@tea-agent/loop-agent 0.13.0 → 0.15.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 (272) hide show
  1. package/AGENTS.md +157 -157
  2. package/CHANGELOG.md +116 -305
  3. package/README.md +357 -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/dist/workflows/dag/init-hybrid.js +27 -11
  50. package/docs/README.md +106 -104
  51. package/docs/architecture/README.md +26 -26
  52. package/docs/architecture/dag-execution.md +140 -140
  53. package/docs/architecture/evolution.md +54 -54
  54. package/docs/architecture/facts-and-state.md +71 -71
  55. package/docs/architecture/runtime-boundaries.md +191 -191
  56. package/docs/architecture/system-overview.md +93 -93
  57. package/docs/architecture/worker-and-feature.md +85 -85
  58. package/docs/harness-methodology-debugging.md +153 -153
  59. package/docs/harness-methodology-tdd.md +130 -130
  60. package/docs/harness-methodology-verification.md +27 -27
  61. package/docs/init-surface.manifest.json +304 -307
  62. package/docs/skills/README.md +7 -7
  63. package/docs/skills/vetted-skill-registry.md +29 -29
  64. package/docs/templates/adr.md +60 -60
  65. package/docs/templates/agent-dag-authority-surface-audit.prompt.md +94 -94
  66. package/docs/templates/agent-dag-decision-envelope.schema.json +213 -213
  67. package/docs/templates/agent-dag-decision-gate-dogfood-report.md +117 -117
  68. package/docs/templates/agent-dag-decision-gate.prompt.md +246 -246
  69. package/docs/templates/agent-dag-process-supervisor.prompt.md +98 -98
  70. package/docs/templates/agent-dag-report.schema.json +473 -473
  71. package/docs/templates/agent-dag-review-verdict.prompt.md +68 -68
  72. package/docs/templates/agent-dag.base.json +190 -190
  73. package/docs/templates/agent-dag.final-verification.json +185 -185
  74. package/docs/templates/agent-dag.schema.json +411 -411
  75. package/docs/templates/agent-dag.supervised-implementation.json +620 -620
  76. package/docs/templates/backend-test-analysis.schema.json +44 -44
  77. package/docs/templates/backend-test-case-manifest.schema.json +190 -190
  78. package/docs/templates/backend-test-dag.classify.prompt.md +75 -75
  79. package/docs/templates/backend-test-dag.generate-pytest.prompt.md +204 -204
  80. package/docs/templates/backend-test-dag.json +559 -559
  81. package/docs/templates/backend-test-dag.retrospect.prompt.md +139 -139
  82. package/docs/templates/backend-test-dag.review-cases.prompt.md +83 -83
  83. package/docs/templates/backend-test-execution.schema.json +133 -133
  84. package/docs/templates/backend-test-result.schema.json +99 -99
  85. package/docs/templates/branch-merge-report.md +0 -1
  86. package/docs/templates/exec-plan.md +64 -64
  87. package/docs/templates/feature-spec.md +53 -53
  88. package/docs/templates/frontend-design-contract.md +42 -42
  89. package/docs/templates/frontend-eval/fixtures/failures/01-type-build-error.md +17 -17
  90. package/docs/templates/frontend-eval/fixtures/failures/02-unit-component-test-fail.md +16 -16
  91. package/docs/templates/frontend-eval/fixtures/failures/03-fixture-schema-drift.md +16 -16
  92. package/docs/templates/frontend-eval/fixtures/failures/04-missing-loading-empty-error-state.md +16 -16
  93. package/docs/templates/frontend-eval/fixtures/failures/05-forbidden-write-writeset-expansion.md +16 -16
  94. package/docs/templates/frontend-eval/fixtures/failures/06-unapproved-dependency-add.md +16 -16
  95. package/docs/templates/frontend-eval/fixtures/failures/07-mock-production-on.md +21 -21
  96. package/docs/templates/frontend-eval/fixtures/functional/01-simple-component-style.md +29 -29
  97. package/docs/templates/frontend-eval/fixtures/functional/02-form-validation.md +28 -28
  98. package/docs/templates/frontend-eval/fixtures/functional/03-list-detail-page.md +28 -28
  99. package/docs/templates/frontend-eval/fixtures/functional/04-api-mock.md +29 -29
  100. package/docs/templates/frontend-eval/fixtures/functional/05-permission-auth-gated-ui.md +27 -27
  101. package/docs/templates/frontend-eval/fixtures/functional/06-ssr-server-client-boundary.md +28 -28
  102. package/docs/templates/frontend-eval/fixtures/functional/07-shared-public-component-api.md +28 -28
  103. package/docs/templates/frontend-eval/fixtures/functional/08-pure-local-no-remote.md +27 -27
  104. package/docs/templates/frontend-eval/metrics.md +138 -138
  105. package/docs/templates/frontend-eval/smoke-targets.md +53 -53
  106. package/docs/templates/frontend-implementation-contract.schema.json +27 -27
  107. package/docs/templates/frontend-task-constraints.md +35 -35
  108. package/docs/templates/frontend-task-requirement.md +70 -70
  109. package/docs/templates/frontend-test-dag.generate-cases.prompt.md +5 -5
  110. package/docs/templates/frontend-test-dag.json +23 -23
  111. package/docs/templates/frontend-test-dag.retrieve-context.prompt.md +3 -3
  112. package/docs/templates/frontend-test-dag.retrospect.prompt.md +3 -3
  113. package/docs/templates/frontend-test-dag.review-cases.prompt.md +3 -3
  114. package/docs/templates/frontend-test-dag.review-execution.prompt.md +3 -3
  115. package/docs/templates/harness.schema.json +221 -221
  116. package/docs/templates/hybrid-dag.json +188 -188
  117. package/docs/templates/init-evolution-review.md +35 -35
  118. package/docs/templates/interactive-ui-round2-experiment.md +66 -66
  119. package/docs/templates/knowledge-graph-bootstrap-dag.json +118 -118
  120. package/docs/templates/knowledge-sync-dag.json +178 -178
  121. package/docs/templates/knowledge-sync-draft.schema.json +71 -71
  122. package/docs/templates/product-line/AGENTS.md +8 -8
  123. package/docs/templates/product-line/README.md +9 -9
  124. package/docs/templates/product-line/acceptance.yaml +14 -14
  125. package/docs/templates/product-line/closeout.yaml +9 -9
  126. package/docs/templates/product-line/design.md +13 -13
  127. package/docs/templates/product-line/links.md +10 -10
  128. package/docs/templates/product-line/requirement.md +17 -17
  129. package/docs/templates/product-line/task-graph.yaml +15 -15
  130. package/docs/templates/product-line/task.yaml +64 -64
  131. package/docs/templates/product-line/test-plan.md +7 -7
  132. package/docs/templates/production-readiness-checklist.md +57 -57
  133. package/docs/templates/progress-log.md +17 -17
  134. package/docs/templates/project-start-checklist.md +9 -9
  135. package/docs/templates/qa-report.md +48 -48
  136. package/docs/templates/sprint-contract.md +29 -29
  137. package/docs/templates/worker-dogfood-evidence.md +80 -80
  138. package/docs/templates/worker-dogfood-setup.md +68 -68
  139. package/examples/decision-gate-agent-dag.json +173 -173
  140. package/examples/example-dag.json +46 -46
  141. package/examples/hybrid-loop-agent-dag.json +188 -188
  142. package/harness.json +66 -66
  143. package/package.json +78 -52
  144. package/scripts/kb-bootstrap-init-skeleton.sh +240 -240
  145. package/scripts/kb-graph-incremental-prepare.mjs +386 -386
  146. package/scripts/kb-graph-materialize.mjs +105 -105
  147. package/scripts/kb-graph-promote.mjs +164 -164
  148. package/scripts/kb-query.mjs +554 -554
  149. package/skills/agent-worker/SKILL.md +39 -39
  150. package/skills/agent-worker/references/agent-worker-operator.md +60 -60
  151. package/skills/ai-engineering-context/SKILL.md +48 -48
  152. package/skills/analyze-product-dependencies/SKILL.md +67 -67
  153. package/skills/analyze-product-dependencies/agents/openai.yaml +4 -4
  154. package/skills/analyze-product-dependencies/references/api-documentation-schema.md +30 -30
  155. package/skills/analyze-product-dependencies/references/dependency-analysis-schema.md +28 -28
  156. package/skills/analyze-product-dependencies/references/example.md +76 -76
  157. package/skills/analyze-product-dependencies/references/forward-test-cases.md +35 -35
  158. package/skills/analyze-product-dependencies/references/input-contract.md +11 -11
  159. package/skills/analyze-product-dependencies/references/scouting-rules.md +61 -61
  160. package/skills/analyze-product-dependencies/scripts/test-validators.mjs +267 -267
  161. package/skills/analyze-product-dependencies/scripts/validate-api-documentation.mjs +101 -101
  162. package/skills/analyze-product-dependencies/scripts/validate-dependency-analysis.mjs +142 -142
  163. package/skills/analyze-product-dependencies/scripts/validate-product-requirement-input.mjs +76 -76
  164. package/skills/analyze-product-dependencies/scripts/validation-helpers.mjs +146 -146
  165. package/skills/analyze-product-requirements/SKILL.md +90 -90
  166. package/skills/analyze-product-requirements/agents/openai.yaml +4 -4
  167. package/skills/analyze-product-requirements/references/acceptance-criteria.md +91 -91
  168. package/skills/analyze-product-requirements/references/clarification-and-knowledge.md +56 -56
  169. package/skills/analyze-product-requirements/references/example.md +86 -86
  170. package/skills/analyze-product-requirements/references/forward-test-cases.md +66 -66
  171. package/skills/analyze-product-requirements/references/product-analysis-schema.md +32 -32
  172. package/skills/analyze-product-requirements/references/product-requirement-schema.md +33 -33
  173. package/skills/analyze-product-requirements/references/requirement-clarification-schema.md +35 -35
  174. package/skills/analyze-product-requirements/scripts/test-validators.mjs +193 -193
  175. package/skills/analyze-product-requirements/scripts/validate-product-analysis.mjs +69 -69
  176. package/skills/analyze-product-requirements/scripts/validate-product-requirement.mjs +97 -97
  177. package/skills/analyze-product-requirements/scripts/validate-requirement-clarification.mjs +98 -98
  178. package/skills/analyze-product-requirements/scripts/validation-helpers.mjs +156 -156
  179. package/skills/browser-tools/SKILL.md +196 -196
  180. package/skills/browser-tools/browser-content.js +103 -103
  181. package/skills/browser-tools/browser-cookies.js +35 -35
  182. package/skills/browser-tools/browser-eval.js +53 -53
  183. package/skills/browser-tools/browser-hn-scraper.js +108 -108
  184. package/skills/browser-tools/browser-nav.js +44 -44
  185. package/skills/browser-tools/browser-pick.js +162 -162
  186. package/skills/browser-tools/browser-screenshot.js +34 -34
  187. package/skills/browser-tools/browser-start.js +86 -86
  188. package/skills/browser-tools/package-lock.json +2556 -2556
  189. package/skills/browser-tools/package.json +19 -19
  190. package/skills/code-review-core/SKILL.md +20 -20
  191. package/skills/codebase-scout/SKILL.md +19 -19
  192. package/skills/frontend-design-review/SKILL.md +66 -66
  193. package/skills/frontend-design-review/references/review-checklist.md +40 -58
  194. package/skills/frontend-implementation/SKILL.md +49 -49
  195. package/skills/frontend-implementation/references/code-standards.md +32 -32
  196. package/skills/frontend-implementation/references/design-spec.md +46 -46
  197. package/skills/frontend-implementation/references/node-contracts.md +27 -27
  198. package/skills/frontend-review/SKILL.md +61 -59
  199. package/skills/frontend-review/references/review-findings.md +48 -47
  200. package/skills/frontend-verification/SKILL.md +55 -53
  201. package/skills/frontend-verification/references/verification-checklist.md +59 -68
  202. package/skills/grill-me/SKILL.md +10 -10
  203. package/skills/grill-with-docs/SKILL.md +88 -88
  204. package/skills/grill-with-docs/adr-format.md +47 -47
  205. package/skills/grill-with-docs/context-format.md +60 -60
  206. package/skills/init-capability-evolution/SKILL.md +70 -70
  207. package/skills/loop-agent/SKILL.md +151 -151
  208. package/skills/loop-agent/references/README.md +67 -67
  209. package/skills/loop-agent/references/command-reference.md +527 -527
  210. package/skills/loop-agent/references/docs-converge.md +126 -126
  211. package/skills/loop-agent/references/harness-policy.md +263 -263
  212. package/skills/loop-agent/references/hybrid-dag.md +243 -243
  213. package/skills/loop-agent/references/learned/README.md +21 -21
  214. package/skills/loop-agent/references/long-running-loop.md +57 -57
  215. package/skills/loop-agent/references/model-routing.md +36 -36
  216. package/skills/loop-agent/references/multi-worktree.md +54 -54
  217. package/skills/loop-agent/references/one-shot-runs.md +85 -85
  218. package/skills/loop-agent/references/orchestrator-and-interventions.md +169 -169
  219. package/skills/loop-agent/references/pi-prompt.md +23 -23
  220. package/skills/loop-agent/references/pi-subagent-assisted-mode.md +84 -84
  221. package/skills/loop-agent/references/post-implementation-and-patterns.md +44 -44
  222. package/skills/loop-agent/references/task-workflow.md +89 -89
  223. package/skills/loop-agent/references/verification-and-failure-handling.md +141 -141
  224. package/skills/playwright-cli/SKILL.md +420 -420
  225. package/skills/playwright-cli/references/element-attributes.md +23 -23
  226. package/skills/playwright-cli/references/playwright-tests.md +39 -39
  227. package/skills/playwright-cli/references/request-mocking.md +87 -87
  228. package/skills/playwright-cli/references/running-code.md +241 -241
  229. package/skills/playwright-cli/references/session-management.md +225 -225
  230. package/skills/playwright-cli/references/storage-state.md +275 -275
  231. package/skills/playwright-cli/references/test-generation.md +433 -433
  232. package/skills/playwright-cli/references/tracing.md +139 -139
  233. package/skills/playwright-cli/references/video-recording.md +143 -143
  234. package/skills/playwright-cli-case-generator/SKILL.md +74 -74
  235. package/skills/requesting-code-review/SKILL.md +101 -101
  236. package/skills/requesting-code-review/code-reviewer.md +168 -168
  237. package/skills/systematic-debugging/CREATION-LOG.md +119 -119
  238. package/skills/systematic-debugging/SKILL.md +296 -296
  239. package/skills/systematic-debugging/condition-based-waiting-example.ts +158 -158
  240. package/skills/systematic-debugging/condition-based-waiting.md +115 -115
  241. package/skills/systematic-debugging/defense-in-depth.md +122 -122
  242. package/skills/systematic-debugging/find-polluter.sh +63 -63
  243. package/skills/systematic-debugging/root-cause-tracing.md +169 -169
  244. package/skills/systematic-debugging/test-academic.md +14 -14
  245. package/skills/systematic-debugging/test-pressure-1.md +58 -58
  246. package/skills/systematic-debugging/test-pressure-2.md +68 -68
  247. package/skills/systematic-debugging/test-pressure-3.md +69 -69
  248. package/skills/test-driven-development/SKILL.md +20 -20
  249. package/skills/using-git-worktrees/SKILL.md +215 -215
  250. package/skills/verification-before-completion/SKILL.md +154 -154
  251. package/skills/webapp-testing/SKILL.md +19 -19
  252. package/docs/agent-dag-recovery-playbook.md +0 -195
  253. package/docs/agent-dag-runner.md +0 -67
  254. package/docs/cursor-prompt-sidecar.md +0 -36
  255. package/docs/decisions/README.md +0 -18
  256. package/docs/design/README.md +0 -167
  257. package/docs/development-principles.md +0 -73
  258. package/docs/exec-plans/README.md +0 -6
  259. package/docs/exec-plans/active/README.md +0 -12
  260. package/docs/exec-plans/completed/README.md +0 -107
  261. package/docs/feature-workflow.md +0 -414
  262. package/docs/loop-agent-harness.md +0 -142
  263. package/docs/production-readiness.md +0 -96
  264. package/docs/progress/README.md +0 -80
  265. package/docs/reports/README.md +0 -159
  266. package/docs/verification-matrix.md +0 -70
  267. package/scripts/check-product-line-docs.sh +0 -29
  268. package/scripts/check-task-pool-root.sh +0 -32
  269. package/scripts/kb-graph-incremental-prepare.sh +0 -5
  270. package/scripts/kb-graph-materialize.sh +0 -4
  271. package/scripts/kb-graph-promote.sh +0 -4
  272. package/scripts/kb-query.sh +0 -5
@@ -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,