@dommaker/harness 1.7.0 → 1.8.1

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 (563) hide show
  1. package/CHANGELOG.md +44 -0
  2. package/bin/harness.js +17 -1
  3. package/dist/agents/index.d.ts +6 -2
  4. package/dist/agents/index.d.ts.map +1 -1
  5. package/dist/agents/index.js +6 -16
  6. package/dist/agents/index.js.map +1 -1
  7. package/dist/cli/commands/__tests__/gate-decision.d.ts +18 -0
  8. package/dist/cli/commands/__tests__/gate-decision.d.ts.map +1 -0
  9. package/dist/cli/commands/__tests__/gate-decision.js +26 -0
  10. package/dist/cli/commands/__tests__/gate-decision.js.map +1 -0
  11. package/dist/cli/commands/acceptance.d.ts.map +1 -1
  12. package/dist/cli/commands/acceptance.js +17 -28
  13. package/dist/cli/commands/acceptance.js.map +1 -1
  14. package/dist/cli/commands/check.d.ts +19 -3
  15. package/dist/cli/commands/check.d.ts.map +1 -1
  16. package/dist/cli/commands/check.js +36 -22
  17. package/dist/cli/commands/check.js.map +1 -1
  18. package/dist/cli/commands/command.d.ts +0 -1
  19. package/dist/cli/commands/command.d.ts.map +1 -1
  20. package/dist/cli/commands/command.js +8 -6
  21. package/dist/cli/commands/command.js.map +1 -1
  22. package/dist/cli/commands/constraints-retire.d.ts.map +1 -1
  23. package/dist/cli/commands/constraints-retire.js +36 -57
  24. package/dist/cli/commands/constraints-retire.js.map +1 -1
  25. package/dist/cli/commands/contract.d.ts.map +1 -1
  26. package/dist/cli/commands/contract.js +36 -42
  27. package/dist/cli/commands/contract.js.map +1 -1
  28. package/dist/cli/commands/definitions.d.ts +2 -0
  29. package/dist/cli/commands/definitions.d.ts.map +1 -1
  30. package/dist/cli/commands/definitions.js +11 -6
  31. package/dist/cli/commands/definitions.js.map +1 -1
  32. package/dist/cli/commands/failure.d.ts.map +1 -1
  33. package/dist/cli/commands/failure.js +16 -2
  34. package/dist/cli/commands/failure.js.map +1 -1
  35. package/dist/cli/commands/init.d.ts +14 -8
  36. package/dist/cli/commands/init.d.ts.map +1 -1
  37. package/dist/cli/commands/init.js +172 -364
  38. package/dist/cli/commands/init.js.map +1 -1
  39. package/dist/cli/commands/knowledge-view.d.ts +90 -0
  40. package/dist/cli/commands/knowledge-view.d.ts.map +1 -0
  41. package/dist/cli/commands/knowledge-view.js +198 -0
  42. package/dist/cli/commands/knowledge-view.js.map +1 -0
  43. package/dist/cli/commands/knowledge.d.ts +137 -52
  44. package/dist/cli/commands/knowledge.d.ts.map +1 -1
  45. package/dist/cli/commands/knowledge.js +534 -400
  46. package/dist/cli/commands/knowledge.js.map +1 -1
  47. package/dist/cli/commands/passes-gate.d.ts +4 -1
  48. package/dist/cli/commands/passes-gate.d.ts.map +1 -1
  49. package/dist/cli/commands/passes-gate.js +11 -2
  50. package/dist/cli/commands/passes-gate.js.map +1 -1
  51. package/dist/cli/commands/performance.d.ts.map +1 -1
  52. package/dist/cli/commands/performance.js +19 -31
  53. package/dist/cli/commands/performance.js.map +1 -1
  54. package/dist/cli/commands/report.d.ts.map +1 -1
  55. package/dist/cli/commands/report.js +2 -1
  56. package/dist/cli/commands/report.js.map +1 -1
  57. package/dist/cli/commands/review.d.ts.map +1 -1
  58. package/dist/cli/commands/review.js +13 -25
  59. package/dist/cli/commands/review.js.map +1 -1
  60. package/dist/cli/commands/scaffold-templates.d.ts +73 -0
  61. package/dist/cli/commands/scaffold-templates.d.ts.map +1 -0
  62. package/dist/cli/commands/scaffold-templates.js +424 -0
  63. package/dist/cli/commands/scaffold-templates.js.map +1 -0
  64. package/dist/cli/commands/scaffold.d.ts +105 -0
  65. package/dist/cli/commands/scaffold.d.ts.map +1 -0
  66. package/dist/cli/commands/scaffold.js +263 -0
  67. package/dist/cli/commands/scaffold.js.map +1 -0
  68. package/dist/cli/commands/security.d.ts.map +1 -1
  69. package/dist/cli/commands/security.js +22 -24
  70. package/dist/cli/commands/security.js.map +1 -1
  71. package/dist/cli/commands/spec-baseline-check.d.ts +43 -0
  72. package/dist/cli/commands/spec-baseline-check.d.ts.map +1 -1
  73. package/dist/cli/commands/spec-baseline-check.js +109 -34
  74. package/dist/cli/commands/spec-baseline-check.js.map +1 -1
  75. package/dist/cli/commands/status.d.ts +8 -0
  76. package/dist/cli/commands/status.d.ts.map +1 -1
  77. package/dist/cli/commands/status.js +5 -7
  78. package/dist/cli/commands/status.js.map +1 -1
  79. package/dist/cli/commands/sync-docs/context-syncer.d.ts +21 -2
  80. package/dist/cli/commands/sync-docs/context-syncer.d.ts.map +1 -1
  81. package/dist/cli/commands/sync-docs/context-syncer.js +112 -28
  82. package/dist/cli/commands/sync-docs/context-syncer.js.map +1 -1
  83. package/dist/cli/commands/sync-docs/index.d.ts +1 -1
  84. package/dist/cli/commands/sync-docs/index.d.ts.map +1 -1
  85. package/dist/cli/commands/sync-docs/index.js +86 -27
  86. package/dist/cli/commands/sync-docs/index.js.map +1 -1
  87. package/dist/cli/commands/sync-docs/project-reader.d.ts +24 -1
  88. package/dist/cli/commands/sync-docs/project-reader.d.ts.map +1 -1
  89. package/dist/cli/commands/sync-docs/project-reader.js +33 -7
  90. package/dist/cli/commands/sync-docs/project-reader.js.map +1 -1
  91. package/dist/cli/commands/validate.d.ts +0 -16
  92. package/dist/cli/commands/validate.d.ts.map +1 -1
  93. package/dist/cli/commands/validate.js +2 -97
  94. package/dist/cli/commands/validate.js.map +1 -1
  95. package/dist/cli/gate-command.d.ts +37 -0
  96. package/dist/cli/gate-command.d.ts.map +1 -0
  97. package/dist/cli/gate-command.js +64 -0
  98. package/dist/cli/gate-command.js.map +1 -0
  99. package/dist/cli/state-io.d.ts +34 -0
  100. package/dist/cli/state-io.d.ts.map +1 -0
  101. package/dist/cli/state-io.js +71 -0
  102. package/dist/cli/state-io.js.map +1 -0
  103. package/dist/completion-checkers/index.d.ts +1 -1
  104. package/dist/completion-checkers/index.d.ts.map +1 -1
  105. package/dist/completion-checkers/index.js +0 -15
  106. package/dist/completion-checkers/index.js.map +1 -1
  107. package/dist/context/knowledge-injector.d.ts +4 -2
  108. package/dist/context/knowledge-injector.d.ts.map +1 -1
  109. package/dist/context/knowledge-injector.js +13 -6
  110. package/dist/context/knowledge-injector.js.map +1 -1
  111. package/dist/core/constraints/agent-prompt-renderer.js +2 -2
  112. package/dist/core/constraints/agent-prompt-renderer.js.map +1 -1
  113. package/dist/core/constraints/capabilities-reconcile.d.ts +20 -0
  114. package/dist/core/constraints/capabilities-reconcile.d.ts.map +1 -1
  115. package/dist/core/constraints/capabilities-reconcile.js +26 -4
  116. package/dist/core/constraints/capabilities-reconcile.js.map +1 -1
  117. package/dist/core/constraints/check-cache.d.ts +1 -1
  118. package/dist/core/constraints/check-cache.js +1 -1
  119. package/dist/core/constraints/checker.d.ts +8 -3
  120. package/dist/core/constraints/checker.d.ts.map +1 -1
  121. package/dist/core/constraints/checker.js +30 -19
  122. package/dist/core/constraints/checker.js.map +1 -1
  123. package/dist/core/constraints/checkers/capability-sync.d.ts +3 -1
  124. package/dist/core/constraints/checkers/capability-sync.d.ts.map +1 -1
  125. package/dist/core/constraints/checkers/capability-sync.js +17 -24
  126. package/dist/core/constraints/checkers/capability-sync.js.map +1 -1
  127. package/dist/core/constraints/checkers/context-doc-sync.d.ts +1 -1
  128. package/dist/core/constraints/checkers/context-doc-sync.d.ts.map +1 -1
  129. package/dist/core/constraints/checkers/context-doc-sync.js +9 -6
  130. package/dist/core/constraints/checkers/context-doc-sync.js.map +1 -1
  131. package/dist/core/constraints/checkers/docs-freshness.d.ts.map +1 -1
  132. package/dist/core/constraints/checkers/docs-freshness.js +24 -30
  133. package/dist/core/constraints/checkers/docs-freshness.js.map +1 -1
  134. package/dist/core/constraints/checkers/governance-presence.d.ts.map +1 -1
  135. package/dist/core/constraints/checkers/governance-presence.js +10 -4
  136. package/dist/core/constraints/checkers/governance-presence.js.map +1 -1
  137. package/dist/core/constraints/checkers/types.d.ts +10 -6
  138. package/dist/core/constraints/checkers/types.d.ts.map +1 -1
  139. package/dist/core/constraints/checkers/types.js +7 -3
  140. package/dist/core/constraints/checkers/types.js.map +1 -1
  141. package/dist/core/constraints/context-builder.d.ts +11 -10
  142. package/dist/core/constraints/context-builder.d.ts.map +1 -1
  143. package/dist/core/constraints/context-builder.js +31 -27
  144. package/dist/core/constraints/context-builder.js.map +1 -1
  145. package/dist/core/constraints/context-reconcile.d.ts +75 -0
  146. package/dist/core/constraints/context-reconcile.d.ts.map +1 -0
  147. package/dist/core/constraints/context-reconcile.js +161 -0
  148. package/dist/core/constraints/context-reconcile.js.map +1 -0
  149. package/dist/core/constraints/doc-freshness/runner.d.ts +7 -0
  150. package/dist/core/constraints/doc-freshness/runner.d.ts.map +1 -1
  151. package/dist/core/constraints/doc-freshness/runner.js +8 -3
  152. package/dist/core/constraints/doc-freshness/runner.js.map +1 -1
  153. package/dist/core/constraints/git-evidence.js +1 -1
  154. package/dist/core/constraints/git-evidence.js.map +1 -1
  155. package/dist/core/constraints/injection-drift.d.ts +7 -2
  156. package/dist/core/constraints/injection-drift.d.ts.map +1 -1
  157. package/dist/core/constraints/injection-drift.js +13 -7
  158. package/dist/core/constraints/injection-drift.js.map +1 -1
  159. package/dist/core/constraints/run-env.d.ts +92 -0
  160. package/dist/core/constraints/run-env.d.ts.map +1 -0
  161. package/dist/core/constraints/run-env.js +175 -0
  162. package/dist/core/constraints/run-env.js.map +1 -0
  163. package/dist/core/constraints/triggers.d.ts +22 -0
  164. package/dist/core/constraints/triggers.d.ts.map +1 -0
  165. package/dist/core/constraints/triggers.js +31 -0
  166. package/dist/core/constraints/triggers.js.map +1 -0
  167. package/dist/core/effective-constraints.d.ts +13 -4
  168. package/dist/core/effective-constraints.d.ts.map +1 -1
  169. package/dist/core/effective-constraints.js +16 -6
  170. package/dist/core/effective-constraints.js.map +1 -1
  171. package/dist/core/effective-set.d.ts +8 -15
  172. package/dist/core/effective-set.d.ts.map +1 -1
  173. package/dist/core/effective-set.js +7 -12
  174. package/dist/core/effective-set.js.map +1 -1
  175. package/dist/core/index.d.ts +1 -0
  176. package/dist/core/index.d.ts.map +1 -1
  177. package/dist/core/index.js.map +1 -1
  178. package/dist/core/project-config-loader.d.ts +39 -17
  179. package/dist/core/project-config-loader.d.ts.map +1 -1
  180. package/dist/core/project-config-loader.js +51 -122
  181. package/dist/core/project-config-loader.js.map +1 -1
  182. package/dist/core/validators/check-handlers/http.d.ts +2 -2
  183. package/dist/core/validators/check-handlers/http.d.ts.map +1 -1
  184. package/dist/core/validators/check-handlers/http.js +12 -7
  185. package/dist/core/validators/check-handlers/http.js.map +1 -1
  186. package/dist/failure/classifier.d.ts +1 -1
  187. package/dist/failure/classifier.d.ts.map +1 -1
  188. package/dist/failure/classifier.js +8 -8
  189. package/dist/failure/classifier.js.map +1 -1
  190. package/dist/failure/index.d.ts +2 -1
  191. package/dist/failure/index.d.ts.map +1 -1
  192. package/dist/failure/index.js +9 -17
  193. package/dist/failure/index.js.map +1 -1
  194. package/dist/failure/recorder.d.ts +1 -1
  195. package/dist/failure/recorder.d.ts.map +1 -1
  196. package/dist/gates/checker-gate.d.ts +2 -1
  197. package/dist/gates/checker-gate.d.ts.map +1 -1
  198. package/dist/gates/checker-gate.js +3 -2
  199. package/dist/gates/checker-gate.js.map +1 -1
  200. package/dist/gates/command.d.ts +10 -4
  201. package/dist/gates/command.d.ts.map +1 -1
  202. package/dist/gates/command.js +36 -62
  203. package/dist/gates/command.js.map +1 -1
  204. package/dist/gates/contract.d.ts.map +1 -1
  205. package/dist/gates/contract.js +0 -4
  206. package/dist/gates/contract.js.map +1 -1
  207. package/dist/gates/definitions.d.ts +2 -1
  208. package/dist/gates/definitions.d.ts.map +1 -1
  209. package/dist/gates/definitions.js +6 -5
  210. package/dist/gates/definitions.js.map +1 -1
  211. package/dist/gates/index.d.ts +0 -4
  212. package/dist/gates/index.d.ts.map +1 -1
  213. package/dist/gates/index.js +1 -6
  214. package/dist/gates/index.js.map +1 -1
  215. package/dist/gates/performance.d.ts.map +1 -1
  216. package/dist/gates/performance.js +0 -4
  217. package/dist/gates/performance.js.map +1 -1
  218. package/dist/gates/runner.d.ts +1 -1
  219. package/dist/gates/runner.js +1 -1
  220. package/dist/gates/security.d.ts +1 -1
  221. package/dist/gates/security.d.ts.map +1 -1
  222. package/dist/gates/security.js +5 -6
  223. package/dist/gates/security.js.map +1 -1
  224. package/dist/gates/types.d.ts +14 -17
  225. package/dist/gates/types.d.ts.map +1 -1
  226. package/dist/gates/types.js.map +1 -1
  227. package/dist/hooks/bootstrap.d.ts +6 -4
  228. package/dist/hooks/bootstrap.d.ts.map +1 -1
  229. package/dist/hooks/bootstrap.js +25 -13
  230. package/dist/hooks/bootstrap.js.map +1 -1
  231. package/dist/hooks/config.d.ts +6 -2
  232. package/dist/hooks/config.d.ts.map +1 -1
  233. package/dist/hooks/config.js +5 -1
  234. package/dist/hooks/config.js.map +1 -1
  235. package/dist/hooks/index.d.ts +1 -1
  236. package/dist/hooks/index.d.ts.map +1 -1
  237. package/dist/hooks/index.js +0 -15
  238. package/dist/hooks/index.js.map +1 -1
  239. package/dist/hooks/pipeline.d.ts +19 -1
  240. package/dist/hooks/pipeline.d.ts.map +1 -1
  241. package/dist/hooks/pipeline.js +42 -4
  242. package/dist/hooks/pipeline.js.map +1 -1
  243. package/dist/hooks/registry.d.ts +11 -8
  244. package/dist/hooks/registry.d.ts.map +1 -1
  245. package/dist/hooks/registry.js +22 -7
  246. package/dist/hooks/registry.js.map +1 -1
  247. package/dist/hooks/types.d.ts +25 -7
  248. package/dist/hooks/types.d.ts.map +1 -1
  249. package/dist/index.d.ts +3 -3
  250. package/dist/index.d.ts.map +1 -1
  251. package/dist/index.js +3 -4
  252. package/dist/index.js.map +1 -1
  253. package/dist/knowledge/audit-scoring.d.ts +87 -0
  254. package/dist/knowledge/audit-scoring.d.ts.map +1 -0
  255. package/dist/knowledge/audit-scoring.js +470 -0
  256. package/dist/knowledge/audit-scoring.js.map +1 -0
  257. package/dist/knowledge/audit.d.ts +11 -59
  258. package/dist/knowledge/audit.d.ts.map +1 -1
  259. package/dist/knowledge/audit.js +47 -522
  260. package/dist/knowledge/audit.js.map +1 -1
  261. package/dist/knowledge/import.d.ts.map +1 -1
  262. package/dist/knowledge/import.js +2 -0
  263. package/dist/knowledge/import.js.map +1 -1
  264. package/dist/knowledge/index-generator.d.ts.map +1 -1
  265. package/dist/knowledge/index-generator.js +4 -5
  266. package/dist/knowledge/index-generator.js.map +1 -1
  267. package/dist/knowledge/index.d.ts +3 -2
  268. package/dist/knowledge/index.d.ts.map +1 -1
  269. package/dist/knowledge/index.js +3 -16
  270. package/dist/knowledge/index.js.map +1 -1
  271. package/dist/knowledge/ingest.js +1 -1
  272. package/dist/knowledge/ingest.js.map +1 -1
  273. package/dist/knowledge/lifecycle.d.ts.map +1 -1
  274. package/dist/knowledge/lifecycle.js +4 -2
  275. package/dist/knowledge/lifecycle.js.map +1 -1
  276. package/dist/knowledge/migration.d.ts +3 -0
  277. package/dist/knowledge/migration.d.ts.map +1 -1
  278. package/dist/knowledge/migration.js +8 -2
  279. package/dist/knowledge/migration.js.map +1 -1
  280. package/dist/knowledge/query.d.ts +6 -0
  281. package/dist/knowledge/query.d.ts.map +1 -1
  282. package/dist/knowledge/query.js +8 -2
  283. package/dist/knowledge/query.js.map +1 -1
  284. package/dist/knowledge/reference-tracker.d.ts.map +1 -1
  285. package/dist/knowledge/reference-tracker.js +4 -6
  286. package/dist/knowledge/reference-tracker.js.map +1 -1
  287. package/dist/knowledge/store.d.ts +22 -16
  288. package/dist/knowledge/store.d.ts.map +1 -1
  289. package/dist/knowledge/store.js +53 -12
  290. package/dist/knowledge/store.js.map +1 -1
  291. package/dist/knowledge/tree-walker.d.ts +19 -0
  292. package/dist/knowledge/tree-walker.d.ts.map +1 -0
  293. package/dist/knowledge/tree-walker.js +30 -0
  294. package/dist/knowledge/tree-walker.js.map +1 -0
  295. package/dist/knowledge/types.d.ts +16 -0
  296. package/dist/knowledge/types.d.ts.map +1 -1
  297. package/dist/monitoring/traces.d.ts +5 -3
  298. package/dist/monitoring/traces.d.ts.map +1 -1
  299. package/dist/monitoring/traces.js +19 -5
  300. package/dist/monitoring/traces.js.map +1 -1
  301. package/dist/test-setup/jsonl-fake-fs.d.ts +30 -0
  302. package/dist/test-setup/jsonl-fake-fs.d.ts.map +1 -0
  303. package/dist/test-setup/jsonl-fake-fs.js +49 -0
  304. package/dist/test-setup/jsonl-fake-fs.js.map +1 -0
  305. package/dist/tools/index.d.ts +4 -1
  306. package/dist/tools/index.d.ts.map +1 -1
  307. package/dist/tools/index.js +7 -15
  308. package/dist/tools/index.js.map +1 -1
  309. package/dist/types/checkpoint.d.ts +5 -0
  310. package/dist/types/checkpoint.d.ts.map +1 -1
  311. package/dist/types/project-config.d.ts +18 -0
  312. package/dist/types/project-config.d.ts.map +1 -1
  313. package/dist/types/trace.d.ts +13 -4
  314. package/dist/types/trace.d.ts.map +1 -1
  315. package/dist/types/trace.js +4 -3
  316. package/dist/types/trace.js.map +1 -1
  317. package/dist/utils/exec.d.ts +4 -27
  318. package/dist/utils/exec.d.ts.map +1 -1
  319. package/dist/utils/exec.js +4 -94
  320. package/dist/utils/exec.js.map +1 -1
  321. package/dist/utils/jsonl.d.ts +17 -7
  322. package/dist/utils/jsonl.d.ts.map +1 -1
  323. package/dist/utils/jsonl.js +144 -17
  324. package/dist/utils/jsonl.js.map +1 -1
  325. package/dist/utils/numeric-flag.d.ts +44 -0
  326. package/dist/utils/numeric-flag.d.ts.map +1 -0
  327. package/dist/utils/numeric-flag.js +62 -0
  328. package/dist/utils/numeric-flag.js.map +1 -0
  329. package/package.json +1 -1
  330. package/src/CONTEXT.md +5 -2
  331. package/src/__tests__/acceptance-gate.test.ts +7 -4
  332. package/src/__tests__/checker-extra.test.ts +3 -2
  333. package/src/__tests__/checker.test.ts +4 -3
  334. package/src/__tests__/checkpoint.test.ts +26 -9
  335. package/src/__tests__/context-files-resolution.test.ts +29 -15
  336. package/src/__tests__/contract-gate.test.ts +19 -40
  337. package/src/__tests__/error-classifier.test.ts +1 -1
  338. package/src/__tests__/exec.test.ts +45 -107
  339. package/src/__tests__/failure-recorder.test.ts +7 -5
  340. package/src/__tests__/hooks-pipeline.test.ts +34 -47
  341. package/src/__tests__/layering.test.ts +217 -25
  342. package/src/__tests__/passes-gate.test.ts +9 -4
  343. package/src/__tests__/performance-gate.test.ts +3 -15
  344. package/src/__tests__/project-config-loader-extra.test.ts +31 -57
  345. package/src/__tests__/project-config-loader.test.ts +6 -3
  346. package/src/__tests__/public-exports.test.ts +0 -1
  347. package/src/__tests__/public-type-surface.test.ts +5 -4
  348. package/src/__tests__/public-value-surface.test.ts +182 -0
  349. package/src/__tests__/review-gate.test.ts +4 -6
  350. package/src/__tests__/security-gate.test.ts +5 -20
  351. package/src/__tests__/skip-semantics.test.ts +5 -3
  352. package/src/__tests__/spec-validator.test.ts +3 -2
  353. package/src/__tests__/sub-barrels-explicit.test.ts +87 -0
  354. package/src/__tests__/test-fixture-hygiene.test.ts +53 -0
  355. package/src/__tests__/trace-analyzer-extra.test.ts +5 -3
  356. package/src/__tests__/trace-analyzer.test.ts +5 -3
  357. package/src/__tests__/trace-collector.test.ts +5 -3
  358. package/src/agents/index.ts +13 -2
  359. package/src/cli/__tests__/gate-command.test.ts +162 -0
  360. package/src/cli/__tests__/state-io.test.ts +50 -0
  361. package/src/cli/commands/CONTEXT.md +30 -5
  362. package/src/cli/commands/__tests__/acceptance.test.ts +24 -25
  363. package/src/cli/commands/__tests__/bin-exit-mapping.test.ts +15 -0
  364. package/src/cli/commands/__tests__/check-drift.test.ts +42 -1
  365. package/src/cli/commands/__tests__/check-read-count.test.ts +170 -0
  366. package/src/cli/commands/__tests__/check-skip-output.test.ts +4 -1
  367. package/src/cli/commands/__tests__/check.test.ts +63 -44
  368. package/src/cli/commands/__tests__/command-gate-dead-options.test.ts +60 -0
  369. package/src/cli/commands/__tests__/command.test.ts +33 -17
  370. package/src/cli/commands/__tests__/constraints-retire.test.ts +52 -0
  371. package/src/cli/commands/__tests__/context-syncer.test.ts +141 -0
  372. package/src/cli/commands/__tests__/contract.test.ts +20 -20
  373. package/src/cli/commands/__tests__/failure.test.ts +5 -4
  374. package/src/cli/commands/__tests__/gate-decision.ts +30 -0
  375. package/src/cli/commands/__tests__/init-dead-options.test.ts +50 -0
  376. package/src/cli/commands/__tests__/init-governance-io.test.ts +139 -0
  377. package/src/cli/commands/__tests__/init-injection.test.ts +3 -3
  378. package/src/cli/commands/__tests__/init-ondisk.test.ts +867 -0
  379. package/src/cli/commands/__tests__/init.test.ts +82 -6
  380. package/src/cli/commands/__tests__/knowledge-audit-threshold.test.ts +146 -0
  381. package/src/cli/commands/__tests__/knowledge-flywheel-consistency.test.ts +1 -1
  382. package/src/cli/commands/__tests__/knowledge-tone-mapping.test.ts +244 -0
  383. package/src/cli/commands/__tests__/knowledge-view.test.ts +839 -0
  384. package/src/cli/commands/__tests__/knowledge.test.ts +33 -15
  385. package/src/cli/commands/__tests__/numeric-flag-assembly.test.ts +368 -0
  386. package/src/cli/commands/__tests__/performance.test.ts +19 -21
  387. package/src/cli/commands/__tests__/posteval-plan.test.ts +5 -3
  388. package/src/cli/commands/__tests__/pre-push-hook.test.ts +181 -0
  389. package/src/cli/commands/__tests__/project-path-anchoring.test.ts +95 -2
  390. package/src/cli/commands/__tests__/project-path-convention.test.ts +103 -25
  391. package/src/cli/commands/__tests__/registry.test.ts +2 -0
  392. package/src/cli/commands/__tests__/report.test.ts +23 -1
  393. package/src/cli/commands/__tests__/review.test.ts +10 -17
  394. package/src/cli/commands/__tests__/scaffold.test.ts +505 -0
  395. package/src/cli/commands/__tests__/security-default-scan.test.ts +75 -0
  396. package/src/cli/commands/__tests__/security.test.ts +21 -24
  397. package/src/cli/commands/__tests__/spec-baseline-check.test.ts +3 -2
  398. package/src/cli/commands/__tests__/spec-baseline-index-cap.test.ts +131 -0
  399. package/src/cli/commands/__tests__/spec-baseline-read-count.test.ts +325 -0
  400. package/src/cli/commands/__tests__/status-extra.test.ts +25 -8
  401. package/src/cli/commands/__tests__/status.test.ts +46 -18
  402. package/src/cli/commands/__tests__/sync-docs-agents.test.ts +19 -4
  403. package/src/cli/commands/__tests__/sync-docs-context-drift.test.ts +232 -0
  404. package/src/cli/commands/__tests__/sync-docs-module-order.test.ts +111 -0
  405. package/src/cli/commands/__tests__/sync-docs-read-count.test.ts +192 -0
  406. package/src/cli/commands/__tests__/sync-docs.test.ts +3 -2
  407. package/src/cli/commands/__tests__/validate.test.ts +1 -48
  408. package/src/cli/commands/acceptance.ts +24 -29
  409. package/src/cli/commands/check.ts +60 -35
  410. package/src/cli/commands/command.ts +9 -8
  411. package/src/cli/commands/constraints-retire.ts +57 -70
  412. package/src/cli/commands/contract.ts +44 -47
  413. package/src/cli/commands/definitions.ts +12 -6
  414. package/src/cli/commands/failure.ts +16 -3
  415. package/src/cli/commands/init.ts +242 -389
  416. package/src/cli/commands/knowledge-view.ts +224 -0
  417. package/src/cli/commands/knowledge.ts +643 -448
  418. package/src/cli/commands/passes-gate.ts +12 -3
  419. package/src/cli/commands/performance.ts +31 -38
  420. package/src/cli/commands/report.ts +3 -2
  421. package/src/cli/commands/review.ts +22 -28
  422. package/src/cli/commands/scaffold-templates.ts +406 -0
  423. package/src/cli/commands/scaffold.ts +302 -0
  424. package/src/cli/commands/security.ts +27 -23
  425. package/src/cli/commands/spec-baseline-check.ts +158 -33
  426. package/src/cli/commands/status.ts +12 -7
  427. package/src/cli/commands/sync-docs/__tests__/context-export-surface.test.ts +102 -0
  428. package/src/cli/commands/sync-docs/__tests__/module-descriptions.test.ts +196 -0
  429. package/src/cli/commands/sync-docs/context-syncer.ts +137 -31
  430. package/src/cli/commands/sync-docs/index.ts +103 -28
  431. package/src/cli/commands/sync-docs/project-reader.ts +51 -7
  432. package/src/cli/commands/validate.ts +1 -104
  433. package/src/cli/gate-command.ts +87 -0
  434. package/src/cli/state-io.ts +53 -0
  435. package/src/completion-checkers/index.ts +10 -1
  436. package/src/context/CONTEXT.md +2 -1
  437. package/src/context/__tests__/knowledge-injector.test.ts +27 -0
  438. package/src/context/__tests__/session-manager.test.ts +19 -12
  439. package/src/context/knowledge-injector.ts +14 -7
  440. package/src/core/CONTEXT.md +10 -7
  441. package/src/core/__tests__/effective-set.test.ts +36 -60
  442. package/src/core/constraints/__tests__/context-reconcile.test.ts +246 -0
  443. package/src/core/constraints/__tests__/run-env.test.ts +377 -0
  444. package/src/core/constraints/__tests__/triggers.test.ts +70 -0
  445. package/src/core/constraints/agent-prompt-renderer.ts +1 -1
  446. package/src/core/constraints/capabilities-reconcile.ts +28 -4
  447. package/src/core/constraints/check-cache.ts +1 -1
  448. package/src/core/constraints/checker.ts +30 -14
  449. package/src/core/constraints/checkers/__tests__/context-doc-sync.test.ts +8 -3
  450. package/src/core/constraints/checkers/__tests__/governance-presence.test.ts +16 -7
  451. package/src/core/constraints/checkers/__tests__/no-hardcoded-credentials.test.ts +2 -1
  452. package/src/core/constraints/checkers/capability-sync.ts +27 -28
  453. package/src/core/constraints/checkers/context-doc-sync.ts +9 -7
  454. package/src/core/constraints/checkers/docs-freshness.ts +28 -33
  455. package/src/core/constraints/checkers/governance-presence.ts +10 -6
  456. package/src/core/constraints/checkers/types.ts +14 -8
  457. package/src/core/constraints/context-builder.ts +35 -26
  458. package/src/core/constraints/context-reconcile.ts +200 -0
  459. package/src/core/constraints/doc-freshness/__tests__/runner.test.ts +25 -0
  460. package/src/core/constraints/doc-freshness/runner.ts +18 -4
  461. package/src/core/constraints/git-evidence.ts +1 -1
  462. package/src/core/constraints/injection-drift.ts +19 -8
  463. package/src/core/constraints/run-env.ts +207 -0
  464. package/src/core/constraints/triggers.ts +33 -0
  465. package/src/core/effective-constraints.ts +17 -6
  466. package/src/core/effective-set.ts +8 -24
  467. package/src/core/index.ts +2 -0
  468. package/src/core/project-config-loader.ts +54 -102
  469. package/src/core/validators/__tests__/http-retry-sleep.test.ts +231 -0
  470. package/src/core/validators/check-handlers/http.ts +18 -7
  471. package/src/failure/CONTEXT.md +2 -1
  472. package/src/failure/classifier.ts +2 -2
  473. package/src/failure/index.ts +14 -2
  474. package/src/failure/recorder.ts +1 -1
  475. package/src/gates/CONTEXT.md +13 -7
  476. package/src/gates/__tests__/checker-gate.test.ts +1 -1
  477. package/src/gates/__tests__/command-single-predicate.test.ts +135 -0
  478. package/src/gates/__tests__/command.test.ts +8 -15
  479. package/src/gates/__tests__/contract.test.ts +5 -5
  480. package/src/gates/__tests__/gate-interface.test.ts +0 -17
  481. package/src/gates/__tests__/performance.test.ts +0 -13
  482. package/src/gates/__tests__/review.test.ts +0 -1
  483. package/src/gates/__tests__/runner.test.ts +1 -1
  484. package/src/gates/__tests__/security-default-scan.test.ts +97 -0
  485. package/src/gates/__tests__/security.test.ts +0 -13
  486. package/src/gates/checker-gate.ts +3 -2
  487. package/src/gates/command.ts +51 -74
  488. package/src/gates/contract.ts +0 -5
  489. package/src/gates/definitions.ts +6 -5
  490. package/src/gates/index.ts +0 -5
  491. package/src/gates/performance.ts +1 -6
  492. package/src/gates/runner.ts +1 -1
  493. package/src/gates/security.ts +9 -11
  494. package/src/gates/types.ts +20 -23
  495. package/src/hooks/CONTEXT.md +10 -9
  496. package/src/hooks/__tests__/bootstrap.test.ts +29 -6
  497. package/src/hooks/__tests__/pipeline.test.ts +133 -17
  498. package/src/hooks/__tests__/registry.test.ts +51 -3
  499. package/src/hooks/bootstrap.ts +35 -15
  500. package/src/hooks/config.ts +6 -2
  501. package/src/hooks/index.ts +10 -1
  502. package/src/hooks/pipeline.ts +51 -6
  503. package/src/hooks/registry.ts +31 -12
  504. package/src/hooks/types.ts +26 -7
  505. package/src/index.ts +1 -2
  506. package/src/knowledge/CONTEXT.md +14 -7
  507. package/src/knowledge/__tests__/audit-labels.test.ts +8 -5
  508. package/src/knowledge/__tests__/audit-scoring.test.ts +230 -0
  509. package/src/knowledge/__tests__/audit-write-count.test.ts +131 -0
  510. package/src/knowledge/__tests__/audit.test.ts +291 -208
  511. package/src/knowledge/__tests__/doctor.test.ts +3 -2
  512. package/src/knowledge/__tests__/ingest.test.ts +3 -2
  513. package/src/knowledge/__tests__/lifecycle.test.ts +57 -2
  514. package/src/knowledge/__tests__/migration.test.ts +35 -6
  515. package/src/knowledge/__tests__/query.test.ts +3 -2
  516. package/src/knowledge/__tests__/reference-tracker.test.ts +23 -2
  517. package/src/knowledge/__tests__/store.test.ts +149 -4
  518. package/src/knowledge/__tests__/tree-walker.test.ts +132 -0
  519. package/src/knowledge/audit-scoring.ts +589 -0
  520. package/src/knowledge/audit.ts +55 -599
  521. package/src/knowledge/import.ts +2 -0
  522. package/src/knowledge/index-generator.ts +4 -6
  523. package/src/knowledge/index.ts +27 -2
  524. package/src/knowledge/ingest.ts +1 -1
  525. package/src/knowledge/lifecycle.ts +5 -2
  526. package/src/knowledge/migration.ts +8 -2
  527. package/src/knowledge/query.ts +8 -1
  528. package/src/knowledge/reference-tracker.ts +5 -7
  529. package/src/knowledge/store.ts +75 -16
  530. package/src/knowledge/tree-walker.ts +29 -0
  531. package/src/knowledge/types.ts +19 -0
  532. package/src/monitoring/CONTEXT.md +5 -2
  533. package/src/monitoring/__tests__/context-tracker.test.ts +16 -8
  534. package/src/monitoring/__tests__/trace-file-anchoring.test.ts +80 -0
  535. package/src/monitoring/traces.ts +19 -5
  536. package/src/release/CONTEXT.md +1 -1
  537. package/src/release/__tests__/integrity.test.ts +21 -12
  538. package/src/test-setup/__tests__/jsonl-fake-fs.test.ts +98 -0
  539. package/src/test-setup/jsonl-fake-fs.ts +59 -0
  540. package/src/tools/index.ts +5 -1
  541. package/src/types/checkpoint.ts +6 -0
  542. package/src/types/project-config.ts +21 -0
  543. package/src/types/trace.ts +14 -4
  544. package/src/utils/__tests__/file-walk.test.ts +3 -2
  545. package/src/utils/__tests__/jsonl-bounded-read.test.ts +106 -0
  546. package/src/utils/__tests__/jsonl-skip-disposition.test.ts +10 -6
  547. package/src/utils/__tests__/jsonl.test.ts +61 -14
  548. package/src/utils/__tests__/numeric-flag.test.ts +80 -0
  549. package/src/utils/__tests__/package-version.test.ts +2 -2
  550. package/src/utils/exec.ts +4 -64
  551. package/src/utils/jsonl.ts +159 -20
  552. package/src/utils/numeric-flag.ts +64 -0
  553. package/dist/failure/types.d.ts +0 -9
  554. package/dist/failure/types.d.ts.map +0 -1
  555. package/dist/failure/types.js +0 -25
  556. package/dist/failure/types.js.map +0 -1
  557. package/dist/gates/effective-gates.d.ts +0 -30
  558. package/dist/gates/effective-gates.d.ts.map +0 -1
  559. package/dist/gates/effective-gates.js +0 -81
  560. package/dist/gates/effective-gates.js.map +0 -1
  561. package/src/failure/types.ts +0 -9
  562. package/src/gates/__tests__/effective-gates.test.ts +0 -77
  563. package/src/gates/effective-gates.ts +0 -99
@@ -4,6 +4,7 @@
4
4
 
5
5
  import { knowledgeAudit, knowledgeStats, knowledgeHealth, knowledgeSearch } from '../knowledge';
6
6
  import { captureIO, type CapturingIO } from '../../command-contract';
7
+ import type { AuditReport } from '../../../knowledge/audit-scoring';
7
8
 
8
9
  // Mock chalk
9
10
  jest.mock('chalk', () => ({
@@ -13,6 +14,7 @@ jest.mock('chalk', () => ({
13
14
  yellow: jest.fn((str: string) => str),
14
15
  red: jest.fn((str: string) => str),
15
16
  gray: jest.fn((str: string) => str),
17
+ cyan: jest.fn((str: string) => str),
16
18
  }));
17
19
 
18
20
  // Mock KnowledgeAudit
@@ -21,8 +23,6 @@ jest.mock('../../../knowledge/audit', () => ({
21
23
  KnowledgeAudit: jest.fn().mockImplementation(() => ({
22
24
  run: mockRun,
23
25
  })),
24
- // label 正本在 audit.ts 规则定义上,CLI 直接消费(#109)
25
- AUDIT_RULE_LABELS: jest.requireActual('../../../knowledge/audit').AUDIT_RULE_LABELS,
26
26
  }));
27
27
 
28
28
  // Mock KnowledgeIndexGenerator (avoids real fs writes in CLI tests)
@@ -32,7 +32,11 @@ jest.mock('../../../knowledge/index-generator', () => ({
32
32
  })),
33
33
  }));
34
34
 
35
- const MOCK_REPORT = {
35
+ /**
36
+ * 审计报告的 mock 与真实类型同源(harness#133 验收 3):标注成 AuditReport 后,
37
+ * 7 个维度、14 条规则键由编译期穷尽性管住——缺键补偿(原先手写 6 键再 splice incremental)写不出来。
38
+ */
39
+ const MOCK_REPORT: AuditReport = {
36
40
  timestamp: '2026-06-02T00:00:00.000Z',
37
41
  totalEntries: 100,
38
42
  issues: [
@@ -49,14 +53,17 @@ const MOCK_REPORT = {
49
53
  'frontmatter-missing': 0,
50
54
  'test-data-pollution': 0,
51
55
  'daily-audit-noise': 0,
56
+ 'event-noise': 0,
52
57
  'zero-content-proven': 0,
53
58
  'short-content': 1,
54
59
  'maturity-inflation': 0,
55
60
  'title-duplicate': 0,
56
61
  'source-refs-bloat': 0,
62
+ 'fragment-cluster': 0,
57
63
  'promotion-blocked': 0,
58
64
  'orphan-draft': 0,
59
65
  'stale-entry': 0,
66
+ 'deprecated-domain': 0,
60
67
  },
61
68
  dimensions: {
62
69
  structure: { score: 100, issues: 0, details: {} },
@@ -65,16 +72,20 @@ const MOCK_REPORT = {
65
72
  maturity: { score: 100, issues: 0, details: {} },
66
73
  freshness: { score: 100, issues: 0, details: {} },
67
74
  flywheel: { score: 50, issues: 0, details: {} },
75
+ incremental: { score: 80, issues: 0, details: {} },
68
76
  },
69
77
  autoFixed: 0,
70
78
  healthScore: { before: 95, after: 95 },
71
79
  };
72
80
 
81
+
73
82
  let io: CapturingIO;
74
83
  beforeEach(() => {
75
84
  io = captureIO();
76
85
  });
77
86
 
87
+ // 解析函数本体自 #133 起住 knowledge-view.ts(resolveKnowledgeBaseDir),行为面不变:
88
+ // 这里经 knowledgeStats 观测 `-p` / KNOWLEDGE_BASE_DIR / 旧目录兜底三条路径的解析结果
78
89
  describe('getKnowledgeDir', () => {
79
90
  const fs = require('fs');
80
91
  const os = require('os');
@@ -147,10 +158,22 @@ describe('getKnowledgeDir', () => {
147
158
  });
148
159
 
149
160
  describe('knowledgeAudit CLI', () => {
161
+ // 引擎改收 store(#134)后,视图层会真构造 FileKnowledgeStore(构造即 mkdir),
162
+ // 本 describe 判定的是接线,不落真目录:把 store 构造点换成替身
163
+ let storeCtorSpy: jest.SpyInstance;
150
164
 
151
165
  beforeEach(() => {
152
166
  jest.clearAllMocks();
153
167
  mockRun.mockReturnValue(MOCK_REPORT);
168
+ storeCtorSpy = jest.spyOn(require('../../../knowledge/store'), 'FileKnowledgeStore').mockImplementation(() => ({
169
+ list: jest.fn().mockReturnValue([]),
170
+ get: jest.fn(),
171
+ getBaseDir: jest.fn().mockReturnValue('/tmp/knowledge'),
172
+ }));
173
+ });
174
+
175
+ afterEach(() => {
176
+ storeCtorSpy.mockRestore();
154
177
  });
155
178
 
156
179
  it('should output JSON when --json is set', async () => {
@@ -196,12 +219,12 @@ describe('knowledgeAudit CLI', () => {
196
219
  expect(output).toContain('修复后: 95/100');
197
220
  });
198
221
 
199
- it('should pass custom dir to KnowledgeAudit', async () => {
222
+ it('引擎收 store:目录解析落 openKnowledgeStore,阈值走第二形参(#134)', async () => {
200
223
  const { KnowledgeAudit } = require('../../../knowledge/audit');
201
- await knowledgeAudit({ dir: '/custom/path' }, io);
202
- expect(KnowledgeAudit).toHaveBeenCalledWith(expect.objectContaining({
203
- baseDir: '/custom/path',
204
- }));
224
+ await knowledgeAudit({ dir: '/custom/path', threshold: '30' }, io);
225
+ expect(storeCtorSpy).toHaveBeenCalledWith({ baseDir: '/custom/path' });
226
+ const store = storeCtorSpy.mock.results[0].value;
227
+ expect(KnowledgeAudit).toHaveBeenCalledWith(store, { shortContentThreshold: 30 });
205
228
  });
206
229
 
207
230
  it('规则 label 闭环:event-noise / deprecated-domain 显示中文 label,不回落英文键名(#109)', async () => {
@@ -223,13 +246,8 @@ describe('knowledgeAudit CLI', () => {
223
246
  });
224
247
 
225
248
  it('维度 label 闭环:incremental 维度显示中文 label,不回落英文键名(#109)', async () => {
226
- mockRun.mockReturnValue({
227
- ...MOCK_REPORT,
228
- dimensions: {
229
- ...MOCK_REPORT.dimensions,
230
- incremental: { score: 80, issues: 0, details: {} },
231
- },
232
- });
249
+ // mock 与 AuditReport 同源后不必再补 incremental 键(#133 验收 3)
250
+ mockRun.mockReturnValue(MOCK_REPORT);
233
251
  await knowledgeAudit({}, io);
234
252
  const output = io.outText();
235
253
  expect(output).toContain('D7 增量存活');
@@ -0,0 +1,368 @@
1
+ /**
2
+ * 数值旗帜装配口径推广测试(harness#154)
3
+ *
4
+ * #152 把判据落在 knowledge audit --threshold 一处,本票推广到其余数值旗帜:
5
+ * - 定义表装配(mapActionArgs,转不出来抛 NumericFlagError → bin 映射 usage-error):
6
+ * constraints report 三阈值、performance --coverage-threshold/--bundle-threshold、
7
+ * review --min-reviewers;
8
+ * - 命令模块装配(parseNumericFlag 判别 + 就地 logError + usage-error):
9
+ * knowledge search --limit、failure list --limit、passes-gate --coverage-threshold。
10
+ * 证三件事:脏输入 fail-loud(非零 + stderr 点名旗帜 + stdout 零字节 + 零副作用)、
11
+ * 合法路径逐字不变(未传 vs 显式缺省同果)、显式 '0' 不被当「未传」兜掉。
12
+ */
13
+
14
+ import * as fs from 'fs';
15
+ import * as os from 'os';
16
+ import * as path from 'path';
17
+ import { spawnSync } from 'child_process';
18
+
19
+ // Mock chalk(断言看文本,不看 ANSI)
20
+ jest.mock('chalk', () => ({
21
+ blue: jest.fn((s: string) => s),
22
+ bold: jest.fn((s: string) => s),
23
+ green: jest.fn((s: string) => s),
24
+ yellow: jest.fn((s: string) => s),
25
+ red: jest.fn((s: string) => s),
26
+ gray: jest.fn((s: string) => s),
27
+ cyan: jest.fn((s: string) => s),
28
+ }));
29
+
30
+ import { captureIO, lastJsonOutput } from '../../command-contract';
31
+ import { COMMAND_DEFINITIONS } from '../definitions';
32
+ import { GATE_DEFINITIONS } from '../../../gates/definitions';
33
+ import { knowledgeSearchCommand } from '../knowledge';
34
+ import { failureList } from '../failure';
35
+ import { coverageCheck } from '../passes-gate';
36
+ import { FileKnowledgeStore } from '../../../knowledge/store';
37
+ import type { KnowledgeEntry } from '../../../knowledge/types';
38
+ import { FailureRecorder } from '../../../failure/recorder';
39
+ import { DEFAULT_FAILURE_LOG_FILE, ErrorType, FailureLevel } from '../../../types/failure';
40
+ import { NumericFlagError } from '../../../utils/numeric-flag';
41
+
42
+ const repoRoot = path.join(__dirname, '..', '..', '..', '..');
43
+ const distBin = path.join(repoRoot, 'bin', 'harness.js');
44
+ const hasDist = fs.existsSync(path.join(repoRoot, 'dist', 'cli', 'commands'));
45
+
46
+ function tmp(): string {
47
+ return fs.mkdtempSync(path.join(os.tmpdir(), 'harness-k154-'));
48
+ }
49
+
50
+ // ========================================
51
+ // 定义表装配点(mapActionArgs → requireNumericFlag)
52
+ // ========================================
53
+
54
+ const reportDef = COMMAND_DEFINITIONS.find(d => d.command === 'constraints')!
55
+ .children!.find(d => d.command === 'report')!;
56
+ const performanceCli = GATE_DEFINITIONS.find(g => g.id === 'performance')!.cli;
57
+ const reviewCli = GATE_DEFINITIONS.find(g => g.id === 'review')!.cli;
58
+
59
+ describe('constraints report 三阈值:装配点 fail-loud', () => {
60
+ const valid = { json: false, zeroInterceptMin: '50', noiseFailRate: '0.8', noiseMinTotal: '20' };
61
+
62
+ it('缺省字符串 → 数值(int/int/float 各归其形)', () => {
63
+ expect(reportDef.mapActionArgs!([], valid)).toEqual([{
64
+ projectPath: undefined,
65
+ export: undefined,
66
+ json: false,
67
+ zeroInterceptMin: 50,
68
+ noiseFailRate: 0.8,
69
+ noiseMinTotal: 20,
70
+ }]);
71
+ });
72
+
73
+ it.each([
74
+ ['zeroInterceptMin', '--zero-intercept-min'],
75
+ ['noiseFailRate', '--noise-fail-rate'],
76
+ ['noiseMinTotal', '--noise-min-total'],
77
+ ])('%s 脏值 → 抛 NumericFlagError 点名 %s(原先 NaN 静默减少候选、退出码 0)', (key, flag) => {
78
+ let caught: unknown;
79
+ try {
80
+ reportDef.mapActionArgs!([], { ...valid, [key]: 'abc' });
81
+ } catch (err) {
82
+ caught = err;
83
+ }
84
+ expect(caught).toBeInstanceOf(NumericFlagError);
85
+ expect((caught as Error).message).toContain(flag);
86
+ expect((caught as Error).message).toContain('"abc"');
87
+ });
88
+
89
+ it('显式 "0" → 0(不被当未传兜掉)', () => {
90
+ const [args] = reportDef.mapActionArgs!([], { ...valid, zeroInterceptMin: '0' }) as [{ zeroInterceptMin: number }];
91
+ expect(args.zeroInterceptMin).toBe(0);
92
+ });
93
+ });
94
+
95
+ describe('门禁 performance / review:装配点 fail-loud', () => {
96
+ it('performance 缺省字符串 → 数值;显式 "0" → 0', () => {
97
+ const [args] = performanceCli.mapActionArgs!([], {
98
+ coverage: true, coverageThreshold: '80', bundle: true, bundleThreshold: '500',
99
+ }) as [{ coverageThreshold: number; bundleThreshold: number }];
100
+ expect(args.coverageThreshold).toBe(80);
101
+ expect(args.bundleThreshold).toBe(500);
102
+ const [zeros] = performanceCli.mapActionArgs!([], {
103
+ coverage: true, coverageThreshold: '0', bundle: true, bundleThreshold: '0',
104
+ }) as [{ coverageThreshold: number; bundleThreshold: number }];
105
+ expect(zeros.coverageThreshold).toBe(0);
106
+ expect(zeros.bundleThreshold).toBe(0);
107
+ });
108
+
109
+ it.each([
110
+ ['coverageThreshold', '--coverage-threshold'],
111
+ ['bundleThreshold', '--bundle-threshold'],
112
+ ])('performance %s 脏值 → 抛 NumericFlagError 点名 %s', (key, flag) => {
113
+ let caught: unknown;
114
+ try {
115
+ performanceCli.mapActionArgs!([], { coverageThreshold: '80', bundleThreshold: '500', [key]: 'abc' });
116
+ } catch (err) {
117
+ caught = err;
118
+ }
119
+ expect(caught).toBeInstanceOf(NumericFlagError);
120
+ expect((caught as Error).message).toContain(flag);
121
+ });
122
+
123
+ it('review --min-reviewers:缺省 → 1,显式 "0" → 0,脏值抛错', () => {
124
+ const [args] = reviewCli.mapActionArgs!([], { minReviewers: '1' }) as [{ minReviewers: number }];
125
+ expect(args.minReviewers).toBe(1);
126
+ const [zero] = reviewCli.mapActionArgs!([], { minReviewers: '0' }) as [{ minReviewers: number }];
127
+ expect(zero.minReviewers).toBe(0);
128
+ expect(() => reviewCli.mapActionArgs!([], { minReviewers: 'abc' })).toThrow(NumericFlagError);
129
+ });
130
+ });
131
+
132
+ // ========================================
133
+ // 命令模块装配点(parseNumericFlag 判别 + 就地 usage-error)
134
+ // ========================================
135
+
136
+ const DAY = 24 * 60 * 60 * 1000;
137
+ function makeEntry(id: string, content: string): KnowledgeEntry {
138
+ return {
139
+ id,
140
+ type: 'guideline',
141
+ title: `探针 ${id}`,
142
+ content,
143
+ maturity: 'draft',
144
+ layer: 'project',
145
+ created: new Date(Date.now() - 3 * DAY).toISOString(),
146
+ lastReferenced: new Date(Date.now() - DAY).toISOString(),
147
+ contributors: [],
148
+ projects: [],
149
+ tags: [],
150
+ applicablePhases: [],
151
+ sourceReferences: [],
152
+ referencedBy: [],
153
+ executionResults: [],
154
+ consumptionMode: 'reference',
155
+ origin: 'agent',
156
+ };
157
+ }
158
+
159
+ /** 两条都含 probe 的条目,store 落在 projectPath 约定位置(openKnowledgeStore 同径) */
160
+ function seedKnowledge(projectPath: string): void {
161
+ const store = new FileKnowledgeStore({ baseDir: `${projectPath}/.harness/knowledge` });
162
+ store.save(makeEntry('P-1', 'probe alpha'));
163
+ store.save(makeEntry('P-2', 'probe beta'));
164
+ }
165
+
166
+ describe('knowledge search --limit:命令入口 fail-loud', () => {
167
+ it('未传 vs 显式 "20" 逐字同果;"1" 真截断', async () => {
168
+ const projectPath = tmp();
169
+ seedKnowledge(projectPath);
170
+ const unset = captureIO();
171
+ const r1 = await knowledgeSearchCommand(['probe'], { projectPath, json: true }, unset);
172
+ expect(r1.kind).toBe('ok');
173
+ const explicit = captureIO();
174
+ const r2 = await knowledgeSearchCommand(['probe'], { projectPath, json: true, limit: '20' }, explicit);
175
+ expect(r2.kind).toBe('ok');
176
+ expect(explicit.outText()).toBe(unset.outText());
177
+ expect(lastJsonOutput<{ total: number }>(unset).total).toBe(2);
178
+
179
+ const one = captureIO();
180
+ await knowledgeSearchCommand(['probe'], { projectPath, json: true, limit: '1' }, one);
181
+ expect(lastJsonOutput<{ total: number }>(one).total).toBe(1);
182
+ fs.rmSync(projectPath, { recursive: true, force: true });
183
+ });
184
+
185
+ it('显式 "0" → 0 条(原先 0 || 20 静默落缺省)', async () => {
186
+ const projectPath = tmp();
187
+ seedKnowledge(projectPath);
188
+ const io = captureIO();
189
+ const r = await knowledgeSearchCommand(['probe'], { projectPath, json: true, limit: '0' }, io);
190
+ expect(r.kind).toBe('ok');
191
+ expect(lastJsonOutput<{ total: number }>(io).total).toBe(0);
192
+ fs.rmSync(projectPath, { recursive: true, force: true });
193
+ });
194
+
195
+ it.each(['abc', '1e2', '0.7', '-5', '0x10'])(
196
+ '--limit %o → usage-error + stderr 点名,store 不构造、目录零新文件',
197
+ async (raw) => {
198
+ const projectPath = tmp();
199
+ const io = captureIO();
200
+ const r = await knowledgeSearchCommand(['probe'], { projectPath, json: true, limit: raw }, io);
201
+ expect(r.kind).toBe('usage-error');
202
+ expect(r).toEqual({ kind: 'usage-error', reason: expect.stringContaining('--limit') });
203
+ expect(io.outText()).toBe('');
204
+ expect(io.errText()).toContain('--limit');
205
+ expect(io.errText()).toContain(`"${raw}"`);
206
+ expect(fs.readdirSync(projectPath)).toEqual([]);
207
+ fs.rmSync(projectPath, { recursive: true, force: true });
208
+ },
209
+ );
210
+ });
211
+
212
+ describe('failure list --limit:命令入口 fail-loud', () => {
213
+ async function seedFailures(projectPath: string, count: number): Promise<void> {
214
+ const recorder = new FailureRecorder({ logFile: path.join(projectPath, DEFAULT_FAILURE_LOG_FILE) });
215
+ for (let i = 0; i < count; i++) {
216
+ await recorder.record({
217
+ type: ErrorType.AGENT_ERROR,
218
+ level: FailureLevel.L2,
219
+ message: `探针失败 ${i}`,
220
+ timestamp: Date.now() + i,
221
+ });
222
+ }
223
+ }
224
+
225
+ it('显式 "20" 截到 20 条;显式 "0" = 不截断(既有语义钉住,非兜回缺省)', async () => {
226
+ const projectPath = tmp();
227
+ await seedFailures(projectPath, 25);
228
+ const twenty = captureIO();
229
+ const r1 = await failureList({ projectPath, json: true, limit: '20' }, twenty);
230
+ expect(r1.kind).toBe('ok');
231
+ expect(lastJsonOutput<{ total: number }>(twenty).total).toBe(20);
232
+
233
+ const zero = captureIO();
234
+ const r2 = await failureList({ projectPath, json: true, limit: '0' }, zero);
235
+ expect(r2.kind).toBe('ok');
236
+ expect(lastJsonOutput<{ total: number }>(zero).total).toBe(25);
237
+ fs.rmSync(projectPath, { recursive: true, force: true });
238
+ });
239
+
240
+ it('程序内 number 入参形状不变(双形声明是对的)', async () => {
241
+ const projectPath = tmp();
242
+ await seedFailures(projectPath, 25);
243
+ const io = captureIO();
244
+ const r = await failureList({ projectPath, json: true, limit: 5 }, io);
245
+ expect(r.kind).toBe('ok');
246
+ expect(lastJsonOutput<{ total: number }>(io).total).toBe(5);
247
+ fs.rmSync(projectPath, { recursive: true, force: true });
248
+ });
249
+
250
+ it('--limit abc → usage-error + stderr 点名,recorder 不构造、目录零新文件', async () => {
251
+ const projectPath = tmp();
252
+ const io = captureIO();
253
+ const r = await failureList({ projectPath, json: true, limit: 'abc' }, io);
254
+ expect(r).toEqual({ kind: 'usage-error', reason: expect.stringContaining('--limit') });
255
+ expect(io.outText()).toBe('');
256
+ expect(io.errText()).toContain('--limit');
257
+ expect(io.errText()).toContain('"abc"');
258
+ expect(fs.readdirSync(projectPath)).toEqual([]);
259
+ fs.rmSync(projectPath, { recursive: true, force: true });
260
+ });
261
+ });
262
+
263
+ describe('passes-gate --coverage-threshold:命令入口 fail-loud', () => {
264
+ it('脏值 → usage-error + stderr 点名,覆盖率检查不执行(原先打出自证异常的 "(x% < NaN%)")', async () => {
265
+ const projectPath = tmp();
266
+ const io = captureIO();
267
+ const r = await coverageCheck({ projectPath, coverageThreshold: 'abc' }, io);
268
+ expect(r).toEqual({ kind: 'usage-error', reason: expect.stringContaining('--coverage-threshold') });
269
+ expect(io.outText()).toBe('');
270
+ expect(io.errText()).toContain('--coverage-threshold');
271
+ expect(io.errText()).toContain('"abc"');
272
+ fs.rmSync(projectPath, { recursive: true, force: true });
273
+ });
274
+ });
275
+
276
+ // ========================================
277
+ // 端到端:真实 spawn bin/harness.js(dist 存在时)
278
+ // ========================================
279
+
280
+ // 与 bin-exit-mapping.test.ts 同规:CI 上 dist 缺失显式失败而非静默 skip(harness#99)
281
+ if (!hasDist && process.env.CI) {
282
+ throw new Error('dist 未构建:数值旗帜端到端不得静默 skip —— CI 必须先 npm run build 再 npm test(harness#99)');
283
+ }
284
+
285
+ const smoke = hasDist ? describe : describe.skip;
286
+
287
+ smoke('端到端:脏输入 → 非零退出 + stderr 点名 + stdout 零字节 + 零副作用落盘', () => {
288
+ const run = (argv: string[], cwd: string) => spawnSync(process.execPath, [distBin, ...argv], {
289
+ cwd,
290
+ encoding: 'utf-8',
291
+ timeout: 60000,
292
+ });
293
+
294
+ /** 四组静默降级站点(票面「确切缺口」1/2/3/4)+ performance --coverage-threshold */
295
+ it.each([
296
+ [['constraints', 'report', '--zero-intercept-min', 'abc'], '--zero-intercept-min'],
297
+ [['constraints', 'report', '--noise-fail-rate', 'abc'], '--noise-fail-rate'],
298
+ [['constraints', 'report', '--noise-min-total', 'abc'], '--noise-min-total'],
299
+ [['knowledge', 'search', 'probe', '--limit', 'abc'], '--limit'],
300
+ [['failure', 'list', '--limit', 'abc'], '--limit'],
301
+ [['performance', '--bundle', '--bundle-threshold', 'abc'], '--bundle-threshold'],
302
+ [['performance', '--coverage', '--coverage-threshold', 'abc'], '--coverage-threshold'],
303
+ ])('%j → exit 1', (argv, flag) => {
304
+ const projectPath = tmp();
305
+ try {
306
+ const r = run([...argv, '-p', projectPath], projectPath);
307
+ expect(r.status).toBe(1);
308
+ expect(r.stderr).toContain(flag);
309
+ expect(r.stderr).toContain('"abc"');
310
+ expect(r.stdout).toBe('');
311
+ expect(fs.readdirSync(projectPath)).toEqual([]);
312
+ } finally {
313
+ fs.rmSync(projectPath, { recursive: true, force: true });
314
+ }
315
+ });
316
+
317
+ it('review --min-reviewers abc → exit 1(fail-closed 面同样收敛为 fail-loud)', () => {
318
+ const projectPath = tmp();
319
+ try {
320
+ const r = run(['review', '--min-reviewers', 'abc', '-p', projectPath], projectPath);
321
+ expect(r.status).toBe(1);
322
+ expect(r.stderr).toContain('--min-reviewers');
323
+ expect(fs.readdirSync(projectPath)).toEqual([]);
324
+ } finally {
325
+ fs.rmSync(projectPath, { recursive: true, force: true });
326
+ }
327
+ });
328
+
329
+ it('passes-gate --coverage --coverage-threshold abc → exit 1(usage-error,先于覆盖率执行)', () => {
330
+ const projectPath = tmp();
331
+ try {
332
+ const r = run(['passes-gate', '--coverage', '--coverage-threshold', 'abc', '-p', projectPath], projectPath);
333
+ expect(r.status).toBe(1);
334
+ expect(r.stderr).toContain('--coverage-threshold');
335
+ expect(fs.readdirSync(projectPath)).toEqual([]);
336
+ } finally {
337
+ fs.rmSync(projectPath, { recursive: true, force: true });
338
+ }
339
+ });
340
+
341
+ it('合法路径逐字不变:未传 vs 显式缺省值,stdout 逐字相等', () => {
342
+ const pairs: string[][][] = [
343
+ [
344
+ ['constraints', 'report'],
345
+ ['constraints', 'report', '--zero-intercept-min', '50', '--noise-fail-rate', '0.8', '--noise-min-total', '20'],
346
+ ],
347
+ [
348
+ ['failure', 'list'],
349
+ ['failure', 'list', '--limit', '20'],
350
+ ],
351
+ [
352
+ ['knowledge', 'search', 'probe'],
353
+ ['knowledge', 'search', 'probe', '--limit', '20'],
354
+ ],
355
+ ];
356
+ for (const [unset, explicit] of pairs) {
357
+ const projectPath = tmp();
358
+ try {
359
+ const r1 = run([...unset, '-p', projectPath], projectPath);
360
+ const r2 = run([...explicit, '-p', projectPath], projectPath);
361
+ expect(r2.status).toBe(r1.status);
362
+ expect(r2.stdout).toBe(r1.stdout);
363
+ } finally {
364
+ fs.rmSync(projectPath, { recursive: true, force: true });
365
+ }
366
+ }
367
+ });
368
+ });
@@ -4,11 +4,12 @@
4
4
 
5
5
  import { performance } from '../performance';
6
6
  import { captureIO, type CapturingIO } from '../../command-contract';
7
+ import { decide, fakeGate, throwingGate } from './gate-decision';
7
8
  import { PerformanceGate } from '../../../gates/performance';
8
9
 
9
10
  jest.mock('../../../gates/performance', () => ({
10
11
  PerformanceGate: jest.fn().mockImplementation(() => ({
11
- check: jest.fn(),
12
+ evaluate: jest.fn(),
12
13
  })),
13
14
  }));
14
15
 
@@ -31,14 +32,13 @@ describe('performance command', () => {
31
32
  });
32
33
 
33
34
  it('should print success when check passes', async () => {
34
- const mockCheck = jest.fn().mockResolvedValue({
35
- passed: true,
36
- message: 'ok',
37
- details: {
38
- metrics: { coverage: 85.5, bundleSize: 204800 },
39
- },
40
- });
41
- MockGate.mockImplementation(() => ({ check: mockCheck }) as any);
35
+ MockGate.mockImplementation(() =>
36
+ fakeGate(
37
+ decide('performance', true, 'ok', {
38
+ metrics: { coverage: 85.5, bundleSize: 204800 },
39
+ })
40
+ ) as any
41
+ );
42
42
 
43
43
  const result = await performance({}, io);
44
44
 
@@ -47,12 +47,13 @@ describe('performance command', () => {
47
47
  });
48
48
 
49
49
  it('should print failure and exit 1 when check fails', async () => {
50
- const mockCheck = jest.fn().mockResolvedValue({
51
- passed: false,
52
- message: 'threshold exceeded',
53
- details: { failures: ['coverage below 80%', 'bundle too large'] },
54
- });
55
- MockGate.mockImplementation(() => ({ check: mockCheck }) as any);
50
+ MockGate.mockImplementation(() =>
51
+ fakeGate(
52
+ decide('performance', false, 'threshold exceeded', {
53
+ failures: ['coverage below 80%', 'bundle too large'],
54
+ })
55
+ ) as any
56
+ );
56
57
 
57
58
  const result = await performance({}, io);
58
59
 
@@ -64,8 +65,7 @@ describe('performance command', () => {
64
65
  });
65
66
 
66
67
  it('should handle errors and exit 1', async () => {
67
- const mockCheck = jest.fn().mockRejectedValue(new Error('gate error'));
68
- MockGate.mockImplementation(() => ({ check: mockCheck }) as any);
68
+ MockGate.mockImplementation(() => throwingGate(new Error('gate error')) as any);
69
69
 
70
70
  const result = await performance({}, io);
71
71
 
@@ -77,8 +77,7 @@ describe('performance command', () => {
77
77
  });
78
78
 
79
79
  it('bundleThreshold 直传 KB 到 maxBundleSize(不再按字节错位换算)', async () => {
80
- const mockCheck = jest.fn().mockResolvedValue({ passed: true, message: 'ok' });
81
- MockGate.mockImplementation(() => ({ check: mockCheck }) as any);
80
+ MockGate.mockImplementation(() => fakeGate(decide('performance', true, 'ok')) as any);
82
81
 
83
82
  await performance({ bundleThreshold: 500 }, io);
84
83
 
@@ -90,8 +89,7 @@ describe('performance command', () => {
90
89
  });
91
90
 
92
91
  it('coverage 旗帜对齐 minCoverage 字段(原 coverage 错位键名恒不生效)', async () => {
93
- const mockCheck = jest.fn().mockResolvedValue({ passed: true, message: 'ok' });
94
- MockGate.mockImplementation(() => ({ check: mockCheck }) as any);
92
+ MockGate.mockImplementation(() => fakeGate(decide('performance', true, 'ok')) as any);
95
93
 
96
94
  await performance({ coverage: true, coverageThreshold: 90 }, io);
97
95
 
@@ -5,6 +5,7 @@
5
5
  import * as fs from 'fs';
6
6
  import { captureIO, type CapturingIO } from '../../command-contract';
7
7
  import * as path from 'path';
8
+ import * as os from 'os';
8
9
 
9
10
  let io: CapturingIO;
10
11
  beforeEach(() => {
@@ -13,13 +14,14 @@ beforeEach(() => {
13
14
 
14
15
  describe('postevalPlan', () => {
15
16
  jest.setTimeout(30000); // Retry-based tests with exponential backoff need longer timeout
16
- const tempDir = path.join(process.cwd(), 'temp-test-posteval');
17
- const planPath = path.join(tempDir, 'plan.md');
17
+ let tempDir: string;
18
+ let planPath: string;
18
19
  let originalFetch: typeof fetch;
19
20
  let originalEnv: NodeJS.ProcessEnv;
20
21
 
21
22
  beforeAll(() => {
22
- fs.mkdirSync(tempDir, { recursive: true });
23
+ tempDir = fs.mkdtempSync(path.join(os.tmpdir(), 'temp-test-posteval-'));
24
+ planPath = path.join(tempDir, 'plan.md');
23
25
  fs.writeFileSync(planPath, '# Test plan\n- [AC-001] Task 1\n- [AC-002] Task 2');
24
26
  });
25
27