@dommaker/harness 0.13.0 → 0.13.2

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 (420) hide show
  1. package/CHANGELOG.md +169 -0
  2. package/bin/harness-knowledge-capture.js +99 -0
  3. package/bin/harness-knowledge-check.js +149 -0
  4. package/bin/harness-knowledge-track.js +92 -0
  5. package/bin/harness-knowledge-track.sh +47 -0
  6. package/bin/harness-sensitive-check.sh +67 -0
  7. package/dist/cli/commands/init.js +34 -2
  8. package/dist/cli/commands/init.js.map +1 -1
  9. package/package.json +6 -3
  10. package/src/CONTEXT.md +34 -0
  11. package/src/__tests__/acceptance-gate.test.ts +364 -0
  12. package/src/__tests__/annotation-checker.test.ts +183 -0
  13. package/src/__tests__/architecture-engine.test.ts +619 -0
  14. package/src/__tests__/checker-extra.test.ts +1627 -0
  15. package/src/__tests__/checker.test.ts +1268 -0
  16. package/src/__tests__/checkpoint.test.ts +697 -0
  17. package/src/__tests__/clean-state-extra.test.ts +301 -0
  18. package/src/__tests__/clean-state.test.ts +169 -0
  19. package/src/__tests__/constraint-doctor.test.ts +410 -0
  20. package/src/__tests__/constraint-evolver.test.ts +404 -0
  21. package/src/__tests__/constraint-handler.test.ts +136 -0
  22. package/src/__tests__/context/progressive-loader.test.ts +131 -0
  23. package/src/__tests__/contract-gate.test.ts +321 -0
  24. package/src/__tests__/cross-project-checker.test.ts +318 -0
  25. package/src/__tests__/cso-validator.test.ts +205 -0
  26. package/src/__tests__/detect-source-roots.test.ts +98 -0
  27. package/src/__tests__/doctor-evolver.test.ts +381 -0
  28. package/src/__tests__/error-classifier.test.ts +304 -0
  29. package/src/__tests__/exec.test.ts +83 -0
  30. package/src/__tests__/extend-exceptions.test.ts +149 -0
  31. package/src/__tests__/failure-recorder.test.ts +335 -0
  32. package/src/__tests__/hooks-pipeline.test.ts +214 -0
  33. package/src/__tests__/interceptor.test.ts +89 -0
  34. package/src/__tests__/iron-laws.test.ts +246 -0
  35. package/src/__tests__/long-running.test.ts +17 -0
  36. package/src/__tests__/passes-gate-check.test.ts +138 -0
  37. package/src/__tests__/passes-gate-extension.test.ts +151 -0
  38. package/src/__tests__/passes-gate-extra.test.ts +238 -0
  39. package/src/__tests__/passes-gate.test.ts +231 -0
  40. package/src/__tests__/performance-analyzer.test.ts +501 -0
  41. package/src/__tests__/performance-collector.test.ts +276 -0
  42. package/src/__tests__/performance-gate.test.ts +74 -0
  43. package/src/__tests__/presets.test.ts +104 -0
  44. package/src/__tests__/project-config-loader-extra.test.ts +269 -0
  45. package/src/__tests__/project-config-loader.test.ts +127 -0
  46. package/src/__tests__/review-gate.test.ts +92 -0
  47. package/src/__tests__/security-gate.test.ts +100 -0
  48. package/src/__tests__/session-startup.test.ts +334 -0
  49. package/src/__tests__/spec-validator.test.ts +57 -0
  50. package/src/__tests__/token-budget.test.ts +252 -0
  51. package/src/__tests__/trace-analyzer-extra.test.ts +307 -0
  52. package/src/__tests__/trace-analyzer.test.ts +131 -0
  53. package/src/__tests__/trace-collector.test.ts +258 -0
  54. package/src/__tests__/traces.test.ts +347 -0
  55. package/src/agents/CONTEXT.md +21 -0
  56. package/src/agents/__tests__/lifecycle.test.ts +248 -0
  57. package/src/agents/index.ts +2 -0
  58. package/src/agents/lifecycle.ts +201 -0
  59. package/src/agents/types.ts +46 -0
  60. package/src/architecture/CONTEXT.md +22 -0
  61. package/src/architecture/constraint-engine.ts +356 -0
  62. package/src/architecture/cross-project-checker.ts +563 -0
  63. package/src/cli/commands/CONTEXT.md +24 -0
  64. package/src/cli/commands/__tests__/acceptance.test.ts +180 -0
  65. package/src/cli/commands/__tests__/check.test.ts +598 -0
  66. package/src/cli/commands/__tests__/command.test.ts +149 -0
  67. package/src/cli/commands/__tests__/contract.test.ts +151 -0
  68. package/src/cli/commands/__tests__/failure.test.ts +199 -0
  69. package/src/cli/commands/__tests__/flow.test.ts +343 -0
  70. package/src/cli/commands/__tests__/init.test.ts +306 -0
  71. package/src/cli/commands/__tests__/passes-gate.test.ts +256 -0
  72. package/src/cli/commands/__tests__/performance.test.ts +116 -0
  73. package/src/cli/commands/__tests__/posteval-plan.test.ts +201 -0
  74. package/src/cli/commands/__tests__/report-extra.test.ts +98 -0
  75. package/src/cli/commands/__tests__/report.test.ts +109 -0
  76. package/src/cli/commands/__tests__/review.test.ts +153 -0
  77. package/src/cli/commands/__tests__/security.test.ts +147 -0
  78. package/src/cli/commands/__tests__/spec.test.ts +193 -0
  79. package/src/cli/commands/__tests__/status-extra.test.ts +223 -0
  80. package/src/cli/commands/__tests__/status.test.ts +306 -0
  81. package/src/cli/commands/__tests__/sync-docs.test.ts +335 -0
  82. package/src/cli/commands/__tests__/validate.test.ts +139 -0
  83. package/src/cli/commands/acceptance.ts +111 -0
  84. package/src/cli/commands/analyze-sessions.ts +488 -0
  85. package/src/cli/commands/check.ts +441 -0
  86. package/src/cli/commands/command.ts +90 -0
  87. package/src/cli/commands/constraints.ts +86 -0
  88. package/src/cli/commands/contract.ts +168 -0
  89. package/src/cli/commands/failure.ts +117 -0
  90. package/src/cli/commands/flow.ts +275 -0
  91. package/src/cli/commands/index.ts +26 -0
  92. package/src/cli/commands/init.ts +832 -0
  93. package/src/cli/commands/knowledge.ts +391 -0
  94. package/src/cli/commands/passes-gate.ts +158 -0
  95. package/src/cli/commands/performance.ts +108 -0
  96. package/src/cli/commands/posteval-plan.ts +85 -0
  97. package/src/cli/commands/release.ts +159 -0
  98. package/src/cli/commands/report.ts +198 -0
  99. package/src/cli/commands/review.ts +118 -0
  100. package/src/cli/commands/security.ts +122 -0
  101. package/src/cli/commands/spec.ts +158 -0
  102. package/src/cli/commands/status.ts +169 -0
  103. package/src/cli/commands/sync-docs.ts +743 -0
  104. package/src/cli/commands/update-user-model.ts +527 -0
  105. package/src/cli/commands/validate.ts +222 -0
  106. package/src/constraints/__tests__/lifecycle-runner.test.ts +246 -0
  107. package/src/constraints/__tests__/registry.test.ts +196 -0
  108. package/src/constraints/index.ts +3 -0
  109. package/src/constraints/lifecycle-runner.ts +184 -0
  110. package/src/constraints/registry.ts +134 -0
  111. package/src/constraints/types.ts +59 -0
  112. package/src/context/CONTEXT.md +28 -0
  113. package/src/context/__tests__/compaction.test.ts +169 -0
  114. package/src/context/__tests__/file-budget.test.ts +142 -0
  115. package/src/context/__tests__/knowledge-injector.test.ts +148 -0
  116. package/src/context/__tests__/progressive-loader.test.ts +264 -0
  117. package/src/context/__tests__/session-manager.test.ts +300 -0
  118. package/src/context/__tests__/token-budget.test.ts +338 -0
  119. package/src/context/__tests__/token-pipeline.test.ts +178 -0
  120. package/src/context/__tests__/tool-output-budget.test.ts +95 -0
  121. package/src/context/compaction.ts +202 -0
  122. package/src/context/file-budget.ts +142 -0
  123. package/src/context/index.ts +15 -0
  124. package/src/context/knowledge-injector.ts +168 -0
  125. package/src/context/progressive-loader.ts +260 -0
  126. package/src/context/session-manager.ts +343 -0
  127. package/src/context/token-budget.ts +295 -0
  128. package/src/context/token-pipeline.ts +265 -0
  129. package/src/context/tool-output-budget.ts +178 -0
  130. package/src/context/types.ts +160 -0
  131. package/src/core/CONTEXT.md +26 -0
  132. package/src/core/constraints/__tests__/default-executors.test.ts +57 -0
  133. package/src/core/constraints/__tests__/interceptor.test.ts +251 -0
  134. package/src/core/constraints/__tests__/prompt-injection.test.ts +89 -0
  135. package/src/core/constraints/check-cache.ts +96 -0
  136. package/src/core/constraints/checker.ts +1169 -0
  137. package/src/core/constraints/default-executors.ts +92 -0
  138. package/src/core/constraints/definitions.ts +1119 -0
  139. package/src/core/constraints/doc-freshness/__tests__/runner.test.ts +551 -0
  140. package/src/core/constraints/doc-freshness/auto-fix.ts +69 -0
  141. package/src/core/constraints/doc-freshness/runner.ts +486 -0
  142. package/src/core/constraints/index.ts +78 -0
  143. package/src/core/constraints/interceptor.ts +220 -0
  144. package/src/core/constraints/prompt-injection.ts +73 -0
  145. package/src/core/index.ts +23 -0
  146. package/src/core/project-config-loader.ts +252 -0
  147. package/src/core/session/__tests__/startup.test.ts +281 -0
  148. package/src/core/session/clean-state.ts +178 -0
  149. package/src/core/session/index.ts +15 -0
  150. package/src/core/session/startup.ts +253 -0
  151. package/src/core/spec/__tests__/validator.test.ts +379 -0
  152. package/src/core/spec/index.ts +7 -0
  153. package/src/core/spec/validator.ts +383 -0
  154. package/src/core/validators/__tests__/passes-gate.test.ts +131 -0
  155. package/src/core/validators/checkpoint.ts +547 -0
  156. package/src/core/validators/cso.ts +124 -0
  157. package/src/core/validators/index.ts +25 -0
  158. package/src/core/validators/passes-gate.ts +613 -0
  159. package/src/dashboard/CONTEXT.md +21 -0
  160. package/src/dashboard/__tests__/data.test.ts +115 -0
  161. package/src/dashboard/__tests__/stats.test.ts +156 -0
  162. package/src/dashboard/data.ts +113 -0
  163. package/src/dashboard/index.ts +3 -0
  164. package/src/dashboard/stats.ts +127 -0
  165. package/src/dashboard/types.ts +113 -0
  166. package/src/evolution/CONTEXT.md +22 -0
  167. package/src/evolution/__tests__/auto-evolve.test.ts +320 -0
  168. package/src/evolution/auto-evolve.ts +98 -0
  169. package/src/evolution/index.ts +1 -0
  170. package/src/failure/CONTEXT.md +24 -0
  171. package/src/failure/classifier.ts +156 -0
  172. package/src/failure/constraint-handler.ts +173 -0
  173. package/src/failure/index.ts +35 -0
  174. package/src/failure/recorder.ts +201 -0
  175. package/src/failure/types.ts +165 -0
  176. package/src/gates/CONTEXT.md +27 -0
  177. package/src/gates/__tests__/acceptance.test.ts +608 -0
  178. package/src/gates/__tests__/command.test.ts +206 -0
  179. package/src/gates/__tests__/performance.test.ts +381 -0
  180. package/src/gates/__tests__/review.test.ts +302 -0
  181. package/src/gates/__tests__/security.test.ts +332 -0
  182. package/src/gates/acceptance.ts +493 -0
  183. package/src/gates/command.ts +444 -0
  184. package/src/gates/contract.ts +260 -0
  185. package/src/gates/index.ts +67 -0
  186. package/src/gates/performance.ts +359 -0
  187. package/src/gates/review.ts +169 -0
  188. package/src/gates/security.ts +244 -0
  189. package/src/gates/types.ts +159 -0
  190. package/src/governance/CONTEXT.md +22 -0
  191. package/src/governance/__tests__/executor.test.ts +249 -0
  192. package/src/governance/executor.ts +229 -0
  193. package/src/governance/index.ts +13 -0
  194. package/src/governance/types.ts +53 -0
  195. package/src/hooks/CONTEXT.md +23 -0
  196. package/src/hooks/__tests__/bootstrap.test.ts +184 -0
  197. package/src/hooks/bootstrap.ts +144 -0
  198. package/src/hooks/index.ts +15 -0
  199. package/src/hooks/pipeline.ts +157 -0
  200. package/src/hooks/registry.ts +88 -0
  201. package/src/hooks/types.ts +80 -0
  202. package/src/index.ts +198 -0
  203. package/src/knowledge/CONTEXT.md +29 -0
  204. package/src/knowledge/__tests__/doctor.test.ts +272 -0
  205. package/src/knowledge/__tests__/import.test.ts +376 -0
  206. package/src/knowledge/__tests__/ingest.test.ts +125 -0
  207. package/src/knowledge/__tests__/lifecycle-hooks.test.ts +137 -0
  208. package/src/knowledge/__tests__/lifecycle.test.ts +248 -0
  209. package/src/knowledge/__tests__/lint.test.ts +401 -0
  210. package/src/knowledge/__tests__/query.test.ts +185 -0
  211. package/src/knowledge/__tests__/reference-tracker.test.ts +129 -0
  212. package/src/knowledge/__tests__/store.test.ts +238 -0
  213. package/src/knowledge/doctor.ts +104 -0
  214. package/src/knowledge/import.ts +505 -0
  215. package/src/knowledge/index.ts +16 -0
  216. package/src/knowledge/ingest.ts +126 -0
  217. package/src/knowledge/lifecycle-hooks.ts +199 -0
  218. package/src/knowledge/lifecycle.ts +175 -0
  219. package/src/knowledge/lint.ts +360 -0
  220. package/src/knowledge/query.ts +150 -0
  221. package/src/knowledge/reference-tracker.ts +99 -0
  222. package/src/knowledge/store.ts +264 -0
  223. package/src/knowledge/types.ts +139 -0
  224. package/src/llm/CONTEXT.md +21 -0
  225. package/src/llm/__tests__/adapter.test.ts +172 -0
  226. package/src/llm/adapter.ts +149 -0
  227. package/src/llm/index.ts +2 -0
  228. package/src/llm/types.ts +81 -0
  229. package/src/monitoring/CONTEXT.md +29 -0
  230. package/src/monitoring/__tests__/context-tracker.test.ts +172 -0
  231. package/src/monitoring/__tests__/knowledge-doctor.test.ts +276 -0
  232. package/src/monitoring/__tests__/knowledge-evolver.test.ts +365 -0
  233. package/src/monitoring/__tests__/performance-analyzer.test.ts +137 -0
  234. package/src/monitoring/__tests__/performance-collector.test.ts +332 -0
  235. package/src/monitoring/__tests__/traces.test.ts +190 -0
  236. package/src/monitoring/constraint-doctor.ts +499 -0
  237. package/src/monitoring/constraint-evolver.ts +573 -0
  238. package/src/monitoring/context-tracker.ts +148 -0
  239. package/src/monitoring/index.ts +23 -0
  240. package/src/monitoring/knowledge-doctor.ts +323 -0
  241. package/src/monitoring/knowledge-evolver.ts +289 -0
  242. package/src/monitoring/performance-analyzer.ts +450 -0
  243. package/src/monitoring/performance-collector.ts +348 -0
  244. package/src/monitoring/trace-analyzer.ts +470 -0
  245. package/src/monitoring/traces.ts +339 -0
  246. package/src/presets/__tests__/standard.test.ts +104 -0
  247. package/src/presets/index.ts +16 -0
  248. package/src/presets/standard.ts +163 -0
  249. package/src/safety/CONTEXT.md +23 -0
  250. package/src/safety/__tests__/input-guardrail.test.ts +105 -0
  251. package/src/safety/__tests__/output-guardrail.test.ts +108 -0
  252. package/src/safety/__tests__/sandbox.test.ts +158 -0
  253. package/src/safety/__tests__/tool-guardrail.test.ts +127 -0
  254. package/src/safety/index.ts +5 -0
  255. package/src/safety/input-guardrail.ts +133 -0
  256. package/src/safety/output-guardrail.ts +174 -0
  257. package/src/safety/sandbox.ts +148 -0
  258. package/src/safety/tool-guardrail.ts +176 -0
  259. package/src/safety/types.ts +124 -0
  260. package/src/spec/CONTEXT.md +19 -0
  261. package/src/spec/__tests__/annotation-checker.test.ts +289 -0
  262. package/src/spec/annotation-checker.ts +342 -0
  263. package/src/tools/CONTEXT.md +25 -0
  264. package/src/tools/__tests__/loader.test.ts +252 -0
  265. package/src/tools/__tests__/registry.test.ts +157 -0
  266. package/src/tools/core/__tests__/core.test.ts +122 -0
  267. package/src/tools/core/index.ts +201 -0
  268. package/src/tools/core/package.json +7 -0
  269. package/src/tools/core/pnpm-lock.yaml +232 -0
  270. package/src/tools/definitions/core/code/fingerprint.sh +273 -0
  271. package/src/tools/definitions/core/code/fingerprint.yml +72 -0
  272. package/src/tools/definitions/core/code/parse.yml +68 -0
  273. package/src/tools/definitions/core/code/register-language.sh +475 -0
  274. package/src/tools/definitions/core/code/register-language.yml +74 -0
  275. package/src/tools/definitions/core/docker/build.yml +73 -0
  276. package/src/tools/definitions/core/docker/run.yml +81 -0
  277. package/src/tools/definitions/core/file/copy.yml +88 -0
  278. package/src/tools/definitions/core/file/read.yml +69 -0
  279. package/src/tools/definitions/core/file/write.yml +75 -0
  280. package/src/tools/definitions/core/git/branch.yml +61 -0
  281. package/src/tools/definitions/core/git/cleanup-worktree.yml +50 -0
  282. package/src/tools/definitions/core/git/clone.yml +69 -0
  283. package/src/tools/definitions/core/git/commit.yml +65 -0
  284. package/src/tools/definitions/core/git/push.yml +79 -0
  285. package/src/tools/definitions/core/git/worktree.yml +96 -0
  286. package/src/tools/definitions/core/notification/notify.sh +152 -0
  287. package/src/tools/definitions/core/notification/notify.yml +60 -0
  288. package/src/tools/definitions/core/npm/build.yml +75 -0
  289. package/src/tools/definitions/core/npm/install.yml +58 -0
  290. package/src/tools/definitions/core/npm/test.yml +75 -0
  291. package/src/tools/definitions/core/validation/check-reuse.yml +170 -0
  292. package/src/tools/definitions/core/validation/validate-handlers.yml +118 -0
  293. package/src/tools/definitions/core/validation/validate-readme-stats.yml +155 -0
  294. package/src/tools/definitions/core/validation/validate-yaml-syntax.yml +134 -0
  295. package/src/tools/definitions/ext/browser/browser-automate.sh +255 -0
  296. package/src/tools/definitions/ext/browser/browser-automate.yml +166 -0
  297. package/src/tools/definitions/ext/browser/browser-close.sh +104 -0
  298. package/src/tools/definitions/ext/browser/browser-close.yml +55 -0
  299. package/src/tools/definitions/ext/browser/browser-mcp-debug.sh +682 -0
  300. package/src/tools/definitions/ext/browser/browser-mcp-debug.yml +167 -0
  301. package/src/tools/definitions/ext/browser/browser-start.sh +101 -0
  302. package/src/tools/definitions/ext/browser/browser-start.yml +62 -0
  303. package/src/tools/definitions/registry.json +795 -0
  304. package/src/tools/definitions/std/README.md +350 -0
  305. package/src/tools/definitions/std/analysis/analyze-codebase.yml +72 -0
  306. package/src/tools/definitions/std/analysis/analyze-diff.yml +182 -0
  307. package/src/tools/definitions/std/analysis/analyze-git-diff.yml +70 -0
  308. package/src/tools/definitions/std/analysis/analyze-impact.yml +78 -0
  309. package/src/tools/definitions/std/analysis/analyze-requirements.yml +105 -0
  310. package/src/tools/definitions/std/analysis/brainstorm-options.yml +106 -0
  311. package/src/tools/definitions/std/analysis/build-graph.yml +154 -0
  312. package/src/tools/definitions/std/analysis/clarify-requirements.yml +90 -0
  313. package/src/tools/definitions/std/analysis/detect-context.yml +109 -0
  314. package/src/tools/definitions/std/analysis/detect-layers.yml +125 -0
  315. package/src/tools/definitions/std/analysis/generate-tour.yml +102 -0
  316. package/src/tools/definitions/std/analysis/search-enhance.yml +105 -0
  317. package/src/tools/definitions/std/backlog/add.yml +51 -0
  318. package/src/tools/definitions/std/backlog/decide.yml +39 -0
  319. package/src/tools/definitions/std/backlog/github-sync.yml +161 -0
  320. package/src/tools/definitions/std/backlog/list.yml +53 -0
  321. package/src/tools/definitions/std/backlog/load.yml +46 -0
  322. package/src/tools/definitions/std/backlog/resolve.yml +37 -0
  323. package/src/tools/definitions/std/backlog/update.yml +42 -0
  324. package/src/tools/definitions/std/bugfix/diagnose.yml +68 -0
  325. package/src/tools/definitions/std/bugfix/fix.yml +66 -0
  326. package/src/tools/definitions/std/bugfix/verify.yml +69 -0
  327. package/src/tools/definitions/std/constraint/check-decomposition.yml +103 -0
  328. package/src/tools/definitions/std/constraint/check-feature-list.yml +77 -0
  329. package/src/tools/definitions/std/constraint/check-progress.yml +97 -0
  330. package/src/tools/definitions/std/constraint/generate-report.yml +147 -0
  331. package/src/tools/definitions/std/deploy/commit-push.yml +33 -0
  332. package/src/tools/definitions/std/deploy/deploy-backend.yml +37 -0
  333. package/src/tools/definitions/std/deploy/deploy-frontend.yml +37 -0
  334. package/src/tools/definitions/std/deploy/rollback.yml +148 -0
  335. package/src/tools/definitions/std/design/analyze-architecture-impact.yml +113 -0
  336. package/src/tools/definitions/std/design/design-api.yml +55 -0
  337. package/src/tools/definitions/std/design/design-architecture.yml +97 -0
  338. package/src/tools/definitions/std/design/design-db.yml +81 -0
  339. package/src/tools/definitions/std/design/generate-spec.yml +182 -0
  340. package/src/tools/definitions/std/development/develop-api.yml +85 -0
  341. package/src/tools/definitions/std/development/develop-backend.yml +88 -0
  342. package/src/tools/definitions/std/development/develop-frontend.yml +87 -0
  343. package/src/tools/definitions/std/development/develop-shared-types.yml +74 -0
  344. package/src/tools/definitions/std/development/develop-task.yml +122 -0
  345. package/src/tools/definitions/std/development/develop-tests.yml +76 -0
  346. package/src/tools/definitions/std/development/execute-batch.yml +152 -0
  347. package/src/tools/definitions/std/development/fix-issues.yml +100 -0
  348. package/src/tools/definitions/std/development/implement-task.yml +124 -0
  349. package/src/tools/definitions/std/development/review-fix-cycle.yml +232 -0
  350. package/src/tools/definitions/std/evolution/implement.yml +125 -0
  351. package/src/tools/definitions/std/evolution/prioritize.yml +112 -0
  352. package/src/tools/definitions/std/evolution/report-gap.yml +166 -0
  353. package/src/tools/definitions/std/file/read.yml +21 -0
  354. package/src/tools/definitions/std/governance/aggregate-opinions.sh +201 -0
  355. package/src/tools/definitions/std/governance/aggregate-opinions.yml +79 -0
  356. package/src/tools/definitions/std/governance/audit-task.yml +178 -0
  357. package/src/tools/definitions/std/governance/cast-vote.yml +129 -0
  358. package/src/tools/definitions/std/governance/collect-issues.yml +16 -0
  359. package/src/tools/definitions/std/governance/create-signed-document.yml +23 -0
  360. package/src/tools/definitions/std/governance/create-voting-session.yml +101 -0
  361. package/src/tools/definitions/std/governance/define-stance.sh +243 -0
  362. package/src/tools/definitions/std/governance/define-stance.yml +82 -0
  363. package/src/tools/definitions/std/governance/generate-review-report.yml +23 -0
  364. package/src/tools/definitions/std/governance/impeach.yml +179 -0
  365. package/src/tools/definitions/std/governance/multi-stance-review.yml +154 -0
  366. package/src/tools/definitions/std/governance/prepare-artifact.yml +20 -0
  367. package/src/tools/definitions/std/governance/review-spec-approval.yml +262 -0
  368. package/src/tools/definitions/std/governance/rollback.yml +186 -0
  369. package/src/tools/definitions/std/governance/stance-review.yml +149 -0
  370. package/src/tools/definitions/std/governance/track-effect.yml +199 -0
  371. package/src/tools/definitions/std/governance/vote-tally.yml +144 -0
  372. package/src/tools/definitions/std/patch/execute.yml +51 -0
  373. package/src/tools/definitions/std/planning/generate-tasks.yml +36 -0
  374. package/src/tools/definitions/std/planning/load-tasks.yml +44 -0
  375. package/src/tools/definitions/std/planning/split-batch.yml +481 -0
  376. package/src/tools/definitions/std/planning/split-tasks.yml +359 -0
  377. package/src/tools/definitions/std/planning/update-tasks.yml +51 -0
  378. package/src/tools/definitions/std/planning/validate-tasks.yml +46 -0
  379. package/src/tools/definitions/std/project/decide-next-workflow.yml +38 -0
  380. package/src/tools/definitions/std/project/load-state.yml +31 -0
  381. package/src/tools/definitions/std/project/save-state.yml +32 -0
  382. package/src/tools/definitions/std/quality/check-quality.yml +241 -0
  383. package/src/tools/definitions/std/quality/debug-systematic.yml +163 -0
  384. package/src/tools/definitions/std/quality/handle-feedback.yml +108 -0
  385. package/src/tools/definitions/std/quality/review-code.yml +128 -0
  386. package/src/tools/definitions/std/quality/review-spec.yml +140 -0
  387. package/src/tools/definitions/std/quality/review-task.yml +190 -0
  388. package/src/tools/definitions/std/quality/run-tests.yml +80 -0
  389. package/src/tools/definitions/std/quick/analyze.yml +56 -0
  390. package/src/tools/definitions/std/quick/implement.yml +67 -0
  391. package/src/tools/definitions/std/quick/verify.yml +71 -0
  392. package/src/tools/definitions/std/verification/verify_completion.yml +113 -0
  393. package/src/tools/definitions/std/verification/wait-condition.yml +107 -0
  394. package/src/tools/index.ts +5 -0
  395. package/src/tools/loader.ts +216 -0
  396. package/src/tools/paths.ts +15 -0
  397. package/src/tools/registry.ts +128 -0
  398. package/src/tools/types.ts +46 -0
  399. package/src/types/__tests__/types.test.ts +86 -0
  400. package/src/types/checkpoint.ts +174 -0
  401. package/src/types/constraint.ts +335 -0
  402. package/src/types/cso.ts +37 -0
  403. package/src/types/enforcement.ts +48 -0
  404. package/src/types/index.ts +59 -0
  405. package/src/types/iron-law.ts +50 -0
  406. package/src/types/passes-gate.ts +185 -0
  407. package/src/types/performance.ts +295 -0
  408. package/src/types/project-config.ts +251 -0
  409. package/src/types/session.ts +132 -0
  410. package/src/types/spec.ts +91 -0
  411. package/src/types/trace.ts +228 -0
  412. package/src/utils/detect-source-roots.ts +114 -0
  413. package/src/utils/exec.ts +61 -0
  414. package/src/verification/CONTEXT.md +23 -0
  415. package/src/verification/__tests__/loop.test.ts +303 -0
  416. package/src/verification/__tests__/rules-based.test.ts +240 -0
  417. package/src/verification/index.ts +3 -0
  418. package/src/verification/loop.ts +137 -0
  419. package/src/verification/rules-based.ts +153 -0
  420. package/src/verification/types.ts +81 -0
@@ -0,0 +1,343 @@
1
+ /**
2
+ * flow 命令测试
3
+ */
4
+
5
+ import { flow } from '../flow';
6
+ import * as fs from 'fs';
7
+ import * as readline from 'readline';
8
+ import { TraceCollector } from '../../../monitoring/traces';
9
+ import { TraceAnalyzer } from '../../../monitoring/trace-analyzer';
10
+ import { ConstraintDoctor } from '../../../monitoring/constraint-doctor';
11
+ import { ConstraintEvolver } from '../../../monitoring/constraint-evolver';
12
+
13
+ // Mock fs
14
+ jest.mock('fs', () => ({
15
+ existsSync: jest.fn().mockReturnValue(false),
16
+ readFileSync: jest.fn().mockReturnValue(''),
17
+ mkdirSync: jest.fn(),
18
+ writeFileSync: jest.fn(),
19
+ }));
20
+
21
+ // Mock readline
22
+ jest.mock('readline', () => ({
23
+ createInterface: jest.fn().mockReturnValue({
24
+ question: jest.fn(),
25
+ close: jest.fn(),
26
+ }),
27
+ }));
28
+
29
+ // Mock monitoring modules
30
+ jest.mock('../../../monitoring/traces', () => ({
31
+ TraceCollector: jest.fn(),
32
+ }));
33
+
34
+ jest.mock('../../../monitoring/trace-analyzer', () => ({
35
+ TraceAnalyzer: jest.fn(),
36
+ }));
37
+
38
+ jest.mock('../../../monitoring/constraint-doctor', () => ({
39
+ ConstraintDoctor: jest.fn(),
40
+ }));
41
+
42
+ jest.mock('../../../monitoring/constraint-evolver', () => ({
43
+ ConstraintEvolver: jest.fn(),
44
+ }));
45
+
46
+ // Mock chalk
47
+ jest.mock('chalk', () => ({
48
+ blue: jest.fn((str: string) => str),
49
+ yellow: jest.fn((str: string) => str),
50
+ green: jest.fn((str: string) => str),
51
+ gray: jest.fn((str: string) => str),
52
+ red: jest.fn((str: string) => str),
53
+ }));
54
+
55
+ const mockFs = fs as jest.Mocked<typeof fs>;
56
+ const MockTraceCollector = TraceCollector as jest.MockedClass<typeof TraceCollector>;
57
+ const MockTraceAnalyzer = TraceAnalyzer as jest.MockedClass<typeof TraceAnalyzer>;
58
+ const MockConstraintDoctor = ConstraintDoctor as jest.MockedClass<typeof ConstraintDoctor>;
59
+ const MockConstraintEvolver = ConstraintEvolver as jest.MockedClass<typeof ConstraintEvolver>;
60
+
61
+ describe('flow command', () => {
62
+ let consoleSpy: jest.SpyInstance;
63
+ let mockRl: { question: jest.Mock; close: jest.Mock };
64
+
65
+ beforeEach(() => {
66
+ jest.clearAllMocks();
67
+ consoleSpy = jest.spyOn(console, 'log').mockImplementation();
68
+ process.exitCode = 0;
69
+
70
+ mockRl = {
71
+ question: jest.fn((q: string, cb: (a: string) => void) => cb('y')),
72
+ close: jest.fn(),
73
+ };
74
+ (readline.createInterface as jest.Mock).mockReturnValue(mockRl);
75
+
76
+ // Reset fs mocks
77
+ mockFs.existsSync.mockReturnValue(false);
78
+ mockFs.readFileSync.mockReturnValue('');
79
+ mockFs.mkdirSync.mockReturnValue('');
80
+ mockFs.writeFileSync.mockReturnValue(undefined as any);
81
+ });
82
+
83
+ afterEach(() => {
84
+ consoleSpy.mockRestore();
85
+ process.exitCode = 0;
86
+ });
87
+
88
+ describe('flow', () => {
89
+ it('应该跳过无 trace 记录情况', async () => {
90
+ mockFs.existsSync.mockReturnValue(false);
91
+
92
+ await flow({});
93
+ expect(consoleSpy).toHaveBeenCalledWith(expect.stringContaining('暂无 Trace'));
94
+ });
95
+
96
+ it('应该跳过无异常情况', async () => {
97
+ mockFs.existsSync.mockReturnValue(true);
98
+ mockFs.readFileSync.mockReturnValue('{}');
99
+
100
+ const mockCollector = {
101
+ read: jest.fn().mockReturnValue([]),
102
+ };
103
+ const mockAnalyzer = {
104
+ summarize: jest.fn().mockReturnValue([]),
105
+ detectAnomalies: jest.fn().mockReturnValue([]),
106
+ };
107
+ (MockTraceCollector as any).mockImplementation(() => mockCollector);
108
+ (MockTraceAnalyzer as any).mockImplementation(() => mockAnalyzer);
109
+
110
+ await flow({});
111
+ expect(consoleSpy).toHaveBeenCalledWith(expect.stringContaining('未发现异常'));
112
+ });
113
+
114
+ it('应该运行完整流程', async () => {
115
+ mockFs.existsSync.mockReturnValue(true);
116
+ mockFs.readFileSync.mockReturnValue(JSON.stringify({ constraintId: 'test' }));
117
+
118
+ const mockCollector = {
119
+ read: jest.fn().mockReturnValue([]),
120
+ };
121
+ const mockAnalyzer = {
122
+ summarize: jest.fn().mockReturnValue([
123
+ { constraintId: 'test', level: 'iron_law', passRate: 0.3 },
124
+ ]),
125
+ detectAnomalies: jest.fn().mockReturnValue([
126
+ { constraintId: 'test', type: 'high_failure_rate' },
127
+ ]),
128
+ };
129
+ (MockTraceCollector as any).mockImplementation(() => mockCollector);
130
+ (MockTraceAnalyzer as any).mockImplementation(() => mockAnalyzer);
131
+
132
+ const mockDoctor = {
133
+ diagnose: jest.fn().mockResolvedValue({
134
+ anomalyId: 'test-anomaly',
135
+ constraintId: 'test',
136
+ rootCause: { primary: 'test' },
137
+ impact: { severity: 'high' },
138
+ }),
139
+ };
140
+ (MockConstraintDoctor as any).mockImplementation(() => mockDoctor);
141
+
142
+ const mockEvolver = {
143
+ propose: jest.fn().mockResolvedValue({
144
+ constraintId: 'test',
145
+ type: 'adjust_threshold',
146
+ risk: { level: 'low' },
147
+ }),
148
+ };
149
+ (MockConstraintEvolver as any).mockImplementation(() => mockEvolver);
150
+
151
+ await flow({});
152
+ expect(consoleSpy).toHaveBeenCalledWith(expect.stringContaining('流程完成'));
153
+ });
154
+
155
+ it('应该支持从诊断步骤开始', async () => {
156
+ mockFs.existsSync.mockReturnValue(true);
157
+ mockFs.readFileSync.mockReturnValue(JSON.stringify({ constraintId: 'test' }));
158
+
159
+ const mockCollector = {
160
+ read: jest.fn().mockReturnValue([]),
161
+ };
162
+ const mockAnalyzer = {
163
+ summarize: jest.fn().mockReturnValue([]),
164
+ detectAnomalies: jest.fn().mockReturnValue([]),
165
+ };
166
+ (MockTraceCollector as any).mockImplementation(() => mockCollector);
167
+ (MockTraceAnalyzer as any).mockImplementation(() => mockAnalyzer);
168
+
169
+ await flow({ from: 'diagnose' });
170
+ expect(consoleSpy).toHaveBeenCalled();
171
+ });
172
+
173
+ it('应该自动应用低风险提案', async () => {
174
+ mockFs.existsSync.mockReturnValue(true);
175
+ mockFs.readFileSync.mockReturnValue(JSON.stringify({ constraintId: 'test' }));
176
+
177
+ const mockCollector = {
178
+ read: jest.fn().mockReturnValue([]),
179
+ };
180
+ const mockAnalyzer = {
181
+ summarize: jest.fn().mockReturnValue([
182
+ { constraintId: 'test', level: 'iron_law', passRate: 0.3 },
183
+ ]),
184
+ detectAnomalies: jest.fn().mockReturnValue([
185
+ { constraintId: 'test', type: 'high_failure_rate' },
186
+ ]),
187
+ };
188
+ (MockTraceCollector as any).mockImplementation(() => mockCollector);
189
+ (MockTraceAnalyzer as any).mockImplementation(() => mockAnalyzer);
190
+
191
+ const mockDoctor = {
192
+ diagnose: jest.fn().mockResolvedValue({
193
+ anomalyId: 'test-anomaly',
194
+ constraintId: 'test',
195
+ rootCause: { primary: 'test' },
196
+ impact: { severity: 'high' },
197
+ }),
198
+ };
199
+ (MockConstraintDoctor as any).mockImplementation(() => mockDoctor);
200
+
201
+ const mockEvolver = {
202
+ propose: jest.fn().mockResolvedValue({
203
+ constraintId: 'test',
204
+ type: 'adjust_threshold',
205
+ risk: { level: 'low' },
206
+ }),
207
+ };
208
+ (MockConstraintEvolver as any).mockImplementation(() => mockEvolver);
209
+
210
+ mockRl.question
211
+ .mockImplementationOnce((q: string, cb: (a: string) => void) => cb('y'))
212
+ .mockImplementationOnce((q: string, cb: (a: string) => void) => cb('y'));
213
+
214
+ await flow({ autoApply: true });
215
+ expect(consoleSpy).toHaveBeenCalledWith(expect.stringContaining('自动应用'));
216
+ });
217
+
218
+ it('应该取消当用户在步骤1输入 n', async () => {
219
+ mockFs.existsSync.mockReturnValue(true);
220
+ mockFs.readFileSync.mockReturnValue(JSON.stringify({ constraintId: 'test' }));
221
+
222
+ const mockAnalyzer = {
223
+ summarize: jest.fn().mockReturnValue([]),
224
+ detectAnomalies: jest.fn().mockReturnValue([
225
+ { constraintId: 'test', type: 'high_failure_rate' },
226
+ ]),
227
+ };
228
+ (MockTraceCollector as any).mockImplementation(() => ({}));
229
+ (MockTraceAnalyzer as any).mockImplementation(() => mockAnalyzer);
230
+
231
+ mockRl.question.mockImplementationOnce((q: string, cb: (a: string) => void) => cb('n'));
232
+
233
+ await flow({});
234
+ expect(consoleSpy).toHaveBeenCalledWith(expect.stringContaining('已取消'));
235
+ });
236
+
237
+ it('应该跳过提案当无提案生成', async () => {
238
+ mockFs.existsSync.mockReturnValue(true);
239
+ mockFs.readFileSync.mockReturnValue(JSON.stringify({ constraintId: 'test' }));
240
+
241
+ const mockAnalyzer = {
242
+ summarize: jest.fn().mockReturnValue([]),
243
+ detectAnomalies: jest.fn().mockReturnValue([
244
+ { constraintId: 'test', type: 'high_failure_rate' },
245
+ ]),
246
+ };
247
+ (MockTraceCollector as any).mockImplementation(() => ({}));
248
+ (MockTraceAnalyzer as any).mockImplementation(() => mockAnalyzer);
249
+
250
+ const mockDoctor = {
251
+ diagnose: jest.fn().mockResolvedValue({
252
+ constraintId: 'test',
253
+ rootCause: { primary: 'test' },
254
+ impact: { severity: 'high' },
255
+ }),
256
+ };
257
+ (MockConstraintDoctor as any).mockImplementation(() => mockDoctor);
258
+
259
+ const mockEvolver = {
260
+ propose: jest.fn().mockResolvedValue(null),
261
+ };
262
+ (MockConstraintEvolver as any).mockImplementation(() => mockEvolver);
263
+
264
+ mockRl.question
265
+ .mockImplementationOnce((q: string, cb: (a: string) => void) => cb('y'))
266
+ .mockImplementationOnce((q: string, cb: (a: string) => void) => cb('y'));
267
+
268
+ await flow({});
269
+ expect(consoleSpy).toHaveBeenCalledWith(expect.stringContaining('无需优化'));
270
+ });
271
+
272
+ it('应该处理诊断失败', async () => {
273
+ mockFs.existsSync.mockReturnValue(true);
274
+ mockFs.readFileSync.mockReturnValue(JSON.stringify({ constraintId: 'test' }));
275
+
276
+ const mockAnalyzer = {
277
+ summarize: jest.fn().mockReturnValue([]),
278
+ detectAnomalies: jest.fn().mockReturnValue([
279
+ { constraintId: 'test', type: 'high_failure_rate' },
280
+ ]),
281
+ };
282
+ (MockTraceCollector as any).mockImplementation(() => ({}));
283
+ (MockTraceAnalyzer as any).mockImplementation(() => mockAnalyzer);
284
+
285
+ const mockDoctor = {
286
+ diagnose: jest.fn().mockRejectedValue(new Error('diagnosis failed')),
287
+ };
288
+ (MockConstraintDoctor as any).mockImplementation(() => mockDoctor);
289
+
290
+ const mockEvolver = {
291
+ propose: jest.fn().mockResolvedValue(null),
292
+ };
293
+ (MockConstraintEvolver as any).mockImplementation(() => mockEvolver);
294
+
295
+ mockRl.question
296
+ .mockImplementationOnce((q: string, cb: (a: string) => void) => cb('y'))
297
+ .mockImplementationOnce((q: string, cb: (a: string) => void) => cb('y'));
298
+
299
+ await flow({});
300
+ expect(consoleSpy).toHaveBeenCalledWith(expect.stringContaining('诊断失败'));
301
+ });
302
+
303
+ it('应该跳过提案当用户输入 n', async () => {
304
+ mockFs.existsSync.mockReturnValue(true);
305
+ mockFs.readFileSync.mockReturnValue(JSON.stringify({ constraintId: 'test' }));
306
+
307
+ const mockAnalyzer = {
308
+ summarize: jest.fn().mockReturnValue([]),
309
+ detectAnomalies: jest.fn().mockReturnValue([
310
+ { constraintId: 'test', type: 'high_failure_rate' },
311
+ ]),
312
+ };
313
+ (MockTraceCollector as any).mockImplementation(() => ({}));
314
+ (MockTraceAnalyzer as any).mockImplementation(() => mockAnalyzer);
315
+
316
+ const mockDoctor = {
317
+ diagnose: jest.fn().mockResolvedValue({
318
+ constraintId: 'test',
319
+ rootCause: { primary: 'test' },
320
+ impact: { severity: 'high' },
321
+ }),
322
+ };
323
+ (MockConstraintDoctor as any).mockImplementation(() => mockDoctor);
324
+
325
+ const mockEvolver = {
326
+ propose: jest.fn().mockResolvedValue({
327
+ constraintId: 'test',
328
+ type: 'adjust_threshold',
329
+ risk: { level: 'medium' },
330
+ }),
331
+ };
332
+ (MockConstraintEvolver as any).mockImplementation(() => mockEvolver);
333
+
334
+ mockRl.question
335
+ .mockImplementationOnce((q: string, cb: (a: string) => void) => cb('y'))
336
+ .mockImplementationOnce((q: string, cb: (a: string) => void) => cb('y'))
337
+ .mockImplementationOnce((q: string, cb: (a: string) => void) => cb('n'));
338
+
339
+ await flow({});
340
+ expect(consoleSpy).toHaveBeenCalledWith(expect.stringContaining('跳过提案'));
341
+ });
342
+ });
343
+ });
@@ -0,0 +1,306 @@
1
+ /**
2
+ * init 命令测试
3
+ */
4
+
5
+ import { init } from '../init';
6
+ import * as fs from 'fs/promises';
7
+
8
+ // Mock fs/promises
9
+ const mockReaddir = jest.fn().mockResolvedValue([]);
10
+ const existingFiles = new Set<string>();
11
+
12
+ // Mock fs (sync) for detectSourceRoots and setupClaudeMdConstraints
13
+ const mockExistsSync = jest.fn().mockReturnValue(false);
14
+ const mockReaddirSync = jest.fn().mockReturnValue([]);
15
+
16
+ jest.mock('fs', () => ({
17
+ existsSync: (...args: any[]) => mockExistsSync(...args),
18
+ readdirSync: (...args: any[]) => mockReaddirSync(...args),
19
+ statSync: jest.fn(),
20
+ readFileSync: jest.fn().mockReturnValue('{"version": "1.0.0"}'),
21
+ }));
22
+
23
+ jest.mock('fs/promises', () => ({
24
+ mkdir: jest.fn(),
25
+ writeFile: jest.fn(),
26
+ readFile: jest.fn().mockRejectedValue(new Error('ENOENT')),
27
+ access: jest.fn((path: string) => {
28
+ if (existingFiles.has(path)) return Promise.resolve(undefined);
29
+ return Promise.reject(new Error(`ENOENT: ${path}`));
30
+ }),
31
+ chmod: jest.fn(),
32
+ readdir: (...args: any[]) => mockReaddir(...args),
33
+ }));
34
+
35
+ // Mock js-yaml
36
+ jest.mock('js-yaml', () => ({
37
+ dump: jest.fn().mockReturnValue('yaml content'),
38
+ load: jest.fn(),
39
+ }));
40
+
41
+ // Mock chalk
42
+ jest.mock('chalk', () => ({
43
+ blue: jest.fn((str: string) => str),
44
+ yellow: jest.fn((str: string) => str),
45
+ green: jest.fn((str: string) => str),
46
+ gray: jest.fn((str: string) => str),
47
+ red: jest.fn((str: string) => str),
48
+ cyan: jest.fn((str: string) => str),
49
+ bold: jest.fn((str: string) => str),
50
+ }));
51
+
52
+ // Mock validate module
53
+ jest.mock('../validate', () => ({
54
+ createExampleCheckpoint: jest.fn(),
55
+ createExampleResolutions: jest.fn(),
56
+ }));
57
+
58
+ const mockFs = fs as jest.Mocked<typeof fs>;
59
+
60
+ // Use explicit projectPath to avoid CI path mismatch
61
+ const PROJECT = '/test/project';
62
+
63
+ describe('init command', () => {
64
+ let consoleSpy: jest.SpyInstance;
65
+
66
+ beforeEach(() => {
67
+ jest.clearAllMocks();
68
+ existingFiles.clear();
69
+ mockExistsSync.mockReturnValue(false);
70
+ mockReaddirSync.mockReturnValue([]);
71
+ consoleSpy = jest.spyOn(console, 'log').mockImplementation();
72
+ });
73
+
74
+ afterEach(() => {
75
+ consoleSpy.mockRestore();
76
+ });
77
+
78
+ describe('init', () => {
79
+ it('应该创建配置目录', async () => {
80
+ mockFs.mkdir.mockResolvedValue(undefined);
81
+ mockFs.writeFile.mockResolvedValue(undefined);
82
+
83
+ await init({ preset: 'standard', projectPath: PROJECT });
84
+ expect(mockFs.mkdir).toHaveBeenCalled();
85
+ });
86
+
87
+ it('应该使用 strict 预设', async () => {
88
+ mockFs.mkdir.mockResolvedValue(undefined);
89
+ mockFs.writeFile.mockResolvedValue(undefined);
90
+
91
+ await init({ preset: 'strict', projectPath: PROJECT });
92
+ expect(consoleSpy).toHaveBeenCalledWith(expect.stringContaining('strict'));
93
+ });
94
+
95
+ it('应该使用 relaxed 预设', async () => {
96
+ mockFs.mkdir.mockResolvedValue(undefined);
97
+ mockFs.writeFile.mockResolvedValue(undefined);
98
+
99
+ await init({ preset: 'relaxed', projectPath: PROJECT });
100
+ expect(consoleSpy).toHaveBeenCalledWith(expect.stringContaining('relaxed'));
101
+ });
102
+
103
+ it('应该支持自定义项目路径', async () => {
104
+ mockFs.mkdir.mockResolvedValue(undefined);
105
+ mockFs.writeFile.mockResolvedValue(undefined);
106
+
107
+ await init({ preset: 'standard', projectPath: '/custom/path' });
108
+ expect(mockFs.mkdir).toHaveBeenCalled();
109
+ });
110
+
111
+ it('应该输出代码片段模式', async () => {
112
+ await init({ preset: 'standard', printSnippets: true });
113
+ expect(consoleSpy).toHaveBeenCalled();
114
+ });
115
+ });
116
+
117
+ describe('Git hooks', () => {
118
+ it('应该跳过 Git hooks 当无 .git 目录', async () => {
119
+ mockFs.mkdir.mockResolvedValue(undefined);
120
+ mockFs.writeFile.mockResolvedValue(undefined);
121
+
122
+ await init({ preset: 'standard', projectPath: PROJECT });
123
+ expect(consoleSpy).toHaveBeenCalledWith(expect.stringContaining('未检测到 Git 仓库'));
124
+ });
125
+
126
+ it('应该提示手动添加当 pre-commit 已存在', async () => {
127
+ mockFs.mkdir.mockResolvedValue(undefined);
128
+ mockFs.writeFile.mockResolvedValue(undefined);
129
+ existingFiles.add(`${PROJECT}/.git`);
130
+ existingFiles.add(`${PROJECT}/.git/hooks`);
131
+ existingFiles.add(`${PROJECT}/.git/hooks/pre-commit`);
132
+
133
+ await init({ preset: 'standard', projectPath: PROJECT });
134
+ expect(consoleSpy).toHaveBeenCalledWith(expect.stringContaining('pre-commit 已存在'));
135
+ });
136
+
137
+ it('应该创建 pre-commit hook', async () => {
138
+ mockFs.mkdir.mockResolvedValue(undefined);
139
+ mockFs.writeFile.mockResolvedValue(undefined);
140
+ existingFiles.add(`${PROJECT}/.git`);
141
+ existingFiles.add(`${PROJECT}/.git/hooks`);
142
+
143
+ await init({ preset: 'standard', projectPath: PROJECT });
144
+ expect(consoleSpy).toHaveBeenCalledWith(expect.stringContaining('已创建 .git/hooks/pre-commit'));
145
+ });
146
+ });
147
+
148
+ describe('GitHub Actions', () => {
149
+ it('应该提示当已有 CI 配置', async () => {
150
+ mockFs.mkdir.mockResolvedValue(undefined);
151
+ mockFs.writeFile.mockResolvedValue(undefined);
152
+ mockReaddir.mockResolvedValue(['ci.yml']);
153
+ existingFiles.add(`${PROJECT}/.github/workflows`);
154
+
155
+ await init({ preset: 'standard', projectPath: PROJECT });
156
+ expect(consoleSpy).toHaveBeenCalledWith(expect.stringContaining('已存在的 CI 配置'));
157
+ });
158
+ });
159
+
160
+ describe('CAPABILITIES.md', () => {
161
+ it('init 不应创建 CAPABILITIES.md(由 sync-docs 管理)', async () => {
162
+ mockFs.mkdir.mockResolvedValue(undefined);
163
+ mockFs.writeFile.mockResolvedValue(undefined);
164
+
165
+ await init({ preset: 'standard', projectPath: PROJECT });
166
+ const writes = mockFs.writeFile.mock.calls.map((c: unknown[]) => String(c[0]));
167
+ expect(writes.every((w: string) => !w.includes('CAPABILITIES.md'))).toBe(true);
168
+ });
169
+ });
170
+
171
+ describe('custom-constraints', () => {
172
+ it('应该跳过创建当已存在', async () => {
173
+ mockFs.mkdir.mockResolvedValue(undefined);
174
+ mockFs.writeFile.mockResolvedValue(undefined);
175
+ existingFiles.add(`${PROJECT}/.harness/custom-constraints.yml`);
176
+
177
+ await init({ preset: 'standard', projectPath: PROJECT });
178
+ expect(consoleSpy).toHaveBeenCalledWith(expect.stringContaining('custom-constraints.yml 已存在'));
179
+ });
180
+ });
181
+
182
+ describe('governance', () => {
183
+ it('应该在配置中包含 governance 段', async () => {
184
+ mockFs.mkdir.mockResolvedValue(undefined);
185
+ mockFs.writeFile.mockResolvedValue(undefined);
186
+
187
+ await init({ preset: 'standard', governance: 'standard', projectPath: PROJECT });
188
+ expect(consoleSpy).toHaveBeenCalledWith(expect.stringContaining('治理级别: standard'));
189
+ });
190
+
191
+ it('应该创建 CHANGELOG.md', async () => {
192
+ mockFs.mkdir.mockResolvedValue(undefined);
193
+ mockFs.writeFile.mockResolvedValue(undefined);
194
+
195
+ await init({ preset: 'standard', governance: 'standard', projectPath: PROJECT });
196
+ const writeCalls = mockFs.writeFile.mock.calls;
197
+ const changelogCall = writeCalls.find((c: any[]) => String(c[0]).includes('CHANGELOG.md'));
198
+ expect(changelogCall).toBeDefined();
199
+ expect(changelogCall![1]).toContain('Changelog');
200
+ });
201
+
202
+ it('应该跳过 CHANGELOG.md 当已存在', async () => {
203
+ mockFs.mkdir.mockResolvedValue(undefined);
204
+ mockFs.writeFile.mockResolvedValue(undefined);
205
+ existingFiles.add(`${PROJECT}/CHANGELOG.md`);
206
+
207
+ await init({ preset: 'standard', governance: 'standard', projectPath: PROJECT });
208
+ expect(consoleSpy).toHaveBeenCalledWith(expect.stringContaining('CHANGELOG.md 已存在'));
209
+ });
210
+
211
+ it('应该为 standard 治理创建 src/CONTEXT.md', async () => {
212
+ mockFs.mkdir.mockResolvedValue(undefined);
213
+ mockFs.writeFile.mockResolvedValue(undefined);
214
+ existingFiles.add(`${PROJECT}/src`);
215
+
216
+ mockExistsSync.mockImplementation((path: string) => path === `${PROJECT}/src`);
217
+ mockReaddirSync.mockImplementation((dir: string) => {
218
+ if (dir === `${PROJECT}/src`) {
219
+ return [{ name: 'index.ts', isFile: () => true, isDirectory: () => false }];
220
+ }
221
+ return [];
222
+ });
223
+
224
+ await init({ preset: 'standard', governance: 'standard', projectPath: PROJECT });
225
+ const writeCalls = mockFs.writeFile.mock.calls;
226
+ const contextCall = writeCalls.find((c: any[]) => String(c[0]).includes('CONTEXT.md'));
227
+ expect(contextCall).toBeDefined();
228
+ expect(contextCall![1]).toContain('职责');
229
+ });
230
+
231
+ it('应该跳过 CONTEXT.md 当目录不存在', async () => {
232
+ mockFs.mkdir.mockResolvedValue(undefined);
233
+ mockFs.writeFile.mockResolvedValue(undefined);
234
+
235
+ await init({ preset: 'standard', governance: 'standard', projectPath: PROJECT });
236
+ const writeCalls = mockFs.writeFile.mock.calls;
237
+ const contextCall = writeCalls.find((c: any[]) => String(c[0]).includes('CONTEXT.md'));
238
+ expect(contextCall).toBeUndefined();
239
+ });
240
+
241
+ it('minimal 治理不应创建 CONTEXT.md', async () => {
242
+ mockFs.mkdir.mockResolvedValue(undefined);
243
+ mockFs.writeFile.mockResolvedValue(undefined);
244
+
245
+ await init({ preset: 'standard', governance: 'minimal', projectPath: PROJECT });
246
+ const writeCalls = mockFs.writeFile.mock.calls;
247
+ const contextCall = writeCalls.find((c: any[]) => String(c[0]).includes('CONTEXT.md'));
248
+ expect(contextCall).toBeUndefined();
249
+ });
250
+
251
+ it('应该创建治理 CI workflow', async () => {
252
+ mockFs.mkdir.mockResolvedValue(undefined);
253
+ mockFs.writeFile.mockResolvedValue(undefined);
254
+
255
+ await init({ preset: 'standard', governance: 'standard', projectPath: PROJECT });
256
+ const writeCalls = mockFs.writeFile.mock.calls;
257
+ const workflowCall = writeCalls.find((c: any[]) => String(c[0]).includes('harness-governance.yml'));
258
+ expect(workflowCall).toBeDefined();
259
+ expect(workflowCall![1]).toContain('Harness Governance');
260
+ expect(workflowCall![1]).toContain('harness check');
261
+ });
262
+
263
+ it('应该跳过治理 CI workflow 当已存在', async () => {
264
+ mockFs.mkdir.mockResolvedValue(undefined);
265
+ mockFs.writeFile.mockResolvedValue(undefined);
266
+ existingFiles.add(`${PROJECT}/.github/workflows/harness-governance.yml`);
267
+
268
+ await init({ preset: 'standard', governance: 'standard', projectPath: PROJECT });
269
+ expect(consoleSpy).toHaveBeenCalledWith(expect.stringContaining('harness-governance.yml 已存在'));
270
+ });
271
+
272
+ it('strict 治理应在 CI 中包含 docs check', async () => {
273
+ mockFs.mkdir.mockResolvedValue(undefined);
274
+ mockFs.writeFile.mockResolvedValue(undefined);
275
+
276
+ await init({ preset: 'standard', governance: 'strict', projectPath: PROJECT });
277
+ const writeCalls = mockFs.writeFile.mock.calls;
278
+ const workflowCall = writeCalls.find((c: any[]) => String(c[0]).includes('harness-governance.yml'));
279
+ expect(workflowCall![1]).toContain('sync-docs');
280
+ });
281
+
282
+ it('minimal 治理不应在 CI 中包含 docs check', async () => {
283
+ mockFs.mkdir.mockResolvedValue(undefined);
284
+ mockFs.writeFile.mockResolvedValue(undefined);
285
+
286
+ await init({ preset: 'standard', governance: 'minimal', projectPath: PROJECT });
287
+ const writeCalls = mockFs.writeFile.mock.calls;
288
+ const workflowCall = writeCalls.find((c: any[]) => String(c[0]).includes('harness-governance.yml'));
289
+ expect(workflowCall![1]).not.toContain('sync-docs');
290
+ });
291
+
292
+ it('无 governance 选项时不应创建治理文件', async () => {
293
+ mockFs.mkdir.mockResolvedValue(undefined);
294
+ mockFs.writeFile.mockResolvedValue(undefined);
295
+
296
+ await init({ preset: 'standard', projectPath: PROJECT });
297
+ const writeCalls = mockFs.writeFile.mock.calls;
298
+ const changelogCall = writeCalls.find((c: any[]) => String(c[0]).includes('CHANGELOG.md'));
299
+ const contextCall = writeCalls.find((c: any[]) => String(c[0]).includes('CONTEXT.md'));
300
+ const workflowCall = writeCalls.find((c: any[]) => String(c[0]).includes('harness-governance.yml'));
301
+ expect(changelogCall).toBeUndefined();
302
+ expect(contextCall).toBeUndefined();
303
+ expect(workflowCall).toBeUndefined();
304
+ });
305
+ });
306
+ });