# Исходный подробный контракт этапа 8 Снимок локального плана `_bmad-output/planning-artifacts/epics.md`. Исходная ревизия: `78dc060b8a5086b1cc7a1bec77385a0f2471fbf3`. Дата переноса: 2026-10-04. Технический текст ниже сохранён дословно, чтобы перенос не изменял обязательные критерии. Основные описания этапов и задач в Gitea написаны на русском языке. ## Epic 8: Доказанный production-релиз Команда всесторонне проверяет один immutable RC, формирует подписанное evidence, публикует честную readiness page и только после прохождения gate разрешает анонс на Хабре. ### Story 8.1: Зафиксировать immutable RC и Evidence Manifest contract **Depends on:** Story 7.9 **Work type:** implementation **Deliverable:** Зафиксировать immutable RC и Evidence Manifest contract. **Completion:** outcome этой story и все её AC проверены; будущая qualification не выполняется попутно. As a release owner, I want привязать все проверки к одному неизменяемому кандидату, So that release нельзя объявить готовым на смеси разных builds и configurations. **Requirements:** FR-52 **Acceptance Criteria:** **Given** release candidate build **When** он замораживается **Then** фиксируются source revision, Rust/Node toolchains, binary/package/image/offline-bundle digests и release identifier **And** любая пересборка или изменение bytes создаёт новый RC. **Given** production qualification environment **When** она регистрируется **Then** content-addressed artifacts фиксируют deployment/config fingerprints, component versions, workload/corpus/matrix versions и environment class **And** raw secrets/hosts/user data отсутствуют. **Given** Evidence Manifest schema **When** принимается evidence item **Then** versioned JSON Schema требует requirement/gate IDs, RC/artifact/config digests, commands, started/completed times, result, output digests, reviewer/owner и freshness **And** unknown status, missing linkage или malformed time fail validation. **Given** automated или manual evidence **When** оно добавляется **Then** raw bounded artifacts сохраняются content-addressed, manifest append/revision history audit-able **And** fail/blocked/not-run никогда не нормализуются в pass. **Given** release-signing step **When** manifest snapshot подписывается **Then** signature охватывает schema version, all referenced digests и gate inputs через documented offline trust root **And** missing/altered/expired evidence делает validation fail closed. **Given** release-signing trust root и signer identity **When** key создаётся, ротируется, отзывается либо объявляется скомпрометированным **Then** versioned offline policy задаёт custody, allowed algorithms, validity, threshold/approval, public-key distribution и revocation statement **And** verifier fail closed для unknown/revoked key, не требует online signer и не принимает rollback на более старый trust state без explicit recovery procedure. **Given** manifest verifier **When** проверяется complete либо intentionally incomplete RC **Then** он детерминированно выводит per-requirement status, stale/missing/conflicting evidence и exact failure reasons **And** verifier работает offline и проходит tampering/forgery/rollback negative tests. ### Story 8.2: Завершить Capability Inventory и обязательные CI gates **Depends on:** Story 8.1 **Work type:** implementation **Deliverable:** Завершить Capability Inventory и обязательные CI gates. **Completion:** outcome этой story и все её AC проверены; будущая qualification не выполняется попутно. As a release owner, I want видеть automated/manual evidence для каждого flow, So that существующая или новая функция не остаётся непроверенной. **Requirements:** FR-46 **Acceptance Criteria:** **Given** все UI, Admin API, MCP, worker, runner и deployment capabilities **When** Capability Inventory обновляется для RC **Then** каждый flow имеет stable identifier, support status, owner, contract/FR/NFR links и required automated/manual evidence **And** обязательная capability не скрыта feature flag или общим allow-marker. **Given** inventory item **When** он declared supported **Then** test pyramid включает применимые unit, integration/contract, PostgreSQL real-stack E2E, UI Playwright и negative security tests **And** bug fixes имеют regression fixture/test. **Given** Gitea-compatible CI **When** RC pipeline запускается **Then** выполняются format/lint/build, Rust tests, migrations, contract/roundtrip, frontend build, Playwright, deployment smoke, corpus/matrix и security gates **And** mandatory suite нельзя silently skip из-за отсутствующего service/secret. **Given** flaky либо retried mandatory test **When** первоначальный attempt не pass **Then** outcome остаётся non-pass до root-cause disposition и clean rerun policy **And** SM-2 требует flaky mandatory tests = 0. **Given** evidence collection **When** suite завершается **Then** command, tool version, seed, duration, result и logs/report digests записываются в Evidence Manifest **And** результат относится к exact RC/config. **Given** inventory validator **When** остаётся capability без owner/contract/evidence либо применимая stable MCP capability `deferred` **Then** release gate fail closed с exact item list **And** 100% scope coverage machine-checkable. ### Story 8.3: Выполнить полный versioned manual regression **Depends on:** Story 8.2 **Work type:** qualification **Deliverable:** Выполнить полный versioned manual regression. **Completion:** accepted evidence всех AC на указанном build/RC и среде; harness-only и внешний handoff не являются pass. As a release coordinator, I want вручную пройти все ключевые пользовательские flows на production profile, So that интеграционные и UX-дефекты обнаружены до публичного релиза. **Requirements:** FR-47 **Acceptance Criteria:** **Given** Capability Inventory и immutable RC **When** генерируется manual checklist **Then** он versioned и покрывает onboarding, Operations, OpenAPI upload, Agents, Tools, Resources, Prompts, keys/auth, approvals, history, Tasks, traces, metrics и Load Runs **And** для каждого шага заданы preconditions, exact action, expected outcome и evidence capture. **Given** production-like fresh deployment **When** reviewer выполняет checklist RU и EN **Then** проверяются success, validation, empty, error, confirmation, retry/recovery и permission boundaries **And** browser matrix assignment и test data documented. **Given** manual result **When** шаг завершён **Then** reviewer записывает pass/fail/blocked/not-run, timestamp, RC/config и bounded screenshot/log/support IDs **And** blocked/not-run не считается pass. **Given** найденный defect **When** он регистрируется **Then** defect связан с checklist step, severity, owner и evidence; fix создаёт новый RC и regression test **And** affected steps повторяются на новом RC. **Given** destructive/recovery scenario **When** проверяются revoke, cancel, reconciliation, stop, backup/restore или upgrade **Then** confirmation/audit и post-condition верифицируются отдельно **And** test environment cleanup documented. **Given** manual gate **When** checklist закрывается **Then** 100% steps имеют accepted pass, Critical/High defects = 0 **And** signed reviewer summary доказывает SM-3/SM-4 на exact RC. ### Story 8.4: Квалифицировать compatibility matrices **Depends on:** Story 8.2 **Work type:** qualification **Deliverable:** Квалифицировать compatibility matrices. **Completion:** accepted evidence всех AC на указанном build/RC и среде; harness-only и внешний handoff не являются pass. As a release owner, I want опубликовать доказанную совместимость протоколов и зависимостей, So that пользователи знают точные поддерживаемые сочетания. **Requirements:** FR-48 **Acceptance Criteria:** **Given** feature-freeze date **When** MCP matrix замораживается **Then** exact latest stable revision и две предыдущие поддерживаемые stable revisions зафиксированы с полным capability inventory **And** experimental/RC extensions тестируются отдельно и не заменяют stable support. **Given** MCP matrix **When** protocol harness и минимум три representative clients выполняют её **Then** negotiation, Tools, Resources/templates, Prompts, completion, logging, progress, cancellation, changes и Tasks/fallback проверены применимо к revision **And** advertised capabilities точно совпадают с поведением. **Given** OpenAPI matrix/corpus **When** versioned ≥50 OpenAPI 3.0/3.1 и Swagger 2.0 specs проходят preview/apply/E2E upload **Then** ≥95% Operations actionable Draft, silent loss = 0, unsupported constructs имеют explicit findings **And** каждый discovered defect добавляет immutable fixture. **Given** data/browser matrix **When** выполняются PostgreSQL 16, optional Valkey 8/PG-only и current stable Chromium/Firefox/WebKit suites **Then** core flows и degraded dependency behavior проходят **And** exact image/browser versions и deviations recorded. **Given** matrix cell **When** result fail/blocked/not-run или evidence устарело **Then** соответствующее support claim не публикуется и release gate остаётся закрыт **And** rerun требует того же RC либо новый RC. **Given** accepted matrices **When** формируются release notes/docs **Then** human- и machine-readable results содержат supported/not-applicable/experimental/deferred status, known limits и evidence digests **And** они доказывают SM-8/SM-9. ### Story 8.5: Квалифицировать производительность фиксированного RC **Depends on:** Story 8.2 **Work type:** qualification **Deliverable:** Квалифицировать производительность фиксированного RC. **Completion:** accepted evidence всех AC на указанном build/RC и среде; harness-only и внешний handoff не являются pass. As a release owner, I want воспроизводимо проверить скорость фиксированного RC, So that performance claims подтверждены измерениями, а не ожиданиями. **Requirements:** FR-49 **Acceptance Criteria:** **Given** Reference Deployment/Workload v1 и accepted baseline **When** выполняются три последовательных baseline/load/stress Runs **Then** проверены NFR-P1…P5, minute-level success/saturation, latency/platform overhead, UI responsiveness и production-size datasets **And** regression >10% объяснён и одобрен либо исправлен на новом RC. **Given** baseline Run **When** измеряется platform overhead относительно 10 ms stub upstream **Then** p95 ≤50 ms и p99 ≤150 ms, discovery ≤150 ms p95 **And** telemetry-enabled overhead отдельно сравнивается с disabled baseline. **Given** production-size dataset **When** тестируются 2 000 Operations, 200 Agents, 500 active keys и 1 000 000 history records **Then** основные UI screens интерактивны ≤2 s p95 и flows функционально не деградируют **And** query/series/resource budgets остаются bounded. **Given** stress progression beyond qualified load **When** система достигает saturation **Then** overload rejection bounded и классифицирован, control/stop capacity сохраняется **And** unbounded growth, crash или silent SLO accounting отсутствуют. **Given** completed qualification **When** отчёт финализируется **Then** raw metrics/traces/logs/reports content-addressed и linked к RC/config/workload/seeds **And** automated verdict доказывает SM-5. **Given** interrupted либо modified run **When** artifact/config/workload digest меняется или telemetry gap необъяснён **Then** run invalidated, частичная длительность не объединяется с другой **And** три последовательных Runs начинаются заново на текущем RC. ### Story 8.6: Провести 72-часовой soak и recovery qualification **Depends on:** Story 8.5 **Work type:** qualification **Deliverable:** Провести 72-часовой soak и recovery qualification. **Completion:** accepted evidence всех AC на указанном build/RC и среде; harness-only и внешний handoff не являются pass. As a release owner, I want длительно проверить устойчивость того же RC под нагрузкой и сбоями, So that recovery и отсутствие накопительных дефектов доказаны до burn-in. **Requirements:** FR-49 **Acceptance Criteria:** **Given** fixed RC после performance pass **When** запускается непрерывный 72-hour soak с prescribed mix **Then** нет data loss, deadlock, duplicate terminal outcomes, unbounded memory/disk/cardinality growth или SLI violation **And** workload mix удерживается в tolerance, probes excluded from eligible event count. **Given** qualification window **When** вводятся process restart, network partition, PostgreSQL/Valkey/backend outage, disk pressure и telemetry outage **Then** declared fail-open/fail-closed behavior, drain, lease recovery, spool replay и alerts соответствуют contracts **And** safety path не деградирует silently. **Given** 10 000 queued Tasks и concurrent sync/background work **When** fault убран **Then** queue/backlog recovery, fairness, start latency и deadlines остаются в NFR-P2/R5 envelope **And** terminal accounting сходится. **Given** scheduled recovery probes **When** выполняются backup/restore, worker restart и optional dependency rebuild **Then** реальный MCP call, Task resume и correlation подтверждают восстановление **And** probe outcomes связаны с fault window и expected recovery target. **Given** completed 72-hour qualification **When** отчёт финализируется **Then** raw metrics/traces/logs/recovery reports content-addressed и linked к RC/config/workload/fault schedule **And** automated verdict доказывает 72-hour portion SM-6. **Given** interruption, digest change либо необъяснённый telemetry gap **When** целостность qualification нарушена **Then** run invalidated, partial duration не объединяется с другой **And** полные 72 часа начинаются заново на текущем RC. ### Story 8.7: Закрыть security release qualification **Depends on:** Story 8.2 **Work type:** qualification **Deliverable:** Закрыть security release qualification. **Completion:** accepted evidence всех AC на указанном build/RC и среде; harness-only и внешний handoff не являются pass. As a security reviewer, I want проверить threat model, supply chain и ключевые attack surfaces, So that публичный release не содержит известных Critical/High рисков. **Requirements:** FR-50 **Acceptance Criteria:** **Given** final feature surface RC **When** threat-model review выполняется **Then** обновлены assets, trust boundaries, actors, abuse cases и mitigations для Admin/MCP, OpenAPI, outbound, Resources/Prompts, Tasks, observability и Load Runner **And** каждый in-scope threat связан с control/test/evidence либо blocker. **Given** exact source/dependencies/images/bundle **When** запускаются pinned fresh SAST, dependency, container, secret и license scans **Then** tool/rules/database versions и timestamps captured **And** реальные Critical/High vulnerabilities/findings = 0, suppressions имеют reviewer/rationale/expiry. **Given** authorization/security test suite **When** проверяются tenant/Agent isolation, bootstrap/session/CSRF/CORS, key lifecycle, approvals, idempotency, Task fencing и LoadAuthorizationPlan **Then** default deny и fail-closed guarantees подтверждены **And** metadata existence не раскрывается unauthorized actor. **Given** outbound/OpenAPI attack suite **When** проверяются DNS rebinding, redirect/proxy, private IP, external refs, zip/path traversal, entity/schema bombs и oversized bodies **Then** SSRF/resource bounds выполняются на каждом connection/stage **And** crash/silent partial import отсутствуют. **Given** redaction audit **When** canary secrets помещаются в headers, cookies, query, JSON/YAML, errors, browser events, traces, metrics, reports, exports и diagnostics **Then** ни один canary не выходит за разрешённую encrypted authority **And** negative regression evidence покрывает NFR-S2/O5. **Given** security gate review **When** findings triaged **Then** Critical/High product/security defects = 0, Medium имеют owner и не нарушают SLO/data integrity/security **And** signed disposition и scan artifacts доказывают FR-50/SM-4. ### Story 8.8: Проверить документацию и incident runbooks новым пользователем **Depends on:** Story 8.2 **Work type:** qualification **Deliverable:** Проверить документацию и incident runbooks новым пользователем. **Completion:** accepted evidence всех AC на указанном build/RC и среде; harness-only и внешний handoff не являются pass. As a новый self-hosted пользователь, I want получить проверенную документацию от установки до диагностики, So that могу безопасно эксплуатировать Crank без скрытых знаний команды. **Requirements:** FR-51 **Acceptance Criteria:** **Given** release documentation set **When** он собирается **Then** включает fresh quickstart, production/offline install, configuration, security model, capabilities/limits, compatibility matrices, troubleshooting и upgrade/deprecation guidance **And** commands/versions соответствуют exact RC и canonical `deploy/community`. **Given** operations guide **When** оператор настраивает observability **Then** документированы metrics/buckets/cardinality, Prometheus/Grafana/GlitchTip integration, dashboards, SLO denominators/exclusions и telemetry loss handling **And** compatible external endpoints описаны без cloud requirement. **Given** recovery guide **When** оператор выполняет backup/restore, key recovery/rotation, drain/restart, N-1 upgrade или rollback **Then** preconditions, irreversible boundaries, validation probes и failure recovery приведены пошагово **And** raw secret material не предлагается хранить в manifest/config. **Given** shipped Critical/High alert **When** проверяется runbook link **Then** существует versioned page с meaning, impact, safe diagnostics, mitigation, recovery и verification **And** базовые действия доступны при outage Grafana/GlitchTip. **Given** fresh-user validation на чистом online и air-gapped host **When** участник без внутреннего контекста следует только shipped docs **Then** он устанавливает продукт, публикует Tool, делает MCP call, находит trace и выполняет backup/restore probe **And** ошибки/неясности фиксируются как release defects. **Given** docs CI **When** проверяются links, commands, config fields, screenshots, schemas и runbook alert coverage **Then** stale/broken content блокирует release **And** signed fresh-user report и docs digest входят в Evidence Manifest. ### Story 8.9: Провести 30-дневный burn-in и опубликовать readiness page **Depends on:** Story 8.3, Story 8.4, Story 8.6, Story 8.7, Story 8.8 **Work type:** qualification **Deliverable:** Провести 30-дневный burn-in и опубликовать readiness page. **Completion:** accepted evidence всех AC на указанном build/RC и среде; harness-only и внешний handoff не являются pass. As a потенциальный Community пользователь, I want видеть длительно подтверждённую готовность и честные ограничения, So that могу принять осознанное решение о production использовании. **Requirements:** FR-49, FR-53 **Acceptance Criteria:** **Given** тот же immutable RC после 72-hour qualification **When** начинается supervised burn-in **Then** он длится непрерывные 30 календарных дней без ускорения и выполняет Reference Workload mix ±2 п.п. **And** probes не засчитываются в минимум 1 000 000 eligible events. **Given** burn-in execution **When** собираются SLIs **Then** product/control availability, latency, Task deadlines, trace delivery/completeness, resource growth и error budgets оцениваются на полном окне **And** 100% e2e flows имеют одинаковый Trace ID в UI/history. **Given** planned fault windows **When** вводятся restart/dependency/telemetry outage scenarios **Then** recovery matrix проходит, spool replay завершается, alert срабатывает **And** открытого Telemetry Loss Record, data loss, deadlock или unbounded growth не остаётся. **Given** остановка qualification observer/workload, незапланированное изменение среды либо RC/config/workload digest change **When** целостность burn-in нарушена **Then** gate invalidates run и новый 30-day window начинается заново **And** paused time нельзя вычесть или склеить с другим RC. Плановый restart приложения в зафиксированном fault schedule не равен остановке qualification run: независимые observer/workload сохраняют непрерывность, same-RC fingerprints и полное evidence fault window. Если это не доказано, действует invalidation выше. Scope Story 8.9 конечен: одна accepted qualification и связанная readiness page; реакция page на stale evidence проверяется сценариями, а не бессрочным обслуживанием в coding session. **Given** accepted evidence **When** readiness page генерируется **Then** она публикует supported scope, deployment/reference limits, security/data-egress model, exact compatibility, SLO evidence и known non-blocking issues **And** unsupported/experimental/deferred items обозначены явно без маркетингового расширения claims. **Given** readiness review **When** known issue изменяется или evidence устаревает **Then** page и machine-readable source обновляются с reviewer/audit **And** Critical/High, SLO/data-integrity/security issue блокирует publication status. **Given** burn-in completion **When** manifest validator принимает results **Then** доказаны 30-day portions SM-6/SM-7 и FR-49/FR-53 на exact RC **And** readiness page digest включён в подписанный Evidence Manifest. ### Story 8.10: Вычислять Habr Release Gate без исключений **Depends on:** Story 8.9 **Work type:** implementation **Deliverable:** Вычислять Habr Release Gate без исключений. **Completion:** outcome этой story и все её AC проверены; будущая qualification не выполняется попутно. As a release owner, I want получить однозначное machine-verifiable разрешение на анонс, So that Community release публикуется только после полного доказательства готовности. **Requirements:** FR-54 **Acceptance Criteria:** **Given** signed Evidence Manifest exact RC **When** Habr Gate evaluator запускается offline **Then** он проверяет trust/signature/schema, immutable artifact linkage, freshness и coverage FR-1…FR-53 **And** FR-54 не используется как собственное доказательство. **Given** success-metric evidence **When** evaluator вычисляет gate **Then** SM-2 automated quality, SM-3 manual, SM-4 defects, SM-5 performance, SM-6 reliability, SM-7 traceability, SM-8 OpenAPI, SM-9 MCP и SM-10 deployment/free scope имеют explicit pass **And** denominators/thresholds совпадают с PRD, а inferred/manual override pass запрещён. **Given** обязательная capability deferred/hidden, Critical/High defect, SLO failure, flaky mandatory suite, incomplete manual pass либо incompatible artifact digest **When** gate оценивается **Then** status строго `BLOCKED` с exact requirement/evidence reasons **And** waiver/exception path для этих условий отсутствует. **Given** Medium/known non-blocking issue **When** он допускается readiness contract **Then** требуются owner, rationale, user impact, workaround/target и proof отсутствия SLO/data-integrity/security impact **And** issue опубликован на readiness page. **Given** все mandatory checks accepted **When** gate финализируется **Then** создаётся подписанный immutable `PUBLIC_READY` verdict с RC/bundle/readiness/manifest digests и timestamp **And** только этот verdict разрешает release tooling сформировать Habr announcement assets/tag. **Given** artifact, manifest, page или evidence изменены после verdict **When** release tooling повторно проверяет inputs **Then** verdict становится invalid и publication блокируется до нового полного evaluation **And** уже проверенные bytes нельзя заменить тем же version label. **Given** positive/negative gate fixtures **When** CI проверяет evaluator **Then** complete fixture passes, каждый missing/stale/tampered/failing input blocks детерминированно **And** завершение Epic 8 подтверждает FR-46…FR-54 и production-ready Community release.