Files
specs/openspec/changes/archive/2026-08-24-harden-agent-sdd-governance/tasks.md
T

46 lines
11 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
## 1. Контракт версии OpenSpec и проектная схема
- [x] 1.1 Добавить точный контракт CLI `1.10.0` и тонкий version preflight в `specs/openspec` и `specs/scripts`, вызывать его до project-owned операций со store и проверить реальный успешный случай `1.10.0` и контролируемый временный wrong-version failure без отдельного unit-test suite для скрипта.
- [x] 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`.
- [x] 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 без нового обязательного артефакта.
- [x] 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
- [x] 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.
- [x] 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`.
- [x] 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 оркестрационного скрипта.
- [x] 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
- [x] 3.1 Добавить тонкий Node runtime preflight frontend из `engines`/`.nvmrc`, поставить его первым в canonical `npm run verify` и проверить успешный запуск под Node 22 и остановку до application checks под контролируемым неподдерживаемым Node без отдельного unit test.
- [x] 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.
- [x] 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
- [x] 4.1 Добавить тонкий Node runtime preflight backend из `engines`/`.nvmrc`, поставить его первым в новом canonical verification entrypoint и проверить успешный запуск под Node 22 и остановку до application checks под контролируемым неподдерживаемым Node без отдельного unit test.
- [x] 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.
- [x] 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-документация
- [x] 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.
- [x] 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.
- [x] 5.3 Добавить ADR 010 о native OpenSpec schema и минимальной local orchestration, проиндексировать его в `docs/adr/README.md` и проверить, что ADR фиксирует alternatives, consequences и reconsideration triggers без пересказа requirements change.
- [x] 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 записи.
- [x] 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
- [x] 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.
- [x] 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
- [x] 7.1 Запустить workspace dispatcher для `harden-agent-sdd-governance` под Node 22 и проверить успешные canonical results frontend, backend, specs и docs без fallback, auto-fix или запуска deferred e2e.
- [x] 7.2 Запустить `bash specs/scripts/verify-runtime-openapi.sh` под Node 22 и проверить соответствие backend runtime contract committed OpenAPI snapshot frontend, поскольку обе contract sides входят в Delivery Map этого change.
- [x] 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.
- [x] 7.4 Выполнить semantic verification реализации против Proposal, всех 19 требований Delta Specs, Design и этого checklist, затем провести independent read-only standards/spec review и проверить отсутствие Critical и Important findings до запроса archive.