@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
package/src/cli/commands/__tests__/report.test.ts ADDED
@@ -0,0 +1,109 @@
1
+ /**
2
+ * report 命令测试
3
+ */
4
+
5
+ import { report } from '../report';
6
+ import * as fs from 'fs/promises';
7
+
8
+ // Mock fs/promises
9
+ jest.mock('fs/promises', () => ({
10
+ writeFile: jest.fn(),
11
+ }));
12
+
13
+ // Mock chalk
14
+ jest.mock('chalk', () => ({
15
+ blue: jest.fn((str: string) => str),
16
+ green: jest.fn((str: string) => str),
17
+ gray: jest.fn((str: string) => str),
18
+ }));
19
+
20
+ const mockFs = fs as jest.Mocked<typeof fs>;
21
+
22
+ describe('report command', () => {
23
+ let consoleSpy: jest.SpyInstance;
24
+
25
+ beforeEach(() => {
26
+ jest.clearAllMocks();
27
+ consoleSpy = jest.spyOn(console, 'log').mockImplementation();
28
+ });
29
+
30
+ afterEach(() => {
31
+ consoleSpy.mockRestore();
32
+ });
33
+
34
+ describe('report', () => {
35
+ it('应该生成 JSON 格式报告', async () => {
36
+ await report({ format: 'json' });
37
+ expect(consoleSpy).toHaveBeenCalled();
38
+ const output = consoleSpy.mock.calls.map(c => c[0]).join('\n');
39
+ expect(output).toContain('timestamp');
40
+ });
41
+
42
+ it('应该生成 Markdown 格式报告', async () => {
43
+ await report({ format: 'markdown' });
44
+ expect(consoleSpy).toHaveBeenCalledWith(expect.stringContaining('Harness 检查报告'));
45
+ });
46
+
47
+ it('应该生成 HTML 格式报告', async () => {
48
+ await report({ format: 'html' });
49
+ expect(consoleSpy).toHaveBeenCalledWith(expect.stringContaining('<!DOCTYPE html>'));
50
+ });
51
+
52
+ it('应该保存报告到文件', async () => {
53
+ mockFs.writeFile.mockResolvedValue(undefined);
54
+
55
+ await report({ format: 'json', output: 'report.json' });
56
+ expect(mockFs.writeFile).toHaveBeenCalledWith('report.json', expect.any(String), 'utf-8');
57
+ expect(consoleSpy).toHaveBeenCalledWith(expect.stringContaining('报告已保存'));
58
+ });
59
+
60
+ it('应该使用自定义项目路径', async () => {
61
+ await report({ format: 'json', projectPath: '/custom/path' });
62
+ expect(consoleSpy).toHaveBeenCalled();
63
+ });
64
+
65
+ it('Markdown 报告应包含表格结构', async () => {
66
+ await report({ format: 'markdown' });
67
+ const output = consoleSpy.mock.calls.map((c: unknown[]) => c[0]).join('\n');
68
+ expect(output).toContain('| 指标 | 数值 |');
69
+ expect(output).toContain('| 总约束 |');
70
+ expect(output).toContain('报告由 @dommaker/harness 生成');
71
+ });
72
+
73
+ it('HTML 报告应包含完整结构', async () => {
74
+ await report({ format: 'html' });
75
+ const output = consoleSpy.mock.calls.map((c: unknown[]) => c[0]).join('\n');
76
+ expect(output).toContain('<html lang="zh-CN">');
77
+ expect(output).toContain('</html>');
78
+ expect(output).toContain('Harness 检查报告');
79
+ expect(output).toContain('<table>');
80
+ });
81
+
82
+ it('JSON 报告应包含约束统计', async () => {
83
+ await report({ format: 'json' });
84
+ const output = consoleSpy.mock.calls.map((c: unknown[]) => c[0]).join('\n');
85
+ // 过滤掉 chalk 的 emoji 行，只取 JSON 部分
86
+ const jsonStart = output.indexOf('{');
87
+ const jsonEnd = output.lastIndexOf('}');
88
+ const jsonStr = output.slice(jsonStart, jsonEnd + 1);
89
+ const parsed = JSON.parse(jsonStr);
90
+ expect(parsed.constraints).toBeDefined();
91
+ expect(parsed.constraints.total).toBeGreaterThan(0);
92
+ expect(parsed.constraints.ironLaws).toBeGreaterThan(0);
93
+ expect(parsed.timestamp).toBeDefined();
94
+ expect(parsed.projectPath).toBeDefined();
95
+ });
96
+
97
+ it('应该支持输出到文件 (markdown)', async () => {
98
+ mockFs.writeFile.mockResolvedValue(undefined);
99
+ await report({ format: 'markdown', output: 'report.md' });
100
+ expect(mockFs.writeFile).toHaveBeenCalledWith('report.md', expect.stringContaining('# Harness'), 'utf-8');
101
+ });
102
+
103
+ it('应该支持输出到文件 (html)', async () => {
104
+ mockFs.writeFile.mockResolvedValue(undefined);
105
+ await report({ format: 'html', output: 'report.html' });
106
+ expect(mockFs.writeFile).toHaveBeenCalledWith('report.html', expect.stringContaining('<!DOCTYPE html>'), 'utf-8');
107
+ });
108
+ });
109
+ });
package/src/cli/commands/__tests__/review.test.ts ADDED
@@ -0,0 +1,153 @@
1
+ /**
2
+ * review 命令测试
3
+ */
4
+
5
+ import { review, reviewStatus } from '../review';
6
+ import { execAsync } from '../../../utils/exec';
7
+ import { ReviewGate } from '../../../gates/review';
8
+
9
+ jest.mock('../../../utils/exec', () => ({
10
+ execAsync: jest.fn(),
11
+ }));
12
+
13
+ jest.mock('../../../gates/review', () => ({
14
+ ReviewGate: jest.fn().mockImplementation(() => ({
15
+ check: jest.fn(),
16
+ })),
17
+ }));
18
+
19
+ jest.mock('chalk', () => ({
20
+ blue: jest.fn((s: string) => s),
21
+ green: jest.fn((s: string) => s),
22
+ red: jest.fn((s: string) => s),
23
+ yellow: jest.fn((s: string) => s),
24
+ gray: jest.fn((s: string) => s),
25
+ cyan: jest.fn((s: string) => s),
26
+ }));
27
+
28
+ const mockExec = execAsync as jest.MockedFunction<typeof execAsync>;
29
+ const MockGate = ReviewGate as jest.MockedClass<typeof ReviewGate>;
30
+
31
+ describe('review command', () => {
32
+ let consoleSpy: jest.SpyInstance;
33
+ let exitSpy: jest.SpyInstance;
34
+
35
+ beforeEach(() => {
36
+ jest.clearAllMocks();
37
+ consoleSpy = jest.spyOn(console, 'log').mockImplementation();
38
+ exitSpy = jest.spyOn(process, 'exit').mockImplementation(() => undefined as never);
39
+ process.exitCode = 0;
40
+ });
41
+
42
+ afterEach(() => {
43
+ consoleSpy.mockRestore();
44
+ exitSpy.mockRestore();
45
+ process.exitCode = 0;
46
+ });
47
+
48
+ describe('review', () => {
49
+ it('should print success when check passes', async () => {
50
+ mockExec.mockResolvedValue({ stdout: 'main\n', stderr: '' });
51
+ const mockCheck = jest.fn().mockResolvedValue({
52
+ passed: true,
53
+ message: 'ok',
54
+ details: { approvals: 2, changesRequested: 0 },
55
+ });
56
+ MockGate.mockImplementation(() => ({ check: mockCheck }) as any);
57
+
58
+ await review({});
59
+
60
+ expect(consoleSpy).toHaveBeenCalledWith(expect.stringContaining('代码审查门控检查通过'));
61
+ expect(exitSpy).not.toHaveBeenCalled();
62
+ });
63
+
64
+ it('should print failure and exit 1 when check fails', async () => {
65
+ mockExec.mockResolvedValue({ stdout: 'main\n', stderr: '' });
66
+ const mockCheck = jest.fn().mockResolvedValue({
67
+ passed: false,
68
+ message: 'needs approval',
69
+ details: { suggestion: 'Request review from a teammate' },
70
+ });
71
+ MockGate.mockImplementation(() => ({ check: mockCheck }) as any);
72
+
73
+ await review({});
74
+
75
+ expect(consoleSpy).toHaveBeenCalledWith(expect.stringContaining('代码审查门控检查失败'));
76
+ expect(exitSpy).toHaveBeenCalledWith(1);
77
+ });
78
+
79
+ it('should handle errors and exit 1', async () => {
80
+ mockExec.mockResolvedValue({ stdout: 'main\n', stderr: '' });
81
+ const mockCheck = jest.fn().mockRejectedValue(new Error('gate error'));
82
+ MockGate.mockImplementation(() => ({ check: mockCheck }) as any);
83
+
84
+ await review({});
85
+
86
+ expect(consoleSpy).toHaveBeenCalledWith(expect.stringContaining('代码审查门控检查出错'));
87
+ expect(exitSpy).toHaveBeenCalledWith(1);
88
+ });
89
+
90
+ it('should show hint when not in a git repo', async () => {
91
+ mockExec.mockRejectedValue(new Error('not a git repository'));
92
+
93
+ await review({});
94
+
95
+ expect(consoleSpy).toHaveBeenCalledWith(expect.stringContaining('需要在 Git 仓库中运行'));
96
+ expect(exitSpy).toHaveBeenCalledWith(1);
97
+ });
98
+
99
+ it('should parse allowedReviewers from comma-separated string', async () => {
100
+ mockExec.mockResolvedValue({ stdout: 'main\n', stderr: '' });
101
+ const mockCheck = jest.fn().mockResolvedValue({ passed: true, message: 'ok' });
102
+ MockGate.mockImplementation(() => ({ check: mockCheck }) as any);
103
+
104
+ await review({ allowedReviewers: 'alice, bob, charlie' });
105
+
106
+ expect(MockGate).toHaveBeenCalledWith(
107
+ expect.objectContaining({
108
+ allowedReviewers: ['alice', 'bob', 'charlie'],
109
+ }),
110
+ );
111
+ });
112
+ });
113
+
114
+ describe('reviewStatus', () => {
115
+ it('should display PR info', async () => {
116
+ mockExec
117
+ .mockResolvedValueOnce({ stdout: 'feature-branch\n', stderr: '' })
118
+ .mockResolvedValueOnce({
119
+ stdout: JSON.stringify({
120
+ number: 42,
121
+ title: 'Add feature',
122
+ state: 'OPEN',
123
+ reviewDecision: 'APPROVED',
124
+ reviews: [{ author: { login: 'alice' }, state: 'APPROVED' }],
125
+ }),
126
+ stderr: '',
127
+ });
128
+
129
+ await reviewStatus({});
130
+
131
+ expect(consoleSpy).toHaveBeenCalledWith(expect.stringContaining('PR #42'));
132
+ expect(consoleSpy).toHaveBeenCalledWith(expect.stringContaining('APPROVED'));
133
+ });
134
+
135
+ it('should handle no PR found', async () => {
136
+ mockExec
137
+ .mockResolvedValueOnce({ stdout: 'feature-branch\n', stderr: '' })
138
+ .mockRejectedValueOnce(new Error('no PR'));
139
+
140
+ await reviewStatus({});
141
+
142
+ expect(consoleSpy).toHaveBeenCalledWith(expect.stringContaining('未找到关联的 PR'));
143
+ });
144
+
145
+ it('should handle git errors', async () => {
146
+ mockExec.mockRejectedValue(new Error('not a git repository'));
147
+
148
+ await reviewStatus({});
149
+
150
+ expect(consoleSpy).toHaveBeenCalledWith(expect.stringContaining('获取审查状态失败'));
151
+ });
152
+ });
153
+ });
package/src/cli/commands/__tests__/security.test.ts ADDED
@@ -0,0 +1,147 @@
1
+ /**
2
+ * security 命令测试
3
+ */
4
+
5
+ import { security, auditDetails } from '../security';
6
+ import { SecurityGate } from '../../../gates/security';
7
+
8
+ jest.mock('../../../gates/security', () => ({
9
+ SecurityGate: jest.fn().mockImplementation(() => ({
10
+ scan: jest.fn(),
11
+ })),
12
+ }));
13
+
14
+ jest.mock('chalk', () => ({
15
+ blue: jest.fn((s: string) => s),
16
+ green: jest.fn((s: string) => s),
17
+ red: Object.assign(jest.fn((s: string) => s), { bold: jest.fn((s: string) => s) }),
18
+ yellow: jest.fn((s: string) => s),
19
+ gray: jest.fn((s: string) => s),
20
+ }));
21
+
22
+ const MockGate = SecurityGate as jest.MockedClass<typeof SecurityGate>;
23
+
24
+ describe('security command', () => {
25
+ let consoleSpy: jest.SpyInstance;
26
+ let exitSpy: jest.SpyInstance;
27
+
28
+ beforeEach(() => {
29
+ jest.clearAllMocks();
30
+ consoleSpy = jest.spyOn(console, 'log').mockImplementation();
31
+ exitSpy = jest.spyOn(process, 'exit').mockImplementation(() => undefined as never);
32
+ process.exitCode = 0;
33
+ });
34
+
35
+ afterEach(() => {
36
+ consoleSpy.mockRestore();
37
+ exitSpy.mockRestore();
38
+ process.exitCode = 0;
39
+ });
40
+
41
+ describe('security', () => {
42
+ it('should print success when scan passes', async () => {
43
+ const mockScan = jest.fn().mockResolvedValue({
44
+ passed: true,
45
+ message: 'no vulnerabilities',
46
+ details: { critical: 0, high: 0, moderate: 0, low: 0 },
47
+ });
48
+ MockGate.mockImplementation(() => ({ scan: mockScan }) as any);
49
+
50
+ await security({});
51
+
52
+ expect(consoleSpy).toHaveBeenCalledWith(expect.stringContaining('安全门控检查通过'));
53
+ expect(exitSpy).not.toHaveBeenCalled();
54
+ });
55
+
56
+ it('should print failure and exit 1 when scan fails', async () => {
57
+ const mockScan = jest.fn().mockResolvedValue({
58
+ passed: false,
59
+ message: 'vulnerabilities found',
60
+ details: {
61
+ critical: 1,
62
+ high: 2,
63
+ vulnerabilities: [
64
+ { name: 'pkg-a', severity: 'critical', via: 'CVE-2026-0001' },
65
+ { name: 'pkg-b', severity: 'high', via: 'CVE-2026-0002' },
66
+ ],
67
+ },
68
+ });
69
+ MockGate.mockImplementation(() => ({ scan: mockScan }) as any);
70
+
71
+ await security({});
72
+
73
+ expect(consoleSpy).toHaveBeenCalledWith(expect.stringContaining('安全门控检查失败'));
74
+ expect(consoleSpy).toHaveBeenCalledWith(expect.stringContaining('pkg-a'));
75
+ expect(consoleSpy).toHaveBeenCalledWith(expect.stringContaining('pkg-b'));
76
+ expect(exitSpy).toHaveBeenCalledWith(1);
77
+ });
78
+
79
+ it('should default severity to high', async () => {
80
+ const mockScan = jest.fn().mockResolvedValue({ passed: true, message: 'ok' });
81
+ MockGate.mockImplementation(() => ({ scan: mockScan }) as any);
82
+
83
+ await security({});
84
+
85
+ expect(MockGate).toHaveBeenCalledWith(
86
+ expect.objectContaining({ severityThreshold: 'high' }),
87
+ );
88
+ });
89
+
90
+ it('should use custom severity', async () => {
91
+ const mockScan = jest.fn().mockResolvedValue({ passed: true, message: 'ok' });
92
+ MockGate.mockImplementation(() => ({ scan: mockScan }) as any);
93
+
94
+ await security({ severity: 'critical' });
95
+
96
+ expect(MockGate).toHaveBeenCalledWith(
97
+ expect.objectContaining({ severityThreshold: 'critical' }),
98
+ );
99
+ });
100
+ });
101
+
102
+ describe('auditDetails', () => {
103
+ it('should print no vulnerabilities when passed with no total', async () => {
104
+ const mockScan = jest.fn().mockResolvedValue({
105
+ passed: true,
106
+ message: 'ok',
107
+ details: {},
108
+ });
109
+ MockGate.mockImplementation(() => ({ scan: mockScan }) as any);
110
+
111
+ await auditDetails({});
112
+
113
+ expect(consoleSpy).toHaveBeenCalledWith(expect.stringContaining('未发现安全漏洞'));
114
+ });
115
+
116
+ it('should list vulnerabilities when present', async () => {
117
+ const mockScan = jest.fn().mockResolvedValue({
118
+ passed: false,
119
+ message: 'vulns found',
120
+ details: {
121
+ total: 2,
122
+ vulnerabilities: [
123
+ { name: 'pkg-a', severity: 'high', via: 'CVE-2026-0001' },
124
+ { name: 'pkg-b', severity: 'low', via: 'CVE-2026-0002' },
125
+ ],
126
+ },
127
+ });
128
+ MockGate.mockImplementation(() => ({ scan: mockScan }) as any);
129
+
130
+ await auditDetails({});
131
+
132
+ expect(consoleSpy).toHaveBeenCalledWith(expect.stringContaining('发现 2 个漏洞'));
133
+ expect(consoleSpy).toHaveBeenCalledWith(expect.stringContaining('pkg-a'));
134
+ });
135
+
136
+ it('should default severity to low for audit', async () => {
137
+ const mockScan = jest.fn().mockResolvedValue({ passed: true, message: 'ok', details: {} });
138
+ MockGate.mockImplementation(() => ({ scan: mockScan }) as any);
139
+
140
+ await auditDetails({});
141
+
142
+ expect(MockGate).toHaveBeenCalledWith(
143
+ expect.objectContaining({ severityThreshold: 'low' }),
144
+ );
145
+ });
146
+ });
147
+ });
package/src/cli/commands/__tests__/spec.test.ts ADDED
@@ -0,0 +1,193 @@
1
+ /**
2
+ * spec 命令测试
3
+ */
4
+
5
+ import { specValidate, listSpecTypes } from '../spec';
6
+ import { SpecValidator, validateAllSpecs } from '../../../core/spec/validator';
7
+ import type { BatchSpecValidationResult, SpecValidationResult } from '../../../types/spec';
8
+
9
+ // Mock SpecValidator
10
+ jest.mock('../../../core/spec/validator', () => ({
11
+ SpecValidator: {
12
+ getInstance: jest.fn(),
13
+ },
14
+ validateAllSpecs: jest.fn(),
15
+ }));
16
+
17
+ // Mock chalk
18
+ jest.mock('chalk', () => ({
19
+ blue: jest.fn((str: string) => str),
20
+ yellow: jest.fn((str: string) => str),
21
+ green: jest.fn((str: string) => str),
22
+ gray: jest.fn((str: string) => str),
23
+ red: jest.fn((str: string) => str),
24
+ bold: jest.fn((str: string) => str),
25
+ }));
26
+
27
+ const MockSpecValidator = SpecValidator as jest.Mocked<typeof SpecValidator>;
28
+ const mockValidateAllSpecs = validateAllSpecs as jest.MockedFunction<typeof validateAllSpecs>;
29
+
30
+ describe('spec command', () => {
31
+ let consoleSpy: jest.SpyInstance;
32
+ let mockValidator: {
33
+ setConfig: jest.Mock;
34
+ validateFile: jest.Mock;
35
+ };
36
+
37
+ beforeEach(() => {
38
+ jest.clearAllMocks();
39
+ consoleSpy = jest.spyOn(console, 'log').mockImplementation();
40
+ process.exitCode = 0;
41
+
42
+ mockValidator = {
43
+ setConfig: jest.fn(),
44
+ validateFile: jest.fn(),
45
+ };
46
+ (MockSpecValidator.getInstance as jest.Mock).mockReturnValue(mockValidator);
47
+ });
48
+
49
+ afterEach(() => {
50
+ consoleSpy.mockRestore();
51
+ process.exitCode = 0;
52
+ });
53
+
54
+ describe('specValidate', () => {
55
+ describe('单文件验证', () => {
56
+ it('应该验证单个文件', async () => {
57
+ const mockResult: SpecValidationResult = {
58
+ file: 'test.yml',
59
+ type: 'custom',
60
+ valid: true,
61
+ errors: [],
62
+ warnings: [],
63
+ };
64
+ mockValidator.validateFile.mockResolvedValue(mockResult);
65
+
66
+ await specValidate({ file: 'test.yml' });
67
+ expect(consoleSpy).toHaveBeenCalledWith(expect.stringContaining('验证通过'));
68
+ });
69
+
70
+ it('应该显示验证错误', async () => {
71
+ const mockResult: SpecValidationResult = {
72
+ file: 'test.yml',
73
+ type: 'custom',
74
+ valid: false,
75
+ errors: [{ path: 'name', message: 'required', severity: 'error' }],
76
+ warnings: [],
77
+ };
78
+ mockValidator.validateFile.mockResolvedValue(mockResult);
79
+
80
+ await specValidate({ file: 'test.yml' });
81
+ expect(consoleSpy).toHaveBeenCalledWith(expect.stringContaining('验证失败'));
82
+ expect(consoleSpy).toHaveBeenCalledWith(expect.stringContaining('错误'));
83
+ });
84
+
85
+ it('应该显示警告', async () => {
86
+ const mockResult: SpecValidationResult = {
87
+ file: 'test.yml',
88
+ type: 'custom',
89
+ valid: true,
90
+ errors: [],
91
+ warnings: [{ path: 'version', message: 'deprecated', severity: 'warning' }],
92
+ };
93
+ mockValidator.validateFile.mockResolvedValue(mockResult);
94
+
95
+ await specValidate({ file: 'test.yml' });
96
+ expect(consoleSpy).toHaveBeenCalledWith(expect.stringContaining('警告'));
97
+ });
98
+
99
+ it('应该显示详细指标', async () => {
100
+ const mockResult: SpecValidationResult = {
101
+ file: 'test.yml',
102
+ type: 'custom',
103
+ valid: true,
104
+ errors: [],
105
+ warnings: [],
106
+ metrics: { lines: 100, sections: 5 },
107
+ };
108
+ mockValidator.validateFile.mockResolvedValue(mockResult);
109
+
110
+ await specValidate({ file: 'test.yml', verbose: true });
111
+ expect(consoleSpy).toHaveBeenCalledWith(expect.stringContaining('指标'));
112
+ });
113
+ });
114
+
115
+ describe('批量验证', () => {
116
+ it('应该验证所有 Spec 文件', async () => {
117
+ const mockResult: BatchSpecValidationResult = {
118
+ total: 5,
119
+ passed: 5,
120
+ failed: 0,
121
+ warnings: 0,
122
+ results: [],
123
+ };
124
+ mockValidateAllSpecs.mockResolvedValue(mockResult);
125
+
126
+ await specValidate({});
127
+ expect(consoleSpy).toHaveBeenCalledWith(expect.stringContaining('所有 Spec 文件验证通过'));
128
+ });
129
+
130
+ it('应该显示失败统计', async () => {
131
+ const mockResult: BatchSpecValidationResult = {
132
+ total: 5,
133
+ passed: 3,
134
+ failed: 2,
135
+ warnings: 1,
136
+ results: [
137
+ { file: 'fail1.yml', type: 'custom', valid: false, errors: [{ path: 'x', message: 'err', severity: 'error' }], warnings: [] },
138
+ ],
139
+ };
140
+ mockValidateAllSpecs.mockResolvedValue(mockResult);
141
+
142
+ await specValidate({});
143
+ expect(consoleSpy).toHaveBeenCalledWith(expect.stringContaining('失败: 2'));
144
+ });
145
+
146
+ it('应该处理无 Spec 文件情况', async () => {
147
+ const mockResult: BatchSpecValidationResult = {
148
+ total: 0,
149
+ passed: 0,
150
+ failed: 0,
151
+ warnings: 0,
152
+ results: [],
153
+ };
154
+ mockValidateAllSpecs.mockResolvedValue(mockResult);
155
+
156
+ await specValidate({});
157
+ expect(consoleSpy).toHaveBeenCalledWith(expect.stringContaining('没有找到 Spec 文件'));
158
+ });
159
+
160
+ it('应该设置退出码当有失败', async () => {
161
+ const mockResult: BatchSpecValidationResult = {
162
+ total: 2,
163
+ passed: 1,
164
+ failed: 1,
165
+ warnings: 0,
166
+ results: [],
167
+ };
168
+ mockValidateAllSpecs.mockResolvedValue(mockResult);
169
+
170
+ await specValidate({});
171
+ expect(process.exitCode).toBe(1);
172
+ });
173
+ });
174
+
175
+ describe('Schema 配置', () => {
176
+ it('应该设置自定义 Schema 路径', async () => {
177
+ mockValidateAllSpecs.mockResolvedValue({
178
+ total: 0, passed: 0, failed: 0, warnings: 0, results: [],
179
+ });
180
+
181
+ await specValidate({ schema: 'custom-schema.ts' });
182
+ expect(mockValidator.setConfig).toHaveBeenCalled();
183
+ });
184
+ });
185
+ });
186
+
187
+ describe('listSpecTypes', () => {
188
+ it('应该列出支持的 Spec 类型', () => {
189
+ listSpecTypes();
190
+ expect(consoleSpy).toHaveBeenCalledWith(expect.stringContaining('支持的 Spec 类型'));
191
+ });
192
+ });
193
+ });