MCP SDK 2/3 — перенести действующий transport/protocol на rmcp без изменения бизнес-границ #107

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

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

РАЗРЕШЕНО к совместимой поэтапной реализации решением владельца 08.11.2026 (#107 (comment)). Начинать после поставки #106. На первом рабочем срезе сохраняется действующий transport/session/lifecycle, SDK внедряется request-scoped в обработку запросов без потери остальных MCP-функций. Полная замена транспорта не является условием приёмки первого среза. Production deploy/switch не разрешён. Существующий Epic 3 / FR-13 / Story #8 / AT-3.1-14 и действующие AC остальных MCP-функций.
Источник: /home/codex/code/crank/docs/development/rmcp-migration-plan.md, раздел 2. Владелец 27.10.2026 одобрил планирование; решение 08.11.2026 выше разрешает реализацию совместимого варианта. Исходные AC ниже — цель этапа, не основание расширять каждый отдельный DEV-срез. Issue не закрывать как полностью выполненный после одного Tools-среза; production switch требует отдельного решения.

Зависимости

Только после положительного исполняемого результата этапа «MCP SDK 1/3» и записанного решения TL о достаточности совместимости (evidence-backed SDK/dependency decision AT-3.1-14). Зависит от #106: #106 (native dependency). База — актуальный проверенный main с поставкой4.1 и принятым этапом1; SDK pin/lock и минимальный seam берутся из этапа1, не выбираются заново.
Исполнитель DEV, независимая same-card QA → TL. Один writer MCP-файлов; порядок переноса устанавливается по результату первого опыта. Не вести параллельно новую протокольную реализацию4.7 и миграцию тех же файлов.

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

Подключить SDK к действующему пути и перенести стандартные envelopes, dispatch, lifecycle и transport.

  • Через SDK проходят действующие Tools, Resources, Prompts, completion, уведомления и подписки в применимых revisions 2026-07-28/2025-11-25, а также progress/cancel и существующая logging policy.
  • Сохранены авторизация/отзыв доступа, agent scope, advertised capabilities, admission, deadlines и семантика ошибок. SDK defaults не расширяют объявленные capabilities или список разрешённых revisions.
  • Сессии, reconnect и ограничения памяти/очередей сохраняют действующий контракт; in-memory хранилище не заменяет существующее долговременное хранение без решения.
  • Перенесённые участки собственного протокольного кода удаляются по мере принятия. Временный способ безопасного сравнения/отката не превращается во второй постоянный MCP runtime.
  • Существующие affected ATDD подтверждают старое поведение; тесты меняются только там, где проверяли приватное устройство старого адаптера, а не нужный клиенту контракт.

Границы и передача

Новые бизнес-возможности, переработка REST runtime, базы, модели или UI в эту работу не входят. Crank сохраняет authorization, Agent/workspace scope, published versions, REST mapping, admission и исполнение команд.4.2–4.6 сохраняют domain semantics: durable persistence, leases/fencing, retry/cancel/input/reconciliation не становятся SDK defaults.4.7 интегрируется в принятый SDK seam с точными revision contracts; неизвестная совместимость проверяется, не выдаётся за готовую функцию.
DEV affected ATDD + дешёвые обязательные gates → независимая QA → TL. Ближайший потребитель — этап3: удаление остатков, финальная проверка и поставка. Не повторять full по ролям; финальный feature-run на собранной функции.
Нельзя ослаблять действующие функции/AC без владельца. Секреты/данные/Seerr/VPN/DNS/STOP/ceilings сохраняются. Production manual deployment требует отдельного разрешения по runbook; эта плановая задача его не даёт. Не назначать сроки до первого опыта. ARC только по конкретной несовместимости, без новой подготовительной цепочки.

## Статус и основание РАЗРЕШЕНО к совместимой поэтапной реализации решением владельца 08.11.2026 (https://git.itexp.me/bsodfather/crank/issues/107#issuecomment-2463). Начинать после поставки #106. На первом рабочем срезе сохраняется действующий transport/session/lifecycle, SDK внедряется request-scoped в обработку запросов без потери остальных MCP-функций. Полная замена транспорта не является условием приёмки первого среза. Production deploy/switch не разрешён. Существующий Epic 3 / FR-13 / Story #8 / AT-3.1-14 и действующие AC остальных MCP-функций. Источник: /home/codex/code/crank/docs/development/rmcp-migration-plan.md, раздел 2. Владелец 27.10.2026 одобрил планирование; решение 08.11.2026 выше разрешает реализацию совместимого варианта. Исходные AC ниже — цель этапа, не основание расширять каждый отдельный DEV-срез. Issue не закрывать как полностью выполненный после одного Tools-среза; production switch требует отдельного решения. ## Зависимости Только после положительного исполняемого результата этапа «MCP SDK 1/3» и записанного решения TL о достаточности совместимости (evidence-backed SDK/dependency decision AT-3.1-14). Зависит от #106: https://git.itexp.me/bsodfather/crank/issues/106 (native dependency). База — актуальный проверенный main с поставкой4.1 и принятым этапом1; SDK pin/lock и минимальный seam берутся из этапа1, не выбираются заново. Исполнитель DEV, независимая same-card QA → TL. Один writer MCP-файлов; порядок переноса устанавливается по результату первого опыта. Не вести параллельно новую протокольную реализацию4.7 и миграцию тех же файлов. ## Результат и AC (раздел 2 готового плана) Подключить SDK к действующему пути и перенести стандартные envelopes, dispatch, lifecycle и transport. - Через SDK проходят действующие Tools, Resources, Prompts, completion, уведомления и подписки в применимых revisions 2026-07-28/2025-11-25, а также progress/cancel и существующая logging policy. - Сохранены авторизация/отзыв доступа, agent scope, advertised capabilities, admission, deadlines и семантика ошибок. SDK defaults не расширяют объявленные capabilities или список разрешённых revisions. - Сессии, reconnect и ограничения памяти/очередей сохраняют действующий контракт; in-memory хранилище не заменяет существующее долговременное хранение без решения. - Перенесённые участки собственного протокольного кода удаляются по мере принятия. Временный способ безопасного сравнения/отката не превращается во второй постоянный MCP runtime. - Существующие affected ATDD подтверждают старое поведение; тесты меняются только там, где проверяли приватное устройство старого адаптера, а не нужный клиенту контракт. ## Границы и передача Новые бизнес-возможности, переработка REST runtime, базы, модели или UI в эту работу не входят. Crank сохраняет authorization, Agent/workspace scope, published versions, REST mapping, admission и исполнение команд.4.2–4.6 сохраняют domain semantics: durable persistence, leases/fencing, retry/cancel/input/reconciliation не становятся SDK defaults.4.7 интегрируется в принятый SDK seam с точными revision contracts; неизвестная совместимость проверяется, не выдаётся за готовую функцию. DEV affected ATDD + дешёвые обязательные gates → независимая QA → TL. Ближайший потребитель — этап3: удаление остатков, финальная проверка и поставка. Не повторять full по ролям; финальный feature-run на собранной функции. Нельзя ослаблять действующие функции/AC без владельца. Секреты/данные/Seerr/VPN/DNS/STOP/ceilings сохраняются. Production manual deployment требует отдельного разрешения по runbook; эта плановая задача его не даёт. Не назначать сроки до первого опыта. ARC только по конкретной несовместимости, без новой подготовительной цепочки. <!-- crank-plan:rmcp-migration-stage-2 -->
bsodfather added this to the Этап 3. Инструменты, ресурсы и шаблоны запросов MCP milestone 2026-10-26 21:54:25 +00:00
bsodfather added the Kind/Enhancement
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

Amendment владельца31.10.2026: #34 — business reconciliation4.6 исключена. В разделе «Границы» перечисление4.2–4.6/read retry/input/reconciliation означает только сохранённые proxy/durable safety semantics; external evidence/verifier/manual outcome resolution/confirmed business attempt больше не требуются. Исторические формулировки не восстанавливают снятый scope. #106→#107→#108 остаются planning-only: SDK migration не реализована и не разрешена к автозапуску; технические/security/standard AC сохранены.

Amendment владельца31.10.2026: https://git.itexp.me/bsodfather/crank/issues/34 — business reconciliation4.6 исключена. В разделе «Границы» перечисление4.2–4.6/read retry/input/reconciliation означает только сохранённые proxy/durable safety semantics; external evidence/verifier/manual outcome resolution/confirmed business attempt больше не требуются. Исторические формулировки не восстанавливают снятый scope. #106→#107→#108 остаются planning-only: SDK migration не реализована и не разрешена к автозапуску; технические/security/standard AC сохранены.
Author
Owner

Решение владельца 08.11.2026: «Да, начать совместимое поэтапное внедрение».

Разрешено начать существующий #107 после завершения принятой поставки #106. Первый рабочий срез — встроить rmcp в обработку запросов действующего приложения, используя уже проверенный request-scoped seam. Сохранять нынешние HTTP-вход, авторизацию, Agent/workspace scope, долговременные сессии/reconnect, progress/cancel, admission и остальные действующие MCP-функции. Готовый SDK transport не внедрять ценой известных несовместимостей или потери возможностей; собственный transport пока может остаться. Замещённый код удалять по мере принятия срезов, без второго постоянного runtime.

Это разрешение на реализацию совместимого этапа, а не новая исследовательская/spec-цепочка. TL после delivery-checkpoint ставит DEV конкретный ближайший рабочий срез, DEV дробит только при необходимости; один writer MCP-файлов, affected ATDD, независимая QA, затем DevOps commit/push/PR/release. Уже полученные #106 evidence использовать повторно, full не гонять по каждой роли. ARC только по конкретной новой несовместимости; PM — при расширении функций. Новые функции, урезание требований и production deploy/switch этим не разрешены. #108/4.7 автоматически не запускать.

Предыдущую пометку «только план / не запуск реализации» для этого согласованного минимального варианта считать заменённой данным решением.

Решение владельца 08.11.2026: «Да, начать совместимое поэтапное внедрение». Разрешено начать существующий #107 после завершения принятой поставки #106. Первый рабочий срез — встроить rmcp в обработку запросов действующего приложения, используя уже проверенный request-scoped seam. Сохранять нынешние HTTP-вход, авторизацию, Agent/workspace scope, долговременные сессии/reconnect, progress/cancel, admission и остальные действующие MCP-функции. Готовый SDK transport не внедрять ценой известных несовместимостей или потери возможностей; собственный transport пока может остаться. Замещённый код удалять по мере принятия срезов, без второго постоянного runtime. Это разрешение на реализацию совместимого этапа, а не новая исследовательская/spec-цепочка. TL после delivery-checkpoint ставит DEV конкретный ближайший рабочий срез, DEV дробит только при необходимости; один writer MCP-файлов, affected ATDD, независимая QA, затем DevOps commit/push/PR/release. Уже полученные #106 evidence использовать повторно, full не гонять по каждой роли. ARC только по конкретной новой несовместимости; PM — при расширении функций. Новые функции, урезание требований и production deploy/switch этим не разрешены. #108/4.7 автоматически не запускать. Предыдущую пометку «только план / не запуск реализации» для этого согласованного минимального варианта считать заменённой данным решением.
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Reference: bsodfather/crank#107