@tea-agent/loop-agent 0.35.0 → 0.35.1-beta.0

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.

package/docs/templates/project-start-checklist.md

@@ -1,9 +1,9 @@
-# 项目开工检查清单
-
-- [ ] 确认 `pwd`
-- [ ] 阅读 `README.md`、`harness.json`，以及 `harness.json.governanceRoot` 指向的 `README.md`
-- [ ] 检查 `git status --short --branch`
-- [ ] 确定单一工作块
-- [ ] 从治理根目录下的 `verification-matrix.md` 选择验证命令
-- [ ] 保留无关用户变更
-- [ ] 非平凡工作时记录 handoff 证据
+# 项目开工检查清单
+
+- [ ] 确认 `pwd`
+- [ ] 阅读 `README.md`、`harness.json`，以及 `harness.json.governanceRoot` 指向的 `README.md`
+- [ ] 检查 `git status --short --branch`
+- [ ] 确定单一工作块
+- [ ] 从治理根目录下的 `verification-matrix.md` 选择验证命令
+- [ ] 保留无关用户变更
+- [ ] 非平凡工作时记录 handoff 证据

package/docs/templates/qa-report.md

@@ -1,48 +1,48 @@
-# QA 报告模板
-
-## 日期 / 会话
-
-## 测试范围
-
-## 相关 Contract / Plan
-
-## 测试方法
-
-- 自动化测试：
-- 构建 / 类型检查：
-- Smoke / 手工路径：
-- 其他证据：
-
-## Smoke / 手工检查
-
-- CLI smoke：
-- DAG smoke：
-- Loop workflow smoke：
-- Executor smoke：
-- 结果：pass / blocked / fail
-
-## 通过标准
-
-## 发现项
-
-| ID | Severity | Finding | Evidence | Suggested Fix |
-|----|----------|---------|----------|---------------|
-
-## Failure Routing
-
-| Run / Scenario | Raw Failure | DAG Normalized Category | Product-line Category | Recommended Follow-up | Evidence |
-|---|---|---|---|---|---|
-|  |  |  |  |  |  |
-
-## 新发现的 Bug / 漂移
-
-- 新发现 bug：
-- 发现的契约漂移：
-- 发现的文档/测试不一致：
-
-## 最终结论
-
-- 结论：pass / partial / fail
-- 结论依据：
-
-## 后续项
+# QA 报告模板
+
+## 日期 / 会话
+
+## 测试范围
+
+## 相关 Contract / Plan
+
+## 测试方法
+
+- 自动化测试：
+- 构建 / 类型检查：
+- Smoke / 手工路径：
+- 其他证据：
+
+## Smoke / 手工检查
+
+- CLI smoke：
+- DAG smoke：
+- Loop workflow smoke：
+- Executor smoke：
+- 结果：pass / blocked / fail
+
+## 通过标准
+
+## 发现项
+
+| ID | Severity | Finding | Evidence | Suggested Fix |
+|----|----------|---------|----------|---------------|
+
+## Failure Routing
+
+| Run / Scenario | Raw Failure | DAG Normalized Category | Product-line Category | Recommended Follow-up | Evidence |
+|---|---|---|---|---|---|
+|  |  |  |  |  |  |
+
+## 新发现的 Bug / 漂移
+
+- 新发现 bug：
+- 发现的契约漂移：
+- 发现的文档/测试不一致：
+
+## 最终结论
+
+- 结论：pass / partial / fail
+- 结论依据：
+
+## 后续项

package/docs/templates/sprint-contract.md

@@ -1,29 +1,29 @@
-# Sprint Contract
-
-## 目标（Objective）
-
-描述有边界的工作块。
-
-## 交付物（Deliverables）
-
-- 
-
-## 非目标（Non-goals）
-
-- 
-
-## 验证（Verification）
-
-```bash
-bash scripts/check-repo.sh
-npm run typecheck
-npm test
-```
-
-Windows 上通过 Git Bash 或已配置的兼容 Bash 运行脚本。实际文件操作用平台原生路径。
-
-## 失败条件（Failure Conditions）
-
-- 必需验证无法运行或失败
-- 工作需要超出本 contract 的范围
-- 实现改动了无关文件
+# Sprint Contract
+
+## 目标（Objective）
+
+描述有边界的工作块。
+
+## 交付物（Deliverables）
+
+- 
+
+## 非目标（Non-goals）
+
+- 
+
+## 验证（Verification）
+
+```bash
+bash scripts/check-repo.sh
+npm run typecheck
+npm test
+```
+
+Windows 上通过 Git Bash 或已配置的兼容 Bash 运行脚本。实际文件操作用平台原生路径。
+
+## 失败条件（Failure Conditions）
+
+- 必需验证无法运行或失败
+- 工作需要超出本 contract 的范围
+- 实现改动了无关文件

package/docs/templates/worker-dogfood-evidence.md

@@ -1,80 +1,80 @@
-# Worker Dogfood Evidence
-
-## Sample identity
-
-| Field | Value |
-|---|---|
-| Date | |
-| Feature / Task | |
-| Target repo | disposable path or sanitized reference |
-| Controller package/version | |
-| Agent-worker package/version (same npm install) | |
-| Controller requested entry / real entry | sanitized reference; keep machine-local absolute value in runtime evidence |
-| Controller launch command / args prefix | sanitized reference |
-| Controller binary SHA-256 | |
-| Controller package fingerprint | `sha256:<hex>` |
-| Expected controller version / fingerprint | n/a / exact values |
-| Provider/model / override | |
-| Batch ID | |
-| Worker run ID | |
-| Retry of worker run ID | n/a / |
-| Candidate commit / tarball SHA-256 | n/a / |
-
-## Baseline
-
-- Baseline commit and `git status`:
-- Existing failing behavior or missing capability:
-- Preflight (`loop-agent --version`, `inspect`, `docs audit`, `check-repo`):
-
-## Run evidence
-
-| Artifact | Path / link | Result |
-|---|---|---|
-| TaskSpec / source-doc copies | | |
-| DAG spec | | |
-| DAG report JSON / Markdown | | |
-| DAG skill snapshot ref / SHA-256 / mode | | |
-| shell verification | | |
-| diff | | |
-| closeout or Failure Handoff | | |
-| morning report | | |
-| Observe snapshot / events | | |
-| Controller identity in Worker / Task Pool / batch / Feature evidence | | |
-
-## Candidate takeover evidence (if applicable)
-
-| Field | Value / result |
-|---|---|
-| Candidate isolated slot containment | |
-| `loop-agent` entry / binary SHA-256 / reported version | |
-| `agent-worker` entry / binary SHA-256 / reported version | |
-| Shared package fingerprint | |
-| Full init / doctor / inspect / docs audit / target check-repo | |
-| `agent-worker` skill and `.agents/skills` mirror hashes | |
-| Feature validation / `feature run --dry-run` | |
-| DAG executors | expected: `static`, `shell` only |
-| PATH trap invocations | expected: none |
-| Pi/model executor observed | expected: false; derive from actual DAG nodes |
-| Feature dry-run executed tasks | expected: empty |
-| Canary verdict / evidence path | |
-
-Do not use a deterministic canary result as proof that live Pi/model/provider execution succeeded. Record run-owned skill snapshot evidence and any explicitly authorized live run separately.
-
-## Acceptance and QA coverage
-
-| Acceptance | Test case(s) | Test file / verification | Result |
-|---|---|---|---|
-| | | | |
-
-## Failure / retry (if applicable)
-
-| Raw failure | Product-line category | Recommended follow-up | Root cause evidence | Retry result |
-|---|---|---|---|---|
-| | | | | |
-
-## Conclusion
-
-- Verdict: pass / fail / blocked
-- Review notes:
-- Follow-up task(s):
-- Evidence limitations (for example deterministic-only, no Pi executor/live takeover):
+# Worker Dogfood Evidence
+
+## Sample identity
+
+| Field | Value |
+|---|---|
+| Date | |
+| Feature / Task | |
+| Target repo | disposable path or sanitized reference |
+| Controller package/version | |
+| Agent-worker package/version (same npm install) | |
+| Controller requested entry / real entry | sanitized reference; keep machine-local absolute value in runtime evidence |
+| Controller launch command / args prefix | sanitized reference |
+| Controller binary SHA-256 | |
+| Controller package fingerprint | `sha256:<hex>` |
+| Expected controller version / fingerprint | n/a / exact values |
+| Provider/model / override | |
+| Batch ID | |
+| Worker run ID | |
+| Retry of worker run ID | n/a / |
+| Candidate commit / tarball SHA-256 | n/a / |
+
+## Baseline
+
+- Baseline commit and `git status`:
+- Existing failing behavior or missing capability:
+- Preflight (`loop-agent --version`, `inspect`, `docs audit`, `check-repo`):
+
+## Run evidence
+
+| Artifact | Path / link | Result |
+|---|---|---|
+| TaskSpec / source-doc copies | | |
+| DAG spec | | |
+| DAG report JSON / Markdown | | |
+| DAG skill snapshot ref / SHA-256 / mode | | |
+| shell verification | | |
+| diff | | |
+| closeout or Failure Handoff | | |
+| morning report | | |
+| Observe snapshot / events | | |
+| Controller identity in Worker / Task Pool / batch / Feature evidence | | |
+
+## Candidate takeover evidence (if applicable)
+
+| Field | Value / result |
+|---|---|
+| Candidate isolated slot containment | |
+| `loop-agent` entry / binary SHA-256 / reported version | |
+| `agent-worker` entry / binary SHA-256 / reported version | |
+| Shared package fingerprint | |
+| Full init / doctor / inspect / docs audit / target check-repo | |
+| `agent-worker` skill and `.agents/skills` mirror hashes | |
+| Feature validation / `feature run --dry-run` | |
+| DAG executors | expected: `static`, `shell` only |
+| PATH trap invocations | expected: none |
+| Pi/model executor observed | expected: false; derive from actual DAG nodes |
+| Feature dry-run executed tasks | expected: empty |
+| Canary verdict / evidence path | |
+
+Do not use a deterministic canary result as proof that live Pi/model/provider execution succeeded. Record run-owned skill snapshot evidence and any explicitly authorized live run separately.
+
+## Acceptance and QA coverage
+
+| Acceptance | Test case(s) | Test file / verification | Result |
+|---|---|---|---|
+| | | | |
+
+## Failure / retry (if applicable)
+
+| Raw failure | Product-line category | Recommended follow-up | Root cause evidence | Retry result |
+|---|---|---|---|---|
+| | | | | |
+
+## Conclusion
+
+- Verdict: pass / fail / blocked
+- Review notes:
+- Follow-up task(s):
+- Evidence limitations (for example deterministic-only, no Pi executor/live takeover):