@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 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/agents/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,0CAAwB;AACxB,8CAA4B"}
@@ -0,0 +1,68 @@
1
+ /**
2
+ * Agent 生命周期管理
3
+ *
4
+ * 管理 Agent 的启动、监控、回退、终止
5
+ */
6
+ import type { AgentConfig, AgentState, AgentStatus, AgentEvent, FallbackStrategy } from './types';
7
+ export type EventHandler = (event: AgentEvent) => void;
8
+ export declare class AgentLifecycle {
9
+ private agents;
10
+ private configs;
11
+ private strategies;
12
+ private eventHandlers;
13
+ constructor();
14
+ /**
15
+ * 注册 Agent
16
+ */
17
+ register(config: AgentConfig): AgentState;
18
+ /**
19
+ * 启动 Agent
20
+ */
21
+ start(id: string): AgentState | undefined;
22
+ /**
23
+ * 完成 Agent
24
+ */
25
+ complete(id: string, metadata?: Record<string, unknown>): AgentState | undefined;
26
+ /**
27
+ * 标记失败
28
+ */
29
+ fail(id: string, error: string): AgentState | undefined;
30
+ /**
31
+ * 终止 Agent
32
+ */
33
+ terminate(id: string): AgentState | undefined;
34
+ /**
35
+ * 获取 Agent 状态
36
+ */
37
+ getState(id: string): AgentState | undefined;
38
+ /**
39
+ * 获取所有 Agent 状态
40
+ */
41
+ getAllStates(): AgentState[];
42
+ /**
43
+ * 按状态过滤
44
+ */
45
+ getByStatus(status: AgentStatus): AgentState[];
46
+ /**
47
+ * 注册回退策略
48
+ */
49
+ addFallbackStrategy(strategy: FallbackStrategy): void;
50
+ /**
51
+ * 注册事件处理器
52
+ */
53
+ onEvent(handler: EventHandler): void;
54
+ /**
55
+ * 应用回退策略
56
+ */
57
+ private applyFallbackStrategies;
58
+ private emit;
59
+ /**
60
+ * 移除 Agent
61
+ */
62
+ remove(id: string): boolean;
63
+ /**
64
+ * 清空所有 Agent
65
+ */
66
+ clear(): void;
67
+ }
68
+ //# sourceMappingURL=lifecycle.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"lifecycle.d.ts","sourceRoot":"","sources":["../../src/agents/lifecycle.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACV,WAAW,EACX,UAAU,EACV,WAAW,EACX,UAAU,EACV,gBAAgB,EACjB,MAAM,SAAS,CAAC;AAEjB,MAAM,MAAM,YAAY,GAAG,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,CAAC;AAEvD,qBAAa,cAAc;IACzB,OAAO,CAAC,MAAM,CAA0B;IACxC,OAAO,CAAC,OAAO,CAA2B;IAC1C,OAAO,CAAC,UAAU,CAAqB;IACvC,OAAO,CAAC,aAAa,CAAiB;;IAStC;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,WAAW,GAAG,UAAU;IAYzC;;OAEG;IACH,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS;IAUzC;;OAEG;IACH,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,UAAU,GAAG,SAAS;IAWhF;;OAEG;IACH,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS;IAavD;;OAEG;IACH,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS;IAU7C;;OAEG;IACH,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS;IAI5C;;OAEG;IACH,YAAY,IAAI,UAAU,EAAE;IAI5B;;OAEG;IACH,WAAW,CAAC,MAAM,EAAE,WAAW,GAAG,UAAU,EAAE;IAI9C;;OAEG;IACH,mBAAmB,CAAC,QAAQ,EAAE,gBAAgB,GAAG,IAAI;IAIrD;;OAEG;IACH,OAAO,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI;IAIpC;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAqC/B,OAAO,CAAC,IAAI;IAUZ;;OAEG;IACH,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAK3B;;OAEG;IACH,KAAK,IAAI,IAAI;CAId"}
@@ -0,0 +1,181 @@
1
+ "use strict";
2
+ /**
3
+ * Agent 生命周期管理
4
+ *
5
+ * 管理 Agent 的启动、监控、回退、终止
6
+ */
7
+ Object.defineProperty(exports, "__esModule", { value: true });
8
+ exports.AgentLifecycle = void 0;
9
+ class AgentLifecycle {
10
+ agents;
11
+ configs;
12
+ strategies;
13
+ eventHandlers;
14
+ constructor() {
15
+ this.agents = new Map();
16
+ this.configs = new Map();
17
+ this.strategies = [];
18
+ this.eventHandlers = [];
19
+ }
20
+ /**
21
+ * 注册 Agent
22
+ */
23
+ register(config) {
24
+ const state = {
25
+ id: config.id,
26
+ status: 'idle',
27
+ retryCount: 0,
28
+ metadata: {},
29
+ };
30
+ this.agents.set(config.id, state);
31
+ this.configs.set(config.id, config);
32
+ return state;
33
+ }
34
+ /**
35
+ * 启动 Agent
36
+ */
37
+ start(id) {
38
+ const state = this.agents.get(id);
39
+ if (!state)
40
+ return undefined;
41
+ state.status = 'running';
42
+ state.startedAt = new Date().toISOString();
43
+ this.emit({ type: 'start', agentId: id, timestamp: state.startedAt });
44
+ return state;
45
+ }
46
+ /**
47
+ * 完成 Agent
48
+ */
49
+ complete(id, metadata) {
50
+ const state = this.agents.get(id);
51
+ if (!state)
52
+ return undefined;
53
+ state.status = 'completed';
54
+ state.completedAt = new Date().toISOString();
55
+ if (metadata)
56
+ state.metadata = { ...state.metadata, ...metadata };
57
+ this.emit({ type: 'complete', agentId: id, timestamp: state.completedAt, data: metadata });
58
+ return state;
59
+ }
60
+ /**
61
+ * 标记失败
62
+ */
63
+ fail(id, error) {
64
+ const state = this.agents.get(id);
65
+ if (!state)
66
+ return undefined;
67
+ state.status = 'failed';
68
+ state.error = error;
69
+ this.emit({ type: 'error', agentId: id, timestamp: new Date().toISOString(), data: { error } });
70
+ // 检查回退策略
71
+ this.applyFallbackStrategies(state);
72
+ return state;
73
+ }
74
+ /**
75
+ * 终止 Agent
76
+ */
77
+ terminate(id) {
78
+ const state = this.agents.get(id);
79
+ if (!state)
80
+ return undefined;
81
+ state.status = 'terminated';
82
+ state.completedAt = new Date().toISOString();
83
+ this.emit({ type: 'terminate', agentId: id, timestamp: state.completedAt });
84
+ return state;
85
+ }
86
+ /**
87
+ * 获取 Agent 状态
88
+ */
89
+ getState(id) {
90
+ return this.agents.get(id);
91
+ }
92
+ /**
93
+ * 获取所有 Agent 状态
94
+ */
95
+ getAllStates() {
96
+ return Array.from(this.agents.values());
97
+ }
98
+ /**
99
+ * 按状态过滤
100
+ */
101
+ getByStatus(status) {
102
+ return this.getAllStates().filter(s => s.status === status);
103
+ }
104
+ /**
105
+ * 注册回退策略
106
+ */
107
+ addFallbackStrategy(strategy) {
108
+ this.strategies.push(strategy);
109
+ }
110
+ /**
111
+ * 注册事件处理器
112
+ */
113
+ onEvent(handler) {
114
+ this.eventHandlers.push(handler);
115
+ }
116
+ /**
117
+ * 应用回退策略
118
+ */
119
+ applyFallbackStrategies(state) {
120
+ const config = this.configs.get(state.id);
121
+ if (!config)
122
+ return;
123
+ for (const strategy of this.strategies) {
124
+ if (!strategy.condition(state))
125
+ continue;
126
+ switch (strategy.action) {
127
+ case 'retry': {
128
+ const maxRetries = config.maxRetries ?? 3;
129
+ if (state.retryCount < maxRetries) {
130
+ state.retryCount++;
131
+ state.status = 'running';
132
+ state.error = undefined;
133
+ this.emit({
134
+ type: 'retry',
135
+ agentId: state.id,
136
+ timestamp: new Date().toISOString(),
137
+ data: { attempt: state.retryCount },
138
+ });
139
+ }
140
+ break;
141
+ }
142
+ case 'degrade':
143
+ state.status = 'paused';
144
+ state.metadata.degraded = true;
145
+ break;
146
+ case 'abort':
147
+ state.status = 'terminated';
148
+ break;
149
+ case 'notify':
150
+ // 通知由事件处理器处理
151
+ break;
152
+ }
153
+ }
154
+ }
155
+ emit(event) {
156
+ for (const handler of this.eventHandlers) {
157
+ try {
158
+ handler(event);
159
+ }
160
+ catch {
161
+ // 事件处理器不应影响主流程
162
+ }
163
+ }
164
+ }
165
+ /**
166
+ * 移除 Agent
167
+ */
168
+ remove(id) {
169
+ this.configs.delete(id);
170
+ return this.agents.delete(id);
171
+ }
172
+ /**
173
+ * 清空所有 Agent
174
+ */
175
+ clear() {
176
+ this.agents.clear();
177
+ this.configs.clear();
178
+ }
179
+ }
180
+ exports.AgentLifecycle = AgentLifecycle;
181
+ //# sourceMappingURL=lifecycle.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"lifecycle.js","sourceRoot":"","sources":["../../src/agents/lifecycle.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,42 @@
1
+ /**
2
+ * Agent 生命周期类型定义
3
+ */
4
+ export type AgentStatus = 'idle' | 'starting' | 'running' | 'paused' | 'completed' | 'failed' | 'terminated';
5
+ export interface AgentConfig {
6
+ /** Agent ID */
7
+ id: string;
8
+ /** Agent 名称 */
9
+ name: string;
10
+ /** 工作目录 */
11
+ workingDir: string;
12
+ /** 最大运行时间(ms) */
13
+ maxRunTime?: number;
14
+ /** 失败重试次数 */
15
+ maxRetries?: number;
16
+ /** Sandbox 级别 */
17
+ sandboxLevel?: 1 | 2 | 3 | 4;
18
+ }
19
+ export interface AgentState {
20
+ id: string;
21
+ status: AgentStatus;
22
+ startedAt?: string;
23
+ completedAt?: string;
24
+ error?: string;
25
+ retryCount: number;
26
+ metadata: Record<string, unknown>;
27
+ }
28
+ export interface AgentEvent {
29
+ type: 'start' | 'progress' | 'complete' | 'error' | 'retry' | 'terminate';
30
+ agentId: string;
31
+ timestamp: string;
32
+ data?: unknown;
33
+ }
34
+ export interface FallbackStrategy {
35
+ /** 回退条件 */
36
+ condition: (state: AgentState) => boolean;
37
+ /** 回退动作 */
38
+ action: 'retry' | 'degrade' | 'abort' | 'notify';
39
+ /** 回退参数 */
40
+ params?: Record<string, unknown>;
41
+ }
42
+ //# sourceMappingURL=types.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/agents/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,UAAU,GAAG,SAAS,GAAG,QAAQ,GAAG,WAAW,GAAG,QAAQ,GAAG,YAAY,CAAC;AAE7G,MAAM,WAAW,WAAW;IAC1B,eAAe;IACf,EAAE,EAAE,MAAM,CAAC;IACX,eAAe;IACf,IAAI,EAAE,MAAM,CAAC;IACb,WAAW;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iBAAiB;IACjB,YAAY,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;CAC9B;AAED,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,WAAW,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,OAAO,GAAG,UAAU,GAAG,UAAU,GAAG,OAAO,GAAG,OAAO,GAAG,WAAW,CAAC;IAC1E,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,gBAAgB;IAC/B,WAAW;IACX,SAAS,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,OAAO,CAAC;IAC1C,WAAW;IACX,MAAM,EAAE,OAAO,GAAG,SAAS,GAAG,OAAO,GAAG,QAAQ,CAAC;IACjD,WAAW;IACX,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC"}
@@ -0,0 +1,6 @@
1
+ "use strict";
2
+ /**
3
+ * Agent 生命周期类型定义
4
+ */
5
+ Object.defineProperty(exports, "__esModule", { value: true });
6
+ //# sourceMappingURL=types.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/agents/types.ts"],"names":[],"mappings":";AAAA;;GAEG"}
@@ -24,6 +24,12 @@ export interface ArchitectureResult {
24
24
  passed: boolean;
25
25
  violations: ArchitectureViolation[];
26
26
  }
27
+ export interface ModuleBoundary {
28
+ /** 源文件 glob 模式 */
29
+ from: string;
30
+ /** 禁止导入的目标 glob 模式 */
31
+ denyImport: string;
32
+ }
27
33
  export interface ArchitectureRule {
28
34
  id: string;
29
35
  type: 'forbidden-pattern' | 'file-count' | 'module-boundary' | 'custom';
@@ -32,6 +38,7 @@ export interface ArchitectureRule {
32
38
  message?: string;
33
39
  patterns?: string[];
34
40
  threshold?: number;
41
+ boundaries?: ModuleBoundary[];
35
42
  script?: string;
36
43
  }
37
44
  export declare class ArchitectureConstraintEngine {
@@ -42,6 +49,17 @@ export declare class ArchitectureConstraintEngine {
42
49
  private checkForbiddenPattern;
43
50
  private checkFileCount;
44
51
  private checkModuleBoundary;
52
+ /**
53
+ * 从 diff 中提取每个文件新增的 import 路径
54
+ * 只解析 + 开头的行(新增内容)
55
+ */
56
+ private extractImportsFromDiff;
57
+ /**
58
+ * 解析 import 路径为相对于项目根的路径
59
+ * 相对路径: ./foo, ../bar → 基于导入文件解析
60
+ * 非相对路径: @scope/foo → 返回 null(外部依赖)
61
+ */
62
+ private resolveImport;
45
63
  private matchGlob;
46
64
  }
47
65
  export declare function loadArchitectureRules(configPath: string): Promise<ArchitectureRule[]>;
@@ -1 +1 @@
1
- {"version":3,"file":"constraint-engine.d.ts","sourceRoot":"","sources":["../../src/architecture/constraint-engine.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,CAAC,EAAE;QACH,MAAM,EAAE,MAAM,CAAC;QACf,YAAY,EAAE,MAAM,CAAC;QACrB,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;CACH;AAED,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,EAAE,OAAO,GAAG,SAAS,CAAC;CAC/B;AAED,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,OAAO,CAAC;IAChB,UAAU,EAAE,qBAAqB,EAAE,CAAC;CACrC;AAED,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,mBAAmB,GAAG,YAAY,GAAG,iBAAiB,GAAG,QAAQ,CAAC;IACxE,QAAQ,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAE/B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IAEpB,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,qBAAa,4BAA4B;IAC3B,OAAO,CAAC,KAAK;gBAAL,KAAK,EAAE,gBAAgB,EAAE;IAEvC,KAAK,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,kBAAkB,CAAC;YAcxD,SAAS;IAgBvB,OAAO,CAAC,qBAAqB;IA6B7B,OAAO,CAAC,cAAc;IAkBtB,OAAO,CAAC,mBAAmB;IAQ3B,OAAO,CAAC,SAAS;CAkBlB;AAGD,wBAAsB,qBAAqB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAgB3F;AAiED,wBAAsB,oBAAoB,CACxC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,kBAAkB,CAAC,CAI7B"}
1
+ {"version":3,"file":"constraint-engine.d.ts","sourceRoot":"","sources":["../../src/architecture/constraint-engine.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,CAAC,EAAE;QACH,MAAM,EAAE,MAAM,CAAC;QACf,YAAY,EAAE,MAAM,CAAC;QACrB,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;CACH;AAED,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,EAAE,OAAO,GAAG,SAAS,CAAC;CAC/B;AAED,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,OAAO,CAAC;IAChB,UAAU,EAAE,qBAAqB,EAAE,CAAC;CACrC;AAED,MAAM,WAAW,cAAc;IAC7B,kBAAkB;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,sBAAsB;IACtB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,mBAAmB,GAAG,YAAY,GAAG,iBAAiB,GAAG,QAAQ,CAAC;IACxE,QAAQ,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAE/B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IAEpB,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,UAAU,CAAC,EAAE,cAAc,EAAE,CAAC;IAE9B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,qBAAa,4BAA4B;IAC3B,OAAO,CAAC,KAAK;gBAAL,KAAK,EAAE,gBAAgB,EAAE;IAEvC,KAAK,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,kBAAkB,CAAC;YAcxD,SAAS;IAgBvB,OAAO,CAAC,qBAAqB;IA6B7B,OAAO,CAAC,cAAc;IAkBtB,OAAO,CAAC,mBAAmB;IAiC3B;;;OAGG;IACH,OAAO,CAAC,sBAAsB;IAoC9B;;;;OAIG;IACH,OAAO,CAAC,aAAa;IAoBrB,OAAO,CAAC,SAAS;CA+BlB;AAGD,wBAAsB,qBAAqB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAgB3F;AAiED,wBAAsB,oBAAoB,CACxC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,kBAAkB,CAAC,CAI7B"}
@@ -105,22 +105,114 @@ class ArchitectureConstraintEngine {
105
105
  return [];
106
106
  }
107
107
  checkModuleBoundary(rule, context) {
108
- // TODO: 实现模块边界检查
109
- return [];
108
+ const violations = [];
109
+ const boundaries = rule.boundaries || [];
110
+ if (boundaries.length === 0)
111
+ return [];
112
+ // 从 diff 中提取每个文件新增的 import 语句
113
+ const fileImports = this.extractImportsFromDiff(context.diff);
114
+ for (const boundary of boundaries) {
115
+ for (const [file, imports] of fileImports.entries()) {
116
+ if (!this.matchGlob(file, boundary.from))
117
+ continue;
118
+ for (const importPath of imports) {
119
+ const resolved = this.resolveImport(file, importPath);
120
+ if (resolved && this.matchGlob(resolved, boundary.denyImport)) {
121
+ violations.push({
122
+ ruleId: rule.id,
123
+ message: rule.message || `${file} 不允许导入 ${importPath}(违反模块边界 ${boundary.from} → ${boundary.denyImport})`,
124
+ files: [file],
125
+ severity: rule.severity || 'error',
126
+ });
127
+ }
128
+ }
129
+ }
130
+ }
131
+ return violations;
132
+ }
133
+ /**
134
+ * 从 diff 中提取每个文件新增的 import 路径
135
+ * 只解析 + 开头的行(新增内容)
136
+ */
137
+ extractImportsFromDiff(diff) {
138
+ const result = new Map();
139
+ let currentFile = '';
140
+ for (const line of diff.split('\n')) {
141
+ // 解析 diff 文件头: +++ b/src/foo.ts
142
+ const fileMatch = line.match(/^\+\+\+ b\/(.+)$/);
143
+ if (fileMatch) {
144
+ currentFile = fileMatch[1];
145
+ continue;
146
+ }
147
+ // 只处理新增行
148
+ if (!line.startsWith('+') || line.startsWith('+++'))
149
+ continue;
150
+ if (!currentFile)
151
+ continue;
152
+ const content = line.slice(1);
153
+ // 匹配各种 import 形式
154
+ // import ... from 'path'
155
+ // import 'path'
156
+ // export ... from 'path'
157
+ const importMatch = content.match(/(?:import|export)\s+.*?from\s+['"]([^'"]+)['"]/);
158
+ const sideEffectMatch = content.match(/^import\s+['"]([^'"]+)['"]/);
159
+ const importPath = importMatch?.[1] || sideEffectMatch?.[1];
160
+ if (importPath) {
161
+ const existing = result.get(currentFile) || [];
162
+ existing.push(importPath);
163
+ result.set(currentFile, existing);
164
+ }
165
+ }
166
+ return result;
167
+ }
168
+ /**
169
+ * 解析 import 路径为相对于项目根的路径
170
+ * 相对路径: ./foo, ../bar → 基于导入文件解析
171
+ * 非相对路径: @scope/foo → 返回 null(外部依赖)
172
+ */
173
+ resolveImport(fromFile, importPath) {
174
+ // 外部依赖(非相对路径)跳过
175
+ if (!importPath.startsWith('.'))
176
+ return null;
177
+ const fromDir = fromFile.includes('/') ? fromFile.slice(0, fromFile.lastIndexOf('/')) : '';
178
+ const parts = (fromDir + '/' + importPath).split('/');
179
+ const resolved = [];
180
+ for (const part of parts) {
181
+ if (part === '.' || part === '')
182
+ continue;
183
+ if (part === '..') {
184
+ resolved.pop();
185
+ }
186
+ else {
187
+ resolved.push(part);
188
+ }
189
+ }
190
+ return resolved.join('/');
110
191
  }
111
192
  matchGlob(file, pattern) {
112
193
  // 简化的 glob 匹配
113
194
  let regexPattern = pattern;
114
- // 处理 **/ 开头(匹配任意前缀路径)
195
+ // 用占位符保护 ** 的不同位置,避免被 * 替换破坏
196
+ const DS_MID = '\x00DSM\x00'; // /**/ 中间
197
+ const DS_END = '\x00DSE\x00'; // ** 结尾
198
+ const DS_SRT = '\x00DSS\x00'; // **/ 开头
199
+ // 优先处理 /**/(中间的 **)
200
+ regexPattern = regexPattern.replace(/\/\*\*\//g, `/${DS_MID}/`);
201
+ // 处理 **/ 开头
115
202
  if (regexPattern.startsWith('**/')) {
116
- regexPattern = '(?:.*/)?' + regexPattern.slice(3);
203
+ regexPattern = DS_SRT + regexPattern.slice(3);
117
204
  }
118
- // 处理 /**/(匹配任意中间路径)和 **(匹配任意字符)
205
+ // 处理剩余的 **(结尾)
206
+ regexPattern = regexPattern.replace(/\*\*/g, DS_END);
207
+ // 替换单 *(路径通配符)
208
+ regexPattern = regexPattern.replace(/\*/g, '[^/]*');
209
+ // 恢复 ** 占位符为正则
210
+ const esc = (s) => s.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
119
211
  regexPattern = regexPattern
120
- .replace(/\/\*\*\//g, '/(?:.*/)?') // /**/ -> /(?:.*/)?
121
- .replace(/\*\*/g, '.*') // ** -> .*
122
- .replace(/\*/g, '[^/]*'); // * -> [^/]*
123
- const regex = new RegExp(regexPattern);
212
+ .replace(new RegExp(`/${esc(DS_MID)}/`, 'g'), '/(?:.*/)?')
213
+ .replace(new RegExp(esc(DS_SRT), 'g'), '(?:.*/)?')
214
+ .replace(new RegExp(esc(DS_END), 'g'), '.*');
215
+ const regex = new RegExp(`^${regexPattern}$`);
124
216
  return regex.test(file);
125
217
  }
126
218
  }
@@ -1 +1 @@
1
- {"version":3,"file":"constraint-engine.js","sourceRoot":"","sources":["../../src/architecture/constraint-engine.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"constraint-engine.js","sourceRoot":"","sources":["../../src/architecture/constraint-engine.ts"],"names":[],"mappings":"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"}
@@ -2,6 +2,9 @@
2
2
  * 跨工程接口契约检查
3
3
  *
4
4
  * 检测多工程开发时的接口不一致问题
5
+ *
6
+ * 可通过 CrossProjectConfig 自定义工程依赖关系和契约位置,
7
+ * 使此模块适用于任意多工程项目,而非仅限于 agent-studio 生态。
5
8
  */
6
9
  export interface CrossProjectViolation {
7
10
  type: 'api-mismatch' | 'doc-code-mismatch' | 'breaking-change' | 'missing-implementation';
@@ -22,10 +25,25 @@ export interface CrossProjectContext {
22
25
  changedProjects: string[];
23
26
  changedFiles: string[];
24
27
  }
28
+ /**
29
+ * 跨工程检查配置
30
+ *
31
+ * 允许调用方自定义工程依赖关系和契约位置,
32
+ * 而非使用硬编码的默认值。
33
+ */
34
+ export interface CrossProjectConfig {
35
+ /** 工程依赖关系图:project -> 它依赖的项目列表 */
36
+ dependencies: Record<string, string[]>;
37
+ /** 接口契约定义位置:pair name -> 文件路径列表 */
38
+ contractLocations: Record<string, string[]>;
39
+ }
25
40
  /**
26
41
  * 检查跨工程接口一致性
42
+ *
43
+ * @param context 跨工程上下文
44
+ * @param config 工程依赖关系和契约位置配置
27
45
  */
28
- export declare function checkCrossProjectContracts(context: CrossProjectContext): Promise<CrossProjectViolation[]>;
46
+ export declare function checkCrossProjectContracts(context: CrossProjectContext, config: CrossProjectConfig): Promise<CrossProjectViolation[]>;
29
47
  /**
30
48
  * 检查文档-代码一致性
31
49
  * 场景:文档写了接口,代码没实现
@@ -1 +1 @@
1
- {"version":3,"file":"cross-project-checker.d.ts","sourceRoot":"","sources":["../../src/architecture/cross-project-checker.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,cAAc,GAAG,mBAAmB,GAAG,iBAAiB,GAAG,wBAAwB,CAAC;IAC1F,QAAQ,EAAE,OAAO,GAAG,SAAS,CAAC;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE;QACP,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,CAAC;CACH;AAED,MAAM,WAAW,mBAAmB;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAsBD;;GAEG;AACH,wBAAsB,0BAA0B,CAC9C,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,qBAAqB,EAAE,CAAC,CAalC;AAyGD;;;GAGG;AACH,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAAE,GACjB,OAAO,CAAC,qBAAqB,EAAE,CAAC,CA4ClC"}
1
+ {"version":3,"file":"cross-project-checker.d.ts","sourceRoot":"","sources":["../../src/architecture/cross-project-checker.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,cAAc,GAAG,mBAAmB,GAAG,iBAAiB,GAAG,wBAAwB,CAAC;IAC1F,QAAQ,EAAE,OAAO,GAAG,SAAS,CAAC;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE;QACP,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,CAAC;CACH;AAED,MAAM,WAAW,mBAAmB;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAED;;;;;GAKG;AACH,MAAM,WAAW,kBAAkB;IACjC,kCAAkC;IAClC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IACvC,mCAAmC;IACnC,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;CAC7C;AAED;;;;;GAKG;AACH,wBAAsB,0BAA0B,CAC9C,OAAO,EAAE,mBAAmB,EAC5B,MAAM,EAAE,kBAAkB,GACzB,OAAO,CAAC,qBAAqB,EAAE,CAAC,CAclC;AAsHD;;;GAGG;AACH,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAAE,GACjB,OAAO,CAAC,qBAAqB,EAAE,CAAC,CA4ClC"}