@tea-agent/loop-agent 0.14.0 → 0.15.0

package/docs/exec-plans/active/README.md

@@ -1,13 +0,0 @@
-# 进行中的执行计划
-
-本目录存放当前进行中的 execution plan。
-
-源码仓库可在本 README 旁保留具体 active plan 文件。npm 包只携带本 README 作为目录契约，不复制 loop-agent 源码历史的 active plan；目标仓库自行生成 active plan。
-
-当前 active execution plan：
-
-- [`2026-07-18-nightly-auto-release.md`](2026-07-18-nightly-auto-release.md) — 夜间自动发布：距上次 tag ≥3 commits → GitHub Release + npm（内部测试阶段复用人工发布规则；全自动执行、次日上午人工核对；**active**）
-- [`2026-07-16-recursive-self-improvement-eval-lab.md`](2026-07-16-recursive-self-improvement-eval-lab.md) — Eval Lab：**M0+M1+M2(W2.1–W2.3) done**；W2.4 alias/promotion 与 M3+ live campaign 仍 todo（设计真源 `docs/design/recursive-self-improvement-eval-lab.md`；CHANGELOG `[Unreleased]`）
-- [`2026-07-16-frontend-mock-node.md`](2026-07-16-frontend-mock-node.md) — 前端 DAG Mock 策略节点与安全验证
-
-- 已归档：`../completed/2026-07-18-observe-ops-surface-and-rich-timeline.md`、`../completed/2026-07-16-fe-test-dag.md`、`../completed/2026-07-17-frontend-implementation-capability-deepening.md`、`../completed/2026-07-17-backend-test-capability-deepening.md`、`../completed/2026-07-16-backend-test-remediation.md`、`../completed/2026-07-16-frontend-demand-auto-routing.md`、`../completed/2026-07-16-frontend-mock-data-workflow.md`、`../completed/2026-07-14-knowledge-sync-and-graph.md`、`../completed/2026-07-15-repair-artifact-gate-runtime-contract.md`、`../completed/2026-07-14-observe-ui-r5.md`、`../completed/2026-07-14-observe-ui-r4.md`、`../completed/2026-07-14-observe-ui-r3.md`、`../completed/2026-07-14-observe-ui-r2.md`、`../completed/2026-07-14-observe-ui-r1.md`、`../completed/2026-07-14-init-canonical-layout.md`、`../completed/2026-07-12-observe-warm-console-redesign.md`、`../completed/2026-07-14-website-docs-ia-and-converge.md`、`../completed/2026-07-13-versioned-self-hosting-bootstrap.md`、`../completed/2026-07-12-pi-only-agent-runtime.md`、第二月 M2-01～M2-08、`../completed/2026-07-11-observe-dashboard-page-system.md`、`../completed/2026-07-11-observe-dashboard-detail-refinement.md`、`../completed/2026-07-11-observe-terminal-dag-kpi.md`、`../completed/2026-07-11-observe-polling-efficiency.md`、`../completed/2026-07-11-command-performance-guardrails.md` 及更早计划。

package/docs/exec-plans/completed/README.md

@@ -1,108 +0,0 @@
-# 已完成的执行计划
-
-实现与验证结束后，已完成计划移入此目录。
-
-npm 包携带本 README 作为目录契约。具体 completed plan 属于目标仓库历史，不从 loop-agent 源码历史复制。
-
-- [`2026-07-18-observe-ops-surface-and-rich-timeline.md`](2026-07-18-observe-ops-surface-and-rich-timeline.md) — Observe 资源池运营面、总览执行面重排、检查器半屏宽度与富执行过程时间线（含 `recordedAt`）
-- [`2026-07-16-fe-test-dag.md`](2026-07-16-fe-test-dag.md) — FE-test RAG：`taskKind: "frontend-test"` 串行浏览器用例/证据 DAG（MVP + PR #25；prompt 深度 / 真实 browser smoke 等 residual 另开）
-- [`2026-07-17-frontend-implementation-capability-deepening.md`](2026-07-17-frontend-implementation-capability-deepening.md) — frontend-implementation Contract/trace/repair、风险裁剪、React/Next/Vue capability、a11y/openSpec seed（M0–M6 核心完成；W2.7/W3.8/W6.8 residual）
-- [`2026-07-17-backend-test-capability-deepening.md`](2026-07-17-backend-test-capability-deepening.md) — backend-test 执行合同、结果分类、Case Manifest/Traceability 与 M4 docs/init/tmpdir smoke 收敛（M0–M4 全完成）
-- [`2026-07-17-review-findings-remediation.md`](2026-07-17-review-findings-remediation.md) — 收敛主干 review findings
-- [`2026-07-16-frontend-mock-data-workflow.md`](2026-07-16-frontend-mock-data-workflow.md) — 前端 Mock 数据治理链
-- [`2026-07-16-frontend-demand-auto-routing.md`](2026-07-16-frontend-demand-auto-routing.md) — 前端需求确定性自动路由
-- [`2026-07-16-dag-source-binding-recovery.md`](2026-07-16-dag-source-binding-recovery.md) — DAG 任务源绑定与恢复门禁
-- [`2026-07-16-backend-test-remediation.md`](2026-07-16-backend-test-remediation.md) — backend-test 报告、writeSet 与 prompt 修复
-- [`2026-07-14-knowledge-sync-and-graph.md`](2026-07-14-knowledge-sync-and-graph.md) — knowledge-sync 与知识图谱 MVP 完成归档
-- [`2026-07-16-target-agents-routing-observe.md`](2026-07-16-target-agents-routing-observe.md) — 让根与初始化目标 AGENTS 正确路由后端测试，并提供本地只读看板入口和安全更新回归
-- [`2026-07-16-init-upgrade-continuity.md`](2026-07-16-init-upgrade-continuity.md) — 修复 apply-safe 降级 recorded state、补齐 knowledge taskKind/公共 CLI 指引，并将 kb runtime scripts 纳入 packageRequired
-- [`2026-07-15-repair-artifact-gate-runtime-contract.md`](2026-07-15-repair-artifact-gate-runtime-contract.md) — 显式 `repairNodeId` + 严格 repair writer 契约、DagSpec `runtimeContract` capability preflight，以及 run-owned controller identity（resume 漂移 fail-closed）
-- [`2026-07-14-backend-test-dag-template.md`](2026-07-14-backend-test-dag-template.md) — 通过 `taskKind: "backend-test"` 生成需求分析、功能用例、pytest 自动化、执行与复盘的 Pi-only 专用 DAG
-- [`2026-07-14-observe-ui-r5.md`](2026-07-14-observe-ui-r5.md) — Observe 原生 ES module 拆分、四态 helper、Pool hash 筛选与入口 re-export
-- [`2026-07-14-observe-ui-r4.md`](2026-07-14-observe-ui-r4.md) — Observe Batch/Pool 有界事件时间线、cursor/limit、JSONL 容量与投影 fault-first
-- [`2026-07-14-observe-ui-r2.md`](2026-07-14-observe-ui-r2.md) — Observe Batch / Worker Run 证据化详情、三层只读结构与安全 artifact preview
-- [`2026-07-14-observe-ui-r3.md`](2026-07-14-observe-ui-r3.md) — Observe Feature 决策详情、copy-only 建议命令与 canonical 对象关系导航
-- [`2026-07-14-observe-ui-r1.md`](2026-07-14-observe-ui-r1.md) — Observe 资源池总览、Task 下钻、精确对象关联与有界 run history
-- [`2026-07-14-init-canonical-layout.md`](2026-07-14-init-canonical-layout.md) — 目标项目治理资料统一到 `ai_workspace/loop-agent/` 与 `.agents/skills/`，并为旧布局提供保守安全迁移
-- [`2026-07-14-self-update-notifier-implementation.md`](2026-07-14-self-update-notifier-implementation.md) — 实现 loop-agent CLI 自更新提醒，覆盖拒绝版本、精确安装、npm global 来源证明和验证收口
-- [`2026-07-12-observe-warm-console-redesign.md`](2026-07-12-observe-warm-console-redesign.md) — 以暖白、细边界和高密度信息架构重构 Observe Dashboard；多轮细节调整后按用户确认收口归档。
-- [`2026-07-14-website-docs-ia-and-converge.md`](2026-07-14-website-docs-ia-and-converge.md) — Website 文档信息架构、双树边界与 `docs-converge` 同步机制
-- [`2026-07-14-frontend-spec-source-fallback.md`](2026-07-14-frontend-spec-source-fallback.md) — 统一前端规范来源为知识库优先、失败后强制检索当前项目 `openSpec/`
-- [`2026-07-13-test-environment-stability.md`](2026-07-13-test-environment-stability.md) — 修复 Windows Git Bash、npm CLI 启动与 Git/Delivery 测试资源分类，避免验证节点反复失败并跳过 DAG 收口
-- [`2026-07-13-sdd-embedded-skills.md`](2026-07-13-sdd-embedded-skills.md) — 目标项目 repo-local SDD skills 的可选 DAG 节点嵌入增强，loop-agent 保持流程、状态与写边界控制
-- [`2026-07-13-frontend-skill-contracts.md`](2026-07-13-frontend-skill-contracts.md) — 补齐前端节点 Skill 的输入、输出、证据与阻断契约，并预留组件/设计知识库接入 TODO
-- [`2026-07-13-versioned-self-hosting-bootstrap.md`](2026-07-13-versioned-self-hosting-bootstrap.md) — 固定已发布 controller identity、冻结 run-owned skills，并由隔离候选包完成 deterministic self-hosting takeover canary
-- [`2026-07-12-pi-only-agent-runtime.md`](2026-07-12-pi-only-agent-runtime.md) — 将 DAG、Loop、Delegate 和 Worker 收敛为 Pi-only 受治理 runtime，仅保留独立的 one-shot `cursor-prompt` sidecar
-- [`2026-07-11-m2-01-feature-review-model.md`](2026-07-11-m2-01-feature-review-model.md) — 第二月首个纵向切片：严格派生 Feature 状态、AC/Delivery/Closeout 证据与只读 `feature review`
-- [`2026-07-12-m2-02-feature-run-orchestration.md`](2026-07-12-m2-02-feature-run-orchestration.md) — Feature 级 dry-run 与复用现有 Worker pipeline 的薄编排入口
-- [`2026-07-12-m2-03-follow-up-tracer-bullet.md`](2026-07-12-m2-03-follow-up-tracer-bullet.md) — ProductBug 失败到人工批准 FIX、依赖重连、Ready 与 verified lineage 的纵向闭环
-- [`2026-07-12-m2-04-follow-up-hardening.md`](2026-07-12-m2-04-follow-up-hardening.md) — 全 failure-category ActionCard/TaskDraft、EnvFailure 阈值、supersede 与审批事务故障回滚
-- [`2026-07-12-m2-05-git-transaction.md`](2026-07-12-m2-05-git-transaction.md) — Feature branch checkpoint、失败证据/恢复、ignored 隔离与事务完整性
-- [`2026-07-12-m2-06-delivery-closeout-preview.md`](2026-07-12-m2-06-delivery-closeout-preview.md) — Delivery Package、canonical AC evidence 与只读 Closeout gates
-- [`2026-07-12-m2-07-feature-decision-metrics.md`](2026-07-12-m2-07-feature-decision-metrics.md) — 共享 Feature Decision Summary、Observe 层级、corruption 降级与月度 metrics
-- [`2026-07-12-m2-08-closeout-dogfood-release.md`](2026-07-12-m2-08-closeout-dogfood-release.md) — Closeout apply、第二真实 Feature、真实 Follow-up 恢复、package/init/browser 与月度收口证据
-- [`2026-07-11-observe-dashboard-page-system.md`](2026-07-11-observe-dashboard-page-system.md) — 完成 Observe 全页面信息层级与桌面布局优化，按用户确认收口归档。
-- [`2026-07-11-observe-dashboard-detail-refinement.md`](2026-07-11-observe-dashboard-detail-refinement.md) — 完成 DAG 详情输出、依赖图与执行过程的轮询状态保持和桌面节点布局优化，按用户确认收口归档。
-- [`2026-07-11-observe-terminal-dag-kpi.md`](2026-07-11-observe-terminal-dag-kpi.md) — 修复终态 DAG 因遗留未执行节点被误计为活跃的问题。
-- [`2026-07-11-observe-polling-efficiency.md`](2026-07-11-observe-polling-efficiency.md) — 完成详情页终态停轮询、非重叠调度和后台降频。
-- [`2026-07-11-command-performance-guardrails.md`](2026-07-11-command-performance-guardrails.md) — 完成命令并发参数、串行验证与 Observe SSE 的资源峰值护栏。
-- [`2026-07-11-command-performance-followups.md`](2026-07-11-command-performance-followups.md) — 完成 Observe 快照复用、命令输出有界缓冲和 reference index 遍历优化。
-- [`2026-07-02-loop-agent-subject-restructure.md`](2026-07-02-loop-agent-subject-restructure.md) — 将原 `tools/code-agent` runtime 提升到仓库根、重命名为 `loop-agent`，移除旧 memory plugin 产品线
-- [`2026-07-04-remove-level1-fallback.md`](2026-07-04-remove-level1-fallback.md) — 移除历史顺序 Level 1 fallback，runtime、文档与 command surface 收敛到 DAG 执行
-- [`2026-07-04-runtime-boundary-remediation.md`](2026-07-04-runtime-boundary-remediation.md) — 整合 CLI/skill/runtime 边界，抽出 DAG/Loop runtime seam，集中 harness store/guard 策略
-- [`2026-07-10-next-stage-worker-evidence.md`](2026-07-10-next-stage-worker-evidence.md) — Worker retry、EnvFailure、边界治理、初始化投影与真实 BE/FE/QA dogfood evidence 闭环
-- [`2026-07-10-release-0.6.0-nightly-drill.md`](2026-07-10-release-0.6.0-nightly-drill.md) — 发布 0.6.0、首轮夜间演练（6 worker runs / 3 success）、Observe 过程时间线验证；C6 owner gate 由 Round 3 morning decision 满足后正式关闭
-- [`2026-07-10-harness-json-schema.md`](2026-07-10-harness-json-schema.md) — 新增 `harness.json` IDE JSON Schema、初始化投影、旧项目 update 修复和漂移防护
-- [`2026-07-11-interactive-ui-writer-routing.md`](2026-07-11-interactive-ui-writer-routing.md) — 新增 interactive-ui writer-only HIGH 路由、UI 交付契约、真实 React dogfood fixture 与 Round-2 A/B/C 实验入口
-- [`2026-07-11-round-2-interactive-ui-productization.md`](2026-07-11-round-2-interactive-ui-productization.md) — 完成 owner gate、0.7.0–0.7.4 发布、React A/B/C、20 个 Worker runs、外部 nightly、产品线模板与 docs CI
-- [`2026-07-11-observe-dag-visualization.md`](2026-07-11-observe-dag-visualization.md) — Observe 投影 canonical DAG edges，新增确定性 SVG 依赖图、节点交互、视觉 tokens、可访问性与真实 Chrome smoke
-- [`2026-07-04-dag-role-skill-alignment.md`](2026-07-04-dag-role-skill-alignment.md) — 对齐 DAG/Dynamic Workflow role 与 repo-local vetted skills，新增 strict skill audit
-- [`2026-07-06-production-readiness-hardening.md`](2026-07-06-production-readiness-hardening.md) — 冻结 Production Readiness v0.1，打磨 DAG 主路径 next steps、failure routing、doctor/report/failure handoff 与 dogfood 验证
-- [`2026-07-08-taskspec-schema-validate.md`](2026-07-08-taskspec-schema-validate.md) — 新增 TaskSpec v0.1 schema、三层校验器、risk→complexity 映射和 5 个 dogfood TaskSpec 样例
-- [`2026-07-08-acceptance-taskgraph-ready.md`](2026-07-08-acceptance-taskgraph-ready.md) — 新增 AcceptanceSpec / TaskGraphSpec schema、Feature graph 校验、环检测和 Ready 队列计算
-- [`2026-07-08-profile-mapping-agent-worker-cli.md`](2026-07-08-profile-mapping-agent-worker-cli.md) — 新增 business profile 到 loop-agent profile 映射、独立 `agent-worker` CLI 和 package bin surface
-- [`2026-07-08-loop-agent-client-contract-smoke.md`](2026-07-08-loop-agent-client-contract-smoke.md) — 新增 LoopAgentClient、command artifact、JSON parse failure、repo resolver/preflight 与 Ring 0 CLI contract smoke
-- [`2026-07-08-materializer-ring1-dag.md`](2026-07-08-materializer-ring1-dag.md) — 新增 TaskSpec materializer、materialize manifest、coverage-safe source 输出与 Ring 1 DAG generate/validate/dry-run smoke
-- [`2026-07-08-run-task-pipeline-ring2.md`](2026-07-08-run-task-pipeline-ring2.md) — 新增 Worker run-task pipeline、task-local run record、成功/失败分流与 Ring 2 shell-only DAG success/failure smoke
-- [`2026-07-08-task-pool-morning-report.md`](2026-07-08-task-pool-morning-report.md) — 新增 Worker Task Pool JSONL/state store、failure routing、串行 batch run-ready 和 morning report
-- [`2026-07-08-taskspec-worker-master.md`](2026-07-08-taskspec-worker-master.md) — 完成 TaskSpec + Worker 7 步 master 编排，覆盖 schema、graph、profile、client、materialize、run-task、Task Pool 和 morning report
-- [`2026-07-10-obs-001.md`](2026-07-10-obs-001.md) — WorkerEvent schema 与 append-only event/snapshot store
-- [`2026-07-10-obs-002.md`](2026-07-10-obs-002.md) — LoopAgentClient 流式输出、heartbeat 与实时 artifact
-- [`2026-07-10-obs-003.md`](2026-07-10-obs-003.md) — composite progress 与 Worker pipeline 事件打点
-- [`2026-07-10-obs-004.md`](2026-07-10-obs-004.md) — observability snapshot read model
-- [`2026-07-10-obs-005.md`](2026-07-10-obs-005.md) — 本地只读 observe HTTP/SSE server
-- [`2026-07-10-obs-006.md`](2026-07-10-obs-006.md) — Dashboard、Batch Detail 与 Run Detail UI
-- [`2026-07-10-obs-007.md`](2026-07-10-obs-007.md) — run-dag JSONL events 与 composite observer
-- [`2026-07-10-obs-008.md`](2026-07-10-obs-008.md) — Worker DAG events 接线与 DAG Detail UI
-- [`2026-07-10-obs-009.md`](2026-07-10-obs-009.md) — stale、quiet 与 timeout-risk 诊断
-- [`2026-07-10-obs-010.md`](2026-07-10-obs-010.md) — Failure Inbox、文档、package surface 与 smoke 验证
-- [`2026-07-10-observe-ui-review-remediation.md`](2026-07-10-observe-ui-review-remediation.md) — 修复 Observe UI 事件链路、历史 run 投影、artifact 安全边界与失败状态展示
-
-- [`2026-07-13-exec-plan-lifecycle.md`](2026-07-13-exec-plan-lifecycle.md)
-
-- [`2026-07-15-task-pool-priority-aware-ready-planner.md`](2026-07-15-task-pool-priority-aware-ready-planner.md)
-- [`2026-07-15-task-pool-v2-feature-scoped-task-identity.md`](2026-07-15-task-pool-v2-feature-scoped-task-identity.md)
-- [`2026-07-15-init-update-surface-coverage.md`](2026-07-15-init-update-surface-coverage.md)
-- [`2026-07-15-readonly-node-retry.md`](2026-07-15-readonly-node-retry.md)
-
-- [`2026-07-16-init-natural-language-routing.md`](2026-07-16-init-natural-language-routing.md)
-
-- [`2026-07-16-observe-inspector-node-consistency.md`](2026-07-16-observe-inspector-node-consistency.md)
-
-- [`2026-07-16-repair-artifact-pass-normalization.md`](2026-07-16-repair-artifact-pass-normalization.md)
-
-- [`2026-07-16-decision-envelope-fence-tolerance.md`](2026-07-16-decision-envelope-fence-tolerance.md)
-
-- [`2026-07-16-decision-envelope-prompt-contract.md`](2026-07-16-decision-envelope-prompt-contract.md)
-
-- [`2026-07-17-source-target-structure-alignment.md`](2026-07-17-source-target-structure-alignment.md)
-
-- [`2026-07-17-review-findings-remediation.md`](2026-07-17-review-findings-remediation.md)
-
-- [`2026-07-16-backend-test-analysis-contract-artifact.md`](2026-07-16-backend-test-analysis-contract-artifact.md)
-
-- [`2026-07-17-release-0130-reconcile.md`](2026-07-17-release-0130-reconcile.md)
-
-- [`2026-07-17-observe-dashboard-incremental-polling.md`](2026-07-17-observe-dashboard-incremental-polling.md)
-
-- [`2026-07-18-origin-main-merge-43e86ad.md`](2026-07-18-origin-main-merge-43e86ad.md)

package/docs/feature-workflow.md

@@ -1,414 +0,0 @@
-# 功能工作流
-
-本文档区分两层：
-
-- **Session governance**：监督方（人/agent）如何组织一次工作会话
-- **Runtime workflows**：`src/workflows/` 下代码实际执行的内容
-
-## 默认会话协议
-
-1. **Orient**：读 `README.md`、`harness.json` 与本 docs 索引
-2. **Select**：选一个有限边界的工作块
-3. **Contract**：写明交付物、非目标、完成标准、验证命令、失败条件
-4. **Implement**：做最小连贯变更，同步更新必要文档、脚本与测试
-5. **Verify**：按 `verification-matrix.md` 跑命令；完成声明用新鲜输出
-6. **Handoff**：在 `ai_workspace/loop-agent/progress/`、`ai_workspace/loop-agent/reports/`、exec plan 或 ADR 中记录证据
-
-## Orient
-
-先理解当前系统，不要默认「没有」：
-
-- 读 `harness.json` 列出的仓库入口
-- 查 `git status --short --branch` 与最近提交
-- 新增结构前搜索现有源码、测试、脚本、文档与模板
-- 任务依赖健康基线时跑最小基线检查
-- 涉及 TDD、完成声明或调试时读方法论文档
-
-基线已坏时，记录失败命令，并决定当前块是修基线还是在明确范围内接受已知失败。
-
-## Select
-
-工作块要窄到可验证。避免无关重构、功能与文档迁移混在一起。
-
-选中的块应有：
-
-- 单一用户可见或维护者可见结果
-- 委托写工作时显式 allowed paths
-- 已知非目标
-- 能证明结果的验证命令
-
-## Contract
-
-非平凡工作应在实现前写或更新 execution plan、sprint contract、progress log 或 issue 级笔记。Contract 应包含：
-
-- 交付物
-- 非目标
-- 验收标准
-- 验证命令
-- 失败条件
-- 预期更新的 artifacts
-
-Bug 修复的 contract 应含复现路径，以及证明修复的回归测试或 smoke check。
-
-## Implement
-
-做满足 contract 的最小连贯变更。
-
-- 优先现有 helper 与目录边界
-- 行为变更更新测试
-- 工作流或命令变更更新文档与示例
-- 治理变更更新 `harness.json`、检查脚本或模板
-- 不把占位实现当作已完成
-- 重复约束出现时固化为持久产物
-
-## Verify
-
-验证是完成权威。
-
-- 用 `ai_workspace/loop-agent/verification-matrix.md` 选最窄的证明命令
-- 完整重跑命令
-- 读 exit code 与输出
-- 修失败或报告确切失败状态
-- 不用陈旧输出或部分检查声明完成
-
-## Agent DAG First
-
-复杂实现优先 DAG 工作流：
-
-```bash
-loop-agent new-task <task-id> "Task title"
-loop-agent dag run-task <task-id> --profile auto --strict-models --output <temp-dir>/<task-id>-dag.json
-loop-agent dag validate --dag <temp-dir>/<task-id>-dag.json --strict-models --strict-governance
-loop-agent run-dag --dag <temp-dir>/<task-id>-dag.json --cwd .
-```
-
-`<temp-dir>` 为平台原生临时目录。macOS/Windows 上实际文件操作用原生路径；`/` 仅用于稳定 repo 引用、JSON/Markdown 证据引用和 glob 约定。
-
-## 业务模板（taskKind）与治理 Profile
-
-这两层要分开：
-
-| 层 | 入口 | 作用 | 合法取值 |
-|----|------|------|----------|
-| 业务模板 | `task.json.taskKind` | 选专用 DAG 节点链 | `standard` / `frontend-implementation` / `frontend-test` / `backend-test` / `knowledge-sync` / `knowledge-graph-bootstrap` 等 |
-| 治理 profile | `dag run-task --profile` | 风险与流程强度 | **仅** `auto` / `minimal` / `standard` / `reviewed` / `supervised` |
-
-专用业务流水线**不要**写成 `--profile frontend-test` / `--profile backend-test` / `--profile knowledge-sync` / `--profile knowledge-graph-bootstrap`：CLI 会拒绝这些值。正确做法是写 `task.json.taskKind`（`knowledge-sync` 还须 `featureId`）。
-
-| 用户描述关键词 | 正确入口 | 模板 |
-|--------------|----------|------|
-| 后端测试、接口测试、pytest 自动化 | `taskKind: "backend-test"` | backend-test-dag |
-| 前端功能测试、浏览器测试、Playwright CLI | `taskKind: "frontend-test"` | frontend-test-dag |
-| 前端实现、UI/组件开发 | `taskKind: "frontend-implementation"`（或 standard 下高置信自动分类） | frontend-implementation |
-| 测试知识回写 / 知识同步 | `taskKind: "knowledge-sync"` + `featureId` | knowledge-sync-dag |
-| 业务知识图谱开荒 / 增量 | `taskKind: "knowledge-graph-bootstrap"` | knowledge-graph-bootstrap-dag |
-| 普通实现、修复、功能 | `taskKind: "standard"` + `--profile auto`（默认） | 由 governance / 任务源分类推断 |
-
-**后端测试示例：**
-
-```bash
-loop-agent new-task <task-id> "后端测试任务"
-# 将需求文档放入 .harness/tasks/<task-id>/source/需求.md
-# 将参考文档放入 .harness/tasks/<task-id>/source/references/
-# 在 .harness/tasks/<task-id>/task.json 设置：
-#   { "taskKind": "backend-test", ... }
-loop-agent dag run-task <task-id> --execute --cwd .
-# 需要收紧治理时再叠加合法 profile，例如：
-# loop-agent dag run-task <task-id> --profile supervised --execute --cwd .
-```
-
-这不是线性 OS-CIVH runtime 状态机。代码里 DAG 有三个命令阶段：
-
-1. `dag run-task` 加载 `.harness/tasks/<task-id>/source/需求.md`、可选 `执行约束.md`、`task.json` 与 adapter 验证命令，写出 DAG spec
-2. `dag validate` 校验 schema、依赖、governance profile、写边界、model routing、shell 验证元数据
-3. `run-dag` 加载 DAG、按拓扑排序为 ranks、有界并发执行可运行节点、持久化到 `.harness/dag-runs/<lifecycle>/<run-id>/`，并转入 `completed` 或 `paused`
-
-标准生成的 hybrid DAG 固定为 Pi-only writer：
-
-```text
-contract-pi
-  -> scout-src + scout-tests
-  -> plan-pi
-  -> implement-pi
-  -> verify-shell
-  -> verify-pi
-  -> closeout-pi
-```
-
-`implement-pi` / `repair-pi` 使用 `executor: "pi"` 与 `toolProfile: "write"`。受治理 runtime 不再生成或接受 `implement-cursor` / `repair-cursor`；旧 Cursor DAG 会在 schema 校验阶段失败，需要重新生成。
-
-专用模板选择与 governance profile 是两层独立路由。显式声明的专用 `taskKind` 始终优先；对于默认 `standard` 任务，生成器会根据任务标题、`source/需求.md` 和结构化 `allowedPaths` 做保守、确定性的需求分类。只有高置信的前端实现需求才自动选择 `frontend-implementation` 模板；由显式 profile、`workflowPolicy` 或 supervised quality gate 选中的 supervised 模板不会被自动分类降级。后端、前后端混合、明确排除前端或无法可靠判断的需求继续使用 governance profile 选出的通用模板，绝不会自动进入 `backend-test-dag`。已有 `taskKind: "frontend-implementation"` 继续作为兼容入口和有意覆盖：
-
-```text
-frontend-contract-pi
-  -> frontend-scout-pi
-  -> frontend-mock-assess-pi
-  -> frontend-mock-contract-gate-shell
-  -> frontend-plan-pi
-  -> [frontend-design-gate-pi -> frontend-first-design-gate-shell -> frontend-plan-revision-pi]  # small risk 可裁剪
-  -> [frontend-requirement-coverage-shell]
-  -> frontend-implementation-contract-shell
-  -> frontend-final-design-review-pi
-  -> frontend-final-design-gate-shell
-  -> frontend-implement-pi
-  -> [frontend-mock-verify-shell]
-  -> frontend-static-verify-shell
-  -> frontend-behavior-verify-shell
-  -> frontend-verification-trace-shell
-  -> frontend-failure-assess-shell
-  -> frontend-repair-contract-shell
-  -> frontend-repair-pi
-  -> frontend-static-reverify-shell
-  -> frontend-behavior-reverify-shell
-  -> frontend-verification-retrace-shell
-  -> frontend-review-pi
-  -> frontend-review-gate-shell
-  -> frontend-closeout-pi
-```
-
-`frontend-mock-assess-pi` 是 contract/scout 之后、plan 之前的只读策略节点。它先确认接口契约与后端就绪度，再按项目能力选择已有原生 Mock、浏览器拦截、请求适配层或 `not-needed`。static/behavior shell 命令在 DAG 生成时已固化，策略只能选择能由这些入口验证的方案；缺少契约、无法保证生产默认关闭、所选策略没有可执行验证或只能靠注释真实请求时输出 `MOCK_STRATEGY: blocked`。`not-needed` 仍需真实或无远程接口的行为证据。Mock 代码由唯一 writer `frontend-implement-pi` 按已批准计划实现，不增加第二个 writer。
-
-前端链在计划前显示 Mock/API/schema 读取、生成期能力 seed、五态策略和 contract gate。可在 `task.json.frontendMock` 设置 `policy: auto|required|disabled`、安全的 `serviceRoot` 和生成时固化的专项 `verifyCommands`。已有原生服务时优先复用；没有原生能力时可使用现有浏览器拦截或可逆 request adapter。不安全或不完整的显式 required 合同只生成无 writer 的评估 DAG；有可信专项命令时实现后先运行 `frontend-mock-verify-shell`，再进入静态和行为验证。规范读取证据继续显示在 Observe 节点详情中。
-
-新生成 DAG 还会冻结 `sourceBinding`（任务源路径、SHA-256 与显式 `REQ/BR/AC` 编号）。前端任务存在显式编号时，`frontend-requirement-coverage-shell` 只检查 `frontend-plan-revision-pi` 输出的当前生效计划证据，缺少任一编号就阻断最终 design review 和 writer；即使首轮 design review 直接通过，revision 节点也必须复述完整 Requirement Coverage，避免从已被取代的原计划借用编号。DAG 中断后应修复 task source 并重新生成完整 DAG；不要用聊天摘要拼接 impl-only 后半段。严格治理会拒绝没有 `sourceBinding`、也没有只读 planner 上游的 v3 孤立 writer。
-
-这条链在实现前加入两阶段 design gate：首轮 design review 同时接受 `VERDICT: pass` 和 `VERDICT: request-revision`，request-revision 时由只读 `frontend-plan-revision-pi` 消费原计划与 design findings 完成修订，再经 `frontend-final-design-review-pi` 和 `frontend-final-design-gate-shell` 最终门禁；只有最终 `VERDICT: pass` 才授权写入。`MOCK_STRATEGY: blocked`、真实请求被注释、生产默认启用 Mock 或 Mock 与接口契约不一致都不得通过。design gate 失败路由为 `ContractMismatch` / `frontend-plan-revision-and-rerun`，不路由为 `ProductBug` / `dev-fix`。
-
-这条链还将前端静态验证与行为验证分开建模，并在 verify 后增加 verification-trace 与单轮 bounded repair（失败可评估/修复/复验；contract/path/依赖/凭据等不可自动修）。Mock-backed 行为验证只证明页面状态和交互，不证明真实后端已就绪或接口已联通。后端未被实际调用时，closeout 必须写明 `Frontend status: mock-validated`、`Real integration: pending`，并列出 `<task-id>-real-api-integration-verify`。该 follow-up 不会自动创建或运行；后端就绪后需要显式创建/执行新的复验任务。生成期会注入确定性风险分级与 React/Next/Vue 等强证据 capability；a11y 仅在项目已有 lint/axe 类工具时声明 static/component 级证据。当前仍不包含浏览器自动化、视觉回归或 browser-level a11y executor。
-
-后端测试任务只有在显式声明 `task.json.taskKind = "backend-test"` 时才选择专用模板；它面向测试工程，不是普通后端实现模式，也不新增 governance profile：
-
-```text
-analyze-inputs-pi
-  -> backend-test-analysis-contract-shell
-  -> backend-test-environment-scout-pi
-  -> backend-test-execution-contract-shell
-  -> generate-backend-functional-cases-pi
-  -> emit-backend-case-manifest-pi
-  -> backend-test-case-manifest-shell
-  -> review-backend-cases-pi
-  -> review-backend-cases-gate-shell
-  -> generate-backend-pytest-pi
-  -> backend-test-traceability-gate-shell
-  -> execute-backend-pytest-shell
-  -> parse-backend-test-result-shell
-  -> classify-backend-test-result-pi
-  -> test-retrospect-pi
-  -> backend-test-outcome-gate-shell
-```
-
-这条链覆盖后端功能测试从需求分析到复盘评级的全链路流程：
-
-- `analyze-inputs-pi`：只读输出严格的 Backend Test Analysis v1 JSON；`backend-test-analysis-contract-shell` 确定性校验 source binding、AC IDs、schema 与敏感值，并把规范化结果写入当前 run 的 `contracts/backend-test-analysis.json`。gate 节点记录 artifact path / SHA-256 / schema ID，随 lifecycle 目录整体迁移；非法或来源不一致时 fail-closed，后续 case/pytest writers 不执行。
-- `backend-test-environment-scout-pi`（read-only）：发现 pytest 配置、test roots、已有 fixture/client、文档化命令与 env *名称*（禁止全仓搜 secrets）；输出 Backend Test Execution Contract v1 纯 JSON。
-- `backend-test-execution-contract-shell`：`jsonArtifactGate.schemaId=backend-test-execution-v1`，校验并 materialize 当前 run 的 `contracts/backend-test-execution.json`；unknown schemaId / path traversal / secret 值 fail-closed。
-- `emit-backend-case-manifest-pi`（read-only）：从 `testcase/md/**` + 已验证 analysis 产出 Backend Test Case Manifest v1 纯 JSON（模型不写 `.harness/**`）。
-- `backend-test-case-manifest-shell`：`jsonArtifactGate.schemaId=backend-test-case-manifest-v1` → `contracts/backend-test-case-manifest.json`；caseId 唯一/格式、显式 AC 覆盖或 evidenceGaps、未知 AC、skipped 无 gapReason fail-closed；`coverageSummary` 由 gate 确定性计算/核对。
-- `backend-test-traceability-gate-shell`：pytest 生成后、execute 前校验 `generated` 的 file/symbol 存在；skipped/unsupported 必须有 gapReason。
-- `generate-backend-functional-cases-pi`：在 execution gate 之后，只消费已验证 analysis/execution 证据，按契约字段生成结构化后端功能测试用例（Markdown），用例 ID 带 `BE-` 前缀（如 `BE-ORDER-001`），写入 `testcase/md/`
-- `review-backend-cases-pi`：评审后端功能测试用例，输出审查报告 + `VERDICT: pass` / `VERDICT: request-revision`
-- `review-backend-cases-gate-shell`：只有评审首条 verdict 为 `VERDICT: pass` 时才允许继续生成 pytest；`request-revision` 或其它结果 **fail-closed 即停**，**不会**自动回到 generate 节点修订（本模板不启用 convergence；修好用例或约束后重新 `dag run-task`）
-- `generate-backend-pytest-pi`：依赖 review gate **与** execution contract，将功能用例转化为 pytest；可写 `testcase/**/test_*.py` 与可选 `helpers/**`/`factories/**`；只使用已验证 fixture/env name/`testRoot`/API 字段；禁止改 conftest/配置与生产代码
-- `execute-backend-pytest-shell`：先对 `contracts/backend-test-execution.json` 做确定性 preflight（framework、`testRoot` 存在且与生成期冻结的 Adapter 路径一致、required env、external base URL env；`managed-command` 无 sourceRef 证据 fail-closed），再执行 `pytest testcase/`；JUnit 写入 `$HARNESS_DAG_RUN_DIR/reports/backend-test-junit.xml`，原始 `pytestExitCode` 写入 `reports/backend-test-pytest-exit.txt`。当 JUnit 非空且 exit 为 0/1 时节点 FINISHED（断言失败不跳过下游）；禁止改测试源码或生产代码
-- `parse-backend-test-result-shell`：确定性 materialize Backend Test Result v1 → `contracts/backend-test-result.json`（损坏/缺失 JUnit fail-closed）
-- `classify-backend-test-result-pi`：read-only 结构化分类（ProductBug|TestBug|EnvFailure|ContractMismatch|FlakyTest|Unknown）；单次失败不得 FlakyTest；collection/command/report-error 不得 ProductBug
-- `test-retrospect-pi`：在 pass 与 assertion-fail 路径均运行；通过率与失败列表只来自 Result v1；不得把失败改写成通过
-- `backend-test-outcome-gate-shell`：仅以 Result v1 `outcome`/counts 收口；全绿 exit 0，否则非零；忽略 retrospective Markdown
-
-最终验证后的知识库回写可通过 `task.json.taskKind = "knowledge-sync"` 选择专用模板（与 `backend-test` 一样走 taskKind 路由，不占用 governance `--profile`）。
-
-**必须绑定 `featureId`**（fail-closed）。解析顺序：`task.json.featureId` → `hardConstraints` 中 `featureId=F-…` → 需求正文中的 `F-YYYY-NNN` → 若 `taskId` 本身是 `F-*`。生成器会把 writeSet 收窄到 `features/<featureId>/…`，validate 只检查该 Feature 下的 draft。
-
-```json
-{
-  "taskKind": "knowledge-sync",
-  "featureId": "F-2026-004"
-}
-```
-
-```text
-knowledge-sync-collect-pi
-  -> knowledge-sync-draft-pi
-  -> knowledge-sync-validate-shell
-  -> knowledge-sync-review-qa-pi
-  -> knowledge-sync-review-domain-pi      # parallel with qa/evidence
-  -> knowledge-sync-review-evidence-pi
-  -> knowledge-sync-multi-review-gate-shell   # all VERDICT: pass
-  -> knowledge-sync-apply-pi
-  -> knowledge-sync-pointer-pi
-```
-
-这条链在 shell 最终验证证据之后，把稳定事实写入 Feature 测试知识库（L1），而不是把 `.harness` 大日志搬进 docs：
-
-1. **knowledge-sync-collect-pi**：只读汇总 final verification / AC / 用例 / 缺陷 / 需求 delta 候选
-2. **knowledge-sync-draft-pi**：写入 `features/<featureId>/testing/sync/pending/knowledge-sync-draft.json`
-3. **knowledge-sync-validate-shell**：校验该路径 draft 的 schema、`featureId` 一致、operations 目标路径、finalVerification 门禁
-4. **多视角审查（并行）**：QA/验收、领域/产品、证据/审计 三个只读 reviewer；聚合门禁要求全部 `VERDICT: pass`
-5. **knowledge-sync-apply-pi**：仅在 `features/<featureId>/testing/**`（及该 Feature 的 `requirement-delta.md`、`ai_workspace/loop-agent/test-reports/**`）受控回写
-6. **knowledge-sync-pointer-pi**：写 `features/<featureId>/testing/runs/latest.md` 与 `sync/applied/KS-*.json`
-
-设计说明见 `ai_workspace/loop-agent/design/full-chain-test-knowledge-base.md` §11；JSON 示例见 `ai_workspace/loop-agent/templates/knowledge-sync-dag.json`。
-
-业务知识图谱**初始化**可通过 `task.json.taskKind = "knowledge-graph-bootstrap"` 选择专用模板。跑前先落 B1 骨架：
-
-```bash
-loop-agent knowledge graph-init --product-name <name>
-# 编辑 knowledge/bootstrap/scope.yaml 后再 run-task
-```
-
-（需有 `knowledge/bootstrap/scope.yaml` 与 `status.yaml`；`graph-init` 幂等，默认不覆盖已有 scope/status，可用 `--force`。）
-
-图谱索引与 Phase A 查询（package-backed CLI，非 RAG）：
-
-```bash
-loop-agent knowledge graph-materialize
-loop-agent knowledge query --mode by_feature --feature F-2026-004 --json
-loop-agent knowledge query --mode by_id --id SVC-order --json
-loop-agent knowledge query --mode search --text "预占" --json
-```
-
-**增量更新（非全量开荒）**：缩小 scope 后复用同一 `knowledge-graph-bootstrap` DAG（propose 仅针对 seeds/includes；promote 仍默认不覆盖已有正式文件）：
-
-```bash
-loop-agent knowledge graph-incremental-prepare --feature F-2026-004 --service order
-# 可选：--reset-staging
-# 审阅 knowledge/bootstrap/scope.yaml（update_mode: incremental）
-# task.json.taskKind = "knowledge-graph-bootstrap"
-loop-agent dag run-task <id>
-# 如需手工晋升已审阅的 staging，再按顺序执行：
-loop-agent knowledge graph-promote
-loop-agent knowledge graph-materialize
-```
-
-测试知识日常写回仍用 `knowledge-sync`（`featureId` 必填），与图谱增量入口分离。
-
-```text
-kg-bootstrap-preflight-shell
-  -> kg-bootstrap-inventory-shell
-  -> kg-bootstrap-propose-pi
-  -> kg-bootstrap-validate-shell
-  -> kg-bootstrap-review-structure-pi
-  -> kg-bootstrap-review-evidence-pi      # parallel with structure/safety
-  -> kg-bootstrap-review-safety-pi
-  -> kg-bootstrap-multi-review-gate-shell  # all VERDICT: pass
-  -> kg-bootstrap-promote-shell
-  -> kg-bootstrap-materialize-shell
-```
-
-AI 只写 `knowledge/bootstrap/staging/**`；禁止 self-`asserted`；**结构 / 证据 / 边界安全** 三视角审查全部通过后才 promote（默认不覆盖已有正式文件）；materialize 写 `knowledge/graph/` 索引。设计见 `ai_workspace/loop-agent/design/knowledge-graph-ai-bootstrap.md`，示意 JSON 见 `ai_workspace/loop-agent/templates/knowledge-graph-bootstrap-dag.json`。
-
-前端测试模板（`frontend-test-dag`）后续沿用对称命名即可接入。
-前端 shell 验证优先使用任务源 `需求.md` / `执行约束.md` 中声明的前端验证命令，例如 `npm run typecheck`、`npm run build`、`npm test`；解析不到时再使用 adapter 验证命令和模板 fallback。
-
-`verify-shell` 使用 adapter 根据 task verify preset/quota 解析出的最终验证命令，并把新鲜 exit code/stdout/stderr 交给后续只读 verifier。review-gated 模板继续插入：
-
-```text
-verify-shell -> verify-pi -> review-pi -> review-gate-shell -> closeout-pi
-```
-
-supervised 模板在实现路径上增加 write-set audit、有界计划修订、只读 verdict 格式恢复、soft/hard shell 验证、process supervision、有界 repair、decision gates 与可选 convergence retry。初审 `request-revision` 不再直接终止：只读 `plan-revision-pi` 最多修订一轮，再由终审和 pass-only gate 决定是否授权 writer。初审与终审遗漏 `VERDICT:` 时各允许一个只读格式修复节点；格式结论不明确时必须转为 `request-revision`，shell gate 不会从正文猜测 pass。
-
-### 只读 Pi 节点安全重试
-
-所有生成模板都会为安全的只读 Pi 节点（planner/scout/reviewer/verifier/closeout，且 `writePolicy=read-only|none`、非 writer、非 dynamic、非 decision-gate）自动声明默认 `retryPolicy`（总尝试 3 次，手工配置最多 5 次，指数退避，单次等待上限 30s）。supervisor 与 implementer 明确不在资格范围。仅重试 `timeout`、`network`、`rate-limit`、`unavailable`；`quota`、`auth`、`invalid-output`、`write-guard` 与未知失败不重试。每次 attempt 保留独立证据，详见 [ai_workspace/loop-agent/agent-dag-runner.md](./agent-dag-runner.md#retry-read-only-pi-nodes)。
-
-### 可选 repo-local SDD skill 增强
-
-`dag run-task` 会在目标项目的 `.agents/skills/` 中探测三个可选 skill：
-
-- `SDD-requirement-analysis` → `contract-pi`
-- `SDD-design-analysis` → `plan-pi`
-- `SDD-implementation-test-review` → `implement-pi`、`repair-pi`、`verify-pi`、`review-pi`
-
-命中时，skill 通过节点 `skills` 进入现有 resolved instruction 和 run-owned snapshot 链路，并在节点任务中收到 embedded-mode 约束：只为当前 DAG 阶段提供知识、规范与方法，不得更新 `working_requirements_status.md`、推进 SDD 状态、触发 SDD 用户确认或执行归档。节点的读写边界、当前阶段与输出契约优先；writer 仍只允许写入显式 `writeSet`。`SDD-code-spec-init` 与 `SDD-project-how-to-spec-init` 不会在普通功能 DAG 中自动运行。
-
-探测不到这些 repo-local skills 时，DAG 不追加节点 skill 或约束块，保持当前默认流程。用户级或 npm 包内同名 skill 也不会作为自动启用信号。
-
-源码参考：
-
-- `src/commands/dag-run-task.ts`
-- `src/commands/dag-validate.ts`
-- `src/commands/run-dag.ts`
-- `src/workflows/dag/init-hybrid.ts`
-- `src/workflows/dag/sdd-embedded.ts`
-- `src/workflows/dag/runner.ts`
-
-监督 agent 仍负责：
-
-- 写 contract
-- 限定 allowed/forbidden paths
-- 审查 DAG/writeSet 范围
-- 选择验证命令
-- 记录 handoff 证据
-
-声称 Production Readiness v0.1 的低/中风险单仓库任务，另须遵循 `ai_workspace/loop-agent/production-readiness.md` 与 `ai_workspace/loop-agent/templates/production-readiness-checklist.md`。该标准冻结支持范围、非目标、必需 DAG 证据、failure routing 字段与最终验证门禁。
-
-## Exec-plan 生命周期
-
-exec-plan 不是手工文档；它有确定性 CLI 生命周期，并与 `dag run-task` 共享同一索引校验源。
-
-```bash
-loop-agent plan create <plan-id> "<title>"
-loop-agent plan complete <plan-id> --summary "<summary>"
-loop-agent plan check
-```
-
-- `new-task` 不自动绑定 exec-plan；微小任务仍可不创建计划。
-- `plan create` 优先读取目标项目 `<governanceRoot>/templates/exec-plan.md`，不存在时回退到发布包内置模板；create/complete 同步 active/completed 索引，拒绝重复 id、路径穿越与不安全文件名，多文件操作均具备回滚保护。
-- `dag run-task` 在生成 DAG 草稿前运行 `plan check` 同源校验，索引漂移立即失败；空仓库与索引一致的仓库不受影响。
-- `plan list`（只读）与 `docs archive`（兼容入口）保留；`scripts/check-exec-plan-index-sync.sh` 仍作为独立最终防线。
-
-## 已移除的顺序工作流
-
-历史 Level 1 顺序 command surface 已从公开工作流移除。新工作不要用 `loop-agent run analyze|plan|spec|implement|verify|retrospective|auto|loop|continue|study`。
-
-改用 DAG 路径：
-
-```bash
-loop-agent new-task <task-id> "Task title"
-loop-agent dag run-task <task-id> --profile auto --strict-models --output <temp-dir>/<task-id>-dag.json
-loop-agent dag validate --dag <temp-dir>/<task-id>-dag.json --strict-models --strict-governance
-loop-agent run-dag --dag <temp-dir>/<task-id>-dag.json --cwd .
-```
-
-遗留 `.harness/tasks/<task-id>/.workflow_state.json` 在 task status 完全迁移到 DAG 导向读模型前仍可读，但不是新任务完成的权威。
-
-## Outer Loop Runtime
-
-`loop` 命令是长跑任务控制层，与会话治理协议不是一回事。它记录 rounds 与 signals，可跑 shell 验证、Pi review 或 DAG action（review/execute），并选择下一自动 action。自动写入只能通过受治理 Pi-only Agent DAG execute；`loopAutoExecutionPolicy` 控制是否允许自动执行，旧 `loopAutoWritePolicy` 会 fail-fast。
-
-支持的 loop actions：
-
-- `shell-verify`
-- `pi-review`
-- `dag`
-- `record-round`
-- `add-signal`
-- `closeout`
-
-源码参考：
-
-- `src/commands/loop.ts`
-- `src/workflows/loop/actions.ts`
-- `src/workflows/loop/state.ts`
-- `src/workflows/loop/rounds.ts`
-
-## 调试与 TDD
-
-任务需要时使用方法论文档：
-
-- 行为变更与 bug 修复：`ai_workspace/loop-agent/harness-methodology-tdd.md`
-- 完成或 handoff 声明：`ai_workspace/loop-agent/harness-methodology-verification.md`
-- 失败与意外行为：`ai_workspace/loop-agent/harness-methodology-debugging.md`
-
-## Handoff
-
-Handoff 应说明：
-
-- 改了什么
-- 有意未做什么
-- 跑了哪些验证命令
-- 是否影响契约、文档、测试或脚本
-- 剩余风险或后续工作
-
-较大工作应更新 `ai_workspace/loop-agent/progress/`、`ai_workspace/loop-agent/reports/`、active exec plan 或 `ai_workspace/loop-agent/decisions/`，以便下一会话不依赖聊天历史。