@tea-agent/loop-agent 0.3.0 → 0.5.0

package/docs/init-surface.manifest.json

@@ -1,175 +1,199 @@
-{
-  "version": 1,
-  "description": "Machine-checked contract for files that must remain available through npm packaging and target-project initialization.",
-  "packageRequired": [
-    "AGENTS.md",
-    "CHANGELOG.md",
-    "README.md",
-    "harness.json",
-    "bin/loop-agent.js",
-    "docs/README.md",
-    "docs/init-surface.manifest.json",
-    "docs/architecture/runtime-boundaries.md",
-    "docs/skills/README.md",
-    "docs/skills/vetted-skill-registry.md",
-    "docs/templates/init-evolution-review.md",
-    "docs/templates/production-readiness-checklist.md",
-    "docs/templates/agent-dag.schema.json",
-    "examples/example-dag.json",
-    "skills/loop-agent/SKILL.md",
-    "skills/loop-agent/references/command-reference.md",
-    "skills/ai-engineering-context/SKILL.md",
-    "skills/verification-before-completion/SKILL.md",
-    "skills/systematic-debugging/SKILL.md",
-    "skills/requesting-code-review/SKILL.md",
-    "skills/codebase-scout/SKILL.md",
-    "skills/test-driven-development/SKILL.md",
-    "skills/code-review-core/SKILL.md",
-    "skills/init-capability-evolution/SKILL.md",
-    "skills/webapp-testing/SKILL.md"
-  ],
-  "initFullRequired": [
-    "README.md",
-    "AGENTS.md",
-    "harness.json",
-    "docs/README.md",
-    "docs/development-principles.md",
-    "docs/feature-workflow.md",
-    "docs/verification-matrix.md",
-    "docs/loop-agent-harness.md",
-    "docs/templates/init-evolution-review.md",
-    "docs/templates/production-readiness-checklist.md",
-    "scripts/check-repo.sh",
-    "scripts/ci-governance.sh",
-    "scripts/ci-tests.sh",
-    "scripts/ci.sh",
-    ".harness/prompts/analyze.md",
-    ".harness/tasks",
-    ".harness/dag-runs/active",
-    "skills/loop-agent/SKILL.md",
-    "skills/loop-agent/references/command-reference.md",
-    "skills/ai-engineering-context/SKILL.md",
-    "skills/verification-before-completion/SKILL.md",
-    "skills/systematic-debugging/SKILL.md",
-    "skills/requesting-code-review/SKILL.md",
-    "skills/codebase-scout/SKILL.md",
-    "skills/test-driven-development/SKILL.md",
-    "skills/code-review-core/SKILL.md",
-    "skills/init-capability-evolution/SKILL.md",
-    "skills/webapp-testing/SKILL.md"
-  ],
-  "initSurface": {
-    "README.md": "managed-block",
-    "AGENTS.md": "managed-block",
-    "harness.json": "generated",
-    "docs/README.md": "generated",
-    "docs/development-principles.md": "generated",
-    "docs/feature-workflow.md": "generated",
-    "docs/verification-matrix.md": "generated",
-    "docs/loop-agent-harness.md": "generated",
-    "docs/templates/init-evolution-review.md": "copied",
-    "docs/templates/production-readiness-checklist.md": "copied",
-    "scripts/check-repo.sh": "generated",
-    "scripts/ci-governance.sh": "generated",
-    "scripts/ci-tests.sh": "generated",
-    "scripts/ci.sh": "generated",
-    ".harness/prompts/analyze.md": "generated",
-    ".harness/tasks": "directory",
-    ".harness/dag-runs/active": "directory",
-    ".harness/init-surface.json": "state",
-    "skills/loop-agent/SKILL.md": "copied",
-    "skills/loop-agent/references/command-reference.md": "copied",
-    "skills/ai-engineering-context/SKILL.md": "copied",
-    "skills/verification-before-completion/SKILL.md": "copied",
-    "skills/systematic-debugging/SKILL.md": "copied",
-    "skills/requesting-code-review/SKILL.md": "copied",
-    "skills/codebase-scout/SKILL.md": "copied",
-    "skills/test-driven-development/SKILL.md": "copied",
-    "skills/code-review-core/SKILL.md": "copied",
-    "skills/init-capability-evolution/SKILL.md": "copied",
-    "skills/webapp-testing/SKILL.md": "copied"
-  },
-  "packageExcluded": [
-    "docs/progress/20*.md",
-    "docs/reports/20*.md",
-    "docs/exec-plans/active/20*.md",
-    "docs/exec-plans/completed/20*.md"
-  ],
-  "initExcluded": [
-    "examples/example-dag.json",
-    "docs/skills/vetted-skill-registry.md"
-  ],
-  "reviewTriggers": [
-    "AGENTS.md",
-    "README.md",
-    "CHANGELOG.md",
-    "harness.json",
-    "package.json",
-    "src/commands/init.ts",
-    "src/workflows/dag/skills.ts",
-    "src/workflows/dag/init-hybrid.ts",
-    "src/workflows/dag/skill-instructions.ts",
-    "docs/templates/**",
-    "docs/skills/**",
-    "skills/**",
-    "scripts/**"
-  ],
-  "evolutionReview": {
-    "defaultMode": "advisory",
-    "strictReportGlob": "docs/reports/*-init-evolution-review.md",
-    "tiers": [
-      {
-        "name": "model-review",
-        "severity": "high",
-        "strictRequiresReport": true,
-        "description": "Changes that may alter target-project initialization behavior, default DAG role skills, skill resolution, or package/init contracts.",
-        "patterns": [
-          "src/commands/init.ts",
-          "src/workflows/dag/skills.ts",
-          "src/workflows/dag/init-hybrid.ts",
-          "src/workflows/dag/skill-instructions.ts",
-          "src/workflows/dag/prompt.ts",
-          "src/workflows/dag/node-execution.ts",
-          "docs/init-surface.manifest.json",
-          "package.json",
-          "harness.json",
-          "AGENTS.md",
-          "README.md"
-        ]
-      },
-      {
-        "name": "surface-check",
-        "severity": "medium",
-        "strictRequiresReport": false,
-        "description": "Asset surface changes that usually need deterministic package/init smoke checks but not a model review when the checks pass.",
-        "patterns": [
-          "skills/**",
-          "docs/templates/**",
-          "docs/skills/**",
-          "scripts/check-init-surface.sh",
-          "scripts/check-repo.sh"
-        ]
-      },
-      {
-        "name": "advisory",
-        "severity": "low",
-        "strictRequiresReport": false,
-        "description": "Documentation and user-facing guidance changes that should be considered but should not slow normal iteration.",
-        "patterns": [
-          "CHANGELOG.md",
-          "website/docs/**",
-          "docs/*.md",
-          "docs/architecture/**"
-        ]
-      }
-    ],
-    "modelReviewQuestions": [
-      "Does this change alter files or guidance produced by loop-agent init --profile full --merge?",
-      "Does a new or changed skill need to be bundled, projected to target projects, or documented as optional only?",
-      "Do target-project AGENTS.md, README managed blocks, governance docs, templates, or script matrix need updates?",
-      "Does package.json files include every static asset required by the runtime and init projection?",
-      "Does docs/init-surface.manifest.json still match the intended package and init surface?",
-      "Do older initialized target projects need a migration note, manual copy guidance, or future init audit/update support?"
-    ]
-  }
-}
+{
+  "version": 1,
+  "description": "Machine-checked contract for files that must remain available through npm packaging and target-project initialization.",
+  "packageRequired": [
+    "AGENTS.md",
+    "CHANGELOG.md",
+    "README.md",
+    "harness.json",
+    "bin/loop-agent.js",
+    "docs/README.md",
+    "docs/init-surface.manifest.json",
+    "docs/architecture/runtime-boundaries.md",
+    "docs/skills/README.md",
+    "docs/skills/vetted-skill-registry.md",
+    "docs/templates/init-evolution-review.md",
+    "docs/templates/production-readiness-checklist.md",
+    "docs/templates/agent-dag.schema.json",
+    "examples/example-dag.json",
+    "skills/loop-agent/SKILL.md",
+    "skills/loop-agent/references/command-reference.md",
+    "skills/ai-engineering-context/SKILL.md",
+    "skills/verification-before-completion/SKILL.md",
+    "skills/systematic-debugging/SKILL.md",
+    "skills/requesting-code-review/SKILL.md",
+    "skills/codebase-scout/SKILL.md",
+    "skills/test-driven-development/SKILL.md",
+    "skills/code-review-core/SKILL.md",
+    "skills/init-capability-evolution/SKILL.md",
+    "skills/webapp-testing/SKILL.md"
+  ],
+  "initFullRequired": [
+    "README.md",
+    "AGENTS.md",
+    ".gitignore",
+    "harness.json",
+    "docs/README.md",
+    "docs/development-principles.md",
+    "docs/feature-workflow.md",
+    "docs/verification-matrix.md",
+    "docs/loop-agent-harness.md",
+    "docs/templates/init-evolution-review.md",
+    "docs/templates/production-readiness-checklist.md",
+    "scripts/check-repo.sh",
+    "scripts/ci-governance.sh",
+    "scripts/ci-tests.sh",
+    "scripts/ci.sh",
+    ".harness/prompts/analyze.md",
+    ".harness/tasks",
+    ".harness/dag-runs/active",
+    "skills/loop-agent/SKILL.md",
+    "skills/loop-agent/references/command-reference.md",
+    "skills/ai-engineering-context/SKILL.md",
+    "skills/verification-before-completion/SKILL.md",
+    "skills/systematic-debugging/SKILL.md",
+    "skills/requesting-code-review/SKILL.md",
+    "skills/codebase-scout/SKILL.md",
+    "skills/test-driven-development/SKILL.md",
+    "skills/code-review-core/SKILL.md",
+    "skills/init-capability-evolution/SKILL.md",
+    "skills/webapp-testing/SKILL.md",
+    ".agents/skills/loop-agent/SKILL.md",
+    ".agents/skills/loop-agent/references/command-reference.md",
+    ".agents/skills/ai-engineering-context/SKILL.md",
+    ".agents/skills/verification-before-completion/SKILL.md",
+    ".agents/skills/systematic-debugging/SKILL.md",
+    ".agents/skills/requesting-code-review/SKILL.md",
+    ".agents/skills/codebase-scout/SKILL.md",
+    ".agents/skills/test-driven-development/SKILL.md",
+    ".agents/skills/code-review-core/SKILL.md",
+    ".agents/skills/init-capability-evolution/SKILL.md",
+    ".agents/skills/webapp-testing/SKILL.md"
+  ],
+  "initSurface": {
+    "README.md": "managed-block",
+    "AGENTS.md": "managed-block",
+    ".gitignore": "managed-block",
+    "harness.json": "generated",
+    "docs/README.md": "generated",
+    "docs/development-principles.md": "generated",
+    "docs/feature-workflow.md": "generated",
+    "docs/verification-matrix.md": "generated",
+    "docs/loop-agent-harness.md": "generated",
+    "docs/templates/init-evolution-review.md": "copied",
+    "docs/templates/production-readiness-checklist.md": "copied",
+    "scripts/check-repo.sh": "generated",
+    "scripts/ci-governance.sh": "generated",
+    "scripts/ci-tests.sh": "generated",
+    "scripts/ci.sh": "generated",
+    ".harness/prompts/analyze.md": "generated",
+    ".harness/tasks": "directory",
+    ".harness/dag-runs/active": "directory",
+    ".harness/init-surface.json": "state",
+    "skills/loop-agent/SKILL.md": "copied",
+    "skills/loop-agent/references/command-reference.md": "copied",
+    "skills/ai-engineering-context/SKILL.md": "copied",
+    "skills/verification-before-completion/SKILL.md": "copied",
+    "skills/systematic-debugging/SKILL.md": "copied",
+    "skills/requesting-code-review/SKILL.md": "copied",
+    "skills/codebase-scout/SKILL.md": "copied",
+    "skills/test-driven-development/SKILL.md": "copied",
+    "skills/code-review-core/SKILL.md": "copied",
+    "skills/init-capability-evolution/SKILL.md": "copied",
+    "skills/webapp-testing/SKILL.md": "copied",
+    ".agents/skills/loop-agent/SKILL.md": "copied",
+    ".agents/skills/loop-agent/references/command-reference.md": "copied",
+    ".agents/skills/ai-engineering-context/SKILL.md": "copied",
+    ".agents/skills/verification-before-completion/SKILL.md": "copied",
+    ".agents/skills/systematic-debugging/SKILL.md": "copied",
+    ".agents/skills/requesting-code-review/SKILL.md": "copied",
+    ".agents/skills/codebase-scout/SKILL.md": "copied",
+    ".agents/skills/test-driven-development/SKILL.md": "copied",
+    ".agents/skills/code-review-core/SKILL.md": "copied",
+    ".agents/skills/init-capability-evolution/SKILL.md": "copied",
+    ".agents/skills/webapp-testing/SKILL.md": "copied"
+  },
+  "packageExcluded": [
+    "docs/progress/20*.md",
+    "docs/reports/20*.md",
+    "docs/exec-plans/active/20*.md",
+    "docs/exec-plans/completed/20*.md"
+  ],
+  "initExcluded": [
+    "examples/example-dag.json",
+    "docs/skills/vetted-skill-registry.md"
+  ],
+  "reviewTriggers": [
+    "AGENTS.md",
+    "README.md",
+    "CHANGELOG.md",
+    "harness.json",
+    "package.json",
+    "src/commands/init.ts",
+    "src/workflows/dag/skills.ts",
+    "src/workflows/dag/init-hybrid.ts",
+    "src/workflows/dag/skill-instructions.ts",
+    "docs/templates/**",
+    "docs/skills/**",
+    "skills/**",
+    "scripts/**"
+  ],
+  "evolutionReview": {
+    "defaultMode": "advisory",
+    "strictReportGlob": "docs/reports/*-init-evolution-review.md",
+    "tiers": [
+      {
+        "name": "model-review",
+        "severity": "high",
+        "strictRequiresReport": true,
+        "description": "Changes that may alter target-project initialization behavior, default DAG role skills, skill resolution, or package/init contracts.",
+        "patterns": [
+          "src/commands/init.ts",
+          "src/workflows/dag/skills.ts",
+          "src/workflows/dag/init-hybrid.ts",
+          "src/workflows/dag/skill-instructions.ts",
+          "src/workflows/dag/prompt.ts",
+          "src/workflows/dag/node-execution.ts",
+          "docs/init-surface.manifest.json",
+          "package.json",
+          "harness.json",
+          "AGENTS.md",
+          "README.md"
+        ]
+      },
+      {
+        "name": "surface-check",
+        "severity": "medium",
+        "strictRequiresReport": false,
+        "description": "Asset surface changes that usually need deterministic package/init smoke checks but not a model review when the checks pass.",
+        "patterns": [
+          "skills/**",
+          "docs/templates/**",
+          "docs/skills/**",
+          "scripts/check-init-surface.sh",
+          "scripts/check-repo.sh"
+        ]
+      },
+      {
+        "name": "advisory",
+        "severity": "low",
+        "strictRequiresReport": false,
+        "description": "Documentation and user-facing guidance changes that should be considered but should not slow normal iteration.",
+        "patterns": [
+          "CHANGELOG.md",
+          "website/docs/**",
+          "docs/*.md",
+          "docs/architecture/**"
+        ]
+      }
+    ],
+    "modelReviewQuestions": [
+      "Does this change alter files or guidance produced by loop-agent init --profile full --merge?",
+      "Does a new or changed skill need to be bundled, projected to target projects, or documented as optional only?",
+      "Do target-project AGENTS.md, README managed blocks, governance docs, templates, or script matrix need updates?",
+      "Does package.json files include every static asset required by the runtime and init projection?",
+      "Does docs/init-surface.manifest.json still match the intended package and init surface?",
+      "Do older initialized target projects need a migration note, manual copy guidance, or future init audit/update support?"
+    ]
+  }
+}

package/docs/skills/vetted-skill-registry.md

@@ -12,10 +12,10 @@ The entries below are local wrappers or existing local skills. They are not whol
 | `systematic-debugging` | local wrapper inspired by systematic debugging discipline | `skills/systematic-debugging/SKILL.md` | implementer, verifier | verifier | Advisory prompt guidance only; does not run tools by itself. |
 | `requesting-code-review` | local existing | `skills/requesting-code-review/SKILL.md` | reviewer | reviewer | Review prompt guidance only. |
 | `test-driven-development` | local wrapper inspired by TDD practice | `skills/test-driven-development/SKILL.md` | implementer | implementer | Does not force tests in mechanical-only docs changes; implementer still follows task contract. |
-| `code-review-core` | local wrapper inspired by code review practice | `skills/code-review-core/SKILL.md` | reviewer | reviewer | No external tools or network by default. |
-| `codebase-scout` | local wrapper | `skills/codebase-scout/SKILL.md` | scout | scout | Read-only reconnaissance guidance. |
-| `init-capability-evolution` | local wrapper | `skills/init-capability-evolution/SKILL.md` | supervisor, maintenance | optional | Used only when changes may affect target-project initialization, package surface, or init projection rules. |
-| `webapp-testing` | local wrapper inspired by frontend/browser testing practice | `skills/webapp-testing/SKILL.md` | verifier, reviewer | optional | Only applies when task explicitly involves browser-rendered behavior; no default Playwright/Semgrep execution. |
+| `code-review-core` | local wrapper inspired by code review practice | `skills/code-review-core/SKILL.md` | reviewer | reviewer | No external tools or network by default. |
+| `codebase-scout` | local wrapper | `skills/codebase-scout/SKILL.md` | scout | scout | Read-only reconnaissance guidance. |
+| `init-capability-evolution` | local wrapper | `skills/init-capability-evolution/SKILL.md` | supervisor, maintenance | optional | Used only when changes may affect target-project initialization, package surface, or init projection rules. |
+| `webapp-testing` | local wrapper inspired by frontend/browser testing practice | `skills/webapp-testing/SKILL.md` | verifier, reviewer | optional | Only applies when task explicitly involves browser-rendered behavior; no default Playwright/Semgrep execution. |
 
 ## Vetting Rules
 

package/docs/templates/agent-dag.base.json

@@ -60,7 +60,7 @@
     "cursor": {
       "LOW": "composer-2.5",
       "MED": "composer-2.5",
-      "HIGH": "composer-2.5"
+      "HIGH": "gpt-5.5"
     },
     "pi": {
       "LOW": "gpt-5.3-codex-spark",

package/docs/templates/agent-dag.final-verification.json

@@ -28,7 +28,7 @@
     "cursor": {
       "LOW": "composer-2.5",
       "MED": "composer-2.5",
-      "HIGH": "composer-2.5"
+      "HIGH": "gpt-5.5"
     },
     "pi": {
       "LOW": "gpt-5.3-codex-spark",

package/docs/templates/agent-dag.supervised-implementation.json

@@ -76,7 +76,7 @@
     "cursor": {
       "LOW": "composer-2.5",
       "MED": "composer-2.5",
-      "HIGH": "composer-2.5"
+      "HIGH": "gpt-5.5"
     },
     "pi": {
       "LOW": "gpt-5.3-codex-spark",

package/docs/templates/hybrid-dag.json

@@ -56,7 +56,7 @@
     "cursor": {
       "LOW": "composer-2.5",
       "MED": "composer-2.5",
-      "HIGH": "composer-2.5"
+      "HIGH": "gpt-5.5"
     },
     "pi": {
       "LOW": "gpt-5.3-codex-spark",

package/docs/templates/init-evolution-review.md

@@ -1,33 +1,33 @@
-# Init Evolution Review
-
-Date:
-Base:
-Head:
-
-## Changed Surface
-
-- 
-
-## Decision
-
-Choose one:
-
-- No init impact
-- Surface check only
-- Init update required
-
-Rationale:
-
-## Updates Made
-
-- 
-
-## Verification
-
-```bash
-# commands and results
-```
-
-## Residual Risk
-
-- 
+# Init Evolution Review
+
+Date:
+Base:
+Head:
+
+## Changed Surface
+
+- 
+
+## Decision
+
+Choose one:
+
+- No init impact
+- Surface check only
+- Init update required
+
+Rationale:
+
+## Updates Made
+
+- 
+
+## Verification
+
+```bash
+# commands and results
+```
+
+## Residual Risk
+
+- 

package/examples/example-dag.json

@@ -5,7 +5,7 @@
     "cursor": {
       "LOW": "composer-2.5",
       "MED": "composer-2.5",
-      "HIGH": "composer-2.5"
+      "HIGH": "gpt-5.5"
     },
     "pi": {
       "LOW": "gpt-5.3-codex-spark",

package/examples/hybrid-loop-agent-dag.json

@@ -57,7 +57,7 @@
     "cursor": {
       "LOW": "composer-2.5",
       "MED": "composer-2.5",
-      "HIGH": "composer-2.5"
+      "HIGH": "gpt-5.5"
     },
     "pi": {
       "LOW": "gpt-5.3-codex-spark",

package/harness.json

@@ -46,43 +46,18 @@
     "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
-    }
+    "checkHarnessRuntimeClean": "scripts/check-harness-runtime-clean.sh",
+    "checkInitEvolutionNeeded": "scripts/check-init-evolution-needed.sh",
+    "checkInitSurface": "scripts/check-init-surface.sh",
+    "ci": "scripts/ci.sh"
   },
   "executors": {
     "pi": {
       "description": "Pi planning, review, diagnosis, and bounded writing when DAG toolProfile=write",
       "defaultModel": "gpt-5.3-codex-spark",
-      "requiresApiKey": ""
+      "LOW": "gpt-5.3-codex-spark",
+      "MED": "glm-5.2",
+      "HIGH": "gpt-5.5"
     },
     "cursor": {
       "description": "Cursor via @cursor/sdk (default model: account default)",

package/package.json

@@ -1,9 +1,10 @@
 {
   "name": "@tea-agent/loop-agent",
-  "version": "0.3.0",
+  "version": "0.5.0",
   "type": "module",
   "bin": {
-    "loop-agent": "bin/loop-agent.js"
+    "loop-agent": "bin/loop-agent.js",
+    "agent-worker": "bin/agent-worker.js"
   },
   "files": [
     "AGENTS.md",
@@ -15,12 +16,12 @@
     "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/",
+    "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/",
@@ -48,17 +49,18 @@
   },
   "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": "*"
+    "@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",
-    "@types/node": "^24.6.0"
+    "vitest": "^3.2.4"
   }
 }