Сделать импорт реальных спецификаций OpenAPI надёжным способом получения проверяемых REST-операций и инструментов MCP. Пользователь должен видеть, что будет создано, какие ограничения обнаружены и какие действия требуют явного решения.
Что входит в этап
- Основная разработка задач 2-1–2-14 уже завершена. Повторно переносить их в открытые задачи не требуется. Оставшаяся работа — согласовать приёмку маршрута первого запуска 2-15 и провести итоговую ретроспективу.
- Полный результат этапа: разбор OpenAPI 3.0/3.1 и Swagger 2.0, разрешение ссылок в допустимых пределах, проверка схем и сопоставления авторизации, понятный предварительный просмотр, атомарное применение плана импорта и управляемый повторный импорт.
- Импорт не должен скрывать неподдерживаемые конструкции или терять операции без сообщения. Секреты хранятся предусмотренным способом и не включаются в спецификацию, план импорта или интерфейс первого запуска.
- Маршрут 2-15 использует существующий импорт и приводит пользователя через проверку и публикацию инструмента к первому вызову MCP. Не допускаются отдельный упрощённый обработчик, автоматическая публикация без решения пользователя или дубликаты после обновления страницы.
Условия завершения
Перед закрытием сверить статус 2-15: в спецификации разработка завершена, в плане задача ожидает оператора. Человеческий протокол удобства использования и общий документ приёмки учитываются отдельно от завершения разработки. Итоговая ретроспектива должна подтвердить результат на фактах и оформить только реально обнаруженные остаточные дефекты.
После выполнения задач провести ретроспективу: сверить результат с требованиями, проверками и фактическими изменениями, оформить подтверждённые недостатки и принять решение о закрытии этапа.
Основание плана
Подробный план и обязательные критерии. Номер исходного эпика: 2. При переносе уже завершённые задачи исключены.
Задачи этапа
Превратить опубликованный каталог агента в полноценный, совместимый и предсказуемый интерфейс MCP. Клиент должен обнаруживать и использовать только доступные ему опубликованные версии объектов.
Что входит в этап
- Согласовать поддерживаемые версии протокола и точно объявлять возможности. Новый и прежний жизненные циклы обслуживаются отдельными адаптерами; экспериментальные расширения не подменяют стабильную поддержку.
- Предоставить список и вызов инструментов, структурированные результаты, сообщения о ходе выполнения, отмену и уведомления об изменениях каталога.
- Добавить статические ресурсы и шаблоны ресурсов на основе REST: создание черновика, проверка, публикация неизменяемой версии, привязка к агенту, чтение, импорт и экспорт.
- Добавить параметризованные шаблоны запросов: предварительный просмотр, публикация, получение через MCP, перенос и безопасное включение опубликованных ресурсов.
- Предоставить подсказки значений, безопасные сообщения журнала и уведомления об изменениях ресурсов и шаблонов. Закрепить поддержку исполняемой матрицей совместимости.
Условия завершения
Закрытие требует проверенных контрактов API/MCP, предусмотренных проверок интерфейса на русском и английском языках, отрицательных проверок доступа и отсутствия расхождения между объявленными и фактическими возможностями. Версии, пределы и зависимости указаны в задачах 3-1–3-20. Длительная приёмка конкретного кандидата выпуска относится к этапу 8.
После выполнения задач провести ретроспективу: сверить результат с требованиями, проверками и фактическими изменениями, оформить подтверждённые недостатки и принять решение о закрытии этапа.
Основание плана
Подробный план и обязательные критерии. Номер исходного эпика: 3. При переносе уже завершённые задачи исключены.
Задачи этапа
- 3-1. Согласование версий MCP и доступных возможностей
- 3-2. Список опубликованных инструментов через MCP
- 3-3. Вызов инструментов и структурированные результаты MCP
- 3-4. Ход выполнения и отмена вызовов инструментов
- 3-5. Уведомления об изменении каталога инструментов
- 3-6. Типизированные черновики статических ресурсов
- 3-7. Публикация ресурсов и привязка версий к агенту
- 3-8. Поиск и чтение статических ресурсов через MCP
- 3-9. Импорт, экспорт и управление ресурсами в интерфейсе
- 3-10. Шаблоны ресурсов на основе REST
- 3-11. Чтение REST-ресурсов через общий механизм выполнения
- 3-12. Черновики шаблонов запросов с параметрами
- 3-13. Публикация шаблонов запросов и привязка версий к агенту
- 3-14. Список и получение шаблонов запросов через MCP
- 3-15. Импорт и экспорт шаблонов запросов
- 3-16. Использование опубликованных ресурсов в шаблонах запросов
- 3-17. Подсказки допустимых значений в MCP
- 3-18. Безопасные сообщения журнала MCP
- 3-19. Уведомления об изменении ресурсов и шаблонов запросов
- 3-20. Исполняемая матрица совместимости MCP
- 3-Р. Итоговая ретроспектива этапа 3
Обеспечить управляемое выполнение нескольких операций и сохраняемых фоновых заданий при перегрузке, отмене, перезапуске и потере связи. Система должна честно различать успешный результат, отказ и неизвестный исход внешнего действия.
Что входит в этап
- Закрепить режим выполнения инструмента и проверять ограничения приёма до внешнего действия. Очередь, число исполнителей и потребление ресурсов должны иметь явные пределы.
- Атомарно принимать задания, сохранять необходимые версии и полномочия, выдавать исполнителю ограниченную аренду и запрещать устаревшему исполнителю записывать итог.
- Управлять повторными попытками и отменой с учётом идемпотентности. При потере подтверждения внешнего действия сохранять
outcome_unknown, разрешая его только по проверяемым данным. - Предоставить дополнительный ввод, операции заданий через MCP и совместимый путь для клиентов без соответствующего расширения. В административном интерфейсе доступны поиск, допустимые действия, продолжение и уточнение исхода.
- Проверить мощность и восстановление: не менее 128 одновременных выполнений, до 10 000 заданий в очереди, начало и ожидание p95 ≤5 секунд в допустимой нагрузке, очистка накопленной очереди ≤60 минут и предусмотренное возобновление после сбоя.
Условия завершения
Этап закрывается после воспроизводимых испытаний конкуренции, сбоев и восстановления на указанной сборке и конфигурации. Недопустимы потеря заданий, двойные окончательные результаты, бесконтрольные повторы внешних действий и рост ресурсов без предела. Зависимость начала — проверенное управление вызовами 3-4; полный порядок указан в задачах 4-1–4-10.
После выполнения задач провести ретроспективу: сверить результат с требованиями, проверками и фактическими изменениями, оформить подтверждённые недостатки и принять решение о закрытии этапа.
Основание плана
Подробный план и обязательные критерии. Номер исходного эпика: 4. При переносе уже завершённые задачи исключены.
Задачи этапа
- 4-1. Режимы выполнения и ограничения приёма работы
- 4-2. Атомарное принятие сохраняемых фоновых заданий
- 4-3. Аренда выполнения и защита от устаревших исполнителей
- 4-4. Повторы, отмена и неизвестный исход выполнения
- 4-5. Продолжение задания после ввода пользователя
- 4-6. Уточнение неизвестного исхода по подтверждающим данным
- 4-7. Фоновые задания через MCP и совместимый запасной путь
- 4-8. Поиск фоновых заданий и безопасные действия администратора
- 4-9. Дополнительный ввод и уточнение исхода в интерфейсе
- 4-10. Проверка мощности очереди и восстановления заданий
- 4-Р. Итоговая ретроспектива этапа 4
Дать оператору возможность найти запрос, понять причину ошибки, оценить состояние системы и получить своевременное оповещение. Диагностические данные должны оставаться безопасными и учитываться даже при отказе внешнего приёмника.
Что входит в этап
- Провести Request ID и Trace ID через интерфейс, API, MCP, внешние запросы и фоновые задания. Добавить поиск выполнения и переход к связанной трассировке.
- Безопасно собирать ошибки браузера и передавать трассировки и ошибки в GlitchTip. Недоставленные события сохранять в устойчивом дисковом буфере с подтверждением доставки.
- Явно учитывать потери диагностики. Подтвердить запас буфера на 30 часов для каждого получателя, восстановление после недоступности до 24 часов и установленные сроки доставки.
- Завершить технические метрики и локальные показатели использования. Имена, типы, единицы, метки и гистограммы фиксируются контрактом; пользовательские идентификаторы и произвольные значения не создают новые ряды.
- Поставить защищённый сбор Prometheus, готовые панели Grafana, правила вычисления SLO и заменяемую доставку уведомлений через адаптер Apprise. Каждое серьёзное оповещение должно вести к понятной инструкции действий.
Условия завершения
Перед закрытием проверить реальную корреляцию, доставку, восстановление буфера, точный учёт потерь и ограничение числа рядов. Для наблюдаемости подтверждаются накладные расходы ≤5% задержки p95 и ≤10% CPU. Внешняя аналитика не становится обязательной: передача за пределы установки включается явно. Начало зависит от проверки фоновых заданий 4-10; объём — задачи 5-1–5-13.
После выполнения задач провести ретроспективу: сверить результат с требованиями, проверками и фактическими изменениями, оформить подтверждённые недостатки и принять решение о закрытии этапа.
Основание плана
Подробный план и обязательные критерии. Номер исходного эпика: 5. При переносе уже завершённые задачи исключены.
Задачи этапа
- 5-1. Единые идентификаторы запросов и трассировок
- 5-2. Поиск запросов и переход к трассировке из интерфейса
- 5-3. Безопасная диагностика браузера
- 5-4. Надёжная отправка трассировок и ошибок в GlitchTip
- 5-5. Сохранение диагностических событий в дисковом буфере
- 5-6. Учёт потерь диагностики и проверка ёмкости буфера
- 5-7. Полное покрытие техническими метриками
- 5-8. Локальные показатели использования и активных пользователей
- 5-9. Защищённая интеграция с Prometheus
- 5-10. Заменяемая доставка уведомлений через Apprise
- 5-11. Готовые панели Grafana и ссылки на трассировки
- 5-12. Измерение целевых показателей надёжности
- 5-13. Доставка прикладных оповещений
- 5-Р. Итоговая ретроспектива этапа 5
Позволить оператору самостоятельно задать реалистичную нагрузку, безопасно её запустить и остановить, увидеть текущие результаты и сравнить выпуски по воспроизводимым данным.
Что входит в этап
- Создавать версионируемые сценарии из точных опубликованных инструментов. Сценарий закрепляет состав запросов, входные данные, длительность, разгон и пороги.
- Поддержать RPS, число виртуальных пользователей и прозрачную модель DAU. Формулы, единицы, допущения и получаемая нагрузка видны до запуска.
- Требовать явный план разрешения нагрузки с целями, полномочиями и пределами. Изменяющие операции допускаются только при предусмотренных мерах безопасности.
- Исполнять нагрузку в изолированном процессе с ограниченными ресурсами, сохраняя возможность управления и остановки. Потеря связи и повторное открытие интерфейса не создают новый запуск.
- Сохранять неизменяемые отчёты с контрольными суммами сценария, сборки и конфигурации. Сравнивать только совместимые условия, явно показывая различия; незавершённый запуск не считается успешным.
Условия завершения
Проверить полный маршрут от сценария и предварительной проверки до остановки и отчёта, API и интерфейс на русском и английском языках, реальные метрики и панели. Предусмотрены испытания 100 RPS в течение 30 минут и всплеска 250 RPS в течение 5 минут. Сам инструмент испытаний и окончательная приёмка производительности выпуска — разные результаты; последняя входит в этап 8. Начало зависит от 5-13; объём — 6-1–6-6.
После выполнения задач провести ретроспективу: сверить результат с требованиями, проверками и фактическими изменениями, оформить подтверждённые недостатки и принять решение о закрытии этапа.
Основание плана
Подробный план и обязательные критерии. Номер исходного эпика: 6. При переносе уже завершённые задачи исключены.
Задачи этапа
- 6-1. Версионируемые сценарии нагрузочных испытаний
- 6-2. Прозрачный расчёт нагрузки по активным пользователям
- 6-3. Явное разрешение нагрузочного запуска
- 6-4. Изолированный исполнитель нагрузочных испытаний
- 6-5. Текущая статистика и безопасная остановка нагрузки
- 6-6. Неизменяемые отчёты и сравнение выпусков
- 6-Р. Итоговая ретроспектива этапа 6
Сделать Crank пригодным для самостоятельной эксплуатации: установить на чистой среде, в том числе без интернета, безопасно открыть сетевой доступ, обновить и доказать восстановление после аварии.
Что входит в этап
- Зафиксировать полный контракт конфигурации и проверить миграции данных, совместимость текущей и предыдущей версий и границы обратимости.
- Поставить минимальный и полный профили в
deploy/communityс проверками готовности и постоянных данных. Необязательные зависимости не должны незаметно становиться обязательными. - Защитить сетевое развёртывание, ограничить права контейнеров и процессов, ресурсы и доступ к секретам.
- Собирать полный подписанный комплект автономной установки. Состав, контрольные суммы и ключи проверяются без доступа к внешнему сервису.
- Создавать согласованную резервную копию с
BackupManifest, безопасно работать с ключами, проверять восстановление реальным вызовом MCP и продолжением допустимого задания. - Поставить порядок обновления одного экземпляра и отката: предварительные проверки, прекращение приёма, фиксация работы, переход версии, проверка результата и восстановление при сбое.
Условия завершения
Закрытие требует реальных испытаний чистой установки, автономной установки, миграций, обновления и восстановления в поддерживаемых пределах. Нельзя объявлять резервную копию или откат пригодными только по наличию файлов и инструкции. Неполные данные и несовместимые версии дают безопасный отказ с понятным действием оператора. Начало зависит от 6-6; объём — 7-1–7-9.
После выполнения задач провести ретроспективу: сверить результат с требованиями, проверками и фактическими изменениями, оформить подтверждённые недостатки и принять решение о закрытии этапа.
Основание плана
Подробный план и обязательные критерии. Номер исходного эпика: 7. При переносе уже завершённые задачи исключены.
Задачи этапа
- 7-1. Полный контракт эксплуатационной конфигурации
- 7-2. Миграции данных и совместимость соседних версий
- 7-3. Минимальный и полный профили развёртывания
- 7-4. Защита доступа при сетевом развёртывании
- 7-5. Подписанный комплект для автономной установки
- 7-6. Защита контейнеров и границ процессов
- 7-7. Согласованные резервные копии с описанием состава
- 7-8. Проверенное восстановление и безопасная работа с ключами
- 7-9. Безопасное обновление и откат одного экземпляра
- 7-Р. Итоговая ретроспектива этапа 7
Доказать готовность Community-выпуска на одной неизменяемой сборке, а не на смеси результатов разных версий. Разрешение публикации должно вычисляться из проверенных и подписанных доказательств.
Что входит в этап
- Зафиксировать кандидат выпуска, точные артефакты, конфигурацию и реестр доказательств. Каждое требование связано с проверкой, результатом, временем, владельцем и контрольными суммами.
- Завершить перечень возможностей и обязательные проверки CI, провести полную ручную приёмку, матрицы MCP, OpenAPI, PostgreSQL, Valkey и браузеров.
- Подтвердить производительность тремя последовательными наборами измерений, пройти непрерывные 72 часа нагрузки со сбоями и затем 30 календарных дней эксплуатационных испытаний. Ускорение времени и склейка неполных окон не допускаются.
- Закрыть проверку безопасности и проверить документацию участником без внутреннего контекста, включая автономную установку и восстановление.
- Опубликовать страницу готовности с доказанными возможностями и честными ограничениями. Автономный проверяющий механизм разрешает выпуск и анонс на Хабре только при успешном выполнении всех обязательных условий.
Условия завершения
Критических и высоких дефектов, нестабильных обязательных тестов, обязательных возможностей без доказательств и нарушений целевых показателей быть не должно. Отсутствующие, устаревшие, изменённые, невыполненные и заблокированные проверки не считаются успешными; ручной обход обязательных условий запрещён. Разработка средств проверки и фактическое выполнение испытаний разделены в задачах 8-1–8-10. Начало зависит от 7-9. План не предполагает, что 30 дней можно выполнить в одной сессии разработки.
После выполнения задач провести ретроспективу: сверить результат с требованиями, проверками и фактическими изменениями, оформить подтверждённые недостатки и принять решение о закрытии этапа.
Основание плана
Подробный план и обязательные критерии. Номер исходного эпика: 8. При переносе уже завершённые задачи исключены.
Задачи этапа
- 8-1. Неизменяемый кандидат выпуска и реестр доказательств
- 8-2. Полный перечень возможностей и обязательные проверки CI
- 8-3. Полная ручная приёмка пользовательских сценариев
- 8-4. Проверка совместимости протоколов, данных и браузеров
- 8-5. Приёмочные измерения производительности кандидата выпуска
- 8-6. 72 часа нагрузки и испытания восстановления
- 8-7. Приёмочная проверка безопасности выпуска
- 8-8. Проверка документации и аварийных инструкций новым пользователем
- 8-9. 30 дней эксплуатационных испытаний и страница готовности
- 8-10. Автоматическое разрешение выпуска и анонса на Хабре
- 8-Р. Итоговая ретроспектива этапа 8