Agent-System/.doc/ops/short-term/2026-09-14-final-artifact-vault-plan.md

title, status, created, updated, owner, branch, worktree, mutex

title	status	created	updated	owner	branch	worktree	mutex
最终成果保险库调研与整改方案	done	2026-09-14	2026-09-14	Codex	fix/dev-runtime-data-root-guard	.worktrees/fix-dev-runtime-data-root-guard	artifact-vault

最终成果保险库调研与整改方案

目标

评估并完善“只归档最终生成物和最终智能体回复”的提案，形成不会与数据库、文档账本和工作区争夺事实源，且能支持受控部分恢复的系统方案。

范围

• 最终文档版本、最终助手回复和必要恢复元数据的归档边界；
• 终态判定、原子发布、不可变清单、校验、授权、保留与删除；
• 工作区清理门禁、降级读取、隔离恢复和数据库重建边界；
• 与现有数据生命周期、迁移语料、文档账本和对话持久化方案衔接。

非目标

• 本轮不实现业务代码、数据库迁移或对象存储；
• 不归档候选稿、流式片段、工具轨迹、租约、临时工作区或其他中间结果；
• 不把保险库定义为运行数据库的完整镜像或自动覆盖线上数据的入口；
• 不执行数据删除、卷切换或恢复写入。

步骤

1. 登记任务和独立 mutex。
2. 核对现有文档快照、CAS、最终助手消息、任务终态和备份恢复边界。
3. 评审提案，明确可采用部分、必须修正部分和反模式。
4. 编写专项调研与整改方案，并并入运行数据生命周期方案。
5. 更新 CURRENT、FEATURE-MATRIX、gap-matrix 与整改索引。
6. 完成文档一致性、安全、可行性和对抗性复核。

验收标准

• 明确“最终”的服务端判定规则和禁止进入保险库的内容。
• 明确数据库、工作区、保险库三者权威边界，不产生静默双写。
• 方案含 manifest/checksum、幂等发布、清理前门禁、降级读取和隔离恢复流程。
• 明确可恢复与不可恢复的数据范围、安全/删除要求及恢复演练。
• 本轮未实施业务代码或破坏性操作。

相关链接

• Research: 最终成果保险库与部分恢复边界
• Remediation: 最终成果保险库与受控恢复
• Test report: 待用户批准实施后创建

证据 / 备注

• 当前受控文档不可变正文位于 PostgreSQL document_content_blobs，工作区 output.md 是投影。
• 当前附件 CAS 物理 blob 位于运行状态根，引用元数据位于 PostgreSQL。
• 当前任务完成摘要通过 FinalizeAssistantTaskMessage 写回 chat_messages，尚无独立终态成果发布协议。
• 文档复核补齐：显式发布不可绕过终态、不可变 payload staging、项目作用域加密 CAS/引用删除、存量回填、掉电持久化、敏感内容准入、既有项目授权降级和 scratch 恢复权限。
• 独立 Claude 安全/对抗复核结果已收敛；whole-document peer 因结构化输出重试耗尽被丢弃，未作为结论依据。