3-1. Согласование версий MCP и доступных возможностей #8

Open
opened 2026-10-04 20:48:07 +00:00 by bsodfather · 1 comment
Owner

Результат задачи

Обеспечить явное согласование версии протокола и точное объявление поддерживаемых возможностей сервера.

Что необходимо сделать и проверить

  • Зафиксированы ровно 2026-07-28 и 2025-11-25 с источниками и датой выбора.
  • новый и прежний жизненные циклы изолированы адаптерами, смешанные запросы проверены.
  • неизвестные версии и несовместимые заголовки отклоняются.
  • объявленные возможности соответствуют исполняемому реестру; experimental enablement отложен до первой реальной extension, unknown/unregistered вызовы безопасно отклоняются.

Зависимости

1-13 (уже завершена; повторно не переносится).

Приёмка

Требования: FR-13. Это задача разработки. Проверить её результат и все обязательные критерии: применимые модульные, интеграционные, отрицательные и сквозные проверки, сборку и предусмотренные проверки проекта. Зафиксировать фактические результаты и оставшиеся ограничения. Будущие приёмочные испытания других задач не выполняются попутно.

Полный обязательный контракт задачи и подробные критерии. Описание выше поясняет работу; ссылка сохраняет полный объём требований, включая ограничения и отрицательные сценарии. Сокращённое описание не заменяет и не ослабляет исходные критерии.

Утверждённое изменение контракта — 2026-10-11

Владелец согласовал ровно две целевые MCP revisions: 2026-07-28 и 2025-11-25, Resource-first порядок 3.1 → 3.6 → 3.7 → 3.8, узкие method services и перенос production experimental configuration до первой реальной extension. Этот раздел и полный актуальный контракт ниже заменяют противоречащие им старые формулировки, включая историческое вложение. Остальные требования и доказательства не ослаблены. Это изменение планирования, НЕ выполненная разработка или PASS. Требования ≥3 representative real clients, NFR-P4, FR-54, immutable RC и отдельная release qualification сохраняются. Runtime пока остаётся pre-change; будущая реализация обслуживает только две целевые revisions и безопасно отклоняет остальные без implicit fallback.

Полный актуальный scoped contract

Story 3.1: Согласовывать MCP revision и точные capabilities

Current contract note (owner decision 2026-10-11, supersedes window/order-формулировки ниже): целевые revisions ровно две — 2026-07-28 (modern stateless) и 2025-11-25 (legacy session). Автоматический latest/N-1/N-2 и обязательное сохранение 2025-03-26 сняты из обещания; неподдерживаемая identity получает безопасную структурированную ошибку без implicit fallback. Ранее реализованные 2025-06-18/2025-03-26 остаются в коде до отдельного согласованного ATDD/build этапа. Первый пользовательский результат вертикали: 3.1 → 3.6 → 3.7 → 3.8; Tools-модернизация 3.2–3.5 остаётся обязательной работой Epic 3 с собственными зависимостями. Причина изменения: нет потребителей; публичное основание для 2025-11-25 — встроенный MCP-путь VS Code 1.136.1.

Depends on: Story 1.13

Work type: implementation

Deliverable: Согласовывать MCP revision и точные capabilities.

Completion: outcome этой story и все её AC проверены; будущая qualification не выполняется попутно.

As an интегратор MCP-клиента,
I want endpoint явно согласовывать поддерживаемую protocol revision и capabilities,
So that клиент не полагается на поведение, которого сервер не реализует.

Requirements: FR-13

Acceptance Criteria:

Given наступление feature freeze
When утверждается MCP support window
Then из официальных stable specifications выбираются ровно две целевые поддерживаемые stable revisions — 2026-07-28 и 2025-11-25; автоматический выбор latest плюс двух предыдущих не применяется
And конкретные versions, source digests и дата выбора фиксируются в Capability Inventory.

Given ранее реализованная поддержка 2025-03-26 (и 2025-06-18)
When текущий support window их больше не включает
Then обе revision остаются в коде до отдельного согласованного ATDD/build этапа, но не входят в заявленное обещание поддержки, и неподдерживаемая identity получает безопасную структурированную ошибку без implicit fallback
And удаление из кода и изменение обещания выполняются отдельным согласованным изменением с release/migration note, не попутно с добавлением новых adapters.

Given официальная stable MCP specification
When формируется server capability inventory
Then каждая capability и extension получает status supported, not_applicable, experimental или deferred, owner, fallback и evidence target
And применимая stable capability со status deferred блокирует feature-complete gate.

Given клиент MCP 2026-07-28
When он начинает работу с public endpoint
Then stateless adapter обслуживает обязательный server/discover, request-scoped metadata и применимые стандартные headers без initialize/session dependency
And рекламирует только реально реализованные methods/extensions.

Given клиент одной из selected legacy revisions из Capability Inventory
When он выполняет initialize и последующие session requests
Then отдельный legacy adapter сохраняет согласованный lifecycle, headers и negotiation semantics
And ни один session contract не протекает в stateless adapter либо shared method services.

Given unsupported, malformed или отсутствующая protocol identity
When request достигает соответствующего protocol-era adapter
Then endpoint возвращает структурированную revision-correct error либо только разрешённый specification fallback
And не угадывает adapter, experimental behavior или ложную session state.

Given одна public MCP route
When запросы разных revisions поступают одновременно
Then version-specific headers, lifecycle, pagination, notifications и result shapes изолированы adapters
And shared method services получают typed internal requests без transport-specific DTO leakage.

Given protocol adapter foundation
When capability либо extension добавляется последующей Story
Then Story 3.1 предоставляет единый typed registration mechanism для server/discover и legacy negotiation
And конкретный descriptor и method mapping принадлежат Story соответствующей capability, а не transport router.

Given release-candidate или experimental MCP extension
When оператор планирует включить её отдельной configuration
Then production experimental configuration отложена до появления первой реальной extension: в текущем scope ни одна experimental/unknown extension не регистрируется и не рекламируется, а прямой вызов unknown или незарегистрированного identifier безопасно отклоняется
And future activation trigger (единая формулировка, обязательна до первого production enablement): включение только при явном операторском enablement ∧ revision совместима ∧ client opt-in; negative cells (не включено / несовместимая revision / клиент без поддержки) без advertisement; stable fallback доступен при выключенной extension; триггер принадлежит первой реальной owning capability story и не создаёт нового issue — отдельный future gate, не выполненная AC; extension не становится единственным путём для критичного Tool и может быть выключена без потери stable core.

Given клиент без Resources, Prompts или Tasks extension
When он завершает negotiation
Then сервер не отправляет неподдерживаемые methods/notifications
And Tools остаются доступны через согласованный stable path.

Given request одного protocol era
When он использует lifecycle/header semantics другого era либо несовместимую revision
Then transport отклоняет request stable protocol error
And не маршрутизирует его молча в другой adapter и не создаёт скрытую state.

Given изменение transport negotiation
When проверяются architecture boundaries
Then MCP headers, Accept negotiation, session и JSON/SSE semantics остаются в crank-community-mcp transport boundary
And core/application services не импортируют protocol-version DTOs.

Given protocol fixture suite
When выполняется negotiation matrix
Then RED-first wire fixtures покрывают server/discover/stateless lifecycle 2026-07-28, initialize/session lifecycle 2025-11-25, malformed/unsupported versions (включая снятые 2025-06-18/2025-03-26 без implicit fallback), concurrent mixed clients и unknown/unregistered extensions, которые никогда не рекламируются
And advertised capabilities byte-for-byte соответствуют independent executable inventory (не снимку текущего вывода и не другой revision).

Given актуальный официальный Rust MCP SDK
When проектируется adapter 2026-07-28
Then выполняется bounded compatibility assessment против существующих architecture boundaries, MSRV и transport tests
And default decision сохраняет существующий transport; SDK принимается только отдельным evidence-backed ADR/dependency change, а wire-level conformance остаётся обязательной при любом выборе.

### Результат задачи Обеспечить явное согласование версии протокола и точное объявление поддерживаемых возможностей сервера. ### Что необходимо сделать и проверить - Зафиксированы ровно `2026-07-28` и `2025-11-25` с источниками и датой выбора. - новый и прежний жизненные циклы изолированы адаптерами, смешанные запросы проверены. - неизвестные версии и несовместимые заголовки отклоняются. - объявленные возможности соответствуют исполняемому реестру; experimental enablement отложен до первой реальной extension, unknown/unregistered вызовы безопасно отклоняются. ### Зависимости 1-13 (уже завершена; повторно не переносится). ### Приёмка Требования: FR-13. Это задача разработки. Проверить её результат и все обязательные критерии: применимые модульные, интеграционные, отрицательные и сквозные проверки, сборку и предусмотренные проверки проекта. Зафиксировать фактические результаты и оставшиеся ограничения. Будущие приёмочные испытания других задач не выполняются попутно. [Полный обязательный контракт задачи и подробные критерии](https://git.itexp.me/attachments/c1fe4516-5f6c-41ab-a697-c7a0faac0527). Описание выше поясняет работу; ссылка сохраняет полный объём требований, включая ограничения и отрицательные сценарии. Сокращённое описание не заменяет и не ослабляет исходные критерии. <!-- crank-plan:story-3-1 --> ### Утверждённое изменение контракта — 2026-10-11 Владелец согласовал ровно две целевые MCP revisions: `2026-07-28` и `2025-11-25`, Resource-first порядок `3.1 → 3.6 → 3.7 → 3.8`, узкие method services и перенос production experimental configuration до первой реальной extension. Этот раздел и полный актуальный контракт ниже заменяют противоречащие им старые формулировки, включая историческое вложение. Остальные требования и доказательства не ослаблены. Это изменение планирования, НЕ выполненная разработка или PASS. Требования ≥3 representative real clients, NFR-P4, FR-54, immutable RC и отдельная release qualification сохраняются. Runtime пока остаётся pre-change; будущая реализация обслуживает только две целевые revisions и безопасно отклоняет остальные без implicit fallback. ### Полный актуальный scoped contract ### Story 3.1: Согласовывать MCP revision и точные capabilities > **Current contract note (owner decision 2026-10-11, supersedes window/order-формулировки ниже):** целевые revisions ровно две — `2026-07-28` (modern stateless) и `2025-11-25` (legacy session). Автоматический latest/N-1/N-2 и обязательное сохранение `2025-03-26` сняты из обещания; неподдерживаемая identity получает безопасную структурированную ошибку без implicit fallback. Ранее реализованные `2025-06-18`/`2025-03-26` остаются в коде до отдельного согласованного ATDD/build этапа. Первый пользовательский результат вертикали: 3.1 → 3.6 → 3.7 → 3.8; Tools-модернизация 3.2–3.5 остаётся обязательной работой Epic 3 с собственными зависимостями. Причина изменения: нет потребителей; публичное основание для `2025-11-25` — встроенный MCP-путь VS Code 1.136.1. **Depends on:** Story 1.13 **Work type:** implementation **Deliverable:** Согласовывать MCP revision и точные capabilities. **Completion:** outcome этой story и все её AC проверены; будущая qualification не выполняется попутно. As an интегратор MCP-клиента, I want endpoint явно согласовывать поддерживаемую protocol revision и capabilities, So that клиент не полагается на поведение, которого сервер не реализует. **Requirements:** FR-13 **Acceptance Criteria:** **Given** наступление feature freeze **When** утверждается MCP support window **Then** из официальных stable specifications выбираются ровно две целевые поддерживаемые stable revisions — `2026-07-28` и `2025-11-25`; автоматический выбор latest плюс двух предыдущих не применяется **And** конкретные versions, source digests и дата выбора фиксируются в Capability Inventory. **Given** ранее реализованная поддержка `2025-03-26` (и `2025-06-18`) **When** текущий support window их больше не включает **Then** обе revision остаются в коде до отдельного согласованного ATDD/build этапа, но не входят в заявленное обещание поддержки, и неподдерживаемая identity получает безопасную структурированную ошибку без implicit fallback **And** удаление из кода и изменение обещания выполняются отдельным согласованным изменением с release/migration note, не попутно с добавлением новых adapters. **Given** официальная stable MCP specification **When** формируется server capability inventory **Then** каждая capability и extension получает status `supported`, `not_applicable`, `experimental` или `deferred`, owner, fallback и evidence target **And** применимая stable capability со status `deferred` блокирует feature-complete gate. **Given** клиент MCP `2026-07-28` **When** он начинает работу с public endpoint **Then** stateless adapter обслуживает обязательный `server/discover`, request-scoped metadata и применимые стандартные headers без initialize/session dependency **And** рекламирует только реально реализованные methods/extensions. **Given** клиент одной из selected legacy revisions из Capability Inventory **When** он выполняет initialize и последующие session requests **Then** отдельный legacy adapter сохраняет согласованный lifecycle, headers и negotiation semantics **And** ни один session contract не протекает в stateless adapter либо shared method services. **Given** unsupported, malformed или отсутствующая protocol identity **When** request достигает соответствующего protocol-era adapter **Then** endpoint возвращает структурированную revision-correct error либо только разрешённый specification fallback **And** не угадывает adapter, experimental behavior или ложную session state. **Given** одна public MCP route **When** запросы разных revisions поступают одновременно **Then** version-specific headers, lifecycle, pagination, notifications и result shapes изолированы adapters **And** shared method services получают typed internal requests без transport-specific DTO leakage. **Given** protocol adapter foundation **When** capability либо extension добавляется последующей Story **Then** Story 3.1 предоставляет единый typed registration mechanism для `server/discover` и legacy negotiation **And** конкретный descriptor и method mapping принадлежат Story соответствующей capability, а не transport router. **Given** release-candidate или experimental MCP extension **When** оператор планирует включить её отдельной configuration **Then** production experimental configuration отложена до появления первой реальной extension: в текущем scope ни одна experimental/unknown extension не регистрируется и не рекламируется, а прямой вызов unknown или незарегистрированного identifier безопасно отклоняется **And** future activation trigger (единая формулировка, обязательна до первого production enablement): включение только при явном операторском enablement ∧ revision совместима ∧ client opt-in; negative cells (не включено / несовместимая revision / клиент без поддержки) без advertisement; stable fallback доступен при выключенной extension; триггер принадлежит первой реальной owning capability story и не создаёт нового issue — отдельный future gate, не выполненная AC; extension не становится единственным путём для критичного Tool и может быть выключена без потери stable core. **Given** клиент без Resources, Prompts или Tasks extension **When** он завершает negotiation **Then** сервер не отправляет неподдерживаемые methods/notifications **And** Tools остаются доступны через согласованный stable path. **Given** request одного protocol era **When** он использует lifecycle/header semantics другого era либо несовместимую revision **Then** transport отклоняет request stable protocol error **And** не маршрутизирует его молча в другой adapter и не создаёт скрытую state. **Given** изменение transport negotiation **When** проверяются architecture boundaries **Then** MCP headers, Accept negotiation, session и JSON/SSE semantics остаются в `crank-community-mcp` transport boundary **And** core/application services не импортируют protocol-version DTOs. **Given** protocol fixture suite **When** выполняется negotiation matrix **Then** RED-first wire fixtures покрывают `server/discover`/stateless lifecycle `2026-07-28`, initialize/session lifecycle `2025-11-25`, malformed/unsupported versions (включая снятые `2025-06-18`/`2025-03-26` без implicit fallback), concurrent mixed clients и unknown/unregistered extensions, которые никогда не рекламируются **And** advertised capabilities byte-for-byte соответствуют independent executable inventory (не снимку текущего вывода и не другой revision). **Given** актуальный официальный Rust MCP SDK **When** проектируется adapter `2026-07-28` **Then** выполняется bounded compatibility assessment против существующих architecture boundaries, MSRV и transport tests **And** default decision сохраняет существующий transport; SDK принимается только отдельным evidence-backed ADR/dependency change, а wire-level conformance остаётся обязательной при любом выборе. <!-- crank-approved:epic3-resource-first-20261011 -->
bsodfather added this to the Этап 3. Инструменты, ресурсы и шаблоны запросов MCP milestone 2026-10-04 20:48:07 +00:00
bsodfather added the Kind/Feature
Priority
High
2
labels 2026-10-04 20:48:07 +00:00
bsodfather added this to the Crank project 2026-10-04 20:53:17 +00:00
bsodfather moved this to In Progress in Crank on 2026-10-11 07:31:31 +00:00
bsodfather moved this to Backlog in Crank on 2026-10-11 07:37:07 +00:00
Author
Owner

Планирование rmcp по решению владельца27.10.2026 опубликовано в существующем Epic3: #106 → #107 → #108 (Backlog, не запущены). Полные scoped AC готовы из docs/development/rmcp-migration-plan.md; новый PRD/аудит не нужен. #106 продолжает FR-13/AT-3.1-14: исполняемая проверка SDK и краткое evidence-backed архитектурное/dependency решение TL, а не презумпция несовместимости по историческому default «свой transport». Владелец одобрил планирование, не автоматический dependency change/production switch. Обе revisions и весь ранее подтверждённый MCP scope сохраняются. Сначала завершить проверку поставки4.1 (t_d1fdbddf→t_cfa693e8), затем отдельно назначить исполнение #106; положительный результат и решение TL открывают #107, принятый перенос открывает #108. Совместимость ещё не доказана.

Сопоставление будущих4.2–4.7: #30(4.2) Task+intent/commit/ack, #31(4.3) lease/fencing/recovery, #32(4.4) retry/cancel/outcome_unknown, #33(4.5) validated input, #34(4.6) reconciliation — доменная семантика Crank, SDK её не заменяет. Эти части могут идти независимо при непересекающихся writers; существующие их dependencies/AC сохраняются. #35(4.7) revision-specific Tasks wire/advertisement/fallback должен учитывать принятый SDK seam, поэтому добавлена dependency на #106; при активном переносе #107 один writer MCP-файлов, не параллельное редактирование. Domain results не выдаются за готовый public runtime/Tasks extension. Нагрузочный STOP/ceilings и production manual-only сохраняются.

Планирование rmcp по решению владельца27.10.2026 опубликовано в существующем Epic3: #106 → #107 → #108 (Backlog, не запущены). Полные scoped AC готовы из docs/development/rmcp-migration-plan.md; новый PRD/аудит не нужен. #106 продолжает FR-13/AT-3.1-14: исполняемая проверка SDK и краткое evidence-backed архитектурное/dependency решение TL, а не презумпция несовместимости по историческому default «свой transport». Владелец одобрил планирование, не автоматический dependency change/production switch. Обе revisions и весь ранее подтверждённый MCP scope сохраняются. Сначала завершить проверку поставки4.1 (t_d1fdbddf→t_cfa693e8), затем отдельно назначить исполнение #106; положительный результат и решение TL открывают #107, принятый перенос открывает #108. Совместимость ещё не доказана. Сопоставление будущих4.2–4.7: #30(4.2) Task+intent/commit/ack, #31(4.3) lease/fencing/recovery, #32(4.4) retry/cancel/outcome_unknown, #33(4.5) validated input, #34(4.6) reconciliation — доменная семантика Crank, SDK её не заменяет. Эти части могут идти независимо при непересекающихся writers; существующие их dependencies/AC сохраняются. #35(4.7) revision-specific Tasks wire/advertisement/fallback должен учитывать принятый SDK seam, поэтому добавлена dependency на #106; при активном переносе #107 один writer MCP-файлов, не параллельное редактирование. Domain results не выдаются за готовый public runtime/Tasks extension. Нагрузочный STOP/ceilings и production manual-only сохраняются.
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Reference: bsodfather/crank#8