docs(specs): archive local verification remediation

2026-08-23 21:21:22 +03:00
parent 51344d4988
commit 72444dbbb1
11 changed files with 441 additions and 4 deletions
@@ -0,0 +1,58 @@
+## 1. Зафиксировать активный и отложенный audit scope
+
+- [x] 1.1 Обновить `docs/development/audit-remediation.md`: пометить только
+  WL-P1-05, WL-P2-06, WL-P2-09 и WL-P2-11 как `active` с
+  `make-local-verification-agent-safe`; записать WL-P2-05 и WL-P2-13 как
+  `deferred` с датой, наблюдаемой причиной Prisma 7.9.1 и trigger review;
+  не помечать finding как `done`.
+- [x] 1.2 Обновить durable development documentation и scoped `AGENTS.md`,
+  чтобы они называли только реально существующие non-mutating gates, Node 22 и
+  `npm ci`, а writers `lint:fix` и `openapi:sync` были явными.
+
+## 2. Восстановить non-mutating local gates backend
+
+- [x] 2.1 Добавить backend Node 22 runtime metadata и lockfile-safe bootstrap
+  guidance; разделить `lint:check`, `lint:fix` и совместимый non-mutating alias
+  `lint` в `backend/package.json`.
+- [x] 2.2 Добавить отдельные backend TypeScript configurations и scripts для
+  приложения и тестов; application compilation исключает test sources, test
+  compilation включает test surface, оба выполняются без repository artifacts.
+- [x] 2.3 Исправить существующий неполный `TbankClient` test double или
+  заменить его typed test adapter, чтобы test TypeScript gate проходил без
+  ослабления production client contract.
+- [x] 2.4 Документировать, что текущие `test:e2e` и общий workspace verdict не
+  являются частью этого change, пока WL-P2-05/P2-13 отложены; не добавлять
+  обходной Prisma runner или ложный `npm run verify`.
+
+## 3. Проверить runtime API contract без writers
+
+- [x] 3.1 Реализовать минимальный runtime OpenAPI comparison helper, который
+  запускает backend с deterministic development test environment, ждёт local
+  readiness, получает `/api/docs-json`, canonicalizes object keys во временных
+  files, сравнивает SHA-256 полного document, выводит diff при mismatch и всегда
+  завершает child process.
+- [x] 3.2 Подтвердить, что helper никогда не вызывает
+  `frontend/scripts/openapi-sync.mjs`, не обращается к external service, не
+  требует T-Bank credentials и не записывает committed snapshot/generated
+  types; запустить его для текущего contract и устранить каждый content mismatch
+  через согласованный contract workflow, а не скрытым переписыванием.
+
+## 4. Completion evidence и audit tracking
+
+- [x] 4.1 Запустить `openspec validate make-local-verification-agent-safe
+  --type change --strict --store wealth-ledger-specs`, `openspec validate
+  --specs --strict --store wealth-ledger-specs`, authority verifier, отдельный
+  runtime OpenAPI check и relevant per-repository checks; зафиксировать точные
+  commands и observed results.
+- [x] 4.2 Выполнить independent read-only review diff, OpenSpec deltas,
+  temporary-resource behavior, runtime-contract comparison и точности
+  документации; устранить каждую confirmed issue и подтвердить, что этот task
+  list не содержит post-archive bookkeeping, commit или registry-completion
+  checkbox.
+- [x] 4.3 Выполнить applicable pre-archive `opsx-verify` procedure и устранить
+  каждый blocking result. Эта задача завершается до archive. Только после
+  завершения каждого checkbox change может быть archived и synced; только после
+  этого remediation registry вне task list получает actual archive path,
+  commits, terminal evidence, четыре статуса `done` и ровно одну следующую
+  рекомендуемую задачу. WL-P2-05 и WL-P2-13 остаются `deferred` до своего
+  отдельного change.