release-candidate: 汇集 dev@b9339cd2 至 test（docgov 共享 map 竞态修复、任务刷新恢复、商务叙事阶段门控），准备长期实测 [Tag: rc-v1.1.0-beta.7]

登录 500 来自进程被 concurrent map 打崩，不是登录逻辑。单测 -race 已通过，dev 重建仍待合入后复验。

.cursor/hooks.json

@@ -0,0 +1,49 @@
+{
+  "version": 1,
+  "hooks": {
+    "beforeShellExecution": [
+      {
+        "command": ".cursor/hooks/guard-git.sh",
+        "matcher": "^git ",
+        "timeout": 10,
+        "failClosed": true
+      },
+      {
+        "command": ".cursor/hooks/guard-pi-shell.sh",
+        "matcher": "pi_subagents\\.py|pkill",
+        "timeout": 10,
+        "failClosed": true
+      }
+    ],
+    "beforeMCPExecution": [
+      {
+        "command": ".cursor/hooks/guard-pi-dispatch.sh",
+        "matcher": "pi-subagents|pi_subagent_",
+        "timeout": 10,
+        "failClosed": true
+      }
+    ],
+    "postToolUse": [
+      {
+        "command": ".cursor/hooks/pi-receipt-context.sh",
+        "matcher": "MCP: pi-subagents|pi_subagent_",
+        "timeout": 10,
+        "failClosed": false
+      }
+    ],
+    "sessionStart": [
+      {
+        "command": ".cursor/hooks/audit-session.sh",
+        "timeout": 20,
+        "failClosed": false
+      }
+    ],
+    "stop": [
+      {
+        "command": ".cursor/hooks/audit-session.sh",
+        "timeout": 10,
+        "failClosed": false
+      }
+    ]
+  }
+}

.cursor/hooks/_lib.py

@@ -0,0 +1,166 @@
+#!/usr/bin/env python3
+"""Shared helpers for project Cursor hooks (advisory gates + audit/probe)."""
+from __future__ import annotations
+
+import json
+import os
+import re
+import sys
+from datetime import datetime, timezone
+from pathlib import Path
+from typing import Any
+
+KNOWN_ROLES = frozenset(
+    {
+        "research",
+        "planning",
+        "requirements_review",
+        "plan_review",
+        "code_review",
+        "diagnosis",
+        "test_run",
+        "acceptance_check",
+        "stage_notes",
+        "report",
+        "auxiliary",
+    }
+)
+TEST_ROLES = frozenset({"test_run", "acceptance_check"})
+FULL_SHA = re.compile(r"^[0-9a-fA-F]{40}$")
+REQUEST_ID = re.compile(r"^[A-Za-z0-9][A-Za-z0-9._:-]{0,127}$")
+
+
+def repo_root() -> Path:
+    env = os.environ.get("CURSOR_PROJECT_DIR") or os.environ.get("CURSOR_WORKSPACE_ROOT")
+    if env:
+        return Path(env).resolve()
+    # hooks run with cwd = project root
+    return Path.cwd().resolve()
+
+
+def audit_path() -> Path:
+    return repo_root() / ".cursor" / "hook-audit.jsonl"
+
+
+def probe_path() -> Path:
+    return repo_root() / ".cursor" / "hook-probe.jsonl"
+
+
+def inventory_dir() -> Path:
+    return repo_root() / ".cursor" / "hook-audit"
+
+
+def append_jsonl(path: Path, record: dict[str, Any]) -> None:
+    path.parent.mkdir(parents=True, exist_ok=True)
+    record = dict(record)
+    record.setdefault("ts", datetime.now(timezone.utc).isoformat())
+    with path.open("a", encoding="utf-8") as fh:
+        fh.write(json.dumps(record, ensure_ascii=False) + "\n")
+
+
+def read_stdin() -> str:
+    return sys.stdin.read()
+
+
+def maybe_probe(raw: str, hook: str) -> None:
+    if os.environ.get("CURSOR_HOOKS_PROBE", "").strip() not in ("1", "true", "TRUE", "yes"):
+        return
+    append_jsonl(
+        probe_path(),
+        {"hook": hook, "raw": raw[:65536], "raw_len": len(raw)},
+    )
+
+
+def parse_json_loose(raw: str) -> dict[str, Any] | None:
+    raw = (raw or "").strip()
+    if not raw:
+        return None
+    try:
+        data = json.loads(raw)
+    except json.JSONDecodeError:
+        return None
+    return data if isinstance(data, dict) else None
+
+
+def first_key(data: dict[str, Any], *names: str) -> Any:
+    for name in names:
+        if name in data and data[name] is not None:
+            return data[name]
+    return None
+
+
+def normalize_tool_name(name: str | None) -> str | None:
+    """Strip Cursor MCP prefixes such as 'MCP:' / 'MCP: pi-subagents/'."""
+    if name is None:
+        return None
+    n = str(name).strip()
+    # Observed IDE postToolUse: tool_name == "MCP:pi_subagent_roles"
+    if n.upper().startswith("MCP:"):
+        n = n[4:].lstrip()
+    # Rare: "MCP: pi-subagents/pi_subagent_run"
+    if "/" in n and n.rsplit("/", 1)[-1].startswith("pi_subagent_"):
+        n = n.rsplit("/", 1)[-1]
+    return n or None
+
+
+def tool_name(data: dict[str, Any]) -> str | None:
+    v = first_key(data, "tool_name", "mcp_tool_name", "name", "toolName")
+    return normalize_tool_name(str(v) if v is not None else None)
+
+
+def mcp_server(data: dict[str, Any]) -> str | None:
+    v = first_key(data, "mcp_server_name", "server", "mcpServer", "server_name")
+    return str(v) if v is not None else None
+
+
+def tool_input(data: dict[str, Any]) -> dict[str, Any] | None:
+    v = first_key(data, "tool_input", "arguments", "input", "toolInput", "params")
+    if isinstance(v, dict):
+        return v
+    if isinstance(v, str):
+        try:
+            parsed = json.loads(v)
+            return parsed if isinstance(parsed, dict) else None
+        except json.JSONDecodeError:
+            return None
+    return None
+
+
+def shell_command(data: dict[str, Any]) -> str:
+    v = first_key(data, "command", "shell_command", "cmd")
+    return str(v) if v is not None else ""
+
+
+def emit(obj: dict[str, Any]) -> None:
+    sys.stdout.write(json.dumps(obj, ensure_ascii=False))
+    sys.stdout.flush()
+
+
+def allow() -> None:
+    emit({"permission": "allow"})
+    raise SystemExit(0)
+
+
+def ask(user_message: str, agent_message: str) -> None:
+    emit(
+        {
+            "permission": "ask",
+            "user_message": user_message,
+            "agent_message": agent_message,
+        }
+    )
+    raise SystemExit(0)
+
+
+def additional_context(text: str) -> None:
+    emit({"additional_context": text})
+    raise SystemExit(0)
+
+
+def audit(hook: str, code: str, **extra: Any) -> None:
+    rec = {"hook": hook, "code": code}
+    rec.update(extra)
+    try:
+        append_jsonl(audit_path(), rec)
+    except OSError:
+        pass

.cursor/hooks/audit-session.sh

@@ -0,0 +1,4 @@
+#!/usr/bin/env bash
+set -euo pipefail
+DIR="$(cd "$(dirname "$0")" && pwd)"
+exec python3 -B "$DIR/audit_session.py"

.cursor/hooks/audit_session.py

@@ -0,0 +1,101 @@
+#!/usr/bin/env python3
+"""sessionStart / stop: audit + optional fail-open inventory (no context injection)."""
+from __future__ import annotations
+
+import json
+import os
+import subprocess
+import sys
+from datetime import datetime, timezone
+from pathlib import Path
+
+sys.path.insert(0, str(Path(__file__).resolve().parent))
+import _lib as lib  # noqa: E402
+
+HOOK = "audit-session"
+INVENTORY_TIMEOUT = 15
+
+
+def _run_inventory(root: Path) -> dict:
+    out: dict = {"cleanup_report": None, "docs_drift": None, "errors": []}
+    if os.environ.get("CURSOR_HOOKS_NO_INVENTORY", "").strip() in ("1", "true", "TRUE", "yes"):
+        out["skipped"] = "CURSOR_HOOKS_NO_INVENTORY"
+        return out
+    agentctl = root / "scripts" / "agentctl.py"
+    if not agentctl.is_file():
+        out["errors"].append("agentctl.py missing")
+        return out
+    for label, args in (
+        ("cleanup_report", ["cleanup", "report"]),
+        ("docs_drift", ["docs", "drift"]),
+    ):
+        try:
+            r = subprocess.run(
+                ["python3", "-B", str(agentctl), *args],
+                cwd=str(root),
+                capture_output=True,
+                text=True,
+                timeout=INVENTORY_TIMEOUT,
+                check=False,
+            )
+            payload = None
+            for stream in (r.stdout, r.stderr):
+                for line in (stream or "").splitlines():
+                    line = line.strip()
+                    if line.startswith("{"):
+                        try:
+                            payload = json.loads(line)
+                            break
+                        except json.JSONDecodeError:
+                            continue
+                if payload is not None:
+                    break
+            out[label] = {
+                "exit_code": r.returncode,
+                "payload": payload,
+                "stdout_tail": (r.stdout or "")[-2000:],
+                "stderr_tail": (r.stderr or "")[-1000:],
+            }
+        except subprocess.TimeoutExpired:
+            out["errors"].append(f"{label}: timeout>{INVENTORY_TIMEOUT}s")
+        except OSError as exc:
+            out["errors"].append(f"{label}: {exc}")
+    return out
+
+
+def main() -> None:
+    raw = lib.read_stdin()
+    lib.maybe_probe(raw, HOOK)
+    data = lib.parse_json_loose(raw) or {}
+    event = str(
+        lib.first_key(data, "hook_event_name", "event", "event_name", "type") or "unknown"
+    )
+    root = lib.repo_root()
+    if "start" in event.lower() or event == "unknown":
+        inv = _run_inventory(root)
+        inv_path = None
+        try:
+            inv_dir = lib.inventory_dir()
+            inv_dir.mkdir(parents=True, exist_ok=True)
+            ts = datetime.now(timezone.utc).strftime("%Y%m%dT%H%M%SZ")
+            path = inv_dir / f"inventory-{ts}.json"
+            path.write_text(json.dumps(inv, ensure_ascii=False, indent=2) + "\n", encoding="utf-8")
+            inv_path = str(path)
+        except OSError:
+            pass
+        lib.audit(
+            HOOK,
+            "SESSION_AUDIT",
+            event=event,
+            inventory_path=inv_path,
+            inventory_errors=inv.get("errors"),
+        )
+    else:
+        lib.audit(HOOK, "SESSION_AUDIT", event=event)
+
+    lib.emit({})
+    raise SystemExit(0)
+
+
+if __name__ == "__main__":
+    main()

.cursor/hooks/guard-git.sh

@@ -0,0 +1,60 @@
+#!/usr/bin/env bash
+# Fail-closed red-line gate for destructive / unauthorized git. Does not replace agentctl leases.
+set -euo pipefail
+input=$(cat)
+command=$(printf '%s' "$input" | python3 -c 'import json,sys; print(json.load(sys.stdin).get("command") or "")')
+
+ask() {
+  local user_msg="$1"
+  local agent_msg="$2"
+  python3 -c 'import json,sys; print(json.dumps({"permission":"ask","user_message":sys.argv[1],"agent_message":sys.argv[2]}))' "$user_msg" "$agent_msg"
+  exit 0
+}
+
+allow() {
+  echo '{"permission":"allow"}'
+  exit 0
+}
+
+# Normalize whitespace for matching
+cmd=$(printf '%s' "$command" | tr '\n' ' ')
+
+# Unauthorized push (user must confirm)
+if printf '%s' "$cmd" | grep -Eq '(^|[[:space:]])git([[:space:]]+-[^[:space:]]+)*[[:space:]]+push([[:space:]]|$)'; then
+  ask "git push 需要显式用户授权（AGENTS remote_sync）。请确认后再继续。" \
+      "Hook blocked git push pending user authorization."
+fi
+
+# Destructive / force operations
+if printf '%s' "$cmd" | grep -Eq 'git[[:space:]]+.*(--force|-f)([[:space:]]|$)' \
+  || printf '%s' "$cmd" | grep -Eq 'git[[:space:]]+push[[:space:]].*\+'; then
+  ask "检测到 git --force / 强推。破坏性操作须用户明确授权。" \
+      "Hook requires confirmation for force git operation."
+fi
+
+if printf '%s' "$cmd" | grep -Eq 'git[[:space:]]+reset[[:space:]]+.*--hard'; then
+  ask "git reset --hard 会丢弃工作区。须用户明确授权。" \
+      "Hook requires confirmation for git reset --hard."
+fi
+
+if printf '%s' "$cmd" | grep -Eq 'git[[:space:]]+clean[[:space:]]+.*-[a-zA-Z]*f'; then
+  ask "git clean -f 会删除未跟踪文件。须用户明确授权。" \
+      "Hook requires confirmation for git clean -f."
+fi
+
+if printf '%s' "$cmd" | grep -Eq 'git[[:space:]]+branch[[:space:]]+(-D|--delete[[:space:]]+--force)'; then
+  ask "强制删分支 (-D) 须用户明确授权；优先 git branch -d。" \
+      "Hook requires confirmation for git branch -D."
+fi
+
+if printf '%s' "$cmd" | grep -Eq 'git[[:space:]]+worktree[[:space:]]+remove[[:space:]]+.*--force'; then
+  ask "git worktree remove --force 被 AGENTS 禁止升级。须用户明确授权。" \
+      "Hook requires confirmation for forced worktree remove."
+fi
+
+if printf '%s' "$cmd" | grep -Eq 'git[[:space:]]+checkout[[:space:]]+--\.($|[[:space:]])'; then
+  ask "git checkout -- . 会丢弃全部本地修改。须用户明确授权。" \
+      "Hook requires confirmation for discarding all local changes."
+fi
+
+allow

.cursor/hooks/guard-pi-dispatch.sh

@@ -0,0 +1,5 @@
+#!/usr/bin/env bash
+# Thin wrapper: preserve stdin for Cursor hook JSON (do not use heredoc).
+set -euo pipefail
+DIR="$(cd "$(dirname "$0")" && pwd)"
+exec python3 -B "$DIR/guard_pi_dispatch.py"

.cursor/hooks/guard-pi-shell.sh

@@ -0,0 +1,4 @@
+#!/usr/bin/env bash
+set -euo pipefail
+DIR="$(cd "$(dirname "$0")" && pwd)"
+exec python3 -B "$DIR/guard_pi_shell.py"

.cursor/hooks/guard_pi_dispatch.py

@@ -0,0 +1,113 @@
+#!/usr/bin/env python3
+"""Advisory beforeMCPExecution gate for pi-subagents MCP tools."""
+from __future__ import annotations
+
+import sys
+from pathlib import Path
+
+sys.path.insert(0, str(Path(__file__).resolve().parent))
+import _lib as lib  # noqa: E402
+
+HOOK = "guard-pi-dispatch"
+
+
+def main() -> None:
+    raw = lib.read_stdin()
+    lib.maybe_probe(raw, HOOK)
+    data = lib.parse_json_loose(raw)
+    if data is None:
+        lib.audit(HOOK, "UNRECOGNIZED_INPUT", reason="non_json_or_empty")
+        lib.allow()
+
+    name = lib.tool_name(data)
+    server = lib.mcp_server(data)
+    if not name:
+        lib.audit(HOOK, "UNRECOGNIZED_INPUT", reason="missing_tool_name", keys=sorted(data.keys())[:40])
+        lib.allow()
+
+    if server and "pi-subagents" not in server and not name.startswith("pi_subagent_"):
+        if not name.startswith("pi_subagent_"):
+            lib.allow()
+
+    if name in ("pi_subagent_roles", "pi_subagent_result"):
+        lib.allow()
+
+    if name != "pi_subagent_run":
+        if name.startswith("pi_subagent_"):
+            lib.audit(HOOK, "UNRECOGNIZED_INPUT", reason="unknown_pi_tool", tool=name)
+        lib.allow()
+
+    args = lib.tool_input(data) or {}
+    req = args.get("request") if isinstance(args.get("request"), dict) else args
+    if not isinstance(req, dict):
+        lib.audit(HOOK, "UNRECOGNIZED_INPUT", reason="missing_request")
+        lib.ask(
+            "pi_subagent_run 缺少可识别的 request 对象。请核对 MCP 参数后再继续。",
+            "Hook: unrecognized request shape for pi_subagent_run.",
+        )
+
+    role = req.get("role_id")
+    request_id = req.get("request_id")
+    goal = req.get("goal")
+    auth = req.get("authorization_ref")
+    source_sha = req.get("source_sha")
+    input_files = req.get("input_files")
+    timeout = req.get("timeout_seconds")
+
+    problems: list[str] = []
+
+    if not role or not isinstance(role, str):
+        problems.append("role_id 缺失")
+    elif role not in lib.KNOWN_ROLES:
+        problems.append(f"role_id={role!r} 不在已知角色表")
+
+    if not request_id or not isinstance(request_id, str) or not lib.REQUEST_ID.match(request_id):
+        problems.append("request_id 非法（需字母数字开头，长度≤128）")
+
+    if not goal or not isinstance(goal, str) or not goal.strip():
+        problems.append("goal 为空")
+
+    if not auth or not isinstance(auth, str) or not auth.strip():
+        problems.append("authorization_ref 为空")
+
+    if not isinstance(source_sha, str) or not lib.FULL_SHA.match(source_sha):
+        problems.append("source_sha 必须是完整 40-hex 提交（禁止 HEAD/分支名/短 hash）")
+
+    if not isinstance(input_files, list):
+        problems.append("input_files 必须是数组")
+
+    if not isinstance(timeout, int) or isinstance(timeout, bool) or timeout <= 0:
+        if isinstance(timeout, float) and timeout.is_integer() and timeout > 0:
+            pass
+        else:
+            problems.append("timeout_seconds 必须是正整数")
+
+    if isinstance(role, str) and role in lib.TEST_ROLES:
+        cmds = req.get("approved_commands")
+        digest = req.get("plan_digest")
+        if not isinstance(cmds, list) or not cmds:
+            problems.append("test 角色需要 approved_commands（argv 数组的数组）")
+        elif any(not isinstance(c, list) or not all(isinstance(x, str) for x in c) for c in cmds):
+            problems.append("approved_commands 形状错误（应为字符串数组的数组）")
+        if not isinstance(digest, str) or len(digest) != 64 or any(
+            c not in "0123456789abcdefABCDEF" for c in digest
+        ):
+            problems.append("plan_digest 必须是 64-hex SHA-256")
+
+    if "model_override" in req and req.get("model_override") is not None:
+        problems.append("出现 model_override（禁止静默换模型；请用任务 override）")
+
+    if problems:
+        detail = "；".join(problems)
+        lib.audit(HOOK, "SHAPE_ASK", tool=name, problems=problems, role=role, request_id=request_id)
+        lib.ask(
+            f"pi_subagent_run 形状检查未通过：{detail}。执行器仍会硬校验；确认后继续或修正参数。",
+            f"Hook advisory: {detail}",
+        )
+
+    lib.audit(HOOK, "ALLOW", tool=name, role=role, request_id=request_id)
+    lib.allow()
+
+
+if __name__ == "__main__":
+    main()

.cursor/hooks/guard_pi_shell.py

@@ -0,0 +1,56 @@
+#!/usr/bin/env python3
+"""Advisory beforeShellExecution: bare pi_subagents.py run / broad pkill."""
+from __future__ import annotations
+
+import re
+import sys
+from pathlib import Path
+
+sys.path.insert(0, str(Path(__file__).resolve().parent))
+import _lib as lib  # noqa: E402
+
+HOOK = "guard-pi-shell"
+
+
+def main() -> None:
+    raw = lib.read_stdin()
+    lib.maybe_probe(raw, HOOK)
+    data = lib.parse_json_loose(raw)
+    if data is None:
+        lib.audit(HOOK, "UNRECOGNIZED_INPUT", reason="non_json_or_empty")
+        lib.allow()
+
+    cmd = lib.shell_command(data)
+    if not cmd:
+        lib.audit(HOOK, "UNRECOGNIZED_INPUT", reason="missing_command", keys=sorted(data.keys())[:40])
+        lib.allow()
+
+    compact = re.sub(r"\s+", " ", cmd).strip()
+
+    if re.search(r"(^|[;&|]\s*)pkill(\s|$)", compact) and re.search(r"\s-f(\s|$)", compact):
+        lib.audit(HOOK, "PKILL_ASK", command=compact[:500])
+        lib.ask(
+            "检测到 pkill -f（广谱杀进程）。AGENTS/PI 规则禁止广谱杀；请确认范围后再继续。",
+            "Hook requires confirmation for pkill -f.",
+        )
+
+    if re.search(r"pi_subagents\.py(\s|$)", compact) and re.search(r"(^|\s)run(\s|$)", compact):
+        has_lease = (
+            re.search(r"agentctl(\.py)?\s+with\b", compact) is not None
+            and re.search(r"--resource\s+path:", compact) is not None
+        )
+        if re.search(r"pi_subagents\.py\s+(roles|result|status|config)\b", compact):
+            lib.allow()
+        if not has_lease:
+            lib.audit(HOOK, "BARE_RUN_ASK", command=compact[:500])
+            lib.ask(
+                "裸调 pi_subagents.py run 缺少 agentctl with --resource path:… 租约。"
+                "报告路径须在 path:.doc/test-reports/assets/pi-subagents/<task>/<request> 租约内。",
+                "Hook: bare PI run without lease resource.",
+            )
+
+    lib.allow()
+
+
+if __name__ == "__main__":
+    main()

.cursor/hooks/pi-receipt-context.sh

@@ -0,0 +1,4 @@
+#!/usr/bin/env bash
+set -euo pipefail
+DIR="$(cd "$(dirname "$0")" && pwd)"
+exec python3 -B "$DIR/pi_receipt_context.py"

.cursor/hooks/pi_receipt_context.py

@@ -0,0 +1,48 @@
+#!/usr/bin/env python3
+"""postToolUse: inject receipt-check reminders after pi-subagents tools."""
+from __future__ import annotations
+
+import sys
+from pathlib import Path
+
+sys.path.insert(0, str(Path(__file__).resolve().parent))
+import _lib as lib  # noqa: E402
+
+HOOK = "pi-receipt-context"
+
+REMINDER = """[PI subagent receipt checklist]
+- 核对 report/receipt 路径：.doc/test-reports/assets/pi-subagents/<task_id>/<request_id>/
+- 记录 config_revision / config_sha256 / configured vs actual_model（不可观察填 unknown）
+- run_status=succeeded 不等于阶段 PASS；review_state 仍可为 pending
+- 测试 pass 只来自批准命令证据（approved_commands），不能用模型叙事冒充
+- 推进门禁前用 subagent-stage-record skill 写回传与阶段收据
+"""
+
+
+def main() -> None:
+    raw = lib.read_stdin()
+    lib.maybe_probe(raw, HOOK)
+    data = lib.parse_json_loose(raw)
+    if data is None:
+        lib.audit(HOOK, "UNRECOGNIZED_INPUT", reason="non_json_or_empty")
+        lib.emit({})
+        raise SystemExit(0)
+
+    name = lib.tool_name(data) or ""
+    server = lib.mcp_server(data) or ""
+    blob = raw
+    is_pi = (
+        name.startswith("pi_subagent_")
+        or "pi-subagents" in server
+        or "pi_subagent_" in blob
+    )
+    if not is_pi:
+        lib.emit({})
+        raise SystemExit(0)
+
+    lib.audit(HOOK, "CONTEXT_INJECT", tool=name or "unknown")
+    lib.additional_context(REMINDER)
+
+
+if __name__ == "__main__":
+    main()

.cursor/mcp.json

@@ -0,0 +1,24 @@
+{
+  "mcpServers": {
+    "agentctl": {
+      "type": "stdio",
+      "command": "node",
+      "args": ["scripts/mcp/agentctl-mcp.mjs"]
+    },
+    "jev": {
+      "type": "stdio",
+      "command": "node",
+      "args": ["scripts/mcp/jev-mcp.mjs"]
+    },
+    "codegraph": {
+      "type": "stdio",
+      "command": "codegraph",
+      "args": ["serve", "--mcp", "--path", "${workspaceFolder}"]
+    },
+    "pi-subagents": {
+      "type": "stdio",
+      "command": "node",
+      "args": ["scripts/mcp/pi-subagents-mcp.mjs"]
+    }
+  }
+}

.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/agentctl-mandatory.mdc

@@ -0,0 +1,27 @@
+---
+description: Agent-System 写操作必须经 agentctl（租约、docs apply、候选合入）；禁止绕过治理直接改共享文档或 push。
+alwaysApply: true
+---
+
+# agentctl 强制治理
+
+本仓库由 agentctl 管理面协调（SQLite + launchd daemon）。细则见 [AGENTS.md](../../AGENTS.md) 与 [操作规范](../../.doc/ops/2026-09-21-agent-worktree-workflow.md)；流程技能见 `.cursor/skills/agentctl-*`。
+
+## 硬边界
+
+1. **写仓库**：必须 `agentctl with` / MCP `lease_run`。裸 `git commit` 会被 agentctl pre-commit hook 拒绝。
+2. **共享文档**：`.doc/ops/CURRENT.md`、`.doc/status/FEATURE-MATRIX.md` 只能 `docs apply`（行级 CAS；MATRIX 键为 `record_id`）。
+3. **合入 local dev**：`validate` 后 `queue enqueue`（daemon `--ff-only`）或受控 `integrate`；禁止直接改主目录 `dev` tip。
+4. **禁止默认**：未授权 `git push`、晋升 test/main、`--force` 清理、卸载 launchd coordinator、改 gap-matrix / 升 MATRIX 状态值冒充发布。
+5. **需求重叠**：跨对话新设计须 `catalog overlap`；硬重叠拒绝；软重叠须 `catalog ack` 留痕后方可编码（见 `.doc/ops/2026-09-24-governance-catalog-plan.md`）。
+
+## 会话路径
+
+- 启动 → skill `agentctl-session-start`
+- 建场 → `agentctl-worktree-setup`
+- 写回 → `agentctl-lease-write`
+- 合入/收口 → `agentctl-integrate-closeout`
+- PI 派发 → skill `pi-subagent-dispatch`（MCP `pi-subagents`）
+- 阶段落盘 → skill `subagent-stage-record`
+- MCP 工具定义见 `.cursor/mcp.json` → `scripts/mcp/agentctl-mcp.mjs` / `pi-subagents-mcp.mjs`
+- 客户端 hook 边界见规则 `cursor-hooks`

.cursor/rules/chinese-session-title.mdc

@@ -0,0 +1,22 @@
+---
+description: Cursor 对话自动生成的会话名称使用简体中文
+alwaysApply: true
+---
+
+# 会话名称（中文）
+
+Cursor 为本对话自动生成或建议的**会话名称 / 聊天标题**必须使用**简体中文**。
+
+## 要求
+
+- 用简短中文概括当前任务主题（约 6–16 字）
+- 优先动词/对象：如「创建会话中文命名规则」「修复登录超时」
+- 禁止默认英文标题（专有名词、命令、路径可保留原文，整体仍以中文为主）
+
+## 示例
+
+| 场景 | 可用标题 |
+|---|---|
+| 新建 Cursor 规则 | 创建会话中文命名规则 |
+| 排查 hook | 排查 pi-dispatch hook |
+| 合入 feature | 合入治理目录库变更 |

.cursor/rules/cursor-hooks.mdc

@@ -0,0 +1,42 @@
+---
+description: Project Cursor hooks are advisory gates layered on agentctl/PI executor hard checks; scripts exist does not mean Cursor loaded them.
+alwaysApply: true
+---
+
+# Cursor hooks（客户端门禁）
+
+配置：`.cursor/hooks.json`；脚本：`.cursor/hooks/`。规范登记修订 `cursor-governance-2026-09-24-r1`。
+
+## 分层
+
+| 层 | 能力 | 说明 |
+|---|---|---|
+| 执行器 / agentctl | **enforced** | `scripts/pi_subagents.py`、租约、pre-commit 等硬拒绝 |
+| hook 脚本行为 | **enforced**（有单元回归） | stdin→stdout 契约可测 |
+| hook ↔ Cursor 接线 | **advisory / manual** | 官方事件字段未完全文档化；待 probe 采样后收紧 |
+
+命中策略：与 `guard-git.sh` 一致，一律 `permission: ask`（不静默 deny）。
+
+## 事件与脚本
+
+- `beforeShellExecution`：`guard-git.sh`（破坏性 git）；`guard-pi-shell.sh`（裸调 `pi_subagents.py run`、`pkill -f`）
+- `beforeMCPExecution`：`guard-pi-dispatch.sh`（`pi_subagent_run` 形状）
+- `postToolUse`：`pi-receipt-context.sh`（注入收据核对提醒）
+- `sessionStart` / `stop`：`audit-session.sh`（审计 + 可选只读盘点；**不注入上下文**）
+
+IDE 实测（2026-09-24）：`postToolUse` 的 `tool_name` 形如 `MCP:pi_subagent_roles`；hooks 须剥 `MCP:` 前缀后再匹配角色工具名。
+
+## 审计与 probe
+
+- 审计：`.cursor/hook-audit.jsonl`（gitignore；勿提交）
+- 盘点：`.cursor/hook-audit/inventory-*.json`
+- 采样：`CURSOR_HOOKS_PROBE=1` → `.cursor/hook-probe.jsonl`
+- 关闭盘点：`CURSOR_HOOKS_NO_INVENTORY=1`
+
+异形/未知字段：**fail-open + 审计 `UNRECOGNIZED_INPUT`**，不因契约未知卡死会话。
+
+## 红线
+
+- 不把 hook 复刻成第二套执行器门禁
+- 脚本存在 ≠ Cursor 已加载；改 hooks 后检查 Hooks 设置页或通道
+- 审计日志不得放进被 git 跟踪的 `.cursor/hooks/` 目录

.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/pi-subagents.mdc

@@ -0,0 +1,24 @@
+---
+description: Route PI analysis/review/test subagent work through scripts/pi_subagents.py (not Cursor native agents).
+alwaysApply: true
+---
+
+# PI subagents（工程工具）
+
+本机 PI 子任务走 `scripts/pi_subagents.py` + 模型配置 `.doc/ops/2026-09-24-subagent-model-config.md`。可执行步骤见 skill `pi-subagent-dispatch`；阶段记录见 `subagent-stage-record`。
+
+## 自动派发（主 Agent）
+
+1. **预览配置**：`pi_subagent_roles` / CLI `roles`（不调模型）。
+2. **按阶段选角色**：research → planning → reviews → diagnosis → test_run / acceptance_check → report；实施/修复仍由 Cursor Auto。
+3. **派发 `run`**：携带 task_id、role_id、唯一 request_id、goal、authorization_ref、冻结 source_sha、input_files、timeout；test 角色另附 approved_commands + plan_digest。
+4. **租约**：报告路径 `path:.doc/test-reports/assets/pi-subagents/<task>/<request>`；裸调拒绝。
+5. **取回**：`pi_subagent_result` / CLI `result`；`run_status` 与 `verdict`/`review_state` 分离——模型成功仅 `pending`，测试 pass 仅来自批准命令证据。
+6. **门禁**：审查/测试结论须带回报告路径与 receipt 字段；不得用模型叙事冒充 PASS。
+
+## 边界
+
+- **Cursor Auto**：唯一代码实施车道；本规则不把 implementation 派给 PI。
+- **禁止**：自动换模型、M3 关键角色、伪造 lease、递归把本修复任务再派给 PI worker、`pkill -f` 广谱杀进程。
+- **MCP**：`.cursor/mcp.json` → `pi-subagents`（roles/run/result）；executor 来自 MCP 安装根。
+- **Hook（advisory）**：`.cursor/hooks/guard-pi-dispatch.sh` / `guard-pi-shell.sh` 可在形状错误时 `ask`；**硬拒绝以执行器为准**，见规则 `cursor-hooks`。

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

@@ -1,12 +1,13 @@
 ---
-description: 规定项目中所有自动化测试、功能测试、集成测试报告的存放路径与结构标准规范
-globs: ["**/*test*.go", ".doc/test-reports/**/*.md"]
+description: Cursor-side test report path/naming conventions; validation scope comes from the validation contract.
 alwaysApply: true
 ---
 
 # 测试报告规范准则 (Test Reports Standard)
 
-本仓库严格遵循标准化、可追溯的质量测试管理体系。所有测试报告必须归档于指定的文档目录下，并遵循固定结构。
+本仓库严格遵循标准化、可追溯的质量测试管理体系。**验证范围、套件选择与模型证据的唯一来源**为 [验证契约](../../.doc/ops/2026-09-21-validation-contract.md)；本规则只约定 Cursor 侧的报告路径、命名与结构提醒，不另设第二套测试门禁。
+
+**范围判定**：纯工程规范/文档变更按 [PROJECT.md 验证入口](../../PROJECT.md#验证入口) 与 [worktree 工作规范](../../.doc/ops/2026-09-21-agent-worktree-workflow.md) 检查链接、规则一致性及 Git 差异；不适用产品 PI 全链路。报告注明 NOT REQUIRED 及依据，不能记成产品测试 PASS。运行模板、提示词和业务变更不属于此例外——按验证契约选层级。
 
 ## 一、 测试报告归档路径规范
 
@@ -15,11 +16,9 @@ alwaysApply: true
   - 例如：`.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
 # [功能/模块名称] 测试报告
@@ -28,38 +27,37 @@ alwaysApply: true
 - 简述被测功能/特性的产生背景、业务痛点或上一轮测试中发现的缺陷与瓶颈。
 
 ## 二、 测试目标 (Test Objectives)
-- 列举本次测试需要验证的核心功能点、质量指标（如通过率 100%、无流程卡点、非阻塞人机协同等）。
+- 列举本次测试需要验证的核心功能点、质量指标。
 
 ## 三、 测试方案与环境 (Test Plan & Environment)
-- 测试环境（OS、Go 版本、后端 Stub/Real 模型）；
-- 测试层级分层（单元测试、协同集成测试、CLI 真实交互测试）；
+- 测试环境（OS、工具版本、目标环境批准配置）；
+- 测试层级分层（按验证契约矩阵选行）；
 - 核心测试用例矩阵设计。
 
 ## 四、 预期结果 (Expected Results)
-- 明确给出各用例输入下的理论判定分支、目标意图、提取槽位、参谋回复风格与状态机流转。
+- 明确给出各用例输入下的理论判定。
 
 ## 五、 实际测试结果与判定 (Actual Results & Evaluation)
 - 必须包含针对每一个典型测试用例的真实记录：
   - **测试输入 (Input)**
-  - **实际输出 (Actual Output)**：贴出真实的终端/日志输出文本
-  - **评价判定 (Evaluation / Verdict)**：PASS / FAIL 标志及判定依据
+  - **实际输出 (Actual Output)**：贴出真实的终端/日志输出文本（可脱敏）
+  - **评价判定 (Evaluation / Verdict)**：PASS / FAIL / SKIP / 未运行
   - **性能与耗时 (Duration & Latency)**
 
 ## 六、 自动化测试套件汇总 (Test Suite Execution)
-- 附带 `go test -v ./...` 全量回归测试输出与通过率统计。
+- 只列本次适用并**实际运行**的检查与通过率；不无条件要求全量 `go test`。
+- 工程工具改动优先 `python3 -B -m unittest discover -s scripts/tests -p 'test_*.py' -v`（见验证契约「工程工具验收补充」）。
 
 ## 七、 测试结论与后续优化建议 (Conclusion & Next Steps)
-- 总结测试是否达到上线/合并标准，提出后续演进或强化点。
+- 总结测试是否达到授权交付终点，提出后续演进或强化点。
 ```
 
----
-
 ## 三、 执行要求与真实 Agent 交付铁律
 
 1. **真实 Agent 交付铁律（红线）**：
-   - **开发实现阶段**：可以快速使用 `stub` 验证状态机、协议分流、数据落盘与逻辑契约，加速反馈；
-   - **交付前验收与测试报告生成**：**必须切回真实环境与真实 Agent（`pi-agent` + 实际运行的 `MiniMax-M2.7-highspeed` 容器）进行全链路端到端实测**；
-   - **严禁**使用 stub 的测试输出作为最终交付报告的验收数据。
-2. **严禁散落存放**：测试报告统一归档至 `.doc/test-reports/` 目录下，禁止散落在根目录或临时沙箱中。
+   - **开发实现阶段**：可以快速使用 stub 验证状态机、协议分流、数据落盘与逻辑契约，加速反馈；
+   - **交付前验收与测试报告生成**：涉及产品 Agent/工作流时，必须按验证契约「产品 PI 基线」在获授权环境用真实产品 PI Agent Runner 全链路实测；模型以目标环境批准配置为准，不得在本规则中硬编码模型名；
+   - **严禁**使用 stub、SKIP、未运行输出作为最终交付报告的验收数据。
+2. **严禁散落存放**：测试报告统一归档至 `.doc/test-reports/`，禁止散落在根目录或临时沙箱中。
 3. **真实控制台取样**：测试报告中的输入、输出、耗时与判定必须取自实际环境运行的真实控制台输出与日志。
 4. **Git 规范管理**：测试报告伴随对应阶段的 `docs(test)` 或 `test(...)` 规范提交入库。

.cursor/skills/agentctl-integrate-closeout/SKILL.md

@@ -0,0 +1,61 @@
+---
+name: agentctl-integrate-closeout
+description: Validate a merge candidate, enqueue for daemon ff-only integrate, and close out five-state. Use when ready to land a task on local dev.
+---
+
+# agentctl 集成与收口
+
+权威：[操作规范](../../../.doc/ops/2026-09-21-agent-worktree-workflow.md)、[验证契约](../../../.doc/ops/2026-09-21-validation-contract.md)。常驻 daemon 已装载时走 **enqueue**，勿手动 `integrate`（除非 daemon 停）。
+
+## 候选
+
+优先一层封装（创建 integrate worktree、`task register`、`--no-ff` merge；**不** validate/enqueue）：
+
+```bash
+D=$(git -C /path/to/Agent-System rev-parse HEAD)   # 冻结 expected-dev
+python3 scripts/agentctl.py integrate prepare \
+  --task <feature-task-id> --expected-dev "$D" \
+  [--integrate-id integrate-<task>-YYYY-MM-DD]
+# 进入返回的 worktree 继续 validate → enqueue
+cd .worktrees/integrate-<task>-YYYY-MM-DD   # 或 emit 中的 worktree
+```
+
+第一父必须等于 `$D`。手工 `worktree add` + `with` + `merge --no-ff` 仍可用。
+
+## validate → enqueue（daemon ff）
+
+```bash
+python3 ../../scripts/agentctl.py validate --task "$ID" -- <验收命令>
+python3 ../../scripts/agentctl.py queue enqueue \
+  --task "$ID" --expected-dev "$D" --head "$(git rev-parse HEAD)"
+# 在任务 worktree 内 enqueue；数秒内 daemon 合入
+python3 ../../scripts/agentctl.py queue list
+python3 ../../scripts/agentctl.py daemon status
+```
+
+验收按验证契约选行；治理脚本用 `unittest discover`。
+
+## 五态收口
+
+| 字段 | 典型值 |
+|---|---|
+| review_state | accepted |
+| integration_state | merged_local_dev |
+| deployment | not_required 或 loaded_local_launchd |
+| cleanup | pending（独立维护者；禁止 `--force`） |
+| remote_sync | not_requested |
+
+CURRENT 行 → `done`（`docs apply`）；`task close --status done`。
+
+## 清理前
+
+确认 tip 为 local_dev 祖先、证据已持久化、无 tracked/untracked 遗留、无进程占用。唯一日志/对话归档进 `.doc/ops/evidence/` 后再 `worktree remove`。
+
+只读盘点（不自动删除、不自动写 MATRIX）：
+
+```bash
+python3 ../../scripts/agentctl.py cleanup report   # 主目录或任意同仓 cwd
+python3 ../../scripts/agentctl.py docs drift
+```
+
+对 `verdict=ready` 的 worktree 由独立维护者执行 `agent-worktree.sh remove … --delete-branch`；拒绝则保留 cleanup_pending。daemon 未装载时用 `queue schedule --drain`（主目录 + 分支 dev）。

.cursor/skills/agentctl-lease-write/SKILL.md

@@ -0,0 +1,46 @@
+---
+name: agentctl-lease-write
+description: Write under agentctl leases and docs apply CAS. Use before any git write, shared-doc edit, or when hitting UNMANAGED_DOCUMENT_CHANGE / EVIDENCE_REQUIRED.
+---
+
+# agentctl 租约写回
+
+权威：[AGENTS §3–5](../../../AGENTS.md)、[操作规范](../../../.doc/ops/2026-09-21-agent-worktree-workflow.md)。
+
+## 原则
+
+- **任何仓库写**（含 `git add/commit`）必须在 `agentctl with` / MCP `lease_run` 租约内
+- CURRENT / FEATURE-MATRIX **只能** `docs apply`（行级 CAS；MATRIX 键为 `record_id`）
+- 直接 `git commit` 会被 agentctl-managed pre-commit hook 拒绝
+
+## lease_run（CLI）
+
+```bash
+python3 scripts/agentctl.py with \
+  --task "$ID" \
+  --resource path:scripts --resource path:.doc --resource git:index \
+  -- bash -lc 'git add … && git commit -m "…"'
+```
+
+MCP：`lease_run` 的 `command` 为 **argv 数组**（无额外 shell）。
+
+## docs apply（行级）
+
+```bash
+python3 scripts/agentctl.py docs snapshot --file .doc/ops/CURRENT.md --record "$RID"
+# expected_sha256 = snapshot.sha256；改 replacement 后：
+python3 scripts/agentctl.py docs apply --task "$ID" --request /tmp/req.json
+```
+
+FEATURE-MATRIX 升 `done` 需要 `docs:approve` + 可核验 evidence（`git cat-file -e`），否则 `EVIDENCE_REQUIRED`。
+收口或合入含 MATRIX 的变更后跑 `python3 scripts/agentctl.py docs drift`：硬告警仅 `done→非 done`；不因任务结束自动升 done。
+
+## 常见拒绝
+
+| 码 | 处置 |
+|---|---|
+| `UNMANAGED_DOCUMENT_CHANGE` | 保留现场，先 snapshot/reconcile，勿覆盖 |
+| `BASE_CHANGED` | 重新 snapshot，基于新 sha 再 apply |
+| `AMBIGUOUS_RECORD` | 修重复 record_id / 模块名 |
+| `CAPABILITY_REQUIRED` | 任务缺 docs:admin / docs:approve |
+| `DOCUMENT_RECEIPT_REQUIRED` | 共享文档须经 apply 收据后再 commit |

.cursor/skills/agentctl-session-start/SKILL.md

@@ -0,0 +1,51 @@
+---
+name: agentctl-session-start
+description: Start an Agent-System session under agentctl governance. Use at session start, when opening a worktree, or before any write to this repo.
+---
+
+# agentctl 会话启动
+
+权威规范：[AGENTS.md](../../../AGENTS.md)、[操作规范](../../../.doc/ops/2026-09-21-agent-worktree-workflow.md)、[CURRENT](../../../.doc/ops/CURRENT.md)。
+
+## 步骤
+
+1. 读 `AGENTS.md`、`PROJECT.md`、`.doc/ops/CURRENT.md` 活跃摘要（勿跳过）。
+2. 核对管理面：
+
+```bash
+python3 scripts/agentctl.py daemon status
+# 期望：status=ok；launchd 已装载时 manager.lock.held=true
+```
+
+或 MCP 工具 `status`。
+
+3. 刷新 CodeGraph 索引（fail-open；CLI 缺失可跳过）：
+
+```bash
+codegraph sync -q
+# 或：python3 scripts/agentctl.py hooks codegraph-sync
+```
+
+跨文件定位优先用 CodeGraph MCP/`explore`；**grep 仍是完整性唯一权威**（假阴性时以 grep 为准）。
+
+4. 若任务已存在：在注册 worktree 内工作，确认 `tasks.state=active`。
+5. **开工前需求重叠探测**（治理目录库）：新设计或可能与其他对话重叠时：
+
+```bash
+python3 scripts/agentctl.py catalog search --query '<关键词>'
+python3 scripts/agentctl.py catalog overlap --task "$ID" --statement '<设计原文>' [--requirement R-xxx] [--feature <record_id>] [--mutex <key>]
+# soft 命中须显式裁决后才可编码：
+python3 scripts/agentctl.py catalog overlap ack --task "$ID" --overlap <oid> --decision proceed|merge_into|supersede|defer --reason '...'
+```
+
+硬重叠（同 mutex/feature/scope/R-ID）直接拒绝；向量层失败自动降级到 FTS5，不阻断。
+
+6. 若新任务：跟 [agentctl-worktree-setup](../agentctl-worktree-setup/SKILL.md)。
+7. 任何仓库写 → [agentctl-lease-write](../agentctl-lease-write/SKILL.md)；合入 → [agentctl-integrate-closeout](../agentctl-integrate-closeout/SKILL.md)。
+
+## 禁止
+
+- 主目录直接开发提交；未授权 `git push` / 晋升 test/main
+- 绕过 `docs apply` 改 CURRENT / FEATURE-MATRIX
+- 卸载或重启 launchd coordinator（除非用户明示）
+- 未执行 `catalog overlap` / 未裁决 soft 命中即编码（有 `--requirement`/`--intent`/`--feature`/`--mutex` 绑定时机器强制）

.cursor/skills/agentctl-worktree-setup/SKILL.md

@@ -0,0 +1,65 @@
+---
+name: agentctl-worktree-setup
+description: Create an agentctl task worktree, register scopes/capabilities, and claim CURRENT. Use when starting a new feature/fix task in Agent-System.
+---
+
+# agentctl 建场
+
+权威：[操作规范](../../../.doc/ops/2026-09-21-agent-worktree-workflow.md)。
+
+## 命令序列
+
+```bash
+cd /path/to/Agent-System   # 主目录（dev）
+D=$(git rev-parse HEAD)
+ID=<task-id-YYYY-MM-DD>
+WT=.worktrees/$ID
+# 推荐入口：自动 best-effort codegraph init（后台；CLI 缺失不阻断）
+./scripts/agent-worktree.sh create feature/$ID
+# 等价：git worktree add -b feature/$ID "$WT" "$D"
+cd "$WT"
+python3 ../../scripts/agentctl.py task register \
+  --id "$ID" --owner <Owner> \
+  --scope scripts --scope .doc \
+  --capability docs:publish
+# 需要整文/行级 admin 时再加 --capability docs:admin；证据升 done 加 docs:approve
+# 若已知需求/功能绑定，追加：
+#   --requirement R-<slug> --intent '<设计原文>' --feature <record_id> --mutex <key>
+# 有 soft 重叠时 register 会 OVERLAP_ACK_REQUIRED：先 catalog overlap + ack 再重试 register
+codegraph sync -q   # 若建场已 init，此处只需 sync；缺失 CLI 可跳过
+```
+
+## 开工前重叠裁决（catalog）
+
+```bash
+python3 ../../scripts/agentctl.py catalog overlap \
+  --task "$ID" --statement '<新设计原文>' \
+  [--requirement R-xxx] [--feature <record_id>] [--mutex <key>]
+# hard → 换 mutex/合并到持有者任务；soft → ack 留痕
+python3 ../../scripts/agentctl.py catalog ack \
+  --task "$ID" --overlap <oid> \
+  --decision proceed|merge_into|supersede|defer \
+  --reason '<理由>'
+```
+
+## CURRENT 认领
+
+优先用一层封装（内部仍走 `docs apply` CAS）：
+
+```bash
+python3 ../../scripts/agentctl.py claim new \
+  --task "$ID" --owner <Owner> --mutex <mutex> \
+  [--branch feature/$ID] [--worktree "$WT"] [--replace]
+```
+
+手工 `docs snapshot` + `docs apply` 仍可用；行已存在且内容不同时需 `--replace`。
+
+## short-term 模板字段
+
+`status`、`write_scope`、`mutex`、`base_dev_sha`、`review_state`/`integration_state`/`deployment`/`cleanup`/`remote_sync`。命名 `.doc/ops/short-term/YYYY-MM-DD-<slug>.md`。
+
+## 注意
+
+- 从确切 `dev` SHA 创建，不从他人 feature 分支启动
+- 重叠 path/mutex 只允许一个写者
+- CodeGraph 索引是加速器：有假阴性；穷举调用方仍用 grep

.cursor/skills/jev-decide/SKILL.md

@@ -0,0 +1,52 @@
+---
+name: jev-decide
+description: Use jev-service typed decisions (choice/noul/numeric with probabilities) for Agent-System governance classification. Use when choosing task tier, validation level, reject-code routing, or other closed-enum judgments.
+---
+
+# jev-decide（治理决策）
+
+依赖 MCP 服务器 `jev`（[`scripts/mcp/jev-mcp.mjs`](../../../scripts/mcp/jev-mcp.mjs)）。凭证在本机 `~/.secrets/jev/`（`api.key`、`base-url`），**禁止**写入仓库、commit 或聊天。
+
+## 何时用
+
+输入是情境文本、输出是**封闭枚举 / yes-no / 分桶数值**时调用 `jev_decide`，例如：
+
+| 决策点 | 建议 questions |
+|---|---|
+| 任务分级（是否开 worktree） | `choice`：`info_reply` / `single_task` / `cross_module` |
+| 验证层级（验证契约） | `choice`（可多题）：`doc` / `script` / `go` / `frontend` / `migration` / `product_pi` |
+| 拒绝码处置 | `choice`：`reconcile` / `re_snapshot` / `fix_record_id` / `request_capability` / `abort` |
+| 是否 blocker / 是否触碰重验面 | `noul` |
+
+不适合：需要解释链、多步规划、自由文本生成——那些走大模型或 agentctl 确定性门禁。
+
+## 调用约定
+
+1. 可选先 `jev_health`；失败则本机判断，勿阻塞写路径。
+2. `jev_decide`：同一情境的多问合成一次请求。
+3. 问句**正向措辞**，避免双重否定。
+4. 置信度路由：
+   - `confidence >= 0.9` 且 top1−top2 ≥ 0.15 → 可采用
+   - 否则 → agent 自行按规范裁定，把 jev 结果当参考
+5. 401/超时/`answers.*.error` → 降级到本机判断；勿把决策失败变成业务失败。
+
+## 示例（任务分级）
+
+```json
+{
+  "context": "用户请求：给 CURRENT 加一行认领说明，不改代码",
+  "questions": {
+    "tier": {
+      "type": "choice",
+      "question": "This request matches which AGENTS task tier?",
+      "options": ["info_reply", "single_task", "cross_module"]
+    },
+    "needs_worktree": {
+      "type": "noul",
+      "question": "Does this require a new feature/fix worktree?"
+    }
+  }
+}
+```
+
+权威矩阵仍以 [AGENTS.md](../../../AGENTS.md)、[验证契约](../../../.doc/ops/2026-09-21-validation-contract.md) 为准；jev 只加速封闭枚举分类，不替代机器门禁（admit/hooks/docs apply）。

.cursor/skills/pi-subagent-dispatch/SKILL.md

@@ -0,0 +1,87 @@
+---
+name: pi-subagent-dispatch
+description: Dispatch gmktec PI analysis/review/test subagents via project MCP pi-subagents (roles/run/result). Use when delegating research, planning, reviews, diagnosis, test_run, acceptance_check, or report work—not for code implementation.
+---
+
+# PI Subagent 派发
+
+权威：[模型配置](../../../.doc/ops/2026-09-24-subagent-model-config.md)、[执行器说明](../../../.doc/ops/2026-09-24-pi-subagent-executor.md)、[流程规范](../../../.doc/ops/2026-09-24-subagent-workflow-standard.md)。客户端规则：[pi-subagents](../../rules/pi-subagents.mdc)。阶段落盘：[subagent-stage-record](../subagent-stage-record/SKILL.md)。
+
+**Cursor Auto 独占代码实施与修复**；本 skill 只走本机 PI 子任务。
+
+## 调用序列
+
+1. `pi_subagent_roles` — 只读预览角色/模型（不调 PI）。
+2. 选 `role_id`（research → planning → reviews → diagnosis → test_run / acceptance_check → report）。
+3. （推荐）`agentctl pi packet` 生成派发包；**不**触发 run：
+   ```bash
+   python3 -B scripts/agentctl.py pi packet \
+     --task "$ID" --role research \
+     --goal '…' --authorization-ref 'user:…' \
+     --source-sha "$(git rev-parse HEAD)" \
+     [--input-file …] [--approved-command '…']… \
+     --request-id "$RID" --write
+   # → .doc/test-reports/assets/pi-subagents/<task>/<request>/packet.json
+   ```
+4. `pi_subagent_run` — 按 packet 字段在 agentctl 租约下异步启动。
+5. `pi_subagent_result` — 取回收据；轮询至终态。
+
+CLI 等价：`python3 -B scripts/pi_subagents.py roles|run|result`；`run` 必须包在 `agentctl with --resource path:.doc/test-reports/assets/pi-subagents/<task>/<request>` 内。
+
+## 请求字段（MCP `pi_subagent_run`）
+
+外层：`worktree`（已登记任务工作区绝对路径）、`task_id`、`request` 对象。
+
+`request` 必填：
+
+| 字段 | 约束 |
+|---|---|
+| `role_id` | 配置 §3 中 enabled 角色 |
+| `request_id` | 任务内稳定唯一；同参重放不重复调模型 |
+| `goal` | 具体目标；子任务不依赖主会话未传入历史 |
+| `authorization_ref` | 可回链真实用户授权，禁止日志自授 |
+| `source_sha` | **完整** 40-hex 提交；禁止 `HEAD`/分支名/短 hash |
+| `input_files` | 已跟踪 UTF-8 普通文件相对路径数组 |
+| `timeout_seconds` | 正整数 |
+
+测试角色（`test_run` / `acceptance_check`）另需：
+
+- `approved_commands`：argv 数组的数组（如 `[["go","test","-short","./"]]`）
+- `plan_digest`：外部已批准计划的 SHA-256 hex
+
+禁止静默 `model_override`；临时改模型写任务 override 并说明用户来源。
+
+## 租约与输出
+
+- 资源：`path:.doc/test-reports/assets/pi-subagents/<task_id>/<request_id>`
+- 产物：`receipt.json`、`report.md`、命令日志（同目录）
+- 裸调 `run`（无租约）被拒绝
+
+## 状态分离（红线）
+
+| 字段 | 含义 |
+|---|---|
+| `run_status` | running / succeeded / failed / cancelled / unknown |
+| `verdict` | pass / changes_required / blocked / not_applicable |
+| `review_state` | 阶段门禁；模型 succeeded **仅** pending |
+
+测试 `commands_passed`/`pass` 只针对批准命令证据，不能直接赋给任务 `acceptance`。
+
+## 常见拒绝码（执行器权威）
+
+| 码 | 处置 |
+|---|---|
+| `INVALID_SOURCE_SHA` | 换完整提交 hash |
+| `APPROVED_COMMANDS_REQUIRED` | 补 approved_commands + plan_digest |
+| `MINIMAX_ROLE_FORBIDDEN` | 不把 M3 用于关键角色 |
+| `INPUT_NOT_TRACKED` / `PATH_OUT_OF_SCOPE` | 收窄 input_files |
+| `CONCURRENCY_LIMIT` | 串行或等空闲槽 |
+| `ORPHAN_RUNNING` | 先核进程/副作用，勿盲目重派 |
+
+Cursor hooks 对形状错误可能 `permission=ask`（advisory）；**硬拒绝以执行器为准**。
+
+## 禁止
+
+- 把 implementation 派给 PI
+- 自动换模型 / 伪造 lease / 递归把本修复再派给 PI worker
+- 用模型叙事冒充 PASS；审查结论须带回报告路径与 receipt 字段

.cursor/skills/subagent-stage-record/SKILL.md

@@ -0,0 +1,56 @@
+---
+name: subagent-stage-record
+description: Record PI/Cursor stage handoffs using the subagent stage template (dispatch packet, return, S0–S9 receipt, R-AC-T mapping). Use after PI results, before gate advances, or when closing a multi-stage task.
+---
+
+# Subagent 阶段记录
+
+权威模板：[subagent-stage-record.md](../../../.doc/ops/templates/subagent-stage-record.md)；流程：[协作规范](../../../.doc/ops/2026-09-24-subagent-workflow-standard.md)。派发入口：[pi-subagent-dispatch](../pi-subagent-dispatch/SKILL.md)。
+
+原则：**一步一记录，不必一步一文件**。小任务可把适用段落并入任务主文档；跨模块才拆独立审查/测试/验收证据。
+
+## 何时写
+
+- 每次 `pi_subagent_run` 前后：派发包 + 回传
+- 阶段门禁推进前：S0–S9 收据行
+- 收口前：R→AC→改动→审查→T→运行验收映射
+
+## 派发包（最小字段）
+
+复制到任务文档并填实值：
+
+- `parent_task_id` / `subtask_id` / `stage_id` / `role_id`
+- 配置路径 / `config_revision` / `config_sha256`（来自 roles 或 receipt）
+- 解析后的 provider/model；任务 override 与用户来源
+- 目标、非目标、授权来源、交付终点
+- 输入版本：R-ID / AC-ID / 方案版本 / `base_sha` / `head_sha` 或 `source_sha`
+- cwd / branch / allowed_paths / 只读或写入 / mutex
+- 完成条件、输出路径、预算与异常处理
+
+## 子任务回传
+
+- PI `run_id` / producer / 起止时间
+- `configured_model` / `actual_model`（不可观察填 `unknown`）
+- `run_status` 与 `verdict` **分列**（不得把退出成功当质量通过）
+- 结论与依据、证据链接、脱敏范围
+- 未覆盖项、风险、遗留进程/产物、接管建议
+
+只读子 Agent 结论由主 Agent 转存时：保留 `agent_id` 与原结论，注明「由主 Agent 转存」。
+
+## 阶段收据表
+
+| 阶段 | 输入版本 | 产物/证据 | producer | reviewer/独立性 | 决定 | 下一步 |
+|---|---|---|---|---|---|---|
+| S0–S9 适用项 | | | | independent / self_review / not_required | pass / changes_required / blocked / not_applicable | |
+
+未执行阶段写 `not_applicable` + 原因。报告存在不自动满足门禁。
+
+## 需求追踪
+
+| R-ID | AC-ID | 改动/版本 | 审查 | T-ID / 结果 | 运行验收 | acceptance_owner |
+|---|---|---|---|---|---|---|
+| | | | | | | |
+
+## 与任务五态
+
+继续用任务模板的 `status`、`review_state`、`integration_state`、`deployment`、`cleanup`、`remote_sync`；额外记 `phase`、`acceptance`、待回收 `subtask_id`。`done` 取决于授权交付终点，不因会话结束自动完成。

.doc/README.md

@@ -11,10 +11,10 @@
 .doc/
   README.md              ← 本文件（总地图）
   status/                ← 模块/功能完成度 SSOT
-  audit/                 ← 问题发现与分析
+  audit/                 ← 问题发现与分析、ISSUES.md 问题/修复台账
   remediation/           ← 整改方案与发布缺口
   archive/               ← 历史（只增不删）
-  ops/                   ← 活协作（任务、交接、调研）
+  ops/                   ← 活协作（任务、交接、调研；lessons/ 开发经验）
   system-design/         ← 模块架构深读
   adr/                   ← 架构决策
   backlog/               ← 产品 backlog（非阻塞）
@@ -33,13 +33,21 @@
 
 | 我要… | 读这里 |
 |--------|--------|
+| Subagent 模型配置 / 流程 | [可调整模型配置](ops/2026-09-24-subagent-model-config.md) · [PI 执行器](ops/2026-09-24-pi-subagent-executor.md) · [流程草案](ops/2026-09-24-subagent-workflow-standard.md) · [研究依据](audit/2026-09-24-subagent-workflow-research.md) |
+| 规则来源/生效版本 | [规范登记](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) |
+| 问题历史、修复经过 | [问题台账](audit/ISSUES.md) · [闭环规范](ops/2026-09-23-issue-learning-workflow.md) |
+| 开发注意事项与经验检索 | [经验索引](ops/lessons/INDEX.md) |
 | 审计/问题分析 | [audit/INDEX.md](audit/INDEX.md) |
 | 整改方案 | [remediation/INDEX.md](remediation/INDEX.md) |
 | 历史归档 | [archive/README.md](archive/README.md) |
 | 架构设计 | [system-design/README.md](system-design/README.md) |
+| 用错误码定位失败 | [错误码目录](system-design/2026-09-28-error-code-catalog.md) |
 | 测试报告 | [test-reports/](test-reports/) |
 | 历史功能设计 | [archive/design/superpowers/](archive/design/superpowers/) |
 | Herdr 角色、审批与备援 | [ops/2026-09-13-herdr-agent-roster.md](ops/2026-09-13-herdr-agent-roster.md) |
@@ -57,9 +65,13 @@
 
 ## 文档生命周期
 
+按 [AGENTS 任务分级](../AGENTS.md#2-任务分级与授权) 选择最小产物。下图是可选信息流，不要求每任务创建所有文件；小任务/有价值的只读审查可由一个主文档承载范围、结论、验证与交接。主文档先明确 task_id、owner、授权来源、状态和证据；跨阶段信息确需独立时才拆分并回链。
+
 ```text
 audit（问题）→ remediation（方案）→ ops/short-term（任务）
   → test-reports（验收）→ archive（关闭证据）
 ```
 
-状态字段：`planned | in_progress | blocked | done | cancelled`
+任务状态字段：`planned | in_progress | blocked | done | cancelled`。问题以 issue_state、经验以 lesson_state 独立记录，取值与转换见 [闭环规范](ops/2026-09-23-issue-learning-workflow.md)；研究任务完成不关闭待修问题。
+
+会话结束不等于任务完成；只有 done/cancelled 任务归档。CURRENT 保留最多 3 项焦点及活跃/阻塞/待集成/待清理事项，完成认领和长证据迁入 [历史快照](archive/ops/2026-09-21-current-history.md)。移动文档同步修复相对链接，保留证据与来源。规范生命周期另用 proposed/approved/active/deprecated；工具能力另用 manual/enforced。

.doc/adr/2026-09-14-final-artifact-vault.md

@@ -0,0 +1,25 @@
+# ADR：最终成果保险库（FAV）
+
+## 状态
+
+已接受（2026-09-14，落地计划 V0–V6）
+
+## 背景
+
+运行库 PostgreSQL 与 workspace 投影会一起丢失或错挂。需要独立保存**已确认终态**的精确字节，但不能成为第三套完整业务真相源，也不能用目录扫描猜测“最终文件”。
+
+## 决策
+
+1. **三层权威**：PostgreSQL 管项目/权限/工作流/版本关系；workspace 是可清理投影；FAV 只对已归档 payload、manifest、来源证据和删除状态权威。
+2. **无 tenant_id**：安全边界沿用 `environment + project_members + role-admin`。未来组织层另立 ADR。
+3. **事件准入**：只接受方案准入表中的数据库事实。显式 publish/pin 不能绕过终态 allowlist。禁止扫描 workspace。
+4. **同事务冻结**：终态事务把精确 payload/SHA 写入 staging 并写 unpublished outbox；publisher 不得重读可变消息行。
+5. **union-deny 删除**：运行库删除账本或 vault tombstone 任一侧删除即拒绝读取/恢复。
+6. **恢复**：只进 scratch 库，默认 `recover-as-collection`。禁止 GET 自动写回或覆盖现有 head。
+7. **互补**：FAV、migration corpus、完整 DB backup/PITR 互相不能替代。不作为 409/split-brain 绕行。
+
+## 后果
+
+- 实现从 `feature/final-artifact-vault` 推进；mutex=`artifact-vault`。
+- Goose 从 **00034** 增加 FAV 表（00033 已被 task-run 治理占用）。
+- 降级读取默认关闭（`FAV_DEGRADED_READ`），Unit A 纠挂完成前不得对现网开启。

.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-16-software-project-bootstrap-keys.md

@@ -0,0 +1,85 @@
+# ADR：纯软件工作流 key 与领域边界（SWBOOT-00）
+
+## 状态
+
+已接受（2026-09-16）
+
+## 背景
+
+工作流引擎已声明 `non_medical_software` 产品域，但正式目录、创建入口与模板仍以医疗器械三工作流（`main` / `product_manager` / `test_manager`）为硬编码白名单。继续复用医疗 manifest 会造成临床/注册/CDO 语义污染；直接改写既有三 key 会破坏已激活医疗实例。
+
+详细设计见 [software-project-bootstrap-workflow](../system-design/2026-09-14-software-project-bootstrap-workflow.md)。
+
+## 决策
+
+### 1. 新增正式可选工作流 key
+
+| key | 定位 | 默认产品域 | 可重复实例 |
+|-----|------|------------|------------|
+| `software_bootstrap` | 一次性建立项目事实、需求、架构、风险、路线与验证基线 | `non_medical_software` | 否（默认一次；终止后可重建并保留旧证据） |
+| `software_delivery` | 按里程碑/发布重复交付，承接 change brief → 证据 → 验证 → 发布 → 复盘 | `non_medical_software` | 是 |
+
+医疗三 key **保持不变**，仍为正式可选；不得在其 published hash 上替换为软件语义。
+
+### 2. 目录策略：published + selectable，而非“仅三 key”
+
+项目可选工作流 = 已发布 (`latest_published_version > 0`) ∩ `project_selectable=true` ∩ 策略白名单。
+
+白名单扩展为：
+
+```text
+main | product_manager | test_manager | software_bootstrap | software_delivery
+```
+
+固定文档数量校验 **仅** 继续约束医疗三 key；软件工作流按 manifest 自身完整性校验，不强制医疗文档数。
+
+### 3. 领域与合规分离
+
+- `product_domain=non_medical_software` 只说明非医疗器械，不关闭鉴权/审计/安全基线。
+- `compliance_profile` / `governance_profile` / `execution_mode` / `team_mode` 为项目级独立字段。
+- 首期默认：`governance=standard`，`compliance=internal_control+security_baseline`，`execution_mode=docs_only`。
+- `controlled_patch` 在 SWBOOT-10 受控执行器就绪前 **不可真正启用**；仅保留 allowlist stub。
+
+### 4. 串联而非回环
+
+```text
+software_bootstrap（完成 + 创建者确认）
+  → 仅建议 software_delivery
+  → 创建者确认后新建 planning/激活实例
+```
+
+bootstrap 完成不得自动创建或激活 delivery。
+
+### 5. Solo 审批策略（契约）
+
+- `collaborative`：独立三权（author/reviewer/approver 不同人）。
+- `solo`：`creator_acknowledgement`；页面与审计持续标注“未独立评审”。
+- `controlled` 或要求独立审查的 compliance profile：**禁止 solo**。
+
+### 6. 错误码（首期）
+
+| code | 含义 |
+|------|------|
+| `ERR_WORKFLOW_NOT_SELECTABLE` | key 不在正式可选白名单或未 published |
+| `ERR_DOMAIN_INCOMPATIBLE` | 工作流与项目 `product_domain` / `project_type` 不兼容 |
+| `ERR_COMPLIANCE_PROFILE` | 合规配置非法或与治理冲突（如 controlled+solo） |
+| `ERR_EXECUTION_MODE_DISABLED` | 请求 `controlled_patch` 但受控执行器未启用 |
+| `ERR_REPO_PATH_NOT_ALLOWLISTED` | 仓库路径不在管理员 allowlist（SWBOOT-10 stub） |
+| `ERR_CREATION_PREVIEW_STALE` | creation token / plan_hash 过期或不匹配（409） |
+
+### 7. 运行时权威不变
+
+继续遵守 [workflow-runtime-authority](./2026-09-12-workflow-runtime-authority.md)：任务只能从冻结 `doc_task_instance` 启动；禁止客户端 `task_key`/duty/stage 旁路。
+
+## 后果
+
+- Bootstrap seed 与 catalog API 必须同时暴露软件两 key，且按 `product_domain` 过滤时不把医疗默认话术塞进软件项目。
+- 项目表 additive 增加 `project_type_key` / `compliance_profile_key` 等字段；旧项目不自动分类为医疗或软件。
+- SWBOOT-10 仅落地 allowlist stub：任何真实 patch/merge/push 必须 fail closed，直到独立 Epic 验收。
+- 医疗三工作流黄金用例与固定文档数门禁保持回归基线。
+
+## 关联
+
+- 实施任务：`.doc/ops/short-term/2026-09-16-software-project-bootstrap.md`
+- Backlog：`.doc/ops/long-term/2026-09-14-software-project-bootstrap-implementation.md`
+- 验收清单：`.doc/ops/checklists/2026-09-14-software-project-bootstrap-acceptance.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-16-wave2-real-pi-evidence.md

@@ -0,0 +1,30 @@
+---
+title: "Wave 2 PU4 真实 PI 补证（U8 + full/none）"
+status: done
+created: 2026-09-16
+updated: 2026-09-16
+owner: Cursor
+branch: feature/wave2-real-pi-evidence
+worktree: "-"
+mutex: intent-plan
+---
+
+# Wave 2 PU4 真实 PI 补证（U8 + full/none）
+
+## 目标
+
+补齐 multi-intent U8 与工作流 full/none 的真实 PI / PG / 跨用户 / 恢复证据。
+
+## 步骤
+
+1. [x] 认领 + 占槽 rebuild
+2. [x] U8 live 证据路径
+3. [x] full/none 混合长链 live 测试
+4. [x] 报告 + 矩阵更新 + 释放槽位
+
+## 验收标准
+
+- [x] U8 真实 PI PASS
+- [x] full 跨用户审批 PASS
+- [x] none 免审批且不阻塞 PASS
+- [x] 报告归档 `.doc/test-reports/2026-09-16-wave2-real-pi-evidence-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-policy-review.md

@@ -0,0 +1,47 @@
+---
+title: "Agent 规范整体审查"
+status: done
+created: 2026-09-21
+updated: 2026-09-21
+owner: Codex
+branch: feature/agent-policy-review
+worktree: .worktrees/agent-policy-review
+base_dev_sha: a241e838150f218f3a09d3523f93291b847d45fd
+write_scope: [.doc/ops/short-term/2026-09-21-agent-policy-review.md, .doc/archive/ops/2026-09-21-agent-policy-review.md, .doc/audit/2026-09-21-agent-policy-review.md, .doc/ops/CURRENT.md]
+mutex: agent-policy-review
+deployment: not_required
+cleanup: retained-with-reason
+---
+
+# Agent 规范整体审查
+
+## 目标与范围
+
+评估生效规范的可完善之处，形成有依据的新增、删除、修改清单。本轮使用 ce-doc-review 的只读审查流程；不修改 AGENTS/PROJECT/客户端规则，不实现锁管理或改业务代码。
+
+## 已确定约束
+
+- 全部新增修改使用 .worktrees；主目录留给 dev 集成与运行。
+- 锁先统一入口/提交门禁防误改，OS 权限隔离后续实施。
+- 审查不等于实现或部署授权；已有未合入规范收口和 .locks 方案保留原分支。
+
+## 步骤
+
+1. [x] 启动链、当前 Git、规范与模板盘点。
+2. [x] 一致性、可执行性、范围、安全及故障场景复核。
+3. [x] 核实保留发现，形成增删改建议与实施优先级。
+4. [x] 文档校验、归档、本地提交。
+
+## 验收
+
+- 每条保留发现有当前源文件或明确缺失证据、实际后果和建议修改。
+- 区分已生效规则、尚待实现工具和未合入草案；不把建议当现状。
+- 未修改主目录跟踪文件、运行锁、服务或用户数据。
+
+## 结果与交接
+
+- [整体审查](../../audit/2026-09-21-agent-policy-review.md)：10 组增删改建议、2 项安全观察；保留已确定的 worktree 与 L1-first 选择。
+- 五个独立会话内视角已返回；主审核对引用与实际命令/脚本。文档原规则未改，自动化未实施。
+- 检查项：新增文档相对链接、git diff --check；未运行产品测试，不作运行验收声明。
+- 本任务 CURRENT 快照标 done，未占共享集成槽位；本地分支保留供审核，未合入 dev、未 push。
+- 需要执行修改时先按第一批消除冲突，再处理减负及既有工具实现；不要将本报告直接视为已生效规则。

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

@@ -0,0 +1,43 @@
+---
+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
+---
+
+# 采纳 Agent worktree 工作规范
+
+## 授权与范围
+
+用户于 2026-09-21 确认“提交吧，之后按这套执行”。延续原治理任务，在原 dev 派生的独立 worktree 内将方案采纳为生效规则，提交并合入本地 dev。仅修改规范、模板和治理记录。
+
+本次不将 W1–W4 的自动化开发宣称已完成；它们保留在实施任务中。主目录仍有其他任务未提交改动，使用临时集成 worktree 合入纯文档，不迁移原任务、不改变业务运行态、不 push。
+
+## 步骤
+
+1. [x] 核对主目录现场、原方案提交与集成槽位。
+2. [x] 同步 AGENTS、PROJECT、Cursor 规则、操作规范与模板。
+3. [x] 文档检查、提交、独立 worktree 合入 dev。
+4. [x] 更新验收/交接及清理状态。
+
+## 验收
+
+- [x] 单 Agent 主目录开发例外已移除，生效规则可从启动链发现。
+- [x] 创建明确来自 dev；测试提交、共享服务串行、部署及安全清理条件可执行。
+- [x] 自动化能力保持 planned；主目录其他任务未提交改动不被纳入提交。
+- [x] 本地 dev 含本次规范提交；未 push，未重建服务。
+
+## 相关链接
+
+- [方案](../../remediation/2026-09-21-agent-workflow-governance-plan.md)
+
+## 结果
+
+- 规则提交 `048bbe4a`，验证的合并候选及首次 dev 合入 `83e22a70`。
+- [文档验收](../../test-reports/2026-09-21-agent-workflow-governance-adoption-test-report.md)。
+- 主目录旧任务保留；临时 dev 集成工作区保留到原 owner 可安全切回 dev，见 [交接](../../ops/handoffs/2026-09-21-agent-workflow-governance-plan.md)。
+- 收口提交合入后普通清理本任务和候选工作区，实际结果记录共同 Git 目录的治理操作收据。未 push；deployment=not_required。

.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-16-matrix-deep-test-promote-test.md

@@ -0,0 +1,49 @@
+---
+title: "FEATURE-MATRIX 深度测试 + 晋升部署 test"
+status: done
+created: 2026-09-16
+updated: 2026-09-16
+owner: Cursor-Auto
+branch: feature/matrix-deep-test-promote-test
+worktree: "-"
+mutex: infra
+---
+
+# FEATURE-MATRIX 深度测试 + 晋升部署 test
+
+## 目标
+
+按 FEATURE-MATRIX 对已实现模块做分层深度回归，通过后将本地 `dev` 晋升到 `test`（`rc-v1.0.0-beta.2`）并 rebuild/冒烟 `:8081`。
+
+## 范围
+
+- Wave 1：vet/short/arch/npm/bundle + 模块定向 + 隔离治理 PG
+- Wave 2：dev `:8080` live API 抽检
+- Wave 3：真实 PI 抽样（失败再升格三链）
+- Wave 4：`dev` → `test` + rebuild + smoke
+- Wave 5：测试报告 + SSOT
+
+## 非目标
+
+- 不实现纯软件项目自举
+- 不默认 28min 三工作流 PI；不合 `main`；不改项目 143；不启用 FAV
+
+## 步骤
+
+1. [x] 认领占槽
+2. [x] 自动化深度回归
+3. [x] live `:8080` 抽检
+4. [x] PI 抽样
+5. [x] 晋升 test 并冒烟
+6. [x] 报告与归档
+
+## 验收标准
+
+- [x] 矩阵已实现行均有 PASS 证据
+- [x] `:8081` health/ready schema=47；`test-env-smoke.sh` PASS
+- [x] tag `rc-v1.0.0-beta.2`；报告归档
+
+## 相关链接
+
+- Plan: matrix_deep_test_promote
+- FEATURE-MATRIX / CURRENT / gap-matrix

.doc/archive/ops/short-term/2026-09-16-production-ready-gates.md

@@ -0,0 +1,47 @@
+---
+title: "发布门禁闭环 → production_ready"
+status: done
+created: 2026-09-16
+updated: 2026-09-16
+owner: Cursor-Auto
+branch: docs/production-ready-flip
+worktree: "-"
+mutex: ci
+---
+
+# 发布门禁闭环 → production_ready
+
+## 目标
+
+按 gap-matrix 发布门禁勾选 B1–B4，对齐环境 schema 后翻 `production_ready=yes`。
+
+## 范围
+
+- B1 CI TEST_DATABASE_URL + 治理 PG（已完成）
+- B2 真实 PI 三工作流 E2E（已完成）
+- B3 对话全链路恢复（已完成）
+- B4 版本冲突/终止 preview（已完成）
+- B5 SSOT 翻旗 + main schema 对齐（已完成）
+
+## 非目标
+
+- 多意图 U9–U12、软件项目自举、FAV、完整 PI change-report 叙事
+
+## 步骤
+
+1. [x] B1 BUG-08
+2. [x] B2 PI E2E
+3. [x] B3 chat refresh + restart
+4. [x] B4 conflict + termination-preview + envelope unwrap
+5. [x] B5 merge/smoke、main rebuild 迁库、翻旗
+
+## 验收标准
+
+- [x] gap 门禁四框可勾（含对话与前端）
+- [x] FEATURE-MATRIX / gap / CURRENT `production_ready: yes`
+- [x] main/dev/test health schema_version=47
+
+## 相关链接
+
+- Test reports: `2026-09-16-ci-governance-pg-bug08`、`pi-three-workflow-e2e`、`chat-refresh-gate`、`frontend-gate-b4`
+- gap-matrix / FEATURE-MATRIX / CURRENT

.doc/archive/ops/short-term/2026-09-16-wave2b-nightly-promotion-receipt.md

@@ -0,0 +1,48 @@
+---
+title: "Wave 2B PU5B：nightly PI + promotion receipt"
+status: done
+created: 2026-09-16
+updated: 2026-09-16
+owner: Cursor
+branch: feature/wave2b-nightly-promotion-receipt
+worktree: "-"
+mutex: ci
+---
+
+# Wave 2B PU5B：nightly PI + promotion receipt
+
+## 目标
+
+落地夜间真实 PI 回归入口、不可变 promotion receipt，以及晋升脚本强制校验；same-image digest 晋升本轮仅做到 same-commit + digest 可追溯。
+
+## 范围
+
+- promotion receipt 写/校验 + waiver
+- nightly-real-pi.yml + run-nightly-real-pi.sh
+- git-workflow-helper / promote-to-test / release-to-main 门禁钩子
+- 报告与 FEATURE-MATRIX / remediation 同步
+
+## 非目标
+
+- compose 按 digest pull 的同镜像晋升流水线
+- Playwright 双标签；升 MULTI_INTENT tier
+
+## 步骤
+
+1. [x] 认领 + 开分支
+2. [x] receipt 写/校验脚本
+3. [x] nightly workflow + 本机脚本
+4. [x] 晋升钩子
+5. [x] 报告 + 合入 dev
+
+## 验收标准
+
+- [x] 缺 secret/runner → infra_fail，晋升拒绝
+- [x] product_fail → 晋升拒绝
+- [x] pass receipt → 晋升可过；无 receipt → 非零退出
+- [x] 报告归档（`.doc/test-reports/2026-09-16-wave2b-nightly-promotion-receipt-test-report.md`）
+
+## 相关链接
+
+- Remediation PU5B: `../../remediation/2026-09-16-feature-matrix-production-readiness-plan.md`
+- Test report: `../../test-reports/2026-09-16-wave2b-nightly-promotion-receipt-test-report.md`

.doc/archive/ops/short-term/2026-09-16-wave2c-same-image-digest.md

@@ -0,0 +1,41 @@
+---
+title: "Wave 2C：同 digest 镜像晋升"
+status: done
+created: 2026-09-16
+updated: 2026-09-16
+owner: Cursor
+branch: feature/wave2c-same-image-digest
+worktree: "-"
+mutex: infra
+---
+
+# Wave 2C：同 digest 镜像晋升
+
+## 目标
+
+候选 commit 一次构建；test/main 按 receipt digests 启动；pinned 禁止 rebuild 另造镜像。
+
+## 范围
+
+- candidate-images-build/apply
+- compose + env-service pinned
+- promote/release 钩子 + receipt --require-digests
+- nightly digests 对齐
+
+## 非目标
+
+- 远程 registry；升 tier；Playwright；U8 quality_failed（Phase 3）
+
+## 步骤
+
+1. [x] 认领 + 开分支
+2. [x] build/apply + check digests
+3. [x] compose/env-service/hooks
+4. [x] nightly align
+5. [x] 报告合入
+
+## 验收标准
+
+- [x] PASS receipt 含 digests；apply 后 ID 一致
+- [x] pinned rebuild 不换 ID（env-service 拒绝 --build）
+- [x] 缺 digest 拒绝晋升

.doc/archive/ops/short-term/2026-09-16-wave3-pu6-pu8-go-no-go.md

@@ -0,0 +1,26 @@
+---
+title: "Wave 3 PU6–PU8 go/no-go 文档任务"
+status: done
+created: 2026-09-16
+updated: 2026-09-16
+owner: Cursor
+branch: feature/wave3-pu6-pu8-go-no-go
+worktree: "-"
+mutex: architecture-docs
+---
+
+# Wave 3 PU6–PU8 go/no-go 文档任务
+
+## 目标
+
+完成 PU6–PU8 产品 go/no-go 记录与获批后契约；未获批不实施。
+
+## 步骤
+
+1. [x] 调研 go/no-go 总文
+2. [x] PU6–PU8 / U9–U12 契约
+3. [x] 勾 DoD + 矩阵/CURRENT 同步 + 合入
+
+## 相关链接
+
+- Research: `../research/2026-09-16-wave3-pu6-pu8-go-no-go.md`

.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-13-document-revision-active-doc-routing.md

@@ -1,13 +1,16 @@
 ---
 title: "当前受控文档改写被领域关键词改路由到另一交付物"
-status: in_progress
+status: done
 created: 2026-09-13
-updated: 2026-09-13
+updated: 2026-09-22
 severity: high
 ---
 
 # 当前受控文档改写被领域关键词改路由到另一交付物
 
+> **W3 UI-rerun 关闭（2026-09-22）**：`status=done`。真实 Playwright 账本 PASS：[`ui-acceptance-results.json`](../test-reports/assets/2026-09-22-docrev-ui-rerun/ui-acceptance-results.json)（main UI-00..16）+ [`ui-acceptance-results-post-restart.json`](../test-reports/assets/2026-09-22-docrev-ui-rerun/ui-acceptance-results-post-restart.json)（UI-15）。任务 tip 已合入本地 `dev`；详见 [short-term](../ops/short-term/2026-09-22-docrev-ui-rerun.md) 与 [测试报告](../test-reports/2026-09-22-docrev-ui-rerun-test-report.md)。
+
+
 ## 现象
 
 第二轮真实 UI（schema 30）**UI-05 首个失败**：

.doc/audit/2026-09-13-document-revision-block-selector.md

@@ -1,13 +1,16 @@
 ---
 title: "UI-06 用 overlay/p/h 选择器找不到真实文档块"
-status: in_progress
+status: done
 created: 2026-09-13
-updated: 2026-09-13
+updated: 2026-09-22
 severity: high
 ---
 
 # UI-06 用 overlay/p/h 选择器找不到真实文档块
 
+> **W3 UI-rerun 关闭（2026-09-22）**：`status=done`。真实 Playwright 账本 PASS：[`ui-acceptance-results.json`](../test-reports/assets/2026-09-22-docrev-ui-rerun/ui-acceptance-results.json)（main UI-00..16）+ [`ui-acceptance-results-post-restart.json`](../test-reports/assets/2026-09-22-docrev-ui-rerun/ui-acceptance-results-post-restart.json)（UI-15）。任务 tip 已合入本地 `dev`；详见 [short-term](../ops/short-term/2026-09-22-docrev-ui-rerun.md) 与 [测试报告](../test-reports/2026-09-22-docrev-ui-rerun-test-report.md)。
+
+
 ## 现象
 
 第六轮真实 UI（schema 30）：

.doc/audit/2026-09-13-document-revision-duty-cell-assertion.md

@@ -1,13 +1,16 @@
 ---
 title: "UI-13a 用整行 option 文案误判编制负责人"
-status: in_progress
+status: done
 created: 2026-09-13
-updated: 2026-09-13
+updated: 2026-09-22
 severity: high
 ---
 
 # UI-13a 用整行 option 文案误判编制负责人
 
+> **W3 UI-rerun 关闭（2026-09-22）**：`status=done`。真实 Playwright 账本 PASS：[`ui-acceptance-results.json`](../test-reports/assets/2026-09-22-docrev-ui-rerun/ui-acceptance-results.json)（main UI-00..16）+ [`ui-acceptance-results-post-restart.json`](../test-reports/assets/2026-09-22-docrev-ui-rerun/ui-acceptance-results-post-restart.json)（UI-15）。任务 tip 已合入本地 `dev`；详见 [short-term](../ops/short-term/2026-09-22-docrev-ui-rerun.md) 与 [测试报告](../test-reports/2026-09-22-docrev-ui-rerun-test-report.md)。
+
+
 ## 现象
 
 第16轮真实 UI（schema 30，`dev@dd5671e`）：UI-00 至 UI-12 PASS；分类导航修复已实证，UI-13a 已能从「我的私密」切回「流程受控」并打开 reviewer B 权限矩阵。

.doc/audit/2026-09-13-document-revision-duty-etag-overwrite.md

@@ -1,13 +1,16 @@
 ---
 title: "文档职责伪造与保存时重取 ETag 可覆盖并发正文"
-status: in_progress
+status: done
 created: 2026-09-13
-updated: 2026-09-13
+updated: 2026-09-22
 severity: critical
 ---
 
 # 文档职责伪造与保存时重取 ETag 可覆盖并发正文
 
+> **W3 UI-rerun 关闭（2026-09-22）**：`status=done`。真实 Playwright 账本 PASS：[`ui-acceptance-results.json`](../test-reports/assets/2026-09-22-docrev-ui-rerun/ui-acceptance-results.json)（main UI-00..16）+ [`ui-acceptance-results-post-restart.json`](../test-reports/assets/2026-09-22-docrev-ui-rerun/ui-acceptance-results-post-restart.json)（UI-15）。任务 tip 已合入本地 `dev`；详见 [short-term](../ops/short-term/2026-09-22-docrev-ui-rerun.md) 与 [测试报告](../test-reports/2026-09-22-docrev-ui-rerun-test-report.md)。
+
+
 ## 现象
 
 静态审查与 E2E UI-13 路径暴露两类产品缺陷：

.doc/audit/2026-09-13-document-revision-e2e-reject-routing.md

@@ -1,13 +1,16 @@
 ---
 title: "UI-05b 缺当前受控文档指示语被路由到 feasibility_reg"
-status: in_progress
+status: done
 created: 2026-09-13
-updated: 2026-09-13
+updated: 2026-09-22
 severity: high
 ---
 
 # UI-05b 缺当前受控文档指示语被路由到 feasibility_reg
 
+> **W3 UI-rerun 关闭（2026-09-22）**：`status=done`。真实 Playwright 账本 PASS：[`ui-acceptance-results.json`](../test-reports/assets/2026-09-22-docrev-ui-rerun/ui-acceptance-results.json)（main UI-00..16）+ [`ui-acceptance-results-post-restart.json`](../test-reports/assets/2026-09-22-docrev-ui-rerun/ui-acceptance-results-post-restart.json)（UI-15）。任务 tip 已合入本地 `dev`；详见 [short-term](../ops/short-term/2026-09-22-docrev-ui-rerun.md) 与 [测试报告](../test-reports/2026-09-22-docrev-ui-rerun-test-report.md)。
+
+
 ## 现象
 
 第五轮真实 UI（schema 30）**UI-05b 首个失败**：

.doc/audit/2026-09-13-document-revision-editor-hydration-race.md

@@ -1,13 +1,16 @@
 ---
 title: "UI-06 编辑弹窗打开期间 hydration 换块 ID 导致保存静默丢稿"
-status: in_progress
+status: done
 created: 2026-09-13
-updated: 2026-09-13
+updated: 2026-09-22
 severity: high
 ---
 
 # UI-06 编辑弹窗打开期间 hydration 换块 ID 导致保存静默丢稿
 
+> **W3 UI-rerun 关闭（2026-09-22）**：`status=done`。真实 Playwright 账本 PASS：[`ui-acceptance-results.json`](../test-reports/assets/2026-09-22-docrev-ui-rerun/ui-acceptance-results.json)（main UI-00..16）+ [`ui-acceptance-results-post-restart.json`](../test-reports/assets/2026-09-22-docrev-ui-rerun/ui-acceptance-results-post-restart.json)（UI-15）。任务 tip 已合入本地 `dev`；详见 [short-term](../ops/short-term/2026-09-22-docrev-ui-rerun.md) 与 [测试报告](../test-reports/2026-09-22-docrev-ui-rerun-test-report.md)。
+
+
 ## 现象
 
 第十二轮真实 UI（schema 30，dev@4c465d2 基线）：

.doc/audit/2026-09-13-document-revision-fast-completion-observation.md

@@ -1,13 +1,16 @@
 ---
 title: "UI-11 快速 completed 被验收脚本误判为失败"
-status: in_progress
+status: done
 created: 2026-09-13
-updated: 2026-09-13
+updated: 2026-09-22
 severity: high
 ---
 
 # UI-11 快速 completed 被验收脚本误判为失败
 
+> **W3 UI-rerun 关闭（2026-09-22）**：`status=done`。真实 Playwright 账本 PASS：[`ui-acceptance-results.json`](../test-reports/assets/2026-09-22-docrev-ui-rerun/ui-acceptance-results.json)（main UI-00..16）+ [`ui-acceptance-results-post-restart.json`](../test-reports/assets/2026-09-22-docrev-ui-rerun/ui-acceptance-results-post-restart.json)（UI-15）。任务 tip 已合入本地 `dev`；详见 [short-term](../ops/short-term/2026-09-22-docrev-ui-rerun.md) 与 [测试报告](../test-reports/2026-09-22-docrev-ui-rerun-test-report.md)。
+
+
 ## 现象
 
 第14轮真实 UI（schema 30，`dev@339e871`）在 **UI-11** 失败：页面上传附件并发送「请将此附件归档」后，相邻助手卡片已快速处于 `completed`（文案：已收录补充材料并关联黑板）。

.doc/audit/2026-09-13-document-revision-overlay-selector.md

@@ -1,13 +1,16 @@
 ---
 title: "UI-07 纯净阅读用 overlay/class*block 找不到真实块"
-status: in_progress
+status: done
 created: 2026-09-13
-updated: 2026-09-13
+updated: 2026-09-22
 severity: high
 ---
 
 # UI-07 纯净阅读用 overlay/class*block 找不到真实块
 
+> **W3 UI-rerun 关闭（2026-09-22）**：`status=done`。真实 Playwright 账本 PASS：[`ui-acceptance-results.json`](../test-reports/assets/2026-09-22-docrev-ui-rerun/ui-acceptance-results.json)（main UI-00..16）+ [`ui-acceptance-results-post-restart.json`](../test-reports/assets/2026-09-22-docrev-ui-rerun/ui-acceptance-results-post-restart.json)（UI-15）。任务 tip 已合入本地 `dev`；详见 [short-term](../ops/short-term/2026-09-22-docrev-ui-rerun.md) 与 [测试报告](../test-reports/2026-09-22-docrev-ui-rerun-test-report.md)。
+
+
 ## 现象
 
 第八轮真实 UI（schema 30）：

.doc/audit/2026-09-13-document-revision-overlay-transition.md

@@ -1,13 +1,16 @@
 ---
 title: "UI-07 在 CSS transition 中间帧采样纯净阅读"
-status: in_progress
+status: done
 created: 2026-09-13
-updated: 2026-09-13
+updated: 2026-09-22
 severity: high
 ---
 
 # UI-07 在 CSS transition 中间帧采样纯净阅读
 
+> **W3 UI-rerun 关闭（2026-09-22）**：`status=done`。真实 Playwright 账本 PASS：[`ui-acceptance-results.json`](../test-reports/assets/2026-09-22-docrev-ui-rerun/ui-acceptance-results.json)（main UI-00..16）+ [`ui-acceptance-results-post-restart.json`](../test-reports/assets/2026-09-22-docrev-ui-rerun/ui-acceptance-results-post-restart.json)（UI-15）。任务 tip 已合入本地 `dev`；详见 [short-term](../ops/short-term/2026-09-22-docrev-ui-rerun.md) 与 [测试报告](../test-reports/2026-09-22-docrev-ui-rerun-test-report.md)。
+
+
 ## 现象
 
 第九轮真实 UI（schema 30）：

.doc/audit/2026-09-13-document-revision-pending-report-selection.md

@@ -1,13 +1,16 @@
 ---
 title: "UI-05a 未打开待确认报告导致确认按钮缺失"
-status: in_progress
+status: done
 created: 2026-09-13
-updated: 2026-09-13
+updated: 2026-09-22
 severity: high
 ---
 
 # UI-05a 未打开待确认报告导致确认按钮缺失
 
+> **W3 UI-rerun 关闭（2026-09-22）**：`status=done`。真实 Playwright 账本 PASS：[`ui-acceptance-results.json`](../test-reports/assets/2026-09-22-docrev-ui-rerun/ui-acceptance-results.json)（main UI-00..16）+ [`ui-acceptance-results-post-restart.json`](../test-reports/assets/2026-09-22-docrev-ui-rerun/ui-acceptance-results-post-restart.json)（UI-15）。任务 tip 已合入本地 `dev`；详见 [short-term](../ops/short-term/2026-09-22-docrev-ui-rerun.md) 与 [测试报告](../test-reports/2026-09-22-docrev-ui-rerun-test-report.md)。
+
+
 ## 现象
 
 第四轮真实 UI（schema 30）**UI-05a 首个失败**：

.doc/audit/2026-09-13-document-revision-post-restart-selector.md

@@ -1,13 +1,16 @@
 ---
 title: "post-restart 项目名同时命中顶栏与侧栏"
-status: in_progress
+status: done
 created: 2026-09-13
-updated: 2026-09-13
+updated: 2026-09-22
 severity: high
 ---
 
 # post-restart 项目名同时命中顶栏与侧栏
 
+> **W3 UI-rerun 关闭（2026-09-22）**：`status=done`。真实 Playwright 账本 PASS：[`ui-acceptance-results.json`](../test-reports/assets/2026-09-22-docrev-ui-rerun/ui-acceptance-results.json)（main UI-00..16）+ [`ui-acceptance-results-post-restart.json`](../test-reports/assets/2026-09-22-docrev-ui-rerun/ui-acceptance-results-post-restart.json)（UI-15）。任务 tip 已合入本地 `dev`；详见 [short-term](../ops/short-term/2026-09-22-docrev-ui-rerun.md) 与 [测试报告](../test-reports/2026-09-22-docrev-ui-rerun-test-report.md)。
+
+
 ## 现象
 
 第18轮真实 UI（schema 31）：main **18 PASS / 0 FAIL**。宿主重启 app 后 `UI_PHASE=post-restart` 在页面**已经恢复项目**时失败，尚未走到 `revision-state`。

.doc/audit/2026-09-13-document-revision-prelim-output.md

@@ -1,13 +1,16 @@
 ---
 title: "UI-11 prelim_design 缺 output.md 导致 TASK_INTERRUPTED"
-status: in_progress
+status: done
 created: 2026-09-13
-updated: 2026-09-13
+updated: 2026-09-22
 severity: high
 ---
 
 # UI-11 prelim_design 缺 output.md 导致 TASK_INTERRUPTED
 
+> **W3 UI-rerun 关闭（2026-09-22）**：`status=done`。真实 Playwright 账本 PASS：[`ui-acceptance-results.json`](../test-reports/assets/2026-09-22-docrev-ui-rerun/ui-acceptance-results.json)（main UI-00..16）+ [`ui-acceptance-results-post-restart.json`](../test-reports/assets/2026-09-22-docrev-ui-rerun/ui-acceptance-results-post-restart.json)（UI-15）。任务 tip 已合入本地 `dev`；详见 [short-term](../ops/short-term/2026-09-22-docrev-ui-rerun.md) 与 [测试报告](../test-reports/2026-09-22-docrev-ui-rerun-test-report.md)。
+
+
 ## 现象
 
 第11轮真实 UI（schema 30，`dev@2a58674`）：

.doc/audit/2026-09-13-document-revision-quality-gate-self-pollution.md

@@ -1,13 +1,16 @@
 ---
 title: "质量门禁自污染与 auto_repair 未启用导致 quality_failed"
-status: in_progress
+status: done
 created: 2026-09-13
-updated: 2026-09-13
+updated: 2026-09-22
 severity: high
 ---
 
 # 质量门禁自污染与 auto_repair 未启用导致 quality_failed
 
+> **W3 UI-rerun 关闭（2026-09-22）**：`status=done`。真实 Playwright 账本 PASS：[`ui-acceptance-results.json`](../test-reports/assets/2026-09-22-docrev-ui-rerun/ui-acceptance-results.json)（main UI-00..16）+ [`ui-acceptance-results-post-restart.json`](../test-reports/assets/2026-09-22-docrev-ui-rerun/ui-acceptance-results-post-restart.json)（UI-15）。任务 tip 已合入本地 `dev`；详见 [short-term](../ops/short-term/2026-09-22-docrev-ui-rerun.md) 与 [测试报告](../test-reports/2026-09-22-docrev-ui-rerun-test-report.md)。
+
+
 ## 现象
 
 同一整改范围真实 run（与 SSE/幂等现场同源）：

.doc/audit/2026-09-13-document-revision-quality-repair-workspace-contract.md

@@ -1,13 +1,16 @@
 ---
 title: "UI-03 质量修复子工作区越界改写根 output.md"
-status: in_progress
+status: done
 created: 2026-09-13
-updated: 2026-09-13
+updated: 2026-09-22
 severity: high
 ---
 
 # UI-03 质量修复子工作区越界改写根 output.md
 
+> **W3 UI-rerun 关闭（2026-09-22）**：`status=done`。真实 Playwright 账本 PASS：[`ui-acceptance-results.json`](../test-reports/assets/2026-09-22-docrev-ui-rerun/ui-acceptance-results.json)（main UI-00..16）+ [`ui-acceptance-results-post-restart.json`](../test-reports/assets/2026-09-22-docrev-ui-rerun/ui-acceptance-results-post-restart.json)（UI-15）。任务 tip 已合入本地 `dev`；详见 [short-term](../ops/short-term/2026-09-22-docrev-ui-rerun.md) 与 [测试报告](../test-reports/2026-09-22-docrev-ui-rerun-test-report.md)。
+
+
 ## 现象
 
 第13轮 Antigravity 完整 UI（schema 30，dev@8b1a531 基线）：UI00–02 PASS，UI-03 真实 PI 终态 `quality_failed`，页面 70 分、缺少必填章节「阻塞信息 / 非阻塞信息」。

.doc/audit/2026-09-13-document-revision-quality-status-false-positive.md

@@ -1,13 +1,16 @@
 ---
 title: "行动计划表状态列「待续」被质量门禁误判为敷衍"
-status: in_progress
+status: done
 created: 2026-09-13
-updated: 2026-09-13
+updated: 2026-09-22
 severity: high
 ---
 
 # 行动计划表状态列「待续」被质量门禁误判为敷衍
 
+> **W3 UI-rerun 关闭（2026-09-22）**：`status=done`。真实 Playwright 账本 PASS：[`ui-acceptance-results.json`](../test-reports/assets/2026-09-22-docrev-ui-rerun/ui-acceptance-results.json)（main UI-00..16）+ [`ui-acceptance-results-post-restart.json`](../test-reports/assets/2026-09-22-docrev-ui-rerun/ui-acceptance-results-post-restart.json)（UI-15）。任务 tip 已合入本地 `dev`；详见 [short-term](../ops/short-term/2026-09-22-docrev-ui-rerun.md) 与 [测试报告](../test-reports/2026-09-22-docrev-ui-rerun-test-report.md)。
+
+
 ## 现象
 
 第三轮真实 UI（新用户 `mtzzliz5`，新项目，真实 MiniMax）：

.doc/audit/2026-09-13-document-revision-reviewer-duty-sync.md

@@ -1,13 +1,16 @@
 ---
 title: "项目 reviewer 未同步到受控文档职责"
-status: in_progress
+status: done
 created: 2026-09-13
-updated: 2026-09-13
+updated: 2026-09-22
 severity: critical
 ---
 
 # 项目 reviewer 未同步到受控文档职责
 
+> **W3 UI-rerun 关闭（2026-09-22）**：`status=done`。真实 Playwright 账本 PASS：[`ui-acceptance-results.json`](../test-reports/assets/2026-09-22-docrev-ui-rerun/ui-acceptance-results.json)（main UI-00..16）+ [`ui-acceptance-results-post-restart.json`](../test-reports/assets/2026-09-22-docrev-ui-rerun/ui-acceptance-results-post-restart.json)（UI-15）。任务 tip 已合入本地 `dev`；详见 [short-term](../ops/short-term/2026-09-22-docrev-ui-rerun.md) 与 [测试报告](../test-reports/2026-09-22-docrev-ui-rerun-test-report.md)。
+
+
 ## 现象
 
 第17轮真实 UI（schema 30，`dev@639969f`）：UI-00 至 UI-12 PASS。UI-13a 精确职责断言首次暴露产品缺陷：

.doc/audit/2026-09-13-document-revision-save-selector.md

@@ -1,13 +1,16 @@
 ---
 title: "UI-06 全页模糊保存按钮未发出 PATCH"
-status: in_progress
+status: done
 created: 2026-09-13
-updated: 2026-09-13
+updated: 2026-09-22
 severity: high
 ---
 
 # UI-06 全页模糊保存按钮未发出 PATCH
 
+> **W3 UI-rerun 关闭（2026-09-22）**：`status=done`。真实 Playwright 账本 PASS：[`ui-acceptance-results.json`](../test-reports/assets/2026-09-22-docrev-ui-rerun/ui-acceptance-results.json)（main UI-00..16）+ [`ui-acceptance-results-post-restart.json`](../test-reports/assets/2026-09-22-docrev-ui-rerun/ui-acceptance-results-post-restart.json)（UI-15）。任务 tip 已合入本地 `dev`；详见 [short-term](../ops/short-term/2026-09-22-docrev-ui-rerun.md) 与 [测试报告](../test-reports/2026-09-22-docrev-ui-rerun-test-report.md)。
+
+
 ## 现象
 
 第七轮真实 UI（schema 30）：

.doc/audit/2026-09-13-document-revision-second-doc-routing-lease.md

@@ -1,13 +1,16 @@
 ---
 title: "UI-11 第二份文档路由到 intake 且 human lease 残留"
-status: in_progress
+status: done
 created: 2026-09-13
-updated: 2026-09-13
+updated: 2026-09-22
 severity: high
 ---
 
 # UI-11 第二份文档路由到 intake 且 human lease 残留
 
+> **W3 UI-rerun 关闭（2026-09-22）**：`status=done`。真实 Playwright 账本 PASS：[`ui-acceptance-results.json`](../test-reports/assets/2026-09-22-docrev-ui-rerun/ui-acceptance-results.json)（main UI-00..16）+ [`ui-acceptance-results-post-restart.json`](../test-reports/assets/2026-09-22-docrev-ui-rerun/ui-acceptance-results-post-restart.json)（UI-15）。任务 tip 已合入本地 `dev`；详见 [short-term](../ops/short-term/2026-09-22-docrev-ui-rerun.md) 与 [测试报告](../test-reports/2026-09-22-docrev-ui-rerun-test-report.md)。
+
+
 ## 现象
 
 第十轮真实 UI（schema 30）：

.doc/audit/2026-09-13-document-revision-sse-idempotency.md

@@ -1,13 +1,16 @@
 ---
 title: "任务 run SSE 超时断线后同 turn 误击 DOC_BUSY"
-status: in_progress
+status: done
 created: 2026-09-13
-updated: 2026-09-13
+updated: 2026-09-22
 severity: critical
 ---
 
 # 任务 run SSE 超时断线后同 turn 误击 DOC_BUSY
 
+> **W3 UI-rerun 关闭（2026-09-22）**：`status=done`。真实 Playwright 账本 PASS：[`ui-acceptance-results.json`](../test-reports/assets/2026-09-22-docrev-ui-rerun/ui-acceptance-results.json)（main UI-00..16）+ [`ui-acceptance-results-post-restart.json`](../test-reports/assets/2026-09-22-docrev-ui-rerun/ui-acceptance-results-post-restart.json)（UI-15）。任务 tip 已合入本地 `dev`；详见 [short-term](../ops/short-term/2026-09-22-docrev-ui-rerun.md) 与 [测试报告](../test-reports/2026-09-22-docrev-ui-rerun-test-report.md)。
+
+
 ## 现象
 
 真实 Antigravity UI-03（dev schema 30）：

.doc/audit/2026-09-13-document-revision-workflow-category-navigation.md

@@ -1,13 +1,16 @@
 ---
 title: "UI-13a 在私密分类下打不开受控工作流文档"
-status: in_progress
+status: done
 created: 2026-09-13
-updated: 2026-09-13
+updated: 2026-09-22
 severity: high
 ---
 
 # UI-13a 在私密分类下打不开受控工作流文档
 
+> **W3 UI-rerun 关闭（2026-09-22）**：`status=done`。真实 Playwright 账本 PASS：[`ui-acceptance-results.json`](../test-reports/assets/2026-09-22-docrev-ui-rerun/ui-acceptance-results.json)（main UI-00..16）+ [`ui-acceptance-results-post-restart.json`](../test-reports/assets/2026-09-22-docrev-ui-rerun/ui-acceptance-results-post-restart.json)（UI-15）。任务 tip 已合入本地 `dev`；详见 [short-term](../ops/short-term/2026-09-22-docrev-ui-rerun.md) 与 [测试报告](../test-reports/2026-09-22-docrev-ui-rerun-test-report.md)。
+
+
 ## 现象
 
 第15轮真实 UI（schema 30，`dev@48a4dcb`）：UI-00 至 UI-12 全部 PASS，UI-11 快速完成修复已实证 PASS。**UI-13a 在真正权限断言前失败**。

.doc/audit/2026-09-14-dev-runtime-data-root-split-brain.md

@@ -0,0 +1,167 @@
+---
+title: "dev rebuild 从临时 worktree 挂载空数据根导致正文投影 409"
+status: done
+created: 2026-09-14
+updated: 2026-09-14
+severity: critical
+---
+
+# dev rebuild 从临时 worktree 挂载空数据根导致正文投影 409
+
+## 现象
+
+用户刷新项目 143 后，前端请求：
+
+```text
+GET /api/v1/docgov/documents/doc_proj143_intake/content 409
+DOCUMENT_CONTENT_PROJECTION_MISSING
+docgov: document content projection missing
+```
+
+错误发生在 `projectDocuments.ts` → `controlledDocHydrate.ts` 的受控正文水合链。它不是并发编辑的 `HEAD_CONFLICT`，也不是此前已修过的 canonical hash drift。
+
+本轮只做只读现场核对与整改设计：没有操作用户会话、没有修改数据库/正文、没有重建共享容器。
+
+## 结论
+
+直接根因是 **dev 应用、PI Runner、Cursor Runner 被重建成挂载临时集成 worktree 的空 `data/dev`，而 PostgreSQL 仍沿用原 dev 持久卷**，形成数据库与文件事实源的 split-brain：
+
+```text
+PostgreSQL persistent volume
+  document_records.work_dir=/app/data/workspaces/bizdev/intake_1789270446856290128
+                     │
+                     ├─ 主仓 data/dev：output.md 存在，SHA 与 DB/head 一致
+                     │
+                     └─ 当前容器 /app/data：绑定 /tmp/as-dev-wf409-merge/data/dev，文件不存在
+```
+
+`loadControlledDocumentContent` 先取得账本 head，再调用 `InspectProjection`；容器内看不到 `output.md`，因此正确分类为 `MISSING` 并返回 409。前端只是如实暴露后端错误，不是本次根因。
+
+## 现场证据
+
+### E1 — 容器挂载源是临时 worktree
+
+2026-09-14 08:54 UTC 的 `docker inspect shuimu-agent-app-dev`：
+
+| 项 | 现场值 |
+|---|---|
+| Compose working dir | `/tmp/as-dev-wf409-merge` |
+| Compose config | `/tmp/as-dev-wf409-merge/docker-compose.dev.yml` |
+| app `/app/data` source | `/tmp/as-dev-wf409-merge/data/dev` |
+| pi-agent `/app/data/workspaces` source | `/tmp/as-dev-wf409-merge/data/dev/workspaces` |
+| cursor-agent `/app/data/workspaces` source | `/tmp/as-dev-wf409-merge/data/dev/workspaces` |
+| app created | `2026-09-14T08:40:44Z` |
+
+数据库容器的数据仍来自命名卷 `agent-dev-context-pgdata`，不会随 Compose 工作目录切换。由此产生“旧数据库 + 新空文件根”的不一致组合。
+
+### E2 — 项目 143 数据本身当前完整
+
+`document_records`：
+
+| 字段 | 值 |
+|---|---|
+| doc_id | `doc_proj143_intake` |
+| work_dir | `/app/data/workspaces/bizdev/intake_1789270446856290128` |
+| content_sha256 | `f283ba94c9c037897f021960f51abacee7242c3db8d10f9f2a5e32cde6acf039` |
+| updated_at | `2026-09-14 05:14:10.302146+00` |
+
+账本 open version 1 的 head snapshot 302 是人工修订，SHA 同为 `f283...f039`；主仓文件：
+
+```text
+/home/weichen/projects/Agent-System/data/dev/workspaces/bizdev/intake_1789270446856290128/output.md
+size=40075
+sha256=f283ba94c9c037897f021960f51abacee7242c3db8d10f9f2a5e32cde6acf039
+```
+
+同一路径在当前 app 容器内 `stat` 返回 `No such file or directory`。所以无需再次对项目 143 做内容修复；需要恢复正确数据根挂载。
+
+### E3 — 影响不是单文档
+
+对 dev 数据库 100 条“非模板且 work_dir 非空”的记录做只读比较：
+
+| 根目录 | aligned | missing |
+|---|---:|---:|
+| 主仓 `/home/weichen/projects/Agent-System/data/dev` | 32 | 68 |
+| 当前容器挂载 `/tmp/as-dev-wf409-merge/data/dev` | 0 | 100 |
+
+主仓下的 68 条 missing 包含历史测试/临时路径，不能直接等同于 68 个真实用户缺陷；但当前容器对本次抽样 **100/100 都不可见**，足以确认环境级事故。恢复前任何真实文档读取或 PI 写入都不可信。
+
+错误根在容器启动后已出现 27 个文件，其中 9 个 CAS blob 的 mtime 为 `08:40:45 UTC`；虽然 08:54 UTC 尚未找到新的 `output.md`，错误根已经不是可直接丢弃的“绝对空目录”，恢复前仍须做完整差异保全。
+
+只读核对显示 test/main 当前 app 与 PI Runner 仍挂主仓 `data/test`、`data/main`，本轮没有观察到同样的运行事故；但其 Compose 仍使用相对 bind，仍受同一设计缺陷影响。
+
+### E4 — 健康检查假阳性
+
+同一时刻 `/health` 与 `/ready` 都返回 200，只检查数据库、schema 和 task store；未验证：
+
+- 容器绑定的数据根身份；
+- app 与 runner 是否挂载同一根；
+- 活跃项目的正文投影是否可达；
+- 数据库记录与文件根是否属于同一环境实例。
+
+因此“healthy + schema 33”不能证明文档运行态可用。
+
+## 根因分析
+
+### R1 — Compose 相对 bind mount 与调用 worktree 耦合（直接根因）
+
+`docker-compose.dev.yml` 使用：
+
+```yaml
+- ./data/dev:/app/data
+- ./data/dev/workspaces:/app/data/workspaces
+```
+
+Compose 按 project working directory 解析相对路径。`scripts/env-service.sh` 又把 `ROOT_DIR` 定义为脚本所在 worktree 并 `cd` 进去，所以从任何复制/linked worktree 执行 `dev rebuild`，都会把该 worktree 自己的 `data/dev` 当成运行数据根。
+
+### R2 — 纪律是文档约束，不是可执行门禁
+
+`scripts/agent-worktree.sh` 只打印“禁止在此目录运行 env-service”，`AGENTS.md` 也规定 worktree 不得操作共享 Docker；但 `env-service.sh` 没有检测 linked worktree、主 worktree、分支、数据根或集成槽位。一次误调用即可静默替换全套容器挂载。
+
+### R3 — 数据库与文件没有共享存储身份
+
+数据库使用稳定 named volume；正文使用随调用目录变化的 bind mount。两者没有共同的 environment/storage UUID，也没有启动握手，因此任意一个被指向另一份状态时，进程仍可启动并连接成功。
+
+### R4 — 账本权威仍被兼容投影阻断
+
+当前设计声明 ledger head 是权威正文，但 GET 在账本存在时仍要求 `output.md` 投影必须存在且 aligned。于是兼容投影丢失会阻断 UI 读取权威账本。该 fail-closed 对真实 fork 有价值，却把“可安全重建的 missing”与“内容分叉”按同样的可用性后果处理。
+
+### R5 — 正文更新仍是非原子双写
+
+人工 PATCH 先提交 PostgreSQL 账本，再单独写 `output.md`；候选 commit/reject 也采用 DB 状态与文件投影分步更新。失败后只依赖同幂等键重试，没有持久 projection job/status 和后台补偿。即使修复本次挂载问题，进程崩溃、权限错误或磁盘故障仍可能再次留下 head 已更新、投影缺失的状态。
+
+### R6 — 发布验收没有“从不同源码目录 rebuild 后仍接回同一状态”的负例
+
+既有真实 UI 验收验证过 restart 后恢复，但 restart 不会重新解析 Compose bind mount；本次事故由 rebuild/recreate 触发。现有门禁没有覆盖 linked worktree、临时集成目录或错误数据根的启动拒绝。
+
+## 为什么会“每次修改后又出现”
+
+修改本身并不会删除项目 143 正文。本次时间线表明：最新人工修订和主仓 `output.md` 在 05:14 UTC 已一致落盘；08:40 UTC 后续 dev rebuild 把运行容器切到另一份空数据根，刷新才出现 409。
+
+因此用户感知的“改完再刷新就坏”来自两个事件经常相邻：开发修改 → Agent 在临时 worktree 合并/rebuild → Compose 改绑数据目录。只修某个文档、某个 hydrate effect 或某次 hash 漂移，都无法阻止它复发。
+
+## 严重度与影响
+
+`critical`：
+
+- dev 环境所有受控正文、工作流产物和 runner 工作区均可能不可见或写入错误根；
+- 错误根上的新输出可能与主仓状态分叉；
+- health/ready 仍为绿色，集成报告可能产生假 PASS；
+- test/main 使用同类相对 bind 写法，设计缺陷可横向复制，虽本轮未观察其被错挂载。
+
+## 关联整改
+
+- Remediation: [dev 运行数据根隔离与文档投影自愈整改](../remediation/2026-09-14-dev-runtime-data-root-and-projection-remediation.md)
+- Short-term: [dev runtime data root guard 诊断与设计](../ops/short-term/2026-09-14-dev-runtime-data-root-guard.md)
+- 前序问题: [项目 143 canonical hash 漂移](./2026-09-14-project143-controlled-content-404.md)
+
+## 开放问题
+
+- 恢复前需再次冻结并备份错误根，确认 08:40 UTC 后是否已有新会话、附件、runner 输出或 agent session 写入；08:54 UTC 抽样未发现 `output.md`，不能替代完整差异清单。
+- test/main 当前挂载源需在实施 Unit A 只读核对；本轮未扩大操作范围。
+
+## 审查附记（2026-09-14 ~09:23 UTC）
+
+- 现场复核：`shuimu-agent-app-dev` 仍 created `08:40:44Z`，bind source 仍为 `/tmp/as-dev-wf409-merge/data/dev`；`/health` `/ready` 仍 200，`schema_version=33`。
+- 主仓 CURRENT 集成槽仍为 `implementer_cursor` / `e2e`。worktree 副本不得写成 idle。
+- 方案已审查修订：见 [整改方案](../remediation/2026-09-14-dev-runtime-data-root-and-projection-remediation.md)。用户选择事故抢占 + 先改方案再批实施。08:54 的 `f283...f039` 不得再当 Wave 0 硬门槛。

.doc/audit/2026-09-15-mock-deliverables-pollute-real-projects.md

@@ -0,0 +1,85 @@
+---
+title: "前端 mock 交付物污染真实项目：幻影受控文档伪造终审已生效态与法定职责"
+status: done
+created: 2026-09-15
+updated: 2026-09-15
+severity: critical
+---
+
+# 前端 mock 交付物污染真实项目：幻影受控文档伪造终审已生效态与法定职责
+
+## 现象
+
+用户在 **test 环境**（127.0.0.1:8081）新建测试项目「测试项目」（test 库 `projects.id=1`，唯一项目），工作台立即显示 11 份「受控文档」，其中包括与该项目毫无关系的：
+
+- 《4K超高清荧光内窥镜系统立项与可行性报告》
+- 《微创外科内窥镜全球竞品技术与临床深度调研报告》
+- 神经外科双频超声吸引（NeuroPulse）系列
+- CUSA 超声手术吸引系统系列
+
+这些文档：
+
+1. 显示**伪造的生命周期状态**（`reviewing` / `approved`——`DeckDrawer.tsx` 将 `approved` 渲染为「**终审已生效**」），即用户所称「生效区」出现从未经过任何 docgov 生命周期流转的"已生效"文档；
+2. 带有**伪造的法定职责人**（author 张工 / reviewer 李主管 / approver 王总监——均非真实用户）；
+3. 带有伪造版本号（V1.0）、伪造更新时间、伪造正文全文；
+4. 在项目成员视角按真实受控文档参与 RBAC 可见性过滤与工作流槽位合并，**与真实服务端文档混排**。
+
+而 test 库 `document_records` 为 **0 行**——服务端受控文档台账完全为空，这 11 份文档**全部来自前端硬编码 mock 数据**。
+
+## 根因分析
+
+### 1. mock 交付物硬编码绑定 projectId 1/2/3/5201/6001–6010
+
+`web/src/App.tsx:267` `INITIAL_DELIVERABLES` 硬编码 7 份 mock 交付物 `projectId: 1`（doc-001~004、doc-shared-001、doc-private-001/002）；`P2_INITIAL`（projectId 2）、`CUSA_INITIAL_DELIVERABLES`（projectId 3）、`NEUROPULSE`（5201）、`TEN_PROJECTS`（6001+）同理。`ALL_INITIAL_DELIVERABLES` 聚合后作为 `loadDeliverables()` 的默认值（App.tsx:621），并经 `saveDeliverables` **写入 localStorage 持久化**。
+
+### 2. 项目过滤按数字 ID 匹配，新建项目与 mock 项目 ID 撞车
+
+`App.tsx:1014`：`currentProjectDeliverables = deliverables.filter(doc => doc.projectId === currentProjectId)`。
+
+- test 库为全新库，用户新建的第一个项目得到 `id=1` → 与 mock 的 `projectId: 1` **精确撞车**，7 份幻影文档全部"归属"该项目；
+- 新建项目时 `createProjectTemplateDeliverables`（App.tsx:3844）再克隆 7 份模板骨架（`doc-p1-*`，`lifecycleState: 'template'`，合规）→ 7 mock + 4~7 模板/私有，构成用户看到的 11 份；
+- **dev 库同样中招**：`agent_system_dev.projects` 存在真实项目 id 1–8（智能微创内窥镜/测试内窥镜系统等），id 1/2/3 的真实项目同样被 mock 文档污染。
+
+### 3. mock 正文与 mock 用户/权限无环境门控，已进生产构建产物
+
+- `mockDocuments.ts` 无任何 `import.meta.env` 门控；`App.tsx` 中 `MOCK_USERS`（含伪造 `projectPermissions: {doc-001: approver...}`）作为 `loadUsers()` 默认值与 `currentUser` 初始身份兜底（App.tsx:610/617）；
+- **构建产物已验证污染**：`web/dist/assets/index-DogUjae5.js` 中 grep 命中「4K超高清荧光」字符串——dev/test/main 三环境共用同一前端构建，main 生产环境同样受影响。
+
+### 4. 既有防线只挡"正文请求"，不挡"清单展示"
+
+团队已知悉 legacy mock ID（`revisionToolbarMount.ts:24 isLegacyLocalMockDocId`：`doc-\d{3}` / `doc-shared-*` / `doc-private-*` / `doc-cusa-*`），并禁止它们发起 content/revision 请求（`controlledDocHydrate.ts:shouldLoadControlledContent` 排除）。但这只防住了「幻影文档冒充服务端正文」，**没有防住幻影文档出现在交付物清单、生命周期徽章（终审已生效）、职责栏与项目文档统计中**——用户看到的正是后者。
+
+### 5. 服务端权威清单未做前端对账
+
+`GET /api/v1/projects/{id}/documents`（`docgov/project_docs.go`，`WHERE project_id=$1 AND task_key<>''`，服务端已正确按项目隔离）返回空数组时，`mergeWorkflowDocumentsFromServer`（`deliverableSync.ts:41`）**直接 `return prev`，不删除本地多余项**——本地幻影文档无任何下架机制。
+
+## 严重度
+
+`critical`：
+
+1. **治理完整性破坏**：空项目展示「终审已生效」受控文档 + 三级法定职责人，在医疗器械合规语境下（ISO 13485 / 21 CFR Part 11 电子记录可靠性）构成"记录失实"；
+2. **跨环境广泛影响**：dev 真实项目 id 1–8、test 新建项目、main 生产同构建产物全部受影响；
+3. **权限视图失真**：伪造职责人/权限映射混入 RBAC 过滤链，用户对"谁可审批什么"产生错误认知；
+4. 既有防线（isLegacyLocalMockDocId）证明团队已两次踩坑（本审计为同域第三类症状），说明 mock 数据保留策略系统性不足。
+
+## 关联整改
+
+- Remediation: [2026-09-15-mock-deliverables-pollution-remediation.md](../remediation/2026-09-15-mock-deliverables-pollution-remediation.md)
+
+## 证据
+
+- test 库（`shuimu-system-pg-test`，127.0.0.1:5434）：`projects` 仅 id=1「测试项目」（通用医疗器械）；`document_records` 0 行；全库 87 张业务表除 projects/users/auth_sessions/chat_sessions/project_workflows 外全部为空
+- dev 库（`shuimu-context-pg-dev`，127.0.0.1:5433）：真实项目 id 1–8（智能微创内窥镜 / 测试内窥镜系统）→ 与 mock projectId 1/2/3 撞车
+- `web/src/App.tsx:267-498`（INITIAL_DELIVERABLES/P2/CUSA/ALL_INITIAL_DELIVERABLES）、`621`（loadDeliverables）、`1014`（projectId 过滤）、`3844`（新建克隆模板）
+- `web/src/data/mockDocuments.ts:32-505`（mock 文档全文与伪造 lifecycleState/职责人）、`web/src/data/seeds/neuropulseSeed.json`（projectId 5201）、`tenProjectsSeed.json`（6001–6010）
+- `web/dist/assets/index-DogUjae5.js`：grep 命中「4K超高清荧光」（生产构建含 mock 数据）
+- `web/src/features/documentRevision/revisionToolbarMount.ts:24-32`（isLegacyLocalMockDocId 既有防线）
+- `web/src/lib/deliverableSync.ts:41-45`（serverDocs 空时不回收本地项）
+- `web/src/components/doc/DeckDrawer.tsx:87-103`（approved → 「终审已生效」渲染）
+- `web/src/api/projectDocuments.ts:46-58`（服务端清单 API，服务端隔离正确）
+
+## 开放问题
+
+- mock 数据的保留意图（demo 演示模式？）需要在整改方案中决策：彻底移除 vs 环境门控（`import.meta.env.MODE` / 构建期注入 `VITE_ENABLE_DEMO_SEEDS`）
+- localStorage 中已被 `saveDeliverables` 持久化的 mock 项，需要一次性迁移清理（对齐既有 `dropRecordKeys`/ControlledInvalidationPlan 机制）
+- main 环境是否已有真实用户看过幻影文档（`document_access_audit` 为 0 行，无服务端读取痕迹，风险主要在前端展示层）

.doc/audit/2026-09-16-bug11-410-retire-decision.md

@@ -0,0 +1,19 @@
+---
+title: "BUG-11 410 兼容策略冻结"
+created: 2026-09-16
+status: done
+---
+
+# BUG-11：旧 WORKFLOW_SWITCH API 410 策略
+
+## 决定（2026-09-16 产品/工程冻结）
+
+**保留** 治理可用时返回 `410 Gone` + `WORKFLOW_SWITCH_API_RETIRED`；治理不可用环境仍允许旧路径。
+
+- 不视为能力缺口；不强制本轮删除路由。
+- 遥测若证明零流量，可另开退役任务。
+
+## 证据
+
+- `internal/server/project_handlers.go` Gone 分支
+- gap-matrix BUG-11 → PASS（策略冻结）

.doc/audit/2026-09-16-demo-seed-pollution-systemic.md

@@ -0,0 +1,44 @@
+---
+title: Demo/测试数据污染系统性审计
+status: done
+created: 2026-09-16
+updated: 2026-09-16
+owner: Cursor-Auto
+---
+
+# Demo / 测试数据污染系统性审计
+
+## 前序
+
+本审计在 [2026-09-15 mock 交付物污染真实项目](./2026-09-15-mock-deliverables-pollute-real-projects.md)（及对应 [整改](../remediation/2026-09-15-mock-deliverables-pollution-remediation.md)）之上收敛为全栈系统性排查：前端门控、goose 演示项目/会话、stub API。
+
+## 背景
+
+空项目展示「终审已生效」受控文档 + 伪造三级职责人。初判怀疑 docgov 隔离失败；实锤为前端 mock/seed 与 DB goose 演示种子污染。
+
+## 结论
+
+| 面 | 判定 | 说明 |
+|----|------|------|
+| 服务端 `document_records` / project_docs | **正常** | 按 `project_id` 隔离；空项目台账为 0 |
+| 前端 `ALL_INITIAL_DELIVERABLES` / mockDocuments | **critical** | 无门控进生产包；projectId 1/2/3 撞车 |
+| 前端 DEFAULT_PROJECTS / sessions / MOCK_USERS | **critical/high** | NeuroPulse 5201、CUSA id=3、6001–6010 |
+| `deliverableSync` 空清单 `return prev` | **critical** | 权威空列表不回收本地 mock |
+| `isLegacyLocalMockDocId` 覆盖不全 | **critical** | 未覆盖 neuropulse / ten-projects |
+| Goose `00011`/`00012` | **critical** | 全环境写入 6001–6010 + 聊天 |
+| API `backend=stub` | **high** | main 仍可请求 stub |
+| `BootstrapDevSeedUsers` | **OK** | 已有 env 门控 |
+
+## 证据路径
+
+- `web/src/App.tsx`（整改前 INITIAL_*）
+- `web/src/data/mockDocuments.ts` / `neuropulseDemo.ts` / `tenProjectsDemo.ts`
+- `web/src/lib/deliverableSync.ts`
+- `deploy/postgres/goose/00011_*.sql` / `00012_*.sql`
+- `internal/taskrun/backend.go`
+- 产物扫描：`scripts/check-prod-bundle.sh`
+
+## 整改回链
+
+- [remediation](../remediation/2026-09-16-demo-seed-pollution-remediation.md)
+- [test-report](../test-reports/2026-09-16-demo-seed-pollution-test-report.md)

.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-16-feature-matrix-production-readiness-audit.md

@@ -0,0 +1,110 @@
+---
+title: "FEATURE-MATRIX production-ready 连续性审计"
+status: done
+created: 2026-09-16
+updated: 2026-09-16
+---
+
+# FEATURE-MATRIX production-ready 连续性审计
+
+## 结论
+
+排除“纯软件项目自举”后，当前证据没有显示新的发布 blocker。`CURRENT.md`、`gap-matrix.md` 与 B1–B4 报告一致记录 `production_ready=yes`，dev/test/main 均为 schema 47。
+
+`FEATURE-MATRIX.md` 仍需整改，但问题主要是状态语义混杂和证据漂移：同一个 `partial` 同时表示补证、首发后增强、实验、刻意关闭和真正的能力缺口。矩阵不能仅凭这些 `partial` 把 production-ready 回退，也不能据此宣称所有能力完整。
+
+本轮只读核对文档和源码，没有运行测试、改业务代码、切换 feature flag 或操作共享环境。运行态事实仍以现有测试报告为准；后续状态提升必须重新验证。
+
+## 审计边界
+
+- 包含：除“纯软件项目自举”外的 `partial` 行、与这些行直接相关的 done/deferred 边界、发布门禁和证据链。
+- 不包含：纯软件项目自举的实现方案、FAV 的实现审计、业务代码整改、部署或环境晋升。
+- 权威关系：`FEATURE-MATRIX.md` 描述能力成熟度；`gap-matrix.md` 描述发布 blocker；`CURRENT.md` 描述当前协作与环境快照。
+
+## 已确认事实
+
+1. 发布门禁 B1–B4 已签，三环境 schema 为 47；U9–U12、FAV、完整 PI change-report 叙事和软件自举明确不挡当前首发。
+2. 对话刷新、重登、重启和跨用户拒绝已有真实 PI/运行态证据。
+3. 可靠事件 notify、workflow advance、projection 已 live，生产闭包 hook 已退出；FAV 仍保持 off。
+4. 多意图 U1–U8 已合入默认 `legacy` 的安全基线，但 U8 真实 PI generate 在其报告中是 SKIP，不能写成真实生成闭环已签。
+5. 工作流治理的设置页、DutyMode、动作级鉴权和三工作流真实 PI E2E 已签；full/none 文档长链的页面证据仍未完整覆盖。
+6. 文档版本账本、人工修订、比较、通知和运行时 UI 已通过；change report 仍是明确标识的 deterministic fallback，不是完整 PI 叙事。
+
+## 逐行核对
+
+| 模块 | 当前判定 | 剩余工作 | 发布关系 |
+|---|---|---|---|
+| 意图识别 L1 | 当前行范围已具备改为 `done` 的条件 | 把 U9–U12 移出 L1 行；L1 只保留 18 类、三分支、读写分流和纯依赖边界 | 文档校准，不是 blocker |
+| 多意图持久计划 | `partial` 合理 | 先补 U8 真实 PI + PG + browser + restart + 撤权证据；U9 独立实验；U10–U12 逐 action 扩面 | 默认 `legacy`，不挡首发 |
+| 对话 / ctxmgr baseline | 当前冻结范围可改为 `done` | 语义摘要是 backlog D3，不是 D5；拆成独立 deferred/partial 行 | 文档校准，不是 blocker |
+| 对话安全治理 D7 | `deferred` 独立行 | 数据分类，数据库/备份/日志控制盘点，留存删除口径和加密边界；若确认当前基线违规则升级 blocker | 待合规口径，不得无限期隐藏在普通 backlog |
+| 工作流治理 | `partial` 合理 | full 文档真实 PI 人工审批长链；none 文档真实 PI 生成、免审批、账本持久化和阶段不阻塞长链 | 补证优先，不预设改代码 |
+| IAM / 鉴权 | 现有缺口文字过时，模块仍应暂保 `partial` | 历史读取统一 owner/阶段授权已闭环；改为全路由 inventory、PG fail-closed、管理员例外、缓存失效和 410 退役决策 | 若发现现行旁路则升级 blocker |
+| 文档版本与修改认知 baseline | 当前冻结范围可改为 `done` | 账本、人工修订、真实 diff+lineage 和 UI 已签；完整 PI narrative 拆成独立 deferred/partial 行 | 文档校准，不是 blocker |
+| 前端工作台 | 当前行范围可改为 `done` | 其他 409 消费方复用信封解析应另列 hardening，不能让当前能力永久 `partial` | 文档校准，不是 blocker |
+| CI / E2E | `partial` 合理 | 夜间 `RUN_PI_E2E=1`、失败分类与证据归档；修复全仓 race 的 TempDir 异步收口 flake | 阻止下一次晋升，不自动否定已发布版本 |
+| Artifact promotion | `partial/deferred` 独立行 | 现状只证明同 commit 与各环境 digest 可追溯；要声明 same-image promotion，需一次构建、按 digest 晋升和可执行 receipt | 发布加固，不反向否定已签版本 |
+| 模块解耦与可靠事件 | 当前核心范围可改为 `done` | 将 FAV 拆成独立 `deferred` 行；选择性后续解耦按收益触发 | FAV 保持 off，不挡首发 |
+
+## 文档漂移
+
+1. 多意图行仍写“共享环境 schema 45 待晋升”，与三环境 schema 47 冲突。
+2. 对话行将语义摘要标成 D5；`chat-agent-p6-backlog.md` 中语义摘要实际为 D3，D5 是共享 KB 环境隔离评估。
+3. IAM 行仍把已经闭环的历史读取 owner/阶段授权写成待办。
+4. 前端行的“缺口/后续”没有未完成项，但状态仍是 `partial`。
+5. 模块解耦行把已完成的事件核心和故意关闭的 FAV 混在同一状态中。
+6. `2026-09-15-multi-intent-hitl-plan.md`、Phase 2 解耦方案、HTTP 信封方案和相关历史研究的头部状态或叙事已被后续报告部分或全部取代。
+
+历史文档不得删除。应在原文增加 implemented/superseded 指针，或更新仍作为活方案的状态与证据链接。
+
+## 风险发现
+
+### IAM fail-open 潜在路径
+
+`internal/auth/store_factory.go` 在 pool 为空或 IAM 表未就绪时回退 `MemoryStore`，没有按环境显式拒绝。当前 main schema 47 使该分支未被证实正在触发，因此本审计不直接翻转 production-ready；后续必须先只读核对部署实际选择，再把 fallback 改成仅 dev/test 加显式 opt-in 可用，空值、未知环境和 main/prod 一律 fail closed，并覆盖既有 session 的授权依赖中断负例。
+
+### 状态提升越级
+
+U8 的代码合入、默认 legacy 安全和真实 PI 放量是三件不同的事。矩阵若只写“U1–U8 完成”，会掩盖真实 PI stop-gate，并可能误导后续把 tier 升到 `confirm/full`。
+
+### `none` 语义误写
+
+`none` 表示不需要人工三权审批，不是“none 文档审批长链”。验收应证明真实 PI 生成、版本账本、审批动作不适用和阶段不阻塞。
+
+### 证据失效
+
+测试报告只证明其 commit、schema、镜像、runner/model/protocol 和环境。代码、迁移、compose、flag、runner 协议变化或环境晋升后，历史 PASS 不能单独证明新部署。
+
+## 推荐状态模型
+
+能力状态与发布状态必须正交：
+
+- `done`：本行声明的能力边界已完成并有相应层级证据；不表示该领域永无后续。
+- `partial`：已交付可用子集，行内列出尚未满足的关闭条件。
+- `planned`：方案已存在但尚未实施。
+- `deferred`：明确不进入当前路线，且不是发布 blocker。
+- `blocked`：该行目标无法继续，必须给出 blocker 和恢复条件。
+- `production_ready`：只由 `gap-matrix.md` 的发布门禁决定，不由所有能力行必须 `done` 推导。
+
+## 重验触发器
+
+发生以下任一变化时，受影响行必须重新验证，不能沿用旧 PASS：
+
+- 授权谓词、owner port、会话或阶段作用域变化；
+- schema、迁移、compose、镜像或环境晋升；
+- feature flag/tier 从 off、legacy 或 shadow 升级；
+- PI Runner URL、模型、typed-result 协议或 prompt/schema 变化；
+- event consumer writer、lease、receipt、replay 或回滚路径变化；
+- 浏览器用户流、SSE 恢复或持久化边界变化。
+
+## 相关证据
+
+- 能力矩阵：`status/FEATURE-MATRIX.md`
+- 发布缺口：`remediation/gap-matrix.md`
+- 当前环境：`ops/CURRENT.md`
+- 发布门禁任务：`archive/ops/short-term/2026-09-16-production-ready-gates.md`
+- 多意图设计与 U8：`system-design/2026-09-15-multi-intent-hitl-plan.md`、`test-reports/2026-09-16-multi-intent-u8-task-generate-test-report.md`
+- 对话门禁：`test-reports/2026-09-16-chat-refresh-gate-test-report.md`
+- 工作流 full/none 证据边界：`test-reports/2026-09-14-workflow-plan-409-frozen-and-optional-duties-test-report.md`
+- 文档版本：`test-reports/2026-09-14-document-revision-runtime-ui-test-report.md`
+- 事件与解耦：`test-reports/2026-09-15-phase2-closeout-test-report.md`、`ops/research/2026-09-15-track-e-retrospective.md`

.doc/audit/2026-09-16-r13-data-safety-checklist.md

@@ -0,0 +1,23 @@
+---
+title: "R13 数据安全清单（nightly / real-PI）"
+created: 2026-09-16
+status: done
+---
+
+# R13 数据安全清单
+
+用于真实 PI / nightly / 扩面验收的出站与留存门禁。
+
+| # | 控制项 | 状态 | 证据/路径 |
+|---|--------|------|-----------|
+| 1 | 隔离合成 project/session，禁止生产真实 PII | PASS | nightly `agent_wave2_pi` + 合成 fixture |
+| 2 | 凭证不入库；secrets 仅 Gitea Actions / `~/.secrets` | PASS | handoff gitea-nightly-secrets |
+| 3 | evidence_refs 脱敏；日志无 token/密码 | PASS | `promotion-receipt-*` + run script |
+| 4 | PI 最小字段 allowlist / typed-result-v1 | PASS | deploy/pi-agent typed-result |
+| 5 | 跨项目/跨用户负例拒绝 | PASS | Wave2 / authz 套件 |
+| 6 | 产物保留期有限（本地 tar / Actions） | PASS | workflow archive step |
+| 7 | KB 出站失败降级不泄漏凭证 | PASS | pi-agent runner health 无 key |
+
+## 开放增强
+
+- 完整红队注入矩阵可另开 audit；不挡本清单基线勾选。

.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 另开任务