From a692190a77ffce8550a1213c8b91c073a3f63956 Mon Sep 17 00:00:00 2001 From: gewuyou <95328647+GeWuYou@users.noreply.github.com> Date: Thu, 7 May 2026 12:23:18 +0800 Subject: [PATCH] =?UTF-8?q?docs(ai-plan):=20=E5=BD=92=E6=A1=A3=20single-co?= =?UTF-8?q?ntext-priority=20=E4=B8=BB=E9=A2=98?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - 更新 public index，只保留仍处于活跃状态的 topic 与分支映射 - 归档 single-context-priority 主题目录到 public archive - 补充 ai-plan-governance 跟踪与 trace，记录本次归档校正与验证结果 --- ai-plan/public/README.md | 6 ------ .../todos/ai-plan-governance-tracking.md | 8 +++++++- .../traces/ai-plan-governance-trace.md | 14 ++++++++++++++ .../todos/single-context-priority-tracking.md | 0 .../traces/single-context-priority-trace.md | 0 5 files changed, 21 insertions(+), 7 deletions(-) rename ai-plan/public/{ => archive}/single-context-priority/todos/single-context-priority-tracking.md (100%) rename ai-plan/public/{ => archive}/single-context-priority/traces/single-context-priority-trace.md (100%) diff --git a/ai-plan/public/README.md b/ai-plan/public/README.md index d264cbd9..4ee6c551 100644 --- a/ai-plan/public/README.md +++ b/ai-plan/public/README.md @@ -42,10 +42,6 @@ help the current worktree land on the right recovery documents without scanning - Purpose: track `PR #330` disposal-contract fixes for `MicrosoftDiContainer`, related benchmark cleanup hardening, and review follow-up. - Tracking: `ai-plan/public/microsoft-di-container-disposal/todos/microsoft-di-container-disposal-tracking.md` - Trace: `ai-plan/public/microsoft-di-container-disposal/traces/microsoft-di-container-disposal-trace.md` -- `single-context-priority` - - Purpose: converge `GameContext` toward a single active architecture context model and tighten related `MicrosoftDiContainer` pre-freeze lookup semantics. - - Tracking: `ai-plan/public/single-context-priority/todos/single-context-priority-tracking.md` - - Trace: `ai-plan/public/single-context-priority/traces/single-context-priority-trace.md` ## Worktree To Active Topic Map @@ -68,5 +64,3 @@ help the current worktree land on the right recovery documents without scanning - Priority 1: `documentation-full-coverage-governance` - Branch: `fix/microsoft-di-container-disposal` - Priority 1: `microsoft-di-container-disposal` -- Branch: `refactor/single-context-priority` - - Priority 1: `single-context-priority` diff --git a/ai-plan/public/ai-plan-governance/todos/ai-plan-governance-tracking.md b/ai-plan/public/ai-plan-governance/todos/ai-plan-governance-tracking.md index 1b5ac9c4..d1c7117f 100644 --- a/ai-plan/public/ai-plan-governance/todos/ai-plan-governance-tracking.md +++ b/ai-plan/public/ai-plan-governance/todos/ai-plan-governance-tracking.md @@ -32,6 +32,9 @@ ## 已完成 +- 已将已完成的 `single-context-priority` 主题整体迁入： + - `ai-plan/public/archive/single-context-priority/` + - 并同步从 `ai-plan/public/README.md` 的 active topics 与 branch map 中移除 - 已为活跃主题建立并使用主题内归档目录： - `ai-plan/public/ai-plan-governance/archive/todos/` - `ai-plan/public/ai-plan-governance/archive/traces/` @@ -89,6 +92,9 @@ - `find ai-plan/public/data-repository-persistence -maxdepth 3 -type f | sort` - 结果：通过 - 备注：只有单文件且混合承担 todo / trace 的 legacy `local-plan` 也已按治理规则拆分为 active 入口与主题内 archive +- `find ai-plan/public/archive/single-context-priority -maxdepth 3 -type f | sort` + - 结果：通过 + - 备注：确认已完成 topic 已整体迁入主题级 archive，且 active boot 入口不再引用它 - `test ! -e local-plan` - 结果：通过 - 备注：当前工作树根目录已不再保留 legacy `local-plan/` @@ -105,4 +111,4 @@ 1. 继续扫描是否还有遗留的 `local-plan` 或其他非 `ai-plan` 的 durable recovery 文档目录，尤其关注单文件混合 tracking/trace 或只有 todo 没有 trace 的更早期计划 2. 后续只要某个 active 主题积累了多个已完成且已验证阶段，就在同一变更里将其细节迁入该主题自己的 `archive/` -3. 若某个主题整体完成，再将整个主题目录移入 `ai-plan/public/archive//` +3. 若某个主题整体完成，再将整个主题目录移入 `ai-plan/public/archive//`，并同步清理 `ai-plan/public/README.md` 的 active topics 与 branch map diff --git a/ai-plan/public/ai-plan-governance/traces/ai-plan-governance-trace.md b/ai-plan/public/ai-plan-governance/traces/ai-plan-governance-trace.md index efdfc6c2..ab479db2 100644 --- a/ai-plan/public/ai-plan-governance/traces/ai-plan-governance-trace.md +++ b/ai-plan/public/ai-plan-governance/traces/ai-plan-governance-trace.md @@ -117,3 +117,17 @@ 1. 后续若再遇到“单文件同时承担 tracking / trace”的更早期计划，继续按同一模式迁入 topic archive，并显式标注来源边界 2. 保持新 topic 的 active 入口精简，避免把拆分后的公共目录重新写回旧式混合日志 + +### 阶段：完成主题归档校正（RP-005） + +- 复核 `ai-plan/public/README.md` 与当前 worktree 后确认：`single-context-priority` 虽已完成并合入 `origin/main`，但仍残留在 active topics 与 branch map，导致 boot 会把已完成主题误判为活跃入口 +- 按治理规则将 `ai-plan/public/single-context-priority/` 整体迁入 `ai-plan/public/archive/single-context-priority/` +- 同步从 `ai-plan/public/README.md` 中移除该主题的 active topics 条目与 `refactor/single-context-priority` 分支映射，确保公共索引只保留仍应默认进入的 topic +- 本轮额外验证目标： + - `find ai-plan/public/archive/single-context-priority -maxdepth 3 -type f | sort` + - `dotnet build GFramework.Core.Abstractions/GFramework.Core.Abstractions.csproj -c Release` + +### 下一步 — 完成主题归档 + +1. 后续只要发现某个 topic 已整体完成且默认 boot 不应再落入，就在同一变更里同时完成主题归档与 public index 清理 +2. 继续把 `ai-plan/public/README.md` 视为严格的 active-only 索引，而不是“做过的 topic 列表” diff --git a/ai-plan/public/single-context-priority/todos/single-context-priority-tracking.md b/ai-plan/public/archive/single-context-priority/todos/single-context-priority-tracking.md similarity index 100% rename from ai-plan/public/single-context-priority/todos/single-context-priority-tracking.md rename to ai-plan/public/archive/single-context-priority/todos/single-context-priority-tracking.md diff --git a/ai-plan/public/single-context-priority/traces/single-context-priority-trace.md b/ai-plan/public/archive/single-context-priority/traces/single-context-priority-trace.md similarity index 100% rename from ai-plan/public/single-context-priority/traces/single-context-priority-trace.md rename to ai-plan/public/archive/single-context-priority/traces/single-context-priority-trace.md