Docs/sdk update documentation

ai-plan/public/documentation-full-coverage-governance/archive/todos/documentation-full-coverage-governance-status-history-rp-049-to-rp-052-2026-05-01.md

@@ -0,0 +1,31 @@
+# Documentation Full Coverage Governance Status History (RP-049 to RP-052)
+
+## Scope
+
+- 该归档承接 active tracking 从 `RP-049` 到 `RP-052` 迁出的阶段状态、批次边界和恢复决策。
+- 逐命令验证明细单独保存在：
+  `ai-plan/public/documentation-full-coverage-governance/archive/todos/documentation-full-coverage-governance-validation-history-rp-049-to-rp-052-2026-05-01.md`
+
+## 2026-04-29 / RP-049
+
+- 重新进入时确认当前分支仍为 `docs/sdk-update-documentation`，但上游恢复路径不再依赖旧 PR 线程，而是改用 `origin/main` 作为 batch stop-condition baseline。
+- 本轮工作树在 reader-facing 文案收口后相对 `origin/main` 来到 `13` files / `132` lines，仍明显低于 `$gframework-batch-boot 50` 的阈值。
+- 主线程接受的变更范围限定在 `docs/zh-CN/godot/*`、`game/*` 和少量 README 标签，不扩展到导航重写或大型结构改稿。
+
+## 2026-04-29 / RP-050
+
+- 在 `RP-049` 的基础上继续做第 2 批低风险 reader-facing 收口，触达 `game/data.md`、`game/storage.md`、`godot/ui.md` 与 `GFramework.Cqrs.Abstractions/README.md`、`GFramework.SourceGenerators.Common/README.md`。
+- 决策上只接受“改句子即可闭环”的问题，不把 README 子系统地图或结构级重写混入同一轮。
+- 当轮工作树相对 `origin/main` 为 `18` files / `225` lines，仍保留充足余量。
+
+## 2026-04-29 / RP-051
+
+- 从与 `origin/main` 零 diff 的状态重新进入后，把批次目标从“低风险句子收口”提升为“补新的 docs coverage 入口”。
+- 这一轮新增 `docs/zh-CN/source-generators/schema-config-generator.md`，并同步更新 `source-generators/index.md`、`api-reference/index.md`、`source-generators/cqrs-handler-registry-generator.md`、`core/cqrs.md` 与 `docs/.vitepress/config.mts`。
+- 接受的核心结论是：`Game.SourceGenerators` 需要新的 reader-facing 专题页，而 `SourceGenerators.Common` 和各 `*.SourceGenerators.Abstractions` 更适合作为现有入口中的共享排障层阅读路线。
+
+## 2026-04-30 / RP-052
+
+- 该批次提交为 `f88f96c3`（`docs(source-generators): 补充生成器专题覆盖并更新进度`）。
+- 提交后重新计算确认 committed branch diff vs `origin/main` 已回落到 `8` files / `337` lines，说明提交前的 `39` files / `2555` lines 只是临时工作树峰值，不应继续作为默认恢复指标。
+- active topic 后续仍可以继续按 `$gframework-batch-boot 50` 推进，但应优先挑“已有 package README、但站内专题仍不足”的覆盖切片。

ai-plan/public/documentation-full-coverage-governance/archive/todos/documentation-full-coverage-governance-validation-history-rp-049-to-rp-052-2026-05-01.md

@@ -0,0 +1,70 @@
+# Documentation Full Coverage Governance Validation History (RP-049 to RP-052)
+
+## 2026-04-29 / RP-049
+
+### 页面校验
+
+- `bash .agents/skills/gframework-doc-refresh/scripts/validate-all.sh docs/zh-CN/godot/storage.md`
+- `bash .agents/skills/gframework-doc-refresh/scripts/validate-all.sh docs/zh-CN/godot/setting.md`
+- `bash .agents/skills/gframework-doc-refresh/scripts/validate-all.sh docs/zh-CN/godot/signal.md`
+- `bash .agents/skills/gframework-doc-refresh/scripts/validate-all.sh docs/zh-CN/godot/logging.md`
+- `bash .agents/skills/gframework-doc-refresh/scripts/validate-all.sh docs/zh-CN/godot/index.md`
+- `bash .agents/skills/gframework-doc-refresh/scripts/validate-all.sh docs/zh-CN/game/scene.md`
+- `bash .agents/skills/gframework-doc-refresh/scripts/validate-all.sh docs/zh-CN/game/config-system.md`
+- `bash .agents/skills/gframework-doc-refresh/scripts/validate-all.sh docs/zh-CN/core/index.md`
+- `bash .agents/skills/gframework-doc-refresh/scripts/validate-all.sh docs/zh-CN/ecs/arch.md`
+  - 结果：通过；本轮页面的 frontmatter、链接与代码块校验通过。
+
+### README 链接校验
+
+- `bash .agents/skills/gframework-doc-refresh/scripts/validate-links.sh GFramework.Godot/README.md tools/gframework-config-tool/README.md`
+  - 结果：通过；reader-facing 链接标签调整后目标有效。
+
+### 站点构建
+
+- `bun run build`（工作目录：`docs/`）
+  - 结果：通过；站点仍可构建，仅保留既有大 chunk warning。
+
+## 2026-04-29 / RP-050
+
+### 页面校验
+
+- `bash .agents/skills/gframework-doc-refresh/scripts/validate-all.sh docs/zh-CN/game/data.md`
+- `bash .agents/skills/gframework-doc-refresh/scripts/validate-all.sh docs/zh-CN/game/storage.md`
+- `bash .agents/skills/gframework-doc-refresh/scripts/validate-all.sh docs/zh-CN/godot/ui.md`
+  - 结果：通过；本轮 3 个页面的 frontmatter、链接与代码块校验通过。
+
+### README 链接校验
+
+- `bash .agents/skills/gframework-doc-refresh/scripts/validate-links.sh GFramework.Cqrs.Abstractions/README.md GFramework.SourceGenerators.Common/README.md`
+  - 结果：通过；README reader-facing 标签调整后目标有效。
+
+### 站点构建
+
+- `bun run build`（工作目录：`docs/`）
+  - 结果：通过；本轮 reader-facing 收口后站点仍可构建，仅保留既有大 chunk warning。
+
+## 2026-04-30 / RP-051
+
+### 页面校验
+
+- `bash .agents/skills/gframework-doc-refresh/scripts/validate-all.sh docs/zh-CN/source-generators/schema-config-generator.md`
+- `bash .agents/skills/gframework-doc-refresh/scripts/validate-all.sh docs/zh-CN/source-generators/index.md`
+- `bash .agents/skills/gframework-doc-refresh/scripts/validate-all.sh docs/zh-CN/source-generators/cqrs-handler-registry-generator.md`
+- `bash .agents/skills/gframework-doc-refresh/scripts/validate-all.sh docs/zh-CN/core/cqrs.md`
+- `bash .agents/skills/gframework-doc-refresh/scripts/validate-all.sh docs/zh-CN/api-reference/index.md`
+  - 结果：通过；新增专题页与相关入口页校验通过。
+
+### 站点构建
+
+- `bun run build`（工作目录：`docs/`）
+  - 结果：通过；新增 `Schema 配置生成器` 入口后站点仍可构建，仅保留既有大 chunk warning。
+
+## 2026-04-30 / RP-052
+
+### 提交后状态确认
+
+- `git status --short --branch`
+- `git diff --name-only origin/main...HEAD | wc -l`
+- `git diff --numstat origin/main...HEAD`
+  - 结果：通过；提交后工作树 clean，相对 `origin/main` 的 committed diff 为 `8` files / `337` lines。

ai-plan/public/documentation-full-coverage-governance/archive/traces/documentation-full-coverage-governance-trace-history-rp-049-to-rp-052-2026-05-01.md

@@ -0,0 +1,31 @@
+# Documentation Full Coverage Governance Trace History (RP-049 to RP-052)
+
+## Scope
+
+- 该归档记录 `RP-049` 到 `RP-052` 从 active trace 迁出的阶段时间线，保留每轮恢复点、核心决策与停止条件。
+- 对应的验证明细继续保存在：
+  `ai-plan/public/documentation-full-coverage-governance/archive/todos/documentation-full-coverage-governance-validation-history-rp-049-to-rp-052-2026-05-01.md`
+
+## 2026-04-29 / RP-049
+
+- 由于旧 PR 恢复路径已经失效，这一轮改用 `origin/main` 作为唯一 batch baseline，并重新确认当前分支仍为 `docs/sdk-update-documentation`。
+- 本轮主要清理 `godot`、`game` 与少量 README 中仍显露内部证据、命令式导流和原始路径标签的 reader-facing 问题。
+- 停止条件保持为 `$gframework-batch-boot 50`，但本轮并未逼近阈值。
+
+## 2026-04-29 / RP-050
+
+- 主线程继续沿低风险文案批次推进，接受 2 个 explorer 的热点排序，只处理“改句子即可闭环”的页面与 README 标签问题。
+- 实际落地集中在 `game/data.md`、`game/storage.md`、`godot/ui.md` 与 2 个 README。
+- 剩余命中已接近结构级 README 重写，因此被明确排除出这一轮批次。
+
+## 2026-04-29 / RP-051
+
+- 在确认 `HEAD` 与 `origin/main` 同步后，本轮把目标提升为新的 docs coverage 入口补链，而不是继续做纯措辞巡检。
+- 接受的结论是：`Game.SourceGenerators` 需要独立专题页，而 `SourceGenerators.Common` 与各 `*.SourceGenerators.Abstractions` 只需要在 landing / API 入口内承担共享 diagnostics 与 attribute 契约说明。
+- 与此同时，`Cqrs.SourceGenerators` 的真实缺口被限定为对 fallback 精度、分层策略和 `GF_Cqrs_001` 判断顺序的 reader-facing 解释，而不是继续新增第二张专题页。
+
+## 2026-04-30 / RP-052
+
+- 这一轮 coverage 扩展提交为 `f88f96c3`，提交后 branch diff 相对 `origin/main` 回落到 `8` files / `337` lines，重新释放了 stop-condition 余量。
+- active topic 后续仍可继续扩批，但更适合选择“已有 package README、但站内 docs 仍缺 reader-facing 专题”的切片，而不是继续给共享支撑层单开页面。
+- 该状态也为后续用 `$gframework-pr-review` 精确跟进最新 review 线程提供了更清晰的恢复入口。