@llipe.com/dev-tasks 0.6.6 → 0.7.3

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 (352) hide show
  1. package/.claude/agents/developer.md +2 -0
  2. package/.claude/commands/developer.md +2 -0
  3. package/.claude/commands/planner.md +2 -0
  4. package/.claude/commands/product-engineer.md +13 -7
  5. package/.claude/skills/activity-init/SKILL.md +81 -8
  6. package/.github/agents/developer.agent.md +2 -0
  7. package/.github/agents/planner.agent.md +2 -0
  8. package/.github/agents/product-engineer.agent.md +13 -7
  9. package/.github/prompts/product-engineer-init.prompt.md +7 -1
  10. package/.github/skills/activity-init/SKILL.md +81 -8
  11. package/.kiro/agents/developer.md +2 -0
  12. package/.kiro/agents/planner.md +2 -0
  13. package/.kiro/agents/product-engineer.md +13 -7
  14. package/.kiro/skills/activity-init/SKILL.md +81 -8
  15. package/AGENTS.md +96 -1
  16. package/CHANGELOG.md +96 -0
  17. package/README.md +288 -632
  18. package/dist/adapters/cli/catalog-build.d.ts +30 -0
  19. package/dist/adapters/cli/catalog-build.d.ts.map +1 -0
  20. package/dist/adapters/cli/catalog-build.js +73 -0
  21. package/dist/adapters/cli/catalog-build.js.map +1 -0
  22. package/dist/adapters/cli/catalog-query.d.ts +13 -0
  23. package/dist/adapters/cli/catalog-query.d.ts.map +1 -0
  24. package/dist/adapters/cli/catalog-query.js +329 -0
  25. package/dist/adapters/cli/catalog-query.js.map +1 -0
  26. package/dist/adapters/cli/catalog-scaffold.d.ts +24 -0
  27. package/dist/adapters/cli/catalog-scaffold.d.ts.map +1 -0
  28. package/dist/adapters/cli/catalog-scaffold.js +46 -0
  29. package/dist/adapters/cli/catalog-scaffold.js.map +1 -0
  30. package/dist/adapters/cli/catalog-validate.d.ts +35 -0
  31. package/dist/adapters/cli/catalog-validate.d.ts.map +1 -0
  32. package/dist/adapters/cli/catalog-validate.js +122 -0
  33. package/dist/adapters/cli/catalog-validate.js.map +1 -0
  34. package/dist/adapters/cli/ctx-assemble.d.ts +19 -0
  35. package/dist/adapters/cli/ctx-assemble.d.ts.map +1 -0
  36. package/dist/adapters/cli/ctx-assemble.js +293 -0
  37. package/dist/adapters/cli/ctx-assemble.js.map +1 -0
  38. package/dist/adapters/cli/ctx-fetch.d.ts +49 -0
  39. package/dist/adapters/cli/ctx-fetch.d.ts.map +1 -0
  40. package/dist/adapters/cli/ctx-fetch.js +267 -0
  41. package/dist/adapters/cli/ctx-fetch.js.map +1 -0
  42. package/dist/adapters/cli/extract-all.d.ts +2 -2
  43. package/dist/adapters/cli/extract-all.d.ts.map +1 -1
  44. package/dist/adapters/cli/extract-all.js.map +1 -1
  45. package/dist/adapters/cli/extract-component.d.ts +2 -2
  46. package/dist/adapters/cli/extract-component.d.ts.map +1 -1
  47. package/dist/adapters/cli/extract-component.js.map +1 -1
  48. package/dist/adapters/cli/init.d.ts +37 -0
  49. package/dist/adapters/cli/init.d.ts.map +1 -0
  50. package/dist/adapters/cli/init.js +336 -0
  51. package/dist/adapters/cli/init.js.map +1 -0
  52. package/dist/adapters/cli/scope-gate.d.ts +25 -0
  53. package/dist/adapters/cli/scope-gate.d.ts.map +1 -0
  54. package/dist/adapters/cli/scope-gate.js +157 -0
  55. package/dist/adapters/cli/scope-gate.js.map +1 -0
  56. package/dist/adapters/cli/scope.d.ts +26 -0
  57. package/dist/adapters/cli/scope.d.ts.map +1 -0
  58. package/dist/adapters/cli/scope.js +172 -0
  59. package/dist/adapters/cli/scope.js.map +1 -0
  60. package/dist/adapters/cli/validate-component.d.ts +24 -0
  61. package/dist/adapters/cli/validate-component.d.ts.map +1 -0
  62. package/dist/adapters/cli/validate-component.js +62 -0
  63. package/dist/adapters/cli/validate-component.js.map +1 -0
  64. package/dist/adapters/cli/verify-contract-diff.d.ts +21 -0
  65. package/dist/adapters/cli/verify-contract-diff.d.ts.map +1 -0
  66. package/dist/adapters/cli/verify-contract-diff.js +69 -0
  67. package/dist/adapters/cli/verify-contract-diff.js.map +1 -0
  68. package/dist/adapters/cli/verify-drift.d.ts +24 -0
  69. package/dist/adapters/cli/verify-drift.d.ts.map +1 -0
  70. package/dist/adapters/cli/verify-drift.js +103 -0
  71. package/dist/adapters/cli/verify-drift.js.map +1 -0
  72. package/dist/adapters/cli/verify-impact.d.ts +23 -0
  73. package/dist/adapters/cli/verify-impact.d.ts.map +1 -0
  74. package/dist/adapters/cli/verify-impact.js +119 -0
  75. package/dist/adapters/cli/verify-impact.js.map +1 -0
  76. package/dist/bin/dev-tasks.d.ts +1 -1
  77. package/dist/bin/dev-tasks.js +28 -6
  78. package/dist/bin/dev-tasks.js.map +1 -1
  79. package/dist/bin/dt.js +488 -0
  80. package/dist/bin/dt.js.map +1 -1
  81. package/dist/core/catalog/build.d.ts +143 -0
  82. package/dist/core/catalog/build.d.ts.map +1 -0
  83. package/dist/core/catalog/build.js +475 -0
  84. package/dist/core/catalog/build.js.map +1 -0
  85. package/dist/core/catalog/checks/index.d.ts +18 -0
  86. package/dist/core/catalog/checks/index.d.ts.map +1 -0
  87. package/dist/core/catalog/checks/index.js +18 -0
  88. package/dist/core/catalog/checks/index.js.map +1 -0
  89. package/dist/core/catalog/checks/v01-schema.d.ts +17 -0
  90. package/dist/core/catalog/checks/v01-schema.d.ts.map +1 -0
  91. package/dist/core/catalog/checks/v01-schema.js +57 -0
  92. package/dist/core/catalog/checks/v01-schema.js.map +1 -0
  93. package/dist/core/catalog/checks/v02-v03-identity.d.ts +14 -0
  94. package/dist/core/catalog/checks/v02-v03-identity.d.ts.map +1 -0
  95. package/dist/core/catalog/checks/v02-v03-identity.js +60 -0
  96. package/dist/core/catalog/checks/v02-v03-identity.js.map +1 -0
  97. package/dist/core/catalog/checks/v04-referential-integrity.d.ts +7 -0
  98. package/dist/core/catalog/checks/v04-referential-integrity.d.ts.map +1 -0
  99. package/dist/core/catalog/checks/v04-referential-integrity.js +32 -0
  100. package/dist/core/catalog/checks/v04-referential-integrity.js.map +1 -0
  101. package/dist/core/catalog/checks/v05-domain-existence.d.ts +6 -0
  102. package/dist/core/catalog/checks/v05-domain-existence.d.ts.map +1 -0
  103. package/dist/core/catalog/checks/v05-domain-existence.js +23 -0
  104. package/dist/core/catalog/checks/v05-domain-existence.js.map +1 -0
  105. package/dist/core/catalog/checks/v06-v07-paths.d.ts +29 -0
  106. package/dist/core/catalog/checks/v06-v07-paths.d.ts.map +1 -0
  107. package/dist/core/catalog/checks/v06-v07-paths.js +107 -0
  108. package/dist/core/catalog/checks/v06-v07-paths.js.map +1 -0
  109. package/dist/core/catalog/checks/v08-v10-contracts.d.ts +13 -0
  110. package/dist/core/catalog/checks/v08-v10-contracts.d.ts.map +1 -0
  111. package/dist/core/catalog/checks/v08-v10-contracts.js +70 -0
  112. package/dist/core/catalog/checks/v08-v10-contracts.js.map +1 -0
  113. package/dist/core/catalog/checks/v11-manual-fields.d.ts +16 -0
  114. package/dist/core/catalog/checks/v11-manual-fields.d.ts.map +1 -0
  115. package/dist/core/catalog/checks/v11-manual-fields.js +60 -0
  116. package/dist/core/catalog/checks/v11-manual-fields.js.map +1 -0
  117. package/dist/core/catalog/checks/v12-cycles.d.ts +8 -0
  118. package/dist/core/catalog/checks/v12-cycles.d.ts.map +1 -0
  119. package/dist/core/catalog/checks/v12-cycles.js +28 -0
  120. package/dist/core/catalog/checks/v12-cycles.js.map +1 -0
  121. package/dist/core/catalog/checks/v13-orphan-contracts.d.ts +7 -0
  122. package/dist/core/catalog/checks/v13-orphan-contracts.d.ts.map +1 -0
  123. package/dist/core/catalog/checks/v13-orphan-contracts.js +33 -0
  124. package/dist/core/catalog/checks/v13-orphan-contracts.js.map +1 -0
  125. package/dist/core/catalog/checks/v14-v15-lifecycle.d.ts +8 -0
  126. package/dist/core/catalog/checks/v14-v15-lifecycle.d.ts.map +1 -0
  127. package/dist/core/catalog/checks/v14-v15-lifecycle.js +42 -0
  128. package/dist/core/catalog/checks/v14-v15-lifecycle.js.map +1 -0
  129. package/dist/core/catalog/checks/v16-deprecated-consumers.d.ts +7 -0
  130. package/dist/core/catalog/checks/v16-deprecated-consumers.d.ts.map +1 -0
  131. package/dist/core/catalog/checks/v16-deprecated-consumers.js +47 -0
  132. package/dist/core/catalog/checks/v16-deprecated-consumers.js.map +1 -0
  133. package/dist/core/catalog/checks/v17-low-confidence.d.ts +7 -0
  134. package/dist/core/catalog/checks/v17-low-confidence.d.ts.map +1 -0
  135. package/dist/core/catalog/checks/v17-low-confidence.js +32 -0
  136. package/dist/core/catalog/checks/v17-low-confidence.js.map +1 -0
  137. package/dist/core/catalog/checks/v18-low-payload.d.ts +7 -0
  138. package/dist/core/catalog/checks/v18-low-payload.d.ts.map +1 -0
  139. package/dist/core/catalog/checks/v18-low-payload.js +33 -0
  140. package/dist/core/catalog/checks/v18-low-payload.js.map +1 -0
  141. package/dist/core/catalog/checks/v19-domain-membership.d.ts +8 -0
  142. package/dist/core/catalog/checks/v19-domain-membership.d.ts.map +1 -0
  143. package/dist/core/catalog/checks/v19-domain-membership.js +55 -0
  144. package/dist/core/catalog/checks/v19-domain-membership.js.map +1 -0
  145. package/dist/core/catalog/coverage.d.ts +39 -0
  146. package/dist/core/catalog/coverage.d.ts.map +1 -0
  147. package/dist/core/catalog/coverage.js +62 -0
  148. package/dist/core/catalog/coverage.js.map +1 -0
  149. package/dist/core/catalog/graph.d.ts +49 -0
  150. package/dist/core/catalog/graph.d.ts.map +1 -0
  151. package/dist/core/catalog/graph.js +114 -0
  152. package/dist/core/catalog/graph.js.map +1 -0
  153. package/dist/core/catalog/index-model.d.ts +96 -0
  154. package/dist/core/catalog/index-model.d.ts.map +1 -0
  155. package/dist/core/catalog/index-model.js +8 -0
  156. package/dist/core/catalog/index-model.js.map +1 -0
  157. package/dist/core/catalog/queries.d.ts +69 -0
  158. package/dist/core/catalog/queries.d.ts.map +1 -0
  159. package/dist/core/catalog/queries.js +165 -0
  160. package/dist/core/catalog/queries.js.map +1 -0
  161. package/dist/core/catalog/resolve.d.ts +47 -0
  162. package/dist/core/catalog/resolve.d.ts.map +1 -0
  163. package/dist/core/catalog/resolve.js +318 -0
  164. package/dist/core/catalog/resolve.js.map +1 -0
  165. package/dist/core/catalog/scaffold.d.ts +31 -0
  166. package/dist/core/catalog/scaffold.d.ts.map +1 -0
  167. package/dist/core/catalog/scaffold.js +141 -0
  168. package/dist/core/catalog/scaffold.js.map +1 -0
  169. package/dist/core/catalog/validate-component.d.ts +50 -0
  170. package/dist/core/catalog/validate-component.d.ts.map +1 -0
  171. package/dist/core/catalog/validate-component.js +105 -0
  172. package/dist/core/catalog/validate-component.js.map +1 -0
  173. package/dist/core/catalog/validate.d.ts +71 -0
  174. package/dist/core/catalog/validate.d.ts.map +1 -0
  175. package/dist/core/catalog/validate.js +103 -0
  176. package/dist/core/catalog/validate.js.map +1 -0
  177. package/dist/core/context/assemble.d.ts +126 -0
  178. package/dist/core/context/assemble.d.ts.map +1 -0
  179. package/dist/core/context/assemble.js +197 -0
  180. package/dist/core/context/assemble.js.map +1 -0
  181. package/dist/core/context/cache.d.ts +60 -0
  182. package/dist/core/context/cache.d.ts.map +1 -0
  183. package/dist/core/context/cache.js +236 -0
  184. package/dist/core/context/cache.js.map +1 -0
  185. package/dist/core/context/exit-codes.d.ts +28 -0
  186. package/dist/core/context/exit-codes.d.ts.map +1 -0
  187. package/dist/core/context/exit-codes.js +28 -0
  188. package/dist/core/context/exit-codes.js.map +1 -0
  189. package/dist/core/context/fetch.d.ts +55 -0
  190. package/dist/core/context/fetch.d.ts.map +1 -0
  191. package/dist/core/context/fetch.js +112 -0
  192. package/dist/core/context/fetch.js.map +1 -0
  193. package/dist/core/context/index.d.ts +7 -1
  194. package/dist/core/context/index.d.ts.map +1 -1
  195. package/dist/core/context/index.js +7 -1
  196. package/dist/core/context/index.js.map +1 -1
  197. package/dist/core/context/init.d.ts +179 -0
  198. package/dist/core/context/init.d.ts.map +1 -0
  199. package/dist/core/context/init.js +532 -0
  200. package/dist/core/context/init.js.map +1 -0
  201. package/dist/core/context/layers/architecture-layer.d.ts +13 -0
  202. package/dist/core/context/layers/architecture-layer.d.ts.map +1 -0
  203. package/dist/core/context/layers/architecture-layer.js +24 -0
  204. package/dist/core/context/layers/architecture-layer.js.map +1 -0
  205. package/dist/core/context/layers/contracts-layer.d.ts +13 -0
  206. package/dist/core/context/layers/contracts-layer.d.ts.map +1 -0
  207. package/dist/core/context/layers/contracts-layer.js +83 -0
  208. package/dist/core/context/layers/contracts-layer.js.map +1 -0
  209. package/dist/core/context/layers/conventions-delta-layer.d.ts +13 -0
  210. package/dist/core/context/layers/conventions-delta-layer.d.ts.map +1 -0
  211. package/dist/core/context/layers/conventions-delta-layer.js +37 -0
  212. package/dist/core/context/layers/conventions-delta-layer.js.map +1 -0
  213. package/dist/core/context/layers/flow-layer.d.ts +14 -0
  214. package/dist/core/context/layers/flow-layer.d.ts.map +1 -0
  215. package/dist/core/context/layers/flow-layer.js +61 -0
  216. package/dist/core/context/layers/flow-layer.js.map +1 -0
  217. package/dist/core/context/layers/index-layer.d.ts +13 -0
  218. package/dist/core/context/layers/index-layer.d.ts.map +1 -0
  219. package/dist/core/context/layers/index-layer.js +77 -0
  220. package/dist/core/context/layers/index-layer.js.map +1 -0
  221. package/dist/core/context/layers/primary-layer.d.ts +16 -0
  222. package/dist/core/context/layers/primary-layer.d.ts.map +1 -0
  223. package/dist/core/context/layers/primary-layer.js +61 -0
  224. package/dist/core/context/layers/primary-layer.js.map +1 -0
  225. package/dist/core/context/layers/secondary-layer.d.ts +19 -0
  226. package/dist/core/context/layers/secondary-layer.d.ts.map +1 -0
  227. package/dist/core/context/layers/secondary-layer.js +52 -0
  228. package/dist/core/context/layers/secondary-layer.js.map +1 -0
  229. package/dist/core/context/session-lock.d.ts +114 -0
  230. package/dist/core/context/session-lock.d.ts.map +1 -0
  231. package/dist/core/context/session-lock.js +90 -0
  232. package/dist/core/context/session-lock.js.map +1 -0
  233. package/dist/core/context/tokens.d.ts +35 -0
  234. package/dist/core/context/tokens.d.ts.map +1 -0
  235. package/dist/core/context/tokens.js +88 -0
  236. package/dist/core/context/tokens.js.map +1 -0
  237. package/dist/core/distribution/fetch-package.d.ts +18 -0
  238. package/dist/core/distribution/fetch-package.d.ts.map +1 -0
  239. package/dist/core/distribution/fetch-package.js +42 -0
  240. package/dist/core/distribution/fetch-package.js.map +1 -0
  241. package/dist/core/distribution/index.d.ts +3 -1
  242. package/dist/core/distribution/index.d.ts.map +1 -1
  243. package/dist/core/distribution/index.js +2 -1
  244. package/dist/core/distribution/index.js.map +1 -1
  245. package/dist/core/distribution/install.d.ts +1 -1
  246. package/dist/core/distribution/install.d.ts.map +1 -1
  247. package/dist/core/distribution/install.js +10 -2
  248. package/dist/core/distribution/install.js.map +1 -1
  249. package/dist/core/distribution/pin.d.ts +5 -0
  250. package/dist/core/distribution/pin.d.ts.map +1 -1
  251. package/dist/core/distribution/pin.js +17 -1
  252. package/dist/core/distribution/pin.js.map +1 -1
  253. package/dist/core/distribution/update.d.ts +11 -1
  254. package/dist/core/distribution/update.d.ts.map +1 -1
  255. package/dist/core/distribution/update.js +45 -1
  256. package/dist/core/distribution/update.js.map +1 -1
  257. package/dist/core/exit-codes.d.ts +30 -1
  258. package/dist/core/exit-codes.d.ts.map +1 -1
  259. package/dist/core/exit-codes.js +31 -1
  260. package/dist/core/exit-codes.js.map +1 -1
  261. package/dist/core/extract/component.d.ts +11 -8
  262. package/dist/core/extract/component.d.ts.map +1 -1
  263. package/dist/core/extract/component.js.map +1 -1
  264. package/dist/core/extract/index.d.ts +1 -1
  265. package/dist/core/extract/index.d.ts.map +1 -1
  266. package/dist/core/extract/openapi/route1.d.ts.map +1 -1
  267. package/dist/core/extract/openapi/route1.js +6 -0
  268. package/dist/core/extract/openapi/route1.js.map +1 -1
  269. package/dist/core/extract/providers/node-ts.d.ts.map +1 -1
  270. package/dist/core/extract/providers/node-ts.js +9 -0
  271. package/dist/core/extract/providers/node-ts.js.map +1 -1
  272. package/dist/core/index.d.ts +1 -0
  273. package/dist/core/index.d.ts.map +1 -1
  274. package/dist/core/index.js +1 -0
  275. package/dist/core/index.js.map +1 -1
  276. package/dist/core/providers/index.d.ts +3 -2
  277. package/dist/core/providers/index.d.ts.map +1 -1
  278. package/dist/core/providers/index.js +1 -1
  279. package/dist/core/providers/index.js.map +1 -1
  280. package/dist/core/providers/tracker.d.ts +74 -0
  281. package/dist/core/providers/tracker.d.ts.map +1 -0
  282. package/dist/core/providers/tracker.js +38 -0
  283. package/dist/core/providers/tracker.js.map +1 -0
  284. package/dist/core/scope/calibration.d.ts +25 -0
  285. package/dist/core/scope/calibration.d.ts.map +1 -0
  286. package/dist/core/scope/calibration.js +52 -0
  287. package/dist/core/scope/calibration.js.map +1 -0
  288. package/dist/core/scope/closure.d.ts +31 -0
  289. package/dist/core/scope/closure.d.ts.map +1 -0
  290. package/dist/core/scope/closure.js +68 -0
  291. package/dist/core/scope/closure.js.map +1 -0
  292. package/dist/core/scope/gate.d.ts +41 -0
  293. package/dist/core/scope/gate.d.ts.map +1 -0
  294. package/dist/core/scope/gate.js +165 -0
  295. package/dist/core/scope/gate.js.map +1 -0
  296. package/dist/core/scope/index.d.ts +15 -2
  297. package/dist/core/scope/index.d.ts.map +1 -1
  298. package/dist/core/scope/index.js +11 -1
  299. package/dist/core/scope/index.js.map +1 -1
  300. package/dist/core/scope/partition.d.ts +36 -0
  301. package/dist/core/scope/partition.d.ts.map +1 -0
  302. package/dist/core/scope/partition.js +78 -0
  303. package/dist/core/scope/partition.js.map +1 -0
  304. package/dist/core/scope/prompt.d.ts +39 -0
  305. package/dist/core/scope/prompt.d.ts.map +1 -0
  306. package/dist/core/scope/prompt.js +123 -0
  307. package/dist/core/scope/prompt.js.map +1 -0
  308. package/dist/core/scope/scoping.d.ts +52 -0
  309. package/dist/core/scope/scoping.d.ts.map +1 -0
  310. package/dist/core/scope/scoping.js +99 -0
  311. package/dist/core/scope/scoping.js.map +1 -0
  312. package/dist/core/scope/types.d.ts +77 -0
  313. package/dist/core/scope/types.d.ts.map +1 -0
  314. package/dist/core/scope/types.js +5 -0
  315. package/dist/core/scope/types.js.map +1 -0
  316. package/dist/core/scope/validate.d.ts +47 -0
  317. package/dist/core/scope/validate.d.ts.map +1 -0
  318. package/dist/core/scope/validate.js +90 -0
  319. package/dist/core/scope/validate.js.map +1 -0
  320. package/dist/core/verify/asyncapi-diff.d.ts +34 -0
  321. package/dist/core/verify/asyncapi-diff.d.ts.map +1 -0
  322. package/dist/core/verify/asyncapi-diff.js +209 -0
  323. package/dist/core/verify/asyncapi-diff.js.map +1 -0
  324. package/dist/core/verify/contract-diff.d.ts +39 -0
  325. package/dist/core/verify/contract-diff.d.ts.map +1 -0
  326. package/dist/core/verify/contract-diff.js +63 -0
  327. package/dist/core/verify/contract-diff.js.map +1 -0
  328. package/dist/core/verify/drift.d.ts +47 -0
  329. package/dist/core/verify/drift.d.ts.map +1 -0
  330. package/dist/core/verify/drift.js +122 -0
  331. package/dist/core/verify/drift.js.map +1 -0
  332. package/dist/core/verify/impact.d.ts +22 -0
  333. package/dist/core/verify/impact.d.ts.map +1 -0
  334. package/dist/core/verify/impact.js +93 -0
  335. package/dist/core/verify/impact.js.map +1 -0
  336. package/dist/core/verify/index.d.ts +10 -0
  337. package/dist/core/verify/index.d.ts.map +1 -0
  338. package/dist/core/verify/index.js +9 -0
  339. package/dist/core/verify/index.js.map +1 -0
  340. package/dist/core/verify/openapi-diff.d.ts +29 -0
  341. package/dist/core/verify/openapi-diff.d.ts.map +1 -0
  342. package/dist/core/verify/openapi-diff.js +291 -0
  343. package/dist/core/verify/openapi-diff.js.map +1 -0
  344. package/dist/core/verify/types.d.ts +138 -0
  345. package/dist/core/verify/types.d.ts.map +1 -0
  346. package/dist/core/verify/types.js +5 -0
  347. package/dist/core/verify/types.js.map +1 -0
  348. package/package.json +11 -2
  349. package/schemas/component.schema.json +203 -0
  350. package/schemas/flow.schema.json +75 -0
  351. package/schemas/scope-output.schema.json +62 -0
  352. package/schemas/.gitkeep +0 -0
@@ -0,0 +1,123 @@
1
+ /**
2
+ * Scoping prompt template and input assembler.
3
+ *
4
+ * The scoping prompt instructs the LLM to:
5
+ * - Choose only from provided candidates
6
+ * - Use `low` confidence when ambiguous
7
+ * - List unmapped capabilities in `unresolved`
8
+ *
9
+ * The input assembler builds the constrained input containing only:
10
+ * task, candidates, flows, domains (spec §7.1).
11
+ */
12
+ /* ─── System Prompt ───────────────────────────────────────────────────── */
13
+ /**
14
+ * The system prompt for the scoping LLM call.
15
+ * Instructs the model on constraints and output format.
16
+ */
17
+ export const SCOPING_SYSTEM_PROMPT = `You are a code-change scoping assistant. Your task is to determine which components from a service catalog are affected by a given task description.
18
+
19
+ ## Rules
20
+
21
+ 1. **Only choose from the provided candidates list.** Never invent component ids.
22
+ 2. When ambiguous or uncertain, set confidence to "low".
23
+ 3. Any capability the task mentions that you cannot map to a candidate MUST be listed in "unresolved".
24
+ 4. Primary components are those that need a code change. Secondary are needed for understanding context only.
25
+ 5. Primary: 1 to 6 items. Secondary: 0 to 8 items.
26
+ 6. Contracts crossed: list contract ids from provides/consumes that the task touches or depends on.
27
+ 7. Rationale: explain your reasoning in at most 600 characters.
28
+
29
+ ## Output Format
30
+
31
+ Return a single JSON object conforming to this structure:
32
+ {
33
+ "schemaVersion": "1.0.0",
34
+ "primary": ["<component-id>", ...],
35
+ "secondary": ["<component-id>", ...],
36
+ "contracts_crossed": ["<contract-id>", ...],
37
+ "confidence": "high" | "medium" | "low",
38
+ "unresolved": ["<capability-description>", ...],
39
+ "rationale": "<explanation, max 600 chars>",
40
+ "flow": "<optional flow-id>"
41
+ }
42
+
43
+ Return ONLY the JSON object. No markdown, no explanation, no wrapping.`;
44
+ /**
45
+ * The repair prompt sent when the first LLM response fails validation.
46
+ */
47
+ export const REPAIR_PROMPT_PREFIX = `Your previous response failed validation with the following errors:
48
+
49
+ `;
50
+ export const REPAIR_PROMPT_SUFFIX = `
51
+
52
+ Please fix the issues and return a corrected JSON object. Remember:
53
+ - Only use component ids from the candidates list provided earlier.
54
+ - Follow the exact schema (required: schemaVersion, primary, secondary, contracts_crossed, confidence, unresolved, rationale).
55
+ - Rationale must be at most 600 characters.
56
+ - Return ONLY the JSON object.`;
57
+ /* ─── Input Assembler ─────────────────────────────────────────────────── */
58
+ /**
59
+ * Build the scoping input from task text and resolve results.
60
+ * The input contains ONLY task, candidates, flows, and domains — never the full catalog.
61
+ *
62
+ * @param taskText - The task description text
63
+ * @param resolveResults - Candidate components from the resolve step
64
+ * @param index - The catalog index (used to look up component details, flows, domains)
65
+ * @returns The constrained scoping input
66
+ */
67
+ export function buildScopingInput(taskText, resolveResults, index) {
68
+ // Build candidate list from resolve results
69
+ const candidateIds = new Set(resolveResults.map((r) => r.id));
70
+ const candidates = [];
71
+ for (const result of resolveResults) {
72
+ const comp = index.components.find((c) => c.id === result.id);
73
+ if (!comp)
74
+ continue;
75
+ candidates.push(componentToCandidate(comp));
76
+ }
77
+ // Filter flows to only those with participants in the candidate set
78
+ const flows = index.flows
79
+ .filter((f) => f.participants.some((p) => candidateIds.has(p)))
80
+ .map((f) => flowToScopingFlow(f));
81
+ // Filter domains to only those containing candidate components
82
+ const domains = index.domains
83
+ .filter((d) => d.components.some((c) => candidateIds.has(c)))
84
+ .map((d) => domainToScopingDomain(d, candidateIds));
85
+ return {
86
+ task: taskText,
87
+ candidates,
88
+ flows,
89
+ domains,
90
+ };
91
+ }
92
+ /**
93
+ * Serialize the scoping input to a string for the LLM user message.
94
+ */
95
+ export function serializeScopingInput(input) {
96
+ return JSON.stringify(input, null, 2);
97
+ }
98
+ /* ─── Internal Helpers ────────────────────────────────────────────────── */
99
+ function componentToCandidate(comp) {
100
+ return {
101
+ id: comp.id,
102
+ name: comp.name,
103
+ description: comp.description,
104
+ domain: comp.domain,
105
+ provides: comp.provides.map((p) => p.id),
106
+ consumes: comp.consumes.map((c) => c.contract),
107
+ };
108
+ }
109
+ function flowToScopingFlow(flow) {
110
+ return {
111
+ id: flow.id,
112
+ name: flow.name,
113
+ participants: flow.participants,
114
+ };
115
+ }
116
+ function domainToScopingDomain(domain, candidateIds) {
117
+ return {
118
+ name: domain.name,
119
+ // Only include components that are in the candidate set
120
+ components: domain.components.filter((c) => candidateIds.has(c)),
121
+ };
122
+ }
123
+ //# sourceMappingURL=prompt.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"prompt.js","sourceRoot":"","sources":["../../../core/scope/prompt.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,52 @@
1
+ /**
2
+ * LLM scoping orchestrator.
3
+ *
4
+ * Orchestrates: prompt assembly → LLM call → schema validation →
5
+ * post-schema id validation → single repair retry → calibration recording.
6
+ *
7
+ * Exit 10 on second validation failure (invalid scope after retry).
8
+ */
9
+ import type { CatalogIndex } from "../catalog/index-model.js";
10
+ import type { ResolveCandidate } from "../catalog/resolve.js";
11
+ import type { LlmScopeProvider, ScopeOutput } from "./types.js";
12
+ export interface ScopingOptions {
13
+ /** The task description text */
14
+ taskText: string;
15
+ /** Resolve results (candidates) */
16
+ candidates: ResolveCandidate[];
17
+ /** The catalog index */
18
+ index: CatalogIndex;
19
+ /** LLM provider for the scoping call */
20
+ llmProvider: LlmScopeProvider;
21
+ /** Base directory for calibration output (default: cwd) */
22
+ baseDir?: string;
23
+ /** If true, skip writing calibration data */
24
+ skipCalibration?: boolean;
25
+ }
26
+ export interface ScopingSuccess {
27
+ success: true;
28
+ output: ScopeOutput;
29
+ repairAttempted: boolean;
30
+ calibrationPath?: string;
31
+ }
32
+ export interface ScopingFailure {
33
+ success: false;
34
+ errors: string[];
35
+ repairAttempted: boolean;
36
+ }
37
+ export type ScopingResult = ScopingSuccess | ScopingFailure;
38
+ /** Exit code for invalid scope after retry (spec §8.2) */
39
+ export declare const EXIT_INVALID_SCOPE = 10;
40
+ /**
41
+ * Run the LLM scoping step with schema-validated output and repair retry.
42
+ *
43
+ * Steps:
44
+ * 1. Build constrained input (task, candidates, flows, domains)
45
+ * 2. Call LLM with system prompt + input
46
+ * 3. Parse and validate response (schema + id check)
47
+ * 4. On failure: send repair prompt with error context → validate again
48
+ * 5. Second failure → return failure result (caller exits 10)
49
+ * 6. On success: record calibration data
50
+ */
51
+ export declare function runScoping(options: ScopingOptions): Promise<ScopingResult>;
52
+ //# sourceMappingURL=scoping.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"scoping.d.ts","sourceRoot":"","sources":["../../../core/scope/scoping.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAU9D,OAAO,KAAK,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAIhE,MAAM,WAAW,cAAc;IAC7B,gCAAgC;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,mCAAmC;IACnC,UAAU,EAAE,gBAAgB,EAAE,CAAC;IAC/B,wBAAwB;IACxB,KAAK,EAAE,YAAY,CAAC;IACpB,wCAAwC;IACxC,WAAW,EAAE,gBAAgB,CAAC;IAC9B,2DAA2D;IAC3D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,6CAA6C;IAC7C,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,IAAI,CAAC;IACd,MAAM,EAAE,WAAW,CAAC;IACpB,eAAe,EAAE,OAAO,CAAC;IACzB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,KAAK,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,eAAe,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,MAAM,aAAa,GAAG,cAAc,GAAG,cAAc,CAAC;AAI5D,0DAA0D;AAC1D,eAAO,MAAM,kBAAkB,KAAK,CAAC;AAIrC;;;;;;;;;;GAUG;AACH,wBAAsB,UAAU,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC,CA4DhF"}
@@ -0,0 +1,99 @@
1
+ /**
2
+ * LLM scoping orchestrator.
3
+ *
4
+ * Orchestrates: prompt assembly → LLM call → schema validation →
5
+ * post-schema id validation → single repair retry → calibration recording.
6
+ *
7
+ * Exit 10 on second validation failure (invalid scope after retry).
8
+ */
9
+ import { buildScopingInput, serializeScopingInput, SCOPING_SYSTEM_PROMPT, REPAIR_PROMPT_PREFIX, REPAIR_PROMPT_SUFFIX, } from "./prompt.js";
10
+ import { parseLlmResponse, validateScopeIds, validateScopeSchema } from "./validate.js";
11
+ import { buildCalibrationRecord, writeCalibrationRecord } from "./calibration.js";
12
+ /* ─── Exit Code ───────────────────────────────────────────────────────── */
13
+ /** Exit code for invalid scope after retry (spec §8.2) */
14
+ export const EXIT_INVALID_SCOPE = 10;
15
+ /* ─── Orchestrator ────────────────────────────────────────────────────── */
16
+ /**
17
+ * Run the LLM scoping step with schema-validated output and repair retry.
18
+ *
19
+ * Steps:
20
+ * 1. Build constrained input (task, candidates, flows, domains)
21
+ * 2. Call LLM with system prompt + input
22
+ * 3. Parse and validate response (schema + id check)
23
+ * 4. On failure: send repair prompt with error context → validate again
24
+ * 5. Second failure → return failure result (caller exits 10)
25
+ * 6. On success: record calibration data
26
+ */
27
+ export async function runScoping(options) {
28
+ const { taskText, candidates, index, llmProvider, baseDir, skipCalibration } = options;
29
+ // Build constrained input
30
+ const scopingInput = buildScopingInput(taskText, candidates, index);
31
+ const userInput = serializeScopingInput(scopingInput);
32
+ // Compute valid id sets for post-schema validation
33
+ const candidateIds = new Set(candidates.map((c) => c.id));
34
+ const indexIds = new Set(index.components.map((c) => c.id));
35
+ // First attempt
36
+ const firstResponse = await llmProvider.scopeCall(SCOPING_SYSTEM_PROMPT, userInput);
37
+ const firstValidation = validateResponse(firstResponse, candidateIds, indexIds);
38
+ if (firstValidation.valid) {
39
+ const calibrationPath = recordCalibration(firstValidation.output, taskText, baseDir, skipCalibration);
40
+ return {
41
+ success: true,
42
+ output: firstValidation.output,
43
+ repairAttempted: false,
44
+ calibrationPath,
45
+ };
46
+ }
47
+ // Repair attempt: send error context back to LLM
48
+ const repairMessage = REPAIR_PROMPT_PREFIX + firstValidation.errors.join("\n") + REPAIR_PROMPT_SUFFIX;
49
+ const secondResponse = await llmProvider.scopeCall(SCOPING_SYSTEM_PROMPT, userInput + "\n\n" + repairMessage);
50
+ const secondValidation = validateResponse(secondResponse, candidateIds, indexIds);
51
+ if (secondValidation.valid) {
52
+ const calibrationPath = recordCalibration(secondValidation.output, taskText, baseDir, skipCalibration);
53
+ return {
54
+ success: true,
55
+ output: secondValidation.output,
56
+ repairAttempted: true,
57
+ calibrationPath,
58
+ };
59
+ }
60
+ // Second failure → exit 10
61
+ return {
62
+ success: false,
63
+ errors: secondValidation.errors,
64
+ repairAttempted: true,
65
+ };
66
+ }
67
+ /**
68
+ * Parse, schema-validate, and id-validate a raw LLM response.
69
+ */
70
+ function validateResponse(rawResponse, candidateIds, indexIds) {
71
+ // Step 1: Parse JSON
72
+ const parseResult = parseLlmResponse(rawResponse);
73
+ if ("error" in parseResult) {
74
+ return { valid: false, errors: [parseResult.error] };
75
+ }
76
+ // Step 2: Schema validation
77
+ const schemaResult = validateScopeSchema(parseResult.parsed);
78
+ if (!schemaResult.valid) {
79
+ return { valid: false, errors: schemaResult.errors };
80
+ }
81
+ // Step 3: Post-schema id validation
82
+ const idResult = validateScopeIds(schemaResult.output, candidateIds, indexIds);
83
+ if (!idResult.valid) {
84
+ const errors = idResult.inventedIds.map((id) => `Invented component id "${id}" is not in candidates or index`);
85
+ return { valid: false, errors };
86
+ }
87
+ return { valid: true, output: schemaResult.output };
88
+ }
89
+ /**
90
+ * Record calibration data (if not skipped).
91
+ */
92
+ function recordCalibration(output, taskText, baseDir, skip) {
93
+ if (skip)
94
+ return undefined;
95
+ const dir = baseDir ?? process.cwd();
96
+ const record = buildCalibrationRecord(output, taskText);
97
+ return writeCalibrationRecord(dir, record);
98
+ }
99
+ //# sourceMappingURL=scoping.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"scoping.js","sourceRoot":"","sources":["../../../core/scope/scoping.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,77 @@
1
+ /**
2
+ * Shared types for the scope module.
3
+ */
4
+ /**
5
+ * The raw scope output returned by the LLM scoping call.
6
+ * Must conform to scope-output.schema.json.
7
+ */
8
+ export interface ScopeOutput {
9
+ schemaVersion: string;
10
+ primary: string[];
11
+ secondary: string[];
12
+ contracts_crossed: string[];
13
+ confidence: "high" | "medium" | "low";
14
+ unresolved: string[];
15
+ rationale: string;
16
+ flow?: string;
17
+ }
18
+ /**
19
+ * Input provided to the scoping LLM call.
20
+ * Contains only: task, candidates, flows, domains (spec §7.1).
21
+ */
22
+ export interface ScopingInput {
23
+ task: string;
24
+ candidates: ScopingCandidate[];
25
+ flows: ScopingFlow[];
26
+ domains: ScopingDomain[];
27
+ }
28
+ /**
29
+ * A candidate component for the scoping call.
30
+ * Derived from resolve results — not the full catalog.
31
+ */
32
+ export interface ScopingCandidate {
33
+ id: string;
34
+ name: string;
35
+ description: string;
36
+ domain: string;
37
+ provides: string[];
38
+ consumes: string[];
39
+ }
40
+ /**
41
+ * A flow entry for scoping context.
42
+ */
43
+ export interface ScopingFlow {
44
+ id: string;
45
+ name: string;
46
+ participants: string[];
47
+ }
48
+ /**
49
+ * A domain entry for scoping context.
50
+ */
51
+ export interface ScopingDomain {
52
+ name: string;
53
+ components: string[];
54
+ }
55
+ /**
56
+ * Calibration record for a scoping session.
57
+ */
58
+ export interface CalibrationRecord {
59
+ timestamp: string;
60
+ taskTextHash: string;
61
+ primary: string[];
62
+ secondary: string[];
63
+ confidence: "high" | "medium" | "low";
64
+ unresolved: string[];
65
+ }
66
+ /**
67
+ * LLM provider interface for the scoping call.
68
+ * Accepts the assembled input and returns raw JSON string from the LLM.
69
+ */
70
+ export interface LlmScopeProvider {
71
+ /**
72
+ * Call the LLM with the assembled scoping prompt + input.
73
+ * Returns the raw response string (expected to be JSON).
74
+ */
75
+ scopeCall(systemPrompt: string, userInput: string): Promise<string>;
76
+ }
77
+ //# sourceMappingURL=types.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../core/scope/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,UAAU,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;IACtC,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,gBAAgB,EAAE,CAAC;IAC/B,KAAK,EAAE,WAAW,EAAE,CAAC;IACrB,OAAO,EAAE,aAAa,EAAE,CAAC;CAC1B;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,UAAU,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;IACtC,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;OAGG;IACH,SAAS,CAAC,YAAY,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CACrE"}
@@ -0,0 +1,5 @@
1
+ /**
2
+ * Shared types for the scope module.
3
+ */
4
+ export {};
5
+ //# sourceMappingURL=types.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.js","sourceRoot":"","sources":["../../../core/scope/types.ts"],"names":[],"mappings":"AAAA;;GAEG"}
@@ -0,0 +1,47 @@
1
+ /**
2
+ * Schema validation and post-schema id validation for scope output.
3
+ *
4
+ * - Validates LLM output against scope-output.schema.json
5
+ * - Rejects any component id not present in candidates or full index
6
+ */
7
+ import type { ScopeOutput } from "./types.js";
8
+ export interface ValidationSuccess {
9
+ valid: true;
10
+ output: ScopeOutput;
11
+ }
12
+ export interface ValidationFailure {
13
+ valid: false;
14
+ errors: string[];
15
+ }
16
+ export type ValidationResult = ValidationSuccess | ValidationFailure;
17
+ /**
18
+ * Validate raw parsed JSON against scope-output.schema.json.
19
+ * Returns structured validation result.
20
+ */
21
+ export declare function validateScopeSchema(data: unknown): ValidationResult;
22
+ export interface IdValidationSuccess {
23
+ valid: true;
24
+ }
25
+ export interface IdValidationFailure {
26
+ valid: false;
27
+ inventedIds: string[];
28
+ }
29
+ export type IdValidationResult = IdValidationSuccess | IdValidationFailure;
30
+ /**
31
+ * Validate that all component ids in the scope output exist in either:
32
+ * 1. The candidates list (from resolve), OR
33
+ * 2. The full index (all known component ids)
34
+ *
35
+ * Any id found in neither is considered "invented" and must trigger repair.
36
+ */
37
+ export declare function validateScopeIds(output: ScopeOutput, candidateIds: Set<string>, indexIds: Set<string>): IdValidationResult;
38
+ /**
39
+ * Parse raw LLM response string into a JSON object.
40
+ * Handles responses that may include markdown fences or extra whitespace.
41
+ */
42
+ export declare function parseLlmResponse(response: string): {
43
+ parsed: unknown;
44
+ } | {
45
+ error: string;
46
+ };
47
+ //# sourceMappingURL=validate.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../../core/scope/validate.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAOH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAoB9C,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,IAAI,CAAC;IACZ,MAAM,EAAE,WAAW,CAAC;CACrB;AAED,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,KAAK,CAAC;IACb,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,MAAM,MAAM,gBAAgB,GAAG,iBAAiB,GAAG,iBAAiB,CAAC;AAIrE;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,OAAO,GAAG,gBAAgB,CAcnE;AAID,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,IAAI,CAAC;CACb;AAED,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,KAAK,CAAC;IACb,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,MAAM,MAAM,kBAAkB,GAAG,mBAAmB,GAAG,mBAAmB,CAAC;AAE3E;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,WAAW,EACnB,YAAY,EAAE,GAAG,CAAC,MAAM,CAAC,EACzB,QAAQ,EAAE,GAAG,CAAC,MAAM,CAAC,GACpB,kBAAkB,CAqBpB;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG;IAAE,MAAM,EAAE,OAAO,CAAA;CAAE,GAAG;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,CAkB1F"}
@@ -0,0 +1,90 @@
1
+ /**
2
+ * Schema validation and post-schema id validation for scope output.
3
+ *
4
+ * - Validates LLM output against scope-output.schema.json
5
+ * - Rejects any component id not present in candidates or full index
6
+ */
7
+ import { Ajv2020 } from "ajv/dist/2020.js";
8
+ import { readFileSync } from "node:fs";
9
+ import { resolve, dirname } from "node:path";
10
+ import { fileURLToPath } from "node:url";
11
+ /* ─── Schema Loading ──────────────────────────────────────────────────── */
12
+ const __dirname = dirname(fileURLToPath(import.meta.url));
13
+ const ajv = new Ajv2020({ allErrors: true });
14
+ let _validator = null;
15
+ function getValidator() {
16
+ if (!_validator) {
17
+ const schemaPath = resolve(__dirname, "../../schemas/scope-output.schema.json");
18
+ const schema = JSON.parse(readFileSync(schemaPath, "utf-8"));
19
+ _validator = ajv.compile(schema);
20
+ }
21
+ return _validator;
22
+ }
23
+ /* ─── Schema Validation ───────────────────────────────────────────────── */
24
+ /**
25
+ * Validate raw parsed JSON against scope-output.schema.json.
26
+ * Returns structured validation result.
27
+ */
28
+ export function validateScopeSchema(data) {
29
+ const validate = getValidator();
30
+ const isValid = validate(data);
31
+ if (!isValid) {
32
+ const errors = (validate.errors ?? []).map((e) => {
33
+ const path = e.instancePath || "/";
34
+ const msg = e.message ?? "unknown error";
35
+ return `${path}: ${msg}`;
36
+ });
37
+ return { valid: false, errors };
38
+ }
39
+ return { valid: true, output: data };
40
+ }
41
+ /**
42
+ * Validate that all component ids in the scope output exist in either:
43
+ * 1. The candidates list (from resolve), OR
44
+ * 2. The full index (all known component ids)
45
+ *
46
+ * Any id found in neither is considered "invented" and must trigger repair.
47
+ */
48
+ export function validateScopeIds(output, candidateIds, indexIds) {
49
+ const allValidIds = new Set([...candidateIds, ...indexIds]);
50
+ const inventedIds = [];
51
+ for (const id of output.primary) {
52
+ if (!allValidIds.has(id)) {
53
+ inventedIds.push(id);
54
+ }
55
+ }
56
+ for (const id of output.secondary) {
57
+ if (!allValidIds.has(id)) {
58
+ inventedIds.push(id);
59
+ }
60
+ }
61
+ if (inventedIds.length > 0) {
62
+ return { valid: false, inventedIds };
63
+ }
64
+ return { valid: true };
65
+ }
66
+ /**
67
+ * Parse raw LLM response string into a JSON object.
68
+ * Handles responses that may include markdown fences or extra whitespace.
69
+ */
70
+ export function parseLlmResponse(response) {
71
+ // Strip markdown code fences if present
72
+ let cleaned = response.trim();
73
+ if (cleaned.startsWith("```json")) {
74
+ cleaned = cleaned.slice(7);
75
+ }
76
+ else if (cleaned.startsWith("```")) {
77
+ cleaned = cleaned.slice(3);
78
+ }
79
+ if (cleaned.endsWith("```")) {
80
+ cleaned = cleaned.slice(0, -3);
81
+ }
82
+ cleaned = cleaned.trim();
83
+ try {
84
+ return { parsed: JSON.parse(cleaned) };
85
+ }
86
+ catch {
87
+ return { error: `Response is not valid JSON: ${cleaned.slice(0, 200)}` };
88
+ }
89
+ }
90
+ //# sourceMappingURL=validate.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"validate.js","sourceRoot":"","sources":["../../../core/scope/validate.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,34 @@
1
+ /**
2
+ * Custom AsyncAPI breaking-change comparator.
3
+ *
4
+ * Detects breaking changes between two AsyncAPI 2.x/3.x specifications.
5
+ * No LLM or external dependencies.
6
+ *
7
+ * Breaking-change classes:
8
+ * - Removed channel
9
+ * - New required field in message payload
10
+ * - Changed field type in message payload
11
+ * - Narrowed enum (values removed)
12
+ *
13
+ * Non-breaking changes:
14
+ * - New channel added
15
+ * - New optional field in message payload
16
+ * - Widened enum (values added)
17
+ */
18
+ import type { ContractDiffResult, PayloadConfidence } from "./types.js";
19
+ /**
20
+ * Options for the AsyncAPI diff.
21
+ */
22
+ export interface AsyncApiDiffOptions {
23
+ /**
24
+ * Skip channels/messages with this payload confidence or lower.
25
+ * Default: skip "low" confidence payloads.
26
+ */
27
+ skipBelowConfidence?: PayloadConfidence;
28
+ }
29
+ /**
30
+ * Compare two AsyncAPI specs and return diff findings.
31
+ * Skips payloads with `payload_confidence: low` by default.
32
+ */
33
+ export declare function diffAsyncApi(base: unknown, head: unknown, options?: AsyncApiDiffOptions): ContractDiffResult;
34
+ //# sourceMappingURL=asyncapi-diff.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"asyncapi-diff.d.ts","sourceRoot":"","sources":["../../../core/verify/asyncapi-diff.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAe,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAqCrF;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;OAGG;IACH,mBAAmB,CAAC,EAAE,iBAAiB,CAAC;CACzC;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,OAAO,EACb,IAAI,EAAE,OAAO,EACb,OAAO,GAAE,mBAAwB,GAChC,kBAAkB,CA4CpB"}