@tea-agent/loop-agent 0.25.6 → 0.26.0

package/docs/templates/knowledge-sync-dag.json

@@ -1,178 +1,178 @@
-{
-  "$schema": "./agent-dag.schema.json",
-  "version": 2,
-  "title": "Knowledge-sync DAG template",
-  "objective": "After final verification, draft and apply stable testing knowledge: acceptance verdict, cases, coverage, defects, requirement delta pointers, and run audit records under features/*/testing/**.",
-  "successCriteria": [
-    "knowledge-sync-collect-pi inventories final verification evidence, ACs, cases, and defect candidates without writing files",
-    "knowledge-sync-draft-pi writes schemaVersion 1 knowledge-sync-draft.json under features/<feature-id>/testing/sync/pending/",
-    "knowledge-sync-validate-shell fails closed on missing draft, invalid schema, or non-pass finalVerification when gated",
-    "multi-perspective review (qa/domain/evidence) each emit VERDICT; aggregate gate requires all pass before apply",
-    "knowledge-sync-apply-pi upserts acceptance-verdict, coverage-matrix, cases, automation-map, and defects only within writeSet",
-    "knowledge-sync-pointer-pi writes runs/latest.md and sync/applied/KS-*.json audit pointers",
-    "No writes to src/**, .harness/**, or knowledge/testing/standards/**"
-  ],
-  "globalConstraints": [
-    "Replace feature-id placeholders with the concrete Feature id before production runs.",
-    "Do not commit runtime traces under .harness/dag-runs/.",
-    "Use only existing executors: pi, shell. Pi writer nodes must set toolProfile=write.",
-    "Read-only nodes must not write repository files.",
-    "Exclusive writer nodes must stay within declared writeSet.",
-    "Final verification shell evidence remains completion authority; knowledge-sync stores stable facts and path pointers only.",
-    "High-risk requirement/acceptance body changes require human approval via requirement-delta; do not silently rewrite requirement.md.",
-    "Prefer structured YAML/Markdown L1 knowledge pack over vector-store-only writes."
-  ],
-  "defaults": {
-    "executor": "pi",
-    "contextProfile": "slim",
-    "skills": [
-      "ai-engineering-context"
-    ],
-    "writePolicy": "read-only"
-  },
-  "skillsByRole": {
-    "planner": [
-      "loop-agent"
-    ],
-    "implementer": [
-      "verification-before-completion"
-    ],
-    "reviewer": [
-      "requesting-code-review"
-    ],
-    "verifier": [
-      "verification-before-completion",
-      "systematic-debugging"
-    ],
-    "closeout": [
-      "loop-agent",
-      "verification-before-completion"
-    ]
-  },
-  "tasks": [
-    {
-      "id": "knowledge-sync-collect-pi",
-      "depends_on": [],
-      "role": "planner",
-      "executor": "pi",
-      "complexity": "MED",
-      "writePolicy": "read-only",
-      "allowedPaths": [
-        "./**",
-        "docs/**",
-        "features/**"
-      ],
-      "forbiddenPaths": [
-        ".harness/**",
-        "artifacts/**"
-      ],
-      "outputContract": "Plain Markdown inventory of evidence and knowledge-sync candidates; no file writes.",
-      "subtask_prompt": "Collect final-verification evidence, AC list, cases, defects, and requirement-delta candidates. Read-only."
-    },
-    {
-      "id": "knowledge-sync-draft-pi",
-      "depends_on": [
-        "knowledge-sync-collect-pi"
-      ],
-      "role": "implementer",
-      "executor": "pi",
-      "toolProfile": "write",
-      "complexity": "HIGH",
-      "writePolicy": "exclusive",
-      "writeSet": [
-        "features/**/testing/sync/pending/**"
-      ],
-      "allowedPaths": [
-        "features/**/testing/sync/pending/**"
-      ],
-      "forbiddenPaths": [
-        ".harness/**",
-        "artifacts/**",
-        "src/**"
-      ],
-      "outputContract": "Pending knowledge-sync-draft.json + markdown summary under features/<feature-id>/testing/sync/pending/.",
-      "subtask_prompt": "Write schemaVersion 1 draft with operations, payload, and gates. Stay within writeSet."
-    },
-    {
-      "id": "knowledge-sync-validate-shell",
-      "depends_on": [
-        "knowledge-sync-draft-pi"
-      ],
-      "role": "verifier",
-      "executor": "shell",
-      "complexity": "LOW",
-      "writePolicy": "read-only",
-      "allowedPaths": [
-        "features/**"
-      ],
-      "forbiddenPaths": [
-        ".harness/**",
-        "artifacts/**"
-      ],
-      "outputContract": "Deterministic draft schema validation; exit non-zero on invalid draft.",
-      "subtask_prompt": "Validate pending knowledge-sync-draft.json files.",
-      "shell": {
-        "commands": [
-          "node -e \"const fs=require('fs');const path=require('path');function walk(d,a=[]){if(!fs.existsSync(d))return a;for(const e of fs.readdirSync(d,{withFileTypes:true})){const p=path.join(d,e.name);if(e.isDirectory())walk(p,a);else if(e.name==='knowledge-sync-draft.json')a.push(p);}return a;}const drafts=walk('features');if(!drafts.length){console.error('no draft');process.exit(1);}for(const f of drafts){const d=JSON.parse(fs.readFileSync(f,'utf8'));if(d.schemaVersion!==1)process.exit(1);}console.log('ok');\""
-        ],
-        "cwd": ".",
-        "timeoutMs": 120000
-      }
-    },
-    {
-      "id": "knowledge-sync-apply-pi",
-      "depends_on": [
-        "knowledge-sync-validate-shell"
-      ],
-      "role": "implementer",
-      "executor": "pi",
-      "toolProfile": "write",
-      "complexity": "HIGH",
-      "writePolicy": "exclusive",
-      "writeSet": [
-        "features/**/testing/**",
-        "features/**/requirement-delta.md",
-        "docs/test-reports/**"
-      ],
-      "allowedPaths": [
-        "features/**/testing/**",
-        "features/**/requirement-delta.md",
-        "docs/test-reports/**"
-      ],
-      "forbiddenPaths": [
-        ".harness/**",
-        "artifacts/**",
-        "src/**",
-        "knowledge/testing/standards/**"
-      ],
-      "outputContract": "Applied L1 knowledge files: acceptance-verdict, coverage-matrix, cases, defects, optional requirement-delta.",
-      "subtask_prompt": "Apply validated draft into Feature testing knowledge paths. Do not touch standards or src."
-    },
-    {
-      "id": "knowledge-sync-pointer-pi",
-      "depends_on": [
-        "knowledge-sync-apply-pi"
-      ],
-      "role": "closeout",
-      "executor": "pi",
-      "toolProfile": "write",
-      "complexity": "MED",
-      "writePolicy": "exclusive",
-      "writeSet": [
-        "features/**/testing/runs/**",
-        "features/**/testing/sync/applied/**"
-      ],
-      "allowedPaths": [
-        "features/**/testing/runs/**",
-        "features/**/testing/sync/applied/**"
-      ],
-      "forbiddenPaths": [
-        ".harness/**",
-        "artifacts/**",
-        "src/**"
-      ],
-      "outputContract": "runs/latest.md and sync/applied/KS-*.json audit pointers.",
-      "subtask_prompt": "Write run pointers and applied audit record only."
-    }
-  ]
-}
+{
+  "$schema": "./agent-dag.schema.json",
+  "version": 2,
+  "title": "Knowledge-sync DAG template",
+  "objective": "After final verification, draft and apply stable testing knowledge: acceptance verdict, cases, coverage, defects, requirement delta pointers, and run audit records under features/*/testing/**.",
+  "successCriteria": [
+    "knowledge-sync-collect-pi inventories final verification evidence, ACs, cases, and defect candidates without writing files",
+    "knowledge-sync-draft-pi writes schemaVersion 1 knowledge-sync-draft.json under features/<feature-id>/testing/sync/pending/",
+    "knowledge-sync-validate-shell fails closed on missing draft, invalid schema, or non-pass finalVerification when gated",
+    "multi-perspective review (qa/domain/evidence) each emit VERDICT; aggregate gate requires all pass before apply",
+    "knowledge-sync-apply-pi upserts acceptance-verdict, coverage-matrix, cases, automation-map, and defects only within writeSet",
+    "knowledge-sync-pointer-pi writes runs/latest.md and sync/applied/KS-*.json audit pointers",
+    "No writes to src/**, .harness/**, or knowledge/testing/standards/**"
+  ],
+  "globalConstraints": [
+    "Replace feature-id placeholders with the concrete Feature id before production runs.",
+    "Do not commit runtime traces under .harness/dag-runs/.",
+    "Use only existing executors: pi, shell. Pi writer nodes must set toolProfile=write.",
+    "Read-only nodes must not write repository files.",
+    "Exclusive writer nodes must stay within declared writeSet.",
+    "Final verification shell evidence remains completion authority; knowledge-sync stores stable facts and path pointers only.",
+    "High-risk requirement/acceptance body changes require human approval via requirement-delta; do not silently rewrite requirement.md.",
+    "Prefer structured YAML/Markdown L1 knowledge pack over vector-store-only writes."
+  ],
+  "defaults": {
+    "executor": "pi",
+    "contextProfile": "slim",
+    "skills": [
+      "ai-engineering-context"
+    ],
+    "writePolicy": "read-only"
+  },
+  "skillsByRole": {
+    "planner": [
+      "loop-agent"
+    ],
+    "implementer": [
+      "verification-before-completion"
+    ],
+    "reviewer": [
+      "requesting-code-review"
+    ],
+    "verifier": [
+      "verification-before-completion",
+      "systematic-debugging"
+    ],
+    "closeout": [
+      "loop-agent",
+      "verification-before-completion"
+    ]
+  },
+  "tasks": [
+    {
+      "id": "knowledge-sync-collect-pi",
+      "depends_on": [],
+      "role": "planner",
+      "executor": "pi",
+      "complexity": "MED",
+      "writePolicy": "read-only",
+      "allowedPaths": [
+        "./**",
+        "docs/**",
+        "features/**"
+      ],
+      "forbiddenPaths": [
+        ".harness/**",
+        "artifacts/**"
+      ],
+      "outputContract": "Plain Markdown inventory of evidence and knowledge-sync candidates; no file writes.",
+      "subtask_prompt": "Collect final-verification evidence, AC list, cases, defects, and requirement-delta candidates. Read-only."
+    },
+    {
+      "id": "knowledge-sync-draft-pi",
+      "depends_on": [
+        "knowledge-sync-collect-pi"
+      ],
+      "role": "implementer",
+      "executor": "pi",
+      "toolProfile": "write",
+      "complexity": "HIGH",
+      "writePolicy": "exclusive",
+      "writeSet": [
+        "features/**/testing/sync/pending/**"
+      ],
+      "allowedPaths": [
+        "features/**/testing/sync/pending/**"
+      ],
+      "forbiddenPaths": [
+        ".harness/**",
+        "artifacts/**",
+        "src/**"
+      ],
+      "outputContract": "Pending knowledge-sync-draft.json + markdown summary under features/<feature-id>/testing/sync/pending/.",
+      "subtask_prompt": "Write schemaVersion 1 draft with operations, payload, and gates. Stay within writeSet."
+    },
+    {
+      "id": "knowledge-sync-validate-shell",
+      "depends_on": [
+        "knowledge-sync-draft-pi"
+      ],
+      "role": "verifier",
+      "executor": "shell",
+      "complexity": "LOW",
+      "writePolicy": "read-only",
+      "allowedPaths": [
+        "features/**"
+      ],
+      "forbiddenPaths": [
+        ".harness/**",
+        "artifacts/**"
+      ],
+      "outputContract": "Deterministic draft schema validation; exit non-zero on invalid draft.",
+      "subtask_prompt": "Validate pending knowledge-sync-draft.json files.",
+      "shell": {
+        "commands": [
+          "node -e \"const fs=require('fs');const path=require('path');function walk(d,a=[]){if(!fs.existsSync(d))return a;for(const e of fs.readdirSync(d,{withFileTypes:true})){const p=path.join(d,e.name);if(e.isDirectory())walk(p,a);else if(e.name==='knowledge-sync-draft.json')a.push(p);}return a;}const drafts=walk('features');if(!drafts.length){console.error('no draft');process.exit(1);}for(const f of drafts){const d=JSON.parse(fs.readFileSync(f,'utf8'));if(d.schemaVersion!==1)process.exit(1);}console.log('ok');\""
+        ],
+        "cwd": ".",
+        "timeoutMs": 120000
+      }
+    },
+    {
+      "id": "knowledge-sync-apply-pi",
+      "depends_on": [
+        "knowledge-sync-validate-shell"
+      ],
+      "role": "implementer",
+      "executor": "pi",
+      "toolProfile": "write",
+      "complexity": "HIGH",
+      "writePolicy": "exclusive",
+      "writeSet": [
+        "features/**/testing/**",
+        "features/**/requirement-delta.md",
+        "docs/test-reports/**"
+      ],
+      "allowedPaths": [
+        "features/**/testing/**",
+        "features/**/requirement-delta.md",
+        "docs/test-reports/**"
+      ],
+      "forbiddenPaths": [
+        ".harness/**",
+        "artifacts/**",
+        "src/**",
+        "knowledge/testing/standards/**"
+      ],
+      "outputContract": "Applied L1 knowledge files: acceptance-verdict, coverage-matrix, cases, defects, optional requirement-delta.",
+      "subtask_prompt": "Apply validated draft into Feature testing knowledge paths. Do not touch standards or src."
+    },
+    {
+      "id": "knowledge-sync-pointer-pi",
+      "depends_on": [
+        "knowledge-sync-apply-pi"
+      ],
+      "role": "closeout",
+      "executor": "pi",
+      "toolProfile": "write",
+      "complexity": "MED",
+      "writePolicy": "exclusive",
+      "writeSet": [
+        "features/**/testing/runs/**",
+        "features/**/testing/sync/applied/**"
+      ],
+      "allowedPaths": [
+        "features/**/testing/runs/**",
+        "features/**/testing/sync/applied/**"
+      ],
+      "forbiddenPaths": [
+        ".harness/**",
+        "artifacts/**",
+        "src/**"
+      ],
+      "outputContract": "runs/latest.md and sync/applied/KS-*.json audit pointers.",
+      "subtask_prompt": "Write run pointers and applied audit record only."
+    }
+  ]
+}

package/docs/templates/knowledge-sync-draft.schema.json

@@ -1,71 +1,71 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://loop-agent.local/schemas/knowledge-sync-draft.schema.json",
-  "title": "Knowledge Sync Draft",
-  "description": "Pending package written by knowledge-sync-draft-pi before validate/apply.",
-  "type": "object",
-  "additionalProperties": false,
-  "required": [
-    "schemaVersion",
-    "featureId",
-    "taskId",
-    "runId",
-    "finalVerification",
-    "operations",
-    "payload",
-    "gates"
-  ],
-  "properties": {
-    "schemaVersion": { "const": 1 },
-    "featureId": { "type": "string", "minLength": 1 },
-    "taskId": { "type": "string", "minLength": 1 },
-    "runId": { "type": "string", "minLength": 1 },
-    "headSha": { "type": "string" },
-    "finalVerification": {
-      "type": "string",
-      "enum": ["pass", "fail", "partial", "pass-with-waivers"]
-    },
-    "operations": {
-      "type": "array",
-      "minItems": 1,
-      "items": {
-        "type": "object",
-        "additionalProperties": false,
-        "required": ["op", "target", "risk", "reason"],
-        "properties": {
-          "op": { "type": "string", "enum": ["upsert", "create", "append"] },
-          "target": { "type": "string", "minLength": 1 },
-          "risk": { "type": "string", "enum": ["low", "medium", "high"] },
-          "reason": { "type": "string", "minLength": 1 }
-        }
-      }
-    },
-    "payload": {
-      "type": "object",
-      "additionalProperties": true,
-      "properties": {
-        "acceptanceVerdict": { "type": ["object", "null"] },
-        "coverageMatrix": { "type": ["object", "null"] },
-        "caseIndex": { "type": ["object", "null"] },
-        "automationMap": { "type": ["object", "null"] },
-        "defects": { "type": ["object", "null"] },
-        "requirementDelta": { "type": ["object", "string", "null"] },
-        "retrospectiveRef": { "type": ["string", "null"] },
-        "evidencePointers": {
-          "type": "array",
-          "items": { "type": "string" }
-        }
-      }
-    },
-    "gates": {
-      "type": "object",
-      "additionalProperties": false,
-      "required": ["requireHumanIfHighRisk", "blockIfFinalVerificationNotPass"],
-      "properties": {
-        "requireHumanIfHighRisk": { "type": "boolean" },
-        "blockIfFinalVerificationNotPass": { "type": "boolean" },
-        "blockIfCoverageP0Missing": { "type": "boolean" }
-      }
-    }
-  }
-}
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://loop-agent.local/schemas/knowledge-sync-draft.schema.json",
+  "title": "Knowledge Sync Draft",
+  "description": "Pending package written by knowledge-sync-draft-pi before validate/apply.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schemaVersion",
+    "featureId",
+    "taskId",
+    "runId",
+    "finalVerification",
+    "operations",
+    "payload",
+    "gates"
+  ],
+  "properties": {
+    "schemaVersion": { "const": 1 },
+    "featureId": { "type": "string", "minLength": 1 },
+    "taskId": { "type": "string", "minLength": 1 },
+    "runId": { "type": "string", "minLength": 1 },
+    "headSha": { "type": "string" },
+    "finalVerification": {
+      "type": "string",
+      "enum": ["pass", "fail", "partial", "pass-with-waivers"]
+    },
+    "operations": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["op", "target", "risk", "reason"],
+        "properties": {
+          "op": { "type": "string", "enum": ["upsert", "create", "append"] },
+          "target": { "type": "string", "minLength": 1 },
+          "risk": { "type": "string", "enum": ["low", "medium", "high"] },
+          "reason": { "type": "string", "minLength": 1 }
+        }
+      }
+    },
+    "payload": {
+      "type": "object",
+      "additionalProperties": true,
+      "properties": {
+        "acceptanceVerdict": { "type": ["object", "null"] },
+        "coverageMatrix": { "type": ["object", "null"] },
+        "caseIndex": { "type": ["object", "null"] },
+        "automationMap": { "type": ["object", "null"] },
+        "defects": { "type": ["object", "null"] },
+        "requirementDelta": { "type": ["object", "string", "null"] },
+        "retrospectiveRef": { "type": ["string", "null"] },
+        "evidencePointers": {
+          "type": "array",
+          "items": { "type": "string" }
+        }
+      }
+    },
+    "gates": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["requireHumanIfHighRisk", "blockIfFinalVerificationNotPass"],
+      "properties": {
+        "requireHumanIfHighRisk": { "type": "boolean" },
+        "blockIfFinalVerificationNotPass": { "type": "boolean" },
+        "blockIfCoverageP0Missing": { "type": "boolean" }
+      }
+    }
+  }
+}

package/docs/templates/product-line/closeout.yaml

@@ -1,9 +1,9 @@
-schema_version: 1
-feature_id: F-YYYY-NNN
-status: success
-qa_verdict: pass
-qa_evidence:
-  - <run-or-report-path>
-owner: <human owner>
-decided_at: <ISO-8601 timestamp>
-summary: <what shipped and why evidence is sufficient>
+schema_version: 1
+feature_id: F-YYYY-NNN
+status: success
+qa_verdict: pass
+qa_evidence:
+  - <run-or-report-path>
+owner: <human owner>
+decided_at: <ISO-8601 timestamp>
+summary: <what shipped and why evidence is sufficient>

package/docs/templates/product-line/design.md

@@ -1,13 +1,13 @@
-# Design — <Feature title>
-
-## Context and boundaries
-
-Describe existing components, public contracts, trust boundaries, and protected areas.
-
-## Proposed change
-
-Describe the smallest end-to-end path and its failure behavior.
-
-## Decisions and alternatives
-
-Record material trade-offs and link ADRs where needed.
+# Design — <Feature title>
+
+## Context and boundaries
+
+Describe existing components, public contracts, trust boundaries, and protected areas.
+
+## Proposed change
+
+Describe the smallest end-to-end path and its failure behavior.
+
+## Decisions and alternatives
+
+Record material trade-offs and link ADRs where needed.

package/docs/templates/product-line/links.md

@@ -1,10 +1,10 @@
-# Traceability links
-
-| Relationship | Link or ID |
-|---|---|
-| Feature | `F-YYYY-NNN` |
-| Acceptance → tests | `AC-FEATURE-001` → `TC-001` |
-| Acceptance → tasks | `AC-FEATURE-001` → `BE-001`, `QA-001` |
-| Task → worker/DAG run | `<workerRunId>` / `<dagRunId>` |
-| Change/MR/PR | `<link>` |
-| QA evidence | `<artifact path or link>` |
+# Traceability links
+
+| Relationship | Link or ID |
+|---|---|
+| Feature | `F-YYYY-NNN` |
+| Acceptance → tests | `AC-FEATURE-001` → `TC-001` |
+| Acceptance → tasks | `AC-FEATURE-001` → `BE-001`, `QA-001` |
+| Task → worker/DAG run | `<workerRunId>` / `<dagRunId>` |
+| Change/MR/PR | `<link>` |
+| QA evidence | `<artifact path or link>` |

package/docs/templates/product-line/requirement.md

@@ -1,17 +1,17 @@
-# <Feature title>
-
-- Feature ID: `<F-YYYY-NNN>`
-- Owner: `<human owner>`
-- Outcome: `<user or business outcome>`
-
-## In scope
-
-- `<observable capability>`
-
-## Out of scope
-
-- `<explicit non-goal>`
-
-## Constraints
-
-- `<security, compatibility, cost, or operational boundary>`
+# <Feature title>
+
+- Feature ID: `<F-YYYY-NNN>`
+- Owner: `<human owner>`
+- Outcome: `<user or business outcome>`
+
+## In scope
+
+- `<observable capability>`
+
+## Out of scope
+
+- `<explicit non-goal>`
+
+## Constraints
+
+- `<security, compatibility, cost, or operational boundary>`

package/docs/templates/product-line/test-plan.md

@@ -1,7 +1,7 @@
-# Test plan — <Feature title>
-
-| Test ID | Acceptance | Level | Scenario | Deterministic command |
-|---|---|---|---|---|
-| TC-001 | AC-FEATURE-001 | integration | happy path and primary failure | `<project-specific command>` |
-
-Include negative cases, regression scope, environment assumptions, and evidence locations. Commands must match the target project's real toolchain.
+# Test plan — <Feature title>
+
+| Test ID | Acceptance | Level | Scenario | Deterministic command |
+|---|---|---|---|---|
+| TC-001 | AC-FEATURE-001 | integration | happy path and primary failure | `<project-specific command>` |
+
+Include negative cases, regression scope, environment assumptions, and evidence locations. Commands must match the target project's real toolchain.