manage-codebase-refresh

用途：根据近期代码变更刷新代码库文档，保持文档与源码同步。主要能力：检测自基线以来的 Git 变更，映射到 doc-index.json 中的文档条目，刷新受影响文档；若存在 knowledge-graph.json，则做 KG 影响分析并标记受影响 wiki 条目；用 --deep 触发对相邻文件的深度重扫。用法：$manage-codebase-refresh，可用 $manage-codebase-refresh "--since 2026-03-15"、"--deep" 或 "--since 3d --deep"。--since 覆盖变更检测窗口，支持 ISO 日期或相对时间如 3d；--deep 对轻微变更也强制深度重扫。基线优先级为 --since、state.json.codebase_last_refreshed、codebase_last_rebuilt，最后回退为 7 天。输出边界：只允许写入 .workflow/codebase/ 下的文档与 doc-index.json，以及 .workflow/state.json 的 codebase_last_refreshed，绝不修改源代码或这些路径之外的文件。限制与错误：若 .workflow/ 未初始化报 E001；若无代码库文档需改用 $manage-codebase-rebuild（E002）；若无变更则 W001 并退出。KG 不存在时跳过相关分析，资料未提供更进一步的收费或平台信息。