@tea-agent/loop-agent 0.35.1-beta.0 → 0.35.1-beta.2

package/AGENTS.md

@@ -1,108 +1,110 @@
-<!-- CODEGRAPH_START -->
-## CodeGraph
-
-如果仓库根目录存在 `.codegraph/`，在理解或定位代码前优先使用 CodeGraph，再考虑 rg/fd 或手动读文件。
-<!-- CODEGRAPH_END -->
-
-# AGENTS.md
-
-本仓库采用“人类掌舵，智能体执行”的工程方式。目标不是一次性写完所有代码，而是在一个可持续演进、可交接、可验证的系统里做小步增量。
-
-`AGENTS.md` 是地图，不是百科。顶层只保留开工协议、会话协议与文档导航；长期知识、方法论、决策、计划、报告和模板应进入 `docs/`。
-
-## 默认立场
-
-- 仓库是记录系统：决策、契约、计划、测试、报告优先落到仓库，而不是停留在聊天里。
-- 一次只推进一个清晰工作块；主会话按 Orient → Select → Contract → Implement → Verify → Handoff 治理，runtime 真实流程以 `src/workflows/` 为准。
-- 先验证基线，再叠加改动；完成定义必须可验证，不能靠删测试、降标准或模糊描述制造“完成”。
-- Do not consider backward compatibility. Ignore legacy code/libraries.
-- 搜索先于实现；受治理 Agent runtime 只有 Pi（`implement-pi` / `repair-pi`）；`cursor-prompt` 仅为显式手工 one-shot sidecar。
-- DAG 标准路径：Contract → Scout → Plan → Implement → Verify → Closeout/Handoff。
-- 机器校验契约真源：`docs/init-surface.manifest.json`、`docs/architecture/runtime-boundaries.md`、`src/cli/command-definitions.ts`、`skills/loop-agent/`、`scripts/check-*.sh`；本文件只指路。
-- 本仓库既是源项目也是 init 默认模板；新增能力必须判断 npm 内置 vs `loop-agent init` 投影。
-- 委托写入前必须结构化 `task.json.allowedPaths` / `forbiddenPaths`，并审查 DAG writer `writeSet`。
-- Shell 搜索优先 `rg`，按名找文件优先 `fd`；脚本用 Git Bash / 兼容 Bash。
-- 用 loop-agent 迭代本仓库时，控制器必须来自已发布 npm 包（记录实际版本）；启动后不要中途升级；不要用工作区 `npm link` / `npm run dev` 控制可能改 CLI/runtime/package 的任务。
-- 反复出现的约束固化为文档、脚本、检查、测试或模板；禁止占位实现（除非 contract 标明脚手架）。
-- 非微小实现：`exec-plan` 不能替代 Agent DAG；除非用户要求 one-shot 或计划记录 escape hatch，否则改实现前完成 `task advance`（PRD + 结构化路径边界）、writeSet gate 审查与 `task advance --approve-gate`。
-- **实现默认 DAG，主会话不直接改代码**：只要是实现/修复/行为或展示语义变更（含 observe 文案映射、runtime status、schema、executor、CLI 等），主会话只做 Orient / 建 task / dry-run / validate / writeSet 审查 / 执行与监视 DAG，**不得**自己改 `src/**`、`test/**` 等交付面。仅当用户**明确授权**主会话直接处理（例如「直接改」「主会话改」「one-shot」「不用 DAG」）时，才允许主会话写入；授权后仍须记录边界、allowedPaths 与验证证据。纯答疑、读代码、查状态、提交/推送已有 diff、或用户点名的文档微调（如本文件规则）不在此限。
-- 不要自行引入外部 SDD/spec-first 等强制平行治理树；以本文件与 `docs/` 为准（ADR 0006）。
-
-## 开始顺序
-
-改文件前必须先完成：
-
-1. `pwd` → 读 `README.md`、`harness.json`、`docs/README.md`；有 `CONTEXT.md` 则读术语表。
-2. 实现类工作继续读：`docs/governance/development-principles.md`、`docs/governance/feature-workflow.md`、`docs/governance/verification-matrix.md`。
-3. 涉及命令/executor/init/skills/发布包/治理检查时继续读：`docs/architecture/runtime-boundaries.md`、`docs/runtime/loop-agent-harness.md`。
-4. 涉及测试纪律/验证声明/调试时继续读：`docs/governance/harness-methodology-*.md`。
-5. 查看最近提交、相关 plan/progress/report；`git status --short --branch`；跑最小基线验证。
-6. 后端/接口/pytest → `taskKind: "backend-test"`（不是 `--profile`）；知识回写 `knowledge-sync`；图谱开荒 `knowledge-graph-bootstrap`。`--profile` 仅 `auto|minimal|standard|reviewed|supervised`。
-7. 看板/observe → `agent-worker console`（默认 repo=当前目录、port=8790；listen 成功后默认打开系统浏览器，`--no-open` 禁止）（`/inspect/` 只读）；`observe serve` 已下线（`OBSERVE_SERVE_REMOVED` + exit 2）；`observe snapshot` 仍可用。
-8. 分支合并 → 先读 `docs/operations/branch-merge-guideline.md`。
-
-## 会话协议
-
-1. Orient → 2. Select（一块）→ 3. Contract → 4. Implement → 5. Verify → 6. Converge Docs → 7. Handoff。
-
-这不是 DAG 节点序列。实现默认 Agent DAG；主 agent 拆任务、写 contract、结构化路径、审查 DAG/writeSet/profile/shell verification，**不自行 implement**。主会话 one-shot 仅在用户明确授权时可用，并记录边界与验证证据；「看起来很小」或「只是展示文案」不构成授权——若改动触及 runtime/status/映射语义，仍走 DAG。
-
-启动 loop-agent DAG 流程后，主 agent 应自主推进到整个流程结束，不要中途请求无谓的人工确认（如“要我现在执行 DAG 吗？”）。只要 dry-run / validate / writeSet 审查通过就应直接执行并跑完全部 ranks；遇到真问题（契约不一致、writeSet 越界、verify 失败且超出 maxFixLoops、用户明显未授权的高风险动作）才停。即便 profile 是 supervised/reviewed，也不默认在 review-gate 主动停下等人——控制器会在需要人工 approve 时自行提示，主 agent 的职责是推动流程跑完。
-
-DAG 执行期间主 agent 必须持续轮询监视直到 run 结束（FINISHED / FAILED / 需要 approve），不能轮询一次就停下等用户；轮询间隔应合理（避免频繁唤醒浪费 token，也不得住一个节点上赌一次就走）。判活必须用可靠方式：看 `state.json` 的 `runner.heartbeatAt` 是否持续刷新 + `session-events.jsonl` 是否在增长 + `dag doctor` 的 `liveness` 字段，不要只用 `tasklist /FI "PID eq X"` 这类过滤语法在 Git Bash 下会误报 DEAD，从而错判一个正常工作的 run 为 orphaned。遇到疑似 stall 先按 `docs/runtime/agent-dag-runner.md` 查 `lastMeaningfulProgressAt` / provider 活动，有真实进展就继续等，绝不盲目 supersede。持续监视过程中，主 agent 可在合适节点（例如 rank/节点状态变化、进入 verify/closeout、出现 stall 嫌疑或需要 approve 时）向用户做简短进度汇报（当前节点、状态、是否有风险），避免长时间静默；汇报是告知，不是请求确认，不得因此停下流程。
-
-DAG 执行期间，主 agent 不得修改 writeSet 外的任何工作区文件（包括 AGENTS.md、docs、根配置等）。bounded writer 节点的 write guard 用「节点运行期间的工作区 diff」作为越界证据，不区分改动来自 pi 还是主会话——主会话在 pi 节点跑的时候改了 writeSet 外文件，会让 write guard 把账算到 pi 头上、判节点 ERROR、下游 cascade skip。需要改文档/约束时，要么在 DAG 启动前改完，要么等 run 结束后改；务必与 DAG 写入节点在时间上互斥。排查任务路由问题时优先用 `resolveTaskDagTemplateSelection` / `classifyTaskDemand` 等纯函数探针或 `--output` 指定临时路径，不要反复 `dag execute --dry-run` / 无必要的 lifecycle 探测。dry-run 不执行节点；若确需预演，检查命令返回的 `.harness/dag-runs/dry-run/<runId>/` `runDir`，它不进入 active overview，也不能作为 `dag resume` 目标。优先用纯函数探针或 `task status`。
-
-## 项目地图
-
-- `CONTEXT.md`：术语表
-- `src/`：运行时；`test/`：Vitest；`bin/loop-agent.js`：CLI
-- `skills/`：源仓库/npm 内置 skills；目标项目只生成 `.agents/skills/`
-- `.harness/`：运行态（tasks/dag-runs/runs 等；init 会 gitignore 运行事实，保留 prompts 与占位）
-- `docs/`：治理；`website/`：用户文档站；`scripts/`：检查与 CI
-
-## 工作规则（增量约束）
-
-- 保留无关用户改动；优先沿用现有 helper/目录边界。
-- 长期决策写入 `docs/`；面向用户变更更新 `CHANGELOG.md`（结果导向中文）。
-- init/投影变更必须同步目标项目生成物与 package assets；init evolution 按 `docs/init-surface.manifest.json` 分级。
-- CLI/skill entry/runtime boundary/发布包变更同步 catalog、脚本与测试。
-- 明确的前端页面/UI/组件/交互实现需求必须设置 `taskKind: "frontend-implementation"`（不是 `--profile`），不得保留默认 `standard`；浏览器/UI 自动化测试继续使用 `taskKind: "frontend-test"`。
-- 没有新鲜验证证据时不声明完成；新债写入 plan/progress/report。
-
-## 验证
-
-权威源：`docs/governance/verification-matrix.md`。
-
-默认节奏：编辑中只跑矩阵「最低验证」（typecheck + 定向 Vitest）；`git commit` 的 `pre-commit` 只做 `check-repo`；`git push` 的 `pre-push` 经 `node scripts/pre-push-verify.mjs` 在 receipt 命中时复用、miss 时跑 full `bash scripts/ci.sh`（全量 typecheck + `npm test`）。每个 clone 安装一次 hooks：`bash scripts/install-git-hooks.sh`。
-
-连续 source→target 交付遵循**单一最终树全量验证**：同一 Git tree、相同环境与命令合同在 receipt TTL 内只选一个本地 full authority（有效 receipt / target pre-push / 可选 `npm run verify:tree`），不按分支名策略化，也不机械双跑 full CI。细节见 verification-matrix 与 branch-merge-guideline。
-
-常用：
-
-```bash
-# 编辑中
-npm run typecheck
-npx vitest run <相关测试路径>
-
-# 可选：提前验证当前 clean HEAD 并写 receipt（随后同 tree push 可复用）
-npm run verify:tree
-
-# push / 交付前（或依赖 pre-push；receipt miss 时安全回退 full）
-bash scripts/ci.sh
-npm run build
-node bin/loop-agent.js --help
-```
-
-文档站变更：`npm run docs:build`。init / architecture / skill entry / pack 定向验证见 verification-matrix。
-
-## 交接
-
-记录：改了什么、为什么、验证命令与结果、契约/文档/测试影响、剩余风险、后续工作。
-
-## 禁止事项
-
-- 未读相关文档就大改；一次混合无关重构/新功能/文档大迁移。
-- 把对话约束当长期知识；缺验证宣称完成；假设系统没有某能力（先搜索）。
-- stub/假数据通路替代交付；把本机绝对路径写入仓库级 AGENTS/README/模板/发布包。
-- 只更新本仓库体验而遗漏目标项目 init 体验。
+<!-- CODEGRAPH_START -->
+## CodeGraph
+
+如果仓库根目录存在 `.codegraph/`，在理解或定位代码前优先使用 CodeGraph，再考虑 rg/fd 或手动读文件。
+<!-- CODEGRAPH_END -->
+
+# AGENTS.md
+
+本仓库采用“人类掌舵，智能体执行”的工程方式。目标不是一次性写完所有代码，而是在一个可持续演进、可交接、可验证的系统里做小步增量。
+
+`AGENTS.md` 是地图，不是百科。顶层只保留开工协议、会话协议与文档导航；长期知识、方法论、决策、计划、报告和模板应进入 `docs/`。
+
+## 默认立场
+
+- 仓库是记录系统：决策、契约、计划、测试、报告优先落到仓库，而不是停留在聊天里。
+- 一次只推进一个清晰工作块；主会话按 Orient → Select → Contract → Implement → Verify → Handoff 治理，runtime 真实流程以 `src/workflows/` 为准。
+- 先验证基线，再叠加改动；完成定义必须可验证，不能靠删测试、降标准或模糊描述制造“完成”。
+- Do not consider backward compatibility. Ignore legacy code/libraries.
+- 搜索先于实现；受治理 Agent runtime 只有 Pi（`implement-pi` / `repair-pi`）；`cursor-prompt` 仅为显式手工 one-shot sidecar。
+- DAG 标准路径：Contract → Scout → Plan → Implement → Verify → Closeout/Handoff。
+- 机器校验契约真源：`docs/init-surface.manifest.json`、`docs/architecture/runtime-boundaries.md`、`src/cli/command-definitions.ts`、`skills/loop-agent/`、`scripts/check-*.sh`；本文件只指路。
+- 本仓库既是源项目也是 init 默认模板；新增能力必须判断 npm 内置 vs `loop-agent init` 投影。
+- 委托写入前必须结构化 `task.json.allowedPaths` / `forbiddenPaths`，并审查 DAG writer `writeSet`。
+- Shell 搜索优先 `rg`，按名找文件优先 `fd`；脚本用 Git Bash / 兼容 Bash。
+- 用 loop-agent 迭代本仓库时，控制器必须来自已发布 npm 包（记录实际版本）；启动后不要中途升级；不要用工作区 `npm link` / `npm run dev` 控制可能改 CLI/runtime/package 的任务。
+- 反复出现的约束固化为文档、脚本、检查、测试或模板；禁止占位实现（除非 contract 标明脚手架）。
+- 非微小实现：`exec-plan` 不能替代 Agent DAG；除非用户要求 one-shot 或计划记录 escape hatch，否则改实现前完成 `task advance`（PRD + 结构化路径边界）、writeSet gate 审查与 `task advance --approve-gate`。
+- **实现默认 DAG，主会话不直接改代码**：只要是实现/修复/行为或展示语义变更（含 observe 文案映射、runtime status、schema、executor、CLI 等），主会话只做 Orient / 建 task / dry-run / validate / writeSet 审查 / 执行与监视 DAG，**不得**自己改 `src/**`、`test/**` 等交付面。仅当用户**明确授权**主会话直接处理（例如「直接改」「主会话改」「one-shot」「不用 DAG」）时，才允许主会话写入；授权后仍须记录边界、allowedPaths 与验证证据。纯答疑、读代码、查状态、提交/推送已有 diff、或用户点名的文档微调（如本文件规则）不在此限。
+- 不要自行引入外部 SDD/spec-first 等强制平行治理树；以本文件与 `docs/` 为准（ADR 0006）。
+
+## 开始顺序
+
+改文件前必须先完成：
+
+1. `pwd` → 读 `README.md`、`harness.json`、`docs/README.md`；有 `CONTEXT.md` 则读术语表。
+2. 实现类工作继续读：`docs/governance/development-principles.md`、`docs/governance/feature-workflow.md`、`docs/governance/verification-matrix.md`。
+3. 涉及命令/executor/init/skills/发布包/治理检查时继续读：`docs/architecture/runtime-boundaries.md`、`docs/runtime/loop-agent-harness.md`。
+4. 涉及测试纪律/验证声明/调试时继续读：`docs/governance/harness-methodology-*.md`。
+5. 查看最近提交、相关 plan/progress/report；`git status --short --branch`；跑最小基线验证。
+6. 后端/接口/pytest → `taskKind: "backend-test"`（不是 `--profile`）；知识回写 `knowledge-sync`；图谱开荒 `knowledge-graph-bootstrap`。`--profile` 仅 `auto|minimal|standard|reviewed|supervised`。
+7. 看板/observe → `agent-worker console`（默认 repo=当前目录、port=8790；listen 成功后默认打开系统浏览器，`--no-open` 禁止）（`/inspect/` 只读）；`observe serve` 已下线（`OBSERVE_SERVE_REMOVED` + exit 2）；`observe snapshot` 仍可用。
+8. 分支合并 → 先读 `docs/operations/branch-merge-guideline.md`。
+
+## 会话协议
+
+1. Orient → 2. Select（一块）→ 3. Contract → 4. Implement → 5. Verify → 6. Converge Docs → 7. Handoff。
+
+这不是 DAG 节点序列。实现默认 Agent DAG；主 agent 拆任务、写 contract、结构化路径、审查 DAG/writeSet/profile/shell verification，**不自行 implement**。主会话 one-shot 仅在用户明确授权时可用，并记录边界与验证证据；「看起来很小」或「只是展示文案」不构成授权——若改动触及 runtime/status/映射语义，仍走 DAG。
+
+启动 loop-agent DAG 流程后，主 agent 应自主推进到整个流程结束，不要中途请求无谓的人工确认（如“要我现在执行 DAG 吗？”）。只要 dry-run / validate / writeSet 审查通过就应直接执行并跑完全部 ranks；遇到真问题（契约不一致、writeSet 越界、verify 失败且超出 maxFixLoops、用户明显未授权的高风险动作）才停。即便 profile 是 supervised/reviewed，也不默认在 review-gate 主动停下等人——控制器会在需要人工 approve 时自行提示，主 agent 的职责是推动流程跑完。
+
+DAG 执行期间主 agent 必须持续轮询监视直到 run 结束（FINISHED / FAILED / 需要 approve），不能轮询一次就停下等用户；轮询间隔应合理（避免频繁唤醒浪费 token，也不得住一个节点上赌一次就走）。判活必须用可靠方式：看 `state.json` 的 `runner.heartbeatAt` 是否持续刷新 + `session-events.jsonl` 是否在增长 + `dag doctor` 的 `liveness` 字段，不要只用 `tasklist /FI "PID eq X"` 这类过滤语法在 Git Bash 下会误报 DEAD，从而错判一个正常工作的 run 为 orphaned。遇到疑似 stall 先按 `docs/runtime/agent-dag-runner.md` 查 `lastMeaningfulProgressAt` / provider 活动，有真实进展就继续等，绝不盲目 supersede。持续监视过程中，主 agent 可在合适节点（例如 rank/节点状态变化、进入 verify/closeout、出现 stall 嫌疑或需要 approve 时）向用户做简短进度汇报（当前节点、状态、是否有风险），避免长时间静默；汇报是告知，不是请求确认，不得因此停下流程。
+
+DAG 执行期间，主 agent 不得修改 writeSet 外的任何工作区文件（包括 AGENTS.md、docs、根配置等）。bounded writer 节点的 write guard 用「节点运行期间的工作区 diff」作为越界证据，不区分改动来自 pi 还是主会话——主会话在 pi 节点跑的时候改了 writeSet 外文件，会让 write guard 把账算到 pi 头上、判节点 ERROR、下游 cascade skip。需要改文档/约束时，要么在 DAG 启动前改完，要么等 run 结束后改；务必与 DAG 写入节点在时间上互斥。排查任务路由问题时优先用 `resolveTaskDagTemplateSelection` / `classifyTaskDemand` 等纯函数探针或 `--output` 指定临时路径，不要反复 `dag execute --dry-run` / 无必要的 lifecycle 探测。dry-run 不执行节点；若确需预演，检查命令返回的 `.harness/dag-runs/dry-run/<runId>/` `runDir`，它不进入 active overview，也不能作为 `dag resume` 目标。优先用纯函数探针或 `task status`。
+
+## 项目地图
+
+- `CONTEXT.md`：术语表
+- `src/`：运行时；`test/`：Vitest；`bin/loop-agent.js`：CLI
+- `skills/`：源仓库/npm 内置 skills；目标项目只生成 `.agents/skills/`
+- `.harness/`：运行态（tasks/dag-runs/runs 等；init 会 gitignore 运行事实，保留 prompts 与占位）
+- `docs/`：治理；`website/`：用户文档站；`scripts/`：检查与 CI
+
+## 工作规则（增量约束）
+
+- 保留无关用户改动；优先沿用现有 helper/目录边界。
+- 长期决策写入 `docs/`；面向用户变更更新 `CHANGELOG.md`（结果导向中文）。
+- init/投影变更必须同步目标项目生成物与 package assets；init evolution 按 `docs/init-surface.manifest.json` 分级。
+- CLI/skill entry/runtime boundary/发布包变更同步 catalog、脚本与测试。
+- 明确的前端页面/UI/组件/交互实现需求必须设置 `taskKind: "frontend-implementation"`（不是 `--profile`），不得保留默认 `standard`；浏览器/UI 自动化测试继续使用 `taskKind: "frontend-test"`。
+- 没有新鲜验证证据时不声明完成；新债写入 plan/progress/report。
+
+## 验证
+
+权威源：`docs/governance/verification-matrix.md`。
+
+默认节奏：编辑中只跑矩阵「最低验证」（typecheck + 定向 Vitest）；`git commit` 的 `pre-commit` 只做 `check-repo`；`git push` 的 `pre-push` 经 `node scripts/pre-push-verify.mjs` 在 receipt 命中时复用、miss 时跑 full `bash scripts/ci.sh`（全量 typecheck + `npm test`）。每个 clone 安装一次 hooks：`bash scripts/install-git-hooks.sh`。
+
+连续 source→target 交付遵循**单一最终树全量验证**：同一 Git tree、相同环境与命令合同在 receipt TTL 内只选一个本地 full authority（有效 receipt / target pre-push / 可选 `npm run verify:tree`），不按分支名策略化，也不机械双跑 full CI。细节见 verification-matrix 与 branch-merge-guideline。
+
+常用：
+
+```bash
+# 编辑中
+npm run typecheck
+npx vitest run <相关测试路径>
+
+# 可选：提前验证当前 clean HEAD 并写 receipt（随后同 tree push 可复用）
+npm run verify:tree
+
+# push / 交付前（或依赖 pre-push；receipt miss 时安全回退 full）
+bash scripts/ci.sh
+npm run build
+node bin/loop-agent.js --help
+```
+
+- 改 `src/**` 后必须先 `npm run build` 再用 `bin/loop-agent.js`：bin 内置 stale-dist 守卫（src 比 dist 新即硬失败，`--ignore-stale-dist` 逃生），`--version` 会显示构建 git SHA，发布/自测前用它确认跑的是目标改动。
+
+文档站变更：`npm run docs:build`。init / architecture / skill entry / pack 定向验证见 verification-matrix。
+
+## 交接
+
+记录：改了什么、为什么、验证命令与结果、契约/文档/测试影响、剩余风险、后续工作。
+
+## 禁止事项
+
+- 未读相关文档就大改；一次混合无关重构/新功能/文档大迁移。
+- 把对话约束当长期知识；缺验证宣称完成；假设系统没有某能力（先搜索）。
+- stub/假数据通路替代交付；把本机绝对路径写入仓库级 AGENTS/README/模板/发布包。
+- 只更新本仓库体验而遗漏目标项目 init 体验。

package/CHANGELOG.md

@@ -1,36 +1,34 @@
 # 更新日志
 
-## [Unreleased]
-
-## [0.35.1-beta.0] - 2026-08-14
-
-### 重点更新
-
-- Operator Chat 新增长跑 DAG 自主监督能力，通过只读 `operationWait`、canonical heartbeat 与有界退避持续监控后台 operation 至真实终态
-- `task advance --approve-gate --json` 新增 stderr 周期进度，同时保证 stdout 保持单一最终 JSON
-- `loop-agent init` 收敛 managed `.gitignore` 与运行态目录迁移评估，并保留项目自有 Pi routing
-- Operator Chat `/` 命令面板升级为响应式 3/2/1 列卡片网格，补齐参数命令、动态目录与键盘/IME 行为
+## [0.35.1-beta.2] - 2026-08-14
 
-### 新增
+> frontend-implementation DAG 优化 v9 全六阶段 + Console 展示层（beta，发布到 `beta` dist-tag）。
 
-- Operator Chat 长跑 DAG 监督 P0-P2：新增只读、model-callable、无需 Human Gate 的 `operationWait` action/tool（复用 operation event store 的 `listFrom`/`subscribe`，订阅先于复查防竞态；已有事件/终态/needs-reconcile 立即返回，首个新事件立即 settle，超时返回 `timedOut:true` 摘要而非命令失败，NOT_FOUND/EVENT_CURSOR_EXPIRED 确定性错误；所有路径单次 settle 并清理 timer/listener）。
-- Console operation runner 将 sibling CLI 的 `LoopAgentClient` heartbeat 投影为 canonical `kind: "heartbeat"` operation event（含 `at`、`elapsedMs` 与 operation/action/run/task 安全摘要）；写入失败不终止 sibling CLI/DAG 执行，不改变 DAG runner lease heartbeat 频率。
+## [Unreleased]
 
 ### 改进
 
-- `task advance --approve-gate --json` 运行 DAG 时周期进度只写 stderr（`--quiet` 可关闭），stdout 保持单个 `OperatorCommandResultV1` JSON；新增 `--progress-interval-ms`（下限 1000ms，与 `dag execute` 同语义）与 `--quiet` 参数；observer 仅在 approve 且非 dry-run 时创建，所有终态/异常路径 `finally` dispose，不留 timer。
-- Operator Chat 长跑监督合同统一为 60 → 90 → 120 → 180 秒退避（状态变化后重置 60 秒，疑似 stall 用 30–60 秒复查）；base prompt 与 managed init `AGENTS.md` 模板明确：长跑 DAG 必须经 `prepareDagExecution → runDag → operationId` 由 Console operation 后台持有，禁止前台 Bash 直接 `task advance --approve-gate`、禁止管道 `tail`/`head`、禁止模型自行拼接 `nohup`/`Start-Process`/`start`。
-
-### Init / Upgrade
-
-- `loop-agent init` 的 managed `.gitignore` block 收敛为四条目录级规则（`.harness/`、`.agents/`、`.task-pool/`、`.worktrees/`）：删除旧细粒度规则与反向放行；`scripts/` 与 `ai_workspace/loop-agent/` 保持可提交。旧格式 block 仍由 `check-update` 确定性报告 `refresh-managed-block`，`update --apply-safe` / `upgrade` 应用后收敛，block 外用户规则原样保留。
-- full init 不再生成 `.harness/**/.gitkeep` 占位文件（目录照常创建）。
-- `init upgrade` 在 managed block 收敛后生成只读 gitignore 迁移评估（`.harness/init-upgrades/<run-id>/gitignore-migration.json`）：inventory 已跟踪的 `.harness/**` 与 `.agents/**`，建议 index-only 的 `git rm -r --cached --ignore-unmatch` 命令（只改 index、保留工作区文件）；`.agents` 已跟踪内容触发审查暂停，非 Git 仓库 / git 查询失败 / 存在 staged 条目时 fail closed，controller 不自动修改 Git index。
-
-### Operator Chat
-
-- Operator Chat 斜杠命令面板完成 UI-12 响应式卡片网格：Operator / Pi Web / Extensions / Prompts / Skills 分组按现有 `comfortable / compact / narrow` 容器模式渲染 3 / 2 / 1 列，卡片仅显示真实命令名与最多两行描述；面板头部固定、候选区独立滚动、分组标题 sticky，长命令不会撑宽页面。键盘支持四方向几何导航与最小滚动，hover、`aria-selected`、`aria-activedescendant` 保持同源；IME composition 与结束后 100ms 保护阻止误导航/误接受，完整描述通过 `aria-describedby` 关联。补足 1/2/3 列、跨分组和 shuffled globalIndex 回归测试，并以真实浏览器验证三档列数、无横向溢出及 Operator/extension/prompt/skill 补全路径。
-- 修复 Operator Chat 命令面板缺口：`/name` 与 `/compact` 参数走本地重命名/压缩路径，palette Enter/Tab 对参数命令进入可编辑前缀，动态 Extension/Skill/Prompt 冲突按优先级保留最高来源，动态目录 fail-soft 时保留本地命令并展示可重试 warning；会话标题 tooltip 水平夹紧视口，单条 Markdown 渲染失败仅该消息降级为纯文本。
+- DAG runner 捕获 SIGTERM/SIGINT：外层硬超时或监督层杀进程时，先把 run 写成 `failed` 终态（含 `terminalReason` 与 `finishedAt`）再退出，不再留 orphaned RUNNING；agent-worker 硬超时改为 SIGTERM→宽限 10s→SIGKILL 两级，给终态落盘留窗口
+- prewrite gate 失败结果新增机器可读 `failureCode`（如 `mock-strategy-outside-allowed`、`verdict-not-pass`、`contract-invalid` 等），失败场景强制非空，下游路由不再解析散文
+- plan 节点的契约自校验改为 `schemaId → validator` 注册表（`contract-output-registry`），新增契约无需改 executor；契约 schema 层新增深度 null 归一（`z.preprocess` 递归删 null），模型对可选字段吐 null 不再炸 strict schema，必填字段 null 仍以清晰 Required 报错
+- VERDICT 归一更宽容：`VERDICT:pass`（缺空格）、尾部句号/感叹号等漂移在节点级即归一，减少无谓的 protocol-invalid 重试
+- 构建写入 `dist/build-stamp.json`（git SHA + 时间），`loop-agent --version` 显示构建来源；`bin/loop-agent.js` 在源码树内运行且 dist 落后于 src 时硬失败（`--ignore-stale-dist` 逃生），杜绝「改了没生效」的陈旧产物事故
+
+- `frontend-implementation` DAG 删除冗余的 `frontend-contract-json-pi` 与 `frontend-contract-json-validate-shell` 两个节点，`frontend-prewrite-gate-shell` 直接消费 plan/revision 的 candidate JSON，成为 candidate → canonical 的唯一转换点（standard 17→15、small 15→13、green path 13→11 节点 / 8→7 Pi）
+- prewrite gate 新增 `frontend-prewrite-result-v1` 分类 artifact（accepted / accepted-normalized / retryable-invalid / blocked），blocked/retryable-invalid 先落 artifact 再以结构化结果返回
+- 新增两层 writer 前置门禁：scheduler admission + executeDagNode 运行前 guard，仅在 classification 为 accepted/accepted-normalized 时放行 writer，否则 SKIPPED + `frontend-prewrite-not-authorized`，writer provider 调用次数为 0
+- 终态聚合对 candidate-contract-invalid / prewrite-blocked 强制 `failed`，防止「prewrite FINISHED + writer SKIPPED」误判 partial_failed
+- 删除 contract-json 节点后，frozen command label 提醒与 requirement coverage 指令迁移进 `frontend-plan-pi` / `frontend-plan-revision-pi` 提示，模型侧引导不丢失
+- `frontend-repair.ts` 的失败分类从 nodeId/stdout/stderr 字符串启发式改为结构化证据（verificationTargetId / commandLabel → commandCategory / exitCode / traceRef / changedPaths），字符串匹配降级为兜底
+- `review` 失败不再默认可自动修复：只有 finding 同时具备明确文件、行或符号、requirement/AC 且修复范围 ⊆ writeSet、不需重新规划 contract 时才进入自动 repair，否则转人工
+- `frontendRepairAssessment` 扩展结构化证据字段（verificationTargetId / commandLabel / exitCode / commandCategory / requirementIds / acceptanceCriteriaIds / fixScope / changedPaths / traceRef），缺必要证据时不再判定 repairable
+- `frontend-implement-pi` 与 `frontend-repair-pi` 共享同一 prompt builder / contract loader / writeSet guard，仅 phase 与 baseline 不同
+- 新增 `frontend-recovery-state-v1` / `frontend-recovery-result-v1` 类型与 schema；prewrite 判定 retryable-invalid 时不再直接失败，改为 parent 先终态收敛、写 recovery intent（phase=child-staging）
+- 新增 candidate continuation：带 commit point 的 staged child 创建（staging 目录 + rename + activation marker + requestId 幂等）、facts import 与 reset closure，parent/child 以 recoveryRootRunId 归一到同一全链统计
+- scheduler 对 recovery child 施加 activation marker 门禁（无有效 marker 不可调度/执行），fail-closed；continuation 配额按 root 统一限制（至多一次）
+- 新增 writer transient rollback 基元（`frontend-writer-rollback.ts`）：writeSet 内容快照（existing files + allowed-new）、逐文件 CAS 恢复（current hash 与 attempt hash 一致才恢复，否则 auto-recovery-blocked，禁止 `git reset --hard`）、可恢复事务式 rollback journal（pending→restoring→completed|blocked，含崩溃恢复 hash/CAS 重判）
+- 接入 writer transient partial-write 自动恢复（`frontend-writer-recovery.ts`）：writer provider 调用前捕获 baseline 快照、调用后记录 attempt 变更；终态聚合时对 transient partial write 先 CAS 回滚、再写 recovery intent 并顺序创建 child（重跑 `frontend-implement-pi`，导入上游 facts）；回滚无法证明完整 → `auto-recovery-blocked`，不建 child
+- 新增 frontend recovery root manifest（`frontend-recovery-root-manifest-v1`）：全链按 `recoveryRootRunId` 去重统计（parent/child 不重复计），`recovered` 收敛为逻辑 `finished`；6 个 outcome（none/recovered/candidate-contract-invalid/prewrite-blocked/repair-exhausted/auto-recovery-blocked）映射到稳定 recovery CTA
 
 ## [0.35.0] - 2026-08-13