@dommaker/harness 0.8.3 → 0.10.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 (623) hide show
  1. package/README.md +138 -186
  2. package/bin/harness.js +123 -61
  3. package/dist/agents/index.d.ts +3 -0
  4. package/dist/agents/index.d.ts.map +1 -0
  5. package/dist/agents/index.js +19 -0
  6. package/dist/agents/index.js.map +1 -0
  7. package/dist/agents/lifecycle.d.ts +68 -0
  8. package/dist/agents/lifecycle.d.ts.map +1 -0
  9. package/dist/agents/lifecycle.js +181 -0
  10. package/dist/agents/lifecycle.js.map +1 -0
  11. package/dist/agents/types.d.ts +42 -0
  12. package/dist/agents/types.d.ts.map +1 -0
  13. package/dist/agents/types.js +6 -0
  14. package/dist/agents/types.js.map +1 -0
  15. package/dist/architecture/constraint-engine.d.ts +18 -0
  16. package/dist/architecture/constraint-engine.d.ts.map +1 -1
  17. package/dist/architecture/constraint-engine.js +101 -9
  18. package/dist/architecture/constraint-engine.js.map +1 -1
  19. package/dist/architecture/cross-project-checker.d.ts +19 -1
  20. package/dist/architecture/cross-project-checker.d.ts.map +1 -1
  21. package/dist/architecture/cross-project-checker.js +242 -80
  22. package/dist/architecture/cross-project-checker.js.map +1 -1
  23. package/dist/cli/commands/acceptance.d.ts.map +1 -1
  24. package/dist/cli/commands/acceptance.js +1 -0
  25. package/dist/cli/commands/acceptance.js.map +1 -1
  26. package/dist/cli/commands/check.d.ts.map +1 -1
  27. package/dist/cli/commands/check.js +184 -75
  28. package/dist/cli/commands/check.js.map +1 -1
  29. package/dist/cli/commands/command.d.ts +10 -3
  30. package/dist/cli/commands/command.d.ts.map +1 -1
  31. package/dist/cli/commands/command.js +7 -71
  32. package/dist/cli/commands/command.js.map +1 -1
  33. package/dist/cli/commands/failure.d.ts +28 -0
  34. package/dist/cli/commands/failure.d.ts.map +1 -0
  35. package/dist/cli/commands/failure.js +132 -0
  36. package/dist/cli/commands/failure.js.map +1 -0
  37. package/dist/cli/commands/flow.d.ts +2 -0
  38. package/dist/cli/commands/flow.d.ts.map +1 -1
  39. package/dist/cli/commands/flow.js +38 -3
  40. package/dist/cli/commands/flow.js.map +1 -1
  41. package/dist/cli/commands/index.d.ts +4 -1
  42. package/dist/cli/commands/index.d.ts.map +1 -1
  43. package/dist/cli/commands/index.js +14 -3
  44. package/dist/cli/commands/index.js.map +1 -1
  45. package/dist/cli/commands/init.d.ts +2 -0
  46. package/dist/cli/commands/init.d.ts.map +1 -1
  47. package/dist/cli/commands/init.js +251 -1
  48. package/dist/cli/commands/init.js.map +1 -1
  49. package/dist/cli/commands/knowledge.d.ts +41 -0
  50. package/dist/cli/commands/knowledge.d.ts.map +1 -0
  51. package/dist/cli/commands/knowledge.js +195 -0
  52. package/dist/cli/commands/knowledge.js.map +1 -0
  53. package/dist/cli/commands/passes-gate.d.ts.map +1 -1
  54. package/dist/cli/commands/passes-gate.js +2 -4
  55. package/dist/cli/commands/passes-gate.js.map +1 -1
  56. package/dist/cli/commands/report.d.ts +1 -1
  57. package/dist/cli/commands/report.d.ts.map +1 -1
  58. package/dist/cli/commands/report.js +57 -70
  59. package/dist/cli/commands/report.js.map +1 -1
  60. package/dist/cli/commands/review.d.ts.map +1 -1
  61. package/dist/cli/commands/review.js +27 -63
  62. package/dist/cli/commands/review.js.map +1 -1
  63. package/dist/cli/commands/security.d.ts +1 -1
  64. package/dist/cli/commands/security.d.ts.map +1 -1
  65. package/dist/cli/commands/security.js +42 -82
  66. package/dist/cli/commands/security.js.map +1 -1
  67. package/dist/cli/commands/status.d.ts.map +1 -1
  68. package/dist/cli/commands/status.js +2 -2
  69. package/dist/cli/commands/status.js.map +1 -1
  70. package/dist/cli/commands/sync-docs.d.ts +21 -0
  71. package/dist/cli/commands/sync-docs.d.ts.map +1 -0
  72. package/dist/cli/commands/sync-docs.js +564 -0
  73. package/dist/cli/commands/sync-docs.js.map +1 -0
  74. package/dist/constraints/definitions.d.ts +39 -0
  75. package/dist/constraints/definitions.d.ts.map +1 -0
  76. package/dist/constraints/definitions.js +71 -0
  77. package/dist/constraints/definitions.js.map +1 -0
  78. package/dist/constraints/index.d.ts +4 -0
  79. package/dist/constraints/index.d.ts.map +1 -0
  80. package/dist/constraints/index.js +20 -0
  81. package/dist/constraints/index.js.map +1 -0
  82. package/dist/constraints/lifecycle-runner.d.ts +52 -0
  83. package/dist/constraints/lifecycle-runner.d.ts.map +1 -0
  84. package/dist/constraints/lifecycle-runner.js +151 -0
  85. package/dist/constraints/lifecycle-runner.js.map +1 -0
  86. package/dist/constraints/quality.d.ts +11 -0
  87. package/dist/constraints/quality.d.ts.map +1 -0
  88. package/dist/constraints/quality.js +257 -0
  89. package/dist/constraints/quality.js.map +1 -0
  90. package/dist/constraints/registry.d.ts +26 -0
  91. package/dist/constraints/registry.d.ts.map +1 -0
  92. package/dist/constraints/registry.js +128 -0
  93. package/dist/constraints/registry.js.map +1 -0
  94. package/dist/constraints/safety.d.ts +13 -0
  95. package/dist/constraints/safety.d.ts.map +1 -0
  96. package/dist/constraints/safety.js +103 -0
  97. package/dist/constraints/safety.js.map +1 -0
  98. package/dist/constraints/types.d.ts +53 -0
  99. package/dist/constraints/types.d.ts.map +1 -0
  100. package/dist/constraints/types.js +8 -0
  101. package/dist/constraints/types.js.map +1 -0
  102. package/dist/context/compaction.d.ts +57 -0
  103. package/dist/context/compaction.d.ts.map +1 -0
  104. package/dist/context/compaction.js +166 -0
  105. package/dist/context/compaction.js.map +1 -0
  106. package/dist/context/file-budget.d.ts +40 -0
  107. package/dist/context/file-budget.d.ts.map +1 -0
  108. package/dist/context/file-budget.js +147 -0
  109. package/dist/context/file-budget.js.map +1 -0
  110. package/dist/context/index.d.ts +15 -0
  111. package/dist/context/index.d.ts.map +1 -0
  112. package/dist/context/index.js +31 -0
  113. package/dist/context/index.js.map +1 -0
  114. package/dist/context/knowledge-injector.d.ts +49 -0
  115. package/dist/context/knowledge-injector.d.ts.map +1 -0
  116. package/dist/context/knowledge-injector.js +122 -0
  117. package/dist/context/knowledge-injector.js.map +1 -0
  118. package/dist/context/progressive-loader.d.ts +0 -1
  119. package/dist/context/progressive-loader.d.ts.map +1 -1
  120. package/dist/context/progressive-loader.js +15 -32
  121. package/dist/context/progressive-loader.js.map +1 -1
  122. package/dist/context/session-manager.d.ts +67 -0
  123. package/dist/context/session-manager.d.ts.map +1 -0
  124. package/dist/context/session-manager.js +275 -0
  125. package/dist/context/session-manager.js.map +1 -0
  126. package/dist/context/token-pipeline.d.ts +55 -0
  127. package/dist/context/token-pipeline.d.ts.map +1 -0
  128. package/dist/context/token-pipeline.js +220 -0
  129. package/dist/context/token-pipeline.js.map +1 -0
  130. package/dist/context/tool-output-budget.d.ts +59 -0
  131. package/dist/context/tool-output-budget.d.ts.map +1 -0
  132. package/dist/context/tool-output-budget.js +177 -0
  133. package/dist/context/tool-output-budget.js.map +1 -0
  134. package/dist/context/types.d.ts +113 -0
  135. package/dist/context/types.d.ts.map +1 -0
  136. package/dist/context/types.js +30 -0
  137. package/dist/context/types.js.map +1 -0
  138. package/dist/core/constraints/checker.d.ts +25 -1
  139. package/dist/core/constraints/checker.d.ts.map +1 -1
  140. package/dist/core/constraints/checker.js +244 -162
  141. package/dist/core/constraints/checker.js.map +1 -1
  142. package/dist/core/constraints/default-executors.d.ts +10 -0
  143. package/dist/core/constraints/default-executors.d.ts.map +1 -0
  144. package/dist/core/constraints/default-executors.js +120 -0
  145. package/dist/core/constraints/default-executors.js.map +1 -0
  146. package/dist/core/constraints/definitions.d.ts.map +1 -1
  147. package/dist/core/constraints/definitions.js +92 -10
  148. package/dist/core/constraints/definitions.js.map +1 -1
  149. package/dist/core/constraints/interceptor.d.ts.map +1 -1
  150. package/dist/core/constraints/interceptor.js +5 -6
  151. package/dist/core/constraints/interceptor.js.map +1 -1
  152. package/dist/core/project-config-loader.d.ts.map +1 -1
  153. package/dist/core/project-config-loader.js +12 -30
  154. package/dist/core/project-config-loader.js.map +1 -1
  155. package/dist/core/session/clean-state.d.ts.map +1 -1
  156. package/dist/core/session/clean-state.js +9 -7
  157. package/dist/core/session/clean-state.js.map +1 -1
  158. package/dist/core/session/startup.d.ts.map +1 -1
  159. package/dist/core/session/startup.js +3 -5
  160. package/dist/core/session/startup.js.map +1 -1
  161. package/dist/core/spec/validator.d.ts.map +1 -1
  162. package/dist/core/spec/validator.js +2 -4
  163. package/dist/core/spec/validator.js.map +1 -1
  164. package/dist/core/validators/checkpoint.d.ts.map +1 -1
  165. package/dist/core/validators/checkpoint.js +3 -5
  166. package/dist/core/validators/checkpoint.js.map +1 -1
  167. package/dist/core/validators/passes-gate.d.ts +0 -4
  168. package/dist/core/validators/passes-gate.d.ts.map +1 -1
  169. package/dist/core/validators/passes-gate.js +5 -13
  170. package/dist/core/validators/passes-gate.js.map +1 -1
  171. package/dist/dashboard/data.d.ts +39 -0
  172. package/dist/dashboard/data.d.ts.map +1 -0
  173. package/dist/dashboard/data.js +89 -0
  174. package/dist/dashboard/data.js.map +1 -0
  175. package/dist/dashboard/index.d.ts +4 -0
  176. package/dist/dashboard/index.d.ts.map +1 -0
  177. package/dist/dashboard/index.js +20 -0
  178. package/dist/dashboard/index.js.map +1 -0
  179. package/dist/dashboard/stats.d.ts +20 -0
  180. package/dist/dashboard/stats.d.ts.map +1 -0
  181. package/dist/dashboard/stats.js +115 -0
  182. package/dist/dashboard/stats.js.map +1 -0
  183. package/dist/dashboard/types.d.ts +98 -0
  184. package/dist/dashboard/types.d.ts.map +1 -0
  185. package/dist/dashboard/types.js +8 -0
  186. package/dist/dashboard/types.js.map +1 -0
  187. package/dist/failure/recorder.d.ts +4 -0
  188. package/dist/failure/recorder.d.ts.map +1 -1
  189. package/dist/failure/recorder.js +9 -11
  190. package/dist/failure/recorder.js.map +1 -1
  191. package/dist/gates/acceptance.d.ts.map +1 -1
  192. package/dist/gates/acceptance.js +2 -4
  193. package/dist/gates/acceptance.js.map +1 -1
  194. package/dist/gates/contract.d.ts.map +1 -1
  195. package/dist/gates/contract.js +0 -3
  196. package/dist/gates/contract.js.map +1 -1
  197. package/dist/gates/performance.d.ts.map +1 -1
  198. package/dist/gates/performance.js +3 -5
  199. package/dist/gates/performance.js.map +1 -1
  200. package/dist/gates/review.d.ts.map +1 -1
  201. package/dist/gates/review.js +4 -6
  202. package/dist/gates/review.js.map +1 -1
  203. package/dist/gates/security.d.ts.map +1 -1
  204. package/dist/gates/security.js +2 -4
  205. package/dist/gates/security.js.map +1 -1
  206. package/dist/governance/executor.d.ts +45 -0
  207. package/dist/governance/executor.d.ts.map +1 -0
  208. package/dist/governance/executor.js +237 -0
  209. package/dist/governance/executor.js.map +1 -0
  210. package/dist/governance/index.d.ts +9 -0
  211. package/dist/governance/index.d.ts.map +1 -0
  212. package/dist/governance/index.js +13 -0
  213. package/dist/governance/index.js.map +1 -0
  214. package/dist/governance/types.d.ts +46 -0
  215. package/dist/governance/types.d.ts.map +1 -0
  216. package/dist/governance/types.js +9 -0
  217. package/dist/governance/types.js.map +1 -0
  218. package/dist/index.d.ts +28 -7
  219. package/dist/index.d.ts.map +1 -1
  220. package/dist/index.js +56 -14
  221. package/dist/index.js.map +1 -1
  222. package/dist/knowledge/import.d.ts +95 -0
  223. package/dist/knowledge/import.d.ts.map +1 -0
  224. package/dist/knowledge/import.js +429 -0
  225. package/dist/knowledge/import.js.map +1 -0
  226. package/dist/knowledge/index.d.ts +15 -0
  227. package/dist/knowledge/index.d.ts.map +1 -0
  228. package/dist/knowledge/index.js +40 -0
  229. package/dist/knowledge/index.js.map +1 -0
  230. package/dist/knowledge/ingest.d.ts +30 -0
  231. package/dist/knowledge/ingest.d.ts.map +1 -0
  232. package/dist/knowledge/ingest.js +94 -0
  233. package/dist/knowledge/ingest.js.map +1 -0
  234. package/dist/knowledge/lifecycle-hooks.d.ts +62 -0
  235. package/dist/knowledge/lifecycle-hooks.d.ts.map +1 -0
  236. package/dist/knowledge/lifecycle-hooks.js +140 -0
  237. package/dist/knowledge/lifecycle-hooks.js.map +1 -0
  238. package/dist/knowledge/lifecycle.d.ts +43 -0
  239. package/dist/knowledge/lifecycle.d.ts.map +1 -0
  240. package/dist/knowledge/lifecycle.js +141 -0
  241. package/dist/knowledge/lifecycle.js.map +1 -0
  242. package/dist/knowledge/lint.d.ts +57 -0
  243. package/dist/knowledge/lint.d.ts.map +1 -0
  244. package/dist/knowledge/lint.js +235 -0
  245. package/dist/knowledge/lint.js.map +1 -0
  246. package/dist/knowledge/query.d.ts +33 -0
  247. package/dist/knowledge/query.d.ts.map +1 -0
  248. package/dist/knowledge/query.js +107 -0
  249. package/dist/knowledge/query.js.map +1 -0
  250. package/dist/knowledge/reference-tracker.d.ts +31 -0
  251. package/dist/knowledge/reference-tracker.d.ts.map +1 -0
  252. package/dist/knowledge/reference-tracker.js +124 -0
  253. package/dist/knowledge/reference-tracker.js.map +1 -0
  254. package/dist/knowledge/store.d.ts +42 -0
  255. package/dist/knowledge/store.d.ts.map +1 -0
  256. package/dist/knowledge/store.js +280 -0
  257. package/dist/knowledge/store.js.map +1 -0
  258. package/dist/knowledge/types.d.ts +103 -0
  259. package/dist/knowledge/types.d.ts.map +1 -0
  260. package/dist/knowledge/types.js +17 -0
  261. package/dist/knowledge/types.js.map +1 -0
  262. package/dist/llm/adapter.d.ts +36 -0
  263. package/dist/llm/adapter.d.ts.map +1 -0
  264. package/dist/llm/adapter.js +118 -0
  265. package/dist/llm/adapter.js.map +1 -0
  266. package/dist/llm/index.d.ts +3 -0
  267. package/dist/llm/index.d.ts.map +1 -0
  268. package/dist/llm/index.js +19 -0
  269. package/dist/llm/index.js.map +1 -0
  270. package/dist/llm/types.d.ts +62 -0
  271. package/dist/llm/types.d.ts.map +1 -0
  272. package/dist/llm/types.js +8 -0
  273. package/dist/llm/types.js.map +1 -0
  274. package/dist/monitoring/constraint-doctor.d.ts +16 -3
  275. package/dist/monitoring/constraint-doctor.d.ts.map +1 -1
  276. package/dist/monitoring/constraint-doctor.js +84 -9
  277. package/dist/monitoring/constraint-doctor.js.map +1 -1
  278. package/dist/monitoring/context-tracker.d.ts +38 -0
  279. package/dist/monitoring/context-tracker.d.ts.map +1 -0
  280. package/dist/monitoring/context-tracker.js +162 -0
  281. package/dist/monitoring/context-tracker.js.map +1 -0
  282. package/dist/monitoring/index.d.ts +3 -0
  283. package/dist/monitoring/index.d.ts.map +1 -1
  284. package/dist/monitoring/index.js +6 -0
  285. package/dist/monitoring/index.js.map +1 -1
  286. package/dist/monitoring/knowledge-doctor.d.ts +78 -0
  287. package/dist/monitoring/knowledge-doctor.d.ts.map +1 -0
  288. package/dist/monitoring/knowledge-doctor.js +266 -0
  289. package/dist/monitoring/knowledge-doctor.js.map +1 -0
  290. package/dist/monitoring/knowledge-evolver.d.ts +72 -0
  291. package/dist/monitoring/knowledge-evolver.d.ts.map +1 -0
  292. package/dist/monitoring/knowledge-evolver.js +205 -0
  293. package/dist/monitoring/knowledge-evolver.js.map +1 -0
  294. package/dist/monitoring/performance-analyzer.d.ts.map +1 -1
  295. package/dist/monitoring/performance-analyzer.js +10 -4
  296. package/dist/monitoring/performance-analyzer.js.map +1 -1
  297. package/dist/monitoring/trace-analyzer.d.ts.map +1 -1
  298. package/dist/monitoring/trace-analyzer.js +12 -5
  299. package/dist/monitoring/trace-analyzer.js.map +1 -1
  300. package/dist/safety/index.d.ts +6 -0
  301. package/dist/safety/index.d.ts.map +1 -0
  302. package/dist/safety/index.js +22 -0
  303. package/dist/safety/index.js.map +1 -0
  304. package/dist/safety/input-guardrail.d.ts +36 -0
  305. package/dist/safety/input-guardrail.d.ts.map +1 -0
  306. package/dist/safety/input-guardrail.js +118 -0
  307. package/dist/safety/input-guardrail.js.map +1 -0
  308. package/dist/safety/output-guardrail.d.ts +40 -0
  309. package/dist/safety/output-guardrail.d.ts.map +1 -0
  310. package/dist/safety/output-guardrail.js +150 -0
  311. package/dist/safety/output-guardrail.js.map +1 -0
  312. package/dist/safety/sandbox.d.ts +45 -0
  313. package/dist/safety/sandbox.d.ts.map +1 -0
  314. package/dist/safety/sandbox.js +134 -0
  315. package/dist/safety/sandbox.js.map +1 -0
  316. package/dist/safety/tool-guardrail.d.ts +51 -0
  317. package/dist/safety/tool-guardrail.d.ts.map +1 -0
  318. package/dist/safety/tool-guardrail.js +147 -0
  319. package/dist/safety/tool-guardrail.js.map +1 -0
  320. package/dist/safety/types.d.ts +104 -0
  321. package/dist/safety/types.d.ts.map +1 -0
  322. package/dist/safety/types.js +6 -0
  323. package/dist/safety/types.js.map +1 -0
  324. package/dist/tools/core/index.d.ts +13 -0
  325. package/dist/tools/core/index.d.ts.map +1 -0
  326. package/dist/tools/core/index.js +198 -0
  327. package/dist/tools/core/index.js.map +1 -0
  328. package/dist/tools/definitions/core/code/fingerprint.sh +273 -0
  329. package/dist/tools/definitions/core/code/fingerprint.yml +72 -0
  330. package/dist/tools/definitions/core/code/parse.yml +68 -0
  331. package/dist/tools/definitions/core/code/register-language.sh +475 -0
  332. package/dist/tools/definitions/core/code/register-language.yml +74 -0
  333. package/dist/tools/definitions/core/docker/build.yml +73 -0
  334. package/dist/tools/definitions/core/docker/run.yml +81 -0
  335. package/dist/tools/definitions/core/file/copy.yml +88 -0
  336. package/dist/tools/definitions/core/file/read.yml +69 -0
  337. package/dist/tools/definitions/core/file/write.yml +75 -0
  338. package/dist/tools/definitions/core/git/branch.yml +61 -0
  339. package/dist/tools/definitions/core/git/cleanup-worktree.yml +50 -0
  340. package/dist/tools/definitions/core/git/clone.yml +69 -0
  341. package/dist/tools/definitions/core/git/commit.yml +65 -0
  342. package/dist/tools/definitions/core/git/push.yml +79 -0
  343. package/dist/tools/definitions/core/git/worktree.yml +96 -0
  344. package/dist/tools/definitions/core/notification/notify.sh +152 -0
  345. package/dist/tools/definitions/core/notification/notify.yml +60 -0
  346. package/dist/tools/definitions/core/npm/build.yml +75 -0
  347. package/dist/tools/definitions/core/npm/install.yml +58 -0
  348. package/dist/tools/definitions/core/npm/test.yml +75 -0
  349. package/dist/tools/definitions/core/validation/check-reuse.yml +170 -0
  350. package/dist/tools/definitions/core/validation/validate-handlers.yml +118 -0
  351. package/dist/tools/definitions/core/validation/validate-readme-stats.yml +155 -0
  352. package/dist/tools/definitions/core/validation/validate-yaml-syntax.yml +134 -0
  353. package/dist/tools/definitions/definitions/core/code/fingerprint.sh +273 -0
  354. package/dist/tools/definitions/definitions/core/code/fingerprint.yml +72 -0
  355. package/dist/tools/definitions/definitions/core/code/parse.yml +68 -0
  356. package/dist/tools/definitions/definitions/core/code/register-language.sh +475 -0
  357. package/dist/tools/definitions/definitions/core/code/register-language.yml +74 -0
  358. package/dist/tools/definitions/definitions/core/docker/build.yml +73 -0
  359. package/dist/tools/definitions/definitions/core/docker/run.yml +81 -0
  360. package/dist/tools/definitions/definitions/core/file/copy.yml +88 -0
  361. package/dist/tools/definitions/definitions/core/file/read.yml +69 -0
  362. package/dist/tools/definitions/definitions/core/file/write.yml +75 -0
  363. package/dist/tools/definitions/definitions/core/git/branch.yml +61 -0
  364. package/dist/tools/definitions/definitions/core/git/cleanup-worktree.yml +50 -0
  365. package/dist/tools/definitions/definitions/core/git/clone.yml +69 -0
  366. package/dist/tools/definitions/definitions/core/git/commit.yml +65 -0
  367. package/dist/tools/definitions/definitions/core/git/push.yml +79 -0
  368. package/dist/tools/definitions/definitions/core/git/worktree.yml +96 -0
  369. package/dist/tools/definitions/definitions/core/notification/notify.sh +152 -0
  370. package/dist/tools/definitions/definitions/core/notification/notify.yml +60 -0
  371. package/dist/tools/definitions/definitions/core/npm/build.yml +75 -0
  372. package/dist/tools/definitions/definitions/core/npm/install.yml +58 -0
  373. package/dist/tools/definitions/definitions/core/npm/test.yml +75 -0
  374. package/dist/tools/definitions/definitions/core/validation/check-reuse.yml +170 -0
  375. package/dist/tools/definitions/definitions/core/validation/validate-handlers.yml +118 -0
  376. package/dist/tools/definitions/definitions/core/validation/validate-readme-stats.yml +155 -0
  377. package/dist/tools/definitions/definitions/core/validation/validate-yaml-syntax.yml +134 -0
  378. package/dist/tools/definitions/definitions/ext/browser/browser-automate.sh +255 -0
  379. package/dist/tools/definitions/definitions/ext/browser/browser-automate.yml +166 -0
  380. package/dist/tools/definitions/definitions/ext/browser/browser-close.sh +104 -0
  381. package/dist/tools/definitions/definitions/ext/browser/browser-close.yml +55 -0
  382. package/dist/tools/definitions/definitions/ext/browser/browser-mcp-debug.sh +682 -0
  383. package/dist/tools/definitions/definitions/ext/browser/browser-mcp-debug.yml +167 -0
  384. package/dist/tools/definitions/definitions/ext/browser/browser-start.sh +101 -0
  385. package/dist/tools/definitions/definitions/ext/browser/browser-start.yml +62 -0
  386. package/dist/tools/definitions/definitions/registry.json +795 -0
  387. package/dist/tools/definitions/definitions/std/README.md +350 -0
  388. package/dist/tools/definitions/definitions/std/analysis/analyze-codebase.yml +72 -0
  389. package/dist/tools/definitions/definitions/std/analysis/analyze-diff.yml +182 -0
  390. package/dist/tools/definitions/definitions/std/analysis/analyze-git-diff.yml +70 -0
  391. package/dist/tools/definitions/definitions/std/analysis/analyze-impact.yml +78 -0
  392. package/dist/tools/definitions/definitions/std/analysis/analyze-requirements.yml +105 -0
  393. package/dist/tools/definitions/definitions/std/analysis/brainstorm-options.yml +106 -0
  394. package/dist/tools/definitions/definitions/std/analysis/build-graph.yml +154 -0
  395. package/dist/tools/definitions/definitions/std/analysis/clarify-requirements.yml +90 -0
  396. package/dist/tools/definitions/definitions/std/analysis/detect-context.yml +109 -0
  397. package/dist/tools/definitions/definitions/std/analysis/detect-layers.yml +125 -0
  398. package/dist/tools/definitions/definitions/std/analysis/generate-tour.yml +102 -0
  399. package/dist/tools/definitions/definitions/std/analysis/search-enhance.yml +105 -0
  400. package/dist/tools/definitions/definitions/std/backlog/add.yml +51 -0
  401. package/dist/tools/definitions/definitions/std/backlog/decide.yml +39 -0
  402. package/dist/tools/definitions/definitions/std/backlog/github-sync.yml +161 -0
  403. package/dist/tools/definitions/definitions/std/backlog/list.yml +53 -0
  404. package/dist/tools/definitions/definitions/std/backlog/load.yml +46 -0
  405. package/dist/tools/definitions/definitions/std/backlog/resolve.yml +37 -0
  406. package/dist/tools/definitions/definitions/std/backlog/update.yml +42 -0
  407. package/dist/tools/definitions/definitions/std/bugfix/diagnose.yml +68 -0
  408. package/dist/tools/definitions/definitions/std/bugfix/fix.yml +66 -0
  409. package/dist/tools/definitions/definitions/std/bugfix/verify.yml +69 -0
  410. package/dist/tools/definitions/definitions/std/constraint/check-decomposition.yml +103 -0
  411. package/dist/tools/definitions/definitions/std/constraint/check-feature-list.yml +77 -0
  412. package/dist/tools/definitions/definitions/std/constraint/check-progress.yml +97 -0
  413. package/dist/tools/definitions/definitions/std/constraint/generate-report.yml +147 -0
  414. package/dist/tools/definitions/definitions/std/deploy/commit-push.yml +33 -0
  415. package/dist/tools/definitions/definitions/std/deploy/deploy-backend.yml +37 -0
  416. package/dist/tools/definitions/definitions/std/deploy/deploy-frontend.yml +37 -0
  417. package/dist/tools/definitions/definitions/std/deploy/rollback.yml +148 -0
  418. package/dist/tools/definitions/definitions/std/design/analyze-architecture-impact.yml +113 -0
  419. package/dist/tools/definitions/definitions/std/design/design-api.yml +55 -0
  420. package/dist/tools/definitions/definitions/std/design/design-architecture.yml +97 -0
  421. package/dist/tools/definitions/definitions/std/design/design-db.yml +81 -0
  422. package/dist/tools/definitions/definitions/std/design/generate-spec.yml +182 -0
  423. package/dist/tools/definitions/definitions/std/development/develop-api.yml +85 -0
  424. package/dist/tools/definitions/definitions/std/development/develop-backend.yml +88 -0
  425. package/dist/tools/definitions/definitions/std/development/develop-frontend.yml +87 -0
  426. package/dist/tools/definitions/definitions/std/development/develop-shared-types.yml +74 -0
  427. package/dist/tools/definitions/definitions/std/development/develop-task.yml +122 -0
  428. package/dist/tools/definitions/definitions/std/development/develop-tests.yml +76 -0
  429. package/dist/tools/definitions/definitions/std/development/execute-batch.yml +152 -0
  430. package/dist/tools/definitions/definitions/std/development/fix-issues.yml +100 -0
  431. package/dist/tools/definitions/definitions/std/development/implement-task.yml +124 -0
  432. package/dist/tools/definitions/definitions/std/development/review-fix-cycle.yml +232 -0
  433. package/dist/tools/definitions/definitions/std/evolution/implement.yml +125 -0
  434. package/dist/tools/definitions/definitions/std/evolution/prioritize.yml +112 -0
  435. package/dist/tools/definitions/definitions/std/evolution/report-gap.yml +166 -0
  436. package/dist/tools/definitions/definitions/std/file/read.yml +21 -0
  437. package/dist/tools/definitions/definitions/std/governance/aggregate-opinions.sh +201 -0
  438. package/dist/tools/definitions/definitions/std/governance/aggregate-opinions.yml +79 -0
  439. package/dist/tools/definitions/definitions/std/governance/audit-task.yml +178 -0
  440. package/dist/tools/definitions/definitions/std/governance/cast-vote.yml +129 -0
  441. package/dist/tools/definitions/definitions/std/governance/collect-issues.yml +16 -0
  442. package/dist/tools/definitions/definitions/std/governance/create-signed-document.yml +23 -0
  443. package/dist/tools/definitions/definitions/std/governance/create-voting-session.yml +101 -0
  444. package/dist/tools/definitions/definitions/std/governance/define-stance.sh +243 -0
  445. package/dist/tools/definitions/definitions/std/governance/define-stance.yml +82 -0
  446. package/dist/tools/definitions/definitions/std/governance/generate-review-report.yml +23 -0
  447. package/dist/tools/definitions/definitions/std/governance/impeach.yml +179 -0
  448. package/dist/tools/definitions/definitions/std/governance/multi-stance-review.yml +154 -0
  449. package/dist/tools/definitions/definitions/std/governance/prepare-artifact.yml +20 -0
  450. package/dist/tools/definitions/definitions/std/governance/review-spec-approval.yml +262 -0
  451. package/dist/tools/definitions/definitions/std/governance/rollback.yml +186 -0
  452. package/dist/tools/definitions/definitions/std/governance/stance-review.yml +149 -0
  453. package/dist/tools/definitions/definitions/std/governance/track-effect.yml +199 -0
  454. package/dist/tools/definitions/definitions/std/governance/vote-tally.yml +144 -0
  455. package/dist/tools/definitions/definitions/std/patch/execute.yml +51 -0
  456. package/dist/tools/definitions/definitions/std/planning/generate-tasks.yml +36 -0
  457. package/dist/tools/definitions/definitions/std/planning/load-tasks.yml +44 -0
  458. package/dist/tools/definitions/definitions/std/planning/split-batch.yml +481 -0
  459. package/dist/tools/definitions/definitions/std/planning/split-tasks.yml +359 -0
  460. package/dist/tools/definitions/definitions/std/planning/update-tasks.yml +51 -0
  461. package/dist/tools/definitions/definitions/std/planning/validate-tasks.yml +46 -0
  462. package/dist/tools/definitions/definitions/std/project/decide-next-workflow.yml +38 -0
  463. package/dist/tools/definitions/definitions/std/project/load-state.yml +31 -0
  464. package/dist/tools/definitions/definitions/std/project/save-state.yml +32 -0
  465. package/dist/tools/definitions/definitions/std/quality/check-quality.yml +241 -0
  466. package/dist/tools/definitions/definitions/std/quality/debug-systematic.yml +163 -0
  467. package/dist/tools/definitions/definitions/std/quality/handle-feedback.yml +108 -0
  468. package/dist/tools/definitions/definitions/std/quality/review-code.yml +128 -0
  469. package/dist/tools/definitions/definitions/std/quality/review-spec.yml +140 -0
  470. package/dist/tools/definitions/definitions/std/quality/review-task.yml +190 -0
  471. package/dist/tools/definitions/definitions/std/quality/run-tests.yml +80 -0
  472. package/dist/tools/definitions/definitions/std/quick/analyze.yml +56 -0
  473. package/dist/tools/definitions/definitions/std/quick/implement.yml +67 -0
  474. package/dist/tools/definitions/definitions/std/quick/verify.yml +71 -0
  475. package/dist/tools/definitions/definitions/std/verification/verify_completion.yml +113 -0
  476. package/dist/tools/definitions/definitions/std/verification/wait-condition.yml +107 -0
  477. package/dist/tools/definitions/ext/browser/browser-automate.sh +255 -0
  478. package/dist/tools/definitions/ext/browser/browser-automate.yml +166 -0
  479. package/dist/tools/definitions/ext/browser/browser-close.sh +104 -0
  480. package/dist/tools/definitions/ext/browser/browser-close.yml +55 -0
  481. package/dist/tools/definitions/ext/browser/browser-mcp-debug.sh +682 -0
  482. package/dist/tools/definitions/ext/browser/browser-mcp-debug.yml +167 -0
  483. package/dist/tools/definitions/ext/browser/browser-start.sh +101 -0
  484. package/dist/tools/definitions/ext/browser/browser-start.yml +62 -0
  485. package/dist/tools/definitions/registry.json +795 -0
  486. package/dist/tools/definitions/std/README.md +350 -0
  487. package/dist/tools/definitions/std/analysis/analyze-codebase.yml +72 -0
  488. package/dist/tools/definitions/std/analysis/analyze-diff.yml +182 -0
  489. package/dist/tools/definitions/std/analysis/analyze-git-diff.yml +70 -0
  490. package/dist/tools/definitions/std/analysis/analyze-impact.yml +78 -0
  491. package/dist/tools/definitions/std/analysis/analyze-requirements.yml +105 -0
  492. package/dist/tools/definitions/std/analysis/brainstorm-options.yml +106 -0
  493. package/dist/tools/definitions/std/analysis/build-graph.yml +154 -0
  494. package/dist/tools/definitions/std/analysis/clarify-requirements.yml +90 -0
  495. package/dist/tools/definitions/std/analysis/detect-context.yml +109 -0
  496. package/dist/tools/definitions/std/analysis/detect-layers.yml +125 -0
  497. package/dist/tools/definitions/std/analysis/generate-tour.yml +102 -0
  498. package/dist/tools/definitions/std/analysis/search-enhance.yml +105 -0
  499. package/dist/tools/definitions/std/backlog/add.yml +51 -0
  500. package/dist/tools/definitions/std/backlog/decide.yml +39 -0
  501. package/dist/tools/definitions/std/backlog/github-sync.yml +161 -0
  502. package/dist/tools/definitions/std/backlog/list.yml +53 -0
  503. package/dist/tools/definitions/std/backlog/load.yml +46 -0
  504. package/dist/tools/definitions/std/backlog/resolve.yml +37 -0
  505. package/dist/tools/definitions/std/backlog/update.yml +42 -0
  506. package/dist/tools/definitions/std/bugfix/diagnose.yml +68 -0
  507. package/dist/tools/definitions/std/bugfix/fix.yml +66 -0
  508. package/dist/tools/definitions/std/bugfix/verify.yml +69 -0
  509. package/dist/tools/definitions/std/constraint/check-decomposition.yml +103 -0
  510. package/dist/tools/definitions/std/constraint/check-feature-list.yml +77 -0
  511. package/dist/tools/definitions/std/constraint/check-progress.yml +97 -0
  512. package/dist/tools/definitions/std/constraint/generate-report.yml +147 -0
  513. package/dist/tools/definitions/std/deploy/commit-push.yml +33 -0
  514. package/dist/tools/definitions/std/deploy/deploy-backend.yml +37 -0
  515. package/dist/tools/definitions/std/deploy/deploy-frontend.yml +37 -0
  516. package/dist/tools/definitions/std/deploy/rollback.yml +148 -0
  517. package/dist/tools/definitions/std/design/analyze-architecture-impact.yml +113 -0
  518. package/dist/tools/definitions/std/design/design-api.yml +55 -0
  519. package/dist/tools/definitions/std/design/design-architecture.yml +97 -0
  520. package/dist/tools/definitions/std/design/design-db.yml +81 -0
  521. package/dist/tools/definitions/std/design/generate-spec.yml +182 -0
  522. package/dist/tools/definitions/std/development/develop-api.yml +85 -0
  523. package/dist/tools/definitions/std/development/develop-backend.yml +88 -0
  524. package/dist/tools/definitions/std/development/develop-frontend.yml +87 -0
  525. package/dist/tools/definitions/std/development/develop-shared-types.yml +74 -0
  526. package/dist/tools/definitions/std/development/develop-task.yml +122 -0
  527. package/dist/tools/definitions/std/development/develop-tests.yml +76 -0
  528. package/dist/tools/definitions/std/development/execute-batch.yml +152 -0
  529. package/dist/tools/definitions/std/development/fix-issues.yml +100 -0
  530. package/dist/tools/definitions/std/development/implement-task.yml +124 -0
  531. package/dist/tools/definitions/std/development/review-fix-cycle.yml +232 -0
  532. package/dist/tools/definitions/std/evolution/implement.yml +125 -0
  533. package/dist/tools/definitions/std/evolution/prioritize.yml +112 -0
  534. package/dist/tools/definitions/std/evolution/report-gap.yml +166 -0
  535. package/dist/tools/definitions/std/file/read.yml +21 -0
  536. package/dist/tools/definitions/std/governance/aggregate-opinions.sh +201 -0
  537. package/dist/tools/definitions/std/governance/aggregate-opinions.yml +79 -0
  538. package/dist/tools/definitions/std/governance/audit-task.yml +178 -0
  539. package/dist/tools/definitions/std/governance/cast-vote.yml +129 -0
  540. package/dist/tools/definitions/std/governance/collect-issues.yml +16 -0
  541. package/dist/tools/definitions/std/governance/create-signed-document.yml +23 -0
  542. package/dist/tools/definitions/std/governance/create-voting-session.yml +101 -0
  543. package/dist/tools/definitions/std/governance/define-stance.sh +243 -0
  544. package/dist/tools/definitions/std/governance/define-stance.yml +82 -0
  545. package/dist/tools/definitions/std/governance/generate-review-report.yml +23 -0
  546. package/dist/tools/definitions/std/governance/impeach.yml +179 -0
  547. package/dist/tools/definitions/std/governance/multi-stance-review.yml +154 -0
  548. package/dist/tools/definitions/std/governance/prepare-artifact.yml +20 -0
  549. package/dist/tools/definitions/std/governance/review-spec-approval.yml +262 -0
  550. package/dist/tools/definitions/std/governance/rollback.yml +186 -0
  551. package/dist/tools/definitions/std/governance/stance-review.yml +149 -0
  552. package/dist/tools/definitions/std/governance/track-effect.yml +199 -0
  553. package/dist/tools/definitions/std/governance/vote-tally.yml +144 -0
  554. package/dist/tools/definitions/std/patch/execute.yml +51 -0
  555. package/dist/tools/definitions/std/planning/generate-tasks.yml +36 -0
  556. package/dist/tools/definitions/std/planning/load-tasks.yml +44 -0
  557. package/dist/tools/definitions/std/planning/split-batch.yml +481 -0
  558. package/dist/tools/definitions/std/planning/split-tasks.yml +359 -0
  559. package/dist/tools/definitions/std/planning/update-tasks.yml +51 -0
  560. package/dist/tools/definitions/std/planning/validate-tasks.yml +46 -0
  561. package/dist/tools/definitions/std/project/decide-next-workflow.yml +38 -0
  562. package/dist/tools/definitions/std/project/load-state.yml +31 -0
  563. package/dist/tools/definitions/std/project/save-state.yml +32 -0
  564. package/dist/tools/definitions/std/quality/check-quality.yml +241 -0
  565. package/dist/tools/definitions/std/quality/debug-systematic.yml +163 -0
  566. package/dist/tools/definitions/std/quality/handle-feedback.yml +108 -0
  567. package/dist/tools/definitions/std/quality/review-code.yml +128 -0
  568. package/dist/tools/definitions/std/quality/review-spec.yml +140 -0
  569. package/dist/tools/definitions/std/quality/review-task.yml +190 -0
  570. package/dist/tools/definitions/std/quality/run-tests.yml +80 -0
  571. package/dist/tools/definitions/std/quick/analyze.yml +56 -0
  572. package/dist/tools/definitions/std/quick/implement.yml +67 -0
  573. package/dist/tools/definitions/std/quick/verify.yml +71 -0
  574. package/dist/tools/definitions/std/verification/verify_completion.yml +113 -0
  575. package/dist/tools/definitions/std/verification/wait-condition.yml +107 -0
  576. package/dist/tools/index.d.ts +6 -0
  577. package/dist/tools/index.d.ts.map +1 -0
  578. package/dist/tools/index.js +22 -0
  579. package/dist/tools/index.js.map +1 -0
  580. package/dist/tools/loader.d.ts +21 -0
  581. package/dist/tools/loader.d.ts.map +1 -0
  582. package/dist/tools/loader.js +199 -0
  583. package/dist/tools/loader.js.map +1 -0
  584. package/dist/tools/paths.d.ts +9 -0
  585. package/dist/tools/paths.d.ts.map +1 -0
  586. package/dist/tools/paths.js +51 -0
  587. package/dist/tools/paths.js.map +1 -0
  588. package/dist/tools/registry.d.ts +59 -0
  589. package/dist/tools/registry.d.ts.map +1 -0
  590. package/dist/tools/registry.js +115 -0
  591. package/dist/tools/registry.js.map +1 -0
  592. package/dist/tools/types.d.ts +38 -0
  593. package/dist/tools/types.d.ts.map +1 -0
  594. package/dist/tools/types.js +6 -0
  595. package/dist/tools/types.js.map +1 -0
  596. package/dist/types/constraint.d.ts +8 -0
  597. package/dist/types/constraint.d.ts.map +1 -1
  598. package/dist/types/constraint.js.map +1 -1
  599. package/dist/types/project-config.d.ts +57 -0
  600. package/dist/types/project-config.d.ts.map +1 -1
  601. package/dist/types/session.d.ts +6 -0
  602. package/dist/types/session.d.ts.map +1 -1
  603. package/dist/utils/exec.d.ts +11 -1
  604. package/dist/utils/exec.d.ts.map +1 -1
  605. package/dist/utils/exec.js +56 -2
  606. package/dist/utils/exec.js.map +1 -1
  607. package/dist/verification/index.d.ts +4 -0
  608. package/dist/verification/index.d.ts.map +1 -0
  609. package/dist/verification/index.js +20 -0
  610. package/dist/verification/index.js.map +1 -0
  611. package/dist/verification/loop.d.ts +30 -0
  612. package/dist/verification/loop.d.ts.map +1 -0
  613. package/dist/verification/loop.js +114 -0
  614. package/dist/verification/loop.js.map +1 -0
  615. package/dist/verification/rules-based.d.ts +40 -0
  616. package/dist/verification/rules-based.d.ts.map +1 -0
  617. package/dist/verification/rules-based.js +130 -0
  618. package/dist/verification/rules-based.js.map +1 -0
  619. package/dist/verification/types.d.ts +69 -0
  620. package/dist/verification/types.d.ts.map +1 -0
  621. package/dist/verification/types.js +6 -0
  622. package/dist/verification/types.js.map +1 -0
  623. package/package.json +2 -2
@@ -0,0 +1,94 @@
1
+ "use strict";
2
+ /**
3
+ * Knowledge Ingest Pipeline
4
+ *
5
+ * Handles ingesting new knowledge entries into the store
6
+ * with auto-fill, dedup detection, and batch support.
7
+ */
8
+ Object.defineProperty(exports, "__esModule", { value: true });
9
+ exports.KnowledgeIngest = void 0;
10
+ // ── Ingest ─────────────────────────────────────────────────
11
+ class KnowledgeIngest {
12
+ store;
13
+ constructor(store) {
14
+ this.store = store;
15
+ }
16
+ /**
17
+ * Ingest a single knowledge entry.
18
+ * Auto-fills id, created, maturity, and other defaults.
19
+ * Returns the fully-formed entry that was saved.
20
+ */
21
+ ingestEntry(partial, options) {
22
+ const entry = this.buildEntry(partial, options);
23
+ // Dedup check: same title + same type
24
+ const existing = this.findDuplicate(entry.title, entry.type);
25
+ if (existing) {
26
+ // Merge: update existing entry with new content and metadata
27
+ return this.mergeEntries(existing, entry, options);
28
+ }
29
+ this.store.save(entry);
30
+ return entry;
31
+ }
32
+ /**
33
+ * Ingest multiple entries in batch.
34
+ * Returns all ingested entries.
35
+ */
36
+ ingestBatch(partials, options) {
37
+ return partials.map(p => this.ingestEntry(p, options));
38
+ }
39
+ // ── Internal ───────────────────────────────────────────────
40
+ buildEntry(partial, options) {
41
+ const now = new Date().toISOString();
42
+ const type = partial.type || this.inferType(options);
43
+ const id = partial.id || this.generateId(type);
44
+ return {
45
+ id,
46
+ type,
47
+ title: partial.title || 'Untitled',
48
+ content: partial.content || '',
49
+ maturity: options.maturity || partial.maturity || 'draft',
50
+ layer: options.layer,
51
+ created: partial.created || now,
52
+ lastReferenced: partial.lastReferenced || '',
53
+ contributors: partial.contributors || [],
54
+ projects: partial.projects || options.projects || [],
55
+ tags: [...new Set([...(partial.tags || []), ...(options.tags || [])])],
56
+ applicablePhases: partial.applicablePhases || [],
57
+ sourceReferences: partial.sourceReferences || this.defaultSourceRef(options.source),
58
+ referencedBy: partial.referencedBy || [],
59
+ };
60
+ }
61
+ generateId(type) {
62
+ const prefix = type.toUpperCase().slice(0, 3);
63
+ const existing = this.store.list({ types: [type] });
64
+ const seq = String(existing.length + 1).padStart(3, '0');
65
+ return `${prefix}-${seq}`;
66
+ }
67
+ inferType(options) {
68
+ // Default to 'guideline' if type can't be inferred
69
+ return 'guideline';
70
+ }
71
+ findDuplicate(title, type) {
72
+ const all = this.store.list({ types: [type] });
73
+ return all.find(e => e.title.toLowerCase() === title.toLowerCase());
74
+ }
75
+ mergeEntries(existing, incoming, options) {
76
+ const merged = {
77
+ content: incoming.content || existing.content,
78
+ lastReferenced: new Date().toISOString(),
79
+ contributors: [...new Set([...existing.contributors, ...incoming.contributors])],
80
+ projects: [...new Set([...existing.projects, ...incoming.projects])],
81
+ tags: [...new Set([...existing.tags, ...incoming.tags])],
82
+ sourceReferences: [...existing.sourceReferences, ...incoming.sourceReferences],
83
+ };
84
+ return this.store.update(existing.id, merged);
85
+ }
86
+ defaultSourceRef(source) {
87
+ return [{
88
+ workflow: source,
89
+ timestamp: new Date().toISOString(),
90
+ }];
91
+ }
92
+ }
93
+ exports.KnowledgeIngest = KnowledgeIngest;
94
+ //# sourceMappingURL=ingest.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"ingest.js","sourceRoot":"","sources":["../../src/knowledge/ingest.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,62 @@
1
+ /**
2
+ * 知识生命周期钩子
3
+ *
4
+ * 与 Agent 生命周期集成:
5
+ * - 启动时注入相关知识上下文
6
+ * - 完成时提取新知识
7
+ */
8
+ import type { KnowledgeEntry, KnowledgeType } from './types';
9
+ import { KnowledgeStore } from './store';
10
+ import { KnowledgeQuery } from './query';
11
+ import type { ContextSource } from '../context/types';
12
+ export interface LifecycleHookConfig {
13
+ store: KnowledgeStore;
14
+ query: KnowledgeQuery;
15
+ /** 启动时注入的最大 token 数 */
16
+ injectionBudget?: number;
17
+ /** 完成时提取的最大条目数 */
18
+ maxExtractionEntries?: number;
19
+ /** 当前阶段 */
20
+ phase?: string;
21
+ }
22
+ export interface ExtractionResult {
23
+ entries: KnowledgeEntry[];
24
+ source: 'archive' | 'error' | 'decision';
25
+ }
26
+ export declare class KnowledgeLifecycleHooks {
27
+ private config;
28
+ constructor(config: LifecycleHookConfig);
29
+ /**
30
+ * 启动钩子:注入相关知识到上下文
31
+ *
32
+ * 在 Agent session 启动时调用
33
+ */
34
+ onSessionStart(options?: {
35
+ phase?: string;
36
+ budget?: number;
37
+ focusTypes?: KnowledgeType[];
38
+ exclude?: string[];
39
+ }): ContextSource[];
40
+ /**
41
+ * 完成钩子:从产物中提取新知识
42
+ *
43
+ * 在 Agent task 完成时调用(ARCHIVE 阶段)
44
+ */
45
+ onTaskComplete(context: {
46
+ taskDescription: string;
47
+ changedFiles?: string[];
48
+ testResults?: string;
49
+ errors?: string[];
50
+ decisions?: string[];
51
+ }): ExtractionResult;
52
+ /**
53
+ * 错误钩子:从错误中提取知识
54
+ */
55
+ onError(error: Error, context?: {
56
+ taskDescription?: string;
57
+ stackTrace?: string;
58
+ }): ExtractionResult;
59
+ private formatForContext;
60
+ private createExtractionEntry;
61
+ }
62
+ //# sourceMappingURL=lifecycle-hooks.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"lifecycle-hooks.d.ts","sourceRoot":"","sources":["../../src/knowledge/lifecycle-hooks.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC7D,OAAO,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAItD,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,cAAc,CAAC;IACtB,KAAK,EAAE,cAAc,CAAC;IACtB,uBAAuB;IACvB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,kBAAkB;IAClB,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,WAAW;IACX,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAID,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,MAAM,EAAE,SAAS,GAAG,OAAO,GAAG,UAAU,CAAC;CAC1C;AAID,qBAAa,uBAAuB;IAClC,OAAO,CAAC,MAAM,CAAsB;gBAExB,MAAM,EAAE,mBAAmB;IAIvC;;;;OAIG;IACH,cAAc,CAAC,OAAO,CAAC,EAAE;QACvB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,UAAU,CAAC,EAAE,aAAa,EAAE,CAAC;QAC7B,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;KACpB,GAAG,aAAa,EAAE;IA6BnB;;;;OAIG;IACH,cAAc,CAAC,OAAO,EAAE;QACtB,eAAe,EAAE,MAAM,CAAC;QACxB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;QACxB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;QAClB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;KACtB,GAAG,gBAAgB;IAsCpB;;OAEG;IACH,OAAO,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,CAAC,EAAE;QAC9B,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,GAAG,gBAAgB;IAwBpB,OAAO,CAAC,gBAAgB;IAYxB,OAAO,CAAC,qBAAqB;CA0B9B"}
@@ -0,0 +1,140 @@
1
+ "use strict";
2
+ /**
3
+ * 知识生命周期钩子
4
+ *
5
+ * 与 Agent 生命周期集成:
6
+ * - 启动时注入相关知识上下文
7
+ * - 完成时提取新知识
8
+ */
9
+ Object.defineProperty(exports, "__esModule", { value: true });
10
+ exports.KnowledgeLifecycleHooks = void 0;
11
+ // ── 生命周期钩子 ─────────────────────────────────────────
12
+ class KnowledgeLifecycleHooks {
13
+ config;
14
+ constructor(config) {
15
+ this.config = config;
16
+ }
17
+ /**
18
+ * 启动钩子:注入相关知识到上下文
19
+ *
20
+ * 在 Agent session 启动时调用
21
+ */
22
+ onSessionStart(options) {
23
+ const budget = options?.budget ?? this.config.injectionBudget ?? 800;
24
+ const phase = options?.phase ?? this.config.phase ?? 'default';
25
+ const queryResult = this.config.query.query({
26
+ phase,
27
+ maxTokens: budget,
28
+ maxEntries: 10,
29
+ focusTypes: options?.focusTypes ?? [],
30
+ });
31
+ const sources = [];
32
+ const excludeSet = new Set(options?.exclude ?? []);
33
+ for (const entry of queryResult.entries) {
34
+ if (excludeSet.has(entry.id))
35
+ continue;
36
+ sources.push({
37
+ type: 'knowledge',
38
+ id: `knowledge-${entry.id}`,
39
+ content: this.formatForContext(entry),
40
+ priority: 3,
41
+ metadata: { entryId: entry.id, maturity: entry.maturity },
42
+ });
43
+ }
44
+ return sources;
45
+ }
46
+ /**
47
+ * 完成钩子:从产物中提取新知识
48
+ *
49
+ * 在 Agent task 完成时调用(ARCHIVE 阶段)
50
+ */
51
+ onTaskComplete(context) {
52
+ const entries = [];
53
+ // 从错误中提取 pitfall
54
+ if (context.errors && context.errors.length > 0) {
55
+ for (const error of context.errors.slice(0, 3)) {
56
+ entries.push(this.createExtractionEntry({
57
+ title: `踩坑: ${error.slice(0, 100)}`,
58
+ content: error,
59
+ type: 'pitfall',
60
+ tags: ['auto-extract', 'error'],
61
+ }));
62
+ }
63
+ }
64
+ // 从决策中提取 decision
65
+ if (context.decisions && context.decisions.length > 0) {
66
+ for (const decision of context.decisions.slice(0, 3)) {
67
+ entries.push(this.createExtractionEntry({
68
+ title: `决策: ${decision.slice(0, 100)}`,
69
+ content: decision,
70
+ type: 'decision',
71
+ tags: ['auto-extract', 'decision'],
72
+ }));
73
+ }
74
+ }
75
+ // 保存到知识库
76
+ for (const entry of entries) {
77
+ this.config.store.save(entry);
78
+ }
79
+ return {
80
+ entries,
81
+ source: 'archive',
82
+ };
83
+ }
84
+ /**
85
+ * 错误钩子:从错误中提取知识
86
+ */
87
+ onError(error, context) {
88
+ const content = [
89
+ `错误: ${error.message}`,
90
+ context?.stackTrace ? `\n堆栈:\n${context.stackTrace}` : '',
91
+ context?.taskDescription ? `\n任务: ${context.taskDescription}` : '',
92
+ ].filter(Boolean).join('\n');
93
+ const entry = this.createExtractionEntry({
94
+ title: `踩坑: ${error.message.slice(0, 100)}`,
95
+ content,
96
+ type: 'pitfall',
97
+ tags: ['auto-extract', 'error', 'runtime'],
98
+ });
99
+ this.config.store.save(entry);
100
+ return {
101
+ entries: [entry],
102
+ source: 'error',
103
+ };
104
+ }
105
+ // ── 辅助方法 ───────────────────────────────────────────
106
+ formatForContext(entry) {
107
+ const parts = [];
108
+ parts.push(`## [${entry.type.toUpperCase()}] ${entry.title}`);
109
+ parts.push(`成熟度: ${entry.maturity}`);
110
+ if (entry.tags.length > 0) {
111
+ parts.push(`标签: ${entry.tags.join(', ')}`);
112
+ }
113
+ parts.push('');
114
+ parts.push(entry.content);
115
+ return parts.join('\n');
116
+ }
117
+ createExtractionEntry(params) {
118
+ return {
119
+ id: `extract-${Date.now()}-${Math.random().toString(36).slice(2, 6)}`,
120
+ type: params.type,
121
+ title: params.title,
122
+ content: params.content,
123
+ maturity: 'draft',
124
+ layer: 'project',
125
+ created: new Date().toISOString(),
126
+ lastReferenced: '',
127
+ contributors: [],
128
+ projects: [],
129
+ tags: params.tags,
130
+ applicablePhases: [],
131
+ sourceReferences: [{
132
+ workflow: 'lifecycle-hook',
133
+ timestamp: new Date().toISOString(),
134
+ }],
135
+ referencedBy: [],
136
+ };
137
+ }
138
+ }
139
+ exports.KnowledgeLifecycleHooks = KnowledgeLifecycleHooks;
140
+ //# sourceMappingURL=lifecycle-hooks.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"lifecycle-hooks.js","sourceRoot":"","sources":["../../src/knowledge/lifecycle-hooks.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,43 @@
1
+ /**
2
+ * Knowledge Lifecycle Manager
3
+ *
4
+ * Handles maturity promotion, auto-decay, and reference tracking
5
+ * for the knowledge flywheel.
6
+ */
7
+ import type { KnowledgeEntry, MaturityLevel, MaturityChange, DecayConfig } from './types';
8
+ import { KnowledgeStore } from './store';
9
+ export declare class KnowledgeLifecycle {
10
+ private store;
11
+ private config;
12
+ constructor(store: KnowledgeStore, config?: Partial<DecayConfig>);
13
+ /**
14
+ * Record that an entry was referenced.
15
+ * Updates lastReferenced timestamp and contributors.
16
+ */
17
+ recordReference(entryId: string, contributor?: string): KnowledgeEntry | undefined;
18
+ /**
19
+ * Check if an entry meets promotion criteria.
20
+ * Returns the target maturity level if promotion is warranted, otherwise undefined.
21
+ *
22
+ * Rules:
23
+ * - draft → verified: lastReferenced is set (referenced at least once)
24
+ * - verified → proven: referenced ≥3 times (contributors count as proxy) + ≥2 projects
25
+ */
26
+ checkPromotion(entryId: string): MaturityLevel | undefined;
27
+ /**
28
+ * Check if an entry should decay based on time since last reference.
29
+ * Returns the target maturity level if decay is warranted, otherwise undefined.
30
+ */
31
+ checkEntryDecay(entryId: string): MaturityLevel | undefined;
32
+ /**
33
+ * Run a full decay cycle across all entries.
34
+ * Returns a list of maturity changes that were applied.
35
+ */
36
+ runDecayCycle(): MaturityChange[];
37
+ /**
38
+ * Promote an entry if it meets criteria. Returns the change if applied.
39
+ */
40
+ tryPromote(entryId: string): MaturityChange | undefined;
41
+ private monthsSince;
42
+ }
43
+ //# sourceMappingURL=lifecycle.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"lifecycle.d.ts","sourceRoot":"","sources":["../../src/knowledge/lifecycle.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,cAAc,EACd,aAAa,EACb,cAAc,EACd,WAAW,EACZ,MAAM,SAAS,CAAC;AAEjB,OAAO,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAIzC,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,KAAK,CAAiB;IAC9B,OAAO,CAAC,MAAM,CAAc;gBAEhB,KAAK,EAAE,cAAc,EAAE,MAAM,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC;IAKhE;;;OAGG;IACH,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAelF;;;;;;;OAOG;IACH,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS;IAqB1D;;;OAGG;IACH,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS;IA2B3D;;;OAGG;IACH,aAAa,IAAI,cAAc,EAAE;IAqBjC;;OAEG;IACH,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAmBvD,OAAO,CAAC,WAAW;CAKpB"}
@@ -0,0 +1,141 @@
1
+ "use strict";
2
+ /**
3
+ * Knowledge Lifecycle Manager
4
+ *
5
+ * Handles maturity promotion, auto-decay, and reference tracking
6
+ * for the knowledge flywheel.
7
+ */
8
+ Object.defineProperty(exports, "__esModule", { value: true });
9
+ exports.KnowledgeLifecycle = void 0;
10
+ const types_1 = require("./types");
11
+ // ── Lifecycle ──────────────────────────────────────────────
12
+ class KnowledgeLifecycle {
13
+ store;
14
+ config;
15
+ constructor(store, config) {
16
+ this.store = store;
17
+ this.config = { ...types_1.DEFAULT_DECAY_CONFIG, ...config };
18
+ }
19
+ /**
20
+ * Record that an entry was referenced.
21
+ * Updates lastReferenced timestamp and contributors.
22
+ */
23
+ recordReference(entryId, contributor) {
24
+ const entry = this.store.get(entryId);
25
+ if (!entry)
26
+ return undefined;
27
+ const now = new Date().toISOString();
28
+ const contributors = contributor && !entry.contributors.includes(contributor)
29
+ ? [...entry.contributors, contributor]
30
+ : entry.contributors;
31
+ return this.store.update(entryId, {
32
+ lastReferenced: now,
33
+ contributors,
34
+ });
35
+ }
36
+ /**
37
+ * Check if an entry meets promotion criteria.
38
+ * Returns the target maturity level if promotion is warranted, otherwise undefined.
39
+ *
40
+ * Rules:
41
+ * - draft → verified: lastReferenced is set (referenced at least once)
42
+ * - verified → proven: referenced ≥3 times (contributors count as proxy) + ≥2 projects
43
+ */
44
+ checkPromotion(entryId) {
45
+ const entry = this.store.get(entryId);
46
+ if (!entry)
47
+ return undefined;
48
+ switch (entry.maturity) {
49
+ case 'draft':
50
+ if (entry.lastReferenced)
51
+ return 'verified';
52
+ return undefined;
53
+ case 'verified':
54
+ if (entry.contributors.length >= 3 && entry.projects.length >= 2) {
55
+ return 'proven';
56
+ }
57
+ return undefined;
58
+ case 'proven':
59
+ case 'archived':
60
+ return undefined;
61
+ }
62
+ }
63
+ /**
64
+ * Check if an entry should decay based on time since last reference.
65
+ * Returns the target maturity level if decay is warranted, otherwise undefined.
66
+ */
67
+ checkEntryDecay(entryId) {
68
+ const entry = this.store.get(entryId);
69
+ if (!entry)
70
+ return undefined;
71
+ const lastRef = entry.lastReferenced || entry.created;
72
+ if (!lastRef)
73
+ return undefined;
74
+ const monthsSinceRef = this.monthsSince(lastRef);
75
+ switch (entry.maturity) {
76
+ case 'proven':
77
+ if (monthsSinceRef >= this.config.provenDecayMonths)
78
+ return 'verified';
79
+ return undefined;
80
+ case 'verified':
81
+ if (monthsSinceRef >= this.config.verifiedDecayMonths)
82
+ return 'draft';
83
+ return undefined;
84
+ case 'draft':
85
+ if (monthsSinceRef >= this.config.draftDecayMonths)
86
+ return 'archived';
87
+ return undefined;
88
+ case 'archived':
89
+ return undefined;
90
+ }
91
+ }
92
+ /**
93
+ * Run a full decay cycle across all entries.
94
+ * Returns a list of maturity changes that were applied.
95
+ */
96
+ runDecayCycle() {
97
+ const entries = this.store.list({ excludeArchived: false });
98
+ const changes = [];
99
+ for (const entry of entries) {
100
+ const targetMaturity = this.checkEntryDecay(entry.id);
101
+ if (targetMaturity && targetMaturity !== entry.maturity) {
102
+ const change = {
103
+ entryId: entry.id,
104
+ from: entry.maturity,
105
+ to: targetMaturity,
106
+ reason: `Auto-decay: ${entry.maturity} → ${targetMaturity} (unreferenced for threshold)`,
107
+ };
108
+ this.store.update(entry.id, { maturity: targetMaturity });
109
+ changes.push(change);
110
+ }
111
+ }
112
+ return changes;
113
+ }
114
+ /**
115
+ * Promote an entry if it meets criteria. Returns the change if applied.
116
+ */
117
+ tryPromote(entryId) {
118
+ const entry = this.store.get(entryId);
119
+ if (!entry)
120
+ return undefined;
121
+ const target = this.checkPromotion(entryId);
122
+ if (!target || target === entry.maturity)
123
+ return undefined;
124
+ const change = {
125
+ entryId,
126
+ from: entry.maturity,
127
+ to: target,
128
+ reason: `Promotion: ${entry.maturity} → ${target}`,
129
+ };
130
+ this.store.update(entryId, { maturity: target });
131
+ return change;
132
+ }
133
+ // ── Internal ───────────────────────────────────────────────
134
+ monthsSince(dateStr) {
135
+ const then = new Date(dateStr);
136
+ const now = new Date();
137
+ return (now.getFullYear() - then.getFullYear()) * 12 + (now.getMonth() - then.getMonth());
138
+ }
139
+ }
140
+ exports.KnowledgeLifecycle = KnowledgeLifecycle;
141
+ //# sourceMappingURL=lifecycle.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"lifecycle.js","sourceRoot":"","sources":["../../src/knowledge/lifecycle.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,57 @@
1
+ /**
2
+ * 知识库 Lint(健康检查)
3
+ *
4
+ * 检查项:
5
+ * - 索引不一致(自动修复)
6
+ * - 孤儿条目(无引用、无验证)
7
+ * - 矛盾检测(同主题相反结论)
8
+ * - 过时检测(6 月未引用的 draft)
9
+ * - 重复/相似条目
10
+ * - 成熟度衰减
11
+ */
12
+ import { KnowledgeStore } from './store';
13
+ import { ReferenceTracker } from './reference-tracker';
14
+ import type { KnowledgeEntry, LintIssue, LintIssueType } from './types';
15
+ export interface LintReport {
16
+ timestamp: string;
17
+ totalEntries: number;
18
+ issues: LintIssue[];
19
+ fixed: number;
20
+ summary: Record<LintIssueType, number>;
21
+ }
22
+ export declare class KnowledgeLinter {
23
+ private store;
24
+ private tracker;
25
+ constructor(store: KnowledgeStore, tracker: ReferenceTracker);
26
+ /**
27
+ * 执行完整 Lint 检查
28
+ */
29
+ run(autoFix?: boolean): LintReport;
30
+ /**
31
+ * 检查索引一致性
32
+ */
33
+ checkIndexConsistency(entries: KnowledgeEntry[]): LintIssue[];
34
+ /**
35
+ * 检查孤儿条目(无引用、无验证)
36
+ */
37
+ checkOrphans(entries: KnowledgeEntry[]): LintIssue[];
38
+ /**
39
+ * 检查过时条目(6 月未引用的 draft)
40
+ */
41
+ checkOutdated(entries: KnowledgeEntry[]): LintIssue[];
42
+ /**
43
+ * 检查重复/相似条目
44
+ */
45
+ checkDuplicates(entries: KnowledgeEntry[]): LintIssue[];
46
+ /**
47
+ * 检查矛盾(同主题相反结论)
48
+ *
49
+ * 简单实现:同 tag 组合下成熟度冲突
50
+ */
51
+ checkContradictions(entries: KnowledgeEntry[]): LintIssue[];
52
+ /**
53
+ * 自动修复可修复的问题
54
+ */
55
+ private autoFix;
56
+ }
57
+ //# sourceMappingURL=lint.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"lint.d.ts","sourceRoot":"","sources":["../../src/knowledge/lint.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,aAAa,EAAiB,MAAM,SAAS,CAAC;AAEvF,MAAM,WAAW,UAAU;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,SAAS,EAAE,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC;CACxC;AAED,qBAAa,eAAe;IAC1B,OAAO,CAAC,KAAK,CAAiB;IAC9B,OAAO,CAAC,OAAO,CAAmB;gBAEtB,KAAK,EAAE,cAAc,EAAE,OAAO,EAAE,gBAAgB;IAK5D;;OAEG;IACH,GAAG,CAAC,OAAO,GAAE,OAAe,GAAG,UAAU;IAsCzC;;OAEG;IACH,qBAAqB,CAAC,OAAO,EAAE,cAAc,EAAE,GAAG,SAAS,EAAE;IAoC7D;;OAEG;IACH,YAAY,CAAC,OAAO,EAAE,cAAc,EAAE,GAAG,SAAS,EAAE;IAyBpD;;OAEG;IACH,aAAa,CAAC,OAAO,EAAE,cAAc,EAAE,GAAG,SAAS,EAAE;IA0BrD;;OAEG;IACH,eAAe,CAAC,OAAO,EAAE,cAAc,EAAE,GAAG,SAAS,EAAE;IA+BvD;;;;OAIG;IACH,mBAAmB,CAAC,OAAO,EAAE,cAAc,EAAE,GAAG,SAAS,EAAE;IA0C3D;;OAEG;IACH,OAAO,CAAC,OAAO;CAkBhB"}