@tea-agent/loop-agent 0.13.0 → 0.14.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 (270) hide show
  1. package/AGENTS.md +157 -157
  2. package/CHANGELOG.md +73 -301
  3. package/README.md +338 -334
  4. package/bin/agent-worker.js +22 -22
  5. package/bin/loop-agent.js +21 -21
  6. package/dist/commands/cursor-prompt.js +6 -6
  7. package/dist/commands/init.js +505 -505
  8. package/dist/commands/loop-benchmark.js +11 -11
  9. package/dist/commands/pi-reuse-benchmark.js +16 -16
  10. package/dist/executors/pi-event-serializer.js +33 -11
  11. package/dist/sidecars/cursor-prompt/executor.js +1 -1
  12. package/dist/task/runtime.js +27 -27
  13. package/dist/worker/observe/spec-evidence.js +19 -10
  14. package/dist/worker/observe/static/api.js +46 -46
  15. package/dist/worker/observe/static/app.js +151 -150
  16. package/dist/worker/observe/static/constants.js +156 -148
  17. package/dist/worker/observe/static/copy.js +67 -67
  18. package/dist/worker/observe/static/dag-helpers.js +201 -172
  19. package/dist/worker/observe/static/dag-layout.d.ts +31 -31
  20. package/dist/worker/observe/static/dag-layout.js +83 -83
  21. package/dist/worker/observe/static/dag-model.js +72 -72
  22. package/dist/worker/observe/static/dom.js +122 -122
  23. package/dist/worker/observe/static/format-pool.d.ts +71 -0
  24. package/dist/worker/observe/static/format-pool.js +134 -67
  25. package/dist/worker/observe/static/format.js +317 -292
  26. package/dist/worker/observe/static/index.html +350 -308
  27. package/dist/worker/observe/static/kpi.js +100 -94
  28. package/dist/worker/observe/static/markdown-render.js +124 -0
  29. package/dist/worker/observe/static/relations.js +133 -133
  30. package/dist/worker/observe/static/router.js +93 -93
  31. package/dist/worker/observe/static/run-processing.js +148 -148
  32. package/dist/worker/observe/static/shell-chrome.js +74 -68
  33. package/dist/worker/observe/static/state.js +273 -267
  34. package/dist/worker/observe/static/styles.css +2504 -1902
  35. package/dist/worker/observe/static/views/batch.js +227 -227
  36. package/dist/worker/observe/static/views/dag-graph.js +172 -172
  37. package/dist/worker/observe/static/views/dag-inspector.js +530 -627
  38. package/dist/worker/observe/static/views/dag.js +371 -371
  39. package/dist/worker/observe/static/views/dashboard.js +86 -100
  40. package/dist/worker/observe/static/views/failures.js +143 -143
  41. package/dist/worker/observe/static/views/feature.js +492 -492
  42. package/dist/worker/observe/static/views/pool.js +708 -350
  43. package/dist/worker/observe/static/views/run.js +453 -453
  44. package/dist/worker/observe/static/views/session-timeline.js +771 -219
  45. package/dist/worker/observe/static/views/shell.js +7 -7
  46. package/dist/worker/observe/static/views/task.js +314 -314
  47. package/dist/worker/observe/static/views/timeline.js +163 -163
  48. package/dist/workflows/dag/canvas-observer.js +275 -275
  49. package/docs/README.md +105 -104
  50. package/docs/agent-dag-recovery-playbook.md +195 -195
  51. package/docs/agent-dag-runner.md +67 -67
  52. package/docs/architecture/README.md +26 -26
  53. package/docs/architecture/dag-execution.md +140 -140
  54. package/docs/architecture/evolution.md +54 -54
  55. package/docs/architecture/facts-and-state.md +71 -71
  56. package/docs/architecture/runtime-boundaries.md +191 -191
  57. package/docs/architecture/system-overview.md +93 -93
  58. package/docs/architecture/worker-and-feature.md +85 -85
  59. package/docs/cursor-prompt-sidecar.md +36 -36
  60. package/docs/decisions/README.md +18 -18
  61. package/docs/design/README.md +167 -167
  62. package/docs/development-principles.md +73 -73
  63. package/docs/exec-plans/README.md +6 -6
  64. package/docs/exec-plans/active/README.md +2 -1
  65. package/docs/exec-plans/completed/README.md +105 -104
  66. package/docs/feature-workflow.md +414 -414
  67. package/docs/harness-methodology-debugging.md +153 -153
  68. package/docs/harness-methodology-tdd.md +130 -130
  69. package/docs/harness-methodology-verification.md +27 -27
  70. package/docs/init-surface.manifest.json +307 -307
  71. package/docs/loop-agent-harness.md +142 -142
  72. package/docs/production-readiness.md +96 -96
  73. package/docs/progress/README.md +59 -58
  74. package/docs/reports/README.md +123 -119
  75. package/docs/skills/README.md +7 -7
  76. package/docs/skills/vetted-skill-registry.md +29 -29
  77. package/docs/templates/adr.md +60 -60
  78. package/docs/templates/agent-dag-authority-surface-audit.prompt.md +94 -94
  79. package/docs/templates/agent-dag-decision-envelope.schema.json +213 -213
  80. package/docs/templates/agent-dag-decision-gate-dogfood-report.md +117 -117
  81. package/docs/templates/agent-dag-decision-gate.prompt.md +246 -246
  82. package/docs/templates/agent-dag-process-supervisor.prompt.md +98 -98
  83. package/docs/templates/agent-dag-report.schema.json +473 -473
  84. package/docs/templates/agent-dag-review-verdict.prompt.md +68 -68
  85. package/docs/templates/agent-dag.base.json +190 -190
  86. package/docs/templates/agent-dag.final-verification.json +185 -185
  87. package/docs/templates/agent-dag.schema.json +411 -411
  88. package/docs/templates/agent-dag.supervised-implementation.json +620 -620
  89. package/docs/templates/backend-test-analysis.schema.json +44 -44
  90. package/docs/templates/backend-test-case-manifest.schema.json +190 -190
  91. package/docs/templates/backend-test-dag.classify.prompt.md +75 -75
  92. package/docs/templates/backend-test-dag.generate-pytest.prompt.md +204 -204
  93. package/docs/templates/backend-test-dag.json +559 -559
  94. package/docs/templates/backend-test-dag.retrospect.prompt.md +139 -139
  95. package/docs/templates/backend-test-dag.review-cases.prompt.md +83 -83
  96. package/docs/templates/backend-test-execution.schema.json +133 -133
  97. package/docs/templates/backend-test-result.schema.json +99 -99
  98. package/docs/templates/exec-plan.md +64 -64
  99. package/docs/templates/feature-spec.md +53 -53
  100. package/docs/templates/frontend-design-contract.md +42 -42
  101. package/docs/templates/frontend-eval/fixtures/failures/01-type-build-error.md +17 -17
  102. package/docs/templates/frontend-eval/fixtures/failures/02-unit-component-test-fail.md +16 -16
  103. package/docs/templates/frontend-eval/fixtures/failures/03-fixture-schema-drift.md +16 -16
  104. package/docs/templates/frontend-eval/fixtures/failures/04-missing-loading-empty-error-state.md +16 -16
  105. package/docs/templates/frontend-eval/fixtures/failures/05-forbidden-write-writeset-expansion.md +16 -16
  106. package/docs/templates/frontend-eval/fixtures/failures/06-unapproved-dependency-add.md +16 -16
  107. package/docs/templates/frontend-eval/fixtures/failures/07-mock-production-on.md +21 -21
  108. package/docs/templates/frontend-eval/fixtures/functional/01-simple-component-style.md +29 -29
  109. package/docs/templates/frontend-eval/fixtures/functional/02-form-validation.md +28 -28
  110. package/docs/templates/frontend-eval/fixtures/functional/03-list-detail-page.md +28 -28
  111. package/docs/templates/frontend-eval/fixtures/functional/04-api-mock.md +29 -29
  112. package/docs/templates/frontend-eval/fixtures/functional/05-permission-auth-gated-ui.md +27 -27
  113. package/docs/templates/frontend-eval/fixtures/functional/06-ssr-server-client-boundary.md +28 -28
  114. package/docs/templates/frontend-eval/fixtures/functional/07-shared-public-component-api.md +28 -28
  115. package/docs/templates/frontend-eval/fixtures/functional/08-pure-local-no-remote.md +27 -27
  116. package/docs/templates/frontend-eval/metrics.md +138 -138
  117. package/docs/templates/frontend-eval/smoke-targets.md +53 -53
  118. package/docs/templates/frontend-implementation-contract.schema.json +27 -27
  119. package/docs/templates/frontend-task-constraints.md +35 -35
  120. package/docs/templates/frontend-task-requirement.md +70 -70
  121. package/docs/templates/frontend-test-dag.generate-cases.prompt.md +5 -5
  122. package/docs/templates/frontend-test-dag.json +23 -23
  123. package/docs/templates/frontend-test-dag.retrieve-context.prompt.md +3 -3
  124. package/docs/templates/frontend-test-dag.retrospect.prompt.md +3 -3
  125. package/docs/templates/frontend-test-dag.review-cases.prompt.md +3 -3
  126. package/docs/templates/frontend-test-dag.review-execution.prompt.md +3 -3
  127. package/docs/templates/harness.schema.json +221 -221
  128. package/docs/templates/hybrid-dag.json +188 -188
  129. package/docs/templates/init-evolution-review.md +35 -35
  130. package/docs/templates/interactive-ui-round2-experiment.md +66 -66
  131. package/docs/templates/knowledge-graph-bootstrap-dag.json +118 -118
  132. package/docs/templates/knowledge-sync-dag.json +178 -178
  133. package/docs/templates/knowledge-sync-draft.schema.json +71 -71
  134. package/docs/templates/product-line/AGENTS.md +8 -8
  135. package/docs/templates/product-line/README.md +9 -9
  136. package/docs/templates/product-line/acceptance.yaml +14 -14
  137. package/docs/templates/product-line/closeout.yaml +9 -9
  138. package/docs/templates/product-line/design.md +13 -13
  139. package/docs/templates/product-line/links.md +10 -10
  140. package/docs/templates/product-line/requirement.md +17 -17
  141. package/docs/templates/product-line/task-graph.yaml +15 -15
  142. package/docs/templates/product-line/task.yaml +64 -64
  143. package/docs/templates/product-line/test-plan.md +7 -7
  144. package/docs/templates/production-readiness-checklist.md +57 -57
  145. package/docs/templates/progress-log.md +17 -17
  146. package/docs/templates/project-start-checklist.md +9 -9
  147. package/docs/templates/qa-report.md +48 -48
  148. package/docs/templates/sprint-contract.md +29 -29
  149. package/docs/templates/worker-dogfood-evidence.md +80 -80
  150. package/docs/templates/worker-dogfood-setup.md +68 -68
  151. package/docs/verification-matrix.md +70 -70
  152. package/examples/decision-gate-agent-dag.json +173 -173
  153. package/examples/example-dag.json +46 -46
  154. package/examples/hybrid-loop-agent-dag.json +188 -188
  155. package/harness.json +66 -66
  156. package/package.json +88 -52
  157. package/scripts/check-product-line-docs.sh +29 -29
  158. package/scripts/check-task-pool-root.sh +32 -32
  159. package/scripts/kb-bootstrap-init-skeleton.sh +240 -240
  160. package/scripts/kb-graph-incremental-prepare.mjs +386 -386
  161. package/scripts/kb-graph-incremental-prepare.sh +5 -5
  162. package/scripts/kb-graph-materialize.mjs +105 -105
  163. package/scripts/kb-graph-materialize.sh +4 -4
  164. package/scripts/kb-graph-promote.mjs +164 -164
  165. package/scripts/kb-graph-promote.sh +4 -4
  166. package/scripts/kb-query.mjs +554 -554
  167. package/scripts/kb-query.sh +5 -5
  168. package/skills/agent-worker/SKILL.md +39 -39
  169. package/skills/agent-worker/references/agent-worker-operator.md +60 -60
  170. package/skills/ai-engineering-context/SKILL.md +48 -48
  171. package/skills/analyze-product-dependencies/SKILL.md +67 -67
  172. package/skills/analyze-product-dependencies/agents/openai.yaml +4 -4
  173. package/skills/analyze-product-dependencies/references/api-documentation-schema.md +30 -30
  174. package/skills/analyze-product-dependencies/references/dependency-analysis-schema.md +28 -28
  175. package/skills/analyze-product-dependencies/references/example.md +76 -76
  176. package/skills/analyze-product-dependencies/references/forward-test-cases.md +35 -35
  177. package/skills/analyze-product-dependencies/references/input-contract.md +11 -11
  178. package/skills/analyze-product-dependencies/references/scouting-rules.md +61 -61
  179. package/skills/analyze-product-dependencies/scripts/test-validators.mjs +267 -267
  180. package/skills/analyze-product-dependencies/scripts/validate-api-documentation.mjs +101 -101
  181. package/skills/analyze-product-dependencies/scripts/validate-dependency-analysis.mjs +142 -142
  182. package/skills/analyze-product-dependencies/scripts/validate-product-requirement-input.mjs +76 -76
  183. package/skills/analyze-product-dependencies/scripts/validation-helpers.mjs +146 -146
  184. package/skills/analyze-product-requirements/SKILL.md +90 -90
  185. package/skills/analyze-product-requirements/agents/openai.yaml +4 -4
  186. package/skills/analyze-product-requirements/references/acceptance-criteria.md +91 -91
  187. package/skills/analyze-product-requirements/references/clarification-and-knowledge.md +56 -56
  188. package/skills/analyze-product-requirements/references/example.md +86 -86
  189. package/skills/analyze-product-requirements/references/forward-test-cases.md +66 -66
  190. package/skills/analyze-product-requirements/references/product-analysis-schema.md +32 -32
  191. package/skills/analyze-product-requirements/references/product-requirement-schema.md +33 -33
  192. package/skills/analyze-product-requirements/references/requirement-clarification-schema.md +35 -35
  193. package/skills/analyze-product-requirements/scripts/test-validators.mjs +193 -193
  194. package/skills/analyze-product-requirements/scripts/validate-product-analysis.mjs +69 -69
  195. package/skills/analyze-product-requirements/scripts/validate-product-requirement.mjs +97 -97
  196. package/skills/analyze-product-requirements/scripts/validate-requirement-clarification.mjs +98 -98
  197. package/skills/analyze-product-requirements/scripts/validation-helpers.mjs +156 -156
  198. package/skills/browser-tools/SKILL.md +196 -196
  199. package/skills/browser-tools/browser-content.js +103 -103
  200. package/skills/browser-tools/browser-cookies.js +35 -35
  201. package/skills/browser-tools/browser-eval.js +53 -53
  202. package/skills/browser-tools/browser-hn-scraper.js +108 -108
  203. package/skills/browser-tools/browser-nav.js +44 -44
  204. package/skills/browser-tools/browser-pick.js +162 -162
  205. package/skills/browser-tools/browser-screenshot.js +34 -34
  206. package/skills/browser-tools/browser-start.js +86 -86
  207. package/skills/browser-tools/package-lock.json +2556 -2556
  208. package/skills/browser-tools/package.json +19 -19
  209. package/skills/code-review-core/SKILL.md +20 -20
  210. package/skills/codebase-scout/SKILL.md +19 -19
  211. package/skills/frontend-design-review/SKILL.md +66 -66
  212. package/skills/frontend-design-review/references/review-checklist.md +58 -58
  213. package/skills/frontend-implementation/SKILL.md +49 -49
  214. package/skills/frontend-implementation/references/code-standards.md +32 -32
  215. package/skills/frontend-implementation/references/design-spec.md +46 -46
  216. package/skills/frontend-implementation/references/node-contracts.md +27 -27
  217. package/skills/frontend-review/SKILL.md +59 -59
  218. package/skills/frontend-review/references/review-findings.md +47 -47
  219. package/skills/frontend-verification/SKILL.md +53 -53
  220. package/skills/frontend-verification/references/verification-checklist.md +68 -68
  221. package/skills/grill-me/SKILL.md +10 -10
  222. package/skills/grill-with-docs/SKILL.md +88 -88
  223. package/skills/grill-with-docs/adr-format.md +47 -47
  224. package/skills/grill-with-docs/context-format.md +60 -60
  225. package/skills/init-capability-evolution/SKILL.md +70 -70
  226. package/skills/loop-agent/SKILL.md +151 -151
  227. package/skills/loop-agent/references/README.md +67 -67
  228. package/skills/loop-agent/references/command-reference.md +527 -527
  229. package/skills/loop-agent/references/docs-converge.md +126 -126
  230. package/skills/loop-agent/references/harness-policy.md +263 -263
  231. package/skills/loop-agent/references/hybrid-dag.md +243 -243
  232. package/skills/loop-agent/references/learned/README.md +21 -21
  233. package/skills/loop-agent/references/long-running-loop.md +57 -57
  234. package/skills/loop-agent/references/model-routing.md +36 -36
  235. package/skills/loop-agent/references/multi-worktree.md +54 -54
  236. package/skills/loop-agent/references/one-shot-runs.md +85 -85
  237. package/skills/loop-agent/references/orchestrator-and-interventions.md +169 -169
  238. package/skills/loop-agent/references/pi-prompt.md +23 -23
  239. package/skills/loop-agent/references/pi-subagent-assisted-mode.md +84 -84
  240. package/skills/loop-agent/references/post-implementation-and-patterns.md +44 -44
  241. package/skills/loop-agent/references/task-workflow.md +89 -89
  242. package/skills/loop-agent/references/verification-and-failure-handling.md +141 -141
  243. package/skills/playwright-cli/SKILL.md +420 -420
  244. package/skills/playwright-cli/references/element-attributes.md +23 -23
  245. package/skills/playwright-cli/references/playwright-tests.md +39 -39
  246. package/skills/playwright-cli/references/request-mocking.md +87 -87
  247. package/skills/playwright-cli/references/running-code.md +241 -241
  248. package/skills/playwright-cli/references/session-management.md +225 -225
  249. package/skills/playwright-cli/references/storage-state.md +275 -275
  250. package/skills/playwright-cli/references/test-generation.md +433 -433
  251. package/skills/playwright-cli/references/tracing.md +139 -139
  252. package/skills/playwright-cli/references/video-recording.md +143 -143
  253. package/skills/playwright-cli-case-generator/SKILL.md +74 -74
  254. package/skills/requesting-code-review/SKILL.md +101 -101
  255. package/skills/requesting-code-review/code-reviewer.md +168 -168
  256. package/skills/systematic-debugging/CREATION-LOG.md +119 -119
  257. package/skills/systematic-debugging/SKILL.md +296 -296
  258. package/skills/systematic-debugging/condition-based-waiting-example.ts +158 -158
  259. package/skills/systematic-debugging/condition-based-waiting.md +115 -115
  260. package/skills/systematic-debugging/defense-in-depth.md +122 -122
  261. package/skills/systematic-debugging/find-polluter.sh +63 -63
  262. package/skills/systematic-debugging/root-cause-tracing.md +169 -169
  263. package/skills/systematic-debugging/test-academic.md +14 -14
  264. package/skills/systematic-debugging/test-pressure-1.md +58 -58
  265. package/skills/systematic-debugging/test-pressure-2.md +68 -68
  266. package/skills/systematic-debugging/test-pressure-3.md +69 -69
  267. package/skills/test-driven-development/SKILL.md +20 -20
  268. package/skills/using-git-worktrees/SKILL.md +215 -215
  269. package/skills/verification-before-completion/SKILL.md +154 -154
  270. package/skills/webapp-testing/SKILL.md +19 -19
@@ -94,523 +94,523 @@ const COMPAT_PROMPTS = {
94
94
  ].join("\n"),
95
95
  };
96
96
  const GOVERNANCE_ROOT_TOKEN = "__LOOP_AGENT_GOVERNANCE_ROOT__";
97
- const INIT_CHECK_ENGINEERING_STRUCTURE_SH = `#!/usr/bin/env bash
98
- set -euo pipefail
99
-
100
- ROOT_DIR="$(cd "$(dirname "\${BASH_SOURCE[0]}")/.." && pwd)"
101
- cd "\${ROOT_DIR}"
102
-
103
- required_paths=(
104
- "README.md"
105
- "harness.json"
106
- "AGENTS.md"
107
- "${GOVERNANCE_ROOT_TOKEN}/README.md"
108
- "${GOVERNANCE_ROOT_TOKEN}/development-principles.md"
109
- "${GOVERNANCE_ROOT_TOKEN}/feature-workflow.md"
110
- "${GOVERNANCE_ROOT_TOKEN}/verification-matrix.md"
111
- "${GOVERNANCE_ROOT_TOKEN}/architecture/runtime-boundaries.md"
112
- "${GOVERNANCE_ROOT_TOKEN}/templates"
113
- ".agents/skills/loop-agent/SKILL.md"
114
- ".harness/prompts/analyze.md"
115
- ".harness/prompts/plan.md"
116
- ".harness/tasks"
117
- ".harness/dag-runs/active"
118
- ".harness/dag-runs/completed"
119
- ".harness/dag-runs/paused"
120
- ".harness/runs/active"
121
- ".harness/runs/completed"
122
- ".harness/runs/failed"
123
- "scripts/check-engineering-structure.sh"
124
- "scripts/check-doc-index.sh"
125
- "scripts/check-doc-links.sh"
126
- "scripts/check-active-plan-status.sh"
127
- "scripts/check-exec-plan-index-sync.sh"
128
- "scripts/check-harness-runtime-clean.sh"
129
- "scripts/check-architecture-boundaries.sh"
130
- "scripts/check-skill-entry.sh"
131
- "scripts/check-repo.sh"
132
- "scripts/ci-governance.sh"
133
- "scripts/ci-tests.sh"
134
- "scripts/ci.sh"
135
- )
136
-
137
- missing=()
138
- for item in "\${required_paths[@]}"; do
139
- if [[ ! -e "\${item}" ]]; then
140
- missing+=("\${item}")
141
- fi
142
- done
143
-
144
- if (( \${#missing[@]} > 0 )); then
145
- echo "loop-agent 初始化检查失败,缺少必要路径:"
146
- for item in "\${missing[@]}"; do
147
- echo " - \${item}"
148
- done
149
- exit 1
150
- fi
151
-
152
- echo "loop-agent 工程结构检查通过"
97
+ const INIT_CHECK_ENGINEERING_STRUCTURE_SH = `#!/usr/bin/env bash
98
+ set -euo pipefail
99
+
100
+ ROOT_DIR="$(cd "$(dirname "\${BASH_SOURCE[0]}")/.." && pwd)"
101
+ cd "\${ROOT_DIR}"
102
+
103
+ required_paths=(
104
+ "README.md"
105
+ "harness.json"
106
+ "AGENTS.md"
107
+ "${GOVERNANCE_ROOT_TOKEN}/README.md"
108
+ "${GOVERNANCE_ROOT_TOKEN}/development-principles.md"
109
+ "${GOVERNANCE_ROOT_TOKEN}/feature-workflow.md"
110
+ "${GOVERNANCE_ROOT_TOKEN}/verification-matrix.md"
111
+ "${GOVERNANCE_ROOT_TOKEN}/architecture/runtime-boundaries.md"
112
+ "${GOVERNANCE_ROOT_TOKEN}/templates"
113
+ ".agents/skills/loop-agent/SKILL.md"
114
+ ".harness/prompts/analyze.md"
115
+ ".harness/prompts/plan.md"
116
+ ".harness/tasks"
117
+ ".harness/dag-runs/active"
118
+ ".harness/dag-runs/completed"
119
+ ".harness/dag-runs/paused"
120
+ ".harness/runs/active"
121
+ ".harness/runs/completed"
122
+ ".harness/runs/failed"
123
+ "scripts/check-engineering-structure.sh"
124
+ "scripts/check-doc-index.sh"
125
+ "scripts/check-doc-links.sh"
126
+ "scripts/check-active-plan-status.sh"
127
+ "scripts/check-exec-plan-index-sync.sh"
128
+ "scripts/check-harness-runtime-clean.sh"
129
+ "scripts/check-architecture-boundaries.sh"
130
+ "scripts/check-skill-entry.sh"
131
+ "scripts/check-repo.sh"
132
+ "scripts/ci-governance.sh"
133
+ "scripts/ci-tests.sh"
134
+ "scripts/ci.sh"
135
+ )
136
+
137
+ missing=()
138
+ for item in "\${required_paths[@]}"; do
139
+ if [[ ! -e "\${item}" ]]; then
140
+ missing+=("\${item}")
141
+ fi
142
+ done
143
+
144
+ if (( \${#missing[@]} > 0 )); then
145
+ echo "loop-agent 初始化检查失败,缺少必要路径:"
146
+ for item in "\${missing[@]}"; do
147
+ echo " - \${item}"
148
+ done
149
+ exit 1
150
+ fi
151
+
152
+ echo "loop-agent 工程结构检查通过"
153
153
  `;
154
- const INIT_CHECK_DOC_INDEX_SH = `#!/usr/bin/env bash
155
- set -euo pipefail
156
-
157
- ROOT_DIR="$(cd "$(dirname "\${BASH_SOURCE[0]}")/.." && pwd)"
158
- cd "\${ROOT_DIR}"
159
-
160
- required_docs=(
161
- "${GOVERNANCE_ROOT_TOKEN}/README.md"
162
- "${GOVERNANCE_ROOT_TOKEN}/development-principles.md"
163
- "${GOVERNANCE_ROOT_TOKEN}/feature-workflow.md"
164
- "${GOVERNANCE_ROOT_TOKEN}/verification-matrix.md"
165
- "${GOVERNANCE_ROOT_TOKEN}/architecture/runtime-boundaries.md"
166
- "${GOVERNANCE_ROOT_TOKEN}/loop-agent-harness.md"
167
- "${GOVERNANCE_ROOT_TOKEN}/harness-methodology-tdd.md"
168
- "${GOVERNANCE_ROOT_TOKEN}/harness-methodology-verification.md"
169
- "${GOVERNANCE_ROOT_TOKEN}/harness-methodology-debugging.md"
170
- "${GOVERNANCE_ROOT_TOKEN}/templates"
171
- "${GOVERNANCE_ROOT_TOKEN}/exec-plans/active/README.md"
172
- "${GOVERNANCE_ROOT_TOKEN}/exec-plans/completed/README.md"
173
- "${GOVERNANCE_ROOT_TOKEN}/progress/README.md"
174
- "${GOVERNANCE_ROOT_TOKEN}/reports/README.md"
175
- "${GOVERNANCE_ROOT_TOKEN}/decisions/README.md"
176
- )
177
-
178
- missing=()
179
- for item in "\${required_docs[@]}"; do
180
- if [[ ! -e "\${item}" ]]; then
181
- missing+=("\${item}")
182
- fi
183
- done
184
-
185
- if (( \${#missing[@]} > 0 )); then
186
- echo "docs 索引检查失败,缺少必要文档或目录:" >&2
187
- for item in "\${missing[@]}"; do
188
- echo " - \${item}" >&2
189
- done
190
- exit 1
191
- fi
192
-
193
- echo "docs 索引检查通过"
154
+ const INIT_CHECK_DOC_INDEX_SH = `#!/usr/bin/env bash
155
+ set -euo pipefail
156
+
157
+ ROOT_DIR="$(cd "$(dirname "\${BASH_SOURCE[0]}")/.." && pwd)"
158
+ cd "\${ROOT_DIR}"
159
+
160
+ required_docs=(
161
+ "${GOVERNANCE_ROOT_TOKEN}/README.md"
162
+ "${GOVERNANCE_ROOT_TOKEN}/development-principles.md"
163
+ "${GOVERNANCE_ROOT_TOKEN}/feature-workflow.md"
164
+ "${GOVERNANCE_ROOT_TOKEN}/verification-matrix.md"
165
+ "${GOVERNANCE_ROOT_TOKEN}/architecture/runtime-boundaries.md"
166
+ "${GOVERNANCE_ROOT_TOKEN}/loop-agent-harness.md"
167
+ "${GOVERNANCE_ROOT_TOKEN}/harness-methodology-tdd.md"
168
+ "${GOVERNANCE_ROOT_TOKEN}/harness-methodology-verification.md"
169
+ "${GOVERNANCE_ROOT_TOKEN}/harness-methodology-debugging.md"
170
+ "${GOVERNANCE_ROOT_TOKEN}/templates"
171
+ "${GOVERNANCE_ROOT_TOKEN}/exec-plans/active/README.md"
172
+ "${GOVERNANCE_ROOT_TOKEN}/exec-plans/completed/README.md"
173
+ "${GOVERNANCE_ROOT_TOKEN}/progress/README.md"
174
+ "${GOVERNANCE_ROOT_TOKEN}/reports/README.md"
175
+ "${GOVERNANCE_ROOT_TOKEN}/decisions/README.md"
176
+ )
177
+
178
+ missing=()
179
+ for item in "\${required_docs[@]}"; do
180
+ if [[ ! -e "\${item}" ]]; then
181
+ missing+=("\${item}")
182
+ fi
183
+ done
184
+
185
+ if (( \${#missing[@]} > 0 )); then
186
+ echo "docs 索引检查失败,缺少必要文档或目录:" >&2
187
+ for item in "\${missing[@]}"; do
188
+ echo " - \${item}" >&2
189
+ done
190
+ exit 1
191
+ fi
192
+
193
+ echo "docs 索引检查通过"
194
194
  `;
195
- const INIT_CHECK_DOC_LINKS_SH = `#!/usr/bin/env bash
196
- set -euo pipefail
197
-
198
- ROOT_DIR="$(cd "$(dirname "\${BASH_SOURCE[0]}")/.." && pwd)"
199
- cd "\${ROOT_DIR}"
200
-
201
- if [[ ! -d "${GOVERNANCE_ROOT_TOKEN}" ]]; then
202
- echo "docs 链接检查失败:缺少 ${GOVERNANCE_ROOT_TOKEN}/" >&2
203
- exit 1
204
- fi
205
-
206
- missing=()
207
- while IFS= read -r -d '' file; do
208
- while IFS= read -r link; do
209
- [[ -z "\${link}" ]] && continue
210
- [[ "\${link}" == http://* || "\${link}" == https://* || "\${link}" == mailto:* || "\${link}" == "#"* ]] && continue
211
- [[ "\${link}" == *"://"* ]] && continue
212
- target="\${link%%#*}"
213
- [[ -z "\${target}" ]] && continue
214
- [[ "\${target}" == /* ]] && continue
215
- base="$(dirname "\${file}")"
216
- if [[ ! -e "\${base}/\${target}" ]]; then
217
- missing+=("\${file}: \${link}")
218
- fi
219
- done < <(grep -Eo '\\[[^]]+\\]\\([^)]+\\)' "\${file}" | sed -E 's/^.*\\(([^)]+)\\)$/\\1/' || true)
220
- done < <(find "${GOVERNANCE_ROOT_TOKEN}" -type f -name '*.md' -print0)
221
-
222
- if (( \${#missing[@]} > 0 )); then
223
- echo "docs 链接检查失败:" >&2
224
- for item in "\${missing[@]}"; do
225
- echo " - \${item}" >&2
226
- done
227
- exit 1
228
- fi
229
-
230
- echo "docs 链接检查通过"
195
+ const INIT_CHECK_DOC_LINKS_SH = `#!/usr/bin/env bash
196
+ set -euo pipefail
197
+
198
+ ROOT_DIR="$(cd "$(dirname "\${BASH_SOURCE[0]}")/.." && pwd)"
199
+ cd "\${ROOT_DIR}"
200
+
201
+ if [[ ! -d "${GOVERNANCE_ROOT_TOKEN}" ]]; then
202
+ echo "docs 链接检查失败:缺少 ${GOVERNANCE_ROOT_TOKEN}/" >&2
203
+ exit 1
204
+ fi
205
+
206
+ missing=()
207
+ while IFS= read -r -d '' file; do
208
+ while IFS= read -r link; do
209
+ [[ -z "\${link}" ]] && continue
210
+ [[ "\${link}" == http://* || "\${link}" == https://* || "\${link}" == mailto:* || "\${link}" == "#"* ]] && continue
211
+ [[ "\${link}" == *"://"* ]] && continue
212
+ target="\${link%%#*}"
213
+ [[ -z "\${target}" ]] && continue
214
+ [[ "\${target}" == /* ]] && continue
215
+ base="$(dirname "\${file}")"
216
+ if [[ ! -e "\${base}/\${target}" ]]; then
217
+ missing+=("\${file}: \${link}")
218
+ fi
219
+ done < <(grep -Eo '\\[[^]]+\\]\\([^)]+\\)' "\${file}" | sed -E 's/^.*\\(([^)]+)\\)$/\\1/' || true)
220
+ done < <(find "${GOVERNANCE_ROOT_TOKEN}" -type f -name '*.md' -print0)
221
+
222
+ if (( \${#missing[@]} > 0 )); then
223
+ echo "docs 链接检查失败:" >&2
224
+ for item in "\${missing[@]}"; do
225
+ echo " - \${item}" >&2
226
+ done
227
+ exit 1
228
+ fi
229
+
230
+ echo "docs 链接检查通过"
231
231
  `;
232
- const INIT_CHECK_ACTIVE_PLAN_STATUS_SH = `#!/usr/bin/env bash
233
- set -euo pipefail
234
-
235
- ROOT_DIR="$(cd "$(dirname "\${BASH_SOURCE[0]}")/.." && pwd)"
236
- cd "\${ROOT_DIR}"
237
-
238
- active_dir="${GOVERNANCE_ROOT_TOKEN}/exec-plans/active"
239
- [[ -d "\${active_dir}" ]] || { echo "active plan 检查失败:缺少 \${active_dir}" >&2; exit 1; }
240
-
241
- bad=()
242
- while IFS= read -r -d '' file; do
243
- name="$(basename "\${file}")"
244
- [[ "\${name}" == "README.md" ]] && continue
245
- if grep -Eiq 'status:[[:space:]]*(completed|done|closed)|状态[::][[:space:]]*(已完成|完成|关闭)' "\${file}"; then
246
- bad+=("\${file}")
247
- fi
248
- done < <(find "\${active_dir}" -maxdepth 1 -type f -name '*.md' -print0)
249
-
250
- if (( \${#bad[@]} > 0 )); then
251
- echo "active plan 状态检查失败:已完成计划不应留在 active 目录:" >&2
252
- for item in "\${bad[@]}"; do
253
- echo " - \${item}" >&2
254
- done
255
- exit 1
256
- fi
257
-
258
- echo "active plan 状态检查通过"
232
+ const INIT_CHECK_ACTIVE_PLAN_STATUS_SH = `#!/usr/bin/env bash
233
+ set -euo pipefail
234
+
235
+ ROOT_DIR="$(cd "$(dirname "\${BASH_SOURCE[0]}")/.." && pwd)"
236
+ cd "\${ROOT_DIR}"
237
+
238
+ active_dir="${GOVERNANCE_ROOT_TOKEN}/exec-plans/active"
239
+ [[ -d "\${active_dir}" ]] || { echo "active plan 检查失败:缺少 \${active_dir}" >&2; exit 1; }
240
+
241
+ bad=()
242
+ while IFS= read -r -d '' file; do
243
+ name="$(basename "\${file}")"
244
+ [[ "\${name}" == "README.md" ]] && continue
245
+ if grep -Eiq 'status:[[:space:]]*(completed|done|closed)|状态[::][[:space:]]*(已完成|完成|关闭)' "\${file}"; then
246
+ bad+=("\${file}")
247
+ fi
248
+ done < <(find "\${active_dir}" -maxdepth 1 -type f -name '*.md' -print0)
249
+
250
+ if (( \${#bad[@]} > 0 )); then
251
+ echo "active plan 状态检查失败:已完成计划不应留在 active 目录:" >&2
252
+ for item in "\${bad[@]}"; do
253
+ echo " - \${item}" >&2
254
+ done
255
+ exit 1
256
+ fi
257
+
258
+ echo "active plan 状态检查通过"
259
259
  `;
260
- const INIT_CHECK_EXEC_PLAN_INDEX_SYNC_SH = `#!/usr/bin/env bash
261
- set -euo pipefail
262
-
263
- ROOT_DIR="$(cd "$(dirname "\${BASH_SOURCE[0]}")/.." && pwd)"
264
- cd "\${ROOT_DIR}"
265
-
266
- required=(
267
- "${GOVERNANCE_ROOT_TOKEN}/exec-plans/README.md"
268
- "${GOVERNANCE_ROOT_TOKEN}/exec-plans/active/README.md"
269
- "${GOVERNANCE_ROOT_TOKEN}/exec-plans/completed/README.md"
270
- )
271
-
272
- for item in "\${required[@]}"; do
273
- if [[ ! -f "\${item}" ]]; then
274
- echo "exec-plan 索引同步检查失败:缺少 \${item}" >&2
275
- exit 1
276
- fi
277
- done
278
-
279
- echo "exec-plan 索引同步检查通过"
260
+ const INIT_CHECK_EXEC_PLAN_INDEX_SYNC_SH = `#!/usr/bin/env bash
261
+ set -euo pipefail
262
+
263
+ ROOT_DIR="$(cd "$(dirname "\${BASH_SOURCE[0]}")/.." && pwd)"
264
+ cd "\${ROOT_DIR}"
265
+
266
+ required=(
267
+ "${GOVERNANCE_ROOT_TOKEN}/exec-plans/README.md"
268
+ "${GOVERNANCE_ROOT_TOKEN}/exec-plans/active/README.md"
269
+ "${GOVERNANCE_ROOT_TOKEN}/exec-plans/completed/README.md"
270
+ )
271
+
272
+ for item in "\${required[@]}"; do
273
+ if [[ ! -f "\${item}" ]]; then
274
+ echo "exec-plan 索引同步检查失败:缺少 \${item}" >&2
275
+ exit 1
276
+ fi
277
+ done
278
+
279
+ echo "exec-plan 索引同步检查通过"
280
280
  `;
281
- const INIT_CHECK_HARNESS_RUNTIME_CLEAN_SH = `#!/usr/bin/env bash
282
- set -euo pipefail
283
-
284
- ROOT_DIR="$(cd "$(dirname "\${BASH_SOURCE[0]}")/.." && pwd)"
285
- cd "\${ROOT_DIR}"
286
-
287
- failures=()
288
-
289
- count_entries() {
290
- local dir="$1"
291
- if [[ ! -d "\${dir}" ]]; then
292
- echo 0
293
- return
294
- fi
295
- find "\${dir}" -mindepth 1 -maxdepth 1 ! -name .gitkeep | wc -l | tr -d ' '
296
- }
297
-
298
- if [[ "\${HARNESS_ALLOW_ACTIVE_DAG_RUNS:-}" != "1" ]]; then
299
- active_dag_count="$(count_entries ".harness/dag-runs/active")"
300
- [[ "\${active_dag_count}" == "0" ]] || failures+=(".harness/dag-runs/active contains \${active_dag_count} entries")
301
- fi
302
-
303
- if [[ "\${HARNESS_ALLOW_ACTIVE_TOOL_RUNS:-\${HARNESS_ALLOW_ACTIVE_ONE_SHOT_RUNS:-}}" != "1" ]]; then
304
- active_run_count="$(count_entries ".harness/runs/active")"
305
- [[ "\${active_run_count}" == "0" ]] || failures+=(".harness/runs/active contains \${active_run_count} entries")
306
- fi
307
-
308
- if [[ -d artifacts ]]; then
309
- artifact_count="$(find artifacts -mindepth 1 -maxdepth 1 ! -name .gitkeep | wc -l | tr -d ' ')"
310
- [[ "\${artifact_count}" == "0" ]] || failures+=("root artifacts/ contains \${artifact_count} entries; use ${GOVERNANCE_ROOT_TOKEN}/reports or .harness run artifacts")
311
- fi
312
-
313
- if (( \${#failures[@]} > 0 )); then
314
- echo "[HARNESS RUNTIME DIRTY]" >&2
315
- for item in "\${failures[@]}"; do
316
- echo " - \${item}" >&2
317
- done
318
- exit 1
319
- fi
320
-
321
- echo "harness runtime clean check passed"
281
+ const INIT_CHECK_HARNESS_RUNTIME_CLEAN_SH = `#!/usr/bin/env bash
282
+ set -euo pipefail
283
+
284
+ ROOT_DIR="$(cd "$(dirname "\${BASH_SOURCE[0]}")/.." && pwd)"
285
+ cd "\${ROOT_DIR}"
286
+
287
+ failures=()
288
+
289
+ count_entries() {
290
+ local dir="$1"
291
+ if [[ ! -d "\${dir}" ]]; then
292
+ echo 0
293
+ return
294
+ fi
295
+ find "\${dir}" -mindepth 1 -maxdepth 1 ! -name .gitkeep | wc -l | tr -d ' '
296
+ }
297
+
298
+ if [[ "\${HARNESS_ALLOW_ACTIVE_DAG_RUNS:-}" != "1" ]]; then
299
+ active_dag_count="$(count_entries ".harness/dag-runs/active")"
300
+ [[ "\${active_dag_count}" == "0" ]] || failures+=(".harness/dag-runs/active contains \${active_dag_count} entries")
301
+ fi
302
+
303
+ if [[ "\${HARNESS_ALLOW_ACTIVE_TOOL_RUNS:-\${HARNESS_ALLOW_ACTIVE_ONE_SHOT_RUNS:-}}" != "1" ]]; then
304
+ active_run_count="$(count_entries ".harness/runs/active")"
305
+ [[ "\${active_run_count}" == "0" ]] || failures+=(".harness/runs/active contains \${active_run_count} entries")
306
+ fi
307
+
308
+ if [[ -d artifacts ]]; then
309
+ artifact_count="$(find artifacts -mindepth 1 -maxdepth 1 ! -name .gitkeep | wc -l | tr -d ' ')"
310
+ [[ "\${artifact_count}" == "0" ]] || failures+=("root artifacts/ contains \${artifact_count} entries; use ${GOVERNANCE_ROOT_TOKEN}/reports or .harness run artifacts")
311
+ fi
312
+
313
+ if (( \${#failures[@]} > 0 )); then
314
+ echo "[HARNESS RUNTIME DIRTY]" >&2
315
+ for item in "\${failures[@]}"; do
316
+ echo " - \${item}" >&2
317
+ done
318
+ exit 1
319
+ fi
320
+
321
+ echo "harness runtime clean check passed"
322
322
  `;
323
- const INIT_CHECK_ARCHITECTURE_BOUNDARIES_SH = `#!/usr/bin/env bash
324
- set -euo pipefail
325
-
326
- ROOT_DIR="$(cd "$(dirname "\${BASH_SOURCE[0]}")/.." && pwd)"
327
- cd "\${ROOT_DIR}"
328
-
329
- boundary_doc="${GOVERNANCE_ROOT_TOKEN}/architecture/runtime-boundaries.md"
330
- if [[ ! -f "\${boundary_doc}" ]]; then
331
- echo "architecture boundary 检查失败:缺少 \${boundary_doc}" >&2
332
- exit 1
333
- fi
334
-
335
- violations=()
336
-
337
- check_ts_import_boundary() {
338
- local from_dir="$1"
339
- local forbidden_dir="$2"
340
- local label="$3"
341
- [[ -d "\${from_dir}" && -d "\${forbidden_dir}" ]] || return 0
342
- while IFS= read -r -d '' file; do
343
- if grep -Eq "from ['\\\"][^'\\\"]*\${forbidden_dir}/|import\\(['\\\"][^'\\\"]*\${forbidden_dir}/|require\\(['\\\"][^'\\\"]*\${forbidden_dir}/" "\${file}"; then
344
- violations+=("\${label}: \${file} imports \${forbidden_dir}")
345
- fi
346
- done < <(find "\${from_dir}" -type f \\( -name '*.ts' -o -name '*.tsx' -o -name '*.js' -o -name '*.jsx' -o -name '*.mjs' -o -name '*.cjs' \\) -print0)
347
- }
348
-
349
- # These checks are intentionally optional and stack-agnostic. They activate only
350
- # when a target repository has recognizable source directories.
351
- check_ts_import_boundary "src/workflows" "src/commands" "workflow-runtime"
352
- check_ts_import_boundary "src/executors" "src/commands" "executors"
353
- check_ts_import_boundary "src/domain" "src/infrastructure" "domain"
354
-
355
- if (( \${#violations[@]} > 0 )); then
356
- echo "architecture boundary 检查失败:" >&2
357
- for item in "\${violations[@]}"; do
358
- echo " - \${item}" >&2
359
- done
360
- echo "请更新 \${boundary_doc} 中的层边界,或修正反向依赖。" >&2
361
- exit 1
362
- fi
363
-
364
- echo "architecture boundary 检查通过"
323
+ const INIT_CHECK_ARCHITECTURE_BOUNDARIES_SH = `#!/usr/bin/env bash
324
+ set -euo pipefail
325
+
326
+ ROOT_DIR="$(cd "$(dirname "\${BASH_SOURCE[0]}")/.." && pwd)"
327
+ cd "\${ROOT_DIR}"
328
+
329
+ boundary_doc="${GOVERNANCE_ROOT_TOKEN}/architecture/runtime-boundaries.md"
330
+ if [[ ! -f "\${boundary_doc}" ]]; then
331
+ echo "architecture boundary 检查失败:缺少 \${boundary_doc}" >&2
332
+ exit 1
333
+ fi
334
+
335
+ violations=()
336
+
337
+ check_ts_import_boundary() {
338
+ local from_dir="$1"
339
+ local forbidden_dir="$2"
340
+ local label="$3"
341
+ [[ -d "\${from_dir}" && -d "\${forbidden_dir}" ]] || return 0
342
+ while IFS= read -r -d '' file; do
343
+ if grep -Eq "from ['\\\"][^'\\\"]*\${forbidden_dir}/|import\\(['\\\"][^'\\\"]*\${forbidden_dir}/|require\\(['\\\"][^'\\\"]*\${forbidden_dir}/" "\${file}"; then
344
+ violations+=("\${label}: \${file} imports \${forbidden_dir}")
345
+ fi
346
+ done < <(find "\${from_dir}" -type f \\( -name '*.ts' -o -name '*.tsx' -o -name '*.js' -o -name '*.jsx' -o -name '*.mjs' -o -name '*.cjs' \\) -print0)
347
+ }
348
+
349
+ # These checks are intentionally optional and stack-agnostic. They activate only
350
+ # when a target repository has recognizable source directories.
351
+ check_ts_import_boundary "src/workflows" "src/commands" "workflow-runtime"
352
+ check_ts_import_boundary "src/executors" "src/commands" "executors"
353
+ check_ts_import_boundary "src/domain" "src/infrastructure" "domain"
354
+
355
+ if (( \${#violations[@]} > 0 )); then
356
+ echo "architecture boundary 检查失败:" >&2
357
+ for item in "\${violations[@]}"; do
358
+ echo " - \${item}" >&2
359
+ done
360
+ echo "请更新 \${boundary_doc} 中的层边界,或修正反向依赖。" >&2
361
+ exit 1
362
+ fi
363
+
364
+ echo "architecture boundary 检查通过"
365
365
  `;
366
- const INIT_CHECK_SKILL_ENTRY_SH = `#!/usr/bin/env bash
367
- set -euo pipefail
368
-
369
- ROOT_DIR="$(cd "$(dirname "\${BASH_SOURCE[0]}")/.." && pwd)"
370
- cd "\${ROOT_DIR}"
371
-
372
- check_skill() {
373
- local skill_name="$1"
374
- shift
375
- local skill_dir=".agents/skills/\${skill_name}"
376
- local skill_md="\${skill_dir}/SKILL.md"
377
- local missing=()
378
-
379
- if [[ ! -f "\${skill_md}" ]]; then
380
- echo "skill entry 检查失败:缺少 \${skill_md}" >&2
381
- exit 1
382
- fi
383
- grep -Eq "^name:[[:space:]]*\${skill_name}[[:space:]]*$" "\${skill_md}" || missing+=("frontmatter name")
384
- grep -Eq '^description:[[:space:]]*[^[:space:]]' "\${skill_md}" || missing+=("frontmatter description")
385
-
386
- local ref
387
- for ref in "$@"; do
388
- [[ -f "\${skill_dir}/\${ref}" ]] || missing+=("\${ref}")
389
- grep -Fq "\${ref}" "\${skill_md}" || missing+=("SKILL.md -> \${ref}")
390
- done
391
- if (( \${#missing[@]} > 0 )); then
392
- echo "skill entry 检查失败(\${skill_name}):" >&2
393
- printf ' - %s\\n' "\${missing[@]}" >&2
394
- exit 1
395
- fi
396
-
397
- local line_count
398
- line_count="$(wc -l < "\${skill_md}" | tr -d ' ')"
399
- if [[ "\${line_count}" =~ ^[0-9]+$ && "\${line_count}" -gt 180 ]]; then
400
- echo "skill entry 检查失败:\${skill_md} 行数为 \${line_count},入口应保持精简" >&2
401
- exit 1
402
- fi
403
- echo "skill entry 检查通过:\${skill_name} references ok, lines=\${line_count}"
404
- }
405
-
406
- check_skill "loop-agent" \\
407
- "references/harness-policy.md" \\
408
- "references/hybrid-dag.md" \\
409
- "references/verification-and-failure-handling.md" \\
410
- "references/command-reference.md"
411
- check_skill "agent-worker" "references/agent-worker-operator.md"
412
-
413
- description_line="$(grep -E '^description:' .agents/skills/agent-worker/SKILL.md | head -n 1 | tr '[:upper:]' '[:lower:]')"
414
- for term in "agent-worker" "feature packet" "taskspec" "task pool" "self-host" "candidate" "loop-agent"; do
415
- if [[ "\${description_line}" != *"\${term}"* ]]; then
416
- echo "skill entry 检查失败(agent-worker):description 缺少触发/路由词 \${term}" >&2
417
- exit 1
418
- fi
419
- done
366
+ const INIT_CHECK_SKILL_ENTRY_SH = `#!/usr/bin/env bash
367
+ set -euo pipefail
368
+
369
+ ROOT_DIR="$(cd "$(dirname "\${BASH_SOURCE[0]}")/.." && pwd)"
370
+ cd "\${ROOT_DIR}"
371
+
372
+ check_skill() {
373
+ local skill_name="$1"
374
+ shift
375
+ local skill_dir=".agents/skills/\${skill_name}"
376
+ local skill_md="\${skill_dir}/SKILL.md"
377
+ local missing=()
378
+
379
+ if [[ ! -f "\${skill_md}" ]]; then
380
+ echo "skill entry 检查失败:缺少 \${skill_md}" >&2
381
+ exit 1
382
+ fi
383
+ grep -Eq "^name:[[:space:]]*\${skill_name}[[:space:]]*$" "\${skill_md}" || missing+=("frontmatter name")
384
+ grep -Eq '^description:[[:space:]]*[^[:space:]]' "\${skill_md}" || missing+=("frontmatter description")
385
+
386
+ local ref
387
+ for ref in "$@"; do
388
+ [[ -f "\${skill_dir}/\${ref}" ]] || missing+=("\${ref}")
389
+ grep -Fq "\${ref}" "\${skill_md}" || missing+=("SKILL.md -> \${ref}")
390
+ done
391
+ if (( \${#missing[@]} > 0 )); then
392
+ echo "skill entry 检查失败(\${skill_name}):" >&2
393
+ printf ' - %s\\n' "\${missing[@]}" >&2
394
+ exit 1
395
+ fi
396
+
397
+ local line_count
398
+ line_count="$(wc -l < "\${skill_md}" | tr -d ' ')"
399
+ if [[ "\${line_count}" =~ ^[0-9]+$ && "\${line_count}" -gt 180 ]]; then
400
+ echo "skill entry 检查失败:\${skill_md} 行数为 \${line_count},入口应保持精简" >&2
401
+ exit 1
402
+ fi
403
+ echo "skill entry 检查通过:\${skill_name} references ok, lines=\${line_count}"
404
+ }
405
+
406
+ check_skill "loop-agent" \\
407
+ "references/harness-policy.md" \\
408
+ "references/hybrid-dag.md" \\
409
+ "references/verification-and-failure-handling.md" \\
410
+ "references/command-reference.md"
411
+ check_skill "agent-worker" "references/agent-worker-operator.md"
412
+
413
+ description_line="$(grep -E '^description:' .agents/skills/agent-worker/SKILL.md | head -n 1 | tr '[:upper:]' '[:lower:]')"
414
+ for term in "agent-worker" "feature packet" "taskspec" "task pool" "self-host" "candidate" "loop-agent"; do
415
+ if [[ "\${description_line}" != *"\${term}"* ]]; then
416
+ echo "skill entry 检查失败(agent-worker):description 缺少触发/路由词 \${term}" >&2
417
+ exit 1
418
+ fi
419
+ done
420
420
  `;
421
- const INIT_CHECK_REPO_SH = `#!/usr/bin/env bash
422
- set -euo pipefail
423
-
424
- ROOT_DIR="$(cd "$(dirname "\${BASH_SOURCE[0]}")/.." && pwd)"
425
- cd "\${ROOT_DIR}"
426
-
427
- checks=(
428
- "scripts/check-engineering-structure.sh"
429
- "scripts/check-doc-index.sh"
430
- "scripts/check-doc-links.sh"
431
- "scripts/check-active-plan-status.sh"
432
- "scripts/check-exec-plan-index-sync.sh"
433
- "scripts/check-harness-runtime-clean.sh"
434
- "scripts/check-architecture-boundaries.sh"
435
- "scripts/check-skill-entry.sh"
436
- "scripts/check-product-line-docs.sh"
437
- )
438
-
439
- for check in "\${checks[@]}"; do
440
- echo "==> bash \${check}"
441
- bash "\${check}"
442
- echo
443
- done
444
-
445
- echo "仓库治理检查全部通过"
421
+ const INIT_CHECK_REPO_SH = `#!/usr/bin/env bash
422
+ set -euo pipefail
423
+
424
+ ROOT_DIR="$(cd "$(dirname "\${BASH_SOURCE[0]}")/.." && pwd)"
425
+ cd "\${ROOT_DIR}"
426
+
427
+ checks=(
428
+ "scripts/check-engineering-structure.sh"
429
+ "scripts/check-doc-index.sh"
430
+ "scripts/check-doc-links.sh"
431
+ "scripts/check-active-plan-status.sh"
432
+ "scripts/check-exec-plan-index-sync.sh"
433
+ "scripts/check-harness-runtime-clean.sh"
434
+ "scripts/check-architecture-boundaries.sh"
435
+ "scripts/check-skill-entry.sh"
436
+ "scripts/check-product-line-docs.sh"
437
+ )
438
+
439
+ for check in "\${checks[@]}"; do
440
+ echo "==> bash \${check}"
441
+ bash "\${check}"
442
+ echo
443
+ done
444
+
445
+ echo "仓库治理检查全部通过"
446
446
  `;
447
- const INIT_CHECK_PRODUCT_LINE_DOCS_SH = `#!/usr/bin/env bash
448
- set -euo pipefail
449
-
450
- ROOT_DIR="$(cd "$(dirname "\${BASH_SOURCE[0]}")/.." && pwd)"
451
- cd "\${ROOT_DIR}"
452
-
453
- if ! command -v agent-worker >/dev/null 2>&1; then
454
- echo "product-line docs check skipped: agent-worker is not installed"
455
- exit 0
456
- fi
457
-
458
- feature_dirs=()
459
- for root in features product/features dogfood/features; do
460
- [[ -d "\${root}" ]] || continue
461
- while IFS= read -r feature_dir; do
462
- if [[ ! -f "\${feature_dir}/acceptance.yaml" ]]; then
463
- echo "product-line docs check failed: incomplete feature packet missing acceptance.yaml: \${feature_dir}" >&2
464
- exit 1
465
- fi
466
- feature_dirs+=("\${feature_dir}")
467
- done < <(find "\${root}" -mindepth 1 -maxdepth 1 -type d | sort)
468
- done
469
-
470
- if [[ \${#feature_dirs[@]} -eq 0 ]]; then
471
- echo "product-line docs check skipped: no feature packets found"
472
- exit 0
473
- fi
474
-
475
- for feature_dir in "\${feature_dirs[@]}"; do
476
- echo "==> validate product-line feature: \${feature_dir}"
477
- agent-worker task validate-feature "\${feature_dir}"
478
- done
479
-
480
- echo "product-line docs checks passed: \${#feature_dirs[@]} feature packet(s)"
447
+ const INIT_CHECK_PRODUCT_LINE_DOCS_SH = `#!/usr/bin/env bash
448
+ set -euo pipefail
449
+
450
+ ROOT_DIR="$(cd "$(dirname "\${BASH_SOURCE[0]}")/.." && pwd)"
451
+ cd "\${ROOT_DIR}"
452
+
453
+ if ! command -v agent-worker >/dev/null 2>&1; then
454
+ echo "product-line docs check skipped: agent-worker is not installed"
455
+ exit 0
456
+ fi
457
+
458
+ feature_dirs=()
459
+ for root in features product/features dogfood/features; do
460
+ [[ -d "\${root}" ]] || continue
461
+ while IFS= read -r feature_dir; do
462
+ if [[ ! -f "\${feature_dir}/acceptance.yaml" ]]; then
463
+ echo "product-line docs check failed: incomplete feature packet missing acceptance.yaml: \${feature_dir}" >&2
464
+ exit 1
465
+ fi
466
+ feature_dirs+=("\${feature_dir}")
467
+ done < <(find "\${root}" -mindepth 1 -maxdepth 1 -type d | sort)
468
+ done
469
+
470
+ if [[ \${#feature_dirs[@]} -eq 0 ]]; then
471
+ echo "product-line docs check skipped: no feature packets found"
472
+ exit 0
473
+ fi
474
+
475
+ for feature_dir in "\${feature_dirs[@]}"; do
476
+ echo "==> validate product-line feature: \${feature_dir}"
477
+ agent-worker task validate-feature "\${feature_dir}"
478
+ done
479
+
480
+ echo "product-line docs checks passed: \${#feature_dirs[@]} feature packet(s)"
481
481
  `;
482
- const INIT_CI_GOVERNANCE_SH = `#!/usr/bin/env bash
483
- set -euo pipefail
484
-
485
- ROOT_DIR="$(cd "$(dirname "\${BASH_SOURCE[0]}")/.." && pwd)"
486
- cd "\${ROOT_DIR}"
487
-
488
- bash scripts/check-repo.sh
482
+ const INIT_CI_GOVERNANCE_SH = `#!/usr/bin/env bash
483
+ set -euo pipefail
484
+
485
+ ROOT_DIR="$(cd "$(dirname "\${BASH_SOURCE[0]}")/.." && pwd)"
486
+ cd "\${ROOT_DIR}"
487
+
488
+ bash scripts/check-repo.sh
489
489
  `;
490
- const INIT_CI_TESTS_SH = `#!/usr/bin/env bash
491
- set -euo pipefail
492
-
493
- ROOT_DIR="$(cd "$(dirname "\${BASH_SOURCE[0]}")/.." && pwd)"
494
- cd "\${ROOT_DIR}"
495
-
496
- ran=0
497
- notes=()
498
-
499
- run_cmd() {
500
- echo "==> $*"
501
- "$@"
502
- ran=1
503
- }
504
-
505
- run_bash() {
506
- echo "==> $*"
507
- bash -lc "$*"
508
- ran=1
509
- }
510
-
511
- has_make_target() {
512
- local target="$1"
513
- [[ -f Makefile || -f makefile ]] || return 1
514
- grep -Eq "^[[:alnum:]_.-]*\${target}[[:alnum:]_.-]*:" Makefile makefile 2>/dev/null
515
- }
516
-
517
- has_npm_script() {
518
- local script="$1"
519
- [[ -f package.json ]] || return 1
520
- command -v node >/dev/null 2>&1 || return 1
521
- node -e "const fs=require('fs'); const p=JSON.parse(fs.readFileSync('package.json','utf8')); process.exit(p.scripts && p.scripts[process.argv[1]] ? 0 : 1)" "\${script}" >/dev/null 2>&1
522
- }
523
-
524
- if [[ -f package.json ]]; then
525
- if command -v npm >/dev/null 2>&1; then
526
- for script in lint typecheck test build; do
527
- if has_npm_script "\${script}"; then
528
- run_cmd npm run "\${script}"
529
- fi
530
- done
531
- else
532
- notes+=("package.json exists but npm is not available")
533
- fi
534
- fi
535
-
536
- if has_make_target verify; then
537
- run_cmd make verify
538
- elif has_make_target test; then
539
- run_cmd make test
540
- fi
541
-
542
- if [[ -f go.mod ]]; then
543
- if command -v go >/dev/null 2>&1; then
544
- run_cmd go test ./...
545
- else
546
- notes+=("go.mod exists but go is not available")
547
- fi
548
- fi
549
-
550
- if [[ -f Cargo.toml ]]; then
551
- if command -v cargo >/dev/null 2>&1; then
552
- run_cmd cargo test
553
- else
554
- notes+=("Cargo.toml exists but cargo is not available")
555
- fi
556
- fi
557
-
558
- if [[ -f pyproject.toml || -f pytest.ini || -f tox.ini ]]; then
559
- if command -v pytest >/dev/null 2>&1; then
560
- run_cmd pytest
561
- elif command -v tox >/dev/null 2>&1 && [[ -f tox.ini ]]; then
562
- run_cmd tox
563
- else
564
- notes+=("Python project metadata found but pytest/tox is not available")
565
- fi
566
- fi
567
-
568
- if [[ -f pom.xml ]]; then
569
- if command -v mvn >/dev/null 2>&1; then
570
- run_cmd mvn test
571
- else
572
- notes+=("pom.xml exists but mvn is not available")
573
- fi
574
- fi
575
-
576
- if [[ -f build.gradle || -f build.gradle.kts || -f settings.gradle || -f settings.gradle.kts ]]; then
577
- if [[ -x ./gradlew ]]; then
578
- run_cmd ./gradlew test
579
- elif command -v gradle >/dev/null 2>&1; then
580
- run_cmd gradle test
581
- else
582
- notes+=("Gradle project metadata found but gradle/gradlew is not available")
583
- fi
584
- fi
585
-
586
- if compgen -G "*.sln" >/dev/null || compgen -G "*.csproj" >/dev/null; then
587
- if command -v dotnet >/dev/null 2>&1; then
588
- run_cmd dotnet test
589
- else
590
- notes+=(".NET project metadata found but dotnet is not available")
591
- fi
592
- fi
593
-
594
- if (( ran == 0 )); then
595
- echo "未检测到可安全自动运行的项目测试入口。"
596
- echo "loop-agent 治理检查仍可运行;请让初始化模型根据目标项目技术栈补充 scripts/ci-tests.sh 与 ${GOVERNANCE_ROOT_TOKEN}/verification-matrix.md。"
597
- fi
598
-
599
- if (( \${#notes[@]} > 0 )); then
600
- echo "项目验证探测备注:"
601
- for note in "\${notes[@]}"; do
602
- echo " - \${note}"
603
- done
604
- fi
490
+ const INIT_CI_TESTS_SH = `#!/usr/bin/env bash
491
+ set -euo pipefail
492
+
493
+ ROOT_DIR="$(cd "$(dirname "\${BASH_SOURCE[0]}")/.." && pwd)"
494
+ cd "\${ROOT_DIR}"
495
+
496
+ ran=0
497
+ notes=()
498
+
499
+ run_cmd() {
500
+ echo "==> $*"
501
+ "$@"
502
+ ran=1
503
+ }
504
+
505
+ run_bash() {
506
+ echo "==> $*"
507
+ bash -lc "$*"
508
+ ran=1
509
+ }
510
+
511
+ has_make_target() {
512
+ local target="$1"
513
+ [[ -f Makefile || -f makefile ]] || return 1
514
+ grep -Eq "^[[:alnum:]_.-]*\${target}[[:alnum:]_.-]*:" Makefile makefile 2>/dev/null
515
+ }
516
+
517
+ has_npm_script() {
518
+ local script="$1"
519
+ [[ -f package.json ]] || return 1
520
+ command -v node >/dev/null 2>&1 || return 1
521
+ node -e "const fs=require('fs'); const p=JSON.parse(fs.readFileSync('package.json','utf8')); process.exit(p.scripts && p.scripts[process.argv[1]] ? 0 : 1)" "\${script}" >/dev/null 2>&1
522
+ }
523
+
524
+ if [[ -f package.json ]]; then
525
+ if command -v npm >/dev/null 2>&1; then
526
+ for script in lint typecheck test build; do
527
+ if has_npm_script "\${script}"; then
528
+ run_cmd npm run "\${script}"
529
+ fi
530
+ done
531
+ else
532
+ notes+=("package.json exists but npm is not available")
533
+ fi
534
+ fi
535
+
536
+ if has_make_target verify; then
537
+ run_cmd make verify
538
+ elif has_make_target test; then
539
+ run_cmd make test
540
+ fi
541
+
542
+ if [[ -f go.mod ]]; then
543
+ if command -v go >/dev/null 2>&1; then
544
+ run_cmd go test ./...
545
+ else
546
+ notes+=("go.mod exists but go is not available")
547
+ fi
548
+ fi
549
+
550
+ if [[ -f Cargo.toml ]]; then
551
+ if command -v cargo >/dev/null 2>&1; then
552
+ run_cmd cargo test
553
+ else
554
+ notes+=("Cargo.toml exists but cargo is not available")
555
+ fi
556
+ fi
557
+
558
+ if [[ -f pyproject.toml || -f pytest.ini || -f tox.ini ]]; then
559
+ if command -v pytest >/dev/null 2>&1; then
560
+ run_cmd pytest
561
+ elif command -v tox >/dev/null 2>&1 && [[ -f tox.ini ]]; then
562
+ run_cmd tox
563
+ else
564
+ notes+=("Python project metadata found but pytest/tox is not available")
565
+ fi
566
+ fi
567
+
568
+ if [[ -f pom.xml ]]; then
569
+ if command -v mvn >/dev/null 2>&1; then
570
+ run_cmd mvn test
571
+ else
572
+ notes+=("pom.xml exists but mvn is not available")
573
+ fi
574
+ fi
575
+
576
+ if [[ -f build.gradle || -f build.gradle.kts || -f settings.gradle || -f settings.gradle.kts ]]; then
577
+ if [[ -x ./gradlew ]]; then
578
+ run_cmd ./gradlew test
579
+ elif command -v gradle >/dev/null 2>&1; then
580
+ run_cmd gradle test
581
+ else
582
+ notes+=("Gradle project metadata found but gradle/gradlew is not available")
583
+ fi
584
+ fi
585
+
586
+ if compgen -G "*.sln" >/dev/null || compgen -G "*.csproj" >/dev/null; then
587
+ if command -v dotnet >/dev/null 2>&1; then
588
+ run_cmd dotnet test
589
+ else
590
+ notes+=(".NET project metadata found but dotnet is not available")
591
+ fi
592
+ fi
593
+
594
+ if (( ran == 0 )); then
595
+ echo "未检测到可安全自动运行的项目测试入口。"
596
+ echo "loop-agent 治理检查仍可运行;请让初始化模型根据目标项目技术栈补充 scripts/ci-tests.sh 与 ${GOVERNANCE_ROOT_TOKEN}/verification-matrix.md。"
597
+ fi
598
+
599
+ if (( \${#notes[@]} > 0 )); then
600
+ echo "项目验证探测备注:"
601
+ for note in "\${notes[@]}"; do
602
+ echo " - \${note}"
603
+ done
604
+ fi
605
605
  `;
606
- const INIT_CI_SH = `#!/usr/bin/env bash
607
- set -euo pipefail
608
-
609
- ROOT_DIR="$(cd "$(dirname "\${BASH_SOURCE[0]}")/.." && pwd)"
610
- cd "\${ROOT_DIR}"
611
-
612
- bash scripts/ci-governance.sh
613
- bash scripts/ci-tests.sh
606
+ const INIT_CI_SH = `#!/usr/bin/env bash
607
+ set -euo pipefail
608
+
609
+ ROOT_DIR="$(cd "$(dirname "\${BASH_SOURCE[0]}")/.." && pwd)"
610
+ cd "\${ROOT_DIR}"
611
+
612
+ bash scripts/ci-governance.sh
613
+ bash scripts/ci-tests.sh
614
614
  `;
615
615
  const INIT_SCRIPT_FILES = {
616
616
  "scripts/check-engineering-structure.sh": INIT_CHECK_ENGINEERING_STRUCTURE_SH,