merge: promote local dev to test (rc-v1.1.0-beta.1, schema 61)

go test under internal/server previously preferred package-local
data/test, so materials never reached the pi-agent bind mount and
intake quality gates failed closed on empty sandboxes.

.cursor/rules/agent-collaboration-docs.mdc

@@ -1,25 +1,6 @@
 ---
-description: 强制 Agent 文档同步与 ops 协作纪律；详情见 AGENTS.md
+description: 任务分级、授权、文档与收口入口
 alwaysApply: true
 ---
 
-# Agent 文档同步（强制）
-
-完整规范见 [AGENTS.md](../../AGENTS.md) 与 [PROJECT.md](../../PROJECT.md)。
-
-## 开场必读
-
-1. `AGENTS.md` → `PROJECT.md` → `.doc/README.md` → `.doc/ops/CURRENT.md` → `FEATURE-MATRIX` → short-term / handoff
-
-## 红线
-
-- 任务开始前：short-term/long-term + CURRENT 并行认领（mutex）
-- 合 dev + 容器测：占用 CURRENT 集成槽位；他人 queue 等待
-- 多 Agent 并行：worktree（`.worktrees/`）；禁止 worktree 内 env-service start
-- 禁止只改代码；done 任务 → `archive/ops/`
-- 验收报告 → `.doc/test-reports/`；运行产物 → `test-reports/assets/`
-- 禁止在 `.doc/` 根或 `docs/` 随意新建文档
-
-## 状态
-
-`planned | in_progress | blocked | done | cancelled`
+遵循 [AGENTS](../../AGENTS.md) 的启动、任务分级与收口规则。写入文档前读 [文档地图](../../.doc/README.md)；创建、集成、环境操作、清理前读 [操作规范](../../.doc/ops/2026-09-21-agent-worktree-workflow.md)。

.cursor/rules/git-secrets-autonomy.mdc

@@ -1,24 +1,6 @@
 ---
-description: Git push 凭证自主读取；禁止向用户索要 token；详情见 AGENTS.md §8
+description: 凭证与推送授权入口
 alwaysApply: true
 ---
 
-# Git Secrets 自主（禁止索要）
-
-完整规范见 [AGENTS.md](../../AGENTS.md) §8 与 [PROJECT.md](../../PROJECT.md) §7。
-
-## 本仓约定
-
-- 凭证：`${HOME}/.secrets/gitea`
-- 字段：`- ACCESS_TOKEN=`、`- URL_PREFIX=`
-- 推送：优先 `./scripts/git-push-dev.sh <branch>`
-
-## 禁止
-
-- 向用户索要或要求粘贴 token
-- 在聊天/文档/commit 中展示 secret
-- 写入 git config 或提交到仓库
-
-## 缺失时
-
-在 `.doc/ops` 记 blocker（路径 + 缺字段），提示用户本机补齐后重试；**仍不索要内容**。
+遵循 [AGENTS 安全与证据](../../AGENTS.md#5-安全与证据)；授权推送的凭证和脚本入口见 [PROJECT](../../PROJECT.md#凭证与推送)。

.cursor/rules/git-workflow-and-environments.mdc

@@ -1,60 +1,6 @@
 ---
-description: 项目固定3分支模型(dev/test/main)、逐步渐进式提交规范与三套独立服务（知识库共享+对话与DB隔离）准则
+description: 分支、原子提交与环境操作入口
 alwaysApply: true
 ---
 
-# Git 三分支流转与三套服务环境架构准则
-
-本仓库严格遵循以下固定分支体系、提交拆分规范与多套独立服务运行准则：
-
-## 一、 Git 固定三分支体系
-
-1. **开发分支 (`dev`)**:
-   - **合入基线**，不是日常 commit 目标。
-   - **禁止**在 `dev` 上直接开发提交（含 docs/chore）。
-   - 一律从最新 `dev` 检出 `feature/<name>` 或 `fix/<name>`，在 feature 分支上渐进式提交；自测后占集成槽位，`--no-ff` 合回 `dev`，并删除临时子分支（见 [AGENTS.md](../../AGENTS.md) §6.2）。
-
-2. **测试分支 (`test`)**:
-   - 当 `dev` 积累了一定的功能阶段后，合并至 `test` 分支，创建阶段候选节点 Tag（如 `rc-vX.Y.Z-beta.1`）。
-   - 用于较长时间的真实环境部署、全链路集成测试、运维稳定性检验。
-   - **严禁**在 `test` 分支进行开发或直接 commit。
-
-3. **主分支 (`main`)**:
-   - 生产发布分支（Release）。
-   - **严禁**直接在 `main` 上开发或 commit！
-   - 只有 `test` 分支的代码经过实际运维和测试充分验证达到发布标准后，方可将对应验证节点合并回 `main` 分支，并打正式发布 Tag（如 `v1.0.0`）。
-
----
-
-## 二、 任务拆分与渐进式提交规范 (Progressive Commits)
-
-- **原子性拆分**：严禁把整个任务的大量改动揉合成一次庞大的提交。
-- **阶段逐步提交**：一个任务必须按功能逻辑分层逐步提交：
-  1. `feat(db)` / `refactor(db)`: 数据表、模型、迁移脚本
-  2. `feat(agent)` / `feat(service)`: 业务逻辑、智能体执行流程
-  3. `feat(api)`: 接口路由与交互
-  4. `test(...)`: 单元测试与集成测试用例
-  5. `docs(...)` / `chore(...)`: 配置、运维脚本与文档同步
-- **提交规范**：遵循 Conventional Commits (`feat`, `fix`, `refactor`, `test`, `docs`, `chore`, `ci`)。
-
----
-
-## 三、 三套环境独立运行准则 (知识库共享 + 对话与DB隔离)
-
-三套独立服务对应三个分支的运行态：
-
-| 环境 | 分支 | Compose 项目 | HTTP 端口 | DB 端口 | 数据/对话路径 |
-| :--- | :--- | :--- | :--- | :--- | :--- |
-| **共享知识库** | 跨环境 | `agent-infra` | - | `5432` | `data/shared/kb` |
-| **开发环境** | `dev` | `agent-dev` | `8080` | `5433` | `data/dev` |
-| **测试环境** | `test` | `agent-test` | `8081` | `5434` | `data/test` |
-| **生产环境** | `main` | `agent-main` | `8000` | `5435` | `data/main` |
-
-### 核心约束：
-1. **知识库共享**：
-   - 三套环境服务均通过共享网络或内网连接同一个知识库数据库（`shuimu-kb-shared:5432`）。
-   - 知识库法规、向量索引保持全局一致。
-2. **对话数据与数据库隔离（红线）**：
-   - 各环境对话记录（Chat History）、Agent 思考工作区、审计事件及 SQLite/Postgres 业务库必须严格隔离！
-   - 严禁任何环境读取或写入其他环境的对话数据与业务库。
-   - 宿主机挂载目录严格区分：`data/dev/`、`data/test/`、`data/main/`。
+分支/原子提交边界见 [AGENTS](../../AGENTS.md)，环境拓扑见 [PROJECT](../../PROJECT.md)。创建、集成、环境写操作及清理按 [操作规范](../../.doc/ops/2026-09-21-agent-worktree-workflow.md) 执行。

.cursor/rules/test-reports-standard.mdc

@@ -1,65 +1,6 @@
 ---
-description: 规定项目中所有自动化测试、功能测试、集成测试报告的存放路径与结构标准规范
-globs: ["**/*test*.go", ".doc/test-reports/**/*.md"]
+description: 按变更范围选择测试及真实证据要求
 alwaysApply: true
 ---
 
-# 测试报告规范准则 (Test Reports Standard)
-
-本仓库严格遵循标准化、可追溯的质量测试管理体系。所有测试报告必须归档于指定的文档目录下，并遵循固定结构。
-
-## 一、 测试报告归档路径规范
-
-- **统一目录**：所有测试报告必须统一存放于 `.doc/test-reports/` 目录下。
-- **命名规范**：遵循 `YYYY-MM-DD-<模块/功能/版本>-test-report.md` 命名格式。
-  - 例如：`.doc/test-reports/2026-09-07-three-branch-intent-framework-test-report.md`
-- **证据附件**：运行产物（json/jsonl、workspace 快照、截图）放 `.doc/test-reports/assets/<report-slug>/`，**不得**与 `*-test-report.md` 混放在同一层级目录。
-
----
-
-## 二、 测试报告固定结构模板
-
-每份测试报告必须包含以下核心板块：
-
-```markdown
-# [功能/模块名称] 测试报告
-
-## 一、 测试背景 (Background)
-- 简述被测功能/特性的产生背景、业务痛点或上一轮测试中发现的缺陷与瓶颈。
-
-## 二、 测试目标 (Test Objectives)
-- 列举本次测试需要验证的核心功能点、质量指标（如通过率 100%、无流程卡点、非阻塞人机协同等）。
-
-## 三、 测试方案与环境 (Test Plan & Environment)
-- 测试环境（OS、Go 版本、后端 Stub/Real 模型）；
-- 测试层级分层（单元测试、协同集成测试、CLI 真实交互测试）；
-- 核心测试用例矩阵设计。
-
-## 四、 预期结果 (Expected Results)
-- 明确给出各用例输入下的理论判定分支、目标意图、提取槽位、参谋回复风格与状态机流转。
-
-## 五、 实际测试结果与判定 (Actual Results & Evaluation)
-- 必须包含针对每一个典型测试用例的真实记录：
-  - **测试输入 (Input)**
-  - **实际输出 (Actual Output)**：贴出真实的终端/日志输出文本
-  - **评价判定 (Evaluation / Verdict)**：PASS / FAIL 标志及判定依据
-  - **性能与耗时 (Duration & Latency)**
-
-## 六、 自动化测试套件汇总 (Test Suite Execution)
-- 附带 `go test -v ./...` 全量回归测试输出与通过率统计。
-
-## 七、 测试结论与后续优化建议 (Conclusion & Next Steps)
-- 总结测试是否达到上线/合并标准，提出后续演进或强化点。
-```
-
----
-
-## 三、 执行要求与真实 Agent 交付铁律
-
-1. **真实 Agent 交付铁律（红线）**：
-   - **开发实现阶段**：可以快速使用 `stub` 验证状态机、协议分流、数据落盘与逻辑契约，加速反馈；
-   - **交付前验收与测试报告生成**：**必须切回真实环境与真实 Agent（`pi-agent` + 实际运行的 `MiniMax-M2.7-highspeed` 容器）进行全链路端到端实测**；
-   - **严禁**使用 stub 的测试输出作为最终交付报告的验收数据。
-2. **严禁散落存放**：测试报告统一归档至 `.doc/test-reports/` 目录下，禁止散落在根目录或临时沙箱中。
-3. **真实控制台取样**：测试报告中的输入、输出、耗时与判定必须取自实际环境运行的真实控制台输出与日志。
-4. **Git 规范管理**：测试报告伴随对应阶段的 `docs(test)` 或 `test(...)` 规范提交入库。
+测试范围、精确产品 PI 入口、环境模型证据和报告格式统一见 [验证契约](../../.doc/ops/2026-09-21-validation-contract.md)。按实际变更选择适用行；报告大小不扩大测试范围。

.doc/README.md

@@ -33,6 +33,10 @@
 
 | 我要… | 读这里 |
 |--------|--------|
+| 规则来源/生效版本 | [规范登记](ops/2026-09-21-policy-registry.md) |
+| 选择测试/报告范围 | [验证契约](ops/2026-09-21-validation-contract.md) |
+| 任务模板与会话收口 | [任务模板](ops/templates/short-term-task.md) · [收口清单](ops/templates/session-close-checklist.md) |
+| 创建任务、集成、部署、清理 | [worktree 工作规范](ops/2026-09-21-agent-worktree-workflow.md) |
 | 当前在做什么 | [ops/CURRENT.md](ops/CURRENT.md) |
 | 模块完成度 | [status/FEATURE-MATRIX.md](status/FEATURE-MATRIX.md) |
 | 发布 blocker | [remediation/gap-matrix.md](remediation/gap-matrix.md) |
@@ -57,9 +61,13 @@
 
 ## 文档生命周期
 
+按 [AGENTS 任务分级](../AGENTS.md#2-任务分级与授权) 选择最小产物。下图是可选信息流，不要求每任务创建所有文件；小任务/有价值的只读审查可由一个主文档承载范围、结论、验证与交接。主文档先明确 task_id、owner、授权来源、状态和证据；跨阶段信息确需独立时才拆分并回链。
+
 ```text
 audit（问题）→ remediation（方案）→ ops/short-term（任务）
   → test-reports（验收）→ archive（关闭证据）
 ```
 
 状态字段：`planned | in_progress | blocked | done | cancelled`
+
+会话结束不等于任务完成；只有 done/cancelled 任务归档。CURRENT 保留最多 3 项焦点及活跃/阻塞/待集成/待清理事项，完成认领和长证据迁入 [历史快照](archive/ops/2026-09-21-current-history.md)。移动文档同步修复相对链接，保留证据与来源。规范生命周期另用 proposed/approved/active/deprecated；工具能力另用 manual/enforced。

.doc/adr/2026-09-14-modular-monolith-decoupling.md

@@ -2,7 +2,7 @@
 
 ## 状态
 
-提议（2026-09-14；架构与实施计划已修订，等待用户确认后进入首个实现里程碑）
+已接受（2026-09-14 提议；2026-09-18 确认——Phase 1 纵向绞杀与 Phase 2 持久事件交付已落地并验收，见 gap-matrix `DOC-RELIABILITY-PILOT` PASS、[Phase 1 计划](../remediation/2026-09-14-module-decoupling-refactor-plan.md)、[Phase 2 修订计划](../remediation/2026-09-15-module-decoupling-ipc-phase2-remediation-plan.md)、[Track E 复盘](../ops/research/2026-09-15-track-e-retrospective.md)）
 
 ## 背景
 

.doc/adr/2026-09-17-d7-chat-data-retention.md

@@ -0,0 +1,63 @@
+---
+title: "D7 对话数据留存与删除口径（草案）"
+status: proposed
+created: 2026-09-17
+updated: 2026-09-17
+compliance: pending-compliance-signoff
+owner: Cline
+related:
+  - ../remediation/2026-09-16-partial-deferred-completion-plan.md
+  - ../ops/short-term/2026-09-16-partial-deferred-completion.md
+  - ../status/FEATURE-MATRIX.md
+---
+
+# ADR：D7 对话数据留存与删除口径
+
+## 状态
+
+**提议 / 工程草案**（2026-09-17）。数字与删除口径标 `pending-compliance-signoff`：合规签字或改数前，W7 仅允许数据分类盘点与现状审计，不得按未签字数字执行物理删除或备份清除。接受后状态改为 `accepted`。
+
+## 背景
+
+FEATURE-MATRIX「对话数据治理（D7）」为 `deferred`。收口计划 W7 要求：数据分类盘点 → 留存/删除口径落 ADR → 库/备份/日志控制 → 敏感字段加密边界。工程不能单方面定合规数字，但必须提供可审草案，避免无限期停在 deferred。Track E / R13 / R18 / R22 已对日志脱敏与销毁门禁有硬约束，本 ADR 将其固化为 D7 口径。
+
+## 决策（建议默认；待合规确认）
+
+### 1. 数据分类与留存
+
+| 数据类 | 留存 | 说明 |
+|--------|------|------|
+| 会话正文（chat sessions/messages） | 热库 **365 天**（可配置） | 超期 soft-delete → 观察窗 → 物理清理 |
+| 派生文档 / 私密文档 | 与聊天**独立周期**；回收站 **30 天**后物理清理 | 删除 UI 须说明影响范围（只删聊天 / 只删文档 / 两者） |
+| 审计元数据（导出/治理审计） | **180 天** | 不可被普通用户删除覆盖 |
+| Agent trace / workspace 非终态 | 任务结束后 **30 天**；nightly 仅合成数据 | 禁止当长期事实源 |
+| 日志 / dead-letter / reconciliation | 不按正文留存；**只存 ID、digest、typed error code、allowlist 摘要** | Track E 红线 |
+| FAV 终态制品 | `retention_class` + legal hold + delete ledger | 与聊天口径解耦 |
+
+### 2. 删除路径
+
+1. **用户删除**：soft-delete / tombstone → 观察窗 → 物理清理。
+2. **备份清除**：须二次批准 + 精确 delete manifest；对齐销毁门禁 R22（完整备份恢复演练、migration corpus、FAV coverage、manifest、用户批准）。
+3. **删除界面**：必须说明聊天源消息与派生文档的独立保留周期及本次操作影响范围。
+
+### 3. 加密边界（首期）
+
+- 首期范围：敏感字段**盘点** + 传输与备份访问控制。
+- **不默认**上字段级加密；选型待合规确认与威胁模型后再立实现任务。
+
+### 4. 违规升级
+
+盘点确认当前基线违反已确认的安全或合规要求 → **立即**写入 [`gap-matrix.md`](../remediation/gap-matrix.md)，不得继续当普通 backlog；本行 `done` 让位于整改。
+
+## 后果
+
+- W7 可按本草案启动盘点；物理删除与备份清除在 `pending-compliance-signoff` 解除前禁止按建议数字自动执行。
+- 2026-09-17 只读盘点：[../audit/2026-09-17-d7-data-inventory.md](../audit/2026-09-17-d7-data-inventory.md)（未删数据、未升矩阵 done、未写 gap-matrix blocker）。
+- 日志/DLQ/reconciliation 实现与审计须持续满足 Track E ID-only 红线。
+- 合规改数后：更新本 ADR 数字表、`updated` 日期，并将 `compliance` 改为 `signed` / `accepted`；再开 W7 整改实现。
+
+## 相关链接
+
+- 收口计划 §7.1：[../remediation/2026-09-16-partial-deferred-completion-plan.md](../remediation/2026-09-16-partial-deferred-completion-plan.md)
+- FEATURE-MATRIX D7 行：[../status/FEATURE-MATRIX.md](../status/FEATURE-MATRIX.md)
+- Track E Phase 2：[../remediation/2026-09-15-module-decoupling-ipc-phase2-remediation-plan.md](../remediation/2026-09-15-module-decoupling-ipc-phase2-remediation-plan.md)

.doc/archive/design/2026-09-17-personal-engineering-control-center-plan.md

@@ -0,0 +1,609 @@
+---
+title: "个人工程中控台：实时项目看板与离线 HTML 快照"
+type: feat
+date: 2026-09-17
+artifact_contract: ce-unified-plan/v1
+product_contract_source: ce-plan-bootstrap
+execution: code
+---
+
+> **已废弃（2026-09-17；2026-09-19 更新）**：旧版只读工程中控台代码已移除。后来短暂合入的 Control Center 也已移出本仓库，进度管理由独立项目承担。本文仅作历史证据保留。
+
+# 个人工程中控台：实时项目看板与离线 HTML 快照
+
+## Goal Capsule
+
+为仓库所有者提供一个独立于产品后台的本地只读中控台。打开一个页面即可判断当前系统由什么组成、哪些任务正在计划或实施、真实分支和 worktree 在哪里、各环境实际运行了什么，并能在两次点击内到达对应的设计、审计、整改、任务和测试材料。
+
+中控台同时提供两种输出：
+
+1. `serve`：持续采集本地仓库、Git 和运行环境，提供自动刷新的 HTML 页面与机器可读 JSON；
+2. `export`：基于同一份不可变快照生成单文件 HTML，便于归档、离线查看和交接。
+
+这不是产品功能，不接入产品后台、产品数据库或产品权限体系；它也不是发布系统，不执行 Git、Docker、部署或文档写操作。
+
+### 成功标准
+
+- 在当前仓库规模下，首次可用页面目标为 2 秒内出现；慢数据源可随后标记为 `degraded`，不得拖垮整页。
+- 正常情况下，本地文件、Git 或运行态变化在 5 秒内反映到新快照。
+- 页面分别展示“文档声明、Git 实施、验证证据、环境实装”，不把任务文档的 `done` 翻译为已合并或已部署。
+- 每个关键结论均显示来源、采集时间、新鲜度和可信类型；冲突保留双方证据，不静默选边。
+- 在线模式检索 allowlist 内未截断的 Markdown 正文；离线导出同时给出 included、truncated 和 metadata-only 清单，二进制附件只索引路径、类型、大小和归属。
+- 单文件 HTML 默认权限为 `0600`，可脱离仓库阅读已纳入 inclusion manifest 的 Markdown 正文，并醒目标出截断或仅元数据条目；不打包 `.doc/**/assets`。
+- 任一采集源失败时仍可查看最近成功数据，并明确显示 `stale/error/last_success_at`。
+
+---
+
+## Product Contract
+
+### 用户与使用场景
+
+唯一主要用户是仓库所有者。典型使用包括：
+
+- 每天开始工作时查看焦点任务、阻塞、集成槽和环境异常；
+- 从模块进入设计、任务、测试和部署证据链；
+- 判断某项工作究竟只是有计划、正在实现、已经验证，还是已在某环境实装；
+- 查看本地分支、远端跟踪引用、ahead/behind、worktree 和未提交变更；
+- 发现 `CURRENT`、功能矩阵、发布门禁、Git 与 Docker 之间的漂移；
+- 导出一个自包含 HTML，作为某一时点的项目快照。
+
+### 已确定的产品决策
+
+#### PKD-1：独立本地工具
+
+采用独立 Go CLI 和本地 Web 页面，不加入现有产品后台。
+
+（session-settled: user-approved — chosen over product-admin integration: the console is for the repository owner’s local engineering management and the production image excludes `.doc` and `.git`）
+
+#### PKD-2：只读实时页与离线快照共用数据模型
+
+实时服务和导出文件必须由同一份版本化快照生成，避免在线页面与离线报告出现两套口径。
+
+（session-settled: user-approved — chosen over a static-only report: the requested console must follow agent tasks and project state as they change）
+
+### 核心需求
+
+| ID | 需求 |
+|---|---|
+| R1 | CLI 默认解析当前 Git 仓库根，也接受显式 `--repo`；页面始终显示绝对根路径、当前分支、HEAD 和采集时间。 |
+| R2 | 仅监听 `127.0.0.1`，不依赖产品容器、产品数据库或产品登录。 |
+| R3 | 架构与模块页聚合 `module-boundaries.yaml`、系统设计索引和 `FEATURE-MATRIX`，展示模块、能力、依赖和证据链。 |
+| R4 | 任务状态至少拆为 `doc_status`、Git facets、`verification_result`/`verification_freshness`、deployment facets；可并存事实不得压成单值枚举。 |
+| R5 | Git 页展示本地/跟踪分支、ahead/behind、最近提交、worktree、dirty/untracked 和任务声明匹配情况；不得隐式 `fetch`。 |
+| R6 | 部署页按 shared/dev/test/main 分别展示容器状态、应用 readiness、服务完整性、schema、镜像与 promotion receipt；不得计算未经定义的综合绿灯。 |
+| R7 | 文档页支持按 taxonomy、状态、模块和关键词筛选，展示正文、正向链接、反向链接、broken、orphan 与 unindexed 状态；查询状态可通过 URL 恢复。 |
+| R8 | 一个不可变快照包含 `schema_version`、`generation_id`、`revision_id`、`generated_at`、仓库/提交身份、来源状态、事实与冲突。 |
+| R9 | 自动刷新采用完整快照原子切换；每个来源独立超时，失败时保留最近成功数据并标注过期。 |
+| R10 | 每条关键事实标注 `declared`、`observed`、`verified` 或 `inferred`，并保留来源路径和采集时间。 |
+| R11 | 单 HTML 内嵌结构化模型、页面资源和允许导出的 Markdown 正文；附件只保留元数据及相对链接，并显示内容覆盖清单。 |
+| R12 | 对 Agent 暴露稳定的只读 JSON，而不是让 Agent 解析 HTML；JSON 与页面引用同一 `generation_id` 和 `revision_id`。 |
+| R13 | TaskState 显示声明的 owner/Agent 类型/认领/mutex 与基于 Git 的最近活动证据；Herdr 工程 Agent 和产品 PI Agent Runner 使用不同类型。没有运行态来源时必须显示 unknown，不得把“已认领”写成“正在执行”。 |
+| R14 | 文件、命令和 HTTP 均采用 allowlist；拒绝路径穿越、symlink 越界、原始 HTML 执行、远程资源加载和凭证读取。 |
+
+### 事实源与权威边界
+
+| 领域 | 权威来源 | 中控台处理方式 |
+|---|---|---|
+| 发布门禁 | `.doc/remediation/gap-matrix.md` | 只解释发布 blocker，不替代能力完成度。 |
+| 能力成熟度 | `.doc/status/FEATURE-MATRIX.md` | 显示功能完成度，不据此推断是否部署。 |
+| 当前焦点、认领、集成槽 | `.doc/ops/CURRENT.md` | 作为团队声明，与 Git 和运行态对账。 |
+| 任务计划 | `ops/short-term`、`ops/long-term`、backlog front matter | 作为计划状态，不据此推断实现。 |
+| 分支与 worktree | Git plumbing | 作为本地观测；远端状态注明“基于本地 refs，未联网刷新”。 |
+| 环境运行态 | Docker/Compose 元数据与 `/ready` | 分开展示容器、应用与服务完整性。 |
+| 验收证据 | `.doc/test-reports` 及 promotion receipts | 显示证据存在性与身份，不以文件名替代内容校验。 |
+
+来源之间不设全局覆盖顺序。各来源回答自己的问题；值不一致时生成 drift，并并列展示原值、时间和来源。
+
+### 用户流程
+
+```mermaid
+flowchart LR
+    Start[启动 serve 或 export] --> Root[解析显式 repo root]
+    Root --> Collect[并行采集文档 Git 运行态]
+    Collect --> Snapshot[构建不可变快照]
+    Snapshot --> Reconcile[按领域对账]
+    Reconcile --> Live[本地实时页面和 JSON]
+    Reconcile --> Export[单文件 HTML]
+    Live --> Refresh[定时生成下一快照]
+    Refresh --> Snapshot
+```
+
+总览默认优先显示 `in_progress`、`blocked`、`planned`、`partial/deferred`、drift 和 degraded。`done` 与 archive 默认收起，避免历史材料淹没当前工作。
+
+任务详情按照以下证据链导航：
+
+```mermaid
+flowchart LR
+    Audit[audit 问题] --> Remediation[remediation 方案]
+    Remediation --> Task[任务声明]
+    Task --> Git[分支 worktree commit merge]
+    Git --> Test[测试与验收报告]
+    Test --> Deploy[环境 artifact 与 readiness]
+```
+
+显式 Markdown 链接和既定 taxonomy 属于强关系；仅由文件名或 slug 推断的关系标为“候选”，不得参与完成度计算。
+
+### 状态模型
+
+```mermaid
+flowchart TB
+    D[doc_status: planned/in_progress/blocked/done] --> View[并列状态视图]
+    G[Git facets: branch/worktree/merge/cleanliness/ahead-behind] --> View
+    V[Verification: result + freshness + bound identity] --> View
+    P[Deployment facets: container/readiness/services/artifact identity] --> View
+    View --> Drift{来源是否一致}
+    Drift -->|是| Consistent[consistent]
+    Drift -->|否| Conflict[drift + 双方证据]
+```
+
+“实装”定义为存在可核对的环境观测证据，而不是任务文档为 `done`。容器可达但 artifact identity 无法核对时显示“运行可见、版本未验证”，不得提升为 verified deployment。当文档声明 healthy、Docker 显示异常而 `/ready` 为 ok 时，页面保留多值并标记 drift，不输出统一绿灯。
+
+### 真实验收样本
+
+1. rdev：存在调研、设计、任务与 backlog，但若没有 CURRENT 认领和真实分支，应显示“已计划、未认领、未实施、未实装”。
+2. main 环境：若 CURRENT 声明整体 healthy，而 events 容器实际 restarting、应用 `/ready` 仍为 ok，应同时显示三项证据与 drift。
+3. 本地 dev：若分支领先 `origin/dev`，必须显示“本地已具备、远端未确认可用”，不得写成已远程发布。
+4. `system-admin-console`：作为产品管理后台能力，与本计划的个人工程中控台分开展示，名称和边界不得混淆。
+
+### 安全与非目标
+
+一期明确不做：
+
+- 不写文档，不修改任务状态，不占用集成槽；
+- 不创建、切换、合并、删除或推送 Git 分支；
+- 不执行 `git fetch`，不调用远端托管平台 API；
+- 不启动、停止、重建或部署容器；
+- 不控制 Herdr 或向 Agent 派发任务；
+- 不读取 `.env`、`.secrets`、Docker `Config.Env`、数据库数据或 `.git` 内部文件正文；
+- 不加入产品 API、产品前端、产品数据库或生产镜像；
+- 不执行 Markdown 原始 HTML、脚本、Mermaid 或远程资源。
+
+后续候选包括跨快照历史、远端 CI/Gitea 聚合、受限 Markdown/Mermaid 渲染、Agent 查询 API 和修复建议。任何写操作继续保持在本工具之外。
+
+---
+
+## Planning Contract
+
+### High-Level Technical Design
+
+以下图示冻结边界和协议，不规定具体函数签名。
+
+```mermaid
+flowchart LR
+    Docs[.doc sources] --> DC[Document collector]
+    Git[Git/worktrees] --> GC[Git collector]
+    Run[Docker/ready/receipts] --> RC[Runtime collector]
+    DC --> Build[Snapshot builder]
+    GC --> Build
+    RC --> Build
+    Build --> Rec[Reconcile facts and conflicts]
+    Rec --> JSON[Read-only JSON]
+    Rec --> Web[Local HTML]
+    Rec --> File[Offline HTML]
+```
+
+```mermaid
+sequenceDiagram
+    participant UI as Browser
+    participant C as Collection coordinator
+    participant S as Sources
+    participant P as Snapshot publisher
+    UI->>C: poll with revision_id
+    C-->>UI: current snapshot immediately
+    C->>S: singleflight collection with deadlines
+    S-->>C: facts or source error
+    C->>P: publish complete generation atomically
+    P-->>UI: new revision or not-modified
+```
+
+```mermaid
+stateDiagram-v2
+    [*] --> Loading
+    Loading --> Fresh: first collection succeeds
+    Loading --> ErrorUnknown: first collection fails
+    Fresh --> Refreshing: TTL expires
+    Refreshing --> Fresh: new generation succeeds
+    Refreshing --> Stale: source fails and last-known exists
+    Stale --> Fresh: source recovers
+    ErrorUnknown --> Fresh: source first succeeds
+```
+
+### 技术决策
+
+#### KTD-1：采用仓库内独立 Go CLI
+
+新增 `cmd/engineering-dashboard` 与 `internal/engineeringdashboard`，复用仓库 Go 工具链但不导入产品业务包。Go 标准库足以提供本地 HTTP、资源嵌入、JSON、并发和原子文件输出；现有 `yaml.v3` 可用于已定义的 YAML 契约。
+
+#### KTD-2：快照是唯一交付模型
+
+采集器只生产事实，reconcile 层只生产派生状态和冲突，HTTP/API/export 只消费已完成的不可变快照。快照至少包含：
+
+```text
+schema_version, generation_id, revision_id, generated_at, collection_duration
+repository { root, branch, head, dirty }
+sources[] { name, status, observed_at, last_success_at, error }
+facts[] { subject, field, value, provenance, source_ref, observed_at, confidence }
+conflicts[] { subject, field, kind, fact_refs[] }
+documents[], modules[], tasks[], git[], environments[]
+```
+
+`generation_id` 唯一标识一次采集，包含采集批次语义；`revision_id` 只由 schema、仓库身份和规范化的非易变事实、冲突、来源状态确定，明确排除 `generated_at`、`observed_at` 和采集耗时。HTML 与 JSON 必须展示同一对标识，HTTP ETag 和前端是否重绘使用 `revision_id`。一期不读取旧 schema 的外部 JSON；离线 HTML 自带对应 renderer，因此不依赖未来二进制迁移。
+
+#### KTD-3：专用解析器与容错索引并存
+
+对 CURRENT、FEATURE-MATRIX、gap-matrix、任务 front matter 和 module boundaries 编写契约化解析器。文档层只索引 promotion receipt 的路径与链接，结构化部署凭证由运行态采集器唯一负责。对其余 Markdown 只提取安全元数据、标题、正文与链接。专用解析器失败时保留原文入口并标记 degraded，不凭模糊规则编造状态。
+
+#### KTD-4：命令执行采用固定 argv 和超时
+
+Git 与 Docker 采集通过注入式 command runner 执行固定程序和分离 argv，不通过 shell 拼接。`--repo` 先转为绝对、symlink-resolved 的 Git 根并作为单个参数传递。每个来源默认 2 秒超时；错误输出做长度限制和敏感字段清理。Git 使用 porcelain/plumbing 输出，例如 `status --porcelain=v2`、`worktree list --porcelain`、`for-each-ref`、`rev-list`、`merge-base`。
+
+#### KTD-5：一期采用短轮询，不引入持久数据库
+
+服务端由单一采集协调器按 TTL 触发完整重采集，2–5 秒刷新；同一仓库最多一轮采集在途，请求只读取当前快照，不直接叠加扫描。每轮带单调 generation 序号和整轮 deadline，只有当前有效轮次能原子发布。页面使用 ETag/`revision_id` 避免重复传输。last-known 只在同一 `serve` 进程内有效；冷启动或单次 export 首次采集失败时显示 unknown/error，不伪造历史值。文件监听、SSE 通知、持久缓存和历史数据库均后置。
+
+#### KTD-6：安全阅读优先于富渲染
+
+在线详情页一期将 Markdown 全部作为纯文本安全转义，并保留换行和空白；标题、列表、链接、代码、图片和 Mermaid 均显示源码，不生成 HTML 节点或发起资源请求。静态导出内嵌同一正文和内部导航。所有文档 ID 都是规范化仓库相对路径，只允许 `.doc/**/*.md` 及明确列入 allowlist 的根 Markdown；读取前后都校验解析路径，直接拒绝 symlink，并对 `.git`、`.env*`、`.secrets`、`data` 等敏感路径执行最终目标 denylist。
+
+#### KTD-7：导出为自包含、有限尺寸的证据快照
+
+导出将模型、CSS、JS 和允许的 Markdown 正文写入单 HTML，采用临时文件加 rename 原子落盘，默认 `0600`。数据使用 HTML-safe JSON 或等价编码封装，正文只通过 `textContent`/DOM API 写入；CSP 禁止网络、外部资源和内联事件执行。默认只嵌入 Git tracked、allowlist 内的 Markdown；untracked Markdown 只列元数据，除非用户显式选择。导出前输出 inclusion manifest 与敏感模式告警；`.doc/**/assets`、数据库、构建产物和二进制报告不嵌入。
+
+### 建议目录
+
+```text
+cmd/engineering-dashboard/
+  main.go
+internal/engineeringdashboard/
+  model.go
+  collector.go
+  source_docs.go
+  source_git.go
+  source_runtime.go
+  reconcile.go
+  server.go
+  export.go
+  assets/
+    index.html
+    app.js
+    app.css
+  testdata/
+    docs/
+    git/
+    runtime/
+scripts/
+  engineering-dashboard.sh
+.doc/test-reports/
+  YYYY-MM-DD-engineering-dashboard-test-report.md
+```
+
+### 风险与缓解
+
+| 风险 | 缓解 |
+|---|---|
+| 文档结构并不完全统一 | 只对 SSOT 和任务 front matter 使用严格契约；其余文档容错索引并暴露解析告警。 |
+| 看板制造“假完成” | 多轴 facets、事实 provenance、验证身份绑定、冲突不覆盖、真实反例测试。 |
+| Docker/Git 卡住或不可用 | 独立超时、并行采集、last-known 状态、degraded 页面。 |
+| 文档 XSS 或路径穿越 | 纯文本渲染、HTML-safe 数据封装、CSP、路径 allowlist、拒绝 symlink、最终目标敏感路径 denylist。 |
+| `.doc` 附件导致扫描/导出失控 | 默认跳过 assets 内容，只采集元数据；设置单文档和总正文上限并报告截断。 |
+| 导出副本离开本机后 `0600` 不再提供保护 | 页面首部标明敏感快照、仓库身份和生成时间；输出 inclusion manifest，交接者自行控制接收者、保留期与删除。 |
+| worktree 与主 checkout 混淆 | 只管理 `--repo` 指定/解析出的根，页面常驻显示根与 HEAD；其他 worktree 仅作为 Git 元数据。 |
+| 本地 remote refs 被误认为远端实时状态 | 显示 refs 观测时间和“未联网刷新”，不自动 fetch。 |
+| 与产品 `system-admin-console` 命名冲突 | CLI、包和文档统一使用 `engineering-dashboard` / “个人工程中控台”。 |
+
+---
+
+## Implementation Units
+
+### U1：冻结快照、事实与状态契约
+
+**目标**：先建立不会把计划、实现、验证、部署混为一谈的模型与测试夹具。
+
+**覆盖需求**：R4、R8、R10、R12、R13；承接 PKD-2 的同源快照决策。
+
+**依赖**：无。
+
+**文件**：
+
+- `internal/engineeringdashboard/model.go`
+- `internal/engineeringdashboard/model_test.go`
+- `internal/engineeringdashboard/testdata/**`
+
+**实施要点**：
+
+1. 定义版本化 `Snapshot`、`SourceState`、`Fact`、`Conflict`、`TaskState`、`AgentClaim`、`EnvironmentState`。
+2. provenance 固定为 `declared|observed|verified|inferred`；freshness 固定为 `fresh|stale|error|unknown`。
+3. 状态使用可组合 facets：Git 分为 branch/worktree/merge/cleanliness/ahead-behind；验证分为 result/freshness/subject identity；部署分为 container/readiness/services/artifact identity。
+4. TaskState 保留 owner、agent kind、claim、mutex、声明分支、观测 worktree、最近活动时间及证据；声明与观测不可互相提升。
+5. 建立 rdev、dev ahead、main events restarting、CURRENT/worktree 不匹配等夹具。
+
+**测试场景**：
+
+- 文档 `done` 但无 merge/deploy 时，Git 与部署 facets 不改变；
+- `claimed` 但无可观测运行信号时，Agent 活动保持 unknown；Herdr 与产品 PI Runner 不共享类型；
+- 同字段多来源不一致时生成 conflict 并保留所有 fact 引用；
+- JSON round-trip 保留 schema 与 snapshot identity；
+- 枚举未知值失败且错误可定位。
+
+**完成证据**：模型测试通过，schema 示例落入 Go fixture，不存在页面专用的第二套状态类型。
+
+### U2：实现文档图谱与领域解析器
+
+**目标**：将 `.doc` taxonomy、模块、任务、测试和链接转换为可追溯文档图谱。
+
+**覆盖需求**：R3、R7、R10、R11、R14。
+
+**依赖**：U1。
+
+**文件**：
+
+- `internal/engineeringdashboard/source_docs.go`
+- `internal/engineeringdashboard/docs_test.go`
+
+**实施要点**：
+
+1. 扫描 allowlist 内 Markdown，默认跳过任何 `assets` 目录正文；记录附件元数据。
+2. 解析 front matter、标题、显式 Markdown 链接和反向链接。
+3. 为 CURRENT、FEATURE-MATRIX、gap-matrix、任务文、module boundaries 和 test report 建立专用适配器；receipt 只在文档图谱中作为文档与链接，结构化解析归 U4。
+4. 区分 `broken`、`orphan`、`unindexed`；slug 相似只形成候选关系。
+5. 规范化路径并阻止 `..`、绝对路径和任何 symlink；最终目标再次应用扩展名 allowlist 与敏感路径 denylist。
+
+**测试场景**：
+
+- taxonomy 内文档可检索且反向链接正确；
+- broken link 不导致整个索引失败；
+- front matter 缺失或非标准时产生告警并仍可阅读；
+- assets 不读正文，越界 symlink 被拒绝；
+- rdev 文档链被发现，但没有被推断为已实现。
+
+**完成证据**：文档索引能从 fixture 生成稳定 JSON，路径安全负例通过。
+
+### U3：实现 Git 与 worktree 采集
+
+**目标**：以只读 Git plumbing 形成可复现的分支、提交和 worktree 观测。
+
+**覆盖需求**：R1、R4、R5、R10、R14。
+
+**依赖**：U1。
+
+**文件**：
+
+- `internal/engineeringdashboard/source_git.go`
+- `internal/engineeringdashboard/git_test.go`
+
+**实施要点**：
+
+1. 抽象 command runner，固定 argv、工作目录、超时和输出上限。
+2. 收集当前分支/HEAD、dirty/untracked、local/remote-tracking refs、ahead/behind、merge-base 和 worktree。
+3. 不执行 fetch；remote tracking ref 始终带本地观测时间与免责声明。
+4. 对账任务声明的 branch/worktree，但不因路径名相似而认定一致。
+
+**测试场景**：
+
+- 本地分支领先 origin 时显示 ahead 且不显示“远端可用”；
+- worktree 目录名与真实检出分支不一致时生成 drift；
+- 命令超时、Git 不存在、非 Git 目录时单源 degraded；
+- runner 记录中不存在 shell、fetch、push 或写命令。
+
+**完成证据**：临时 Git 仓库集成测试和 fake runner 单元测试通过。
+
+### U4：实现运行态与部署证据采集
+
+**目标**：按环境独立呈现容器、应用 readiness、服务完整性、schema、镜像和晋升凭证。
+
+**覆盖需求**：R4、R6、R10、R14。
+
+**依赖**：U1。
+
+**文件**：
+
+- `internal/engineeringdashboard/source_runtime.go`
+- `internal/engineeringdashboard/runtime_test.go`
+
+**实施要点**：
+
+1. 从仓库内批准的 Compose 静态配置和 allowlist labels 映射环境与服务；无法明确映射时显示 unknown，不用名称猜测。容器 JSON 只提取容器名、image/digest、状态、restart count、health，以及 allowlist 内的 Compose project/service labels；不复制 Env、Mounts、完整 NetworkSettings 或任意 labels。
+2. 对 allowlist 中的本地 `/ready` 端点执行短超时、响应大小受限的请求；禁用重定向，或对每一跳重新校验 scheme、解析后 IP、端口和 host。
+3. 解析 promotion receipt/candidate image 等仓库证据，保留 artifact identity。
+4. 将 container health、app readiness、required-service completeness 分开建模。
+
+**测试场景**：
+
+- app ready 且 events restarting 时同时保留两项状态；
+- Docker 不可用或 HTTP 超时时，其他数据源仍可输出；
+- receipt 与容器 image 不一致时生成 deployment drift；容器可达但 identity 缺失时标记“运行可见、版本未验证”；
+- readiness 重定向到外网或非 allowlist 本地端口时拒绝访问；
+- 输出中不存在容器环境变量或凭证。
+
+**完成证据**：fixture 和 fake HTTP/Docker runner 测试通过，main 分叉场景被覆盖。
+
+### U5：实现对账、派生视图与新鲜度
+
+**目标**：把来源事实组合成用户可判断的视图，但不替来源做未经定义的裁决。
+
+**覆盖需求**：R3、R4、R6、R8、R9、R10、R13。
+
+**依赖**：U2、U3、U4。
+
+**文件**：
+
+- `internal/engineeringdashboard/reconcile.go`
+- `internal/engineeringdashboard/reconcile_test.go`
+
+**实施要点**：
+
+1. 按领域 SSOT 规则构建 module、task、environment 和 evidence-chain 视图。
+2. 实现 conflict 分类：declared-vs-observed、task-vs-git、test-vs-subject、receipt-vs-runtime、stale-source、missing-evidence。
+3. 快照构建期间每个来源独立记录 `observed_at`、持续时间和错误；成功后一次性发布。
+4. 失败源只可复用同一 serve 进程的 last-known，并标注 stale、age 与 last-success；冷启动无缓存时为 unknown/error。过期数据不隐藏，但按年龄提升告警级别。
+5. 测试报告只有在 commit/artifact identity 与当前 subject 对齐时才能派生 pass；身份缺失为 unbound，身份不匹配为 stale/drift。
+
+**测试场景**：
+
+- 三个真实样本得到预期多轴状态；
+- 同一组输入顺序变化不改变规范化快照；
+- 单源失败不会删除其他源，也不会重写 last-known 的观测时间；冷启动失败没有伪造 last-known；
+- 旧测试报告、新 HEAD 与不同 image 不会派生当前验证通过；
+- 恢复后 stale 自动清除并产生新 snapshot ID。
+
+**完成证据**：reconcile table tests 覆盖一致、漂移、缺失、过期和恢复。
+
+### U6：实现本地服务、总览与文档导航
+
+**目标**：提供能快速判断异常并下钻证据的本地只读页面和 JSON。
+
+**覆盖需求**：R1、R2、R3、R7–R10、R12–R14；承接 PKD-1 和 PKD-2。
+
+**依赖**：U5。
+
+**文件**：
+
+- `internal/engineeringdashboard/server.go`
+- `internal/engineeringdashboard/server_test.go`
+- `internal/engineeringdashboard/assets/index.html`
+- `internal/engineeringdashboard/assets/app.js`
+- `internal/engineeringdashboard/assets/app.css`
+- `cmd/engineering-dashboard/main.go`
+
+**实施要点**：
+
+1. `serve --repo <path> --addr 127.0.0.1:<port>`；一期无条件拒绝所有非 loopback 地址，包括通配、IPv6 非 loopback 和显式传入值。
+2. 暴露 `/api/v1/snapshot`、`/api/v1/doc/<id>`、`/healthz`；所有接口只读。严格校验 Host/Origin/Fetch Metadata，不信任代理转发头；页面和 API 使用每次启动生成的不可预测访问令牌，降低 DNS rebinding 与跨站读取风险。
+3. 页面分为总览、架构/模块、任务、Git、部署、文档和证据链。
+4. 自动刷新完整快照，保留当前筛选、滚动位置、焦点和选中文档；ETag 未变化时不重绘。
+5. 明确一级视图状态：initial loading、fresh empty、fresh success、partial/degraded with last-known、hard error without cache、refreshing、recovered。刷新中继续展示上一完整快照，直到下一版本原子替换。
+6. 搜索覆盖标题、仓库相对路径、front matter 和未截断正文；不同维度用 AND、同一维度多选用 OR，默认先排当前任务和异常证据，再按匹配度与路径稳定排序。筛选、查询和选中文档写入 URL 参数，支持浏览器前进/后退与深链。
+7. 桌面优先；窄屏下侧栏变为可关闭抽屉，宽表格保留可横向滚动的语义表头，详情区单列。所有功能可键盘完成，使用 landmark/标题/表格语义，drift/degraded 不只靠颜色表达，自动刷新通过非打断式 live region 报告且不抢焦点。
+8. Markdown 正文只进入文本节点；在线页与导出页均设置限制性 CSP，不执行 HTML、脚本、SVG、远程 URL 或事件属性。
+
+**测试场景**：
+
+- 只监听 loopback，方法 allowlist 拒绝写请求；Host/Origin/token、DNS rebinding 和跨 Origin 负例被拒绝；
+- HTML 与 JSON 的 generation/revision identity 一致；
+- 文档 ID 越界、symlink 越界、未知 ID 返回安全错误；
+- degraded source 在总览可见且页面仍可导航；
+- 任务状态四轴、drift 和来源时间在浏览器中可见。
+- 首次加载、空数据、无缓存错误、刷新、恢复状态可区分；键盘、焦点、语义结构、窄屏和非颜色告警验收通过。
+- 搜索组合逻辑、排序、无结果、URL 深链和刷新后的视图保持通过。
+
+**完成证据**：HTTP tests、基本无障碍检查和真实浏览器验收通过。
+
+### U7：实现离线导出、启动脚本与治理文档
+
+**目标**：生成安全、可携带、可追踪的单文件快照，并完成仓库治理接线。
+
+**覆盖需求**：R1、R8、R9、R11、R14；承接 PKD-1 和 PKD-2。
+
+**依赖**：U6。
+
+**文件**：
+
+- `internal/engineeringdashboard/export.go`
+- `internal/engineeringdashboard/export_test.go`
+- `scripts/engineering-dashboard.sh`
+- `.doc/status/FEATURE-MATRIX.md`
+- `.doc/ops/CURRENT.md`
+- `.doc/test-reports/YYYY-MM-DD-engineering-dashboard-test-report.md`
+
+**实施要点**：
+
+1. `export --repo <path> --output <file>` 构建一次不可变快照并原子写入；首次采集失败的来源显示 unknown/error。
+2. 以 HTML-safe JSON/等价编码内嵌允许的 Markdown 正文、索引和页面资源；附件保持元数据与相对链接，所有正文只写入文本节点。
+3. 默认权限 `0600`，输出页显示生成时间、repo、HEAD、snapshot ID 和 degraded/drift。
+4. 薄脚本只负责定位仓库与调用 Go CLI，不隐藏参数或执行安装/部署副作用。
+5. 实施期间按仓库规范更新 CURRENT、FEATURE-MATRIX 和 test report；完成后再迁移任务生命周期状态。
+
+**测试场景**：
+
+- 导出文件脱离仓库后仍能搜索和阅读 Markdown；
+- 导出中不含附件字节、绝对凭证路径、env 值或远程请求；`</script>`、事件属性、SVG、危险 URL scheme 和 Unicode 边界载荷不能逃逸数据上下文；
+- 默认 tracked/untracked 与敏感模式策略、inclusion manifest 和覆盖清单符合契约；
+- 采集部分失败时仍能导出并保留错误；
+- 输出中 JSON/HTML snapshot identity 一致，权限符合预期；
+- 大文档和总正文上限触发时明确标记截断。
+
+**完成证据**：export tests、离线浏览器验收和治理文档回链完整。
+
+---
+
+## Verification Contract
+
+### 自动验证
+
+实施阶段至少运行：
+
+```bash
+go test ./internal/engineeringdashboard/...
+go test ./cmd/engineering-dashboard/...
+go vet ./...
+go test -short ./...
+git diff --check
+```
+
+涉及共享容器的只读验收也必须遵守 CURRENT 集成槽规则；中控台本身不得为测试启动、停止或重建共享容器。
+
+### 契约验证矩阵
+
+| 领域 | 必须证明 |
+|---|---|
+| 模型 | 计划、Git facets、验证、部署 facets 互不覆盖；Agent 声明和运行观测分离；所有派生结论可追溯到 facts。 |
+| 文档 | taxonomy、全文检索、反链、broken/unindexed、路径安全与 assets 排除。 |
+| Git | ahead/behind、worktree、dirty、local refs 新鲜度和无隐式 fetch。 |
+| 部署 | container/app/service 三类信号分离，receipt/artifact 身份可核对。 |
+| 降级 | 每个源超时、错误、stale、恢复都不会让整页不可用。 |
+| 实时 | 变化在目标时间内形成完整新快照，不出现半新半旧卡片。 |
+| 导出 | 单文件离线可读、默认 `0600`、不嵌 assets、不产生网络请求。 |
+| 安全 | loopback、Host/Origin/startup token、read-only methods、命令 allowlist、路径边界、Docker 字段 allowlist、CSP 与输出脱敏。 |
+
+### 浏览器验收
+
+1. 从总览进入 rdev，确认“计划/实施/验证/实装”四轴与源文档链接均可见。
+2. 在仓库外复制导出 HTML，断网打开并全文搜索、阅读至少一份设计与一份测试报告。
+3. 制造 fixture 中的 CURRENT/Docker/readiness 冲突，确认页面保留多值且不出现综合绿灯。
+4. 切换 fixture 快照，确认页面刷新后筛选条件和当前文档保持不变。
+5. 尝试路径穿越、未知文档、POST、DNS rebinding、跨 Origin、readiness 重定向和含原始 HTML/脚本逃逸载荷的 Markdown，确认均不能越界、外联或执行。
+
+### 性能与容量验证
+
+- 记录当前 `.doc` 规模下的冷启动、增量刷新、JSON 大小和 HTML 导出大小。
+- 建议一期门槛：UI shell 与来源状态在 2 秒内可交互，P95 完整快照重建不超过 5 秒，单源超时不超过 2 秒；基线不达标时必须记录实测并拆分后台正文索引，不能伪造 PASS。
+- 导出达到配置上限时必须显式列出被截断文档，不允许静默丢失。
+
+---
+
+## Definition of Done
+
+- [ ] `serve` 和 `export` 在显式仓库根下可重复运行，且没有产品后台依赖。
+- [ ] 实时 HTML、离线 HTML 与 JSON 使用同一版本化快照契约。
+- [ ] `generation_id` 标识采集实例，`revision_id` 标识内容版本并驱动 ETag；无内容变化不会触发重绘。
+- [ ] 架构、模块、功能、任务、Git、部署、文档和证据链均可从页面访问。
+- [ ] 计划、实施、验证、实装四轴独立，rdev、dev ahead、main events 分叉样本通过。
+- [ ] Agent 认领与可观测活动分开，Herdr 工程 Agent 与产品 PI Agent Runner 不混称。
+- [ ] 所有 drift、degraded、stale 都带来源和时间，不存在未经定义的综合绿灯。
+- [ ] 默认 loopback、Host/Origin/startup token、只读命令、路径边界、脱敏、CSP 和 Markdown 安全测试通过。
+- [ ] 首次加载、空数据、部分失败、无缓存失败、恢复、键盘、窄屏和 URL 深链验收通过。
+- [ ] 导出 HTML 脱离仓库可读 Markdown，且不包含二进制 assets 或凭证数据。
+- [ ] 单元、集成、全仓短测、浏览器验收和 `git diff --check` 均有真实输出。
+- [ ] `.doc/test-reports` 报告回链任务文，FEATURE-MATRIX 与 CURRENT 按实际状态更新。
+- [ ] 没有遗留调试入口、写操作按钮、未使用的替代模型或与产品后台重名的组件。
+
+---
+
+## Appendix
+
+### 一期交付边界
+
+一期交付：本地只读服务、版本化快照 JSON、架构/任务/Git/部署/文档视图、四轴状态、drift/degraded、全文搜索、安全文档阅读和单 HTML 导出。
+
+后续评估：跨快照历史趋势、远端托管/CI 聚合、受限富文本与 Mermaid、跨仓库聚合、面向 Agent 的筛选查询 API。
+
+永久排除：在页面中修改文档、切换或推送分支、控制 Agent、执行部署、读取密钥、成为产品后台模块。
+
+### 方案依据
+
+- `.doc/README.md` 定义的文档 taxonomy 与生命周期；
+- `.doc/ops/CURRENT.md` 的焦点、认领、集成槽与环境声明；
+- `.doc/status/FEATURE-MATRIX.md` 的模块完成度口径；
+- `.doc/remediation/gap-matrix.md` 的发布门禁口径；
+- `.doc/system-design/README.md` 与模块边界清单；
+- Git/worktree、Docker/Compose、`/ready` 和 promotion receipts 的当前可观测能力。

.doc/archive/ops/2026-09-16-pu6-semantic-summary.md

@@ -0,0 +1,55 @@
+---
+title: "PU6 语义摘要 shadow（SEMANTIC_SUMMARY_SHADOW）"
+status: done
+created: 2026-09-16
+updated: 2026-09-16
+owner: Cursor-Auto
+branch: feature/pu6-semantic-summary
+worktree: ".worktrees/feature-pu6-semantic-summary"
+mutex: chat
+---
+
+# PU6 语义摘要 shadow
+
+## 目标
+
+在授权可见消息集合上落地 `SEMANTIC_SUMMARY_SHADOW`（默认 off）：shadow 语义摘要、失败回 deterministic 并标注 freshness；不启用 REPLACE。
+
+## 范围
+
+- `internal/ctxmgr/summarizer.go` + semantic shadow
+- `internal/app/chatflow/` 授权过滤入口
+- `internal/server/chat_digest_api.go` 出站 freshness/shadow 字段
+- 单元/表征测试；测试报告
+
+## 非目标
+
+- 不启用 `SEMANTIC_SUMMARY_REPLACE`
+- 不合入 `dev`
+- 不改 plan 文件
+
+## 步骤
+
+1. [x] 从 `dev` 开分支 / worktree 并认领
+2. [x] flags + 无工具语义摘要器 + rolling summary shadow
+3. [x] chatflow 授权路径 + digest API
+4. [x] 测试与报告
+5. [x] 渐进提交并 push
+
+## 验收标准
+
+- [x] flag off 行为与基线一致
+- [x] shadow on：仅 authorized 消息；失败保留 deterministic + freshness
+- [x] injection 不能提权；REPLACE 路径未接线
+- [x] 测试报告归档
+
+## 相关链接
+
+- Contract: `../long-term/2026-09-16-pu6-semantic-summary-contract.md`
+- Test report: `../../test-reports/2026-09-16-pu6-semantic-summary-test-report.md`
+
+## 证据 / 备注
+
+- 分支：`feature/pu6-semantic-summary`（worktree）
+- 测试：`go test -short ./internal/ctxmgr/ ./internal/app/chatflow/ ./internal/server/` PASS
+

.doc/archive/ops/2026-09-16-pu8-u9-u12-flags.md

@@ -0,0 +1,48 @@
+---
+title: "P5 PU8 U9–U12 独立 flag 脚手架"
+status: done
+created: 2026-09-16
+updated: 2026-09-16
+owner: Cursor
+branch: feature/pu8-u9-u12-flags
+worktree: /tmp/wt-pu8
+mutex: intent-plan
+---
+
+# P5 PU8 U9–U12 独立 flag 脚手架
+
+## 目标
+
+为多意图扩面 U9–U12 落地独立 env flag（默认 OFF）与 stub/dry-run 端口，不升 `MULTI_INTENT_PLAN_TIER`。
+
+## 范围
+
+- `MULTI_INTENT_U9_SEGMENT` / `U10_MUTATE` / `U11_DOCGOV` / `U12_RUN_CONTROL`
+- U9 segment proposal port + fail-closed stub
+- U10–U12 dry-run adapters + `BuildOwnerMux` 门控
+- 单测证明默认 off 与 enable 路径不 panic
+
+## 非目标
+
+- 真实 LLM 分段 / 升 tier / 合入 `dev`
+- 真实 docgov/workflow 副作用写路径
+
+## 步骤
+
+1. [x] 独立 flags + `.env.example`
+2. [x] segment proposal + expansion adapters + mux 门控
+3. [x] Assemble `BuildOwnerMux` 接线
+4. [x] 单测 + 测试报告
+5. [x] push（不合 `dev`）
+
+## 验收标准
+
+- [x] 四 flag 默认 off；开 flag 不升 PlanTier
+- [x] flag off ≡ legacy（无 LLM proposal、无新 adapters）
+- [x] flag on：U9 fail-closed；U10–U12 dry-run/guarded
+- [x] 报告归档
+
+## 相关链接
+
+- Contracts: [u9](../long-term/2026-09-16-pu8-u9-segment-proposal-contract.md) … [u12](../long-term/2026-09-16-pu8-u12-workflow-run-control-contract.md)
+- Test report: [../../test-reports/2026-09-16-pu8-u9-u12-flags-test-report.md](../../test-reports/2026-09-16-pu8-u9-u12-flags-test-report.md)

.doc/archive/ops/2026-09-17-docgov-modification-proposal-http.md

@@ -0,0 +1,48 @@
+---
+title: "docgov 变更提案 HTTP + 前端接线"
+status: done
+created: 2026-09-17
+updated: 2026-09-17
+owner: Cursor
+branch: feature/docgov-modification-proposal-http
+worktree: .worktrees/feature-docgov-modification-proposal-http
+mutex: docgov
+---
+
+# docgov 变更提案 HTTP + 前端接线
+
+## 目标
+
+暴露 `POST /api/v1/docgov/proposal`，前端「修改」快捷分支与 `ProposalConfirmCard` 走真实 propose/decide，不再本地假装成功。
+
+## 范围
+
+- API：`ProposeModification` 路由；decide 补 404/403 映射
+- 前端：`docgov.ts` + `App.tsx` 接线
+- 单测 + 真实 HTTP 证据
+- 关闭 audit 缺口；dev 试点总开关证据归档
+
+## 非目标
+
+- 晋升 test/main
+- 变更提案自动改写受控正文（批准后仍为 UI 演示增补）
+
+## 步骤
+
+1. [x] 实现 propose handler + 路由
+2. [x] 前端 client + App 接线
+3. [x] handler/client 单测
+4. [x] 合入 dev + rebuild + 真实 HTTP
+5. [x] push origin/dev；清理 author-only worktree
+
+## 验收标准
+
+- [x] `POST /api/v1/docgov/proposal` 可写库（单测）
+- [x] 真实 HTTP claim → propose → decide PASS
+- [x] audit 缺口 resolved；CURRENT 认领收敛
+
+## 相关链接
+
+- Audit: [../../audit/2026-09-17-docgov-modification-proposal-http-gap.md](../../audit/2026-09-17-docgov-modification-proposal-http-gap.md)
+- Pilot: [../../test-reports/assets/2026-09-17-author-only-pilot/](../../test-reports/assets/2026-09-17-author-only-pilot/)
+- Closeout: [../handoffs/2026-09-17-document-author-only-closeout.md](../handoffs/2026-09-17-document-author-only-closeout.md)

.doc/archive/ops/2026-09-17-docgov-optional-duty-null-fk.md

@@ -0,0 +1,53 @@
+---
+title: "修复 CreateOrGetDocument 可选职责 0→NULL FK"
+status: done
+created: 2026-09-17
+updated: 2026-09-17
+owner: Cursor
+branch: fix/docgov-optional-duty-null-fk
+worktree: "-"
+mutex: docgov
+---
+
+# 修复 CreateOrGetDocument 可选职责 0→NULL FK
+
+## 目标
+
+无 reviewer/approver 职责时创建文档账本成功，不再因 `reviewer_id=0` FK 失败并被标成 `INTERNAL_ERROR`。
+
+## 范围
+
+- `internal/docgov/engine.go`：`nullIfZero` 写入 author/reviewer/approver
+- `internal/stream/classify.go`：`DOC_LEDGER_ERROR` 分型
+- 回归测试 + audit/test-report
+
+## 非目标
+
+- 不强制项目配置 reviewer
+- 不改前端 flushSync / 虚拟列表
+- 不改项目 6417 存量数据（代码修好后重试即可）
+
+## 步骤
+
+1. [x] CreateOrGetDocument 0→NULL
+2. [x] ClassifyError `DOC_LEDGER_ERROR`
+3. [x] 单元/回归测试（`-short` 已绿）
+4. [x] 占集成槽位 rebuild + 6417 复测（`run_1789625396102207018`，`doc_proj6417_intake` NULL FK）
+5. [x] test-report 归档；合入 `dev`
+
+## 验收标准
+
+- [x] `go test -short ./internal/docgov/... ./internal/stream/...` PASS
+- [x] 仅-author 项目 `CreateOrGetDocument` / 任务发起不再 `INTERNAL_ERROR`；`reviewer_id IS NULL`
+- [x] 项目 6417 账本创建成功（full 职责路径未被本修复改动）
+
+## 相关链接
+
+- Audit: [../../audit/2026-09-17-docgov-optional-duty-null-fk.md](../../audit/2026-09-17-docgov-optional-duty-null-fk.md)
+- Test report: [../../test-reports/2026-09-17-docgov-optional-duty-null-fk-test-report.md](../../test-reports/2026-09-17-docgov-optional-duty-null-fk-test-report.md)
+
+## 证据 / 备注
+
+- 失败 run：`run_1789622069585300787`
+- 验证 run：`run_1789625396102207018` / `doc_proj6417_intake` author=9 reviewer/approver NULL
+- merge：`e488d10 merge: fix/docgov-optional-duty-null-fk`

.doc/archive/ops/2026-09-17-document-author-only-plan.md

@@ -0,0 +1,47 @@
+---
+title: 文档编制人兼任审核批准方案
+status: done
+created: 2026-09-17
+updated: 2026-09-17
+owner: Codex
+branch: feature/document-author-only-plan
+worktree: .worktrees/feature-document-author-only-plan
+mutex: document-duty-policy-plan
+---
+
+# 文档编制人兼任审核批准方案
+
+## 目标
+
+基于当前源码形成管理员总授权、项目创建者逐文档选择的详细实施方案，交用户审核。
+
+## 范围
+
+权限、系统设置、工作流规划和冻结、文档三职、动作鉴权、状态机、前端、迁移与验收。
+
+## 非目标
+
+本次不修改业务代码、不变更数据库或共享容器、不推送。
+
+## 步骤
+
+1. [x] 阅读启动链并从本地 dev 建立隔离分支。
+2. [x] 核查实现并记录证据。
+3. [x] 编写方案、检查边界与验收覆盖。
+
+## 验收标准
+
+- [x] 方案覆盖用户两个权限层级及逐文档持久化。
+- [x] 当前事实与拟议行为分开，列明实施单元与测试场景。
+
+## 证据 / 备注
+
+基线 dev adb48c8。已 fetch origin/dev，本地 dev 领先 44、落后 0，保留未推送集成成果；主工作区 feature/control-center-server 未切换。worktree 脚本默认从当前 HEAD 创建，故直接指定 dev 创建本 worktree，避免引入他人分支。
+
+## 交付
+
+- 方案：`.doc/remediation/2026-09-17-document-author-only-plan.md`
+- 核查：`.doc/audit/2026-09-17-document-author-only-analysis.md`
+- 本任务完成仅指方案交付，业务实现为 planned；R9/R10 待用户审核。
+- 未合入 dev：方案保留在独立分支供审核；未推送、未修改业务代码或容器。
+- 验证：源码与文档一致性检查、git diff --check；未执行业务测试。

.doc/archive/ops/2026-09-17-document-author-only-u1.md

@@ -0,0 +1,57 @@
+---
+title: "文档编制人兼任：U1 策略存储与总授权"
+status: done
+created: 2026-09-17
+updated: 2026-09-17
+owner: Cursor
+branch: feature/document-author-only-plan
+worktree: ".worktrees/feature-document-author-only-plan"
+mutex: sysadmin + document-duty-policy
+---
+
+# 文档编制人兼任：U1 策略存储与总授权
+
+## 目标
+
+落地 `workflow.allow_author_only_approval` 管理员总开关：默认关闭、严格 bool、revision CAS、事务内审计，并向 projectinstance 提供可参与激活事务的窄读取接口。
+
+## 范围
+
+- Goose 增量迁移（revision 列、种子行、策略审计表）
+- `internal/sysadmin` 存储/服务/窄 Policy 接口
+- `admin_system_handlers` 对本 key 的 `expected_revision` 协议
+- 单元 / PG / HTTP 负例测试
+
+## 非目标
+
+- 逐文档 duty_policy（U2）
+- 前端设置页文案（U5）
+- 已激活实例紧急熔断
+
+## 步骤
+
+1. [x] 认领 CURRENT
+2. [x] 迁移 00050
+3. [x] sysadmin CAS + 审计 + PolicySource
+4. [x] admin handler
+5. [x] 测试与提交
+
+## 验收标准
+
+- [x] 管理员可开关；非管理员 403
+- [x] null/字符串布尔拒绝
+- [x] 并发 CAS 仅一版成功
+- [x] 审计失败回滚设置
+- [x] 窄接口可读 allowed+revision；缺行默认 false；DB 故障不伪装
+
+## 相关链接
+
+- Plan: `.doc/remediation/2026-09-17-document-author-only-plan.md` U1
+- Checklist:
+
+## 证据 / 备注
+
+- `go test ./internal/sysadmin/ ./internal/server/ -run 'Settings|AuthorOnly|PGSettings|AdminSystem'` PASS
+- `go test -short ./internal/sysadmin/ ./internal/server/` PASS
+- Key: `workflow.allow_author_only_approval`
+- 窄接口: `sysadmin.AuthorOnlyPolicySource`

.doc/archive/ops/2026-09-17-document-author-only-u2.md

@@ -0,0 +1,54 @@
+---
+title: "文档编制人兼任：U2 逐文档模式与激活"
+status: done
+created: 2026-09-17
+updated: 2026-09-17
+owner: Cursor
+branch: feature/document-author-only-plan
+worktree: ".worktrees/feature-document-author-only-plan"
+mutex: projectinstance + document-duty-policy
+---
+
+# 文档编制人兼任：U2 逐文档模式与激活
+
+## 目标
+
+落地逐文档 `duty_policy=author_only`：规划校验、预览摘要、激活 token 绑定策略 revision，激活事务内行锁串行化关闭总开关。
+
+## 范围
+
+- DocTaskPlan / PreviewSummary / ProjectSettings 扩展
+- ResolveDocTaskDuty、Save/Preview/Activate 消费 U1 策略
+- Goose 00051 token revision 列
+- app 适配器装配、HTTP 错误码映射
+- 单元测试
+
+## 非目标
+
+- Heal/文档投影（U3）
+- 前端 UI（U5）
+- 运行时动作多职责（U4/U6）
+
+## 步骤
+
+1. [x] 类型与解析器
+2. [x] service/store/迁移
+3. [x] app 装配与 handler
+4. [x] 测试与提交
+
+## 验收标准
+
+- [x] 一位成员兼任可存/预览/激活（总开关开）
+- [x] 总开关关时 Save 拒绝
+- [x] 预览后 revision 变化旧 token 409
+- [x] 未开模式只填作者仍 partial 拒绝
+- [x] 旧快照缺 duty_policy 时 hash 稳定
+
+## 相关链接
+
+- Plan: `.doc/remediation/2026-09-17-document-author-only-plan.md` U2
+
+## 证据 / 备注
+
+- `go vet ./internal/projectinstance/ ./internal/app/ ./internal/server/`
+- `go test -short ./internal/projectinstance/ ./internal/server/ ./internal/app/` PASS

.doc/archive/ops/2026-09-17-document-author-only-u3.md

@@ -0,0 +1,55 @@
+---
+title: "文档编制人兼任：U3 文档绑定与职责投影"
+status: done
+created: 2026-09-17
+updated: 2026-09-17
+owner: Cursor
+branch: feature/document-author-only-plan
+worktree: ".worktrees/feature-document-author-only-plan"
+mutex: docgov + docduty + bizdev + document-duty-policy
+---
+
+# 文档编制人兼任：U3 文档绑定与职责投影
+
+## 目标
+
+生成时写入实例治理职责并 `duty_locked`；heal/revoke 跳过锁定行；读侧投影 `duty_policy`。
+
+## 范围
+
+- Goose 00052：`document_records.duty_locked` / `duty_policy`
+- `docgov.LockDocumentDuty` + 列表投影
+- `docduty` heal/revoke `AND NOT duty_locked`
+- `bizdev.InstanceDutySource` + `resolveTaskDocumentDuties` 治理分支；跳过 governed 内存 heal
+- `app/instance_duty_adapter.go` 装配
+
+## 非目标
+
+- U4 动作鉴权 / allowed_actions
+- U5/U6 前端
+- 合入 `dev`
+
+## 步骤
+
+1. [x] 迁移
+2. [x] docgov / docduty
+3. [x] bizdev + app 适配器
+4. [x] 测试与提交
+
+## 验收标准
+
+- [x] 受治理文档创建后 `duty_locked=true` 且三职来自实例
+- [x] heal/revoke 不清锁定行（SQL 过滤 + 单测/PG 可选）
+- [x] 生成后 governed 路径不再用项目默认覆盖内存态
+- [x] 模块边界：bizdev/docduty/docgov 不导入 projectinstance
+
+## 相关链接
+
+- Plan: U3（文档绑定与职责投影一致性）
+- 依赖：U1 `3b6def2`、U2 `c03d0a3`
+
+## 证据 / 备注
+
+- `go vet ./internal/docgov/ ./internal/docduty/ ./internal/bizdev/ ./internal/app/ ./internal/projectinstance/`
+- `go test -short` 上述包 PASS
+- PG：`TEST_DATABASE_URL` 未配置时 `Heal/Revoke SkipsDutyLocked` 自动跳过

.doc/archive/ops/2026-09-17-document-author-only-u4.md

@@ -0,0 +1,47 @@
+---
+title: "文档编制人兼任：U4 动作鉴权与审计"
+status: done
+created: 2026-09-17
+updated: 2026-09-17
+owner: Cursor
+branch: feature/document-author-only-plan
+worktree: ".worktrees/feature-document-author-only-plan"
+mutex: projectinstance + docgov + document-duty-policy
+---
+
+# 文档编制人兼任：U4 动作鉴权与审计
+
+## 目标
+
+ABAC 门禁识别 `duty_policy=author_only` 派生职责；审计 Details 携带 duty_policy。
+
+## 范围
+
+- `duty_action` / `stage_access` / `gate` 改用 `ResolveDocTaskDuty`
+- `state_machine` Transition* Details 补 `duty_policy`
+- author_only 动作矩阵与阶段可见性测试
+
+## 非目标
+
+- U5 UI / U6 浏览器闭环
+
+## 步骤
+
+1. [x] ABAC 三文件
+2. [x] 审计详情
+3. [x] 测试与提交
+
+## 验收标准
+
+- [x] author_only 规范存储（仅 Author ID）下 A 可 run/edit/submit/review/approve
+- [x] 非 A 拒绝；阶段门禁将 author_only 视为 approvalManaged
+- [x] 审计 Details 含 duty_policy
+
+## 相关链接
+
+- Plan: U4+U5 实施计划
+- 依赖：U1–U3
+
+## 证据 / 备注
+
+- `go test -short ./internal/projectinstance/ ./internal/docgov/ ./internal/app/ ./internal/server/` PASS

.doc/archive/ops/2026-09-17-document-author-only-u5.md

@@ -0,0 +1,48 @@
+---
+title: "文档编制人兼任：U5 系统设置与逐文档 UI"
+status: done
+created: 2026-09-17
+updated: 2026-09-17
+owner: Cursor
+branch: feature/document-author-only-plan
+worktree: ".worktrees/feature-document-author-only-plan"
+mutex: web + document-duty-policy
+---
+
+# 文档编制人兼任：U5 系统设置与逐文档 UI
+
+## 目标
+
+前端识别 `duty_policy` / `author_only_policy`；项目设置可逐文档开启兼任。
+
+## 范围
+
+- `projectSettings.ts` 类型
+- `projectSettingsDuties.ts` resolveClientDocTaskDuty + 校验
+- `ProjectSettingsModal` 兼任勾选与预览
+- SettingsSection 不改（白名单通用渲染）
+
+## 非目标
+
+- U6 多职责动作栏 / 浏览器 E2E
+
+## 步骤
+
+1. [x] 类型与 lib
+2. [x] UI
+3. [x] 测试与提交
+
+## 验收标准
+
+- [x] author_only 客户端校验通过且不计三人门槛
+- [x] 总开关关闭时兼任勾选禁用并提示
+- [x] 预览展示兼任文档计数
+
+## 相关链接
+
+- Plan: U4+U5 实施计划
+
+## 证据 / 备注
+
+- `npx tsc --noEmit` PASS
+- `npm test` PASS（含 projectSettingsDuties author_only 用例）

.doc/archive/ops/2026-09-17-document-author-only-u6.md

@@ -0,0 +1,55 @@
+---
+title: "文档编制人兼任：U6 多职责动作与真实闭环"
+status: done
+created: 2026-09-17
+updated: 2026-09-17
+owner: Cursor
+branch: feature/document-author-only-plan
+worktree: ".worktrees/feature-document-author-only-plan"
+mutex: web + document-duty-policy
+---
+
+# 文档编制人兼任：U6 多职责动作与真实闭环
+
+## 目标
+
+去掉 author-first 动作短路，把认领/送审/审核/批准接到真实 docgov HTTP，完成 author_only 端到端验收。
+
+## 范围
+
+- `web/src/api/docgov.ts` 四接口客户端
+- `docGovActionVisibility` / `holdsDocDuty`
+- `App.tsx` 真实 handler + 快捷指令
+- `duty_policy` 透传与「编制人兼任」徽标
+- 单测 + 真实闭环报告
+
+## 非目标
+
+- 变更提案 HTTP 路由（另记 audit）
+- 合入 `dev` / 推送远端（未授权不推）
+
+## 步骤
+
+1. [x] API 客户端
+2. [x] ID 直判可见性
+3. [x] App 接线 + 驳回批准修正
+4. [x] duty_policy 徽标透传
+5. [x] 单测 / tsc
+6. [x] 真实闭环与报告
+
+## 验收标准
+
+- [x] author_only 下 A 可见三动作；非 A 403
+- [x] 真实 API 闭环写库与审计含 duty_policy
+- [x] 浏览器可见「编制人兼任」徽标
+- [x] 测试报告归档
+
+## 相关链接
+
+- Test report: [../../test-reports/2026-09-17-document-author-only-u6-test-report.md](../../test-reports/2026-09-17-document-author-only-u6-test-report.md)
+- Remediation U6: [../../remediation/2026-09-17-document-author-only-plan.md](../../remediation/2026-09-17-document-author-only-plan.md)
+
+## 证据 / 备注
+
+- `npm test` 390 pass；`tsc --noEmit` clean
+- assets: `test-reports/assets/2026-09-17-document-author-only-u6/`

.doc/archive/ops/2026-09-17-initial-load-performance-plan.md

@@ -0,0 +1,41 @@
+---
+title: "首次加载性能诊断与改进方案"
+status: done
+created: 2026-09-17
+updated: 2026-09-17
+owner: Codex
+branch: feature/initial-load-performance-plan
+worktree: .worktrees/feature-initial-load-performance-plan
+mutex: loading-performance-audit
+---
+
+# 首次加载性能诊断与改进方案
+
+## 目标
+以源码、现有容器静态资源和只读浏览器测量定位首次加载瓶颈，输出可审核的分期改进方案。
+
+## 范围
+登录前首屏、登录后初始化、项目/文档首次打开、静态资源交付；区分事实与待验证假设。
+
+## 非目标
+不修改业务代码，不重启/重建共享服务，不触发真实对话或文档写任务，不提交或推送其他人的工作。
+
+## 步骤
+1. [x] 阅读仓库启动链；独立 dev 基线 worktree，主仓保留其他 Agent 分支。
+2. [x] 采集数值基线和源码证据。
+3. [x] 写 audit 和 remediation，同步 CURRENT，归档任务。
+
+## 验收标准
+- [x] 原因有文件位置或运行时测量支持，未覆盖环境明确标注。
+- [x] 方案包含优先级、改动边界、性能预算、回归门禁和回滚。
+
+## 证据 / 备注
+仅诊断与方案，不代表优化已实施。fetch 后 origin/dev 落后本地 dev；不拉回或覆盖本地工作。worktree 从创建瞬间的 dev 建立。
+
+## 交付
+
+- 诊断：`.doc/audit/2026-09-17-initial-load-performance-audit.md`
+- 方案：`.doc/remediation/2026-09-17-initial-load-performance-plan.md`
+- 报告：`.doc/test-reports/2026-09-17-initial-load-performance-baseline.md`
+- 本轮仅方案；没有业务代码、没有部署、未提交、未合dev、未推送。主仓仅同步本任务认领。
+- 临时3199 Vite已停止；既有3100/8080/8081未重启。未占集成槽。

.doc/archive/ops/2026-09-17-kb-host-auth-fix.md

@@ -0,0 +1,55 @@
+---
+title: "修复 KB 宿主机错误口令与静默离线降级"
+status: done
+created: 2026-09-17
+updated: 2026-09-17
+owner: Cursor
+branch: fix/kb-host-auth-layered-load
+worktree: "-"
+mutex: infra
+---
+
+# 修复 KB 宿主机错误口令与静默离线降级
+
+## 目标
+
+消除 `config.Load("")` 只读 `configs/.env.dev`、忽略根 `.env` 的 `KB_DB_PASSWORD` 导致的错误默认口令与静默离线；E2E/nightly 默认 fail-closed。
+
+## 范围
+
+- `internal/config` 分层加载 + 宿主机 DNS 归一化 + 空默认口令
+- `internal/kb` 脱敏日志、`Online()`、`KB_REQUIRE_ONLINE` / `KB_ALLOW_OFFLINE`
+- `/health` 增加 `kb_ready`
+- PI E2E helper 与 `scripts/run-nightly-real-pi.sh` 预检
+- env 模板与验收报告
+
+## 非目标
+
+- 不改 KB 数据内容 / 法规迁移
+- 不把真实口令写入 git 跟踪的 `configs/.env.*`
+- 不把容器内 DNS 改成 localhost
+
+## 步骤
+
+1. [x] 分层 Load + 默认口令清空
+2. [x] NormalizeKBHostForRuntime
+3. [x] kb 客户端脱敏 + RequireOnline（EnsureOnline；不 Fatalf）
+4. [x] health `kb_ready` + E2E/nightly 门禁
+5. [x] 合入 `dev` 冒烟（rebuild + `/health` `kb_ready=true`）
+
+## 验收标准
+
+- [x] `config.Load("")` 分层合并后口令来自根 `.env`（单测临时文件 + live 布尔校验）
+- [x] 宿主机 `shuimu-kb-shared` → `127.0.0.1`；容器内保留 compose DNS
+- [x] 错口令/空口令离线且日志无明文密码；`KB_ALLOW_OFFLINE=1` 可降级
+- [x] 合 `dev` 后 short 测 PASS；dev rebuild 后 `kb_ready=true`，日志 `online=true dsn=...:***@shuimu-kb-shared...`，无 `shared_kb_secret_pass`
+
+## 相关链接
+
+- Test report: `.doc/test-reports/2026-09-17-kb-host-auth-layered-load-test-report.md`
+- Plan: 修复 KB 连接降级
+
+## 证据 / 备注
+
+根因：`Load` 优先单文件 `configs/.env.dev`（故意省略 `KB_DB_PASSWORD`），保留错误默认 `shared_kb_secret_pass`；Compose 本已分层，宿主机 `go test` 未对齐。
+合入后容器日志：`[kb] online=true dsn=postgres://regkb:***@shuimu-kb-shared:5432/regulations?sslmode=disable`；health `kb_ready=true`。

.doc/archive/ops/2026-09-17-rdev-template-depth-s1-continued.md

@@ -0,0 +1,57 @@
+---
+title: "rdev 模板深度补强 S1 续批（剩余 46 份）"
+status: done
+created: 2026-09-17
+updated: 2026-09-17
+owner: Cursor
+branch: feature/rdev-template-depth-s1-continued
+worktree: ".worktrees/feature-rdev-template-depth-s1-continued"
+mutex: rdev-templates
+---
+
+# rdev 模板深度补强 S1 续批（剩余 46 份）
+
+## 目标
+
+将剩余 46 份 `rd_*` 模板按写作规范做同等深度补强，lint allowlist 扩至全 60 份，抽样真 PI 打样收口。
+
+## 范围
+
+- 批1：6 份评审记录
+- 批2：阶段06 硬件/工艺 8 份
+- 批3：阶段06 软件/检验/技术要求+清单 9 份
+- 批4：阶段08 验证 12 份
+- 批5：阶段10–13 转换/确认 11 份
+- lint allowlist + 抽样真 PI + 文档同步
+
+## 非目标
+
+- S2/S3、P2 前端、P3 三样本全量 E2E、P4 键名空间化
+- 晋升 test/main
+
+## 步骤
+
+1. [x] 批1 评审记录 6 份
+2. [x] 批2 硬件/工艺 8 份
+3. [x] 批3 软件/检验/清单 9 份
+4. [x] 批4 验证 12 份
+5. [x] 批5 转换/确认 11 份
+6. [x] 抽样真 PI + 文档同步（合入 push 见 merge 步骤）
+
+## 验收标准
+
+- [x] 46 份无「按本阶段专业结构写」；lint allowlist 60/60
+- [x] 抽样 1–2 份真 PI PASS（`rd_planning_review` + `rd_design_vv`，项目 6446）
+- [x] FEATURE-MATRIX / 写作规范 / backlog 已更新
+
+## 相关链接
+
+- Backlog: [.doc/backlog/2026-09-17-rdev-phase2-backlog.md](../../backlog/2026-09-17-rdev-phase2-backlog.md)
+- 写作规范: [.doc/system-design/project-workflow/08-rdev模板写作规范.md](../../system-design/project-workflow/08-rdev模板写作规范.md)
+- 首批报告: [.doc/test-reports/2026-09-17-rdev-template-depth-test-report.md](../../test-reports/2026-09-17-rdev-template-depth-test-report.md)
+- 续批报告: [.doc/test-reports/2026-09-17-rdev-template-depth-s1-continued-test-report.md](../../test-reports/2026-09-17-rdev-template-depth-s1-continued-test-report.md)
+
+## 证据 / 备注
+
+- 资产：`.doc/test-reports/assets/2026-09-17-rdev-template-depth-s1-continued/`
+- 附带：`fix(projectinstance): allocate next instance_no for planning drafts`

.doc/archive/ops/2026-09-17-rdev-template-depth.md

@@ -0,0 +1,54 @@
+---
+title: "rdev 模板深度补强 S0 + S1 首批"
+status: done
+created: 2026-09-17
+updated: 2026-09-17
+owner: Cursor
+branch: feature/rdev-template-depth
+worktree: ".worktrees/feature-rdev-template-depth"
+mutex: rdev-templates
+---
+
+# rdev 模板深度补强 S0 + S1 首批
+
+## 目标
+
+修复 rdev leader prompt 错配，并为阶段 01–05 的 14 份 rdev 模板补齐 ISO 13485 专业章节与逐节写作指令，以 dev 真实 PI 打样验证收口。
+
+## 范围
+
+- S0.1 B1：`rdev_leader.md` + InstructionsFile 注入链
+- S0.2：`rd_design_input_spec` 样例 + 写作规范 + lint
+- S0.3：dev 真实 PI 打样
+- S1 首批：阶段 01–05 共 14 份模板（分 3 批）
+
+## 非目标
+
+- overlay 机制本体、R1–R7 二期、per-stage 步骤定制、模型配置化、manifest 元数据、前端（P2）、键名空间化（P4）、阶段 06–13 模板
+
+## 步骤
+
+1. [x] S0.1 leader prompt 注入链（`6a09062`）
+2. [x] S0.2 样例模板 + 规范 + lint（含于 `eb09b21`）
+3. [x] S0.3 真实 PI 打样（项目 6424 intake + 6425 `rd_design_input_spec`）
+4. [x] S1 批 1–3（`eb09b21`）
+5. [x] 文档与门禁
+
+## 验收标准
+
+- [x] rdev leader AGENTS.md 含「设计控制」且不含「商务对接负责人」「CDO」
+- [x] intake leader 回归仍含「商务对接负责人」
+- [x] 14 份模板 lint 绿灯；真 PI 终稿五节实质论证
+- [x] `go vet` + `go test -short` 全绿
+
+## 相关链接
+
+- Test report: [.doc/test-reports/2026-09-17-rdev-template-depth-test-report.md](../../test-reports/2026-09-17-rdev-template-depth-test-report.md)
+- Assets: [.doc/test-reports/assets/2026-09-17-rdev-template-depth/](../../test-reports/assets/2026-09-17-rdev-template-depth/)
+- Backlog: [.doc/backlog/2026-09-17-rdev-phase2-backlog.md](../../backlog/2026-09-17-rdev-phase2-backlog.md)
+- 写作规范: [.doc/system-design/project-workflow/08-rdev模板写作规范.md](../../system-design/project-workflow/08-rdev模板写作规范.md)
+
+## 证据 / 备注
+
+- 依赖 `feature/rdev-core`（尚未合 dev）；合入前需 rebase 丢弃已进 dev 的 engineering-dashboard 重复提交。
+- 真 PI：`run_1789635054471569201`（intake ~220s）；`run_1789635960880707641`（DI ~450s，`stage=RD03_design_input`）。

.doc/archive/ops/2026-09-17-rdev-workflow-integration.md

@@ -0,0 +1,70 @@
+---
+title: "研发工作流（rdev）接入：13 阶段 / 60 文档任务"
+status: done
+created: 2026-09-17
+updated: 2026-09-17
+owner: Cursor
+branch: fix/docgov-stage-dynamic → feature/rdev-core
+worktree: "-"
+mutex: workflow-def
+---
+
+# 研发工作流（rdev）接入：13 阶段 / 60 文档任务
+
+## 目标
+
+在现有 5 个正式工作流外新增医疗第 4 工作流「研发设计控制流程」（key: `rdev`），完整承载参考项目 13 phase / 60 文档任务的 ISO 13485 DHF 设计控制链，并通过真实 PI 验收；随后完成全工作流任务键命名空间化（P4）。
+
+## 范围
+
+- 方案：[07-研发工作流rdev接入-设计与实施计划](../../system-design/project-workflow/07-研发工作流rdev接入-设计与实施计划.md)（P0–P4 五期；§8 四项决策已确认）
+- P0：docgov Stage 去硬编码 + stage key 透传
+- P1：rdev.v2.json manifest（13×60 一次到位）+ 60 份 rd_ 前缀模板 + catalog/seed/registry + squad kind 编排 + main-completed precheck + 齐套测试 + stub PG 全链路
+- P2：前端激活规划/切换/前置 Banner + intent 文档名匹配 + prior docs 注入与血缘
+- P3：真实 PI Agent E2E（rd_proposal / rd_planning_review / rd_sw_plan 三样本）+ CI 门禁扩四
+- P4：现有工作流（main/pm/tm + 软件两盘点）任务键 `bd_`/`pm_`/`tm_`（`sw_`）空间化，alias 兼容式改名（D12），独立分支独立验收
+
+## 非目标
+
+- 二期增强全部移入 backlog：[2026-09-17-rdev-phase2-backlog](../../backlog/2026-09-17-rdev-phase2-backlog.md)（N/A 不适用页生成、UR/RS 结构化门禁、kind 专用门禁、depends_on 精确血缘、DMR 归档、sw_ 键盘点、complexity regulatory 注入）
+- 云盘 canonical DHF/DMR 归档（本仓库无云盘模块）
+- 软件域（non_medical_software）开放 rdev
+
+## 步骤
+
+1. [x] 用户确认方案 §8 四项决策（2026-09-17：名称「研发设计控制流程」/ 60 任务一次到位 / N/A 规划期关闭 + backlog / rd_ 前缀并扩展到现有工作流键名空间化）
+2. [x] P0 分支 `fix/docgov-stage-dynamic`（StageKey 透传；已叠入 `feature/rdev-core`）
+3. [x] P1 分支 `feature/rdev-core`（manifest/模板/seed/编排/precheck/齐套测试）
+4. [ ] P2 分支 `feature/rdev-web-governance`（前端 + intent + 血缘）— **骨架已定，待独立认领**
+5. [ ] P3 真实 PI 验收 + 报告归档 + FEATURE-MATRIX 更新 — **骨架已定，待独立认领**
+6. [ ] P4 分支 `feature/workflow-key-namespace`（D12 alias 兼容式改名 + 双路径回归）— **骨架已定，待独立认领**
+
+## 验收标准
+
+- [x] `go vet ./...` && `go test -short` 相关包 PASS（P0+P1）
+- [x] 齐套断言：manifest 60 任务 ↔ `templates/docs/rd_*.md` 存在非空；rd_ 键与既有任务键不相交
+- [x] precheck：main 未 completed 时 rd 任务启动被拒且文案含 CDO
+- [ ] PG 集成：rdev 实例 planning→live→推进（`TestPG_RDevActivateWithNAClose`，需 `TEST_DATABASE_URL`）
+- [ ] web `npm test && npm run build` PASS；Playwright 抽检激活/推进（P2）
+- [ ] 真实 PI + MiniMax 三样本 E2E 报告归档 `.doc/test-reports/`（P3）
+- [ ] P4：旧 live 实例（旧键）+ 新实例（新键）双路径回归 PASS；全工作流任务键集合无交集
+
+## 相关链接
+
+- 设计方案: [07-研发工作流rdev接入-设计与实施计划](../../system-design/project-workflow/07-研发工作流rdev接入-设计与实施计划.md)
+- 参考调研: [2026-09-17-rdev-workflow-reference-analysis](../research/2026-09-17-rdev-workflow-reference-analysis.md)
+- 二期 backlog: [2026-09-17-rdev-phase2-backlog](../../backlog/2026-09-17-rdev-phase2-backlog.md)
+- Checklist: -
+- Handoff: -
+- Test report: -
+
+
+## 证据 / 备注
+
+- 参考项目：`.refs/weichen-agent-system`（configs/workflows/rdev.yaml 60 stage、templates/docs 60 模板、squads/overlays 配套）
+- 关键约束：WF-DEF-06（无流程级依赖，precheck 先例 test_manager）；doc_id `doc_proj{pid}_{taskKey}` 平铺命名 → rd_ 前缀
+
+## 合入说明（2026-09-17）
+
+- P0+P1 已 `--no-ff` 合入本地 `dev`（含 template-depth S0+S1）。
+- P2/P3/P4 仍 planned，待独立认领。

.doc/archive/ops/2026-09-17-w4-multi-intent-u9-u12.md

@@ -0,0 +1,39 @@
+---
+title: "W4 PU8 U9–U12 独立 flag live"
+status: done
+created: 2026-09-17
+updated: 2026-09-17
+owner: Cursor
+branch: feature/w4-u9-segment-live
+worktree: "-"
+mutex: intent-plan
+---
+
+# W4 PU8 U9–U12 独立 flag live
+
+## 目标
+
+U9 真实 LLM proposer（规则能切则不出 proposal）；U10–U12 各自独立 flag 的 dry-run→confirm 证据；不升 `MULTI_INTENT_PLAN_TIER`。
+
+## 范围
+
+- `PiSegmentProposer` + 规则门 + 组合根接线
+- U10 mutate 幂等 dry-run receipt；U11 项目 143 只读；U12 run-control 独立 flag
+- 四份独立 test-report
+
+## 非目标
+
+- 不升 `confirm` / `full`
+- 不把 U10–U12 dry-run 写成领域 live 写
+
+## 步骤
+
+1. [x] U9 PI proposer + 规则门
+2. [x] U10–U12 分 flag 证据
+3. [x] 合 `dev` + 矩阵升 done
+
+## 验收标准
+
+- [x] 真实 MiniMax U9
+- [x] 负例 malformed/timeout/OOB/规则已切
+- [x] PLAN_TIER 仍 legacy

.doc/archive/ops/2026-09-20-capability-enablement-impact-plan.md

@@ -0,0 +1,40 @@
+---
+title: "功能启用与文档修改影响分析调研"
+status: done
+created: 2026-09-20
+updated: 2026-09-20
+owner: Codex
+branch: feature/capability-enablement-impact-plan
+worktree: "-"
+mutex: capability-impact-research
+---
+
+# 功能启用与文档修改影响分析调研
+
+## 目标
+核实已实现功能的有效启用状态，形成分阶段启用方案及需求追踪、增量影响分析设计。
+
+## 范围
+源码、配置、只读运行态、已有证据；研究报告与整改方案落盘。
+
+## 非目标
+本轮不修改业务代码、不启用开关、不改变共享容器或真实项目数据。
+
+## 步骤
+1. [x] 核实功能状态和接线。
+2. [x] 调研已有修改报告、依赖与需求追踪模型。
+3. [x] 编写详细报告和可实施方案，完成文档核查。
+
+## 验收标准
+- [x] 当前事实与历史验收分开；每项启用方案有前置条件、验收、回退。
+- [x] 影响分析有版本、权限、增量更新、一致性和用户交互契约。
+
+## 证据 / 备注
+开始时 dev=8fdcd98，工作区干净；git pull --ff-only 返回 Already up to date。无集成槽占用、无 push 授权。
+
+产物：
+
+- [调研报告](../../ops/research/2026-09-20-capability-enablement-impact-research.md)
+- [整改方案](../../remediation/2026-09-20-capability-enablement-impact-plan.md)
+- [FEATURE-MATRIX 校准](../../status/FEATURE-MATRIX.md)
+- [方案审阅记录](../../ops/research/2026-09-20-capability-enablement-impact-plan-review.md)

.doc/archive/ops/2026-09-20-p0-hotfixes.md

@@ -0,0 +1,49 @@
+---
+title: "2026-09-20 P0 热修（迁移 / 越权 / 稳定性 / 凭证）"
+status: done
+created: 2026-09-20
+updated: 2026-09-20
+owner: Cursor-Auto
+branch: docs/p0-closeout-2026-09-20
+worktree: "-"
+mutex: docs
+---
+
+# 2026-09-20 P0 热修
+
+## 目标
+
+关闭系统体检发现的 P0 critical：迁移断链、三项 IDOR、进程 panic/race、凭证泄漏与生产口令轮换。
+
+## 范围
+
+- Wave 0–4（见 [整改方案](../../remediation/2026-09-20-p0-remediation-plan.md)）
+- 后续实现分支：`fix/capability-merge-00058-2026-09-20`、`fix/authz-idor-hotfixes-2026-09-20`、`fix/runtime-panic-races-2026-09-20`、`fix/credential-hardening-2026-09-20`、`docs/p0-closeout-2026-09-20`
+
+## 非目标
+
+- main 分支对齐晋升
+- FAV / SWBOOT-10 / D7 / MULTI_INTENT full
+
+## 步骤
+
+1. [x] Wave 0：审计与整改文档、CURRENT 认领、long-term 增补
+2. [x] Wave 1：capability 合入 + 00058 + rebuild
+3. [x] Wave 2：三项越权
+4. [x] Wave 2b：panic/race/recover/XSS
+5. [x] Wave 3：凭证 + 口令轮换
+6. [x] Wave 4：测试报告与收口
+
+## 验收标准
+
+- [x] 见 [测试报告](../../test-reports/2026-09-20-p0-hotfixes-test-report.md)
+
+## 相关链接
+
+- Audit: [../../audit/2026-09-20-system-triage-audit.md](../../audit/2026-09-20-system-triage-audit.md)
+- Remediation: [../../remediation/2026-09-20-p0-remediation-plan.md](../../remediation/2026-09-20-p0-remediation-plan.md)
+- Test report: [../../test-reports/2026-09-20-p0-hotfixes-test-report.md](../../test-reports/2026-09-20-p0-hotfixes-test-report.md)
+
+## 证据 / 备注
+
+（各波次合入 commit 与健康输出）

.doc/archive/ops/2026-09-21-agent-governance-implementation.md

@@ -0,0 +1,51 @@
+---
+title: "落实 Agent 规范与 L1 操作门禁"
+status: done
+created: 2026-09-21
+updated: 2026-09-21
+owner: Codex
+branch: feature/agent-governance-implementation
+worktree: .worktrees/agent-governance-implementation
+base_dev_sha: a241e838150f218f3a09d3523f93291b847d45fd
+mutex: agent-governance
+review_state: passed
+integration_state: integrated
+deployment: not_required
+cleanup: pending
+cleanup_owner: independent-maintainer-after-owner-exit
+remote_sync: not_requested
+---
+
+# 落实 Agent 规范与 L1 操作门禁
+
+用户已授权“按照方案实现这些规范”。范围：审查 R01–R10、两项安全补充、两个共享文档与 dev 操作的 L1 管理入口。所有修改在本任务 worktree；不改产品业务代码、数据库、模型配置，不升级 test/main，不 push。Python 标准库 sqlite3/fcntl 实现本机协调，不增加产品 Go 依赖。
+
+## 实施单元与所有权
+
+- 规范 Agent：AGENTS/PROJECT/客户端薄入口/模板/测试规范/CURRENT 归档，互斥 policy-docs。
+- 工具 Agent：worktree helper、env-service、candidate-images-build 与对应测试，互斥 ops-scripts。
+- 根 Agent：agentctl/SQLite/lease/CAS/提交与集成门禁、runbook、报告、FEATURE-MATRIX、ignore，互斥 coordination-core。
+- 测试 Agent：核心独立行为测试，仅写自己的测试文件，使用临时 Git 仓库。
+
+## 验收
+
+- [x] 新规范一致、轻量入口和真实状态可用；历史迁移不丢失。
+- [x] 主仓唯一 .locks；原子资源集合、父子冲突、活跃/失效身份、幂等及保守恢复。
+- [x] CURRENT/MATRIX 受控增量/CAS 更新，旧基线不覆盖，记录恢复证据。
+- [x] 错误工作区/无租约服务写入被拒；候选镜像源码 SHA 不符被拒。
+- [x] 安全 create/remove、commit/ref 门禁正反例通过。
+- [x] 独立代码审查及真实临时仓库并发验收；本地 dev 接收验证后的候选；安全清理。
+
+## 交付边界
+
+L1 对统一入口与 Git hooks 防误改，不能阻止任意同 UID shell 绕过。OS 沙箱、跨机锁、产品 PI 镜像交付等独立运行架构变更不在本次规范/最小门禁改动内。纯工程代码与文档不触发产品重建；将验证主目录运行挂载和就绪未因本轮改变。
+
+## 验证与集成结果
+
+- 76 项 Python 工程测试通过；最终候选复跑同样 76 PASS。20 个真实进程/独立 Git worktree 争同一资源：1 个执行、19 个 LOCK_BUSY。
+- ce-simplify-code 三视角完成；ce-code-review `20260921-133611-5e4781e6` 的 5 个确认问题全部修复并经独立复核关闭。详见[报告](../../test-reports/2026-09-21-agent-governance-test-report.md)。
+- 源码实现提交 `fed87ad1`；保留并行 Cursor 材料切块任务后任务 HEAD 为 `578a96440da56717582ec5ab267a094ceea3d941`。dev 从 `a5ea469ca44171a5c3e6419b1757852270fb991d` 接收完整验证候选 `7e9317b849e0696e110bac5b27749861178d7e3d`，这是规则 effective_commit。
+- 主仓 `.locks` 初始化、旧/新 dev flock 同 inode 和三个 hooks 已启用；doctor 正常，无租约 env guard 返回 LEASE_REQUIRED。收口文档使用已生效入口完成 CAS、提交与后续候选集成。
+- 真实 dev 合入前后 ready=ok/schema61、容器镜像和主目录 data/dev 挂载一致。本轮 deployment=not_required；未 push、未操作 test/main、无产品数据库或模型配置改动。
+- cleanup=pending：实际普通 remove 因部分同 UID 进程 cwd 不可读拒绝。保留本任务及 integrate-agent-governance-implementation 两个工作区，不使用 force/-D。独立维护者在 owner 退出并解决/核实进程可见性后重跑全部门禁；仅含可再生 pycache 的文件先明确删除。其他任务现场不在清理范围。
+- 文档链接检查 356 个目标中，唯一已存在的 `FEATURE-MATRIX` 历史 promotion receipt 断链不由本轮引入；本轮新增/修改链接全部有效。

.doc/archive/ops/2026-09-21-agent-workflow-governance-plan.md

@@ -0,0 +1,48 @@
+---
+title: "Agent 工作规范与 worktree 并行治理方案"
+status: done
+created: 2026-09-21
+updated: 2026-09-21
+owner: Codex
+branch: feature/agent-workflow-governance-plan
+worktree: .worktrees/feature-agent-workflow-governance-plan
+mutex: agent-workflow-governance-plan
+---
+
+# Agent 工作规范与 worktree 并行治理方案
+
+## 目标
+
+基于当前仓库规范、脚本和现场，评估主目录保护、强制 worktree、串行集成与清理机制，交付可审核方案。
+
+## 范围
+
+- 只读检查 Git、脚本、Compose、测试入口和协作记录。
+- 形成调研、治理方案及交接文档；仅在本任务 worktree 写文档。
+
+## 非目标
+
+- 不修改业务代码、Agent 规则或运维脚本；不切换主目录分支、不干预其他任务、不重建服务、不清理既有 worktree、不 push。
+
+## 步骤
+
+1. [x] 阅读启动链并盘点现场。
+2. [x] 显式从本地 dev@15b8a4a8 创建独立 worktree。
+3. [x] 完成机制核验、方案和边界审查。
+4. [x] 写交接并核查文档差异。
+
+## 验收标准
+
+- [x] 有现状证据、方案比较、操作流程、并行边界、恢复与验收标准。
+- [x] 区分已存在机制与拟实现机制；不将方案宣称为已落地。
+
+## 证据 / 备注
+
+初始主目录为 fix/intent-workflow-scoping-2026-09-21，有其他任务未提交变更。为保护现场，未执行 checkout dev / pull；从显式本地 dev 创建 worktree。origin/dev...dev 为 0/309，仅为本地远端跟踪引用快照，本轮未 fetch。认领仅登记本 worktree 的 CURRENT，尚无跨 worktree 实时协调入口；本任务只读代码且使用独立文档路径。
+
+## 交付
+
+- [调研](../../ops/research/2026-09-21-agent-workflow-governance-research.md)
+- [方案](../../remediation/2026-09-21-agent-workflow-governance-plan.md)
+- [交接](../../ops/handoffs/2026-09-21-agent-workflow-governance-plan.md)
+- 仅文档核验，未执行产品测试；治理能力在 FEATURE-MATRIX 保持 planned。

.doc/archive/ops/2026-09-21-current-history.md

@@ -0,0 +1,286 @@
+# CURRENT 历史快照（2026-09-21）
+
+归档来源：实施基线 `eb4dbdca5baae8dd5f3ddefc0f5510ac2978dcd3` 的 `.doc/ops/CURRENT.md`。以下保留原始认领、环境断言、焦点和证据索引；只调整移动后的 Markdown 相对链接。历史状态不是当前锁、环境或授权依据，活跃协调见 [CURRENT](../../ops/CURRENT.md)。基线内已失效的旧链接另在本次验证记录中说明，不把历史声明改写成新结论。
+
+---
+
+# 当前焦点
+
+**更新**: 2026-09-21
+**production_ready**: yes（门禁 B1–B4 已签；dev schema **61**，test/main 仍为 **58**。P0 热修 done；rdev 种子热修 done，见 [报告](../../test-reports/2026-09-20-rdev-seed-hotfix-test-report.md)）
+
+## 焦点
+
+1. **工作流作用域权重**：`WORKFLOW_SCOPE_MODE` 默认 `strict`；`weighted` 按关系权重打分，只读跨流注明归属，写动作仍拦截。见 [报告](../../test-reports/2026-09-21-workflow-scope-weighting-test-report.md)。test/main 未晋升。
+2. **意图确认优先与阶段感知**：弱写「整理需求」→ intake 确认卡片。见 [报告](../../test-reports/2026-09-21-intent-confirm-stage-aware-test-report.md)。test/main 未晋升。
+3. **上传解析提示 / 去重 / CoW 收口**：MinerU 解析状态轮询闭环（pending→running→done）、重复文件「已复用」提示、失败原因+重新解析、CAS 不可变 CoW 契约测试，已合入 `dev`（代码 `99905571`、证据 `74587ccf`、收口 `a0464eb5`）。见 [报告](../../test-reports/2026-09-21-upload-parse-ux-dedup-test-report.md)。test/main 未晋升。前序任务执行状态卡收口见 [报告](../../test-reports/2026-09-21-taskrun-status-card-persistence-test-report.md)（含二轮修复：completed 步骤 label 冻结为"正在…（NN%）"的收口归一化 + dev 历史回填，已合入 `dev@4b303247` 并真实 PI 验收）。
+4. **MinerU 真实 PDF 二轮验收**：用户反馈「PDF 内容未被理解」由两因叠加——(A) 首轮在 worktree 内跑 `env-service dev rebuild` 令挂载漂到 worktree `data/dev`，真实历史 blob 全部读不到；(B) Agent 轻量 API 硬限 20 页，28 页真实文件失败。首轮结论作废。二轮从**主目录** rebuild 修复挂载，`internal/mineru` 在 `-30003` 时按 20 页窗分块解析并重编全局页锚；`ReadRefBytes` 失败改为 `slog.Warn`。已合入 `dev@362b68a0`。真实 `bd_intake`（项目 6532）`completed`，工作区 `materials_text` 注入 29152 字节中文正文。见 [报告](../../test-reports/2026-09-21-mineru-doc-parsing-test-report.md) 第八节。
+5. **红线**：禁止整支 merge FAV；不默认升 `MULTI_INTENT_PLAN_TIER=full`；`SEMANTIC_SUMMARY_REPLACE` 不随 W2 开启；FAV live 观察窗证据驱动；`FAV_DEGRADED_READ=false`；项目 143 只读；SWBOOT-10 保持 fail-closed stub；D7 对话 ADR 仍待合规签字（追踪表留存类别已定为 `record`，不授权物理删除）；**不改 `production_ready`**；模块解耦批次 A–G 与回溯实施切片未单独认领前保持 `planned`；**合入 dev 后必须回主目录跑 `env-service.sh dev rebuild`，禁止任何 worktree 内运行 `env-service`**（脚本 ROOT_DIR 取自脚本所在目录树，会带走 bind mount，导致 `/app/data` 漂到 worktree 空目录）。
+
+## 并行认领
+
+| owner | task | branch | worktree | mutex | status |
+|-------|------|--------|----------|-------|--------|
+| Codex | 2026-09-21-agent-governance-implementation | feature/agent-governance-implementation | .worktrees/agent-governance-implementation | agent-governance | in_progress |
+| Cursor | 2026-09-21-workflow-scope-weighting | feature/workflow-scope-weighting-2026-09-21 | .worktrees/workflow-scope-weighting-2026-09-21 | intent+web+docgov | done |
+| Cursor | 2026-09-21-upload-parse-ux-dedup | feature/upload-parse-ux-2026-09-21 | .worktrees/upload-parse-ux-2026-09-21 | server+web+storage | done |
+| Cursor | 2026-09-21-mineru-doc-parsing | feature/mineru-doc-parsing-2026-09-21 | .worktrees/mineru-doc-parsing-2026-09-21 | storage+bizdev+kb | done |
+| Cursor | 2026-09-21-intent-confirm-stage-aware | fix/intent-confirm-stage-aware-2026-09-21 | .worktrees/intent-confirm-stage-aware-2026-09-21 | intent+web+docgov | done |
+| Cursor | 2026-09-21-taskrun-status-card | feature/taskrun-status-card-2026-09-21 | .worktrees/feature-taskrun-status-card-2026-09-21 | chat+web+taskrun | done |
+| Cursor | 2026-09-21-intent-workflow-scoping | fix/intent-workflow-scoping-2026-09-21 | - | intent+web+docgov | done |
+| Codex | 2026-09-21-agent-workflow-governance-adoption | feature/agent-workflow-governance-plan | .worktrees/feature-agent-workflow-governance-plan | agent-workflow-governance | in_progress |
+| Codex | 2026-09-21-agent-workflow-governance-plan | feature/agent-workflow-governance-plan | .worktrees/feature-agent-workflow-governance-plan | agent-workflow-governance-plan | done |
+| Cursor | 2026-09-21-workflow-doc-key-unification | fix/workflow-doc-key-unification-2026-09-21 | .worktrees/fix-workflow-doc-key-unification-2026-09-21 | docgov+web | done |
+| Cursor | 2026-09-21-dev-deep-test-four-issues | fix/dev-deep-test-four-issues-2026-09-21 | - | web+intent+taskrun | done |
+| Cursor | 2026-09-21-trace-panel-to-chat | feature/trace-panel-to-chat-2026-09-21 | - | trace-impact+web | done |
+| Cursor | 2026-09-21-taskrun-scope-persist | fix/taskrun-scope-persist-2026-09-21 | - | projectinstance+taskrun | done |
+| Cursor | 2026-09-21-dev-multiuser-four-issues | fix/dev-multiuser-four-issues-2026-09-21 | .worktrees/fix-dev-multiuser-four-issues | projectinstance+docgov | done |
+| Cursor | 2026-09-21-taskrun-error-transparency | fix/taskrun-error-transparency-2026-09-21 | - | chat+web | done |
+| Cursor | 2026-09-21-trace-panel-null-crash | fix/trace-panel-null-crash-2026-09-21 | - | trace-index+web | done |
+| Cursor-Auto | 2026-09-20-stage-backtrack-design | feature/stage-backtrack-design | - | trace-impact-design | done |
+| Cursor-Auto | 2026-09-20-impact-loop-t1 至 T3/B1–B3 | feature/stage-backtrack-impl | - | trace-index | done |
+| Cursor | 2026-09-20-rdev-seed-hotfix | fix/workflow-seed-bootstrap-2026-09-20 | - | workflow-def | done |
+| Cursor-Auto | 2026-09-20-module-decoupling-spec-audit | docs/module-decoupling-spec-2026-09-20 | - | module-decoupling-spec | done |
+| Cursor-Auto | 2026-09-20-p0-closeout | docs/p0-closeout-2026-09-20 | - | docs | done |
+| Cursor-Auto | 2026-09-20-p0-hotfixes（Wave 0 文档） | docs/p0-triage-2026-09-20 | - | docs | done |
+| Cursor-Auto | 2026-09-20-p0-capability-00058 | fix/capability-merge-00058-2026-09-20 | - | infra+chat | done |
+| Cursor-Auto | 2026-09-20-p0-idor | fix/authz-idor-hotfixes-2026-09-20 | - | authz | done |
+| Cursor-Auto | 2026-09-20-p0-runtime-stability | fix/runtime-panic-races-2026-09-20 | - | taskrun+chat+web | done |
+| Cursor-Auto | 2026-09-20-p0-credentials | fix/credential-hardening-2026-09-20 | - | ops+infra | done |
+| Cursor-Auto | 2026-09-20-proposed-authoritative-reports | feature/capability-enablement-impact-plan | - | docgov | done |
+| Cursor-Auto | 2026-09-20-pi-narrative-clipped-diff | feature/capability-enablement-impact-plan | - | docgov | done |
+| Cursor-Auto | 2026-09-20-pi-reasoning-profile | feature/capability-enablement-impact-plan | - | pi-agent | done |
+| Cursor-Auto | 2026-09-20-semantic-summary-persistence | feature/capability-enablement-impact-plan | - | chat+lineage-version | done |
+| Cursor-Auto | 2026-09-20-feature-readiness-and-lineage-authz | feature/capability-enablement-impact-plan | - | sysadmin+lineage | done |
+| Codex | 2026-09-20-capability-enablement-impact-plan | feature/capability-enablement-impact-plan | - | capability-impact-research | done |
+| Cursor-Auto | 2026-09-20-post-activation-duty-reassign-member-chat | fix/post-activation-duty-reassign-member-chat | - | projectworkflow+authz+web | done |
+| Cursor-Auto | 2026-09-20-test-env-triage-fixes | fix/test-env-triage-2026-09-20 | - | projectworkflow+chat+assets | done |
+| Cursor-Auto | 2026-09-20-test-env-beta6-verification | docs/test-env-beta6-verification | - | infra+docs | done |
+| Cursor-Auto | 2026-09-20-bug-hunt-permissions-uploads | fix/bug-hunt-2026-09-20-permissions-and-uploads | - | authz+web+projectworkflow | done |
+| Cursor | audit-b1-data-consistency | fix/audit-b1-data-consistency | - | docgov+workflow+chat | done |
+| Cursor | audit-b2-authz-hardening | fix/audit-b2-authz-hardening | - | authz | done |
+| Cursor | audit-b3-sse-events | fix/audit-b3-sse-events | - | chat+events | done |
+| Cursor | audit-b4-frontend | fix/audit-b4-frontend | - | web | done |
+| Cursor-Auto | 2026-09-19-audit-remainder-closeout | fix/audit-remainder-closeout | - | audit-remainder | done |
+| Antigravity | 2026-09-20-dev-deep-test-and-promotion | feature/dev-deep-test-and-promotion | - | integration | done |
+| Cursor-Auto | 2026-09-19-remove-control-center | fix/remove-control-center | - | controlcenter | done |
+| Cursor-Auto | 2026-09-17-control-center-server | feature/control-center-server | - | controlcenter | cancelled |
+| Kimi | 2026-09-18-user-manual | feature/user-manual | .worktrees/feature-user-manual | docs | done |
+| Cursor-Auto | 2026-09-18-wave7-roadmap-orchestration | docs/wave7-roadmap-orchestration | - | roadmap-orchestration | done |
+| Cursor-Auto | 2026-09-18-wave6-doc-drift | docs/wave6-doc-drift | - | doc-drift | done |
+| Cursor-Auto | 2026-09-18-wave5-deadcode-decisions | fix/wave5-deadcode-decisions | - | deadcode-cleanup | done |
+| Cursor-Auto | 2026-09-18-wave4-hardening-r1-r8 | fix/wave4-hardening-r1-r8 | - | hardening | done |
+| Cursor-Auto | 2026-09-18-wave3-test-debt-blindspots | fix/wave3-test-debt-blindspots | - | test-debt | done |
+| Cursor-Auto | 2026-09-18-wave2-config-flag-align | fix/wave2-config-flag-align | - | infra | done |
+| Cursor | 2026-09-18-wave1-main-env-fix | fix/wave1-main-env-fix | - | infra | done |
+| Cursor | 2026-09-18-wave0-p0-bug-fixes | fix/wave0-p0-sse-chat-cache-bugs | - | chat + web | done |
+| Kimi | 2026-09-17-system-health-check（只读审计，未实施） | - | - | audit | done |
+| Cursor | 2026-09-17-docgov-modification-proposal-http | feature/docgov-modification-proposal-http | - | docgov | done |
+| Cursor | 2026-09-17-document-author-only-closeout | feature/document-author-only-plan | - | document-duty-policy | done |
+| Cursor | 2026-09-17-rdev-template-depth-s1-continued | feature/rdev-template-depth-s1-continued | .worktrees/feature-rdev-template-depth-s1-continued | rdev-templates | done |
+| Cursor | 2026-09-17-rdev-workflow-integration | feature/rdev-core | - | workflow-def | done |
+| Cursor | 2026-09-17-rdev-template-depth | feature/rdev-template-depth | .worktrees/feature-rdev-template-depth | rdev-templates | done |
+| Codex | 2026-09-17-document-author-only-plan | feature/document-author-only-plan | - | document-duty-policy-plan | done |
+| Cursor | 2026-09-17-initial-load-perf-u2 | feature/initial-load-perf-u2 | - | web + static-delivery | done |
+| Codex | 2026-09-17-initial-load-performance-plan | feature/initial-load-performance-plan | .worktrees/feature-initial-load-performance-plan | loading-performance-audit | done |
+| Kimi | 2026-09-17-system-admin-console | feature/system-admin-console | - | web + sysadmin | done |
+| Cursor-Auto | 2026-09-17-engineering-dashboard | feature/engineering-dashboard | .worktrees/feature-engineering-dashboard | engineering-dashboard | done |
+| Cursor | 2026-09-17-promote-null-fk-to-test | feature/promote-null-fk-to-test | - | infra | done |
+| Cursor | 2026-09-17-docgov-optional-duty-null-fk | fix/docgov-optional-duty-null-fk | - | docgov | done |
+| Cursor | 2026-09-17-leftover-hygiene | chore/leftover-hygiene-2026-09-17 | - | ops | done |
+| Cursor | 2026-09-17-w2-semantic-summary-shadow | feature/w2-semantic-summary-shadow-live | - | chat | done |
+| Cursor | 2026-09-17-w3-pi-change-report-narrative | feature/w3-pi-change-report-narrative-live | - | docgov | done |
+| Cursor | 2026-09-17-w4-multi-intent-u9-u12 | feature/w4-u9-segment-live | - | intent-plan | done |
+| Cursor | 2026-09-17-w5a-software-bootstrap-ui | feature/w5a-software-bootstrap-ui-pi | - | workflow-design | done |
+| Cursor | 2026-09-17-w6-fav-subscriber-shadow | feature/w6-fav-subscriber-shadow | - | events | done |
+| Cursor | 2026-09-17-w7-d7-inventory | feature/w7-d7-data-inventory | - | chat | done |
+| Cursor | 2026-09-17-promote-dev-to-test | feature/promote-dev-to-test-2026-09-17 | - | infra | done |
+| Cursor | 2026-09-17-kb-host-auth-fix | fix/kb-host-auth-layered-load | - | infra | done |
+| Cursor | 2026-09-17-w1-ci-e2e-green-nightly | feature/w1-ci-e2e-green-nightly | - | ci | done |
+| Cline | 2026-09-16-partial-deferred-completion | docs/partial-deferred-completion-plan | - | architecture-docs | in_progress |
+| Cursor | 2026-09-16-intent-plan-playwright-dual-tab | feature/intent-plan-cards-playwright | .worktrees/feature-intent-plan-cards-playwright | web | done |
+| Cursor | 2026-09-16-full-backlog-override | docs/override-nogo-full-backlog | - | architecture-docs | done |
+| Cursor | 2026-09-16-gitea-nightly-docker-datadir | fix/gitea-nightly-docker-datadir | - | ci | done |
+| Cursor | 2026-09-16-gitea-nightly-host-tools | fix/gitea-nightly-host-tools | - | ci | done |
+| Cursor | 2026-09-21-test-env-lazy-doc-verification | docs/lazy-doc-verification-2026-09-21 | - | infra+docs | done |
+| Cursor | 2026-09-16-wave-leftovers | fix/wave-leftovers-n7-playwright-dod | - | ci | done |
+| Cursor | 2026-09-16-wave3-pu6-pu8-go-no-go | feature/wave3-pu6-pu8-go-no-go | - | architecture-docs | done |
+| Cursor | 2026-09-16-wave2c-same-image-digest | feature/wave2c-same-image-digest | - | infra | done |
+| Cursor | 2026-09-16-wave2b-nightly-promotion-receipt | feature/wave2b-nightly-promotion-receipt | - | ci | done |
+| Cursor | 2026-09-16-wave2-real-pi-evidence | feature/wave2-real-pi-evidence | - | intent-plan | done |
+| Cursor | 2026-09-16-wave1-race-tempdir-cleanup | fix/race-tempdir-cleanup | - | ci | done |
+| Cursor | 2026-09-16-wave1-iam-fail-closed | fix/iam-store-fail-closed | - | authz | done |
+| Cursor | 2026-09-16-feature-matrix-wave0-calibration | feature/feature-matrix-production-readiness-plan | .worktrees/feature-matrix-production-readiness-plan | architecture-docs | done |
+| Codex | 2026-09-16-feature-matrix-production-readiness-plan | feature/feature-matrix-production-readiness-plan | .worktrees/feature-matrix-production-readiness-plan | architecture-docs | done |
+| Cursor-Auto | 2026-09-16-matrix-deep-test-promote-test | feature/matrix-deep-test-promote-test | - | infra | done |
+| Cursor-Auto | 2026-09-16-production-ready-gates | docs/production-ready-flip | - | ci | done |
+| Cursor-Auto | 2026-09-16-demo-seed-pollution | fix/demo-data-pollution-web | - | web | done |
+| Cursor | 2026-09-16-multi-intent-u8-task-generate | feature/multi-intent-u8-task-generate | - | intent-plan | done |
+| Cursor | 2026-09-16-multi-intent-u7-auto-read | feature/multi-intent-u7-auto-read | - | intent-plan | done |
+| Cursor | 2026-09-16-multi-intent-u6-web-cards | feature/multi-intent-u6-web-cards | - | web | done |
+| Cursor | 2026-09-16-multi-intent-u5-decision-api | feature/multi-intent-u5-decision-api | - | intent-plan | done |
+| Cursor | 2026-09-16-multi-intent-u4-outbox-projection | feature/multi-intent-u4-outbox-projection | - | events | done |
+| Cursor | 2026-09-15-multi-intent-u3-intentflow-pg | feature/multi-intent-u3-intentflow-pg | - | intent-plan | done |
+| Cursor | 2026-09-15-multi-intent-u2-segmenter | feature/multi-intent-u2-segmenter | - | intent | done |
+| Cursor | 2026-09-15-multi-intent-u1-contracts | feature/multi-intent-u1-contracts | - | architecture-docs | done |
+| Cursor | app-composition-u11-u12 | feature/app-composition-u11-u12 | - | app | done |
+| Cursor | chatlog-contextasm-u10 | feature/chatlog-contextasm-u10 | - | chat | done |
+| Cursor | chat-history-refresh-remediation | fix/chat-history-refresh | - | chat | done |
+| Cursor | dataset-lifecycle-u9 | feature/dataset-lifecycle-u9 | - | dataset | done |
+| Cursor | taskrun-runmanifest-u8 | feature/taskrun-runmanifest | - | taskrun | done |
+| Cursor | document-reliability-m1-live-and-m2 | refactor/document-reliability-pilot | - | workspace | done |
+| Codex | module-decoupling-remediation-plan | feature/module-decoupling-remediation | - | architecture-docs | done |
+| Codex | module-decoupling-phase2-plan-review | docs/module-decoupling-ipc-assessment | - | architecture-docs | done |
+| Cursor | module-decoupling-phase2-docs | feature/module-decoupling-phase2-docs | - | architecture-docs | done |
+| verifier_antigravity | controlled-content-ui-acceptance | fix/controlled-content-ui-acceptance | - | document-content-ui-acceptance | done |
+| implementer_cursor | controlled-content-canonical-hash | fix/controlled-content-canonical-hash | - | docgov | done |
+| Codex | project143-controlled-content-404-diagnosis | fix/project143-controlled-content-404-diagnosis | - | docgov-content-diagnosis | done |
+| Codex | software-project-bootstrap-plan | feature/software-project-bootstrap-plan | - | workflow-design | done |
+| Codex | conversation-intent-runtime-state | fix/conversation-intent-state | - | intent | done |
+| Cursor | conversation-intent-runtime-state | docs/conversation-intent-dual-tab | - | intent | done |
+| Cursor | document-revision-wave1-6-implementation | feature/document-revision-management | - | docgov | done |
+| Cursor-Auto | document-revision-runtime-ui03 | fix/document-revision-runtime-ui03 | - | docgov | done |
+| Cursor-Auto | document-revision-sse-idempotency | fix/document-revision-sse-idempotency | - | docgov | done |
+| Cursor-Auto | document-revision-active-doc-routing | fix/document-revision-active-doc-routing | - | docgov | done |
+| Cursor-Auto | document-revision-quality-context | fix/document-revision-quality-context | - | docgov | done |
+| Cursor-Auto | document-revision-e2e-pending-flow | fix/document-revision-e2e-pending-flow | - | pending-report-ui | done |
+| Cursor-Auto | document-revision-e2e-reject-routing | fix/document-revision-e2e-reject-routing | - | document-revision-runtime-ui | done |
+| Cursor-Auto | document-revision-e2e-block-selector | fix/document-revision-e2e-block-selector | - | document-revision-block-selector | done |
+| Cursor-Auto | document-revision-e2e-save-selector | fix/document-revision-e2e-save-selector | - | document-revision-save-selector | done |
+| Cursor-Auto | document-revision-e2e-overlay-selector | fix/document-revision-e2e-overlay-selector | - | document-revision-overlay-selector | done |
+| Cursor-Auto | document-revision-e2e-overlay-transition | fix/document-revision-e2e-overlay-transition | - | document-revision-overlay-transition | done |
+| Cursor-Auto | document-revision-second-doc-routing-lease | fix/document-revision-second-doc-routing-lease | - | document-revision-second-doc-routing-lease | done |
+| Cursor-Auto | document-revision-prelim-output | fix/document-revision-pi-runner-module | - | document-revision-prelim-output | done |
+| Cursor-Auto | document-revision-editor-hydration-race | fix/document-revision-editor-hydration-race | - | document-revision-editor-hydration-race | done |
+| Cursor-Auto | document-revision-quality-repair-workspace-contract | fix/document-revision-quality-repair-workspace-contract | - | document-revision-quality-repair-workspace-contract | done |
+| Cursor-Auto | document-revision-fast-completion-observation | fix/document-revision-fast-completion-observation | - | document-revision-fast-completion-observation | done |
+| Cursor-Auto | document-revision-workflow-category-navigation | fix/document-revision-workflow-category-navigation | - | document-revision-workflow-category-navigation | done |
+| Cursor-Auto | document-revision-duty-cell-assertion | fix/document-revision-duty-cell-assertion | - | document-revision-duty-cell-assertion | done |
+| Cursor-Auto | document-revision-reviewer-duty-sync | fix/document-revision-reviewer-duty-sync | - | document-revision-reviewer-duty-sync | done |
+| Cursor-Auto | document-revision-post-restart-selector | fix/document-revision-post-restart-selector | - | document-revision-post-restart-selector | done |
+| Cursor-Auto | document-revision-post-restart-final-snippet | fix/document-revision-post-restart-final-snippet | - | document-revision-post-restart-final-snippet | done |
+| Cursor-Auto | document-revision-pg-id-remap | fix/document-revision-pg-id-remap | - | document-revision | done |
+| Cursor-Auto | document-revision-runtime | fix/document-revision-runtime-ui03 | - | docgov | done |
+| Cursor-Auto | document-revision-runtime-ui-final-report | feature/document-revision-runtime-ui-final-report | - | document-revision-runtime-ui | done |
+| Cursor-Auto | document-revision-evidence-count | fix/document-revision-evidence-count | - | document-revision-evidence-count | done |
+| Cursor-Auto | document-revision-session-close | feature/document-revision-session-close | - | document-revision-session-close | done |
+| Cursor-Auto | vite-frp-allowed-hosts | fix/vite-frp-allowed-hosts | - | web-devserver | done |
+| implementer_cursor | workflow-plan-409-frozen-and-optional-duties | fix/workflow-plan-409-frozen-and-optional-duties | - | workflow | done |
+| implementer_cursor | governance-action-level-authz | fix/governance-action-level-authz | - | workflow | done |
+| Cursor | leftover-branch-cleanup | chore/leftover-branch-cleanup | - | ops | done |
+| Cursor | event-e0a-production-scope-contract | fix/event-production-scope-contract | - | events | done |
+| Cursor | event-e0b-dispatcher-pg | feature/events-dispatcher-pg | - | events | done |
+| Cursor | event-e1a-notify-cutover | fix/event-notify-cutover | - | events | done |
+| Cursor | event-e1b-workflow-advance | fix/event-workflow-advance | - | events | done |
+| Cursor | event-e1c-projection-cutover | fix/event-projection-cutover | - | events | done |
+| Cursor | event-e2-hook-guard | fix/event-e2-hook-guard | - | events | done |
+| Cursor | doccontent-canonical-boundary | fix/doccontent-canonical-boundary | - | docgov | done |
+| Cursor | intent-bizdev-boundary | fix/intent-bizdev-boundary | - | intent | done |
+| Cursor | stageflow-type-ownership | fix/stageflow-type-ownership | - | stageflow | done |
+| Cursor | bizdev-locator-removal | fix/bizdev-locator-removal | - | bizdev | done |
+| Cursor | chatflow-orchestration-boundary | fix/chatflow-orchestration-boundary | - | chat | done |
+| Cursor | phase2-closeout-inventories | feature/phase2-closeout-inventories | - | architecture-docs | done |
+| Cursor | event-shared-live-cutover | feature/event-shared-live-cutover | - | events | done |
+| Cursor | pi-typed-result | feature/pi-typed-result | - | pi-agent | done |
+| Cursor | promote-dev-to-test-2026-09-15 | feature/promote-dev-to-test-2026-09-15 | - | infra | done |
+
+> 新任务开始前登记。`branch` 必须为 `feature/<slug>` 或 `fix/<slug>`，**禁止** `dev` / `test` / `main`。同一 `mutex` 同时仅一个 `in_progress`。
+
+> workflow-plan 409 与治理鉴权 G1–G5 已收口（见 [test-report](../../test-reports/2026-09-14-governance-action-level-authz-test-report.md)）。禁止终止或改写项目 143。
+> `document-reliability-pilot` U11–U12 已合入 `dev@bf59cce` 并 rebuild。`CHAT-INTENT-STATE` 双标签 busy 已 PASS（项目 6275）。禁止 worktree 内 `env-service`。项目 143 只读，禁止终止。
+> 2026-09-17 leftover 二次收口：[报告](../../test-reports/2026-09-17-leftover-hygiene-test-report.md)。已合入 leftover worktree/旁支再拆一轮；`feature/software-project-bootstrap` L1 已在 `dev`（残留关闭 commit 已丢弃）。`fix/clean-test-env-baseline` **不 merge**（前端 demo 清理已放弃；仅保留已挑拣的 `SEED_DEMO_USERS=false`）。extra worktree 仅余 `.worktrees/fix-dev-runtime-data-root-guard`（目录名是 guard，检出的是 `feature/final-artifact-vault`）。**故意不合入、不删**：`feature/final-artifact-vault`、`feature/remove-herdr-agent-settings`、`fix/project143-controlled-content-404-diagnosis`、`fix/dev-runtime-data-root-guard`、`dev-old-linear`。不删 `origin/*`。不整支 merge FAV；不启用 `FAV_DEGRADED_READ`。
+
+## 集成槽位
+
+| holder | phase | since | scope | queue |
+|--------|-------|-------|-------|-------|
+| - | idle | 2026-09-21 | taskrun-status-card label 修复已合入 dev@4b303247 并真实 PI 验收（round2 docs 随后合入）；mineru 二轮文档已合入；schema=61 | - |
+
+**phase**: `idle` | `merging` | `smoke` | `e2e`
+
+> 合入 `dev` + 共享容器验证必须串行。详见 [AGENTS.md](../../../AGENTS.md) §6.3。
+
+## 环境快照
+
+| 环境 | 端口 | schema | 状态 |
+|------|------|--------|------|
+| dev | 8080 | **61** | healthy（mineru `00061`；intent-confirm 真实 PI PASS；`/health` schema_version=61；`pi-agent`；events `:8088`） |
+| test | 8081 | **58** | healthy（`rc-v1.0.0-beta.7`；rdev v1 active；`published_by` 回落到用户 4；events `:8089`） |
+| main | 8000 | **58** | healthy（P0 Wave3 rebuild 已追平 schema；分支树对齐仍记 backlog；口令已轮换；events `:8090`） |
+
+## SSOT
+
+| 类型 | 路径 |
+|------|------|
+| 2026-09-21 Agent worktree 工作规范 | [方案](../../remediation/2026-09-21-agent-workflow-governance-plan.md) · [调研](../../ops/research/2026-09-21-agent-workflow-governance-research.md) · [交接](../../ops/handoffs/2026-09-21-agent-workflow-governance-plan.md)；规范已采纳，自动化另列 planned |
+| 2026-09-20 rdev 种子 | [short-term](../../ops/short-term/2026-09-20-rdev-seed-hotfix.md) · [报告](../../test-reports/2026-09-20-rdev-seed-hotfix-test-report.md) |
+| 2026-09-20 模块解耦 | [审计](../../audit/2026-09-20-module-coupling-audit.md) · [规范](../../system-design/2026-09-20-module-development-standards.md) · [批次 A–G](../../remediation/2026-09-20-module-decoupling-batch-plan.md) · [short-term](../../ops/short-term/2026-09-20-module-decoupling-spec-audit.md) |
+| 文档总地图 | [../README.md](../../README.md) |
+| 模块完成度 | [FEATURE-MATRIX](../../status/FEATURE-MATRIX.md)（Wave 0 已校准契约与冻结边界） |
+| 发布缺口 | [gap-matrix](../../remediation/gap-matrix.md)（`production_ready=yes`；Wave 0 IAM 只读未发现旁路） |
+| 2026-09-20 系统体检 | [audit](../../audit/2026-09-20-system-triage-audit.md) · [P0 整改](../../remediation/2026-09-20-p0-remediation-plan.md) · [short-term](../../ops/short-term/2026-09-20-p0-hotfixes.md) |
+| 连续性审计/计划 | [audit](../../audit/2026-09-16-feature-matrix-production-readiness-audit.md) · [remediation](../../remediation/2026-09-16-feature-matrix-production-readiness-plan.md) · [Wave 0 任务](../../ops/short-term/2026-09-16-feature-matrix-wave0-calibration.md) |
+| 测试报告 | [test-reports/](../../test-reports) |
+| dev→test 晋升前复核 | [research](../../ops/research/2026-09-19-pre-test-promotion-review.md)（2026-09-19 只读；静态门禁过，容器未 rebuild，暂不合并） |
+| D7 盘点（W7） | [audit](../../audit/2026-09-17-d7-data-inventory.md) · [报告](../../test-reports/2026-09-17-w7-d7-inventory-test-report.md) · ADR 仍 `pending-compliance-signoff` |
+| 功能启用与文档影响分析 | [调研](../../ops/research/2026-09-20-capability-enablement-impact-research.md) · [整改方案](../../remediation/2026-09-20-capability-enablement-impact-plan.md) · [方案审阅](../../ops/research/2026-09-20-capability-enablement-impact-plan-review.md)（2026-09-20；未启用开关、未改业务代码） |
+| 阶段回溯与影响闭环 | [设计](../../system-design/2026-09-20-stage-backtrack-and-impact-loop-design.md) · [short-term](../../ops/short-term/2026-09-20-stage-backtrack-design.md)（2026-09-20；仅设计。切片 T1/T2/B1/B2/B3/T3 均为 planned） |
+| Wave 7 编排确认 | [决策记录](../../ops/short-term/2026-09-18-wave7-roadmap-orchestration.md) |
+| Agent 手册 | [AGENTS.md](../../../AGENTS.md) |
+| 意图双标签 busy 交接 | [./handoffs/2026-09-15-conversation-intent-dual-tab.md](../../ops/handoffs/2026-09-15-conversation-intent-dual-tab.md) |
+| 受控正文 hash 漂移 W1–W6 | [../ops/handoffs/2026-09-14-controlled-content-canonical-hash.md](../../ops/handoffs/2026-09-14-controlled-content-canonical-hash.md) |
+| DOCREV ADR | [../adr/2026-09-13-document-version-boundary.md](../../adr/2026-09-13-document-version-boundary.md) |
+| DOCREV 管理测试 | [../test-reports/2026-09-13-document-revision-management-test-report.md](../../test-reports/2026-09-13-document-revision-management-test-report.md) |
+| DOCREV 运行时 UI Round20 | [../test-reports/2026-09-14-document-revision-runtime-ui-test-report.md](../../test-reports/2026-09-14-document-revision-runtime-ui-test-report.md) |
+| 纯软件项目自举设计 | [../system-design/2026-09-14-software-project-bootstrap-workflow.md](../../system-design/2026-09-14-software-project-bootstrap-workflow.md) |
+| 模块化单体解耦架构 | [../system-design/2026-09-14-module-decoupling-architecture.md](../../system-design/2026-09-14-module-decoupling-architecture.md) |
+| 模块解耦整改计划 | [../remediation/2026-09-14-module-decoupling-refactor-plan.md](../../remediation/2026-09-14-module-decoupling-refactor-plan.md) |
+| Phase 2 方案审阅 | [../audit/2026-09-15-module-decoupling-phase2-plan-review.md](../../audit/2026-09-15-module-decoupling-phase2-plan-review.md) |
+| Phase 2 修订计划 | [../remediation/2026-09-15-module-decoupling-ipc-phase2-remediation-plan.md](../../remediation/2026-09-15-module-decoupling-ipc-phase2-remediation-plan.md) |
+| 多意图 HITL 复核方案 | [../system-design/2026-09-15-multi-intent-hitl-plan.md](../../system-design/2026-09-15-multi-intent-hitl-plan.md) |
+| 多意图 HITL U1 契约 | [../test-reports/2026-09-15-multi-intent-u1-contracts-test-report.md](../../test-reports/2026-09-15-multi-intent-u1-contracts-test-report.md) |
+| 多意图 HITL U2 分段 | [../test-reports/2026-09-15-multi-intent-u2-segmenter-test-report.md](../../test-reports/2026-09-15-multi-intent-u2-segmenter-test-report.md) |
+| 多意图 HITL U3 PG | [../test-reports/2026-09-15-multi-intent-u3-intentflow-pg-test-report.md](../../test-reports/2026-09-15-multi-intent-u3-intentflow-pg-test-report.md) |
+| 多意图 HITL U4 投影 | [../test-reports/2026-09-16-multi-intent-u4-outbox-projection-test-report.md](../../test-reports/2026-09-16-multi-intent-u4-outbox-projection-test-report.md) |
+| 多意图 HITL U5 API | [../test-reports/2026-09-16-multi-intent-u5-decision-api-test-report.md](../../test-reports/2026-09-16-multi-intent-u5-decision-api-test-report.md) |
+| 多意图 HITL U6 Web | [../test-reports/2026-09-16-multi-intent-u6-web-cards-test-report.md](../../test-reports/2026-09-16-multi-intent-u6-web-cards-test-report.md) |
+| 多意图 HITL U8 generate | [../test-reports/2026-09-16-multi-intent-u8-task-generate-test-report.md](../../test-reports/2026-09-16-multi-intent-u8-task-generate-test-report.md) |
+| 多意图 HITL U7 只读 | [../test-reports/2026-09-16-multi-intent-u7-auto-read-test-report.md](../../test-reports/2026-09-16-multi-intent-u7-auto-read-test-report.md) |
+| 文档可靠性 M1 报告 | [../test-reports/2026-09-14-document-reliability-pilot-test-report.md](../../test-reports/2026-09-14-document-reliability-pilot-test-report.md) |
+| 文档可靠性 M1 活验 | [../test-reports/2026-09-14-document-reliability-pilot-live-test-report.md](../../test-reports/2026-09-14-document-reliability-pilot-live-test-report.md) |
+| 文档可靠性 M2 | [../test-reports/2026-09-14-document-reliability-m2-test-report.md](../../test-reports/2026-09-14-document-reliability-m2-test-report.md) |
+| 文档可靠性 M3 U8 | [../test-reports/2026-09-15-taskrun-runmanifest-u8-test-report.md](../../test-reports/2026-09-15-taskrun-runmanifest-u8-test-report.md) |
+| 文档可靠性 M3 U9 | [../test-reports/2026-09-15-dataset-lifecycle-u9-test-report.md](../../test-reports/2026-09-15-dataset-lifecycle-u9-test-report.md) |
+| 文档可靠性 M4 U10 | [../test-reports/2026-09-15-chatlog-contextasm-u10-test-report.md](../../test-reports/2026-09-15-chatlog-contextasm-u10-test-report.md) |
+| 文档可靠性 M5/M6 U11–U12 | [../test-reports/2026-09-15-app-composition-u11-u12-test-report.md](../../test-reports/2026-09-15-app-composition-u11-u12-test-report.md) |
+| Track E E2 闭包守卫 | [../test-reports/2026-09-15-event-e2-hook-guard-test-report.md](../../test-reports/2026-09-15-event-e2-hook-guard-test-report.md) |
+| Track E 复盘 | [./research/2026-09-15-track-e-retrospective.md](../../ops/research/2026-09-15-track-e-retrospective.md) |
+| 旁支清点收口 | [../test-reports/2026-09-15-leftover-branch-cleanup-test-report.md](../../test-reports/2026-09-15-leftover-branch-cleanup-test-report.md) · [二次收口](../../test-reports/2026-09-17-leftover-hygiene-test-report.md) |
+| SSE/幂等审计 | [../audit/2026-09-13-document-revision-sse-idempotency.md](../../audit/2026-09-13-document-revision-sse-idempotency.md) |
+| 质量门禁自污染审计 | [../audit/2026-09-13-document-revision-quality-gate-self-pollution.md](../../audit/2026-09-13-document-revision-quality-gate-self-pollution.md) |
+| 当前文档路由审计 | [../audit/2026-09-13-document-revision-active-doc-routing.md](../../audit/2026-09-13-document-revision-active-doc-routing.md) |
+| 行动表状态假阳性审计 | [../audit/2026-09-13-document-revision-quality-status-false-positive.md](../../audit/2026-09-13-document-revision-quality-status-false-positive.md) |
+| 待确认报告选择失败审计 | [../audit/2026-09-13-document-revision-pending-report-selection.md](../../audit/2026-09-13-document-revision-pending-report-selection.md) |
+| UI-05b 拒绝路由失败审计 | [../audit/2026-09-13-document-revision-e2e-reject-routing.md](../../audit/2026-09-13-document-revision-e2e-reject-routing.md) |
+| 职责伪造与 ETag 覆盖审计 | [../audit/2026-09-13-document-revision-duty-etag-overwrite.md](../../audit/2026-09-13-document-revision-duty-etag-overwrite.md) |
+| UI-06 块选择器失败审计 | [../audit/2026-09-13-document-revision-block-selector.md](../../audit/2026-09-13-document-revision-block-selector.md) |
+| UI-06 保存选择器失败审计 | [../audit/2026-09-13-document-revision-save-selector.md](../../audit/2026-09-13-document-revision-save-selector.md) |
+| UI-07 纯净阅读取样失败审计 | [../audit/2026-09-13-document-revision-overlay-selector.md](../../audit/2026-09-13-document-revision-overlay-selector.md) |
+| UI-07 transition 中间帧取样审计 | [../audit/2026-09-13-document-revision-overlay-transition.md](../../audit/2026-09-13-document-revision-overlay-transition.md) |
+| UI-11 第二份文档路由与 lease 审计 | [../audit/2026-09-13-document-revision-second-doc-routing-lease.md](../../audit/2026-09-13-document-revision-second-doc-routing-lease.md) |
+| UI-11 prelim_design 缺 output.md 审计 | [../audit/2026-09-13-document-revision-prelim-output.md](../../audit/2026-09-13-document-revision-prelim-output.md) |
+| UI-06 编辑弹窗 hydration 竞态审计 | [../audit/2026-09-13-document-revision-editor-hydration-race.md](../../audit/2026-09-13-document-revision-editor-hydration-race.md) |
+| UI-03 质量修复子工作区契约审计 | [../audit/2026-09-13-document-revision-quality-repair-workspace-contract.md](../../audit/2026-09-13-document-revision-quality-repair-workspace-contract.md) |
+| UI-11 快速完成观测误判审计 | [../audit/2026-09-13-document-revision-fast-completion-observation.md](../../audit/2026-09-13-document-revision-fast-completion-observation.md) |
+| UI-13a 私密分类导航失败审计 | [../audit/2026-09-13-document-revision-workflow-category-navigation.md](../../audit/2026-09-13-document-revision-workflow-category-navigation.md) |
+| UI-13a 职责单元格误判审计 | [../audit/2026-09-13-document-revision-duty-cell-assertion.md](../../audit/2026-09-13-document-revision-duty-cell-assertion.md) |
+| UI-13a reviewer 职责未同步审计 | [../audit/2026-09-13-document-revision-reviewer-duty-sync.md](../../audit/2026-09-13-document-revision-reviewer-duty-sync.md) |
+| UI-03 首次生成 PG ID 误删 baseline | [../audit/2026-09-13-document-revision-pg-id-remap.md](../../audit/2026-09-13-document-revision-pg-id-remap.md) |
+| UI-06 刷新后缓存竞争死锁审计 | [../audit/2026-09-14-document-revision-refresh-cache-race.md](../../audit/2026-09-14-document-revision-refresh-cache-race.md) |
+| 受控正文真实 UI 验收报告 | [../test-reports/2026-09-14-controlled-content-ui-acceptance.md](../../test-reports/2026-09-14-controlled-content-ui-acceptance.md) |
+
+## 并行集成补录
+
+来源：dev@a5ea469c 的 CURRENT 增量。保留材料切块任务的新结论；活跃 CURRENT 保留其认领和最新槽位。
+
+5. **材料切块不再看体积**：项目 6579 `doc_proj6579_bd_intake` 已确认候选 535，正式正文不再含「二进制压缩流」。成功解析的材料一律写入 `material_chunks`，≤60KB 仍全文注入。见 [报告](../../test-reports/2026-09-21-force-material-chunk-index-test-report.md)。已合入 `dev` 并从主目录 rebuild。test/main 未晋升。

.doc/archive/ops/2026-09-21-herdr-orchestration-v12.md

@@ -0,0 +1,46 @@
+---
+task_id: herdr-orchestration-v12
+status: done
+owner: Codex
+branch: feature/herdr-orchestration-v12
+base_dev_sha: d919e06a73f7a4e18ed9d0cc26728f9cb32f8d97
+policy_revision: agent-governance-2026-09-21-r1
+deployment: not_required
+remote_sync: not_requested
+integration_state: merged
+review_state: passed
+cleanup: pending
+cleanup_owner: independent-maintainer-after-owner-exit
+effective_commit: 8c5e3477585fe27a485343dac97a670d95cf8905
+---
+# Herdr v1.2 分工与自动审批
+
+授权：用户要求研究所给方案、纳入仅 Herdr 生效规范，并让已准备客户端自动通过工具请求。本轮修改规则与对应本地入口，提交/合入 dev；不改个人全局配置，不花费模型额度做探针，不操作产品/test/main，不 push。
+
+本会话 HERDR_ENV 检查失败；依 Herdr 技能不查看/操作现有会话。以本机帮助/非敏感模型别名、官方文档及真实临时 Git/SQLite 配合模拟 Herdr 边界验收，不能声称真实 pane 已启动。
+
+范围：AGENTS/PROJECT 条件入口、roster、两个启动/派发脚本及共享模块/测试。写入通过任务 path 租约；共享 CURRENT 用 CAS。保留其他任务与已存在 cleanup_pending。
+
+结论与验收见下文。交付后的原 task_id 继续用于 Kimi 总次数；不得以拆子任务重置预算。
+
+## 研究与验证结果
+
+总体采纳。修正 Cursor“无限量”前提、执行跟踪与代码实施边界、默认唯一实施与显式故障接管的矛盾；Kimi 应急/终稿共用上限，GPT 耗尽不以文稿审核代替代码安全终审；普通会话不套用本分工。
+
+本机配置只读核验：Claude Opus/Sonnet 别名为 glm-5.3[1m]，Haiku 为 glm-5.3-flash[1m]；Codex 默认 gpt-6-astra；PI 默认 minimax-cn/MiniMax-M3，模型目录可列出 qwen-token-plan-cn/qwen3.8-max、qwen3.8-flash 与 zai-coding-cn/glm-5.3。未读取或输出凭证；未修改这些全局设置；未实际调用远端模型。
+
+- 11 项专用行为测试 PASS（4.664s），包含九个 profile 的自动审批 flags、Herdr 外/错工作区拒绝、目标 pane 检查、报告路由、显式实施备援、不确定发送不重投、唯一重试标记、同角色歧义、Kimi 关停/跨入口计数/未知结果不退款；八进程竞争只有一次真实模拟发送。
+- [测试输出](../../test-reports/assets/2026-09-21-herdr-v12/focused-tests.txt)；[九种启动命令](../../test-reports/assets/2026-09-21-herdr-v12/launch-commands.json)。Git/SQLite 是真实临时仓库，Herdr transport 为 fake，绝不将其声明为实际 pane 启动/模型 E2E。
+- PI 安装版本 0.85.1 的本机 README 明确内置工具无权限弹窗，`--approve` 是项目文件信任；扩展仍可自建交互。Cursor force 保留显式 deny，Kimi 使用 auto 而非 yolo。其他本机帮助与[官方出处](../../ops/2026-09-13-herdr-agent-roster.md#5-自动通过请求与实际启动)相互核对。
+- 本地复核：路由/参数集中于一个 Python 模块，两个 shell 薄入口不复制策略；保留 task 与主仓 `.locks` 身份校验；Kimi 占用在投递前事务提交。没有后台队列/全账户计费控制，MiniMax/GPT 预算轮次由任务记录管理。
+- 代码不涉及产品 Go/前端/数据库业务；无需产品重建。提交后的候选将按工程测试全集验证，再受控合入 dev；真实 Herdr 会话核验留给下一次在 Herdr 内的实际任务，不在外部强行接入。
+
+## 收口
+
+实现提交 `8bc7940e`；生效 dev 候选 `8c5e3477585fe27a485343dac97a670d95cf8905`，其第一父节点 `d919e06a`，主目录持锁快进接收同一已验证节点。[候选完整输出](../../test-reports/assets/2026-09-21-herdr-v12/candidate-tests.txt)：87 tests PASS，36.216s，含原门禁与本轮 11 项测试。语法、diff 与本轮链接检查均通过。收口附加提交仅文档，按文档契约另验。
+
+运行边界：未启动真实 Herdr/pane/模型请求，未改全局配置、产品服务或数据库；deployment=not_required，无远端 push。不会把模拟 transport 的通过当作实际账户、余额或审批 UI 已消失的证明。
+
+清理：[进程可见性预检](../../test-reports/assets/2026-09-21-herdr-v12/cleanup-preflight.json)拒绝，部分同 UID cwd 不可读。保留 `.worktrees/herdr-orchestration-v12` 与 `.worktrees/integrate-herdr-orchestration-v12`；独立维护者在 owner 退出和进程可见性核实后重跑普通 remove/-d 的全部门禁，不强删，不接管其他任务。
+
+影响：Herdr roster、条件入口、规范登记、启动/派发脚本一致；不改变 FEATURE-MATRIX 的产品状态或治理完整自动化 partial，也不改变 gap-matrix。下一次实际 Herdr 任务先核验模型/自动审批启动状态，再按既有任务范围调度；Kimi 仅有必要时调用一次。

.doc/archive/ops/2026-09-21-intent-confirm-stage-aware.md

@@ -0,0 +1,41 @@
+---
+title: "意图确认优先与阶段感知消解"
+status: done
+created: 2026-09-21
+updated: 2026-09-21
+owner: Cursor
+branch: fix/intent-confirm-stage-aware-2026-09-21
+worktree: .worktrees/intent-confirm-stage-aware-2026-09-21
+base_dev_sha: 49fb68fec1ea56f00616c23d08efb15950c2300d
+mutex: intent+web+docgov
+---
+
+# 意图确认优先与阶段感知消解
+
+## 目标
+
+商务流初期「整理一下需求」等弱写表述 → 阶段感知消解为 intake，经确认卡片拍板后再执行；不强指令误伤。扩展已合入的工作流作用域修复。
+
+## 范围
+
+- 批次5 `feat(intent)`：弱写动词 + `stageAwareRequirementsTask` + `needs_confirmation`
+- 批次6 `feat(coordinator)`：智能确认门禁（PendingExpectation）
+- 批次7 `feat(web)`：阶段错误降级聊天一次
+- 批次8：验收报告 + 合回 `dev` + 真实 PI 抽样
+
+## 步骤
+
+1. [x] 批次5–7 实现与单元门禁
+2. [x] 批次8：合入 `dev@0c401904` + rebuild + 真实链路抽样（陈威项目 6579）
+
+## 验收标准
+
+- [x] V0.1「整理一下需求」→ 确认 →「好」→ intake（单元 + 真实 PI）
+- [x] 强指令不强制确认；「编写用户需求表」无 rdev 误拦
+- [x] 合入后真实 PI 抽样（见测试报告）
+
+## 相关链接
+
+- Plan: `~/.cursor/plans/意图确认优先与阶段感知_7ab2c4d5.plan.md`
+- Prior (done): `.doc/archive/ops/2026-09-21-intent-workflow-scoping.md`
+- Test report: `.doc/test-reports/2026-09-21-intent-confirm-stage-aware-test-report.md`

.doc/archive/ops/2026-09-21-intent-workflow-scoping.md

@@ -0,0 +1,70 @@
+---
+title: "意图填槽工作流作用域修复"
+status: done
+created: 2026-09-21
+updated: 2026-09-21
+owner: Cursor
+branch: fix/intent-workflow-scoping-2026-09-21
+worktree: "-"
+mutex: intent+web+docgov
+---
+
+# 意图填槽工作流作用域修复
+
+## 目标
+
+意图识别填槽（target_doc / target_task）只命中当前激活工作流的文档与任务；显式点名其他工作流的文档时拦截并引导切换工作流，不误触、不执行。
+
+## 背景
+
+用户反馈：填「要修改的文档」等槽位时可能命中其他工作流的文档。根因链（2026-09-21 调研）：
+
+1. `intent.ContextSnapshot` 无 workflow 字段，`ToSnapshot()` 丢弃 `Project.ActiveWorkflowKey`；server 默认上下文硬编码 `CurrentWorkflow: "intake"`
+2. `extractDocName` 词表全是 main（bd_）流文档名，无按流归属约束
+3. 消费端匹配池 `ListWorkflowDocumentsByProject` 仅按 project_id 过滤（跨工作流全量），`selectReadableWorkflowDocument` 双向 contains 模糊匹配取首个命中
+4. 前端 `resolveTaskTemplateForMessage` 匹配池 `currentProjectDeliverables` 仅按 projectId 过滤；`activeWorkflowKey` 只用于徽标展示
+
+## 范围
+
+- 批次1 `feat(intent)`：`ContextSnapshot` 增加 `ActiveWorkflowKey`；`ToSnapshot` 下传；docgov 命中他流文档名时打 `workflow_scope_mismatch` 标记不误填
+- 批次2 `feat(coordinator+server+projectinstance)`：`ActiveWorkflowTaskKeys` 辅助查询；文档匹配池收窄到激活流；`ErrDocWrongWorkflow` 拦截引导；TRIGGER_TASK 任务键归属校验；enrich 时注入真实 `active_workflow_key`
+- 批次3 `feat(web)`：`DeliverableItem.workflowKey`；文档列表 API 附带 `workflow_key` 与 `active_workflow_key`；templateMatch 匹配池按激活流过滤，他流点名返回 wrongWorkflow 提示
+- 批次4：真实环境验收 + 测试报告 + 合回 dev
+
+## 非目标
+
+- 不迁移 `document_records` 表（不加 workflow_instance_id 列）
+- 不改 `production_ready`、不晋升 test/main、不动项目 143
+- 不改 SWITCH_WORKFLOW 意图本身行为
+- UI 文档展示列表保持全量（仅匹配池收窄）
+
+## 渐进安全策略
+
+`active_workflow_key` 为空或查不到激活实例（存量单流项目、planning 态）→ 不过滤，保持现状行为。
+
+## 步骤
+
+1. [x] 批次1：intent 快照与工作流词表归属
+2. [x] 批次2：服务端匹配池收窄与拦截引导
+3. [x] 批次3：前端模板匹配池收窄
+4. [x] 批次4：真实环境验收、报告归档、合回 dev
+
+## 验收标准
+
+- [x] 激活 main 流说「查看调研报告」→ 命中 main 流文档（正例；修改/生成话术另记路由噪声）
+- [x] 激活 main 流说「编写项目建议书」（rdev 流文档）→ 拦截 + 引导切换（反例；tasks/run 409 ERR_DOC_WRONG_WORKFLOW）
+- [ ] 激活 rdev 流后同名操作 → 正常执行（切换后正例；本轮 SWITCH 落库未兑现，记 deferred）
+- [x] 存量无 active_workflow_key 项目 → 行为不变（回归）
+- [x] 相关包 `go vet` / scoped `go test -short`、`web: npm test && npm run build` 全绿
+
+## 相关链接
+
+- Plan: `~/.cursor/plans/意图填槽工作流作用域修复_dba2ab4c.plan.md`
+- Handoff:
+- Test report: `.doc/test-reports/2026-09-21-intent-workflow-scoping-test-report.md`
+
+## 证据 / 备注
+
+用户在 dev 商务对接实测发现跨工作流误命中。用户在方案确认时选定：严格拦截 + 引导切换；等四问题修复 mutex 释放后独立分支推进。
+
+- 2026-09-21 收口：已合入 `dev@e0665ca4`，验收报告见 `.doc/test-reports/2026-09-21-intent-workflow-scoping-test-report.md`。

.doc/archive/ops/2026-09-21-workflow-scope-weighting.md

@@ -0,0 +1,59 @@
+---
+title: "工作流作用域权重化"
+status: done
+created: 2026-09-21
+updated: 2026-09-21
+owner: Cursor
+branch: feature/workflow-scope-weighting-2026-09-21
+worktree: .worktrees/workflow-scope-weighting-2026-09-21
+base_dev_sha: 10aee3feb478c550adc9959f2d3a8d17cd5b48a0
+write_scope: [internal/workflowscope, internal/intent, internal/server, internal/coordinator, internal/config, internal/sysadmin, web/src, docker-compose.dev.yml, docker-compose.test.yml, docker-compose.main.yml, .env.example, .doc]
+head_sha: 7723a5515948788602b342cdda1137c90fee311b
+deployment: deployed
+cleanup: pending
+mutex: intent+web+docgov
+---
+
+# 工作流作用域权重化
+
+## 目标
+
+把「句子里出现他流文档短语就硬拦截」改为「匹配质量 × 工作流关系权重」裁决。激活流优先；只有他流精确命中明显压过激活流时才跨流。只读跨流在查看权限通过后放行并注明归属；写动作仍引导到项目设置切换（跨流写在现架构下不可执行）。`WORKFLOW_SCOPE_MODE` 默认 `strict`，保持现状。
+
+## 范围
+
+- 新建 `internal/workflowscope`（开关、关系权重、打分裁决）
+- 服务端文档读取、意图填槽、前端模板匹配改用同一裁决
+- compose / `.env.example` / sysadmin 登记开关
+- dev 真实环境验收与测试报告
+
+## 非目标
+
+- 不迁移 `document_records`，不加 `workflow_instance_id`
+- 不改工作流切换 / 激活接口
+- 不改 `production_ready`，不晋升 test/main，不动项目 143
+
+## 步骤
+
+1. [x] 打分内核与开关
+2. [x] 服务端只读跨流放行与查看权限
+3. [x] 意图填槽改打分
+4. [x] 前端模板匹配改打分
+5. [x] 开关声明、真实验收、报告、合回 dev
+
+## 验收标准
+
+- [x] strict 模式与现有跨流拦截断言一致
+- [x] weighted 下激活流精确名压过他流短语，不再误拦
+- [x] weighted 下只读精确点名他流文档可放行并注明归属；写动作仍拦截
+- [x] 无查看权限 / 实例已关闭时跨流只读拒绝
+- [x] 空激活键不过滤
+
+## 相关链接
+
+- Plan: `~/.cursor/plans/工作流作用域权重化_411b5e35.plan.md`
+- Test report: `.doc/test-reports/2026-09-21-workflow-scope-weighting-test-report.md`
+
+## 证据 / 备注
+
+查看权限：治理实例 `ViewableTaskKeys` 只含当前实例已启用文档。他流任务键不在快照内，不能把它当成「显式隐藏」。判定为：解析失败按 `failClosedAuthz` 拒绝；`ViewableTaskKeys` 为空（实例已关闭）拒绝；键落在当前实例但不可见则拒绝；键不属于当前实例、且调用方已能查看该实例文档时允许只读。

.doc/archive/ops/short-term/2026-09-17-engineering-dashboard.md

@@ -0,0 +1,59 @@
+---
+title: "个人工程中控台：实时项目看板与离线 HTML 快照"
+status: done
+created: 2026-09-17
+updated: 2026-09-17
+owner: Cursor-Auto
+branch: feature/engineering-dashboard
+worktree: .worktrees/feature-engineering-dashboard
+mutex: engineering-dashboard
+---
+
+# 个人工程中控台：实时项目看板与离线 HTML 快照
+
+## 目标
+
+实现一个独立于产品后台的本地只读中控台，以同一不可变快照驱动实时页面、机器可读 JSON 与单文件 HTML 导出。
+
+## 范围
+
+- 聚合 `.doc`、Git/worktree、Docker/Compose、`/ready` 和晋升凭证。
+- 展示架构、模块、功能、任务、分支、验证和环境实装证据。
+- 提供 Markdown 搜索、阅读、正反向链接和证据链导航。
+- 显示来源、新鲜度、degraded 与 drift，不把声明状态当作观测状态。
+
+## 非目标
+
+- 不接入产品后台、产品数据库或产品权限体系。
+- 不写文档，不操作 Git、Docker、部署或 Herdr。
+- 不隐式联网或执行 `git fetch`。
+
+## 步骤
+
+1. [x] U1：冻结快照、事实与四轴状态契约。
+2. [x] U2：实现文档图谱与领域解析器。
+3. [x] U3：实现 Git 与 worktree 采集。
+4. [x] U4：实现运行态与部署证据采集。
+5. [x] U5：实现对账、派生视图与新鲜度。
+6. [x] U6：实现本地服务、总览与文档导航。
+7. [x] U7：实现离线导出、脚本、浏览器验收和治理文档同步。
+
+## 验收标准
+
+- [x] 实时 HTML、离线 HTML 和 JSON 引用同一 `generation_id` 与 `revision_id`。
+- [x] 计划、实施、验证、实装四轴独立展示。
+- [x] rdev、dev ahead、main events 分叉三个真实样本按方案输出。
+- [x] 单源失败时页面仍可用，且显示 stale/error/last-success。
+- [x] 默认仅监听 loopback，无写操作、凭证暴露、路径越界和远程资源执行。
+- [x] 导出 HTML 离开仓库后仍可阅读 Markdown，且不嵌入 assets。
+
+## 相关链接
+
+- 设计与实施方案：[../../archive/design/2026-09-17-personal-engineering-control-center-plan.md](../../archive/design/2026-09-17-personal-engineering-control-center-plan.md)
+- Test report: [../../test-reports/2026-09-17-engineering-dashboard-test-report.md](../../test-reports/2026-09-17-engineering-dashboard-test-report.md)
+
+## 证据 / 备注
+
+- 实现提交序列见 `feature/engineering-dashboard`（U1→U7）。
+- 启动：`./scripts/engineering-dashboard.sh serve --repo . --addr 127.0.0.1:8787`
+- 导出：`./scripts/engineering-dashboard.sh export --repo . --output /tmp/engdash.html`

.doc/audit/2026-09-16-fav-u7-remaining-port.md

@@ -0,0 +1,24 @@
+---
+title: "FAV U7 incremental — remaining port inventory"
+status: open
+created: 2026-09-16
+updated: 2026-09-17
+---
+
+# FAV U7 增量：未移植清单
+
+相对 `feature/final-artifact-vault`，本切片 **未** 整支 merge，且因 `internal/artifactvault` 与当前 `dev`（dataset Candidate backfill）大面积 DIFF，下列能力仍待后续手工移植 + 审计：
+
+| 项 | 旁支路径 | 阻塞 |
+|----|----------|------|
+| EnumerateTerminals / LoadExclusions | `internal/artifactvault/enumerate.go` | 依赖 TerminalRow；与现 `Enumerate(Candidate)` 并存需设计 |
+| TerminalRow Backfill | FAV `backfill.go` | 现 backfill 已改为 dataset 路径 |
+| 完整 CLI | `cmd/artifact-vault` 全命令 | 本切片仅 status stub |
+| ingest hooks | `internal/server/vault.go` OnFinalArtifact* | 会写 staging；需与 publisher 门闩同批审批 |
+| schema JSON | `*.schema.json` | 可选文档资产 |
+| durable Register(fav) | `cmd/events` | events 硬门 + 单独 cutover 审批 |
+| live staging → artifact → publication | publisher Drain / ingest hooks | 每级观察窗 ≥7 天；本轮 **未** 放量 |
+
+**W6 已移植（仍非 live）**：`internal/app/fav.EventConsumer.ObserveShadow` 只计算 intended outcome（`WouldStage`/`WouldPublish` 恒 false）；`FAV_DEGRADED_READ` 为 true 时 shadow 直接拒绝；`HandleLease` 与 `Registry.Register(fav)` 仍 fail-closed。
+
+**红线保持**：`FAV_DEGRADED_READ=false`；fav consumer mode=off；禁止整支 merge。

.doc/audit/2026-09-17-adhoc-verification-script-empty-path-join.md

@@ -0,0 +1,45 @@
+---
+title: "临时验证脚本 Path 空字符串拼接导致跨任务取证串味"
+status: done
+created: 2026-09-17
+updated: 2026-09-17
+severity: low
+---
+
+# 临时验证脚本 Path 空字符串拼接导致跨任务取证串味
+
+## 现象
+
+S0.3 真 PI 打样归档时，`rd_design_input_spec-final.md` 一度被写成无关客户的商务对标报告（「掌上无线超声系统 × GE Vscan / Philips Lumify」），而非设计输入规格书终稿。
+
+## 根因分析
+
+产品侧小队/工作区创建正常：失败的 `rd_*` 请求因 main-completed 硬 precheck 拒绝，`task_runs.WorkspaceID` 如实为空。
+
+缺陷在**本地临时取证脚本**（`.doc/test-reports/assets/2026-09-17-rdev-template-depth/run_s0_*.py`）的兜底逻辑：
+
+1. `ws_id = pi_result.get("workspace_id") or ""` 在响应无该字段时得到空串；
+2. Python `pathlib`：`Path(bizdev_root) / ""` **坍缩为父目录本身**（无报错）；
+3. 随后 `root.rglob("output.md")` 扫遍共享 `data/dev/workspaces/bizdev/` 全树；
+4. 「取最长文本」启发式选中历史商务任务终稿并误归档。
+
+证据：会话内 `task_runs` 失败记录 `WorkspaceID=""`；`Path('/a/b') / '' == Path('/a/b')` 可复现；误归档文件内含 `adhoc_GEVsca_...` 工作区路径。
+
+## 严重度
+
+`low` — 仅本地取证脚本；未污染产品库、未改小队/黑板创建逻辑；同轮已用精确工作区路径重归档并随测试报告提交干净终稿。
+
+## 关联整改
+
+- 无需产品代码改动。
+- 经验红线：临时验证脚本禁止「空路径拼接 + 全树 `rglob` + 取最大值」组合；`work_dir`/`WorkspaceID` 为空时必须失败退出，不得扩大搜索范围。
+
+## 证据
+
+- 正确终稿：`.doc/test-reports/assets/2026-09-17-rdev-template-depth/rd_design_input_spec-final.md`
+- 测试报告：`.doc/test-reports/2026-09-17-rdev-template-depth-test-report.md`
+- 工作区 ID 生成：`internal/squad/workspace.go`（`ws_%s_%d` + UnixNano）
+
+## 开放问题
+
+- 无。

.doc/audit/2026-09-17-d7-data-inventory.md

@@ -0,0 +1,62 @@
+---
+title: "D7 对话数据分类盘点"
+status: done
+created: 2026-09-17
+updated: 2026-09-17
+severity: medium
+---
+
+# D7 对话数据分类盘点
+
+## 现象
+
+FEATURE-MATRIX「对话数据治理（D7）」为 `deferred`；ADR 数字 `pending-compliance-signoff`。W7 只盘点当前基线：会话正文、派生副本、共享 KB、日志、备份、事件敏感字段。本轮**未**按草案 365/180/30 天执行物理删除或备份清除。
+
+## 根因分析
+
+当前基线是「热库明文 + 软删除列预留 + 事件 ID 化」，不是已签字的留存作业。缺口是**尚未实现**的治理能力，不是已确认合规数字被违反。
+
+## 严重度
+
+`medium`（实现缺口；**不**升 gap-matrix blocker）
+
+## 分类盘点
+
+| 数据类 | 位置 | 形态 | 现状 |
+|--------|------|------|------|
+| 会话正文 | `chat_sessions` / `chat_messages.content` | 热库明文 TEXT；`deleted_at` 列存在 | dev 619 sessions / 3291 messages；`deleted_at` 全 NULL；Go 无 `SET deleted_at`、无 `DELETE FROM chat_*` |
+| 派生摘要 | `chat_daily_digests` | headline / key_points JSON | 0 行 |
+| 向量记忆 | `context_memory_chunks` | `content` TEXT + embedding | 102 行：`project_doc` 71、`chat_history` 24、`approved_case` 7。聊天派生副本会随正文留存 |
+| 私密文档 | `freeform_documents` | `is_deleted` / `deleted_at` + version markdown | 122 份，其中 113 已软删（聊天消息无对等写路径） |
+| 共享 KB | `shuimu-kb-shared` / `regulations` | 法规 chunks，无 chat 表 | `reg_documents` 2907、`reg_chunks` 312919；与对话库隔离 |
+| 事件 envelope | `event_envelopes.payload` BYTEA | JSON 字段 | 4 条；keys 均为 ID/digest/`summary_ref`，`has_content=false` |
+| 事件 DLQ / attempts | `event_dead_letters` / `event_delivery_attempts` | ID + reason / error_code | DLQ 0；attempts 4；无正文列 |
+| 日志 | Docker `json-file` 无 max-size | 应用 slog | 抽检 rebuild 日志：DSN 已 `***`，无 chat content |
+| 备份 | `scripts/backup-system-db.sh` `pg_dump -Fc` | 整库含 chat 明文 | 宿主机无 `./backups` 目录；CI 有 backup-restore-drill |
+| Agent workspace | `data/dev/workspaces` 150M | 非终态工作区 | 无 30 天清理作业（ADR 草案待签字） |
+| FAV | `final_artifacts` | 1 行；consumer mode=off | 与聊天口径解耦；W6 shadow 不写 |
+
+事件 payload 比 `StaticContracts` allowlist **多出** `workspace_id` / `manifest_sha256` 等 ID 字段，但仍无聊天正文。属契约收紧 follow-up，不是 Track E 正文泄漏。
+
+## 违规判定
+
+对照已签字约束（Track E ID-only 日志/DLQ、R13 出站最小化、ADR 明确「签字前禁止按数字删除」）：
+
+- **未发现**已确认安全/合规基线被当前实现违反。
+- **因此不写** `gap-matrix` blocker。
+- 缺 365 天热库清理、缺聊天 soft-delete 写路径、缺字段级加密，均属 ADR 签字后的 W7 整改实现，不得在本轮当「已违规」执行删除。
+
+## 关联整改
+
+- ADR 草案: [../adr/2026-09-17-d7-chat-data-retention.md](../adr/2026-09-17-d7-chat-data-retention.md)
+- 签字后整改：soft-delete 写路径 → 观察窗 → 物理清理；同步清 `context_memory_chunks` 的 `chat_history`；备份二次批准 + delete manifest（R22）
+
+## 证据
+
+`.doc/test-reports/assets/2026-09-17-w7-d7-inventory/`（counts / columns / event keys / KB / logs / health）。查询只读，未 `DELETE`/`UPDATE`。
+
+## 开放问题
+
+- 合规何时签字或改数（365/180/30）？
+- 聊天 UI 删除是否要与 freeform 回收站对齐？
+- `taskrun.completed` payload 额外 ID 字段是否收紧 allowlist？

.doc/audit/2026-09-17-docgov-modification-proposal-http-gap.md

@@ -0,0 +1,32 @@
+---
+title: "docgov 变更提案缺少 HTTP 路由"
+status: resolved
+created: 2026-09-17
+updated: 2026-09-17
+severity: medium
+---
+
+# docgov 变更提案缺少 HTTP 路由
+
+## 现象
+
+引擎侧存在 `docgov.ProposeModification` / `DecideModificationProposal`，但服务端此前仅注册 `POST /api/v1/docgov/proposal/decide`；前端 `App.tsx`「变更方案提议」（`pendingProposal`）为本地模拟。
+
+## 根因分析
+
+生命周期三接口与 claim 已注册；变更提案 **propose** 路径从未暴露为 HTTP。
+
+## 严重度
+
+`medium` — 不阻塞编制→审核→批准主链；阻塞「认领后小队修改须提案确认」的真实治理。
+
+## 处置（resolved）
+
+- 新增 `POST /api/v1/docgov/proposal` → `ProposeModification`
+- 前端 `proposeModification` / `decideModificationProposal` + App 接线
+- 单测：`TestServer_DocGovProposeAndDecideHTTP`、`web/src/api/docgov.test.ts`
+- 任务：`.doc/ops/short-term/2026-09-17-docgov-modification-proposal-http.md`
+
+## 证据
+
+- 合入后真实 HTTP 证据见 `.doc/test-reports/assets/2026-09-17-docgov-modification-proposal-http/`

.doc/audit/2026-09-17-docgov-optional-duty-null-fk.md

@@ -0,0 +1,54 @@
+---
+title: "可选职责空审核人 CreateOrGetDocument 写 reviewer_id=0 触发 FK"
+status: done
+created: 2026-09-17
+updated: 2026-09-17
+severity: high
+---
+
+# 可选职责空审核人 CreateOrGetDocument 写 reviewer_id=0 触发 FK
+
+## 现象
+
+dev 项目「内廷元无创神经刺激器」(6417) 发起 `intake` 任务后 UI 显示：
+
+- `code: INTERNAL_ERROR`
+- `userMessage: 系统内部错误，请重新开始会话`
+- `requestId: run_1789622069585300787`
+- `sessionId: sess-p6417-u9`
+
+浏览器偶发 `flushSync was called from inside a lifecycle method`（错误态重渲染副作用，非根因）。
+
+## 根因分析
+
+1. app-dev 日志：`persist document ledger: ... document_records_reviewer_id_fkey (SQLSTATE 23503)`
+2. 项目成员仅 `document_duty=author`（user 9），无 reviewer/approver
+3. `resolveTaskDocumentDuties` 合法返回 `ReviewerID=0`
+4. [`internal/docgov/engine.go`](../../internal/docgov/engine.go) `CreateOrGetDocument` 把 `0` 写入可空 FK，PG 拒绝（无 `users.id=0`）
+5. `ClassifyError` 默认分支掩盖为 `INTERNAL_ERROR`
+
+对照：[`internal/docduty/store.go`](../../internal/docduty/store.go) heal 路径已有 `nullIfZero`，**创建路径漏改**。
+
+复现：`INSERT ... reviewer_id=0` → 同 FK 错误。近 7 天同因至少 3 次（6417/6359/6274）。
+
+## 严重度
+
+`high`（任何无 reviewer 职责的项目首次落文档账本均会失败；可扩散至 test/main）
+
+## 关联整改
+
+- Short-term: [../archive/ops/2026-09-17-docgov-optional-duty-null-fk.md](../archive/ops/2026-09-17-docgov-optional-duty-null-fk.md)
+- Fix branch: `fix/docgov-optional-duty-null-fk`
+- Test report: [../test-reports/2026-09-17-docgov-optional-duty-null-fk-test-report.md](../test-reports/2026-09-17-docgov-optional-duty-null-fk-test-report.md)
+
+## 证据
+
+- `docker logs shuimu-agent-app-dev` @ `2026-09-17T05:14:29Z` run_1789622069585300787
+- `task_runs.error_message` 与上述一致；`document_records` 对 project 6417 为 0 行
+- 手工 `INSERT reviewer_id=0` → `Key (reviewer_id)=(0) is not present in table "users"`
+
+## 后续
+
+- 创建路径 0→NULL；ClassifyError 增加 `DOC_LEDGER_ERROR`
+- 不强制配置 reviewer（保持可选职责语义）
+- flushSync 另开任务

.doc/audit/2026-09-17-document-author-only-analysis.md

@@ -0,0 +1,45 @@
+---
+title: 文档编制人兼任模式源码核查
+status: done
+created: 2026-09-17
+updated: 2026-09-17
+severity: medium
+---
+
+# 文档编制人兼任模式源码核查
+
+## 结论
+
+当前 dev 基线 adb48c8 不支持本需求。已有标准三人审批、可选免审批、系统设置白名单可复用，但必须补齐逐文档模式、职责来源和前端多职责。
+
+## 根因与证据
+
+1. `internal/projectinstance/duty_mode.go`：partial 拒绝，full 要求三人分离。
+2. `internal/projectinstance/service.go`：创建者规划权限与激活后冻结已存在。新需求需在这条链上增加总授权，不能只改 UI。
+3. `internal/docduty/store.go`：HealProjectDocuments 按项目默认职责回填受控文档。`internal/docgov/project_docs.go` 在列表读取时调用；`internal/bizdev/service.go` 在生成后调用。新增逐文档策略必须阻止该链覆盖实例职责。
+4. `web/src/lib/currentDocRole.ts` 优先返回 author；`docGovActionVisibility.ts` 按单角色显示动作。同人三职会缺审核和批准入口。
+5. `internal/server/handlers.go` 三个动作端点固定使用相应 action role，并以登录身份调用引擎；`internal/docgov/state_machine.go` 可复用逐步流转。
+6. `internal/sysadmin/settings.go` 有白名单 bool 设置，但没有本需求 key；存储只保留最后修改人时间，新策略需独立版本与审计。
+
+以上为静态源码核查，未查询真实用户数据，未执行功能测试，未声称线上已复现或已修复。完整源码映射与实施单元见方案。
+
+## 关联方案
+
+[文档编制人兼任审核批准](../remediation/2026-09-17-document-author-only-plan.md)
+
+## 文档检查
+
+已检查两级权限、逐文档独立性、full/none 兼容、前后端职责来源、状态与锁、并发授权撤销、成员退出、迁移及回滚。修正一处 docflow 路径为 internal/app/docflow。方案明确区分已知事实与建议口径。
+
+ce-doc-review 未运行：当前工具目录未提供可调用的 skill invocation 入口；按 ce-plan 的 skill_unreachable 分支记录，不能把本地自检当作独立文档审查通过。
+
+```yaml
+fixes_applied: 0
+proposed_fixes_count: 0
+decisions_count: 0
+fyi_count: 0
+skipped_reason: skill_unreachable
+skipped_detail: No callable skill invocation interface in this session; local source and consistency checks only.
+```
+
+上方计数仅为未运行技能的占位，不代表产品决策已解决。开放问题仍为 R9、R10；用户未答复时保持方案建议，业务实现不得自行视为授权。

.doc/audit/2026-09-17-initial-load-performance-audit.md

@@ -0,0 +1,117 @@
+---
+title: "首次加载慢：静态资源、字体与初始化请求诊断"
+status: done
+created: 2026-09-17
+updated: 2026-09-17
+severity: high
+---
+
+# 首次加载性能诊断
+
+## 结论与适用范围
+
+当前已复现的主要问题在浏览器加载入口：登录页也下载约 2.82 MB 未压缩 JavaScript；外部 Google Fonts CSS 阻塞页面加载；若用户访问 Vite 3100，首访进一步扩大为 207 个资源请求、12.24 MB。冷缓存与热缓存差异很大，与“尤其第一次慢”一致。
+
+登录后还有已确认的请求放大和后端重复工作，但没有登录态浏览器瀑布图或 SQL 耗时，不能声称已量化其贡献。用户已确认 3100/8080/8081，系统重启后第一次访问约十数秒；设备、网络与“系统重启”包含宿主机还是仅应用尚未确认；本次未复现用户原始环境的完整等待时间。
+
+- 主仓读取时 `feature/rdev-core@52f0fbc`；其他 Agent 正在工作，未切换其分支。
+- 文档独立 worktree 基线为 `dev@d0ef696`。创建前已 fetch；本地 dev 有未推送提交，未 reset/覆盖。
+- 实测现有 8080/8081/8000 构建入口与 3100 Vite；以资源 hash 为运行产物标识，**没有证据证明容器恰好等于上述源码 commit**。
+- “首次”定义为新浏览器 context、空 HTTP 缓存；没有重启服务、清空 DB 缓存或重启 Vite，故不是服务/依赖预构建冷启动。
+- 未登录、没有调用对话/文档写接口；浏览器探针未使用真实用户会话。
+
+## 实测基线
+
+工具：隔离 Playwright v1.63.0 Docker 浏览器，host 网络访问既有服务。宿主浏览器缺 libatk，改用本机已有浏览器镜像；未修改应用容器。每个场景一个样本，仅诊断，不是 p95 或交付验收。
+
+| 场景 | 登录输入框可见 | FCP | 资源数 | transferSize 合计 |
+|---|---:|---:|---:|---:|
+| 8080 本机冷缓存 | 662 ms | 664 ms | 4 | 2,857,761 B |
+| 同 context 再次导航 | 62 ms | 60 ms | 5 | 353 B |
+| 8080 CDP 10 Mbps / 80 ms 冷缓存 | 2,636 ms | 2,636 ms | 4 | 2,857,761 B |
+| 同 context 再次导航 | 60 ms | 60 ms | 5 | 353 B |
+| 8080 CDP 2 Mbps / 80 ms 冷缓存 | 11,776 ms | 11,776 ms | 4 | 2,857,761 B |
+| 3100 本机冷缓存 | 659 ms | 652 ms | 207 | 12,238,086 B |
+| 3100 同 context 再次导航 | 162 ms | 160 ms | 208 | 52,253 B |
+
+transferSize 是浏览器 Resource Timing 可观测资源求和，不含顶层 HTML，不等于全链路抓包流量。输入框可见按导航命令开始至 selector 可见计时，FCP 来自页面 Performance API，两者采样时钟和帧提交不同。CDP 限速为模拟设置，不能代替真实公网 RTT；本机 document TTFB 仍约 1–3 ms。首次/再次均保持已有服务运行，未运行 Vite 冷预构建基准。
+
+### F1. 入口包过大且未按需加载（高置信）
+
+- `web/src/main.tsx:2` 静态导入 App；`web/src/App.tsx:98,103,108,145-146` 静态导入导出、系统管理、文件预览等模块；未登录判断直到 `App.tsx:3461`，无法避免入口依赖下载和求值。
+- `web/src/features/replyExport/download.ts:1` → docx；`web/src/engine/docxRenderer.ts:19-22` → docx、KaTeX、Mermaid；`web/src/engine/xlsxRenderer.ts:1` → XLSX。
+- `web/src/components/doc/preview/FilePreviewPanel.tsx:19-24` 全部静态导入预览器；DocxViewer、ExcelViewer 各自静态导入重依赖。
+- 浏览器访问登录页即可观测大 JS。3100 瀑布中含 katex.js 485,944 B、xlsx.js 870,702 B（decodedBodySize）。并非仅仅源码中出现依赖但构建已经排除。
+- 8080 主 JS `/assets/index-BLnmtk_3.js` = **2,820,055 B**；8081 = 2,805,141 B；8000 = 2,798,137 B。
+
+因果链：空缓存 → 登录视图与全部工具共入口 → 下载/解析无关依赖 → 网络较慢时登录表单迟迟出现。10 Mbps 下主 JS 下载约 2,373 ms；2 Mbps 首屏约 11.78 秒。没有采集 CPU trace，不能进一步把时间分解成具体库的执行成本。
+
+### F2. 静态响应无压缩、无明确长缓存策略（高置信）
+
+- 三个构建入口均携带 `Accept-Encoding: gzip, br` 请求主 JS，响应没有 `Content-Encoding`，`Content-Length` 为原始字节数。
+- `internal/server/server.go:344-384` 使用 `http.ServeFile`，没有静态压缩协商或显式 Cache-Control。
+- 同一 8080 JS 离线 gzip 后 **796,146 B**，相对原始包减少约 **71.8%**。这是体积估算，不是已部署优化结果，也不是端到端提速承诺。
+- 资源有 Last-Modified，没有显式 Cache-Control/ETag。本次再次导航已命中浏览器缓存；**不能写成“完全没有缓存”**。问题是版本化资源缺少可预测的长期缓存契约。
+
+源站是上述行为，未知用户实际入口是否另有反向代理压缩。优先在真正提供构建资源的层验证和修复。
+
+### F3. 外部字体 CSS 可放大首次白屏（高置信机制，用户网络贡献待测）
+
+- `web/index.html:9-15` 的 Google Fonts 是 head 中普通 stylesheet。`display=swap` 控制字体显示，不会让外链 CSS 本身变为非阻塞。
+- 本机自然请求字体 CSS 耗时 **508 ms**，DOMContentLoaded 609 ms，登录可见 662 ms。
+- 浏览器拦截并立即失败字体 CSS：登录可见 **210 ms**。Playwright route 会禁用 HTTP cache，因此这个场景不能用于热缓存收益对比，也不能据单样本得出精确净收益。
+- 控制实验仅让字体 CSS 等待 5 秒再失败，其余请求正常：DOMContentLoaded **5,111 ms**、登录可见 **5,161 ms**。证明该依赖可以把外部等待传到登录首屏，**不表示自然字体请求真的用了 5 秒**。
+
+### F4. 登录后项目成员扇出并放大会话同步（源码已证实，耗时待测）
+
+`web/src/App.tsx:524-540` 获取项目后，对每个项目调用成员接口；`:383-387` 每次成员结果用 map 生成新的 projects 数组；`:560-590` 的会话列表 effect 依赖 projects，因此成员返回可重复触发会话列表请求。取消标志仅忽略部分返回，没有 AbortController 终止已发请求。React 批处理可能合并更新，**不能写成固定 N 次会话请求**。
+
+项目数 N 增大时，初始成员请求为 N，叠加会话重取、setProjects 及本地持久化。`web/src/data/storage.ts:63` JSON.stringify + localStorage.setItem，`App.tsx:343` 随 projects 更新保存。持久化是否成为长任务还须 profile，不能预设为主要根因。
+
+### F5. 认证有重复查询和同 session 写放大（源码已证实，耗时待测）
+
+`internal/server/auth_middleware.go:48,62` 已认证并保存 principal；`internal/server/auth_handlers.go:126-139` 的 me 再认证。每次经 `internal/auth/service.go:197-203`、`internal/auth/pg_store.go:335-367` 执行 SELECT session、SELECT status、UPDATE session、GetUserByID。正常 PG me 路径共 8 次认证 DB 操作，加一次权限查询。
+
+其他鉴权请求也无条件 UPDATE 同一 auth_sessions 行；首屏并发可能放大行锁/连接等待。未采集 pg_stat_activity/锁等待或接口 p95，锁竞争是待验证风险。
+
+### F6. 文档列表的隐含写修复与轮询叠加（源码已证实，耗时待测）
+
+`internal/docgov/project_docs.go:59-74` 列表先调用 `HealProjectDocuments`；`internal/docduty/store.go:173-205` 开事务并取得项目 advisory lock（`internal/docduty/revoke.go:111-126`），重复读取创建者/成员，扫描文档，按需逐条 UPDATE，commit 后才正式 SELECT。
+
+前端 `App.tsx:1507-1545` 每 5 秒为租约同步调用这个完整列表。请求时长超过间隔时可能重叠；相同项目多个标签放大成本。**不能直接删除 heal**：须先补齐创建/成员变更/转交/撤销写路径与历史数据修复闭环。本轮没有用该 GET 做只读探针。
+
+### F7. 会话列表先聚合消息再分页（源码已证实，耗时待测）
+
+`internal/ctxmgr/chat_history.go:110-125` 候选会话 JOIN 消息、COUNT、GROUP BY/ORDER BY 后 LIMIT，另取最新消息内容。仅返回少量会话不代表少量消息扫描。`internal/projectworkflow/store.go:171-240` 项目列表也无分页。
+
+已有 `chat_messages(session_id, created_at)` 索引（`deploy/postgres/goose/00001_baseline.sql:119`）；不笼统认定缺索引。先 EXPLAIN/数据量和可见性分析，再决定先分页后统计、索引或摘要。
+
+### F8. 重启场景补查（用户补充后）
+
+用户明确 3100、8080、8081 在系统重启后首次进入约十数秒。三种冷态须分开：浏览器 HTTP 缓存、Vite 转换/依赖缓存、Go/DB/代理启动就绪。重启若不改变构建 hash，并不会自动清掉浏览器持久 HTTP 缓存；不能直接用新 context 测量解释全部重启现象。
+
+现存容器启动记录：dev StartedAt `2026-09-17T07:00:38.127811581Z`，打印“监听地址”于 `07:00:38.293728694Z`（约 **166 ms**）；test StartedAt `06:20:05.243037366Z`，打印监听于 `06:20:05.384607542Z`（约 **142 ms**）。这是已有 DB 就绪条件下的一次启动、且日志先于真正 ListenAndServe，**不是 host reboot→ready 时间**；但未支持“Go 每次初始化必然十几秒”。
+
+`cmd/server/main.go:41-50` 的初始化在监听前，`internal/bizdev/service.go:69-114` 包括 DB Ping/迁移/成员补齐/seed；DB连接段 timeout 5 秒，后续 seed 使用 Background，缺少分阶段耗时。`internal/app/app.go:355` 的 Runtime.Start 幂等，入口重复调用不会重复启动 worker，不能据此误判双倍启动。
+
+Compose app healthcheck 每 10 秒、start_period 20 秒；start_period 是失败宽限窗口，**不代表强制等待20秒**。若代理/运维脚本等健康状态才放流，则探测周期可能影响可见就绪，需要对齐宿主启动、DB healthy、app listen、ready、首次请求时间。3100 的无缓存 Vite 预构建/按请求转换为独立候选，8080/8081 构建产物不存在 Vite 首次编译。
+
+隔离 Vite 在 3199 使用独立空 cacheDir，同源码、未重启宿主/DB：监听准备 43 ms，首访登录可见 **1,580 ms**、207 资源/14,445,631 B，再次 171 ms。服务先启动、浏览器随后连接，部分预构建可能已在导航前完成；该值不是“启动到首屏”总时间。支持开发冷态有额外成本，但本机未复现自然网络十数秒；不得仅靠 warmup 宣称已解决 8080/8081。证据见 `../test-reports/assets/2026-09-17-initial-load-performance/vite-cold.json`。
+
+本轮不重启正在使用的共享服务；U1/U7 纳入计划中的隔离重启矩阵和阶段计时。没有把服务冷启动排除在用户需求之外。
+
+## 已排除与未证明
+
+- 本机静态 HTML TTFB 约 1–3 ms；这组未登录测试并非后端生成首页耗时数秒。
+- 没有请求产品 PI Runner，因此本次首屏慢不能归因于大模型冷启动。
+- 服务监听前迁移/种子初始化（`cmd/server/main.go:41-50,84-85`；`internal/bizdev/service.go:69-114`）只解释重启就绪，不等于每个新浏览器首访。
+- 没有用户重启时的 FRP/公网瀑布、登录后基线、慢 CPU profile、数据库 EXPLAIN；不对这些项宣称已复现。
+- 基线现有测试以功能为主；本轮未发现首屏资源预算/冷缓存性能门禁。未运行业务测试，因为没有业务代码变更。
+
+## 关联整改与证据
+
+- [改进方案](../remediation/2026-09-17-initial-load-performance-plan.md)
+- [诊断测量报告](../test-reports/2026-09-17-initial-load-performance-baseline.md)
+- [完整浏览器数据](../test-reports/assets/2026-09-17-initial-load-performance/browser.json)
+- [受控实验](../test-reports/assets/2026-09-17-initial-load-performance/controlled.json)
+- [静态响应摘要](../test-reports/assets/2026-09-17-initial-load-performance/assets.json)

.doc/audit/2026-09-17-system-health-check.md

@@ -0,0 +1,180 @@
+---
+title: "系统全面体检：任务收口、缺陷与未启用功能审计"
+status: done
+created: 2026-09-17
+updated: 2026-09-17
+severity: high
+---
+
+# 系统全面体检（2026-09-17）
+
+> 范围：① 规划未实现 / 需变更 / 实施中任务；② 现存与潜在 bug；③ 已实现但未启用或未测试的功能。
+> 方法：文档 SSOT 盘点（CURRENT / FEATURE-MATRIX / gap-matrix / short-term / long-term / backlog / ADR / handoff）+ Go 全量 vet/build/test + 前端 test/build + 特性开关与环境配置交叉核对。只读审计，未实施任何修改。
+> 基线验证：`go vet ./...` 与 `go build ./...` 全绿；`go test -short -count=1 ./...` 62 包全 ok；`web` npm test（380+32）与 build 通过。
+
+---
+
+## 一、任务状态盘点
+
+### 1.1 实施中（in_progress）
+
+| # | 任务 | 位置 | 剩余工作 |
+|---|------|------|----------|
+| T1 | partial/deferred 全量收口总控 | `.doc/ops/short-term/2026-09-16-partial-deferred-completion.md`（owner Cline） | W5（SWBOOT-10 真实现 + 真实 PI + UI 二次验收）、W6（FAV shadow→live 放量）、W7（D7 按 ADR 整改，待合规签字）、逐行升 done |
+| T2 | Control Center 个人中控台 | 2026-09-19 已移出本仓库 | 进度管理改由独立项目承担；本仓库不再保留该模块 |
+| T3 | 纯软件项目自举 W5b | `.doc/ops/long-term/2026-09-14-software-project-bootstrap-implementation.md` | SWBOOT-10 受控执行器（真 patch/merge）未启动，需独立安全评审，当前 fail-closed stub |
+
+### 1.2 已规划未开始
+
+| # | 任务 | 位置 |
+|---|------|------|
+| T4 | 首次加载性能 U1/U3–U7 | `.doc/remediation/2026-09-17-initial-load-performance-plan.md`（仅 U2 done：主 JS 传输 2.82 MB→~624 KB） |
+| T5 | 选择性模块解耦 M4–M6 | `.doc/ops/long-term/2026-09-14-selective-module-decoupling.md`（planned，owner=TBD） |
+| T6 | 产品 backlog：B5 报价复核、A5/A6 小队降级与 trace、A7 中文注释迁移、D5 KB 按环境隔离评估 | `.doc/backlog/chat-agent-p6-backlog.md`（均无任务文件） |
+| T7 | `TestReconcile_LegacyRepair_PG` 工程测试债 | gap-matrix DOC-CONTENT-CANONICAL-HASH-DRIFT 行（需隔离 PG，本机无） |
+| T8 | IAM 收尾开放项：410 退役产品拍板、R13 全量清单勾选 | handoff `2026-09-16-phase3-leftover-closeout.md` |
+
+### 1.3 部分完成（partial，剩余关闭条件）
+
+| 行 | 剩余关闭条件 |
+|----|--------------|
+| 纯软件项目自举 | SWBOOT-10 非 stub（W5b）+ 真实 PI 全链路 + UI 二次验收 |
+| FAV | W6 shadow 已合；live 未放量（staging→artifact→publication 各 ≥7 天观察窗） |
+| Control Center | 2026-09-19 已移出本仓库，不再作为本仓库关闭条件 |
+| 首次加载性能 | U1/U3–U7 |
+| 文档可靠性试点 | M1 结论「停止扩面」；M2（U5–U12）明确禁止开工，真实 PI/浏览器验收未勾 |
+
+### 1.4 deferred 待决策
+
+- **D7 对话数据治理**：ADR `2026-09-17-d7-chat-data-retention.md` 仍 `pending-compliance-signoff`；W7 盘点未发现违规；签字前禁止物理删除。
+- **`SEMANTIC_SUMMARY_REPLACE`**：决策默认不启用；启用须另开授权 + fail-closed 灰度。
+- **`MULTI_INTENT_PLAN_TIER` 升 confirm**：W4 证据闭环，升级需独立授权；永不默认 full。
+
+### 1.5 文档漂移 / 矛盾（文档债）
+
+| # | 漂移 | 涉及文件 |
+|---|------|----------|
+| D-1 | PU8 四份契约文件仍 `status: in_progress`，但 U9–U12 已升 done、报告已归档 | `.doc/ops/long-term/2026-09-16-pu8-u9/u10/u11/u12-*.md` |
+| D-2 | ADR modular-monolith-decoupling 仍「提议，等待用户确认」，但 Phase 1/2 已落地并被当作已确认结论引用 | `.doc/adr/2026-09-14-modular-monolith-decoupling.md` |
+| D-3 | audit/INDEX.md 与 remediation/INDEX.md 末行称首次加载性能「方案未实施」，与 U2 已验收矛盾 | 两个 INDEX.md（**本审计已顺手修正为准确表述**） |
+| D-4 | handoff `2026-09-15-conversation-intent-dual-tab.md` 的「未完成」已被后续 PASS 覆盖但未回标 | 该 handoff |
+| D-5 | backlog D3/D7 条目与 W2 done、W7/ADR 草案并存，backlog 未同步 | `.doc/backlog/chat-agent-p6-backlog.md` |
+| D-6 | PROJECT.md §9「剩余 blocker」表述与 gap-matrix「门禁已签、production_ready=yes」口径冲突 | `PROJECT.md` |
+
+---
+
+## 二、Bug 清单
+
+### 2.1 确认 bug（有明确证据）
+
+**后端**
+
+| ID | 描述 | 证据 | 严重度 |
+|----|------|------|--------|
+| B-1 | **SSE 聊天流被全局 WriteTimeout=120s 强杀**：`server.go:350` 的 WriteTimeout 是绝对期限；`handleChatStream`（`sse.go:129`）从不调用 `extendSSEWriteDeadline`、无心跳，该机制只接到了 run-events 订阅端点。任何 >120s 的聊天回合（长 PI 推演常见）必断流 | `internal/server/server.go:350`、`internal/server/sse.go:46-64,129` | high |
+| B-2 | **`POST /tasks/run/stream` 同样无 deadline 延长/心跳**，且断线后无法续订：`sse.go:390` 写死 `Subscribe(created.RunID, 0)`，不接受 `after_seq` | `internal/server/sse.go:305-424,390` | high |
+| B-3 | `handleRunTaskStream` **静默吞 JSON 解析错误**：`_ = json.NewDecoder(r.Body).Decode(&req)`，畸形 body 以空请求走默认 `TaskKey="intake"`，可能误启动 intake 任务 | `internal/server/sse.go:315,362-364` | medium |
+| B-4 | `handleRunTaskStream` **Flush 200 SSE 头之后才做会失败的操作**（CreateAndStart/Subscribe），失败时往 SSE 流里写 JSON 错误体；同文件 chat 路径明确「授权必须在 Flush 前」，task 路径未对齐 | `internal/server/sse.go:355-360,383-393` | medium |
+
+**前端**
+
+| ID | 描述 | 证据 | 严重度 |
+|----|------|------|--------|
+| B-5 | **会话窗口缓存 key 不一致**：读/初次写带 `userId` 前缀，但 `loadOlder`/`loadFullDay`/`jumpToDate`/`loadDayForAnchor`/`appendLiveMessage` 等 7 处后续写入不带前缀 → 刷新/切会话恢复到旧窗口；且 LRU 驱逐只用无前缀 key，带前缀缓存永不驱逐，localStorage 只增不减 | `web/src/hooks/useChatWindow.ts:84,100,136,235,271,315,365,416,439,471`、`web/src/data/storage.ts:164-176` | high |
+| B-6 | **mount 时 IndexedDB 恢复用陈旧快照整体覆盖 deliverables**：捕获 mount 闭包、非函数式 set，resolve 前新增的 deliverable 被静默丢弃（旁边已有 `deliverablesRef` 未用） | `web/src/App.tsx:326-336` | medium |
+| B-7 | `useTaskRunStream` 返回**伪 ref**（每渲染新建对象、快照值非 live），且全仓库无消费方——误导性 API | `web/src/hooks/useTaskRunStream.ts:96` | low |
+
+### 2.2 高风险隐患
+
+| ID | 描述 | 证据 |
+|----|------|------|
+| R-1 | **聊天会话无归属校验**：`getOrCreateSession` 仅凭客户端传入 `session_id` 返回既有内存会话，随后直接覆盖 `sess.UserID`；非项目会话（ProjectID==0）无任何授权关卡，内存 Messages/Facts 可进入他人 Prompt 与 SSE。缓解：session ID 为纳秒时间戳不易猜 | `internal/server/server.go:394-415`、`handlers.go:181`、`sse.go:187`、`stage_access_helpers.go:251-253` |
+| R-2 | **18 个非测试文件 `rows.Next()` 循环后未查 `rows.Err()`**，中途断连静默截断结果集（ctxmgr 历史/窗口/搜索、docgov engine、freedoc、storage/cas、`cmd/document-content-reconcile` 漏检会让 reconcile 漏报文档） | 如 `internal/ctxmgr/chat_history.go`、`internal/docgov/engine.go`、`cmd/document-content-reconcile/main.go:82` |
+| R-3 | 事件 dispatcher `Handlers` map **写持锁、读不持锁**（当前仅启动期注册则良性，动态注册即 race） | `internal/events/worker.go:87,154,234` |
+| R-4 | `memTurns` 全局幂等表只增不删且跨实例共享，长期运行内存缓增、测试间可能串扰 | `internal/ctxmgr/chat_turns.go:169` |
+| R-5 | `internal/docrevision/pg_store.go:68-208` 十余处 `_ = json.Unmarshal(...)`，账本 JSONB 损坏时静默零值化 | 同左 |
+| R-6 | 后台 ticker goroutine 无关停通道（通知提醒、vault Drain 错误被丢弃、bizdev 心跳用 `context.Background()`），`Shutdown` 未覆盖 | `notification_reminder_loop.go:15`、`vault.go:63`、`bizdev/service.go:682` |
+| R-7 | SSE 重连对 401/404 无 fail-fast：任何错误一律退避重连 40 次（~3 分钟）期间 UI 一直 thinking；`streamChat` 对畸形 data 帧直接抛错中断整条流 | `web/src/api/taskRuns.ts:108-140`、`api/chatStream.ts:122` |
+| R-8 | 组件卸载/登出不 abort 任务流，在途 SSE 继续写 localStorage | `web/src/App.tsx:595,2804` |
+
+### 2.3 环境 / 配置缺陷
+
+| ID | 描述 | 证据 | 严重度 |
+|----|------|------|--------|
+| E-1 | **main 环境 app `ENV=prod` 与 events `ENV=main` 不一致**：事件信封以 `Environment="prod"` 写入，而 `event_consumer_modes` 只种子 dev/test/main 三行 → app 侧 `WriterLive("prod")` 恒 false（in-process 直连不退出），events worker 按 'main' 判定 → **main 存在双写或 durable 管道空转风险**（取决于 main 行 mode）。dev/test 两服务 ENV 一致，无此问题 | `docker-compose.main.yml:90,160`、`internal/app/docflow/commands.go:276`、`goose/00040:55-59`、`internal/events/dispatcher.go:308-313` | **critical（main 专属）** |
+| E-2 | **main schema 落后两版（47 vs dev 49）**：00048 给 projects 加 13 列，当前 HEAD 代码直接 SELECT/INSERT 这些列；00049 建 system_settings。若把 dev HEAD 镜像升 main 而不先跑迁移，项目工作流查询/系统设置 API 直接 SQL 报错。**main 晋升顺序必须 events（跑迁移）先于 app** | `goose/00048`、`goose/00049`、`internal/projectworkflow/store.go:76,113` | high（晋升窗口） |
+| E-3 | `MULTI_INTENT_PLAN_TIER` 未在任何 compose environment 声明（configs/.env 设了也传不进容器）；test/main 连 U9–U12 flag 都未声明 → 容器内锁死 legacy，授权升级时需先改 compose | `docker-compose.*.yml` | medium |
+| E-4 | `CURSOR_RUNNER_URL` 三环境 compose 都注入但代码零读取；cursor-agent 容器是 alpine 占位，cursor-cli 后端容器部署不可达 | `docker-compose.*.yml` | low |
+| E-5 | `ENABLE_DEV_IMPORT` 不在任何 compose/.env.example；且判断把 `cfg.Env==""` 也算 dev——配置缺失时导入门禁自动放开 | `internal/server/chat_window_api.go:171` | medium |
+| E-6 | `SEED_DEMO_USERS` 仅 test compose 显式 false；dev 依赖默认播种（demo 密码 123456），main 靠代码 `Env!="dev/test"` 兜底，主 compose 未显式关闭 | `docker-compose.test.yml:91`、`internal/auth/bootstrap.go:67-116` | low |
+| E-7 | `INTENT_V2_DECISION_TIER` 非法值回退 `query`（激进），与 `MULTI_INTENT_PLAN_TIER` 回退 `legacy`（保守）策略不一致 | `internal/intent/flags.go:47-64` | low |
+| E-8 | `publisher_gate_test.go:16` 读 `FAV_PUBLISHER_ENABLE`（少 D），与正式变量名不符，该测试门永远走默认分支 | `internal/artifactvault/publisher_gate_test.go:16` | low |
+| E-9 | main compose 的 system-db initdb 只挂 00001_baseline.sql，与 dev/test 不一致；新建卷时初始脚本漂移（依赖 events 启动迁移补齐） | `docker-compose.main.yml:23` | low |
+
+---
+
+## 三、已实现但未启用 / 未测试的功能
+
+### 3.1 特性开关封存（实现完整，全环境 off）
+
+| 功能 | 实现位置 | 状态与门禁 |
+|------|----------|-----------|
+| FAV 事件订阅者 | `internal/app/fav/subscriber.go` | 三重硬门禁：cmd/events 刻意不注册、registry fail-closed、SetMode 拒绝非 off；仅 ObserveShadow 可达 |
+| FAV 发布器 | `internal/server/vault.go:18-67` | `FAV_PUBLISHER_ENABLED=false` 三环境显式；且 VAULT_* 三变量 compose 全未声明，容器内即使开 flag 也会静默 return（E-类：实际不可误开，属设计内封存） |
+| FAV 降级读 | `internal/docquery/service.go:70` | `FAV_DEGRADED_READ=false` 红线保持 |
+| 多意图 PlanTier shadow/auto_read/confirm | `internal/app/intentflow/turn.go` | 容器内锁死 legacy（见 E-3） |
+| U9–U12 扩面 | `intentflow/expansion.go`、`mux.go` | 全 false；dev compose 已声明可调，test/main 未声明 |
+| 意图 V2 shadow/decision | `internal/intent/shadow_v2.go`、`v2_decision.go` | 三环境显式 false |
+| 语义摘要 shadow | `internal/ctxmgr/semantic_summary.go:216` | 默认 off，且仅 AGENT_BACKEND=pi-agent 时挂载 |
+| PI change-report 叙事 | `internal/docrevision/narrative.go:68` | 默认 off，仅确定性 fallback（不得冒充完整 PI） |
+| artifact-vault CLI | `cmd/artifact-vault/main.go` | 未部署 stub |
+| eventmode cutover CLI | `cmd/eventmode/main.go` | 硬门禁仅 dev 可用（`internal/events/cutover.go:13`） |
+
+### 3.2 死代码 / 机制先行无消费方
+
+| # | 项 | 位置 |
+|---|----|------|
+| X-1 | `SEMANTIC_FALLBACK_ENABLED` 死 flag：无任何业务消费方，仅 sysadmin 展示；三环境 compose 都在设一个没用的变量 | `internal/intent/flags.go:43`、`internal/app/app.go:285` |
+| X-2 | `SEMANTIC_SUMMARY_REPLACE` 读取后 `_=` 显式丢弃，刻意永久未接线 | `internal/ctxmgr/semantic_summary.go:257` |
+| X-3 | goose 00048 三张新表 `project_source_bindings`/`repo_path_allowlist`/`project_type_workflows` 无代码消费方（swboot 目录硬编码内存版，RepoAllowlist 为 stub） | `internal/swboot/catalog.go:92,118`、`repo_allowlist.go` |
+| X-4 | `system_settings` 白名单 6 键全部无业务消费方——可写不生效，纯机制先行 | `internal/sysadmin/settings.go:57-66` |
+| X-5 | 前端死组件：`DocumentNotificationList.tsx`（含已读回写，功能完整无挂载点）、`WorkflowPrerequisiteBanner.tsx`、`user/SettingsModal.tsx`（已被 UserSettingsModal 取代）；死 API：`api/projectWorkflow.ts:71 activateWorkflow`；`data/storage.ts:141 saveMessages` deprecated no-op | web/src 各文件 |
+| X-6 | `useTaskRunStream` 伪 ref（同 B-7） | — |
+
+### 3.3 测试盲区
+
+| # | 盲区 | 说明 |
+|---|------|------|
+| S-1 | `TestReconcile_LegacyRepair_PG` 从未执行 | 要求隔离 PG 且硬拒绝 5433/5434/5435；canonical-hash 修复链路零自动化验证（gap-matrix 已记测试债） |
+| S-2 | 两个「永久跳过」 | `taskstream_test.go:189`（功能已删，测试成死代码应删除）；`plan_owner_test.go:125`（重定向跳过） |
+| S-3 | 无测试的 cmd 入口 | `cmd/server`、`cmd/events`、`cmd/artifact-vault`、`cmd/dataset`、`cmd/eventmode`、`cmd/recategorize`、`cmd/document-revision-backfill`（仅 bizdev-cli、document-content-reconcile 有）；`internal/observability`、`internal/workflow` 无测试文件 |
+| S-4 | **E2E 默认全不跑**：web/e2e 9 个 spec 全部被环境门禁（`RUN_UI_ACCEPTANCE=1`/`DOCREV_E2E_BASE_URL`/`INTENT_DUAL_TAB=1`），默认 `playwright test` 实跑 0 用例；`test:ui-acceptance` script 只覆盖 1 个 spec，其余 8 个无 script 入口 | web/e2e/、web/package.json:11 |
+| S-5 | 409 信封处理只覆盖部分消费方：projectMembers、freeformDoc、createTaskRun、chatSessions upsert 等 409 只能裸报错（与 FEATURE-MATRIX hardening backlog 一致） | `web/src/api/projectMembers.ts`、`freeformDoc.ts:177`、`taskRuns.ts`、`chatSessions.ts` |
+| S-6 | 前端 bundle 大 chunk 未分割（mermaid/katex/xlsx/docx 各成 >500 kB chunk，已有 precompress 缓解） | vite build 警告 |
+
+---
+
+## 四、结论与优先级
+
+**总体判断**：发布门禁与 FEATURE-MATRIX 的 `done/partial/deferred` 口径与代码实况基本一致，未发现「stub 冒充验收」类违规；质量门禁（vet/test/build）全绿。主要风险集中在三处：
+
+1. **E-1（main ENV 不一致 → 双写/空转）是唯一 critical 级发现**，且只在 main 环境存在， dev/test 的「healthy」不能证明 main 事件链路正确。
+2. **SSE 120s 断流（B-1/B-2）直接影响长任务可用性**，是用户可感知的现存 bug。
+3. **封存面（FAV/多意图 tier/U9–U12/语义摘要/PI 叙事）实现完整但容器内不可调或硬门禁封存**，红线达标，但授权放量时会发现 compose 层缺失（E-3）与若干死接线（X-1/X-2）。
+
+详细整改顺序见 [remediation 方案](../remediation/2026-09-17-system-health-remediation-plan.md)。
+
+## 关联整改
+
+- Remediation: [2026-09-17-system-health-remediation-plan.md](../remediation/2026-09-17-system-health-remediation-plan.md)
+
+## 证据
+
+- `go vet ./...` / `go build ./...` / `go test -short -count=1 ./...`（62 包 ok）/ `cd web && npm test && npm run build`：2026-09-17 全绿。
+- 文中所有 `文件:行号` 引用均为 2026-09-17 dev 分支工作区实测。
+
+## 开放问题
+
+- E-1 的修复取向（app 改 `ENV=main` vs 事件信封/consumer mode 键改用部署名）需架构决策。
+- D7 合规签字、`MULTI_INTENT_PLAN_TIER` 升 confirm、FAV live 放量均需用户显式授权，不在本整改自动范围内。
+- configs/.env.dev/.env.test/.env.main 实际文件未读取（含密钥）；若偏离 example 模板，E-3/E-4/E-6 结论需复核。

.doc/audit/2026-09-19-system-deep-audit.md

@@ -0,0 +1,130 @@
+---
+title: "系统深度体检审计（2026-09-19，dev@e8ed33b）"
+status: done
+created: 2026-09-19
+updated: 2026-09-19
+severity: high
+---
+
+# 系统深度体检审计（2026-09-19）
+
+> 只读审计，未修改业务代码。分支 `docs/system-deep-audit-2026-09-19`，基点 dev@e8ed33b。
+> 方法：go vet / go test -short 静态基线 + 五路并行深潜（后端 server/chat、docgov/events/工作流/迁移、前端 web、配置 flag/死代码、安全鉴权）。
+
+## 一、总体结论
+
+- **静态基线健康**：`go vet ./...` 零告警；`go test -short ./...` 55 包全 PASS；全仓 TODO/FIXME 仅 2 处非实质。
+- **四条已声明红线全部核实一致**：`MULTI_INTENT_PLAN_TIER=legacy`、`SEMANTIC_SUMMARY_REPLACE` 未接线、`FAV_DEGRADED_READ=false`、SWBOOT-10 fail-closed stub——代码与三环境 compose 均对齐，无漂移。
+- **IAM 主链路复核成立**：路由统一挂鉴权中间件、SQL 全参数化、token 哈希存储、错误出参有内部信息过滤。但存在 dev/test 兜底与端点级鉴权缺口（见 S1/S2）。
+- **本次新发现**：2 项 critical（后端数据竞态 + docgov 吞错）、10 项 high、若干 medium/low。其中 3 项被两路独立审查交叉命中（见 ★ 标记），可信度最高。
+- FEATURE-MATRIX 已声明的 partial/deferred（rdev、SWBOOT、FAV、D7、首载性能）不在本次重复申报范围；本次发现均为**新增**缺口。
+
+## 二、Critical（发布前必须评估）
+
+### C1 ★ docgov 持久化全链路 fire-and-forget 吞错；fencing token 未读回
+`internal/docgov/lease.go:460-467, 485-490`；`internal/docgov/engine.go:318, 392, 405, 470, 477, 650, 743, 750, 1081-1134`
+
+租约获取/续约/回收、正文哈希、认领状态、提案决定及**全部审计日志**均为 `_, _ = e.pool.Exec(...)` 静默吞错：
+- 审计 INSERT 失败 → 合规事件永久丢失，无重试无告警；
+- 租约 UPDATE 失败 → 内存与 DB 分叉，重启后可并行编辑同一文档；
+- `lease.go:485` 用 `context.Background()` 脱离请求生命周期；
+- `loadDocumentFromDBLocked` 的 SELECT 列表**不含 `lease_fencing_token` 列**（00034 迁移已建列）→ 进程重启后 fencing 语义完全失效（合法持锁者被误判 stale，或 stale 写者被放行——两个方向都有缺口）。
+
+**建议**：持久化失败必须返回 error 或 slog.Error+指标；审计写入失败进重试队列；lease SELECT 补 fencing 列；persistLeaseLocked 失败回滚内存状态。
+
+### C2 ★ Session 全字段数据竞态 + 跨项目污染
+`internal/chat/session.go:275-277`；`internal/server/server.go:432-435`；`internal/server/handlers.go:196-198`
+
+- `Messages`/`UserCtx`/`LastAccessedAt` 的读写锁粒度碎片化：SSE 路径持 `execMu`，而 `hydrateVisibleHistory`、`handleGetProject`、`cleanStaleSessionsLocked`、`server.go:435` 均不持锁。并发 SSE+REST 同会话时 `go test -race` 可复现 data race。
+- `handleChat` 无锁写 `sess.ProjectID = req.ProjectID`，同一 sessionID 被不同项目请求交错时跨项目串扰。
+
+**建议**：Session 加 `sync.RWMutex` 统一保护；ProjectID 改为请求级参数不写回共享 sess。
+
+### C3 SSE WriteTimeout=120s 硬杀长任务 + 心跳 goroutine 生命周期不一致
+`internal/server/server.go:352-355`；`internal/server/sse.go:252-271`
+
+全局 `WriteTimeout: 120s`；SSE 靠 45s 续期+15s 心跳兜底，心跳被中间代理吞掉时长 LLM 回合（dialogueTimeout=3min）被强杀。非流式 `handleRunTask` 同步执行数十分钟任务，120s 必然截断响应（业务已执行、客户端收不到结果 → 幂等重试造成重复执行观感）。心跳 goroutine 模式与 `handleTaskRunEvents`（主循环 select，无此问题）不一致。
+
+**建议**：长任务端点异步化（提交+轮询/SSE）；心跳并入主 select 或 WaitGroup 收敛。
+
+### C4 工作流计划保存跨语句竞态 + completed_by 错填
+`internal/projectinstance/service.go:185-190`；`internal/projectinstance/stage_store.go:132-138`
+
+- `SaveWorkflowPlan`：upsert 与 bump revision 两条独立事务，并发下同版本号先互相覆盖 plan 再一方 bump 失败 → **版本号与 plan 内容错位落库**。`Activate` 的 token 前置校验与激活事务间存在 TOCTOU。
+- `completed_by = (SELECT activated_by ...)`：最终阶段完成的归属人被错填为激活人，审计归属错误。
+
+**建议**：upsert+bump 同事务 + `FOR UPDATE` 锁 project 行；completed_by 显式传当前操作者。
+
+## 三、High（建议进入 short-term 整改）
+
+| # | 发现 | 位置 | 要点 |
+|---|------|------|------|
+| H1 ★ | dev/test 未认证静默兜底为 user id=1 | `internal/server/auth_middleware.go:48-51` | `Env=dev|test` + `AllowInMemory` + 无 ContextDB 时，无 token 请求静默识别为 id=1（管理员）。main 已被 `validateProductionSecrets` 兜住。建议：兜底路径加审计日志+启动告警；中期删除 legacy 兜底 |
+| H2 ★ | docgov 批注/审计端点无资源级鉴权且信任请求体身份 | `internal/server/handlers.go:858-940, 534-552` | 任意登录用户读任意文档批注/审计；`AddComment` 直接用 `req.UserID/UserName/UserRole` 可伪造他人身份；`Claim` 角色由客户端自选。两路审查交叉命中。建议：actor 一律取 principal；读类端点加项目成员校验 |
+| H3 ★ | 会话查询类端点水平越权 | `chat_turn_api.go:12-45`；`handlers.go:947-981, 429-451` | `handleGetChatTurn`/`handleListChatSessions`/`handleGetUserContext` 的 session_id/user_id 来自 query 不校验归属；userID<=0 时默认 1（种子 admin）。建议：改用 principal 或比对不一致 403 |
+| H4 | 登录/注册无速率限制 | `server.go:295-296` | 全仓无限流；bcrypt 高成本反而便于 CPU 耗尽 DoS。建议：IP+用户名滑动窗口限流 |
+| H5 | SSE 任务流缺幂等前置检查 | `internal/server/sse.go:398-424` | REST 路径有 `FindByIdempotencyKey`，SSE 路径没有；EventSource 断线重连产生重复任务执行 |
+| H6 | 事件 dispatcher stale-fencing 无限重放 | `internal/events/worker.go:206-275` | ErrStaleFencing 直接 cancel+return 不计 Failed；handler 半成功被回滚后事件无限重放，永不可达 dead，无告警 |
+| H7 | 迁移 00001–00009 缺 down；00012 seed 迁移破坏性 DELETE | `deploy/postgres/goose/` | 前 9 个迁移无 down；00012 无条件 DELETE 30 个 session 的真实消息再插种子；多个迁移事务内 CREATE INDEX（非 CONCURRENTLY）大表会锁表 |
+| H8 | compose 弱口令兜底 + main 注册默认开放 | `docker-compose.{dev,test}.yml:17,86,101`；`main.yml:101` | dev/test 的 DB/ADMIN 口令有弱默认值；main 已用 `:?required` 强制但 `AUTH_REGISTRATION_ENABLED` 默认 true。建议 test 对齐 main 必填，main 注册默认 false |
+| H9 | 前端 KaTeX 占位符 XSS | `web/src/engine/renderMarkdown.ts:44-64, 106-108` | 数学公式 catch 分支把未转义原文放入占位符数组，还原发生在 escapeHtml 之后 → XSS。建议：catch 分支 escapeHtml(math) + 占位符随机化 |
+| H10 | `context.Background()` 脱离请求生命周期 | `internal/chat/session.go:131-134`；`server.go:423,458,566` | LLM 摘要/DB 调用用 Background，客户端断开无法取消，慢库时 handler 挂死。建议：透传请求 ctx + WithTimeout |
+
+## 四、Medium（选录，详见各专项）
+
+| # | 发现 | 位置 |
+|---|------|------|
+| M1 | 全局缺安全响应头（CSP/nosniff/X-Frame-Options/Referrer-Policy） | `internal/server/server.go:624-636` |
+| M2 | 租约 TTL 无上限（可锁文档 1000 天）+ AcquireLease 无编辑权校验 | `handlers.go:1196-1203`；`docgov/lease.go:62-70` |
+| M3 | coordinator 关键词命中强制改写意图 + 模板硬编码"张工您好" | `internal/coordinator/engine.go:409-416, 485` |
+| M4 | `fmt.Sscanf` 解析 `u_sess_xxx` 必然失败 → UserID=0 审计落空 | `coordinator/engine.go:930-934, 1067-1071` |
+| M5 | `Runtime.Start` 被 main 与 Server.Start 双重调用且错误被吞 | `server.go:343-345`；`cmd/server/main.go:47` |
+| M6 | sessions map 无硬上限，惰性清理可被随机 session_id 放大 | `server.go:451-453` |
+| M7 | 修订三阶段写（账本→DocGov→freeform）无事务，靠客户端重试补偿 | `document_revision_handlers.go:274-318` |
+| M8 | 测试 flag 名笔误 `FAV_PUBLISHER_ENABLE`（少 D）门闩失效 | `internal/artifactvault/publisher_gate_test.go:16` |
+| M9 | dev compose 声明永不消费的 `SEMANTIC_SUMMARY_REPLACE`（诱导性配置）；dev 与 test/main 默认模型不一致（M2.7-highspeed vs M3） | `docker-compose.dev.yml:119,44` |
+| M10 | OpsCutover 硬编码 `"dev"`，test/main 无合规 cutover 路径 | `internal/events/cutover.go:12-19` |
+| M11 | 前端乐观已读无失败回滚；MessageStream prevMsgCount 跨会话不重置；SSE 无 online 感知重连 | `web/src/hooks/useUnreadMarks.ts:176-233`；`MessageStream.tsx:148-154` |
+| M12 | ExcelViewer 无行数上限内存爆炸；React 19 下 30+ 处裸 setTimeout 无清理 | `ExcelViewer.tsx:42-55` |
+| M13 | `deploy/postgres/migrations/` 疑似死目录（14 个旧 SQL 无引用，与 goose 重复） | `deploy/postgres/migrations/` |
+| M14 | `Orchestrator.ResolveDocTask` 静默返回 0 值三权掩盖数据不一致 | `internal/workflow/runtime/orchestrator.go:69-83` |
+| M15 | PG 事件投递允许乱序而 MemoryBus 有 gap 语义——测试替身与生产行为分叉 | `internal/events/dispatcher.go:56-63` vs `bus.go:99-103` |
+
+## 五、Low（选录）
+
+- `handleHealth` 每请求同步两次 DB 往返无缓存无超时（`handlers.go:97-110`）
+- `writeStoredEvents` json.Marshal 错误被吞（`task_run_handlers.go:437`）
+- `ReplayPlan.Digest()` 不含 DryRun 字段（纵深防御，`internal/events/replay.go:24-38`）
+- 前端 localStorage 缓存无版本字段；`lucide-react@^1.16.0` 版本异常需确认来源；App.tsx 4600 行/30 个 useEffect 巨石组件
+- `handleRunTaskStream` 死参数 `includeDetails/requestID`（`sse.go:417-418`）
+
+## 六、复核确认无问题的面（证据性记录）
+
+- SQL 注入：全部 pgx 参数化；仅 4 处 fmt.Sprintf 涉 SQL 均为常量
+- CORS：白名单制、无 `*`+凭证；SSE 鉴权失败返回 JSON 而非污染流
+- 日志：密码 bcrypt、token SHA-256 摘要存储；`httpx.LooksInternal` 过滤内部错误串
+- os/exec：bridge 路径来自服务端配置，用户输入只进 stdin payload；无 text/template 引用
+- 事件系统：claim 幂等（SKIP LOCKED + fencing 复合判断）、ack+inbox+checkpoint 单事务、envelope 完整性校验、replay 审批人≠操作人——设计正确
+- 前端：Mermaid strict 模式、链接 noopener、ErrorBoundary 覆盖根组件、EventSource 卸载清理正确
+
+## 七、优先级建议
+
+1. **进 main 前必须处理**：C1–C4、H1–H5、H8、H9（H8 的 main 注册默认开放一项）
+2. **short-term 整改批**：H6、H7、H10、M1、M2、M8（一行修复恢复门闩）
+3. **backlog**：其余 medium/low
+
+## 关联整改
+
+- Remediation: 待立项（建议按第七节优先级拆 short-term 任务）
+
+## 证据
+
+- `go vet ./...` 零输出；`go test -short ./...` 55 包 ok（2026-09-19，dev@e8ed33b）
+- 五路只读深潜：后端 server/chat、docgov/events/工作流/迁移、前端 web、配置/flag/死代码、安全鉴权
+- 任务条目：[ops/short-term/2026-09-19-system-deep-audit.md](../ops/short-term/2026-09-19-system-deep-audit.md)
+
+## 开放问题
+
+- dev 与 test/main 默认模型不一致（M2.7-highspeed vs M3）是否刻意？未见 `.doc/ops` 对齐记录
+- `deploy/postgres/migrations/` 是否还有外部工具依赖？无则建议归档
+- H1 legacy 兜底是否有仍在使用的内部工具依赖？删除前需盘点

.doc/audit/2026-09-20-bug-hunt-permissions-uploads.md

@@ -0,0 +1,48 @@
+---
+title: "系统权限设置与项目协作多项缺陷排查"
+status: done
+created: 2026-09-20
+updated: 2026-09-20
+severity: high
+---
+
+# 系统权限设置与项目协作多项缺陷排查
+
+## 现象
+
+用户报告：成员管理勾选无效、系统设置「允许编制人兼任审核批准」400、PDF 预览被拦截、任务 runs 403 刷屏、发起编制被标 NETWORK_ERROR、注册/建号 rollback、改密后刷新再强制改密、退出重登出现同名重复项目、无项目仍可对话、右侧工具栏默认展开且不记忆。
+
+## 根因分析
+
+| # | 根因 | 关键路径 |
+|---|------|----------|
+| 1 | CSP 缺 `frame-src`，blob iframe fallback 到 `default-src 'self'` | `internal/server/cors.go` |
+| 2 | PdfViewer 同源 iframe 直连，触发 `X-Frame-Options: DENY` 原生拦截页 | `web/src/components/doc/preview/renderers/PdfViewer.tsx` |
+| 3 | 前端未传 `expected_revision`（该 key 后端强制 CAS） | `web/src/api/systemAdmin.ts` / SettingsSection |
+| 4 | `ProjectSettingsApiError` 字段名与消费方 `httpStatus`/`errorCode` 不一致 | `web/src/api/projectSettingsError.ts` |
+| 5 | task-run view 仅放行创建者/owner；前端 403 无停止轮询 | `task_run_auth.go` / `App.tsx` |
+| 6 | `CanManageProjectMembers` 未读细粒度权限位 | `internal/authz/service.go` |
+| 7 | memStore `ListProjectsForUser` 忽略成员表 | `internal/projectworkflow/store.go` |
+| 8 | `user_role_bindings` 插入吞错 → commit rollback；handler 一律 400 | `internal/auth/pg_store.go` |
+| 9 | 嵌套 `user.mustChangePassword` OR 合并复活 + fetchMe 未回写 session | `authUserMap.ts` / WorkbenchView / useAuthenticatedWorkspaceSync |
+| 10 | `projects.name` 无唯一约束 + Create 无幂等键；logout 不清 projects 缓存 | `service.go` / migration 00056 / App logout |
+| 11 | `Project()<=0` 时跳过项目访问校验 | `handlers.go` / `sse.go` / `stage_access_helpers.go` |
+| 12 | `rightCollapsed` 默认 false 且无持久化 | `AppShell.tsx` / `storage.ts` |
+
+## 严重度
+
+`high`
+
+## 关联整改
+
+- Short-term: `.doc/ops/short-term/2026-09-20-bug-hunt-permissions-uploads.md`
+- 分支: `fix/bug-hunt-2026-09-20-permissions-and-uploads`
+
+## 证据
+
+- 产品决策：新增 `project:manage_members`；无项目禁止对话并置灰发送按钮；同创建人内项目名唯一 + `client_key` 幂等。
+- 迁移：`00055_...project-manage-members-permission.sql`、`00056_...project-create-idempotency.sql`
+
+## 开放问题
+
+- 无（本批范围内）

.doc/audit/2026-09-20-module-coupling-audit.md

@@ -0,0 +1,142 @@
+---
+title: "模块耦合现状审计（规范与分批整改基线）"
+status: done
+created: 2026-09-20
+updated: 2026-09-20
+severity: high
+---
+
+# 模块耦合现状审计（规范与分批整改基线）
+
+## 现象
+
+系统已经是模块化单体，不是未治理的大泥球：`module-boundaries.yaml` + `internal/archtest` 已把 import 与事件登记清到零违规（`baseline_counts.import=0`、`event=0`，二者在 `block_kinds`），可靠事件由独立 `cmd/events` worker 经 PostgreSQL lease 消费。
+
+故障仍会跨模块扩散的原因不在“缺总线”，而在四类残留：
+
+1. HTTP 适配层直接持有领域具体类型，而不是只调用用例端口。
+2. `chat`、`app` 子包与 `coordinator` 用子包拆分避开了 Go 编译环，逻辑上仍互相依赖。
+3. `docgov` 的状态、角色和错误被多个模块当成本模块词汇使用。
+4. 带到期日的 SQL/路径例外仍允许非属主写入或拼接工作区路径。
+
+本审计只记录证据与分级，不改代码。整改批次见 [分批计划](../remediation/2026-09-20-module-decoupling-batch-plan.md)。
+
+## 根因分析
+
+### 已有隔离基线（不要推倒）
+
+| 机制 | 位置 | 现状 |
+|------|------|------|
+| 模块化单体 ADR | [2026-09-14-modular-monolith-decoupling](../adr/2026-09-14-modular-monolith-decoupling.md) | 不拆微服务；窄端口 + 组合根 + 领域事件 |
+| 静态边界 | [module-boundaries.yaml](../system-design/module-boundaries.yaml) | import allowlist、表唯一写者、路径属主、事件生产者/消费者 |
+| 架构门禁 | `internal/archtest`、`scripts/arch-check.sh --mode block` | import/event 零容忍 |
+| 进程内端口 | `internal/app/*flow`（例：`internal/app/chatflow/ports.go`） | 消费者拥有窄接口；组合根注入实现 |
+| 跨进程事件 | `internal/events` + `cmd/events` | PG outbox/inbox；dev `:8088` / test `:8089` / main `:8090` |
+| 事件契约 | `internal/events/registry.go` `StaticContracts()` | 11 个事件名、schema version、payload 字段 allowlist；与 YAML parity |
+
+`StaticContracts` 现有事件：`document.agent_candidate_ready`、`document.agent_version_committed`、`document.downstream_impact_detected`、`document.change_report_degraded`、`document.approved`、`taskrun.completed`、`taskrun.cancelled`、`fav.artifact_staged`（`Enabled: false`）、`intent.plan.awaiting_input`、`intent.plan.step_changed`、`intent.plan.completed`。
+
+### 热点 1（P1）：`server` 上帝适配层
+
+`internal/server/server.go` 的 `Server`（约 40–80 行）同时持有 `*bizdev.Service`、`*coordinator.CoordinatorEngine`、`*docgov.GovernanceEngine`、`*docrevision.Service`、`*taskrun.Manager`、`*projectinstance.Service`、`*pgxpool.Pool` 等具体类型。同结构体里只有少数字段是端口（`chatflow.ChatLog`、`chatflow.ContextAssembler`、`intentflow.Service`、`intent.Recognizer`）。
+
+生产 import 覆盖约 30 个内部包（`server.go` 11–34 行）。handler 直接解释领域错误，例如 `internal/server/handlers.go` 对 `docgov.ErrDocumentBusy` 的分支（426、449 行）以及 `docgov.RoleAuthor`（702、1291 行）。
+
+后果：领域包改一个错误或角色常量，HTTP 层必须跟着改；`pool` 还让适配层有机会绕过表属主写 SQL。
+
+### 热点 2（P2）：`chat` ↔ `app` ↔ `coordinator` 逻辑环
+
+编译环被子包拆开了，依赖方向没有：
+
+- `internal/chat/session.go` 11–13 行 import `app/chatflow`、`app/intentflow`、`coordinator`。
+- `internal/chat/action_executor.go` 10–14 行 import `app/intentflow`、`app/stageflow`、`coordinator`、`docgov`、`taskrun`，并持有具体引擎指针。
+- `internal/app/chatflow/ports.go` 又 import `coordinator`、`ctxmgr`、`projectinstance`（`AssembleRequest` 直接嵌 `coordinator.UserInfo`）。
+
+`chat` 既是领域会话，又反向依赖用例包。用例一变，会话执行器就会编译失败，问题不会停在单一模块。
+
+### 热点 3（P3）：`docgov` 词汇泄漏
+
+生产代码（不含本包测试）直接使用 `docgov` 状态/角色/错误的位置包括：
+
+- `internal/coordinator/engine.go`：`ErrDocumentBusy`（955）、`StateDrafting`（1596、1598）。
+- `internal/bizdev/service.go`：`ErrDocumentLocked` / `ErrDocumentBusy`（718）。
+- `internal/server/handlers.go`、`document_revision_handlers.go`、`auth_helpers.go`：`RoleAuthor`、`ErrDocumentBusy`。
+- `internal/chat/action_executor.go`：动作名字符串 `"docgov.review_approve"`（58、150 行），以及 `docgov.StateDrafting`（90）。
+
+这些不是稳定共享词汇（`internal/contracts/vocabulary` 尚未承接它们），而是领域实现类型被当公共 API。
+
+### 热点 4（P3）：工作流定义与实例网
+
+- `internal/workflowdef/catalog.go` import `projectworkflow`。
+- `internal/workflowdef/validator_v2.go` import `workflow`。
+- `internal/projectinstance` 生产文件（`store.go`、`service.go`、`gate.go`、`types.go` 等）import `workflowdef`。
+- `internal/workflow/runtime/orchestrator.go` import `projectinstance`。
+
+定义、目录、实例和运行时互相看得见对方的包。改一份工作流校验会同时碰到定义包和实例包。
+
+### 热点 5（P4）：巨型文件
+
+非测试生产文件行数（2026-09-20 `wc -l` 口径，探索盘点）：
+
+| 行数 | 文件 |
+|------|------|
+| 1844 | `internal/coordinator/engine.go` |
+| 1590 | `internal/bizdev/service.go` |
+| 1395 | `internal/server/handlers.go` |
+| 1291 | `internal/projectinstance/store.go` |
+| 1245 | `internal/intent/recognizer.go` |
+| 1235 | `internal/projectworkflow/store.go` |
+| 1207 | `internal/docgov/engine.go` |
+| 1172 | `internal/docrevision/service.go` |
+| 1151 | `internal/squad/workspace.go` |
+| 1028 | `internal/freedoc/service.go` |
+
+单文件过大本身不是耦合，但它把多个用例绑在同一变更面上，评审和回滚半径变大。拆分应跟在解环之后，避免边搬边改依赖。
+
+### 热点 6（P4）：前端 API 层无统一客户端
+
+`web/src/api/` 约 37 个文件按域各写 `fetch()`，`API_BASE` 与鉴权头分散。错误信封、重试和 401 处理无法在一处收口，后端错误契约一变就会在多个 api 文件重复漏改。这是适配层问题，不是把前端改成 RPC。
+
+### 热点 7（P2，有到期日）：边界例外未清零
+
+[module-boundaries.yaml](../system-design/module-boundaries.yaml) `exceptions` 共 21 条，`baseline_counts` 为 sql_write 5、path 16。
+
+| 种类 | 条数 | 里程碑 | 到期 | 风险 |
+|------|------|--------|------|------|
+| `sql_write` | 4 | U3 | 2026-09-28 | **8 天后到期**。`docduty`、`docrevision` 仍写 `document_records` / `freeform_documents` |
+| `sql_write` | 1 | U8 | 2026-10-26 | `projectinstance` 终止流程直接取消 `task_runs` |
+| `path` | 2 | U4 | 2026-09-28 | **同样 8 天后到期**。`server` 与 `docrevision` 仍点名 `output.md` |
+| `path` | 14 | U5 | 2026-10-12 | `agent`、`bizdev`、`coordinator`、`docgov`、`storage` 仍拼接工作区路径或把 `data/dev` 写进提示 |
+
+到期后若门禁把这些 kind 升为 block 而代码未迁走，构建会失败；若继续延期而不迁，非属主写入会继续让文档/任务故障跨包扩散。本轮不改 YAML，清零归整改批次 G。
+
+## 严重度
+
+整体 `high`：不会单独打穿已签发布门禁（`production_ready` 不因本审计回退），但 P1/P2 使“问题停在单一模块”尚未成立。
+
+| 级别 | 热点 | 扩散方式 |
+|------|------|----------|
+| P1 | server 具体类型装配 | 领域改动直接编译失败到 HTTP |
+| P2 | chat/app/coordinator 逻辑环 | 会话、意图用例、协调引擎必须同改 |
+| P2 | 2026-09-28 到期的 sql_write/path 例外 | 非属主写表或读工作区文件 |
+| P3 | docgov 词汇泄漏 | 状态机常量变成跨包协议 |
+| P3 | workflow 定义/实例网 | 校验与运行时同改 |
+| P4 | 巨型文件、前端 fetch 分散 | 变更面大，不立刻产生跨表写入 |
+
+## 关联整改
+
+- Remediation: [2026-09-20-module-decoupling-batch-plan.md](../remediation/2026-09-20-module-decoupling-batch-plan.md)
+- 开发规范: [2026-09-20-module-development-standards.md](../system-design/2026-09-20-module-development-standards.md)
+- 上位约束（不重复制定）: [架构](../system-design/2026-09-14-module-decoupling-architecture.md)、[Phase 2](../remediation/2026-09-15-module-decoupling-ipc-phase2-remediation-plan.md)、[影响面守则 §2](../remediation/2026-09-16-partial-deferred-completion-plan.md)
+
+## 证据
+
+- 结构体与 import：`internal/server/server.go`、`internal/chat/session.go`、`internal/chat/action_executor.go`、`internal/app/chatflow/ports.go`。
+- 事件契约：`internal/events/registry.go` `StaticContracts`。
+- 例外账本：`module-boundaries.yaml` `exceptions` 与 `baseline_counts`（import 0 / sql_write 5 / path 16 / event 0）。
+- 盘点方式：2026-09-20 只读检索生产 import 与 `docgov` 符号引用；行数来自当时文件长度，后续拆分后以 `wc -l` 重测为准。
+
+## 开放问题
+
+- U3/U4 例外在 2026-09-28 到期后，是先延长豁免并写原因，还是立刻占用 `docgov` mutex 做批次 G 的第一刀。本审计不代决，批次 G 开工前必须二选一，禁止静默改到期日。
+- `internal/contracts/vocabulary` 在架构文档中已定义，代码侧尚未作为 docgov 状态/角色的唯一出口。批次 C 再决定是新建该包还是把稳定枚举留在消费者端口。

.doc/audit/2026-09-20-system-triage-audit.md

@@ -0,0 +1,68 @@
+---
+title: "2026-09-20 系统全量体检审计"
+status: done
+created: 2026-09-20
+updated: 2026-09-20
+severity: high
+---
+
+# 2026-09-20 系统全量体检审计
+
+## 现象
+
+在 `production_ready=yes`、dev/test/main 健康、近期 triage 已合入的前提下，对全系统做只读深度体检，发现若干**未写入 gap-matrix 的 critical/high**，以及一批 medium/low 加固项。
+
+方法：四路并行深潜（后端 Go、安全鉴权、前端 web、基础设施）+ 本机实证（goose 版本表、容器 health、口令登录、代码交叉复核）。
+
+## 根因分析（P0 / critical，均已实证）
+
+| ID | 发现 | 位置 | 证据 |
+|----|------|------|------|
+| P0-MIG | 迁移序号空洞 00054；`chat_summaries` 建表与 summarizer 写失败修复滞留未合入分支 | `feature/capability-enablement-impact-plan@848a0457`；dev 代码仍读写不存在表 | `goose_db_version` 53→55→57 跳号；`to_regclass('chat_summaries')` 空；`summarizer.go:119` `_ = err` |
+| P0-IDOR-PREF | 偏好写入信任请求体 `user_id`，无归属校验 | `internal/server/handlers.go:508-537` | 无 `requireAuthenticatedUser` 比对 |
+| P0-IDOR-SESS | `handleGetProject` 以 `callerUserID=0` 调会话，归属校验被跳过 | `server.go:458-463`；`handlers.go` / `project_handlers.go` | `if callerUserID > 0` 守卫 |
+| P0-IDOR-RECAT | 重分类无会话归属；空 `session_id` 触及全库消息 | `chat_recategorize_api.go`；`ctxmgr/recategorize.go` | `WHERE ($1 = '' OR session_id = $1)` |
+| P0-PANIC | taskrun 订阅发送在锁外，Unsubscribe `close` 后向 closed channel 发送 panic | `taskrun/manager.go:481-497` vs `:590` | select default 不挡 closed；全仓非测试 `recover()`=0 |
+| P0-RACE | 同步 `POST /chat` 不取 `execMu`，与 SSE 并发 data race | `handlers.go:240` vs `sse.go:341` | 09-19 C2 残留半修 |
+| P0-CRED-BACKUP | 三环境 DB 口令硬编码进仓库；生产口令与脚本一致可登录 | `scripts/backup-system-db.sh:43-56` | 实测 `prod_highly_secure_db_pass` 可连 main |
+| P0-CRED-PUSH | push 脚本把 token 拼进 URL，`ps` 可见 | `scripts/git-push-dev.sh:23` | `https://oauth2:${TOKEN}@...` |
+| P0-XSS | 块编辑器 math 错误分支未转义 | `BlockEditorModal.tsx:206`；`MathBlockView.tsx:20` | catch 裸拼 + `dangerouslySetInnerHTML` |
+
+### 环境与分支脱节（本轮不做晋升，记 backlog）
+
+| ID | 发现 | 证据 |
+|----|------|------|
+| ENV-MAIN-DRIFT | main 分支 goose 最高 00025，main 库 schema 52；灾备从分支重建不可复现 | `git ls-tree main`；`goose_db_version` MAX=52 |
+| ENV-TEST-DRIFT | test 分支最高 00056，test 库已 57 | 实测 |
+| DOC-SCHEMA | CURRENT 写 dev schema 56，实测 57 | health JSON |
+| GOOSE-DUP56 | dev 库 version_id=56 记账两行（id 57/58，间隔 2ms） | SQL 取证 |
+
+## 严重度
+
+- **critical / P0**：上表 P0-*（本轮整改）
+- **high / medium / low**：见下方「非 P0 清单」与 [long-term](../ops/long-term/2026-09-19-audit-remainder.md) 2026-09-20 增补区
+
+## 关联整改
+
+- Remediation: [../remediation/2026-09-20-p0-remediation-plan.md](../remediation/2026-09-20-p0-remediation-plan.md)
+- Short-term: [../ops/short-term/2026-09-20-p0-hotfixes.md](../ops/short-term/2026-09-20-p0-hotfixes.md)
+
+## 证据
+
+- `go vet ./...` 零告警（2026-09-20）
+- `go test -short ./...`：仅 `TestPiAgentDockerBuildContext_RunnerModulesPresent` 因外网镜像源 EOF 失败，属测试卫生
+- 三环境 health：dev/test schema **57**，main **52**；events `:8088`/`:8089`/`:8090` ok
+- 四路深潜交叉：IDOR×3、XSS、凭证、迁移空洞均被 ≥2 条路径或本机取证命中
+
+## 非 P0 清单（摘要，详 long-term）
+
+**后端**：XFF 限流可绕过；events `cancelFns` 只增不减；docrevision/docgov 全局锁内 DB I/O；Shutdown 5s vs 长任务；`idemLocks` 无界；SSE query 传消息；C1 缓存不失效；chat 落库非原子等。
+
+**前端**：`useChatWindow` 切会话竞态；PLAN_CONFIRM 无 try/catch；turn Map 只增不减；重置密码死功能；ErrorBoundary 仅顶层；SSE `\r\n`；token localStorage + 无全局 401 登出等。
+
+**基础设施**：容器 root、无资源限制；健康检查路径不一致；main events 挂 shared-net；init 三套；Dockerfile Go 1.23 基镜像；backup 无定时；main 分支对齐晋升专项。
+
+## 开放问题
+
+- capability 分支合入后 00054 重编号为 00058 是否与其他未合并旁支再撞号？（当前仅该分支占用 54）
+- main 分支对齐晋升时 00057 会对存量项目做不可逆改名——晋升前需预演清单

.doc/audit/2026-09-21-agent-policy-review.md

@@ -0,0 +1,234 @@
+---
+title: "Agent 工作规范增删改审查"
+status: done
+created: 2026-09-21
+owner: Codex
+reviewed_dev_sha: a241e838150f218f3a09d3523f93291b847d45fd
+implementation_status: not_started
+---
+
+# Agent 工作规范增删改审查
+
+## 结论
+
+现有方向合理：任务 worktree、主目录保护、串行集成、真实证据和安全清理应继续保留。当前最值得做的是**消除冲突、减少重复维护、让关键门禁可执行**，不是继续扩充一份越来越长的 AGENTS。
+
+本轮建议集中为 10 组增删改与 2 项安全补充观察。它们不都是缺陷：下文区分已验证问题、流程简化建议与已有方案的实施事项。只形成审查结果，没有修改生效规则、脚本、锁、运行环境或业务代码。
+
+已确定的用户选择不重新讨论：全部新增写入走 `.worktrees`；锁先交付统一入口与提交门禁防误改，OS 权限隔离后续实施；本轮是规范审查，不是实施授权。
+
+## 1. 审查范围与现场
+
+冻结基线为本地 `dev@a241e838`，审查在 `.worktrees/agent-policy-review` 进行。覆盖 AGENTS、PROJECT、worktree 工作规范、Cursor 四条规则、任务/收口/handoff 模板、Herdr roster，并检查相关脚本与测试入口。
+
+主目录采样为干净 dev；未 fetch 或推送。本轮新分支只写审查记录和自己的 CURRENT 快照，不修改被审查规范。
+
+实际测量：
+
+- 基线 CURRENT 并行认领共有 **161 条**：158 条 done、2 条 in_progress、1 条 cancelled。新增本轮认领后为 162 条；不把本轮新增记录算成基线问题。
+- 基础启动链六份文件合计 **71,205 字符**，这是文件字符数，不是模型 token 数或耗时指标。
+- CURRENT 焦点有 5 项，而 AGENTS 要求 1–3 项；其中长期红线混在当前焦点中。
+- 之前的规范收口 `d5302a76` 与 `.locks` 方案 `5987bdcd` 均不是本轮基线 dev 的祖先，不能把它们当作所有 Agent 已能读取的生效规则。
+- 本轮没有运行 Go、前端、数据库或产品 PI 测试；命令问题来自源码筛选条件核查，不宣称本轮复现了产品运行故障。
+
+## 2. 优先级总表
+
+“先修”是工程流程优先级，不改变产品 FEATURE-MATRIX 或 production_ready。
+
+| ID | 类别 | 建议动作 | 优先级 | 直接收益 |
+|---|---|---|---|---|
+| R01 | 已验证冲突 | 修改测试范围与验收模型规则 | 先修 | 消除纯文档也被要求真实 PI 的矛盾 |
+| R02 | 已验证命令问题 | 修改真实 PI 示例为准确、可核验的入口 | 先修 | 避免漏测而误以为完成全链路 |
+| R03 | 流程简化建议 | 新增任务分级，允许一个主文档承载小任务 | 第二批 | 少建重复记录，减少共享文件写入 |
+| R04 | 已验证膨胀/不一致 | 精简 CURRENT 和启动读取范围 | 第二批 | 活跃冲突更易发现，降低每轮上下文成本 |
+| R05 | 已验证状态矛盾 | 修改会话结束与任务完成定义 | 先修 | 防止为了结束会话把未完成任务写成 done |
+| R06 | 已验证过强要求 | 删除固定五层提交顺序，保留逻辑原子性 | 第二批 | 代码与测试一起可验证、可回退 |
+| R07 | 已验证引用问题 + 结构调整 | 确立规范唯一来源与生效版本 | 先修 | 避免客户端副本、草案和历史记录互相覆盖 |
+| R08 | 规范增强建议 | 新增任务授权记录与例外处理边界 | 第二批 | 授权内持续执行，超范围才停下确认 |
+| R09 | 已知方案实施事项 | 优先落实最小工具门禁 | 与先修并行规划 | 把已知运维误操作挡在执行前 |
+| R10 | 收口流程增强 | 明确清理执行者、保留原因和复查触发 | 第二批 | 已完成 worktree 不再长期无主积累 |
+
+## 3. 具体增删改
+
+### R01 修改：测试要求必须按变更范围生效
+
+**依据**：`AGENTS.md:118`、`PROJECT.md:118` 明确纯工程规范/文档不调用产品 PI；`.cursor/rules/test-reports-standard.mdc:49,61` 仍要求报告包含全量 Go 回归，并在报告生成前做真实 PI 全链路。后者是 alwaysApply。旧收口分支虽包含相关澄清，但尚未进入本轮基线 dev。
+
+**后果**：Agent 依据不同入口可能运行无关长测试、误动共享服务，或把必要测试当作可选。冲突本身应先消除，不能依靠“Agent 应该理解”。
+
+**建议修改**：测试范围统一在一处定义，PROJECT 和客户端规则引用它：
+
+| 变更 | 必要验证 |
+|---|---|
+| 纯规范/普通文档 | 差异、链接、状态与指令一致性 |
+| 治理脚本 | 沙盒临时仓库中的真实分支、锁、退出与拒绝路径；不以 shell 语法检查替代行为验证 |
+| Go/接口 | 对应单测、项目 Go/架构门禁，受影响 PG/鉴权负例 |
+| 前端 | 对应测试和构建；受影响交互用真实浏览器 |
+| 迁移/运行配置 | 独立环境升级、兼容性、回退/前滚条件及就绪验证 |
+| 产品 Agent/工作流 | 受影响真实产品 PI 链路；不得以 stub/SKIP 替代 |
+
+固定七段报告模板改为“完整报告模板”，小型文档/脚本验证可用精简报告或任务内验证节；必须保留实际命令、结果、提交与适用范围。不要删除真实性要求，也不允许把未运行记作 PASS。
+
+模型要求按目标环境的已批准配置核验并记录实际值。`PROJECT.md:118` 的固定 M2.7-highspeed 不能不分环境套用：当前 dev Compose 默认 M2.7-highspeed，而 test/main Compose 默认 M3。这里是配置源码差异，未检查运行中的秘密配置；建议保留环境策略，禁止为“满足文档”自行切换模型。
+
+### R02 修改：真实 PI 命令要准确选择测试并证明没有跳过
+
+**依据**：`PROJECT.md:91–92` 使用 `RUN_PI_E2E=1 ... go test ./... -run 'PI'`。测试名 `TestPiAgent_FullLifecycle_MultiRole_RealWorld_E2E`（`internal/server/piagent_e2e_test.go:66`）及 `TestWorkflowGovernance_PiAgent_PG_*`（同模块的 `workflow_governance_piagent_pg_test.go:264,278,293`）不匹配大小写敏感的 `PI`。
+
+**后果**：命令执行范围与“全链路”的名称不一致；配置缺失还可能让数据库用例跳过。退出码 0 不能单独证明验收完成。
+
+**建议修改**：优先引用已有 `scripts/run-nightly-real-pi.sh` 作为明确基线入口，写清独立 TEST_DATABASE_URL、Runner 认证、KB/运行环境要求。该脚本当前仅选 U8 和 FullNoneMixedChain 两类测试，**不能把它表述为覆盖全部工作流**；任务按变更范围追加精确测试名与浏览器验收。增加 expected-tests 与实际执行/SKIP 对照，保存最终提交、配置与证据。
+
+不得在文档中填写真实凭证，也不运行测试来试探生产数据。
+
+### R03 新增：任务分级；删除小任务必须重复建多份记录的要求
+
+**依据**：`AGENTS.md:12,37,41–44` 要求任何任务落盘、任务文、研究/审计产物、验收及交接；没有最小产物集或合并记录的规则。
+
+**建议**：保留“需要审计的工作必须有持久证据”，明确三档：
+
+- **信息答复**：解释已有结果、查询简单状态，且不产生新决策、持久成果、仓库写入或运行副作用，可直接答复；不为一次答复单独开 worktree。若要写入任何成果，仍进入任务 worktree。
+- **单一小任务/有价值的只读审查**：一个任务文或专用 audit/research 主文档可同时承载范围、结论、验证、状态和交接；不强制再复制同一内容到另外三份文档。
+- **跨模块、多阶段、数据/部署任务**：完整 task、必要 plan、验证报告、handoff；仅在信息确实独立时拆文件，互相链接而不复制全文。
+
+本次这样的实质规范审查仍须落盘，不能以“只读”免除证据。将相关追问、修正与收口归入原 task_id；只读子审查使用父任务的范围和记录，不为每个 reviewer 再开业务任务链。无关新增任务才从 dev 建新分支。
+
+这项改变需要审核采纳；本轮仍遵守现有落盘规则，没有提前使用豁免。
+
+### R04 修改：CURRENT 只承载活跃协调，历史留索引
+
+**依据**：CURRENT 161 条认领中 158 条已完成；`AGENTS.md:132` 要求 1–3 焦点，当前正文有 5 项。
+
+**建议删除/迁移**：从 CURRENT 活跃表移出已完成/取消且没有后续阻塞的行，历史 owner、branch、worktree、证据在归档任务/历史索引保留。将长期红线独立为受控约束区或链接；它不是每天反复排序的焦点。
+
+**建议保留**：正在进行、阻塞、等待集成及仍需清理的事项。cleanup_pending 是清理/操作阶段，不新增为 task.status 的第六种状态；一行可写任务 done、cleanup pending，并给 owner、原因和下次检查条件。
+
+**启动读取修改**：每会话先读短核心规则、项目入口、活跃状态摘要；编码前按范围补读相关模块标准、相关 FEATURE-MATRIX 行、任务/方案及操作规程。发布才读完整发布门禁。不要通过摘要跳过硬红线，也不要要求每次解释一个已知结果都重读全部历史。
+
+模块开发任务应有明确条件指针指向已有 `.doc/system-design/2026-09-20-module-development-standards.md`，复用现有接口/事件/表写者规则，不新造一套编码规范。
+
+### R05 修改：会话结束、任务完成、合入与清理分别判定
+
+**依据**：收口模板第 3 行适用于“任务完成或切换 Agent”，第 22 行却无条件要求 `status=done`；AGENTS 同时允许 blocked/cancelled。任务模板已有 deployment/cleanup 字段，但缺少明确的结果判定与集成/同步状态。
+
+**建议替换收口条件**：
+
+> 会话结束不等于任务完成。根据实际情况保留 in_progress、blocked、cancelled 或 done；只有任务范围内的验收条件满足才能 done。换 Agent 必须记录剩余工作及接管条件。只有终态任务才归档；不得为了归档改成 done。
+
+为任务记录补充按需字段：`review_state`、`integration_state`、`deployment`、`cleanup`、`remote_sync`。例如“方案研究 done、review pending、未合入、deployment not_required”是合法状态；“代码已合入、部署 failed”不能报交付完成。字段由工具生成优先，避免人工重复维护多张表。
+
+研究/审查的验收是有据可审的产物，不要求把未获实施授权的方案部署到 dev。实现任务的 done 则按其获授权交付范围判定。收口报告始终区分本地提交、dev 合入、实际运行版本和远端状态。
+
+### R06 删除：固定按数据库、服务、API、测试、文档分层提交的硬性顺序
+
+**依据**：`.cursor/rules/git-workflow-and-environments.mdc:33–38` 规定“一个任务必须”按五类依次提交；AGENTS 的原子提交目标是一个逻辑变更一批。
+
+**后果**：小修复也被机械拆分，代码与对应测试分离；一些提交无法独立构建/验证，回退时还可能留下半套契约。
+
+**建议替换**：
+
+> 每个提交围绕一个可解释、可验证、可回退的逻辑变更；实现与其回归测试可同批。迁移、兼容阶段、配置或文档只有在独立审查/回退有价值时拆分，不要求每项任务凑齐固定提交层次。
+
+保留 Conventional Commits、明确文件范围、渐进式交付和独立 worktree；不以“原子”为名把无关改动揉成一批。
+
+### R07 修改：规范来源、生效状态与客户端薄入口
+
+**已验证的小错误**：`.cursor/rules/git-secrets-autonomy.mdc:2,8` 把 Secrets 指向 AGENTS §8，实际在 §9。AGENTS 开头称可整文件复制到任意项目，但正文包含本仓库日期路径、脚本和 Herdr 约定；应改为“可复用基线，项目路径/流程需调整”。
+
+**建议新增规范生命周期**：每项规则记录 proposed/approved/active/deprecated 的规则状态、适用范围、生效提交与 owner；工具能力另记 manual/enforced。这里是规则生命周期，不复用任务 status。
+
+外层系统约束和当前用户授权仍有效；项目内部规则冲突时有明确处理：AGENTS 保存通用硬边界，PROJECT 定义其授权范围内的项目细则，专门 runbook 负责操作流程；客户端入口只引用同一来源，不复制一套近似规则。草案、旧审计和历史报告属于证据，不能自行覆盖生效规则；较新的日期不等于已生效。
+
+此前收口和锁方案未进入当前 dev，说明“已经写好/提交”与“已被所有新任务读取”必须分开。旧任务启动时记录 policy revision，集成前重读当前 dev 的相关生效规则；期间发生变化时做差异检查，不默默套旧规则，也不突然按未来未实施机制阻塞旧任务。
+
+删除 PROJECT 中重复的“当前已无 blocker”等长期硬编码断言，改为引用有日期/制品身份的权威门禁结果。模型、schema、角色可用性等动态值记录在环境/执行收据中；不要在多个入口重复写一份可能过期的“当前值”。
+
+### R08 新增：任务授权记录与例外边界
+
+这是一项规范增强建议，不是声称现有 Agent 已越权。现有手册限制自动审批扩权、push 和破坏性操作，但任务模板只有范围/非目标，没有统一记录“这次到底获准做到哪一步”。
+
+建议任务创建时记录：任务类型（研究/实现/运维）、用户目标、允许写路径、可执行环境、交付终点及明确禁止项。已授权范围内自主持续执行，不在每个 Git/测试步骤重复确认；分析和方案请求默认不包含业务实施。
+
+只有扩大业务范围、增加外部写入、操作未授权环境或破坏性恢复等才重新确认。push 仍遵守明确授权规则；凭证存在不代表允许推送。合理默认写进任务模板，不用每次都问用户一张权限问卷。
+
+紧急/迁移例外需记录 owner、原因、范围、期限/退出条件和恢复动作；例外仅覆盖明确条款。`AGENTS.md:29` 的紧急热修免启动阅读不能被解释为允许主目录直接开发、删库或取消验收。
+
+### R09 落实：先做最小执行门禁，不再只增加禁止句
+
+这是上一治理/锁方案已承认的工程任务，不作为“新发现的缺失要求”重复计数。
+
+**已有证据**：AGENTS 已禁用旧 helper 的 create/remove；源码仍包含省略 dev 起点和强制删除。env-service 的根目录来自脚本所在树，缺少执行目录/锁守卫。CURRENT 第 11 行及关联 MinerU 报告已记录一次 worktree rebuild 引起数据挂载漂移，说明风险并非仅理论；本轮未重演该事故。
+
+**建议实施顺序**：
+
+1. 修 worktree create/remove 的明确基线、主仓定位和安全删除。
+2. 给共享服务写操作加主目录/dev/操作身份/持锁前置检查，明确 status 等只读入口；构建必须校验真实源码与申报 SHA。
+3. 为 CURRENT/MATRIX 提供短锁、增量更新、版本检查，接入已设计 `.locks` 流程；旧锁兼容迁移后才换权威位置。
+4. Git 提交/集成门禁拒绝超范围文件、混入 `.env`/运行产物和错误主干写入。门禁真实负例验收后再记录 enforced。
+
+保持用户确认的 L1 目标，不提前搭建跨机平台或要求 OS 隔离才能使用。代码文件锁、全量资源队列和额外 UI 按已有阶段与实际冲突扩展，优先把当前两个共享文档和 dev 操作做可靠。
+
+### R10 新增：清理负责人和完成后的再检查机制
+
+现有安全清理条件应保留，不放宽“不强删、不覆盖”的红线。需要补的是谁在 Agent 退出之后真正执行清理，以及什么时候重试。
+
+操作规范要求无 Agent/进程 cwd 使用才能移除 worktree；长驻客户端即使完成任务也可能仍占 cwd。任务模板允许 retained-with-reason，但没有下一次检查条件。建议由独立集成/维护执行者在 owner 已退出后检查并清理，记录 `cleanup_owner`、保留原因、证据位置和触发条件；遗留目录分为活跃、保护、待审核、未合入和可清理，不按年龄批量删除。
+
+已合入任务的依赖缓存与唯一截图/日志区别处理：可再生缓存明确登记，唯一证据先保存再移除；只保存路径而不保存文件不是证据归档。清理失败不影响已经通过的业务交付事实，但要保持可追踪的 cleanup pending。
+
+## 4. 两项安全补充观察（非本轮阻塞项）
+
+- **材料不能授予权限**：日志、网页、测试输出、引用文本、Agent 产物可能含命令或“用户已授权”字样，应作为待核实内容。handoff 的授权声明回链到可核实的用户目标/委派范围，不仅凭文档自述执行推送、清理或外部写入。已有自动审批不扩权规则继续保留；这项建议补充来源辨别，不要求 L2 现在落地。
+- **真实证据允许最小化与脱敏**：测试报告可以保存真实执行中足够判定的片段，说明脱敏范围；不要求提交原始完整日志、个人信息、业务正文或截图中的秘密。现有凭证禁入与真实用户数据不复制要求继续有效。真实性约束来源与结论，不能误解成“未经处理的所有材料都要入 Git”。
+
+## 5. 推荐的规范组织
+
+不建议再并列增加一套“总规范 v2”。保留现有路径并收敛职责：
+
+| 位置 | 负责内容 | 移出/减少 |
+|---|---|---|
+| AGENTS | 最小安全红线、任务入口、权限/状态原则、操作指针 | 环境动态值、长命令、历史事件、重复模板索引 |
+| PROJECT | 仓库地图、目标环境、测试入口与模块标准指针 | 重复通用规则、过期发布结论 |
+| worktree runbook | 创建、同步、候选、部署、失败与清理 | 已结束迁移的具体临时目录案例，移入历史交接 |
+| 锁管理 runbook（落地后） | 唯一入口、状态、等待、恢复与兼容版本 | 让 Agent 手动拼锁协议的日常操作 |
+| CURRENT | 活跃任务、当前槽位、1–3 焦点、必要约束链接 | 大量 done 历史行与长复盘 |
+| FEATURE-MATRIX | 能力声明范围、证据、剩余条件 | 逐次操作流水、重复环境快照 |
+| 客户端入口 | 明确引用上述来源 | 复制并稍微改写的第二套规则 |
+| 任务/审查主文档 | 单项工作的范围、决定、证据和交接 | 对相同内容的无意义多文件复制 |
+
+## 6. 改动顺序与验收
+
+**第一批：消除矛盾。** R01、R02、R05、R07 的明确错误先修。检查从所有客户端入口读取后，纯文档、业务修复、暂停交接、取消任务、真实 PI 验收五种场景都得到一致决策。
+
+**第二批：减少流程负担。** 采纳 R03/R04/R06/R08/R10 后更新模板与薄入口；历史只迁移、不删除。验证信息问答不触发无意义写入，实质审计有唯一主产物，代码与测试能形成完整逻辑提交，未完成任务不会被强制 done。
+
+**第三批：工具实现。** R09 与既有 `.locks` 分阶段方案合并为一个实施队列，不重复造项目。用两个并行任务、锁冲突、旧版本共享文档、错误工作区部署、异常退出和清理拒绝的真实证据验收。当前 user-approved 的 L1 防误改边界不变。
+
+规范检查可以自动化为轻量 `doctor/lint`：本地链接、必需字段/状态、过期 waiver、活跃认领冲突、测试入口存在、脚本能力版本与规范声明对齐。没有明确规则契约的模糊 prose lint 不作硬失败，也不为文案偏好构造复杂测试。
+
+## 7. 审查覆盖与可信度
+
+使用 ce-doc-review 非交互只读流程，审查依据为上述实际文件及脚本，而非仅凭历史记忆。
+
+| 审查视角 | 结果 | 本报告处理 |
+|---|---|---|
+| 一致性（独立上下文） | 3 项 | 复用声明/引用合入 R07，焦点上限合入 R04 |
+| 可执行性（独立上下文） | 1 项 | PI 测试筛选问题合入 R02，主审已核对源码 |
+| 范围/减负（独立上下文） | 3 项 | 合入 R03/R04；保留实质审计必须落盘，收窄纯只读豁免 |
+| 安全（独立上下文） | 2 项观察，置信锚 50 | 仅列为 §4 补充观察，不当作已证实漏洞 |
+| 反例审查（独立上下文） | 0 项新增缺陷 | 候选 SHA、失败恢复、累计部署差异等已有引用约束，未重复提出 |
+| 主审当前源核查 | 测试范围冲突、状态模板、提交顺序、动态配置与工具事实 | 补充 R01/R05/R06 等；明确区分改进建议与已知实施项 |
+
+外部第三方 CLI 跨模型复核未执行：本轮未获得向其他外部服务发送仓库文档的显式授权；未以此阻塞会话内独立视角审查。未更改技能或项目配置来伪造关闭该步骤。
+
+未采纳的建议形态：不把纯只读豁免扩大到有持久价值的审计；不把 cleanup_pending 塞进既有任务 status；不要求当前实现 OS 级权限隔离；不因为当前 helper 明确标为未修复，就重复说规范已承诺了不存在的能力。
+
+**已应用规范修正：0。** 上述均是待审核建议。本轮只写审查产物与任务记录，未升级 FEATURE-MATRIX、未改 production_ready、未运行产品测试、未合入 dev 或 push。
+
+## 8. 相关资料
+
+- [当前工作手册](../../AGENTS.md)
+- [项目入口](../../PROJECT.md)
+- [已采纳工作方式](../ops/2026-09-21-agent-worktree-workflow.md)
+- [既有治理方案](../remediation/2026-09-21-agent-workflow-governance-plan.md)
+- `.locks` 补充方案：目前在 `feature/agent-lock-coordination-plan@5987bdcd` 的 `.doc/remediation/2026-09-21-agent-lock-coordination-plan.md`，不在本轮 dev 基线；后续合入时再建立普通相对链接。

.doc/audit/2026-09-21-document-storage-cow-status.md

@@ -0,0 +1,46 @@
+---
+title: "文档存储 CoW（写时复制）现状审计"
+status: done
+created: 2026-09-21
+updated: 2026-09-21
+severity: low
+---
+
+# 文档存储 CoW（写时复制）现状审计
+
+## 背景
+
+用户诉求：上传文档要「几个人传同一份只存一份」，涉及可编辑文档时「考虑 CoW，写入时复制」。本审计确认系统当前的去重与写时复制实现状态，并明确本次收口补齐了什么。
+
+## 现状分析
+
+系统存在两套内容存储，均已采用内容寻址（Content-Addressed Storage, CAS），天然满足去重与 CoW 语义：
+
+### 1. 二进制资产：`internal/storage/cas.go`
+
+- 物理对象表 `storage_blobs` 以 `sha256` 为主键，`ref_count` 记录引用数。
+- 上传命中相同 sha 时（[cas.go](../../internal/storage/cas.go) `storeFileDB`）**不写第二份物理文件**，仅 `ref_count + 1`，并新建一条 `file_references` 逻辑引用。→ 满足「多人传同一文档只存一份」。
+- 文件路径 `blobs/<xx>/<yy>/<sha>.bin` 由内容 hash 唯一决定；`StoreFile` 对已存在 blob **只读不覆写**（命中去重分支直接返回）。内容变化 → hash 变化 → 新路径新文件。→ 即 CoW：修改等价于写入新对象，旧对象不被就地改写。
+
+### 2. 可编辑文档正文：`internal/docrevision/pg_store.go`
+
+- `document_content_blobs` 以 `content_sha256` 为键，`ensureBlobTX` 使用 `INSERT ... ON CONFLICT DO NOTHING`（[pg_store.go:309](../../internal/docrevision/pg_store.go)）。
+- 每次编辑保存生成新 `document_snapshots`，指向新的 `content_sha256`；未变化的正文块复用同一 blob 行。→ 编辑保存不会复制未改动内容，写入时才产生新 blob。→ 满足「可编辑文档 CoW」。
+
+## 结论
+
+- **去重**：物理层早已实现（sha256 + ref_count）；本次补齐的是**逻辑提示**——把 `FileReference.IsDeduplicated` 透出到上传/列表 API 的 `deduplicated` 字段，并在前端附件卡片与文档预览面板展示「重复·已复用」，让"只存一份"对用户可见。跨项目/同项目的逻辑引用记录保留（权限与审计需要），不做合并（已与用户确认方案：物理一份 + 提示）。
+- **CoW**：语义已是事实实现，但**缺防回归守卫**。本次新增 `TestCAS_ImmutabilityCoWContract`（[cas_test.go](../../internal/storage/cas_test.go)）固化契约：① 相同内容重复写入 → 物理 blob 数不变、字节不变；② 内容变化写入 → 新 blob、旧 blob 不被覆写、历史引用仍读原始字节。未来任何"就地改写 blob"的实现都会在测试期失败。
+
+## 严重度
+
+`low` —— 现状正确，本次为可见性增强 + 契约固化，无缺陷修复。
+
+## 关联整改
+
+- 任务：[2026-09-21-upload-parse-ux-dedup.md](../ops/short-term/2026-09-21-upload-parse-ux-dedup.md)
+- 验收报告：[2026-09-21-upload-parse-ux-dedup-test-report.md](../test-reports/2026-09-21-upload-parse-ux-dedup-test-report.md)
+
+## 开放问题
+
+- `storage_blobs.ref_count` 目前只增不减；引用删除（若未来支持资产删除）需配套 decrement 与 blob 物理回收，属后续独立任务，不在本次范围。

.doc/audit/INDEX.md

@@ -13,6 +13,30 @@
 
 ## 核心文档（按阅读顺序推荐）
 
+### 模块耦合现状（2026-09-20）
+
+**文件**: [2026-09-20-module-coupling-audit.md](./2026-09-20-module-coupling-audit.md)
+
+**结论**: 模块化单体与事件总线已在；残留扩散点是 server 具体类型装配、chat/app/coordinator 逻辑环、docgov 词汇泄漏，以及 2026-09-28 到期的 sql_write/path 例外。不改 `production_ready`。
+
+**整改**: [分批计划](../remediation/2026-09-20-module-decoupling-batch-plan.md) · [开发规范](../system-design/2026-09-20-module-development-standards.md)
+
+### 系统全量体检（2026-09-20）
+
+**文件**: [2026-09-20-system-triage-audit.md](./2026-09-20-system-triage-audit.md)
+
+**结论**: 迁移 00054 断链 + 三项 IDOR + taskrun channel panic + 凭证硬编码/暴露为 P0；main 分支与生产 schema 脱节记 backlog。
+
+**整改**: [P0 热修方案](../remediation/2026-09-20-p0-remediation-plan.md) · [short-term](../ops/short-term/2026-09-20-p0-hotfixes.md)
+
+### 可选职责空审核人 CreateOrGetDocument FK（2026-09-17）
+
+**文件**: [2026-09-17-docgov-optional-duty-null-fk.md](./2026-09-17-docgov-optional-duty-null-fk.md)
+
+**结论**: 无 reviewer 职责时 `CreateOrGetDocument` 写 `reviewer_id=0` 触发 FK，被 `ClassifyError` 掩盖为 `INTERNAL_ERROR`；heal 路径已有 `nullIfZero`，创建路径漏改。
+
+**整改**: [short-term](../archive/ops/2026-09-17-docgov-optional-duty-null-fk.md) · branch `fix/docgov-optional-duty-null-fk`
+
 ### FEATURE-MATRIX production-ready 连续性审计（2026-09-16）
 
 **文件**: [2026-09-16-feature-matrix-production-readiness-audit.md](./2026-09-16-feature-matrix-production-readiness-audit.md)
@@ -464,3 +488,6 @@ Day 4-5: Phase C 完善与发布准备（20h）
 ---
 
 *本索引最后更新于 2026-09-12 15:05 UTC*
+
+- 2026-09-17：[系统全面体检](2026-09-17-system-health-check.md)（任务收口 / 缺陷 / 未启用功能；配套 [整改方案](../remediation/2026-09-17-system-health-remediation-plan.md) Wave0–7）。
+- 2026-09-17：[首次加载性能诊断与改进](2026-09-17-initial-load-performance-audit.md)（三入口重启首访；U2 已验收，主 JS ~624 KB；U1/U3–U7 待实施）。

.doc/audit/authorization-matrix-v3-full.md

@@ -43,7 +43,7 @@ AuthN column is **heuristic**; negative-test pointers filled where known.
 | POST | `/api/v1/auth/register` | `s.handleAuthRegister` | `server.go` | handler | see suite |
 | GET | `/api/v1/auth/sessions` | `s.handleAuthSessions` | `server.go` | handler | see suite |
 | DELETE | `/api/v1/auth/sessions/{id}` | `s.handleAuthSessionByID` | `server.go` | handler | see suite |
-| POST | `/api/v1/chat` | `s.handleChat` | `server.go` | session+project | see suite |
+| POST | `/api/v1/chat` | `s.handleChat` | `server.go` | session+project (ERR_NO_PROJECT if unbound + zero memberships) | see suite |
 | GET | `/api/v1/chat/categories` | `s.handleListChatCategories` | `server.go` | session+project | see suite |
 | GET | `/api/v1/chat/dates` | `s.handleListChatDates` | `server.go` | session+project | see suite |
 | GET | `/api/v1/chat/digests` | `s.handleListDailyDigests` | `server.go` | session+project | see suite |
@@ -60,8 +60,8 @@ AuthN column is **heuristic**; negative-test pointers filled where known.
 | GET | `/api/v1/chat/search` | `s.handleChatSearch` | `server.go` | session+project | see suite |
 | GET | `/api/v1/chat/sessions` | `s.handleListChatSessions` | `server.go` | session+project | see suite |
 | POST | `/api/v1/chat/sessions` | `s.handleUpsertChatSession` | `server.go` | session+project | see suite |
-| GET | `/api/v1/chat/stream` | `s.handleChatStream` | `server.go` | session+project | see suite |
-| POST | `/api/v1/chat/stream` | `s.handleChatStream` | `server.go` | session+project | see suite |
+| GET | `/api/v1/chat/stream` | `s.handleChatStream` | `server.go` | session+project (ERR_NO_PROJECT if unbound + zero memberships) | see suite |
+| POST | `/api/v1/chat/stream` | `s.handleChatStream` | `server.go` | session+project (ERR_NO_PROJECT if unbound + zero memberships) | see suite |
 | GET | `/api/v1/chat/turns/{client_turn_id}` | `s.handleGetChatTurn` | `server.go` | session+project | see suite |
 | GET | `/api/v1/chat/unread` | `s.handleChatUnread` | `server.go` | session+project | see suite |
 | GET | `/api/v1/context/cases/recommend` | `s.handleRecommendCases` | `server.go` | handler | see suite |
@@ -131,10 +131,10 @@ AuthN column is **heuristic**; negative-test pointers filled where known.
 | GET | `/api/v1/tasks/run/stream` | `s.handleRunTaskStream` | `server.go` | session+project | see suite |
 | POST | `/api/v1/tasks/run/stream` | `s.handleRunTaskStream` | `server.go` | session+project | see suite |
 | POST | `/api/v1/tasks/runs` | `s.handleCreateTaskRun` | `server.go` | session+project | see suite |
-| GET | `/api/v1/tasks/runs/{run_id}` | `s.handleGetTaskRun` | `server.go` | session+project | see suite |
-| POST | `/api/v1/tasks/runs/{run_id}/cancel` | `s.handleCancelTaskRun` | `server.go` | session+project | see suite |
-| GET | `/api/v1/tasks/runs/{run_id}/events` | `s.handleTaskRunEvents` | `server.go` | session+project | see suite |
-| POST | `/api/v1/tasks/runs/{run_id}/resume` | `s.handleResumeTaskRun` | `server.go` | session+project | see suite |
+| GET | `/api/v1/tasks/runs/{run_id}` | `s.handleGetTaskRun` | `server.go` | session+project member (view) | see suite |
+| POST | `/api/v1/tasks/runs/{run_id}/cancel` | `s.handleCancelTaskRun` | `server.go` | session+run owner or project owner | see suite |
+| GET | `/api/v1/tasks/runs/{run_id}/events` | `s.handleTaskRunEvents` | `server.go` | session+project member (view) | see suite |
+| POST | `/api/v1/tasks/runs/{run_id}/resume` | `s.handleResumeTaskRun` | `server.go` | session+run owner or project owner | see suite |
 | GET | `/api/v1/workflow-instances/{id}` | `s.handleGetWorkflowInstance` | `server.go` | session+project | see suite |
 | POST | `/api/v1/workflow-instances/{id}/stages/{stage}/advance` | `s.handleAdvanceStage` | `server.go` | session+project | see suite |
 | GET | `/api/v1/workflow-instances/{id}/stages/{stage}/readiness` | `s.handleGetStageReadiness` | `server.go` | session+project | see suite |

.doc/backlog/2026-09-17-rdev-phase2-backlog.md

@@ -0,0 +1,75 @@
+# rdev 研发工作流二期增强 Backlog
+
+> 来源：[07-研发工作流rdev接入-设计与实施计划](../system-design/project-workflow/07-研发工作流rdev接入-设计与实施计划.md) §8 决策 3——首期 N/A 采用「激活规划期关闭」，以下增强项不阻塞首期交付，**用户要求记录以便随时续推进**。
+> 创建：2026-09-17。每项建议独立 short-term 任务认领。
+
+## 优先级排序（建议）
+
+### R1 N/A 不适用页生成模式（对齐参考项目行为）
+
+- 现状：skippable 任务在激活规划期由创建者关闭 = 不适用；
+- 目标：保留任务但可生成「不适用说明页」（完整论述理由而非一句话），仍走审核/批准，再进入下一阶段（参考项目 rdev_software overlay 语义）；
+- 涉及：manifest 不适用模式标记、bizdev 执行 N/A 生成路径、squad N/A 编排、前端规划 UI「保留但声明不适用」选项；
+- 验收：软件类任务声明不适用 → 生成完整不适用页 → 审批通过 → 阶段可推进。
+
+### R2 UR/RS 结构化质量门禁（复用 PM requirements.json 模式）
+
+- **状态**：✅ **done**（2026-09-19）— `rd_user_needs` / `rd_system_reqs` 在 `QualityGate.Validate` 中检查连续编号、禁止随机抽取、验证准则与正文/JSON 一致。`pm` 的 `system_reqs` 仍走原有检查。
+- 范围：`rd_user_needs`、`rd_system_reqs`（及 `pm_system_reqs`）输出结构化需求集合；确定性门禁：ID 唯一连续、不随机抽取、缺验证准则拒绝、正文/JSON 不一致拒绝；
+- 参考先例：`quality.system_reqs.v2`。
+
+### R3 review_minutes / upload_index 专用确定性门禁
+
+- **状态**：✅ **done**（2026-09-19）— 评审记录拒绝空洞「同意通过」；附件清单要求索引表与影响分析。`TestRDevQualityGates`。
+
+- review_minutes（6 个评审记录）：问题-决议-行动项闭环检查（拒绝空洞「同意通过」、行动项无责任人/期限）；
+- upload_index（7 个附件清单）：附件索引表存在性、缺失影响分析存在性检查；禁止伪造附件内容靠 Accept 纪律 + 门禁抽查「待上传后更新」结论。
+
+### R4 depends_on 精确血缘与 stale 传播
+
+- 现状：rd 任务 prior docs 全量注入 + 摘要级血缘；
+- 目标：per-task upstream 声明表（对齐参考项目 rdev.yaml depends_on：rd_planning_review ← rd_proposal+rd_design_plan、rd_verification_review ← rd_design_vv+rd_risk_report_v 等），上游新版本批准 → 下游 stale 且不能完成；
+- 参考先例：test_manager 对 approved SR 的 stale 传播（projectworkflow/service.go）。
+
+### R5 DMR 双记录归档
+
+- 参考项目 `records: [dhf, dmr]` 的设计输出/转换文档在本仓库无对应物；需评估文档「记录归属」字段扩展 + 归档/导出按 DHF/DMR 分类（本仓库无云盘，先落 docgov 元数据与导出分类）。
+
+### R6 软件工作流任务键 `sw_` 前缀盘点（并入 P4 或其后）
+
+- `software_bootstrap`/`software_delivery`（executor `software.doc.v1`）任务键盘点并纳入统一命名空间规约（D12 的遗留尾巴）。
+
+### R7 高复杂度 regulatory 步注入策略
+
+- 现状：D7 中 regulatory 按任务清单静态注入；目标：接 `complexity_tier`（complexity_high/medium 分层）动态注入，对齐参考项目 `when: complexity_tier=high`。
+
+## 依赖关系
+
+- R2/R3 可并行；R4 依赖 manifest 落地后的 upstream 声明表；R1 独立；R5/R6/R7 低优先级。
+
+---
+
+## 模板深度与运行时续批（S1 续批 / S2 / S3）
+
+> 来源：Kimi 分析方案 + [2026-09-17-rdev-template-depth](../archive/ops/2026-09-17-rdev-template-depth.md) 收口。S0 + S1 首批（14 份）已交付；以下不阻塞本轮合并候选。
+
+### S1 续批 — 剩余模板专业章节
+
+- **状态**：✅ **done**（2026-09-17）— 46 份全部同等深度补强；allowlist 60/60；真 PI `rd_planning_review` + `rd_design_vv` PASS
+- **证据**：[测试报告](../test-reports/2026-09-17-rdev-template-depth-s1-continued-test-report.md)；[short-term](../ops/short-term/2026-09-17-rdev-template-depth-s1-continued.md)
+
+### S2 — 运行时编排与配置化
+
+- **状态**：✅ **done**（2026-09-19，`fix/audit-remainder-closeout`）
+- per-stage 步骤覆盖（相对默认 organize→engineer→draft→review 的阶段差异）
+- regulatory 步接 `complexity_tier`（与 R7 可合并认领）
+- 模型去硬编码（配置/环境驱动）
+- manifest hint + aliases 元数据补齐
+- **证据**：`TestRDevRegulatoryFollowsComplexityTier`、`TestRDevModelFromEnv`、`TestRDevStageOverrideAndAliases`
+
+### S3 — overlay 与质量门禁扩面
+
+- **状态**：部分（2026-09-19）。overlay 与 R2/R3 已落地；P3 真 PI 未做
+- 轻量 overlay 机制（模板管结构；overlay/运行时管纪律与粒度下限）— done，`configs/overlays/`，`TestRDevWorkspaceWritesOverlay`
+- R2/R3 专用确定性门禁落地 — done，`TestRDevQualityGates`
+- P3：三样本真 PI E2E 报告 + CI 四工作流门禁挂钩 — 未做

.doc/backlog/chat-agent-p6-backlog.md

@@ -5,6 +5,6 @@
 - **B5** 报价模块接入轻量复核与输入范围校验（`internal/quote/`）
 - **A5/A6** 小队工作流支持非关键步骤降级；并行 trace 序号改单次加锁读-算-写（`internal/squad/`）
 - **A7** 将中文注释中的已知限制迁移为正式 issue
-- **D3** 摘要引擎替换为语义摘要（依赖模型接入，需单独评估）（`internal/ctxmgr/summarizer.go`）
+- **D3**（已实现，shadow）摘要引擎语义摘要能力已落地：`SEMANTIC_SUMMARY_SHADOW` 默认 off，见 [FEATURE-MATRIX「语义摘要（D3）」行](../status/FEATURE-MATRIX.md)、[PU6 契约](../ops/long-term/2026-09-16-pu6-semantic-summary-contract.md)（`status: done`）、[W2 真 PI 报告](../test-reports/2026-09-17-w2-semantic-summary-shadow-test-report.md)。`SEMANTIC_SUMMARY_REPLACE` 仍未接线（红线，需独立授权）。本行状态转入 FEATURE-MATRIX 常态跟踪，不再作为独立 backlog 开放项
 - **D5** 知识库按环境隔离方案评估（当前三环境共享 KB 为 intentional 架构）
-- **D7** 对话数据留存期限与敏感字段加密（先对齐合规再定技术方案）
+- **D7** 对话数据留存期限与敏感字段加密——草案 ADR [2026-09-17-d7-chat-data-retention.md](../adr/2026-09-17-d7-chat-data-retention.md)（`compliance: pending-compliance-signoff`）；[W7 只读盘点](../audit/2026-09-17-d7-data-inventory.md) 未发现基线违规，见 [报告](../test-reports/2026-09-17-w7-d7-inventory-test-report.md)。签字前禁止按 365/180/30 物理删除；本行继续跟踪合规签字进度

.doc/ops/2026-09-13-herdr-agent-roster.md

@@ -1,94 +1,110 @@
-# Herdr Agent 角色、审批与备援 SSOT
+# Herdr 多 Agent 编排 v1.2
 
-**更新**: 2026-09-13
-**owner**: `orchestrator_codex`
-**status**: active
+更新：2026-09-21；owner：Herdr 任务协调者；本轮规范修订 `herdr-v1.2`。本文件是 Herdr 角色、额度、审批与备援的唯一来源，取代原 2026-09-13 路由。实现/核验见[任务记录](../archive/ops/2026-09-21-herdr-orchestration-v12.md)。
 
-本文只管理工程协作终端，不管理产品运行时智能体。通用分支、worktree、mutex、集成槽、密钥和破坏性操作规则仍以仓库根 [AGENTS.md](../../AGENTS.md) 为准。
+## 1. 生效范围与前提
 
-## 1. 身份边界
+**仅在明确使用 Herdr 编排、启动或派发任务时适用本表分工。** 普通 Codex、Claude Code、Cursor 独立会话，以及仅研究/编辑本规范的任务，不自动套用 Cursor 唯一实施通道，也不自动启动多 Agent。通用授权、分支、锁、验证、清理始终遵循 [AGENTS](../../AGENTS.md) 与 [worktree 操作规范](./2026-09-21-agent-worktree-workflow.md)。
 
-| 名称 | 唯一含义 | 禁止混称 |
-|------|----------|----------|
-| Herdr PI / `context_pi` | Herdr pane 内运行的 PI CLI，当前目标模型 MiniMax M3，负责工程调研与长上下文分析 | 不代表后端 runner，不作为产品 E2E 证据 |
-| 产品 PI Agent Runner | Compose/服务端调用的产品执行器；模型与验收要求见 PROJECT | 不参与 Herdr 工程任务路由 |
+只有 `HERDR_ENV=1` 才能查看/控制当前 Herdr 会话；外部会话可读规范、跑 dry-run 与隔离测试。用户已授权这些客户端自动通过工具请求；不为已授权步骤再等待人工批准。自动审批不产生额外环境、外部写入或破坏性操作授权。
 
-文档、提示词和 handoff 中禁止只写“PI”；必须写 `context_pi` 或“产品 PI Agent Runner”。
+Herdr 中的 PI CLI（例如 `context_pi`）是工程协作客户端；Compose 中“产品 PI Agent Runner”是业务执行器。二者不共享验收结论，不修改产品模型配置来满足本表。
 
-## 2. 稳定角色
+## 2. 资源与取舍
 
-| 逻辑名 | 客户端 / 目标模型 | 主责 | 工作量策略 | 首选备援 |
-|--------|-------------------|------|------------|----------|
-| `orchestrator_codex` | Codex / GPT Sol 5.6 | 需求澄清、系统方案、任务拆解、调度、跨模块风险、代码终审、发布判断 | 保留推理容量，原则上不承担大批量机械实现 | `context_kimi`；关键争议才用 `reserve_claude` |
-| `implementer_cursor` | Cursor / Auto | 前后端实施、测试补齐、重构、浏览器验证、按 checklist 收口 | 主力实施席，承担最大常规工作量 | `implementer_cline` → `verifier_antigravity` → `orchestrator_codex` |
-| `verifier_antigravity` | Antigravity / Gemini 3.8 Flash | 快速只读排查、测试设计、文档核对、日志归纳、低风险小修 | 低成本高频；不得单独作安全或发布终审 | `implementer_cline` → `implementer_cursor` |
-| `context_pi` | PI CLI / MiniMax M3 1M | 全仓长上下文扫描、文档/代码交叉研究、候选清单、handoff 压缩 | 长材料首选；结论由 Codex 或 reviewer 复核 | `context_kimi` → `orchestrator_codex` |
-| `context_kimi` | Kimi Code / Kimi K3 1M | PI 备援、长文档审查、跨文件一致性检查、方案反证 | 额度有限，优先作长上下文备援而非日常实现 | `context_pi` → `orchestrator_codex` |
-| `implementer_cline` | Cline / GLM 5.3 Flash | 机械实现、测试修复、格式化、重复性迁移、Cursor 备援 | CLI 已可调用；进入主路由前需完成一次隔离 worktree 写验收 | `implementer_cursor` → `verifier_antigravity` |
-| `reserve_claude` | Claude Code / Sonnet 5 | P0/P1 架构争议、安全关键复核、Codex 失败后的第二强意见 | 额度极少，禁止日常调研、批量实现和首轮测试 | `orchestrator_codex` → `context_kimi` |
-| `reserve_devin` | Devin / 尚未接入 | 预留长任务自治席 | `standby`，不得派发 | 无 |
+订阅价格与个人额度优先级来自用户本次说明，是预算输入，不是实测余额或供应商无限量承诺。
 
-模型名称来自当前工作区约定；启动脚本不猜测各 CLI 的模型别名。每次新会话由 orchestrator 在首条状态回报中确认实际模型，不一致则停止高风险任务并记录 handoff。
+| 资源 | 用户预算 | Herdr 纪律 |
+|---|---|---|
+| Cursor Ultra | $200/月，实施优先 | 默认唯一产品代码实施通道；高额度仍监测限流/余额，不自动开启额外付费 |
+| Qwen 3.8 max/flash | 百炼最高档，充裕 | max 分析、报告、监督判断；flash 例行检查和执行已有测试 |
+| GLM 5.3/flash | 高档 token plan，充裕 | 规划、执行跟踪、代码审查；模型额度共享时不把两个客户端当两份预算 |
+| MiniMax M3 | ¥119/月，中等 | 失败归因、二线审查；每个失败问题至多两轮归因，重复失败转交带证据复核 |
+| Kimi Code | ¥699/月，个人调研/报告优先 | Herdr 默认不用；仅可选正式报告终稿检查，或有理由的应急借用；合计每逻辑任务最多一次 |
+| Codex / GPT-6 | 稀缺 | 终审仲裁、高歧义与两轮审查仍未解决的争议；不作日常监督/机械实施 |
+| agy / Antigravity | 最低档，极少 | 轻量杂活与测试想法；耗尽转 flash，不做高频轮询或安全终审 |
 
-## 3. 任务泳道与自动备援顺序
+修正“Cursor 订阅不限量”：官方[用量说明](https://prod.cursor.com/help/models-and-usage/usage-limits)仍描述用量池/限制。其他“充裕”也只是调度优先级，任务开始记录 available/low/exhausted/unknown；unknown 不等于无限。价格不写进程序阈值。
 
-| lane | 适用任务 | 路由顺序 |
-|------|----------|----------|
-| `governance` | 方案、拆解、跨模块决策、普通 review | Codex → Kimi → Cursor → Claude |
-| `critical-review` | 鉴权、安全、迁移、发布 blocker 终审 | Codex → Claude → Kimi |
-| `implementation` | Go/React/SQL 实施与测试 | Cursor → Cline → Antigravity → Codex |
-| `ui` | React、交互、Playwright | Cursor → Antigravity → Cline |
-| `test` | 单测、集成测试、失败定位 | Cursor → Cline → Antigravity |
-| `fast-check` | 日志、静态核对、文档一致性、小修 | Antigravity → Cline → Cursor |
-| `long-context` | 全仓/全量文档审读、证据汇总 | PI → Kimi → Codex |
+## 3. 角色、客户端与路由
 
-Claude 只在 `critical-review` 中作为前排备援；其他 lane 放在最后或不进入路由，以保护额度。Codex 的实现兜底只用于阻塞交付的关键路径。
+模型路由基于本机帮助和已配置别名，启动后还须确认实际模型。`pi --list-models` 只证明配置目录可识别，不证明账户余额、远端可用或本任务真实输出质量。
 
-## 4. 自动派发和接管协议
+| 角色 / lane | 默认 → 备援 | 交付边界 |
+|---|---|---|
+| 例行监督 `supervision` | qwen_flash → qwen_max → verifier_antigravity | 读任务/测试/锁状态；阻塞判断交 max，僵局显式 critical-review |
+| 需求分析 `analysis` | qwen_max → qwen_flash | 可验收需求、歧义、边界；高歧义显式终审升级 |
+| 规划 `planning` | reviewer_glm → qwen_max → glm_pi | 步骤、依赖、允许写范围、测试计划 |
+| 执行计划 `execution` | reviewer_glm → qwen_max | 调度、跟踪、核对产物；不与实施者同时改产品代码 |
+| 实施 `implementation` / `ui` | implementer_cursor | 可运行改动、回归测试；仅明确写入接管理由时追加 reviewer_glm → qwen_max |
+| 代码审查 `code-review` | reviewer_glm → context_pi | 对冻结 diff 独立审查；两轮未过显式 critical-review |
+| 系统测试 `test` | qwen_flash → verifier_antigravity | 执行确定性测试命令；不能以“模型判断通过”替代进程退出码与断言 |
+| 失败归因 `test-analysis` | context_pi → reviewer_glm | 可重现输入、原因、最小修复建议；修复回实施通道 |
+| 报告 `report` | qwen_max → qwen_flash | max 写交付稿；flash 仅草稿，须回 max 定稿 |
+| 报告二审 `report-review` | reviewer_glm | max 自审后，GLM 独立查来源/逻辑/未验收声明 |
+| 可选终稿 `report-final-check` | context_kimi | max 完成正式交付稿后，至多一次，非每任务必经 |
+| 终审 `critical-review` | orchestrator_codex → reviewer_glm | GPT-6 仲裁；GLM 若是原作者/审查者须独立上下文并补跨模型复核，未解决风险保留 blocked |
+| 轻量杂活 `fast-check` | verifier_antigravity → qwen_flash | 小范围静态核对和整理 |
+| 长材料 `long-context` | qwen_max → glm_pi | 相关证据扫描，不默认占 Kimi |
+| 特例借用 `quota-emergency` | context_kimi | 百炼等故障、任务确需借个人额度；与终稿入口共用一次计数 |
 
-1. Orchestrator 先创建 short-term、认领 mutex、建立独立 worktree；之后才启动或选择 agent。
-2. 实例必须使用上表逻辑名，且 `cwd` 必须与任务 worktree 完全相同。派发器不会占用名称不规范或其他目录的实例。
-3. 只向 `idle` / `done` 实例投递。同一 mutex 同时只允许一个执行者写入。
-4. 以下情况可自动尝试下一个备援：实例不存在、启动前已 blocked、认证失败、明确额度耗尽、客户端在写入前失败。
-5. Agent 只有在尚未写文件、未运行有副作用命令时，才可返回派发器给出的本次唯一 `HERDR_RETRY:<dispatch-id>:<reason>` 行触发降级。
-6. `timeout`、`agent_prompt_stalled`、`unknown` 或无终态标记均不能证明任务未执行；派发器必须停止，不得盲目重投。先读取 pane，必要时写 handoff。
-7. 接管前确认原实例不再 `working`；有部分改动时由原实例或 orchestrator 写 handoff，备援串行续作，不得并发覆盖。
-8. Review 可由不同 worktree 的多个只读实例并行；写任务仍受 mutex 单写者约束。
+兼容旧 lane `governance` 转到规划 GLM → max，已移除日常 Codex/Kimi 路由。Cline、Devin 和旧 `reserve_claude` 不在 v1.2 活跃路由；Claude Code 是客户端名称，本机路由到 GLM，不把它算作另一份 Claude 高端模型额度。
 
-## 5. 自动审批不是无限授权
+| profile | 标准逻辑名 | 启动选择 |
+|---|---|---|
+| claude | reviewer_glm | Claude Code `--model opus`，本机 Opus 别名配置为 GLM 5.3；不修改全局配置 |
+| codex | orchestrator_codex | 默认已配置 GPT-6；仅角色名称兼容旧脚本，其职责收窄为终审 |
+| cursor | implementer_cursor | cursor-agent 的已配置模型 |
+| pi-max | qwen_max | qwen-token-plan-cn / qwen3.8-max |
+| pi-flash | qwen_flash | qwen-token-plan-cn / qwen3.8-flash |
+| pi-glm | glm_pi | zai-coding-cn / glm-5.3 |
+| pi | context_pi | minimax-cn / MiniMax-M3 |
+| kimi | context_kimi | Kimi Code 已配置模型 |
+| antigravity | verifier_antigravity | agy 已配置模型 |
 
-统一入口为 [`scripts/herdr-agent-start.sh`](../../scripts/herdr-agent-start.sh)。当前安装版本验证过的参数如下：
+独立上下文审查有价值，但规划和审查都用 GLM 仍可能同源盲点；高风险争议增加 MiniMax/GPT-6 跨模型意见。简单任务采用“实施 → 验证/审查 → 收口”最短路径，不强制走九个角色；大任务按依赖拆分，最多一个产品代码写者/重叠范围，独立 worktree 可并行。
 
-| profile | 自动审批参数 | 保留的边界 |
-|---------|--------------|------------|
-| Claude | `--dangerously-skip-permissions` | 仍受本规范和任务提示约束 |
-| Codex | `--ask-for-approval never --sandbox workspace-write` | 保留 workspace 沙箱；失败回传模型，不询问人工 |
-| Cursor | `--force --sandbox enabled --approve-mcps --trust` | 保留 Cursor 沙箱和显式 deny |
-| Antigravity | `--dangerously-skip-permissions --sandbox` | 保留其终端沙箱 |
-| PI | `--approve` | 信任项目本地文件；该 CLI 没有独立的逐工具审批开关 |
-| Kimi | `--auto` | Never Ask 模式 |
-| Cline | `--tui --auto-approve true` | 所有工具自动批准 |
+## 4. 预算闸门
 
-即使客户端不弹确认框，Agent 也不得自行执行：删库/清空数据、强推、删除主干或 worktree、停止 Herdr server、覆盖其他 Agent 未合并改动、泄露密钥、未获用户授权的外部写入。需要新权限时写 handoff/blocker，不把确认框转交给用户逐条点击。
+- 每任务记录一个不可随子任务/重试变化的 task_id、角色调用、升级原因、审查/归因轮次、实际来源与结果。轮询优先直接读机器状态，只在状态改变或阻塞时调用模型。
+- Kimi 默认不进入普通分析、代码审查、测试归因或报告撰写备援。协调者在既有授权内判断是否值得调用，显式填 `--kimi-reason`，不用再向用户索取工具批准。
+- 派发器在发送前向主仓 `.locks/state.sqlite` 的 `herdr_kimi_uses` 原子登记；同一 task_id 两个入口合计 ≤1。发送失败/结果未知也占用，不自动退款，不通过新 task_id 重置。此计数是一次投递，不是模型内部工具轮数或真实账单 token 上限；输入只含最终稿/必要来源，禁止继续发多轮 Kimi。
+- 个人调研额度告急时，协调者在主仓 `.locks/herdr-kimi.disabled` 留停用标记，所有后续受管 Kimi 派发拒绝；确认恢复后移除此标记。它不控制个人在 Herdr 之外的 Kimi 主业，也不能自动读取个人用量。
+- Kimi 停用：max 自审 + GLM 二审。GPT-6 耗尽：GLM 复核；仅交付文档可以用尚未使用的 Kimi 终稿检查，不能拿文稿检查顶替代码安全/发布终审。百炼故障先用 GLM/MiniMax 支撑，确需 Kimi 才借用；故障消除即回原通道，不形成新默认。
+- 机器强制范围是统一派发入口的一次计数；直接在 Kimi pane 手工发问可绕过，禁止据此声称全账户硬限额已完成。MiniMax 轮次/GPT 升级由任务记录管理，尚无跨供应商余额 API。
 
-## 6. 操作入口
+## 5. 自动通过请求与实际启动
 
-在任务 worktree 的 Herdr pane 中启动标准实例：
+所有 Herdr 启动均走 [start](../../scripts/herdr-agent-start.sh)；仅影响该次进程参数，**不改个人客户端的全局审批设置**。以下来自本轮安装 CLI `--help`，不是猜测同名产品能力。
+
+| 客户端 | 参数 | 说明 |
+|---|---|---|
+| Claude Code | `--dangerously-skip-permissions --model opus` | 自动通过工具权限，使用用户已配置 GLM 别名 |
+| Codex | `--ask-for-approval never --sandbox danger-full-access` | 不再等待批准；授权内操作仍须 agentctl/Git 门禁 |
+| Cursor | `--force --sandbox disabled --approve-mcps --trust` | Run Everything + MCP 自动批准 + workspace trust；显式 deny 仍有效 |
+| agy | `--dangerously-skip-permissions` | 自动通过工具请求，不再添加旧脚本的限制性 sandbox |
+| PI CLI | `--approve` + 明确 provider/model | 内置工具本就无逐工具弹窗；该参数处理项目文件信任，不能说它关闭了不存在的权限系统 |
+| Kimi | `--auto` | Never Ask；`--yolo` 仍可能询问，不替代 auto |
+
+[Cursor 参数](https://cursor.com/docs/cli/reference/parameters)、[Kimi 参数](https://www.kimi.com/code/docs/en/kimi-code-cli/reference/kimi-command)、[Claude 参数](https://code.claude.com/docs/en/cli-reference)与本机帮助一起核对。CLI 升级后先重新核验 flags；外部认证、显式 deny、企业策略或扩展交互无法由统一参数保证消失，失败写 blocker，不反复向用户弹批准，不擅自清除已有安全规则。
 
 ```bash
-./scripts/herdr-agent-start.sh codex orchestrator_codex <pane-id>
-./scripts/herdr-agent-start.sh cursor implementer_cursor <pane-id>
+# 先用 agentctl 注册 task-id。名称可用 base__短任务后缀，完整长度最多 32。
+./scripts/herdr-agent-start.sh --dry-run pi-max qwen_max__demo w1:p2
+./scripts/herdr-agent-start.sh --task task-id pi-max qwen_max__demo w1:p2
+./scripts/herdr-agent-dispatch.sh --explain report
+./scripts/herdr-agent-dispatch.sh --task task-id report '根据已提交证据撰写报告'
+./scripts/herdr-agent-dispatch.sh --task task-id --kimi-reason '正式报告的一次终稿核验' report-final-check '核验最终稿与来源'
+./scripts/herdr-agent-dispatch.sh --task task-id --implementation-fallback 'Cursor 额度已耗尽，已核对无在途写入' implementation '接续已登记范围'
 ```
 
-预览某泳道路由，或自动投递：
+启动/派发仅接受注册任务的直接 `.worktrees` 工作区；目标 pane/agent cwd 必须匹配。标准名后缀支持不同任务同时有自己的同角色 Agent；同任务同角色出现多个可用实例时拒绝歧义。旧命名实例先由其 owner 完成/交接，不自动抢占、改名或停止。
 
-```bash
-./scripts/herdr-agent-dispatch.sh --explain implementation
-./scripts/herdr-agent-dispatch.sh implementation "读取任务文并完成已认领范围，验证后写 handoff。"
-```
+## 6. 监督、失败、恢复与交接
 
-派发器只处理规范命名且已在线的实例，不擅自创建 pane、不重启 agent、不抢集成槽。缺少实例时由 orchestrator 用启动脚本补齐。
-
-## 7. 当前可用性基线
-
-2026-09-13 现场基线：Herdr client/server 0.9.0、协议 22；Claude/Codex/Cursor/Antigravity/PI/Kimi 集成已安装且 current；Cline CLI 3.0.61 可调用，但尚无在线标准命名实例；Devin 尚未接入。在线状态是瞬时信息，派发前必须重新运行 `herdr agent list`。
+1. 协调者读取任务与本规范，确认预算、角色、分支、允许写路径、实际客户端/模型和精确 head。启动后核验身份；标准名字只能表达意图，不能证明客户端模型没被手工切换。
+2. Herdr 的新 pane 不是 `agentctl with` supervisor 的子进程；禁止把短命令租约凭据复制进去。worker 按每条写命令取自己的任务 path 租约，提交另取 git:index；共享 CURRENT/MATRIX 用 docs apply。监督者不长期持有所有资源锁。
+3. 只投递同任务的 idle/done Agent；已工作/blocked/unknown 不发第二份。等待最多 60 秒；超时只观察，不把超时当未执行或自动终止任务。
+4. 已选实例的 prompt RPC 出错统一视为可能已发送，不根据输出里出现 quota/auth 字样自动转发。只有已 settled 且返回本轮唯一 HERDR_RETRY 标记、明确未写入/无副作用时才可备援；仍是合作协议，不是任意工具副作用的机器证明。
+5. 不抢主目录、不切他人分支、不覆盖旧 CURRENT；合入/环境验收由独立协调者按机器锁串行处理。模型返回“完成”不等于测试通过或 dev 已部署。
+6. 每次交接含冻结 SHA、改动范围、实际验证/缺项、未完成副作用、下一执行者与预算用量。owner 退出并确认文件/进程/祖先证据后再清理；异常现场保留 cleanup_pending，不强删。

.doc/ops/2026-09-17-author-only-pilot-toggle.md

@@ -0,0 +1,22 @@
+---
+title: "dev 试点：开放编制人兼任总开关"
+status: done
+created: 2026-09-17
+updated: 2026-09-17
+---
+
+# dev 试点：开放编制人兼任总开关
+
+## 结论
+
+在运行中的 `agent-dev`（`:8080`，schema 52）经 admin CAS 将 `workflow.allow_author_only_approval` 设为 `true`（revision `0 → 1`）。**未**改默认迁移值；**未**晋升 test/main；test/main 仍保持默认 off。
+
+## 证据（脱敏）
+
+- [before-enable.json](../../test-reports/assets/2026-09-17-author-only-pilot/before-enable.json)
+- [put-enable.txt](../../test-reports/assets/2026-09-17-author-only-pilot/put-enable.txt)
+- [after-enable.json](../../test-reports/assets/2026-09-17-author-only-pilot/after-enable.json)
+
+## 关联
+
+- author-only 收口：[../handoffs/2026-09-17-document-author-only-closeout.md](../handoffs/2026-09-17-document-author-only-closeout.md)

.doc/ops/2026-09-21-agent-worktree-workflow.md

@@ -0,0 +1,133 @@
+# Agent worktree 与 L1 操作规范
+
+**修订**：`agent-governance-2026-09-21-r1`。来源：[AGENTS](../../AGENTS.md)、[规范登记](./2026-09-21-policy-registry.md)。工具为 `scripts/agentctl`（Python 标准库，Linux 本机），协议 v1；实际安装与验证见[实施任务](../archive/ops/2026-09-21-agent-governance-implementation.md)。
+
+本规范约束合作 Agent 的统一操作入口和 Git 提交/引用门禁。任意同 UID shell、修改管理器或跳过 hooks 仍可绕过；不把 L1 宣称为 OS 沙箱。共享服务配置与产品数据库不属于任务素材。
+
+## 1. 首次启用与旧锁兼容
+
+由获授权协调者在干净主目录 dev 执行一次：
+
+```bash
+./scripts/agentctl init
+./scripts/agentctl hooks install
+./scripts/agentctl doctor
+```
+
+`init` 只在主目录运行；明确初始化主仓唯一 `.locks/state.sqlite` 和身份文件，不能从 linked worktree 自动建立第二套状态。现有 `.git/agent-control/dev-integration.lock` 保留，用硬链接使 `.locks/os/dev-integration.lock` 指向同一 inode；旧操作未结束、旧锁忙或新旧身份不符均拒绝迁移。状态目录整体被 Git/Docker 忽略，禁止自行删锁/删库/复制 WAL/重建空目录。
+
+`status`、`doctor` 只读，未初始化返回结构化错误而不创建文件；每次打开管理库都会核对旧新 dev 锁身份。`hooks install` 拒绝覆盖外来 hook 或既有自定义 hooksPath；不能把别人的保护脚本直接替换掉。启用前必须完成主目录集成，并让旧任务在下一次写/集成前读取本修订。
+
+## 2. 创建任务并登记范围
+
+从任一同仓工作区使用已验证工具：
+
+```bash
+./scripts/agent-worktree.sh create feature/task-id
+# 输出 worktree 路径和本次实际 base_dev_sha；所有新任务显式来自当前 dev。
+cd .worktrees/task-id
+../../scripts/agentctl task register --id task-id --owner Codex --scope internal/example --scope .doc
+```
+
+示例名称、范围应替换为实际 task_id 与最小写范围；要维护 CURRENT 自己的行，task_id 与该行 task 字段一致。工具定位唯一主仓，不在任务区嵌套 `.worktrees`。分支只接受 `feature/<task-id>` 或 `fix/<task-id>`，重名/路径占用/符号链接均拒绝。旧目录清理由 Git 真实映射定位，不按名字猜测。
+
+任务登记保存 owner、分支、worktree、源提交、允许写路径和能力；不隐式扩展已有登记。任务 scope 是允许范围，实际写许可由每次 `with` 获取。文件路径为仓库相对路径或目录前缀，`.` 表示全仓源文件范围，仅供明确需要的治理/集成任务；不能登记 `.git`、`.locks` 或运行数据作为源码写范围。
+
+特殊能力按任务授权登记，例如 `--capability docs:publish`、`git:dev`、`env:dev`；test/main/shared 能力不能由普通 dev 任务顺带申请。能力字段记录的是已授予的任务边界，不自行产生用户授权。
+
+## 3. 写操作与长驻客户端
+
+```bash
+# 每次命令包裹完整操作；不是先拿一次 fd 锁，再换一个 shell 假定仍持有。
+../../scripts/agentctl with --task task-id --resource path:internal/example -- <command> <args>
+
+# Git 暂存/提交用同一 supervisor 包住，另持任务自身的 index 锁。
+../../scripts/agentctl with --task task-id --resource path:internal/example --resource git:index -- <git-write-script>
+```
+
+`with` 可包裹任务客户端或包含多条命令的受控脚本；不必由模型手工续租。它是非重入操作锁：不在持有某资源的 child 中再次申请同一资源。长期 worker 只持实施路径，不长期占共享文档/集成资源；提交、共享文档更新和 task close 由协调者在 worker 退出后以新的短操作完成。需要自主逐步提交的客户端使用逐命令 `with`，不套全任务的大锁。默认 child cwd 为登记的任务 worktree，只有明确环境/集成操作可选择主目录。代码审查、查询或读取不可变 Git 快照不必持写锁。`--shared` 仅供稳定读取，不能通过写操作 guard。
+
+锁资源支持目录层级冲突；多个资源一次申请、全部获准才启动 child。同任务不同路径可并发；index 单独排他。每个执行器持工作区生命周期 SH 锁，删除必须取得 EX，防止检查完清理后又进入新任务。`--wait` 为有限秒数，默认立即拒绝冲突；失败给 request_id/holder，可做不冲突工作或用原 request_id 重试。没有后台无限排队服务，也不需要常驻产品容器。
+
+会话身份包含 PID/start-time/boot、操作代次与 epoch；继承凭据只对真实 supervisor 的子孙进程有效。锁不会因超时自动转给别人；异常进程和未完成 operation 保留恢复状态。SIGINT/SIGTERM、孤儿子进程和未完成文档写回按实现的恢复门禁处理。
+
+## 4. 共享文档：短锁、行版本和写回收据
+
+当前提供 CURRENT 与 FEATURE-MATRIX 的受控更新；普通任务只改 CURRENT 中自己的 task 行，不能覆盖别人的状态或自行释放槽位。模块行使用现有唯一模块名称定位；重复/歧义 ID 拒绝。发布入口不是对旧文件的整份覆盖。
+
+```bash
+../../scripts/agentctl docs snapshot --file .doc/ops/CURRENT.md --record task-id
+../../scripts/agentctl docs apply --task task-id --request /tmp/task-state-delta.json
+```
+
+请求格式（示意，hash 使用 snapshot 的实际结果）：
+
+```json
+{"request_id":"task-id-state-1","changes":[{"file":".doc/ops/CURRENT.md","record_id":"task-id","expected_sha256":"<old-row-hash>","replacement":"| Codex | task-id | feature/task-id | .worktrees/task-id | module | in_progress |"}]}
+```
+
+新增行使用 `expected_sha256: null`。必须登记目标文件 scope 和 `docs:publish` 能力。工具在同一个短租约中重新读取、行级 CAS、保留其他内容、记录 operation、原子替换并保存文件 hash 收据。同一 request_id 同一请求重放不会重复写；更换载荷不能复用 ID。存在未经管理的本地共享文档改动时拒绝将它们混入收据，先保留现场并对齐正确基线。
+
+多个文档先全部预检再写；中断留下可恢复的前后内容，不能把两个 rename 声称为任意文件读取者的一次原子发布。以同一 Git 提交作为持久发布边界。文件正常更新后，在自己的 task worktree 持对应 path + git:index 租约暂存/提交；hook 检查暂存文件 hash 与已生成收据一致。
+
+FEATURE-MATRIX 从未完成升为 done 需要 `docs:approve` 和已在该任务 HEAD 提交的 `evidence` 路径，不能因任务退出自动关闭能力。仅有工具日志不等于产品验收。文档布局/焦点维护使用显式 `docs:admin` 与 `record_id: "@document"` 的整文档 hash CAS；它不能修改 CURRENT 集成槽位，也不能绕过模块完成证据规则。普通任务没有此入口权限。
+
+## 5. 验证与候选集成
+
+按[验证契约](./2026-09-21-validation-contract.md)选真实检查。工程工具自测入口：
+
+```bash
+python3 -B -m unittest discover -s scripts/tests -p 'test_*.py' -v
+```
+
+冻结待交付提交 T。从最新 dev D 创建独立 `feature/integrate-<id>` 候选工作区并登记，合并 T 形成 `--no-ff` 节点 M；候选的两名父提交中第一名必须是 D。发生业务冲突回原任务修复。
+
+```bash
+# 在候选工作区：登记 candidate-id、实际写范围和 git:dev 能力。
+../../scripts/agentctl validate --task candidate-id -- <verification-command> <args>
+../../scripts/agentctl integrate --task candidate-id --expected-dev <D>
+```
+
+validate 要求干净树、记录精确 HEAD 与命令摘要；必要的实际命令/测试输出仍保存在任务验收证据。不能拿 `true` 替代验证契约。integrate 要求对应验证收据、干净主目录 dev、基线仍为 D，再接收同一 M；dev 前进则重建候选并重验，不能重用陈旧 PASS。
+
+本地 hooks 检查主干直接提交、task 身份、暂存 scope/实际租约、共享文档收据与敏感运行路径；引用事务门禁复用同一候选父节点和 task-bound 验证检查；dev 还要求由 integrate 创建、绑定 old/new 的操作身份，不能借 with 的租约直接快进或 update-ref 绕过。test/main 仍需要各自明确授权的候选与能力。所有管理工具始终以主仓已生效版本为准，旧 worktree 的旧脚本不能代表新协议已接入。
+
+## 6. 共享服务与镜像
+
+```bash
+# task 已获 env:dev；从主目录执行，源码须干净。
+./scripts/agentctl with --task task-id --resource env:dev --cwd <main-root> -- ./scripts/env-service.sh dev rebuild
+```
+
+服务写动作在任何配置创建、网络或 Docker 调用前检查：调用目录与脚本目录都属于主目录、主分支为 dev、当前执行身份与目标环境租约有效。`all` 必须显式持有四个环境资源；不为方便隐式扩大权限。`status/ps/logs` 不初始化 env/data，也不要求写租约。
+
+`candidate-images-build.sh --commit SHA` 要求实际源码 HEAD==SHA 且源码干净；仅允许现有 nightly 的固定 promotion-receipts 目录内未跟踪证据。它从该提交 `git archive` 到私有临时目录，Dockerfile 和上下文均来自不可变导出，不读取随后被其他操作修改的工作树或未跟踪证据。清单记录 source_tree/source_context；临时目录在退出时删除。镜像清单通过临时文件/fsync/rename 发布，避免截断 receipt 被当作完整证据。制品与报告版本分别记录；restart 不是新代码部署证明。
+
+影响产品运行的变更合入后按授权更新 dev，核对实际镜像、挂载、schema、health/ready 与受影响业务。普通工程规范与本地治理工具更新无需重建产品容器。使用共享 dev 的长 E2E 持有环境租约到结束，不能让另一部署改变验收对象。
+
+## 7. 查询、恢复与冻结
+
+```bash
+./scripts/agentctl status
+./scripts/agentctl operation <run-id>
+./scripts/agentctl recover --run <run-id> --reason '<现场检查与恢复依据>'
+```
+
+已结束且结果明确的请求可按 ID 查询；busy 不证明旧操作死亡。recover 仅在原 supervisor 和子进程组均已消失、物理锁可获得时继续；文档现场必须匹配该 operation 的原/目标内容，第三方变化则停止。外部 Docker/Git 未知结果必须先核对现场，理由写入恢复记录；管理器不能自动撤销已经发生的外部副作用。
+
+必要维护可用 freeze/unfreeze 对已授权资源显式冻结，带 task 与 reason；有效持有者也不能绕过冻结。不能删除锁文件“解锁”，也不能恢复一份旧库后把旧租约自动标 active。损坏、身份变化、文件系统异常时停止受保护写入并交接。
+
+## 8. 收口与清理
+
+任务状态、集成、部署、远端同步和 cleanup 分别记录，见[收口清单](./templates/session-close-checklist.md)。命令结束不等于任务完成；task close 会拒绝仍有运行或待恢复 operation 的任务。
+
+```bash
+./scripts/agentctl task close --id task-id --status done
+./scripts/agent-worktree.sh remove feature/task-id --delete-branch
+```
+
+清理由目录外的维护者执行，核对实际 Git 映射、dev 祖先、所有证据、tracked/untracked/ignored 文件、未完成 Git 操作、registry、生命周期锁和使用目录的进程。只用普通 remove/-d，拒绝时保留 cleanup_pending 和复查责任，不换成强制删除。
+
+**本机限制**：无法读取某些同 UID 进程 cwd 时，工具不能证明其未使用目录，故保留 cleanup_pending；只有明确识别的 OS 用户 systemd 管理进程有诊断性例外。测试中的 3 个删除正例仅替换 `/proc` 枚举以模拟可见主机，其余 Git/锁/文件条件为真实执行；可见占用、未知不可读、未合入、脏文件与活跃登记的拒绝另有真实/针对性测试。不要把这项限制转成跳过检查的通用开关。
+
+保护任务、旧 detached 工作区和非本次产物不自动清理。用户未要求 push 时仅本地提交/合入；用户已要求时再按授权同步并核对远端引用。

.doc/ops/2026-09-21-policy-registry.md

@@ -0,0 +1,29 @@
+# Agent 规范来源与生效登记
+
+## 生命周期与权威
+
+`proposed → approved → active → deprecated` 是规则生命周期；与任务的 `planned/in_progress/blocked/done/cancelled` 分开。`manual/enforced` 是工具执行能力，独立于规则状态。规则获批准不证明脚本已经强制执行。
+
+本轮修订 ID：`agent-governance-2026-09-21-r1`。owner：`orchestrator_codex`。批准依据：[规范审查](../audit/2026-09-21-agent-policy-review.md) R01–R10 与用户后续实施授权，具体授权回链由[实施任务](../archive/ops/2026-09-21-agent-governance-implementation.md)保存；审查原文保留历史“待采纳”语境，不改写成执行证据。
+
+本轮规则已通过 `7e9317b849e0696e110bac5b27749861178d7e3d` 合入 dev 并为 `active`；**包含本修订的受控 dev 集成提交**是 `effective_commit`，从该提交进入 dev 后为 `active`。集成者在实施任务记录完整 SHA 与验证证据，避免自引用提交散列。读取时先核对该集成提交是否为当前 dev 祖先；尚未集成的规则不能冒充全仓已生效。任务记录读取的 dev SHA 和修订 ID；旧任务集成前比较规则变化，只按已生效规则补齐适用条件。
+
+| 唯一来源 | 范围 | 本轮 revision/state | owner | 生效提交 |
+|---|---|---|---|---|
+| [AGENTS](../../AGENTS.md) | 任务分级、授权、安全、Git/收口硬边界 | r1 / active | orchestrator_codex | 本修订 dev 集成提交 |
+| [PROJECT](../../PROJECT.md) | 仓库地图、环境、工具与模块入口 | r1 / active | orchestrator_codex | 同上 |
+| [验证契约](./2026-09-21-validation-contract.md) | 测试范围、精确 PI 用例与报告 | r1 / active | orchestrator_codex | 同上 |
+| [worktree 操作规范](./2026-09-21-agent-worktree-workflow.md) | 创建、租约、共享文档、候选、环境、恢复、清理 | 本轮更新 active；既有规则按历史集成记录 | orchestrator_codex | 本轮实施任务及既有历史交接 |
+| [Herdr roster](./2026-09-13-herdr-agent-roster.md) | 角色与备援；实际模型/可用性须重新核验 | 既有规则 active；本轮澄清 active | orchestrator_codex | Git 历史及本轮实施任务 |
+
+客户端入口仅指向上述来源；不独立制定第二套测试、提交或凭证规则。外层系统约束及当前用户授权优先，内部冲突按 AGENTS 硬边界、PROJECT 项目细则、专门操作流程的职责解决；仍无法同时满足时记录冲突并请求范围决策。
+
+## 能力与证据登记
+
+具体工具版本、已验收能力与不覆盖范围由 [操作规范](./2026-09-21-agent-worktree-workflow.md) 和实施任务中的真实负例验收记录定义。文档/脚本存在不等于 `enforced`：只有指定版本入口及其测试证明的边界可记 enforced。普通 prose、未接入 hooks、绕过入口的直接文件修改、跨机器权限隔离不得因此声称已被强制。
+
+CURRENT 是带时间的活跃协调快照；Git/机器状态用于核验实际分支、锁与进程，FEATURE-MATRIX 是能力声明，gap-matrix 是发布门禁。审计、方案、历史报告和较新日期均不能自行覆盖上述权威。保留每条结论的范围、提交、环境与日期，避免把旧的通过结论当作当前运行事实。
+
+## Herdr v1.2 局部修订
+
+用户已授权采纳经研究修正的资源分工与自动审批。Herdr roster 的角色/额度/客户端参数由 `herdr-v1.2` 取代旧路由，仅在明确使用 Herdr 时激活，不扩展通用会话工作流。具体来源、验证与生效集成见[本轮任务](../archive/ops/2026-09-21-herdr-orchestration-v12.md)。已通过 dev 合并提交 `8c5e3477585fe27a485343dac97a670d95cf8905` 生效；profile/dry-run、入口保护和 Kimi 原子计数有隔离验收，真实 Herdr pane 启动未在本轮执行，不将其记为已实测。

.doc/ops/2026-09-21-validation-contract.md

@@ -0,0 +1,62 @@
+# 按变更范围选择验证与证据
+
+规则状态、owner 与生效条件见 [规范登记](./2026-09-21-policy-registry.md)。本文件是项目验证范围和报告要求的唯一来源；客户端仅引用。执行共享环境测试前，先满足 [操作规范](./2026-09-21-agent-worktree-workflow.md) 的授权、环境身份和持锁条件。
+
+## 验证矩阵
+
+| 变更范围 | 必需验证 | 不足以验收的证据 |
+|---|---|---|
+| 纯规范/普通文档 | diff、相对链接、状态、所有入口指令一致性 | 未核对来源的文案结论 |
+| 治理脚本 | 临时 Git 仓库中的真实分支/锁/并发/异常退出与拒绝路径 | 仅语法检查或 stub |
+| Go/接口 | 对应单测；`./scripts/arch-check.sh --mode block`、`go vet ./...`、`go test -short ./...`；受影响 PG 和鉴权负例 | short 测试替代被跳过的 PG/真实链路 |
+| 前端 | `web/` 中 `npm test`、`npm run build`；受影响交互的真实浏览器验证 | API 直调替代 UI 操作 |
+| 迁移/运行配置 | 独立环境升级、兼容性、回退/前滚条件及就绪验证 | 重启/health 替代版本与持久性证据 |
+| 产品 Agent/工作流（含运行模板/提示词） | 受影响真实产品 PI Agent Runner 链路；对应用户流程、持久状态和 UI | stub、SKIP、测试名未匹配、仅健康检查 |
+
+多类变更取并集。按 [模块开发标准](../system-design/2026-09-20-module-development-standards.md) 追加边界与 registry parity 等范围门禁。开发阶段可用 stub；交付验收不能冒充真实执行。纯文档无需产品 PI 或全量 Go，也不为形式重建服务。
+
+## 产品 PI 基线与精确追加
+
+优先入口：`./scripts/run-nightly-real-pi.sh`。调用前核验并从获授权配置提供（不在命令/报告贴凭证值）：
+
+- 独立可写 `TEST_DATABASE_URL`，不得指向真实生产业务库；确认 Runner 与测试所需工作区/`DATA_DIR` 挂载相容。
+- `PI_AGENT_RUNNER_URL` 和 `PI_AGENT_RUNNER_AUTH_TOKEN` / `RUNNER_AUTH_TOKEN`；真实 Runner 可访问。
+- 共享 KB 的授权连接与必要凭证；正常验收要求在线。`KB_ALLOW_OFFLINE=1` 只证明显式降级场景。
+- 目标环境批准的实际模型、协议及制品；通过 `PI_AGENT_MODEL` 传入批准值并比对 Runner 实际配置。脚本默认值不构成批准，也不证明实际模型。
+- 脚本可能构建候选镜像、写 promotion receipt；须满足构建身份/授权条件。`NIGHTLY_SKIP_IMAGE_BUILD=1` 不能补足缺失的制品摘要证据。
+
+脚本当前筛选 **仅两项**：
+
+```text
+TestMultiIntentU8_RealPI_ConfirmGenerate_PG
+TestWorkflowGovernance_PiAgent_PG_FullNoneMixedChain
+```
+
+它不是“全部工作流通过”。按变更范围追加精确名称，例如（前提条件已核验，且已处于相应环境执行租约/独立环境）：
+
+```bash
+go test -count=1 -timeout 2h -v ./internal/server/ -run '^TestPiAgent_FullLifecycle_MultiRole_RealWorld_E2E$'
+go test -count=1 -timeout 90m -v ./internal/server/ -run '^TestWorkflowGovernance_PiAgent_PG_(FullChain|ProductManager_FullChain|TestManager_FullChain)$'
+```
+
+当前源码前提：上述 PG/U8 用例的 `piAgentRunnerHealthy` 预检固定访问 `127.0.0.1:18865`，不能仅设置其他 Runner URL 就假定能执行；FullLifecycle 配置写死 `MiniMax-M3` 且使用临时 DataDir/内存模式，不能用它单独证明 PG 持久性，也不能声称 `PI_AGENT_MODEL` 已改变该用例模型。执行前确认这些条件符合目标环境批准范围；不符时记录缺项并安排相应测试适配，不静默换模型或把 SKIP 当验收。
+
+测试筛选区分大小写；`-run 'PI'` 不能选择名称中的 `PiAgent`。追加用例先读其环境前提；FullLifecycle 中 `RUN_FULL_ADHOC_WBS` 与 `RUN_HEAVY_STAGES` 控制额外段，不能把默认未跑段报为已覆盖。普通 PG 用例同样以源码中的精确名称/前提为准。
+
+运行前列 `expected_tests`（含必须子场景），运行后逐项对照执行、PASS、FAIL、SKIP、未匹配及重试。退出码 0 或 nightly receipt `pass` 不能替代该对照：基线脚本逐项核对两个预期顶层测试；额外子场景/用例仍须逐项核验。缺项不记 PASS，基础设施问题记录 blocker/infra_fail。保留首轮与重试关系，不隐藏失败。
+
+## 模型与环境证据
+
+模型以目标环境批准配置为准；dev/test/main 的 Compose 默认值可能不同，不能将某个模型全局写成验收条件。每次记录目标环境、源码 SHA、镜像/制品摘要、schema、Runner 实际模型/协议、配置来源与核验时间；仅有环境变量不能证明实际值。发现不符先查明并记录，不为满足文档自行换模型。不得用 Herdr `context_pi` 的模型信息替代产品 Runner。
+
+共享环境的长 E2E 持锁至结束；无权使用该环境则在独立固定环境执行。制品/候选变更后重新确认适用证据，不把旧提交 PASS 搬到新提交。
+
+## 报告与真实性
+
+小型文档/脚本任务可以在主文档设验证节；独立报告放 `.doc/test-reports/YYYY-MM-DD-<slug>-test-report.md`，附件放 `.doc/test-reports/assets/<report-slug>/`。任何层级至少记录：范围、被测 SHA、实际命令、环境、预期与实际、判定、证据链接、缺项/风险。命令包含秘密时记录参数名与脱敏方式，不记录值。
+
+跨模块/业务交付使用完整报告：背景、目标、方案/环境、预期、逐例实际结果与耗时、实际执行套件汇总、结论与剩余条件。套件汇总只列本次适用并实际运行的检查，不无条件要求全量 Go。声明 PASS 必须有对应真实输入/输出或足够判定的真实片段；来源与结论可核实，脱敏不得改写结果。无需提交原始完整日志、个人信息、业务正文或秘密截图。记下删减/脱敏范围，唯一证据清理前先安全归档。
+
+## 工程工具验收补充
+
+本地协调与运维守卫使用 `python3 -B -m unittest discover -s scripts/tests -p 'test_*.py' -v`，在临时真实 Git/SQLite/进程环境执行；Docker 守卫测试使用受控目标记录调用，不重建共享服务。nightly 入口现在核对最终尝试日志中两个预期顶层测试均恰好执行且 PASS；零用例、部分 SKIP 或重复拼接证据均不能生成 PASS 收据。该日志核验不是本轮执行了产品 PI 的声明。

.doc/ops/CURRENT.md

@@ -1,185 +1,62 @@
 # 当前焦点
 
-**更新**: 2026-09-16
-**production_ready**: yes（门禁 B1–B4 已签；dev/test/main `schema_version=47`。不把 fallback change report 写成完整 PI）
+**更新**：2026-09-22。此文件是协调快照；实际分支、进程、执行租约以机器核验为准。能力和发布结论分别见 [FEATURE-MATRIX](../status/FEATURE-MATRIX.md) / [gap-matrix](../remediation/gap-matrix.md)。本轮状态对账不改变 `production_ready`，不升 FEATURE-MATRIX 行。
+
+手工 CAS 前 `document_sha256`：`6cadc69b6ec680e9edda74683686196a8774e42ee43033e6ba6abf1ab1933cbf`（`docs apply` 在本 macOS 宿主因 `/proc` 不可用，见 [对账任务例外](./short-term/2026-09-22-status-reconcile.md)）。
 
 ## 焦点
 
-1. **全量 backlog 覆盖 no-go**：P0–P7 总控实施中（[short-term](./short-term/2026-09-16-full-backlog-override.md)）
-2. **运维**：Gitea nightly runner 已通；待 P1 对齐 `DATA_DIR=dev` 后冲 green receipt
-3. **红线**：禁止整支 merge FAV；不默认升 `MULTI_INTENT_PLAN_TIER=full`；项目 143 只读
+1. **状态对账收口（本轮）**：本机主目录为 2026-09-21 23:49 全新 clone；CURRENT 09-21 登记的历史 worktree 在本机不存在。governance-adoption 已按生效提交证据收口为 done；partial-deferred 保持 in_progress（W5–W7 真实未完成）。详见 [对账任务](./short-term/2026-09-22-status-reconcile.md)。
+2. **另一会话进行中**：`dev-prod-ready-test-promotion-2026-09-22`（Cursor）仍 active；首批合入已在本地 `dev@a3150dcb`。本对账任务不改其状态、不触碰其 worktree。
+3. **Agent 规范与 L1 门禁**：R01–R10、共享 .locks 已启用；dev 生效提交 `7e9317b8`。本机 macOS 上 `with`/`docs apply`/`validate`/`integrate` 不可用，受测 Linux 主机仍 enforced；OS 隔离不在范围。
 
 ## 并行认领
 
 | owner | task | branch | worktree | mutex | status |
-|-------|------|--------|----------|-------|--------|
-| Cursor-Auto | 2026-09-16-software-project-bootstrap | feature/software-project-bootstrap | .worktrees/feature-software-project-bootstrap | workflow-design | done |
-| Cursor | 2026-09-16-full-backlog-override | docs/override-nogo-full-backlog | - | architecture-docs | in_progress |
-| Cursor | 2026-09-16-gitea-nightly-docker-datadir | fix/gitea-nightly-docker-datadir | - | ci | done |
-| Cursor | 2026-09-16-gitea-nightly-host-tools | fix/gitea-nightly-host-tools | - | ci | done |
-| Cursor | 2026-09-16-wave-leftovers | fix/wave-leftovers-n7-playwright-dod | - | ci | done |
-| Cursor | 2026-09-16-wave3-pu6-pu8-go-no-go | feature/wave3-pu6-pu8-go-no-go | - | architecture-docs | done |
-| Cursor | 2026-09-16-wave2c-same-image-digest | feature/wave2c-same-image-digest | - | infra | done |
-| Cursor | 2026-09-16-wave2b-nightly-promotion-receipt | feature/wave2b-nightly-promotion-receipt | - | ci | done |
-| Cursor | 2026-09-16-wave2-real-pi-evidence | feature/wave2-real-pi-evidence | - | intent-plan | done |
-| Cursor | 2026-09-16-wave1-race-tempdir-cleanup | fix/race-tempdir-cleanup | - | ci | done |
-| Cursor | 2026-09-16-wave1-iam-fail-closed | fix/iam-store-fail-closed | - | authz | done |
-| Cursor | 2026-09-16-feature-matrix-wave0-calibration | feature/feature-matrix-production-readiness-plan | .worktrees/feature-matrix-production-readiness-plan | architecture-docs | done |
-| Codex | 2026-09-16-feature-matrix-production-readiness-plan | feature/feature-matrix-production-readiness-plan | .worktrees/feature-matrix-production-readiness-plan | architecture-docs | done |
-| Cursor-Auto | 2026-09-16-matrix-deep-test-promote-test | feature/matrix-deep-test-promote-test | - | infra | done |
-| Cursor-Auto | 2026-09-16-production-ready-gates | docs/production-ready-flip | - | ci | done |
-| Cursor-Auto | 2026-09-16-demo-seed-pollution | fix/demo-data-pollution-web | - | web | done |
-| Cursor | 2026-09-16-multi-intent-u8-task-generate | feature/multi-intent-u8-task-generate | - | intent-plan | done |
-| Cursor | 2026-09-16-multi-intent-u7-auto-read | feature/multi-intent-u7-auto-read | - | intent-plan | done |
-| Cursor | 2026-09-16-multi-intent-u6-web-cards | feature/multi-intent-u6-web-cards | - | web | done |
-| Cursor | 2026-09-16-multi-intent-u5-decision-api | feature/multi-intent-u5-decision-api | - | intent-plan | done |
-| Cursor | 2026-09-16-multi-intent-u4-outbox-projection | feature/multi-intent-u4-outbox-projection | - | events | done |
-| Cursor | 2026-09-15-multi-intent-u3-intentflow-pg | feature/multi-intent-u3-intentflow-pg | - | intent-plan | done |
-| Cursor | 2026-09-15-multi-intent-u2-segmenter | feature/multi-intent-u2-segmenter | - | intent | done |
-| Cursor | 2026-09-15-multi-intent-u1-contracts | feature/multi-intent-u1-contracts | - | architecture-docs | done |
-| Cursor | app-composition-u11-u12 | feature/app-composition-u11-u12 | - | app | done |
-| Cursor | chatlog-contextasm-u10 | feature/chatlog-contextasm-u10 | - | chat | done |
-| Cursor | chat-history-refresh-remediation | fix/chat-history-refresh | - | chat | done |
-| Cursor | dataset-lifecycle-u9 | feature/dataset-lifecycle-u9 | - | dataset | done |
-| Cursor | taskrun-runmanifest-u8 | feature/taskrun-runmanifest | - | taskrun | done |
-| Cursor | document-reliability-m1-live-and-m2 | refactor/document-reliability-pilot | - | workspace | done |
-| Codex | module-decoupling-remediation-plan | feature/module-decoupling-remediation | - | architecture-docs | done |
-| Codex | module-decoupling-phase2-plan-review | docs/module-decoupling-ipc-assessment | - | architecture-docs | done |
-| Cursor | module-decoupling-phase2-docs | feature/module-decoupling-phase2-docs | - | architecture-docs | done |
-| verifier_antigravity | controlled-content-ui-acceptance | fix/controlled-content-ui-acceptance | - | document-content-ui-acceptance | done |
-| implementer_cursor | controlled-content-canonical-hash | fix/controlled-content-canonical-hash | - | docgov | done |
-| Codex | project143-controlled-content-404-diagnosis | fix/project143-controlled-content-404-diagnosis | - | docgov-content-diagnosis | done |
-| Codex | software-project-bootstrap-plan | feature/software-project-bootstrap-plan | - | workflow-design | done |
-| Codex | conversation-intent-runtime-state | fix/conversation-intent-state | - | intent | done |
-| Cursor | conversation-intent-runtime-state | docs/conversation-intent-dual-tab | - | intent | done |
-| Cursor | document-revision-wave1-6-implementation | feature/document-revision-management | - | docgov | done |
-| Cursor-Auto | document-revision-runtime-ui03 | fix/document-revision-runtime-ui03 | - | docgov | done |
-| Cursor-Auto | document-revision-sse-idempotency | fix/document-revision-sse-idempotency | - | docgov | done |
-| Cursor-Auto | document-revision-active-doc-routing | fix/document-revision-active-doc-routing | - | docgov | done |
-| Cursor-Auto | document-revision-quality-context | fix/document-revision-quality-context | - | docgov | done |
-| Cursor-Auto | document-revision-e2e-pending-flow | fix/document-revision-e2e-pending-flow | - | pending-report-ui | done |
-| Cursor-Auto | document-revision-e2e-reject-routing | fix/document-revision-e2e-reject-routing | - | document-revision-runtime-ui | done |
-| Cursor-Auto | document-revision-e2e-block-selector | fix/document-revision-e2e-block-selector | - | document-revision-block-selector | done |
-| Cursor-Auto | document-revision-e2e-save-selector | fix/document-revision-e2e-save-selector | - | document-revision-save-selector | done |
-| Cursor-Auto | document-revision-e2e-overlay-selector | fix/document-revision-e2e-overlay-selector | - | document-revision-overlay-selector | done |
-| Cursor-Auto | document-revision-e2e-overlay-transition | fix/document-revision-e2e-overlay-transition | - | document-revision-overlay-transition | done |
-| Cursor-Auto | document-revision-second-doc-routing-lease | fix/document-revision-second-doc-routing-lease | - | document-revision-second-doc-routing-lease | done |
-| Cursor-Auto | document-revision-prelim-output | fix/document-revision-pi-runner-module | - | document-revision-prelim-output | done |
-| Cursor-Auto | document-revision-editor-hydration-race | fix/document-revision-editor-hydration-race | - | document-revision-editor-hydration-race | done |
-| Cursor-Auto | document-revision-quality-repair-workspace-contract | fix/document-revision-quality-repair-workspace-contract | - | document-revision-quality-repair-workspace-contract | done |
-| Cursor-Auto | document-revision-fast-completion-observation | fix/document-revision-fast-completion-observation | - | document-revision-fast-completion-observation | done |
-| Cursor-Auto | document-revision-workflow-category-navigation | fix/document-revision-workflow-category-navigation | - | document-revision-workflow-category-navigation | done |
-| Cursor-Auto | document-revision-duty-cell-assertion | fix/document-revision-duty-cell-assertion | - | document-revision-duty-cell-assertion | done |
-| Cursor-Auto | document-revision-reviewer-duty-sync | fix/document-revision-reviewer-duty-sync | - | document-revision-reviewer-duty-sync | done |
-| Cursor-Auto | document-revision-post-restart-selector | fix/document-revision-post-restart-selector | - | document-revision-post-restart-selector | done |
-| Cursor-Auto | document-revision-post-restart-final-snippet | fix/document-revision-post-restart-final-snippet | - | document-revision-post-restart-final-snippet | done |
-| Cursor-Auto | document-revision-pg-id-remap | fix/document-revision-pg-id-remap | - | document-revision | done |
-| Cursor-Auto | document-revision-runtime | fix/document-revision-runtime-ui03 | - | docgov | done |
-| Cursor-Auto | document-revision-runtime-ui-final-report | feature/document-revision-runtime-ui-final-report | - | document-revision-runtime-ui | done |
-| Cursor-Auto | document-revision-evidence-count | fix/document-revision-evidence-count | - | document-revision-evidence-count | done |
-| Cursor-Auto | document-revision-session-close | feature/document-revision-session-close | - | document-revision-session-close | done |
-| Cursor-Auto | vite-frp-allowed-hosts | fix/vite-frp-allowed-hosts | - | web-devserver | done |
-| implementer_cursor | workflow-plan-409-frozen-and-optional-duties | fix/workflow-plan-409-frozen-and-optional-duties | - | workflow | done |
-| implementer_cursor | governance-action-level-authz | fix/governance-action-level-authz | - | workflow | done |
-| Cursor | leftover-branch-cleanup | chore/leftover-branch-cleanup | - | ops | done |
-| Cursor | event-e0a-production-scope-contract | fix/event-production-scope-contract | - | events | done |
-| Cursor | event-e0b-dispatcher-pg | feature/events-dispatcher-pg | - | events | done |
-| Cursor | event-e1a-notify-cutover | fix/event-notify-cutover | - | events | done |
-| Cursor | event-e1b-workflow-advance | fix/event-workflow-advance | - | events | done |
-| Cursor | event-e1c-projection-cutover | fix/event-projection-cutover | - | events | done |
-| Cursor | event-e2-hook-guard | fix/event-e2-hook-guard | - | events | done |
-| Cursor | doccontent-canonical-boundary | fix/doccontent-canonical-boundary | - | docgov | done |
-| Cursor | intent-bizdev-boundary | fix/intent-bizdev-boundary | - | intent | done |
-| Cursor | stageflow-type-ownership | fix/stageflow-type-ownership | - | stageflow | done |
-| Cursor | bizdev-locator-removal | fix/bizdev-locator-removal | - | bizdev | done |
-| Cursor | chatflow-orchestration-boundary | fix/chatflow-orchestration-boundary | - | chat | done |
-| Cursor | phase2-closeout-inventories | feature/phase2-closeout-inventories | - | architecture-docs | done |
-| Cursor | event-shared-live-cutover | feature/event-shared-live-cutover | - | events | done |
-| Cursor | pi-typed-result | feature/pi-typed-result | - | pi-agent | done |
-| Cursor | promote-dev-to-test-2026-09-15 | feature/promote-dev-to-test-2026-09-15 | - | infra | done |
+|---|---|---|---|---|---|
+| Cursor | 2026-09-22-status-reconcile | feature/status-reconcile-2026-09-22 | .worktrees/status-reconcile-2026-09-22 | ops-status-reconcile | done |
+| Cursor | 2026-09-22-dev-prod-ready-test-promotion | feature/dev-prod-ready-test-promotion-2026-09-22 | .worktrees/dev-prod-ready-test-promotion-2026-09-22 | dev-runtime-migration+release-gate+test-promotion | in_progress |
+| Cursor | integrate-dev-prod-ready-test-promotion-2026-09-22 | feature/integrate-dev-prod-ready-test-promotion-2026-09-22 | .worktrees/integrate-dev-prod-ready-test-promotion-2026-09-22 | git:dev | in_progress |
+| Codex | 2026-09-21-agent-workflow-governance-adoption | feature/agent-workflow-governance-plan | （本机 clone 后不存在） | agent-workflow-governance | done |
+| Cline | 2026-09-16-partial-deferred-completion | docs/partial-deferred-completion-plan | - | architecture-docs | in_progress |
 
-> 新任务开始前登记。`branch` 必须为 `feature/<slug>` 或 `fix/<slug>`，**禁止** `dev` / `test` / `main`。同一 `mutex` 同时仅一个 `in_progress`。
+活跃任务的写路径、base_dev_sha、授权与验证计划见主任务记录与 `agentctl status`；历史 claim 不能代替当前登记。09-21 已交付且已合入 dev 的认领行已迁出本表，完整索引见 [归档](../archive/ops/2026-09-21-current-history.md)。
 
-> workflow-plan 409 与治理鉴权 G1–G5 已收口（见 [test-report](../test-reports/2026-09-14-governance-action-level-authz-test-report.md)）。禁止终止或改写项目 143。
-> `document-reliability-pilot` U11–U12 已合入 `dev@bf59cce` 并 rebuild。`CHAT-INTENT-STATE` 双标签 busy 已 PASS（项目 6275）。禁止 worktree 内 `env-service`。项目 143 只读，禁止终止。
-> 2026-09-15 旁支清理：[报告](../test-reports/2026-09-15-leftover-branch-cleanup-test-report.md)。已合入本地旁支 31 条已 `git branch -d`；7 个对应 worktree 已拆。extra worktree 仅余 `.worktrees/fix-dev-runtime-data-root-guard`（目录名是 guard，检出的是 `feature/final-artifact-vault`）。**故意不合入、不删**：`feature/final-artifact-vault`、`feature/remove-herdr-agent-settings`、`fix/project143-controlled-content-404-diagnosis`、`fix/dev-runtime-data-root-guard`、`dev-old-linear`。不删 `origin/*`。不整支 merge FAV；不启用 `FAV_DEGRADED_READ`。
+## 清理接管与遗留现场
+
+**本机（2026-09-22）**：`git worktree list` 仅主目录 + 上表三个 `.worktrees/*`。下列路径在本 clone **不存在**；远端相关分支大多已是 `dev` 祖先。cleanup_owner 仍为复查责任，不增加删除授权；不因「目录不存在」批量删远端分支。
+
+| 路径/事项 | 分类与保留原因 | cleanup_owner | 复查触发 |
+|---|---|---|---|
+| 09-21 历史任务 worktree 清单（herdr / governance / material-chunk / workflow-scope / upload-parse / mineru / intent-confirm / taskrun-status / doc-key / multiuser / initial-load / agent-lock / agent-policy 等） | 原 cleanup=pending；本机全新 clone 后目录不存在；证据在归档与 test-reports | 独立维护者 | 若在其他宿主仍有目录：按门禁核祖先/证据/进程后再 remove |
+| Cline `2026-09-16-partial-deferred-completion` | 仍 in_progress；无登记 worktree；W5–W7 未关闭 | Cline owner / 维护者接管 | 单独授权实施或交接后更新状态 |
+| `.worktrees/fix-dev-runtime-data-root-guard` / FAV 相关保护路径 | 保护项；故意不合入、不删 | 原 owner / 维护者 | 用户调整保护边界并重新核验后 |
+| `.kilo/worktrees/stealth-ice` | 非本轮；本 clone 不存在 | 原 owner 待核实 | 其他宿主若仍存在再查明 |
+| 远端 `origin/feature/software-project-bootstrap` | tip `d3bb7520` 对 dev 补丁等价（`git cherry` `-`）；无需合入 | 维护者 | 可选清理远端引用（须单独授权） |
+| 远端 `origin/feature/remove-herdr-agent-settings` | **保护分支**；已被 Herdr v1.2 反向取代；不合入 | 维护者 | 用户调整保护边界后 |
+
+cleanup=pending 不是任务状态；普通 remove/-d 拒绝时记录原因，不升级强删。历史完成/取消认领、原证据索引和环境快照见 [归档](../archive/ops/2026-09-21-current-history.md)。
 
 ## 集成槽位
 
 | holder | phase | since | scope | queue |
 |--------|-------|-------|-------|-------|
-| - | idle | - | - | - |
+| - | idle | 2026-09-22 | 对账已合入 `dev@38ed539f`；另一会话仍占 integrate 登记，后续合入须串行 | - |
 
 **phase**: `idle` | `merging` | `smoke` | `e2e`
 
-> 合入 `dev` + 共享容器验证必须串行。详见 [AGENTS.md](../../AGENTS.md) §6.3。
+> 合入 `dev` + 共享容器验证必须串行。实际机器锁/进程优先；详见 [操作规范](./2026-09-21-agent-worktree-workflow.md)。
 
-## 环境快照
+## 受控约束
 
-| 环境 | 端口 | schema | 状态 |
-|------|------|--------|------|
-| dev | 8080 | **47** | healthy（`pi-agent` typed-result-v1；events worker `:8088`；notify/advance/projection live、fav off；health+ready PASS；demo 6001–6010 retired） |
-| test | 8081 | **47** | healthy（`rc-v1.0.0-beta.2`；pi-agent `:18866`；events `:8089`；notify/advance/projection live、fav off；health+ready PASS；矩阵深度测试 live 项目 3 PASS） |
-| main | 8000 | **47** | healthy（app + events + runner + DB；与 dev/test 对齐） |
+- 禁止整支 merge FAV；`FAV_DEGRADED_READ=false`；FAV live 观察窗以证据驱动。保留保护分支 `feature/final-artifact-vault`、`feature/remove-herdr-agent-settings`、`fix/project143-controlled-content-404-diagnosis`、`fix/dev-runtime-data-root-guard`、`dev-old-linear`；不删 `origin/*`。
+- 不默认升 `MULTI_INTENT_PLAN_TIER=full`；`SEMANTIC_SUMMARY_REPLACE` 不随 W2 开启；项目 143 只读、禁止终止；SWBOOT-10 保持 fail-closed stub。
+- D7 对话 ADR 仍待合规签字；追踪表类别 `record` 不授权物理删除。模块解耦 A–G 与回溯切片按各自最新主任务认领/证据判断，不因历史设计或本次对账自动启动。
+- `fix/clean-test-env-baseline` 不 merge；仅保留已挑拣的 `SEED_DEMO_USERS=false`。主运行目录与 worktree 的服务边界、重建与恢复要求见操作规范；MinerU 旧挂载事故与二轮证据见历史快照。
 
-## SSOT
+## 活跃入口
 
-| 类型 | 路径 |
-|------|------|
-| 文档总地图 | [../README.md](../README.md) |
-| 模块完成度 | [FEATURE-MATRIX](../status/FEATURE-MATRIX.md)（Wave 0 已校准契约与冻结边界） |
-| 发布缺口 | [gap-matrix](../remediation/gap-matrix.md)（`production_ready=yes`；Wave 0 IAM 只读未发现旁路） |
-| 连续性审计/计划 | [audit](../audit/2026-09-16-feature-matrix-production-readiness-audit.md) · [remediation](../remediation/2026-09-16-feature-matrix-production-readiness-plan.md) · [Wave 0 任务](./short-term/2026-09-16-feature-matrix-wave0-calibration.md) |
-| 测试报告 | [test-reports/](../test-reports/) |
-| Agent 手册 | [AGENTS.md](../../AGENTS.md) |
-| 意图双标签 busy 交接 | [./handoffs/2026-09-15-conversation-intent-dual-tab.md](./handoffs/2026-09-15-conversation-intent-dual-tab.md) |
-| 受控正文 hash 漂移 W1–W6 | [../ops/handoffs/2026-09-14-controlled-content-canonical-hash.md](../ops/handoffs/2026-09-14-controlled-content-canonical-hash.md) |
-| DOCREV ADR | [../adr/2026-09-13-document-version-boundary.md](../adr/2026-09-13-document-version-boundary.md) |
-| DOCREV 管理测试 | [../test-reports/2026-09-13-document-revision-management-test-report.md](../test-reports/2026-09-13-document-revision-management-test-report.md) |
-| DOCREV 运行时 UI Round20 | [../test-reports/2026-09-14-document-revision-runtime-ui-test-report.md](../test-reports/2026-09-14-document-revision-runtime-ui-test-report.md) |
-| 纯软件项目自举设计 | [../system-design/2026-09-14-software-project-bootstrap-workflow.md](../system-design/2026-09-14-software-project-bootstrap-workflow.md) |
-| 模块化单体解耦架构 | [../system-design/2026-09-14-module-decoupling-architecture.md](../system-design/2026-09-14-module-decoupling-architecture.md) |
-| 模块解耦整改计划 | [../remediation/2026-09-14-module-decoupling-refactor-plan.md](../remediation/2026-09-14-module-decoupling-refactor-plan.md) |
-| Phase 2 方案审阅 | [../audit/2026-09-15-module-decoupling-phase2-plan-review.md](../audit/2026-09-15-module-decoupling-phase2-plan-review.md) |
-| Phase 2 修订计划 | [../remediation/2026-09-15-module-decoupling-ipc-phase2-remediation-plan.md](../remediation/2026-09-15-module-decoupling-ipc-phase2-remediation-plan.md) |
-| 多意图 HITL 复核方案 | [../system-design/2026-09-15-multi-intent-hitl-plan.md](../system-design/2026-09-15-multi-intent-hitl-plan.md) |
-| 多意图 HITL U1 契约 | [../test-reports/2026-09-15-multi-intent-u1-contracts-test-report.md](../test-reports/2026-09-15-multi-intent-u1-contracts-test-report.md) |
-| 多意图 HITL U2 分段 | [../test-reports/2026-09-15-multi-intent-u2-segmenter-test-report.md](../test-reports/2026-09-15-multi-intent-u2-segmenter-test-report.md) |
-| 多意图 HITL U3 PG | [../test-reports/2026-09-15-multi-intent-u3-intentflow-pg-test-report.md](../test-reports/2026-09-15-multi-intent-u3-intentflow-pg-test-report.md) |
-| 多意图 HITL U4 投影 | [../test-reports/2026-09-16-multi-intent-u4-outbox-projection-test-report.md](../test-reports/2026-09-16-multi-intent-u4-outbox-projection-test-report.md) |
-| 多意图 HITL U5 API | [../test-reports/2026-09-16-multi-intent-u5-decision-api-test-report.md](../test-reports/2026-09-16-multi-intent-u5-decision-api-test-report.md) |
-| 多意图 HITL U6 Web | [../test-reports/2026-09-16-multi-intent-u6-web-cards-test-report.md](../test-reports/2026-09-16-multi-intent-u6-web-cards-test-report.md) |
-| 多意图 HITL U8 generate | [../test-reports/2026-09-16-multi-intent-u8-task-generate-test-report.md](../test-reports/2026-09-16-multi-intent-u8-task-generate-test-report.md) |
-| 多意图 HITL U7 只读 | [../test-reports/2026-09-16-multi-intent-u7-auto-read-test-report.md](../test-reports/2026-09-16-multi-intent-u7-auto-read-test-report.md) |
-| 文档可靠性 M1 报告 | [../test-reports/2026-09-14-document-reliability-pilot-test-report.md](../test-reports/2026-09-14-document-reliability-pilot-test-report.md) |
-| 文档可靠性 M1 活验 | [../test-reports/2026-09-14-document-reliability-pilot-live-test-report.md](../test-reports/2026-09-14-document-reliability-pilot-live-test-report.md) |
-| 文档可靠性 M2 | [../test-reports/2026-09-14-document-reliability-m2-test-report.md](../test-reports/2026-09-14-document-reliability-m2-test-report.md) |
-| 文档可靠性 M3 U8 | [../test-reports/2026-09-15-taskrun-runmanifest-u8-test-report.md](../test-reports/2026-09-15-taskrun-runmanifest-u8-test-report.md) |
-| 文档可靠性 M3 U9 | [../test-reports/2026-09-15-dataset-lifecycle-u9-test-report.md](../test-reports/2026-09-15-dataset-lifecycle-u9-test-report.md) |
-| 文档可靠性 M4 U10 | [../test-reports/2026-09-15-chatlog-contextasm-u10-test-report.md](../test-reports/2026-09-15-chatlog-contextasm-u10-test-report.md) |
-| 文档可靠性 M5/M6 U11–U12 | [../test-reports/2026-09-15-app-composition-u11-u12-test-report.md](../test-reports/2026-09-15-app-composition-u11-u12-test-report.md) |
-| Track E E2 闭包守卫 | [../test-reports/2026-09-15-event-e2-hook-guard-test-report.md](../test-reports/2026-09-15-event-e2-hook-guard-test-report.md) |
-| Track E 复盘 | [./research/2026-09-15-track-e-retrospective.md](./research/2026-09-15-track-e-retrospective.md) |
-| 旁支清点收口 | [../test-reports/2026-09-15-leftover-branch-cleanup-test-report.md](../test-reports/2026-09-15-leftover-branch-cleanup-test-report.md) |
-| SSE/幂等审计 | [../audit/2026-09-13-document-revision-sse-idempotency.md](../audit/2026-09-13-document-revision-sse-idempotency.md) |
-| 质量门禁自污染审计 | [../audit/2026-09-13-document-revision-quality-gate-self-pollution.md](../audit/2026-09-13-document-revision-quality-gate-self-pollution.md) |
-| 当前文档路由审计 | [../audit/2026-09-13-document-revision-active-doc-routing.md](../audit/2026-09-13-document-revision-active-doc-routing.md) |
-| 行动表状态假阳性审计 | [../audit/2026-09-13-document-revision-quality-status-false-positive.md](../audit/2026-09-13-document-revision-quality-status-false-positive.md) |
-| 待确认报告选择失败审计 | [../audit/2026-09-13-document-revision-pending-report-selection.md](../audit/2026-09-13-document-revision-pending-report-selection.md) |
-| UI-05b 拒绝路由失败审计 | [../audit/2026-09-13-document-revision-e2e-reject-routing.md](../audit/2026-09-13-document-revision-e2e-reject-routing.md) |
-| 职责伪造与 ETag 覆盖审计 | [../audit/2026-09-13-document-revision-duty-etag-overwrite.md](../audit/2026-09-13-document-revision-duty-etag-overwrite.md) |
-| UI-06 块选择器失败审计 | [../audit/2026-09-13-document-revision-block-selector.md](../audit/2026-09-13-document-revision-block-selector.md) |
-| UI-06 保存选择器失败审计 | [../audit/2026-09-13-document-revision-save-selector.md](../audit/2026-09-13-document-revision-save-selector.md) |
-| UI-07 纯净阅读取样失败审计 | [../audit/2026-09-13-document-revision-overlay-selector.md](../audit/2026-09-13-document-revision-overlay-selector.md) |
-| UI-07 transition 中间帧取样审计 | [../audit/2026-09-13-document-revision-overlay-transition.md](../audit/2026-09-13-document-revision-overlay-transition.md) |
-| UI-11 第二份文档路由与 lease 审计 | [../audit/2026-09-13-document-revision-second-doc-routing-lease.md](../audit/2026-09-13-document-revision-second-doc-routing-lease.md) |
-| UI-11 prelim_design 缺 output.md 审计 | [../audit/2026-09-13-document-revision-prelim-output.md](../audit/2026-09-13-document-revision-prelim-output.md) |
-| UI-06 编辑弹窗 hydration 竞态审计 | [../audit/2026-09-13-document-revision-editor-hydration-race.md](../audit/2026-09-13-document-revision-editor-hydration-race.md) |
-| UI-03 质量修复子工作区契约审计 | [../audit/2026-09-13-document-revision-quality-repair-workspace-contract.md](../audit/2026-09-13-document-revision-quality-repair-workspace-contract.md) |
-| UI-11 快速完成观测误判审计 | [../audit/2026-09-13-document-revision-fast-completion-observation.md](../audit/2026-09-13-document-revision-fast-completion-observation.md) |
-| UI-13a 私密分类导航失败审计 | [../audit/2026-09-13-document-revision-workflow-category-navigation.md](../audit/2026-09-13-document-revision-workflow-category-navigation.md) |
-| UI-13a 职责单元格误判审计 | [../audit/2026-09-13-document-revision-duty-cell-assertion.md](../audit/2026-09-13-document-revision-duty-cell-assertion.md) |
-| UI-13a reviewer 职责未同步审计 | [../audit/2026-09-13-document-revision-reviewer-duty-sync.md](../audit/2026-09-13-document-revision-reviewer-duty-sync.md) |
-| UI-03 首次生成 PG ID 误删 baseline | [../audit/2026-09-13-document-revision-pg-id-remap.md](../audit/2026-09-13-document-revision-pg-id-remap.md) |
-| UI-06 刷新后缓存竞争死锁审计 | [../audit/2026-09-14-document-revision-refresh-cache-race.md](../audit/2026-09-14-document-revision-refresh-cache-race.md) |
-| 受控正文真实 UI 验收报告 | [../test-reports/2026-09-14-controlled-content-ui-acceptance.md](../test-reports/2026-09-14-controlled-content-ui-acceptance.md) |
+- [操作规范](./2026-09-21-agent-worktree-workflow.md) · [规则来源/生效](./2026-09-21-policy-registry.md) · [验证契约](./2026-09-21-validation-contract.md)
+- [状态对账](./short-term/2026-09-22-status-reconcile.md) · [dev 门禁与 test 晋升](./short-term/2026-09-22-dev-prod-ready-test-promotion.md)
+- [模块开发标准](../system-design/2026-09-20-module-development-standards.md) · [governance 交接](./handoffs/2026-09-21-agent-workflow-governance-plan.md)
+- [partial-deferred 主任务](./short-term/2026-09-16-partial-deferred-completion.md) · [历史证据与环境快照](../archive/ops/2026-09-21-current-history.md)

.doc/ops/handoffs/2026-09-15-conversation-intent-dual-tab.md

@@ -65,3 +65,13 @@ curl -sf http://127.0.0.1:8080/ready
 - CURRENT: [CURRENT.md](../CURRENT.md)
 - Task: [../short-term/2026-09-13-conversation-intent-runtime-state.md](../short-term/2026-09-13-conversation-intent-runtime-state.md)
 - Test report: [../../test-reports/2026-09-13-conversation-intent-runtime-state-test-report.md](../../test-reports/2026-09-13-conversation-intent-runtime-state-test-report.md)
+
+## 回标（2026-09-18，Wave 6 文档漂移修复）
+
+上方「未完成」与「认领 / 槽位状态」两节是 2026-09-15 交接时刻的快照，**已在同一提交（`8a8f64a`）内被后续证据覆盖**：
+
+- 浏览器双标签刷新恢复 / busy 租约可见性：项目 6275、`sess-p6275-u10` 真实 PI + Docker 截图（`dual-tab-live.py`、`live.json`、`window-before-refresh.json`、`window-after-refresh.json`、`screenshots/tab-b-after-reload.png` 等，均在同一提交归档）。
+- `CHAT-INTENT-STATE` 已在 [gap-matrix](../../remediation/gap-matrix.md) 标记 **PASS**（「双标签活验项目 6275 / `sess-p6275-u10`」）。
+- mutex 已释放：CURRENT.md 当前无该任务 `in_progress` 行；集成槽位 holder 为 `idle`。
+
+**结论**：本 handoff 无待办事项，`status: closed` 生效，仅为历史记录保留原文，不删除。

.doc/ops/handoffs/2026-09-17-document-author-only-closeout.md

@@ -0,0 +1,40 @@
+---
+title: "document-author-only U1–U6 收口交接"
+status: done
+created: 2026-09-17
+updated: 2026-09-17
+from: Cursor
+to: integrator
+---
+
+# document-author-only U1–U6 收口交接
+
+## 结论
+
+实现与验收任务已全部收口：U1–U6 short-term 已迁入 `archive/ops/`；FEATURE-MATRIX / remediation DoD（除发布末条）已更新；U6 报告已归档。
+
+**远端**：已 `git-push-dev.sh` 推送 `origin/dev`（含 author-only merge）；**未**晋升 test/main。
+
+**dev 试点**：`workflow.allow_author_only_approval=true`（revision 1）；证据见 [pilot assets](../../test-reports/assets/2026-09-17-author-only-pilot/) 与 [ops 笔记](../2026-09-17-author-only-pilot-toggle.md)。
+
+## 分支
+
+- `feature/document-author-only-plan` — 已合入并清理 worktree/本地分支
+- 续作：`feature/docgov-modification-proposal-http`（变更提案 HTTP）
+
+## 合入 `dev`（已完成）
+
+- `merge --no-ff feature/document-author-only-plan` → 后续推送至 `origin/dev@ba92a8b` 一带
+- 冒烟：`go vet` / `go test -short` 相关包 PASS；`./scripts/env-service.sh dev rebuild`；`GET /health` → `schema_version=52`、`status=ok`
+- 总开关默认迁移值仍为 off；**dev 运行态**已 CAS 试点开启；**未**晋升 test/main
+
+## 明确不在本期（已转入续作）
+
+- ~~变更提案 HTTP 路由~~ → [short-term](../short-term/2026-09-17-docgov-modification-proposal-http.md) / [audit resolved](../../audit/2026-09-17-docgov-modification-proposal-http-gap.md)
+- test/main 晋升仍另授
+
+## 证据
+
+- [U6 报告](../../test-reports/2026-09-17-document-author-only-u6-test-report.md)
+- [方案 DoD](../../remediation/2026-09-17-document-author-only-plan.md)
+- [pilot](../../test-reports/assets/2026-09-17-author-only-pilot/)

.doc/ops/handoffs/2026-09-21-agent-workflow-governance-plan.md

@@ -0,0 +1,43 @@
+---
+title: "Agent worktree 并行治理规范采纳与迁移交接"
+created: 2026-09-21
+from: Codex
+to: user-and-next-agent
+status: open
+---
+
+# 交接：Agent worktree 并行治理规范采纳与迁移交接
+
+## 已完成
+
+- 当前规范、worktree/服务/制品脚本、Compose、CI 和实际运行挂载的只读核查。
+- [调研](../research/2026-09-21-agent-workflow-governance-research.md) 与 [完整方案](../../remediation/2026-09-21-agent-workflow-governance-plan.md)，含现状差距、五阶段实施、恢复与十四项验收。
+- 本分支 CURRENT 登记已结束；FEATURE-MATRIX 新能力保持 planned；研究任务归档。
+
+## 下一步
+
+用户已确认采纳并提交。生效规则见 [worktree 工作规范](../2026-09-21-agent-worktree-workflow.md)；自动化仍按 [W0–W4 实施任务](../long-term/2026-09-21-agent-workflow-governance-automation.md) 追踪，不能当作已经实现。此次仅集成规范文档，不迁移旧任务或重建服务。
+
+## 认领 / 槽位
+
+| 项 | 值 |
+|---|---|
+| 研究 mutex | 已在本 worktree CURRENT 标记 done |
+| 共享集成槽位 | 本任务分支 CURRENT 登记文档集成；实际操作持 common-dir 下 dev-integration.lock，主目录 CURRENT 保留 |
+| branch | feature/agent-workflow-governance-plan |
+| worktree | .worktrees/feature-agent-workflow-governance-plan |
+| 起点 | 本地 dev@15b8a4a8 |
+| 合入 / push | 本次按已验证候选合入本地 dev；未 push，最终结果见规范采纳验收报告 |
+
+## 验证及边界
+
+- 仅文档差异、链接和状态检查；未运行 Go/前端测试、迁移或真实 PI 操作，不作产品验收声明。
+- 主目录另有 Cursor 工作流作用域任务的未提交改动；保留现场，不 checkout/pull/stash/reset。
+- 当前没有自动任务协调器，分支 CURRENT 不等于全局实时认领。此次只有人工明确范围和本机 flock，不宣称自动队列或全局硬隔离已实现。
+- 收口文档允许单独审核/合入，但不能按计划已写完将治理功能改成 done。
+- 主目录仍是旧任务分支；dev 暂由 `.worktrees/agent-governance-dev-integration` 检出以安全集成文档。旧任务 owner 保存成果、确认主目录干净后，先安全移除临时 dev worktree，再在主目录切回 dev；不得强抢 dev 检出。
+
+## 相关链接
+
+- [研究任务](../../archive/ops/2026-09-21-agent-workflow-governance-plan.md)
+- [CURRENT](../CURRENT.md)

.doc/ops/long-term/2026-09-14-software-project-bootstrap-implementation.md

@@ -2,7 +2,7 @@
 title: "纯软件项目自举工作流实施"
 status: in_progress
 created: 2026-09-14
-updated: 2026-09-16
+updated: 2026-09-17
 ---
 
 # 纯软件项目自举工作流实施
@@ -22,18 +22,18 @@ updated: 2026-09-16
 - 真实 PI 和 Ubuntu 无头浏览器黄金项目验收通过；
 - 未实现受控代码执行前，系统不会直接修改项目仓库。
 
-## 实施进度（2026-09-16）
+## 实施进度（2026-09-17）
 
 | Epic | 状态 | 说明 |
 |------|------|------|
 | SWBOOT-00 | done（契约） | ADR `.doc/adr/2026-09-16-software-project-bootstrap-keys.md` |
-| SWBOOT-01 | done（迁移） | goose `00048` additive；活验待集成槽 |
-| SWBOOT-02..04 | done（L1） | manifests + catalog 五 key；医疗三门禁保留 |
-| SWBOOT-05..08 | partial | 后端 catalog/creation-preview/create 字段；七步 UI / 对话路由未做 |
-| SWBOOT-09 | partial | L1 单测报告已出；真实 PI/UI NOT RUN |
-| SWBOOT-10 | stub only | allowlist + fail-closed；无真实 patch/merge |
+| SWBOOT-01 | done（迁移） | goose `00048` additive；已合 `dev` |
+| SWBOOT-02..04 | done（L1） | manifests + catalog 五 key；医疗三门禁保留；已合 `dev`（`f0029df`） |
+| SWBOOT-05..08 | done（W5a） | catalog 驱动创建向导；软件不克隆医疗 7 模板；solo 未独立评审标注 |
+| SWBOOT-09 | partial | docs_only 真实 PI 已出；无头浏览器全向导仍 NOT RUN |
+| SWBOOT-10 | stub only | allowlist + fail-closed；真 patch/merge 归 W5b，本轮不实施 |
 
-分支：`feature/software-project-bootstrap`（**未合 dev**）。
+L1（SWBOOT-00…09 契约/迁移/目录钩子 + SWBOOT-10 stub）**已合入 `dev`**。后续由 [partial/deferred W5](../short-term/2026-09-16-partial-deferred-completion.md) 承接：W5a = UI + `docs_only` 真实 PI；W5b = 受控执行器（独立安全评审）。
 
 ## 实施拆分
 
@@ -59,9 +59,11 @@ updated: 2026-09-16
 - 文档版本运行时 Round20 能力作为文档链基线；
 - 用户确认首期执行模式及 solo/collaborative 策略。
 
-## 暂不启动原因
+## 剩余工作
 
-本轮用户要求先梳理和制定详细方案；业务代码、迁移、模板和智能体配置尚未授权进入实施。本任务保持 `planned`，启动时须从 `dev` 新建独立 feature 分支，并在 CURRENT 认领 `workflow-design`/相应拆分 mutex。
+L1 已合 `dev`。W5a 从 `dev` 开 `feature/w5a-software-bootstrap-ui-pi`（mutex `workflow-design`）。W5b 受控执行器未启动，SWBOOT-10 保持 fail-closed stub。
+
+**Wave 5 X-3（2026-09-18）**：goose 00048 三表（`project_types` / `compliance_profiles` / `project_type_workflows`；另含零读者的 `project_source_bindings` / `repo_path_allowlist`）消费方接线评估结论 = **deferred → SWBOOT-10/W5b**。不改 schema；API 继续硬编码目录。决策落点：[wave5-deadcode-decisions.md#x-3](../short-term/2026-09-18-wave5-deadcode-decisions.md#x-3)。不阻塞 W5b 立项。
 
 ## 相关链接
 

.doc/ops/long-term/2026-09-16-intent-plan-playwright-dual-tab.md

@@ -1,9 +1,9 @@
 ---
 title: "Playwright intent-plan 双标签 — 长期 gated"
-status: planned
+status: done
 created: 2026-09-16
 updated: 2026-09-16
-owner: TBD
+owner: Cursor-Auto
 branch: feature/intent-plan-cards-playwright
 mutex: web
 ---
@@ -12,9 +12,9 @@ mutex: web
 
 ## 现状
 
-- `web/e2e/intent-plan-cards.spec.ts`：`test.skip` unless `RUN_UI_ACCEPTANCE=1`；仅 body visible 骨架。
-- Conversation-intent 双标签已有 live 证据（项目 6275）；**不等于** intent-plan confirm 双标签。
-- Wave2 明确不宣称 UI 双标签已绿。
+- short-term / 报告已关闭：见 [../short-term/2026-09-16-intent-plan-playwright-dual-tab.md](../short-term/2026-09-16-intent-plan-playwright-dual-tab.md) 与 [../../test-reports/2026-09-16-intent-plan-playwright-dual-tab-test-report.md](../../test-reports/2026-09-16-intent-plan-playwright-dual-tab-test-report.md)
+- `RUN_UI_ACCEPTANCE=1` 真浏览器 PASS（Docker Playwright）；默认 skip
+- **不升** `MULTI_INTENT_PLAN_TIER`
 
 ## 关闭条件
 

.doc/ops/long-term/2026-09-16-pu6-semantic-summary-contract.md

@@ -1,32 +1,32 @@
 ---
 title: "PU6 语义摘要 D3 — 获批后任务契约"
-status: planned
+status: done
 created: 2026-09-16
-updated: 2026-09-16
-owner: TBD
-branch: feature/pu6-semantic-summary
+updated: 2026-09-17
+owner: Cursor
+branch: feature/w2-semantic-summary-shadow-live
 mutex: chat
 go_no_go: go
 ---
 
 # PU6 语义摘要 D3 — 获批后任务契约
 
-**go/no-go**：no-go（见 `.doc/ops/research/2026-09-16-wave3-pu6-pu8-go-no-go.md`）。已授权 GO；按 short-term 总控实施（默认 flag off）。
+**go/no-go**：GO。脚手架 + W2 live 已合 `dev`。`SEMANTIC_SUMMARY_SHADOW` 默认 off；开 flag 时组合根注入产品 PI no-tool summarizer。**不启用** `SEMANTIC_SUMMARY_REPLACE`。
 
-## 目标（获批后）
+## 目标
 
-在授权可见集合上 shadow 语义摘要，可解释 fallback；通过后方可考虑替换 deterministic。
+在授权可见集合上 shadow 语义摘要，可解释 fallback；REPLACE 为后置独立授权任务。
 
 ## 预注册门
 
-- flag：`SEMANTIC_SUMMARY_SHADOW` → 可选 `SEMANTIC_SUMMARY_REPLACE`
+- flag：`SEMANTIC_SUMMARY_SHADOW` → 可选 `SEMANTIC_SUMMARY_REPLACE`（本轮不启用）
 - 输入：authorized view only；无工具权限摘要器；R13 出站门
 - 失败：保留旧摘要/deterministic；标注 freshness
 - 负例：撤权消息不入摘要；injection 不能改权限
 
 ## 路径提示
 
-`internal/ctxmgr/summarizer.go`、`internal/app/chatflow/`、`internal/server/chat_digest_api.go`、web 摘要消费组件
+`internal/ctxmgr/summarizer.go`、`internal/ctxmgr/semantic_summary.go`、`internal/app/chatflow/`、`internal/server/chat_digest_api.go`、`internal/agent/piagent.go`
 
 ## 回滚
 

.doc/ops/long-term/2026-09-16-pu7-pi-narrative-contract.md

@@ -1,9 +1,9 @@
 ---
 title: "PU7 PI change-report 叙事 — 获批后任务契约"
-status: planned
+status: done
 created: 2026-09-16
-updated: 2026-09-16
-owner: TBD
+updated: 2026-09-17
+owner: Cursor-Auto
 branch: feature/pu7-pi-narrative
 mutex: docgov
 go_no_go: go
@@ -11,22 +11,27 @@ go_no_go: go
 
 # PU7 PI change-report 叙事 — 获批后任务契约
 
-**go/no-go**：no-go。未获批禁止实现。
+**go/no-go**：GO（用户覆盖授权，见 Wave3 research）。脚手架已合 `dev`；W3 live（产品 PI + digest 绑定）已接线，默认 flag 仍 off。
 
-## 目标（获批后）
+## 目标
 
 只读消费 immutable diff+lineage+risk floor 的 PI 叙事；任意 schema/超时/注入 → 全量 fallback。
 
 ## 预注册门
 
-- flag：`PI_CHANGE_REPORT_NARRATIVE`
+- flag：`PI_CHANGE_REPORT_NARRATIVE`（默认 off）
 - 禁止覆盖服务端风险/审批结论
-- typed schema + 文档版本 + input digest 绑定
+- typed schema + input digest 绑定（`change_report_narrative_v1`）
 - UI 明确区分 narrative vs 事实字段
 
-## 路径提示
+## 路径
 
-`internal/docrevision/`、`deploy/pi-agent/` typed result、`ChangeReportPanel.tsx`
+- `internal/docrevision/flags.go` / `narrative.go` / `service.go`
+- `deploy/pi-agent/change-report-narrative-v1.mjs`
+- `web/.../ChangeReportPanel.tsx` / `changeReportView.ts`
+- 报告：[../../test-reports/2026-09-16-pu7-pi-narrative-test-report.md](../../test-reports/2026-09-16-pu7-pi-narrative-test-report.md)
+- W3 live：[../../test-reports/2026-09-17-w3-pi-change-report-narrative-test-report.md](../../test-reports/2026-09-17-w3-pi-change-report-narrative-test-report.md)
+- short-term：[../short-term/2026-09-17-w3-pi-change-report-narrative.md](../short-term/2026-09-17-w3-pi-change-report-narrative.md)
 
 ## 回滚
 

.doc/ops/long-term/2026-09-16-pu8-u10-mutate-contract.md

@@ -1,10 +1,10 @@
 ---
 title: "PU8-U10 mutate — 获批后任务契约"
-status: planned
+status: done
 created: 2026-09-16
-updated: 2026-09-16
-owner: TBD
-branch: feature/pu8-u10-mutate
+updated: 2026-09-18
+owner: Cursor
+branch: feature/w4-u9-segment-live
 mutex: intent-plan
 go_no_go: go
 flag: MULTI_INTENT_U10_MUTATE
@@ -12,7 +12,7 @@ flag: MULTI_INTENT_U10_MUTATE
 
 # PU8-U10 mutate
 
-**go/no-go**：no-go。独立 flag；高风险动作绑定 expected revision + 显式确认 + 执行前再授权；不依赖 U9。
+**go/no-go**：GO（覆盖授权）。独立 flag 脚手架已合 `dev`。W4：dry-run→confirm 幂等 receipt 证据；mutex `intent-plan`。不升 `MULTI_INTENT_PLAN_TIER`。报告：[../../test-reports/2026-09-17-w4-u10-mutate-test-report.md](../../test-reports/2026-09-17-w4-u10-mutate-test-report.md)
 
 ## 负例
 

.doc/ops/long-term/2026-09-16-pu8-u11-docgov-contract.md

@@ -1,15 +1,15 @@
 ---
 title: "PU8-U11 docgov action — 获批后任务契约"
-status: planned
+status: done
 created: 2026-09-16
-updated: 2026-09-16
-owner: TBD
-branch: feature/pu8-u11-docgov
-mutex: docgov
+updated: 2026-09-18
+owner: Cursor
+branch: feature/w4-u9-segment-live
+mutex: intent-plan
 go_no_go: go
 flag: MULTI_INTENT_U11_DOCGOV
 ---
 
 # PU8-U11 docgov
 
-**go/no-go**：no-go。独立 flag/mutex；按钮与自然语言同一 owner command；项目 143 只读纪律不变。
+**go/no-go**：GO（覆盖授权）。独立 flag 脚手架已合 `dev`。W4：项目 143 只读 fail-closed。mutex `intent-plan`。报告：[../../test-reports/2026-09-17-w4-u11-docgov-test-report.md](../../test-reports/2026-09-17-w4-u11-docgov-test-report.md)

.doc/ops/long-term/2026-09-16-pu8-u12-workflow-run-control-contract.md

@@ -1,15 +1,15 @@
 ---
 title: "PU8-U12 workflow/run-control — 获批后任务契约"
-status: planned
+status: done
 created: 2026-09-16
-updated: 2026-09-16
-owner: TBD
-branch: feature/pu8-u12-workflow-run-control
-mutex: workflow
+updated: 2026-09-18
+owner: Cursor
+branch: feature/w4-u9-segment-live
+mutex: intent-plan
 go_no_go: go
 flag: MULTI_INTENT_U12_RUN_CONTROL
 ---
 
 # PU8-U12 workflow/run-control
 
-**go/no-go**：no-go。独立 flag；双标签确认/取消仅一成功；投影停机时权威 GET 仍正确；回滚后计划可读/取消/finalize。
+**go/no-go**：GO（覆盖授权）。独立 flag 脚手架已合 `dev`。W4：独立 flag dry-run 证据。不升 `MULTI_INTENT_PLAN_TIER`。报告：[../../test-reports/2026-09-17-w4-u12-run-control-test-report.md](../../test-reports/2026-09-17-w4-u12-run-control-test-report.md)

.doc/ops/long-term/2026-09-16-pu8-u9-segment-proposal-contract.md

@@ -1,10 +1,10 @@
 ---
 title: "PU8-U9 segment proposal — 获批后任务契约"
-status: planned
+status: done
 created: 2026-09-16
-updated: 2026-09-16
-owner: TBD
-branch: feature/pu8-u9-segment-proposal
+updated: 2026-09-18
+owner: Cursor
+branch: feature/w4-u9-segment-live
 mutex: intent-plan
 go_no_go: go
 flag: MULTI_INTENT_U9_SEGMENT
@@ -12,7 +12,7 @@ flag: MULTI_INTENT_U9_SEGMENT
 
 # PU8-U9 segment proposal
 
-**go/no-go**：no-go。规则无法判断时才出 segment proposal；超时/越界 fail closed；非 U10–U12 默认前置。
+**go/no-go**：GO（覆盖授权）。flag 脚手架已合 `dev`。W4：真实 LLM proposer；规则能判断则不出 proposal。不升 `MULTI_INTENT_PLAN_TIER`。报告：[../../test-reports/2026-09-17-w4-u9-segment-test-report.md](../../test-reports/2026-09-17-w4-u9-segment-test-report.md)
 
 ## 安全 stop gate
 

.doc/ops/long-term/2026-09-19-audit-remainder.md

@@ -0,0 +1,119 @@
+---
+title: "2026-09-19 审计剩余项（medium/low，不挡已合入批 1–4）"
+status: planned
+created: 2026-09-19
+updated: 2026-09-19
+---
+
+# 2026-09-19 审计剩余项
+
+## 动机
+
+[系统深度体检](../../audit/2026-09-19-system-deep-audit.md) 的 C1–C4 与 H1–H10 已按四批合入 `dev`。下列 medium/low 仍真实存在，但不进入本轮发布回退。
+
+## 成功标准
+
+- 每条有独立 short-term、负例测试或明确关闭理由后再标 done
+- 不把本清单自动写成 gap-matrix blocker
+
+## 依赖
+
+- 批 1–4 已在 `dev`：`844f757`、`08f4e0b`、`a2a49a6`、`d73bc79`
+
+## 暂不启动原因
+
+本轮范围只到 critical + high。下列项要么是加固、要么需要产品/合规决策，要么改动面大于收益。
+
+## 进展（2026-09-19，`fix/audit-remainder-closeout`）
+
+| ID | 结果 |
+|----|------|
+| M1 | done。`nosniff` / `DENY` / `Referrer-Policy` / 本站 CSP。`TestP0_SecurityHeaders` |
+| M2 | done。TTL 钳到人工 15 分钟、小队 30 分钟；人工租约前 `CheckHumanCanEdit`。`TestAcquireLeaseClampsHumanTTL` |
+| M3 | done（本项可落地部分）。低置信度才做关键词改道；称呼取用户名。高置信度意图层改造不在本项把模板整段搬走 |
+| M4 | done。`parseDecimalID` 拒绝 `u_sess_*`。`TestParseDecimalIDRejectsSessionTokens` |
+| M5 | done。`Server.Start` 不再二次启动并吞错。`main` 仍调用 `Runtime.Start`，该方法本身已幂等 |
+| M6 | done（上限）。硬上限 4096，淘汰最久未访问。会话 id 仍由客户端提供，因为历史恢复按该 id 查找；改成只接受服务端签发会打断现有对话协议 |
+| M9 | done。dev compose 不再声明 `SEMANTIC_SUMMARY_REPLACE`。dev=`MiniMax-M2.7-highspeed`、test/main=`MiniMax-M3` 确认为有意分叉，已写在 compose 注释 |
+| M10 | done（写明路径，不放开门闩）。`OpsCutoverPromotionPath`：dev 观察后用晋升回执写 test，再写 main。`ValidateOpsCutover` 仍拒绝 test/main |
+| M13 | done。SQL 迁到 `deploy/postgres/archive/pre-goose/`。代码与脚本无引用 |
+| M14 | done。冻结计划找不到职责行则报错；显式空三权仍为 0。`TestResolveDocTask_NoneDutiesStayZero` |
+| L1 | done。健康检查 2 秒缓存 + 2 秒 DB 超时 |
+| L2 | done。SSE marshal 失败写 `event: error` 帧 |
+| L3 | done。`ReplayPlan.Digest` 含 `DryRun`；dry-run 摘要不能授权 apply |
+| M15 | done。生产 `claimSQL` 与 `MemoryBus` 共用 `VersionClaimable`：版本 0 可领，版本化事件不能跳过 checkpoint。checkpoint 只前进。`TestVersionClaimableMatchesMemoryBusGap`、`TestGapDoesNotSkipVersion` |
+| H3 负例 | done。`TestListChatSessions_CrossUserIs403` |
+| FE 缓存 | done（版本字段）。窗口缓存写入 `{schema,data}`，无 schema 的旧载荷丢弃。`window cache: 无 schema` |
+| FE lucide | 关闭理由：`package-lock.json` 锁定 `lucide-react@1.42.0`，来源 `registry.npmjs.org`，带 integrity。`^1.16.0` 是合法的 1.x 范围，不是来源不明的包 |
+| M7 | done（出站意图 + 同键重放）。`document_content_projections` 与账本同一事务写入；投影成功才销账。`TestDocRevision_PatchOrder_RetryProjectsWithoutSecondLedgerCommit`。账本库与正文库仍不是一个 SQL 事务，进程退出后靠未投影行重放，不靠客户端记忆 |
+| FE App.tsx | 部分收口。登录壳不再静态引用重模块。本地缓存、登录同步、文档补水、服务端文档同步、生命周期、发送消息、块编辑、对话流/任务流重试、卡片动作、立项和成员写操作已分别抽出。文档栏在 `DocumentPane`，聊天栏在 `ChatColumn`，`AppShell` 与工作台弹窗在 `WorkbenchView`。`App.tsx` 仍持有会话状态，不再挂 `<AppShell` |
+| H1-del | 关闭理由：`allowLegacyTestPrincipal` 仍被 `AllowInMemory && ContextDbHost==""` 的 dev/test 内存测试使用。删除会把这批测试变成未登录 401。保留告警，删除另开、先改测试夹具 |
+
+仍开放：`rd_proposal` 终稿未对齐模板标题（没有新的真 PI）。U7 登录表单可见未测（本机无头 Chromium 缺 `libatk`），也不把 1.4 秒模块图写成「较十几秒基线下降 50%」。见 [U7 报告](../test-reports/2026-09-19-initial-load-u7-restart-test-report.md)。工作台壳已挪到 `WorkbenchView`。dev schema 53。U6 仍不加索引。`TestArchitectureBoundaries` 仍有 6 条新 import（intent/squad/template → workflowdef），不是本轮容器改动。test/main 仍是 schema 52。评审门禁的法规表误伤已修，保存的 P3 终稿不再报「问题行缺少」。
+
+红线关闭（不是实现）：
+
+- SWBOOT-10：保持 fail-closed stub。未获独立授权前不接真实仓库写入。
+- FAV live：禁止整支 merge；`FAV_DEGRADED_READ=false`；live 需要各阶段至少 7 天观察窗，本轮不放量。
+- D7：合规签字前禁止按留存口径物理删除。盘点已完成，口径仍 `pending-compliance-signoff`。
+
+## 清单
+
+| ID | 项 | 位置 | 说明 |
+|----|----|------|------|
+| M1 | 安全响应头 | `internal/server/server.go` CORS 中间件 | 补 `nosniff` / `X-Frame-Options` / `Referrer-Policy` / 收敛 CSP |
+| M2 | 租约 TTL 无上限 | `handlers.go` AcquireLease | clamp 到 `DefaultHumanLeaseTTL`，Acquire 前校验编辑权 |
+| M3 | 关键词改写意图 + 硬编码「张工」 | `internal/coordinator/engine.go` | 移到意图层并加置信度；称呼取用户名 |
+| M4 | `fmt.Sscanf` 解析 `u_sess_*` 得到 UserID=0 | 同上 | 统一数字 ID |
+| M5 | `Runtime.Start` 双调用且吞错 | `cmd/server/main.go` 与 `server.go` | `sync.Once` 或删 Server.Start 内调用 |
+| M6 | sessions 无硬上限 | `server.go` cleanStaleSessionsLocked | LRU + 服务端发 session id |
+| M7 | 修订三阶段写无事务 | `document_revision_handlers.go` | 已落地：`00053` 投影意图与账本同事务；成功后销账。见进展表 |
+| M9 | `SEMANTIC_SUMMARY_REPLACE` 只在 dev compose 声明；dev/test 默认模型不一致 | compose | 删未接线 flag 并钉死测试；确认 M3 是否刻意 |
+| M10 | cutover 只允许 `dev` | `internal/events/cutover.go` | 写明 test/main 切换路径 |
+| M13 | `deploy/postgres/migrations/` 死目录 | 与 goose 重复 | 确认无外部依赖后归档 |
+| M14 | ResolveDocTask 静默 0 值三权 | `orchestrator.go` | 找不到 duties 应报错 |
+| M15 | PG 投递允许乱序，MemoryBus 有 gap | `dispatcher.go` vs `bus.go` | 对齐测试替身与生产顺序语义 |
+| L1 | health 每次打两次 DB | `handlers.go` | 短缓存 + 超时 |
+| L2 | SSE marshal 错误被吞 | `task_run_handlers.go` | 失败写 error 帧 |
+| L3 | ReplayPlan digest 不含 DryRun | `replay.go` | 纳入 digest |
+| H1-del | 删除 legacy user-id=1 兜底 | `auth_middleware.go` | 已加日志；删除前盘点调用方 |
+| FE | App.tsx 巨石、localStorage 无版本、lucide 版本确认 | `web/` | 拆 hook；缓存加 version；确认包来源 |
+
+## 相关链接
+
+- 审计：[../../audit/2026-09-19-system-deep-audit.md](../../audit/2026-09-19-system-deep-audit.md)
+- 批 1–3 报告：`.doc/test-reports/2026-09-19-audit-b*.md`
+
+## 2026-09-20 系统体检增补（非 P0，不挡本轮热修）
+
+> 来源：[../../audit/2026-09-20-system-triage-audit.md](../../audit/2026-09-20-system-triage-audit.md)。P0 项走 [../../remediation/2026-09-20-p0-remediation-plan.md](../../remediation/2026-09-20-p0-remediation-plan.md)，不写入本表为「已关闭」。
+
+| ID | 项 | 位置 | 说明 |
+|----|----|------|------|
+| T20-B1 | 登录限流信任 XFF 首跳 | `login_rate_limit.go` | 仅在可信代理后启用；否则用 RemoteAddr |
+| T20-B2 | events `cancelFns` 只增不减 | `events/worker.go` | claim 完成后从切片移除 |
+| T20-B3 | docrevision/docgov 全局锁内 DB I/O | `docrevision/*` `docgov/lease.go` | 锁外 hydrate / 按文档分锁 |
+| T20-B4 | 主库连接池无 statement_timeout | `bizdev/service.go` | 对齐 kb 池调优 |
+| T20-B5 | chat 消息与 turn 非原子 | `chat/session.go` | 同事务或补偿明确 |
+| T20-B6 | `idemLocks` map 永不清理 | `taskrun/manager.go` | TTL 或终态回收 |
+| T20-B7 | Shutdown 5s vs 长任务 | `cmd/server/main.go` | 拉长优雅退出或拒绝新任务 |
+| T20-B8 | `hasMessageScopeColumns` 无缓存 | `message_scope_io.go` | 启动缓存一次 |
+| T20-B9 | C1 记忆写入不失效缓存 | `chat_memory.go` | upsert 后 Invalidate |
+| T20-B10 | SSE 头先写再 Subscribe | `task_run_handlers.go` | 对齐 sse.go 顺序 |
+| T20-B11 | GET chat/stream 消息走 query | `sse.go` | 改 POST body |
+| T20-F1 | `useChatWindow` 切会话竞态 | `useChatWindow.ts` | loadOlder 等加 generation/abort |
+| T20-F2 | PLAN_CONFIRM 无 try/catch | `useCardActions.ts` | 失败复位 executing |
+| T20-F3 | turn Map 只增不减 | `useTurnRuntime.ts` | removeTurn 接线 |
+| T20-F4 | 重置密码死功能 + 硬编码文案 | `UsersSection.tsx` | 接真实 API 或隐藏按钮 |
+| T20-F5 | ErrorBoundary 仅顶层 | `main.tsx` | 栏级边界 |
+| T20-F6 | SSE 帧不兼容 `\r\n` | `chatStream.ts` | 规范 CRLF |
+| T20-F7 | token 存 localStorage + 无全局 401 | `auth.ts` | HttpOnly cookie 专项 |
+| T20-F8 | blob URL / 轮询叠加 / 统计迟到 | 多处 | 加固批 |
+| T20-I1 | 容器 root、无 mem/cpu 限制 | compose / Dockerfile | 非 root + resources |
+| T20-I2 | 健康检查路径三环境不一致 | compose | 统一 `/ready` |
+| T20-I3 | main events 挂 shared-net | `docker-compose.main.yml` | 对齐 dev/test |
+| T20-I4 | init 策略三套分叉 | compose volumes | 统一 extensions_init |
+| T20-I5 | Dockerfile Go 1.23 基镜像 | `deploy/app/Dockerfile` | 钉 1.27.1 |
+| T20-I6 | backup 无定时调度 | ops | systemd/cron；RPO 60m |
+| T20-I7 | **main 分支对齐晋升专项** | git main vs schema 52 | 独立授权；含 00057 改名预演 |
+| T20-I8 | 默认 short 测依赖外网 docker 镜像 | `pi_runner_image_test.go` | Short 跳过或本地 fixture |

.doc/ops/long-term/2026-09-21-agent-workflow-governance-automation.md

@@ -0,0 +1,34 @@
+---
+title: "Agent worktree 治理自动化 W0–W4"
+status: planned
+created: 2026-09-21
+updated: 2026-09-21
+owner: next-implementation-owner
+mutex: agent-workflow-governance
+---
+
+# Agent worktree 治理自动化 W0–W4
+
+工作方式已由用户采纳，本任务跟踪完整工程能力及剩余范围。规则生效不等于脚本或权限隔离已完成。
+
+## 按依赖实施
+
+1. W0：接续主目录旧任务，核查运行挂载与热补丁，安全回到 dev。
+2. W1：修 worktree 创建起点、主仓定位、安全 remove、路径/分支校验和构建忽略。
+3. W2：原子认领、资源 mutex、集成队列、env-service guard、operation 恢复。
+4. W3：候选测试对应实际 dev/运行制品，PI 源码镜像交付、就绪/业务验收和恢复。
+5. W4：证据归档、条件自动清理、客户端薄入口与状态投影。
+
+每个实施任务从当时 dev 在 `.worktrees/` 开工；按 [完整方案](../../remediation/2026-09-21-agent-workflow-governance-plan.md) §11 验收。W5 OS/跨机能力按实际需要另立任务。
+
+## 关闭条件
+
+- 两个独立任务完成并行开发、串行交付、运行验收和安全清理。
+- 错误起点、并发抢占、危险清理、部署失败/超时/崩溃均有拒绝或恢复证据。
+- 自动化机制确实落地后再将对应 FEATURE-MATRIX 能力升 done。
+
+## 2026-09-21 L1 分批交付
+
+[实施任务](../../archive/ops/2026-09-21-agent-governance-implementation.md) 已验证 W1、安全门禁、W2 本机 SQLite 原子租约/恢复/有限等待、两个共享文档 CAS，以及 W3 精确候选准入与固定源码导出、W4 薄入口和证据归档。验收见[报告](../../test-reports/2026-09-21-agent-governance-test-report.md)，实际主仓启用状态以收口为准。
+
+完整自动化仍未关闭：后台持久队列与自动调度、通用文档投影、两个业务任务的部署/恢复闭环、产品 PI 源码镜像交付及本机不可读进程造成的清理限制仍需后续范围；OS/跨机隔离另立任务。不得把本次临时 Git 仓库门禁测试当作真实业务运行验收。

.doc/ops/long-term/2026-09-21-http-request-access-log.md

@@ -0,0 +1,29 @@
+---
+title: "HTTP 请求访问日志"
+status: planned
+created: 2026-09-21
+updated: 2026-09-21
+---
+
+# HTTP 请求访问日志
+
+## 动机
+
+2026-09-21 排查 test 环境「网络连接异常」时，app 容器没有请求级访问日志。无法区分「请求未到达」与「到达后在鉴权/SSE 早期失败」。数据库里也没有失败请求的消息行。
+
+## 成功标准
+
+- 每条 HTTP 请求打一行结构化日志：方法、路径、状态码、耗时、request_id；不记录正文、token、密码
+- 默认在 dev/test 开启；不把密钥或完整 prompt 写入日志
+
+## 依赖
+
+- 与本次错误透传修复独立，可单独认领
+
+## 暂不启动原因
+
+本次只修错误透传（json 标签 + 前端文案）。访问日志会碰到所有路由，需要单独设计和验证，避免日志泄漏。
+
+## 相关链接
+
+- Short-term: [2026-09-21-taskrun-error-transparency.md](../short-term/2026-09-21-taskrun-error-transparency.md)

.doc/ops/research/2026-09-17-rdev-workflow-reference-analysis.md

@@ -0,0 +1,93 @@
+---
+title: "参考项目 weichen-agent-system 研发工作流（rdev）文档关系与阶段组成梳理"
+created: 2026-09-17
+status: done
+confidence: high
+---
+
+# 调研：参考项目 weichen-agent-system 研发工作流（rdev）文档关系与阶段组成梳理
+
+## 结论
+
+参考项目 `.refs/weichen-agent-system` 中的「研发流程」（`key: rdev`）是与商务对接（bizdev）、测试经理（test_manager）、产品经理（product_manager）并列的第 4 个工作流，`kind: followon`、`after: bizdev`：商务对接末阶段 CDO 报价批准后才可启动。rdev 共 **60 个阶段（文档任务）**，按 **13 个 phase（01–13）** 组织成 ISO 13485 设计控制链（策划 → 输入 → 输出 → 验证 → 转换 → 确认），每阶段恰好对应 `templates/docs/<stage_key>.md` 一份自描述模板，并有 overlays（工作流级 `rdev.md` + 阶段簇 `rdev_phNN.md` + 文档类型 `kind_*.md`）与 `configs/squads/rdev.yaml` 五步小队编排三层配套。
+
+## 证据
+
+| 项 | 路径/命令 | 结果 |
+|----|-----------|------|
+| 工作流定义 | `.refs/weichen-agent-system/configs/workflows/rdev.yaml` | 1473 行；`key: rdev` `kind: followon` `after: bizdev`；60 个 stage |
+| 阶段齐套校验 | `.refs/weichen-agent-system/scripts/e2e-rdev.sh` | 脚本内置断言 `want 60 rdev stages`，逐 stage 校验 `templates/docs/<key>.md` 存在且非空，末模板须含「签署」 |
+| 小队编排 | `.refs/weichen-agent-system/configs/squads/rdev.yaml` | `default_steps`：organizer → engineer（+regulatory 可选并行）→ writer → leader；关键 stage 覆盖专属 steps |
+| 任务叠加 | `.refs/weichen-agent-system/configs/overlays/rdev.md`、`rdev_ph01…ph13.md`、`rdev_software.md`、`kind_review_minutes.md`、`kind_upload_index.md`、`kind_design_record.md` | 工作流级 / 阶段簇 / 文档类型三层叠加，`### role:` 按专员过滤 |
+| 研发负责人人设 | `.refs/weichen-agent-system/configs/agents/rdev_leader.md` | 「研发/设计控制小队负责人…按 ISO 13485 把本阶段做成可追溯的 DHF 记录」 |
+| 插件 | `.refs/weichen-agent-system/plugins/rdev/plugin.go` | 不注册生成意图，启动走生命周期 `start_workflow`（说法「启动研发流程」） |
+| 官方说明 | `.refs/weichen-agent-system/docs/workflows.md` §研发流程、`docs/handoff.md` §研发流程（followon） | 约 60 阶段、每阶段一份 Word（RD-…）、不适用须完整理由并仍走审核/批准 |
+| Canonical 归档 | `docs/cloud-drive.md` | `archive/dhf/{NN-阶段名}/{nn-产出}`；`records` 含 `dmr` 且已批准再拷 `archive/dmr/` |
+
+## 研发工作流的文档关系（五层结构）
+
+```text
+configs/workflows/rdev.yaml     ← 阶段 SSOT：key/标题/phase/records/artifact_kind/docx 元数据/fields/depends_on/skippable
+        │  一一对应（stage key = 模板文件名）
+        ▼
+templates/docs/<stage_key>.md   ← 自描述模板：文件编号 RD-…、记录归属 DHF(/DMR)、阶段 NN、
+        │                          结论/适用性/正文/追溯表/材料摘要/待确认清单/签署 固定骨架
+        ▼
+configs/squads/rdev.yaml        ← 小队编排：default_steps + 个别 stage 覆盖（五步编制流水线）
+        ▼
+configs/overlays/*.md           ← 任务叠加（注入 TASK 的阶段级撰写指导，多层）：
+                                   ① rdev.md（工作流级全员质量红线）
+                                   ② rdev_phNN.md（阶段簇，ph01–ph13）
+                                   ③ kind_review_minutes / kind_upload_index / kind_design_record（文档类型）
+                                   ④ rdev_software.md（软件类阶段专项）+ 个别 stage 特例 overlay
+        ▼
+plugins/rdev/plugin.go          ← 运行时入口：启动走生命周期 start_workflow（followon 门禁），
+                                   不注册生成意图；启动时从 bizdev 拷贝已填字段（产品类型/预期用途/目标市场等）
+```
+
+- **模板即文档**：每份模板头部自带「文件编号 / 记录归属 / 版本 / 阶段」元数据，与 rdev.yaml 中 stage 的 `docx.code`（RD-…）和 `phase` 一致；`scripts/e2e-rdev.sh` 强制校验 60 个 key 与模板一一对应。
+- **记录归属双轨**：`records: [dhf]`（设计历史文件）为主；设计输出/转换类文档 `records: [dhf, dmr]`（同时属器械主记录），批准后额外拷贝到 `archive/dmr/`。
+- **追溯链**：每份模板含固定「追溯」表（本文件 ID ↔ 上游输入 ↔ 下游验证/确认），需求类要求 UR→RS 追溯主表（见 `kind_design_record.md`）。
+- **评审依赖**：评审记录类 stage 用 `depends_on` 显式声明上游（如 `verification_review` depends_on `design_vv`、`risk_report_v`）。
+- **不适用机制**：每 stage 都有 `applicability` / `na_rationale` 字段；软件类/动物试验/临床等 15 个 stage 标 `skippable: true` + `skip_hint`，不适用仍须生成完整不适用页并走审核/批准。
+
+
+## 工作流阶段组成（13 个 phase / 60 个 stage）
+
+| Phase | 阶段簇 overlay | Stage（key → 文档） | 数量 |
+|-------|--------|--------------------|------|
+| 01 策划 | rdev_ph01 | `proposal` 项目建议书、`design_plan` 设计开发计划任务书 | 2 |
+| 02 策划评审 | rdev_ph02 | `planning_review` 策划评审记录（depends: proposal, design_plan） | 1 |
+| 03 设计输入 | rdev_ph03 | `user_needs` 用户需求规格书(UN)、`regs_stds` 法规和标准清单、`adverse_events` 同类产品不良事件、`system_reqs` 系统需求规格书(SR)、`risk_plan` 风险管理计划、`hazard_analysis` 危险分析、`sw_plan`*/`sw_reqs`*/`sw_config`* 软件三件套、`design_input_spec` 设计输入规格书、`design_input_list` 设计输入清单、`system_design` 系统设计方案 | 12 |
+| 04 需求评审 | — | `req_review` 需求评审记录（depends: user_needs, system_reqs） | 1 |
+| 05 输入阶段评审 | — | `input_phase_review` 阶段3和4评审记录（depends: design_input_spec/list, req_review） | 1 |
+| 06 设计输出 | rdev_ph06 | `drawings_3d` 图纸3D、`product_bom` BOM、`ee_bom`*/`pcba`*/`electrical_sys`* 电气三件套、`sw_arch`*/`sw_ui`* 软件、`purchase_spec` 采购规范、`process_flow` 工艺流程、`packaging` 包装、`ifu` 说明书、`incoming_iqc`/`ipqc`/`fqc` 三级检验、`tech_req` 产品技术要求、`risk_report` 风险管理报告、`design_output_list` 设计输出清单 | 17 |
+| 07 输出评审 | — | `output_review` 阶段6评审（depends: design_output_list） | 1 |
+| 08 验证 | rdev_ph08 | `prototype_photos` 样机照片、`design_vv` 设计验证方案、`shelf_life` 货架寿命、`lifetime` 使用期限、`biocompatibility` 生物学、`cleaning` 清洁消毒、`emc_safety`* EMC安规、`risk_report_v` 验证风险报告、`sw_release`*/`sw_unit_test`*/`sw_sys_test`* 软件三件套、`qualified_suppliers` 合格供方 | 12 |
+| 09 验证评审 | — | `verification_review`（depends: design_vv, risk_report_v） | 1 |
+| 10 转换 | — | `dmr_list` DMR文件清单、`pack_ship` 包装运输、`risk_report_t` 转换风险报告 | 3 |
+| 11 转换评审 | — | `transfer_review`（depends: dmr_list, pack_ship, risk_report_t） | 1 |
+| 12 确认 | — | `validation_plan` 设计确认方案、`use_error` 使用错误、`animal_study`* 动物试验、`sw_quality`* 软件质量、`clinical`* 临床试验报告、`risk_report_val` 确认风险报告、`user_test` 用户测试 | 7 |
+| 13 设计确认报告 | — | `design_validation_report` 设计确认报告（末阶段，批准后项目 done） | 1 |
+
+合计 60，与 `e2e-rdev.sh` 的 `want 60 rdev stages` 断言一致。（`*` = `skippable: true`，实测 grep 共 15 个：软件 9 个（sw_plan/sw_reqs/sw_config/sw_arch/sw_ui/sw_release/sw_unit_test/sw_sys_test/sw_quality）+ 电气 3 个（ee_bom/pcba/electrical_sys）+ emc_safety + animal_study + clinical）
+
+**artifact_kind 三类**（grep 实测）：`document`（常规成文，47 个）、`review_minutes`（评审记录，6 个）、`upload_index`（附件清单/上传索引，7 个，只建索引不伪造内容）。各 kind 有独立 overlay 质量要求。
+
+## 小队与治理机制
+
+- **小队编制**：复用整理(organizer)/技术(engineer)/撰写(writer)/法规(regulatory)/检索(searcher)专员，种子化「研发流程负责人」(rdev_leader)；市场与财务不进研发小队。
+- **默认五步**：organizer（抽材料事实+回填字段+blackboard facts/gaps/implications）→ engineer（技术内容与追溯，可并行）→ regulatory（仅 complexity_tier=high，可选并行）→ writer（按模板成稿）→ leader（二审完整性/粒度/不适用理由/有无编造，不达标退回）。
+- **门禁**：启动前必须 bizdev CDO 已批准（e2e 脚本专门验证「CDO 前启动应被拒绝」）；启动时从商务对接拷贝产品类型/预期用途/目标市场等字段。
+- **状态机**：与 bizdev 同一套编制/审核/批准 FSM；末阶段批准后项目标 `done`。
+
+## 开放问题
+
+- 本仓库（Agent-System）当前尚无 rdev 工作流模块；若要移植，需评估 60 stage × 模板 × overlay × 小队步骤的落地范围与分期（bizdev 已有移植先例）。
+- 参考项目 `records: [dhf, dmr]` 双归属与云盘 canonical 归档机制在本仓库尚无对应物，移植时需决策是否引入。
+- `complexity_tier=high` 才注入 regulatory 步；本仓库复杂度分层（complexity_high/medium overlay）如何对齐需另调研。
+
+## 建议动作
+
+- 若立项移植 rdev：在 `ops/short-term/` 新建任务，按「工作流定义 → 模板 → 小队 → overlays → 生命周期门禁」顺序分批实施，先做 phase 01–03（策划/输入）切片。
+- 移植时保留「stage key = 模板文件名」一一对应约束，并复刻 e2e 齐套校验（60 stage、模板非空、末模板含签署）。

.doc/ops/research/2026-09-19-pre-test-promotion-review.md

@@ -0,0 +1,151 @@
+---
+title: "dev→test 晋升前复核：功能权限、合并可行性、已知缺陷"
+created: 2026-09-19
+updated: 2026-09-19
+status: done
+confidence: high
+---
+
+# 调研：dev→test 晋升前复核
+
+只读复核。不改业务代码、不 rebuild 容器、不合入 `test`/`main`、不修复 [medium/low backlog](../long-term/2026-09-19-audit-remainder.md)。
+
+## 结论
+
+1. **规划内的功能、权限与流程已按声明范围接入。** [FEATURE-MATRIX](../../status/FEATURE-MATRIX.md) 主表里，除明确标成 `partial` / `deferred` 的行以外，其余能力均为 `done`，并有测试报告或 commit 证据。没有发现「规划了但完全未实现」的模块。未完成项是主动延后，且 [gap-matrix](../../remediation/gap-matrix.md) 已判定不挡首发。
+2. **`dev` 的静态质量达标，但现在不建议直接合并入 `test`。** `go vet` 与 `go test -short` 全绿，2026-09-19 深度审计的 critical/high 已合入 `dev`。合并前仍缺三件事：dev 容器 rebuild 冒烟、治理 PG 集成与前端构建、批 2 越权负例的自动化覆盖。
+3. **critical/high 已关闭；medium/low 仍在，且本轮不修。** 新发现的观察项是文档漂移和 `test` 分支上 9 个晋升提交，不是新的代码缺陷。
+
+## 一、功能、权限、流程
+
+对照 [FEATURE-MATRIX](../../status/FEATURE-MATRIX.md)（更新 2026-09-19）与 [gap-matrix](../../remediation/gap-matrix.md)（`production_ready=yes`，门禁 B1–B4 已签）。
+
+### 已关闭（声明范围内 `done`）
+
+| 能力 | 接入情况 |
+|------|----------|
+| 意图识别 L1、多意图 U1–U8、多意图扩面 U9–U12 | 代码与报告齐全；`MULTI_INTENT_PLAN_TIER` 仍为 `legacy`，未默认升 `confirm`/`full` |
+| 对话 / ctxmgr、语义摘要 D3、PI change-report 叙事 | 刷新恢复门禁已签；摘要与叙事 flag 默认 off，REPLACE 未启用 |
+| 工作流治理 | 三正式工作流、动作级鉴权、真实 PI E2E |
+| 文档治理、文档版本 baseline | 法定生命周期、租约、受控正文、运行时 UI |
+| IAM / 鉴权 | 项目级 API + RBAC；路由清单见 [authorization-matrix-v3](../../audit/authorization-matrix-v3-full.md) |
+| 前端工作台、PI Runner、三环境运维、CI/E2E、Artifact 同 digest、可靠事件核心、系统管理台 | 各自行有报告；系统管理台二期（Playwright、细粒度 `system:*`、设置审计）不在本行关闭条件内 |
+| 文档编制人兼任（U1–U6） | 已合入 `dev`；总开关默认 off |
+
+2026-09-19 审计批 2 已把鉴权缺口接到主链：H1 给 dev/test legacy 兜底加了告警（未删除兜底）、H2 批注/认领 actor 取 principal 且读类端点校验项目成员、H3 会话查询跨用户 403、H4 登录限流、H8 compose 口令改为必填。证据：[批 2 报告](../../test-reports/2026-09-19-audit-b2-authz-hardening-test-report.md)。
+
+### 明确未完成（不是遗漏）
+
+| 行 | 状态 | 剩余 | 是否挡首发 |
+|----|------|------|------------|
+| 研发设计控制（rdev） | partial | S2/S3、P2 前端、P3 三样本 E2E、P4 键名空间化 | 否 |
+| 纯软件项目自举 | partial | SWBOOT-10 仍 fail-closed stub | 否 |
+| Final Artifact Vault | partial | live 未放量；禁止整支 merge；`FAV_DEGRADED_READ=false` | 否 |
+| 对话数据治理（D7） | deferred | `pending-compliance-signoff`；禁止按口径物理删除 | 否（违规则才升 blocker） |
+| 首次加载性能 | partial（矩阵外专项） | U2 已验收；U1/U3–U7 未做 | 否 |
+
+红线与代码/compose 对齐（深度审计已核实，本轮未再改 flag）：`MULTI_INTENT_PLAN_TIER=legacy`、`SEMANTIC_SUMMARY_REPLACE` 未接线、`FAV_DEGRADED_READ=false`、SWBOOT-10 fail-closed stub、项目 143 只读。
+
+## 二、`dev` 能否合入 `test`
+
+**判断：静态门禁通过，运行态与回归门禁未补齐，暂不合并。**
+
+### 已满足
+
+- `dev` 工作树在复核时干净；`dev` HEAD 为 `66421b1`（含审计批 1–4：`844f757`、`08f4e0b`、`a2a49a6`、`d73bc79`）。
+- `go vet ./...` 零告警。
+- `go test -short ./...` 全包 PASS（`internal/server` 本轮实测约 14s，非缓存）。
+- 三环境 `GET /api/v1/health` 均为 `status=ok`、`schema_version=52`、`schema_ready=true`。goose 最新文件为 `00052`。迁移版本本身不阻塞晋升。
+- `internal/`、`cmd/` 生产代码中无 `TODO`/`FIXME`/`XXX`。
+
+### 合并前必须处理
+
+1. **dev 容器仍是旧二进制。** 批 1–3 报告写明未执行 `./scripts/env-service.sh dev rebuild`。`:8080` 健康只证明旧镜像在跑，不能证明审计修复已部署。按 [AGENTS.md](../../../AGENTS.md) §6.3，合入共享环境前要占集成槽位并冒烟。
+2. **`dev` 领先 `test` 225 个 commit。** 差异覆盖 rdev 模板、系统管理台、docgov 加固、Control Center 移除等。`-short` 不够。晋升前至少再跑：`TEST_DATABASE_URL` 下治理 PG 集成，以及 `cd web && npm test && npm run build`。
+3. **批 2 的越权负例仍是人工兜底。** [批 2 报告](../../test-reports/2026-09-19-audit-b2-authz-hardening-test-report.md) 写明：非项目成员访问 docgov 应 403 的 HTTP/Playwright 负例未补，目前靠既有鉴权测试不回退加 code review。
+
+### `test` 上多出来的 9 个提交
+
+`git rev-list --count dev..test` = 9。这些提交是历次 `release-candidate` / 晋升文档同步（含 `rc-v1.0.0-beta.2` 至 `beta.4`），不是 `dev` 上缺失的产品代码。下次晋升应把 `dev` **merge 进** `test`，不要把 `test` reset 到 `dev`，否则这 9 个提交的晋升记录会丢。
+
+`CURRENT.md` 文首仍写 test `schema_version=48`，同文「环境快照」表与本次 health 实测已是 52。这是文档漂移，不是运行时缺陷。更正留给下次晋升文档，本笔记不改那一行。
+
+## 三、缺陷
+
+### 已修复（2026-09-19 深度审计 critical/high）
+
+来源：[系统深度体检](../../audit/2026-09-19-system-deep-audit.md)。四批均已合入 `dev`。
+
+| 批 | 项 | merge |
+|----|----|-------|
+| 1 数据一致性 | C1 docgov 吞错与 fencing 读回；C2 Session 竞态与跨项目污染；C4 计划保存事务与 `completed_by`；H10 请求 ctx | `844f757` |
+| 2 鉴权 | H1–H4、H8、M8 | `08f4e0b` |
+| 3 SSE/事件 | C3 心跳与写超时；H5 任务 SSE 幂等；H6 stale fencing 日志；H7 迁移注释（历史 SQL 不能补 down） | `a2a49a6` |
+| 4 前端 | H9 占位符 XSS；未读回滚；Excel 预览上限 | `d73bc79` |
+
+H1 的 legacy user-id=1 兜底只加了日志，删除仍在 backlog（`H1-del`）。H7 的 00001–00009 无 down 不能改已应用文件，只加了注释。
+
+### 已知未修（维持 backlog，本轮不启动）
+
+清单 SSOT：[2026-09-19-audit-remainder.md](../long-term/2026-09-19-audit-remainder.md)。均为 medium/low，不回写 gap-matrix。
+
+| ID | 项 |
+|----|----|
+| M1 | 缺 `nosniff` / `X-Frame-Options` / `Referrer-Policy`，CSP 未收敛 |
+| M2 | 租约 TTL 无上限；Acquire 前未校验编辑权 |
+| M3 | 关键词改写意图；硬编码「张工」 |
+| M4 | `u_sess_*` 解析失败得到 UserID=0 |
+| M5 | `Runtime.Start` 双调用且吞错 |
+| M6 | sessions 无硬上限 |
+| M7 | 修订三阶段写无事务 |
+| M9 | `SEMANTIC_SUMMARY_REPLACE` 只在 dev compose 声明；dev/test 默认模型不一致 |
+| M10 | cutover 只允许 `dev` |
+| M13 | `deploy/postgres/migrations/` 与 goose 重复 |
+| M14 | ResolveDocTask 静默 0 值三权 |
+| M15 | PG 投递允许乱序，MemoryBus 有 gap |
+| L1 | health 每次两次 DB |
+| L2 | SSE marshal 错误被吞 |
+| L3 | ReplayPlan digest 不含 DryRun |
+| H1-del | 删除 legacy user-id=1 兜底前须盘点调用方 |
+| FE | `App.tsx` 巨石、localStorage 无版本、lucide 来源待确认 |
+
+M8（测试 flag 名 `FAV_PUBLISHER_ENABLE` 少一个 D）已在批 2 修复，不在上表。M11/M12 的未读回滚与 Excel 行数上限已在批 4 处理；批 4 报告写明浏览器端到端未覆盖这两条，单测已钉住 XSS 主路径。
+
+### 本轮新观察（不单独立项）
+
+- 文首 schema 数字与实测不一致，见第二节。
+- `test` 独有 9 个晋升提交，合并时用 merge，不要 reset。
+
+## 证据
+
+复核时间：2026-09-19。工作区当时在 `docs/audit-remediation-backlog`（树与 `dev@66421b1` 一致），随后本笔记落在 `docs/pre-test-promotion-review`。
+
+| 项 | 路径/命令 | 结果 |
+|----|-----------|------|
+| 工作树 | `git status` | clean |
+| dev 领先 test | `git rev-list --count test..dev` | 225 |
+| test 领先 dev | `git rev-list --count dev..test` | 9（晋升/文档提交） |
+| 静态检查 | `go vet ./...` | 零告警，exit 0 |
+| 短测 | `go test -short ./...` | 全包 PASS；`internal/server` 14.044s |
+| dev health | `curl -s http://127.0.0.1:8080/api/v1/health` | `env=dev` `schema_version=52` `status=ok` |
+| test health | `curl -s http://127.0.0.1:8081/api/v1/health` | `env=test` `schema_version=52` `status=ok` |
+| main health | `curl -s http://127.0.0.1:8000/api/v1/health` | `env=main` `schema_version=52` `status=ok` |
+| 迁移文件 | `deploy/postgres/goose/` | 52 个 SQL，最新 `00052_2026-09-17-document-duty-locked.sql` |
+| worktree | `git worktree list` | 主仓 + `dev-rdev-merge` + `feature-initial-load-performance-plan` + `fix-dev-runtime-data-root-guard`（检出 `feature/final-artifact-vault`） |
+| 待办标记 | `grep TODO\|FIXME\|XXX` 于 `internal/` `cmd/`（排除 `_test.go`） | 0 |
+| 容器 | `docker ps` | dev/test/main app+events+pi-agent 均为 healthy；dev app 已运行约 5 小时，早于批 1–4 合入后的 rebuild（未做） |
+
+## 开放问题
+
+- dev 与 test/main 默认模型不一致（M2.7-highspeed vs M3）是否刻意？深度审计已记，本轮无新证据。
+- `deploy/postgres/migrations/` 是否仍有外部工具依赖？无则再归档（M13）。
+- H2/H3 越权负例补到哪一层才算晋升门禁：HTTP 集成即可，还是必须 Playwright？
+
+## 建议动作
+
+按顺序，全部另开任务，不在本笔记内执行：
+
+1. 占集成槽位，`./scripts/env-service.sh dev rebuild`，`curl -sf http://127.0.0.1:8080/health`（或 `/api/v1/health`）确认 schema 52 且二进制含批 1–4。
+2. `TEST_DATABASE_URL` 下跑治理 PG 集成；`cd web && npm test && npm run build`。
+3. 为 H2/H3 补至少一条跨用户/非成员 403 负例。
+4. 通过后再把 `dev` merge 入 `test`（保留 test 上 9 个晋升提交），打 rc tag，并顺手更正 `CURRENT.md` 文首的 test schema 表述。

.doc/ops/research/2026-09-20-capability-enablement-impact-plan-review.md

@@ -0,0 +1,53 @@
+---
+title: "功能启用与文档影响整改方案审阅记录"
+created: 2026-09-20
+status: done
+confidence: high
+---
+
+# 功能启用与文档影响整改方案审阅记录
+
+## 审阅范围
+
+- 文档：[2026-09-20-capability-enablement-impact-plan.md](../../remediation/2026-09-20-capability-enablement-impact-plan.md)
+- 类型：实施整改方案
+- 模式：非交互审阅；在既定目标内直接修正方案和验收条款
+- 视角：coherence、feasibility、security、scope guardian、product、design、adversarial
+- Compound Pack：无
+
+## 已落地修正
+
+1. 候选必须生成持久 `proposed` 报告；候选和正式提交事件分流，并补失效生命周期和 successor report。
+2. 人工关系确认/拒绝进入不可变决定账本；可重建投影不再承担唯一治理事实。
+3. 规范 report 与当前主体的 ReportView 分层，按 report revision、可见集 digest 和 narrative protocol 隔离及失效。
+4. `no_known_dependencies` 增加项目覆盖 epoch 和可见文档集合屏障。
+5. PI 消费者共用 R13 输入信封；纯推理 no-tool 必须由 Runner 强制。
+6. 多意图复用已有 intent plan 步骤、claim、receipt 和事件内核，仅补生产 dispatcher 和真实 owner。
+7. 实施顺序改为共享基座 + 多意图/摘要/影响追踪三条独立轨道。
+8. 显式无类型 ID 只形成候选；补无键、重复键、改名和历史映射身份契约。
+9. 数据模型明确为五张表；迁移门覆盖空库、schema 52 和 schema 53。
+10. 管理台补先读后改、预览、生效和回退流程；项目追踪页补信息架构。
+11. 建议动作和异步分析补完整状态、恢复路径和跨入口一致性。
+12. 增加键盘、焦点、动态播报、关系图等价列表和窄屏契约。
+13. 多意图增加采用率、确认放弃率和主动拆单率止损门。
+14. 索引报告状态与 adapter readiness 分字段，消除 `pending/degraded` 歧义。
+
+## 待用户审核决策
+
+两项均已在 2026-09-20 grill 中决定，详见 [阶段回溯与影响闭环设计](../../system-design/2026-09-20-stage-backtrack-and-impact-loop-design.md)。下面保留原建议，避免事后看不出改了什么。
+
+### 1. 关系候选治理职责
+
+**已决定：不新增 `trace_reviewer`。** `model_candidate` 由下游文档编制人确认或否决；没有编制人时由项目创建者裁决。决议进入 `project_trace_edge_decisions`。
+
+原建议：方案推荐项目本地 `trace_reviewer` 动作能力，绑定既有编制/审核职责，由项目创建者在项目成员内指派；跨文档候选由两端各一名符合条件者确认，全局管理员不自动取得项目或文档权限。未批准前相关端点保持关闭。
+
+### 2. 派生追踪数据留存
+
+**已决定：追踪五表、再打开申请和待复核标记的留存类别为 `record`。** 随项目保留。允许审计过的修复重放，禁止当缓存删除后重建。源文档依法清除时条目 tombstone，边和决议保留。这不签对话数据 D7 ADR，也不授权物理删除。
+
+原问题：T2 开始前，需要确定条目修订、模型候选、确认/拒绝决定的留存类别，以及源文档删除或依法清除时如何传播。D7 未签前不执行物理删除，也不允许用“不可变历史”绕过后续合规决定。
+
+## 审阅结论
+
+方案已具备实施拆分、数据模型、授权边界、状态机、灰度、回退和验收合同。上述两项已决定，不再阻塞 T2/T3 的治理前置。T2/T3 仍须按各自 short-term 认领后实施。对话 D7 的合规签字仍然 pending，与本决定正交。

.doc/ops/research/2026-09-20-capability-enablement-impact-research.md

@@ -0,0 +1,165 @@
+---
+title: "功能启用现状与项目文档修改影响分析调研"
+created: 2026-09-20
+status: done
+confidence: high_for_source_and_runtime_configuration
+---
+
+# 功能启用现状与项目文档修改影响分析调研
+
+## 1. 结论
+
+用户观察基本成立，但“已实现未启用”包含三种不同情况：已有可运行能力被关闭、只有组件或测试链路而未接入生产入口、只有设置或适配器占位。不能统一通过打开开关解决。
+
+建议先补真实执行链路、摘要持久化和工具权限约束，再分阶段启用。文档影响分析应建立**项目级、版本化的需求与关联索引**，工作流作为其中的归属和筛选维度。复用现有文档账本、变更报告和可靠事件，以增量抽取和关联查询代替每次全项目全文处理。
+
+本轮交付调研与[整改方案](../../remediation/2026-09-20-capability-enablement-impact-plan.md)。未修改业务代码、未启用开关、未重启容器、未操作真实会话。下文的源码风险是静态发现，不冒充已复现的事故；历史测试不冒充本轮验收。
+
+## 2. 调研范围与证据等级
+
+- 基线：本地 `dev@8fdcd98`；开始时工作区干净，`git pull --ff-only` 返回 Already up to date。调研分支 `feature/capability-enablement-impact-plan`。
+- 核查：`internal/intent`、`internal/app/intentflow`、`chat`、`ctxmgr`、`docrevision`、`projectworkflow`、`projectcontext`、`sysadmin`、PI Runner、相关前端、三环境 Compose、Goose 迁移。
+- 实时只读证据：三环境 app 容器白名单环境变量、image ID、`/health`、`/ready`；各环境 PostgreSQL `BEGIN READ ONLY` 元数据和聚合计数。未输出密码、业务正文或用户数据。
+- 历史证据：W2/W3/W4 测试报告、Wave5 封存决策、FEATURE-MATRIX。它们说明当时测了什么，不能证明当前聊天入口已打通。
+- 外部研究：NASA 需求追踪方法、PostgreSQL 16 递归查询文档，仅用于设计依据，不代表本项目满足任何外部合规认证。
+- 本轮没有运行 Go/前端测试或真实 PI/浏览器验收；没有证明运行镜像与源码逐字一致。运行开关是容器实际配置，接线结论基于当前检出源码。
+
+## 3. 运行环境核查
+
+2026-09-20 本轮读取结果：
+
+| 项 | dev | test | main |
+|---|---|---|---|
+| health / ready | ok / ok | ok / ok | ok / ok |
+| schema | 53 | 53 | 52 |
+| AGENT_BACKEND | pi-agent | pi-agent | pi-agent |
+| MULTI_INTENT_ENABLED | true | true | true |
+| MULTI_INTENT_PLAN_TIER | legacy | legacy | legacy |
+| U9 / U10 / U11 / U12 | 全 false | 全 false | 全 false |
+| INTENT_V2_SHADOW / DECISION / TIER | false / false / none | 同左 | 同左 |
+| SEMANTIC_SUMMARY_SHADOW | false | false | false |
+| SEMANTIC_SUMMARY_REPLACE | 未注入；源码默认 false | 同左 | 同左 |
+| PI_CHANGE_REPORT_NARRATIVE | false | false | false |
+| FAV_PUBLISHER_ENABLED / DEGRADED_READ | false / false | false / false | false / false |
+| document_lineage 行数 | 10 | 0 | 10 |
+| document_change_reports 行数 | 487 | 0 | 0 |
+| intent_plans 行数 | 2 | 0 | 0 |
+| public.chat_summaries | 不存在 | 不存在 | 不存在 |
+| public.chat_daily_digests | 存在 | 存在 | 存在 |
+
+行数包含既有测试/种子可能性，不能据此推断活跃用户、覆盖率或业务采用率。
+
+本轮 app image ID：dev `sha256:de2c8802eb544cddef157d23d8731cd66b04b85bc6b120a070e08b9b234428df`；test `sha256:f7ad7d2427bbca4d0f6fb3bc9128aa86de546e7d7e3f4f7ebedbbe072776d66d`；main `sha256:0ffe0550461c2b75c783292994d75e71083f7c20c7e4a9a52ad9e5959580c2eb`。这是本机镜像标识，不是远端 registry 发布凭据。
+
+数据库核查先尝试 count(chat_summaries) 得到 relation does not exist；随后以 `to_regclass('public.chat_summaries')` 在三库重新确认。`internal/bizdev/service.go:115` 用业务 pool 构建 ContextManager；仓库 SQL 搜索也未找到该表的建表迁移。`/ready` 正常不能证明这项摘要持久化可用。
+
+## 4. 功能分类与启用判断
+
+| 能力 | 当前实际完成边界 | 判断与建议 |
+|---|---|---|
+| 基础多意图识别 | `intent/flags.go:35` 默认开；旧协调器执行有限只读组合 | 已启用，不应标为“全部关闭” |
+| 新多意图持久计划 | 表、策略、卡片、决定接口存在；生产查询 owner 是 Fake，确认后未发现 worker 调度 | 必须先整改，不能直接升 auto_read/confirm |
+| U9 LLM 分段 | PI proposer 组件已注入；生产未调用 ActiveSegmentProposer | 需接真实聊天链路，不是单纯 flag 问题 |
+| U10 变更 / U11 治理 / U12 运行控制 | flag 开后注册 DryRunAdapter | 真实动作仍需实现；full 不是全功能开关 |
+| 意图 V2 决策 | 有独立灰度 flags，运行环境均 off | 与多意图计划分开验收，避免同时切两套路由无法归因 |
+| 语义摘要 shadow | 有 PI 实现，成功后仍服务确定性摘要 | 可作为第一阶段观测能力，但先补工具限制、持久化和异步隔离 |
+| 语义摘要 REPLACE | 明确封存未接线；true 也不替换 | 新实施项；需完整滚动、授权、质量、失效和回退设计 |
+| PI 变更报告叙事 | 有开关/Fetcher/摘要合并；输入仅统计数 | 接线存在但表达能力不足，先补具体差异与证据 |
+| 文档修改影响 | 账本、报告、面板、lineage 已有 | 依赖覆盖窄；应扩展项目追踪索引 |
+| 系统设置六项 | 可写白名单，但无业务消费方 | 管理台须显示“尚未生效”，逐项接线后开放 |
+| 编制人兼任 | 有独立策略消费方 | 不随本次智能功能一并全局开启；保留项目逐文档配置和冻结职责 |
+| FAV | 当前仅有限 shadow/骨架，生产消费者未放量 | 不纳入首批；维持独立观察窗和关闭降级读 |
+| 软件项目自举受控执行 | 部分数据库表/allowlist/执行器仍 deferred | 不因“已有表”认定可用，独立完善 |
+| D7 删除/留存治理 | 历史资料仍待合规决策 | 不与智能功能启用混合实施 |
+
+### 4.1 多意图的具体缺口
+
+1. `internal/app/app.go:247-249` 将 `QueryGuard{Inner: NewFakeActionOwner()}` 注入生产。`intentflow/owner.go` 的 Fake 返回 receipt，不查询真实业务。
+2. `internal/server/intent_plan_handlers.go:68-82` 决定接口调用 DecidePlan 后返回。非测试 AdvanceEligible 调用只发现 `intentflow/turn.go:98` 自动只读路径；缺少确认后的可靠执行调度。
+3. `internal/chat/session.go:397-406` 对新计划只清除旧 IntentPlan，忽略 planErr；后面仍走 Coordinator.Process。存在双路径处理及确认前副作用风险，须用真实聊天负例验证；本轮未制造真实副作用证明该风险。
+4. `internal/app/plan_owner.go:97-122` 的 live starter 将 task.run 固定到 intake；`turn.go:55-61` 只持久化 key/digest/summary，没有完整类型化参数和目标版本，不能可靠表达“修改 A 后生成 B”。
+5. U9 注入位在 `app.go:141`，生产 HandleTurn 仍直接使用规则 Recognize；`ActiveSegmentProposer` 调用只见测试。
+6. `intentflow/expansion.go:301-313` 为 U10–U12 注册 dry-run；返回 `dryrun:`/`validated_only:`。新领域写不是“开后就可执行”。
+7. 三个 Compose 已声明 PLAN_TIER。旧文档中“没有传进容器”的结论已过时，本轮不沿用。
+
+### 4.2 语义摘要不仅缺一个开关
+
+- `ctxmgr/summary_flags.go:10-20`、`semantic_summary.go` 明确 REPLACE 未接线；现有测试故意令 Replace=true 并验证叙事不变。
+- `ctxmgr/summarizer.go:64-115` 读写 chat_summaries；数据库缺表时写错误被忽略、返回成功并存内存。因此重启持久化是前置整改，不能用内存测试当通过。
+- Source、Shadow、FreshnessNote 不在现有保存 SQL 中，即使补表也需设计完整 provenance 持久化。
+- `MinimizeAuthorizedMessages` 仅取最后 40 条、每条约 240 字符；shadow 输入没有旧摘要。直接把它赋给 Narrative 会丢更早的上下文；不能宣称覆盖全部 CoveredCount。
+- `chat/session.go:177-212` 同步计算滚动摘要，并将当前 early 全量与旧摘要再合并；缺稳定消息水位去重契约，有覆盖计数/重复压缩风险。
+- `app/chatflow/chatlog.go:324` 存在授权包装，但 Session 直接调用 ContextManager。旧摘要复用仅按 session_id；撤权、阶段可见范围变化后是否仍安全，必须补真实链路复核与可见集绑定。
+- shadow 与服务请求同步执行，PI 默认 timeout 3 分钟（`app/semantic_summarizer.go:18`），Session 外层约 30 秒。开启可能增加等待；应移至可观察的后台任务并立即提供确定性结果。
+- `PiSemanticSummarizer` 只检查输出非空，未验证返回 digest、证据引用和长度等完整质量契约。
+
+### 4.3 “no-tool”目前不是运行时强约束
+
+`app/semantic_summarizer.go:64-69` 与 `app/pi_narrative.go:60-67` 通过 Instructions 声明 zero tool，但 `deploy/pi-agent/runner.mjs:151-154` 固定使用 `read,write,edit,tavily_search,web_search` 和 approve。本轮没有验证攻击利用；源码足以证明提示词声明不等价于禁用工具。
+
+建议增加专用纯推理请求 profile：材料直接作为输入，结构化结果通过协议返回，由服务端保存；Runner 不加载搜索扩展、不提供文件/网络工具。若底层 CLI 不支持该 profile，能力应显示 unavailable 并回退，而不是继续标记 no-tool。摘要、叙事和 U9 一并覆盖。
+
+### 4.4 管理台的显示不能当作功能已生效
+
+`internal/sysadmin/features.go` 返回 value/source/requiresRestart，没有 adapter readiness 或 rollout 覆盖信息。`settings.go:68-87` 明示六项无消费方：维护公告、只读模式、默认会话职责、任务默认自动修复、KB 默认返回数、阶段推进提醒。
+
+因此需要拆分“配置值”“实际生效值”“实现成熟度”“失败/阻断原因”。尤其只读模式必须服务端阻断写操作，不能只让前端按钮变灰；默认会话职责不能升级授权。维护公告等低风险项可单独接线，不能把六项保存成功当作六项功能完成。
+
+## 5. 修改影响分析已有什么、缺什么
+
+| 现有资产 | 证据 | 复用方式与限制 |
+|---|---|---|
+| 快照、版本、块映射、事件、报告 | `docrevision/types.go:96-168`；迁移 00028 | 唯一文档事实来源；索引不另存可独立修改的正文 |
+| 变更报告面板 | `web/src/components/doc/ChangeReportPanel.tsx:94-165` | 已有摘要/影响/推荐动作；增加覆盖状态、文档名、证据定位、聊天卡复用 |
+| 下游 lineage | `bizdev/service.go:1169-1193` | 主要为 test_manager 引用 system_reqs；下游 version 写死 1，不能扩面沿用 |
+| ImpactResolver | `bizdev/service.go:132-156` | 一跳查下游；查询错误和无关联都返回 nil，必须区分未知与无影响 |
+| 风险规则 | `docrevision/impact.go:18`、`risk.go:49-54` | 任意 lineage 均变 stale_candidate 并升 critical；扩大关系前先分清存在依赖和实际受影响 |
+| 可靠事件 | `app/docflow/commands.go:285-312` | 复用提交后事件、投影和重放；不新增第二套消息基础设施 |
+| 需求/用例 JSON | `squad/quality_gate_v2.go:34-101` | 已校验 requirements.json/test_cases.json；是工作区产物，不是需求实体数据库 |
+| 上下文快照 | `projectcontext/service.go:167-184,216-242` | 来源用 DocKey、版本用 Stage，且 approved 文档全选；需改为真实快照/版本/片段 |
+| 材料装配 | `projectcontext/service.go:126-145` | 截到 12 项、正文约 4000 字节；减少输入但不能证明召回完整 |
+| 块业务键 | `docrevision/blockmap.go:13` | 仅覆盖 REQ-*；需要兼容 UR/RS 等并维护稳定身份 |
+
+另发现 lineage GET 的权限缺口：`server/project_handlers.go:280-322` 只校验 URL 项目，然后接受任意 query doc_id 查询；应核验文档属于项目、逐文档可见性、关联端点可见性。当前为静态确定的缺少检查，未对真实项目做越权请求。
+
+PI 叙事并不能补这些关系：`app/pi_narrative.go:40-48` 只传 SHA、风险与 hunk/impact 数量，没有具体 Hunks/Impacts。已有 `BuildNarrativePromptInput` 可以提供差异，但未发现生产调用。仅开启 flag 更可能得到“修改了若干处、存在若干影响”这种泛化说明。
+
+还需统一报告可信边界：新 narrative 路径以服务端 impacts 为准；旧 `ValidateChangeReportJSON` 仍通过 mergeImpacts 合并模型提供的关联。新增设计应将模型推测单独列为候选，经文档定位、权限与证据校验后才进入确定关联。
+
+## 6. 是否建立需求清单等表
+
+**需要建立；建议项目级统一条目索引，而不是每个工作流各建一套孤立需求表。** 同一需求可以贯穿需求、设计、风险、验证多个工作流；逐工作流复制会产生重复编号、版本不一致和跨工作流断链。
+
+建议首期三类核心表：稳定条目身份、不可变条目修订、版本化关系；再保存索引构建状态。需求清单、风险清单、接口清单、测试覆盖表是同一索引的不同视图。已有 document_lineage 保留“实际消费了哪个文档版本”的事实，条目关系解释“为什么影响哪一处”。
+
+| 路线 | 优点 | 局限 | 建议 |
+|---|---|---|---|
+| 每次全文处理 | 无建模启动成本 | 输入随项目增长、重复成本高、结果不稳定 | 仅初始化/明确修复，不作常规路径 |
+| 仅摘要/向量检索 | 查找相似内容方便 | 相似不等于依赖，不能可靠证明未受影响 | 用于补充候选 |
+| 仅文档级 lineage | 可快速覆盖实际引用 | 无条目粒度，易误报全篇影响 | 第一阶段复用并修版本 |
+| PostgreSQL 条目+关系+片段 | 版本、事务、双向查询与审计可落在现有栈 | 需持续维护抽取/关系质量 | 推荐主路线 |
+| 独立图数据库/完整 GraphRAG | 可支持更复杂关系探索 | 新基础设施、一致性/授权/运维成本 | 当前无规模证据，不先引入 |
+
+NASA 需求管理资料强调双向追踪及需求变更影响管理，可作为需求—设计—验证关联建模的参考。[NASA Requirements Management](https://www.nasa.gov/reference/6-2-requirements-management/)
+
+PostgreSQL 16 支持递归 CTE 和循环检测，现有数据库可承担首期受限关系遍历。这支持“先用现有 PG”的设计选择，但不能替代本项目性能基准。[PostgreSQL 16 WITH Queries](https://www.postgresql.org/docs/16/queries-with.html)
+
+## 7. 预期用户体验
+
+示例仅说明设计，不是本轮真实项目结果：用户把某需求的响应时间从 2 秒改为 1 秒，提交成功后，助手返回：
+
+> 已修改《系统需求》REQ-017 的响应时间：2 秒 → 1 秒。直接相关的《性能设计》§3.2 和测试用例 TC-017 需要复核；《验收方案》通过测试追踪关系可能受影响。建议先确认实现预算，再更新测试阈值，最后复核验收标准。当前索引覆盖已提交版本，另有一个关联尚待核实。
+
+每条结论可点开证据、旧/新版本和相关片段。明确区分“确定影响”“可能影响”“尚未覆盖”。不因一句影响说明自动修改其他文档；用户选择建议后，仍走目标文档权限、租约、版本校验和审批。
+
+消息、文档面板和项目清单共用一个 report_id。刷新、重开、重启后仍可查阅，并显示后续处理进度。候选尚未提交时只能说“拟修改的预估影响”，不能说已经修改完成。
+
+## 8. 推荐推进顺序与研究局限
+
+1. 修复阻断：真实多意图 owner/确认调度/路由隔离、摘要表和持久化、纯推理工具隔离、lineage 权限和错误状态。
+2. 快速形成用户价值：所有提交路径都产生基础影响报告，聊天主动展示；补完整差异输入后灰度启用 PI 叙事。
+3. 项目需求索引：先覆盖结构化需求和用例，再扩展文档章节、风险和接口；精确关系先行，模型候选后置。
+4. 多意图按 shadow → auto_read → confirm 扩面；U9/领域动作逐个接线、验收。
+5. 语义摘要按 shadow → 质量评估 → 项目级替换推进，保留硬事实和确定性回退。
+
+尚未实测：运行镜像内上述源码接线、真实浏览器旗标开启后的端到端行为、PI工具调用实际执行情况、索引规模/性能、需求关系准确率。报告中的源码缺口已足以阻止盲目放量；验收方案负责关闭这些未验证项。详见[实施方案](../../remediation/2026-09-20-capability-enablement-impact-plan.md)。

.doc/ops/research/2026-09-21-agent-lock-coordination-research.md

@@ -0,0 +1,56 @@
+---
+title: "Agent .locks 与共享文档锁机制核查"
+created: 2026-09-21
+status: done
+confidence: high
+---
+
+# Agent .locks 与共享文档锁机制核查
+
+## 结论
+
+项目级 `.locks` 适合作为所有 worktree 的统一协调位置，但目录或锁文件存在本身不禁止写入。应把原子锁管理、Agent 会话、统一写入口、版本检查和故障恢复一起设计；CURRENT/FEATURE-MATRIX 尤其需要防止旧副本覆盖，而不只是防止同时写。
+
+## 当前现场（2026-09-21 采样）
+
+- 主目录已回到干净 `dev@99905571454281f7d14223443a51da5235d0e655`。原治理提交后的“主目录被旧任务占用”已不是当前事实。
+- `.locks` 不存在；`.git/agent-control/` 存在，包含 `dev-integration.lock`、手工 `active-operation.json` 和历史治理收据。
+- 采样时 active-operation 为 Cursor / upload-parse-ux / merging，但没有 pid、operation ID、base_dev_sha 等统一身份字段。`lslocks` 查询未观察到对应文件锁；这是瞬时观察，不能断言已失锁或安全抢占。
+- 主仓和 linked worktree 的 CURRENT 是不同 Git 快照。dev 中旧治理 adoption 仍为 in_progress；旧任务分支有尚未合入收口，说明任务结束与文档可见状态可能不同步。
+- 主机工作目录为 ext4，`flock` 来自 util-linux 2.42.3。该方案按单机本地文件系统设计，不默认支持网络文件系统或跨机器协调。
+- 本轮仅从明确 dev 创建新的研究 worktree，未获取、释放、迁移或写入既有运行锁，未修改服务或产品数据。
+
+## 源码与规则证据
+
+| 位置 | 发现 | 方案影响 |
+|---|---|---|
+| `AGENTS.md` §6；`.doc/ops/2026-09-21-agent-worktree-workflow.md` §3 | 目前是本机 flock 与人工校验，明确自动协调尚未实现 | 新设计作为补充，不宣称当前已具备原子认领或强制拦截 |
+| `.doc/remediation/2026-09-21-agent-workflow-governance-plan.md` §5 | 已提出共同 Git 目录内注册表与队列，但接口、过期持有者和共享文档写入协议未展开 | 本轮细化，同时提议统一到 `.locks`，旧方案路径暂不自动替换 |
+| `scripts/agent-worktree.sh:5–7,50,67–69` | 从自身目录推主仓、创建未给 dev 起点、删除强制 | 新工具必须使用仓库身份及登记路径；不能把旧 helper 当作锁代理 |
+| `scripts/env-service.sh` | 无锁令牌、实例身份、操作代次校验 | 只在 AGENTS 写要求不能强制阻止运行操作 |
+| `scripts/herdr-agent-start.sh:97–113`、dispatch 66–77 | 主要检查 feature/fix 分支及 cwd，不具有跨工具持久会话租约 | 增加通用 CLI/会话包装，再适配客户端；不将 Herdr 作为唯一入口 |
+| `.gitignore:20–36`、`.dockerignore:1–20` | 未排除整个 `.locks/`；部分 DB 后缀 ignore 不覆盖 JSON/锁/socket | 新增目录时须整体排除 Git、镜像上下文与任务清理，不依赖零散后缀规则 |
+| `go.mod` 与 `go.sum` | go.sum 有历史 modernc/sqlite 条目，但 go.mod 没有当前 SQLite require | 若采用 Go+SQLite，需显式评估并加入驱动，不能把旧校验和视为已接入能力 |
+| CURRENT 与 FEATURE-MATRIX | 人工 Markdown 表格、行无稳定机器 ID、多个历史状态叙述 | 先给需要自动更新的记录稳定 ID，按行/字段补丁操作；禁止覆盖全表 |
+
+## 官方机制核验与推论
+
+- [flock(2)](https://man7.org/linux/man-pages/man2/flock.2.html)：本地 advisory lock 与打开的文件描述关联。由此推论：不同工具调用中只跑一次获取命令，命令退出后不能假定锁仍在；客户端忽略 flock 仍可写入。
+- [flock(1)](https://man7.org/linux/man-pages/man1/flock.1.html)：支持用一个持锁进程包裹命令。适合明确生命周期的短操作和部署执行器，不代替多轮 Agent 会话管理。
+- [unlink(2)](https://man7.org/linux/man-pages/man2/unlink.2.html)：删除路径不立即消灭仍被进程打开的文件。结合 flock 推论：删旧锁再建同名文件可能形成不同 inode 的两个协调域，不能用 rm 当解锁。
+- [Git worktree](https://git-scm.com/docs/git-worktree)：linked worktree 具有独立工作树，共享部分 Git 状态；锁根必须由 common-dir 与登记主目录定位，不能使用各自 cwd/.locks。
+- [Git hooks](https://git-scm.com/docs/githooks)：hooks 是 Git 生命周期入口。由此推论：提交门禁不等于普通编辑器写入拦截，也不自动覆盖所有 Git 更新命令。
+- [SQLite transaction](https://www.sqlite.org/lang_transaction.html)：同一时刻只有一个写事务；短事务可原子完成多资源冲突检查与租约登记。不能把多小时开发装入数据库事务。
+- [SQLite WAL](https://www.sqlite.org/wal.html)：允许读写并行，但要求同机，不能推广为网络共享锁。WAL/备份、checkpoint 与版本兼容需要验收。
+- [rename(2)](https://man7.org/linux/man-pages/man2/rename.2.html)：单次重命名的原子性不等于 CURRENT、FEATURE-MATRIX、SQLite 与 Git 的跨介质事务；需要操作记录、恢复及 Git 提交作为发布边界。
+- [Landlock](https://man7.org/linux/man-pages/man7/landlock.7.html)：Linux 可对进程施加文件系统访问约束。属于系统级约束的候选机制，未验证本机/各客户端兼容性，不宣称已经可用。
+
+## 用户已确认的强度
+
+先统一操作入口与提交门禁防误改，后续再加权限隔离。方案采用 L1a–L1d 为当前交付设计，明确不提前承诺 OS 级阻止任意写入。
+
+## 研究限制
+
+没有实现或运行锁原型/并发测试，没有安装沙箱、改变文件权限、清理锁、读取 `.env` 内容或更改已采纳工作规范。性能目标和故障演练均为后续验收要求，不是实测结果。
+
+[完整补充方案](../../remediation/2026-09-21-agent-lock-coordination-plan.md)

.doc/ops/research/2026-09-21-agent-workflow-governance-research.md

@@ -0,0 +1,61 @@
+---
+title: "Agent worktree 与并行协作机制核查"
+created: 2026-09-21
+status: done
+confidence: high
+---
+
+# Agent worktree 与并行协作机制核查
+
+## 结论
+
+用户提出的主目录保护、全部开发使用 worktree、从 dev 开任务分支、验证后合入并更新服务、安全清理的方向成立。当前仓库具备规范雏形，但机器执行尚未形成闭环；仅修改 AGENTS 文案无法保证并行可靠性。建议采用任务 worktree + 机器协调状态 + 串行集成队列，分阶段增加执行隔离。
+
+本次核查为只读研究及文档编写，未执行产品测试、迁移或服务重建。下列发现是代码与现场证据，风险推断不等于已发生事故。
+
+## 采样边界
+
+- 2026-09-21 初始主目录：`fix/intent-workflow-scoping-2026-09-21@5c6b4f77`；`internal/server/stage_access_helpers.go` 已修改，`internal/projectinstance/workflow_scope.go` 未跟踪，均属其他任务。
+- 本地 dev：`15b8a4a8`；研究 worktree 显式以此创建。上述治理脚本与主目录版本 diff 为空。
+- `git rev-list --left-right --count origin/dev...dev` 为 `0 309`。未 fetch，仅说明当时本地跟踪引用状态，不能宣称实时远端落后 309。
+- `git worktree list --porcelain` 初始列出主目录及 4 个 linked worktree：其中 3 个在 `.worktrees/`，1 个在 `.kilo/worktrees/` 且 detached；新增本次研究 worktree 后为 5 个 linked worktree。
+- 本机 Git 2.53.0；`core.hooksPath` 未配置，`.git/hooks` 未检出非 sample 文件。
+- CURRENT 中仍保留较早的“extra worktree 仅余……”叙述，不能用作当前 worktree 清单。
+
+## 发现与依据
+
+| 编号 | 当前证据 | 影响 / 推断 |
+|---|---|---|
+| F01 | `AGENTS.md` §6.2 允许单 Agent 在主目录创建 feature 分支；CURRENT 多条 worktree=`-` | 用户提出的是对现行规范的实质收紧，必须统一修改入口与执行规则 |
+| F02 | `scripts/agent-worktree.sh:50` 未给 start-point；Git worktree add 默认以 HEAD 为起点 | 从主目录任务分支创建新任务可能夹带其他任务提交，不能保证“来自 dev” |
+| F03 | 同脚本 5–7 行从脚本目录推导 ROOT | 在 linked worktree 调用自身脚本会推导嵌套 `.worktrees`，不能定位唯一主仓 |
+| F04 | 同脚本 34–35 行仅把 `/` 替换为 `-` | `feature/a-b` 与 `feature/a/b` 映射冲突；缺少任务 ID、严格命名及路径校验 |
+| F05 | 同脚本 67–69 行默认 `remove --force`，可选 `branch -D` 且吞错 | 删除前未验证是否合入 dev、是否有未保存文件、是否仍有 Agent 使用；可能损失工作 |
+| F06 | `scripts/env-service.sh:18–20,76–151` 从自身位置定位 Compose；无 worktree、分支、租约校验 | 文档禁止 worktree 动共享服务，但脚本未强制；`logs` 也会经过配置/目录初始化，非纯只读 |
+| F07 | `docker-compose.dev.yml:8,13,38,74,147,174–184` 固定 project/container/network/volume 名 | 不同目录运行同份 Compose 不能获得独立环境；单改 project name 仍不足以隔离显式名称和宿主端口 |
+| F08 | `docker-compose.dev.yml:53–58` 挂载主目录 PI 源码和数据；docker inspect 确认挂载实际存在 | 主目录变更可影响以后加载/重启时的 Runner 行为；`:ro` 只约束容器写入，不冻结宿主文件内容 |
+| F09 | `.doc/ops/CURRENT.md` 是普通版本化 Markdown，无原子认领；各 worktree 内容不同 | 两个 Agent 可同时看到 idle；分支内认领不会实时传到另一 worktree；不能用作真正互斥锁 |
+| F10 | `AGENTS.md` §6.3 要求长 E2E 可先 smoke 释放槽位 | 如 E2E 仍使用可变共享 dev，后续部署会使证据混合；必须保留环境租约或转入隔离环境 |
+| F11 | `scripts/herdr-agent-start.sh:97–109`、dispatch 66–77 行校验仓库文件和 feature/fix 分支，未检验 linked worktree 身份 | 主目录 feature 分支同样可通过；同一逻辑实例名及同 cwd 路由需要适配并行任务身份 |
+| F12 | `.dockerignore:1–20` 未排除 `.worktrees` / `.kilo`；`deploy/app/Dockerfile:19` 为 `COPY . .` | 多 worktree 可能进入构建上下文和构建阶段，增加大小和无关缓存失效；未测传输量，不断言全部最终进入运行镜像 |
+| F13 | `scripts/candidate-images-build.sh:29,48,53` 用指定 COMMIT 标记，但 docker build 使用当前目录 | 任意 `--commit` 并不保证构建该提交；未来集成凭证必须绑定真实干净树，不能直接相信标签 |
+| F14 | `internal/server/handlers.go:28–40,89–155` 提供 ready/schema，Version 固定为 v1.0 | `/ready` 可以检查就绪，但不能单独证明当前运行精确提交；需镜像标识、挂载和配置摘要关联 |
+| F15 | `.github/workflows/ci.yml` 已有 Go/迁移/PG/前端/架构门禁；nightly 与 promotion receipt 也已存在 | 应复用已存在的检查与凭证，补本地准入和集成关联，不另起一套相互矛盾标准 |
+
+## 运行态核查
+
+- dev app/events/PI/PG 均显示 healthy；本轮只查询状态，没有变更容器。
+- `GET :8080/ready`：`status=ok`、`env=dev`、`agent_backend=pi-agent`、schema=60，database/schema/task_store ready。
+- app 挂载主目录 `data/dev`、`.regulations`；PI 挂载主目录 `data/dev/workspaces`、`agent_sessions` 和四组源码路径。
+- app/events 镜像 ID 不同；本轮未调查构建历史，不能仅据此认定异常。这说明未来需要逐组件记录运行身份。
+- 未读取 `.env` 内容、用户会话正文或生产数据；未验证远端分支保护与 CI 当前执行结果。
+
+## 官方机制核验
+
+1. [Git worktree](https://git-scm.com/docs/git-worktree)：linked worktree 有独立 HEAD/index，但共享仓库资源；创建必须显式选择起点。`worktree lock` 用于防移动、删除和修剪，不是开发互斥锁。
+2. [Git hooks](https://git-scm.com/docs/githooks)：hooks 作用于 Git 生命周期，不能拦截编辑器普通写文件。客户端 hook 是防误操作层，不能当作 OS 权限隔离。
+3. [Docker Compose project name](https://docs.docker.com/compose/how-tos/project-name/)：project name 有多级优先级；结合本仓显式容器/卷/网络/端口配置，判断不能只换目录或加 `-p` 就宣称完全隔离。
+
+## 建议
+
+详见 [治理方案](../../remediation/2026-09-21-agent-workflow-governance-plan.md)。最先修正创建起点与强制删除，再落机器协调/服务守卫，最后试点候选集成和可靠部署。旧 worktree 按所有者和证据逐个处理，禁止一键清空。

.doc/ops/short-term/2026-09-16-fav-u7-incremental.md

@@ -1,11 +1,11 @@
 ---
 title: "FAV U7 增量合入（非整支 merge）"
-status: planned
+status: done
 created: 2026-09-16
 updated: 2026-09-16
 owner: Cursor
 branch: feature/fav-u7-publisher
-worktree: "-"
+worktree: ".worktrees/feature-fav-u7-publisher"
 mutex: events
 ---
 
@@ -15,13 +15,40 @@ mutex: events
 
 从 `feature/final-artifact-vault` **手工移植**经审计切片到 `dev`；consumer 默认 off；禁止整支 merge；禁止默认开 `FAV_DEGRADED_READ`。
 
-## 步骤
+## 范围
 
-1. [ ] cherry-pick / 移植 cmd/artifact-vault + vault HTTP + publisher 订阅
-2. [ ] 隔离库负例 + 默认 off 冒烟
-3. [ ] 独立 go/no-go 报告
+- 配置门闩（`FAV_DEGRADED_READ` / `FAV_PUBLISHER_ENABLED` 默认 false）
+- HTTP `GET /api/v1/vault/status` + gated in-process publisher stub
+- `internal/app/fav` durable subscriber stub（不注册到 cmd/events）
+- `cmd/artifact-vault` status stub（完整 CLI 未移植）
 
 ## 非目标
 
 - 整支 merge `feature/final-artifact-vault`
-- 未审计启用 degraded read
+- 未审计启用 degraded read / fav live / publisher production Drain
+- 移植 enumerate / TerminalRow Backfill / OnFinalArtifact hooks
+- 合入 `dev`（本切片仅 feature 推送）
+
+## 步骤
+
+1. [x] 审计 FAV vs `dev` artifactvault 冲突（多数 DIFF → 改 stub）
+2. [x] 落地 stub + 默认 off 测试
+3. [x] go/no-go 报告
+4. [x] 推送 `feature/fav-u7-publisher`（不合 dev）
+
+## 验收标准
+
+- [x] fav consumer / Register 仍 fail-closed
+- [x] `FAV_DEGRADED_READ` 默认 false
+- [x] 测试报告含 NO-GO：subscriber 保持 OFF 直至单独审批
+- [x] 已 push 远端 feature 分支
+
+## 相关链接
+
+- Test report: [.doc/test-reports/2026-09-16-fav-u7-incremental-test-report.md](../../test-reports/2026-09-16-fav-u7-incremental-test-report.md)
+- Assets: [.doc/test-reports/assets/2026-09-16-fav-u7-incremental/](../../test-reports/assets/2026-09-16-fav-u7-incremental/)
+- Remote: `origin/feature/fav-u7-publisher`
+
+## 证据 / 备注
+
+因 `internal/artifactvault` 与 FAV 旁支大面积分叉，未 cherry-pick 核心库；采用最小可编译、默认关闭的 publisher/HTTP/CLI stub。commits: `3478a5a..de65cee`。

.doc/ops/short-term/2026-09-16-full-backlog-override.md

@@ -1,6 +1,6 @@
 ---
 title: "全量 backlog 覆盖 no-go 总控"
-status: in_progress
+status: done
 created: 2026-09-16
 updated: 2026-09-16
 owner: Cursor
@@ -22,19 +22,20 @@ mutex: architecture-docs
 ## 步骤
 
 1. [x] P0 SSOT 翻转
-2. [ ] P1 nightly DATA_DIR 对齐 + green receipt
-3. [ ] P2 IAM inventory + 410 + R13
-4. [ ] P3 Playwright intent-plan 双标签
-5. [ ] P4 PU6 + PU7
-6. [ ] P5 PU8 U9→U12
-7. [ ] P6 SWBOOT-00…09（10 stub）
-8. [ ] P7 FAV 增量
+2. [x] P1 nightly DATA_DIR 对齐 + green receipt（U8 PASS；FullNone 仍有 product_fail 待后续）
+3. [x] P2 IAM inventory + 410 + R13
+4. [x] P3 Playwright intent-plan 双标签（`RUN_UI_ACCEPTANCE=1` Docker Playwright PASS；A=200/B=409；见 [报告](../../test-reports/2026-09-16-intent-plan-playwright-dual-tab-test-report.md)）
+5. [x] P4 PU6 + PU7（agent 实现合入；flag 默认 off）
+6. [x] P5 PU8 U9→U12（独立 flag；legacy tier；agent 实现合入）
+7. [x] P6 SWBOOT-00…09（10 stub/设计冻结；agent 实现合入）
+8. [x] P7 FAV 增量（非整支 merge；publisher/consumer 默认 off）
 
 ## 验收标准
 
-- [ ] 各波 short-term / test-report 回链
-- [ ] FEATURE-MATRIX 对应行更新
-- [ ] CURRENT 焦点与认领同步
+- [x] 各波 short-term / test-report 回链
+- [x] FEATURE-MATRIX 对应行更新
+- [x] CURRENT 焦点与认领同步
+- [x] agent 富实现覆盖薄 stub：`chore/merge-agent-deltas` → `dev`
 
 ## 相关链接
 

.doc/ops/short-term/2026-09-16-intent-plan-playwright-dual-tab.md

@@ -0,0 +1,52 @@
+---
+title: "Playwright intent-plan 双标签验收"
+status: done
+created: 2026-09-16
+updated: 2026-09-16
+owner: Cursor-Auto
+branch: feature/intent-plan-cards-playwright
+worktree: ".worktrees/feature-intent-plan-cards-playwright"
+mutex: web
+---
+
+# Playwright intent-plan 双标签验收
+
+## 目标
+
+`RUN_UI_ACCEPTANCE=1` 真浏览器下，PLAN_CONFIRM 双标签 confirm 互斥；刷新/重登与 PG plan 一致；不升 `MULTI_INTENT_PLAN_TIER`。
+
+## 范围
+
+- `web/e2e/intent-plan-cards.spec.ts` 活验规格
+- App：`GET /intent-plans/active` 水合 PLAN_CONFIRM；confirm 使用唯一 decision nonce；空 docAST 登录兜底
+- InteractiveCard：`data-testid=plan-confirm-card` 等选择器
+- 测试报告归档
+
+## 非目标
+
+- 不升 `MULTI_INTENT_PLAN_TIER`
+- 不用 stub/SKIP 冒充 PASS
+
+## 步骤
+
+1. [x] 从 origin/dev 开 `feature/intent-plan-cards-playwright`（worktree）
+2. [x] 水合 + 唯一 nonce + e2e 规格
+3. [x] `RUN_UI_ACCEPTANCE=1` 真浏览器跑通并写报告
+4. [x] 提交并 `./scripts/git-push-dev.sh`
+
+## 验收标准
+
+- [x] 无 `RUN_UI_ACCEPTANCE` 时 Playwright skip
+- [x] `RUN_UI_ACCEPTANCE=1`：双标签仅一侧 HTTP 200，另一侧 409；败方 outdated
+- [x] 刷新/重登卡片状态与 PG / GET active 一致
+- [x] 报告进 `.doc/test-reports/`
+
+## 相关链接
+
+- Long-term: [../long-term/2026-09-16-intent-plan-playwright-dual-tab.md](../long-term/2026-09-16-intent-plan-playwright-dual-tab.md)
+- Test report: ../../test-reports/2026-09-16-intent-plan-playwright-dual-tab-test-report.md
+
+## 证据 / 备注
+
+- Live：`assets/2026-09-16-intent-plan-playwright-dual-tab/playwright-docker.txt`（1 passed 7.0s）
+- Network：`playwright-network.json`（A=200 / B=409 PLAN_STALE_REVISION；PG executing rev=2）

.doc/ops/short-term/2026-09-16-partial-deferred-completion.md

@@ -0,0 +1,57 @@
+---
+title: "partial/deferred 全量收口总控"
+status: in_progress
+created: 2026-09-16
+updated: 2026-09-22
+owner: Cline
+branch: docs/partial-deferred-completion-plan
+worktree: "-"
+mutex: architecture-docs
+---
+
+# partial/deferred 全量收口总控
+
+## 目标
+
+按 [收口计划](../../remediation/2026-09-16-partial-deferred-completion-plan.md) 把 FEATURE-MATRIX 6 行 `partial` + 1 行 `deferred` 推进到 `done`；全程保持模块独立解耦（端口 + 组合根 + PG 事件 + 契约门禁，不新增 RPC 层），变更影响面不跨模块扩散。
+
+## 授权
+
+用户 2026-09-16 要求已设计功能尽量推进 done，并确认通信机制与系统契约。  
+用户 2026-09-17 确认收口计划 §7 四项决策（D7 草案数字、confirm 可独立授权、REPLACE 默认不启用、FAV 顺序与观察窗）；见计划 §7.1–§7.4 与 [D7 ADR 草案](../../adr/2026-09-17-d7-chat-data-retention.md)。
+
+## 步骤
+
+1. [x] W1 CI/E2E 收口（mutex `ci`；secret/runner 配置 + FullNone product_fail + green nightly）
+2. [x] W2 PU6 语义摘要 D3（mutex `chat`；shadow + 真实 PI + R13 + 负例；**不要求** REPLACE）
+3. [x] W3 PU7 PI change-report 叙事（mutex `docgov`；开 flag + 真实 PI + fallback 负例 + UI 区分）
+4. [x] W4 PU8 U9–U12（mutex `intent-plan`；逐 action 独立 flag，U9→U12 顺序；升 confirm 另开独立授权，不升 full）
+5. [ ] W5 纯软件自举（mutex `workflow-design`；SWBOOT-10 非 stub + 真实 PI + UI 二次验收）
+   - **2026-09-22 剩余状态**：SWBOOT-10 仍为 fail-closed stub（FEATURE-MATRIX / CURRENT 受控约束明确保持）；无本机任务分支或 worktree。关闭条件未变，需单独授权实施，不得在状态对账中假完成。
+6. [ ] W6 FAV（mutex `events`；**shadow 已合** → live staging→artifact→publication 仍未开；每级观察窗 ≥7 天；`FAV_DEGRADED_READ=false`；禁止整支 merge）
+   - **2026-09-22 剩余状态**：仍禁止整支 merge `feature/final-artifact-vault`；live 未放量；观察窗证据驱动。状态对账不合入保护分支、不启动 live。
+7. [ ] W7 D7 数据治理（mutex `chat`；**盘点已合**；按 ADR 口径整改仍待合规签字；数字 `pending-compliance-signoff`；本轮未发现已确认违规、未写 gap-matrix）
+   - **2026-09-22 剩余状态**：ADR 仍待合规签字；禁止按草案数字物理删除。无本机未合入实现分支。
+8. [ ] 逐行升 done（保留 lineage）+ CURRENT / 契约状态同步
+   - **2026-09-22**：不因对账升 FEATURE-MATRIX 行；W5–W7 关闭条件仍未满足。
+9. [x] §7 四项开放问题决策落盘（2026-09-17）
+
+## 本机现场（2026-09-22 对账）
+
+- 主目录为 2026-09-21 23:49 全新 clone；CURRENT 09-21 登记的本任务 worktree `-` 仍成立（从未登记物理路径）。
+- 远端无本任务专属未合入实现分支；剩余工作是多日、需单独授权的实施/观察/合规，不是「未合入分支待 merge」。
+- 详见 [状态对账](./2026-09-22-status-reconcile.md)。
+
+## 验收标准
+
+- [ ] 各波独立 short-term / feature 分支 / test-report / 回滚点（占用对应 mutex）
+- [ ] 计划 DoD 全勾（见 remediation 计划 §8；§7 四项决策项已勾）
+- [ ] `production_ready` 与 B1–B4 门禁零回归
+
+## 相关链接
+
+- Plan: [../../remediation/2026-09-16-partial-deferred-completion-plan.md](../../remediation/2026-09-16-partial-deferred-completion-plan.md)
+- D7 ADR 草案: [../../adr/2026-09-17-d7-chat-data-retention.md](../../adr/2026-09-17-d7-chat-data-retention.md)
+- 矩阵: [../../status/FEATURE-MATRIX.md](../../status/FEATURE-MATRIX.md)
+- 上位: [2026-09-16-full-backlog-override.md](./2026-09-16-full-backlog-override.md)（P0–P7 已完成，本总控承接其收口阶段）
+- 对账: [2026-09-22-status-reconcile.md](./2026-09-22-status-reconcile.md)

.doc/ops/short-term/2026-09-16-pu7-pi-narrative.md

@@ -0,0 +1,48 @@
+---
+title: "PU7 PI change-report 叙事"
+status: done
+created: 2026-09-16
+updated: 2026-09-16
+owner: Cursor-Auto
+branch: feature/pu7-pi-narrative
+worktree: .worktrees/feature-pu7-pi-narrative
+mutex: docgov
+---
+
+# PU7 PI change-report 叙事
+
+## 目标
+
+`PI_CHANGE_REPORT_NARRATIVE` 默认 off；开启后只读消费 immutable diff+lineage 的 typed 叙事，失败全量 deterministic fallback。
+
+## 范围
+
+- `internal/docrevision/` flag + ResolveChangeReport
+- `deploy/pi-agent/change-report-narrative-v1.mjs`
+- `ChangeReportPanel` / changeReportView 区分事实 vs 叙事
+
+## 非目标
+
+- 默认开启 flag
+- 覆盖服务端 risk / approval
+- 合入 `dev`（本任务仅 feature 分支）
+
+## 步骤
+
+1. [x] flag 默认 off
+2. [x] typed narrative + input digest；失败全量 fallback
+3. [x] UI 区分 narrative / 事实字段
+4. [x] 单测 flag off + fallback
+5. [x] test-report + push feature 分支
+
+## 验收标准
+
+- [x] 默认 off 行为 = deterministic fallback
+- [x] 畸形/超时/digest 不匹配 → 无混合字段
+- [x] PI 声称低风险不影响服务端 risk floor
+- [x] 报告归档
+
+## 相关链接
+
+- Contract: [../long-term/2026-09-16-pu7-pi-narrative-contract.md](../long-term/2026-09-16-pu7-pi-narrative-contract.md)
+- Test report: [../../test-reports/2026-09-16-pu7-pi-narrative-test-report.md](../../test-reports/2026-09-16-pu7-pi-narrative-test-report.md)

.doc/ops/short-term/2026-09-16-software-project-bootstrap.md

@@ -1,6 +1,6 @@
 ---
 title: "纯软件项目自举 SWBOOT-00..09 实施"
-status: in_progress
+status: done
 created: 2026-09-16
 updated: 2026-09-16
 owner: Cursor-Auto
@@ -38,7 +38,7 @@ mutex: workflow-design
 4. [x] manifests + catalog allowlist
 5. [x] create-project wizard hooks + SWBOOT-10 stub
 6. [x] unit tests + test-report
-7. [ ] push feature 分支
+7. [x] push feature 分支 (`b5ce947`)
 
 ## 验收标准
 

.doc/ops/short-term/2026-09-17-initial-load-perf-u2.md

@@ -0,0 +1,53 @@
+---
+title: "首次加载 U2：字体自托管与静态资源交付"
+status: done
+created: 2026-09-17
+updated: 2026-09-17
+owner: Cursor
+branch: feature/initial-load-perf-u2
+worktree: "-"
+mutex: web + static-delivery
+---
+
+# 首次加载 U2：字体自托管与静态资源交付
+
+## 目标
+
+登录页不再依赖 Google Fonts 阻塞 CSS；8080/8081 静态资源支持 gzip/br 协商与分层缓存；缺失 `/assets`/`/fonts` 返回 404 而非 HTML。
+
+## 范围
+
+- 自托管 Inter / JetBrains Mono（latin + latin-ext 可变 WOFF2）
+- 构建期预压缩 `.br` / `.gz`
+- Go `serveSPA` 压缩协商、Cache-Control、Vary、assets 404
+- 单元测试与 rebuild 后 curl/浏览器验收
+
+## 非目标
+
+- U1 完整 Playwright 性能套件
+- U3 拆包懒加载 / katex 入口 CSS
+- U4–U6 初始化扇出、认证、SQL
+- U7 完整重启归因（本轮仅借 rebuild 采集起点证据）
+
+## 步骤
+
+1. [x] 诊断/方案文档落盘并合入 `dev`
+2. [x] 自托管字体 + 移除外链
+3. [x] 预压缩脚本接入 build
+4. [x] Go 静态交付修复
+5. [x] 测试与 rebuild 验收
+6. [x] 测试报告与文档同步
+
+## 验收标准
+
+- [x] 登录页无 `fonts.googleapis.com` / `fonts.gstatic.com` 请求
+- [x] 主 JS 响应带 `Content-Encoding: br` 或 `gzip`，体积显著下降
+- [x] `/assets/missing.js` → 404 且非 HTML
+- [x] HTML `Cache-Control: no-cache`；哈希资源 `immutable`
+- [x] SSE / API 缓存行为未回归
+
+## 相关链接
+
+- 方案: [../../remediation/2026-09-17-initial-load-performance-plan.md](../../remediation/2026-09-17-initial-load-performance-plan.md)
+- 审计: [../../audit/2026-09-17-initial-load-performance-audit.md](../../audit/2026-09-17-initial-load-performance-audit.md)
+- Test report: [../../test-reports/2026-09-17-initial-load-perf-u2-test-report.md](../../test-reports/2026-09-17-initial-load-perf-u2-test-report.md)

.doc/ops/short-term/2026-09-17-leftover-hygiene.md

@@ -0,0 +1,50 @@
+---
+title: "已合入 leftover 旁支与文档对齐"
+status: done
+created: 2026-09-17
+updated: 2026-09-17
+owner: Cursor
+branch: chore/leftover-hygiene-2026-09-17
+worktree: "-"
+mutex: ops
+---
+
+# 已合入 leftover 旁支与文档对齐
+
+## 目标
+
+拆掉 tip 已是本地 `dev` 祖先的 extra worktree 与本地旁支；把 CURRENT / SWBOOT long-term / PU 契约与 git 事实对齐。不整支合入冻结旁支。
+
+## 范围
+
+- 拆已合入 extra worktree（保留错名 FAV 目录）
+- `git branch -d` 已合入 leftover；SWBOOT 残留 1 commit 在确认文档已在 `dev` 后 `-D`
+- `fix/clean-test-env-baseline` 不 merge；标明前端清理已放弃
+- 对齐 CURRENT、SWBOOT long-term、PU6/PU8 契约
+
+## 非目标
+
+- 不整支 merge `feature/final-artifact-vault`
+- 不合入 `feature/remove-herdr-agent-settings`、`fix/project143-controlled-content-404-diagnosis`、`fix/dev-runtime-data-root-guard`、`dev-old-linear`
+- 不删 `origin/*`；不从 worktree 起 docker；不碰项目 143；不 push
+- 不升 FEATURE-MATRIX 能力行 `done`
+
+## 步骤
+
+1. [x] 从 `dev` 开 `chore/leftover-hygiene-2026-09-17` 并认领 CURRENT
+2. [x] 拆已合入 worktree、删除已合入旁支
+3. [x] 文档对齐
+4. [x] 冒烟 + test-report
+5. [x] 占槽合 `dev`
+
+## 验收标准
+
+- [x] extra worktree 只剩 FAV 错名目录
+- [x] 5 条冻结旁支仍在
+- [x] 文档不再声称 SWBOOT 未合 `dev`
+- [x] vet / short / arch-check / health+ready PASS
+
+## 相关链接
+
+- Test report: `.doc/test-reports/2026-09-17-leftover-hygiene-test-report.md`
+- 上位: [2026-09-16-partial-deferred-completion.md](./2026-09-16-partial-deferred-completion.md)

.doc/ops/short-term/2026-09-17-promote-dev-to-test.md

@@ -0,0 +1,51 @@
+---
+title: "晋升 dev → test（rc-v1.0.0-beta.3）"
+status: done
+created: 2026-09-17
+updated: 2026-09-17
+owner: Cursor
+branch: feature/promote-dev-to-test-2026-09-17
+worktree: "-"
+mutex: infra
+---
+
+# 晋升 dev → test（rc-v1.0.0-beta.3）
+
+## 目标
+
+在 `production_ready=yes` 前提下，把本地 `dev@46a0fb2`（含 leftover + W2–W7）合入 `test`，重建测试服务，供部署后实测。
+
+## 范围
+
+- `test` `--no-ff` 合入当前 `dev`
+- 候选 tag `rc-v1.0.0-beta.3`
+- `./scripts/env-service.sh test rebuild`（部署新代码，不 pin beta.2 旧镜像）
+- `:8081` health/ready；goose 00048 可迁移
+
+## 非目标
+
+- 不合入 `main`
+- 不启用 FAV live / `FAV_DEGRADED_READ`
+- 不升 `MULTI_INTENT_PLAN_TIER` / `SEMANTIC_SUMMARY_REPLACE`
+- 不翻转 `production_ready`
+- 不终止项目 143
+- 不按 D7 草案删除数据
+
+## 步骤
+
+1. [x] 确认 gap-matrix `production_ready=yes`；FAV/D7/SWBOOT 为 deferred_enhancement
+2. [x] 占集成槽；合入 `test` + tag
+3. [x] rebuild 测试服务
+4. [x] health/ready + schema 冒烟
+
+## 验收标准
+
+- [x] `:8081` health/ready PASS
+- [x] schema 到达 48（00048 additive）
+- [x] FAV 仍 off
+- [x] 默认 flag 仍 off
+
+## 相关链接
+
+- Test report: [../../test-reports/2026-09-17-promote-dev-to-test-test-report.md](../../test-reports/2026-09-17-promote-dev-to-test-test-report.md)
+- gap-matrix: [../../remediation/gap-matrix.md](../../remediation/gap-matrix.md)

.doc/ops/short-term/2026-09-17-system-admin-console.md

@@ -0,0 +1,58 @@
+---
+title: "系统管理台（System Admin Console）一期"
+status: done
+created: 2026-09-17
+updated: 2026-09-17
+owner: Kimi
+branch: feature/system-admin-console
+worktree: "-"
+mutex: web + sysadmin
+---
+
+# 系统管理台（System Admin Console）一期
+
+## 目标
+
+为管理员提供独立的系统级管理界面（全屏视图，`workbench | admin` 顶层切换），覆盖总览状态、知识库、功能与特性开关、角色权限、工作流、用户审批、文档治理；吸收下线 AdminSettingsModal；系统设置只读为主 + SettingSpec 白名单少量可写。
+
+## 范围
+
+- 后端：新包 `internal/sysadmin`（薄聚合层，ports/settings/overview）；迁移 `deploy/postgres/goose/00049`（`system_settings` 表）；路由 `/api/v1/admin/system/{overview,kb,features,settings}`；`internal/server/admin_system_handlers.go`；`internal/app/app.go` 装配。
+- 前端：`web/src/api/systemAdmin.ts` + `web/src/types/systemAdmin.ts`；`web/src/components/admin/console/AdminConsoleView.tsx` + `sections/`；`App.tsx` 顶层视图切换；LeftRail 入口语义改为进入管理台；吸收 `AdminSettingsModal` 六 tab 并删除旧模态。
+
+## 非目标
+
+- 不做全量 DB feature-flag 层（env 开关保留，标注「需重启」）。
+- 不改项目级设置（`projectinstance.ProjectSettings` 与项目设置模态保持原样）。
+- 不引入 react-router / 新前端依赖；不改 `tokens.css` 之外的全局样式。
+- 不做 KB 重建/索引管理等运维动作（一期只读）。
+
+## 步骤
+
+1. [x] 后端 sysadmin 包 + goose 00049（commit `f1404d5`）
+2. [x] 后端路由/handler/装配 + 单测（commit `f1404d5`）
+3. [x] 前端 API 模块与类型（commit `0eaca61`）
+4. [x] AdminConsoleView 骨架与 8 个分组 sections（commit `0eaca61`）
+5. [x] 吸收 AdminSettingsModal 并下线（commit `0eaca61`）
+6. [x] go vet / go test -short / web npm test + build（全绿）
+7. [x] 占集成槽位：dev rebuild + /health + admin overview 冒烟（merge commit `dc7c31e`；schema 48→49；PASS）
+
+## 验收标准
+
+- [x] admin 从 LeftRail 入口进入全屏管理台，八个分组可渲染（UI 人工抽检由 Playwright spec 兜底，见报告后续项 1）
+- [x] 非管理员无入口且 `/api/v1/admin/system/*` 返回 403（server 单测真实 mux + 内存 IAM）
+- [x] 白名单可写设置 PUT 后 GET 生效；env 项只读并标注需重启（写读回环 PASS）
+- [x] `go vet ./...`、`go test -short ./...`、`cd web && npm test && npm run build` 全绿
+- [x] dev 容器冒烟 PASS
+
+## 相关链接
+
+- 方案：会话计划（全屏独立视图 / 吸收旧模态 / 只读+少量可写，用户已批准）
+- Test report: [2026-09-17-system-admin-console-test-report.md](../../test-reports/2026-09-17-system-admin-console-test-report.md)
+- FEATURE-MATRIX 行：系统管理台
+
+## 证据 / 备注
+
+- commit：`f1404d5`（后端）、`0eaca61`（前端）、`dc7c31e`（merge dev）
+- 冒烟：health `schema_version=49`；overview/kb/features(22)/settings(6) 200；PUT 写读回环 PASS；匿名 401、未知 key 400、非 admin 403（单测）
+- 遗留（二期）：Playwright 实跑、`system:*` 细粒度权限、设置审计日志、KB 运维动作、白名单项接消费方、403 自动退回

.doc/ops/short-term/2026-09-17-w1-ci-e2e-green-nightly.md

@@ -0,0 +1,53 @@
+---
+title: "W1 CI/E2E FullNone + green nightly"
+status: done
+created: 2026-09-17
+updated: 2026-09-17
+owner: Cursor
+branch: feature/w1-ci-e2e-green-nightly
+worktree: "-"
+mutex: ci
+---
+
+# W1 CI/E2E FullNone + green nightly
+
+## 目标
+
+收口 FullNone `product_fail`，取得真实 nightly `verdict=pass` receipt，将 FEATURE-MATRIX「CI / E2E」升为 `done`。
+
+## 范围
+
+- 复核 Actions secret/runner 已就绪
+- 复现并修复 `TestWorkflowGovernance_PiAgent_PG_FullNoneMixedChain`
+- nightly U8+FullNone → green receipt + test-report
+- 矩阵行升 done
+
+## 非目标
+
+- W2–W7；升 `MULTI_INTENT_PLAN_TIER`；开 `SEMANTIC_SUMMARY_REPLACE`；整支 merge FAV
+
+## 步骤
+
+1. [x] docs 计划分支合入 `dev`（`4bda648`）
+2. [x] CURRENT 认领 `mutex=ci` + 本 short-term
+3. [x] 本地复现 FullNone 并分栏（根因：duplicate goose 00048 + fields.json 硬目标 + KB/超时）
+4. [x] 修复至本地 FullNone 绿（1008s）
+5. [x] nightly green receipt 归档 + test-report（`6e2476f0…` verdict=pass）
+6. [x] FEATURE-MATRIX CI/E2E → done；总控 W1 勾选；释放认领
+
+## 验收标准
+
+- [x] Nightly receipt `verdict=pass`（真实 run）
+- [x] FullNone 在 nightly 套件 PASS
+- [x] 矩阵 `done`；B1–B4 零回归
+
+## 相关链接
+
+- Plan: [../../remediation/2026-09-16-partial-deferred-completion-plan.md](../../remediation/2026-09-16-partial-deferred-completion-plan.md) §W1
+- Test report: [../../test-reports/2026-09-17-w1-ci-e2e-green-nightly-test-report.md](../../test-reports/2026-09-17-w1-ci-e2e-green-nightly-test-report.md)
+- Receipt: [../../test-reports/assets/promotion-receipts/6e2476f0f2e408e111fe06ca7c31a38294a340b3.json](../../test-reports/assets/promotion-receipts/6e2476f0f2e408e111fe06ca7c31a38294a340b3.json)
+
+## 证据 / 备注
+
+- commits: `4f2e5f0` `a02c67d` `0f52ab8` `11e030d` `6e2476f`
+- Gitea Actions API 可达；本提交未推远端，远端 dispatch 留合入后二次确认

.doc/ops/short-term/2026-09-17-w2-semantic-summary-shadow.md

@@ -0,0 +1,48 @@
+---
+title: "W2 语义摘要 shadow 真实 PI"
+status: done
+created: 2026-09-17
+updated: 2026-09-17
+owner: Cursor
+branch: feature/w2-semantic-summary-shadow-live
+worktree: "-"
+mutex: chat
+---
+
+# W2 语义摘要 shadow 真实 PI
+
+## 目标
+
+在授权可见集合上接入产品 PI Agent Runner 的 no-tool shadow 摘要；默认 flag off；不接线 `SEMANTIC_SUMMARY_REPLACE`。
+
+## 范围
+
+- `PiSemanticSummarizer` 组合根注入（仅 `SEMANTIC_SUMMARY_SHADOW` on 且 backend=pi-agent）
+- R13 minimized input.json；tool_permissions=none
+- 真实 MiniMax 证据 + injection 负例
+- 仓库默认 flag 保持 false
+
+## 非目标
+
+- 启用 `SEMANTIC_SUMMARY_REPLACE`
+- 改 test/main 默认 env
+
+## 步骤
+
+1. [x] 认领 CURRENT mutex `chat`
+2. [x] 实现 PI summarizer + 单测
+3. [x] 真实 PI live
+4. [x] test-report + 矩阵升 done
+5. [x] 合 `dev`
+
+## 验收标准
+
+- [x] flag 默认 off
+- [x] 真实 PI shadow.status=ok 或可解释 fallback
+- [x] injection 秘密不入 served narrative；REPLACE 未接线
+- [x] vet / short / arch-check PASS
+
+## 相关链接
+
+- 契约: `.doc/ops/long-term/2026-09-16-pu6-semantic-summary-contract.md`
+- 总控: `.doc/ops/short-term/2026-09-16-partial-deferred-completion.md`

.doc/ops/short-term/2026-09-17-w3-pi-change-report-narrative.md

@@ -0,0 +1,48 @@
+---
+title: "W3 PU7 PI change-report 叙事 live"
+status: done
+created: 2026-09-17
+updated: 2026-09-17
+owner: Cursor
+branch: feature/w3-pi-change-report-narrative-live
+worktree: "-"
+mutex: docgov
+---
+
+# W3 PU7 PI change-report 叙事 live
+
+## 目标
+
+flag on 时质量修复路径向产品 PI Agent Runner 请求 `change_report_narrative_v1`；digest 绑定；畸形/超时全量 fallback；UI 区分叙事与 `rule_risk`/lineage。
+
+## 范围
+
+- `CreateAgentCandidate` 在 flag on 且 `ReportJSON` 为空时调用 `NarrativeFetcher`
+- 组合根仅 `PI_CHANGE_REPORT_NARRATIVE` on + `pi-agent` 注入 `PiChangeReportNarrator`
+- 仓库默认 flag 仍 off；dev 运行态可覆盖
+- 负例：timeout envelope / fetcher error → fallback 且不返回 `ErrReportInvalid`
+
+## 非目标
+
+- 不把 fallback 写成完整 PI
+- 不覆盖服务端风险与文档影响
+- 不默认开启仓库 flag
+
+## 步骤
+
+1. [x] no-tool PI narrator + 组合根接线
+2. [x] digest 与 `ResolveChangeReport` 同源（candidate 真实 diff 之后再 fetch）
+3. [x] 单测 + 真实 MiniMax + UI 分区单测
+4. [x] 合 `dev` + 冒烟 + 矩阵升 done
+
+## 验收标准
+
+- [x] 真实 PI 产出 `change_report_narrative_v1` 且 digest 原样回写
+- [x] fallback 负例 PASS
+- [x] UI `change-report-factual` / `change-report-narrative` 分区
+- [x] test-report 归档
+
+## 相关链接
+
+- Contract: [../long-term/2026-09-16-pu7-pi-narrative-contract.md](../long-term/2026-09-16-pu7-pi-narrative-contract.md)
+- Test report: [../../test-reports/2026-09-17-w3-pi-change-report-narrative-test-report.md](../../test-reports/2026-09-17-w3-pi-change-report-narrative-test-report.md)

.doc/ops/short-term/2026-09-17-w5a-software-bootstrap-ui-pi.md

@@ -0,0 +1,21 @@
+---
+title: "W5a 软件自举 UI + docs_only PI"
+status: done
+created: 2026-09-17
+updated: 2026-09-17
+owner: Cursor
+branch: feature/w5a-software-bootstrap-ui-pi
+worktree: "-"
+mutex: workflow-design
+---
+
+# W5a 软件自举 UI + docs_only PI
+
+## 目标
+
+创建向导改为服务端 catalog 驱动；软件项目不克隆医疗 7 模板；solo 标注未独立评审；docs_only 真实 PI 建议 delivery 且不自动激活。SWBOOT-10 仍 stub。矩阵不升 done。
+
+## 非目标
+
+- 真 patch/merge（W5b）
+- 升 FEATURE-MATRIX 纯软件自举行

.doc/ops/short-term/2026-09-17-w6-fav-subscriber-shadow.md

@@ -0,0 +1,51 @@
+---
+title: "W6 FAV subscriber shadow"
+status: done
+created: 2026-09-17
+updated: 2026-09-17
+owner: Cursor
+branch: feature/w6-fav-subscriber-shadow
+worktree: "-"
+mutex: events
+---
+
+# W6 FAV subscriber shadow
+
+## 目标
+
+手工移植 FAV subscriber **shadow**：只计算 intended outcome，不写业务副作用；`FAV_DEGRADED_READ=false`；`FAV_PUBLISHER_ENABLED` 默认 false。矩阵保持 `partial`。
+
+## 范围
+
+- `ObserveShadow` 只读计算
+- vault status / CLI 标明 shadow 与 live 未放量
+- 负例：degraded read 拒绝；HandleLease / Register(fav) 仍 fail-closed
+
+## 非目标
+
+- 整支 merge `feature/final-artifact-vault`
+- live staging → artifact → publication
+- 启用 `FAV_DEGRADED_READ`
+- 升 FEATURE-MATRIX FAV 为 `done`
+
+## 步骤
+
+1. [x] `ObserveShadow` + 负例单测
+2. [x] 冒烟 + 报告（live 未放量）
+3. [x] 合 `dev`；矩阵保持 partial
+
+## 验收标准
+
+- [x] WouldStage / WouldPublish 恒 false
+- [x] FAV_DEGRADED_READ=true 时 shadow 拒绝
+- [x] 报告写清 shadow 证据与「live 未放量」
+
+## 相关链接
+
+- Remaining port: [../../audit/2026-09-16-fav-u7-remaining-port.md](../../audit/2026-09-16-fav-u7-remaining-port.md)
+- U7 报告: [../../test-reports/2026-09-16-fav-u7-incremental-test-report.md](../../test-reports/2026-09-16-fav-u7-incremental-test-report.md)
+- Test report: [../../test-reports/2026-09-17-w6-fav-subscriber-shadow-test-report.md](../../test-reports/2026-09-17-w6-fav-subscriber-shadow-test-report.md)
+
+## 证据 / 备注
+
+不占 live 观察窗；≥7 天窗口仍属后续 live 切片。

.doc/ops/short-term/2026-09-17-w7-d7-inventory.md

@@ -0,0 +1,46 @@
+---
+title: "W7 D7 对话数据分类盘点"
+status: done
+created: 2026-09-17
+updated: 2026-09-17
+owner: Cursor
+branch: feature/w7-d7-data-inventory
+worktree: "-"
+mutex: chat
+---
+
+# W7 D7 对话数据分类盘点
+
+## 目标
+
+只做数据分类盘点 audit（sessions/messages、KB、日志、备份、event 敏感字段与流转）。无合规签字不物理删除、不清备份。矩阵 D7 保持 `deferred`。
+
+## 范围
+
+- 只读盘点：表、派生副本、日志、备份脚本、事件 payload
+- 若发现**已确认**安全/合规基线违规 → 立即写 gap-matrix blocker
+
+## 非目标
+
+- 按 ADR 草案数字（365/180/30）执行物理删除或备份清除
+- 字段级加密实现
+- 升 FEATURE-MATRIX D7 为 `done`
+- 翻转 `production_ready`
+
+## 步骤
+
+1. [x] 只读盘点系统库 / 共享 KB / 宿主 traces / 事件 payload keys
+2. [x] 写 audit + test-report；违规判定（无已确认违规，未写 gap-matrix）
+3. [x] 合 `dev`；矩阵保持 deferred
+
+## 验收标准
+
+- [x] 盘点覆盖 sessions/messages、KB、日志、备份、event
+- [x] 未执行物理删除
+- [x] D7 仍 deferred；ADR 仍 `pending-compliance-signoff`
+
+## 相关链接
+
+- ADR: [../../adr/2026-09-17-d7-chat-data-retention.md](../../adr/2026-09-17-d7-chat-data-retention.md)
+- Audit: [../../audit/2026-09-17-d7-data-inventory.md](../../audit/2026-09-17-d7-data-inventory.md)
+- Test report: [../../test-reports/2026-09-17-w7-d7-inventory-test-report.md](../../test-reports/2026-09-17-w7-d7-inventory-test-report.md)

.doc/ops/short-term/2026-09-18-user-manual.md

@@ -0,0 +1,58 @@
+---
+title: "系统使用说明书（含真实截图，md/word/pdf/html 四格式）"
+status: done
+created: 2026-09-18
+updated: 2026-09-18
+owner: Kimi
+branch: feature/user-manual
+worktree: .worktrees/feature-user-manual
+mutex: docs
+---
+
+# 系统使用说明书（含真实截图，md/word/pdf/html 四格式）
+
+## 目标
+
+产出覆盖「从 0 进入系统 → 登录/注册 → 管理员角色权限配置 → 日常使用 → 审批全流程」的终端用户说明书，配 dev 环境真实操作截图（含真实 PI 对话），交付 Markdown / HTML / PDF / Word 四种格式于 `docs/user-manual/`。
+
+## 范围
+
+- dev 环境（127.0.0.1:8080）Playwright 实操截图约 30 张（登录、工作台、立项、对话、文档、审批链、管理台 8 分组）
+- `docs/user-manual/manual.md` 十章中文说明书（内容以代码为准）
+- `docs/user-manual/scripts/`（截图与格式生成脚本，可重跑）
+- `docs/user-manual/dist/`（html/pdf/docx 产物）
+
+## 非目标
+
+- 不合入 dev、不 push（用户未要求）
+- 不改动任何产品代码
+- 不覆盖产品手册范围外的工程内部工具（`engineering-dashboard` 当时为工程内部，其后已移出本仓库）
+
+## 步骤
+
+1. [x] 分支 + 登记
+2. [x] 环境预检（健康、登录凭证、中文字体、chromium）
+3. [x] 截图脚本 `capture-screenshots.mjs` 并采集
+4. [x] 真实 PI 对话截图
+5. [x] 三责审批链 + 阶段门禁截图（zhanggong/lizhuguan/wangzong）
+6. [x] 撰写 manual.md
+7. [x] build-formats.mjs 生成 html/pdf/docx（pandoc 缺失时 .doc 兜底）
+8. [x] 校验（图片引用、PDF 渲染抽查、docx 媒体嵌入）
+9. [x] 提交 + 更新 CURRENT
+
+## 验收标准
+
+- [x] 四种格式文件齐备且可打开
+- [x] manual.md 图片引用全部存在，无孤图
+- [x] PDF 中文无乱码、图片正常嵌入
+- [x] 说明书章节覆盖：进入系统/登录/注册/管理员配置角色权限/项目使用/对话/文档/审批/FAQ
+
+## 相关链接
+
+- Checklist: -
+- Handoff: -
+- Test report: -
+
+## 证据 / 备注
+
+- 演示账号（dev 种子，密码 123456）：zhanggong / lizhuguan / wangzong / guest；管理员 admin（密码取 configs/.env.dev）

.doc/ops/short-term/2026-09-18-wave0-p0-bug-fixes.md

@@ -0,0 +1,55 @@
+---
+title: "Wave 0：P0 确认 bug 修复（SSE/缓存/run-stream）"
+status: done
+created: 2026-09-18
+updated: 2026-09-18
+owner: Cursor
+branch: fix/wave0-p0-sse-chat-cache-bugs
+worktree: "-"
+mutex: chat + web
+---
+
+# Wave 0：P0 确认 bug 修复（SSE/缓存/run-stream）
+
+## 目标
+
+修复体检确认的 P0 bug：SSE 120s 断流（B-1/B-2）、run/stream 解析与时序（B-3/B-4）、前端会话窗口缓存 key 不一致（B-5）、IndexedDB 恢复覆盖（B-6）。
+
+## 范围
+
+- `internal/server/sse.go`：chat/run stream 心跳 + WriteDeadline；Decode 400；CreateAndStart/Subscribe 前置 Flush
+- `web/src/hooks/useChatWindow.ts` + `web/src/data/storage.ts`：缓存 key / LRU 一致
+- `web/src/App.tsx` + `web/src/data/fileStore.ts`：恢复合并
+- 对应单测与测试报告
+
+## 非目标
+
+- E-1（main ENV 不一致）及 Wave 1–7 其余项
+- FAV / MULTI_INTENT_PLAN_TIER / SEMANTIC_SUMMARY_REPLACE 放量
+
+## 步骤
+
+1. [x] 从 dev 开 `fix/wave0-p0-sse-chat-cache-bugs`，CURRENT 认领
+2. [x] B-1/B-2 心跳与 deadline
+3. [x] B-3/B-4 run/stream
+4. [x] B-5 缓存 key
+5. [x] B-6 恢复合并
+6. [x] 单测 + 全量回归 + 合入 dev 冒烟
+
+## 验收标准
+
+- [x] `go vet ./...`、`go test -short ./...`、`cd web && npm test && npm run build` 全绿
+- [x] 畸形 body → 400；Flush 前失败非 200 SSE
+- [x] 缓存 key / LRU 单测 PASS；恢复合并不丢新增 deliverable
+- [x] dev rebuild + health/ready；真 PI 聊天心跳证据（见测试报告）
+
+## 相关链接
+
+- Audit: [../../audit/2026-09-17-system-health-check.md](../../audit/2026-09-17-system-health-check.md)
+- Remediation: [../../remediation/2026-09-17-system-health-remediation-plan.md](../../remediation/2026-09-17-system-health-remediation-plan.md)
+- Test report: [../../test-reports/2026-09-18-wave0-p0-bug-fixes-test-report.md](../../test-reports/2026-09-18-wave0-p0-bug-fixes-test-report.md)
+
+## 证据 / 备注
+
+- Commits：`64efaa3` docs · `54244ed` server · `2620d80` web；合入 `dev` merge `810fb96`
+- Assets：`.doc/test-reports/assets/2026-09-18-wave0-p0-bug-fixes/chat-stream-long.sse.txt`

.doc/ops/short-term/2026-09-18-wave1-main-env-fix.md

@@ -0,0 +1,53 @@
+---
+title: "Wave 1：main 环境 ENV/schema 修正（E-1/E-2/E-5）"
+status: done
+created: 2026-09-18
+updated: 2026-09-18
+owner: Cursor
+branch: fix/wave1-main-env-fix
+worktree: "-"
+mutex: infra
+---
+
+# Wave 1：main 环境 ENV/schema 修正（E-1/E-2/E-5）
+
+## 目标
+
+统一 main 环境 app/events 的 `ENV=main` 语义，用 compose 依赖强制 events 先迁移再启 app，并关闭 `Env==""` 视同 dev 的导入门禁漏洞。
+
+## 范围
+
+- `docker-compose.main.yml`：app `ENV: main`；`depends_on.events` healthy；events 补生产校验所需口令
+- `configs/.env.main`（本机）/ `.env.main.example`：`ENV=main`
+- `internal/server/chat_window_api.go`：去掉空 Env 视同 dev
+- 回归测试 + 真实 main rebuild 验证
+
+## 非目标
+
+- Wave 2+；不改 `event_consumer_modes` 的 mode 值；不触碰 FAV / MULTI_INTENT / SEMANTIC_SUMMARY_REPLACE
+
+## 步骤
+
+1. [x] 从本地 `dev` 开分支并 CURRENT 认领
+2. [x] E-1 ENV 对齐
+3. [x] E-2 depends_on events
+4. [x] E-5 空 Env fail-closed
+5. [x] 单测 + 合入 + main rebuild 冒烟
+
+## 验收标准
+
+- [x] app/events health 均报 `env=main`
+- [x] main schema 已升（health `schema_version=52`，goose `version_id=52`）
+- [x] `event_consumer_modes` 中 main 四行仍为 `off`
+- [x] 导入端点空 Env → 403；compose ENV 对齐单测 PASS
+
+## 相关链接
+
+- Audit: [../../audit/2026-09-17-system-health-check.md](../../audit/2026-09-17-system-health-check.md)
+- Remediation: [../../remediation/2026-09-17-system-health-remediation-plan.md](../../remediation/2026-09-17-system-health-remediation-plan.md)
+- Test report: [../../test-reports/2026-09-18-wave1-main-env-fix-test-report.md](../../test-reports/2026-09-18-wave1-main-env-fix-test-report.md)
+
+## 证据 / 备注
+
+- 合入本地 `dev`：`merge: fix/wave1-main-env-fix` + events secrets unblock
+- Assets：`.doc/test-reports/assets/2026-09-18-wave1-main-env-fix/`

.doc/ops/short-term/2026-09-18-wave2-config-flag-align.md

@@ -0,0 +1,57 @@
+---
+title: "Wave 2：配置与灰度入口对齐（E-3/E-4/E-6/E-7/E-9）"
+status: done
+created: 2026-09-18
+updated: 2026-09-18
+owner: Cursor-Auto
+branch: fix/wave2-config-flag-align
+worktree: "-"
+mutex: infra
+---
+
+# Wave 2：配置与灰度入口对齐
+
+## 目标
+
+三环境 compose 显式声明封存 flag（值保持 legacy/false）；移除死 `CURSOR_RUNNER`；main 显式 `SEED_DEMO_USERS=false`；`INTENT_V2_DECISION_TIER` 非法值 fail-closed 到 `none`；E-9 仅记录评估结论。
+
+## 范围
+
+- E-3 / A-4：三环境补 `MULTI_INTENT_PLAN_TIER` + U9–U12 + SHADOW/NARRATIVE 声明
+- E-4：删除 `CURSOR_RUNNER_URL` 与 `cursor-agent` 占位服务
+- E-6：main `SEED_DEMO_USERS: "false"`
+- E-7：`parseV2DecisionTier` default → `none`
+- E-9：评估记录，不改 initdb
+
+## 非目标
+
+- 不升 `MULTI_INTENT_PLAN_TIER`；不接线 `SEMANTIC_SUMMARY_REPLACE`
+- 不改 FAV modes；不改 E-9 initdb 挂载
+- Wave 3+ 范围项
+
+## 步骤
+
+1. [x] Sonnet 5 产出实施计划（默认决策：删 cursor-agent；不补 REPLACE；E-9 不改代码）
+2. [x] E-7 代码 + 单测
+3. [x] E-3 / E-4 / E-6 compose
+4. [x] compose flag 声明回归测试
+5. [x] go vet/test；三环境 rebuild + env 抽检 + 冒烟
+6. [x] 合入本地 dev；文档闭环
+
+## 验收标准
+
+- [x] 三环境 `docker compose config` 可见目标 flag；`CURSOR_RUNNER` 零匹配
+- [x] 容器内 env 抽检 PASS；health/ready PASS
+- [x] `go test -short ./...` 全绿
+- [x] test-report 归档；remediation Wave 2 done
+
+## 相关链接
+
+- Remediation: [.doc/remediation/2026-09-17-system-health-remediation-plan.md](../../remediation/2026-09-17-system-health-remediation-plan.md)
+- Audit: [.doc/audit/2026-09-17-system-health-check.md](../../audit/2026-09-17-system-health-check.md)
+- Test report: [.doc/test-reports/2026-09-18-wave2-config-flag-align-test-report.md](../../test-reports/2026-09-18-wave2-config-flag-align-test-report.md)
+
+## 证据 / 备注
+
+计划作者：[Wave 2 Sonnet 计划](5b8c8c73-c3e4-4947-b0c4-91822859ff4a)  
+commits：`07fc0ec` `e0aabec` `55a539c` `8d97dd6` + docs closeout

.doc/ops/short-term/2026-09-18-wave3-test-debt-blindspots.md

@@ -0,0 +1,46 @@
+---
+title: "Wave 3：测试债与盲区（S-1/S-2/S-4/S-5）"
+status: done
+created: 2026-09-18
+updated: 2026-09-18
+owner: Cursor-Auto
+branch: fix/wave3-test-debt-blindspots
+worktree: "-"
+mutex: test-debt
+---
+
+# Wave 3：测试债与盲区
+
+## 目标
+
+关闭 `TestReconcile_LegacyRepair_PG` 工程测试债；清理永久跳过死代码；统一 E2E 脚本入口；推广 409/结构化错误信封复用。
+
+## 范围
+
+- S-1 / S-2 / S-4 / S-5（按 Sonnet 计划默认决策）
+
+## 非目标
+
+- 不升 MULTI_INTENT_PLAN_TIER；不接线 REPLACE；不改 FAV；项目 143 只读
+- 不改后端 httpx 信封整体迁移；不统一 INTENT_DUAL_TAB
+
+## 步骤
+
+1. [x] Sonnet 5 计划
+2. [x] S-1 隔离 PG 5436 跑一次并归档
+3. [x] S-2 删死跳过 + plan_owner 说明
+4. [x] S-4 e2e scripts + 退役 document-revision.spec
+5. [x] S-5 信封复用 + 单测
+6. [x] 文档闭环 + 合入本地 dev
+
+## 验收标准
+
+- [x] reconcile PG PASS 证据
+- [x] playwright --list = 29 tests / 8 files
+- [x] npm test / go test -short 全绿
+- [x] gap-matrix 测试债关闭；remediation Wave 3 done
+
+## 相关链接
+
+- Plan agent: [Wave 3 Sonnet 计划](51987049-b338-41a7-84f4-2c97e3655d85)
+- Test report: [.doc/test-reports/2026-09-18-wave3-test-debt-blindspots-test-report.md](../../test-reports/2026-09-18-wave3-test-debt-blindspots-test-report.md)