@tea-agent/loop-agent 0.5.0 → 0.6.0

package/package.json

@@ -1,66 +1,66 @@
-{
-  "name": "@tea-agent/loop-agent",
-  "version": "0.5.0",
-  "type": "module",
-  "bin": {
-    "loop-agent": "bin/loop-agent.js",
-    "agent-worker": "bin/agent-worker.js"
-  },
-  "files": [
-    "AGENTS.md",
-    "bin/",
-    "dist/",
-    "docs/*.md",
-    "docs/architecture/runtime-boundaries.md",
-    "docs/decisions/README.md",
-    "docs/design/README.md",
-    "docs/exec-plans/README.md",
-    "docs/exec-plans/active/README.md",
-    "docs/exec-plans/completed/README.md",
-    "docs/init-surface.manifest.json",
-    "docs/progress/README.md",
-    "docs/reports/README.md",
-    "docs/skills/",
-    "docs/templates/",
-    "examples/",
-    "harness.json",
-    "skills/",
-    "README.md",
-    "CHANGELOG.md"
-  ],
-  "publishConfig": {
-    "access": "public"
-  },
-  "scripts": {
-    "dev": "node --import tsx/esm src/cli.ts",
-    "cursor": "node --import tsx/esm src/cli.ts cursor-prompt",
-    "pi-prompt": "node --import tsx/esm src/cli.ts pi-prompt",
-    "clean": "node -e \"require('node:fs').rmSync('dist',{recursive:true,force:true})\"",
-    "build": "npm run clean && tsc -p tsconfig.build.json",
-    "prepack": "npm run build",
-    "prepublishOnly": "npm run typecheck && npm test && npm run build",
-    "lint": "tsc --noEmit",
-    "typecheck": "tsc --noEmit",
-    "test": "vitest run",
-    "docs:dev": "npm --prefix website start",
-    "docs:build": "npm --prefix website run build",
-    "docs:serve": "npm --prefix website run serve",
-    "smoke:stale-serial": "tsx scripts/smoke-stale-plan-serial.ts"
-  },
-  "dependencies": {
-    "commander": "^12.1.0",
-    "yaml": "^2.9.0",
-    "zod": "^3.25.76"
-  },
-  "optionalDependencies": {
-    "@cursor/sdk": "^1.0.7",
-    "@earendil-works/pi-ai": "*",
-    "@earendil-works/pi-coding-agent": "*"
-  },
-  "devDependencies": {
-    "@types/node": "^24.6.0",
-    "tsx": "^4.20.6",
-    "typescript": "^5.9.3",
-    "vitest": "^3.2.4"
-  }
-}
+{
+  "name": "@tea-agent/loop-agent",
+  "version": "0.6.0",
+  "type": "module",
+  "bin": {
+    "loop-agent": "bin/loop-agent.js",
+    "agent-worker": "bin/agent-worker.js"
+  },
+  "files": [
+    "AGENTS.md",
+    "bin/",
+    "dist/",
+    "docs/*.md",
+    "docs/architecture/runtime-boundaries.md",
+    "docs/decisions/README.md",
+    "docs/design/README.md",
+    "docs/exec-plans/README.md",
+    "docs/exec-plans/active/README.md",
+    "docs/exec-plans/completed/README.md",
+    "docs/init-surface.manifest.json",
+    "docs/progress/README.md",
+    "docs/reports/README.md",
+    "docs/skills/",
+    "docs/templates/",
+    "examples/",
+    "harness.json",
+    "skills/",
+    "README.md",
+    "CHANGELOG.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "dev": "node --import tsx/esm src/cli.ts",
+    "cursor": "node --import tsx/esm src/cli.ts cursor-prompt",
+    "pi-prompt": "node --import tsx/esm src/cli.ts pi-prompt",
+    "clean": "node -e \"require('node:fs').rmSync('dist',{recursive:true,force:true})\"",
+    "build": "npm run clean && tsc -p tsconfig.build.json && node -e \"const fs=require('node:fs');const p='dist/worker/observe/static';fs.mkdirSync(p,{recursive:true});fs.cpSync('src/worker/observe/static',p,{recursive:true});\"",
+    "prepack": "npm run build",
+    "prepublishOnly": "npm run typecheck && npm test && npm run build",
+    "lint": "tsc --noEmit",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "docs:dev": "npm --prefix website start",
+    "docs:build": "npm --prefix website run build",
+    "docs:serve": "npm --prefix website run serve",
+    "smoke:stale-serial": "tsx scripts/smoke-stale-plan-serial.ts"
+  },
+  "dependencies": {
+    "commander": "^12.1.0",
+    "yaml": "^2.9.0",
+    "zod": "^3.25.76"
+  },
+  "optionalDependencies": {
+    "@cursor/sdk": "^1.0.7",
+    "@earendil-works/pi-ai": "*",
+    "@earendil-works/pi-coding-agent": "*"
+  },
+  "devDependencies": {
+    "@types/node": "^24.6.0",
+    "tsx": "^4.20.6",
+    "typescript": "^5.9.3",
+    "vitest": "^3.2.4"
+  }
+}

package/skills/ai-engineering-context/SKILL.md

@@ -1,48 +1,48 @@
----
-name: ai-engineering-context
-description: 当 AI coding agent 启动 loop-agent 工作、准备 DAG 或 Loop context、委派 role-specific 节点，或决定 requirements、facts、evidence、handoff notes 应落何处时使用。
----
-
-# AI Engineering Context
-
-Context 是工程 artifact，不是 chat 残留。须显式保留 requirements、role 边界、write authority、evidence 与 handoff facts。
-
-## When to Use
-
-在启动 task、DAG、workflow 或 Loop round；准备 role prompt；委派给 Cursor/Pi/shell/static executor；或处理 stale plan、冲突 requirements、缺失 evidence 时使用。
-
-不要用于 private platform paths、personal memory、Google Drive 规则，或替代 task skills。
-
-## Context Priority
-
-按以下顺序优先采信 facts：最新 user instruction；task source/contract；DAG/Loop artifacts；docs/plans/ADRs；code/tests；chat history 仅作 hint。
-
-若 sources 冲突，停止并点明冲突。
-
-## Role Boundaries
-
-- Planner：contract、DAG shape、write boundary、verification plan；不做 implementation edits。
-- Scout：code/test/doc/artifact facts；不写 repo。
-- Implementer：在 writeSet 内做 bounded changes；不扩大 scope 或宣称完成。
-- Reviewer：bugs、regressions、missing tests、risk；除非被指派，否则不重写。
-- Verifier：command evidence、reproduction、failure category；model judgment 不是 proof。
-- Supervisor：gates、escalation、repair scope；不绕过 write-guard 或 human-gate。
-- Closeout：evidence、risks、next steps；不隐藏 failures。
-
-## Prompt Contract
-
-每个 delegated node prompt 应包含：objective、task id、role、executor、allowed paths、forbidden paths、writeSet、upstream artifact refs、concise excerpts、output contract、expected evidence、non-goals、stop conditions。
-
-read-only node 只能在 node output 返回 findings。不得在 repo 中创建 scratch files。
-
-## Persistence Rules
-
-Requirements 与 constraints 写入 task `source/`。Execution state 与 node artifacts 写入 `.harness/`。Durable plans、reports、decisions 写入 `docs/`。可复用 process guidance 写入 `skills/`。Chat 仅 transient。
-
-## Failure Handling
-
-- Missing context：运行 scout 或读取 durable source。
-- Ambiguous requirement：implementation 前更新 contract。
-- Verification failure：改 code 前先 diagnose cause。
-- Missing skill instructions：视为 context defect；不要假设 hidden behavior。
-- Missing fresh verification：不要 close out。
+---
+name: ai-engineering-context
+description: 当 AI coding agent 启动 loop-agent 工作、准备 DAG 或 Loop context、委派 role-specific 节点，或决定 requirements、facts、evidence、handoff notes 应落何处时使用。
+---
+
+# AI Engineering Context
+
+Context 是工程 artifact，不是 chat 残留。须显式保留 requirements、role 边界、write authority、evidence 与 handoff facts。
+
+## When to Use
+
+在启动 task、DAG、workflow 或 Loop round；准备 role prompt；委派给 Cursor/Pi/shell/static executor；或处理 stale plan、冲突 requirements、缺失 evidence 时使用。
+
+不要用于 private platform paths、personal memory、Google Drive 规则，或替代 task skills。
+
+## Context Priority
+
+按以下顺序优先采信 facts：最新 user instruction；task source/contract；DAG/Loop artifacts；docs/plans/ADRs；code/tests；chat history 仅作 hint。
+
+若 sources 冲突，停止并点明冲突。
+
+## Role Boundaries
+
+- Planner：contract、DAG shape、write boundary、verification plan；不做 implementation edits。
+- Scout：code/test/doc/artifact facts；不写 repo。
+- Implementer：在 writeSet 内做 bounded changes；不扩大 scope 或宣称完成。
+- Reviewer：bugs、regressions、missing tests、risk；除非被指派，否则不重写。
+- Verifier：command evidence、reproduction、failure category；model judgment 不是 proof。
+- Supervisor：gates、escalation、repair scope；不绕过 write-guard 或 human-gate。
+- Closeout：evidence、risks、next steps；不隐藏 failures。
+
+## Prompt Contract
+
+每个 delegated node prompt 应包含：objective、task id、role、executor、allowed paths、forbidden paths、writeSet、upstream artifact refs、concise excerpts、output contract、expected evidence、non-goals、stop conditions。
+
+read-only node 只能在 node output 返回 findings。不得在 repo 中创建 scratch files。
+
+## Persistence Rules
+
+Requirements 与 constraints 写入 task `source/`。Execution state 与 node artifacts 写入 `.harness/`。Durable plans、reports、decisions 写入 `docs/`。可复用 process guidance 写入 `skills/`。Chat 仅 transient。
+
+## Failure Handling
+
+- Missing context：运行 scout 或读取 durable source。
+- Ambiguous requirement：implementation 前更新 contract。
+- Verification failure：改 code 前先 diagnose cause。
+- Missing skill instructions：视为 context defect；不要假设 hidden behavior。
+- Missing fresh verification：不要 close out。

package/skills/code-review-core/SKILL.md

@@ -1,20 +1,20 @@
----
-name: code-review-core
-description: 用于只读 code review 节点，产出带文件与行号引用的优先级 findings。
----
-
-# Code Review Core
-
-本 skill 用于 reviewer 节点。
-
-## Review 重点
-
-- 优先关注 correctness、行为回归、security、数据丢失与缺失验证。
-- findings 须 grounded 在具体文件与行号。
-- 区分 blocking findings 与次要 maintainability 备注。
-- 检查测试是否证明变更行为，文档是否与面向用户的变更一致。
-- 若无 findings，明确说明，并指出 residual test gap（如有）。
-
-## Output
-
-按 severity 排序列出 findings。仅当无 blocking findings 时，才写 `VERDICT: pass`。
+---
+name: code-review-core
+description: 用于只读 code review 节点，产出带文件与行号引用的优先级 findings。
+---
+
+# Code Review Core
+
+本 skill 用于 reviewer 节点。
+
+## Review 重点
+
+- 优先关注 correctness、行为回归、security、数据丢失与缺失验证。
+- findings 须 grounded 在具体文件与行号。
+- 区分 blocking findings 与次要 maintainability 备注。
+- 检查测试是否证明变更行为，文档是否与面向用户的变更一致。
+- 若无 findings，明确说明，并指出 residual test gap（如有）。
+
+## Output
+
+按 severity 排序列出 findings。仅当无 blocking findings 时，才写 `VERDICT: pass`。

package/skills/codebase-scout/SKILL.md

@@ -1,19 +1,19 @@
----
-name: codebase-scout
-description: 用于只读 scout 节点，在实现前定位现有代码、测试、文档与集成点。
----
-
-# Codebase Scout
-
-本 skill 用于 scout 节点。
-
-## 规则
-
-- 从 repo 指令、task source 与邻近测试入手。
-- 可用时优先 CodeGraph；否则用 `rg` 与聚焦文件阅读。
-- 在提议新抽象前，识别现有 helper 与 ownership 边界。
-- 只返回事实，不做编辑。
-
-## Output
-
-列出相关文件、现有模式、风险，以及实现所需的最小 write surface。
+---
+name: codebase-scout
+description: 用于只读 scout 节点，在实现前定位现有代码、测试、文档与集成点。
+---
+
+# Codebase Scout
+
+本 skill 用于 scout 节点。
+
+## 规则
+
+- 从 repo 指令、task source 与邻近测试入手。
+- 可用时优先 CodeGraph；否则用 `rg` 与聚焦文件阅读。
+- 在提议新抽象前，识别现有 helper 与 ownership 边界。
+- 只返回事实，不做编辑。
+
+## Output
+
+列出相关文件、现有模式、风险，以及实现所需的最小 write surface。

package/skills/init-capability-evolution/SKILL.md

@@ -1,69 +1,69 @@
----
-name: init-capability-evolution
-description: 用于 loop-agent 本仓库的初始化能力演化审查，判断代码、skill、模板、包范围或 DAG 默认能力变化是否需要同步更新目标项目 init surface。
----
-
-# Init Capability Evolution
-
-本 skill 用于 loop-agent 本仓库。当变更可能影响 `loop-agent init` 初始化其他项目的能力时使用。
-
-## Goal
-
-让模型自行判断并维护初始化能力，而不是依赖人工记忆：
-
-- 新能力是否应该进入目标项目。
-- 新增/修改的 skill 是否应随 npm 包和 `init --profile full` 投影。
-- 目标项目的 `AGENTS.md`、README managed block、治理 docs、scripts 或 templates 是否需要更新。
-- `package.json files` 与 `docs/init-surface.manifest.json` 是否仍覆盖真实发布范围。
-- 是否需要目标项目 smoke、init doctor、docs audit 或 package dry-run 证据。
-
-## Trigger Tiers
-
-按 `docs/init-surface.manifest.json` 的 `evolutionReview.tiers` 判断成本：
-
-- `advisory`：只记录提示，不阻塞。
-- `surface-check`：运行 `bash scripts/check-init-surface.sh`；通过即可。
-- `model-review`：写一份简短 init evolution review，必要时修改 init surface、包范围、文档、skill 或测试。
-
-不要把小改动升级成重流程。只有当变化可能改变目标项目初始化体验、默认 DAG 行为、skill resolution、发布包边界或 init 生成物时，才进入 model-review。
-
-## Review Questions
-
-审查时逐条回答：
-
-1. 本次变更会改变目标项目执行 `loop-agent init --profile full --merge` 后得到的文件、规则或能力吗？
-2. 是否新增、删除或重命名了 `skills/**`，并且目标项目需要 repo-local 可审计副本？
-3. 是否改变了默认 DAG role skills、skill resolution、strict skill audit 或 task prompt 注入？
-4. 是否新增通用治理模板、script matrix、production readiness 或 operator recovery 文档，需要目标项目初始化后可见？
-5. `package.json files` 是否包含所有 npm 运行和初始化所需静态资料？
-6. `docs/init-surface.manifest.json` 是否更新了 package / init / exclude / trigger contract？
-7. 旧目标项目是否只需 advisory、需要手工复制新增文件，还是需要未来 `init audit/update` 迁移能力？
-
-## Output
-
-轻量审查可以只在 handoff 中说明。高影响审查应写入：
-
-```text
-docs/reports/YYYY-MM-DD-init-evolution-review.md
-```
-
-报告保持短小，包含：
-
-- changed surface
-- decision: no init impact / surface check only / init update required
-- files updated
-- verification commands and results
-- residual risk
-
-## Required Verification
-
-按影响面选择最小命令：
-
-```bash
-bash scripts/check-init-surface.sh
-bash scripts/check-repo.sh
-npm test -- init-command dag-skills dag-validate-command
-npm pack --dry-run --ignore-scripts
-```
-
-如果没有新鲜验证证据，不要宣称 init evolution 已完成。
+---
+name: init-capability-evolution
+description: 用于 loop-agent 本仓库的初始化能力演化审查，判断代码、skill、模板、包范围或 DAG 默认能力变化是否需要同步更新目标项目 init surface。
+---
+
+# Init Capability Evolution
+
+本 skill 用于 loop-agent 本仓库。当变更可能影响 `loop-agent init` 初始化其他项目的能力时使用。
+
+## Goal
+
+让模型自行判断并维护初始化能力，而不是依赖人工记忆：
+
+- 新能力是否应该进入目标项目。
+- 新增/修改的 skill 是否应随 npm 包和 `init --profile full` 投影。
+- 目标项目的 `AGENTS.md`、README managed block、治理 docs、scripts 或 templates 是否需要更新。
+- `package.json files` 与 `docs/init-surface.manifest.json` 是否仍覆盖真实发布范围。
+- 是否需要目标项目 smoke、init doctor、docs audit 或 package dry-run 证据。
+
+## Trigger Tiers
+
+按 `docs/init-surface.manifest.json` 的 `evolutionReview.tiers` 判断成本：
+
+- `advisory`：只记录提示，不阻塞。
+- `surface-check`：运行 `bash scripts/check-init-surface.sh`；通过即可。
+- `model-review`：写一份简短 init evolution review，必要时修改 init surface、包范围、文档、skill 或测试。
+
+不要把小改动升级成重流程。只有当变化可能改变目标项目初始化体验、默认 DAG 行为、skill resolution、发布包边界或 init 生成物时，才进入 model-review。
+
+## Review Questions
+
+审查时逐条回答：
+
+1. 本次变更会改变目标项目执行 `loop-agent init --profile full --merge` 后得到的文件、规则或能力吗？
+2. 是否新增、删除或重命名了 `skills/**`，并且目标项目需要 repo-local 可审计副本？
+3. 是否改变了默认 DAG role skills、skill resolution、strict skill audit 或 task prompt 注入？
+4. 是否新增通用治理模板、script matrix、production readiness 或 operator recovery 文档，需要目标项目初始化后可见？
+5. `package.json files` 是否包含所有 npm 运行和初始化所需静态资料？
+6. `docs/init-surface.manifest.json` 是否更新了 package / init / exclude / trigger contract？
+7. 旧目标项目是否只需 advisory、需要手工复制新增文件，还是需要未来 `init audit/update` 迁移能力？
+
+## Output
+
+轻量审查可以只在 handoff 中说明。高影响审查应写入：
+
+```text
+docs/reports/YYYY-MM-DD-init-evolution-review.md
+```
+
+报告保持短小，包含：
+
+- changed surface
+- decision: no init impact / surface check only / init update required
+- files updated
+- verification commands and results
+- residual risk
+
+## Required Verification
+
+按影响面选择最小命令：
+
+```bash
+bash scripts/check-init-surface.sh
+bash scripts/check-repo.sh
+npm test -- init-command dag-skills dag-validate-command
+npm pack --dry-run --ignore-scripts
+```
+
+如果没有新鲜验证证据，不要宣称 init evolution 已完成。