From 0c119d7c6fa93a407afa0c54b5d6ed56b84b2389 Mon Sep 17 00:00:00 2001 From: lili Date: Sat, 20 Jun 2026 02:50:00 -0700 Subject: [PATCH] =?UTF-8?q?docs:=20=E5=BD=92=E6=A1=A3=E5=B7=B2=E5=AE=8C?= =?UTF-8?q?=E6=88=90=E9=98=B6=E6=AE=B5=E8=BF=87=E7=A8=8B=E6=96=87=E6=A1=A3?= =?UTF-8?q?=E8=87=B3=20docs/archive(git=20mv=20=E4=BF=9D=E5=8E=86=E5=8F=B2?= =?UTF-8?q?)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 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) --- docs/agent-specs/.agent | 2 ++ ...06-05-P1R-7a-source-owner-compatibility.md | 0 ...6-06-14-P1RAccountRemaining21解锁审阅版.md | 0 ...6-06-14-P1RAccountRemaining21解锁执行版.md | 0 ...StageA-NewAPIQuotaIntegration解锁执行版.md | 0 .../2026-06-14-P1RAccountStageA收敛进度.md | 0 .../2026-06-14-agent基建六砖交付.md | 0 ...2026-06-17-muse-completion-requirements.md | 0 ...01-feat-object-storage-fileservice-plan.md | 0 docs/archive/README.md | 28 +++++++++++++++++++ .../reports => archive}/p1r-api-coverage.md | 0 11 files changed, 30 insertions(+) rename docs/{superpowers/reports => archive}/2026-06-05-P1R-7a-source-owner-compatibility.md (100%) rename docs/{agent-specs => archive}/2026-06-14-P1RAccountRemaining21解锁审阅版.md (100%) rename docs/{agent-specs => archive}/2026-06-14-P1RAccountRemaining21解锁执行版.md (100%) rename docs/{agent-specs => archive}/2026-06-14-P1RAccountStageA-NewAPIQuotaIntegration解锁执行版.md (100%) rename docs/{memorys => archive}/2026-06-14-P1RAccountStageA收敛进度.md (100%) rename docs/{agent-specs => archive}/2026-06-14-agent基建六砖交付.md (100%) rename docs/{brainstorms => archive}/2026-06-17-muse-completion-requirements.md (100%) rename docs/{plans => archive}/2026-06-18-001-feat-object-storage-fileservice-plan.md (100%) create mode 100644 docs/archive/README.md rename docs/{superpowers/reports => archive}/p1r-api-coverage.md (100%) diff --git a/docs/agent-specs/.agent b/docs/agent-specs/.agent index a427766e..3809d143 100644 --- a/docs/agent-specs/.agent +++ b/docs/agent-specs/.agent @@ -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-review（Erdos）和 fresh quality/feasibility review（Carver）。Task 1 只读 preflight 已双 PASS（Ramanujan / Descartes），Task 2 migration/schema 已双 PASS（Boyle / Lorentz），Task 3 AI DO/Mapper/Service 与 terminal fact 同事务 outbox 已双 PASS（Wegener / Bohr），Task 4 AI worker / dispatcher 已在修复 spec review FAIL 后双 PASS（Hume / 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 review（Ptolemy）与 fresh quality/feasibility review（Curie）双 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 review（Feynman）FAIL：Task 7 仍直跑 scanner，Market 命令只看 completionStatus；spec re-review（Banach）FAIL：Task 6 Market 命令仍只看 completionStatus。已修复为 Task 6/Task 7 都在临时隔离副本运行 scanner，当前 worktree protected diff 必须为空，并用 `implementationStatus/completionStatus` 验证 Market 为 `dedicated/needs_verification 32`；修订方案 fresh spec re-review（Kuhn）PASS、fresh quality/feasibility review（Meitner）PASS。Task 6 revised gate 由 fresh implementer（Lorentz）DONE，本轮无文件改动；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 0，summary 为 completed=100、needsVerification=133、incomplete=0、genericPersistence=0、ssePlaceholder=0；Events `streamEvents=dedicated/needs_verification`，Market 32 个 operation 均为 `dedicated/needs_verification`；dependency tree 证明 AI server 依赖 events-api、不依赖 events-server，Events server 不反向依赖 AI/Knowledge/Market/Member/Content server。下一步必须 fresh Task 6 spec review，未双 PASS 前不能进入 Task 7。 最新补记：Task 6 spec review（Ohm）PASS，但指出 dependency test 未显式覆盖 `muse-module-content-server` 属于依赖合同完整性风险；按 `superpowers:receiving-code-review` 处理后判定该反馈有效。fresh implementer（Peirce）已把 `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 0，summary 仍为 completed=100、needsVerification=133、incomplete=0、genericPersistence=0、ssePlaceholder=0，Events 仍为 `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。 diff --git a/docs/superpowers/reports/2026-06-05-P1R-7a-source-owner-compatibility.md b/docs/archive/2026-06-05-P1R-7a-source-owner-compatibility.md similarity index 100% rename from docs/superpowers/reports/2026-06-05-P1R-7a-source-owner-compatibility.md rename to docs/archive/2026-06-05-P1R-7a-source-owner-compatibility.md diff --git a/docs/agent-specs/2026-06-14-P1RAccountRemaining21解锁审阅版.md b/docs/archive/2026-06-14-P1RAccountRemaining21解锁审阅版.md similarity index 100% rename from docs/agent-specs/2026-06-14-P1RAccountRemaining21解锁审阅版.md rename to docs/archive/2026-06-14-P1RAccountRemaining21解锁审阅版.md diff --git a/docs/agent-specs/2026-06-14-P1RAccountRemaining21解锁执行版.md b/docs/archive/2026-06-14-P1RAccountRemaining21解锁执行版.md similarity index 100% rename from docs/agent-specs/2026-06-14-P1RAccountRemaining21解锁执行版.md rename to docs/archive/2026-06-14-P1RAccountRemaining21解锁执行版.md diff --git a/docs/agent-specs/2026-06-14-P1RAccountStageA-NewAPIQuotaIntegration解锁执行版.md b/docs/archive/2026-06-14-P1RAccountStageA-NewAPIQuotaIntegration解锁执行版.md similarity index 100% rename from docs/agent-specs/2026-06-14-P1RAccountStageA-NewAPIQuotaIntegration解锁执行版.md rename to docs/archive/2026-06-14-P1RAccountStageA-NewAPIQuotaIntegration解锁执行版.md diff --git a/docs/memorys/2026-06-14-P1RAccountStageA收敛进度.md b/docs/archive/2026-06-14-P1RAccountStageA收敛进度.md similarity index 100% rename from docs/memorys/2026-06-14-P1RAccountStageA收敛进度.md rename to docs/archive/2026-06-14-P1RAccountStageA收敛进度.md diff --git a/docs/agent-specs/2026-06-14-agent基建六砖交付.md b/docs/archive/2026-06-14-agent基建六砖交付.md similarity index 100% rename from docs/agent-specs/2026-06-14-agent基建六砖交付.md rename to docs/archive/2026-06-14-agent基建六砖交付.md diff --git a/docs/brainstorms/2026-06-17-muse-completion-requirements.md b/docs/archive/2026-06-17-muse-completion-requirements.md similarity index 100% rename from docs/brainstorms/2026-06-17-muse-completion-requirements.md rename to docs/archive/2026-06-17-muse-completion-requirements.md diff --git a/docs/plans/2026-06-18-001-feat-object-storage-fileservice-plan.md b/docs/archive/2026-06-18-001-feat-object-storage-fileservice-plan.md similarity index 100% rename from docs/plans/2026-06-18-001-feat-object-storage-fileservice-plan.md rename to docs/archive/2026-06-18-001-feat-object-storage-fileservice-plan.md diff --git a/docs/archive/README.md b/docs/archive/README.md new file mode 100644 index 00000000..f1f42de5 --- /dev/null +++ b/docs/archive/README.md @@ -0,0 +1,28 @@ +# docs/archive —— 历史过程文档归档 + +> 本目录存放**已完成阶段的过程文档**(工作已落地、价值已沉淀到主台账/代码/git)。归档而非删除:全部 git 可恢复(`git log --follow `、`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/`。 diff --git a/docs/superpowers/reports/p1r-api-coverage.md b/docs/archive/p1r-api-coverage.md similarity index 100% rename from docs/superpowers/reports/p1r-api-coverage.md rename to docs/archive/p1r-api-coverage.md