@tea-agent/loop-agent 0.3.0 → 0.4.0

package/harness.json

@@ -1,94 +1,94 @@
-{
-  "version": 1,
-  "project": "loop-agent",
-  "governanceRoot": "docs",
-  "workflowPolicy": {
-    "defaultImplementationWorkflow": "agent-dag",
-    "dag": {
-      "defaultEntry": "dag run-task",
-      "profileRouting": {
-        "minimal": "standard-dag",
-        "standard": "standard-dag",
-        "reviewed": "review-gated-dag",
-        "supervised": "supervised-implementation"
-      }
-    },
-    "humanGatePolicy": {
-      "defaultMode": "record-only",
-      "pauseOn": [
-        "requirement-ambiguity",
-        "architecture-or-public-contract-risk",
-        "credential-cost-or-deployment-risk",
-        "repeated-gate-failure",
-        "high-or-critical-decision-risk"
-      ]
-    }
-  },
-  "entrypoints": {
-    "readme": "README.md",
-    "agents": "AGENTS.md",
-    "governanceIndex": "docs/README.md",
-    "principles": "docs/development-principles.md",
-    "workflow": "docs/feature-workflow.md",
-    "verificationMatrix": "docs/verification-matrix.md",
-    "loopAgentHarness": "docs/loop-agent-harness.md",
-    "cursorExecutorUsage": "docs/cursor-executor-usage.md"
-  },
-  "artifacts": {
-    "templatesDir": "docs/templates",
-    "execPlansDir": "docs/exec-plans",
-    "progressDir": "docs/progress",
-    "reportsDir": "docs/reports",
-    "decisionsDir": "docs/decisions"
-  },
-  "scripts": {
-    "checkRepo": "scripts/check-repo.sh",
-    "checkStructure": "scripts/check-engineering-structure.sh",
-    "checkDocIndex": "scripts/check-doc-index.sh",
-    "checkDocLinks": "scripts/check-doc-links.sh",
+{
+  "version": 1,
+  "project": "loop-agent",
+  "governanceRoot": "docs",
+  "workflowPolicy": {
+    "defaultImplementationWorkflow": "agent-dag",
+    "dag": {
+      "defaultEntry": "dag run-task",
+      "profileRouting": {
+        "minimal": "standard-dag",
+        "standard": "standard-dag",
+        "reviewed": "review-gated-dag",
+        "supervised": "supervised-implementation"
+      }
+    },
+    "humanGatePolicy": {
+      "defaultMode": "record-only",
+      "pauseOn": [
+        "requirement-ambiguity",
+        "architecture-or-public-contract-risk",
+        "credential-cost-or-deployment-risk",
+        "repeated-gate-failure",
+        "high-or-critical-decision-risk"
+      ]
+    }
+  },
+  "entrypoints": {
+    "readme": "README.md",
+    "agents": "AGENTS.md",
+    "governanceIndex": "docs/README.md",
+    "principles": "docs/development-principles.md",
+    "workflow": "docs/feature-workflow.md",
+    "verificationMatrix": "docs/verification-matrix.md",
+    "loopAgentHarness": "docs/loop-agent-harness.md",
+    "cursorExecutorUsage": "docs/cursor-executor-usage.md"
+  },
+  "artifacts": {
+    "templatesDir": "docs/templates",
+    "execPlansDir": "docs/exec-plans",
+    "progressDir": "docs/progress",
+    "reportsDir": "docs/reports",
+    "decisionsDir": "docs/decisions"
+  },
+  "scripts": {
+    "checkRepo": "scripts/check-repo.sh",
+    "checkStructure": "scripts/check-engineering-structure.sh",
+    "checkDocIndex": "scripts/check-doc-index.sh",
+    "checkDocLinks": "scripts/check-doc-links.sh",
     "checkHarnessRuntimeClean": "scripts/check-harness-runtime-clean.sh",
     "checkInitEvolutionNeeded": "scripts/check-init-evolution-needed.sh",
     "checkInitSurface": "scripts/check-init-surface.sh",
     "ci": "scripts/ci.sh"
   },
-  "models": {
-    "analyze": {
-      "provider": "wizard-local",
-      "model": "gpt-5.3-codex-spark",
-      "timeoutMs": 1800000
-    },
-    "plan": {
-      "provider": "wizard-local",
-      "model": "gpt-5.3-codex-spark",
-      "timeoutMs": 1800000
-    },
-    "implement": {
-      "provider": "wizard-local",
-      "model": "gpt-5.3-codex-spark",
-      "timeoutMs": 1800000
-    },
-    "verify": {
-      "provider": "wizard-local",
-      "model": "gpt-5.3-codex-spark",
-      "timeoutMs": 1800000
-    },
-    "retrospective": {
-      "provider": "wizard-local",
-      "model": "gpt-5.3-codex-spark",
-      "timeoutMs": 1800000
-    }
-  },
-  "executors": {
-    "pi": {
-      "description": "Pi planning, review, diagnosis, and bounded writing when DAG toolProfile=write",
-      "defaultModel": "gpt-5.3-codex-spark",
-      "requiresApiKey": ""
-    },
-    "cursor": {
-      "description": "Cursor via @cursor/sdk (default model: account default)",
-      "enabled": false,
-      "defaultModel": "default",
-      "requiresApiKey": "CURSOR_API_KEY"
-    }
-  }
-}
+  "models": {
+    "analyze": {
+      "provider": "wizard-local",
+      "model": "gpt-5.3-codex-spark",
+      "timeoutMs": 1800000
+    },
+    "plan": {
+      "provider": "wizard-local",
+      "model": "gpt-5.3-codex-spark",
+      "timeoutMs": 1800000
+    },
+    "implement": {
+      "provider": "wizard-local",
+      "model": "gpt-5.3-codex-spark",
+      "timeoutMs": 1800000
+    },
+    "verify": {
+      "provider": "wizard-local",
+      "model": "gpt-5.3-codex-spark",
+      "timeoutMs": 1800000
+    },
+    "retrospective": {
+      "provider": "wizard-local",
+      "model": "gpt-5.3-codex-spark",
+      "timeoutMs": 1800000
+    }
+  },
+  "executors": {
+    "pi": {
+      "description": "Pi planning, review, diagnosis, and bounded writing when DAG toolProfile=write",
+      "defaultModel": "gpt-5.3-codex-spark",
+      "requiresApiKey": ""
+    },
+    "cursor": {
+      "description": "Cursor via @cursor/sdk (default model: account default)",
+      "enabled": false,
+      "defaultModel": "default",
+      "requiresApiKey": "CURSOR_API_KEY"
+    }
+  }
+}

package/package.json

@@ -1,64 +1,66 @@
-{
-  "name": "@tea-agent/loop-agent",
-  "version": "0.3.0",
-  "type": "module",
-  "bin": {
-    "loop-agent": "bin/loop-agent.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",
+{
+  "name": "@tea-agent/loop-agent",
+  "version": "0.4.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",
-    "zod": "^3.25.76"
-  },
-  "optionalDependencies": {
-    "@cursor/sdk": "^1.0.7",
-    "@earendil-works/pi-coding-agent": "*",
-    "@earendil-works/pi-ai": "*"
-  },
-  "devDependencies": {
-    "tsx": "^4.20.6",
-    "typescript": "^5.9.3",
-    "vitest": "^3.2.4",
-    "@types/node": "^24.6.0"
-  }
-}
+    "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-coding-agent": "*",
+    "@earendil-works/pi-ai": "*"
+  },
+  "devDependencies": {
+    "tsx": "^4.20.6",
+    "typescript": "^5.9.3",
+    "vitest": "^3.2.4",
+    "@types/node": "^24.6.0"
+  }
+}

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。