3-1. Согласование версий MCP и доступных возможностей #8
Notifications
Due Date
No due date set.
Blocks
#9 3-2. Список опубликованных инструментов через MCP
bsodfather/crank
#19 3-12. Черновики шаблонов запросов с параметрами
bsodfather/crank
#28 3-Р. Итоговая ретроспектива этапа 3
bsodfather/crank
Reference: bsodfather/crank#8
Reference in new issue
Block a user
Результат задачи
Обеспечить явное согласование версии протокола и точное объявление поддерживаемых возможностей сервера.
Что необходимо сделать и проверить
2026-07-28и2025-11-25с источниками и датой выбора.Зависимости
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
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 targetAnd применимая stable capability со status
deferredблокирует feature-complete gate.Given клиент MCP
2026-07-28When он начинает работу с public endpoint
Then stateless adapter обслуживает обязательный
server/discover, request-scoped metadata и применимые стандартные headers без initialize/session dependencyAnd рекламирует только реально реализованные 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 negotiationAnd конкретный 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-mcptransport boundaryAnd core/application services не импортируют protocol-version DTOs.
Given protocol fixture suite
When выполняется negotiation matrix
Then RED-first wire fixtures покрывают
server/discover/stateless lifecycle2026-07-28, initialize/session lifecycle2025-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-28Then выполняется bounded compatibility assessment против существующих architecture boundaries, MSRV и transport tests
And default decision сохраняет существующий transport; SDK принимается только отдельным evidence-backed ADR/dependency change, а wire-level conformance остаётся обязательной при любом выборе.
Планирование 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 сохраняются.