@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,280 +1,289 @@
1
- {
2
- "version": 1,
3
- "description": "Machine-checked contract for files that must remain available through npm packaging and target-project initialization.",
4
- "packageRequired": [
5
- "AGENTS.md",
6
- "CHANGELOG.md",
7
- "README.md",
8
- "harness.json",
9
- "bin/loop-agent.js",
10
- "docs/README.md",
11
- "docs/init-surface.manifest.json",
12
- "docs/architecture/runtime-boundaries.md",
13
- "docs/architecture/README.md",
14
- "docs/architecture/system-overview.md",
15
- "docs/architecture/dag-execution.md",
16
- "docs/architecture/worker-and-feature.md",
17
- "docs/architecture/facts-and-state.md",
18
- "docs/architecture/evolution.md",
19
- "docs/skills/README.md",
20
- "docs/skills/vetted-skill-registry.md",
21
- "docs/templates/init-evolution-review.md",
22
- "docs/templates/exec-plan.md",
23
- "docs/templates/production-readiness-checklist.md",
24
- "docs/templates/frontend-task-requirement.md",
25
- "docs/templates/frontend-task-constraints.md",
26
- "docs/templates/frontend-design-contract.md",
27
- "docs/templates/worker-dogfood-setup.md",
28
- "docs/templates/worker-dogfood-evidence.md",
29
- "docs/templates/harness.schema.json",
30
- "docs/templates/interactive-ui-round2-experiment.md",
31
- "docs/templates/product-line/README.md",
32
- "docs/templates/product-line/AGENTS.md",
33
- "docs/templates/product-line/requirement.md",
34
- "docs/templates/product-line/acceptance.yaml",
35
- "docs/templates/product-line/design.md",
36
- "docs/templates/product-line/test-plan.md",
37
- "docs/templates/product-line/task-graph.yaml",
38
- "docs/templates/product-line/task.yaml",
39
- "docs/templates/product-line/closeout.yaml",
40
- "docs/templates/product-line/links.md",
41
- "scripts/check-product-line-docs.sh",
42
- "scripts/check-task-pool-root.sh",
43
- "docs/templates/agent-dag.schema.json",
44
- "examples/example-dag.json",
45
- "skills/agent-worker/SKILL.md",
46
- "skills/agent-worker/references/agent-worker-operator.md",
47
- "skills/loop-agent/SKILL.md",
48
- "skills/loop-agent/references/command-reference.md",
49
- "skills/loop-agent/references/docs-converge.md",
50
- "skills/ai-engineering-context/SKILL.md",
51
- "skills/verification-before-completion/SKILL.md",
52
- "skills/systematic-debugging/SKILL.md",
53
- "skills/requesting-code-review/SKILL.md",
54
- "skills/codebase-scout/SKILL.md",
55
- "skills/test-driven-development/SKILL.md",
56
- "skills/code-review-core/SKILL.md",
57
- "skills/init-capability-evolution/SKILL.md",
58
- "skills/webapp-testing/SKILL.md",
59
- "skills/frontend-implementation/SKILL.md",
60
- "skills/frontend-implementation/references/node-contracts.md",
61
- "skills/frontend-implementation/references/design-spec.md",
62
- "skills/frontend-implementation/references/code-standards.md",
63
- "skills/frontend-design-review/SKILL.md",
64
- "skills/frontend-design-review/references/review-checklist.md",
65
- "skills/frontend-review/SKILL.md",
66
- "skills/frontend-review/references/review-findings.md",
67
- "skills/frontend-verification/SKILL.md",
68
- "skills/frontend-verification/references/verification-checklist.md"
69
- ],
70
- "initFullRequired": [
71
- "README.md",
72
- "AGENTS.md",
73
- ".gitignore",
74
- "harness.json",
75
- "docs/README.md",
76
- "docs/development-principles.md",
77
- "docs/feature-workflow.md",
78
- "docs/verification-matrix.md",
79
- "docs/loop-agent-harness.md",
80
- "docs/templates/init-evolution-review.md",
81
- "docs/templates/production-readiness-checklist.md",
82
- "docs/templates/frontend-task-requirement.md",
83
- "docs/templates/frontend-task-constraints.md",
84
- "docs/templates/frontend-design-contract.md",
85
- "docs/templates/worker-dogfood-setup.md",
86
- "docs/templates/worker-dogfood-evidence.md",
87
- "docs/templates/harness.schema.json",
88
- "docs/templates/interactive-ui-round2-experiment.md",
89
- "docs/templates/product-line/README.md",
90
- "docs/templates/product-line/AGENTS.md",
91
- "docs/templates/product-line/requirement.md",
92
- "docs/templates/product-line/acceptance.yaml",
93
- "docs/templates/product-line/design.md",
94
- "docs/templates/product-line/test-plan.md",
95
- "docs/templates/product-line/task-graph.yaml",
96
- "docs/templates/product-line/task.yaml",
97
- "docs/templates/product-line/closeout.yaml",
98
- "docs/templates/product-line/links.md",
99
- "scripts/check-skill-entry.sh",
100
- "scripts/check-product-line-docs.sh",
101
- "scripts/check-repo.sh",
102
- "scripts/ci-governance.sh",
103
- "scripts/ci-tests.sh",
104
- "scripts/ci.sh",
105
- ".harness/prompts/analyze.md",
106
- ".harness/tasks",
107
- ".harness/dag-runs/active",
108
- ".agents/skills/agent-worker/SKILL.md",
109
- ".agents/skills/agent-worker/references/agent-worker-operator.md",
110
- ".agents/skills/loop-agent/SKILL.md",
111
- ".agents/skills/loop-agent/references/command-reference.md",
112
- ".agents/skills/loop-agent/references/docs-converge.md",
113
- ".agents/skills/ai-engineering-context/SKILL.md",
114
- ".agents/skills/verification-before-completion/SKILL.md",
115
- ".agents/skills/systematic-debugging/SKILL.md",
116
- ".agents/skills/requesting-code-review/SKILL.md",
117
- ".agents/skills/codebase-scout/SKILL.md",
118
- ".agents/skills/test-driven-development/SKILL.md",
119
- ".agents/skills/code-review-core/SKILL.md",
120
- ".agents/skills/init-capability-evolution/SKILL.md",
121
- ".agents/skills/webapp-testing/SKILL.md",
122
- ".agents/skills/frontend-implementation/SKILL.md",
123
- ".agents/skills/frontend-implementation/references/node-contracts.md",
124
- ".agents/skills/frontend-implementation/references/design-spec.md",
125
- ".agents/skills/frontend-implementation/references/code-standards.md",
126
- ".agents/skills/frontend-design-review/SKILL.md",
127
- ".agents/skills/frontend-design-review/references/review-checklist.md",
128
- ".agents/skills/frontend-review/SKILL.md",
129
- ".agents/skills/frontend-review/references/review-findings.md",
130
- ".agents/skills/frontend-verification/SKILL.md",
131
- ".agents/skills/frontend-verification/references/verification-checklist.md"
132
- ],
133
- "initSurface": {
134
- "README.md": "managed-block",
135
- "AGENTS.md": "managed-block",
136
- ".gitignore": "managed-block",
137
- "harness.json": "generated",
138
- "docs/README.md": "generated",
139
- "docs/development-principles.md": "generated",
140
- "docs/feature-workflow.md": "generated",
141
- "docs/verification-matrix.md": "generated",
142
- "docs/loop-agent-harness.md": "generated",
143
- "docs/templates/init-evolution-review.md": "copied",
144
- "docs/templates/production-readiness-checklist.md": "copied",
145
- "docs/templates/frontend-task-requirement.md": "copied",
146
- "docs/templates/frontend-task-constraints.md": "copied",
147
- "docs/templates/frontend-design-contract.md": "copied",
148
- "docs/templates/worker-dogfood-setup.md": "copied",
149
- "docs/templates/worker-dogfood-evidence.md": "copied",
150
- "docs/templates/harness.schema.json": "copied",
151
- "docs/templates/interactive-ui-round2-experiment.md": "copied",
152
- "docs/templates/product-line/README.md": "copied",
153
- "docs/templates/product-line/AGENTS.md": "copied",
154
- "docs/templates/product-line/requirement.md": "copied",
155
- "docs/templates/product-line/acceptance.yaml": "copied",
156
- "docs/templates/product-line/design.md": "copied",
157
- "docs/templates/product-line/test-plan.md": "copied",
158
- "docs/templates/product-line/task-graph.yaml": "copied",
159
- "docs/templates/product-line/task.yaml": "copied",
160
- "docs/templates/product-line/closeout.yaml": "copied",
161
- "docs/templates/product-line/links.md": "copied",
162
- "scripts/check-skill-entry.sh": "generated",
163
- "scripts/check-product-line-docs.sh": "copied",
164
- "scripts/check-repo.sh": "generated",
165
- "scripts/ci-governance.sh": "generated",
166
- "scripts/ci-tests.sh": "generated",
167
- "scripts/ci.sh": "generated",
168
- ".harness/prompts/analyze.md": "generated",
169
- ".harness/tasks": "directory",
170
- ".harness/dag-runs/active": "directory",
171
- ".harness/init-surface.json": "state",
172
- ".agents/skills/agent-worker/SKILL.md": "copied",
173
- ".agents/skills/agent-worker/references/agent-worker-operator.md": "copied",
174
- ".agents/skills/loop-agent/SKILL.md": "copied",
175
- ".agents/skills/loop-agent/references/command-reference.md": "copied",
176
- ".agents/skills/loop-agent/references/docs-converge.md": "copied",
177
- ".agents/skills/ai-engineering-context/SKILL.md": "copied",
178
- ".agents/skills/verification-before-completion/SKILL.md": "copied",
179
- ".agents/skills/systematic-debugging/SKILL.md": "copied",
180
- ".agents/skills/requesting-code-review/SKILL.md": "copied",
181
- ".agents/skills/codebase-scout/SKILL.md": "copied",
182
- ".agents/skills/test-driven-development/SKILL.md": "copied",
183
- ".agents/skills/code-review-core/SKILL.md": "copied",
184
- ".agents/skills/init-capability-evolution/SKILL.md": "copied",
185
- ".agents/skills/webapp-testing/SKILL.md": "copied",
186
- ".agents/skills/frontend-implementation/SKILL.md": "copied",
187
- ".agents/skills/frontend-implementation/references/node-contracts.md": "copied",
188
- ".agents/skills/frontend-implementation/references/design-spec.md": "copied",
189
- ".agents/skills/frontend-implementation/references/code-standards.md": "copied",
190
- ".agents/skills/frontend-design-review/SKILL.md": "copied",
191
- ".agents/skills/frontend-design-review/references/review-checklist.md": "copied",
192
- ".agents/skills/frontend-review/SKILL.md": "copied",
193
- ".agents/skills/frontend-review/references/review-findings.md": "copied",
194
- ".agents/skills/frontend-verification/SKILL.md": "copied",
195
- ".agents/skills/frontend-verification/references/verification-checklist.md": "copied"
196
- },
197
- "packageExcluded": [
198
- "docs/progress/20*.md",
199
- "docs/reports/20*.md",
200
- "docs/exec-plans/active/20*.md",
201
- "docs/exec-plans/completed/20*.md"
202
- ],
203
- "initExcluded": [
204
- "examples/example-dag.json",
205
- "docs/skills/vetted-skill-registry.md"
206
- ],
207
- "reviewTriggers": [
208
- "AGENTS.md",
209
- "README.md",
210
- "CHANGELOG.md",
211
- "harness.json",
212
- "package.json",
213
- "src/commands/init.ts",
214
- "src/workflows/dag/skills.ts",
215
- "src/workflows/dag/init-hybrid.ts",
216
- "src/workflows/dag/skill-instructions.ts",
217
- "docs/templates/**",
218
- "docs/skills/**",
219
- "skills/**",
220
- "scripts/**"
221
- ],
222
- "evolutionReview": {
223
- "defaultMode": "advisory",
224
- "strictReportGlob": "docs/reports/*-init-evolution-review.md",
225
- "tiers": [
226
- {
227
- "name": "model-review",
228
- "severity": "high",
229
- "strictRequiresReport": true,
230
- "description": "Changes that may alter target-project initialization behavior, default DAG role skills, skill resolution, or package/init contracts.",
231
- "patterns": [
232
- "src/commands/init.ts",
233
- "src/workflows/dag/skills.ts",
234
- "src/workflows/dag/init-hybrid.ts",
235
- "src/workflows/dag/skill-instructions.ts",
236
- "src/workflows/dag/prompt.ts",
237
- "src/workflows/dag/node-execution.ts",
238
- "docs/init-surface.manifest.json",
239
- "package.json",
240
- "harness.json",
241
- "AGENTS.md",
242
- "README.md"
243
- ]
244
- },
245
- {
246
- "name": "surface-check",
247
- "severity": "medium",
248
- "strictRequiresReport": false,
249
- "description": "Asset surface changes that usually need deterministic package/init smoke checks but not a model review when the checks pass.",
250
- "patterns": [
251
- "skills/**",
252
- "docs/templates/**",
253
- "docs/skills/**",
254
- "scripts/check-init-surface.sh",
255
- "scripts/check-repo.sh"
256
- ]
257
- },
258
- {
259
- "name": "advisory",
260
- "severity": "low",
261
- "strictRequiresReport": false,
262
- "description": "Documentation and user-facing guidance changes that should be considered but should not slow normal iteration.",
263
- "patterns": [
264
- "CHANGELOG.md",
265
- "website/docs/**",
266
- "docs/*.md",
267
- "docs/architecture/**"
268
- ]
269
- }
270
- ],
271
- "modelReviewQuestions": [
272
- "Does this change alter files or guidance produced by loop-agent init --profile full --merge?",
273
- "Does a new or changed skill need to be bundled, projected to target projects, or documented as optional only?",
274
- "Do target-project AGENTS.md, README managed blocks, governance docs, templates, or script matrix need updates?",
275
- "Does package.json files include every static asset required by the runtime and init projection?",
276
- "Does docs/init-surface.manifest.json still match the intended package and init surface?",
277
- "Do older initialized target projects need a migration note, manual copy guidance, or future init audit/update support?"
278
- ]
279
- }
280
- }
1
+ {
2
+ "version": 1,
3
+ "description": "Machine-checked contract for files that must remain available through npm packaging and target-project initialization.",
4
+ "packageRequired": [
5
+ "AGENTS.md",
6
+ "CHANGELOG.md",
7
+ "README.md",
8
+ "harness.json",
9
+ "bin/loop-agent.js",
10
+ "docs/README.md",
11
+ "docs/init-surface.manifest.json",
12
+ "docs/architecture/runtime-boundaries.md",
13
+ "docs/architecture/README.md",
14
+ "docs/architecture/system-overview.md",
15
+ "docs/architecture/dag-execution.md",
16
+ "docs/architecture/worker-and-feature.md",
17
+ "docs/architecture/facts-and-state.md",
18
+ "docs/architecture/evolution.md",
19
+ "docs/skills/README.md",
20
+ "docs/skills/vetted-skill-registry.md",
21
+ "docs/templates/init-evolution-review.md",
22
+ "docs/templates/exec-plan.md",
23
+ "docs/templates/production-readiness-checklist.md",
24
+ "docs/templates/frontend-task-requirement.md",
25
+ "docs/templates/frontend-task-constraints.md",
26
+ "docs/templates/frontend-design-contract.md",
27
+ "docs/templates/worker-dogfood-setup.md",
28
+ "docs/templates/worker-dogfood-evidence.md",
29
+ "docs/templates/harness.schema.json",
30
+ "docs/templates/interactive-ui-round2-experiment.md",
31
+ "docs/templates/product-line/README.md",
32
+ "docs/templates/product-line/AGENTS.md",
33
+ "docs/templates/product-line/requirement.md",
34
+ "docs/templates/product-line/acceptance.yaml",
35
+ "docs/templates/product-line/design.md",
36
+ "docs/templates/product-line/test-plan.md",
37
+ "docs/templates/product-line/task-graph.yaml",
38
+ "docs/templates/product-line/task.yaml",
39
+ "docs/templates/product-line/closeout.yaml",
40
+ "docs/templates/product-line/links.md",
41
+ "scripts/check-product-line-docs.sh",
42
+ "scripts/check-task-pool-root.sh",
43
+ "docs/templates/agent-dag.schema.json",
44
+ "examples/example-dag.json",
45
+ "skills/agent-worker/SKILL.md",
46
+ "skills/agent-worker/references/agent-worker-operator.md",
47
+ "skills/loop-agent/SKILL.md",
48
+ "skills/loop-agent/references/command-reference.md",
49
+ "skills/loop-agent/references/docs-converge.md",
50
+ "skills/ai-engineering-context/SKILL.md",
51
+ "skills/verification-before-completion/SKILL.md",
52
+ "skills/systematic-debugging/SKILL.md",
53
+ "skills/requesting-code-review/SKILL.md",
54
+ "skills/codebase-scout/SKILL.md",
55
+ "skills/test-driven-development/SKILL.md",
56
+ "skills/code-review-core/SKILL.md",
57
+ "skills/init-capability-evolution/SKILL.md",
58
+ "skills/webapp-testing/SKILL.md",
59
+ "skills/playwright-cli/SKILL.md",
60
+ "skills/playwright-cli-case-generator/SKILL.md",
61
+ "skills/frontend-implementation/SKILL.md",
62
+ "skills/frontend-implementation/references/node-contracts.md",
63
+ "skills/frontend-implementation/references/design-spec.md",
64
+ "skills/frontend-implementation/references/code-standards.md",
65
+ "skills/frontend-design-review/SKILL.md",
66
+ "skills/frontend-design-review/references/review-checklist.md",
67
+ "skills/frontend-review/SKILL.md",
68
+ "skills/frontend-review/references/review-findings.md",
69
+ "skills/frontend-verification/SKILL.md",
70
+ "skills/frontend-verification/references/verification-checklist.md",
71
+ "docs/templates/backend-test-analysis.schema.json"
72
+ ],
73
+ "initFullRequired": [
74
+ "README.md",
75
+ "AGENTS.md",
76
+ ".gitignore",
77
+ "harness.json",
78
+ "docs/README.md",
79
+ "docs/development-principles.md",
80
+ "docs/feature-workflow.md",
81
+ "docs/verification-matrix.md",
82
+ "docs/loop-agent-harness.md",
83
+ "docs/templates/init-evolution-review.md",
84
+ "docs/templates/production-readiness-checklist.md",
85
+ "docs/templates/frontend-task-requirement.md",
86
+ "docs/templates/frontend-task-constraints.md",
87
+ "docs/templates/frontend-design-contract.md",
88
+ "docs/templates/worker-dogfood-setup.md",
89
+ "docs/templates/worker-dogfood-evidence.md",
90
+ "docs/templates/harness.schema.json",
91
+ "docs/templates/interactive-ui-round2-experiment.md",
92
+ "docs/templates/product-line/README.md",
93
+ "docs/templates/product-line/AGENTS.md",
94
+ "docs/templates/product-line/requirement.md",
95
+ "docs/templates/product-line/acceptance.yaml",
96
+ "docs/templates/product-line/design.md",
97
+ "docs/templates/product-line/test-plan.md",
98
+ "docs/templates/product-line/task-graph.yaml",
99
+ "docs/templates/product-line/task.yaml",
100
+ "docs/templates/product-line/closeout.yaml",
101
+ "docs/templates/product-line/links.md",
102
+ "scripts/check-skill-entry.sh",
103
+ "scripts/check-product-line-docs.sh",
104
+ "scripts/check-repo.sh",
105
+ "scripts/ci-governance.sh",
106
+ "scripts/ci-tests.sh",
107
+ "scripts/ci.sh",
108
+ ".harness/prompts/analyze.md",
109
+ ".harness/tasks",
110
+ ".harness/dag-runs/active",
111
+ ".agents/skills/agent-worker/SKILL.md",
112
+ ".agents/skills/agent-worker/references/agent-worker-operator.md",
113
+ ".agents/skills/loop-agent/SKILL.md",
114
+ ".agents/skills/loop-agent/references/command-reference.md",
115
+ ".agents/skills/loop-agent/references/docs-converge.md",
116
+ ".agents/skills/ai-engineering-context/SKILL.md",
117
+ ".agents/skills/verification-before-completion/SKILL.md",
118
+ ".agents/skills/systematic-debugging/SKILL.md",
119
+ ".agents/skills/requesting-code-review/SKILL.md",
120
+ ".agents/skills/codebase-scout/SKILL.md",
121
+ ".agents/skills/test-driven-development/SKILL.md",
122
+ ".agents/skills/code-review-core/SKILL.md",
123
+ ".agents/skills/init-capability-evolution/SKILL.md",
124
+ ".agents/skills/webapp-testing/SKILL.md",
125
+ ".agents/skills/playwright-cli/SKILL.md",
126
+ ".agents/skills/playwright-cli-case-generator/SKILL.md",
127
+ ".agents/skills/frontend-implementation/SKILL.md",
128
+ ".agents/skills/frontend-implementation/references/node-contracts.md",
129
+ ".agents/skills/frontend-implementation/references/design-spec.md",
130
+ ".agents/skills/frontend-implementation/references/code-standards.md",
131
+ ".agents/skills/frontend-design-review/SKILL.md",
132
+ ".agents/skills/frontend-design-review/references/review-checklist.md",
133
+ ".agents/skills/frontend-review/SKILL.md",
134
+ ".agents/skills/frontend-review/references/review-findings.md",
135
+ ".agents/skills/frontend-verification/SKILL.md",
136
+ ".agents/skills/frontend-verification/references/verification-checklist.md",
137
+ "docs/templates/backend-test-analysis.schema.json"
138
+ ],
139
+ "initSurface": {
140
+ "README.md": "managed-block",
141
+ "AGENTS.md": "managed-block",
142
+ ".gitignore": "managed-block",
143
+ "harness.json": "generated",
144
+ "docs/README.md": "generated",
145
+ "docs/development-principles.md": "generated",
146
+ "docs/feature-workflow.md": "generated",
147
+ "docs/verification-matrix.md": "generated",
148
+ "docs/loop-agent-harness.md": "generated",
149
+ "docs/templates/init-evolution-review.md": "copied",
150
+ "docs/templates/production-readiness-checklist.md": "copied",
151
+ "docs/templates/frontend-task-requirement.md": "copied",
152
+ "docs/templates/frontend-task-constraints.md": "copied",
153
+ "docs/templates/frontend-design-contract.md": "copied",
154
+ "docs/templates/worker-dogfood-setup.md": "copied",
155
+ "docs/templates/worker-dogfood-evidence.md": "copied",
156
+ "docs/templates/harness.schema.json": "copied",
157
+ "docs/templates/interactive-ui-round2-experiment.md": "copied",
158
+ "docs/templates/product-line/README.md": "copied",
159
+ "docs/templates/product-line/AGENTS.md": "copied",
160
+ "docs/templates/product-line/requirement.md": "copied",
161
+ "docs/templates/product-line/acceptance.yaml": "copied",
162
+ "docs/templates/product-line/design.md": "copied",
163
+ "docs/templates/product-line/test-plan.md": "copied",
164
+ "docs/templates/product-line/task-graph.yaml": "copied",
165
+ "docs/templates/product-line/task.yaml": "copied",
166
+ "docs/templates/product-line/closeout.yaml": "copied",
167
+ "docs/templates/product-line/links.md": "copied",
168
+ "scripts/check-skill-entry.sh": "generated",
169
+ "scripts/check-product-line-docs.sh": "copied",
170
+ "scripts/check-repo.sh": "generated",
171
+ "scripts/ci-governance.sh": "generated",
172
+ "scripts/ci-tests.sh": "generated",
173
+ "scripts/ci.sh": "generated",
174
+ ".harness/prompts/analyze.md": "generated",
175
+ ".harness/tasks": "directory",
176
+ ".harness/dag-runs/active": "directory",
177
+ ".harness/init-surface.json": "state",
178
+ ".agents/skills/agent-worker/SKILL.md": "copied",
179
+ ".agents/skills/agent-worker/references/agent-worker-operator.md": "copied",
180
+ ".agents/skills/loop-agent/SKILL.md": "copied",
181
+ ".agents/skills/loop-agent/references/command-reference.md": "copied",
182
+ ".agents/skills/loop-agent/references/docs-converge.md": "copied",
183
+ ".agents/skills/ai-engineering-context/SKILL.md": "copied",
184
+ ".agents/skills/verification-before-completion/SKILL.md": "copied",
185
+ ".agents/skills/systematic-debugging/SKILL.md": "copied",
186
+ ".agents/skills/requesting-code-review/SKILL.md": "copied",
187
+ ".agents/skills/codebase-scout/SKILL.md": "copied",
188
+ ".agents/skills/test-driven-development/SKILL.md": "copied",
189
+ ".agents/skills/code-review-core/SKILL.md": "copied",
190
+ ".agents/skills/init-capability-evolution/SKILL.md": "copied",
191
+ ".agents/skills/webapp-testing/SKILL.md": "copied",
192
+ ".agents/skills/playwright-cli/SKILL.md": "copied",
193
+ ".agents/skills/playwright-cli-case-generator/SKILL.md": "copied",
194
+ ".agents/skills/frontend-implementation/SKILL.md": "copied",
195
+ ".agents/skills/frontend-implementation/references/node-contracts.md": "copied",
196
+ ".agents/skills/frontend-implementation/references/design-spec.md": "copied",
197
+ ".agents/skills/frontend-implementation/references/code-standards.md": "copied",
198
+ ".agents/skills/frontend-design-review/SKILL.md": "copied",
199
+ ".agents/skills/frontend-design-review/references/review-checklist.md": "copied",
200
+ ".agents/skills/frontend-review/SKILL.md": "copied",
201
+ ".agents/skills/frontend-review/references/review-findings.md": "copied",
202
+ ".agents/skills/frontend-verification/SKILL.md": "copied",
203
+ ".agents/skills/frontend-verification/references/verification-checklist.md": "copied",
204
+ "docs/templates/backend-test-analysis.schema.json": "copied"
205
+ },
206
+ "packageExcluded": [
207
+ "docs/progress/20*.md",
208
+ "docs/reports/20*.md",
209
+ "docs/exec-plans/active/20*.md",
210
+ "docs/exec-plans/completed/20*.md"
211
+ ],
212
+ "initExcluded": [
213
+ "examples/example-dag.json",
214
+ "docs/skills/vetted-skill-registry.md"
215
+ ],
216
+ "reviewTriggers": [
217
+ "AGENTS.md",
218
+ "README.md",
219
+ "CHANGELOG.md",
220
+ "harness.json",
221
+ "package.json",
222
+ "src/commands/init.ts",
223
+ "src/workflows/dag/skills.ts",
224
+ "src/workflows/dag/init-hybrid.ts",
225
+ "src/workflows/dag/skill-instructions.ts",
226
+ "docs/templates/**",
227
+ "docs/skills/**",
228
+ "skills/**",
229
+ "scripts/**"
230
+ ],
231
+ "evolutionReview": {
232
+ "defaultMode": "advisory",
233
+ "strictReportGlob": "docs/reports/*-init-evolution-review.md",
234
+ "tiers": [
235
+ {
236
+ "name": "model-review",
237
+ "severity": "high",
238
+ "strictRequiresReport": true,
239
+ "description": "Changes that may alter target-project initialization behavior, default DAG role skills, skill resolution, or package/init contracts.",
240
+ "patterns": [
241
+ "src/commands/init.ts",
242
+ "src/workflows/dag/skills.ts",
243
+ "src/workflows/dag/init-hybrid.ts",
244
+ "src/workflows/dag/skill-instructions.ts",
245
+ "src/workflows/dag/prompt.ts",
246
+ "src/workflows/dag/node-execution.ts",
247
+ "docs/init-surface.manifest.json",
248
+ "package.json",
249
+ "harness.json",
250
+ "AGENTS.md",
251
+ "README.md"
252
+ ]
253
+ },
254
+ {
255
+ "name": "surface-check",
256
+ "severity": "medium",
257
+ "strictRequiresReport": false,
258
+ "description": "Asset surface changes that usually need deterministic package/init smoke checks but not a model review when the checks pass.",
259
+ "patterns": [
260
+ "skills/**",
261
+ "docs/templates/**",
262
+ "docs/skills/**",
263
+ "scripts/check-init-surface.sh",
264
+ "scripts/check-repo.sh"
265
+ ]
266
+ },
267
+ {
268
+ "name": "advisory",
269
+ "severity": "low",
270
+ "strictRequiresReport": false,
271
+ "description": "Documentation and user-facing guidance changes that should be considered but should not slow normal iteration.",
272
+ "patterns": [
273
+ "CHANGELOG.md",
274
+ "website/docs/**",
275
+ "docs/*.md",
276
+ "docs/architecture/**"
277
+ ]
278
+ }
279
+ ],
280
+ "modelReviewQuestions": [
281
+ "Does this change alter files or guidance produced by loop-agent init --profile full --merge?",
282
+ "Does a new or changed skill need to be bundled, projected to target projects, or documented as optional only?",
283
+ "Do target-project AGENTS.md, README managed blocks, governance docs, templates, or script matrix need updates?",
284
+ "Does package.json files include every static asset required by the runtime and init projection?",
285
+ "Does docs/init-surface.manifest.json still match the intended package and init surface?",
286
+ "Do older initialized target projects need a migration note, manual copy guidance, or future init audit/update support?"
287
+ ]
288
+ }
289
+ }