@tea-agent/loop-agent 0.25.5 → 0.26.0

package/CHANGELOG.md

@@ -1,986 +1,1020 @@
-# 更新日志
-
-## [Unreleased]
-
-## [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 一一对应”质量详情
-
-### 改进
-
-- 减少全量测试中的重复 CLI 冷启动和 self-host canary 二次打包安装场景，收敛低价值重复用例并保留关键端到端主路径
-- DAG 执行期间的主会话行为约束得到增补：启动后自主推进至结束、持续可靠判活、严格限制工作区文件修改，并优先使用纯函数探针排查路由
-
-### 修复
-
-- 修复后端测试节点 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）。
+# 更新日志
+
+## [Unreleased]
+
+## [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 执行期间的主会话行为约束得到增补：启动后自主推进至结束、持续可靠判活、严格限制工作区文件修改，并优先使用纯函数探针排查路由
+
+### 修复
+
+- 修复后端测试节点 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）。