MCP SDK 1/3 — исполняемый rmcp adapter на действующих Tools и обеих revisions #106

Open
opened 2026-10-26 21:54:25 +00:00 by bsodfather · 3 comments
Owner

Статус и основание

ПЛАН / Backlog, не запуск реализации. Техническое продолжение Epic 3, Story #8 / FR-13 / AT-3.1-14. Владелец 27.10.2026 разрешил планирование перехода на официальный rmcp; не dependency change, production switch или deploy.
Источник: /home/codex/code/crank/docs/development/rmcp-migration-plan.md, раздел 1 (полный исполняемый scope ниже); аудит /home/codex/.hermes/codex-operator/handoffs/crank-rmcp-audit-20261027.md. Новый PRD/spec/research не нужен.
Decision: исторический default AT-3.1-14 «сохранять собственный transport» не доказывает непригодность SDK. Решение владельца задаёт цель проверить SDK-путь; принятие SDK/dependency change допускается только по исполняемым evidence и краткому записанному решению TL этого этапа, которое фиксирует архитектурный выбор по AT-3.1-14. Новая большая ADR-цепочка не требуется, wire conformance обязательно.

Зависимости и запуск

Сначала завершить существующую проверку поставки 4.1: Hermes t_d1fdbddf → t_cfa693e8. Известный integrated main cc612516a29d48f2831ba6bdf58c1dc777aa6abf; перед исполнением взять актуальную проверенную базу. Нужны отдельное назначение DEV и один writer выделенного W; независимая same-card QA, затем TL принимает результат. Создание этого issue не разрешает автозапуск.
Кандидат SDK rmcp 3.7.0: окончательный pin/lock проверяются здесь, без автоматического обновления версии.

Результат и AC (раздел 1 готового плана)

Сделать изолированный исполняемый прототип SDK на существующей границе типизированных команд, сохранив авторизацию и динамический каталог. Публичный production endpoint пока обслуживает прежний путь.

  • Динамические tools/list и tools/call работают через SDK с действующими сервисами Crank, включая запрет чужого Agent/неверных credentials и сохранение ошибок инструмента.
  • Через настоящий HTTP-путь проверены обе revisions 2025-11-25 и 2026-07-28: legacy initialize/session и modern discover/stateless, JSON/SSE, headers, progress и cancellation.
  • Отдельно проверены пригодность SessionManager для существующего хранения сессий, переподключение и владение отменой; наличие SDK-типа само по себе не считается доказательством.
  • Установлены существенные gaps для Resources/Prompts/notifications/subscriptions и текущих execution modes. Наличие интерфейса не выдаётся за полную совместимость.
  • На небольшом smoke-наборе проверено, что adapter не обходит действующие ограничения; замеченный риск памяти/очередей записан. Нагрузочная квалификация относится к завершённой функции, не превращается в условие этого прототипа. Существующие ceilings не меняются.
  • Результат — работающий код и краткое решение TL: готов перенос либо конкретная несовместимость с минимальным вариантом решения. Если потребуется ослабить контракт, заменить хранилище или создать большой дополнительный framework — вопрос владельцу до продолжения.
    Это один достаточный опыт, а не серия исследований SDK. Использовать существующие wire fixtures и точечные проверки; NOT_RUN явно. DEV affected ATDD/cheap CI gates → независимая QA → TL; повторного full по ролям нет.

Границы и ближайший потребитель

Следующий этап — перенос действующего MCP transport/protocol после положительного решения TL; не считать Tools prototype полной миграцией. Авторизация, Agent/workspace scope, published versions, REST mapping, admission и исполнение команд остаются у Crank. Сохраняются обе revisions, Tools/Resources/Prompts, logging, notifications и subscriptions; новых бизнес-функций нет. SDK не заменяет durable Task state, leases/recovery или safety stores.
Этап 1 планируется перед расширением заменяемого protocol слоя, не ждёт будущих4.2–4.7/всей нагрузки. Доменная разработка4.2–4.6 может идти параллельно без общего writer; wire-изменения и4.7 — только после решения по этому adapter и согласованного владения файлами, не параллельно с миграцией тех же MCP-файлов.
Секреты/данные/Seerr/VPN/DNS, нагрузочный STOP и ceilings неизменны; production endpoint switch/deploy запрещены этим issue. ARC только для конкретного SessionManager/transport seam вопроса. При изменении функций — решение владельца/PM до реализации. Сроки не назначены.

## Статус и основание ПЛАН / Backlog, не запуск реализации. Техническое продолжение Epic 3, Story #8 / FR-13 / AT-3.1-14. Владелец 27.10.2026 разрешил планирование перехода на официальный rmcp; не dependency change, production switch или deploy. Источник: /home/codex/code/crank/docs/development/rmcp-migration-plan.md, раздел 1 (полный исполняемый scope ниже); аудит /home/codex/.hermes/codex-operator/handoffs/crank-rmcp-audit-20261027.md. Новый PRD/spec/research не нужен. Decision: исторический default AT-3.1-14 «сохранять собственный transport» не доказывает непригодность SDK. Решение владельца задаёт цель проверить SDK-путь; принятие SDK/dependency change допускается только по исполняемым evidence и краткому записанному решению TL этого этапа, которое фиксирует архитектурный выбор по AT-3.1-14. Новая большая ADR-цепочка не требуется, wire conformance обязательно. ## Зависимости и запуск Сначала завершить существующую проверку поставки 4.1: Hermes t_d1fdbddf → t_cfa693e8. Известный integrated main cc612516a29d48f2831ba6bdf58c1dc777aa6abf; перед исполнением взять актуальную проверенную базу. Нужны отдельное назначение DEV и один writer выделенного W; независимая same-card QA, затем TL принимает результат. Создание этого issue не разрешает автозапуск. Кандидат SDK rmcp 3.7.0: окончательный pin/lock проверяются здесь, без автоматического обновления версии. ## Результат и AC (раздел 1 готового плана) Сделать изолированный исполняемый прототип SDK на существующей границе типизированных команд, сохранив авторизацию и динамический каталог. Публичный production endpoint пока обслуживает прежний путь. - Динамические tools/list и tools/call работают через SDK с действующими сервисами Crank, включая запрет чужого Agent/неверных credentials и сохранение ошибок инструмента. - Через настоящий HTTP-путь проверены обе revisions 2025-11-25 и 2026-07-28: legacy initialize/session и modern discover/stateless, JSON/SSE, headers, progress и cancellation. - Отдельно проверены пригодность SessionManager для существующего хранения сессий, переподключение и владение отменой; наличие SDK-типа само по себе не считается доказательством. - Установлены существенные gaps для Resources/Prompts/notifications/subscriptions и текущих execution modes. Наличие интерфейса не выдаётся за полную совместимость. - На небольшом smoke-наборе проверено, что adapter не обходит действующие ограничения; замеченный риск памяти/очередей записан. Нагрузочная квалификация относится к завершённой функции, не превращается в условие этого прототипа. Существующие ceilings не меняются. - Результат — работающий код и краткое решение TL: готов перенос либо конкретная несовместимость с минимальным вариантом решения. Если потребуется ослабить контракт, заменить хранилище или создать большой дополнительный framework — вопрос владельцу до продолжения. Это один достаточный опыт, а не серия исследований SDK. Использовать существующие wire fixtures и точечные проверки; NOT_RUN явно. DEV affected ATDD/cheap CI gates → независимая QA → TL; повторного full по ролям нет. ## Границы и ближайший потребитель Следующий этап — перенос действующего MCP transport/protocol после положительного решения TL; не считать Tools prototype полной миграцией. Авторизация, Agent/workspace scope, published versions, REST mapping, admission и исполнение команд остаются у Crank. Сохраняются обе revisions, Tools/Resources/Prompts, logging, notifications и subscriptions; новых бизнес-функций нет. SDK не заменяет durable Task state, leases/recovery или safety stores. Этап 1 планируется перед расширением заменяемого protocol слоя, не ждёт будущих4.2–4.7/всей нагрузки. Доменная разработка4.2–4.6 может идти параллельно без общего writer; wire-изменения и4.7 — только после решения по этому adapter и согласованного владения файлами, не параллельно с миграцией тех же MCP-файлов. Секреты/данные/Seerr/VPN/DNS, нагрузочный STOP и ceilings неизменны; production endpoint switch/deploy запрещены этим issue. ARC только для конкретного SessionManager/transport seam вопроса. При изменении функций — решение владельца/PM до реализации. Сроки не назначены. <!-- crank-plan:rmcp-migration-stage-1 -->
bsodfather added this to the Этап 3. Инструменты, ресурсы и шаблоны запросов MCP milestone 2026-10-26 21:54:25 +00:00
bsodfather added the Kind/Testing
Priority
High
2
labels 2026-10-26 21:54:25 +00:00
bsodfather added this to the Crank project 2026-10-26 21:54:42 +00:00
Author
Owner

TL31.10: выбран ближайшим следующим шагом после scope amendment #34. Пока НЕ ЗАПУЩЕН: действующее разрешение владельца распространялось на планирование. Запрос решения находится в Kanban t_88454196. Отдельное новое research/spec не требуется.

Подготовленный ограниченный scope после разрешения: выполнить существующий раздел1 этого issue — изолированный rmcp Tools adapter на текущих сервисах/typed commands; реальный loopback HTTP для revisions2025-11-25/2026-07-28, dynamic list/call, denial чужого Agent/неверных credentials, errors/JSON/SSE/headers/progress/cancel, SessionManager storage/reconnect/cancel ownership и конкретные gaps остальных MCP-функций. rmcp3.7.0 только плановый кандидат, pin/lock подтверждается исполнением, не автоматическим upgrade. Public production endpoint остаётся прежним; не запускать #107/#108/4.7 этим разрешением. Ближайший потребитель — перенос #107 после положительного решения TL.

База: проверенная поставка4.5 main e4953abcd2 / rc.14 (актуальность remote перед началом проверить). R=/home/codex/code/crank и accepted story45-input-continuation read-only; отдельный W/writer для106, без захвата чужого tracked/untracked. DEV интегрирует полезные Beam/Ornith части по participant-handoff; обязательны реальные worker IDs/results либо конкретное основание неотделимости, affected ATDD/cheap gates → независимая same-card QA → одна TL-точка. TL после приёмки поручает DevOps поставку с Gitea contract и зависимой проверкой remote SHA/required CI/protected merge/релизного результата. Не держать running ожидание детей, не cron, не платный fallback.

Co-delivery docs следующей кодовой задачи, не отдельный Markdown release: коротко перенести canonical amendment #34 в FR25/FR26/AR9, секцию4.6 и зависимости4.7/4.9/итоговой квалификации acceptance plan; historical AC4.6 пометить cancelled/not_applicable с основанием, не PASS; business-reconciliation части4.9 убрать, input/unknown safety сохранить. PRD/epics в R игнорируемые/исторические — не force-add архивы и не захватывать R WIP; authoritative live amendment #34 уже действует и supersedes старый shared attachment. План rmcp в docs/development/rmcp-migration-plan.md сохранить как план, не как выполненный SDK переход. Никакого удаления опубликованного4.3–4.5 кода/миграций. Production NO_GO, blockers3.3/P4/auth3.20, секреты/данные/Seerr/VPN/DNS сохраняются.

TL31.10: выбран ближайшим следующим шагом после scope amendment #34. Пока НЕ ЗАПУЩЕН: действующее разрешение владельца распространялось на планирование. Запрос решения находится в Kanban t_88454196. Отдельное новое research/spec не требуется. Подготовленный ограниченный scope после разрешения: выполнить существующий раздел1 этого issue — изолированный rmcp Tools adapter на текущих сервисах/typed commands; реальный loopback HTTP для revisions2025-11-25/2026-07-28, dynamic list/call, denial чужого Agent/неверных credentials, errors/JSON/SSE/headers/progress/cancel, SessionManager storage/reconnect/cancel ownership и конкретные gaps остальных MCP-функций. rmcp3.7.0 только плановый кандидат, pin/lock подтверждается исполнением, не автоматическим upgrade. Public production endpoint остаётся прежним; не запускать #107/#108/4.7 этим разрешением. Ближайший потребитель — перенос #107 после положительного решения TL. База: проверенная поставка4.5 main e4953abcd2f5320e1729249221ce9472a175c5f1 / rc.14 (актуальность remote перед началом проверить). R=/home/codex/code/crank и accepted story45-input-continuation read-only; отдельный W/writer для106, без захвата чужого tracked/untracked. DEV интегрирует полезные Beam/Ornith части по participant-handoff; обязательны реальные worker IDs/results либо конкретное основание неотделимости, affected ATDD/cheap gates → независимая same-card QA → одна TL-точка. TL после приёмки поручает DevOps поставку с Gitea contract и зависимой проверкой remote SHA/required CI/protected merge/релизного результата. Не держать running ожидание детей, не cron, не платный fallback. Co-delivery docs следующей кодовой задачи, не отдельный Markdown release: коротко перенести canonical amendment #34 в FR25/FR26/AR9, секцию4.6 и зависимости4.7/4.9/итоговой квалификации acceptance plan; historical AC4.6 пометить cancelled/not_applicable с основанием, не PASS; business-reconciliation части4.9 убрать, input/unknown safety сохранить. PRD/epics в R игнорируемые/исторические — не force-add архивы и не захватывать R WIP; authoritative live amendment #34 уже действует и supersedes старый shared attachment. План rmcp в docs/development/rmcp-migration-plan.md сохранить как план, не как выполненный SDK переход. Никакого удаления опубликованного4.3–4.5 кода/миграций. Production NO_GO, blockers3.3/P4/auth3.20, секреты/данные/Seerr/VPN/DNS сохраняются.
Author
Owner

Решение владельца 05.11.2026: реализация этапа 1 / этого #106 разрешена, прежняя отметка planning-only в начале issue и comment2277 больше не ограничивает запуск ТОЛЬКО этого этапа. Полная миграция #107/#108 и production switch по-прежнему НЕ разрешены.

Запущен существующий scope/AC без нового spec/research: изолированный исполняемый rmcp Tools adapter, реальный HTTP обеих revisions 2025-11-25/2026-07-28, права/ошибки/JSON/SSE/headers/progress/cancel, проверка SessionManager/storage/reconnect/cancel ownership; только необходимые affected ATDD/cheap gates. rmcp 3.7.0 остаётся кандидатом до проверки pin/lock. Публичный production endpoint остаётся прежним. Не выдавать прототип за полную SDK migration.

Исполнение: DEV t_fdcc7df8 → независимая same-card QA hermes_qa → единственная TL-приёмка t_fc5fe89a. База remote main подтверждена TL: e4953abcd2. W=/home/codex/code/crank-worktrees/rmcp106-tools-adapter; R и accepted story45 read-only. DEV интегрирует полезные Beam/Ornith части и возвращает реальные IDs/results. После приёмки TL поручает DevOps поставку с Gitea completion contract, remote SHA/required CI/protected merge/честным prerelease и зависимой проверкой результата.

Canonical отмена business reconciliation #34 сохраняется: не gate и не implementation PASS. Короткие docs amendment co-deliver с кодом106, не отдельный Markdown release; не захватывать R WIP/ignored архивы. Никаких verifier/business-reconciliation/Temporal/Kafka зависимостей. Исторические blockers3.3/P4/auth3.20, unknown/write safety и production NO_GO остаются. Положительное решение106 само по себе НЕ запускает107/108.

Решение владельца 05.11.2026: реализация этапа 1 / этого #106 разрешена, прежняя отметка planning-only в начале issue и comment2277 больше не ограничивает запуск ТОЛЬКО этого этапа. Полная миграция #107/#108 и production switch по-прежнему НЕ разрешены. Запущен существующий scope/AC без нового spec/research: изолированный исполняемый rmcp Tools adapter, реальный HTTP обеих revisions 2025-11-25/2026-07-28, права/ошибки/JSON/SSE/headers/progress/cancel, проверка SessionManager/storage/reconnect/cancel ownership; только необходимые affected ATDD/cheap gates. rmcp 3.7.0 остаётся кандидатом до проверки pin/lock. Публичный production endpoint остаётся прежним. Не выдавать прототип за полную SDK migration. Исполнение: DEV t_fdcc7df8 → независимая same-card QA hermes_qa → единственная TL-приёмка t_fc5fe89a. База remote main подтверждена TL: e4953abcd2f5320e1729249221ce9472a175c5f1. W=/home/codex/code/crank-worktrees/rmcp106-tools-adapter; R и accepted story45 read-only. DEV интегрирует полезные Beam/Ornith части и возвращает реальные IDs/results. После приёмки TL поручает DevOps поставку с Gitea completion contract, remote SHA/required CI/protected merge/честным prerelease и зависимой проверкой результата. Canonical отмена business reconciliation #34 сохраняется: не gate и не implementation PASS. Короткие docs amendment co-deliver с кодом106, не отдельный Markdown release; не захватывать R WIP/ignored архивы. Никаких verifier/business-reconciliation/Temporal/Kafka зависимостей. Исторические blockers3.3/P4/auth3.20, unknown/write safety и production NO_GO остаются. Положительное решение106 само по себе НЕ запускает107/108.
Author
Owner

Решение владельца от 2026-11-05: разрешена реализация первого изолированного rmcp Tools adapter (#106). Продолжить существующую TL-карточку t_88454196 → DEV → независимая QA → TL → DevOps. Production endpoint не переключать; #107/#108 не разрешены этим решением. Минимальные affected/ATDD проверки, без повторного перепланирования и без business reconciliation. Общая запись: /home/codex/.hermes/team/owner-decisions-20261105.md.

Решение владельца от 2026-11-05: разрешена реализация первого изолированного rmcp Tools adapter (#106). Продолжить существующую TL-карточку t_88454196 → DEV → независимая QA → TL → DevOps. Production endpoint не переключать; #107/#108 не разрешены этим решением. Минимальные affected/ATDD проверки, без повторного перепланирования и без business reconciliation. Общая запись: /home/codex/.hermes/team/owner-decisions-20261105.md.
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Reference: bsodfather/crank#106