@tea-agent/loop-agent 0.1.0-fe-test.0

package/CHANGELOG.md

@@ -0,0 +1,2283 @@
+# 更新日志
+
+## [Unreleased]
+
+### 变更
+
+- frontend-test 用例生成预算与契约：去掉 generate「4–8 条 smoke」软建议；`frontendTest.maxCasesPerBatch` 默认 50、配置最高 100。dimension 不再封闭为 core/boundary/flow/backend，仅校验 kebab-case，允许 `ux` 等扩充。生成 skill/prompt 增加 Playwright 专家角色；标准场景补交互体验（提交防重复、操作反馈为 must）。入库中文优先用例模板 `docs/templates/frontend-test-case.example.md`：需登录则 `open` 登录页再 `goto` 目标页，否则 `open`/`goto` 目标页。
+
+
+- npm `next` 渠道发布改为提交数节流：main push 仅当距上次 next 发布的 source commit ≥ 5 个 commit 时才自动发布（新增 `scripts/next-publish-gate.mjs`，读已发布 tarball build-stamp 对比 HEAD）；不足阈值时 workflow 绿色跳过，手动 `workflow_dispatch` 不受限（切 release 线前强制出包 / 紧急补发）。发布文档真源 §4.1/§5.1/§7/§12 同步。
+
+### 新增
+
+- backend-test 适配 A–D：可配置 `backendTest` 布局（`testRoot`/`markdownRel`/`scriptRel`）、用户公共前置文档引用与模块顶部 `user_shared_setup`（不写 conftest）、查询轴 Scenario Partitions 确定性展开与 fail-closed 门禁、`mode=gap-fill` 13 节点增量 DAG。Slot ID 以声明的 Partition ID 为真源（`TP-<Partition ID>-...`）。
+- 前端 plan 唯一机器契约化（JSON-only）：`frontend-plan-pi` / `frontend-plan-revision-pi` 输出收敛为「一行导语 + 唯一 fenced `json` 契约 + 唯一 `openspec-citations` 引用块」，彻底移除「可选 Markdown 说明」；plan.md（`contracts/frontend-plan.md`）改由 prewrite gate 用纯函数 `renderFrontendPlanMarkdown` 确定性渲染（不新增 DAG 节点/不新增 Pi 调用）
+- 契约 schema 新增 5 个可选字段（`implementationSteps` / `stylingStrategy` / `dependencyPolicy` / `residualRisks` / `realIntegrationGap`），`schemaVersion` 保持 1；`docs/templates/frontend-implementation-contract.schema.json` 同步
+- revision 输出改为 RFC 7386 merge-patch delta + 引用块：gate 配置新增 `revisionPatch`，生效时在 `planFallbackFromNodeIds[0]` 原始契约上应用 `applyFrontendImplementationContractPatch` 后进入既有分析/规范化/物化管线；旧 DAG 缺字段按整契约处理
+- canonical contract 序列化（UTF-8）超过 64KB → `retryable-invalid` + 新增 `contract-too-large` failureCode（体积守卫兜底）
+- `design-review` / `final-design-review` 提示改为消费契约 JSON（注入契约字段摘要），不再要求读取 plan prose
+- Console「模型与认证」页新增模型矩阵编辑器：展示并允许编辑 `harness.json executors.pi` 的 LOW/MED/HIGH 三档模型；输入框从 readiness 结构化投影 `piModelMatrix` 预填（provider/model 或裸 model id），本地内联校验（空串 / `default` 哨兵 / 畸形 `provider/`、`/model`、`a//b`）非法时禁用保存；保存经既有 `POST /api/operator/v1/operations` 派发 `savePiModelMatrix`，复用 HTTP 层 `evaluateMutationGate`（boot capability cookie + `x-loop-console-confirmation` 头 + Origin/Host/Sec-Fetch-Site），读全文档后原子写 tmp+fsync+rename（保留 `$schema` 与其余字段），成功后自动重测 readiness 并对活动 Chat session 触发 `/sessions/:id/reload`（409 `PI_SESSION_BUSY` 给出可恢复提示）
+- `GET /api/operator/v1/readiness` 的 probe 新增 `piModelMatrix` 结构化投影（向后兼容，不改动既有 `modelsMessage`）
+- 组件选型规范合规（ADR 0016）：契约 schema 新增可选 `uiComponentChoices[]`（`{ purpose, component, decision(specified|reuse-existing|new), specReference{path,section,line}|null, rationale }`），`specified` 必须给非空 `specReference`、`new` 不得携带、空串拒绝；`schemaVersion` 保持 1；`docs/templates/frontend-implementation-contract.schema.json` 同步
+- `frontend-prewrite-gate` 新增三个 `retryable-invalid` failureCode：`component-spec-reference-invalid`（specReference.path 非受支持规范路径）、`component-spec-not-cited`（未在 openspec-citations 引用块引用或未真实读取）、`component-choices-missing`（组件/主题候选桶非空且契约有 UI 可见工作而 `uiComponentChoices` 缺失/空）
+- gate 配置新增可选 `componentSpecCandidatePaths`（旧 DAG 缺字段兼容）；`init-hybrid` 从 `designEvidence.classified.component ∪ theme ∪ rule.components` 冻结注入，capability context 强调组件/主题桶语义，plan/revision/design-review/final-design-review 提示加入硬规则与 BAD/GOOD 示例
+- `frontend-plan.md` 新增 `Component Selection (spec conformance)` 章节（纯函数确定性渲染，缺省 `_(not specified)_`）
+
+- `frontend-prewrite-gate` 的 OpenSpec 读取校验支持 `task.json.frontendOpenspec` 配置：`policy` 缺省 `cited`（候选 = `requiredReadPaths` ∪ 任务源显式引用的 openspec 路径），`scan-strict` 保留止血任务后的全量必读语义；`requiredReadPaths` 中非 openspec 支持路径在生成期确定性失败
+- 确定性引用块协议：生效 plan 输出在 fenced `json` 契约块后追加 `openspec-citations` fenced 块（每行一个 JSON `{"path","section","line"}`）；gate 解析并与生效 plan/review 节点的成功 read 事件核验，新增 `openspec-citation-block-unparseable` / `openspec-not-cited` / `openspec-citation-not-read` 三个 retryable-invalid failureCode（防捏造、防遗漏）
+- `src/shared/openspec-spec.ts` 新增 `extractTaskSourceOpenspecPaths` 纯函数（反引号内联、markdown 链接目标、裸路径 token → 归一化 → spec 过滤 → 治理子树排除 → 去重排序）
+- 生成期把 `openspecPolicy` 与候选来源元数据（`openspecCandidateSources.declared` / `taskSourceCited` / `scanStrict`）冻结进 prewrite gate 配置；`task advance` 的 advisories 说明当前模式与候选来源
+
+### 改进
+
+- `frontend-plan-pi` 改为 runtime skeleton + editable RFC 7386 patch：`schemaVersion`、source binding、risk、writer target files 与生产 Mock 安全位由 DAG 冻结且不可被 plan/revision 覆盖；节点 validator 将补丁编译为 canonical 完整契约后再交给 review/prewrite，并在 `contracts/candidates/<nodeId>/` 保存每次 raw/extracted/normalized/validation 证据。任务提示与三类结构化重试（invalid-output / provider length 截断 / output-too-large）同步收敛为单一 patch + 唯一 `openspec-citations`；无法在声明文件中解析的可选 verification symbol 会被确定性移除并留下 normalization action，避免格式冲突、完整契约重复输出和说明性 symbol 延迟到 trace 才失败。
+- Operator Chat 恢复工具对齐真实能力：系统提示改用 `dagReport` / `dagRerunPlan` / `dagRerun` / `standaloneTaskRerun` / `workerTaskRetry` 真名，不再写 `operator_*` 或把 `dagResume` 当成模型可执行项；`dagDoctor` / `dagStatus` / `workerPoolDoctor` 改为 typed `runId`/`taskId`，不再让模型猜 CLI `args[]`。ADR 0013 自定义 base prompt 上限由 1900 统一调整为 2500（2026-08-18，废止 0.8×2498 比例），预算用于写清节点续跑 / 整单重生 / Worker 重排队分流，以及多轮迭代恢复纪律（先一句话总结上一轮错误、修根因不修症状、禁止原样重交、同错两轮后停下报告）。
+- Operator Chat 模型工具面收敛：`advanced` 分类的命令（workflow/loop/benchmark/knowledge-graph 等 8 个只读低频入口）不再进入模型工具白名单，模型注意力集中到高频工具；保留的 27 个 model-callable 官方 CLI 动作全部换上「做什么 + 何时用」语义描述，不再是无信息的 `Official CLI action coverage for ...` 模板；dispatcher 对官方尾部动作的识别从描述前缀匹配改为结构化 `OFFICIAL_TAIL_ACTION_IDS` 集合判断。审查收口：`knowledgeCurate` 纠正为 `mutation`/`advanced`（条件写盘，移出模型面，防经 read 通道传 `--output` 写盘）；`promoteRun`/`closeoutTask` 描述去掉 dispatch 不保证的生命周期断言，如实标注为 task-advance 别名并提示先核 run/任务状态。工具清单渲染修复：promptSnippet 去掉重复工具名前缀（SDK 渲染自带 `- name:`，原实现名字出现两遍）；`inspect`/`status`/`spineCheck`/`sourceInstructions` 四条占位描述换成语义描述；task-advance 家族（`newTask`/`dagRunTask`）标注与标准流 `taskAdvance` 的关系，避免模型在 5 个相似入口间选错。可调用性修复：`observeLink` 补上 4 个可选参数 schema（dagRunId/taskId/featureId/workerRunId，原空 schema + additionalProperties:false 导致模型传参必被拒、工具名存实亡）；Pi 工具参数 schema 现在携带注册表里的参数描述（Type.String/Boolean/Number/Array 注入 `description`，原实现丢弃参数描述、模型只能看到参数名）。
+
+- Operator Chat 对齐 pi-web：建会话不再传封闭 `tools` 白名单（避免 SDK 把扩展 MCP 工具滤出 registry），创建后 `bindExtensions` 发 `session_start`，再钉激活集。扩展注册的 MCP 工具可被模型调用；`apply_patch` / `full-tools` / `shell` / `coding-chat` 仍排除。
+- 对话侧栏 Plugins 右侧新增只读 MCP 弹窗：展示 `mcp.json` 配置的服务，以及当前会话真正注册/激活的 MCP 工具；没有配置也没有工具时保持真实空态。
+- 对话侧栏原 Packages 入口改名为 Plugins，与 pi-web / Pi 用户面一致；内部仍是 package inventory。
+- 对话进行中底部上下文占用百分比保持常驻：token 用量事件不再冲掉上一帧的 contextUsage，并在回合中持续刷新。
+- 上一轮大量 bash 结束后再发新消息，旧工具条不再整批挂到新气泡下面：无主工具不再丢进最新一组，历史按完整回合裁切，空助手气泡若还挂着工具会留下来当锚点。
+- 侧栏文件树点击目录行直接插入 `@目录/` 引用（箭头单独负责展开/收起）；输入框 @ 补全也列出目录，排在文件前面。
+- 对话进行中点「停止」立即安静下来（乐观停止，对齐 pi-web）：不再等 POST /abort 往返；后端 abort 等待从 8s 降到 2.5s，未终结时由状态对账收敛。
+- 侧栏文件树实时刷新：agent 回合结束、浏览器标签页回到前台、手动点「刷新」时重拉根目录+全部已展开目录（此前手动刷新只拉根目录，子目录永远旧缓存）。
+- Skills / Packages / Models 面板不再把 Pi 的 warning / collision 原文堆在列表上方：改成标题条一颗摘要芯片（如「14 条提示」），点开按「需要处理 / 名称不规范 / 同名未生效」分组，文案用自然语言，路径只显示末两段；名称不规范的技能在列表旁标「提示」，详情里说明「现在这样也能用」。加载失败仍单独成组，可点「再读一次」。
+- Skills / Packages 双栏改为左右各自滚动；资源弹窗挂到 `document.body`，按顶部对话导航的实时高度在剩余视口居中，不再被 sticky 顶栏挡住上沿。
+
+### 修复
+
+- Console 对话中的 Markdown 表格只约束横向滚动，不再截断纵向滚动链；鼠标或触控板停在表格上时仍可继续上下滚动对话。
+- scenario-param 确定性 rewrite 的 Python 语法校验：Windows 优先 `python`，并把 Microsoft Store `python3` 空壳（非 0 且无语法诊断）视为解释器不可用后回退，避免误回滚合法 rewrite。
+- `frontend-plan-revision-pi` 节点级校验与 merge-patch 输出协议矛盾修复：新增 schemaId `frontend-implementation-contract-revision-patch-v1` 与格式级宽松校验 `validateFrontendRevisionPatchNodeOutput`（至少一个 `openspec-citations` 块 + 剥离引用块后恰好一个 JSON 对象，不做完整契约 schema 校验），revision 节点 `structuredContractOutput.schemaId` 切换（plan-pi 仍为 v1）；node-execution 的 invalid-output retry 指令按 schemaId 分支，patch 协议提示 merge-patch delta + 引用块，消除「prompt 要求 patch、retry 要求完整契约」的 retryable 死循环；gate 仍是唯一权威合并/校验点（零改动）。ADR 0015 补「节点级校验」决策 7
+- `frontend-implementation-contract.schema.json` 的 `uiComponentChoices` items 补 `if/then` 决策语义（`specified` ⇒ `specReference` 必填非 null；`new` ⇒ `specReference` 为 null/缺失）；`frontend-plan-render.ts` 空 `section` 不再渲染尾随 `#`；ADR 0016 增补「门禁边界」小节
+- 前端 gate 内容驱动 revisionPatch 兼容 + verdict 归一化统一：旧 DAG（缺 `revisionPatch` 字段）但 revision 节点按协议输出 merge-patch 时，gate 按内容判定自动合并原始契约并走既有校验（不再因 `missing targets.files` 进入 retryable 死循环）；patch 形态但无法合并（fallback 缺失/自身、原始节点不可读或非完整契约、apply 失败）→ `blocked` + 新增 `revision-patch-unmergeable`（错误信息含重新生成 DAG 指引）；`normalizeVerdictCandidateLine` 增强 backtick 强调剥离，gate 的 `firstNonEmptyVerdictLine` 复用共享 normalize，runIf / output-protocol / gate 三处一致
+
+### 文档
+
+- 新增 `docs/decisions/0016-frontend-component-conformance.md`，并同步 `docs/runtime/frontend-implementation-workflow.md`、`docs/templates/frontend-implementation-contract.schema.json`、`skills/frontend-implementation/references/design-spec.md`、`skills/frontend-implementation/references/node-contracts.md`、`skills/frontend-design-review/references/review-checklist.md`、`CONTEXT.md`
+- 新增 `docs/decisions/0015-frontend-plan-json-only-contract.md`，并同步 `docs/runtime/frontend-implementation-workflow.md`、`docs/templates/frontend-implementation-contract.schema.json`、`skills/frontend-implementation/references/node-contracts.md`
+- 新增 `docs/decisions/0014-openspec-gate-claim-verification.md`，并同步 `docs/runtime/frontend-implementation-workflow.md`、`docs/templates/frontend-task-constraints.md`、`docs/templates/frontend-design-contract.md`、`skills/frontend-implementation/references/node-contracts.md`
+
+## [0.37.1-beta.0] - 2026-08-16
+
+### 重点更新
+
+- backend-test live campaign R115–R141 收口：全新 R141 达到 readiness PASS、23/23 correspondence exact、146/146 Test Points、77/77 scenario MATCH、traceability PASS，并唯一执行 82 个真实 API pytest body
+- 强化 backend-test correspondence、scenario-param、Markdown/pytest writer、collection repair、日志审计和 Windows pytest argfile 执行链，稳定区分 controller TestBug、generated TestBug 与真实 API ProductBug
+
+### 改进
+
+- backend-test correspondence 只分析目标请求实际绑定的 body/payload，忽略 `scenario` 元数据与 setup-only payload；对 `scenario["body"]` 保留字段 shape，并把 intentional invalid enum 交由 scenario-param 门禁判断；同时识别下划线前缀 pytest 参数集合与带说明的 `Payload Contract: none（…）`，避免零 eligible 的 payload/parameter 误阻断
+- backend-test correspondence 继续解析模块内 transport wrapper 的位置 payload 与 wrapper 构造 body，并清理 `Payload Enum` 值后的中文说明，避免 PUT/lifecycle 合法载荷误报；Markdown/pytest writer 同步禁止臆测响应 ID 类型，并在路径 ID 类型未声明时使用 create-delete 派生的合法 missing ID，避免把测试资产缺陷误分类为产品 400/404 缺陷
+- backend-test correspondence 可还原 `_apply_patch(_base_body(...), patch)` 等 transport-body 组合表达式，并把 setup wrapper payload 限定为有 body 契约时的 fallback；traceability 接受经递归脱敏和有界输出的结构化 request/response 日志，scenario-param 支持带显式例值的 string wrong-type；pytest writer/repair 同步禁止把 path/query/control `id` 混入 DTO patch
+- backend-test correspondence 识别模块级 `_post_case`/`_put_case` 参数工厂、factory TP 字面量与通过 `payload["field"] = value` 构造的 DTO shape，并避免空列表全局变量吞并后续参数集合；writer/repair 要求每个变体展开为直接 `pytest.param(..., id="TP-...")`，scenario readiness 不再依赖隐藏的动态参数行；traceability 允许窄 `urllib.error.URLError`/`httpx.RequestError` DELETE cleanup
+- backend-test correspondence 继续还原 `payload = _base_note_payload()` 形式的 builder-return dataflow，并把 intentional invalid enum 交给 scenario-param 而非 Case 聚合 payload gate；Markdown review 明确 GET/DELETE setup DTO 不得改写目标 no-body contract，pytest writer/repair 禁止把返回 scalar 的 helper 当 tuple 解包
+- backend-test collection repair 把 upstream 的 `Repair paths: testcase/...` 直接视为完整权威路径证据并读取/编辑该文件；禁止猜测根级 `contracts/**` 或 DAG run 目录，也禁止 read tool 已成功返回文件后反事实声称路径不存在并提前 blocked
+- backend-test 的 REPAIRABLE collection repair 现在强制 non-empty diff，禁止 `already-satisfied` 制造假修复；Markdown review 增加 `### 测试点` 与三类 binding union 的 exact-set 校验并删除 legacy alias；no-body Case 的 payload correspondence 忽略同一 journey 的 direct setup POST/PUT DTO
+- backend-test generated-local collection repair 从 HIGH 路由降为 MED，在保留 write guard 与 requireChangedFiles 的同时避开连续多轮 grok repair hallucinated blocked/changed-without-write，改由稳定 writer 路由执行有界单文件修复
+- writer outcome 协议确定性归一化显式中文 `实现结果：已变更|已满足|已阻塞` 到 canonical `IMPLEMENTATION_OUTCOME`，仍拒绝无标签 prose、未知值和冲突值，不根据 diff 猜测语义
+- scenario-param 识别 `"x" * _TITLE_MAX_LENGTH` 等长度表达式与 helper 常量名相乘形式
+- correspondence 忽略 pytest payload 中的 `expect`/`echo_*` 辅助键，避免把 DTO 外 helper 字段误判为 PAYLOAD_SHAPE_MISMATCH
+- scenario-param 解析 `bound=LEN100` 机器行、解引用 `_STATUS_ACTIVE` 等 Python 字符串常量，并把 `NOMINAL` 长度样本从 min/max 纠正为 nominal
+
+- scenario-param 观测识别 `_OMIT`/omit sentinel 为合法 `missing`，跳过 `"2xx"`/`"400"` 期望码位置参数，解码 Python `\t`/`\n` 空白字面量，识别 `_TITLE_LEN1` 等长度 helper 名，支持 `custom-literal:whitespace-only|whitespace-padded` 语义标签，`enum-invalid` 接受具体非法字面量，并在 `min`/`LEN1` 意图下优先读取 TP 编码长度与 `minLength` 边界
+- scenario-param 兼容 `empty` 意图下的 omit/`missing-key`，规范化 `custom-literal` 外包引号与可见空白符，并把 `max+1`/`min`/`max` 的裸数字位置参数按长度 token 比较（含 oversized 数字本身）；`custom-literal:trim` 视为 padded whitespace 语义标签
+- backend-test writer 合同明确：`enum-invalid` 必须使用具体非法字面量且禁止 `_OMIT`/missing-key；`custom-literal:trim|ACTIVE|ARCHIVED` 必须使用真实 padded/enum 字面量，禁止 `filter-active` 类描述性伪值
+- scenario-param 识别 `_*_MAX_LENGTH` / `_*_OVER_LENGTH` 等长度 helper 名，明确 `custom-literal:trim` 不能是全空白，并把无 pytest.param 的 request-level/health nominal 记为 MATCH 以免污染 eligibility
+
+## [0.36.4-beta.0] - 2026-08-16
+
+> 前端 DAG 规范上下文确定性落地（beta，发布到 `beta` dist-tag）。
+
+### 新增
+
+- `discoverFrontendProjectCapability` 产出 `designEvidence.classified` 语义归类：按通用目录约定（`openspec/schemas/**`、`openspec/project-specs/templates/**`、`openspec/project-specs/rules/**`、`openspec/project-specs/ui/**`、`ai_workspace/**`）把规范路径分入稳定键 `schemas` / `codeTemplate` / `rule.*` / `theme` / `component` / `uiOther` / `advisoryOther`，并进入 zod schema 校验（分区恒等式：归类值集合 == `normativePaths` 集合），重复探测稳定，不硬编码具体项目文件名
+- 前端 contract/scout/plan/design-review 节点的 `subtask_prompt` 注入归类后的规范路径（含角色语义）并明确要求报告适用规则、命中路径/章节/行号、冲突与缺失
+
+### 修复
+
+- `frontend-prewrite-gate` 在 `openspecCandidatePaths` 非空时强制生效 plan/review 节点实际读取候选路径：未读 → `retryable-invalid` + 新增 `openspec-not-read` failureCode，错误信息列出未读路径；空候选（greenfield）不阻断。此前读取证据仅记录不阻断（advisory），本次真正 fail-closed
+- OpenSpec 候选发现止血：默认排除治理子树（`harness.json.governanceRoot` → 缺省 `ai_workspace/loop-agent`），移除固定 `slice(0, 40)` 截断，`openspec/**` 排序优先于 `ai_workspace/**`，仅保留 ≥200 的显式安全上限（命中时写入 `DagSpec.advisories`，非静默丢弃）；`openspec-not-read` 失败原因增加实际读取路径/候选总数/排除统计与「重新生成 DAG」归因，生成后已删除/改名的候选改为 `candidate-missing-drift` 诊断而非误报「未读」
+
+### 文档
+
+- `docs/templates/frontend-task-constraints.md` 把裸 `TODO` 改写为「探索协议 + 结果 schema + 缺失/冲突 fail-closed」，不再出现具体业务组件名或项目专属路径/命令
+- `docs/templates/frontend-task-requirement.md` 与 `docs/templates/frontend-design-contract.md` 把裸 `TODO` 改写为「编写协议」三要素（要写什么 / DAG 如何消费 / 缺失/冲突时 fail-closed），并新增 `test/frontend-template-no-todo.test.ts` 扫描三个前端模板断言无裸 `TODO`
+- `docs/runtime/frontend-implementation-workflow.md` 的项目规范归类清单改为通用目录约定 + 归类规则，删除写死的示例项目文件名
+
+## [0.36.3-beta.0] - 2026-08-16
+
+> 前端 DAG Mock 治理收紧（beta，发布到 `beta` dist-tag）。
+
+### 改进
+
+- 前端 DAG 的 Mock 策略约束注入设计评审链：`mockContextBlock`（含冻结 allowlist 的「HARD CONSTRAINT」与修复路径）现在也注入 `frontend-design-review-pi` / `frontend-plan-revision-pi` / `frontend-final-design-review-pi`，消除「design-review 按项目规范要求 native、但生成期 allowlist 冻结为 not-needed、prewrite 硬阻断」的策略断环——评审链会明确提示这是生成期契约缺口（需声明 `frontendMock.verifyCommands` 或 `policy: "required"` 后重新生成 DAG）
+- 前端任务生成期 Mock 预警：新增 `DagSpec.advisories`，任务源提到接口/API/Mock 但 auto 模式把策略收窄为 `not-needed` 时，`task advance` 的 `warnings` 会给出可操作提示（声明 `frontendMock.verifyCommands` 或 `policy: required` 后重新生成 DAG），把契约缺口提前到生成期暴露
+
+### 新增
+
+- 版本发布改为三渠道：main 自动发布 npm `next`（`x.y.0-next.N`）、release 分支自动发布正式 patch 到 `release-x.y`、`latest` 仅由人工 GitHub Actions promotion 移动（支持 dry-run 与 CAS 校验）
+- 新增 `next-release.yml` / `cut-release-line.yml` / `release-line-publish.yml` / `promote-npm-latest.yml`，删除旧每日自动 latest 发布入口
+- 发布策略改为 branch + version + channel 矩阵（`scripts/release-channel-policy.mjs`），fail closed
+- 双周 Release Train：可从选定 next 的精确 source SHA 创建版本化 release 分支，带幂等恢复与单 tarball SHA-256 绑定
+
+## [0.37.0] - 2026-08-16
+
+### 新增
+
+- markdown syntax highlight, math formulas and mermaid diagrams; operate entry lands on chat
+- label rerun titles with round number from -rN id suffix
+- enter-DAG action, artifact rail projection, zh changelog
+- surface compaction progress and timeline summary
+- floating auto-dismiss toasts replace in-flow error alerts
+- add running spinners to session titles and stop button
+- show context ratio, semantic cache icons, align process entry typography
+- show context usage and semantic cache labels in usage bar
+- stream live turn process in strict order
+
+### 修复
+
+- isolate interrupt kernel behind worker adapter
+- constrain session title width so hover tooltip engages
+- backfill operation link for semantic activity refs
+- fail fast on non-canonical newTask ids with suggested fix
+- accept projected references and normalize PRD headings
+
+## [0.36.2] - 2026-08-16
+
+### 修复
+
+- exempt changelog history from task-pool-root scan
+- exempt gitignore managed-block doc references in task-pool-root check
+
+## [0.36.1] - 2026-08-16
+
+### 新增
+
+- cooperative live DAG interrupt and recovery UX
+
+### 修复
+
+- move interrupt eligibility to observability to honor kernel import boundary
+- retry semantic intake across Pi tiers with 300s timeout
+
+## [0.36.1-beta.0] - 2026-08-16
+
+> 标准 DAG planner 输出超长紧凑重试（beta，发布到 `beta` dist-tag）。
+
+### 改进
+
+- 标准 DAG 的 planner 节点（`contract-pi` / `plan-pi`）输出超长（`output-too-large`）时自动紧凑重试：新增 `PLANNER_OUTPUT_LIMIT_RETRY_POLICY`（默认重试集合 + `output-too-large`），紧凑重试指令按节点类型区分——结构化契约节点只返回单个紧凑 JSON，普通计划节点返回最小计划（有序步骤、writeSet 边界、验证命令），并丢弃上游原文引用与长证据摘录
+
+## [0.35.4-beta.0] - 2026-08-15
+
+> frontend prewrite 阻断误路由修正 + Mock 契约文档落地（beta，发布到 `beta` dist-tag）。
+
+### 改进
+
+- prewrite 阻断导致的 writer `SKIPPED`（`skippedReason=frontend-prewrite-not-authorized`）失败路由从 `DependencyFailure`/`unblock dependency` 修正为 `ContractMismatch`/`fix-frontend-task-contract-and-regenerate-dag`；`dag report` / `dag doctor` 透传 `skippedReason`，对「Mock 策略契约缺陷需改 task.json + 重新生成 DAG」这类场景给出可操作建议，而非误导性的「解除依赖」
+
+### 文档
+
+- `docs/templates/frontend-task-constraints.md` 的 Mock 约束从 TODO 改为可落地契约：要求从项目**探索**实际存在的确定性 Mock 验证命令（不硬编码命令名）并声明到 `task.json.frontendMock.verifyCommands`，说明生成期 `allowedMockStrategies` 来源、`mock-strategy-outside-allowed` 是生成期契约问题（修复 = 补契约 + 重新生成 DAG，plan-revision 无法修复）
+- `docs/runtime/frontend-implementation-workflow.md` 的 task.json 输入标准补充 Mock 契约声明、命令探索与失败恢复指引
+
+## [0.36.0] - 2026-08-15
+
+### 新增
+
+- 新增任务旅程活动栏，把任务创建、人工门禁、多次运行、失败和恢复记录聚合在同一张卡片中
+- 强化 Operator Chat 的 DAG 恢复能力，运行失败后可以直接查看原因、恢复路径和后续动作
+- 会话删除改为列表行内二次确认，减少误删，也不再被浏览器原生弹窗打断
+- Operator Chat 可以持续监督长时间运行的 DAG，直到任务结束、失败或确实需要人工处理
+- 优化斜杠命令面板的卡片布局和键盘操作，在较小窗口中也能完整浏览和选择命令
+- 运行状态、恢复提示和关键操作文案统一为自然中文，减少内部状态码和生硬英文直接暴露给用户
+
+### 修复
+
+- 任务推进期间的监督更加可靠，减少因短暂静默或状态更新延迟造成的误判
+- 运行器心跳不再提前唤醒 `operationWait`；Markdown 写入统一使用安全编辑工具，降低误覆盖风险
+- 写入目录文档时必须同步更新对应索引，避免内容已经生成却无法从目录入口找到
+- PRD 验收标准支持更多常见中文标题写法，不再因括号、破折号或措辞差异漏掉验收条件
+- 要求执行节点真正生成计划文件；没有触碰禁写路径时，不再错误声称任务受阻
+- 恢复重跑可以正确读取 `dag report` 返回的运行列表，不再因为响应结构差异误判为不可恢复
+- 变更范围统一以 Git 工作区的真实差异为准，不再根据模型回复文字推测是否修改过文件
+- Operator 自定义工具可以正常进入 Pi SDK 会话，不再被工具白名单意外过滤
+- 斜杠命令面板会根据实际可用高度自动调整，不再被窗口边缘裁切
+- 补齐 Operator Chat 的本地命令处理、动态命令降级和错误提示等交互缺口
+
+## [0.35.3] - 2026-08-15
+
+### 新增
+
+- Console 默认进入「对话」页面；创建新任务时先分析需求和依赖，再进入正式任务流程
+- 计划中的文件验证会优先落到允许写入的范围内，命令级检查则使用稳定的静态验证入口
+- Recovery 页面新增恢复链路和最终结果展示，能够看清一次失败是如何被接管和收敛的
+- 前端实现 DAG 增加恢复根清单，并去除重复统计，恢复报告更清晰
+- 写入节点支持部分写入回滚和子任务恢复，局部失败不再轻易污染后续执行
+- 写入节点遇到短暂故障时可以回退到稳定基线，再决定重试或恢复
+- 调度器增加激活门禁和恢复触发条件，只有满足执行条件的子任务才会进入运行
+- 新增分阶段创建子任务的基础能力，为后续恢复和分批执行提供统一入口
+- 补齐恢复状态、恢复结果和终态恢复意图的数据结构，前后端对失败状态的理解保持一致
+- 产出节点新增契约自检，并强化长时间运行时的稳定性和异常收敛能力
+- 统一写入节点的公共辅助逻辑，修复判断改为结构化结果，不再依赖模糊文本
+- 精简前端实现 DAG 的第一阶段，在正式写入前完成结果合并和写入准入检查
+
+### 修复
+
+- 规范证据面板不再单列 openspec，统一为「规范已读取/规范检索」
+- 恢复全量测试稳定性：没有 `python3` 时自动使用可用 Python，统一构建版本格式，并处理 Node 弃用警告造成的干扰
+- 修正续跑候选测试数据，使 `failureCode` 与真实失败语义一致，避免变基后出现错误判断
+
+## [0.35.2] - 2026-08-15
+
+### 重点更新
+
+- Operator Chat 处理详情对齐 pi-web：回合尾部的思考内容与工具调用摘要切分为可折叠「处理详情」，流式中思考可见，回合结束后自动折叠，最终回答单独成气泡
+
+### 新增
+
+- 对话时间线新增内联可折叠「处理详情」区块，集中展示模型思考与工具调用摘要，回合结束后自动折叠
+- turn-process 保留 SDK thinking blocks，流式传输与持久化均携带思考内容
+
+### 改进
+
+- 命令面板 shortcut 优化：Operator 组单行展示，/task、/contract、/dag 分别跳转到任务与恢复页面
+
+### 修复
+
+- 修复「处理详情」思考折叠块背景引用未定义样式变量 --panel 的问题，改为确定性透明背景，消除 Console 样式变量完整性门禁对发布的拦截（视觉无变化）
+- 移除自指的 /help 命令项：输入 / 已弹出命令面板，不再单独提供重复的帮助入口
+
+## [0.35.1] - 2026-08-15
+
+### 重点更新
+
+- taskKind 显式契约全链路生效：页面显式选择的任务类型（含「后端研发（默认 DAG）」= standard）不再被 intake 语义识别或 DAG 生成阶段的语义分类改写；taskKindExplicit 从 CLI 标志 → 语义草稿 → task.json → DAG 路由全链路透传，显式 standard 跳过语义分类且不回写 taskKind
+- Console 任务向导提交反馈：导入/访谈/契约等长动作点击后立即显示进度文案与按钮 spinner，消除数十秒无反馈的「页面卡死」观感；导入结果新增自动发现引用文档与未解析引用的透明提示
+- Console intake 链路修复：任务导航上传 PRD 三件套后契约落地不再因工程边界缺失卡死；semantic intake 在缺失型边界缺口时接管并基于仓库布局推荐 allowedPaths/verify；文字录入「请参照这三个prd路径…」自动发现并导入引用文档；新的 PRD 导入重置 semantic intake 一次性 marker，失败后可重试
+
+### 新增
+
+- PRD 引用自动发现：无上传文档时从文字录入内容中提取 Unicode 路径 token，经 URL 剥离、存在性/大小/排除过滤与角色推断后按角色自动导入引用文件，并透出自动导入与未解析引用结果
+- 任务向导长动作（bootstrap/import/interview/contract）点击后立即在 flash 区域显示动作进度文案（含全链路阶段说明与预期时长），结束时被结果消息覆盖
+- PRD 导入主按钮增加 busy 态 spinner、「导入中…」文案与 aria-busy，新增旋转动画样式
+- 导入结果渲染自动导入的引用文档（路径：角色）与未解析引用警告
+
+### 改进
+
+- semantic intake 资格判定拆分缺失型（工程边界/taskKind 缺失时允许模型按仓库布局推荐）与非法型（路径策略/安全/重叠等仍维持拒绝），回归其 repo-layout-aware fallback 的设计意图
+- semantic intake 提示词增补正式 AC 标题逐字复制指引
+- task advance 对模型未推荐边界场景增加 SEMANTIC_INTAKE_BOUNDARY_UNRESOLVED 可操作提示，明确告知用户当前状态
+
+### 修复
+
+- 修复 Console 显式选择的 taskKind 被丢弃的问题：此前「未选择」与「显式选 standard」被混为一谈，仅在非 standard 时传递任务类型标志，导致 AI 语义识别（如推荐 backend-test）覆盖用户选择、DAG 被改道
+- 修复 DAG 生成阶段对显式 standard 仍执行语义分类并回写 taskKind 的问题：显式信息此前在契约落盘时丢失，现显式指定时跳过语义分类且不回写
+- 修复 PRD 三件套上传时工程边界缺失以 EMPTY_ALLOWED_PATHS blocking 卡死、semantic intake 拒绝接管、契约永不 apply 的问题
+- 修复文字录入「请参照这三个prd路径XXX」只物化一句话、引用文件从未导入的问题
+- 修复 semantic intake attempt marker 一次性失败后永不重试的问题：新的 PRD 导入会重置 marker，失败可随新证据重试
+- Operator Chat DAG recovery P0 收敛：`operationWait` 默认仅由 meaningful progress 或终态唤醒，同时保留 `wakeOn=all` 诊断兼容；operation 终态原子保存并安全投影受信任的 `runSummary`/`dagRunId`，Operation Card 与 prompt 可直接消费失败节点、category 和 recovery 摘要；独立 review 后补齐所有 allowlisted 文本字段中的 Windows drive、UNC 与 POSIX absolute-path 子串脱敏，且不暴露 raw result、CLI 参数、绝对 artifact path 或 secrets。
+- 修复 terminal `run-failed + gate=null` 仍建议 `task advance` 的无进展循环；task status 与 Operation Card 现在停止盲目 resume/retry，并只提供合法的 Inspect/外部恢复导航。
+- 为 Console shortcut palette 的动态高度 custom property 声明 `62vh` 默认值，保留 ChatComposer inline override 与既有 fallback，并维持 `shell-ui-boundary` 未定义 token 检查强度。
+
+## [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 行为
+
+### 新增
+
+- 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 频率。
+
+### 改进
+
+- `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
+
+- 会话历史删除改为 pi-web 式列表行内二次确认：首次点击垃圾桶只在原行显示“删除 / 取消”，不再弹出浏览器原生确认框；同一时刻仅允许一行确认，切换会话、点击取消或按 `Escape` 可撤销，删除中显示忙碌态并阻止重复请求，同时保留原 DELETE confirmation token、失败提示和当前会话清理合同。
+- 修复 Operator Chat 斜杠命令面板在紧凑布局或低高度窗口中顶部被 `.oc-main` 裁切的问题：面板打开后按主工作区顶边与 Composer 锚点之间的真实可用空间动态收缩，并在窗口、VisualViewport 与 Composer 尺寸变化时重算；面板头部保持可见，候选列表继续独立滚动，同时保留原有 `62vh / 520px` 安全上限与无测量回退。
+- 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 渲染失败仅该消息降级为纯文本。
+
+## [0.35.1-beta.4] - 2026-08-15
+
+> 观察面板规范证据不再单列 openspec：读取与检索统一为「规范已读取 / 规范检索」，空态文案同步中性化（beta，发布到 `beta` dist-tag）。
+
+## [0.35.1-beta.3] - 2026-08-14
+
+> frontend-implementation DAG 优化 v9 全六阶段 + Console 展示层（beta，发布到 `beta` dist-tag）。
+
+## [0.35.0] - 2026-08-13
+
+### 重点更新
+
+- 将前端实现契约收敛为单一事实源，消除多个 JSON 生产者导致的输出冲突
+- 严格绑定 Mock 策略与冻结验证命令，在生成与写入阶段前置拦截不一致配置
+- 设计评审节点引入协议感知重试，格式漂移不再直接拖垮整轮运行
+- 改进控制台运行时上下文面板与操作员对话控件
+
+### 新增
+
+- 前端设计评审节点声明 `first-line-enum` 输出协议，VERDICT 首行缺失或畸形时在同一节点内有界重试
+- 前端契约物化新增冻结命令校验，`verificationTarget.commandLabel` 必须落在冻结命令集合内，否则 fail-closed 拒绝
+- plan/revision 提示词强化单 JSON 输出与逐条 AC 回显
+
+### 改进
+
+- 前端实现 DAG 删除重复的 JSON 生产节点，由 prewrite gate 直接从生效计划末尾物化契约，避免 `invalid-output (found N)` 错误
+- 前端 Mock 策略解析逻辑优化：auto 模式在无确认 Mock 能力或无确定性验证命令时强制 `not-needed`，required 模式缺少验证命令时生成期即阻塞
+- 前端 prewrite gate 对不在允许范围内的 Mock 策略给出可操作错误，明确区分不同失败原因并附修复建议
+- 设计评审 verdict 提取同时检查 `assistantText` 与 `stdout`，避免仅输出到 stdout 的 `request-revision` 被误判为缺失
+- 控制台运行时上下文面板与操作员对话控件体验优化
+
+### 修复
+
+- 修复前端 Mock 策略与验证命令不一致仅在 verify trace 才暴露的问题，现已在 prewrite gate 前置安全拦截
+- 修复多个 JSON 生产者导致契约物化失败的问题
+- 修复 `VERDICT: request-revision` 仅输出到 stdout 时被误判为缺失的问题
+
+## [0.34.5] - 2026-08-13
+
+### 重点更新
+
+- 优化 Operator Chat 对话页体验，包括隐藏重复标题、升级 Markdown 渲染、改进工具调用展示，并合并了 `/` 命令面板
+- 控制台启动后默认自动打开系统浏览器看板
+
+### 改进
+
+- 优化 Operator Chat 对话页（UI-01 至 UI-11）：隐藏重复标题、补齐品牌空态与真实注入上下文侧栏、改进工具调用摘要与结果展示、修复遮罩 hover 形变、为截断会话标题提供 tooltip、升级 Markdown/GFM 渲染，并增加用户主动打开的调用记录入口与合并后的 `/` 命令面板
+- 会话列表操作改为按需显示 Remix Icon，同时保留键盘 focus 与触屏可访问路径
+- 输入区将图片上传收敛为图标按钮，并避免“全部工具 · N · 状态”歧义
+- 控制台在服务监听成功后默认打开系统浏览器
+
+## [0.34.4] - 2026-08-12
+
+### 重点更新
+
+- 裸 `agent-worker console` 收敛为唯一看板入口，监听成功后默认打开系统浏览器，并删除 `console serve`
+- 本地连续交付改为按精确 Git tree 复用验证结果，避免提交、推送和分支合并之间机械重复全量测试，同时保持不同 tree、不同环境和远程 CI 的独立质量门槛
+- 全面加固 Operator Chat 的 Turn 所有权、停止与异常恢复流程，解决浏览器与服务端状态错位时的重复提交、停止失效和错误提示问题
+- Operator Chat 新增按仓库保存的 Skills 自动使用偏好，用户可控制技能是否进入模型自动发现范围，同时保留手动调用能力
+- 修复控制台任务导航无法自主执行后端测试与前端测试 DAG 的问题，现可正确识别 pytest、playwright 等多种测试框架的验证命令
+
+### 新增
+
+- 新增可选的 `npm run verify:tree`，对当前严格 clean HEAD 执行完整验证并写入 receipt，随后推送同一 tree 时可直接复用
+- 新增只读的当前 tree receipt 诊断，可区分匹配、缺失、过期、损坏和工作区不合格等状态，不执行测试或写入 receipt
+- Operator Chat 引入完整的 Turn ownership 协议和服务端真实中止接口，并在状态接口中提供 active/latest Turn 与 runtime busy 事实
+- Operator Chat Skills 新增「允许自动使用」开关，偏好按仓库持久化；关闭后仍可通过 `/skill:<name>` 手动调用
+
+### 改进
+
+- 裸 `agent-worker console` 成为唯一 Console 启动入口：本地图形交互环境在服务监听成功后默认打开系统浏览器，`--no-open` 可明确禁止；删除 `console serve` 兼容子命令
+- source→target 连续交付统一选择一个本地全量验证权威；默认 commit/push 不增加步骤，远程 CI 与发布环境不复用本地 receipt
+- pre-push receipt 诊断和执行日志改用有界命令摘要，并严格校验 tree、环境、命令合同、有效期及 receipt 内容一致性
+- Skills 运行时快照改为使用服务端资源标识和独立的自动调用状态，资源变更仅接受当前 inventory 中的合法条目
+- Turn 已占用时返回可恢复的中文状态提示和真实 active Turn，不再向用户暴露裸露的 `chat turn already active` 错误
+
+### 修复
+
+- 修复浏览器已认为对话结束、服务端却仍持有 active Turn 时的重复提交竞态；提交现在支持幂等请求标识、boot epoch orphan 隔离和 durable Turn/runtime busy 联合对账
+- 修复创建 Turn 的响应不确定时状态被过早释放的问题；客户端会保留 ambiguous 状态，通过 `/state` 绑定或释放真实 ownership，不会重新生成请求标识
+- 修复停止请求在 Turn 尚未绑定时丢失的问题；绑定成功后只发送一次真实 abort，且服务端缺少 abort 能力时不会通过 dispose 会话伪造停止
+- 修复 active bind、terminal SSE 与 React streaming 状态交错时提交锁未释放的问题，并统一 adopt、停止中和 abort-pending 为非致命提示
+- 修复控制台任务导航执行 backend-test 和 frontend-test DAG 时，因结构化验证门禁未识别 pytest/playwright 等命令而始终被阻断的问题
+
+## [0.34.3] - 2026-08-12
+
+### 重点更新
+
+- 修复 PRD 导入时 grill-me 模板占位符路径污染写入集的问题，确保仅处理真实需求路径
+
+### 改进
+
+- 语义化导入现可作为兜底方案推荐工程边界，提升需求解析的准确性
+- 将语义约束与验证信息合并至控制台草稿，避免表单默认值覆盖精确的验证命令
+
+### 修复
+
+- 修复 grill-me 模板占位符路径未被过滤即进入写入集，导致占位内容污染实际工程数据的问题
+
+## [0.34.2] - 2026-08-12
+
+### 重点更新
+
+- 修复控制台 DAG 执行在 120 秒后被强制终止导致状态卡死的问题，默认超时现提升至 4 小时
+
+### 改进
+
+- DAG 挂钟时间常量统一收敛至 src/shared 共享模块管理，移除了 workflows 中不必要的内核导入
+- 前端实现契约物化新增冻结命令校验：每个 `verificationTarget.commandLabel` 必须落在 DAG 生成时冻结的命令集合内，否则 fail-closed 拒绝，防止模型发明验证命令；plan/revision 提示词同步强化单 JSON 输出与逐条 AC 回显
+
+### 修复
+
+- 修复控制台任务导航执行 DAG 时因 LoopAgentClient 默认 120 秒超时被强制终止的问题，现已将默认超时提升至 4 小时，并支持通过 --default-timeout-ms 参数覆盖
+- 修正自定义模型合并报告中的文档描述错误
+
+## [0.34.1] - 2026-08-11
+
+### 重点更新
+
+- Console PRD Intake Bridge：统一粘贴、单文件与多文件 PRD 导入流程，复用确定性解析与 Semantic Intake，并回写真实 Console Draft
+- 引入工程边界表单，工程路径与验证命令仅接受人工输入，杜绝使用模板内容冒充需求事实
+- DAG 中断恢复增强：支持协作式 abortSignal，未启动节点明确标记为 controller-interrupted，避免粗暴终止
+- Console Recovery 提供直观的 reconcile CTA，按运行状态精准展示恢复入口，破坏性操作需经浏览器 Human Gate 确认
+
+### 新增
+
+- Console PRD 导入桥接：支持将粘贴、单文件与多文件导入统一接入 task advance 的确定性解析，并映射产物至 DraftStore
+- Console 工程边界表单：在 PRD 导入时支持可选的 allowed/forbidden/verify 字段，并作为标志传递至 bootstrap intake
+- Console Recovery CTA：基于 effective status 与 liveness 展示 dag reconcile-run（supersede/abandon）入口
+- DAG runner 协作式 abortSignal：主控停止时允许已运行节点按 checkpoint 收尾，未启动节点标记 controller-interrupted
+
+### 改进
+
+- dag reconcile-run 增加 --json 与 --action 参数，避免 operation runner 因期待 JSON 失败，并明确拒绝非法 action
+- task advance 生命周期优化：PRD 导入后默认进入仅导入阶段，确保多文件 bootstrap 完成后再执行 Semantic Intake
+- Console Recovery 状态映射细化：将 interrupted/orphaned 等状态映射为 needs-reconcile，suspected-stall 映射为 observe/doctor
+- task advance writeSet gate 输出附确定性 delta，清晰展示边界扩张来源，且不破坏既有 approve 流程
+
+### 修复
+
+- 修复追加 PRD 后两阶段 intake 未重新投影契约、Console 可能回读旧 Semantic Intake artifact 的问题
+- 修复 implement-pi 在 provider clean timeout 且明确零写入时直接终止的问题，现对标准 bounded writer 自动重试一次
+- 修复 grill-me 模板被误当作已解析需求的问题
+- 修复窄屏（<1100px）下 CHANGELOG 文档中尖括号导致的 MDX JSX 解析错误
+
+## [0.34.0] - 2026-08-11
+
+### 重点更新
+
+- Operator Chat 会话创建实现即时响应，Landing 页面与创建请求延迟从秒级降至毫秒级
+- 新增桌面端紧凑响应式布局，根据工作区宽度自动适配 comfortable/compact/narrow 三档显示模式
+- 新增自动会话标题功能，基于首条用户消息生成临时标题，并在首轮对话完成后异步生成正式标题
+- 新增 local-jacoco-coverage 技能，将本地 Java 服务挂载、测试执行与覆盖率切片分析串成标准化链路
+
+### 新增
+
+- Operator Chat 桌面紧凑响应式布局：按工作区宽度切换 comfortable（≥1450px）/ compact（1100–1449px）/ narrow（<1100px）三档；compact 档使用图标窄栏与覆盖抽屉，narrow 档使用顶栏入口；会话与仓库面板支持拖拽分栏并记忆比例
+- Operator Chat 自动会话标题：首条用户消息持久化后生成清洗有界的临时标题，首轮对话成功完成后异步生成正式标题；手工重命名、归档和删除操作可拒绝迟到的自动标题覆盖
+- local-jacoco-coverage 技能：将本地启动 Java 服务挂载 jacocoagent、运行 backend-test DAG、按需求文档做覆盖率切片分析三步串联为可审计、可重复的本地链路，包含强制流程手册、runtime 对齐参考、需求映射规范与编排脚本
+
+### 改进
+
+- Operator Chat 会话创建改为即时响应：先落盘会话骨架与持久记录后立即返回成功，完整 AgentSession 在后台异步初始化，真实 Chrome 测试中 Landing 延迟从 1346ms 降至 22ms、创建请求从 1269ms 降至 16ms
+- 会话创建期间侧栏与 Landing 页共享 busy 状态反馈，抑制双击导致的重复创建
+- 删除正在初始化的会话不会被迟到的后台初始化任务复活，初始化失败统一返回 HTTP 503 错误码
+
+## [0.33.7-beta.2] - 2026-08-13
+
+### Fixed
+
+- scenario-param 解析 `bound=LEN100`、解引用 `_STATUS_ACTIVE` 等 Python 字符串常量，识别 `"x" * _TITLE_MAX_LENGTH` 长度表达式
+- correspondence 忽略 pytest payload 中的 `expect`/`echo_*` 辅助键，避免假 PAYLOAD_SHAPE_MISMATCH
+
+### Changed
+
+- my-webapp 五轮 backend-test 全流程 live campaign 归档（R1–R5 均 finished；R5 correspondence PASS）
+
+## [0.33.7-beta.1] - 2026-08-12
+
+### Fixed
+
+- scenario-param 识别 `_*_MAX_LENGTH` / `_*_OVER_LENGTH` 等长度 helper 名，明确 `custom-literal:trim` 不能是全空白，并把无 pytest.param 的 request-level/health nominal 记为 MATCH 以免污染 eligibility
+- backend-test writer 合同明确：`enum-invalid` 必须使用具体非法字面量且禁止 `_OMIT`/missing-key；`custom-literal:trim|ACTIVE|ARCHIVED` 必须使用真实 padded/enum 字面量；max/min/max+1 应用长度表达式/helper
+
+### Changed
+
+- 归档 R108–R110 live campaign 证据与 residual 收紧结果
+
+## [0.33.7-beta.0] - 2026-08-11
+
+### 重点更新
+
+- backend-test 收口 source-fidelity P0：绑定 source coverage、有界 Markdown/pytest 同步、item-level eligibility 与单次 eligible 业务执行；my-webapp R107 16 节点 finished
+
+### 新增
+
+- backend-test 新增绑定 source references 的来源覆盖事实、Markdown 一轮增量同步和 pytest correspondence 一轮有界修复，在业务测试体执行前保留 initial/effective/residual 证据
+- backend-test 新增 item-level execution eligibility：只授权 payload-safe 的 pytest items，excluded items 与真实业务失败分开展示
+
+### 改进
+
+- 将 backend-test Markdown/pytest map 的默认总 token 预算从 `600000` 提升到 `3000000`，降低多模块生成时过早触发 `dynamic map token budget exhausted` 的概率；仍保持预算耗尽 fail-closed
+- Coverage Matrix 接受 `R400001` 等错误码 Rule Key，并保留单元格内 `ACTIVE|ARCHIVED` 未转义枚举管道符，避免合法行被拆成 10 列后整表丢弃
+- scenario-param 按 TP 精确匹配多行 `场景意图`，保留 `ACTIVE` 大小写字面量，识别 `"a" * N` 长度表达式与空白 `empty`，request-level `nominal` 允许 `None` 查询过滤；避免把合法 payload 误判为 MISMATCH 并错误排除 eligible items
+- backend-test 支持 evidence-only 元用例：Markdown 显式声明 `脚本/primary symbol=无` 且仅绑定 assertion/cross-cutting TP 时，不再强制 1:1 pytest 符号，也不再把其算作 MISSING_PYTEST/SCRIPT_MISMATCH
+- generated pytest 内的 `ScopeMismatch`/setup fixture 失败若完全归因于 `testcase/**` 映射脚本，则归为 REPAIRABLE 并进入唯一一轮 collection repair，不再直接 BLOCKED
+- scenario-param 观测跳过 `pytest.param("TP-...", value, id="TP-...")` 的前导 TP 标签，并支持长度意图用数字位置参数表达
+
+### 修复
+
+- 修复 readiness 错误信息截断与无效 Coverage Matrix 状态语义，避免超长错误或 advisory 矩阵状态误阻断后续节点
+- 修复 scenario 排除项未绑定 payload 字段、request-level 不确定性被误升级为硬失败的问题
+
+## [0.33.6-beta.0] - 2026-08-11
+
+### 修复
+
+- 修复 backend-test correspondence scanner 将下一 Case 的分隔注释误归入前一个 pytest function region，造成虚假的 `MULTIPLE_PYTEST`、script mismatch 和额外 Test Point；现在按函数实际缩进边界隔离 body，并只从精确 `Case-ID:` 元数据或 primary symbol 绑定 Case
+- 修复 backend-test 将 README 其他区域的 Markdown 链接误提取为业务模块、允许 `a401606` 等 opaque/hash-like stem 和异常多模块进入 map 的问题；现在只解析唯一 `## Module Index`，非法、mixed 或超过 8 个模块时 README-only 有界重试并由 manifest fail-closed
+- 修复 backend-test map 总 token 预算耗尽后只生成部分 Markdown/pytest 资产但 parent 仍可能显示成功的问题；budget-blocked child 现在使 backend map 明确 ERROR，并保留 expected/finished/blocked/token 事实
+
+## [0.33.6] - 2026-08-11
+
+### 重点更新
+
+- 加固 PRD 导入与 Semantic Intake，在结构化解析不足时提供安全回退，并增强 writeSet 审查与运行结果摘要
+- Operator Chat 接入单一事件流、启动 epoch 隔离、实时运行时控制与开放资源加载，提升长会话恢复和自主 DAG 监督能力
+- 统一 Windows 等环境下只读 Git 命令的有界恢复机制，同时保留用户自有的 Pi 模型路由配置
+
+### 新增
+
+- task advance 新增 writeSet delta 与 run summary，直接展示边界扩张来源、节点结果和下一步操作
+- Operator Chat 引入单一事件流与 boot epoch fence，支持 cursor 过期后的自动对账恢复，避免将可恢复问题升级为全局错误
+- ChatEventStore 增加事件合并与容量上限双重压缩，控制长期会话持久化体积
+- Operator Chat 新增实时模型、thinking 和运行时资源控制，并按开放资源加载规则解析 Skills、Extensions 与 Packages
+- Operator Chat 可对安全的 bounded DAG 进行持续监督和恢复，执行报告同步补充运行细节与目标 URL 来源
+
+### 改进
+
+- 只读 Git 查询统一使用共享韧性执行器，在 Windows 启动型故障下有界恢复，不扩大 mutation 命令权限
+- 初始化与升级流程保留用户自行配置的 Pi 模型路由，不再因默认配置变化机械覆盖
+- Packages 面板区分配置状态与真实安装元数据，并统一使用品牌图标
+
+### 修复
+
+- 修复 Operator Chat 流式状态与 pi-web 可靠性机制未完全对齐的问题，提升重连和终态收敛稳定性
+- 修复前端测试环境预检中的反引号转义错误，以及重跑默认值和 repair 选择器转义不一致的问题
+- 修复后端测试完整性检查误判字符串内部未配对分隔符，以及按优先级生成非法单模块文件的问题
+- 修复前端测试目标 URL 未从运行时上下文解析的问题，执行时现使用可审计的真实地址来源
+- 修复 generated init 内容因 `desiredSha256` 机械比较而阻断安全升级的问题
+
+## [0.33.5] - 2026-08-11
+
+### 重点更新
+
+- 全面加固 Operator Chat 流式响应的执行可靠性，对齐 pi-web 四层保障机制，彻底解决重连后界面无限加载、空占位气泡卡死等问题
+- 优化前端测试的目标 URL 解析机制，改为从运行时上下文精准解析，并丰富执行报告的细节展示
+- 修复测试生成与执行环境中的多处转义错误，提升复杂脚本生成的稳定性
+
+### 新增
+
+- 新增轻量级会话状态轮询接口（GET /sessions/:id/state），用于快速获取真实的活跃任务状态
+- 前端测试执行报告新增更丰富的细节展示，并支持从运行时上下文中精准解析目标 URL
+
+### 改进
+
+- Operator Chat 客户端现支持每 15 秒及页面可见性变化时定期对账服务端真实状态，当服务端已空闲而客户端仍在加载时自动强制结束
+- 优化重连时的回放保护机制：仅当回放事件的任务 ID 与服务端真实活跃 ID 匹配时才继续流式响应，防止已结束的任务被错误唤醒
+- 前端测试默认短链失败用例现仅重跑 1 次，而阻断性审查节点分支默认重跑 2 次，显式配置仍可覆盖默认值
+
+### 修复
+
+- 修复 Operator Chat 在中断或失败时未写入持久结束事件，导致重连回放卡在开始阶段、界面无限加载的问题
+- 修复对话中断或结束时残留空白占位气泡和卡死省略号的问题，现自动清理未产生内容的消息
+- 修复前端测试重跑选择器生成的 Shell JavaScript 丢失正则反斜杠和换行转义，导致报语法错误的问题
+- 修复前端测试环境预检脚本将 URL 尾部反引号匹配规则展开为裸 Shell 反引号，导致命令替换未闭合的问题
+- 修复后端测试偶尔按优先级生成单一模块文件的问题，现对非法模块命名执行严格阻断
+- 修复后端测试分片完整性校验误判合法测试字符串中未配对分隔符为脚本截断的问题
+
+## [0.33.4] - 2026-08-10
+
+### 重点更新
+
+- 修复后端测试场景参数评估器对 fallback 字段的误判问题，解除由此导致的错误执行阻断
+
+### 修复
+
+- 修复 backend-test 场景参数评估器在 Markdown 无可解析场景意图时，将 TP-ID 推断的 fallback 字段（如 `TP-CREATE-APPROVER-FORMAT` → `cREATE`/`pattern-invalid`）被大写启发式误判为不匹配的问题；此类条目现统一判定为无法判定且不可修复，不再生成无效修复建议，由此导致的错误执行就绪阻断已解除
+- 修复 fallback 场景参数状态被错误标记为失败的问题，现根据实际情况正确标记为不可用或部分可用，且不弱化任何就绪性门禁
+
+## [0.33.3] - 2026-08-10
+
+### 重点更新
+
+- 修复 Windows 环境下 frontend-test 配置 URL 冻结异常的问题，确保跨平台地址识别行为一致
+
+### 改进
+
+- 改进 frontend-test 的 Windows URL 回归测试，使其具备更好的跨平台可移植性
+
+### 修复
+
+- 修复 Windows 环境下 frontend-test 配置 URL（如 baseUrl、targetUrl、loginUrl）无法正确冻结的问题，冲突候选现安全 fail closed，仅在完全未配置时回退 localhost
+
+## [0.33.2] - 2026-08-10
+
+### 重点更新
+
+- 更新 analyze-product 技能
+- 针对结构化产物的可恢复失败自动重试
+
+### 改进
+
+- 更新 analyze-product 技能
+- 结构化产物在遇到可恢复失败时会自动进行重试
+
+## [0.33.1] - 2026-08-10
+
+### 重点更新
+
+- Operate 与 Inspect 合并为统一的双层导航壳，取代旧的三层堆叠栏
+- 在「操作」与「观测」模式间切换时保持对象上下文，支持一键带参数返回恢复现场
+- 夜间信息架构收敛，总览新增「昨夜班次」条带，移除冗余的并列 tab
+- 全面加固窄屏适配与可访问性，优化共享资产加载失败时的降级体验
+
+### 新增
+
+- 新增共享壳唯一实现 operator-chrome.css/js，包含全局品牌带与工作区下划线 tab
+- Inspect 总览新增「昨夜班次」条带，支持通过/失败/需人工/待 harvest 状态一眼可见
+- OperatorSurfaceHealthV1 新增 repoName 字段，统一上移仓库身份展示
+- 新增 operator-chrome 契约测试，覆盖 tab 映射、模型、对象连续与返回路径
+
+### 改进
+
+- 模式切换不丢对象：恢复页持有 DAG 时切「观测」直达同一 DAG 画布，并提供来源 chip 支持一键返回
+- 夜间信息架构收敛：Inspect 顶栏移除「夜间任务」并列 tab，#/night 深链详情保留并提供「在操作台管理 →」入口
+- 仓库身份上移：Inspect 总览移除重复的内联仓库横幅，面包屑从 site-header 移入内容区页头
+- Console 改用 CSP 友好的原生动态导入，共享资产加载失败时保留最小可用导航与错误状态
+- 窄屏（1100px/760px）下新鲜度与 Pi 状态收敛为紧凑图标语法，避免整页横向溢出
+
+### 修复
+
+- 修复 Inspect 壳重渲染时 #header-refresh 新鲜度文案被 health 回填或 hash 切换清空的问题
+- 补齐仓库身份浮层的 aria-controls/aria-expanded/dialog 名称，支持外部点击与 Esc 关闭并恢复按钮焦点
+- 修复关闭来源 chip 时误删 node/page 等对象页查询参数的问题，现仅移除 from 参数
+- 移除 Console 中 new Function 的间接导入与 SVG 图标的 innerHTML 注入面，提升安全性
+- 修复 hash 导航与 destroy 时监听与宿主 class 未完整清理的问题
+
+## [0.33.0] - 2026-08-09
+
+### 重点更新
+
+- Operator Console 工作区导航升级为 hash 路由，支持页面刷新保留状态及浏览器前进后退，并新增模型与设置页面入口
+- 夜间辅助调度器（NightAuxTicker）改为自动启动，移除手动开关，简化操作流程
+- Observe DAG 运行历史页交互全面优化，改进分页器布局、自定义选择器与复制反馈体验
+- 执行器支持 provider/model 显式引用格式，消除运行时模型路由的歧义
+
+### 新增
+
+- Operator Console 工作区导航新增 hash 虚拟路径（#/tasks、#/night、#/models、#/settings），支持刷新恢复与浏览器历史导航
+- 新增模型（Models）与设置（Settings）页面入口
+- 夜间辅助调度器（NightAuxTicker）现默认自动启动，无需手动开启即可维持夜间调度活跃度
+- Observe 新增统一的自定义选择器菜单，支持键盘导航与自适应定位
+- Observe 新增 DAG 运行历史分页功能
+
+### 改进
+
+- Operator Console 工作区导航顺序调整，将对话（Tasks）置于首位
+- 夜间任务面板的健康状态栏简化为纯文本状态展示，移除旧的手动开关
+- Observe 夜页头部操作按钮样式统一
+- Observe DAG 历史分页器视觉布局升级为精致的分段设计，并优化窄屏下的显示
+- 执行器 Pi 层级支持 provider/model 引用格式，规范化解析字符串与对象两种配置写法，提升模型路由准确性
+
+### 修复
+
+- 修复 Observe 自定义选择器键盘焦点异常的问题
+- 修复 Observe DAG 历史分页器在窄视口下布局溢出的问题
+- 修复 Observe 复制反馈按钮的边框样式显示异常，恢复无边框设计
+- 优化 Observe DAG 节点错误摘要展示，将失败行备注压缩为紧凑的两行摘要，避免撑高表格
+
+## [0.32.1] - 2026-08-09
+
+### 新增
+
+- Observe：新增 DAG 运行历史页 `#/dags`：分页表格、hash 恢复 page/pageSize、手动刷新；只读 `GET /api/dag-runs?page=&pageSize=` 返回轻量列表，排除 dry-run/init-only，省略 nodes/edges 等重字段
+- Dashboard「最近 DAG 运行」卡片右上增加「查看全部」入口，进入完整历史页；卡片仍保留最近 10 条
+
+### 修复
+
+- Observe DAG 历史页：分页摘要与失败态使用本地固定可信文案；首次 Loading 与后续动态分页/刷新控件分离；双路径失败共用 aria-live；分页失败不污染列表；默认直连真实 `/api/dag-runs`
+- Observe DAG 历史页 review 收口：取消在途 abort 中途仍式 GET 推进 requestSeq，防止旧响应覆盖缓存页；run-id 复制按钮独立 1.5s 成功计时；图标恢复；手动刷新替换当前页缓存；失效页码 bump prefetch generation 并拒绝陈旧预取写回；`totalPages>7` 页码窗口收紧为首页/末页/当前±1（无紧邻填补）；`.dags-pagination.is-busy` 降级为上方 `opacity`
+- Observe DAG 节点表格：失败行备注改为两行错误摘要，避免完整 errorPreview 撑高表格；完整错误仍在节点检查器输出中查看
+
+### 改进
+
+- Operator Console 前端重构视觉层级与代码结构：`OperatorChat.tsx`（3656→407 行）、`App.tsx`（3044→182 行）、`NightJobsWorkbench.tsx`（852→90 行）按职责拆为 `operator-chat/`、`app/`、`pages/`、`shell/`、`night/` 模块，消息流 / 工具卡 / gate 卡 / composer / 侧栏各自独立；样式统一为单一语义 token 层，人工决策 gate 卡以决策卡规格（橙色左边条 + 浮起阴影 + 状态徽标 + 未决时吸附 composer 上方）突出，工具过程卡默认退后
+- Observe：DAG 历史 pageSize 与节点检查器「执行分次」改为统一自定义选择器（触发器 + listbox；键盘/ARIA/焦点/自适应定位）；不改动 hash-only 分页、attempt raw key / 默认最新 / 节点切换重置语义
+- Observe DAG 历史页：复制改为图标反馈（成功勾号 + 页面 aria-live；失败右下角短暂 Toast）；数字分页器改为精致分段布局；hash 单一事实源；缓存 + AbortController + 相邻页低优先级预取，减少翻页双重加载与长时间等待
+
+- Agent Worker Production Readiness v1 Phase 8：在已发布 `@0.32.0` 上完成 published-tarball deterministic campaign 与 burn-in day 0 开窗；scorecard 仍为 **`NOT_READY`**（待 burn-in 累计、live Pi canary、live Closeout、C4/C7 进程 crash）
+
+### 修复
+
+- Operator Console：补齐 `--accent` / `--danger` / `--surface-raised` 等 14 个被引用但从未定义的 CSS 变量（pi-web 遗留命名与 warm canvas 命名两代并存），此前 HumanGateCard 的橙色左边条、confirmed 态、红色错误文本实际不渲染；设置页仓库指纹截断为短哈希展示
+- Operator Console：新增 `console:typecheck` 门禁并修复拆分后 `.ts/.tsx` 未纳入类型检查的盲区；`ChatComposer` 错误从 `ToolsCatalog` 导入未导出的 `ToolCatalogView`；将 46 处旧式 `JSX.Element` 迁移为 React 19 兼容的 `React.JSX.Element`
+- Operator Chat 会话切换硬化：activate / create / restore 改为版本化提交，慢响应的旧会话选择不再覆盖较新的用户选择；新建 / 删除 / 归档会话完整清理 messages、tool calls、operation / gate / artifact cards、usage、streaming、unread、composer draft、图片附件与文件预览，createSession 改为服务端创建成功后再重置
+- Operator Console：新增 `styles.css` 自定义属性完整性契约与会话选择一致性源码契约；测试中以 `URL.parse` 替换会抛错的 `new URL` 构造
+
+## [0.32.0] - 2026-08-09
+
+### 重点更新
+
+- 启动 Agent Worker Production Readiness v1 分阶段落地：Running Attempt 归属不再依赖 terminal ledger；safe `run-error` 可直接 `task retry`，不再要求 emergency `mark-failed`
+- Harness Task 新 identity 改为 lineage/revision digest，同日 retry 不再依赖修改 title
+- 新增 Task-scoped attempt lease、controller protocol compatibility 评估，以及 agent-worker production readiness 操作合同/checklist
+- Attempt 终态释放 lease；写入前评估 controllerProtocol；scaffold 强制 ADR 0007 acceptance_policy；reconcile dry-run inventory 给出唯一恢复命令
+- 硬下线 `agent-worker observe serve`，只读检视统一走 Console `/inspect/`
+
+### 新增
+
+- `WorkerAttemptIdentity` / immutable run-owner store / `beginWorkerAttempt`（含 lease 路径）
+- `WorkerAttemptFailureV2`、`resolveWorkerRecoveryDecision`、Attempt transition reducer
+- Harness Task lineage/revision digests 与 `MaterializeOutcome` 元数据
+- `docs/operations/agent-worker-production-readiness.md` 与 checklist 模板
+- operator capabilities `controllerProtocol` envelope；`buildRuntimeReconcileInventoryDryRun`；command lifecycle official 命令清单
+- Feature scaffold `acceptance_policy` 与 AC `verification.authority` / `required_evidence_kinds`
+
+### 改进
+
+- Feature Review / Observe 对 Running 与 terminal 分层投影，ownership 告警按 `workerRunId` 聚合
+- Task-scoped WorkerEvent 携带 `featureId`
+- `batch run-ready` / `runSingleTaskAttempt` 在 terminal 后 CAS 释放 lease；有 controller identity 时先做 protocol preflight
+- Feature next-action 优先消费 acceptanceGaps.nextCommand
+
+### 修复
+
+- 硬下线 `agent-worker observe serve`：调用后不再监听端口，stderr 输出稳定标记 `OBSERVE_SERVE_REMOVED` 与替代入口，进程以退出码 2 结束
+- 只读检视统一走 `agent-worker console`（默认 `127.0.0.1:8790`）的 `/inspect/`；`observe snapshot` 仍输出 GlobalSnapshot JSON
+- Console doctor / health-match 不再以外部 8787 Observe 进程为健康前提
+
+## [0.31.1] - 2026-08-09
+
+### 重点更新
+
+- 后端测试生成新增确定性冲突预检与执行就绪性校验，在执行前精准拦截潜在错误并安全自动修复局部缺陷
+- 更精细地区分多种写入失败状态（如思考耗尽、部分写入等），避免无效重试并优先恢复可用进度
+- 收紧测试参数校验与结果真实性，准确区分失败与错误，并前置语法门禁防止生成错误代码
+- 优化 16 个节点的执行成本，将多个审查与计划环节改为确定性交接，在保持质量的同时显著降低资源消耗
+
+### 新增
+
+- 为 `dag rerun-task` 新增确定性 generated-output-conflict 预检，执行前扫描并拦截与磁盘已有文件的冲突，提供精确修复建议
+- writer 执行新增 `writer-thinking-exhausted` 终态分类，精准识别模型思考耗尽且无实际写入的情况，避免无限重试
+- 后端 pytest 模块新增 self-contained 静态导入门禁，在收集前拦截对生成共享命名空间的非法导入
+- 新增 `backend-test-execution-readiness-v1` 执行就绪预检，在收集通过后验证传递 fixture/plugin 注册，支持对局部缺陷的安全自动修复
+
+### 改进
+
+- 在已确认存在实质变更且完整性校验通过时，允许确定性推断缺失的实现结果，避免因模型漏报而中断已完成的流程
+- 收紧 scenario-param 结论判定，全量不可判定显示 `UNAVAILABLE`，混合情况显示 `PARTIAL`，并支持精确到具体传输目标的校验与修复
+- 大幅降低 16 节点运行成本：将部分审查与计划环节改为确定性静态交接，统一质量度量并优化模块聚合策略
+- 在修复写入前新增 `ast.parse` 语法门禁并修正尾逗号算法，严格禁止生成 `,,` 等错误语法污染收集流程
+
+### 修复
+
+- 修复 pytest 结果真实性问题：setup/teardown 错误不再被误报为 collection error，准确区分并独立展示 Failed 与 Error
+- 修复结果合同丢失标识的问题，现完整保留原 pytest node ID、Case ID 与 TP ID，并明确记录业务测试体的实际执行数
+
+## [0.31.0] - 2026-08-08
+
+### 重点更新
+
+- Observe 看板新增 DAG 执行轨迹视图，支持按初始执行、修复轮次和最终收敛分车道展开真实的调度执行过程
+- DAG 节点新增轻量执行历史摘要，在逻辑图卡片、节点表和 Inspector 中直观展示多次尝试与恢复记录
+- 统一执行轨迹与 Inspector 的业务文案为自然中文映射，主界面不再显示难以理解的裸英文状态标识
+- 优化 DAG 拓扑依赖边的路由算法，实现结构化避障正交路由，并恢复平滑的视觉线条样式
+
+### 新增
+
+- Observe DAG 详情新增执行轨迹视图，默认展示逻辑拓扑，支持键盘切换，点击轨迹卡片可联动 Inspector
+- 为 DAG 节点投影并展示轻量执行历史摘要，包含执行次数叙事及 Inspector 分次选择器
+- 新增纯函数模块统一执行轨迹与 Inspector 的业务文案中文映射，规范展示失败原因与状态转换
+- Console 与 Observe 共享统一的品牌 favicon，并支持通过同步脚本保持资源一致
+
+### 改进
+
+- DAG 拓扑依赖边采用结构化避障正交路由，支持长边避障与控制回环独立展示，提升复杂拓扑的可读性
+- 恢复相邻层级普通依赖边的平滑视觉样式，控制回环标签视觉更轻量，避免掩盖主链路
+- DAG 详情响应内嵌有界的执行轨迹投影，在历史证据缺失时安全降级并保持逻辑拓扑始终可用
+- 主 UI 业务术语优化，图卡与工具栏摘要改用自然的中文轮次描述，原始内部编号仅保留在诊断提示中
+
+### 修复
+
+- 修复 Console 与 Observe 未共享 favicon 的问题，现统一使用同一品牌资源并兼容嵌入模式
+- 修复 Observe 逻辑拓扑中同一行 DAG 边未能保持水平的问题，确保同逻辑行混合高度边正确展示
+- 修复执行轨迹车道归类错误，修正收敛开启时节点错误归入最终收敛道的问题，确保各节点按真实位置归类
+- 恢复 DAG Pi writer 节点的 bash 工具权限，同时保持只读节点无 bash 且 edit/write 仍受安全策略约束
+
+## [0.30.0] - 2026-08-08
+
+### 重点更新
+
+- 后端测试生成引入 map-shard 拓扑，将大型单节点拆分为 plan + manifest-shell + map_agent，每个模块用例获得独立的 16K 输出预算，消除大文件多轮写入被截断或完整性误报的风险
+- 修复 map_agent 单个子节点超出 token 限制导致后续所有子节点被错误级联跳过的问题，确保各模块测试用例独立生成互不干扰
+- Completeness Gate 升级为返回结构化缺陷原因，帮助模型精准定位并修复格式问题，有效结束续写死循环
+- 后端测试用例生成全面转向需求驱动覆盖，以产品需求为基准，API 契约作为场景补充，提升测试覆盖的精准度
+
+### 新增
+
+- 新增 plan 节点专属完整性评估器，仅校验 README 覆盖范围和模块索引，不再错误要求下游 map 子节点产出的文件
+- 新增 `scripts/regen-backend-test-dag.mjs` 脚本，用于从 runtime builder 重建打包镜像，保持 runtime 与 packaged template 字节对齐
+- Completeness Gate 的 `moduleStructurallyComplete` 新增结构化原因输出，明确指出空文件、标题层级错误、ID 格式非法或缺失必选章节等具体缺陷
+- 新增 `looksLikeValidPythonModule` 校验逻辑，用于准确识别共享辅助代码和工厂函数，兼容包含合法不平衡分隔符的 fixture 字符串
+
+### 改进
+
+- N2/N3 提示词改为需求驱动覆盖：Coverage Scope 固定为 new-operation/full-contract，以产品需求为基准全覆盖，API 契约补充场景维度，并禁止使用导致用例降级的 `## 测试类` 分组
+- dagDynamicExpansionChildTaskSchema 扩展 `writerOutcomePolicy` 和 `retryPolicy`，使 map_agent 子节点能正确声明实现产出并受 Completeness Gate 保护
+- Completeness Gate 白名单泛化，通过识别子节点 ID 前缀准确匹配 map 分片子节点
+- DAG 执行器模型矩阵统一路由至当前环境实际可用的 wizard-local 模型，避免因 API Key 缺失导致节点大面积失败
+
+### 修复
+
+- 修复 map_agent 中单个子节点超出 `maxTokensPerCase` 被误当作全局预算耗尽，导致后续兄弟子节点全部被跳过（SKIPPED）的问题
+- 修复 plan 节点 Completeness Gate 错误要求下游 map 子节点产出文件齐全，导致计划节点始终判定为不完整并陷入重试死循环的问题
+- 修复 manifest shell 命令因正则反引号和转义符在多层 shell 解析中被破坏，导致确定性 manifest 节点执行报错的问题，现采用 base64 编码彻底规避 bash 转义干扰
+- 修复 pytest-plan 资源检查因严格括号配平启发式算法，误判包含合法不平衡分隔符的 fixture 字符串为不完整的问题
+
+## [0.29.3] - 2026-08-07
+
+### 重点更新
+
+- 夜间任务控制台升级为引导式工作台，支持点选预约、审阅写入集与任务看板，并保留人工审批门禁
+- 失败 DAG 默认改为从失败节点安全续跑，避免因服务波动无理由新建任务
+- Operator Chat 支持内联展示工具执行过程，并改进 Pi 用量统计的准确解析与状态栏展示
+- 增强 Pi 网关限流容错，遇到 429 状态码时自动按 60 秒间隔退避重试
+
+### 新增
+
+- 控制台新增前台辅助夜间任务调度开关，在控制台开启时可按间隔触发调度（仅前台有效，过夜仍需系统定时器）
+
+### 改进
+
+- 失败 DAG 恢复策略改为先诊断再从失败节点续跑，统一对齐系统提示、恢复入口与工具说明
+- Operator Chat 将工具执行过程内联至消息时间线，支持折叠查看，切会话后可恢复工具记录
+- Operator Chat 用量栏改进 Pi 用量解析，准确展示输入、输出、缓存读取与费用信息
+- 注入上下文面板升级为更大可读面板，展示脱敏后的完整系统提示、技能正文与激活工具列表
+
+### 修复
+
+- 修复 Windows 计划任务因 /TR 参数超过 261 字符限制导致创建失败的问题，改用短 .cmd 路径绕过
+- 修复 package-lock 中硬编码的镜像源地址导致发布链路 npm ci 失败的问题，统一指向官方源
+- 修复 playwright-cli open 传入不支持的 --headless/--headed 参数报错的问题
+- 修复 Pi 网关返回 429 限流时重试过快导致任务失败的问题，现自动识别并按 60 秒间隔退避
+- 修复标准 DAG 节点将任务相对路径误当作仓库根路径读取，导致找文件超时的问题
+- 修复 Operator Chat 重开会话时因 JSONL 丢失而静默新建会话 ID 导致会话不匹配的问题
+- 修复夜间任务异步执行结果丢失及 agent-worker 可执行文件权限的问题
+
+## [0.29.2] - 2026-08-07
+
+### 重点更新
+
+- 优化后端测试生成 writer 的续写重试机制，直接内嵌具体目标路径以恢复输出，不再依赖读取受限路径
+- 修复三处完整性门禁（Completeness Gate）误报，避免将正确的测试生成误判为残缺写集
+- 修复标准 Happy Path / `contract-pi` 等节点 source prompt：只暴露仓库相对可读路径（`.harness/tasks/<taskId>/source/...`），并明确禁止把 task-relative 的 `source/需求.md` 当工具读路径
+
+### 改进
+
+- 后端测试生成 writer（N2 MD / N5 pytest）在输出截断或残缺写集后，续写重试直接内嵌具体目标路径清单，不再依赖读取 `.harness/**` 路径
+- 即使遇到结果为空或输出失败的异常，也会评估完整性门禁，将可恢复的部分写入升格为不完整写集，避免重试空转
+
+### 修复
+
+- 修复 README 正文提及的编号式文件名被误判为缺失模块的问题
+- 修复覆盖率矩阵（Coverage Matrix）表头识别被覆盖率范围（Coverage Scope）数据行遮蔽的问题
+- 修复合法多行 `def` 的 pytest 脚本被误判为截断的问题（真正截断现仍由括号配平计数准确捕获）
+
+## [0.29.0] - 2026-08-07
+
+### 重点更新
+
+- 新增 Automatic SemVer 自动化发布链，基于 Conventional Commit 增量自动决定版本号，且绝不自动发布破坏性 major 版本
+- Operator Chat 默认开放完整的 Pi 工具集（read/write/edit/bash 等），在保持安全硬边界的前提下提升操作便捷性
+- 后端测试在 16K 最大输出限制下引入分文件写入纪律与完整性恢复机制，彻底避免残缺资产被误判为成功
+- 控制台新增横向莫比乌斯环页签图标，以暖黑双环表达持续运行，并用克制橙色交接面标记受控切换
+
+### 新增
+
+- 新增 Automatic SemVer 每日发布入口：严格依据最新稳定 tag 到 main HEAD 的增量决定版本，feat 触发 minor，其余触发 patch，破坏性标记会安全停止
+- Operator Chat 默认注册并开放完整的 Pi 工具（read/write/edit/bash/grep/find/ls），Capabilities 与 system prompt 对齐 ADR 0011
+- Loop Operator Console 新增横向暖黑莫比乌斯环页签图标，并覆盖静态资源与 UI 边界检查
+- 客户端恢复机制支持静默忽略瞬时中断错误，并写入详细的恢复日志供运维人员核查
+
+### 改进
+
+- 后端测试在 pytest 执行前增加场景参数一致性检查，支持确定性有界自修，并在执行后生成结构化的《测试失败用例分析报告》
+- 测试框架不再硬编码模型 ID，改为动态解析真实的 Pi 模型矩阵，提升跨环境兼容性
+- 初始化升级流程在控制器基线合并中增加验证权限守卫，提升操作安全性
+- AGENTS 及初始化托管块现允许在监控 DAG 时进行简短的进度更新
+
+### 修复
+
+- 修复控制台在用户主动切换标签页时，任务失败错误信息残留并跨标签页持续显示的问题
+- 修复并发操作更新导致 JSON 路径产生竞态的问题，现对操作写入进行串行化处理
+- 修复 Windows 环境下文件原子替换遇到短暂占用时导致操作卡死的问题，现有界重试并清理临时文件
+- 修复后端测试 Markdown 生成器在已确认变更但无 diff 时误判的问题，现会进行严格的有界重试
+- 改进 Windows 环境下临时目录清理机制，在遇到目录非空或繁忙（ENOTEMPTY/EBUSY）错误时自动重试
+
+## [0.28.13] - 2026-08-06
+
+### 重点更新
+
+- 显著缩短 CI 与发布流程的测试耗时，优化 2 vCPU runner 上的并发策略
+- 修复集成测试在多核环境下因工作区指纹竞态导致的不稳定问题
+
+### 改进
+
+- 优化 CI/发布环境的测试执行效率：固定 fast 测试池为 2 个 worker，移除重复的 pre-prepare 类型检查，并将 npm dist-tag 收敛轮询改为前快后慢的退避策略
+- 默认 fast 测试池现按可用 CPU 核数（上限 4）分配，避免在 2 核环境下意外退化为串行执行
+
+### 修复
+
+- 修复集成测试在多 worker 下因读取工作区指纹竞态导致的包校验不稳定问题，现固定集成测试为串行执行
+- 修复 pre-push 验证收据漂移测试受 CI 环境固定 worker 数量影响的问题，确保使用不同值以正确验证指纹失效场景
+
+## [0.28.12] - 2026-08-06
+
+### 重点更新
+
+- Night Scheduler 交付 Clock Guarantee，支持通过 macOS、Linux 和 Windows 原生系统定时器自动周期触发调度
+- 加固前端 DAG 验证的回退机制与 JSON 解析，提升复杂环境下的容错能力
+- 修复 pre-push 验证在本地缺失远程提交记录时异常中断的问题，保障推送流程顺畅
+
+### 新增
+
+- 新增 `scheduler clock install|status|uninstall` 命令，支持安装用户级别的 launchd、systemd 和 schtasks 定时器
+- 统一 Clock receipt 记录机制，使手动触发与系统定时触发共享运行状态
+- 新增 Clock 健康状态分类器，并接入 doctor、morning 和 scheduler add 的状态反馈
+
+### 改进
+
+- 改进 `--verify` 相关文档示例，不再硬编码特定命令，改用占位符并指向项目配置文件以避免误导
+- 规范化初始化升级测试套件的代码格式，使其符合项目的统一排版规范
+
+### 修复
+
+- 修复 pre-push 验证在本地无法解析远程最新提交 SHA 时直接报错中断的问题，现会安全回退到完整验证流程
+- 修复 CI 环境下因系统定时器精度不足导致的重试退避时间断言不稳定问题
+- 修复前端 DAG 验证 JSON 解析及覆盖率证据推导的问题，增强验证回退机制的健壮性
+- 修复任务草稿复用时因缺少 `--dag-output` 参数导致无法正确导出 DAG 的问题
+- 修复空事实情况下误触发契约准备的问题，现会安全软停止并提示需要输入
+- 修复 macOS 下因路径别名导致初始化升级测试中写入保护用例失败的问题
+
+## [0.28.11] - 2026-08-06
+
+### 重点更新
+
+- 修复 Night Scheduler 收尾提交因前导空格处理不当导致变更路径截断、暂存失败的问题
+
+### 修复
+
+- Night Scheduler 收尾提交改用 trimEnd 替代 trim，保留 git porcelain 格式的前导空格，修复 worktree-only 变更路径被截断（如 src/hello.js 变为 rc/hello.js）导致 git add 失败的问题
+
+## [0.28.10] - 2026-08-05
+
+### 重点更新
+
+- 修复 DAG 变更清单 schema 校验误杀合法执行清单的问题，恢复夜间测试成功路径
+
+### 修复
+
+- DAG writer change-manifest 的 schema 校验现可正确接受 Pi 执行器写入的 effectiveWriteSet 与 approval 元数据字段，修复 verify-pi project-governance-integrity 因 ownership/schema 不匹配而误拒合法 implement-pi 清单的问题
+
+## [0.28.9] - 2026-08-05
+
+### 重点更新
+
+- 提升 DAG 执行的可靠性与验证效率
+- 修复初始化时 Pi 模型矩阵的配置问题
+
+### 改进
+
+- 提升 DAG 执行的可靠性与验证效率
+
+### 修复
+
+- 修复初始化时 Pi 模型矩阵的配置问题
+
+## [0.28.8] - 2026-08-05
+
+### 重点更新
+
+- 修复 Night Scheduler 收尾提交被运行态文件污染的问题，确保提交内容仅限源码变更
+
+### 修复
+
+- Night Scheduler 收尾提交现忽略 .harness/ 与 .worktrees/ 运行态目录，仅暂存 writeSet 源码路径，避免 verify 将 dag-runs 等运行态文件误判为 writer 变更
+- Night Scheduler worktree 在 prepare 时尽力确保 .gitignore 包含 .harness/ 与 .worktrees/，防止运行态文件干扰工作区校验
+
+## [0.28.7] - 2026-08-05
+
+### 重点更新
+
+- 修复 Night Scheduler 执行已准备好的 DAG 时因客户端超时中断任务的问题
+
+### 修复
+
+- Night Scheduler 执行已准备好的 DAG 时，`task advance --approve-gate` 改用 `timeoutMs: 0`，避免默认 120 秒超时在 DAG 仍在运行时将其强制终止，现由内核负责执行监督
+
+## [0.28.6] - 2026-08-05
+
+### 重点更新
+
+- 修复 macOS 下 /tmp 路径别名导致 Night Scheduler 工作区隔离校验误报失败的问题
+
+### 修复
+
+- Night Scheduler 准入控制现使用 realpath 规范化控制目录与 worktree 路径，避免 macOS /tmp 别名引发隔离校验假失败
+- Night Scheduler 准入事实仅冻结真实的仓库内相对 worktree 路径，提升隔离检查的准确性
+
+## [0.28.5] - 2026-08-05
+
+### 重点更新
+
+- 修复 macOS 下 /tmp 路径别名导致 Night Scheduler 工作区隔离校验误报失败的问题
+
+### 修复
+
+- Night Scheduler 准入控制现使用 realpath 规范化控制目录与 worktree 路径，避免 macOS /tmp 别名引发隔离校验假失败
+- Night Scheduler 准入事实仅冻结仓库内相对路径的 worktree 路径，提升隔离检查的准确性
+
+## [0.28.4] - 2026-08-05
+
+### 重点更新
+
+- 修复 Night Scheduler 准入控制中 writeSet 门禁冻结的误报失败问题
+
+### 修复
+
+- Night Scheduler `admission prepare`：为 `task advance --json` 补充 `expectJson`，并允许从 stdout 解析 writeSet gate，修复“did not return JSON”假失败
+
+## [0.28.3] - 2026-08-05
+
+### 重点更新
+
+- 修复 Night Scheduler 准入控制因运行态文件自污染导致 clean-tree 校验总是误拒的问题
+
+### 修复
+
+- Night Scheduler 准入控制：freezeCleanBase 忽略 .harness/**与 .worktrees/** 运行态事实，避免 lifecycle 运行事实自污染导致 clean-tree 误拒，同时保留失败 admission 的 submitted → rejected 审计链
+- 调整 freezeCleanBase 的执行顺序，将其提前至 submitSchedule 之前，确保 baseCommit 能在调度器写入控制文件前正确捕获 HEAD
+- freezeCleanBase 将 .harness 与 .worktrees 视为非源码脏污（与 harvest 逻辑共享），避免准入流程自写入的调度事实干扰基线冻结
+
+## [0.28.2] - 2026-08-05
+
+### 重点更新
+
+- Night Scheduler 实现了夜间任务的完整调度闭环，支持准入控制、执行调度、证据归档与结果回收
+- 控制台新增夜间任务只读视图与操作面板，支持通过 CLI 和人工审批执行准入与调度操作
+- 新增可恢复的项目初始化升级流程，支持状态复核与安全断点恢复
+
+### 新增
+
+- Night Scheduler 核心调度能力：支持一次性夜间计划准备、准入控制、队列预约、执行调度、证据归档及结果回收
+- Night Scheduler 异常恢复机制：支持过期租约恢复、环境失败与不稳定测试的有界自动重试
+- Night Scheduler 自动跟进功能（默认关闭），开启后仅生成任务草稿，永不自动审批
+- 控制台夜间任务只读视图与操作面板，支持通过 CLI 和人工审批执行准入与调度操作
+- 可恢复的项目初始化升级流程，支持断点恢复与状态报告查询
+
+### 改进
+
+- 统一并修正了 DAG 模拟运行（dry-run）的指导说明，明确了预览快照的保存位置与限制
+- 更新了项目路线图与计划索引，将已完成的可靠性计划归档并校准至最新基线
+
+### 修复
+
+- 对齐了各处 DAG 模拟运行的指导说明，消除了文档与实际行为不一致的问题
+
+## [0.28.1] - 2026-08-05
+
+### 重点更新
+
+- 提升前端/后端任务执行稳定性，减少“看起来成功、实际未写入”的误判
+- 缩短默认测试耗时，改善本地与发布验证体验
+
+### 改进
+
+- 默认测试流程更快，并归档已完成计划
+- 维护类任务不再误入前端实现流程
+- 部分证据与 lint 检查改为非阻断，降低无关噪声对交付的干扰
+- 模型输出格式更宽松：说明文字、行内通过结论等常见写法更不易被误杀
+
+### 修复
+
+- 后端生成任务在未实际写入文件时不再误判为成功
+- 前端写入前补齐契约校验，避免无效契约进入实现阶段
+- 修正失败分类误把路径限制提示当成鉴权失败的问题
+- 加强验证与结果解析，减少畸形输出导致的卡死或误判
+
+## [0.28.0] - 2026-08-05
+
+### 重点更新
+
+- 新增客户端上下文溢出（Context Overflow）的自动压缩与恢复机制，支持 OpenCode 与 Pi 环境
+- DAG 总览面板全面隔离模拟运行，确保仅展示真实执行的任务状态
+- 修复多项 DAG 生命周期与状态恢复问题，提升任务执行稳定性
+
+### 新增
+
+- 新增内网/通用客户端上下文溢出恢复机制：支持精准识别中英文溢出提示，并为 OpenCode 和 Pi 环境自动生成压缩与恢复插件
+
+### 改进
+
+- DAG 总览面板全面隔离模拟运行（dry-run/init-only），确保其不再污染活跃任务视图，仅展示真实执行的任务状态
+
+### 修复
+
+- 修复 Playwright 浏览器执行未受限制的问题，恢复其有界执行机制
+- 修复结构化审查在遇到重复或无效 JSON 时无法正确收敛的问题，确保严格按规范完成或进入有界修复
+- 修复通用 writer 声明结果与实际改动不一致仍误判成功的问题，现强制要求结果与 diff 保持一致
+- 修复任务在审计或失败运行后无法正确恢复生命周期的问题，现支持在存在待审批写入集时安全恢复执行
+- 修复客户端上下文溢出恢复在压缩后未正确延迟恢复执行的问题
+
+## [0.27.1] - 2026-08-04
+
+### 重点更新
+
+- 前端测试 L-5 报告看板全新改版，与后端报告模板统一
+- 修复后端测试因 pytest 脚本漏生成而直接阻断的问题，升级为精确的缺失脚本恢复机制
+
+### 新增
+
+- 前端测试 L-5 看板新增确定性质量信号、门禁摘要、证据详情及用例执行详情展示
+
+### 改进
+
+- 前端 L-5 报告看板与后端报告模板视觉与结构对齐，提升跨端报告一致性
+
+### 修复
+
+- 修复后端测试在 Markdown 已声明安全映射脚本、但 pytest writer 漏生成文件时直接以 invalid-output 阻断 repair 的问题：initial facts 升级为 backend-test-pytest-collection-v2，可记录 expected/existing/missing scripts、collectionAttempted=false 与 missing-mapped-pytest-script，复用既有单次有界 repair 精确创建缺失脚本，并由最终收集、scope、安全和 hash freshness 门禁重新授权业务执行
+
+## [0.27.0] - 2026-08-03
+
+### 重点更新
+
+- 标准操作生命周期统一为 task advance（推进任务）与 task status（查看状态）两个入口
+- 移除十余个旧版公开命令别名，简化操作心智模型
+- task advance 首次执行可自动完成 PRD 导入、契约派生、DAG 生成与校验，停在 writeSet 摘要门禁等待确认
+- Worker 与 Console 全面迁移至新的机器契约，统一通过 task advance 驱动
+
+### 新增
+
+- 新增 task advance 作为标准任务生命周期的唯一推荐变更入口
+- 新增 task status 作为只读任务状态查询入口
+- task advance 支持 --accept-recommendations 参数，通过摘要确认确定性采纳工程边界推荐
+- task advance 新增 Worker 机器契约参数：--profile、--max-concurrent、--run-id、--events-jsonl、--worker-association、--dag-output、--skip-finalize、--no-strict-models
+- ADR 0008 将 run 级 dag recovery/forensic/decision 冻结为永久 advanced 专用，标准 task 面保持简洁
+
+### 改进
+
+- Worker run-task 主路径改为 task advance prepare 到 writeSet 门禁后经 --approve-gate 执行，不再 spawn dag run-task / run-dag / dag validate
+- Console 的 status 调用迁移至 task status，dagRunTask/prepareDagConfirmation 生成路径迁移至 task advance --dag-output
+- 顶层 status 去掉 refreshSourceState 副作用，read-model next 指向 advance/status
+- 标准主路径文档、skills、help、capabilities 全面收敛为 task advance + task status
+
+### 修复
+
+- 完成 task-advance 迁移后对齐残余断言：skill 触发词、workflow defaultEntry、Ring1/Ring2 CLI smoke 及 help-summary 与新生命周期一致
+- 更新 dag/run-task/final-verification/reference-context 预期，pre-push 不再断言已删除的 dag run-task / task contract 公开命令
+
+## [0.26.4] - 2026-08-03
+
+### 重点更新
+
+- 强化 DAG 运行时安全与 writer 工具级写边界
+- 收敛效率与可选 document catalog 兼容
+- 防污染 review-pass 知识写入
+
+### 改进
+
+- fresh init 与旧项目 `init update --apply-safe` 刷新的 `AGENTS.md` managed block 现要求持续监控 DAG 至 `FINISHED`、`FAILED`、`partial_failed` 等已结束终态或 Decision Gate 需要 approve；判活须组合 runner heartbeat、session events 与 `dag doctor` liveness/provider meaningful progress，并禁止 exclusive writer 运行期间主会话或其他 writer 并发修改工作区
+- DAG 治理闭包与收敛效率：已配置 `docs/document-catalog.json` 的项目在生成时从 `completeDirectoryIndexes` 注入具体 index companion 到 implement/repair 内存路径，未配置该可选 catalog 的项目保持原有 DAG 生成能力；repair artifact 支持 `blocked-boundary`/`requiredScope` 与 empty-manifest `no-progress` 提前止损；DAG shell 支持显式 `failFast`，supervised hard verify 在同 run、同工作区指纹与命令契约下仅复用成功命令并写可审计 receipt。真实非零退出与 finished 聚合规则不放宽，且不跨 run 缓存验证结果
+- DAG Pi writer 工具级写边界：移除 writer unrestricted `bash`，以 SDK 同名受控 `edit`/`write` 在文件 API 执行前强制 repo containment、symlink/ancestor containment、`allowedPaths`/`writeSet`/`forbiddenPaths`，并硬拒绝 `.harness/tasks/**` 与 `.harness/dag-runs/**`；CLI-only 与 SDK→CLI 对 writer fail-closed（read-only `cli-only` rollback 保留），SDK resource loader 与 CLI 同时关闭 Pi extension 自动发现，阻止 extension 在 session 启动或覆盖工具后绕过沙箱。授权递归 glob（如 `src/**`）可创建其覆盖的中间目录，但同级越界目录仍在 mutation 前拒绝。same-run hard-verify workspace fingerprint 纳入当前 Task Contract 稳定 ignored 治理输入；这些文件漂移后成功命令全部 `reused=false`，runner-owned dag-runs volatile 不进入指纹。post-run write-guard 与 change-manifest 保持第二层防御
+- DAG convergence 成功知识防污染：只有 `review-pi` 与 review verdict recovery 均 FINISHED 且明确 `VERDICT: pass` 才写入 `review-pass` knowledge pattern；review gate 仅完成路由但上游 authority/protocol/review verdict 非 pass 时按 `non-retry-failure` 收口，不再把 `request-revision` 或被跳过的 review 误记为成功
+
+### 修复
+
+- 修复未配置 document catalog 的项目在 DAG 生成路径上的兼容问题，避免可选 catalog 成为硬依赖
+- 提升 convergence 与 writer 可靠性
+
+## [0.26.3] - 2026-08-02
+
+### 重点更新
+
+- DAG 无害工具副产物自动恢复
+- 提升前端验证命令的精确度与失败分类
+- 隔离测试固件与运行环境标记
+
+### 新增
+
+- DAG 无害工具副产物自动恢复：自动清理 Git Bash 误用 `> nul` / `2> nul` 在仓库根目录生成的普通非 symlink untracked `nul` 文件，避免其干扰 Git 状态复查与变更清单生成
+
+### 改进
+
+- 精确限定前端验证命令的作用域，提升验证执行的准确性
+- 更精准地分类前端验证失败原因，避免模糊报错
+- 将运行器标记与测试固件进行安全隔离，防止测试环境干扰
+
+### 修复
+
+- 修复配置验证目标错误处理符号引用的问题
+- 修复 DAG 执行中无害的根目录 nul 副产物导致流程异常的问题
+
+## [0.26.2] - 2026-08-02
+
+### 重点更新
+
+- 后端测试在执行前新增有界的 pytest 收集修复机制，安全且精准地自动修复生成测试中的不一致问题
+- 全面加固 DAG 审查协议与前端契约边界，提升执行稳定性
+- 修复 Observe 看板轮询刷新时的交互状态保留问题，优化使用体验
+
+### 新增
+
+- 后端测试在业务 pytest 执行前新增有界的收集（collection）修复机制：仅对生成的测试目录中可唯一归因的语法、导入、模块或参数化不一致进行最多一次自动修复，且严格禁止修改生产代码或放宽断言
+
+### 改进
+
+- 加固 DAG 审查协议与追踪门禁，提升执行稳定性
+- 加固前端 DAG 契约边界
+- 稳定 Linux 环境下的测试收集固件（fixture）
+- 对齐受监督的 DAG 收尾拓扑结构
+
+### 修复
+
+- 修复 Observe 看板在轮询刷新时破坏 DAG 图视口 DOM 的问题，确保拖动与滚动状态不被销毁
+- 修复节点检查器在内容未变时重建内容的问题，现支持异步标签页安全恢复滚动位置
+
+## [0.26.1] - 2026-08-02
+
+### 新增
+
+- 新增 `task source prepare`：PRD-first 确定性派生薄执行契约（`source/需求.md` / `执行约束.md` + managed paths），默认 dry-run，`--apply` 仅经 Task Contract 投影落盘；默认无 LLM 写 source，工程字段不从 PRD 自动提取
+
+### 修复
+
+- Nightly 发布恢复探测会对 annotated tag 做 peel：远程 `ls-remote` 优先取 `refs/tags/<tag>^{}` 的 commit SHA，而不再把 tag object SHA 与 `git rev-list` 的 commit 误判为 conflict，避免「tag+npm 已齐、仅缺 GitHub Release」的恢复被错误中断
+- 收紧 Windows 下 write-guard 的 `git status` 启动路径，降低启动失败与误报
+
+## [0.26.0] - 2026-08-01
+
+### 新增
+
+- Observe/看板将 DAG 机器态 `partial_failed` 展示为「部分成功」（琥珀色 badge/timeline），与红色「执行失败」区分；内部状态与 recovery 语义仍为 `partial_failed` 非成功终态
+- `harness.json` 的 `executors.pi.LOW|MED|HIGH` 支持简洁对象写法 `{ model, thinking? }`，同时完全兼容既有模型字符串；显式 `thinking` 会透传到 DAG Pi 的 `modelConfig.thinking`，省略时不强制覆盖 Pi 默认（含既有 `wizard-local/gpt-5.5 → low` 硬编码例外，且显式配置优先）
+- pre-push 新增本机 verification receipt：相同 Git tree、关键环境与默认 24 小时 TTL 命中时可复用已通过验证，并对仅 `docs/reports/**/*.md` 的确定性变更使用 `check-repo` + `docs:build` 轻量门禁；新分支、多 ref、dirty/HEAD 漂移等不确定场景保持 fail-closed。
+- DAG Pi 模型矩阵支持 `provider/model` 限定引用，可让 LOW/MED/HIGH 通过不同 Pi provider 调用模型；裸模型名继续兼容原有映射与默认 provider，非法空组件在模型调用前安全拒绝
+
+### 修复
+
+- 收紧 `frontend-project-default-implementation`：强前端项目证据（React/Vue/Next）须与具体前端 allowedPath 证据（如 `.tsx`、`src/components/**`、`apps/web/src/**`）共同出现，才作为默认前端实现依据。核心 runtime 路径（如 `src/workflows/dag/**`、`src/server/**`）与宽泛 `src/**` 不再被仓库级前端证据单独劫持到 `frontend-implementation`，模糊任务安全回退 `standard-dag`/`supervised-implementation`。`Task Type: backend-feature` 不再因项目默认前端证据被误判为 mixed，分类保持 backend、模板保持非前端。不新增模型仲裁或路由 DAG 节点，也不向通用 backend 目录列表硬编码 loop-agent 私有目录，修复跨仓库通用。
+
+## [0.25.6] - 2026-08-01
+
+### 重点更新
+
+- 后端测试新增按变更类型界定覆盖深度的机制，精准控制测试范围并避免无关用例膨胀
+- 初始化托管块改为从独立模板文件渲染，大幅降低维护难度并提升可读性
+
+### 新增
+
+- backend-test 新增机器可读的 Coverage Scope，支持按新增接口、契约变化、行为变化、缺陷修复和纯实现优化选择覆盖深度
+- 目标项目的 AGENTS.md 托管块改为从 docs/templates/init-managed-agents.md 渲染，便于直接编辑维护
+
+### 改进
+
+- Observe/看板将 DAG 机器态 `partial_failed` 展示为「部分成功」（琥珀色 badge/timeline），与红色「执行失败」区分；内部状态与 recovery 语义仍为 `partial_failed` 非成功终态
+- 纯优化类变更现聚焦于需求、确定性影响面与最小回归集，避免无关接口全量用例膨胀
+- 目标项目 `AGENTS.md` 的 `LOOP_AGENT_INIT` managed block 改为从 `docs/templates/init-managed-agents.md` 渲染，便于直接编辑维护；该模板仅随 npm 包发布，不投影到目标项目治理目录；同时同步 `import-prd`/exec-plan 推荐路径、init reconcile 零写入条件、DAG liveness/recovery 精确命令及 Official Console 裸入口
+
+## [0.25.5] - 2026-07-31
+
+### 重点更新
+
+- 后端测试 DAG 新增确定性场景覆盖分析与 Markdown 到 pytest 的精准对应，显著提升测试质量度量的准确性与透明度
+- 受监督的 DAG 默认启用有界自愈闭环，能够自动处理可恢复的执行失败并安全重算后续节点
+- 全面加固客户端会话恢复机制，精准识别并补偿由模型服务瞬时异常引发的结构校验错误
+- 大幅增强 DAG 执行的确定性收尾能力，确保在模型输出不稳定或前置快照失败时安全降级
+
+### 新增
+
+- 后端测试固定 9 节点 DAG 新增可审计的场景覆盖与 Markdown→pytest 一一对应事实：节点 4 从严格 Coverage Matrix、Case Rule/Test Point 绑定及 OpenAPI required/enum/boundary/pattern/format 规则生成覆盖报告，节点 6 生成 1:1/1:0/1:N/0:1 对应报告，节点 7 校验一致性后物化 canonical manifest
+- 受监督的 DAG 默认启用有界自愈闭环：通过 maxFixLoops 派生收敛预算，将可恢复失败与合法的审查修订请求统一纳入恢复链，并确定性注入上一轮失败证据指针，同时保持对安全失败的不自动重试
+- 后端测试用例生成与独立 Review 改为产品需求优先，并穷举文档化 API 规则，涵盖生命周期、枚举等价类、长度数值边界及业务状态迁移等场景
+- 后端测试 HTML/facts 新增可展开的“用例场景覆盖分析”和“Markdown → pytest 一一对应”质量详情
+
+### 改进
+
+- backend-test 用例生成/独立 Review 改为产品需求优先，再穷举文档化 API 规则：覆盖 active/deleted duplicate-name 生命周期、每个合法枚举值、非法枚举等价类、长度/数值边界、字符格式、null/missing/type 错误和业务状态迁移；每个 Case 绑定唯一 primary pytest symbol
+- backend-test 将 Coverage Test Point 与 pytest 执行单元解耦：Test Point 明确分为 `variant`、`assertion`、`cross-cutting`，只有真实输入/状态/结果变体生成参数 item，同一业务旅程检查点通过 symbol docstring 追溯，HTTP 日志等横切证据不再制造重复业务 item；报告区分 Markdown Case、primary symbol、pytest item 并展示执行放大率
+- backend-test HTML/facts 新增可展开的“用例场景覆盖分析”和“Markdown → pytest 一一对应”质量详情，并由最终报告分别消费节点 4/6 详细 findings 与节点 7 machine totals
+- 减少全量测试中的重复 CLI 冷启动和 self-host canary 二次打包安装场景，收敛低价值重复用例并保留关键端到端主路径
+- DAG 执行期间的主会话行为约束得到增补：启动后自主推进至结束、持续可靠判活、严格限制工作区文件修改，并优先使用纯函数探针排查路由
+
+### 修复
+
+- 修复 Windows 上 Pi writer 已完成写入后，write guard 启动 `git status` 偶发 `0xC0000142 / STATUS_DLL_INIT_FAILED` 而快速失败的问题：对该精确状态启用更长的有界指数退避和同一 Git for Windows 安装内的 executable fallback，持久化 writer 前置 baseline 与逐次结构化诊断；所有尝试耗尽后仍保持 fail-closed
+- 修复后端测试节点 4/6 的确定性覆盖与对应分析在自身崩溃时被静默吞掉的问题，现会写入诊断信息并按基础设施故障安全停止
+- 修复后端测试节点 4、6、7 在缺失 spec.sourceBinding 时未统一停止的问题，避免上游回退导致下游 manifest 突发报错
+- 修复成功执行路径下 HTTP 请求/响应日志解析不规范的问题，现统一规范化大小写不敏感的日志前缀并完整解析 JSON，恢复报告中的请求参数与大响应正文
+- 修复 Pi writer 已输出合法结果却因前置说明、Markdown 装饰或中文标点被误判失败的问题，现确定性规范化唯一 outcome 且不影响无副作用操作
+- 修复 Pi writer 前置 Git 快照失败被延后处理的问题，现调用模型前即安全停止，并在失败信息中保留完整的尝试次数与错误上下文
+- 修复不稳定模型输出导致受监督 DAG 无法可信收尾的问题，现使用精确判定协议和有限重试，确保最终状态准确且保持安全关闭
+- 修复合并后 canonical DAG Pi MED 路由错误回退到旧模型的问题，统一恢复为正确配置
+- 修复脚手架样例漂移检查误判当前 worktree 目录名的问题，避免附加 worktree 触发稳定测试失败
+- 修复 Windows 8.3 短路径与长路径指向同一仓库时生成不同指纹的问题，避免应用数据命名空间冲突
+- 修复生成的 OpenCode 恢复插件在 busy→idle 竞态下丢失续接的问题，现保留待处理错误并在明确空闲后安全重试
+- 修复 Pi retry 配置读取将权限或 I/O 错误误判为缺文件的问题，现仅缺失文件时允许新建配置
+- 修复客户端瞬态恢复无法正确处理 TypeValidation 瞬时错误的问题，现能准确识别携带瞬时信号的错误并安全重试，纯 schema 校验失败仍被拒绝
+
+## [0.25.4] - 2026-07-31
+
+### 新增
+
+- stream run progress heartbeats
+
+### 新增
+
+- stream run progress heartbeats
+- improve HTML failure triage
+- add native checklist and HTML report gates
+
+### 修复
+
+- tighten production URL detection
+- preserve supported Pi default model
+- sync packaged prompt contract
+- normalize drifted case ids and decode nested HTML entities
+
+## [0.25.3] - 2026-07-30
+
+### 重点更新
+
+- 新增 OpenCode 客户端瞬态会话恢复机制，在内置重试遗漏时自动补偿 UnknownError
+- 优化前端实现需求路由，将前端开发与测试任务准确分发至对应 DAG 流程
+
+### 新增
+
+- loop-agent init 支持 --client-recovery 参数，可在目标项目生成 OpenCode 插件以补偿瞬态 UnknownError
+- 支持在用户级别原子写入 Pi retry 推荐配置，并严格遵守插件 ownership 不覆盖用户改动
+
+### 改进
+
+- 初始化或刷新 AGENTS.md 时，要求将明确的前端实现需求路由至 frontend-implementation，与浏览器和 UI 自动化测试区分开
+
+### 修复
+
+- 修复生成的 OpenCode 恢复插件无法按真实 API 工作的问题，现直接返回 Hooks.event 并按事件正确分发与续接
+- 修复 Type validation failed 等真实错误被业务校验规则误杀的问题
+- 修复 Pi retry 配置读取将权限或 I/O 错误误判为缺文件的问题，现仅 ENOENT 视为缺文件
+
+## [0.25.2] - 2026-07-30
+
+### 重点更新
+
+- 加固后端测试中文 HTML 报告的用例关联与解析逻辑，提升报告的准确性与可读性
+
+### 改进
+
+- 改进基于 class 的 pytest node id 解析，准确提取真实脚本路径，避免显示为 unknown.py
+- 当用例名称缺失后端 ID 时，支持按函数名与 Markdown catalog 进行回退关联
+- 规范化 [REQ]/[RESP] HTTP 日志块，增强日志兼容性
+
+### 修复
+
+- 修复成功执行路径下原生 pytest-html 报告未正确保留的问题，现会将其另存为 backend-test-pytest-native.html
+
+## [0.25.1] - 2026-07-30
+
+### 重点更新
+
+- 后端测试 DAG 节点新增 JaCoCo 覆盖率收集能力，支持在 L-5 dashboard 展示 Java 后端的代码行与分支覆盖率
+- 规范任务 DAG 草稿的默认输出路径，统一指向 `.harness/tasks/<task-id>/dag.json`
+- 修复 loop-agent 技能条目因注入预算超限被截断的问题，确保默认 DAG 下技能完整解析
+
+### 新增
+
+- backend-test DAG 节点 7 支持可选的 JaCoCo 覆盖率收集：通过跨网络 TCP dump JaCoCo tcpserver 数据，经 jacococli.jar 转换并解析为 code-coverage-v1 合约，供 L-5 dashboard 使用
+- task shell 配置新增 `jacocoCoverage` 字段，支持配置 endpoint、cliJarPath、includes 和 connectTimeoutMs
+- 新增面向开发与运维的 JaCoCo 覆盖率部署指南，涵盖 tcpserver agent 挂载、端口放行、cli 预装及安全提醒
+
+### 改进
+
+- `dag run-task` 与 `dag init-hybrid` 的默认输出路径改为 `.harness/tasks/<task-id>/dag.json`，不再写入系统临时目录
+- agent-worker 在 strict validate 成功后，将校验通过的草稿原子同步到 task 根 `dag.json`
+- task read-model、delegate worktree 提示及各文档示例统一指向规范化的任务草稿路径
+- skills 补充 `source-and-plan-practice.md`，明确 `import-prd` 与 `plan create` 的决策表与推荐顺序，不强制微小任务
+
+### 修复
+
+- 压缩 SKILL.md 及 required-reference 体积，修复默认 DAG 技能注入预算超限导致 loop-agent 条目被截断的问题
+
+## [0.25.0] - 2026-07-30
+
+### 重点更新
+
+- 新增确定性 Feature Packet 脚手架，支持后端、前端及含 API 前端模板，并具备原子批量写入与预检能力
+- 新增 Feature 交付编排命令，自动串联最终验证、交付与收口流程
+- 显著提升 DAG 执行稳定性，修复超时残留子进程、重复验证及耗时记录不完整等问题
+- 新增任务级 Maven 验证规划，自动定位并仅针对相关模块执行验证
+- 后端测试节点现可自动生成指标机器计算的自包含 L-5 可视化报告
+
+### 新增
+
+- backend-test DAG 节点 7 支持可选的 JaCoCo 覆盖率收集（Java 服务）：task shell 配置新增 `jacocoCoverage`（endpoint + cliJarPath + includes + connectTimeoutMs）；节点 7 在 pytest 后跨网络 TCP dump JaCoCo tcpserver 执行数据，用 jacococli.jar 转为 jacoco.xml，确定性解析为 `contracts/code-coverage-v1.json` 并喂给 L-5 dashboard 的 line/branch 指标；全程失败安全（endpoint 不通 / cli 缺失 / 解析失败 → 覆盖率降级 unavailable，不阻断测试与 L-5）
+- 提供 agent-worker Feature Packet 脚手架，内置 backend-only、frontend-only 和 fe-with-api 模板，支持原子批量写入与 validate-feature 预检
+- 新增 agent-worker feature advance 命令，编排 verify-final、delivery 到 closeout 的完整交付路径
+- 新增 agent-worker feature doctor 命令，提供只读的交付就绪诊断（覆盖证据、Pool 状态与工作区改动）
+- Maven 验证现支持任务级范围规划，根据任务涉及的目录自动定位并验证正确的 POM 模块
+- 后端测试 DAG 节点 7 现可确定性生成美观的自包含 L-5 可视化报告，指标完全由机器计算
+
+### 改进
+
+- Feature Delivery 在省略特定参数时，默认使用 feature verify-final 写入的标准证据路径
+- TaskConfig 持久化入口在写入前执行 schema 校验，拒绝不符合规范的数据格式
+- Dogfood 前端测试服务器在检测到旧缓存导致接口数据异常时，现会自动强制重启恢复
+
+### 修复
+
+- 显著加固 DAG 执行可靠性，修复超时或中断后子进程残留问题，降低文件占用与测试干扰概率
+- 修复受监督流程可能重复执行完整验证的问题，避免高成本检查在不同阶段反复运行
+- 修复 DAG 被放弃或替换时，运行中节点实际耗时记录不完整的问题
+- 修复 Windows 环境下因提示内容过长导致 DAG 无法启动的问题，现安全采用受控临时文件传输
+- 修复前端实现 DAG 在未确认项目 Mock 能力时误报缺失 Mock 文件的问题
+- 修复结构化任务配置中数组类型校验不严格的问题
+
+## [0.24.10] - 2026-07-29
+
+### 修复
+
+- Closeout 重验不再要求 `should`/partial AC 绑定完整 run evidence（仅 `covered` must AC 强制 hash 绑定）
+
+## [0.24.9] - 2026-07-29
+
+### 重点更新
+
+- 后端测试执行失败时的诊断信息更加完善，避免出现无输出导致无法定位的问题
+- 修复 Windows 环境下前端证据校验因长命令终端转义导致的崩溃
+- 节点检查器新增「节点输入」只读页签，支持安全审查冻结的节点定义
+
+### 新增
+
+- Observe / Inspect 节点检查器在「节点输出」左侧新增「节点输入」页签：只读投影冻结 run.json 顶层节点定义（任务正文、依赖、执行器摘要、边界）与可选 assembled prompt 指纹
+
+### 改进
+
+- 后端测试节点执行失败时可观测性增强：写入包含映射脚本、PYTHON_BIN、pytest 版本、exit、html 是否存在与 STEP 等信息的诊断文件，并在节点 stderr 汇总失败摘要
+
+### 修复
+
+- 修复前端证据校验在 Windows 下通过长 node -e 命令执行时的终端转义崩溃：改为由 runtime 内部直接校验，兼容 CMD、Git Bash、PowerShell 与 Unix shell
+
+## [0.24.9] - 2026-07-29
+
+### 修复
+
+- Closeout 重验不再要求 `should`/partial AC 绑定完整 run evidence（仅 `covered` must AC 强制 hash 绑定）
+
+## [0.24.8] - 2026-07-29
+
+### 重点更新
+
+- 修复 FINAL-VERIFY 改写已存在的 allowed_paths 证据（gitignore）时 Git checkpoint 误失败，以及 record-error 后 Task Pool 卡在 Running 无法 mark-failed/retry 的问题
+
+### 修复
+
+- `finalizeGitTask` 对 allowed_paths 内的 pre-existing ignored evidence 允许 rewrite 并 force-add
+- `runReadyTasks` 在 record-error 时 best-effort 投影 `runs.jsonl` + Failed 状态，便于官方 retry
+
+## [0.24.7] - 2026-07-29
+
+### 重点更新
+
+- 修复 Feature Verification Bundle 在 Delivery 重验时因绝对路径 artifact、`qa-testcode` 类型与 `run_record` 后写 hash 漂移而失败的问题
+
+### 修复
+
+- 修复前端证据校验在 Windows 下通过长 `node -e` 命令执行时的终端转义崩溃：改为由 runtime 内部直接校验，兼容 CMD、Git Bash、PowerShell 与 Unix shell
+- 修复 `frontend-implement-pi` 因复用需求发现 skill 而长时间侦查后空实现：contract 现在强制 requirement outcome 与 interaction 行为语义，implement/repair 改用不含递归 OpenSpec/AI workspace 搜索的 bounded skill，并由 `implementation-outcome-v1` 机器校验声明结果与实际 diff；只有显式 already-satisfied 才允许空 diff
+- Outcome 投影强制写出 repo-relative artifact 路径
+- Delivery `verifyArtifactRefs` 接受位于仓库内的绝对路径（兼容旧 envelope）
+- `verifyBundleTaskSpecBindings` 接受 `qa-testcode`（backend-test）与 `qa-execute`（frontend-test）
+- Bundle 重验仅 rehash typed evidence（backend/frontend-test-result），忽略可能后写的 run_record
+
+## [0.24.6] - 2026-07-29
+
+### 重点更新
+
+- 修复后端测试 Markdown-first 成功路径未投影 `backend-test-result` 的问题，Ready Planner 可再次放行 FE-TEST
+
+### 修复
+
+- Markdown-first `markdown-execute-html` 在解析原生 pytest-html 后立即物化 `contracts/backend-test-result.json`（Result v1），避免 styled HTML 覆盖后丢失 JSON island
+- `node-execution` 对 `markdown-execute-html` 绑定 `structuredArtifact*`，Outcome 适配器可投影 `kind: backend-test-result`
+
+## [0.24.5] - 2026-07-28
+
+### 重点更新
+
+- 后端测试 Markdown 模块与 pytest 脚本实现一对一精准映射，提升测试执行的确定性
+- 修复后端测试 HTML 报告中请求参数显示为空的问题，正确展示请求与响应日志
+- 初始化项目支持将「帮我完成/实现/修复」等通用需求表达直接路由进 Agent DAG
+- 新增裸 agent-worker console 入口，简化本地看板启动流程
+
+### 新增
+
+- 初始化后的目标项目支持将「帮我完成/实现/修复/开发」等通用需求表达确定性地路由进 Agent DAG（new-task → dag run-task → dag validate → run-dag），无需追加额外的 cli 关键词
+- 新增裸 agent-worker console 入口，直接启动 Loop Operator Console，repo 默认当前目录、port 默认 8790
+- check-skill-entry.sh 及初始化投影脚本支持解析 YAML 折叠块，对通用需求触发词建立机器门禁以防漂移
+
+### 改进
+
+- 后端测试收敛模块映射，生成与评审 prompt 强制模块文件一对一映射，在映射缺失时支持确定性恢复
+- 后端测试 execute/report 节点文案与 pytest-html 真源对齐，移除残留的 JUnit 表述
+- 后端测试 HTML 报告对齐 R04 模板样式，采用全 inline style 设计（渐变 banner、可折叠用例卡片、状态胶囊及请求/响应分块展示）
+- 本地看板启动更简，端口被占用时不再自动更换，改为明确提示使用 --port 显式指定其它端口
+- 旧项目经 init check-update 与 apply-safe 即可安全补回新的「通用需求实现」路由行，并保留用户自定义前言
+
+### 修复
+
+- 修复后端测试 HTML 报告中请求参数显示为空的问题：渲染器现已兼容 payload= 键或 JSON request_record 格式的请求摘要
+- 修复后端测试报告无法正确获取请求/响应日志的问题：兼容 HTTP_REQUEST 与 HTTP REQUEST 两种日志前缀，并在解析前正确解码 HTML 实体
+- 修复 shell-executor 在 Windows 环境下因反斜杠路径导致 runDir 损坏的问题，确保路径注入稳定
+- 修复前端 lint baseline 在 Windows 下因路径解析逻辑缺陷，拒绝相对路径输出导致评估误报为不可用的问题
+- 修复多个测试固件在 Windows 下因嵌套 Shell 引号剥离导致命令执行输出为空或报错的问题（涉及 composite-shell 与 init-command）
+
+## [0.24.4] - 2026-07-28
+
+### 重点更新
+
+- 控制台「导入需求」支持多文件批量导入，自动合成可编辑正文后创建任务
+- 后端测试移除重复运行稳定性门槛，每次执行同时生成用户可读的 HTML 与 Markdown 报告
+- 本地 pre-push 钩子升级为执行完整 CI 流程，覆盖治理检查、类型检查与全量测试
+
+### 新增
+
+- 控制台「导入需求」支持选择或拖入一份或多份 Markdown/TXT 文档（严格 UTF-8，单文件 ≤8 MiB，最多 8 个），多文件分卷归档并合成可编辑正文后创建任务
+
+### 改进
+
+- 后端测试 L-5 结论不再将重复运行稳定性作为门槛，每次执行同时产出用户可读的 HTML 与 Markdown 报告，内部 facts 文件保留用于审计
+- 本地 pre-push 钩子改为执行完整 CI 流程（治理检查 + 类型检查 + 全量测试），pre-commit 保持仅执行 check-repo
+- harness 中等复杂度（MED）模型调整为 grok-4.5，并同步对齐相关 smoke/init 断言
+- 归档已完成的设计文档与执行计划，刷新 0.24.x 六个月规划与能力摘要，并同步验证与 hooks 文档
+
+## [0.24.3] - 2026-07-28
+
+### 重点更新
+
+- 发布工作流改为发布已通过完整门禁并经 SHA-256 校验的 npm tarball，避免 `npm publish` 再次触发全量测试、类型检查与构建。
+- 默认 `standard` 实现任务在 React、Next.js 或 Vue 项目中直接选择 `frontend-implementation` DAG，不再依赖需求关键词；明确后端、文档/测试范围或前端否定仍保留对应通用流程。
+
+## [0.24.2] - 2026-07-28
+
+### 重点更新
+
+- 夜间自动发布固定为 patch 通道，不再因功能提交自动跳转次版本号
+- 新增人工次版本发布工作流，支持显式触发 v0.x.0 版本线升级
+- 夜间发布支持幂等恢复，重跑时自动探测并跳过已完成步骤，冲突时安全失败
+- 控制台聊天工作台布局收紧，新增聚焦模式与落地页设计
+
+### 新增
+
+- 新增 manual-minor-release 工作流，仅在显式触发时强制 bump minor 版本
+- 控制台新增 ChatLanding 子组件，提供无会话/空会话模式下的落地页与建议网格
+- 聊天压缩失败分类器新增对 token 预算超限、已压缩、模型缺失、活跃对话及不支持运行时等场景的精确 HTTP 状态码映射
+
+### 改进
+
+- 发布工作流将最终门禁拆分为独立可观测步骤，并去重以提升执行效率
+- 夜间自动发布固定为 --bump=patch，确保版本递增稳定在 0.x.y + 0.0.1
+- 文档版本引用现支持 floating/current/minimum/range/historical 五类语义声明，合法旧文档不再误阻塞发布
+- 控制台聊天界面收紧工作台密度，新增 is-chat-focus 类锁定视口，仅消息区域滚动且输入框固定底部
+- 聊天压缩接口现通过分类器返回类型化错误码，替代原有的通用失败提示
+
+### 修复
+
+- 修复发布流程接受 GitHub Release 目标时无法正确处理符号引用的问题
+- 修复 GitHub 状态探测缺少认证导致发布恢复判断不准确的问题
+- 修复夜间发布恢复时未针对当前版本标签进行探测的问题
+- 修复夜间发布与手动次版本发布通道混淆的问题，现拆分为独立的 patch 与 minor 通道
+- 修复文档版本治理将合法的旧版本引用误判为漂移并阻塞发布的问题
+
+## [0.24.1] - 2026-07-27
+
+### 重点更新
+
+- 后端测试 HTML 报告全面升级，采用更清晰的可折叠用例卡片设计，直观展示脱敏的请求与响应详情。
+- 彻底修复了 Windows 环境下因 cmd.exe 与 bash 嵌套引号转义不当，导致前端与初始化测试固件执行失败的问题。
+- 前端实现 DAG 大幅优化，复用现有 run-owned canonical artifacts，有效精简了常规全绿路径的直接依赖节点数量。
+
+### 新增
+
+- 后端测试第 7 节点现使用 pytest-html 生成自包含报告，并新增解析器从其 JSON island 提取每条用例的结果与日志。
+- 后端测试生成的 pytest 文件名现可与 Markdown 模块建立一对一清晰映射。
+
+### 改进
+
+- 后端测试 HTML 报告对齐 R04 模板样式：改用全 inline style 设计，包含渐变 banner、可折叠用例卡片、状态胶囊以及请求参数与响应结果分块展示。
+- 前端 canonical implementation contract 允许纯逻辑修改使用空的 UI state，不再强制虚构，并会确定性移除不适用状态下的空输出。
+- 前端实现 DAG 的多个节点（如 frontend-implement-pi、frontend-review-pi 等）直接依赖得到收敛，不再重复读取完整任务源或上游冗余文本。
+
+### 修复
+
+- 修复后端测试 HTML 报告中请求参数显示为空的问题：渲染器现已兼容 payload= 键或 JSON request_record 格式的请求摘要。
+- 修复后端测试报告无法获取请求/响应日志的问题：兼容 HTTP_REQUEST 与 HTTP REQUEST 两种日志前缀，并在解析前正确解码 HTML 实体。
+- 修复 shell-executor 在 Windows 环境下因反斜杠路径导致 runDir 损坏的问题，确保路径注入稳定。
+- 修复前端 worktree baseline 解析 git status 时因提前 trim 导致未暂存文件路径丢失首字符的解析缺陷。
+- 统一 DAG 任务源路径生成与运行时解析基准，解决 freshness、rerun 与预览共享不一致的问题。
+- 修复前端项目在需求未显式提及 UI 时被误判保留为标准任务的问题，提升了基于工程证据与交互语义的任务类型推断准确度。
+- 修复前端 lint baseline 在 Windows 下因路径解析逻辑缺陷，拒绝相对路径输出导致评估误报为不可用的问题。
+- 修复多个测试固件在 Windows 下因嵌套 Shell 引号剥离导致命令执行输出为空或报错的问题（涉及 composite-shell 与 init-command）。
+
+## [0.24.0] - 2026-07-27
+
+### 新增
+
+- align chat workspace with pi web UX
+- operator chat workspace UX + async runtime race guards
+- operator chat M3-M7 (draft interview, human-gate, input context, artifacts, branching, landing)
+- pytest-html report + filename mapping + Windows path fix (#71)
+
+### 改进
+
+- style(console): 收紧 Operator Chat 工作台密度与侧栏体验
+- style(console): prettier-format Operator Chat + keep UI-contract text intact
+
+### 修复
+
+- operator chat M2 closure tracer + code review followups
+
+## [0.23.1] - 2026-07-26
+
+### 重点更新
+
+- **Console Phase 4 — General Operator Chat**：在 `agent-worker console` 内交付 Pi 驱动的自由对话入口，用自然语言多轮编排 loop-agent / agent-worker；暴露全部 operator action（registry 动态派生）+ 内置探查工具 bash/read/grep/find/ls，仍禁文件写入 coding tool；含两轮代码审查的 P1 修复（builtin tool 注册、schema↔dispatcher 契约、server 生命周期、tool policy 统一）与 followup 修复（缩进、SSE 错误兜底、文档同步、waitForIdle 超时+心跳）
+- DAG 新增显式 failure-aware 依赖语义，允许只读恢复节点容忍上游 ERROR 并读取失败证据执行收敛
+- review verdict 协议重试耗尽后支持确定性规范化，缺失或冲突时仍严格报错
+- 新增 recovery recommendation 稳定下一步分类，为各类失败提供明确的修复或重试路由提示
+- loop-agent doctor 新增机器可读 JSON 报告与只读上下文审计能力
+- loop-agent stats context 提供近端 DAG 运行的上下文用量只读聚合统计
+- AGENTS.md 与 init managed block 采用感知源码的精简策略，保留路由与硬约束不变
+- 全面深化文档治理体系，引入目录状态语义、审查策略与外部方法论单轨融入
+
+### 新增
+
+- **Console Phase 4 — General Operator Chat（Pi SDK services 模式）**：
+  - 后端 `src/worker/console/chat/`：`pi-runtime.ts`（services 模式 SDK 包装 + session 隔离 + 显式注册 builtin 探查工具 `tools:[bash,read,grep,find,ls]`）、`tool-adapter.ts`（operator action → Pi tool schema，动态发现 fail-closed）、`session-store.ts`（Gate 3 per-call 授权 + per-session write chain）、`routes.ts`（SSE 流式 HTTP）、`tools.ts`（全 operator action 动态派生白名单）、`resource-loader.ts`（封闭 ResourceLoader）、`model-resolver.ts`（harness.json 动态解析，无硬编码）、`instruction-skills.ts`（9 个只读 skill 白名单）
+  - 前端 `OperatorChat.tsx` + `ChatMarkdown.tsx`：多行 composer、Markdown 气泡、可折叠工具侧栏、停止生成、智能贴底滚动；零依赖 Markdown 渲染
+  - 默认模型从 `harness.json executors.pi.MED` 动态解析，按「bare-id 优先 + 有凭证优先」选取 provider（无硬编码回退）
+  - 红队验证 V12/V14/V15/V16：文件写入 coding tool 必拒、credential 不回传、高风险 action 无 prepared receipt 必失败、模型伪报 complete 不覆盖 deterministic validation
+- DAG 显式 failureAwareDependsOn 依赖语义，支持只读恢复等价节点显式声明容忍指定上游节点的 ERROR
+- review verdict 协议重试耗尽后的确定性规范化：当恰好存在一个合法受支持且无冲突的 verdict 行时自动规范化为首行
+- recovery recommendation 稳定下一步分类：为 nonzero-exit、protocol-invalid 等各类失败提供稳定的 repair/revision/retry 路由提示
+- loop-agent doctor --json 输出单一可 JSON.parse 的 typed DoctorReport，供人与机器共享同一事实源
+- loop-agent doctor --context 提供只读上下文审计，报告默认策略、技能清单与预算跳过情况
+- loop-agent stats context [--last N] [--json] 只读聚合最近 DAG 运行的技能解析与节点结果
+- 新增 scripts/eval-dogfood-context-engineering-ab.sh，支持复现演练 AGENTS map verbose→slim A/B 协议
+- skill registry 增加 verification placement taxonomy（standalone/embedded/chained/PR-bound）创作词汇
+- 新增 docs/architecture/agents-invariants.md 作为源 AGENTS 与 managed block 不变量合同的单一真源
+- 新增 docs/templates/README.md 并纳入 package / full init / init check-update 面
+- 新增文档治理任务式 README、机器可读 document-catalog.json 与 check-doc-governance.mjs 语义检查器
+- 新增文档审查策略与三档 reviewTier freshness 策略，支持按 UTC 日期边界阻断过期文档
+- 新增设计原则与范式转移起源文章，并发布到网站实践文档
+
+### 改进
+
+- supervised 模板的 process-supervisor-pi 可显式消费 soft-verify-shell 的 ERROR，使失败进入有界修复收敛链
+- supervised 中间验证未显式配置时不再继承 verifyQuota: full，默认只取配额 1
+- 生成 DAG 的验证命令默认单命令超时由 5 分钟提升为 30 分钟，避免全量测试误判为超时
+- failure-aware 节点可在 upstream_context 中读取被容忍上游 ERROR 的 stdout/stderr 等作为失败证据
+- loop-agent public skill 增加默认预算完整性回归，确保关键 entry 与 required references 在默认预算下完整解析
+- skills/loop-agent/SKILL.md 将 command-reference.md 从 required 调整为按需 reference，保持在默认预算内
+- doctor 与 stats context 的 JSON 模式不再输出 [loop-agent] banner，保证机器输出可直接解析
+- 源仓库 AGENTS.md 与 init managed block 采用感知源码的精简，长解释指向 docs/，保留开工路由与硬约束
+- 调试纪律要求先建立快速确定性反馈回路再进入根因调查；verifier skill 强调不得越过 writer 边界
+- 任务与 TDD 明确采用垂直 tracer bullet（一测试一实现），避免水平层批处理
+- ADR 增加三门槛过滤；CONTEXT.md 明确只承担术语表职责；grill-with-docs 按 governanceRoot 解析 decisions
+- 外部工程方法论按单轨治理融入 docs/skills/init（ADR 0006），不引入平行状态树
+- 文档治理完成当前权威与内容可信度审计，修正设计入口、能力摘要与网站 roadmap 中的归档状态表述
+- 文档治理完成实际归位，工程规则、runtime 手册和维护操作分别进入清晰目录，当前设计与历史设计分开
+- 文档入口版本与状态对齐 @tea-agent/loop-agent@0.22.0
+- Pi 中等复杂度节点默认模型由 glm-5.2 调整为 gpt-5.5；LOW 与 HIGH 路由保持不变
+
+### 修复
+
+- DAG run-task 持久化 writer 草稿生成前强制要求 managed Task Contract，未管理时在写出前失败并提示人工处理流程
+- Task source 指南修正 verifyCommands 示例为 { label, command, timeoutMs? }[]，并补充旧字符串数组迁移说明
+- 根 Vitest 配置排除 .worktrees/** 隔离 checkout，避免显式测试文件参数误收集旧副本
+- 受监督的 DAG 失败收敛机制修复，确保在有监督失败时保持收敛性
+- DAG bootstrap 合约反馈修复，确保引导阶段正确收敛
+- 修复 check-doc-governance.mjs 未忽略 .DS_Store/Thumbs.db 等 OS 生成文件导致仓库目录测试失败的问题
+- 修复 context-engineering 提案中指向 exec-plans/active/ 的过时链接，更新为实际的 completed/ 路径
+- 校准 context-engineering 提案中的实现证据（测试计数与 AGENTS.md 行数）以匹配当前代码实际产出
+- Console Phase 4 Chat 审查 followup：createSession 缩进规整；handleChatPrompt 加 try/catch+finally 兜底 SSE error 与 res.end；waitForIdle 超时 120s→45s 并新增每 10s heartbeat（SSE comment 帧）防代理超时；设计文档 §7.2.1/V25/§13 同步 widening 契约
+- Console Phase 4 Chat P1 审查修复：`createSessionFromServices` 显式传 `tools:[bash,read,grep,find,ls]`（SDK 默认 builtin 不含 grep/find/ls，否则 setActiveToolsByName 静默 no-op）；schema↔dispatcher 契约对齐（contractValidate/Diff 用 draftJson、workerTaskRetry 补 featureId、动态发现 fail-closed）；server.close() 先 chatRuntime.disposeAll()；resource-loader/system prompt 统一到 widening（hasBash:true）
+- CI 治理：7 个 versionConsumer 文档版本漂移 0.22.0→0.23.0；check-task-pool-root.sh allowlist 增补 codify-constraints.md
+
+## [0.22.0] - 2026-07-24
+
+### 重点更新
+
+- 前端规范读取范围扩展，新增 ai_workspace 作为并列来源，并独立展示各类规范证据
+- 前端实现 DAG 引入 lint 债务基线机制，精准区分存量与新增代码问题，减少误阻断
+- 前端预写门禁增强，强制校验真实的规范读取事件，避免遗漏关键上下文
+- 后端测试报告结构优化，新增 Markdown 报告并改进 HTML 报告的分层展示
+
+### 新增
+
+- 前端规范读取将 ai_workspace 目录与 openspec 相关目录作为并列来源，即使缺少 package.json 也能发现本地规范候选
+- Dashboard 规范证据 API 与界面独立展示知识库查询、openspec 检索和成功读取三类证据
+- 后端测试在同目录下新增生成 backend-test.md 报告，便于查阅测试结论与明细
+
+### 改进
+
+- 前端实现 DAG 允许未修改文件中的已知 lint 诊断作为基线债务继续，但对修改文件的新问题严格阻断
+- 后端测试 HTML 报告采用更清晰的分层展示，新增稳定结论图标与可折叠的质量校验明细，移除了原稳定性指标
+- 前端测试用例的内容完整性与证据检查降级为建议性反馈，不再因个别物料缺失阻断最终复盘
+- 设计文档与研发 DAG 拓扑说明同步更新，澄清了 profile/workflow/type 三套正交概念与当前实现状态
+
+### 修复
+
+- 修复前端技能指令可能超出预算限制的问题
+- 修复 DAG 未正确注册 DeepSeek Pi 模型提供者的问题
+- 修复前端目标项目验证路由不够健壮的问题
+- 修复后端测试中无法跨环境便携解析 Python 运行时的问题
+
+## [0.21.0] - 2026-07-24
+
+### 重点更新
+
+- DAG/Pi 自适应活跃度监管：精准区分传输活动与真实执行进展，受控处置静默卡死，避免误杀。
+- 后端测试执行范围收窄：仅运行最终 Markdown 明确映射且通过安全校验的脚本，杜绝无关测试混入。
+- 后端测试 HTML 报告全面升级：采用清晰的用例卡片，直观展示脱敏的请求与响应详情。
+
+### 新增
+
+- DAG/Pi 自适应 liveness 与非误杀监管：区分 runner lease、transport 活动与 Provider/tool/output 真实进展；节点可投影 active/quiet/suspected-stall/probing/needs-attention；静默 stall 会受控终止，退出无法确认时禁止自动重试；Pi absolute max 对齐 4h；Worker 默认不再给 `run-dag` 设置外层 wall-clock，显式 `worker.timeout_ms` 仍为 hard timeout。
+
+### 改进
+
+- backend-test 第 7 节点现在只执行最终 Markdown `自动化映射` 明确声明且安全校验通过的 pytest 脚本，避免历史或无关 `test_*.py` 混入本轮 JUnit/HTML；空映射、缺失脚本或越界路径会 fail-closed。
+- backend-test HTML 报告升级为更清晰的用例卡片：保留测试结论、质量状态和失败概览，直接展示简洁测试场景、自动化用例名称、结果与耗时，并为通过/失败用例都展示同次执行中脱敏且有界的接口请求参数与响应结果；HTML 不再附带技术证据章节，审计路径与哈希继续保留在 facts/JUnit。
+- frontend-test 第四节点不再扫描或阻断 pytest、原生 Playwright、`npx playwright`、`@playwright/test` 或 Node Playwright API 等可执行工具指令；该节点只保留 manifest、Case/AC/path、非生产 URL 和标准 `playwright-cli open` 前缀等结构与安全门禁，并强烈建议浏览器执行优先使用 `playwright-cli`。
+- frontend-test 用例内容、Case ID、AC 关联与 evidence 完整性检查改为 advisory：缺失或损坏的执行物料不再被自动改写为 blocked，也不阻断最终复盘；finding 汇入结构化结果，并在 Markdown retrospective 后生成中文 HTML 建议报告。路径越界、跨用例 evidence 引用、writeSet、生产环境与凭据安全仍保持硬门禁。
+- frontend-test checklist JavaScript 通过 Base64 参数交给 Node 解码执行，并修正变量声明顺序与重复语句，避免 Git Bash 将 `\s` / `\d`、反引号或引号破坏后再交给 Node。
+- 新初始化项目的 harness 指南同步 adaptive liveness、4h absolute max、stall 状态与 `termination-unconfirmed` 处置；旧项目可由 `init check-update` 识别未修改的受管指南，并通过 `init update --apply-safe` 安全刷新。
+
+## [0.20.1] - 2026-07-24
+
+### 新增
+
+- LLM/provider 偶发失败时可在同节点自动重试；reviewer 漏写 `VERDICT` 等协议错误也会在节点内纠错重试，不必等下游 gate 才失败
+- 新增 `loop-agent dag rerun`：在安全资格通过时，从选定节点重跑只读子图，并保留父 run 证据与 import 审计
+- 新增 `loop-agent dag rerun-task`：一键完整重跑 standalone 任务（重新生成、校验并执行），不修改父 run
+- Operator Console Recovery 提供明确动作：从节点重跑、完整重跑任务、重新排队 Worker Task（不再使用含糊的「重试」）
+- 前端规范读取将知识库与 `openspec/` 作为并列来源：无论知识库是否可用或命中，均继续递归枚举 `<repoRoot>/openspec/**` 并读取索引与任务相关规范正文。`discoverFrontendProjectCapability` 在没有 `package.json` 或 `package.json` 不可读时仍能发现 `openspec/**` 规范候选。
+- 前端预写门禁会校验 plan/design-review 的真实读取事件；生成期存在 `openspec` 规范候选但没有成功读取匹配文件时，在 writer 执行前阻断 DAG 并列出候选路径、检查节点和原因。
+- Dashboard 规范证据 API/UI 分别展示知识库查询、`openspec` 检索和 `openspec` 成功读取证据，三种类别独立展示。
+- 前端规范证据 API 新增 `openspecReads` 与 `openspecSearches` 字段，与通用 `specReads`/`specSearches` 并行。
+
+### 改进
+
+- backend-test 第 4 个 Markdown 校验节点只将前置条件、操作步骤和预期结果作为必需章节；需求来源引用有效性不再阻断后续测试。普通质量问题保持 advisory，但 secret-shaped 值会先生成脱敏安全报告再 fail-closed，避免进入 pytest、HTML/facts 和最终报告。
+- backend-test 生成的真实 HTTP pytest 现在必须输出脱敏且有界的请求/响应日志，包含 method、URL/path、请求参数摘要、响应状态和响应 body 摘要；追溯节点会在 Markdown 映射脚本范围内把日志合同缺口记录为 advisory。
+- backend-test 第 7 节点的 HTML/facts 按测试概览、质量校验、失败概览、用例执行明细和技术证据分层展示；第 8 节点使用固定简洁的中文收口结构，减少重复原文并优先展示结论和风险。
+- Operator Console「恢复」面板自动拉取 DAG 运行与节点候选，优先展示失败项并以选择器填入，仍可手动输入
+- 从节点重跑预检失败时展示真实安全资格阻断原因，不再误报为「无法获取 planHash」
+- 恢复页长操作（完整重跑等）会回写终态成功/失败；不再只提示「已接受」后无下文
+- 恢复原因按所选 run/节点与失败事实自动预填，并给出三步操作指引；手动编辑不会被覆盖
+- 恢复页将「DAG 运行恢复」与「Worker Task 重排队」分成独立区域，避免把 runtime DAG 与 Task Pool 动作混在一起
+- 恢复页去掉高亮「打开检视」，避免与顶部「观测」入口重复误点；需要时用「侧栏预览」或「全屏观测」
+- 恢复页「侧栏预览」在本页打开可关闭；全屏观测顶栏改为「返回操作台」
+- 修复侧栏预览：兼容 Observe 的 `nodeId`/`label`，并安全格式化 session-events（避免 React 渲染对象导致整页空白）
+- 恢复 CTA：查看报告改走 `dag report`（按 run ID）；推荐动作仅用橙色主按钮标出，悬停看说明
+- 从节点重跑 / 完整重跑任务点击后，在按钮下方出现「确定 / 取消」确认条
+- 恢复页不再展示仅弹 CLI 提示的按钮（如「重新生成契约/计划」）
+- 「查看报告」在按钮下方展示交接摘要（失败分类与建议），不再只闪顶部提示
+- 控制器指纹漂移错误改为中文提示：请重启 Console，勿在会话中途重建
+- frontend-test 环境预检：在生成用例前对冻结的非生产 `baseUrl` 做 curl 可达性探测；不可达或缺少 curl 时以 `frontend-base-url-unreachable` / `curl-unavailable` 阻断 generate/map，并写入 `environmentProbe` 事实。节点 5 manifest 物化改为 ruleId 失败分类、map 配额预检与 temp+rename 原子写入；生成/清单/执行强制 playwright-cli-only，U/D 场景要求当前用户数据归属或 create/Mock/blocked。
+- 前端测试 DAG 的证据自检改为按用例降级：个别缺失、空白或格式错误的证据会如实标为 blocked 并继续生成复盘报告；只有全部用例都未产生任何证据内容或证据路径不安全时才失败。
+
+### 修复
+
+- Observe 总览 KPI 问号提示框宽度与窄卡片解耦：提示框使用稳定的 240–280px 视口安全宽度，并在五列、三列和两列布局的右侧列向内对齐，避免宽屏下被压缩成约 78px 的窄条；hover 与键盘焦点行为保持不变。
+- 节点检查器的规范证据文件预览会渲染 Markdown 标题、列表、表格与代码块，不再把正文作为带语法标记的纯文本显示。
+
+## [0.20.0] - 2026-07-23
+
+### 新增
+
+- 继续收紧前端实现证据门禁：禁止空 verification contract，校验验证目标与 requirement/UI state/授权路径绑定；新版 review context 缺失 writer baseline 时直接阻断，非 `not-needed` Mock 策略必须提供 endpoint 与 consumer 证据。
+- 前端写入前重新校验 DAG 绑定源文件的 SHA-256；Mock endpoint 现在必须声明 fixture 与 consumer，且验证 trace 必须记录成功的 Mock 命令。
+- 前端验证 bundle 现在冻结实际命令文本，并将实现契约 targets 限制在 writer writeSet 内，避免验证证据与可写范围漂移。
+- 同步前端 prewrite/review context 的 DAG JSON Schema，避免生成 DAG 因 freshness、writeSet 或 baseline 字段漂移而被错误拒绝。
+- 前端 prewrite 现在强制校验需求源新鲜度，验证 Schema 也要求声明实际命令文本，减少旧 DAG 和证据配置的隐式降级。
+- 前端实现 DAG 的验证命令与侦察范围改为从目标项目自身的 package scripts、包管理器和允许路径推导，不再假设目标项目沿用 loop-agent 的目录与命令布局。
+
+### 改进
+
+- 前端实现 DAG 的验证命令与侦察范围改为从目标项目自身的 package scripts、包管理器和允许路径推导，不再假设目标项目沿用 loop-agent 的目录与命令布局。
+- 后端测试用例默认生成中文 README 索引与模块用例卡片，步骤、预期、需求依据和自动化映射更便于测试、研发与评审人员阅读。
+- 后端测试 HTML 主报告现在逐条展示用例编号、中文名称与场景、脚本、测试函数、结果、耗时和失败原因，完整技术详情可折叠查看。
+
+- streamline implementation DAG (#61)
+- improve human-readable artifacts
+
+### 修复
+
+- relax traceability mapping
+
+## [0.19.0] - 2026-07-23
+
+### 重点更新
+
+- Operator Console 统一整合 Operate 与 Inspect，在同一服务即可检视只读 Dashboard、DAG、时间线与 artifacts
+- 原 Observe 服务进入兼容期，仍可运行但会输出迁移提示，引导平滑过渡到统一控制台
+
+### 新增
+
+- 新增统一 Operator Console：`console serve` 同时提供 Operate 与 Inspect，支持通过 `/inspect/` 直接检视运行详情与 DAG
+- Console 健康检查接口升级，包含 Inspect 就绪状态与路由能力信息
+- `console serve` 新增局域网绑定（`--host 0.0.0.0`）与调试日志（`--debug`）选项，并在非本地访问时保留安全校验
+
+### 改进
+
+- `frontend-implementation` 保留独立 contract/scout，并把 Mock 策略与 implementation contract 合入 plan，把写前授权、验证/失败评估、复验和 review context 分别收敛为组合 shell 节点。standard/high-risk 固定 15 个顶层节点、small-risk 13 个；绿色路径执行 11 个节点、7 次 Pi，同时保留唯一 prewrite 写入授权、同 writeSet repair、真实 diff review 与 fail-closed closeout。
+- 加强前端实现节点的证据链：Trace 只绑定本次实际成功执行的验证命令，契约兼容转换不再补入占位文件或默认验证目标，Prewrite 要求上游节点明确完成，review context 校验 artifact 绑定，并以 writer 前工作区快照隔离既有用户改动。
+- 优化操作与观测统一界面的导航与布局，合并确认与运行为「开始运行」，DAG 详情跳转路径更加准确
+
+### 修复
+
+- 修复执行计划索引将命名约定占位符（如 `YYYY-MM-DD-<topic>.md`）误判为缺失计划引用的问题
+
+## [0.18.1] - 2026-07-22
+
+### 重点更新
+
+- 放宽后端测试 Markdown 用例的映射与验收标准校验，减少合法用例被误拦截的情况
+- 修复文档审计报错未阻断 CI 的治理漏洞，并全面修正失效链接
+- 清理发布日志中残留的已发布记录，避免将已上线能力误展示为未发布
+
+### 修复
+
+- 放宽后端测试 Markdown 用例的每条补充 Case 必须包含 AC 标识的硬性要求，改为确保任务要求的业务 AC 场景至少被一条最终用例覆盖即可，整体缺失必需 AC 时仍会严格阻断
+- 放宽后端测试 traceability 映射校验，Case ID 可位于测试函数名、装饰器、函数体或文档字符串区域，不再强制首行文档字符串或严格一对一映射，避免重复映射等情况导致的误阻断
+- 修复文档审计在发现错误时未返回非零退出码导致 CI 假绿的问题，并将链接门禁覆盖范围扩展至完整的 docs/ 目录
+- 修正文档报告分类迁移后遗留的 269 条失效链接
+- 修复自动发布创建版本区块时未正确消费已发布内容并清理残留记录的问题，移除了随 0.18.0 版本发布的 59 条残留日志
+
+## [0.18.0] - 2026-07-22
+
+### 重点更新
+
+- 后端测试全面采用 Markdown 优先工作流，整合环境预检、独立审查与确定性门禁，单次执行即可生成完整测试报告。
+- 前端实现与测试流程大幅优化，按需执行计划修订与验证，常规全绿路径执行节点数量显著减少。
+- 修复多项严格校验导致的误中断问题，大幅提升 Markdown 用例生成、追踪映射与异常清理的兼容性。
+- 优化 Pi CLI 与 SDK 执行器，彻底解决长文本输出导致的内存溢出与进程卡死问题。
+
+### 新增
+
+- 引入 Markdown 优先的后端测试工作流，支持环境预检、独立审查用例并生成自包含的 HTML 与 Markdown 报告。
+- 新增升级后的初始化面通知器，在检测到版本不一致时自动提示安全更新或引导人工处理。
+- 新增统一的初始化协调命令，支持安全应用更新并智能处理各类阻断情况。
+- 测试报告新增 L-5 指标消费与统一的代码覆盖率报告入口，支持 Python 与 Java 测试数据。
+
+### 改进
+
+- 前端实现绿色路径改为按需分支执行，常规无错路径可少执行多个节点，提升执行效率。
+- 前端测试用例生成现可自动解析明确的 baseUrl，不再保留占位符，避免执行异常。
+- 前端测试复盘报告写入路径调整，支持安全禁止整个 docs 目录的写入权限。
+- 夜间自动发布机制优化为双基线检测，手动补丁不再抹除同周期的功能信号。
+- GitHub Actions CI 优化执行策略，合并任务并跳过纯文档变更，有效降低私有仓库分钟消耗。
+
+### 修复
+
+- 修复 Markdown 用例追踪映射将 HTTP 状态码等数字误识别为用例 ID，以及无法正确识别带返回类型标注的测试函数的问题。
+- 修复 Markdown 用例门禁误拒绝合法的列表断言，以及无法正确解析相对路径绑定文件的问题。
+- 修复 Pi CLI 执行器将单个节点完整标准输出累积为单一字符串，导致长文本输出时内存溢出或卡死的问题。
+- 修复 Windows 环境下因清理环境变量导致 Python 和 pytest 无法正确发现用户级依赖的问题。
+- 修复初始化演进的高影响校验未覆盖专用路径，导致必要审查被静默跳过的问题。
+
+## [0.17.2] - 2026-07-22
+
+### 改进
+
+- Operator Console Happy Path 补齐：主导航（任务/恢复/模型与认证/设置）、newTask / importPrd、grill-me Interview（一次一问 + assessment）、SSE 运行跟随；Pi readiness 可刷新。
+- Operator Console 页面交互文案改为中文（导航、向导步骤、按钮与状态说明）；产品名与 CLI 命令仍保留英文术语。
+- Operator Console 界面与交互美化：暖色画布、胶囊导航、步骤进度条、统一按钮层级与状态条，运行面板元信息更清晰。
+- Operator Console Happy Path 增加「流程类型」选择（后端研发 / 前端研发 / 后端测试 / 前端测试），写入 `taskKind`；访谈枚举同步支持 `frontend-implementation` 与 `frontend-test`。
+- Console Happy Path 去掉单独的「创建任务」步骤：导入需求时根据 PRD 标题自动生成任务名称与 canonical taskId，并一键创建任务 + import-prd。
+- Operator Console 需求访谈可跳过：一键按 grill-me 推荐补齐草稿并签发评估，可直接进入契约校验。
+- Operator Console 将「校验契约 / 应用契约 / Spine 审计」合并为「契约落地」：自动确定性校验与差异，人工确认一次应用，成功后自动 Spine。
+- Observe 运行看板视觉对齐 Console：暖色渐变画布、胶囊导航、柔和面板阴影与状态点，减少高饱和色块；进一步统一 badge/表格/风险块/时间线/DAG 图与 inspector、对象关系条与推荐命令等视图组件。
+
+### 修复
+
+- Console Draft 在 validate/diff/apply 前会投影为 CLI 严格 schema：补齐 `constraints.invariants`，并去掉仅 Console 使用的 `updatedAt`，避免误报 draft schema validation failed。
+- 修复访谈完成后绑定 `interviewAssessmentRef` 会立刻让 assessment 过期的问题：`draftSha256` 不再纳入该绑定字段；finalize 时先清空 `openQuestions` 再签发 assessment。
+- 修复 Console `contractApply` 默认传入 `expectedObservedHash=unknown` 导致 OBSERVED_HASH_CONFLICT / 页面只见 `exit 1`：改为先 `task contract show` 再传真实 revision/hash；异步操作失败时展示 CLI 错误信息。
+- 修复应用契约后界面卡住：轮询操作结果时误读 `{ ok, operation }` 响应，一直等到超时且无法进入 Spine。
+- 修复 DAG 确认准备失败：不再提交空 stub DAG；`prepareDagConfirmation` 会经 `dag run-task` 生成真实 DAG；`dag validate` 接受 `--json` 兼容 Console。
+- 修复 Console `runDag` 因 `run-dag --json` 未识别而失败：CLI 现接受该旗标（输出本就为 JSON）。
+- 运行 DAG 不再用短超时阻塞整页：`runDag` 改为后台接受 + SSE 跟随；Observe 按钮与任务 busy 解耦，运行中可打开。
+- Console 打开 Observe 时，若只给 taskId，会解析该任务最新 DAG run 并跳转 `#/dag/<runId>`，不再误开 `#/task/<taskId>`。
+
+## [0.17.1] - 2026-07-22
+
+### 修复
+
+- TaskSpec materialize 在写入 task.json、需求和约束后会自动 adopt 或刷新 managed Task Contract，避免生成 v4 DAG 后立刻因 binding drift 无法 validate/run。
+- Operator Console 的 Pi readiness 改为真实探测 SDK、认证和可用模型；本机已配置 Pi 时不再误报 `setup-required`，界面同步对齐 Observe 暖白画布。
+
+## [0.17.0] - 2026-07-22
+
+### 新增
+
+- streamline report-first workflow (#53)
+- add operator console, task contract, and harden bindings (#51)
+- condition DAG design and repair branches
+
+### 修复
+
+- synchronize console frontend lockfile (#52)
+- tolerate mock strategy format drift
+- bound executor output
+
+## [0.16.26] - 2026-07-22
+
+### 修复
+
+- Git checkpoint 对 `allowed_paths` 内的 **gitignored 证据文件**（如 dogfood `reports/welcome/final/*.json`）执行 `git add -f` 纳入 checkpoint；敏感路径与范围外 ignored 文件仍 fail-closed。修复 FINAL-VERIFY DAG/report 已绿却因 ignored evidence 记 `record-error`、Task Pool 卡 Running 的 Delivery 阻断。
+
+## [0.16.25] - 2026-07-22
+
+### 修复
+
+- Backend-test pytest preflight 与执行体改为 `&&` fail-closed：preflight 失败不再因 `;` 继续跑 pytest（I27 曾出现 preflight 报 `WELCOME_BASE_URL`/testRoot 错配仍执行用例）。
+- 本地 `npm start` / `node server.js` 类 `managed-command` 在 materialize 时降级为 `in-process`，清空 requiredEnv、seed server fixture，并把 scout `testRoot` 收敛到冻结根 `testcase/`；generate-pytest 提示要求 fixture 内启动服务，不再依赖 clean-env 注入 base URL。
+
+## [0.16.24] - 2026-07-21
+
+### 改进
+
+- frontend-test 默认改为**短链 RAG**：`reviewMode` 默认 `off`（机械 `frontend-case-checklist-shell` 放行，不再默认双轮 LLM review 硬门）；`strictOutcomeGate` 默认 `false`（outcome 全绿门 opt-in）。**流程验收=最终 retrospect 报告**，不以 case 100% 通过为条件。map 仅在 `dynamicExpansion.tolerateChildFailures=true`（frontend-test 默认开启）时将 child auth/timeout/executor 错误落 case-level blocked/failed evidence 且不炸 map closeout；其它 map 仍 fail-closed。
+- Shell `verdictGate` 改为纯 `node -e` 单次调用，降低 Windows Git Bash 复合脚本崩溃风险。
+
+### 修复
+
+- Windows DAG Shell/verification 的 clean environment 现在保留 `APPDATA`，使 Python 3.12/pip 可按系统规则发现用户级 `site-packages` 与其中的 pytest；仍不会继承完整宿主环境或透传未授权 token/credential，backend-test 无需硬编码用户路径。
+
+## [0.16.23] - 2026-07-21
+
+### 修复
+
+- DAG runner 在归档到 `completed/` 前停止 heartbeat 并排空 state 写队列。避免 terminal 节点全 FINISHED 后仍因 completed-facts write guard 拒绝写 `state.json` 导致 `run-dag` 非零退出、Worker 记 `run-error`/Task Pool `Blocked`。
+
+## [0.16.22] - 2026-07-21
+
+### 修复
+
+- Git checkpoint `allowed_paths` 审计与 shell write-guard 对齐：忽略 `.playwright-cli/**` 等 ephemeral tool cache。frontend-test 浏览器用例与 `frontend-test-result` 已绿时，不再因 playwright-cli 会话落盘导致 promote/closeout `record-error`。
+
+## [0.16.21] - 2026-07-21
+
+### 修复
+
+- DAG `sourceBinding.requirementIds` 优先取任务 `需求.md` 的 `## Acceptance References`（TaskSpec `acceptance_refs`），不再把 Feature 整份 `acceptance.yaml` 的兄弟 AC 扫进本任务。修复 frontend-test 用例全绿却因 `AC-CONTRACT-*` missing 判 incomplete 的假失败。
+
+## [0.16.20] - 2026-07-21
+
+### 修复
+
+- Shell write-guard 忽略 playwright-cli 默认会话落盘 `.playwright-cli/**`（console/page dump）。frontend-test 浏览器用例已把权威证据写到 `testcase/frontend/evidence/**` 时，不再因工具缓存误拦 exclusive writer。
+
+## [0.16.19] - 2026-07-20
+
+### 修复
+
+- frontend-test result 物化在比较 evidence 路径前先 `realpath` 仓库与 evidence 根，避免 macOS `/var`→`/private/var` 导致的 `evidence realpath escapes its allowed root` 误拦。
+
+## [0.16.18] - 2026-07-20
+
+### 修复
+
+- frontend-test 执行预检改为硬校验绝对非生产 `baseUrl`（优先 config.md，缺省 `http://localhost:5173`）；fixture/reset 不再作为 preflight 硬门，避免中文隔离叙述因缺少英文 `reset` 被误拦。
+
+## [0.16.17] - 2026-07-20
+
+### 修复
+
+- backend-test execution 合同在 `in-process` 且 `existingFixtures: []` 时注入非秘密默认 fixture（优先 server bootstrap），避免 near-schema 侦察输出在 contracts 门 fail-closed。
+
+## [0.16.16] - 2026-07-20
+
+### 修复
+
+- 动态 DAG `itemsFrom` / JSON 选择器从 shell 节点 stdout 解析时，可跳过命令回显行并提取末尾 JSON 对象，避免 frontend-test `execute-frontend-cases-map` 在 materialize 门成功后仍因 `$ node -e ...` 前缀失败。
+
+## [0.16.15] - 2026-07-20
+
+### 修复
+
+- frontend-test case manifest 校验接受 `evidenceDir` 为 `testcase/frontend/evidence/<caseId>` 目录根（不必强制尾斜杠/子路径），避免生成节点写出合法目录后被 materialize 门误杀。
+
+## [0.16.14] - 2026-07-20
+
+### 修复
+
+- `frontend-test` materialize / path audit 自动并入 `testcase/frontend/**` 与 `docs/test-reports/**`，与 hybrid frontend-test DAG 生成约束对齐，避免 TaskSpec 仅声明 `tests/e2e/**` 时 `dag run-task` 直接失败。
+
+## [0.16.13] - 2026-07-20
+
+### 修复
+
+- backend-test 的 `finalize-effective-result` 管道在节点完成后绑定 `contracts/backend-test-result.json` 为 structured artifact，使 Outcome 投影出 `backend-test-result`，解除 FE-TEST Ready Planner 对 BE-TEST 产物门的误阻断。
+
+## [0.16.12] - 2026-07-20
+
+### 修复
+
+- `backend-test` materialize / Git checkpoint 自动并入 `testcase/**`（与 `docs/test-reports/**`）运行时写根，避免 TaskSpec 仍写 `tests/api/**` 时绿跑无法 promote、任务卡在 Running。
+
+## [0.16.11] - 2026-07-20
+
+### 修复
+
+- Worker 报告决策不再把条件分支的 `SKIPPED` 节点当成失败；backend-test 等混合 DAG 在 revise/repair 未选中时，只要 ERROR 不存在且 run finished，即可 `report-completed` 并进入 Outcome/promote。
+
+## [0.16.10] - 2026-07-20
+
+### 修复
+
+- 后端测试执行合同物化会清理 `managedCommand` 中的空字符串（如 `stop: ""`），避免 near-schema 侦察输出在 strict parse 下误拦 in-process BE-TEST。
+
+## [0.16.9] - 2026-07-20
+
+### 修复
+
+- Outcome 结构化产物声明不再绑定节点 mint-time sha256；同一路径若被后续 gate（如 backend-test traceability）就地改写，投影时以磁盘重算 hash 为准，消除 BE-TEST 完成态仍被 `artifact sha256 mismatch` 误拦。
+
+## [0.16.8] - 2026-07-20
+
+### 修复
+
+- Outcome 投影对同一 run-owned 结构化产物路径的多次 rewrite（如 backend-test case manifest initial→final）只保留最后一次 hash 声明，避免 `artifact sha256 mismatch` 误拦已完成的 BE-TEST。
+
+## [0.16.7] - 2026-07-20
+
+### 修复
+
+- 前端实现合同物化支持 free-form plan JSON 归一化（GWT/对象 UI 状态、requirementCoverage、mock productionDefaultOff），避免 FE-IMPL 在 `frontend-implementation-contract-shell` 因字段漂移误拦。
+
+## [0.16.6] - 2026-07-20
+
+### 修复
+
+- write guard 忽略 `__pycache__` / `.pytest_cache` 等 ephemeral 解释器缓存，避免 backend-test 生成节点本地冒烟 pytest 时被误拦；并明确 generate-pytest 节点不负责执行测试。
+
+## [0.16.5] - 2026-07-20
+
+### 修复
+
+- 后端测试分析/执行合同物化支持 free-form 环境侦察与 GWT/嵌套 endpoint 形状的严格 schema 归一化，避免 BE-TEST 在 contracts 门被模型字段漂移误拦。
+
+## [0.16.4] - 2026-07-19
+
+### 修复
+
+- 后端测试 `backend-test-semantic-final-gate-shell` 改为复合 pipeline `semantic-effective`，不再手写读 contracts 的 inline shell，避免 `--strict-governance` 误判为 fragile verdict gate 并阻断 BE-TEST DAG 校验。
+
+## [0.16.3] - 2026-07-19
+
+### 修复
+
+- 前端实现 DAG 在 review 前新增确定性 `frontend-worktree-diff-shell`，写出 run-owned `diff_patch` 与清单，避免 review 因找不到 actual diff 而误拦截。
+
+## [0.16.2] - 2026-07-19
+
+### 修复
+
+- 前端 `frontend-implementation-contract-shell` 物化时用 DAG 权威 `sourceBinding` 覆盖模型输出，避免模型错绑 requirement 路径/哈希或额外引用路径导致实现链在设计门后 fail-closed。
+
+## [0.16.1] - 2026-07-19
+
+### 重点更新
+
+- 修复全栈 dogfood 产物与恢复缺口：`produces.path` 可投影为 hash-bound Outcome、closeout 证据迁入 `.harness/`、成功任务 Git checkpoint 先于 Task Pool Done，并补齐 reconcile / mark-failed / advance-checkpoint
+- 收紧夜间自动发布门槛：至少一个可发布 Conventional Commit，且稳定 tag 后总提交数 ≥ 5 或距上次发布满 1 天，才自动发版
+- 将根 README 收敛为产品入口，本地环境排障说明独立成篇，降低首次阅读噪声
+
+### 新增
+
+- 新增分支合并规范：按影响自动选择快速、标准或深度模式，统一双方功能保留审查、冲突解析、source-SHA 报告与 init/package 影响校验
+- `.gitignore` 与 `loop-agent init` managed block 现忽略 `.harness/dogfood-evidence/`，避免把 fullstack / Worker dogfood 本地战役证据误提交
+
+### 改进
+
+- Observe DAG 详情移除依赖图下方重复的层级节点列表，并为节点表增加连续序号，浏览执行结构时更紧凑、更易定位
+- 根 README 仅保留定位、适用问题、5 分钟开始、核心边界和文档导航；Agent DAG、Worker、发布与运维细节统一下沉到专题文档
+- Cursor Cloud 等环境排障说明从 `AGENTS.md` 迁至 `docs/local-development-environment.md`
+
+### 修复
+
+- 全栈 dogfood 修复批次：reviewed/supervised DAG 增加一次性 review VERDICT 格式恢复；shell 改为非 login `bash -c`；PATH/VERDICT 格式失败分类对齐 EnvFailure/ContractMismatch
+- 旧目标项目可用 `init check-update` / `update --apply-safe` 刷新 ignore 区块以忽略 dogfood-evidence
+
+## [0.16.0] - 2026-07-19
+
+### 重点更新
+
+- Eval Lab 落地受控评测外环，支持 candidate 矩阵编排、Context Policy A/B dogfood 与 Ignition 研究门禁，全程 autoPromote=false，晋升须人工审核
+- Worker 新增 TaskSpec 显式工作流路由，为四类任务生成带哈希锚定的 Task Outcome，并在晋升前校验 run_record、dag_json 等必需产物
+- 新增 fullstack-v1 Feature Profile，支持确定性结构门禁与 Feature Verification Bundle v1，交付与收尾阶段任一身份漂移或产物篡改均阻断发布
+- Eval Lab 落地固定预算运行时，DagSpec v3 可声明硬预算门禁，超限 fail closed 并输出预算账本，缺失 token 不被当作 0
+
+### 新增
+
+- Eval Lab 新增 Context Policy A/B dogfood 脚本，串联 corpus/candidate/campaign/scorecard 与人工 promote（默认 dry-run），不改 DAG 默认策略
+- Eval Lab 新增 Ignition 研究门禁命令，记录多代 proposer 并给出趋势 verdict，恒为研究用途，不自动晋升
+- Eval Lab 新增 Corpus 契约命令与 dogfood 样板清单（15 个异质任务，public/private/held_out 齐全）
+- Eval Lab 新增 public/private campaign 与 private-verifier，支持多 seed 可重复计划与 candidate 内容泄漏门禁
+- Eval Lab 新增 anti-hack 审计与 Promotion Policy v1，检测验证弱化与可疑 outlier，promote 须通过多项门禁且默认 dry-run
+- Eval Lab 新增固定预算运行时，支持按节点累计资源消耗，硬门禁超限 fail closed 并写出 budget-ledger
+- Eval Lab 新增可切换 Context Policy（baseline-v1 默认与原先一致，role-specialized-v1 按角色调整预算）
+- 新增 fullstack-v1 dogfood Feature F-2026-005，提供零依赖可运行目标仓与双覆盖验收样板
+- 新增 fullstack-v1 Feature Profile，对 packet 执行确定性结构门禁，未声明 profile 的 legacy packet 行为不变
+- AcceptanceSpec verification 新增可选的实现/验证任务引用、required_evidence 与 integration 声明，保留 legacy 字段兼容
+- TaskGraph 节点新增可选 consumes/produces 声明与 Ready Planner artifact gate，上游产物不可验证时下游阻塞
+
+### 改进
+
+- TaskSpec 支持可选 execution.workflow，可确定性物化为任务 DAG 类型并展示在 Worker、Task Pool、晨报与 Observe
+- Ready Planner 明确仅做 envelope 级绑定，不重算产物文件 sha256，文件级 hash 在 Outcome projection 与 Feature Verification Bundle 执行
+- DAG 节点 authoring guidance 明确 Pi 是唯一受治理 writer，cursor-prompt 仅作手工 one-shot sidecar
+- Eval Lab propose 与 experiment 命令支持有界提出 experimenting candidate，accept/reject 须通过 scorecard 门禁，不自动改写已接受 skill
+- 文档基线全面校准至 0.15.0，同步半年规划、仓库分析与路线图，harness Pi MED 路由至 grok-4.5
+- Eval Lab dogfood 脚本改为可安全重复运行，并记录 promote --apply 序列供后续分析
+
+### 修复
+
+- 对齐 Task Outcome 与 Ready Planner 契约：Ready 仅做 envelope 级绑定，Outcome 产物补齐独立 schemaId，失败时写入 outcomeFailure
+- 规范化 shell_verification 为标准 evidence token（兼容旧 shell-verification），未知 outputs.required token 保持兼容不阻塞
+- 清理 0.15.0 版本仍残留在 Unreleased 区块的更新日志条目
+- Eval Lab 运行态（candidate/campaign/scorecard）现被 .gitignore 忽略，旧项目可用 init check-update 刷新 ignore 区块
+
+## [0.15.0] - 2026-07-18
+
+### 重点更新
+
+- 新增 Pull Request 的只读 AI 自动审查，自动检查代码缺陷与测试缺口并更新评论
+- 引入内部测试版本夜间自动发布工作流，主干达标后自动更新版本并发布
+- 收紧 npm 发布包范围，仅保留 init 与 runtime 必需的文档和脚本
+- 修复预发布版本被误发布至 latest 的风险，发布门禁改为按版本号状态严格限制
+
+### 新增
+
+- 新增 Pull Request 的只读 AI 自动审查：在创建、重新打开、转为 ready 或更新提交时检查 bug、测试缺口、runtime boundary 等，并更新单条 PR 评论
+- 新增内部测试版本夜间自动发布：达到提交门槛并通过发布检查后，自动更新版本、生成中文说明并发布 GitHub Release 与 npm
+- 新增面向内部研发人员的轻量 GitHub 协作指南和简短 Pull Request 模板，统一采用短分支与 Squash Merge 的最小协作闭环
+- 新增 `.editorconfig` 与 `.gitattributes`，统一常见文本文件的 UTF-8、LF、缩进和文件末尾换行约定
+
+### 改进
+
+- 收紧 npm 发布包中的 `docs/` 范围：只保留 init/runtime 所需的治理文档、architecture、skills 与 templates
+- 收紧 npm 发布包中的 `scripts/`：只保留知识库实际调用的脚本，不再打包源仓治理检查与 `.sh` 包装
+- 前端实现 DAG 的 `frontendMock.policy=auto` 不再因为目标项目缺少 Mock 能力而阻塞，无确认能力时自动跳过并保留真实请求默认路径
+- 文档基线全面校准至 0.14.0，修复了多处的文档索引遗漏与旧路径引用
+
+### 修复
+
+- 修复私有仓库 AI PR 审查因通过网页 `*.diff` 地址拉取差异导致 404 的问题，改为经 GitHub API 获取 diff
+- 修复预发布版本误发布到 `latest` 的问题：发布门禁改为按版本号的 prerelease 状态限制 dist-tag，beta prerelease 仅允许 `beta` tag
+- 修复网站更新日志（Changelog）的版本插入位置错误：新版本段落不再错误地插入到读者摘要之前，保持页面结构正常
+- 修复网站更新日志中残留的 `[Unreleased]` 块未随版本发布移除的问题
+
+## [0.14.0] - 2026-07-18
+
+### 重点更新
+
+- 新增夜间自动发布工作流，主干达到提交门槛后自动更新版本、生成说明并发布
+- 运营看板重构为执行面优先布局，并新增可展开的富执行过程时间线
+
+### 新增
+
+- 定时触发的 GitHub Actions 夜间发布工作流，支持 dry-run 预演与正式发布
+- 运营看板新增执行过程时间线，支持展开查看工具调用与 AI 正文，并记录时间戳
+- 资源池默认手动刷新，突出展示需处理和 Ready 状态的任务
+- 总览页改为执行面 KPI 与风险并排展示，节点检查器默认半屏显示
+
+### 改进
+
+- 发布说明支持 OpenAI 兼容模型生成，并在模型不可用时自动回退到保守摘要
+- 破坏性变更识别改为严格遵循 Conventional Commits 规范，避免因正文提及该词而误判
+
+### 修复
+
+- 修复模型返回的 JSON 包含 Markdown 代码块导致解析失败、发布说明始终回退为默认摘要的问题
+- 修复提交信息中包含 'breaking change' 字样被误判为破坏性变更从而阻断发布的问题
+- 补充 format-pool.d.ts 类型声明文件，修复 CI 类型检查报错
+
+## [0.13.0] - 2026-07-18
+
+- 前端实现流程新增需求合同、风险识别、项目能力检查、有界修复和验证追踪；高置信度前端需求可自动进入专用流程。
+- 后端自动化测试会在生成 pytest 前确认执行环境和需求覆盖，并区分产品、测试与环境问题。
+- Observe 看板采用增量刷新，保留焦点、滚动位置和当前节点；节点输出、执行过程与规范证据切换更稳定。
+- 新增 `browser-tools` 和前端浏览器测试用例生成能力，full init 后可直接在目标项目使用。
+- Task Pool 按 `{ featureId, taskId }` 识别任务，并新增检查、迁移和 Ready 计划预览命令。
+- 新增 Eval Replay 与 Candidate Registry，用于重放证据、比较候选并审计候选运行关联。
+- 旧项目可通过 `init check-update` 检查新增模板、skills 和托管配置，再用 `init update --apply-safe` 安全补齐。
+- Pi SDK、Windows 命令执行、自举验证和受监督任务的计划修订流程得到稳定性改进。
+
+完整条目和迁移提示见根 `CHANGELOG.md [0.13.0]`。
+
+## [0.12.0] - 2026-07-16
+
+- **只读 Pi 节点安全重试**：opt-in `retryPolicy`（network / rate-limit / unavailable / timeout）；writer / shell 等声明策略会校验失败。见 [Agent DAG](./website/docs/guides/agent-dag.md)。
+- **`taskKind: backend-test`**：需求分析 → 功能用例 → pytest → 复盘。
+- **知识同步与业务图谱 MVP**：`taskKind: knowledge-sync`（须 `featureId`）/ `knowledge-graph-bootstrap`；`loop-agent knowledge query|graph-init|graph-materialize|graph-promote|graph-incremental-prepare`（`knowledge curate` 仍只负责 repair guidance 提案）。
+- **init surface 全量跟踪**：`check-update` / `update --apply-safe` 覆盖包内全部 `docs/templates/**` 与 `skills/**` 到目标目录的投影。
+- 详见根 `CHANGELOG.md [0.12.0]`；站上 [当前规划](./website/docs/overview/roadmap.md) 与 [功能导览](./website/docs/overview/feature-map.md)。
+
+## [0.11.0] - 2026-07-15
+
+- **Observe 本地运营面 R1–R5**：资源池 / Task 下钻、Batch·Run 三层事实、Feature 决策详情与对象关系条、有界事件历史、ES modules 前端模块化；`observe serve` keep-alive / SSE keepalive，可选非 loopback 绑定（默认仍 `127.0.0.1`）。见 [Observe](./website/docs/guides/observe-ui.md)。
+- **版本化自举**：controller identity / package fingerprint / expected gate、run-owned skill snapshot、deterministic `self-host:canary`、`skills/agent-worker` 及目标镜像；dogfood Feature `F-2026-004`。
+- **DagSpec v3 + repair 契约**：新 DAG 携带 `runtimeContract`；supervised `repairNodeId`；run-owned controller identity pin。
+- **`plan create` / `plan complete` / `plan check`**：exec-plan 生命周期与 DAG 前置索引校验。见 [CLI 参考](./website/docs/reference/cli.md)。
+- **CLI 自更新提醒**：交互式成功命令后检查 npm 新版本；`LOOP_AGENT_DISABLE_UPDATE_CHECK=1` 可关。见 [安装](./website/docs/quick-start/installation.md)。
+- **init 布局收敛**：目标项目默认 `ai_workspace/loop-agent/` + `.agents/skills/`；`init update --apply-safe` 可安全迁移旧根 `docs/` / `skills/`。
+- **文档站 IA**：intro 概念地图与 30 分钟路径；[功能导览](./website/docs/overview/feature-map.md)、[架构导读](./website/docs/overview/architecture.md)、[当前规划](./website/docs/overview/roadmap.md)；Markdown 断链构建失败；`skills/loop-agent/references/docs-converge.md` 固化文档收敛检查表。
+- 可选 repo-local SDD skill 嵌入；前端 DAG skill 契约与验证命令安全解析。
+
+## [0.10.0] - 2026-07-12
+
+- **Pi-only 受治理 runtime**：DAG writer 固定 `implement-pi` / `repair-pi`；`cursor-prompt` 仅显式 one-shot sidecar。
+- **`agent-worker feature review|run|approve-followup|delivery|closeout|verify-final`**：Feature 决策面、薄编排、Follow-up 可批准闭环、本地 Git checkpoint、Delivery Package、Feature Closeout。
+- **`task draft-followup`**、**`report metrics --month`**；Morning / Observe Feature Decision Summary。
+- 详见根 `CHANGELOG.md [0.10.0]`。
+
+## [0.9.0] - 2026-07-12
+
+- Observe 看板重设计为暖白运行控制台：统一信息层级、依赖图 + 节点表、右侧节点检查器、安全 Markdown；本机资源 guardrail。见 [Observe](./website/docs/guides/observe-ui.md)。
+
+## [0.8.0] 及更早
+
+- 0.8.0：[CLI 参考](./website/docs/reference/cli.md) 补充 `task validate-feature`、`task retry`、`scripts/worker-nightly.sh` + GitHub Actions、`capabilities: [interactive-ui]`，Task Pool 唯一根 `.harness/task-pool/`。
+- 0.7.5：Observe 新增 DAG 依赖图可视化。
+- 0.7.0：interactive-ui writer-only HIGH 路由与 UI 交付契约。
+- 更早条目见根目录 `CHANGELOG.md`。
+
+## 文档站点同步说明
+
+- 站上 guide / reference 与根 `docs/` 双树边界见 [架构导读 · 双树边界](./website/docs/overview/architecture.md#双树边界)。
+- 活能力短摘要：[`docs/reports/current-capability-summary.md`](https://github.com/tea-agent/loop-agent/blob/main/docs/reports/current-capability-summary.md)。
+- 冻结基线长文：[`docs/reports/2026-07-02-repository-analysis.md`](https://github.com/tea-agent/loop-agent/blob/main/docs/reports/2026-07-02-repository-analysis.md)（2026-07-16 再采样对齐 0.12.0 + 主干 Unreleased；勿当第二 CHANGELOG）。