@dommaker/harness 1.7.0 → 1.8.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (549) hide show
  1. package/CHANGELOG.md +37 -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 +11 -3
  15. package/dist/cli/commands/check.d.ts.map +1 -1
  16. package/dist/cli/commands/check.js +26 -11
  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/sync-docs/context-syncer.d.ts +21 -2
  76. package/dist/cli/commands/sync-docs/context-syncer.d.ts.map +1 -1
  77. package/dist/cli/commands/sync-docs/context-syncer.js +112 -28
  78. package/dist/cli/commands/sync-docs/context-syncer.js.map +1 -1
  79. package/dist/cli/commands/sync-docs/index.d.ts +1 -1
  80. package/dist/cli/commands/sync-docs/index.d.ts.map +1 -1
  81. package/dist/cli/commands/sync-docs/index.js +86 -27
  82. package/dist/cli/commands/sync-docs/index.js.map +1 -1
  83. package/dist/cli/commands/sync-docs/project-reader.d.ts +24 -1
  84. package/dist/cli/commands/sync-docs/project-reader.d.ts.map +1 -1
  85. package/dist/cli/commands/sync-docs/project-reader.js +33 -7
  86. package/dist/cli/commands/sync-docs/project-reader.js.map +1 -1
  87. package/dist/cli/commands/validate.d.ts +0 -16
  88. package/dist/cli/commands/validate.d.ts.map +1 -1
  89. package/dist/cli/commands/validate.js +2 -97
  90. package/dist/cli/commands/validate.js.map +1 -1
  91. package/dist/cli/gate-command.d.ts +37 -0
  92. package/dist/cli/gate-command.d.ts.map +1 -0
  93. package/dist/cli/gate-command.js +64 -0
  94. package/dist/cli/gate-command.js.map +1 -0
  95. package/dist/completion-checkers/index.d.ts +1 -1
  96. package/dist/completion-checkers/index.d.ts.map +1 -1
  97. package/dist/completion-checkers/index.js +0 -15
  98. package/dist/completion-checkers/index.js.map +1 -1
  99. package/dist/context/knowledge-injector.d.ts +4 -2
  100. package/dist/context/knowledge-injector.d.ts.map +1 -1
  101. package/dist/context/knowledge-injector.js +13 -6
  102. package/dist/context/knowledge-injector.js.map +1 -1
  103. package/dist/core/constraints/agent-prompt-renderer.js +2 -2
  104. package/dist/core/constraints/agent-prompt-renderer.js.map +1 -1
  105. package/dist/core/constraints/capabilities-reconcile.d.ts +20 -0
  106. package/dist/core/constraints/capabilities-reconcile.d.ts.map +1 -1
  107. package/dist/core/constraints/capabilities-reconcile.js +26 -4
  108. package/dist/core/constraints/capabilities-reconcile.js.map +1 -1
  109. package/dist/core/constraints/check-cache.d.ts +1 -1
  110. package/dist/core/constraints/check-cache.js +1 -1
  111. package/dist/core/constraints/checker.d.ts +8 -3
  112. package/dist/core/constraints/checker.d.ts.map +1 -1
  113. package/dist/core/constraints/checker.js +30 -19
  114. package/dist/core/constraints/checker.js.map +1 -1
  115. package/dist/core/constraints/checkers/capability-sync.d.ts +3 -1
  116. package/dist/core/constraints/checkers/capability-sync.d.ts.map +1 -1
  117. package/dist/core/constraints/checkers/capability-sync.js +17 -24
  118. package/dist/core/constraints/checkers/capability-sync.js.map +1 -1
  119. package/dist/core/constraints/checkers/context-doc-sync.d.ts +1 -1
  120. package/dist/core/constraints/checkers/context-doc-sync.d.ts.map +1 -1
  121. package/dist/core/constraints/checkers/context-doc-sync.js +9 -6
  122. package/dist/core/constraints/checkers/context-doc-sync.js.map +1 -1
  123. package/dist/core/constraints/checkers/docs-freshness.d.ts.map +1 -1
  124. package/dist/core/constraints/checkers/docs-freshness.js +24 -30
  125. package/dist/core/constraints/checkers/docs-freshness.js.map +1 -1
  126. package/dist/core/constraints/checkers/governance-presence.d.ts.map +1 -1
  127. package/dist/core/constraints/checkers/governance-presence.js +10 -4
  128. package/dist/core/constraints/checkers/governance-presence.js.map +1 -1
  129. package/dist/core/constraints/checkers/types.d.ts +10 -6
  130. package/dist/core/constraints/checkers/types.d.ts.map +1 -1
  131. package/dist/core/constraints/checkers/types.js +7 -3
  132. package/dist/core/constraints/checkers/types.js.map +1 -1
  133. package/dist/core/constraints/context-builder.d.ts +11 -10
  134. package/dist/core/constraints/context-builder.d.ts.map +1 -1
  135. package/dist/core/constraints/context-builder.js +31 -27
  136. package/dist/core/constraints/context-builder.js.map +1 -1
  137. package/dist/core/constraints/context-reconcile.d.ts +75 -0
  138. package/dist/core/constraints/context-reconcile.d.ts.map +1 -0
  139. package/dist/core/constraints/context-reconcile.js +161 -0
  140. package/dist/core/constraints/context-reconcile.js.map +1 -0
  141. package/dist/core/constraints/doc-freshness/runner.d.ts +7 -0
  142. package/dist/core/constraints/doc-freshness/runner.d.ts.map +1 -1
  143. package/dist/core/constraints/doc-freshness/runner.js +8 -3
  144. package/dist/core/constraints/doc-freshness/runner.js.map +1 -1
  145. package/dist/core/constraints/git-evidence.js +1 -1
  146. package/dist/core/constraints/git-evidence.js.map +1 -1
  147. package/dist/core/constraints/injection-drift.d.ts +7 -2
  148. package/dist/core/constraints/injection-drift.d.ts.map +1 -1
  149. package/dist/core/constraints/injection-drift.js +13 -7
  150. package/dist/core/constraints/injection-drift.js.map +1 -1
  151. package/dist/core/constraints/run-env.d.ts +92 -0
  152. package/dist/core/constraints/run-env.d.ts.map +1 -0
  153. package/dist/core/constraints/run-env.js +175 -0
  154. package/dist/core/constraints/run-env.js.map +1 -0
  155. package/dist/core/constraints/triggers.d.ts +22 -0
  156. package/dist/core/constraints/triggers.d.ts.map +1 -0
  157. package/dist/core/constraints/triggers.js +31 -0
  158. package/dist/core/constraints/triggers.js.map +1 -0
  159. package/dist/core/effective-constraints.d.ts +13 -4
  160. package/dist/core/effective-constraints.d.ts.map +1 -1
  161. package/dist/core/effective-constraints.js +16 -6
  162. package/dist/core/effective-constraints.js.map +1 -1
  163. package/dist/core/effective-set.d.ts +8 -15
  164. package/dist/core/effective-set.d.ts.map +1 -1
  165. package/dist/core/effective-set.js +7 -12
  166. package/dist/core/effective-set.js.map +1 -1
  167. package/dist/core/index.d.ts +1 -0
  168. package/dist/core/index.d.ts.map +1 -1
  169. package/dist/core/index.js.map +1 -1
  170. package/dist/core/project-config-loader.d.ts +39 -17
  171. package/dist/core/project-config-loader.d.ts.map +1 -1
  172. package/dist/core/project-config-loader.js +51 -122
  173. package/dist/core/project-config-loader.js.map +1 -1
  174. package/dist/core/validators/check-handlers/http.d.ts +2 -2
  175. package/dist/core/validators/check-handlers/http.d.ts.map +1 -1
  176. package/dist/core/validators/check-handlers/http.js +12 -7
  177. package/dist/core/validators/check-handlers/http.js.map +1 -1
  178. package/dist/failure/classifier.d.ts +1 -1
  179. package/dist/failure/classifier.d.ts.map +1 -1
  180. package/dist/failure/classifier.js +8 -8
  181. package/dist/failure/classifier.js.map +1 -1
  182. package/dist/failure/index.d.ts +2 -1
  183. package/dist/failure/index.d.ts.map +1 -1
  184. package/dist/failure/index.js +9 -17
  185. package/dist/failure/index.js.map +1 -1
  186. package/dist/failure/recorder.d.ts +1 -1
  187. package/dist/failure/recorder.d.ts.map +1 -1
  188. package/dist/gates/checker-gate.d.ts +2 -1
  189. package/dist/gates/checker-gate.d.ts.map +1 -1
  190. package/dist/gates/checker-gate.js +3 -2
  191. package/dist/gates/checker-gate.js.map +1 -1
  192. package/dist/gates/command.d.ts +10 -4
  193. package/dist/gates/command.d.ts.map +1 -1
  194. package/dist/gates/command.js +36 -62
  195. package/dist/gates/command.js.map +1 -1
  196. package/dist/gates/contract.d.ts.map +1 -1
  197. package/dist/gates/contract.js +0 -4
  198. package/dist/gates/contract.js.map +1 -1
  199. package/dist/gates/definitions.d.ts +2 -1
  200. package/dist/gates/definitions.d.ts.map +1 -1
  201. package/dist/gates/definitions.js +6 -5
  202. package/dist/gates/definitions.js.map +1 -1
  203. package/dist/gates/index.d.ts +0 -4
  204. package/dist/gates/index.d.ts.map +1 -1
  205. package/dist/gates/index.js +1 -6
  206. package/dist/gates/index.js.map +1 -1
  207. package/dist/gates/performance.d.ts.map +1 -1
  208. package/dist/gates/performance.js +0 -4
  209. package/dist/gates/performance.js.map +1 -1
  210. package/dist/gates/runner.d.ts +1 -1
  211. package/dist/gates/runner.js +1 -1
  212. package/dist/gates/security.d.ts +1 -1
  213. package/dist/gates/security.d.ts.map +1 -1
  214. package/dist/gates/security.js +5 -6
  215. package/dist/gates/security.js.map +1 -1
  216. package/dist/gates/types.d.ts +14 -17
  217. package/dist/gates/types.d.ts.map +1 -1
  218. package/dist/gates/types.js.map +1 -1
  219. package/dist/hooks/bootstrap.d.ts +6 -4
  220. package/dist/hooks/bootstrap.d.ts.map +1 -1
  221. package/dist/hooks/bootstrap.js +25 -13
  222. package/dist/hooks/bootstrap.js.map +1 -1
  223. package/dist/hooks/config.d.ts +6 -2
  224. package/dist/hooks/config.d.ts.map +1 -1
  225. package/dist/hooks/config.js +5 -1
  226. package/dist/hooks/config.js.map +1 -1
  227. package/dist/hooks/index.d.ts +1 -1
  228. package/dist/hooks/index.d.ts.map +1 -1
  229. package/dist/hooks/index.js +0 -15
  230. package/dist/hooks/index.js.map +1 -1
  231. package/dist/hooks/pipeline.d.ts.map +1 -1
  232. package/dist/hooks/pipeline.js +2 -4
  233. package/dist/hooks/pipeline.js.map +1 -1
  234. package/dist/hooks/registry.d.ts +11 -8
  235. package/dist/hooks/registry.d.ts.map +1 -1
  236. package/dist/hooks/registry.js +22 -7
  237. package/dist/hooks/registry.js.map +1 -1
  238. package/dist/hooks/types.d.ts +23 -7
  239. package/dist/hooks/types.d.ts.map +1 -1
  240. package/dist/index.d.ts +3 -3
  241. package/dist/index.d.ts.map +1 -1
  242. package/dist/index.js +3 -4
  243. package/dist/index.js.map +1 -1
  244. package/dist/knowledge/audit-scoring.d.ts +87 -0
  245. package/dist/knowledge/audit-scoring.d.ts.map +1 -0
  246. package/dist/knowledge/audit-scoring.js +470 -0
  247. package/dist/knowledge/audit-scoring.js.map +1 -0
  248. package/dist/knowledge/audit.d.ts +11 -59
  249. package/dist/knowledge/audit.d.ts.map +1 -1
  250. package/dist/knowledge/audit.js +47 -522
  251. package/dist/knowledge/audit.js.map +1 -1
  252. package/dist/knowledge/import.d.ts.map +1 -1
  253. package/dist/knowledge/import.js +2 -0
  254. package/dist/knowledge/import.js.map +1 -1
  255. package/dist/knowledge/index-generator.d.ts.map +1 -1
  256. package/dist/knowledge/index-generator.js +4 -5
  257. package/dist/knowledge/index-generator.js.map +1 -1
  258. package/dist/knowledge/index.d.ts +3 -2
  259. package/dist/knowledge/index.d.ts.map +1 -1
  260. package/dist/knowledge/index.js +3 -16
  261. package/dist/knowledge/index.js.map +1 -1
  262. package/dist/knowledge/ingest.js +1 -1
  263. package/dist/knowledge/ingest.js.map +1 -1
  264. package/dist/knowledge/lifecycle.d.ts.map +1 -1
  265. package/dist/knowledge/lifecycle.js +4 -2
  266. package/dist/knowledge/lifecycle.js.map +1 -1
  267. package/dist/knowledge/migration.d.ts +3 -0
  268. package/dist/knowledge/migration.d.ts.map +1 -1
  269. package/dist/knowledge/migration.js +8 -2
  270. package/dist/knowledge/migration.js.map +1 -1
  271. package/dist/knowledge/query.d.ts +6 -0
  272. package/dist/knowledge/query.d.ts.map +1 -1
  273. package/dist/knowledge/query.js +8 -2
  274. package/dist/knowledge/query.js.map +1 -1
  275. package/dist/knowledge/reference-tracker.d.ts.map +1 -1
  276. package/dist/knowledge/reference-tracker.js +4 -6
  277. package/dist/knowledge/reference-tracker.js.map +1 -1
  278. package/dist/knowledge/store.d.ts +22 -16
  279. package/dist/knowledge/store.d.ts.map +1 -1
  280. package/dist/knowledge/store.js +53 -12
  281. package/dist/knowledge/store.js.map +1 -1
  282. package/dist/knowledge/tree-walker.d.ts +19 -0
  283. package/dist/knowledge/tree-walker.d.ts.map +1 -0
  284. package/dist/knowledge/tree-walker.js +30 -0
  285. package/dist/knowledge/tree-walker.js.map +1 -0
  286. package/dist/knowledge/types.d.ts +16 -0
  287. package/dist/knowledge/types.d.ts.map +1 -1
  288. package/dist/monitoring/traces.d.ts +5 -3
  289. package/dist/monitoring/traces.d.ts.map +1 -1
  290. package/dist/monitoring/traces.js +19 -5
  291. package/dist/monitoring/traces.js.map +1 -1
  292. package/dist/test-setup/jsonl-fake-fs.d.ts +30 -0
  293. package/dist/test-setup/jsonl-fake-fs.d.ts.map +1 -0
  294. package/dist/test-setup/jsonl-fake-fs.js +49 -0
  295. package/dist/test-setup/jsonl-fake-fs.js.map +1 -0
  296. package/dist/tools/index.d.ts +4 -1
  297. package/dist/tools/index.d.ts.map +1 -1
  298. package/dist/tools/index.js +7 -15
  299. package/dist/tools/index.js.map +1 -1
  300. package/dist/types/checkpoint.d.ts +5 -0
  301. package/dist/types/checkpoint.d.ts.map +1 -1
  302. package/dist/types/project-config.d.ts +18 -0
  303. package/dist/types/project-config.d.ts.map +1 -1
  304. package/dist/types/trace.d.ts +13 -4
  305. package/dist/types/trace.d.ts.map +1 -1
  306. package/dist/types/trace.js +4 -3
  307. package/dist/types/trace.js.map +1 -1
  308. package/dist/utils/exec.d.ts +4 -27
  309. package/dist/utils/exec.d.ts.map +1 -1
  310. package/dist/utils/exec.js +4 -94
  311. package/dist/utils/exec.js.map +1 -1
  312. package/dist/utils/jsonl.d.ts +17 -7
  313. package/dist/utils/jsonl.d.ts.map +1 -1
  314. package/dist/utils/jsonl.js +144 -17
  315. package/dist/utils/jsonl.js.map +1 -1
  316. package/dist/utils/numeric-flag.d.ts +44 -0
  317. package/dist/utils/numeric-flag.d.ts.map +1 -0
  318. package/dist/utils/numeric-flag.js +62 -0
  319. package/dist/utils/numeric-flag.js.map +1 -0
  320. package/package.json +1 -1
  321. package/src/CONTEXT.md +5 -2
  322. package/src/__tests__/acceptance-gate.test.ts +7 -4
  323. package/src/__tests__/checker-extra.test.ts +3 -2
  324. package/src/__tests__/checker.test.ts +4 -3
  325. package/src/__tests__/checkpoint.test.ts +26 -9
  326. package/src/__tests__/context-files-resolution.test.ts +29 -15
  327. package/src/__tests__/contract-gate.test.ts +19 -40
  328. package/src/__tests__/error-classifier.test.ts +1 -1
  329. package/src/__tests__/exec.test.ts +45 -107
  330. package/src/__tests__/failure-recorder.test.ts +7 -5
  331. package/src/__tests__/hooks-pipeline.test.ts +34 -47
  332. package/src/__tests__/layering.test.ts +217 -25
  333. package/src/__tests__/passes-gate.test.ts +9 -4
  334. package/src/__tests__/performance-gate.test.ts +3 -15
  335. package/src/__tests__/project-config-loader-extra.test.ts +31 -57
  336. package/src/__tests__/project-config-loader.test.ts +6 -3
  337. package/src/__tests__/public-exports.test.ts +0 -1
  338. package/src/__tests__/public-type-surface.test.ts +5 -4
  339. package/src/__tests__/public-value-surface.test.ts +182 -0
  340. package/src/__tests__/review-gate.test.ts +4 -6
  341. package/src/__tests__/security-gate.test.ts +5 -20
  342. package/src/__tests__/skip-semantics.test.ts +5 -3
  343. package/src/__tests__/spec-validator.test.ts +3 -2
  344. package/src/__tests__/sub-barrels-explicit.test.ts +87 -0
  345. package/src/__tests__/test-fixture-hygiene.test.ts +53 -0
  346. package/src/__tests__/trace-analyzer-extra.test.ts +5 -3
  347. package/src/__tests__/trace-analyzer.test.ts +5 -3
  348. package/src/__tests__/trace-collector.test.ts +5 -3
  349. package/src/agents/index.ts +13 -2
  350. package/src/cli/__tests__/gate-command.test.ts +162 -0
  351. package/src/cli/commands/CONTEXT.md +29 -5
  352. package/src/cli/commands/__tests__/acceptance.test.ts +24 -25
  353. package/src/cli/commands/__tests__/bin-exit-mapping.test.ts +15 -0
  354. package/src/cli/commands/__tests__/check-drift.test.ts +42 -1
  355. package/src/cli/commands/__tests__/check-read-count.test.ts +167 -0
  356. package/src/cli/commands/__tests__/check-skip-output.test.ts +4 -1
  357. package/src/cli/commands/__tests__/check.test.ts +43 -36
  358. package/src/cli/commands/__tests__/command-gate-dead-options.test.ts +60 -0
  359. package/src/cli/commands/__tests__/command.test.ts +33 -17
  360. package/src/cli/commands/__tests__/constraints-retire.test.ts +52 -0
  361. package/src/cli/commands/__tests__/context-syncer.test.ts +141 -0
  362. package/src/cli/commands/__tests__/contract.test.ts +20 -20
  363. package/src/cli/commands/__tests__/failure.test.ts +5 -4
  364. package/src/cli/commands/__tests__/gate-decision.ts +30 -0
  365. package/src/cli/commands/__tests__/init-dead-options.test.ts +50 -0
  366. package/src/cli/commands/__tests__/init-governance-io.test.ts +139 -0
  367. package/src/cli/commands/__tests__/init-injection.test.ts +3 -3
  368. package/src/cli/commands/__tests__/init-ondisk.test.ts +867 -0
  369. package/src/cli/commands/__tests__/init.test.ts +82 -6
  370. package/src/cli/commands/__tests__/knowledge-audit-threshold.test.ts +146 -0
  371. package/src/cli/commands/__tests__/knowledge-flywheel-consistency.test.ts +1 -1
  372. package/src/cli/commands/__tests__/knowledge-tone-mapping.test.ts +244 -0
  373. package/src/cli/commands/__tests__/knowledge-view.test.ts +839 -0
  374. package/src/cli/commands/__tests__/knowledge.test.ts +33 -15
  375. package/src/cli/commands/__tests__/numeric-flag-assembly.test.ts +368 -0
  376. package/src/cli/commands/__tests__/performance.test.ts +19 -21
  377. package/src/cli/commands/__tests__/posteval-plan.test.ts +5 -3
  378. package/src/cli/commands/__tests__/pre-push-hook.test.ts +181 -0
  379. package/src/cli/commands/__tests__/project-path-anchoring.test.ts +95 -2
  380. package/src/cli/commands/__tests__/project-path-convention.test.ts +103 -25
  381. package/src/cli/commands/__tests__/registry.test.ts +2 -0
  382. package/src/cli/commands/__tests__/report.test.ts +23 -1
  383. package/src/cli/commands/__tests__/review.test.ts +10 -17
  384. package/src/cli/commands/__tests__/scaffold.test.ts +505 -0
  385. package/src/cli/commands/__tests__/security-default-scan.test.ts +75 -0
  386. package/src/cli/commands/__tests__/security.test.ts +21 -24
  387. package/src/cli/commands/__tests__/spec-baseline-check.test.ts +3 -2
  388. package/src/cli/commands/__tests__/spec-baseline-index-cap.test.ts +131 -0
  389. package/src/cli/commands/__tests__/spec-baseline-read-count.test.ts +325 -0
  390. package/src/cli/commands/__tests__/sync-docs-agents.test.ts +19 -4
  391. package/src/cli/commands/__tests__/sync-docs-context-drift.test.ts +232 -0
  392. package/src/cli/commands/__tests__/sync-docs-module-order.test.ts +111 -0
  393. package/src/cli/commands/__tests__/sync-docs-read-count.test.ts +192 -0
  394. package/src/cli/commands/__tests__/sync-docs.test.ts +3 -2
  395. package/src/cli/commands/__tests__/validate.test.ts +1 -48
  396. package/src/cli/commands/acceptance.ts +24 -29
  397. package/src/cli/commands/check.ts +40 -17
  398. package/src/cli/commands/command.ts +9 -8
  399. package/src/cli/commands/constraints-retire.ts +57 -70
  400. package/src/cli/commands/contract.ts +44 -47
  401. package/src/cli/commands/definitions.ts +12 -6
  402. package/src/cli/commands/failure.ts +16 -3
  403. package/src/cli/commands/init.ts +242 -389
  404. package/src/cli/commands/knowledge-view.ts +224 -0
  405. package/src/cli/commands/knowledge.ts +643 -448
  406. package/src/cli/commands/passes-gate.ts +12 -3
  407. package/src/cli/commands/performance.ts +31 -38
  408. package/src/cli/commands/report.ts +3 -2
  409. package/src/cli/commands/review.ts +22 -28
  410. package/src/cli/commands/scaffold-templates.ts +406 -0
  411. package/src/cli/commands/scaffold.ts +302 -0
  412. package/src/cli/commands/security.ts +27 -23
  413. package/src/cli/commands/spec-baseline-check.ts +158 -33
  414. package/src/cli/commands/sync-docs/__tests__/context-export-surface.test.ts +102 -0
  415. package/src/cli/commands/sync-docs/__tests__/module-descriptions.test.ts +196 -0
  416. package/src/cli/commands/sync-docs/context-syncer.ts +137 -31
  417. package/src/cli/commands/sync-docs/index.ts +103 -28
  418. package/src/cli/commands/sync-docs/project-reader.ts +51 -7
  419. package/src/cli/commands/validate.ts +1 -104
  420. package/src/cli/gate-command.ts +87 -0
  421. package/src/completion-checkers/index.ts +10 -1
  422. package/src/context/CONTEXT.md +2 -1
  423. package/src/context/__tests__/knowledge-injector.test.ts +27 -0
  424. package/src/context/__tests__/session-manager.test.ts +19 -12
  425. package/src/context/knowledge-injector.ts +14 -7
  426. package/src/core/CONTEXT.md +10 -7
  427. package/src/core/__tests__/effective-set.test.ts +36 -60
  428. package/src/core/constraints/__tests__/context-reconcile.test.ts +246 -0
  429. package/src/core/constraints/__tests__/run-env.test.ts +377 -0
  430. package/src/core/constraints/__tests__/triggers.test.ts +70 -0
  431. package/src/core/constraints/agent-prompt-renderer.ts +1 -1
  432. package/src/core/constraints/capabilities-reconcile.ts +28 -4
  433. package/src/core/constraints/check-cache.ts +1 -1
  434. package/src/core/constraints/checker.ts +30 -14
  435. package/src/core/constraints/checkers/__tests__/context-doc-sync.test.ts +8 -3
  436. package/src/core/constraints/checkers/__tests__/governance-presence.test.ts +16 -7
  437. package/src/core/constraints/checkers/__tests__/no-hardcoded-credentials.test.ts +2 -1
  438. package/src/core/constraints/checkers/capability-sync.ts +27 -28
  439. package/src/core/constraints/checkers/context-doc-sync.ts +9 -7
  440. package/src/core/constraints/checkers/docs-freshness.ts +28 -33
  441. package/src/core/constraints/checkers/governance-presence.ts +10 -6
  442. package/src/core/constraints/checkers/types.ts +14 -8
  443. package/src/core/constraints/context-builder.ts +35 -26
  444. package/src/core/constraints/context-reconcile.ts +200 -0
  445. package/src/core/constraints/doc-freshness/__tests__/runner.test.ts +25 -0
  446. package/src/core/constraints/doc-freshness/runner.ts +18 -4
  447. package/src/core/constraints/git-evidence.ts +1 -1
  448. package/src/core/constraints/injection-drift.ts +19 -8
  449. package/src/core/constraints/run-env.ts +207 -0
  450. package/src/core/constraints/triggers.ts +33 -0
  451. package/src/core/effective-constraints.ts +17 -6
  452. package/src/core/effective-set.ts +8 -24
  453. package/src/core/index.ts +2 -0
  454. package/src/core/project-config-loader.ts +54 -102
  455. package/src/core/validators/__tests__/http-retry-sleep.test.ts +231 -0
  456. package/src/core/validators/check-handlers/http.ts +18 -7
  457. package/src/failure/CONTEXT.md +2 -1
  458. package/src/failure/classifier.ts +2 -2
  459. package/src/failure/index.ts +14 -2
  460. package/src/failure/recorder.ts +1 -1
  461. package/src/gates/CONTEXT.md +13 -7
  462. package/src/gates/__tests__/checker-gate.test.ts +1 -1
  463. package/src/gates/__tests__/command-single-predicate.test.ts +135 -0
  464. package/src/gates/__tests__/command.test.ts +8 -15
  465. package/src/gates/__tests__/contract.test.ts +5 -5
  466. package/src/gates/__tests__/gate-interface.test.ts +0 -17
  467. package/src/gates/__tests__/performance.test.ts +0 -13
  468. package/src/gates/__tests__/review.test.ts +0 -1
  469. package/src/gates/__tests__/runner.test.ts +1 -1
  470. package/src/gates/__tests__/security-default-scan.test.ts +97 -0
  471. package/src/gates/__tests__/security.test.ts +0 -13
  472. package/src/gates/checker-gate.ts +3 -2
  473. package/src/gates/command.ts +51 -74
  474. package/src/gates/contract.ts +0 -5
  475. package/src/gates/definitions.ts +6 -5
  476. package/src/gates/index.ts +0 -5
  477. package/src/gates/performance.ts +1 -6
  478. package/src/gates/runner.ts +1 -1
  479. package/src/gates/security.ts +9 -11
  480. package/src/gates/types.ts +20 -23
  481. package/src/hooks/CONTEXT.md +10 -9
  482. package/src/hooks/__tests__/bootstrap.test.ts +29 -6
  483. package/src/hooks/__tests__/pipeline.test.ts +28 -17
  484. package/src/hooks/__tests__/registry.test.ts +51 -3
  485. package/src/hooks/bootstrap.ts +35 -15
  486. package/src/hooks/config.ts +6 -2
  487. package/src/hooks/index.ts +10 -1
  488. package/src/hooks/pipeline.ts +4 -6
  489. package/src/hooks/registry.ts +31 -12
  490. package/src/hooks/types.ts +24 -7
  491. package/src/index.ts +1 -2
  492. package/src/knowledge/CONTEXT.md +14 -7
  493. package/src/knowledge/__tests__/audit-labels.test.ts +8 -5
  494. package/src/knowledge/__tests__/audit-scoring.test.ts +230 -0
  495. package/src/knowledge/__tests__/audit-write-count.test.ts +131 -0
  496. package/src/knowledge/__tests__/audit.test.ts +291 -208
  497. package/src/knowledge/__tests__/doctor.test.ts +3 -2
  498. package/src/knowledge/__tests__/ingest.test.ts +3 -2
  499. package/src/knowledge/__tests__/lifecycle.test.ts +57 -2
  500. package/src/knowledge/__tests__/migration.test.ts +35 -6
  501. package/src/knowledge/__tests__/query.test.ts +3 -2
  502. package/src/knowledge/__tests__/reference-tracker.test.ts +23 -2
  503. package/src/knowledge/__tests__/store.test.ts +149 -4
  504. package/src/knowledge/__tests__/tree-walker.test.ts +132 -0
  505. package/src/knowledge/audit-scoring.ts +589 -0
  506. package/src/knowledge/audit.ts +55 -599
  507. package/src/knowledge/import.ts +2 -0
  508. package/src/knowledge/index-generator.ts +4 -6
  509. package/src/knowledge/index.ts +27 -2
  510. package/src/knowledge/ingest.ts +1 -1
  511. package/src/knowledge/lifecycle.ts +5 -2
  512. package/src/knowledge/migration.ts +8 -2
  513. package/src/knowledge/query.ts +8 -1
  514. package/src/knowledge/reference-tracker.ts +5 -7
  515. package/src/knowledge/store.ts +75 -16
  516. package/src/knowledge/tree-walker.ts +29 -0
  517. package/src/knowledge/types.ts +19 -0
  518. package/src/monitoring/CONTEXT.md +5 -2
  519. package/src/monitoring/__tests__/context-tracker.test.ts +16 -8
  520. package/src/monitoring/__tests__/trace-file-anchoring.test.ts +80 -0
  521. package/src/monitoring/traces.ts +19 -5
  522. package/src/release/CONTEXT.md +1 -1
  523. package/src/release/__tests__/integrity.test.ts +21 -12
  524. package/src/test-setup/__tests__/jsonl-fake-fs.test.ts +98 -0
  525. package/src/test-setup/jsonl-fake-fs.ts +59 -0
  526. package/src/tools/index.ts +5 -1
  527. package/src/types/checkpoint.ts +6 -0
  528. package/src/types/project-config.ts +21 -0
  529. package/src/types/trace.ts +14 -4
  530. package/src/utils/__tests__/file-walk.test.ts +3 -2
  531. package/src/utils/__tests__/jsonl-bounded-read.test.ts +106 -0
  532. package/src/utils/__tests__/jsonl-skip-disposition.test.ts +10 -6
  533. package/src/utils/__tests__/jsonl.test.ts +61 -14
  534. package/src/utils/__tests__/numeric-flag.test.ts +80 -0
  535. package/src/utils/__tests__/package-version.test.ts +2 -2
  536. package/src/utils/exec.ts +4 -64
  537. package/src/utils/jsonl.ts +159 -20
  538. package/src/utils/numeric-flag.ts +64 -0
  539. package/dist/failure/types.d.ts +0 -9
  540. package/dist/failure/types.d.ts.map +0 -1
  541. package/dist/failure/types.js +0 -25
  542. package/dist/failure/types.js.map +0 -1
  543. package/dist/gates/effective-gates.d.ts +0 -30
  544. package/dist/gates/effective-gates.d.ts.map +0 -1
  545. package/dist/gates/effective-gates.js +0 -81
  546. package/dist/gates/effective-gates.js.map +0 -1
  547. package/src/failure/types.ts +0 -9
  548. package/src/gates/__tests__/effective-gates.test.ts +0 -77
  549. package/src/gates/effective-gates.ts +0 -99
@@ -2,573 +2,112 @@
2
2
  /**
3
3
  * 知识库质量审计引擎
4
4
  *
5
- * 纯代码检测,零 token 成本。
6
- * 7 维度覆盖:结构完整性 / 内容质量 / 去重有效性 / 成熟度健康 / 新鲜度 / 飞轮验证 / 增量存活
5
+ * 纯代码检测,零 token 成本。打分判定(D1–D7 规则表、维度分、健康分)是纯模块
6
+ * `audit-scoring.ts`,本文件只做存储侧装配:取条目、取环境数据、落地修复动作。
7
7
  *
8
8
  * 两种模式:
9
- * - validate(entry): 单条入库检查(ingest gate
10
- * - run(autoFix): 全量扫描(日兜底 / 手动)
9
+ * - validate(entry): 单条入库检查(ingest gate),不读盘
10
+ * - run(autoFix): 全量扫描(日兜底 / 手动),修复走 store.applyAll 单次索引重写
11
11
  */
12
- var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
13
- if (k2 === undefined) k2 = k;
14
- var desc = Object.getOwnPropertyDescriptor(m, k);
15
- if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
16
- desc = { enumerable: true, get: function() { return m[k]; } };
17
- }
18
- Object.defineProperty(o, k2, desc);
19
- }) : (function(o, m, k, k2) {
20
- if (k2 === undefined) k2 = k;
21
- o[k2] = m[k];
22
- }));
23
- var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
24
- Object.defineProperty(o, "default", { enumerable: true, value: v });
25
- }) : function(o, v) {
26
- o["default"] = v;
27
- });
28
- var __importStar = (this && this.__importStar) || (function () {
29
- var ownKeys = function(o) {
30
- ownKeys = Object.getOwnPropertyNames || function (o) {
31
- var ar = [];
32
- for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
33
- return ar;
34
- };
35
- return ownKeys(o);
36
- };
37
- return function (mod) {
38
- if (mod && mod.__esModule) return mod;
39
- var result = {};
40
- if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
41
- __setModuleDefault(result, mod);
42
- return result;
43
- };
44
- })();
45
12
  Object.defineProperty(exports, "__esModule", { value: true });
46
- exports.KnowledgeAudit = exports.AUDIT_RULE_LABELS = void 0;
47
- const fs = __importStar(require("fs"));
48
- const path = __importStar(require("path"));
49
- const store_1 = require("./store");
50
- const flywheel_metrics_1 = require("./flywheel-metrics");
51
- // ── Constants ─────────────────────────────────────────────
52
- const DEFAULT_SHORT_CONTENT_THRESHOLD = 50;
53
- const ZERO_CONTENT_THRESHOLD = 20;
54
- const DEFAULT_STALE_DAYS = 90;
55
- const DEFAULT_PROMOTION_BLOCK_DAYS = 30;
56
- const MAX_SOURCE_REFS = 20;
57
- const TEST_TAG_PATTERNS = [/^test-scope-/, /^test-empty-/, /^test-\d/];
58
- const DAILY_AUDIT_PATTERN = /^\[Auditor\] Daily audit/;
59
- const EVENT_NOISE_PATTERNS = [
60
- /^\[Monitor\]\s/,
61
- /^KnowledgeSync cycle:/,
62
- /^\[Triage Fix\]\s/,
63
- /^\[Session Feature\]\s/,
64
- ];
65
- const REQUIRED_FRONTMATTER = ['id', 'type', 'title', 'maturity'];
66
- const perEntryRules = [
67
- // D1: 结构完整性
68
- {
69
- name: 'frontmatter-missing',
70
- label: 'frontmatter 缺失',
71
- severity: 'high',
72
- action: 'reject',
73
- scope: 'all',
74
- detect: (entry) => {
75
- const missing = REQUIRED_FRONTMATTER.filter(f => {
76
- const val = entry[f];
77
- return val === undefined || val === null || val === '';
78
- });
79
- if (missing.length > 0) {
80
- return `缺少必填字段: ${missing.join(', ')}`;
81
- }
82
- return null;
83
- },
84
- },
85
- // D2: 内容质量
86
- {
87
- name: 'test-data-pollution',
88
- label: '测试数据污染',
89
- severity: 'critical',
90
- action: 'archive',
91
- scope: 'active',
92
- detect: (entry) => {
93
- // Match test ID patterns
94
- if (/^(test-|inj-test)/.test(entry.id)) {
95
- return `测试 ID: "${entry.id}"`;
96
- }
97
- const hasTestTag = (entry.tags ?? []).some(t => TEST_TAG_PATTERNS.some(p => p.test(t)));
98
- if (hasTestTag) {
99
- return `测试标签: ${(entry.tags ?? []).filter(t => TEST_TAG_PATTERNS.some(p => p.test(t))).join(', ')}`;
100
- }
101
- if (/^(Test Entry|Test pattern|Test incident|Empty Test)$/i.test(entry.title.trim())) {
102
- return `测试标题: "${entry.title}"`;
103
- }
104
- return null;
105
- },
106
- },
107
- {
108
- name: 'daily-audit-noise',
109
- label: '每日审计噪音',
110
- severity: 'high',
111
- action: 'archive',
112
- scope: 'active',
113
- detect: (entry) => {
114
- if (DAILY_AUDIT_PATTERN.test(entry.title)) {
115
- return `每日审计摘要: "${entry.title}"`;
116
- }
117
- return null;
118
- },
119
- },
120
- {
121
- name: 'event-noise',
122
- label: '运维事件噪音',
123
- severity: 'critical',
124
- action: 'archive',
125
- scope: 'active',
126
- detect: (entry) => {
127
- for (const pattern of EVENT_NOISE_PATTERNS) {
128
- if (pattern.test(entry.title)) {
129
- return `运维事件标题: "${entry.title}"`;
130
- }
131
- }
132
- return null;
133
- },
134
- },
135
- {
136
- name: 'zero-content-proven',
137
- label: '零内容 proven',
138
- severity: 'critical',
139
- action: 'demote',
140
- scope: 'all',
141
- detect: (entry) => {
142
- if (entry.maturity === 'proven' && entry.content.trim().length < ZERO_CONTENT_THRESHOLD) {
143
- return `proven 条目内容仅 ${entry.content.trim().length} 字符`;
144
- }
145
- return null;
146
- },
147
- },
148
- {
149
- name: 'maturity-inflation',
150
- label: '成熟度虚高',
151
- severity: 'high',
152
- action: 'demote',
153
- scope: 'all',
154
- detect: (entry) => {
155
- if (entry.maturity === 'verified' && entry.content.trim().length < ZERO_CONTENT_THRESHOLD) {
156
- return `verified 条目内容仅 ${entry.content.trim().length} 字符`;
157
- }
158
- return null;
159
- },
160
- },
161
- {
162
- name: 'short-content',
163
- label: '短内容',
164
- severity: 'medium',
165
- action: 'flag',
166
- scope: 'active',
167
- detect: (entry, ctx) => {
168
- const len = entry.content.trim().length;
169
- if (len < ctx.shortContentThreshold && len >= ZERO_CONTENT_THRESHOLD) {
170
- return `内容 ${len} 字符 (阈值 ${ctx.shortContentThreshold})`;
171
- }
172
- return null;
173
- },
174
- },
175
- // D3: 去重有效性
176
- {
177
- name: 'title-duplicate',
178
- label: '标题重复',
179
- severity: 'medium',
180
- action: 'flag',
181
- scope: 'active',
182
- detect: (entry, ctx) => {
183
- if (!ctx.allEntries)
184
- return null;
185
- if (!entry.title)
186
- return null;
187
- const dupes = ctx.allEntries.filter(e => e.id !== entry.id &&
188
- e.maturity !== 'archived' &&
189
- e.type === entry.type &&
190
- e.title?.toLowerCase().trim() === entry.title.toLowerCase().trim());
191
- if (dupes.length > 0) {
192
- return `与 ${dupes.map(e => e.id).join(', ')} 标题重复`;
193
- }
194
- return null;
195
- },
196
- },
197
- {
198
- name: 'source-refs-bloat',
199
- label: 'sourceReferences 膨胀',
200
- severity: 'low',
201
- action: 'trim',
202
- scope: 'all',
203
- detect: (entry) => {
204
- if ((entry.sourceReferences?.length || 0) > MAX_SOURCE_REFS) {
205
- return `sourceReferences ${entry.sourceReferences.length} 条 (上限 ${MAX_SOURCE_REFS})`;
206
- }
207
- return null;
208
- },
209
- },
210
- {
211
- name: 'fragment-cluster',
212
- label: '碎片集群',
213
- severity: 'medium',
214
- action: 'flag',
215
- scope: 'active',
216
- detect: (entry, ctx) => {
217
- if (!ctx.allEntries || entry.content.trim().length >= 100)
218
- return null;
219
- if (!entry.tags?.length)
220
- return null;
221
- // Find peers: same type, short body, shared tags ≥2
222
- const entryTags = new Set(entry.tags);
223
- const peers = ctx.allEntries.filter(e => e.id !== entry.id &&
224
- e.maturity !== 'archived' &&
225
- e.type === entry.type &&
226
- e.content.trim().length < 100 &&
227
- e.tags?.filter(t => entryTags.has(t)).length >= 2);
228
- if (peers.length >= 2) {
229
- return `碎片集群:与 ${peers.map(e => e.id).join(', ')} 同 type+tags 且 body 均 <100 字符,建议合并`;
230
- }
231
- return null;
232
- },
233
- },
234
- // D4: 成熟度健康
235
- {
236
- name: 'promotion-blocked',
237
- label: 'promotion 受阻',
238
- severity: 'medium',
239
- action: 'flag',
240
- scope: 'all',
241
- detect: (entry, ctx) => {
242
- if (entry.maturity !== 'draft')
243
- return null;
244
- const created = new Date(entry.created);
245
- const daysSinceCreated = (Date.now() - created.getTime()) / (1000 * 60 * 60 * 24);
246
- if (daysSinceCreated > ctx.promotionBlockDays && !entry.lastReferenced) {
247
- return `draft 已 ${Math.floor(daysSinceCreated)} 天未被引用`;
248
- }
249
- return null;
250
- },
251
- },
252
- {
253
- name: 'orphan-draft',
254
- label: '孤儿 draft',
255
- severity: 'low',
256
- action: 'flag',
257
- scope: 'all',
258
- detect: (entry) => {
259
- if (entry.maturity !== 'draft')
260
- return null;
261
- if (entry.contributors.length === 0 && entry.projects.length === 0 && (0, flywheel_metrics_1.genuineRefs)(entry.referencedBy).length === 0) {
262
- return `draft 无贡献者/项目/引用`;
263
- }
264
- return null;
265
- },
266
- },
267
- // D5: 新鲜度
268
- {
269
- name: 'stale-entry',
270
- label: '过期条目',
271
- severity: 'medium',
272
- action: 'flag',
273
- scope: 'active',
274
- detect: (entry, ctx) => {
275
- const lastRef = entry.lastReferenced || entry.created;
276
- if (!lastRef)
277
- return null;
278
- const daysSinceRef = (Date.now() - new Date(lastRef).getTime()) / (1000 * 60 * 60 * 24);
279
- if (daysSinceRef > ctx.staleDays) {
280
- return `超过 ${Math.floor(daysSinceRef)} 天未引用 (阈值 ${ctx.staleDays})`;
281
- }
282
- return null;
283
- },
284
- },
285
- // D2b: 领域相关性 — 检测已废弃领域的残留条目
286
- {
287
- name: 'deprecated-domain',
288
- label: '废弃领域残留',
289
- severity: 'high',
290
- action: 'archive',
291
- scope: 'active',
292
- detect: (entry) => {
293
- const tags = (entry.tags ?? []).map(t => t.toLowerCase());
294
- // Tag-level: "pipeline" tag is deprecated (Studio Pipeline superseded by Agent Network)
295
- if (tags.includes('pipeline')) {
296
- return `标签 "pipeline" 属于已废弃领域(已被 Agent Network 取代)`;
297
- }
298
- // Title-level: strong domain-specific terms
299
- const title = entry.title || '';
300
- if (/pipeline|管线|GoalExecution|DeployAgent|Integration step/i.test(title)) {
301
- return `标题引用已废弃领域: "${title}"`;
302
- }
303
- return null;
304
- },
305
- },
306
- ];
307
- /** 规则 label 正本表(#109,ADR-0002 定义即注册):派生自 perEntryRules,与规则键集编译期闭环,CLI 展示层直接消费 */
308
- exports.AUDIT_RULE_LABELS = Object.fromEntries(perEntryRules.map(r => [r.name, r.label]));
309
- // ── Audit Engine ──────────────────────────────────────────
310
- /** 按 scope 决定是否评估:active 规则对 archived 条目不判定(人口过滤唯一落点) */
311
- function ruleDetail(rule, entry, ctx) {
312
- if (rule.scope === 'active' && entry.maturity === 'archived')
313
- return null;
314
- return rule.detect(entry, ctx);
13
+ exports.KnowledgeAudit = void 0;
14
+ const audit_scoring_1 = require("./audit-scoring");
15
+ /** 数值槽清单(harness#163):显式传入的脏值(NaN/±Infinity/负数)构造期抛 TypeError,不放行到打分层静默关判定 */
16
+ const NUMERIC_OPTION_SLOTS = ['shortContentThreshold', 'staleDays', 'promotionBlockDays'];
17
+ /** 守卫在 `resolveThresholds` 上游(构造期):`??` 语义不动,两处不重复兜;未传/显式 undefined 跳过,显式 0 合法 */
18
+ function assertValidThresholds(options) {
19
+ for (const slot of NUMERIC_OPTION_SLOTS) {
20
+ const value = options[slot];
21
+ if (value !== undefined && (!Number.isFinite(value) || value < 0)) {
22
+ throw new TypeError(`KnowledgeAudit: ${slot} 需为非负有限数,实参 ${value}`);
23
+ }
24
+ }
315
25
  }
316
26
  class KnowledgeAudit {
317
27
  store;
318
- shortContentThreshold;
319
- staleDays;
320
- promotionBlockDays;
321
- constructor(options) {
322
- this.store = new store_1.FileKnowledgeStore({ baseDir: options?.baseDir });
323
- this.shortContentThreshold = options?.shortContentThreshold ?? DEFAULT_SHORT_CONTENT_THRESHOLD;
324
- this.staleDays = options?.staleDays ?? DEFAULT_STALE_DAYS;
325
- this.promotionBlockDays = options?.promotionBlockDays ?? DEFAULT_PROMOTION_BLOCK_DAYS;
28
+ options;
29
+ constructor(store, options) {
30
+ if (options)
31
+ assertValidThresholds(options);
32
+ this.store = store;
33
+ this.options = options ?? {};
326
34
  }
327
35
  /**
328
36
  * 单条入库检查(ingest gate 模式)
329
37
  */
330
38
  validate(entry) {
331
- const ctx = {
332
- shortContentThreshold: this.shortContentThreshold,
333
- staleDays: this.staleDays,
334
- promotionBlockDays: this.promotionBlockDays,
335
- };
336
- return this.scanEntries([entry], ctx);
39
+ return (0, audit_scoring_1.scanEntries)([entry], this.options);
337
40
  }
338
41
  /**
339
42
  * 全量扫描(日兜底 / 手动模式)
340
43
  */
341
44
  run(options) {
342
45
  const entries = this.store.list({ excludeArchived: false }).filter(e => e.title && e.type && e.content != null);
343
- const ctx = {
344
- shortContentThreshold: this.shortContentThreshold,
345
- staleDays: this.staleDays,
346
- promotionBlockDays: this.promotionBlockDays,
347
- allEntries: entries,
348
- };
349
46
  // Per-entry issues
350
- const allIssues = this.scanEntries(entries, ctx);
351
- // Summary
352
- const summary = {};
353
- for (const rule of perEntryRules)
354
- summary[rule.name] = 0;
355
- for (const issue of allIssues)
356
- summary[issue.rule]++;
357
- // Dimension metrics
358
- const dimensions = this.computeDimensions(entries, allIssues);
47
+ const allIssues = (0, audit_scoring_1.scanEntries)(entries, this.options, entries);
48
+ // Dimension metrics(环境数据由 store 供给,打分本体零 IO)
49
+ const dimensions = (0, audit_scoring_1.computeDimensions)(entries, allIssues, this.readEnv());
359
50
  // Health score (before)
360
- const healthBefore = this.calculateHealthScore(entries, allIssues);
51
+ const healthBefore = (0, audit_scoring_1.calculateHealthScore)(entries, allIssues);
361
52
  // Auto-fix
362
53
  let autoFixed = 0;
363
54
  if (options?.autoFix) {
364
55
  autoFixed = this.applyFixes(allIssues);
365
56
  }
366
- // Health score (after)
57
+ // Health score (after)——重扫沿用修复前的人口作跨条目规则对照(现状口径,#134 不动判定)
367
58
  const entriesAfter = options?.autoFix ? this.store.list({ excludeArchived: false }) : entries;
368
- const issuesAfter = options?.autoFix ? this.scanEntries(entriesAfter, ctx) : allIssues;
369
- const healthAfter = this.calculateHealthScore(entriesAfter, issuesAfter);
59
+ const issuesAfter = options?.autoFix ? (0, audit_scoring_1.scanEntries)(entriesAfter, this.options, entries) : allIssues;
60
+ const healthAfter = (0, audit_scoring_1.calculateHealthScore)(entriesAfter, issuesAfter);
370
61
  return {
371
62
  timestamp: new Date().toISOString(),
372
63
  totalEntries: entries.length,
373
64
  issues: allIssues,
374
- summary,
65
+ summary: (0, audit_scoring_1.summarizeIssues)(allIssues),
375
66
  dimensions,
376
67
  autoFixed,
377
68
  healthScore: { before: healthBefore, after: healthAfter },
378
69
  };
379
70
  }
380
- // ── Dimensions ────────────────────────────────────────────
381
- computeDimensions(entries, issues) {
382
- const active = entries.filter(e => e.maturity !== 'archived');
383
- const now = Date.now();
384
- // D1: 结构完整性
385
- const d1Issues = issues.filter(i => i.rule === 'frontmatter-missing');
386
- const d1Score = entries.length === 0 ? 100 : Math.max(0, 100 - (d1Issues.length / entries.length) * 100);
387
- // D2: 内容质量
388
- const d2Rules = ['test-data-pollution', 'daily-audit-noise', 'event-noise', 'zero-content-proven', 'short-content', 'maturity-inflation', 'deprecated-domain'];
389
- const d2Issues = issues.filter(i => d2Rules.includes(i.rule));
390
- const d2Score = active.length === 0 ? 100 : Math.max(0, 100 - (d2Issues.length / active.length) * 100);
391
- // D3: 去重有效性
392
- const d3Rules = ['title-duplicate', 'source-refs-bloat', 'fragment-cluster'];
393
- const d3Issues = issues.filter(i => d3Rules.includes(i.rule));
394
- const d3Score = active.length === 0 ? 100 : Math.max(0, 100 - (d3Issues.length / active.length) * 100);
395
- // D4: 成熟度健康
396
- const d4Rules = ['promotion-blocked', 'orphan-draft'];
397
- const d4Issues = issues.filter(i => d4Rules.includes(i.rule));
398
- const byMaturity = {};
399
- for (const e of entries)
400
- byMaturity[e.maturity] = (byMaturity[e.maturity] || 0) + 1;
401
- const draftRatio = entries.length > 0 ? (byMaturity['draft'] || 0) / entries.length : 0;
402
- const provenRatio = entries.length > 0 ? (byMaturity['proven'] || 0) / entries.length : 0;
403
- // Penalize: draft >50% or proven <2% or proven >20% (test inflation)
404
- let d4Penalty = d4Issues.length * 2;
405
- if (draftRatio > 0.5)
406
- d4Penalty += 10;
407
- if (provenRatio < 0.02 && entries.length > 20)
408
- d4Penalty += 5;
409
- if (provenRatio > 0.2)
410
- d4Penalty += 5; // likely test inflation
411
- const d4Score = entries.length === 0 ? 100 : Math.max(0, 100 - (d4Penalty / entries.length) * 100);
412
- // D5: 新鲜度
413
- const d5Issues = issues.filter(i => i.rule === 'stale-entry');
414
- const ages = active.map(e => {
415
- const lastRef = e.lastReferenced || e.created;
416
- return lastRef ? (now - new Date(lastRef).getTime()) / (1000 * 60 * 60 * 24) : 999;
417
- });
418
- const avgAge = ages.length > 0 ? ages.reduce((a, b) => a + b, 0) / ages.length : 0;
419
- const staleRatio = active.length > 0 ? d5Issues.length / active.length : 0;
420
- const d5Score = active.length === 0 ? 100 : Math.max(0, 100 - (staleRatio * 100));
421
- // D6: 飞轮验证 —— 指标计算唯一实现在 flywheel-metrics,此处只做 fs 读取与报告层映射
422
- let dailyConsumptionEvents = 0;
423
- try {
424
- const statsPath = path.join(this.store.getBaseDir(), '.consumption-stats.json');
425
- if (fs.existsSync(statsPath)) {
426
- const stats = JSON.parse(fs.readFileSync(statsPath, 'utf-8'));
427
- dailyConsumptionEvents = stats.dailyEvents || 0;
428
- }
429
- }
430
- catch { /* best-effort */ }
431
- const metrics = (0, flywheel_metrics_1.evaluateFlywheel)({ entries: active, dailyConsumptionEvents });
432
- // Score: refCoverage * 50 + avgRefs * 20 + consumptionHitRate * 30
433
- const d6Score = Math.min(100, Math.round(metrics.refCoverage * 50 +
434
- Math.min(metrics.avgRefs / 5, 1) * 20 +
435
- metrics.consumptionHitRate * 30));
436
- return {
437
- structure: {
438
- score: Math.round(d1Score),
439
- issues: d1Issues.length,
440
- details: { invalidEntries: d1Issues.length },
441
- },
442
- content: {
443
- score: Math.round(d2Score),
444
- issues: d2Issues.length,
445
- details: {
446
- testData: issues.filter(i => i.rule === 'test-data-pollution').length,
447
- dailyAudit: issues.filter(i => i.rule === 'daily-audit-noise').length,
448
- zeroContent: issues.filter(i => i.rule === 'zero-content-proven').length,
449
- shortContent: issues.filter(i => i.rule === 'short-content').length,
450
- maturityInflation: issues.filter(i => i.rule === 'maturity-inflation').length,
451
- },
452
- },
453
- dedup: {
454
- score: Math.round(d3Score),
455
- issues: d3Issues.length,
456
- details: {
457
- titleDuplicates: issues.filter(i => i.rule === 'title-duplicate').length,
458
- sourceRefsBloat: issues.filter(i => i.rule === 'source-refs-bloat').length,
459
- },
460
- },
461
- maturity: {
462
- score: Math.round(d4Score),
463
- issues: d4Issues.length,
464
- details: {
465
- draft: byMaturity['draft'] || 0,
466
- verified: byMaturity['verified'] || 0,
467
- proven: byMaturity['proven'] || 0,
468
- archived: byMaturity['archived'] || 0,
469
- draftRatio: Math.round(draftRatio * 100),
470
- provenRatio: Math.round(provenRatio * 100),
471
- promotionBlocked: issues.filter(i => i.rule === 'promotion-blocked').length,
472
- },
473
- },
474
- freshness: {
475
- score: Math.round(d5Score),
476
- issues: d5Issues.length,
477
- details: {
478
- avgAgeDays: Math.round(avgAge),
479
- staleEntries: d5Issues.length,
480
- staleRatio: Math.round(staleRatio * 100),
481
- },
482
- },
483
- flywheel: {
484
- score: d6Score,
485
- issues: 0,
486
- details: {
487
- activeEntries: metrics.activeEntries,
488
- entriesWithRefs: metrics.entriesWithRefs,
489
- refCoverage: Math.round(metrics.refCoverage * 100),
490
- avgRefCount: Math.round(metrics.avgRefs * 10) / 10,
491
- dailyConsumptionEvents: metrics.dailyConsumptionEvents,
492
- consumptionHitRate: Math.round(metrics.consumptionHitRate * 100),
493
- },
494
- },
495
- incremental: this.computeIncremental(),
496
- };
497
- }
498
- computeIncremental() {
499
- const survival = this.store.getSurvivalRate(30);
500
- if (!survival) {
501
- return { score: 100, issues: 0, details: { note: 'no 30d snapshot available' } };
502
- }
503
- // Score = survival rate directly (80% target → 80/100)
71
+ // ── Internal ────────────────────────────────────────────
72
+ /** 打分要用的环境数据在此一次取齐(D6 消费统计、D7 快照存活) */
73
+ readEnv() {
504
74
  return {
505
- score: survival.rate,
506
- issues: survival.total - survival.survived,
507
- details: {
508
- survivalRate: survival.rate,
509
- survived: survival.survived,
510
- total: survival.total,
511
- snapshotDate: survival.snapshotDate,
512
- },
75
+ dailyConsumptionEvents: this.store.getConsumptionStats()?.dailyEvents ?? 0,
76
+ survival: this.store.getSurvivalRate(audit_scoring_1.SURVIVAL_SNAPSHOT_DAYS),
513
77
  };
514
78
  }
515
- // ── Internal ────────────────────────────────────────────
516
- /**
517
- * 逐条目跑 perEntryRules(#111 收口):validate(单条目)、run(全量)与 autoFix 重扫共用
518
- */
519
- scanEntries(entries, ctx) {
520
- const issues = [];
521
- for (const entry of entries) {
522
- for (const rule of perEntryRules) {
523
- const detail = ruleDetail(rule, entry, ctx);
524
- if (detail) {
525
- issues.push({
526
- rule: rule.name,
527
- entryId: entry.id,
528
- title: entry.title,
529
- severity: rule.severity,
530
- action: rule.action,
531
- detail,
532
- });
533
- }
534
- }
535
- }
536
- return issues;
537
- }
79
+ /** 修复动作先聚合再经 `applyAll` 落盘:一次审计只重写一次 index.json(#134) */
538
80
  applyFixes(issues) {
539
- let fixed = 0;
81
+ const updates = [];
540
82
  const processed = new Set();
541
83
  for (const issue of issues) {
542
84
  if (processed.has(issue.entryId))
543
85
  continue;
544
86
  switch (issue.action) {
545
87
  case 'archive':
546
- this.store.update(issue.entryId, { maturity: 'archived' });
88
+ updates.push({ id: issue.entryId, partial: { maturity: 'archived' } });
547
89
  processed.add(issue.entryId);
548
- fixed++;
549
90
  break;
550
91
  case 'demote':
551
- this.store.update(issue.entryId, { maturity: 'draft' });
92
+ updates.push({ id: issue.entryId, partial: { maturity: 'draft' } });
552
93
  processed.add(issue.entryId);
553
- fixed++;
554
94
  break;
555
95
  case 'flag': {
556
96
  const entry = this.store.get(issue.entryId);
557
97
  if (entry && !entry.tags.includes('low_quality')) {
558
- this.store.update(issue.entryId, { tags: [...entry.tags, 'low_quality'] });
98
+ updates.push({ id: issue.entryId, partial: { tags: [...entry.tags, 'low_quality'] } });
559
99
  processed.add(issue.entryId);
560
- fixed++;
561
100
  }
562
101
  break;
563
102
  }
564
103
  case 'trim': {
565
104
  const entry = this.store.get(issue.entryId);
566
- if (entry && entry.sourceReferences && entry.sourceReferences.length > MAX_SOURCE_REFS) {
567
- this.store.update(issue.entryId, {
568
- sourceReferences: entry.sourceReferences.slice(-MAX_SOURCE_REFS),
105
+ if (entry && entry.sourceReferences && entry.sourceReferences.length > audit_scoring_1.MAX_SOURCE_REFS) {
106
+ updates.push({
107
+ id: issue.entryId,
108
+ partial: { sourceReferences: entry.sourceReferences.slice(-audit_scoring_1.MAX_SOURCE_REFS) },
569
109
  });
570
110
  processed.add(issue.entryId);
571
- fixed++;
572
111
  }
573
112
  break;
574
113
  }
@@ -576,22 +115,8 @@ class KnowledgeAudit {
576
115
  break;
577
116
  }
578
117
  }
579
- return fixed;
580
- }
581
- calculateHealthScore(entries, issues) {
582
- if (entries.length === 0)
583
- return 100;
584
- const penalty = issues.reduce((sum, issue) => {
585
- switch (issue.severity) {
586
- case 'critical': return sum + 10;
587
- case 'high': return sum + 5;
588
- case 'medium': return sum + 2;
589
- case 'low': return sum + 1;
590
- default: return sum;
591
- }
592
- }, 0);
593
- const maxPenalty = entries.length * 10;
594
- return Math.max(0, 100 - Math.round((penalty / Math.max(maxPenalty, 1)) * 100));
118
+ this.store.applyAll(updates);
119
+ return updates.length;
595
120
  }
596
121
  }
597
122
  exports.KnowledgeAudit = KnowledgeAudit;