@tea-agent/loop-agent 0.13.0-beta.0 → 0.13.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/AGENTS.md

@@ -1,8 +1,8 @@
-# Product-line execution rules
-
-- Read requirement, acceptance, design, test plan, task graph, and the selected TaskSpec before writing.
-- Treat `constraints.allowed_paths` and `constraints.forbidden_paths` as machine-enforced write boundaries; review DAG writer `writeSet` before execution.
-- Advance only tasks whose dependencies are complete. Preserve failed run records; retries receive new worker run IDs.
-- A Ready task must have acceptance references, non-empty allowed/forbidden paths, and deterministic verification commands.
-- QA records an independent verdict and evidence. Do not write `status: success` closeout until `qa_verdict: pass` and non-empty `qa_evidence` exist.
-- Human gates remain human decisions. Record owner, time, reason, evidence, and follow-up without rewriting failed history.
+# Product-line execution rules
+
+- Read requirement, acceptance, design, test plan, task graph, and the selected TaskSpec before writing.
+- Treat `constraints.allowed_paths` and `constraints.forbidden_paths` as machine-enforced write boundaries; review DAG writer `writeSet` before execution.
+- Advance only tasks whose dependencies are complete. Preserve failed run records; retries receive new worker run IDs.
+- A Ready task must have acceptance references, non-empty allowed/forbidden paths, and deterministic verification commands.
+- QA records an independent verdict and evidence. Do not write `status: success` closeout until `qa_verdict: pass` and non-empty `qa_evidence` exist.
+- Human gates remain human decisions. Record owner, time, reason, evidence, and follow-up without rewriting failed history.

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

@@ -1,9 +1,9 @@
-# Product-line feature packet
-
-Copy this directory for each product feature. Replace angle-bracket placeholders, keep IDs stable, and run:
-
-```bash
-agent-worker task validate-feature <feature-dir>
-```
-
-The validator checks acceptance ID uniqueness, task references and dependencies, cycles, TaskSpec/path/verification completeness, and QA evidence before a successful closeout.
+# Product-line feature packet
+
+Copy this directory for each product feature. Replace angle-bracket placeholders, keep IDs stable, and run:
+
+```bash
+agent-worker task validate-feature <feature-dir>
+```
+
+The validator checks acceptance ID uniqueness, task references and dependencies, cycles, TaskSpec/path/verification completeness, and QA evidence before a successful closeout.

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

@@ -1,14 +1,14 @@
-schema_version: 1
-feature_id: F-YYYY-NNN
-acceptance:
-  - id: AC-FEATURE-001
-    title: Observable outcome is delivered
-    priority: must
-    type: behavior
-    given: the documented precondition
-    when: the user or system performs the action
-    then: the observable result occurs
-    verification:
-      expected_task_refs:
-        - BE-001
-        - QA-001
+schema_version: 1
+feature_id: F-YYYY-NNN
+acceptance:
+  - id: AC-FEATURE-001
+    title: Observable outcome is delivered
+    priority: must
+    type: behavior
+    given: the documented precondition
+    when: the user or system performs the action
+    then: the observable result occurs
+    verification:
+      expected_task_refs:
+        - BE-001
+        - QA-001

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/task-graph.yaml

@@ -1,15 +1,15 @@
-schema_version: 1
-feature_id: F-YYYY-NNN
-nodes:
-  - id: BE-001
-    task: BE-001.yaml
-    type: backend-feature
-    depends_on: []
-  - id: QA-001
-    task: QA-001.yaml
-    type: qa-execute
-    depends_on:
-      - BE-001
-parallel_policy:
-  max_parallel_tasks: 2
-  disallow_same_file_parallel_writes: true
+schema_version: 1
+feature_id: F-YYYY-NNN
+nodes:
+  - id: BE-001
+    task: BE-001.yaml
+    type: backend-feature
+    depends_on: []
+  - id: QA-001
+    task: QA-001.yaml
+    type: qa-execute
+    depends_on:
+      - BE-001
+parallel_policy:
+  max_parallel_tasks: 2
+  disallow_same_file_parallel_writes: true

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

@@ -1,64 +1,64 @@
-schema_version: 1
-id: BE-001
-feature_id: F-YYYY-NNN
-title: <Bounded tracer-bullet task>
-description: <Observable delivery>
-repo:
-  name: <repository-name>
-  path_ref: <repository-path-reference>
-  default_branch: main
-type: backend-feature
-priority: P1
-risk_level: medium
-depends_on: []
-source_docs:
-  requirement: ../requirement.md
-  acceptance: ../acceptance.yaml
-  design: ../design.md
-  test_plan: ../test-plan.md
-acceptance_refs:
-  - AC-FEATURE-001
-scope:
-  goals:
-    - <goal>
-  non_goals:
-    - <non-goal>
-constraints:
-  allowed_paths:
-    - <owned/path/**>
-  forbidden_paths:
-    - <protected/path/**>
-  hard_constraints:
-    - Do not access production secrets
-verify:
-  preset: standard
-  mode: serial
-  commands:
-    - id: focused-test
-      label: Focused deterministic verification
-      command: <project-specific verification command>
-      required: true
-      timeout_ms: 300000
-worker:
-  execution_mode: generate-validate-run
-  max_attempts: 1
-  timeout_ms: 7200000
-  require_clean_worktree: true
-  require_human_review: true
-  create_worktree: false
-loop_agent:
-  profile_policy: mapped
-  strict_models: true
-  strict_governance: true
-  max_concurrent: 1
-outputs:
-  required:
-    - dag_json
-    - run_record
-    - shell_verification
-    - diff_patch
-    - closeout_or_failure_handoff
-failure_policy:
-  failed_run_promote: false
-  generate_closeout_draft: true
-  create_followup_task: true
+schema_version: 1
+id: BE-001
+feature_id: F-YYYY-NNN
+title: <Bounded tracer-bullet task>
+description: <Observable delivery>
+repo:
+  name: <repository-name>
+  path_ref: <repository-path-reference>
+  default_branch: main
+type: backend-feature
+priority: P1
+risk_level: medium
+depends_on: []
+source_docs:
+  requirement: ../requirement.md
+  acceptance: ../acceptance.yaml
+  design: ../design.md
+  test_plan: ../test-plan.md
+acceptance_refs:
+  - AC-FEATURE-001
+scope:
+  goals:
+    - <goal>
+  non_goals:
+    - <non-goal>
+constraints:
+  allowed_paths:
+    - <owned/path/**>
+  forbidden_paths:
+    - <protected/path/**>
+  hard_constraints:
+    - Do not access production secrets
+verify:
+  preset: standard
+  mode: serial
+  commands:
+    - id: focused-test
+      label: Focused deterministic verification
+      command: <project-specific verification command>
+      required: true
+      timeout_ms: 300000
+worker:
+  execution_mode: generate-validate-run
+  max_attempts: 1
+  timeout_ms: 7200000
+  require_clean_worktree: true
+  require_human_review: true
+  create_worktree: false
+loop_agent:
+  profile_policy: mapped
+  strict_models: true
+  strict_governance: true
+  max_concurrent: 1
+outputs:
+  required:
+    - dag_json
+    - run_record
+    - shell_verification
+    - diff_patch
+    - closeout_or_failure_handoff
+failure_policy:
+  failed_run_promote: false
+  generate_closeout_draft: true
+  create_followup_task: true

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/production-readiness-checklist.md

@@ -1,57 +1,57 @@
-# Production Readiness 检查清单
-
-声称 Production Readiness v0.1 的低/中风险单仓库 DAG 任务使用本清单。
-
-## 范围
-
-- [ ] 单仓库
-- [ ] 单任务或小范围有边界任务
-- [ ] 低或中风险
-- [ ] 无生产 secret 或生产数据库访问
-- [ ] 无自动 merge 或 release
-- [ ] 无 DAG runtime 之外的第二套 runner
-- [ ] 无可写 Dynamic Workflow sharded migration
-
-## Task Contract
-
-- [ ] Task source 存在于 `.harness/tasks/<task-id>/source/`
-- [ ] `allowedPaths` 显式
-- [ ] `forbiddenPaths` 显式
-- [ ] `writeSet` 或预期写 scope 显式
-- [ ] Shell 验证命令显式
-- [ ] 非目标显式
-
-## DAG 主路径
-
-- [ ] 已运行 `loop-agent new-task <task-id> "Task title"` 或 task 已存在
-- [ ] `loop-agent dag run-task <task-id> --profile auto --strict-models --output <dag-path>` 产出 DAG spec
-- [ ] `loop-agent dag validate --dag <dag-path> --strict-models --strict-governance` 通过
-- [ ] `loop-agent run-dag --dag <dag-path> --cwd .` 产出 run id
-- [ ] `loop-agent dag report --run-id <run-id> --markdown` 可读
-- [ ] `loop-agent dag doctor --run-id <run-id>` 能解释失败或 paused run
-
-## 证据
-
-- [ ] 记录 DAG spec path
-- [ ] 记录 DAG validation 输出
-- [ ] 记录 run id
-- [ ] Shell 验证输出是新鲜的
-- [ ] 成功路径有 promotion 与 closeout 证据
-- [ ] 失败路径有 failure handoff 证据
-
-## Failure Routing
-
-- [ ] 存在时保留 raw failure category
-- [ ] 失败 run 有 DAG normalized failure category
-- [ ] 失败 run 有 product-line failure category
-- [ ] 失败 run 有 recommended follow-up
-- [ ] 派生 category 未覆盖已完成 DAG facts
-- [ ] `Unknown` 已说明或为 fixture 有意接受
-
-## 最终门禁
-
-- [ ] `npm run typecheck`
-- [ ] 相关定向 Vitest 文件
-- [ ] `bash scripts/check-repo.sh`
-- [ ] website/docs 变更时 `npm run docs:build`
-- [ ] 最终 sprint closeout 前 `bash scripts/ci.sh`
+# Production Readiness 检查清单
+
+声称 Production Readiness v0.1 的低/中风险单仓库 DAG 任务使用本清单。
+
+## 范围
+
+- [ ] 单仓库
+- [ ] 单任务或小范围有边界任务
+- [ ] 低或中风险
+- [ ] 无生产 secret 或生产数据库访问
+- [ ] 无自动 merge 或 release
+- [ ] 无 DAG runtime 之外的第二套 runner
+- [ ] 无可写 Dynamic Workflow sharded migration
+
+## Task Contract
+
+- [ ] Task source 存在于 `.harness/tasks/<task-id>/source/`
+- [ ] `allowedPaths` 显式
+- [ ] `forbiddenPaths` 显式
+- [ ] `writeSet` 或预期写 scope 显式
+- [ ] Shell 验证命令显式
+- [ ] 非目标显式
+
+## DAG 主路径
+
+- [ ] 已运行 `loop-agent new-task <task-id> "Task title"` 或 task 已存在
+- [ ] `loop-agent dag run-task <task-id> --profile auto --strict-models --output <dag-path>` 产出 DAG spec
+- [ ] `loop-agent dag validate --dag <dag-path> --strict-models --strict-governance` 通过
+- [ ] `loop-agent run-dag --dag <dag-path> --cwd .` 产出 run id
+- [ ] `loop-agent dag report --run-id <run-id> --markdown` 可读
+- [ ] `loop-agent dag doctor --run-id <run-id>` 能解释失败或 paused run
+
+## 证据
+
+- [ ] 记录 DAG spec path
+- [ ] 记录 DAG validation 输出
+- [ ] 记录 run id
+- [ ] Shell 验证输出是新鲜的
+- [ ] 成功路径有 promotion 与 closeout 证据
+- [ ] 失败路径有 failure handoff 证据
+
+## Failure Routing
+
+- [ ] 存在时保留 raw failure category
+- [ ] 失败 run 有 DAG normalized failure category
+- [ ] 失败 run 有 product-line failure category
+- [ ] 失败 run 有 recommended follow-up
+- [ ] 派生 category 未覆盖已完成 DAG facts
+- [ ] `Unknown` 已说明或为 fixture 有意接受
+
+## 最终门禁
+
+- [ ] `npm run typecheck`
+- [ ] 相关定向 Vitest 文件
+- [ ] `bash scripts/check-repo.sh`
+- [ ] website/docs 变更时 `npm run docs:build`
+- [ ] 最终 sprint closeout 前 `bash scripts/ci.sh`

package/docs/templates/progress-log.md

@@ -1,17 +1,17 @@
-# 进度日志模板
-
-## 日期 / 会话
-
-## 变更内容
-
-## 已验证项
-
-## 新发现的 Bug / 技术债 / 漂移
-
-- Bugs:
-- Debt:
-- Drift:
-
-## 已知缺口 / 风险
-
-## 推荐下一步
+# 进度日志模板
+
+## 日期 / 会话
+
+## 变更内容
+
+## 已验证项
+
+## 新发现的 Bug / 技术债 / 漂移
+
+- Bugs:
+- Debt:
+- Drift:
+
+## 已知缺口 / 风险
+
+## 推荐下一步

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 证据