Agent-System/.doc/archive/ops/2026-09-13-document-revision-quality-repair-workspace-contract.md

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

title	status	created	updated	owner	branch	worktree	mutex
质量修复子工作区契约	done	2026-09-13	2026-09-14	Cursor-Auto	fix/document-revision-quality-repair-workspace-contract	-	document-revision-quality-repair-workspace-contract

质量修复子工作区契约

目标

堵住第13轮 UI-03：repair 步 TASK 引导 ../../output.md，模型越界改根文件，本地目标缺失导致 quality_failed 停在 70。门禁判定保持，修复契约改为本地快照 + containment。

范围

• internal/squad/repair_workspace.go 与单测
• EnsureQualityOrRepair / buildSubWorkspaces snapshot 布局
• audit / remediation / CURRENT

非目标

• 不放宽必填章节；不把越界根文件当成功；不隐藏 quality_failed
• 不改默认步骤的 ../../ context 导航
• 不碰证据目录；不合 dev；不 rebuild Docker；不 E2E；不 push

步骤

1. 从 dev@8b1a531 开分支并登记 mutex
2. 快照契约 + containment + 测试
3. 独立审查 fail-open：runErr / containment 不得提升；restore 失败硬返回；创建/删除计入 mutation
4. gofmt / vet / go test -short ./... / -race squad+agent / settle-policy.test.mjs / git diff --check
5. 真实 UI-03（本轮不做）

验收标准

• 仅 runErr==nil ∧ 无 containment ∧ TrustedLocalDeliverable=true 才覆盖根并重验
• 越界（含创建/删除受保护父级）恢复后不提升，报告 FAIL
• backend 失败/超时即使留下本地目标也不提升
• restore 失败立即返回，可测策略能断言错误传播
• 现场 UI-03（未跑）

相关链接

• Audit: ../../audit/2026-09-13-document-revision-quality-repair-workspace-contract.md
• Remediation: ../../remediation/2026-09-13-document-revision-quality-repair-workspace-contract.md

证据 / 备注

• mutex：document-revision-quality-repair-workspace-contract（新 mutex，不与现有 in_progress 冲突）
• 基线：dev@8b1a531
• 验证（fail-closed 追加）：gofmt / go vet ./... / go test -short ./... / go test -short -race ./internal/squad/ ./internal/agent/ / node --test deploy/pi-agent/settle-policy.test.mjs / git diff --check PASS
• 保护范围仅 output.md / template.md / blackboard.json；其它父级文件是剩余风险
• 未跑真实 UI-03，不得标 done；不得 merge / rebuild / E2E / push