@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,256 @@
1
+ /**
2
+ * passes-gate 命令测试
3
+ */
4
+
5
+ import { runPassesGate, checkCoverage } from '../passes-gate';
6
+ import * as fs from 'fs/promises';
7
+ import { PassesGate } from '../../../core/validators/passes-gate';
8
+ import { execAsync } from '../../../utils/exec';
9
+
10
+ // Mock fs/promises
11
+ jest.mock('fs/promises', () => ({
12
+ readFile: jest.fn(),
13
+ access: jest.fn(),
14
+ }));
15
+
16
+ // Mock execAsync
17
+ jest.mock('../../../utils/exec', () => ({
18
+ execAsync: jest.fn(),
19
+ }));
20
+
21
+ // Mock PassesGate
22
+ jest.mock('../../../core/validators/passes-gate', () => ({
23
+ PassesGate: jest.fn(),
24
+ }));
25
+
26
+ // Mock chalk
27
+ jest.mock('chalk', () => ({
28
+ blue: jest.fn((str: string) => str),
29
+ yellow: jest.fn((str: string) => str),
30
+ green: jest.fn((str: string) => str),
31
+ gray: jest.fn((str: string) => str),
32
+ red: jest.fn((str: string) => str),
33
+ }));
34
+
35
+ const mockFs = fs as jest.Mocked<typeof fs>;
36
+ const MockPassesGate = PassesGate as jest.MockedClass<typeof PassesGate>;
37
+ const mockExecAsync = execAsync as jest.MockedFunction<typeof execAsync>;
38
+
39
+ describe('passes-gate command', () => {
40
+ let consoleSpy: jest.SpyInstance;
41
+
42
+ beforeEach(() => {
43
+ jest.clearAllMocks();
44
+ consoleSpy = jest.spyOn(console, 'log').mockImplementation();
45
+ process.exitCode = 0;
46
+ });
47
+
48
+ afterEach(() => {
49
+ consoleSpy.mockRestore();
50
+ process.exitCode = 0;
51
+ });
52
+
53
+ describe('runPassesGate', () => {
54
+ it('应该跳过无测试命令的情况', async () => {
55
+ mockFs.readFile.mockRejectedValue(new Error('no package.json'));
56
+ mockFs.access.mockRejectedValue(new Error('no file'));
57
+
58
+ await runPassesGate({});
59
+ expect(consoleSpy).toHaveBeenCalledWith(expect.stringContaining('未检测到测试命令'));
60
+ });
61
+
62
+ it('应该通过测试门控', async () => {
63
+ mockFs.readFile.mockResolvedValue(JSON.stringify({
64
+ scripts: { test: 'jest' },
65
+ }));
66
+
67
+ const mockRunTests = jest.fn().mockResolvedValue({
68
+ passed: true,
69
+ passedTests: 10,
70
+ failedTests: 0,
71
+ totalTests: 10,
72
+ duration: 1000,
73
+ failures: [],
74
+ });
75
+ (MockPassesGate as any).mockImplementation(() => ({
76
+ runTests: mockRunTests,
77
+ }));
78
+
79
+ await runPassesGate({});
80
+ expect(consoleSpy).toHaveBeenCalledWith(expect.stringContaining('测试门控通过'));
81
+ });
82
+
83
+ it('应该失败测试门控', async () => {
84
+ mockFs.readFile.mockResolvedValue(JSON.stringify({
85
+ scripts: { test: 'jest' },
86
+ }));
87
+
88
+ const mockRunTests = jest.fn().mockResolvedValue({
89
+ passed: false,
90
+ passedTests: 8,
91
+ failedTests: 2,
92
+ totalTests: 10,
93
+ duration: 1000,
94
+ failures: [{ name: 'test1', message: 'failed' }],
95
+ });
96
+ (MockPassesGate as any).mockImplementation(() => ({
97
+ runTests: mockRunTests,
98
+ }));
99
+
100
+ // Mock process.exit
101
+ const mockExit = jest.spyOn(process, 'exit').mockImplementation(() => undefined as never);
102
+
103
+ await runPassesGate({});
104
+ expect(mockExit).toHaveBeenCalledWith(1);
105
+ mockExit.mockRestore();
106
+ });
107
+
108
+ it('应该处理测试执行错误', async () => {
109
+ mockFs.readFile.mockResolvedValue(JSON.stringify({
110
+ scripts: { test: 'jest' },
111
+ }));
112
+
113
+ const mockRunTests = jest.fn().mockRejectedValue(new Error('test failed'));
114
+ (MockPassesGate as any).mockImplementation(() => ({
115
+ runTests: mockRunTests,
116
+ }));
117
+
118
+ const mockExit = jest.spyOn(process, 'exit').mockImplementation(() => undefined as never);
119
+
120
+ await runPassesGate({});
121
+ expect(mockExit).toHaveBeenCalledWith(1);
122
+ mockExit.mockRestore();
123
+ });
124
+
125
+ it('应该使用自定义测试命令', async () => {
126
+ const mockRunTests = jest.fn().mockResolvedValue({
127
+ passed: true,
128
+ passedTests: 5,
129
+ failedTests: 0,
130
+ totalTests: 5,
131
+ duration: 500,
132
+ failures: [],
133
+ });
134
+ (MockPassesGate as any).mockImplementation(() => ({
135
+ runTests: mockRunTests,
136
+ }));
137
+
138
+ await runPassesGate({ testCommand: 'pytest' });
139
+ expect(MockPassesGate).toHaveBeenCalledWith(
140
+ expect.objectContaining({ testCommand: 'pytest' })
141
+ );
142
+ });
143
+ });
144
+
145
+ describe('checkCoverage', () => {
146
+ it('应该返回 true 当覆盖率达标', async () => {
147
+ mockExecAsync.mockResolvedValue({ stdout: '', stderr: '' });
148
+ mockFs.readFile.mockResolvedValue(JSON.stringify({
149
+ total: { lines: { pct: 85 } },
150
+ }));
151
+
152
+ const result = await checkCoverage('/project', 80);
153
+ expect(result).toBe(true);
154
+ expect(consoleSpy).toHaveBeenCalledWith(expect.stringContaining('覆盖率达标'));
155
+ });
156
+
157
+ it('应该返回 false 当覆盖率不足', async () => {
158
+ mockExecAsync.mockResolvedValue({ stdout: '', stderr: '' });
159
+ mockFs.readFile.mockResolvedValue(JSON.stringify({
160
+ total: { lines: { pct: 60 } },
161
+ }));
162
+
163
+ const result = await checkCoverage('/project', 80);
164
+ expect(result).toBe(false);
165
+ expect(consoleSpy).toHaveBeenCalledWith(expect.stringContaining('覆盖率不足'));
166
+ });
167
+
168
+ it('应该返回 true 当执行出错时', async () => {
169
+ mockExecAsync.mockRejectedValue(new Error('command failed'));
170
+
171
+ const result = await checkCoverage('/project');
172
+ expect(result).toBe(true);
173
+ expect(consoleSpy).toHaveBeenCalledWith(expect.stringContaining('无法获取覆盖率信息'));
174
+ });
175
+
176
+ it('应该使用默认阈值 80', async () => {
177
+ mockExecAsync.mockResolvedValue({ stdout: '', stderr: '' });
178
+ mockFs.readFile.mockResolvedValue(JSON.stringify({
179
+ total: { lines: { pct: 80 } },
180
+ }));
181
+
182
+ const result = await checkCoverage('/project');
183
+ expect(result).toBe(true);
184
+ });
185
+
186
+ it('应该处理 coverage.total 为 undefined', async () => {
187
+ mockExecAsync.mockResolvedValue({ stdout: '', stderr: '' });
188
+ mockFs.readFile.mockResolvedValue(JSON.stringify({}));
189
+
190
+ const result = await checkCoverage('/project', 80);
191
+ expect(result).toBe(false);
192
+ });
193
+ });
194
+
195
+ describe('detectTestCommand', () => {
196
+ it('应该检测 pytest 项目', async () => {
197
+ // package.json 不存在
198
+ mockFs.readFile.mockRejectedValue(new Error('no file'));
199
+ // pytest.ini 存在
200
+ mockFs.access
201
+ .mockResolvedValueOnce(undefined) // pytest.ini
202
+ .mockRejectedValueOnce(new Error('no file')); // go.mod
203
+
204
+ const mockRunTests = jest.fn().mockResolvedValue({
205
+ passed: true, passedTests: 5, failedTests: 0, totalTests: 5, duration: 500, failures: [],
206
+ });
207
+ (MockPassesGate as any).mockImplementation(() => ({ runTests: mockRunTests }));
208
+
209
+ await runPassesGate({});
210
+ expect(MockPassesGate).toHaveBeenCalledWith(expect.objectContaining({ testCommand: 'pytest' }));
211
+ });
212
+
213
+ it('应该检测 Go 项目', async () => {
214
+ mockFs.readFile.mockRejectedValue(new Error('no file'));
215
+ // Reset access mock to avoid leaking from previous tests
216
+ mockFs.access.mockReset();
217
+ mockFs.access
218
+ .mockRejectedValueOnce(new Error('no file')) // pytest.ini
219
+ .mockResolvedValueOnce(undefined); // go.mod
220
+
221
+ const mockRunTests = jest.fn().mockResolvedValue({
222
+ passed: true, passedTests: 5, failedTests: 0, totalTests: 5, duration: 500, failures: [],
223
+ });
224
+ (MockPassesGate as any).mockImplementation(() => ({ runTests: mockRunTests }));
225
+
226
+ await runPassesGate({});
227
+ expect(MockPassesGate).toHaveBeenCalledWith(expect.objectContaining({ testCommand: 'go test ./...' }));
228
+ });
229
+
230
+ it('应该检测 test:ci 脚本', async () => {
231
+ mockFs.readFile.mockResolvedValue(JSON.stringify({
232
+ scripts: { 'test:ci': 'jest --ci' },
233
+ }));
234
+
235
+ const mockRunTests = jest.fn().mockResolvedValue({
236
+ passed: true, passedTests: 5, failedTests: 0, totalTests: 5, duration: 500, failures: [],
237
+ });
238
+ (MockPassesGate as any).mockImplementation(() => ({ runTests: mockRunTests }));
239
+
240
+ await runPassesGate({});
241
+ expect(MockPassesGate).toHaveBeenCalledWith(expect.objectContaining({ testCommand: 'npm run test:ci' }));
242
+ });
243
+
244
+ it('应该跳过默认 echo 测试脚本', async () => {
245
+ mockFs.readFile.mockReset();
246
+ mockFs.readFile.mockResolvedValue(JSON.stringify({
247
+ scripts: { test: 'echo "Error: no test specified"' },
248
+ }));
249
+ mockFs.access.mockReset();
250
+ mockFs.access.mockRejectedValue(new Error('no file'));
251
+
252
+ await runPassesGate({});
253
+ expect(consoleSpy).toHaveBeenCalledWith(expect.stringContaining('未检测到测试命令'));
254
+ });
255
+ });
256
+ });
@@ -0,0 +1,116 @@
1
+ /**
2
+ * performance 命令测试
3
+ */
4
+
5
+ import { performance } from '../performance';
6
+ import { PerformanceGate } from '../../../gates/performance';
7
+
8
+ jest.mock('../../../gates/performance', () => ({
9
+ PerformanceGate: jest.fn().mockImplementation(() => ({
10
+ check: 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: jest.fn((s: string) => s),
18
+ gray: jest.fn((s: string) => s),
19
+ }));
20
+
21
+ const MockGate = PerformanceGate as jest.MockedClass<typeof PerformanceGate>;
22
+
23
+ describe('performance command', () => {
24
+ let consoleSpy: jest.SpyInstance;
25
+ let exitSpy: jest.SpyInstance;
26
+
27
+ beforeEach(() => {
28
+ jest.clearAllMocks();
29
+ consoleSpy = jest.spyOn(console, 'log').mockImplementation();
30
+ exitSpy = jest.spyOn(process, 'exit').mockImplementation(() => undefined as never);
31
+ process.exitCode = 0;
32
+ });
33
+
34
+ afterEach(() => {
35
+ consoleSpy.mockRestore();
36
+ exitSpy.mockRestore();
37
+ process.exitCode = 0;
38
+ });
39
+
40
+ it('should print success when check passes', async () => {
41
+ const mockCheck = jest.fn().mockResolvedValue({
42
+ passed: true,
43
+ message: 'ok',
44
+ details: {
45
+ metrics: { coverage: 85.5, bundleSize: 204800, benchmarkTime: 150 },
46
+ },
47
+ });
48
+ MockGate.mockImplementation(() => ({ check: mockCheck }) as any);
49
+
50
+ await performance({});
51
+
52
+ expect(consoleSpy).toHaveBeenCalledWith(expect.stringContaining('性能门控检查通过'));
53
+ expect(exitSpy).not.toHaveBeenCalled();
54
+ });
55
+
56
+ it('should print failure and exit 1 when check fails', async () => {
57
+ const mockCheck = jest.fn().mockResolvedValue({
58
+ passed: false,
59
+ message: 'threshold exceeded',
60
+ details: { failures: ['coverage below 80%', 'bundle too large'] },
61
+ });
62
+ MockGate.mockImplementation(() => ({ check: mockCheck }) as any);
63
+
64
+ await performance({});
65
+
66
+ expect(consoleSpy).toHaveBeenCalledWith(expect.stringContaining('性能门控检查失败'));
67
+ expect(exitSpy).toHaveBeenCalledWith(1);
68
+ });
69
+
70
+ it('should handle errors and exit 1', async () => {
71
+ const mockCheck = jest.fn().mockRejectedValue(new Error('gate error'));
72
+ MockGate.mockImplementation(() => ({ check: mockCheck }) as any);
73
+
74
+ await performance({});
75
+
76
+ expect(consoleSpy).toHaveBeenCalledWith(expect.stringContaining('性能门控检查出错'));
77
+ expect(exitSpy).toHaveBeenCalledWith(1);
78
+ });
79
+
80
+ it('should convert bundleThreshold from KB to bytes', async () => {
81
+ const mockCheck = jest.fn().mockResolvedValue({ passed: true, message: 'ok' });
82
+ MockGate.mockImplementation(() => ({ check: mockCheck }) as any);
83
+
84
+ await performance({ bundleThreshold: 500 });
85
+
86
+ expect(MockGate).toHaveBeenCalledWith(
87
+ expect.objectContaining({
88
+ thresholds: expect.objectContaining({ bundleSize: 500 * 1024 }),
89
+ }),
90
+ );
91
+ });
92
+
93
+ it('should convert benchmarkTimeout from seconds to ms', async () => {
94
+ const mockCheck = jest.fn().mockResolvedValue({ passed: true, message: 'ok' });
95
+ MockGate.mockImplementation(() => ({ check: mockCheck }) as any);
96
+
97
+ await performance({ benchmarkTimeout: 30 });
98
+
99
+ expect(MockGate).toHaveBeenCalledWith(
100
+ expect.objectContaining({ benchmarkTimeout: 30000 }),
101
+ );
102
+ });
103
+
104
+ it('should set coverage threshold when both flags provided', async () => {
105
+ const mockCheck = jest.fn().mockResolvedValue({ passed: true, message: 'ok' });
106
+ MockGate.mockImplementation(() => ({ check: mockCheck }) as any);
107
+
108
+ await performance({ coverage: true, coverageThreshold: 90 });
109
+
110
+ expect(MockGate).toHaveBeenCalledWith(
111
+ expect.objectContaining({
112
+ thresholds: expect.objectContaining({ coverage: 90 }),
113
+ }),
114
+ );
115
+ });
116
+ });
@@ -0,0 +1,201 @@
1
+ /**
2
+ * posteval-plan 命令测试
3
+ */
4
+
5
+ import * as fs from 'fs';
6
+ import * as path from 'path';
7
+
8
+ describe('postevalPlan', () => {
9
+ jest.setTimeout(30000); // Retry-based tests with exponential backoff need longer timeout
10
+ const tempDir = path.join(process.cwd(), 'temp-test-posteval');
11
+ const planPath = path.join(tempDir, 'plan.md');
12
+ let consoleErrorSpy: jest.SpyInstance;
13
+ let consoleLogSpy: jest.SpyInstance;
14
+ let mockExit: jest.SpyInstance;
15
+ let originalFetch: typeof fetch;
16
+ let originalEnv: NodeJS.ProcessEnv;
17
+
18
+ beforeAll(() => {
19
+ fs.mkdirSync(tempDir, { recursive: true });
20
+ fs.writeFileSync(planPath, '# Test plan\n- [AC-001] Task 1\n- [AC-002] Task 2');
21
+ });
22
+
23
+ afterAll(() => {
24
+ try {
25
+ fs.rmSync(tempDir, { recursive: true, force: true });
26
+ } catch {
27
+ // ignore
28
+ }
29
+ });
30
+
31
+ beforeEach(() => {
32
+ jest.clearAllMocks();
33
+ originalFetch = global.fetch;
34
+ originalEnv = { ...process.env };
35
+ delete process.env.API_PORT;
36
+ delete process.env.POSTEVAL_GRACE_MS;
37
+ consoleErrorSpy = jest.spyOn(console, 'error').mockImplementation();
38
+ consoleLogSpy = jest.spyOn(console, 'log').mockImplementation();
39
+ mockExit = jest.spyOn(process, 'exit').mockImplementation((() => {
40
+ // Don't actually exit
41
+ }) as any);
42
+ });
43
+
44
+ afterEach(() => {
45
+ global.fetch = originalFetch;
46
+ process.env = originalEnv;
47
+ consoleErrorSpy.mockRestore();
48
+ consoleLogSpy.mockRestore();
49
+ mockExit.mockRestore();
50
+ jest.useRealTimers();
51
+ });
52
+
53
+ it('应该成功验证 plan 覆盖率并打印绿色信息', async () => {
54
+ global.fetch = jest.fn().mockResolvedValue({
55
+ ok: true,
56
+ json: () => Promise.resolve({
57
+ completeness: 1,
58
+ matchedAcs: ['AC-001', 'AC-002'],
59
+ missedAcs: [],
60
+ }),
61
+ }) as any;
62
+
63
+ const { postevalPlan } = await import('../posteval-plan');
64
+ await postevalPlan({ planPath });
65
+
66
+ expect(consoleLogSpy).toHaveBeenCalledWith(expect.stringContaining('100%'));
67
+ });
68
+
69
+ it('completeness < 1 应该 exit(1)', async () => {
70
+ global.fetch = jest.fn().mockResolvedValue({
71
+ ok: true,
72
+ json: () => Promise.resolve({
73
+ completeness: 0.5,
74
+ matchedAcs: ['AC-001'],
75
+ missedAcs: ['AC-002'],
76
+ }),
77
+ }) as any;
78
+
79
+ const { postevalPlan } = await import('../posteval-plan');
80
+ await postevalPlan({ planPath });
81
+
82
+ expect(mockExit).toHaveBeenCalledWith(1);
83
+ expect(consoleErrorSpy).toHaveBeenCalledWith(expect.stringContaining('50%'));
84
+ });
85
+
86
+ it('completeness < 1 时应该列出缺失项', async () => {
87
+ global.fetch = jest.fn().mockResolvedValue({
88
+ ok: true,
89
+ json: () => Promise.resolve({
90
+ completeness: 0.33,
91
+ matchedAcs: ['AC-001'],
92
+ missedAcs: ['AC-002', 'AC-003'],
93
+ }),
94
+ }) as any;
95
+
96
+ const { postevalPlan } = await import('../posteval-plan');
97
+ await postevalPlan({ planPath });
98
+
99
+ expect(mockExit).toHaveBeenCalledWith(1);
100
+ expect(consoleErrorSpy).toHaveBeenCalledWith(expect.stringContaining('AC-002'));
101
+ });
102
+
103
+ it('4xx 错误应该 exit(1)', async () => {
104
+ global.fetch = jest.fn().mockResolvedValue({
105
+ ok: false,
106
+ status: 400,
107
+ statusText: 'Bad Request',
108
+ }) as any;
109
+
110
+ const { postevalPlan } = await import('../posteval-plan');
111
+ await postevalPlan({ planPath });
112
+
113
+ expect(mockExit).toHaveBeenCalledWith(1);
114
+ expect(consoleErrorSpy).toHaveBeenCalledWith(expect.stringContaining('400'));
115
+ });
116
+
117
+ it('5xx 错误应该 exit(0) 允许提交', async () => {
118
+ global.fetch = jest.fn().mockResolvedValue({
119
+ ok: false,
120
+ status: 503,
121
+ statusText: 'Service Unavailable',
122
+ }) as any;
123
+
124
+ const { postevalPlan } = await import('../posteval-plan');
125
+ await postevalPlan({ planPath });
126
+
127
+ expect(mockExit).toHaveBeenCalledWith(0);
128
+ expect(consoleErrorSpy).toHaveBeenCalledWith(expect.stringContaining('unavailable'));
129
+ });
130
+
131
+ it('网络错误重试耗尽后应该 exit(0)', async () => {
132
+ global.fetch = jest.fn().mockRejectedValue(new Error('ECONNREFUSED'));
133
+
134
+ const { postevalPlan } = await import('../posteval-plan');
135
+ await postevalPlan({ planPath });
136
+
137
+ expect(mockExit).toHaveBeenCalledWith(0);
138
+ expect(consoleErrorSpy).toHaveBeenCalledWith(expect.stringContaining('unreachable'));
139
+ });
140
+
141
+ it('应该支持自定义 API_PORT', async () => {
142
+ process.env.API_PORT = '3999';
143
+ global.fetch = jest.fn().mockResolvedValue({
144
+ ok: true,
145
+ json: () => Promise.resolve({
146
+ completeness: 1,
147
+ matchedAcs: ['AC-001'],
148
+ missedAcs: [],
149
+ }),
150
+ }) as any;
151
+
152
+ const { postevalPlan } = await import('../posteval-plan');
153
+ await postevalPlan({ planPath });
154
+
155
+ // Verify the fetch was called with port 3999
156
+ const fetchCall = (global.fetch as jest.Mock).mock.calls[0][0];
157
+ expect(fetchCall).toContain(':3999');
158
+ });
159
+
160
+ it('网络错误重试后成功应该不退出', async () => {
161
+ // First 2 calls fail, 3rd succeeds
162
+ const mockFetch = jest.fn()
163
+ .mockRejectedValueOnce(new Error('ECONNREFUSED'))
164
+ .mockRejectedValueOnce(new Error('ECONNREFUSED'))
165
+ .mockResolvedValueOnce({
166
+ ok: true,
167
+ json: () => Promise.resolve({
168
+ completeness: 1,
169
+ matchedAcs: ['AC-001'],
170
+ missedAcs: [],
171
+ }),
172
+ });
173
+
174
+ global.fetch = mockFetch as any;
175
+
176
+ const { postevalPlan } = await import('../posteval-plan');
177
+ await postevalPlan({ planPath });
178
+
179
+ // Should have been called 3 times
180
+ expect(mockFetch).toHaveBeenCalledTimes(3);
181
+ expect(consoleLogSpy).toHaveBeenCalledWith(expect.stringContaining('100%'));
182
+ expect(mockExit).not.toHaveBeenCalled();
183
+ });
184
+
185
+ it('completeness 为 0 时应该正确显示 0%', async () => {
186
+ global.fetch = jest.fn().mockResolvedValue({
187
+ ok: true,
188
+ json: () => Promise.resolve({
189
+ completeness: 0,
190
+ matchedAcs: [],
191
+ missedAcs: ['AC-001'],
192
+ }),
193
+ }) as any;
194
+
195
+ const { postevalPlan } = await import('../posteval-plan');
196
+ await postevalPlan({ planPath });
197
+
198
+ expect(mockExit).toHaveBeenCalledWith(1);
199
+ expect(consoleErrorSpy).toHaveBeenCalledWith(expect.stringContaining('0%'));
200
+ });
201
+ });
@@ -0,0 +1,98 @@
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('format 边界情况', () => {
35
+ it('未知格式应该默认输出 JSON', async () => {
36
+ await report({ format: 'json' });
37
+ const output = consoleSpy.mock.calls.map(c => c[0]).join('\n');
38
+ expect(output).toContain('timestamp');
39
+ });
40
+ });
41
+
42
+ describe('Markdown 报告完整内容', () => {
43
+ it('Markdown 报告应该包含所有区块', async () => {
44
+ await report({ format: 'markdown' });
45
+ const output = consoleSpy.mock.calls.map(c => c[0]).join('\n');
46
+
47
+ expect(output).toContain('# Harness 检查报告');
48
+ expect(output).toContain('## 约束检查');
49
+ expect(output).toContain('Iron Laws');
50
+ expect(output).toContain('Guidelines');
51
+ expect(output).toContain('@dommaker/harness');
52
+ });
53
+ });
54
+
55
+ describe('HTML 报告完整内容', () => {
56
+ it('HTML 报告应该包含所有区块', async () => {
57
+ await report({ format: 'html' });
58
+ const output = consoleSpy.mock.calls.map(c => c[0]).join('\n');
59
+
60
+ expect(output).toContain('<!DOCTYPE html>');
61
+ expect(output).toContain('<title>Harness 检查报告</title>');
62
+ expect(output).toContain('约束检查');
63
+ expect(output).toContain('Iron Laws');
64
+ });
65
+ });
66
+
67
+ describe('文件输出', () => {
68
+ it('Markdown 输出到文件', async () => {
69
+ mockFs.writeFile.mockResolvedValue(undefined);
70
+
71
+ await report({ format: 'markdown', output: 'report.md' });
72
+ expect(mockFs.writeFile).toHaveBeenCalledWith('report.md', expect.stringContaining('# Harness'), 'utf-8');
73
+ });
74
+
75
+ it('HTML 输出到文件', async () => {
76
+ mockFs.writeFile.mockResolvedValue(undefined);
77
+
78
+ await report({ format: 'html', output: 'report.html' });
79
+ expect(mockFs.writeFile).toHaveBeenCalledWith('report.html', expect.stringContaining('<!DOCTYPE html>'), 'utf-8');
80
+ });
81
+ });
82
+
83
+ describe('JSON 报告内容', () => {
84
+ it('JSON 应该包含完整数据结构', async () => {
85
+ await report({ format: 'json' });
86
+ const output = consoleSpy.mock.calls.map(c => c[0]).join('\n');
87
+ const jsonStart = output.indexOf('{');
88
+ const jsonStr = output.slice(jsonStart);
89
+ const data = JSON.parse(jsonStr);
90
+ expect(data).toHaveProperty('timestamp');
91
+ expect(data).toHaveProperty('constraints');
92
+ expect(data.constraints).toHaveProperty('total');
93
+ expect(data.constraints).toHaveProperty('ironLaws');
94
+ expect(data.constraints).toHaveProperty('guidelines');
95
+ expect(data.constraints).toHaveProperty('violations');
96
+ });
97
+ });
98
+ });