@tea-agent/loop-agent 0.12.0 → 0.13.0-beta.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (284) hide show
  1. package/AGENTS.md +155 -153
  2. package/CHANGELOG.md +338 -265
  3. package/README.md +345 -298
  4. package/bin/agent-worker.js +22 -22
  5. package/bin/loop-agent.js +21 -21
  6. package/dist/application/dag/generate-task-dag.js +28 -28
  7. package/dist/application/evaluation/candidate-hash.js +75 -0
  8. package/dist/application/evaluation/candidate.js +52 -0
  9. package/dist/application/evaluation/replay.js +289 -0
  10. package/dist/application/evaluation/types.js +130 -0
  11. package/dist/cli/command-definitions.js +27 -7
  12. package/dist/cli/program.js +8 -4
  13. package/dist/commands/cursor-prompt.js +6 -6
  14. package/dist/commands/eval.js +235 -0
  15. package/dist/commands/init.js +544 -506
  16. package/dist/commands/knowledge.js +129 -31
  17. package/dist/commands/loop-benchmark.js +11 -11
  18. package/dist/commands/pi-reuse-benchmark.js +16 -16
  19. package/dist/executors/pi-sdk-executor.js +38 -24
  20. package/dist/executors/shell-executor.js +34 -2
  21. package/dist/executors/shell-presets.js +20 -0
  22. package/dist/executors/shell-verification.js +7 -0
  23. package/dist/governance/manifest-types.js +4 -0
  24. package/dist/infrastructure/evaluation/candidate-store.js +435 -0
  25. package/dist/infrastructure/evaluation/store.js +40 -0
  26. package/dist/sidecars/cursor-prompt/executor.js +1 -1
  27. package/dist/task/config-types.js +28 -1
  28. package/dist/task/runtime.js +27 -27
  29. package/dist/worker/cli.js +96 -1
  30. package/dist/worker/delivery/package.js +3 -3
  31. package/dist/worker/feature/decision-loader.js +37 -6
  32. package/dist/worker/feature/next-action.js +10 -2
  33. package/dist/worker/feature/ready-plan-projection.js +81 -0
  34. package/dist/worker/feature/reducer.js +2 -1
  35. package/dist/worker/feature/review.js +19 -2
  36. package/dist/worker/feature/run.js +27 -2
  37. package/dist/worker/follow-up/approve.js +5 -2
  38. package/dist/worker/follow-up/factory.js +1 -1
  39. package/dist/worker/observability/read-model.js +246 -41
  40. package/dist/worker/observe/routes.js +173 -15
  41. package/dist/worker/observe/spec-evidence.js +281 -0
  42. package/dist/worker/observe/static/api.js +46 -27
  43. package/dist/worker/observe/static/app.js +150 -150
  44. package/dist/worker/observe/static/constants.js +148 -148
  45. package/dist/worker/observe/static/copy.js +67 -67
  46. package/dist/worker/observe/static/dag-helpers.js +172 -172
  47. package/dist/worker/observe/static/dag-layout.d.ts +31 -31
  48. package/dist/worker/observe/static/dag-layout.js +83 -83
  49. package/dist/worker/observe/static/dag-model.js +72 -72
  50. package/dist/worker/observe/static/dom.js +61 -61
  51. package/dist/worker/observe/static/format-pool.js +67 -67
  52. package/dist/worker/observe/static/format.js +292 -292
  53. package/dist/worker/observe/static/index.html +308 -308
  54. package/dist/worker/observe/static/kpi.js +94 -94
  55. package/dist/worker/observe/static/relations.js +133 -128
  56. package/dist/worker/observe/static/router.js +93 -85
  57. package/dist/worker/observe/static/run-processing.js +148 -148
  58. package/dist/worker/observe/static/shell-chrome.js +68 -68
  59. package/dist/worker/observe/static/state.js +253 -253
  60. package/dist/worker/observe/static/styles.css +1902 -1890
  61. package/dist/worker/observe/static/views/batch.js +227 -226
  62. package/dist/worker/observe/static/views/dag-graph.js +172 -172
  63. package/dist/worker/observe/static/views/dag-inspector.js +607 -477
  64. package/dist/worker/observe/static/views/dag.js +362 -362
  65. package/dist/worker/observe/static/views/dashboard.js +445 -442
  66. package/dist/worker/observe/static/views/failures.js +143 -143
  67. package/dist/worker/observe/static/views/feature.js +492 -453
  68. package/dist/worker/observe/static/views/pool.js +350 -347
  69. package/dist/worker/observe/static/views/run.js +453 -453
  70. package/dist/worker/observe/static/views/session-timeline.js +205 -205
  71. package/dist/worker/observe/static/views/shell.js +7 -7
  72. package/dist/worker/observe/static/views/task.js +314 -260
  73. package/dist/worker/observe/static/views/timeline.js +163 -163
  74. package/dist/worker/pool/doctor.js +165 -0
  75. package/dist/worker/pool/migrate-state.js +303 -0
  76. package/dist/worker/pool/run-store.js +205 -17
  77. package/dist/worker/pool/types.js +17 -1
  78. package/dist/worker/pool/validation.js +100 -15
  79. package/dist/worker/report/morning-report.js +12 -2
  80. package/dist/worker/runner/run-ready.js +41 -26
  81. package/dist/worker/task-graph/ready-planner.js +136 -0
  82. package/dist/workflows/dag/backend-test-analysis-contract.js +120 -0
  83. package/dist/workflows/dag/canvas-observer.js +275 -275
  84. package/dist/workflows/dag/convergence/controller.js +16 -8
  85. package/dist/workflows/dag/dynamic-runtime/map.js +90 -2
  86. package/dist/workflows/dag/failure-routing.js +12 -1
  87. package/dist/workflows/dag/init-hybrid.js +2404 -360
  88. package/dist/workflows/dag/node-execution.js +9 -0
  89. package/dist/workflows/dag/prompt.js +9 -0
  90. package/dist/workflows/dag/report.js +35 -1
  91. package/dist/workflows/dag/runner.js +28 -2
  92. package/dist/workflows/dag/task-demand-routing.js +383 -0
  93. package/dist/workflows/dag/types.js +51 -13
  94. package/dist/workflows/dag/upstream-artifacts.js +1 -0
  95. package/dist/workflows/dag/validate.js +59 -1
  96. package/docs/README.md +106 -104
  97. package/docs/agent-dag-recovery-playbook.md +195 -184
  98. package/docs/agent-dag-runner.md +67 -67
  99. package/docs/architecture/README.md +26 -26
  100. package/docs/architecture/dag-execution.md +140 -140
  101. package/docs/architecture/evolution.md +54 -53
  102. package/docs/architecture/facts-and-state.md +71 -58
  103. package/docs/architecture/runtime-boundaries.md +191 -191
  104. package/docs/architecture/system-overview.md +93 -93
  105. package/docs/architecture/worker-and-feature.md +85 -81
  106. package/docs/cursor-prompt-sidecar.md +36 -36
  107. package/docs/decisions/README.md +18 -15
  108. package/docs/design/README.md +167 -77
  109. package/docs/development-principles.md +73 -73
  110. package/docs/exec-plans/README.md +6 -6
  111. package/docs/exec-plans/active/README.md +15 -9
  112. package/docs/exec-plans/completed/README.md +85 -73
  113. package/docs/feature-workflow.md +389 -261
  114. package/docs/harness-methodology-debugging.md +153 -153
  115. package/docs/harness-methodology-tdd.md +130 -130
  116. package/docs/harness-methodology-verification.md +27 -27
  117. package/docs/init-surface.manifest.json +289 -280
  118. package/docs/loop-agent-harness.md +142 -130
  119. package/docs/production-readiness.md +96 -96
  120. package/docs/progress/README.md +64 -54
  121. package/docs/reports/README.md +117 -94
  122. package/docs/skills/README.md +7 -7
  123. package/docs/skills/vetted-skill-registry.md +29 -27
  124. package/docs/templates/adr.md +60 -60
  125. package/docs/templates/agent-dag-authority-surface-audit.prompt.md +94 -94
  126. package/docs/templates/agent-dag-decision-envelope.schema.json +213 -213
  127. package/docs/templates/agent-dag-decision-gate-dogfood-report.md +117 -117
  128. package/docs/templates/agent-dag-decision-gate.prompt.md +246 -246
  129. package/docs/templates/agent-dag-process-supervisor.prompt.md +98 -98
  130. package/docs/templates/agent-dag-report.schema.json +473 -473
  131. package/docs/templates/agent-dag-review-verdict.prompt.md +68 -68
  132. package/docs/templates/agent-dag.base.json +190 -190
  133. package/docs/templates/agent-dag.final-verification.json +185 -185
  134. package/docs/templates/agent-dag.schema.json +411 -383
  135. package/docs/templates/agent-dag.supervised-implementation.json +501 -501
  136. package/docs/templates/backend-test-analysis.schema.json +44 -0
  137. package/docs/templates/backend-test-dag.generate-pytest.prompt.md +202 -139
  138. package/docs/templates/backend-test-dag.json +311 -276
  139. package/docs/templates/backend-test-dag.retrospect.prompt.md +125 -125
  140. package/docs/templates/backend-test-dag.review-cases.prompt.md +81 -81
  141. package/docs/templates/exec-plan.md +64 -64
  142. package/docs/templates/feature-spec.md +53 -53
  143. package/docs/templates/frontend-design-contract.md +42 -33
  144. package/docs/templates/frontend-task-constraints.md +35 -25
  145. package/docs/templates/frontend-task-requirement.md +70 -61
  146. package/docs/templates/frontend-test-dag.generate-cases.prompt.md +5 -0
  147. package/docs/templates/frontend-test-dag.json +23 -0
  148. package/docs/templates/frontend-test-dag.retrieve-context.prompt.md +3 -0
  149. package/docs/templates/frontend-test-dag.retrospect.prompt.md +3 -0
  150. package/docs/templates/frontend-test-dag.review-cases.prompt.md +3 -0
  151. package/docs/templates/frontend-test-dag.review-execution.prompt.md +3 -0
  152. package/docs/templates/harness.schema.json +221 -221
  153. package/docs/templates/hybrid-dag.json +188 -188
  154. package/docs/templates/init-evolution-review.md +35 -35
  155. package/docs/templates/interactive-ui-round2-experiment.md +66 -66
  156. package/docs/templates/knowledge-graph-bootstrap-dag.json +118 -0
  157. package/docs/templates/knowledge-sync-dag.json +178 -0
  158. package/docs/templates/knowledge-sync-draft.schema.json +71 -0
  159. package/docs/templates/product-line/AGENTS.md +8 -8
  160. package/docs/templates/product-line/README.md +9 -9
  161. package/docs/templates/product-line/acceptance.yaml +14 -14
  162. package/docs/templates/product-line/closeout.yaml +9 -9
  163. package/docs/templates/product-line/design.md +13 -13
  164. package/docs/templates/product-line/links.md +10 -10
  165. package/docs/templates/product-line/requirement.md +17 -17
  166. package/docs/templates/product-line/task-graph.yaml +15 -15
  167. package/docs/templates/product-line/task.yaml +64 -64
  168. package/docs/templates/product-line/test-plan.md +7 -7
  169. package/docs/templates/production-readiness-checklist.md +57 -57
  170. package/docs/templates/progress-log.md +17 -17
  171. package/docs/templates/project-start-checklist.md +9 -9
  172. package/docs/templates/qa-report.md +48 -48
  173. package/docs/templates/sprint-contract.md +29 -29
  174. package/docs/templates/worker-dogfood-evidence.md +80 -80
  175. package/docs/templates/worker-dogfood-setup.md +68 -68
  176. package/docs/verification-matrix.md +70 -66
  177. package/examples/decision-gate-agent-dag.json +177 -177
  178. package/examples/example-dag.json +46 -46
  179. package/examples/hybrid-loop-agent-dag.json +189 -189
  180. package/harness.json +66 -66
  181. package/package.json +88 -46
  182. package/scripts/check-product-line-docs.sh +29 -29
  183. package/scripts/check-task-pool-root.sh +32 -32
  184. package/scripts/kb-bootstrap-init-skeleton.sh +240 -0
  185. package/scripts/kb-graph-incremental-prepare.mjs +386 -0
  186. package/scripts/kb-graph-incremental-prepare.sh +5 -0
  187. package/scripts/kb-graph-materialize.mjs +105 -0
  188. package/scripts/kb-graph-materialize.sh +4 -0
  189. package/scripts/kb-graph-promote.mjs +164 -0
  190. package/scripts/kb-graph-promote.sh +4 -0
  191. package/scripts/kb-query.mjs +554 -0
  192. package/scripts/kb-query.sh +5 -0
  193. package/skills/agent-worker/SKILL.md +39 -37
  194. package/skills/agent-worker/references/agent-worker-operator.md +60 -43
  195. package/skills/ai-engineering-context/SKILL.md +48 -48
  196. package/skills/analyze-product-dependencies/SKILL.md +67 -0
  197. package/skills/analyze-product-dependencies/agents/openai.yaml +4 -0
  198. package/skills/analyze-product-dependencies/references/api-documentation-schema.md +30 -0
  199. package/skills/analyze-product-dependencies/references/dependency-analysis-schema.md +28 -0
  200. package/skills/analyze-product-dependencies/references/example.md +76 -0
  201. package/skills/analyze-product-dependencies/references/forward-test-cases.md +35 -0
  202. package/skills/analyze-product-dependencies/references/input-contract.md +11 -0
  203. package/skills/analyze-product-dependencies/references/scouting-rules.md +61 -0
  204. package/skills/analyze-product-dependencies/scripts/test-validators.mjs +267 -0
  205. package/skills/analyze-product-dependencies/scripts/validate-api-documentation.mjs +101 -0
  206. package/skills/analyze-product-dependencies/scripts/validate-dependency-analysis.mjs +142 -0
  207. package/skills/analyze-product-dependencies/scripts/validate-product-requirement-input.mjs +76 -0
  208. package/skills/analyze-product-dependencies/scripts/validation-helpers.mjs +146 -0
  209. package/skills/analyze-product-requirements/SKILL.md +90 -0
  210. package/skills/analyze-product-requirements/agents/openai.yaml +4 -0
  211. package/skills/analyze-product-requirements/references/acceptance-criteria.md +91 -0
  212. package/skills/analyze-product-requirements/references/clarification-and-knowledge.md +56 -0
  213. package/skills/analyze-product-requirements/references/example.md +86 -0
  214. package/skills/analyze-product-requirements/references/forward-test-cases.md +66 -0
  215. package/skills/analyze-product-requirements/references/product-analysis-schema.md +32 -0
  216. package/skills/analyze-product-requirements/references/product-requirement-schema.md +33 -0
  217. package/skills/analyze-product-requirements/references/requirement-clarification-schema.md +35 -0
  218. package/skills/analyze-product-requirements/scripts/test-validators.mjs +193 -0
  219. package/skills/analyze-product-requirements/scripts/validate-product-analysis.mjs +69 -0
  220. package/skills/analyze-product-requirements/scripts/validate-product-requirement.mjs +97 -0
  221. package/skills/analyze-product-requirements/scripts/validate-requirement-clarification.mjs +98 -0
  222. package/skills/analyze-product-requirements/scripts/validation-helpers.mjs +156 -0
  223. package/skills/code-review-core/SKILL.md +20 -20
  224. package/skills/codebase-scout/SKILL.md +19 -19
  225. package/skills/frontend-design-review/SKILL.md +66 -59
  226. package/skills/frontend-design-review/references/review-checklist.md +58 -37
  227. package/skills/frontend-implementation/SKILL.md +47 -51
  228. package/skills/frontend-implementation/references/code-standards.md +32 -34
  229. package/skills/frontend-implementation/references/design-spec.md +46 -46
  230. package/skills/frontend-implementation/references/node-contracts.md +76 -32
  231. package/skills/frontend-review/SKILL.md +59 -53
  232. package/skills/frontend-review/references/review-findings.md +47 -42
  233. package/skills/frontend-verification/SKILL.md +53 -40
  234. package/skills/frontend-verification/references/verification-checklist.md +68 -56
  235. package/skills/grill-me/SKILL.md +10 -10
  236. package/skills/grill-with-docs/SKILL.md +88 -88
  237. package/skills/grill-with-docs/adr-format.md +47 -47
  238. package/skills/grill-with-docs/context-format.md +60 -60
  239. package/skills/init-capability-evolution/SKILL.md +70 -70
  240. package/skills/loop-agent/SKILL.md +151 -151
  241. package/skills/loop-agent/references/README.md +67 -67
  242. package/skills/loop-agent/references/command-reference.md +505 -452
  243. package/skills/loop-agent/references/docs-converge.md +126 -126
  244. package/skills/loop-agent/references/harness-policy.md +263 -263
  245. package/skills/loop-agent/references/hybrid-dag.md +238 -233
  246. package/skills/loop-agent/references/learned/README.md +21 -21
  247. package/skills/loop-agent/references/long-running-loop.md +57 -57
  248. package/skills/loop-agent/references/model-routing.md +36 -36
  249. package/skills/loop-agent/references/multi-worktree.md +54 -54
  250. package/skills/loop-agent/references/one-shot-runs.md +85 -85
  251. package/skills/loop-agent/references/orchestrator-and-interventions.md +169 -169
  252. package/skills/loop-agent/references/pi-prompt.md +23 -23
  253. package/skills/loop-agent/references/pi-subagent-assisted-mode.md +84 -84
  254. package/skills/loop-agent/references/post-implementation-and-patterns.md +44 -44
  255. package/skills/loop-agent/references/task-workflow.md +89 -89
  256. package/skills/loop-agent/references/verification-and-failure-handling.md +139 -139
  257. package/skills/playwright-cli/SKILL.md +420 -0
  258. package/skills/playwright-cli/references/element-attributes.md +23 -0
  259. package/skills/playwright-cli/references/playwright-tests.md +39 -0
  260. package/skills/playwright-cli/references/request-mocking.md +87 -0
  261. package/skills/playwright-cli/references/running-code.md +241 -0
  262. package/skills/playwright-cli/references/session-management.md +225 -0
  263. package/skills/playwright-cli/references/storage-state.md +275 -0
  264. package/skills/playwright-cli/references/test-generation.md +433 -0
  265. package/skills/playwright-cli/references/tracing.md +139 -0
  266. package/skills/playwright-cli/references/video-recording.md +143 -0
  267. package/skills/playwright-cli-case-generator/SKILL.md +74 -0
  268. package/skills/requesting-code-review/SKILL.md +101 -101
  269. package/skills/requesting-code-review/code-reviewer.md +168 -168
  270. package/skills/systematic-debugging/CREATION-LOG.md +119 -119
  271. package/skills/systematic-debugging/SKILL.md +296 -296
  272. package/skills/systematic-debugging/condition-based-waiting-example.ts +158 -158
  273. package/skills/systematic-debugging/condition-based-waiting.md +115 -115
  274. package/skills/systematic-debugging/defense-in-depth.md +122 -122
  275. package/skills/systematic-debugging/find-polluter.sh +63 -63
  276. package/skills/systematic-debugging/root-cause-tracing.md +169 -169
  277. package/skills/systematic-debugging/test-academic.md +14 -14
  278. package/skills/systematic-debugging/test-pressure-1.md +58 -58
  279. package/skills/systematic-debugging/test-pressure-2.md +68 -68
  280. package/skills/systematic-debugging/test-pressure-3.md +69 -69
  281. package/skills/test-driven-development/SKILL.md +20 -20
  282. package/skills/using-git-worktrees/SKILL.md +215 -215
  283. package/skills/verification-before-completion/SKILL.md +154 -154
  284. package/skills/webapp-testing/SKILL.md +19 -19
@@ -1,189 +1,189 @@
1
- {
2
- "version": 2,
3
- "title": "Hybrid DAG 示例:Pi 只读契约 + 并行侦察 + Pi 写入实现",
4
- "objective": "演示 v2 hybrid DAG:Pi 节点返回只读契约/审查结论,Pi 节点并行只读侦察,Pi writer 节点通过 toolProfile=write 独占实现。",
5
- "successCriteria": [
6
- "contract-pi 返回可审计的只读实现契约摘要",
7
- "scout-src 与 scout-tests 并行只读侦察且互不写冲突",
8
- "implement-core 仅在声明的 writeSet 内修改代码",
9
- "review-pi 基于上游输出完成只读审查",
10
- "verify-shell 归档确定性验证命令输出",
11
- "dag validate 校验通过且 ranks 符合依赖拓扑"
12
- ],
13
- "globalConstraints": [
14
- "Do not commit runtime traces under .harness/dag-runs/",
15
- "Do not enable cross-node Pi runtime reuse by default",
16
- "Preserve CODE_AGENT_PI_BACKEND=cli-only rollback for Pi nodes",
17
- "Every task must explicitly declare executor; defaults.executor is schema-only and not a runtime fallback",
18
- "Prefer same-rank parallel read-only scouts over serial chains when outputs are independent",
19
- "Add depends_on only when a child truly needs upstream output; challenge single-chain topologies during review",
20
- "Same-rank exclusive writeSet entries must be disjoint",
21
- "exclusive implementer nodes must use narrow, concrete writeSet paths; never use ** or repo root",
22
- "Cursor is optional; no-Cursor environments should use Pi read-only scouts and Pi writer nodes with toolProfile=write",
23
- "Read-only nodes must not write root artifacts/**; root artifacts/ is reserved for Level 1/current-work summaries or explicit exclusive write nodes"
24
- ],
25
- "defaults": {
26
- "executor": "pi",
27
- "piBackend": "sdk-first",
28
- "contextProfile": "slim",
29
- "skills": [
30
- "ai-engineering-context"
31
- ],
32
- "writePolicy": "read-only"
33
- },
34
- "skillsByRole": {
35
- "planner": [
36
- "loop-agent"
37
- ],
38
- "scout": [
39
- "ai-engineering-context"
40
- ],
41
- "implementer": [
42
- "verification-before-completion"
43
- ],
44
- "reviewer": [
45
- "requesting-code-review"
46
- ],
47
- "verifier": [
48
- "verification-before-completion",
49
- "systematic-debugging"
50
- ],
51
- "closeout": [
52
- "loop-agent",
53
- "verification-before-completion"
54
- ]
55
- },
56
- "executorModels": {
57
- "pi": {
58
- "LOW": "gpt-5.3-codex-spark",
59
- "MED": "glm-5.2",
60
- "HIGH": "gpt-5.5"
61
- }
62
- },
63
- "tasks": [
64
- {
65
- "id": "contract-pi",
66
- "depends_on": [],
67
- "role": "planner",
68
- "executor": "pi",
69
- "complexity": "MED",
70
- "writePolicy": "read-only",
71
- "allowedPaths": [
72
- "./**",
73
- "docs/**"
74
- ],
75
- "forbiddenPaths": [
76
- ".harness/**",
77
- "artifacts/**"
78
- ],
79
- "outputContract": "Plain Markdown implementation contract summary; no file writes.",
80
- "subtask_prompt": "阅读 ./README.md 与 docs/agent-dag-runner.md,返回 10 行以内的实现契约摘要(只读分析 + 文档建议,不改代码/文档/artifacts)。指出是否适合并行 scout 与窄 writeSet。"
81
- },
82
- {
83
- "id": "scout-src",
84
- "depends_on": [
85
- "contract-pi"
86
- ],
87
- "role": "scout",
88
- "executor": "pi",
89
- "complexity": "LOW",
90
- "writePolicy": "read-only",
91
- "allowedPaths": [
92
- "./src/workflows/dag/**"
93
- ],
94
- "forbiddenPaths": [
95
- ".harness/**",
96
- "artifacts/**"
97
- ],
98
- "outputContract": "Plain Markdown reconnaissance summary of DAG-related source modules; no file writes.",
99
- "subtask_prompt": "只读审计 ./src/workflows/dag/ 中与 DAG 相关的模块,列出关键文件与职责(不要改文件)。"
100
- },
101
- {
102
- "id": "scout-tests",
103
- "depends_on": [
104
- "contract-pi"
105
- ],
106
- "role": "scout",
107
- "executor": "pi",
108
- "complexity": "LOW",
109
- "writePolicy": "read-only",
110
- "allowedPaths": [
111
- "./test/**"
112
- ],
113
- "forbiddenPaths": [
114
- ".harness/**",
115
- "artifacts/**"
116
- ],
117
- "outputContract": "Plain Markdown test coverage gap summary; no file writes.",
118
- "subtask_prompt": "只读审计 ./test/ 中与 dag-runner 相关的测试覆盖,列出缺口建议(不要改文件)。"
119
- },
120
- {
121
- "id": "implement-core",
122
- "depends_on": [
123
- "scout-src",
124
- "scout-tests"
125
- ],
126
- "role": "implementer",
127
- "executor": "pi",
128
- "complexity": "HIGH",
129
- "writePolicy": "exclusive",
130
- "writeSet": [
131
- "./src/workflows/dag/runner.ts"
132
- ],
133
- "allowedPaths": [
134
- "./src/workflows/dag/**"
135
- ],
136
- "forbiddenPaths": [
137
- ".harness/**",
138
- "artifacts/**"
139
- ],
140
- "outputContract": "Implementation summary with changed files, tests run, and residual risks.",
141
- "subtask_prompt": "基于上游侦察结果,在 writeSet 范围内做最小必要改动并说明风险(若无需改动则输出 no-op 理由)。",
142
- "toolProfile": "write"
143
- },
144
- {
145
- "id": "review-pi",
146
- "depends_on": [
147
- "implement-core"
148
- ],
149
- "role": "reviewer",
150
- "executor": "pi",
151
- "complexity": "MED",
152
- "writePolicy": "read-only",
153
- "allowedPaths": [
154
- "./**",
155
- "docs/**"
156
- ],
157
- "forbiddenPaths": [
158
- ".harness/**",
159
- "artifacts/**"
160
- ],
161
- "outputContract": "Plain Markdown review summary; no file writes.",
162
- "subtask_prompt": "审查上游实现与侦察结论是否一致,列出范围漂移、验证缺口与残余风险(只读,不改文件/文档/artifacts)。"
163
- },
164
- {
165
- "id": "verify-shell",
166
- "depends_on": [
167
- "implement-core"
168
- ],
169
- "role": "verifier",
170
- "executor": "shell",
171
- "complexity": "LOW",
172
- "writePolicy": "read-only",
173
- "allowedPaths": [
174
- "./**"
175
- ],
176
- "forbiddenPaths": [
177
- ".harness/**",
178
- "artifacts/**"
179
- ],
180
- "outputContract": "Archived shell verification stdout/stderr with exit codes; no worktree writes.",
181
- "subtask_prompt": "Run deterministic loop-agent verification and archive command outputs.",
182
- "shell": {
183
- "preset": "loop-agent-standard-verify",
184
- "cwd": ".",
185
- "timeoutMs": 300000
186
- }
187
- }
188
- ]
189
- }
1
+ {
2
+ "version": 2,
3
+ "title": "Hybrid DAG 示例:Pi 只读契约 + 并行侦察 + Pi 写入实现",
4
+ "objective": "演示 v2 hybrid DAG:Pi 节点返回只读契约/审查结论,Pi 节点并行只读侦察,Pi writer 节点通过 toolProfile=write 独占实现。",
5
+ "successCriteria": [
6
+ "contract-pi 返回可审计的只读实现契约摘要",
7
+ "scout-src 与 scout-tests 并行只读侦察且互不写冲突",
8
+ "implement-core 仅在声明的 writeSet 内修改代码",
9
+ "review-pi 基于上游输出完成只读审查",
10
+ "verify-shell 归档确定性验证命令输出",
11
+ "dag validate 校验通过且 ranks 符合依赖拓扑"
12
+ ],
13
+ "globalConstraints": [
14
+ "Do not commit runtime traces under .harness/dag-runs/",
15
+ "Do not enable cross-node Pi runtime reuse by default",
16
+ "Preserve CODE_AGENT_PI_BACKEND=cli-only rollback for Pi nodes",
17
+ "Every task must explicitly declare executor; defaults.executor is schema-only and not a runtime fallback",
18
+ "Prefer same-rank parallel read-only scouts over serial chains when outputs are independent",
19
+ "Add depends_on only when a child truly needs upstream output; challenge single-chain topologies during review",
20
+ "Same-rank exclusive writeSet entries must be disjoint",
21
+ "exclusive implementer nodes must use narrow, concrete writeSet paths; never use ** or repo root",
22
+ "Cursor is optional; no-Cursor environments should use Pi read-only scouts and Pi writer nodes with toolProfile=write",
23
+ "Read-only nodes must not write root artifacts/**; root artifacts/ is reserved for Level 1/current-work summaries or explicit exclusive write nodes"
24
+ ],
25
+ "defaults": {
26
+ "executor": "pi",
27
+ "piBackend": "sdk-first",
28
+ "contextProfile": "slim",
29
+ "skills": [
30
+ "ai-engineering-context"
31
+ ],
32
+ "writePolicy": "read-only"
33
+ },
34
+ "skillsByRole": {
35
+ "planner": [
36
+ "loop-agent"
37
+ ],
38
+ "scout": [
39
+ "ai-engineering-context"
40
+ ],
41
+ "implementer": [
42
+ "verification-before-completion"
43
+ ],
44
+ "reviewer": [
45
+ "requesting-code-review"
46
+ ],
47
+ "verifier": [
48
+ "verification-before-completion",
49
+ "systematic-debugging"
50
+ ],
51
+ "closeout": [
52
+ "loop-agent",
53
+ "verification-before-completion"
54
+ ]
55
+ },
56
+ "executorModels": {
57
+ "pi": {
58
+ "LOW": "gpt-5.3-codex-spark",
59
+ "MED": "glm-5.2",
60
+ "HIGH": "gpt-5.5"
61
+ }
62
+ },
63
+ "tasks": [
64
+ {
65
+ "id": "contract-pi",
66
+ "depends_on": [],
67
+ "role": "planner",
68
+ "executor": "pi",
69
+ "complexity": "MED",
70
+ "writePolicy": "read-only",
71
+ "allowedPaths": [
72
+ "./**",
73
+ "docs/**"
74
+ ],
75
+ "forbiddenPaths": [
76
+ ".harness/**",
77
+ "artifacts/**"
78
+ ],
79
+ "outputContract": "Plain Markdown implementation contract summary; no file writes.",
80
+ "subtask_prompt": "阅读 ./README.md 与 docs/agent-dag-runner.md,返回 10 行以内的实现契约摘要(只读分析 + 文档建议,不改代码/文档/artifacts)。指出是否适合并行 scout 与窄 writeSet。"
81
+ },
82
+ {
83
+ "id": "scout-src",
84
+ "depends_on": [
85
+ "contract-pi"
86
+ ],
87
+ "role": "scout",
88
+ "executor": "pi",
89
+ "complexity": "LOW",
90
+ "writePolicy": "read-only",
91
+ "allowedPaths": [
92
+ "./src/workflows/dag/**"
93
+ ],
94
+ "forbiddenPaths": [
95
+ ".harness/**",
96
+ "artifacts/**"
97
+ ],
98
+ "outputContract": "Plain Markdown reconnaissance summary of DAG-related source modules; no file writes.",
99
+ "subtask_prompt": "只读审计 ./src/workflows/dag/ 中与 DAG 相关的模块,列出关键文件与职责(不要改文件)。"
100
+ },
101
+ {
102
+ "id": "scout-tests",
103
+ "depends_on": [
104
+ "contract-pi"
105
+ ],
106
+ "role": "scout",
107
+ "executor": "pi",
108
+ "complexity": "LOW",
109
+ "writePolicy": "read-only",
110
+ "allowedPaths": [
111
+ "./test/**"
112
+ ],
113
+ "forbiddenPaths": [
114
+ ".harness/**",
115
+ "artifacts/**"
116
+ ],
117
+ "outputContract": "Plain Markdown test coverage gap summary; no file writes.",
118
+ "subtask_prompt": "只读审计 ./test/ 中与 dag-runner 相关的测试覆盖,列出缺口建议(不要改文件)。"
119
+ },
120
+ {
121
+ "id": "implement-core",
122
+ "depends_on": [
123
+ "scout-src",
124
+ "scout-tests"
125
+ ],
126
+ "role": "implementer",
127
+ "executor": "pi",
128
+ "complexity": "HIGH",
129
+ "writePolicy": "exclusive",
130
+ "writeSet": [
131
+ "./src/workflows/dag/runner.ts"
132
+ ],
133
+ "allowedPaths": [
134
+ "./src/workflows/dag/**"
135
+ ],
136
+ "forbiddenPaths": [
137
+ ".harness/**",
138
+ "artifacts/**"
139
+ ],
140
+ "outputContract": "Implementation summary with changed files, tests run, and residual risks.",
141
+ "subtask_prompt": "基于上游侦察结果,在 writeSet 范围内做最小必要改动并说明风险(若无需改动则输出 no-op 理由)。",
142
+ "toolProfile": "write"
143
+ },
144
+ {
145
+ "id": "review-pi",
146
+ "depends_on": [
147
+ "implement-core"
148
+ ],
149
+ "role": "reviewer",
150
+ "executor": "pi",
151
+ "complexity": "MED",
152
+ "writePolicy": "read-only",
153
+ "allowedPaths": [
154
+ "./**",
155
+ "docs/**"
156
+ ],
157
+ "forbiddenPaths": [
158
+ ".harness/**",
159
+ "artifacts/**"
160
+ ],
161
+ "outputContract": "Plain Markdown review summary; no file writes.",
162
+ "subtask_prompt": "审查上游实现与侦察结论是否一致,列出范围漂移、验证缺口与残余风险(只读,不改文件/文档/artifacts)。"
163
+ },
164
+ {
165
+ "id": "verify-shell",
166
+ "depends_on": [
167
+ "implement-core"
168
+ ],
169
+ "role": "verifier",
170
+ "executor": "shell",
171
+ "complexity": "LOW",
172
+ "writePolicy": "read-only",
173
+ "allowedPaths": [
174
+ "./**"
175
+ ],
176
+ "forbiddenPaths": [
177
+ ".harness/**",
178
+ "artifacts/**"
179
+ ],
180
+ "outputContract": "Archived shell verification stdout/stderr with exit codes; no worktree writes.",
181
+ "subtask_prompt": "Run deterministic loop-agent verification and archive command outputs.",
182
+ "shell": {
183
+ "preset": "loop-agent-standard-verify",
184
+ "cwd": ".",
185
+ "timeoutMs": 300000
186
+ }
187
+ }
188
+ ]
189
+ }
package/harness.json CHANGED
@@ -1,66 +1,66 @@
1
- {
2
- "$schema": "./docs/templates/harness.schema.json",
3
- "version": 1,
4
- "project": "loop-agent",
5
- "governanceRoot": "docs",
6
- "workflowPolicy": {
7
- "defaultImplementationWorkflow": "agent-dag",
8
- "dag": {
9
- "defaultEntry": "dag run-task",
10
- "outputLanguage": "zh-CN",
11
- "profileRouting": {
12
- "minimal": "standard-dag",
13
- "standard": "standard-dag",
14
- "reviewed": "review-gated-dag",
15
- "supervised": "supervised-implementation"
16
- }
17
- },
18
- "humanGatePolicy": {
19
- "defaultMode": "record-only",
20
- "pauseOn": [
21
- "requirement-ambiguity",
22
- "architecture-or-public-contract-risk",
23
- "credential-cost-or-deployment-risk",
24
- "repeated-gate-failure",
25
- "high-or-critical-decision-risk"
26
- ]
27
- }
28
- },
29
- "entrypoints": {
30
- "readme": "README.md",
31
- "agents": "AGENTS.md",
32
- "governanceIndex": "docs/README.md",
33
- "principles": "docs/development-principles.md",
34
- "workflow": "docs/feature-workflow.md",
35
- "verificationMatrix": "docs/verification-matrix.md",
36
- "loopAgentHarness": "docs/loop-agent-harness.md"
37
- },
38
- "artifacts": {
39
- "templatesDir": "docs/templates",
40
- "execPlansDir": "docs/exec-plans",
41
- "progressDir": "docs/progress",
42
- "reportsDir": "docs/reports",
43
- "decisionsDir": "docs/decisions",
44
- "taskPoolDir": ".harness/task-pool"
45
- },
46
- "scripts": {
47
- "checkRepo": "scripts/check-repo.sh",
48
- "checkStructure": "scripts/check-engineering-structure.sh",
49
- "checkDocIndex": "scripts/check-doc-index.sh",
50
- "checkDocLinks": "scripts/check-doc-links.sh",
51
- "checkHarnessRuntimeClean": "scripts/check-harness-runtime-clean.sh",
52
- "checkTaskPoolRoot": "scripts/check-task-pool-root.sh",
53
- "checkInitEvolutionNeeded": "scripts/check-init-evolution-needed.sh",
54
- "checkInitSurface": "scripts/check-init-surface.sh",
55
- "checkProductLineDocs": "scripts/check-product-line-docs.sh",
56
- "ci": "scripts/ci.sh"
57
- },
58
- "executors": {
59
- "pi": {
60
- "description": "Pi planning, review, diagnosis, and bounded writing when DAG toolProfile=write",
61
- "LOW": "gpt-5.3-codex-spark",
62
- "MED": "grok-4.5",
63
- "HIGH": "gpt-5.6-sol"
64
- }
65
- }
66
- }
1
+ {
2
+ "$schema": "./docs/templates/harness.schema.json",
3
+ "version": 1,
4
+ "project": "loop-agent",
5
+ "governanceRoot": "docs",
6
+ "workflowPolicy": {
7
+ "defaultImplementationWorkflow": "agent-dag",
8
+ "dag": {
9
+ "defaultEntry": "dag run-task",
10
+ "outputLanguage": "zh-CN",
11
+ "profileRouting": {
12
+ "minimal": "standard-dag",
13
+ "standard": "standard-dag",
14
+ "reviewed": "review-gated-dag",
15
+ "supervised": "supervised-implementation"
16
+ }
17
+ },
18
+ "humanGatePolicy": {
19
+ "defaultMode": "record-only",
20
+ "pauseOn": [
21
+ "requirement-ambiguity",
22
+ "architecture-or-public-contract-risk",
23
+ "credential-cost-or-deployment-risk",
24
+ "repeated-gate-failure",
25
+ "high-or-critical-decision-risk"
26
+ ]
27
+ }
28
+ },
29
+ "entrypoints": {
30
+ "readme": "README.md",
31
+ "agents": "AGENTS.md",
32
+ "governanceIndex": "docs/README.md",
33
+ "principles": "docs/development-principles.md",
34
+ "workflow": "docs/feature-workflow.md",
35
+ "verificationMatrix": "docs/verification-matrix.md",
36
+ "loopAgentHarness": "docs/loop-agent-harness.md"
37
+ },
38
+ "artifacts": {
39
+ "templatesDir": "docs/templates",
40
+ "execPlansDir": "docs/exec-plans",
41
+ "progressDir": "docs/progress",
42
+ "reportsDir": "docs/reports",
43
+ "decisionsDir": "docs/decisions",
44
+ "taskPoolDir": ".harness/task-pool"
45
+ },
46
+ "scripts": {
47
+ "checkRepo": "scripts/check-repo.sh",
48
+ "checkStructure": "scripts/check-engineering-structure.sh",
49
+ "checkDocIndex": "scripts/check-doc-index.sh",
50
+ "checkDocLinks": "scripts/check-doc-links.sh",
51
+ "checkHarnessRuntimeClean": "scripts/check-harness-runtime-clean.sh",
52
+ "checkTaskPoolRoot": "scripts/check-task-pool-root.sh",
53
+ "checkInitEvolutionNeeded": "scripts/check-init-evolution-needed.sh",
54
+ "checkInitSurface": "scripts/check-init-surface.sh",
55
+ "checkProductLineDocs": "scripts/check-product-line-docs.sh",
56
+ "ci": "scripts/ci.sh"
57
+ },
58
+ "executors": {
59
+ "pi": {
60
+ "description": "Pi planning, review, diagnosis, and bounded writing when DAG toolProfile=write",
61
+ "LOW": "gpt-5.3-codex-spark",
62
+ "MED": "grok-4.5",
63
+ "HIGH": "gpt-5.6-sol"
64
+ }
65
+ }
66
+ }
package/package.json CHANGED
@@ -1,46 +1,88 @@
1
- {
2
- "name": "@tea-agent/loop-agent",
3
- "version": "0.12.0",
4
- "type": "module",
5
- "bin": {
6
- "loop-agent": "bin/loop-agent.js",
7
- "agent-worker": "bin/agent-worker.js"
8
- },
9
- "files": [
10
- "AGENTS.md", "bin/", "dist/", "docs/*.md", "docs/architecture/runtime-boundaries.md",
11
- "docs/architecture/README.md",
12
- "docs/architecture/system-overview.md",
13
- "docs/architecture/dag-execution.md",
14
- "docs/architecture/worker-and-feature.md",
15
- "docs/architecture/facts-and-state.md",
16
- "docs/architecture/evolution.md",
17
- "docs/decisions/README.md", "docs/design/README.md", "docs/exec-plans/README.md",
18
- "docs/exec-plans/active/README.md", "docs/exec-plans/completed/README.md",
19
- "docs/init-surface.manifest.json", "docs/progress/README.md", "docs/reports/README.md",
20
- "docs/skills/", "docs/templates/", "examples/", "harness.json", "skills/",
21
- "scripts/check-product-line-docs.sh", "scripts/check-task-pool-root.sh", "README.md", "CHANGELOG.md"
22
- ],
23
- "publishConfig": { "access": "public" },
24
- "scripts": {
25
- "dev": "node --import tsx/esm src/cli.ts",
26
- "cursor": "node --import tsx/esm src/cli.ts cursor-prompt",
27
- "pi-prompt": "node --import tsx/esm src/cli.ts pi-prompt",
28
- "clean": "node -e \"require('node:fs').rmSync('dist',{recursive:true,force:true})\"",
29
- "build": "npm run clean && tsc -p tsconfig.build.json && node -e \"const fs=require('node:fs');const p='dist/worker/observe/static';fs.mkdirSync(p,{recursive:true});fs.cpSync('src/worker/observe/static',p,{recursive:true});\"",
30
- "prepack": "npm run build",
31
- "prepublishOnly": "npm run typecheck && npm test && npm run build",
32
- "lint": "tsc --noEmit",
33
- "typecheck": "tsc --noEmit",
34
- "test": "node scripts/run-tests.mjs",
35
- "test:fast": "vitest run --config vitest.fast.config.ts",
36
- "test:integration": "vitest run --config vitest.integration.config.ts",
37
- "docs:dev": "npm --prefix website start",
38
- "docs:build": "npm --prefix website run build",
39
- "docs:serve": "npm --prefix website run serve",
40
- "smoke:stale-serial": "node --import tsx/esm scripts/smoke-stale-plan-serial.ts",
41
- "self-host:canary": "node scripts/self-host-canary.mjs"
42
- },
43
- "dependencies": { "commander": "^12.1.0", "semver": "^7.8.5", "yaml": "^2.9.0", "zod": "^3.25.76" },
44
- "optionalDependencies": { "@cursor/sdk": "^1.0.7", "@earendil-works/pi-ai": "*", "@earendil-works/pi-coding-agent": "*" },
45
- "devDependencies": { "@types/node": "^24.6.0", "@types/semver": "^7.7.1", "tsx": "^4.20.6", "typescript": "^5.9.3", "vitest": "^3.2.4" }
46
- }
1
+ {
2
+ "name": "@tea-agent/loop-agent",
3
+ "version": "0.13.0-beta.0",
4
+ "type": "module",
5
+ "bin": {
6
+ "loop-agent": "bin/loop-agent.js",
7
+ "agent-worker": "bin/agent-worker.js"
8
+ },
9
+ "files": [
10
+ "AGENTS.md",
11
+ "bin/",
12
+ "dist/",
13
+ "docs/*.md",
14
+ "docs/architecture/runtime-boundaries.md",
15
+ "docs/architecture/README.md",
16
+ "docs/architecture/system-overview.md",
17
+ "docs/architecture/dag-execution.md",
18
+ "docs/architecture/worker-and-feature.md",
19
+ "docs/architecture/facts-and-state.md",
20
+ "docs/architecture/evolution.md",
21
+ "docs/decisions/README.md",
22
+ "docs/design/README.md",
23
+ "docs/exec-plans/README.md",
24
+ "docs/exec-plans/active/README.md",
25
+ "docs/exec-plans/completed/README.md",
26
+ "docs/init-surface.manifest.json",
27
+ "docs/progress/README.md",
28
+ "docs/reports/README.md",
29
+ "docs/skills/",
30
+ "docs/templates/",
31
+ "examples/",
32
+ "harness.json",
33
+ "skills/",
34
+ "scripts/check-product-line-docs.sh",
35
+ "scripts/check-task-pool-root.sh",
36
+ "scripts/kb-bootstrap-init-skeleton.sh",
37
+ "scripts/kb-query.sh",
38
+ "scripts/kb-query.mjs",
39
+ "scripts/kb-graph-materialize.sh",
40
+ "scripts/kb-graph-materialize.mjs",
41
+ "scripts/kb-graph-promote.sh",
42
+ "scripts/kb-graph-promote.mjs",
43
+ "scripts/kb-graph-incremental-prepare.sh",
44
+ "scripts/kb-graph-incremental-prepare.mjs",
45
+ "README.md",
46
+ "CHANGELOG.md"
47
+ ],
48
+ "publishConfig": {
49
+ "access": "public"
50
+ },
51
+ "scripts": {
52
+ "dev": "node --import tsx/esm src/cli.ts",
53
+ "cursor": "node --import tsx/esm src/cli.ts cursor-prompt",
54
+ "pi-prompt": "node --import tsx/esm src/cli.ts pi-prompt",
55
+ "clean": "node -e \"require('node:fs').rmSync('dist',{recursive:true,force:true})\"",
56
+ "build": "npm run clean && tsc -p tsconfig.build.json && node -e \"const fs=require('node:fs');const p='dist/worker/observe/static';fs.mkdirSync(p,{recursive:true});fs.cpSync('src/worker/observe/static',p,{recursive:true});\"",
57
+ "prepack": "npm run build",
58
+ "prepublishOnly": "node scripts/check-npm-publish-policy.mjs && npm run typecheck && npm test && npm run build",
59
+ "lint": "tsc --noEmit",
60
+ "typecheck": "tsc --noEmit",
61
+ "test": "node scripts/run-tests.mjs",
62
+ "test:fast": "vitest run --config vitest.fast.config.ts",
63
+ "test:integration": "vitest run --config vitest.integration.config.ts",
64
+ "docs:dev": "npm --prefix website start",
65
+ "docs:build": "npm --prefix website run build",
66
+ "docs:serve": "npm --prefix website run serve",
67
+ "smoke:stale-serial": "node --import tsx/esm scripts/smoke-stale-plan-serial.ts",
68
+ "self-host:canary": "node scripts/self-host-canary.mjs"
69
+ },
70
+ "dependencies": {
71
+ "commander": "^12.1.0",
72
+ "semver": "^7.8.5",
73
+ "yaml": "^2.9.0",
74
+ "zod": "^3.25.76"
75
+ },
76
+ "optionalDependencies": {
77
+ "@cursor/sdk": "^1.0.7",
78
+ "@earendil-works/pi-ai": "0.80.10",
79
+ "@earendil-works/pi-coding-agent": "0.80.10"
80
+ },
81
+ "devDependencies": {
82
+ "@types/node": "^24.6.0",
83
+ "@types/semver": "^7.7.1",
84
+ "tsx": "^4.20.6",
85
+ "typescript": "^5.9.3",
86
+ "vitest": "^3.2.4"
87
+ }
88
+ }