# Исходный подробный контракт этапа 3 Снимок локального плана `_bmad-output/planning-artifacts/epics.md`. Исходная ревизия: `78dc060b8a5086b1cc7a1bec77385a0f2471fbf3`. Дата переноса: 2026-10-04. Технический текст ниже сохранён дословно, чтобы перенос не изменял обязательные критерии. Основные описания этапов и задач в Gitea написаны на русском языке. ## Epic 3: Полноценный современный MCP-каталог Пользователь создаёт и публикует Tools, Resources и Prompts, связывает их с Agent и использует через совместимые MCP-клиенты. ### 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 выбираются latest stable revision и две предыдущие поддерживаемые stable revisions **And** конкретные versions, source digests и дата выбора фиксируются в Capability Inventory. **Given** существующая поддержка `2025-03-26` **When** selected stable window её больше не включает **Then** revision сохраняется до отдельного evidence-backed deprecation gate **And** удаление не выполняется попутно с добавлением новых 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** capability рекламируется только совместимому opted-in клиенту **And** 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 selected `2025-*`, malformed/unsupported versions, concurrent mixed clients и disabled experimental adapters **And** advertised capabilities byte-for-byte соответствуют executable inventory. **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 остаётся обязательной при любом выборе. ### Story 3.2: Обнаруживать Published Tools **Depends on:** Story 3.1 **Work type:** implementation **Deliverable:** Обнаруживать Published Tools. **Completion:** outcome этой story и все её AC проверены; будущая qualification не выполняется попутно. As an MCP-пользователь, I want надёжно получать точный список опубликованных Tools, So that discovery и pagination соответствуют immutable Agent catalog. **Requirements:** FR-14 **Acceptance Criteria:** **Given** авторизованный клиент Published Agent **When** он вызывает `tools/list` **Then** service возвращает только Tools immutable Agent snapshot с точными names, descriptions и input/output schemas **And** Draft, archived/unpublished Agent или capability вне Agent scope не обнаруживается. **Given** Tool list больше page limit **When** клиент запрашивает следующую страницу **Then** используется opaque bounded cursor, связанный с Agent Version, `catalog_revision`, authorization scope и stable ordering **And** cursor другого Agent/revision либо malformed cursor отклоняется safe protocol error. **Given** catalog изменился после выдачи cursor **When** клиент продолжает старую pagination **Then** service возвращает explicit stale-cursor outcome либо version-consistent snapshot согласно negotiated revision **And** страницы разных revisions не смешиваются и не пропускают/дублируют Tools молча. **Given** production-size Agent catalog **When** выполняется `tools/list` **Then** discovery соответствует NFR-P4 ≤150 ms p95 и не загружает полный catalog в transport memory **And** schema serialization остаётся bounded. **Given** Tools discovery suite **When** она выполняется для каждой supported revision **Then** покрыты scope, schemas, pagination, malformed/stale cursor, revision consistency и negative auth **And** protocol fixtures, representative client smoke и `just verify` проходят. ### Story 3.3: Вызывать Published Tools со structured outcomes **Depends on:** Story 3.2 **Work type:** implementation **Deliverable:** Вызывать Published Tools со structured outcomes. **Completion:** outcome этой story и все её AC проверены; будущая qualification не выполняется попутно. As an MCP-пользователь, I want безопасно вызывать Tool и получать revision-correct результат, So that validation и ошибки не зависят от transport implementation. **Requirements:** FR-14 **Acceptance Criteria:** **Given** валидный `tools/call` **When** client передаёт input **Then** input валидируется против exact Published Operation schema до execution **And** неизвестные, missing, wrong-type или oversized values возвращают structured schema error без outbound dispatch. **Given** успешное Tool execution **When** runtime возвращает normalized outcome **Then** version adapter формирует допустимые negotiated structured content и metadata **And** raw upstream response, internal DTO или unsupported content variant не пересекают MCP boundary. **Given** request MCP `2026-07-28` содержит request-scoped `_meta` **When** Tool service обрабатывает вызов **Then** adapter валидирует size/schema, передаёт только разрешённые typed hints и не использует untrusted metadata для authorization, scope или metric labels **And** legacy adapters не получают неподдерживаемые поля и не меняют семантику Tool. **Given** negotiated revision поддерживает `resultType`, cache hints либо multi-round Tool result contract **When** Tool формирует результат **Then** adapter выдаёт только опубликованный и валидированный contract этой revision либо machine-readable `not_applicable` evidence **And** legacy result остаётся revision-correct без неизвестных полей или скрытого continuation state. **Given** schema, authorization, approval, mapping, outbound, upstream или runtime failure **When** Tool call завершается ошибкой **Then** клиент получает structured safe error с корректным protocol shape и explicit retryability там, где revision это допускает **And** Invocation History сохраняет точную internal outcome taxonomy, Request ID и Trace ID. **Given** production Reference Workload **When** выполняется `tools/call` **Then** platform execution overhead соответствует NFR-P4 p95/p99 limits **And** input/result/error handling остаётся bounded. **Given** Tools call suite **When** она выполняется для каждой supported revision **Then** покрыты schema validation, structured success/errors, approval, upstream/runtime failures и negative auth scope **And** protocol fixtures, real runtime path и `just verify` проходят. ### Story 3.4: Управлять progress и cancellation Tool calls **Depends on:** Story 3.3 **Work type:** implementation **Deliverable:** Управлять progress и cancellation Tool calls. **Completion:** outcome этой story и все её AC проверены; будущая qualification не выполняется попутно. As an MCP-пользователь, I want управлять progress и cancellation активного Tool call, So that клиент остаётся отзывчивым без ложных terminal outcomes. **Requirements:** FR-14 **Acceptance Criteria:** **Given** клиент согласовал progress capability и передал допустимый progress token **When** synchronous execution сообщает progress **Then** server отправляет bounded monotonic progress updates в допустимом negotiated format **And** отсутствие progress support либо token не влияет на корректность execution result. **Given** malformed, reused в недопустимом scope или oversized progress token **When** Tool call начинается **Then** token отклоняется либо progress отключается согласно specification **And** token не попадает в metric labels, logs или authorization scope. **Given** клиент отправляет cancellation для active Tool call **When** local execution ещё может быть остановлена **Then** cancellation кооперативно распространяется через runtime и освобождает bounded resources **And** result/Invocation History не получает ложный `completed` state. **Given** cancellation или timeout после возможного outbound dispatch **When** внешний outcome нельзя подтвердить **Then** server не утверждает, что side effect отменён или не произошёл **And** write без idempotency не ретраится автоматически. **Given** Tools execution-lifecycle suite **When** она выполняется для каждой supported revision **Then** покрыты progress token bounds, monotonic updates, cancellation races и ambiguous outbound outcome **And** protocol fixtures, representative client smoke и `just verify` проходят. ### Story 3.5: Отправлять Tool catalog change signals **Depends on:** Story 3.4 **Work type:** implementation **Deliverable:** Отправлять Tool catalog change signals. **Completion:** outcome этой story и все её AC проверены; будущая qualification не выполняется попутно. As an MCP-пользователь, I want получать Tool catalog changes после commit, So that обновляю discovery без зависимости от доставки notification. **Requirements:** FR-14 **Acceptance Criteria:** **Given** Agent публикует новый catalog revision **When** negotiated client поддерживает tools list-changed notification **Then** server отправляет bounded notification после commit **And** notification не является единственным источником каталога: повторный `tools/list` остаётся authoritative. **Given** client не поддерживает list-changed notification **When** catalog обновляется **Then** server не отправляет неподдерживаемое сообщение **And** новый snapshot доступен при следующем обычном discovery request. **Given** Tools execution-lifecycle suite **When** она выполняется для каждой supported revision **Then** покрыты list-changed negotiation, post-commit delivery и authoritative discovery при отсутствии notification support **And** protocol fixtures, representative client smoke и `just verify` проходят. ### Story 3.6: Сохранять typed static Resource Drafts **Depends on:** Story 3.5 **Work type:** implementation **Deliverable:** Сохранять typed static Resource Drafts. **Completion:** outcome этой story и все её AC проверены; будущая qualification не выполняется попутно. As an администратор, I want безопасно сохранять text, JSON и binary Resource Drafts, So that content имеет typed contract, bounded artifact и безопасный preview. **Requirements:** FR-15, FR-16 **Acceptance Criteria:** **Given** Resource domain model **When** добавляется persistence и API contract **Then** Resource является отдельным typed aggregate с собственными ID/version/lifecycle, `CapabilityKind::Resource`, sensitivity и immutable Published Version **And** не хранится как untyped Operation subtype или универсальный JSON blob. **Given** новый Resource Draft **When** администратор выбирает static text, JSON или binary kind **Then** задаются URI, name, description, MIME type, sensitivity и bounded content **And** URI и name валидируются как стабильные capability identifiers. **Given** static content **When** оно сохраняется **Then** bytes размещаются в content-addressed artifact store, а Resource Version хранит exact digest и metadata **And** filesystem path, raw upload filename или mutable external reference не входит в published contract. **Given** JSON Resource **When** Draft сохраняется или preview-ится **Then** content валидируется как JSON и возвращается без изменения data semantics **And** malformed либо oversized JSON отклоняется до publication. **Given** text Resource **When** content принимается **Then** он сохраняет валидный UTF-8 в пределах configured size **And** invalid encoding или unsafe truncation отклоняются с stable finding. **Given** binary Resource **When** он preview-ится или читается через MCP **Then** MIME, byte size и negotiated binary representation соблюдаются version adapter **And** content не декодируется как text и не помещается целиком в logs/errors. **Given** Resource с active либо browser-renderable content type, включая HTML или SVG **When** Admin UI показывает preview/download **Then** untrusted bytes не исполняются в origin Crank: используется inert text/metadata, sandboxed isolated preview либо attachment download по explicit allowlist **And** response применяет safe `Content-Type`, `nosniff`, CSP/sandbox и filename sanitization без content sniffing. **Given** static Resource Draft suite **When** выполняются domain, artifact и API tests **Then** покрыты text/JSON/binary validation, MIME/size, active-content preview, malformed encoding и artifact integrity **And** `just verify` проходит. ### Story 3.7: Публиковать и привязывать static Resource Versions **Depends on:** Story 3.6 **Work type:** implementation **Deliverable:** Публиковать и привязывать static Resource Versions. **Completion:** outcome этой story и все её AC проверены; будущая qualification не выполняется попутно. As an администратор, I want публиковать проверенный Resource Draft и привязывать exact version к Agent, So that MCP catalog получает immutable context с правильной sensitivity. **Requirements:** FR-15, FR-16 **Acceptance Criteria:** **Given** Resource Draft **When** администратор выполняет preview/test read **Then** UI показывает точный content type, size, safe preview и findings без публикации **And** binary preview не раскрывает unbounded bytes в DOM или telemetry. **Given** publish request **When** publication validator выполняется **Then** проверяются URI, MIME, size, sensitivity, artifact digest/integrity и secret findings **And** raw credential, private key либо access-bypassing reference блокирует publication. **Given** валидный Resource Draft **When** администратор публикует его **Then** создаётся immutable Published Resource Version **And** последующее редактирование создаёт новый Draft без изменения published bytes или metadata. **Given** Agent Draft **When** администратор добавляет Resource binding **Then** binding ссылается на exact Published Resource Version через отдельную typed binding table **And** Agent publication атомарно включает Resource в immutable catalog snapshot и повышает `catalog_revision`. **Given** Resource lifecycle API/UI **When** выполняются create, upload, preview, publish, bind или archive **Then** доступны loading, empty, validation, error, confirmation, stale-response и RU/EN states **And** UI различает Draft, exact Published Version, MIME, size и effective sensitivity. **Given** static Resource lifecycle suite **When** выполняются domain, artifact, registry, API и Playwright tests **Then** покрыты preview, secret scan, immutable publication, exact binding, archive и stale Agent revision **And** `just verify` проходит. ### Story 3.8: Обнаруживать и читать static Resources через MCP **Depends on:** Story 3.7 **Work type:** implementation **Deliverable:** Обнаруживать и читать static Resources через MCP. **Completion:** outcome этой story и все её AC проверены; будущая qualification не выполняется попутно. As an MCP-пользователь, I want находить и читать bound static Resources, So that получаю exact published bytes без раскрытия чужих capabilities. **Requirements:** FR-15, FR-16 **Acceptance Criteria:** **Given** авторизованный MCP-клиент Published Agent **When** он вызывает Resource discovery/list **Then** service возвращает только bound Published Resources с opaque revision-scoped pagination **And** Draft, foreign или unbound Resource не обнаруживается. **Given** клиент вызывает `resources/read` для bound static URI **When** access и size checks успешны **Then** version adapter возвращает exact published text/JSON/binary content и MIME в negotiated shape **And** Request ID/Trace ID и read outcome сохраняются без content capture в telemetry. **Given** клиент вызывает неизвестный, Draft либо unbound Resource **When** service разрешает URI **Then** request получает safe not-found/denied protocol outcome без metadata leakage **And** artifact bytes не читаются до authorization. **Given** Published Resource Version архивирована после фиксации в Agent snapshot **When** существующий Agent читает exact bound version **Then** archive запрещает новые bindings/publications, но не ломает воспроизводимое чтение immutable snapshot **And** явная security revocation остаётся отдельным audited state transition и fail-closed contract. **Given** static Resource protocol suite **When** она выполняется для каждой supported MCP revision **Then** покрыты точные `resources/list` и `resources/read`, scope, pagination, archive/revocation, text/JSON/binary read, MIME/size, safe errors и artifact corruption **And** discovery соответствует NFR-P4 ≤150 ms p95, representative clients и `just verify` проходят. ### Story 3.9: Импортировать, экспортировать и сопровождать Resources в UI **Depends on:** Story 3.8 **Work type:** implementation **Deliverable:** Импортировать, экспортировать и сопровождать Resources в UI. **Completion:** outcome этой story и все её AC проверены; будущая qualification не выполняется попутно. As an администратор, I want переносить и сопровождать Resource Versions через безопасный UI, So that lifecycle остаётся воспроизводимым между установками. **Requirements:** FR-15 **Acceptance Criteria:** **Given** Resource export/import **When** администратор переносит Draft или Published Version **Then** wire metadata и content digest сохраняются, content передаётся bounded artifact contract **And** импорт создаёт новый owned Draft для явной проверки/публикации; raw filesystem paths, credentials, foreign ownership metadata и автоматическая Published state отсутствуют. **Given** Resource UI на RU и EN **When** выполняются list, inspect, import, export или archive **Then** присутствуют loading, empty, validation, error, confirmation и stale-response states **And** UI явно различает Draft и точную Published Version. **Given** Resource portability suite **When** выполняются roundtrip, malformed/oversized artifact, cross-workspace и stale UI cases **Then** wire metadata/content digest сохраняются, secrets/internal paths отсутствуют **And** Playwright и `just verify` проходят. ### Story 3.10: Определять и публиковать REST-backed Resource templates **Depends on:** Story 3.9 **Work type:** implementation **Deliverable:** Определять и публиковать REST-backed Resource templates. **Completion:** outcome этой story и все её AC проверены; будущая qualification не выполняется попутно. As an администратор, I want определить безопасный REST-backed Resource template, So that dynamic context публикуется только через pinned read-safe Operation. **Requirements:** FR-16 **Acceptance Criteria:** **Given** новый dynamic Resource Draft **When** администратор выбирает REST-backed kind **Then** Resource ссылается только на exact Published Operation Version того же workspace **And** arbitrary URL, inline request definition или Draft Operation не принимаются. **Given** выбранная Published Operation Version **When** publication validator проверяет Resource **Then** разрешены только read-safe `GET` или `HEAD` Operations без destructive semantics **And** write method, approval-required side effect или неподтверждённая read-safety classification блокирует публикацию. **Given** URI template Resource **When** администратор определяет template parameters **Then** каждый parameter имеет typed schema, required/default/enum/format и однозначное mapping в pinned Operation input **And** неизвестный, duplicate или unmapped parameter создаёт blocker finding. **Given** URI template Resource задаёт cache и failure policy **When** publication validator проверяет Draft **Then** TTL/vary/size и safe failure outcome typed, bounded и совместимы с effective Agent/workspace/auth scope **And** неограниченный cache, cross-scope reuse или arbitrary fallback content блокируют публикацию и объясняются в UI. **Given** Dynamic Resource definition UI **When** выполняются source selection, parameter mapping, preview validation или publish **Then** присутствуют loading, empty, validation, error, confirmation, stale-response и RU/EN states **And** UI показывает pinned Operation Version, read-safety и effective sensitivity/access policy. **Given** template publication suite **When** выполняются API/registry/Playwright tests **Then** покрыты exact source version, GET/HEAD restriction, parameter mapping, host/scheme injection и immutable publication **And** `just verify` проходит. ### Story 3.11: Читать REST-backed Resources через общий runtime **Depends on:** Story 3.10 **Work type:** implementation **Deliverable:** Читать REST-backed Resources через общий runtime. **Completion:** outcome этой story и все её AC проверены; будущая qualification не выполняется попутно. As an MCP-пользователь, I want читать параметризованные Resources из разрешённых REST sources, So that Agent получает актуальный context без отдельного небезопасного network path. **Requirements:** FR-16 **Acceptance Criteria:** **Given** template URI и входные параметры **When** MCP-клиент вызывает `resources/read` **Then** parameters валидируются до execution и кодируются согласно URI-template contract **And** traversal, delimiter injection, выход за разрешённый root и добавление произвольного host/scheme запрещены. **Given** Published Agent с bound Resource template **When** клиент вызывает `resources/templates/list` **Then** он получает только разрешённые templates, parameter metadata и MIME expectations exact Agent snapshot с revision-correct pagination **And** Draft, foreign или unbound templates не обнаруживаются. **Given** валидный dynamic Resource read **When** начинается получение данных **Then** request проходит через `RuntimeExecutionRequest → crank-runtime → crank-adapter-rest` и shared OutboundPolicy **And** Resource не имеет отдельного network path, обходящего SSRF, authentication, timeout, limits или correlation. **Given** pinned Operation использует Auth Profile **When** Resource выполняет read **Then** runtime разрешает credential только через exact `AuthProfileRef` и Agent/workspace scope **And** secret не попадает в URI, cache key, Resource content, logs или protocol result. **Given** успешный REST response **When** Resource mapping завершается **Then** результат преобразуется только в опубликованный text, JSON или binary content contract с точным MIME и size limit **And** unsupported content type или mapping failure не возвращается как arbitrary fallback text. **Given** `HEAD` Resource либо response без body **When** contract допускает metadata-only result **Then** возвращается явно опубликованное metadata representation **And** отсутствие body не интерпретируется как JSON parsing failure. **Given** configured Resource cache policy **When** identical read повторяется **Then** cache key включает Resource Version, canonical parameters и полный Agent/workspace/auth scope **And** потеря Valkey приводит к корректному uncached read, а не к cross-scope result или failure correctness. **Given** pinned Operation была revoked, archived либо её Auth Profile отозван **When** выполняется новый Resource read **Then** admission повторно проверяет текущую safety eligibility и fail closed до dispatch **And** immutable Resource Version не переписывается, а error указывает безопасный recovery path. **Given** upstream timeout, oversized response или policy denial **When** dynamic read завершается ошибкой **Then** MCP получает structured safe Resource error с Request ID/Trace ID **And** raw URL, credential, response body и внутренний network address не раскрываются. **Given** Dynamic Resource read UI на RU и EN **When** выполняются preview/test read или failure recovery **Then** присутствуют loading, empty, validation, error, confirmation и stale-response states **And** preview показывает pinned Operation Version и effective sensitivity/access policy. **Given** dynamic Resource suite **When** выполняются contract и negative tests **Then** покрыты template discovery/read, parameter validation, traversal, host injection, SSRF, auth scope, cache isolation/loss, MIME/size, revoked dependency и empty responses **And** каждая supported MCP revision, Playwright и `just verify` проходят. ### Story 3.12: Создавать и preview-ить parameterized Prompt Drafts **Depends on:** Story 3.1, Story 1.13 **Work type:** implementation **Deliverable:** Создавать и preview-ить parameterized Prompt Drafts. **Completion:** outcome этой story и все её AC проверены; будущая qualification не выполняется попутно. As an администратор, I want создавать typed Prompt Draft и проверять rendering, So that получаю валидированный шаблон до публикации. **Requirements:** FR-17 **Acceptance Criteria:** **Given** Prompt domain model **When** добавляются persistence и API **Then** Prompt является отдельным typed aggregate с ID/version/lifecycle, typed arguments, sensitivity и immutable Published Version **And** не хранится как Tool либо untyped template blob. **Given** Prompt Draft **When** задаются name, description, arguments и messages **Then** argument names уникальны, schemas bounded, required/default/enum semantics валидны, а message roles принадлежат exact enum `system|user|assistant` и сохраняют порядок/границы **And** arbitrary code, executable expression и unbounded interpolation запрещены. **Given** preview/test request **When** arguments валидны **Then** renderer детерминированно возвращает итоговые messages без публикации **And** missing, unknown или invalid argument возвращает structured error до частичного rendering. **Given** Prompt UI на RU и EN **When** выполняются create, preview или validation failure **Then** присутствуют loading, empty, error, confirmation и stale-response states **And** UI различает Draft и exact Published Version. **Given** Prompt suite **When** выполняются API/Playwright tests **Then** покрыты Draft lifecycle, typed arguments, deterministic preview и scope isolation **And** `just verify` проходит. ### Story 3.13: Публиковать Prompts и привязывать exact versions к Agent **Depends on:** Story 3.12 **Work type:** implementation **Deliverable:** Публиковать Prompts и привязывать exact versions к Agent. **Completion:** outcome этой story и все её AC проверены; будущая qualification не выполняется попутно. As an администратор, I want публиковать и привязывать exact Prompt Version, So that Agent snapshot сохраняет immutable contract. **Requirements:** FR-17 **Acceptance Criteria:** **Given** валидный Draft **When** Prompt публикуется **Then** создаётся immutable Published Prompt Version, а последующее изменение создаёт новый Draft **And** published arguments/messages не меняются in place. **Given** Agent Draft **When** добавляется Prompt binding **Then** binding указывает exact Published Prompt Version в отдельной typed table **And** Agent publication атомарно включает Prompt в snapshot и повышает `catalog_revision`. **Given** Prompt UI на RU и EN **When** выполняются publish, bind, archive или validation failure **Then** присутствуют loading, empty, error, confirmation и stale-response states **And** UI различает Draft и exact Published Version. **Given** Prompt suite **When** выполняются API/Playwright tests **Then** покрыты publication/archive lifecycle, exact binding, scope isolation и immutable versions **And** `just verify` проходит. ### Story 3.14: Обнаруживать и получать Published Prompts через MCP **Depends on:** Story 3.13 **Work type:** implementation **Deliverable:** Обнаруживать и получать Published Prompts через MCP. **Completion:** outcome этой story и все её AC проверены; будущая qualification не выполняется попутно. As an MCP-пользователь, I want обнаруживать и получать bound Published Prompts, So that получаю детерминированные сообщения с проверкой arguments и scope. **Requirements:** FR-17 **Acceptance Criteria:** **Given** авторизованный MCP-клиент **When** вызывается `prompts/list` **Then** видны только bound Published Prompts с revision-scoped pagination и typed argument metadata **And** Draft, foreign либо unbound Prompt не раскрывается. **Given** авторизованный клиент вызывает `prompts/get` **When** argument missing, unknown, wrong-type либо oversized **Then** server возвращает structured revision-correct error до любого partial rendering **And** ни одна часть messages, dependency content или foreign metadata не раскрывается. **Given** Published Prompt Version архивирована после фиксации в Agent snapshot **When** существующий Agent получает exact bound version через `prompts/get` **Then** archive запрещает новые bindings/publications, но сохраняет immutable snapshot behavior **And** security revocation/dependency invalidation остаётся отдельным fail-closed state. **Given** Prompt suite **When** выполняются API/MCP/Playwright tests для каждой revision **Then** покрыты typed arguments, deterministic rendering, pagination, exact binding, scope isolation и immutable versions **And** discovery ≤150 ms p95 и `just verify` проходит. ### Story 3.15: Импортировать и экспортировать Prompts через API и UI **Depends on:** Story 3.14 **Work type:** implementation **Deliverable:** Импортировать и экспортировать Prompts через API и UI. **Completion:** outcome этой story и все её AC проверены; будущая qualification не выполняется попутно. As an администратор, I want переносить Prompts через import/export, So that сохраняю wire contract без изменения Published Version. **Requirements:** FR-17 **Acceptance Criteria:** **Given** Prompt import/export **When** переносится версия **Then** wire contract сохраняет arguments/messages и exact metadata без secrets/internal paths **And** upsert создаёт новый Draft, не меняя Published Version. **Given** Prompt UI на RU и EN **When** выполняются import/export или validation failure **Then** присутствуют loading, empty, error, confirmation и stale-response states **And** UI различает Draft и exact Published Version. **Given** Prompt suite **When** выполняются API/Playwright tests **Then** покрыты import/export roundtrip, Draft-only upsert, scope isolation и immutable versions **And** `just verify` проходит. ### Story 3.16: Компоновать Prompts с Published Resources **Depends on:** Story 3.7, Story 3.11, Story 3.14 **Work type:** implementation **Deliverable:** Компоновать Prompts с Published Resources. **Completion:** outcome этой story и все её AC проверены; будущая qualification не выполняется попутно. As an администратор, I want включать разрешённые Resources в Prompt messages, So that Agent получает составной контекст с фиксированными dependencies и effective security policy. **Requirements:** FR-18 **Acceptance Criteria:** **Given** Prompt Draft **When** добавляется Resource dependency **Then** она ссылается только на exact Published Resource Version того же workspace **And** Draft, foreign или mutable reference блокируется. **Given** dependency graph Prompts/Resources **When** выполняется publication validation **Then** graph детерминированно проверяется на cycles, missing/unpublished nodes и bounded depth/count **And** любой unresolved cycle/dependency блокирует публикацию с source path. **Given** dependency с более строгой sensitivity/access policy **When** вычисляется effective Prompt policy **Then** Prompt наследует наиболее строгие ограничения всех dependencies **And** администратор не может понизить их локальным override. **Given** render Prompt **When** Resource reference разрешается **Then** используется exact pinned version и разрешённый negotiated representation **And** rendering не выполняет arbitrary Tool/code и не обращается к unbound capability. **Given** static или dynamic Resource содержит инструкции, role-like delimiters либо иной untrusted external text **When** content вставляется в Prompt messages **Then** published template сохраняет фиксированные message roles/boundaries и provenance exact Resource Version/source class **And** Resource content не может создать/заменить system message, а UI явно обозначает untrusted provenance и не обещает semantic prompt-injection sanitization. **Given** dynamic Resource dependency **When** Prompt get инициирует разрешённое чтение **Then** Resource проходит собственный authorization/outbound/size contract **And** failure возвращается структурированно без partial secret-bearing Prompt. **Given** secret scan или access-bypassing content finding **When** Prompt публикуется либо preview-ится **Then** raw credentials и fallback-as-tool paths блокируются **And** logs, traces и preview содержат только redacted findings. **Given** dependency получает новую version или archive status **When** опубликованный Prompt читается **Then** exact pinned dependency сохраняется immutable, но current safety eligibility revalidated там, где требуется **And** обновление dependency требует нового Prompt Draft/publication. **Given** администратор preview-ит composed Prompt **When** dependencies и arguments разрешены **Then** UI показывает итоговые ordered messages, exact Resource Versions, provenance и effective sensitivity без выполнения arbitrary Tool/code **And** loading, empty, validation, error, stale-response, keyboard/focus и RU/EN states покрыты Playwright. **Given** composition tests **When** выполняются graph, rendering и scope suites **Then** покрыты cycles, missing versions, sensitivity escalation, dynamic failure, secret scan, role/delimiter injection, provenance и deterministic output **And** MCP/Playwright tests и `just verify` проходят. ### Story 3.17: Предоставить MCP completion **Depends on:** Story 3.16 **Work type:** implementation **Deliverable:** Предоставить MCP completion. **Completion:** outcome этой story и все её AC проверены; будущая qualification не выполняется попутно. As an MCP-пользователь, I want получать bounded completion suggestions, So that могу заполнять Prompt и Resource parameters без раскрытия чужих данных. **Requirements:** FR-19 **Acceptance Criteria:** **Given** negotiated revision/capabilities **When** клиент вызывает completion для Prompt argument или Resource template parameter **Then** shared completion service возвращает bounded authorized suggestions из typed schemas **And** не раскрывает foreign names, secrets или arbitrary database values. **Given** malformed token или completion request **When** method service валидирует вход **Then** возвращается revision-correct safe error без unbounded work **And** идентификаторы не попадают в metric labels. **Given** capability suite **When** выполняется по всем supported revisions **Then** покрыты positive/negative completion и authorization **And** representative clients и `just verify` проходят. ### Story 3.18: Предоставить безопасное MCP server logging **Depends on:** Story 3.17 **Work type:** implementation **Deliverable:** Предоставить безопасное MCP server logging. **Completion:** outcome этой story и все её AC проверены; будущая qualification не выполняется попутно. As an MCP-пользователь, I want задавать допустимый server logging level, So that получаю безопасные negotiated events. **Requirements:** FR-19 **Acceptance Criteria:** **Given** server logging capability **When** клиент задаёт допустимый level **Then** adapter отправляет только safe structured events в рамках negotiated contract **And** payloads, credentials, internal causes и user values не раскрываются. **Given** malformed logging level **When** method service валидирует вход **Then** возвращается revision-correct safe error без unbounded work **And** идентификаторы не попадают в metric labels. **Given** capability suite **When** выполняется по всем supported revisions **Then** покрыты logging levels и redaction **And** representative clients и `just verify` проходят. ### Story 3.19: Отправлять Resource и Prompt change signals **Depends on:** Story 3.18 **Work type:** implementation **Deliverable:** Отправлять Resource и Prompt change signals. **Completion:** outcome этой story и все её AC проверены; будущая qualification не выполняется попутно. As an MCP-пользователь, I want получать Resource/Prompt change signals, So that восстанавливаю authoritative catalog при потере notification. **Requirements:** FR-19 **Acceptance Criteria:** **Given** Resource/Prompt catalog commit **When** client поддерживает соответствующий list-changed signal **Then** notification отправляется после commit и может coalesce-иться по revision **And** обычный list/read/get остаётся authoritative при потере notification. **Given** exporter/transport/notification failure **When** critical catalog state уже committed **Then** failure наблюдаема, но не откатывает product transaction **And** stateless client восстанавливает состояние через `server/discover` и обычные list/read/get, а legacy client — через свой revision-correct reinitialize/reconnect contract. **Given** capability suite **When** выполняется по всем supported revisions **Then** покрыты Resource/Prompt notification/subscription gating, coalescing и loss **And** representative clients и `just verify` проходят. ### Story 3.20: Учредить исполняемую MCP compatibility matrix **Depends on:** Story 3.19 **Work type:** implementation **Deliverable:** Учредить исполняемую MCP compatibility matrix. **Completion:** outcome этой story и все её AC проверены; будущая qualification не выполняется попутно. As a пользователь Community release, I want видеть доказанную совместимость MCP versions, methods и клиентов, So that могу выбрать поддерживаемый клиент без доверия к декларациям. **Requirements:** FR-20 **Acceptance Criteria:** **Given** feature-freeze inventory **When** строится machine-readable matrix **Then** она охватывает 100% official stable server capabilities/extensions для latest stable, N-1/N-2 и retained legacy revisions, включая явные cells, владельцев и target Story для ещё не реализованного Tasks extension **And** каждый cell содержит supported/not-applicable/experimental/deferred, fixture и fallback. **Given** применимая stable server capability **When** status остаётся `deferred` или evidence отсутствует **Then** matrix verifier fail closed и блокирует feature-complete gate **And** documentation не может скрыть omission. **Given** завершение любой Story 3.1–3.19 **When** её capability contract становится green **Then** соответствующие machine-readable matrix cells и deterministic wire fixtures добавляются в той же Story **And** Story 3.20 не используется для восполнения отложенного conformance coverage. **Given** protocol harness **When** запускаются selected revisions **Then** отдельно проверяются `server/discover`/stateless lifecycle `2026-07-28`, initialize/session lifecycle legacy adapters, request metadata, Tools, Resources, Prompts, completion, logging, progress, cancellation, subscriptions/pagination и notifications; Tasks cells допускаются planned только до owning Story Epic 4 **And** expected wire fixtures versioned и deterministic. **Given** representative client set **When** до RC выбираются минимум три актуальных клиента **Then** versions/images/config фиксируются, каждый выполняет published discovery и representative calls **And** client-specific workaround документирован и не меняет stable internal semantics. **Given** experimental adapter **When** он включён или выключен **Then** matrix отделяет его evidence от stable contract **And** critical Tool остаётся вызываемым stable клиентом. **Given** matrix result **When** release evidence формируется **Then** raw results content-addressed и связаны с commit/image/config digests **And** human-readable matrix проверяется против machine source. **Given** regression либо новая MCP revision после freeze **When** она обнаружена **Then** текущий RC contract не меняется молча, изменение входит в следующий compatibility cycle либо новый freeze decision **And** fixed regression добавляет protocol fixture. **Given** завершение Epic 3 **When** выполняются protocol/client suites **Then** FR-13…FR-20 catalog/core cells имеют immutable evidence, applicable NFR выполняются, Capability Inventory обновлена, а Tasks extension имеет explicit owner в Epic 4 и blocker status до её evidence **And** `just verify` проходит без удаления retained compatibility или ложного утверждения полной release qualification.