Files

11 KiB
Raw Permalink Blame History

1. Контракт версии OpenSpec и проектная схема

  • 1.1 Добавить точный контракт CLI 1.10.0 и тонкий version preflight в specs/openspec и specs/scripts, вызывать его до project-owned операций со store и проверить реальный успешный случай 1.10.0 и контролируемый временный wrong-version failure без отдельного unit-test suite для скрипта.
  • 1.2 Создать native fork схемы spec-driven в specs/openspec/schemas/wealth-ledger-sdd, изменить dependency graph на proposal → specs → design → tasks → apply и проверить успешный openspec schema validate wealth-ledger-sdd --verbose и project-local source в openspec schema which wealth-ledger-sdd --json.
  • 1.3 Настроить templates и instructions wealth-ledger-sdd, чтобы Proposal, Delta Specs, Design и Tasks сохраняли согласованные непересекающиеся роли, Design требовал Delivery Map четырёх областей и условный Solution Assessment, а Tasks применял risk-based testing и исключал observed evidence/archive bookkeeping; проверить принятие всех templates schema validator без нового обязательного артефакта.
  • 1.4 Выбрать wealth-ledger-sdd default-схемой в specs/openspec/config.yaml, добавить только компактный workspace context и additive lifecycle rules и на disposable project-local change проверить последовательную готовность артефактов, сохранив bootstrap change harden-agent-sdd-governance на spec-driven.

2. OpenSpec authority и workspace orchestration

  • 2.1 Перегенерировать OpenSpec 1.10 agent entrypoints в isolated staging, перенести upstream delta в корневую .opencode projection, повторно наложить только fixed wealth-ledger-specs, one-artifact-at-a-time и hard archive-blocker overlays и проверить, что второй workspace openspec root не создан, а каждый generated entrypoint указывает OpenSpec 1.10.
  • 2.2 Расширить specs/scripts/verify-openspec-authority.sh и существующие hard-guardrail fixtures, чтобы отклонять неверный CLI/schema contract, implicit или conditional store selection, непоследовательный artifact graph, permissive archive и competing planning root при сохранении валидного projection case; проверить bash specs/scripts/verify-openspec-authority.test.sh.
  • 2.3 Добавить non-mutating workspace dispatcher в specs/scripts: принимать canonical change, проверять решения для frontend, backend, specs и docs, всегда запускать specs gates, делегировать только affected repository gates и условно добавлять runtime OpenAPI comparison; проверить выбор всех четырёх областей этого change и отказ для disposable неполного Delivery Map без постоянного unit test оркестрационного скрипта.
  • 2.4 Обновить project-owned semantic verification и archive entrypoints: требовать завершённые affected-area gates, semantic verification и independent read-only review без confirmation override; проверить, что authority fixture отклоняет репрезентативные варианты с отсутствующей verification и разрешённым override.

3. Канонический локальный gate frontend

  • 3.1 Добавить тонкий Node runtime preflight frontend из engines/.nvmrc, поставить его первым в canonical npm run verify и проверить успешный запуск под Node 22 и остановку до application checks под контролируемым неподдерживаемым Node без отдельного unit test.
  • 3.2 Удалить повторный вызов test:run из composite verifier frontend, сохранив один coverage-backed запуск Vitest и все OpenAPI, hygiene, type, Biome, Knip, dependency, build, bundle и coverage ratchets; проверить по полному выводу npm run verify один запуск Vitest suite и выполнение всех обязательных stages.
  • 3.3 Согласовать frontend/README.md и frontend/docs/TESTING.md с canonical gate и risk-based выбором тестов, сохранить существующие hard-guardrail fixtures и обозначить coverage как anti-regression constraint, а не причину тестировать декларативные файлы; проверить разрешение задокументированных команд и ссылок из frontend repository.

4. Канонический локальный gate backend

  • 4.1 Добавить тонкий Node runtime preflight backend из engines/.nvmrc, поставить его первым в новом canonical verification entrypoint и проверить успешный запуск под Node 22 и остановку до application checks под контролируемым неподдерживаемым Node без отдельного unit test.
  • 4.2 Добавить backend npm run verify как fail-fast non-mutating chain для runtime, hygiene, lint, application/test typechecks, Jest и build, явно исключив deferred Prisma e2e и новый global coverage threshold; проверить полный gate под Node 22 и ненулевой общий результат при контролируемом failure одного child stage.
  • 4.3 Обновить backend/README.md и docs/development/backend-workflow.md, обозначив только npm run verify completion gate, оставив lint:fix, coverage и deferred e2e отдельными, и проверить соответствие документированных команд backend/package.json при сохранённом WL-P2-05 review trigger.

5. Docs-as-code и устойчивая governance-документация

  • 5.1 Добавить Node 22 lockfile-backed toolchain docs с markdownlint-cli2, отключить в committed configuration только MD013, предоставить один non-mutating npm run verify и проверить npm ci и полный docs gate на текущем Markdown baseline без auto-fix и network/browser link checking.
  • 5.2 Создать authoritative development policy для Change Owner, artifact approvals, Delivery Map, Completion Evidence, Enforceable Engineering Invariant, risk-based testing, build-vs-buy Solution Assessment и SSOT boundaries; добавить ссылку в docs/development/README.md, привести docs/development/openspec-authority-and-lifecycle.md к as-built custom-schema workflow без копирования schema instructions и проверить разрешение всех local links.
  • 5.3 Добавить ADR 010 о native OpenSpec schema и минимальной local orchestration, проиндексировать его в docs/adr/README.md и проверить, что ADR фиксирует alternatives, consequences и reconsideration triggers без пересказа requirements change.
  • 5.4 Создать immutable docs/audits/audit-24-08-2026.md, добавить его в docs/audits/README.md, расширить единый live remediation registry на все audit snapshots, сделать harden-agent-sdd-governance единственным active remediation change и перевести WL-P3-04 в deferred с accessibility trigger; проверить разрешение каждого Audit ID в один snapshot и не более одной active записи.
  • 5.5 Исправить подтверждённые current-state contradictions исторических A-15 и A-18 в authoritative ADR и основной spec user-authentication, не редактируя immutable audit snapshots; проверить разрешение implementation-status links ADR и успешную strict validation всех основных specs.

6. Слоистые agent instructions и onboarding

  • 6.1 Переписать слои корневого, frontend, backend, specs и docs AGENTS.md: оставить в корне только workspace-wide SSOT/lifecycle constraints, а в каждом репозитории — canonical gate, enforceable style/boundary sources, маршруты к durable docs и audit registry, явный --store wealth-ledger-specs и запрет parallel planning stores; проверить authority fixture и все repository-local link/path checks.
  • 6.2 Обновить onboarding references frontend, backend и specs на новую governance policy, custom schema и workspace dispatcher без копирования architecture или feature content в AGENTS/README; проверить, что читатель из каждого репозитория достигает canonical SDD authority, local gate и относящейся к области durable documentation.

7. Интегрированная pre-archive verification

  • 7.1 Запустить workspace dispatcher для harden-agent-sdd-governance под Node 22 и проверить успешные canonical results frontend, backend, specs и docs без fallback, auto-fix или запуска deferred e2e.
  • 7.2 Запустить bash specs/scripts/verify-runtime-openapi.sh под Node 22 и проверить соответствие backend runtime contract committed OpenAPI snapshot frontend, поскольку обе contract sides входят в Delivery Map этого change.
  • 7.3 Запустить project-local schema validation, strict validation harden-agent-sdd-governance, strict validation всех canonical specs, OpenSpec authority fixtures и git diff --check в каждом affected Git repository; проверить успешное завершение всех structural и repository hygiene gates.
  • 7.4 Выполнить semantic verification реализации против Proposal, всех 19 требований Delta Specs, Design и этого checklist, затем провести independent read-only standards/spec review и проверить отсутствие Critical и Important findings до запроса archive.