@tea-agent/loop-agent 0.13.0 → 0.15.0

package/CHANGELOG.md

@@ -1,317 +1,128 @@
-# 更新日志
-
-这里记录每个版本对使用者有影响的变化。命令名和配置字段保持原样，其余内容尽量用日常语言说明。
-
-## [0.13.0] - 2026-07-18
+# 更新日志
+
+## [0.15.0] - 2026-07-18
 
 ### 重点更新
 
-- 前端实现流程更完整：会先确认需求范围和项目能力，再按风险选择执行路径；验证失败时可进行一次有边界的修复，并保留需求、改动和验证结果之间的追踪关系。
-- 后端自动化测试流程更可靠：在生成 pytest 前确认环境和执行范围，检查需求覆盖，并区分产品缺陷、测试问题与环境问题，减少误报和无效重跑。
-- Observe 看板刷新更稳定：轮询时只更新发生变化的内容，保留卡片、焦点、滚动位置和当前节点；节点输出、执行过程和规范证据不会因切换或延迟响应串到其他节点。
-- 旧项目的初始化更新链路得到加强：`init check-update` 能发现新增模板、skills 和托管配置，`init update --apply-safe` 可安全补齐，不覆盖项目自己的内容。
+- 新增 Pull Request 的只读 AI 自动审查，自动检查代码缺陷与测试缺口并更新评论
+- 引入内部测试版本夜间自动发布工作流，主干达标后自动更新版本并发布
+- 收紧 npm 发布包范围，仅保留 init 与 runtime 必需的文档和脚本
+- 修复预发布版本被误发布至 latest 的风险，发布门禁改为按版本号状态严格限制
 
 ### 新增
 
-- 新增 `browser-tools` skill，可通过 Chrome DevTools Protocol 完成浏览器启动、导航、内容提取、元素选择、脚本执行、截图和 cookie 操作；`loop-agent init --profile full` 会将其安装到目标项目。
-- 新增前端浏览器测试用例生成能力，可根据需求生成逐条执行的中文用例、索引和清单，并明确标记缺失的接口、边界或测试数据。
-- 新增 Eval Replay 与 Candidate Registry，可重放已完成 DAG 的证据、比较候选结果，并记录候选与运行之间的关联；当前用于评估和审计，不会自动晋升候选。
-- 新增 `agent-worker pool doctor`、`pool migrate-state` 和 `batch plan-ready`，用于检查 Task Pool、预览迁移和查看下一批可执行任务。
-- 新增跨分支合并报告模板，统一记录双方功能、冲突处理、初始化影响、发布包变化、验证结果和回退入口。
-- 初始化后的项目支持更自然的“初始化”“检查初始化更新”“安全更新初始化”表达；检查操作保持只读，安全更新会先检查再应用可确定处理的变更。
+- 新增 Pull Request 的只读 AI 自动审查：在创建、重新打开、转为 ready 或更新提交时检查 bug、测试缺口、runtime boundary 等，并更新单条 PR 评论
+- 新增内部测试版本夜间自动发布：达到提交门槛并通过发布检查后，自动更新版本、生成中文说明并发布 GitHub Release 与 npm
+- 新增面向内部研发人员的轻量 GitHub 协作指南和简短 Pull Request 模板，统一采用短分支与 Squash Merge 的最小协作闭环
+- 新增 `.editorconfig` 与 `.gitattributes`，统一常见文本文件的 UTF-8、LF、缩进和文件末尾换行约定
 
 ### 改进
 
-- 高置信度的前端实现需求可自动进入前端专用流程；后端、混合需求或证据不足的任务继续使用原治理流程，不会被误分类。
-- 前端 Mock 策略会优先复用项目已有能力，并明确区分“已用 Mock 验证”和“已完成真实接口联调”，避免把模拟结果误报为完整集成通过。
-- 受监督任务在计划需要调整时可自动完成一次只读修订和复审；写入范围不会因此扩大，最终仍需明确通过才能继续。
-- Task Pool、Ready Planner、Feature 评审、批次执行、报告和 Observe 统一按 Feature 识别任务，同名任务不会跨 Feature 串线。
-- `backend-test`、`frontend-implementation`、`knowledge-sync` 等专用流程统一通过 `task.json.taskKind` 选择；`--profile` 只表示治理强度。
-- Pi SDK 升级至 0.80.10，`doctor` 会检查实际运行能力，而不只是模块是否能够加载。
-- Windows 下的 Git Bash、路径处理、自举验证和 Git 密集测试更稳定。
+- 收紧 npm 发布包中的 `docs/` 范围：只保留 init/runtime 所需的治理文档、architecture、skills 与 templates
+- 收紧 npm 发布包中的 `scripts/`：只保留知识库实际调用的脚本，不再打包源仓治理检查与 `.sh` 包装
+- 前端实现 DAG 的 `frontendMock.policy=auto` 不再因为目标项目缺少 Mock 能力而阻塞，无确认能力时自动跳过并保留真实请求默认路径
+- 文档基线全面校准至 0.14.0，修复了多处的文档索引遗漏与旧路径引用
 
 ### 修复
 
-- 修复 Observe 看板反复显示加载状态、整块重建页面、节点页签内容中断以及旧请求覆盖当前节点的问题。
-- 修复旧项目安全更新后缺少可靠初始化记录，导致后续版本无法继续判断哪些文件可安全更新的问题。
-- 修复前端需求覆盖检查读取旧计划、验证失败无法进入有界修复，以及存在阻塞证据时仍可能继续写入的问题。
-- 修复动态用例执行恢复后重复运行已完成用例或丢失 Token 预算状态的问题。
-- 修复受监督决策和修复结果在合法 Markdown、空白可选说明或格式轻微偏差下被误判的问题，同时继续拒绝不明确或不符合约束的结果。
-- 修复初始化后的 repo-local skills 安装本地依赖时污染目标仓库的问题；托管 `.gitignore` 现在忽略 `.agents/skills/*/node_modules/`。
-- 修复初始化项目缺少运行目录占位、知识库命令发布文件不完整，以及知识图谱晋升路径校验不足的问题。
-
-### 破坏性变更
-
-- Task Pool 任务现在使用 `{ featureId, taskId }` 作为身份。`agent-worker task retry` 应携带 `--feature-id`；存在同名任务时，省略该参数会拒绝执行，不再猜测所属 Feature。
-- 旧的扁平 Task Pool state 不会被自动解释或静默迁移，需要显式检查和迁移。
-
-### 迁移提示
-
-1. 运行 `agent-worker pool doctor --repo <repo> --json` 检查旧 Task Pool 状态。
-2. 先运行 `agent-worker pool migrate-state --repo <repo>` 预览迁移；确认后再添加 `--apply --owner <owner> --reason <reason>`。
-3. 将 retry 命令更新为 `agent-worker task retry <task-id> --feature-id <feature-id> ...`。
-4. 旧项目升级 controller 后，先运行 `loop-agent init check-update`，确认结果后再运行 `loop-agent init update --apply-safe`。
-
-## [0.12.0] - 2026-07-16
-
-### 新增
-
-- 只读 Pi DAG 节点支持 opt-in 安全重试：仅 planner/scout/reviewer/verifier/closeout 角色且无写入能力的 Pi 节点可声明 `retryPolicy`，在同一 run 内重试模型连接中断（`network`）、provider 限流（`rate-limit`）、临时不可用（`unavailable`）或请求 timeout。生成模板默认总尝试 3 次，手工配置最多 5 次，并使用有上限的指数退避。每次 attempt 保留独立证据，节点耗时、Token 与事件数按尝试聚合；后一次成功不会覆盖前一次失败证据。`quota`、`auth`、`invalid-output`、`write-guard` 与未知失败不重试；supervisor、implementer、writer、dynamic、shell、static、docs-only、decision-gate 节点声明策略会在校验阶段失败。未声明策略的历史 DAG 不新增 attempt artifact，行为保持不变。
-- 新增 `taskKind: "backend-test"` 专用 DAG：从需求分析开始，生成并评审后端功能用例，再生成和执行 pytest 自动化，最后产出测试复盘报告；新 DAG 沿用当前 Pi-only runtime、版本化 runtime contract 与既有执行恢复机制。
-- 测试知识回写专用 DAG：`taskKind: "knowledge-sync"`。生成 collect→draft→validate→**多视角审查（QA/领域/证据）**→apply→pointer；**必须绑定 `featureId`**（`task.json.featureId` 或 hardConstraints / 需求中的 `F-…`），writeSet 收窄到 `features/<featureId>/…`。
-- 业务知识图谱开荒 DAG：`taskKind: "knowledge-graph-bootstrap"`（preflight→inventory→propose→validate→**结构/证据/安全三视角审查+聚合门禁**→promote→materialize）；AI 只写 `knowledge/bootstrap/staging/**`。
-- 图谱辅助脚本与 CLI：`loop-agent knowledge query|graph-init|graph-materialize|graph-promote|graph-incremental-prepare`（薄封装 `scripts/kb-*`）；`knowledge curate` 仍只负责 repair guidance 提案。
-- B1 骨架、Phase A 查询（by_id / by_feature / search）、merge-new-only 晋升、增量 scope 准备与 materialize 索引；设计文档见 `ai_workspace/loop-agent/design/knowledge-*.md` 与 active plan `ai_workspace/loop-agent/exec-plans/active/2026-07-14-knowledge-sync-and-graph.md`。
-
-### 修复
-
-- `loop-agent init check-update` / `init update --apply-safe` 漏检初始化投影文件：fresh `init --profile full` 通过目录复制把整个 `ai_workspace/loop-agent/templates/` 与 `.agents/skills/`（镜像到 `.agents/skills/`）投影到目标项目，但期望 init surface 只跟踪其中一个子集。旧版本（如 0.11.0）初始化的项目升级 controller 后，缺失的 backend-test 模板、agent-dag schema/prompt、`loop-agent` 必需 references 等文件无法被报告或补齐，`check-update` 会错误返回 `ok: true`。现在期望 surface 会自动发现包内 `ai_workspace/loop-agent/templates/` 与 `.agents/skills/` 的所有文件并纳入校验；`check-update` 会报告全部缺失/陈旧 surface；`apply-safe` 会确定性补齐缺失文件，对无法证明 ownership 的旧文件仍保持 fail-safe（给出 model merge / human decision，不覆盖用户内容）。`scripts/check-init-surface.sh` 新增 drift 门，阻止“fresh init 会复制、surface 却不跟踪”的漂移。
-
-## [0.11.0] - 2026-07-15
-
-### 新增
-
-- 受治理 DAG 的 repair 环节改为显式声明：`shell.repairArtifactGate` 新增 `repairNodeId`，新生成的 supervised DAG 会直接写明由哪个 Pi 修复节点承接 supervisor 的修订请求；旧 DAG 未声明时，只有在能唯一、安全地推导出下游 Pi 修复节点时才继续兼容，缺失、歧义或修复节点不满足受治理写入契约都会在执行前明确报错。
-- 新生成的 DagSpec 升级为 `version: 3`，并携带必需的 `runtimeContract`（`agentRuntime` / `repairWriterProtocol` / 可选最低 controller 版本）。旧 controller 会因不认识 v3 而在解析阶段拒绝，新 controller 则在 `dag validate`、执行和 resume 前检查 capability 与最低版本，避免版本漂移运行到中途才失败；legacy v1/v2 DAG 继续可读。
-- 每个新的 DAG run 必须把实际执行的 controller identity（package version、binary SHA-256、portable fingerprint）冻结为 run-owned 事实并记录内容哈希；identity 无法解析时不创建 run。`dag report` 会展示 identity 与 runtime-contract compatibility，resume 时重新校验；身份漂移、artifact 篡改或 legacy-unpinned run 都会拒绝继续。
-- Observe R5：控制台前端拆为原生 ES modules（router/api/format/state/views 等），`app.js` 作轻量入口并 re-export 可测 API；统一 loading/empty/degraded/error 状态 helper；资源池支持可分享的 hash 筛选（`status`/`q`）；不引入框架或构建器，R1–R4 路由/API/行为保持。
-- Observe R4：Batch/Pool 有界事件历史 `GET /api/batches/:batchRunId/events` 与 `GET /api/events`（默认 limit 50、硬顶 200，opaque `cursor`/`nextCursor`，与 SSE/run 整数 `after` 分离）；服务端尾部有界 JSONL 扫描；snapshot 事件归约容量硬顶并暴露 `projectionWarnings`；Pool 投影失败 fault-first，避免健康零值 KPI。
-- Observe R3：`#/feature/:featureId` 决策详情（状态、AC 覆盖、blocking、risk、follow-ups、evidence、projectionWarnings）；总览 Feature 可下钻；Feature/Task/Batch/Run/DAG 统一对象关系条，仅 snapshot 可证对象出链；建议命令仅可复制，与已执行事实分区。
-- Observe R2：Batch 详情展示完整 summary（含 additive `recordErrors?`/`runErrors?`）、派生总耗时、Task 诊断列（失败分类、follow-up、harnessTaskId、起止）与页内安全 artifact preview；Worker Run 收敛为「主事实 / 执行过程 / 诊断证据」三层，Task/Batch/DAG 深链仅在 canonical 字段且 snapshot 命中时生成。`TaskSummary.batchRunId?` 对外保留。
-- Observe R1：顶栏「资源池」与 `#/pool` 盘点当前 Worker Task（状态分布、最新 run、更新时间、失败分类）；`#/task/:taskId` 下钻当前事实、真实关联 batch/run/DAG、失败证据与有界 run history（`GET /api/tasks/:taskId/runs`，limit/cursor，`retryOfWorkerRunId`）。`TaskSummary` additive `updatedAt?`；snapshot additive `taskPool.present` 区分未使用与空池。
-- 新增版本更新提醒。发现新版本时可以直接确认升级；忽略某个版本后不会重复提醒，后续新版本仍会正常提示。可用 `LOOP_AGENT_DISABLE_UPDATE_CHECK=1` 关闭检查。
-- 新增 `loop-agent plan create`、`plan complete` 和 `plan check`，统一维护执行计划及其索引，并在生成 DAG 前发现遗漏或不一致。
-- 目标项目可以选择复用本地 SDD skills，为需求、设计、实现和评审节点补充方法指引；未安装时保持原有流程。
-- 新增 `ai_workspace/loop-agent/architecture/` 全景、DAG 执行、Worker/Feature、运行态事实与演进五篇主题文档及目录索引，并在 npm package（不投影到 init）内可达。
-- Worker 和 DAG 运行会固定本次使用的 loop-agent 版本与 skill 配置，避免执行过程中因环境变化产生不一致结果。
-- 新增 `npm run self-host:canary -- --deterministic`，可在隔离环境中检查候选发布包是否能够接管常用 CLI、初始化和 DAG 流程。
-- 新增可选的 `agent-worker` skill，为 Feature、Task、交付和失败恢复提供统一的操作指引。
-- 文档站新增功能导览、架构导读与当前规划入口，并把文档收敛检查固化到 `.agents/skills/loop-agent`，减少站上文档与仓库治理文档漂移。
-- 前端 DAG 的 repo-local skills 补齐节点输入、输出、证据和失败规则；前端规范会优先查知识库，失败时回退到当前项目 `openSpec/`。
-- 目标项目旧布局迁移：`init check-update`（只读）报告旧根 `ai_workspace/loop-agent/` / `.agents/skills/` 可安全迁移的 loop-agent owned 文件、空目录和 `harness.json` 中已废弃的模型字段；`init update --apply-safe` 迁移确认未修改的文件、清理空目录并清理废弃字段，本地修改过、来源不明或目标冲突的文件只进入人工决策，不会被覆盖或删除。
-
-### 变更
-
-- `observe serve` 提高对外访问稳定性：HTTP keep-alive 默认约 65s（避免 Node 5s 默认导致连接池复用失败），SSE 增加 keepalive comment 与 `X-Accel-Buffering: no`；新增 `--debug` 在 stderr 打印请求来源/方法/路径/状态/耗时。
-- `observe serve` 允许显式绑定非 loopback 地址（如 `--host 0.0.0.0`）以便局域网访问；默认仍是 `127.0.0.1`，非本机绑定时会在 stderr 提示无鉴权风险。
-- 根 README 在「核心概念」后增加极简「仓库地图」，方便一眼区分 `src/`、`.agents/skills/`、`.harness/`、`ai_workspace/loop-agent/` 等职责；细节仍以 `AGENTS.md` 与 `ai_workspace/loop-agent/README.md` 为准。
-- 文档治理收敛：站上「当前规划」与 active plan 同步（无进行中计划时明确写出）；`ai_workspace/loop-agent/README` 只索引核心契约与产物目录入口，progress/report 全量列表下沉到子目录 README；Dynamic Workflow 路线图迁入 `ai_workspace/loop-agent/design/`；补齐 design 漏索引与 DAG recovery playbook 入口。
-- 活文档校准：Dynamic Workflow 路线图页首标明已落地 vs 设计输入（Pi-only）；六个月规划第 1–2 月改为 archive/reports 指针；`repository-analysis` 冻结为基线快照，新增 `ai_workspace/loop-agent/reports/current-capability-summary.md`；落地 ADR 0001–0003（Pi-only、Task Pool 根、双树/docs-converge）。
-- 统一 Feature Packet 的推荐目录和中文说明，相关检查同时兼容现有产品线目录。
-- 目标项目初始化布局收敛：默认把 loop-agent 治理资料生成到 `ai_workspace/loop-agent/`，不再在目标项目根生成 `ai_workspace/loop-agent/`；`--profile full` 只把 repo-local skills 写到 `.agents/skills/`，不再生成根 `.agents/skills/`。
-- `new-task` 不再预种 L1 空报告模板（`分析报告.md` / `实现计划.md` / `复盘报告.md`）；任务 `artifacts/` 默认只保留 `修改记录.md` 与 `验证结果.md`，由 `promote-run` 从 completed run 回填。
-- 运行期间修改 skill 不会影响当前任务，新配置会从下一次运行开始生效。
-- Observe 自动刷新时会保留依赖图、检查器和日志的阅读位置，查看长时间任务时不再被频繁打断。
-
-### 修复
-
-- 修复 supervised convergence DAG 在 `process-gate-shell` 报「repair artifact gate cannot find downstream repair task」的问题：修复环节不再按固定节点名（历史上的 `repair-cursor` / `repair-pi`）猜测，而是根据 gate 声明的 `repairNodeId` 或唯一安全的下游 Pi 写入节点解析，合法的 `request-revision` 修订请求能正常走完 repair、hard verify 与 review。
-- Observe UI R5：可变 UI 状态改为 `uiState` plain object，修复 Chrome 中 ES module namespace 赋值导致的路由崩溃；`app.js` 收为约 136 行 bootstrap/route/listeners/re-export，KPI、DAG helpers、run processing 与 shell chrome 迁入职责模块，移除 nullable `registerShell/getShell` locator；Pool grouped filters、四态、DAG inspector ARIA/方向键同步收敛，并通过 focused tests、构建治理与 fresh dist Chrome 验证。
-- 前端 DAG 从 `需求.md` / `执行约束.md` 读取验证命令时不再交给 shell 解释执行；命令会先解析为受限参数列表并拒绝 shell 特殊语法，避免任务文本触发额外命令。
-- 改进 Windows 下 Git Bash、npm 和集成测试的运行方式，减少环境识别错误与资源竞争导致的误失败。
-
-## [0.10.0] - 2026-07-12
-
-### 破坏性变更
-
-- DAG、Loop、Delegate 和 Worker 统一使用 Pi，不再支持 Cursor executor 及相关旧配置。
-- Cursor 仍可通过 `loop-agent cursor-prompt` 手动调用，但不再参与自动执行和受治理写入。
-- Delegate 默认只创建 worktree；需要自动生成并执行 DAG 时必须显式使用 `--auto-run`。
-
-### 迁移提示
-
-1. 删除 harness 和 task 中的 Cursor executor 配置，只保留 `executors.pi`。
-2. 把 `loopAutoWritePolicy` 改为 `loopAutoExecutionPolicy`（`off` | `approval-required` | `enabled`）。
-3. 重新运行 `dag run-task` 并使用 `dag validate` 校验 DAG。
-4. 需要 Cursor 人工辅助时使用 `loop-agent cursor-prompt`，完成后仍需运行项目验证命令。
-
-### 新增
-
-- `agent-worker feature review` 可汇总 Feature 状态、阻塞、验收覆盖、证据和下一步；`--json` 可供脚本读取。
-- `agent-worker feature run` 可检查并推进一个就绪任务，`--dry-run` 可在不写入的情况下预览执行结果。
-- 新增失败接续流程，可根据失败类型生成修复任务或人工行动建议，并在批准前保留原始失败证据。
-- `feature run --git-mode checkpoint` 可为成功任务创建本地检查点，并在任务失败后恢复干净工作区；不会自动 push、merge 或创建远程 PR。
-- 新增 `feature verify-final`、`feature delivery` 和 `feature closeout`，覆盖最终验证、交付材料和显式确认后的收尾操作。
-- 晨报、Observe 和 `report metrics` 会集中展示 Feature 状态、下一步、验收覆盖和统计口径。
-- 初始化演化检查可以复用仍然有效的历史审查结果，减少低影响后续改动造成的重复评审。
-
-### 修改
-
-- `design/` 已并入 `ai_workspace/loop-agent/design/`，设计资料统一从治理文档目录查找。
-- Agent DAG 默认使用简体中文输出；可通过 `workflowPolicy.dag.outputLanguage: "en"` 切换为英文。
-- Observe 和 Dashboard 更集中地展示运行状态、风险、模型、耗时和下一步，并减少已经结束任务中的无关诊断信息。
-- 新增 `dag reconcile-run`，可在执行器已经停止后安全收尾历史失联的 DAG。
-- DAG 详情的节点检查器、事件记录和风险区域更易阅读，长内容和异常状态也能得到清楚提示。
-- 测试会根据机器资源安排并行和串行任务，降低资源竞争造成的不稳定。
-
-### 修复
-
-- 修复 `cursor-prompt --stream` 超时或异常后可能残留连接或进程的问题。
-- 修复部分运行中 DAG 被误判为不活跃、状态颜色丢失以及风险统计重复的问题。
-- 运行快照暂时无法生成时会明确提示指标不可用，不再显示具有误导性的全零状态。
-
-## [0.9.0] - 2026-07-12
-
-### 修复
-
-- 修复 Observe 总览误把已结束、但仍保留未执行节点的 DAG 显示为“活跃 DAG”的问题。
-- DAG 详情页中的节点输出、错误输出、依赖图和执行过程会在轮询更新时保留当前查看位置，不再把页面拉回默认位置。
-- DAG 和 Worker 运行详情完成首次加载后，会在运行结束时停止自动刷新；页面切到后台时会降低刷新频率，减少不必要的本机资源占用。
-- 新建 Task 默认改为串行执行验证，避免治理检查、类型检查和测试同时抢占本机资源；需要并行时仍可显式配置。
-- `run-dag` 和 `dag run-task --execute` 会拒绝无效的 `--max-concurrent`，避免异常参数导致同一批节点同时启动。
-- Worker batch 的 SSE 事件流在没有新增内容时不再重复读取历史事件，并且会等上一轮完成后再继续轮询。
-- Observe 看板在一个刷新周期内会复用同一份运行快照；同时打开总览、批次、Task 或 DAG 详情时，不会为每个请求重复扫描运行记录。
-- DAG shell 命令和 Worker 调用遇到大量输出时，只在内存中保留最近一段内容并标明截断；完整 stdout/stderr 仍会写入运行产物，避免长日志拖慢本机。
-- 建立 reference index 时会跳过依赖、构建产物、虚拟环境和版本控制目录，并在遍历规模过大时提前停止，减少误扫大型仓库。
-
-### 修改
-
-- Observe 看板改为暖白运行控制台：总览、批次、Task、DAG 和异常页面使用统一的信息层级；DAG 详情中的依赖图和节点表各自完整展示，选择节点后可从右侧检查器查看输出和执行过程。
-- 统一整理运行看板的总览、批次详情、运行详情、DAG 详情和异常 Task 页面：先展示当前状态和风险，再呈现运行记录、输出与产物，桌面端查看信息更集中。
-- 最近 DAG 运行改为按时间排列的状态时间线，标题过长时不会再挤压状态；DAG 详情仍可从每条记录直接进入。
-- 优化节点表格和宽屏布局：节点 ID、模型、状态、耗时和备注更容易扫读；节点输出支持 Markdown 阅读，完成节点在依赖图中以绿色状态提示。
-
-## [0.8.0] - 2026-07-11
-
-### 新增
-
-- 提供可定时或手动触发的 Worker 夜间运行入口。每次运行都会保留结果、晨报和 Dashboard 快照，便于持续跟踪。
-- 新增 `agent-worker task validate-feature` 以及可初始化到项目中的产品线模板。它会在开始前检查验收条件、Task 依赖、验证命令和收尾顺序，减少任务资料不完整导致的返工。
-
-### 修改
-
-- 调整运行看板中文术语，明确区分 DAG、Task 和 Worker；将异常状态、运行输出和历史结果等说明改为更容易理解的表述。
-- Task Pool runtime 硬切换到唯一根目录 `.harness/task-pool/`；旧顶层目录不再读取、迁移或兼容，升级会重置本地 Worker Task Pool 历史。
-
-## [0.7.5] - 2026-07-11
-
-### 新增
-
-- DAG 详情页新增依赖关系图。可以直观看到并行步骤、汇合点、失败和跳过路径；选择节点后会突出它的上下游关系。
-
-## [0.7.4] - 2026-07-11
-
-### 修复
-
-- Worker 会把 TaskSpec 要求的验证命令带入最终检查，避免任务看似完成却漏跑类型检查或重点测试。
-
-## [0.7.3] - 2026-07-11
-
-### 修复
-
-- 在 DAG 运行期间执行项目检查时，不再把当前正在运行的 DAG 误判为残留状态。
-
-## [0.7.2] - 2026-07-11
-
-### 修复
-
-- 修复通过脚本包装执行项目检查时的环境传递问题，避免最终验证被错误拦截。
-
-## [0.7.1] - 2026-07-11
-
-### 修复
-
-- DAG 会在评审和收尾前保存最终验证结果，便于确认 Task 是否真正通过检查。
-
-## [0.7.0] - 2026-07-11
-
-### 新增
-
-- TaskSpec 支持声明 `interactive-ui` 能力。涉及交互界面的 Task 会获得更适合 UI 实现和验收的执行配置。
-- 补充真实前端 Task、交互验收和对照样例，方便验证 Worker 对界面交付的处理效果。
-
-### 修复
-
-- 改进演练项目的初始化过程，避免覆盖已有 `.gitignore` 或写入不该提交的运行记录。
-
-## [0.6.0] - 2026-07-10
-
-### 新增
-
-- `agent-worker observe` 提供本地只读的运行看板，可查看 Worker 批次、Task、DAG、输出、失败原因和相关产物。
-- DAG 节点支持记录执行过程；看板可以展示工具调用和助手输出摘要，帮助定位长时间运行的步骤。
-- 新增 `loop-agent import-prd <task-id> --file <path>`，会保存原始 PRD 并在后续执行中保留引用，减少需求在处理中被改写或遗漏。
-- Worker 会把 Task 的需求、验收条件和参考资料整理为可追溯的执行材料；`agent-worker task retry` 可重新排队失败的 Task，同时保留失败记录。
-- `harness.json` 提供 JSON Schema。新初始化的项目和已有项目都可以获得编辑器提示与安全补齐。
-
-### 修复
-
-- 修复运行看板的历史记录、失败产物链接和状态展示问题，并限制服务只在本机访问。
-- 配置、模型或凭证错误会被明确标记为运行环境问题，避免被误导为需求不清。
-- 修复自动化检查环境缺少 `ripgrep` 时可能跳过后续测试的问题。
-
-## [0.5.0] - 2026-07-09
-
-### 新增
-
-- 可以在 `harness.json` 中为 Pi 和 Cursor 配置默认模型及不同复杂度的模型选择。
-- 完整初始化会把包内 `skills/` 投影到目标项目 `.agents/skills/`，方便不同 Agent 工具发现同一套项目指引。
-
-### 修改
-
-- 简化模型配置方式：新项目优先使用 `executors` 配置，旧配置仍可识别并会得到迁移提示。
-- 初始化时不再默认写入 Cursor 的执行器配置；只有项目原本使用 Cursor 时才会保留。
-
-## [0.4.0] - 2026-07-09
-
-### 新增
-
-- 新增 Worker 工作流：可校验 TaskSpec、批量处理就绪 Task、生成并运行 DAG，并在成功或失败后留下可追溯的记录。
-- `agent-worker batch run-ready` 会显示运行进度；`agent-worker report morning` 可汇总批次结果，方便日常查看。
-- 新增 TaskSpec、验收条件和 Task 依赖校验，帮助在执行前发现缺失资料、错误依赖或循环依赖。
-- 提供 `agent-worker` 命令行入口，可检查 Task 配置并解释执行配置的选择。
-
-### 修复
-
-- 改进运行看板、失败处理和重试记录，避免重复运行时丢失历史信息。
-- 为真实模型运行设置更合理的超时范围，减少长时间 DAG 被过早终止。
-
-## [0.3.0] - 2026-07-06
-
-### 新增
-
-- 新增 `frontend-implementation` 任务类型与专用 Agent DAG 模板，支持前端 contract / scout / design gate / implement / static verify / behavior verify / review gate / closeout 节点链，并附带 repo-local `frontend-implementation` skill 骨架。
-- 补齐前端 DAG 的 repo-local skills：前端实现、design gate review、实现 review 和 verification closeout，并纳入 npm package / `loop-agent init --profile full` 初始化投影。
-- `loop-agent init` 支持检查和更新已初始化项目，可提示缺失文件、过期配置和需要人工确认的变更。
-- 新增 `--version`，可直接查看当前安装的 loop-agent 版本。
-- 初始化内容和 npm 包内容会进行一致性检查，减少“本仓库可用、初始化项目缺文件”的情况。
-
-## [0.2.1] - 2026-07-06
-
-### 新增
-
-- 补充面向使用者的文档站，覆盖项目初始化、Task、验证、Loop 和 Agent DAG 的常用用法。
-- 新增生产就绪检查清单和失败交接材料，帮助团队在运行失败后快速定位下一步。
-- DAG 命令会提供更清楚的结果摘要、诊断信息和失败收尾草稿。
-
-### 修改
-
-- 初始化后的项目指引补充了文档收敛、写入边界和失败处理说明，方便团队按同一方式协作。
-
-### 修复
-
-- 前端 DAG 的 static / behavior shell 验证会优先使用任务源 `需求.md` / `执行约束.md` 中声明的前端验证命令，避免被通用 adapter 验证命令覆盖。
-- 前端 DAG 节点不再默认注入通用 DAG role skills，改为只加载节点显式声明的前端 skills，避免前端 skill references 被上下文预算挤出。
-- 修复完整测试运行时，部分真实命令可能因默认超时时间过短而失败的问题。
-
-## [0.2.0] - 2026-07-05
-
-### 新增
-
-- 新增 `loop-agent init`，可把 loop-agent 的基础配置、文档、技能指引和检查脚本初始化到目标项目中。
-- 初始化支持与已有 README、配置和项目结构合并，不会直接覆盖用户已有内容。
-
-### 修改
-
-- 项目可以在 `harness.json` 中使用自己的项目名，同时继续使用 loop-agent 的默认适配器。
-- README 重组为更清晰的使用入口，区分初始化、运行 Task、核心概念和项目维护。
-
-### 修复
-
-- 确保发布包带上运行边界文档，并修复 Cursor DAG Worker 在已构建包中的启动问题。
-
-## [0.1.0] - 已发布
-
-### 新增
-
-- 首个版本：提供 Agent DAG 的生成、检查和执行，以及基础的项目治理命令。
+- 修复私有仓库 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 类型检查报错
+
+本页只汇总**文档站读者摘要**；完整版本事实源始终是仓库根目录 [`CHANGELOG.md`](https://github.com/tea-agent/loop-agent/blob/main/CHANGELOG.md)。
+
+## [Unreleased]
+
+- 新增 Pull Request 的只读 AI 自动审查：在创建、重新打开、转为 ready 或更新提交时检查 bug、测试缺口、runtime boundary、command registry、初始化投影与文档收敛，并更新单条 PR 评论；Fork PR 无模型密钥时安全跳过。
+- 修复私有仓库 AI PR 审查因通过网页 `*.diff` 地址拉取差异导致 404 的问题，改为经 GitHub API 获取 diff。
+- 新增 `.editorconfig` 与 `.gitattributes`，统一常见文本文件的 UTF-8、LF、缩进和文件末尾换行约定，减少不同 IDE 与操作系统产生的无意义差异；本轮不引入 Git hooks 或格式化依赖。
+- 新增面向内部研发人员的轻量 GitHub 协作指南和简短 Pull Request 模板，统一采用短分支、CI 与 Squash Merge 的最小协作闭环，不改变现有 Agent DAG 和发布流程。
+- 收紧 npm 发布包中的 `docs/` 范围：只保留 init/runtime 所需的治理文档、architecture、skills 与 templates；源仓库专属说明与 progress/report/exec-plan 等目录契约不再打进包内。
+- 收紧 npm 发布包中的 `scripts/`：只保留 `loop-agent knowledge` 实际调用的知识库脚本；源仓治理检查与 `.sh` 薄包装不再打进包内。
+- 新增内部测试版本夜间自动发布：达到提交门槛并通过发布检查后，自动更新版本、生成中文说明并发布 GitHub Release 与 npm；手动运行默认只做 dry-run。
+- 发布说明支持 OpenAI-compatible 模型，模型不可用时自动使用保守摘要。
+- 修复 PR #34 发布风险：合并到 main 后包版本被错误提升为 `0.14.1-beta.0`，现已恢复为 `0.14.0`；发布门禁由仅按 frontend 分支判断改为按版本号的 prerelease 状态限制 dist-tag（beta prerelease 只允许 `beta` tag，使用 `latest`/空/默认 tag 时 fail-closed；非 beta prerelease 如 alpha/rc 全局拒绝），避免在 main 上执行默认 `npm publish` 时把 prerelease 误发布到 `latest`。
+- `frontend` 分支继续保留本地 npm beta 发布门禁，并在合入 main 0.14.0 后把测试版本线调整为 `0.14.1-beta.0`，避免误推正式版本或 `latest`。
+- 前端实现 DAG 的 `frontendMock.policy=auto` 不再因为目标项目缺少 Mock 能力而阻塞；无确认 Mock 能力时跳过 Mock、保留真实请求默认路径，并在未真实联调时记录 `Frontend status: locally-validated` 与 `Real integration: pending`。
+
+## [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）。