docs: 归档已完成阶段过程文档至 docs/archive(git mv 保历史)

9 篇工作已完成的过程文档(P1R解锁3篇+agent基建交付+superpowers报告2篇+P1R任务memory+已合并object-storage计划+已折入总览的completion brainstorm)移至 docs/archive/。保留:design-docs(SSOT)、主台账、现状基线、对抗复盘/P0冻结令(知识网根基,被AGENTS/.agents/台账引用)、meta-schema当前2篇、p1r-api-coverage.json(被引数据)、memorys/README。归档非删除,git 可恢复。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This commit is contained in:
lili 2026-06-20 02:50:00 -07:00
parent 73ec83ab20
commit 0c119d7c6f
11 changed files with 30 additions and 0 deletions

View File

@ -4,6 +4,8 @@
边界本目录只记录审阅版、执行版、review gate 与交接约束,不承载代码实现,不修改 OpenAPI、scanner 或 coverage 口径。
> 归档说明(2026-06-20)P1R 解锁(审阅版/执行版)与 agent 基建交付等**已完成阶段文档**已移至 [`docs/archive/`](../archive/README.md);下文 P1R-7b 历史记述中提到的这些路径均以归档副本为准。本目录现仅留现状基线、对抗复盘、P0 冻结令(知识网根基)与 meta-schema 当前文档。人读全局见 [`docs/项目功能与进度总览.md`](../项目功能与进度总览.md)。
当前状态P1R-7b 执行版已作为全局方案下的 AI 子计划通过 fresh spec re-reviewErdos和 fresh quality/feasibility reviewCarver。Task 1 只读 preflight 已双 PASSRamanujan / DescartesTask 2 migration/schema 已双 PASSBoyle / LorentzTask 3 AI DO/Mapper/Service 与 terminal fact 同事务 outbox 已双 PASSWegener / BohrTask 4 AI worker / dispatcher 已在修复 spec review FAIL 后双 PASSHume / Linnaeus。Task 4 focused evidence 为 Worker tests=20、Mapper tests=5均 failures=0/errors=0/skipped=0残余非阻塞风险包括 worker 默认开关口径、retryable 状态日志、terminalFact 与 outbox 完整一致性后续加固。Task 5 focused E2E 已由 Task 5a done 可见性和 Task 5b error / duplicate / rejected 证据合并收口,并通过 fresh spec reviewPtolemy与 fresh quality/feasibility reviewCurie双 PASS本地 evidence 为 `P1rAiEventsPublishEndToEndTest` tests=4、failures=0/errors=0/skipped=0覆盖 done owner 可见与跨 owner 不可见、error payload 不泄露敏感 detail、duplicate replay 同 eventId/sequenceNo、rejected -> outbox dead_letter 且 visible query 为空。该证据仍是 focused harness不代表 P1R-7b completed也不代表 Events/Market completed。Task 6 曾因 coverage scanner `--check` 会重写受保护 coverage JSON/Markdown 而 BLOCKED该 diff 已按受保护边界回退,当前 protected diff 为空。执行版修订 spec reviewFeynmanFAILTask 7 仍直跑 scannerMarket 命令只看 completionStatusspec re-reviewBanachFAILTask 6 Market 命令仍只看 completionStatus。已修复为 Task 6/Task 7 都在临时隔离副本运行 scanner当前 worktree protected diff 必须为空,并用 `implementationStatus/completionStatus` 验证 Market 为 `dedicated/needs_verification 32`;修订方案 fresh spec re-reviewKuhnPASS、fresh quality/feasibility reviewMeitnerPASS。Task 6 revised gate 由 fresh implementerLorentzDONE本轮无文件改动evidence 为 dependency test 2/2、P1R focused gates 29/29、Migration SQL 4/4、Flyway `_test` 4/4 均 failures=0/errors=0/skipped=0隔离副本 scanner exit 0summary 为 completed=100、needsVerification=133、incomplete=0、genericPersistence=0、ssePlaceholder=0Events `streamEvents=dedicated/needs_verification`Market 32 个 operation 均为 `dedicated/needs_verification`dependency tree 证明 AI server 依赖 events-api、不依赖 events-serverEvents server 不反向依赖 AI/Knowledge/Market/Member/Content server。下一步必须 fresh Task 6 spec review未双 PASS 前不能进入 Task 7。
最新补记Task 6 spec reviewOhmPASS但指出 dependency test 未显式覆盖 `muse-module-content-server` 属于依赖合同完整性风险;按 `superpowers:receiving-code-review` 处理后判定该反馈有效。fresh implementerPeirce已把 `P1rAiEventsPublishDependencyTest` forbidden source owner server 列表补齐为 AI / Knowledge / Market / Member / Content并运行 dependency test 2/2 通过protected diff 为空。controller 随后重跑 P1R focused gates 29/29 通过;再以 `/tmp/p1r7b-coverage-scan.N0QGvX` 临时隔离副本运行 scanner `--check` exit 0summary 仍为 completed=100、needsVerification=133、incomplete=0、genericPersistence=0、ssePlaceholder=0Events 仍为 `dedicated/needs_verification`Market 32 个 operation 仍为 `dedicated/needs_verification`,当前真实 worktree 保护文件 diff 为空。只读检索 `docs/memorys` 证实 P1R-7a 留痕已把 source owner propagation 明确移入 P1R-7b且 P1R-7a / Events / Market 均不得写成 completed。执行版文档已同步修正 Task 6 与数据流段的依赖合同旧口径,统一为 Events server 不反向依赖 AI / Knowledge / Market / Member / Content server。由于测试和执行版文档均有变更下一步必须重新派发 fresh Task 6 spec review未双 PASS 前不能进入 Task 7。

28
docs/archive/README.md Normal file
View File

@ -0,0 +1,28 @@
# docs/archive —— 历史过程文档归档
> 本目录存放**已完成阶段的过程文档**(工作已落地、价值已沉淀到主台账/代码/git)。归档而非删除:全部 git 可恢复(`git log --follow <file>``git mv` 还原)。
> 归档日期:2026-06-20 · 原因:过程文档累积过多,清理出人读入口。人读全局见 [`docs/项目功能与进度总览.md`](../项目功能与进度总览.md)。
## 为何这些可归档
工作均已完成且其结论已写回权威源(主台账 `docs/mvp/进度总账.md`、各模块 `.agent`、git 历史)。它们是阶段性 working docs,非项目知识网的根基。
| 文件 | 原位置 | 性质 |
|---|---|---|
| 2026-06-14-P1RAccountRemaining21解锁审阅版.md | docs/agent-specs/ | P1R Account 解锁审阅版(P1R 验收债已清,完成) |
| 2026-06-14-P1RAccountRemaining21解锁执行版.md | docs/agent-specs/ | 同上,执行版 |
| 2026-06-14-P1RAccountStageA-NewAPIQuotaIntegration解锁执行版.md | docs/agent-specs/ | P1R Account Stage A 执行版(完成) |
| 2026-06-14-agent基建六砖交付.md | docs/agent-specs/ | agent 基建交付记录(完成) |
| 2026-06-05-P1R-7a-source-owner-compatibility.md | docs/superpowers/reports/ | superpowers 运行报告 |
| p1r-api-coverage.md | docs/superpowers/reports/ | 覆盖报告(数据 `p1r-api-coverage.json` 仍在原位、被台账/覆盖门引用) |
| 2026-06-14-P1RAccountStageA收敛进度.md | docs/memorys/ | P1R 任务进度 memory(完成) |
| 2026-06-18-001-feat-object-storage-fileservice-plan.md | docs/plans/ | 对象存储 FileService 计划(已合并 dev/1.0.0) |
| 2026-06-17-muse-completion-requirements.md | docs/brainstorms/ | 产品完成度需求 brainstorm(已折入总览) |
## 未归档(留在原位,因仍是活引用/根基)
- `design-docs/`(SSOT)、`docs/mvp/进度总账.md`(主台账)、`docs/项目功能与进度总览.md`(人读入口)。
- `docs/agent-specs/2026-06-13-项目目标与模块现状基线.md`(被各 `.agent` 引用的现状权威)。
- `docs/agent-specs/2026-06-13-目标达成对抗复盘.md``2026-06-13-P0-止血冻结令.md`(被 AGENTS.md/.agents 规则/台账引用为"假绿根因/反假绿规则由来"——知识网根基)。
- `docs/agent-specs/2026-06-17-meta-schema用量投影-review.md` / `2026-06-20-...execution.md`(meta-schema 方向决策待定,当前文档)。
- `docs/dev-baseline/`(早期基线已归档)、`docs/explainers/``docs/api-contracts/`