@tea-agent/loop-agent 0.7.5 → 0.8.0

package/CHANGELOG.md

@@ -1,164 +1,148 @@
-# 更新日志
-
-这里记录每个版本面向使用者的主要变化。保持简短即可：新增、修改、修复或删除了什么，不需要展开实现细节。
-
-## [Unreleased]
-
-## [0.7.5] - 2026-07-11
-
-### 新增
-
-- Observe DAG Detail 新增离线 SVG 依赖图：read-model 从 canonical `run.json` 投影稳定 edges，支持并行/汇合/失败/跳过状态、键盘节点选择、上下游高亮、滚动与重置视图，并保留节点表格和过程时间线降级路径。
-- 新增 repository-owned Worker nightly wrapper 与 GitHub Actions 手动/定时适配面：按 feature 互斥、保留超时/批次退出码，并收集 controller、morning report、Observe snapshot 等 artifacts。
-- 新增 `agent-worker task validate-feature` 和可初始化投影的语言无关产品线模板，校验 AC 唯一性、任务依赖、TaskSpec 路径/验证命令及 QA verdict → success closeout 顺序，并接入仓库治理门禁。
-
-## [0.7.4] - 2026-07-11
-
-### 修复
-
-- Worker materialize 现在把 TaskSpec 中所有 required `verify.commands` 写入 task config，并强制合并到 DAG 最终 shell verification；review 不再只能看到仓库级治理命令而缺少任务契约要求的 typecheck/focused tests。
-
-## [0.7.3] - 2026-07-11
-
-### 修复
-
-- 将 `HARNESS_ALLOW_ACTIVE_DAG_RUNS=1` 作为所有 adapter-resolved DAG verification commands 的统一运行环境不变量，避免 `ci-governance.sh` 等间接 runtime-clean 检查误判当前 active DAG。
-
-## [0.7.2] - 2026-07-11
-
-### 修复
-
-- 修复 adapter 将治理检查包装为 `bash -lc "bash scripts/check-repo.sh"` 时未注入 `HARNESS_ALLOW_ACTIVE_DAG_RUNS=1`，导致新 `verify-shell` 把自身 active DAG 误判为 runtime 脏状态的问题。
-
-## [0.7.1] - 2026-07-11
-
-### 修复
-
-- 标准与 review-gated Agent DAG 现在会把 adapter/TaskSpec 的最终验证命令物化为 `verify-shell`，在 `verify-pi`、review 和 closeout 前保存真实 exit code/stdout/stderr，避免实现已绿但因缺少新鲜 shell 证据被 review gate 拦截。
-
-## [0.7.0] - 2026-07-11
-
-### 新增
-
-- TaskSpec 新增可选 `capabilities: [interactive-ui]`：在不改变 `risk_level` / governance profile 的前提下，仅将 implement/repair writer 路由到 HIGH canonical model，并注入真实 UI component、integration 与 DOM interaction test 交付契约。
-- Round-2 FE dogfood 新增真实 React/ReactDOM + Testing Library/user-event/jsdom fixture、AC-FE-001 DOM 验收，以及 prompt-only MED / default-prompt HIGH / UI-prompt HIGH 的 A/B/C DAG 变体生成脚本与实验记录模板。
-- dogfood Feature `F-2026-001` 新增第二个前端任务 `FE-002`（frontend session store，独立于 FE-001）与对应验收项 `AC-FE-002`，补齐“第二个 FE”覆盖。
-
-### 修复
-
-- 修复 `scripts-local/setup-drill-round1.sh` 在 `.task-pool/` 已忽略时仍尝试提交 state、覆盖 init 生成的 `.gitignore` managed block、依赖版本漂移及危险目标路径缺少保护的问题。
-- 新增首轮夜间演练报告 `docs/reports/2026-07-10-nightly-drill-round-1.md`：记录 0.6.0 已发布控制器下的 batch/晨报/决策闭环、review-gated 失败与人工接管证据。
-- 新增可复现演练目标仓库 setup 脚本 `scripts-local/setup-drill-round1.sh`。
-
-## [0.6.0] - 2026-07-10
-
-### 新增
-
-- Observe UI 中文化：Dashboard 默认突出进行中的 DAG runs（进度、当前节点、已用时），补充 DAG 元信息（title/startedAt/finishedAt/ranks/节点 outputPreview）与 Rank 泳道详情；read-model 只增字段，保持 local-only 只读。
-- Pi SDK DAG 节点在运行中 best-effort 追加 `session-events.jsonl` 至 `.harness/dag-runs/.../<nodeId>/`（过程事件落盘，写失败不影响节点成败；CLI 后端无过程日志）。
-- Observe DAG 详情新增过程时间线：GET `/api/dag-runs/:id/nodes/:nodeId/session-events?after=N` 尾读 `session-events.jsonl`，UI 每 2s 轮询展示工具/助手过程事件（中文标签）。
-- 文档站同步 Observe 指南：`website/docs/guides/observe-ui.md`，并更新 intro / CLI / Agent DAG / 安装与首次运行入口。
-- 新增 `loop-agent import-prd <task-id> --file <path>`：把用户原始 PRD 原样复制到 `source/references/`，写入 `source-manifest.json` 与 `task.json.referenceDocs`，避免 AI 直接改写权威需求。
-- `dag run-task` / hybrid source 加载时会物化 `task.json.referenceDocs` 到 `source/references/`；source 超 2000 字符时仍截断进 prompt，但会保留完整源路径引用（如 `source/需求.md` / `source/references/...`），禁止静默丢弃尾部且不凭空补全。
-- DAG objective / successCriteria 提取兼容 `目标/完成标准/Acceptance References` 等常见标题，并跳过 TaskSpec 元数据行。
-- Worker materialize 生成的 `source/需求.md` 现在带权威声明、`source/references` 路径与 hash 追溯，并把 `acceptance_refs` 展开为短摘要（不再只剩 AC ID）；review-gated/supervised 的 `review-pi` 强制三方对照 references + 派生契约 + 实现。
-
-### 修复
-
-- 修复 GitHub Actions governance job 未安装 `ripgrep`，导致依赖 `rg` 的仓库治理检查失败并跳过 test job 的问题。
-- 修复 Observe UI 历史 worker run 详情 404、未校验 event route identifier 造成的 scoped event path traversal，以及失败的 doctor/closeout evidence step 被错误显示为成功的问题。
-- 修复 Worker provider/executor 配置失败被误导为 `SpecUnclear` 的路由：已知 provider、model、executor、凭证与 thinking-level 配置错误现在归为 `EnvFailure`，并保留原始 DAG/runner 事实。
-
-### 新增
-
-- 新增 `agent-worker observe` 本地只读可观测 UI：`observe serve` 启动 127.0.0.1 只读 HTTP server（REST + SSE），`observe snapshot` 输出全局快照 JSON；提供 Dashboard / Batch Detail / Run Detail / DAG Detail / Failure Inbox 五个静态视图，可实时查看 batch/task/step/command 进展、stdout/stderr tail、DAG node 状态与失败 report/doctor/handoff 链接。底层为结构化事件流（`.task-pool/observability/`）、`LoopAgentClient` 流式输出与 heartbeat、`loop-agent run-dag --events-jsonl` DAG node 级事件，以及 stale/quiet/timeout-risk liveness 诊断。仅读取运行事实，不提供写操作。
-- 新增 `agent-worker task retry <task-id> --repo <repo>`：仅将 `Failed` Task Pool state 显式 requeue，保留失败运行历史和 handoff，并保证下一次 batch 使用新的 `workerRunId`。`src/worker/**` 同时进入架构边界硬检查，禁止 in-process import CLI、commands 或 application。
-
-## [0.5.0] - 2026-07-09
-
-### 新增
-
-- Agent DAG 模型矩阵现由 `harness.json.executors.<pi|cursor>` 驱动：支持 `defaultModel` 与可选 `LOW`/`MED`/`HIGH`（档位优先于 defaultModel，再回退代码默认）。`dag run-task` 生成 `executorModels` 时读取该配置；`--strict-models` 对照 harness 解析结果。
-- `loop-agent init`（full / minimal）现在会在目标项目 `.gitignore` 合并 loop-agent managed block（`# LOOP_AGENT_INIT_START/END`）：忽略 `.harness/tasks/*`、`.harness/dag-runs/*`、`.harness/runs/*`、`.harness/live/`、`.harness/cache/`、`.harness/*.log`、`.harness/init-surface.json`、`.task-pool/`、`.worktrees/` 等个人/会话运行态事实，同时保留 `.harness/prompts/` 和目录占位（`.gitkeep`）可共享。已有 `.gitignore` 时只合并 managed block，不覆盖用户规则；`loop-agent init check-update` 对缺失或过期 block 给出 deterministic `refresh-managed-block`，`update --apply-safe` 可应用；`loop-agent init doctor` 新增 `gitignore loop-agent block` 检查；`docs/init-surface.manifest.json` 登记 `.gitignore`。注意不会整目录忽略 `.harness/`。
-- `loop-agent init --profile full` 现在双写 skills：除了原有的目标项目 `skills/`，还会把同一份 skills 镜像到 `.agents/skills/`（外部 agent 如 OpenCode 的自动发现路径）；`skills/` 仍是 loop-agent runtime 的首选主路径，`--profile minimal` 仍同时跳过两处。DAG skill 解析候选路径增加 `cwd/.agents/skills/<name>/SKILL.md`（位于 `skills/` 之后、发布包内置之前），`init doctor` 额外检查 `.agents/skills/loop-agent/SKILL.md`，`docs/init-surface.manifest.json` 记录 `.agents/skills` 相关 surface。
-
-### 修改
-
-- 废弃顶层 `models` / `modelProfiles` / `modelRouting` 作为 DAG 路由来源：schema 仍兼容旧文件，但默认 `harness.json` 与 `loop-agent init` 新投影不再写出这些字段；`--provider/--model` 改为写入 `executors.pi.defaultModel`。旧目标项目若仍含 `models`，check-update 会将 harness 差异作为 model-merge 任务提示迁移到 `executors`。
-- `loop-agent init` 默认不再向目标项目投影 `executors.cursor`（Cursor 为包开发者可选能力）；仅当目标已有 `executors.cursor` 时保留。
-- 去掉 Pi executor 的无用 `requiresApiKey` 投影；`init check-update` / `update --apply-safe` 可对目标项目安全剥离 `executors.pi.requiresApiKey`，Cursor 的 `requiresApiKey` 仍保留。
-
-## [0.4.0] - 2026-07-09
-
-### 新增
-
-- 新增 `agent-worker batch run-ready` 运行时进度反馈：批次启动、每个 task 的 preflight/materialize/dag 生成与校验/run-dag 执行/report 决策阶段会实时打到 stderr，stdout 仍只保留最终 JSON；新增 `--quiet` 选项可关闭进度，解决长任务静默被误判为卡死的问题。
-- 新增 `agent-worker batch run-ready --pi-model <model>` worker 专属 smoke 覆盖：提供时重写生成 DAG 的 `executorModels.pi.{LOW,MED,HIGH}` 全部指向该模型，并对本次 `dag validate` 去掉 `--strict-models`；不改动 `loop-agent` canonical 模型矩阵或 `pi-prompt` 默认模型，典型用于 MED 模型 provider 抽风时让 dogfood smoke 改跑 `gpt-5.3-codex-spark`。
-- 新增 Worker TaskSpec v0.1 schema、`validateTaskSpec` 三层校验、`risk_level` 到 task complexity 的映射 helper，以及 5 个 dogfood TaskSpec 样例；当前仅作为纯库和样例验证，尚未接入 CLI/runtime。
-- 新增 AcceptanceSpec / TaskGraphSpec schema、Feature graph 校验器和 Ready 队列计算，覆盖 dogfood feature 的验收引用、任务文件一致性、未知依赖、环检测与 ready 判定。
-- 新增 business profile 到 loop-agent profile 的确定性映射、独立 `agent-worker` CLI（`task validate` / `task explain-profile`）和 package bin surface。
-- 新增 Worker `LoopAgentClient`、JSON parse failure artifact、repo path resolver 和目标仓库 preflight，覆盖 Ring 0 CLI contract smoke。
-- 新增 Worker TaskSpec materializer，将 TaskSpec 物化为 `.harness` task、回写 path/verify 边界与 coverage-safe source，并覆盖 Ring 1 DAG generate/validate/dry-run smoke。
-- 新增 Worker `runTaskSpec` pipeline、task-local run record、成功/失败分流和 Ring 2 shell-only DAG success/failure smoke；成功 report 后才 promote/closeout，失败 run 生成 report/doctor/closeout-draft evidence。
-- 新增 Worker Task Pool JSONL/state store、failure routing、串行 `agent-worker batch run-ready` 和 `agent-worker report morning`，支持失败 follow-up 建议、workerRunId 重入复用和 missing artifact 报告降级。
-- 新增 Worker preflight 的 `loop-agent --version`、`git status --short --branch` 和可配置 `--check-repo` 检查，并记录一次无 Cursor/Pi 的 TaskSpec 到 morning report dogfood 运行报告。
-
-### 修复
-
-- 修复 observe UI 的真实事件路由、重复 task 历史运行、DAG/Failure Inbox 路由、失败与命令 artifact 链接、liveness 判定和 DAG 事件元数据；同时强制 server 仅绑定 loopback，并限制 artifact API 只读取已知运行产物目录。
-- 修复 Worker batch/materializer 重入幂等、run-error Task Pool evidence/state 持久化、blocked morning report 汇总和 fallback failure routing 标记。
-- 修复 Worker failure closeout draft 写入 `.harness` 被拒的问题，改为写入 `.task-pool/failure-handoffs/`，并将 `.task-pool/` 作为 runtime state 忽略。
-- 修复 Worker 真实模型 DAG 容易被 120s 默认超时误杀的问题：`run-dag` 默认 30 分钟，显式 `TaskSpec.worker.timeout_ms` 最高 2 小时，普通命令仍保持 2 分钟，`check-repo` 保持 5 分钟。
-- 修复 DAG Pi reviewer 使用 `gpt-5.5` 时未显式设置 provider 支持的 thinking level，导致 SDK 默认 `minimal` 被 `wizard-local` 拒绝的问题。
-
-## [0.3.0] - 2026-07-06
-
-### 新增
-
-- 新增 init surface manifest 与 `scripts/check-init-surface.sh`，自动校验 npm 发布包范围和 `loop-agent init --profile full` 对目标项目的关键文件投影。
-- 新增 `init-capability-evolution` skill、init evolution review 模板与 `scripts/check-init-evolution-needed.sh`，按 advisory / surface-check / model-review 三档提示初始化能力是否需要模型审查；默认不阻塞小改动。
-- CLI 新增 `-V, --version` / `--version`，输出当前 package 版本且不要求 repo adapter。
-- 新增 `loop-agent init check-update` 与 `loop-agent init update`，为旧版初始化过的目标项目生成 deterministic actions、model merge tasks、human decisions，并支持 `.harness/init-surface.json` baseline bootstrap 与安全补齐。
-
-## [0.2.1] - 2026-07-06
-
-### 新增
-
-- 文档站结合 `src/` 与 `skills/loop-agent` 补充目标项目初始化、Harness Policy、Task Source 与验证、Loop 与 Sidecar 指南，并扩充 Agent DAG、CLI 与配置参考。
-- 文档站新增 Harness 实践与设计来源资料，收录 Anthropic 长时运行 agent harness、OpenAI Codex harness engineering、腾讯端到端 Harness Engineering 和社区 agent harness 最佳实践，并在 README、治理索引和开发原则中记录其与当前治理思想的关系。
-- 新增 Production Readiness v0.1 治理标准、生产就绪 checklist 模板，以及 2026-07-06 到 2026-07-12 的生产可用硬化 sprint 执行计划，明确低/中风险单 repo DAG 任务的支持范围、非目标、证据要求、失败分类和最终验证门禁。
-- 新增 DAG production-readiness hardening：`dag validate` / `run-dag` 输出下一步指引，`dag report` 暴露 product-line failure routing 与 Operator Next Steps，`dag doctor --run-id --markdown` 输出失败诊断，failed `dag closeout-draft` 生成 Failure Handoff。
-- `dag run-task`、`dag validate`、`run-dag` 的 JSON 输出新增稳定 `message` summary；`dag validate` 额外输出 write set 与 decision gate check 摘要。
-- Dynamic Workflow node 现在可声明 `skills`，编译到 DAG 时会保留到对应 task、动态展开 child task 与 loop body task。
-- 新增 repo-local vetted skill registry、首批 role skill wrappers，以及 opt-in `dag validate --strict-skills` audit gate。
-
-### 修改
-
-- 更新本仓库与目标项目初始化后的 `AGENTS.md` 工作协议，新增文档收敛步骤、结构化 DAG 写入边界要求，以及 runtime boundary / command registry / skill entry / 发布包范围的定向验证指引。
-- `loop-agent init` 生成的目标项目 `AGENTS.md` 同步包含文档收敛、`task.json.allowedPaths` / `task.json.forbiddenPaths`、DAG 失败诊断与 failure handoff 规则，目标项目文档也会显式导出 production readiness checklist、`dag report`、`dag doctor --run-id --markdown` 和失败 run 的 `dag closeout-draft`。
-
-### 修复
-
-- 修复 `check-harness-runtime-clean.sh` 与 CLI contract 集成测试在 full-suite 负载下可能因默认 5s Vitest timeout 超时的问题，保留真实 shell/CLI 检查和断言。
-
-## [0.2.0] - 2026-07-05
-
-### 新增
-
-- 新增 `loop-agent init` 初始化目标项目，包含模型指引输出、merge 初始化、初始化体检、repo-local skills 投影、语言无关治理脚本矩阵、runtime boundary 文档、skill entry/architecture boundary 检查和目标项目版治理文档；根 README 默认生成中文项目入口，并以 managed block 合并已有 README；模型执行初始化时必须在同一轮自动完成项目识别、README/验证矩阵适配和体检闭环；`examples` 改为工具内置查看/按需复制，不在初始化时默认写入目标仓库。
-
-### 修改
-
-- `harness.json` 支持以 `adapter: "loop-agent"` 与真实项目名分离，目标项目无需把 `project` 写成 `loop-agent` 才能使用默认 adapter。
-- README 重组为兼容 npm/GitHub 展示和本仓库迭代导航的入口，明确区分快速开始、目标项目初始化、任务运行、核心概念、本仓库开发和发布包内容，并补充新项目初始化时可直接交给模型执行的提示词。
-
-### 修复
-
-- npm 发布包范围纳入 `docs/architecture/runtime-boundaries.md`，确保 runtime boundary 治理文档与 0.2.0 包一起发布。
-- Cursor DAG worker 在构建产物中使用 `.js` worker 入口且不依赖 `tsx`，避免发布包/本地 build 运行 Cursor 节点时先因 worker 入口解析失败。
-
-## [0.1.0] - 已发布
-
-### 新增
-
-- 初始发布：Agent DAG 生成/校验/执行、loop-agent harness 治理入口与基础 CLI。
+# 更新日志
+
+这里记录每个版本对使用者有影响的变化。命令名和配置字段保持原样，其余内容尽量用日常语言说明。
+
+## [Unreleased]
+
+- 暂无未发布内容。
+
+## [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
+
+### 新增
+
+- `loop-agent init` 支持检查和更新已初始化项目，可提示缺失文件、过期配置和需要人工确认的变更。
+- 新增 `--version`，可直接查看当前安装的 loop-agent 版本。
+- 初始化内容和 npm 包内容会进行一致性检查，减少“本仓库可用、初始化项目缺文件”的情况。
+
+## [0.2.1] - 2026-07-06
+
+### 新增
+
+- 补充面向使用者的文档站，覆盖项目初始化、Task、验证、Loop 和 Agent DAG 的常用用法。
+- 新增生产就绪检查清单和失败交接材料，帮助团队在运行失败后快速定位下一步。
+- DAG 命令会提供更清楚的结果摘要、诊断信息和失败收尾草稿。
+
+### 修改
+
+- 初始化后的项目指引补充了文档收敛、写入边界和失败处理说明，方便团队按同一方式协作。
+
+### 修复
+
+- 修复完整测试运行时，部分真实命令可能因默认超时时间过短而失败的问题。
+
+## [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 的生成、检查和执行，以及基础的项目治理命令。