@llipe.com/dev-tasks 0.6.7 → 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 +90 -0
  17. package/README.md +30 -2
  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,318 @@
1
+ /**
2
+ * Lexical weighted scorer for text → component resolution.
3
+ * Deterministic and explainable — no embeddings in v1.
4
+ *
5
+ * Spec: PRD RF-24, RF-28; Issue #46 AC1.
6
+ */
7
+ /* ─── Text Normalization ───────────────────────────────────────────── */
8
+ /**
9
+ * Spanish/English stopwords to remove from query and field text.
10
+ */
11
+ const STOPWORDS = new Set([
12
+ // English
13
+ "a",
14
+ "an",
15
+ "the",
16
+ "is",
17
+ "it",
18
+ "of",
19
+ "in",
20
+ "to",
21
+ "and",
22
+ "or",
23
+ "for",
24
+ "on",
25
+ "at",
26
+ "by",
27
+ "with",
28
+ "from",
29
+ "this",
30
+ "that",
31
+ "be",
32
+ "are",
33
+ "was",
34
+ "were",
35
+ "has",
36
+ "have",
37
+ "had",
38
+ "do",
39
+ "does",
40
+ "did",
41
+ "not",
42
+ "but",
43
+ "if",
44
+ "as",
45
+ "its",
46
+ "my",
47
+ "our",
48
+ "your",
49
+ // Spanish
50
+ "el",
51
+ "la",
52
+ "los",
53
+ "las",
54
+ "un",
55
+ "una",
56
+ "de",
57
+ "del",
58
+ "en",
59
+ "con",
60
+ "por",
61
+ "para",
62
+ "es",
63
+ "son",
64
+ "y",
65
+ "o",
66
+ "que",
67
+ "se",
68
+ "su",
69
+ "al",
70
+ "como",
71
+ "no",
72
+ "más",
73
+ "mas",
74
+ "pero",
75
+ "sus",
76
+ ]);
77
+ /**
78
+ * Light suffix-removal stemmer for English and Spanish.
79
+ * Removes common suffixes to match word stems.
80
+ * Not a full Porter/Snowball stemmer — just enough for routing.
81
+ * Conservative: requires minimum remaining stem length of 3.
82
+ */
83
+ function lightStem(word) {
84
+ if (word.length <= 4)
85
+ return word;
86
+ // English suffixes (ordered longest first, with min stem length guards)
87
+ if (word.length > 9 && word.endsWith("ations"))
88
+ return word.slice(0, -6);
89
+ if (word.length > 8 && word.endsWith("ation"))
90
+ return word.slice(0, -5);
91
+ if (word.length > 8 && word.endsWith("ments"))
92
+ return word.slice(0, -5);
93
+ if (word.length > 8 && word.endsWith("ience"))
94
+ return word.slice(0, -5);
95
+ if (word.length > 7 && word.endsWith("ment"))
96
+ return word.slice(0, -4);
97
+ if (word.length > 7 && word.endsWith("ness"))
98
+ return word.slice(0, -4);
99
+ if (word.length > 7 && word.endsWith("ings"))
100
+ return word.slice(0, -4);
101
+ if (word.length > 7 && word.endsWith("tion"))
102
+ return word.slice(0, -4);
103
+ if (word.length > 7 && word.endsWith("sion"))
104
+ return word.slice(0, -4);
105
+ if (word.length > 6 && word.endsWith("ing"))
106
+ return word.slice(0, -3);
107
+ if (word.length > 6 && word.endsWith("ers"))
108
+ return word.slice(0, -3);
109
+ if (word.length > 6 && word.endsWith("ies"))
110
+ return word.slice(0, -3) + "y";
111
+ if (word.length > 6 && word.endsWith("ous"))
112
+ return word.slice(0, -3);
113
+ if (word.length > 5 && word.endsWith("ed") && !word.endsWith("eed"))
114
+ return word.slice(0, -2);
115
+ if (word.length > 5 && word.endsWith("er"))
116
+ return word.slice(0, -2);
117
+ if (word.length > 5 && word.endsWith("ly"))
118
+ return word.slice(0, -2);
119
+ if (word.length > 5 && word.endsWith("es") && !word.endsWith("ies"))
120
+ return word.slice(0, -2);
121
+ if (word.endsWith("s") && !word.endsWith("ss") && !word.endsWith("us") && word.length > 4)
122
+ return word.slice(0, -1);
123
+ // Spanish suffixes
124
+ if (word.length > 7 && word.endsWith("ción"))
125
+ return word.slice(0, -4);
126
+ if (word.length > 8 && word.endsWith("iones"))
127
+ return word.slice(0, -5);
128
+ if (word.length > 8 && word.endsWith("mente"))
129
+ return word.slice(0, -5);
130
+ if (word.length > 6 && word.endsWith("ado"))
131
+ return word.slice(0, -3);
132
+ if (word.length > 6 && word.endsWith("ido"))
133
+ return word.slice(0, -3);
134
+ if (word.length > 7 && word.endsWith("ando"))
135
+ return word.slice(0, -4);
136
+ if (word.length > 8 && word.endsWith("iendo"))
137
+ return word.slice(0, -5);
138
+ return word;
139
+ }
140
+ /**
141
+ * Normalize text for matching:
142
+ * 1. Lowercase
143
+ * 2. NFD decompose and strip combining marks (de-accent)
144
+ * 3. Split on non-alphanumeric (including hyphens/underscores)
145
+ * 4. Remove stopwords
146
+ * 5. Light stemming
147
+ *
148
+ * Returns array of normalized tokens.
149
+ */
150
+ export function normalizeText(text) {
151
+ // Lowercase and de-accent via NFD decomposition + strip combining marks
152
+ const deaccented = text
153
+ .toLowerCase()
154
+ .normalize("NFD")
155
+ .replace(/[\u0300-\u036f]/g, "");
156
+ // Split on non-alphanumeric boundaries
157
+ const tokens = deaccented.split(/[^a-z0-9]+/).filter((t) => t.length > 0);
158
+ // Remove stopwords and stem
159
+ return tokens.filter((t) => !STOPWORDS.has(t)).map((t) => lightStem(t));
160
+ }
161
+ /**
162
+ * Normalize a single term for exact matching (no stemming, just lowercase + de-accent).
163
+ */
164
+ export function normalizeId(text) {
165
+ return text
166
+ .toLowerCase()
167
+ .normalize("NFD")
168
+ .replace(/[\u0300-\u036f]/g, "")
169
+ .trim();
170
+ }
171
+ /* ─── Scoring Signals ──────────────────────────────────────────────── */
172
+ /**
173
+ * Signal weights per the Issue #46 AC:
174
+ * exact id: 100, alias: 80, flow alias: 75, domain: 60,
175
+ * alias-token: 40, glossary→domain: 35, name/description: 25
176
+ */
177
+ const WEIGHT = {
178
+ EXACT_ID: 100,
179
+ ALIAS_EXACT: 80,
180
+ FLOW_ALIAS: 75,
181
+ DOMAIN: 60,
182
+ ALIAS_TOKEN: 40,
183
+ GLOSSARY_DOMAIN: 35,
184
+ PROVIDES_ID: 80,
185
+ NAME_DESCRIPTION: 25,
186
+ };
187
+ /* ─── Scorer ───────────────────────────────────────────────────────── */
188
+ /**
189
+ * Score a component against normalized query tokens and raw query.
190
+ */
191
+ function scoreComponent(component, queryTokens, rawQueryNorm, flowAliases) {
192
+ const signals = [];
193
+ let score = 0;
194
+ // 1. Exact ID match
195
+ if (normalizeId(component.id) === rawQueryNorm) {
196
+ score += WEIGHT.EXACT_ID;
197
+ signals.push({ type: "exact_id", weight: WEIGHT.EXACT_ID, matched: component.id });
198
+ }
199
+ // 2. Alias exact match
200
+ for (const alias of component.aliases) {
201
+ if (normalizeId(alias) === rawQueryNorm) {
202
+ score += WEIGHT.ALIAS_EXACT;
203
+ signals.push({ type: "alias_exact", weight: WEIGHT.ALIAS_EXACT, matched: alias });
204
+ break; // only count once
205
+ }
206
+ }
207
+ // 3. Alias token match (substring/partial)
208
+ if (!signals.some((s) => s.type === "alias_exact")) {
209
+ for (const alias of component.aliases) {
210
+ const aliasTokens = normalizeText(alias);
211
+ const overlap = queryTokens.filter((qt) => aliasTokens.some((at) => at.includes(qt) || qt.includes(at)));
212
+ if (overlap.length > 0) {
213
+ score += WEIGHT.ALIAS_TOKEN;
214
+ signals.push({
215
+ type: "alias_token",
216
+ weight: WEIGHT.ALIAS_TOKEN,
217
+ matched: alias,
218
+ });
219
+ break; // only count once
220
+ }
221
+ }
222
+ }
223
+ // 4. Provides[].id match (treated like alias-exact weight)
224
+ for (const p of component.provides) {
225
+ if (normalizeId(p.id) === rawQueryNorm) {
226
+ score += WEIGHT.PROVIDES_ID;
227
+ signals.push({ type: "provides_id", weight: WEIGHT.PROVIDES_ID, matched: p.id });
228
+ break;
229
+ }
230
+ }
231
+ // 5. Flow alias match (component participates in a flow whose alias matches)
232
+ const componentFlowAliases = flowAliases.get(component.id);
233
+ if (componentFlowAliases) {
234
+ for (const fAlias of componentFlowAliases) {
235
+ if (normalizeId(fAlias) === rawQueryNorm ||
236
+ queryTokens.some((qt) => normalizeId(fAlias).includes(qt))) {
237
+ score += WEIGHT.FLOW_ALIAS;
238
+ signals.push({ type: "flow_alias", weight: WEIGHT.FLOW_ALIAS, matched: fAlias });
239
+ break;
240
+ }
241
+ }
242
+ }
243
+ // 6. Domain match
244
+ const domainTokens = normalizeText(component.domain);
245
+ if (domainTokens.some((dt) => queryTokens.includes(dt))) {
246
+ score += WEIGHT.DOMAIN;
247
+ signals.push({ type: "domain", weight: WEIGHT.DOMAIN, matched: component.domain });
248
+ }
249
+ // 7. Name/description word match
250
+ const nameDescTokens = normalizeText(`${component.name} ${component.description}`);
251
+ const wordOverlap = queryTokens.filter((qt) => nameDescTokens.includes(qt));
252
+ if (wordOverlap.length > 0) {
253
+ // Proportional: more matched words = higher contribution, capped at weight
254
+ const proportion = Math.min(wordOverlap.length / queryTokens.length, 1);
255
+ const wordScore = Math.round(WEIGHT.NAME_DESCRIPTION * proportion);
256
+ if (wordScore > 0) {
257
+ score += wordScore;
258
+ signals.push({
259
+ type: "name_description",
260
+ weight: wordScore,
261
+ matched: wordOverlap.join(", "),
262
+ });
263
+ }
264
+ }
265
+ return { score, signals };
266
+ }
267
+ /**
268
+ * Build a map of component id → flow aliases that route to it.
269
+ * A flow's name, id, and aliases all count as flow aliases for its participants.
270
+ */
271
+ function buildFlowAliasMap(flows) {
272
+ const map = new Map();
273
+ for (const flow of flows) {
274
+ const flowIdentifiers = [flow.id, flow.name];
275
+ if (flow.aliases) {
276
+ flowIdentifiers.push(...flow.aliases);
277
+ }
278
+ for (const participant of flow.participants) {
279
+ const existing = map.get(participant) ?? [];
280
+ existing.push(...flowIdentifiers);
281
+ map.set(participant, existing);
282
+ }
283
+ }
284
+ return map;
285
+ }
286
+ /* ─── Public API ───────────────────────────────────────────────────── */
287
+ /**
288
+ * Resolve free-text query against the catalog index.
289
+ * Returns top candidates sorted by score descending, above threshold.
290
+ *
291
+ * Deterministic: same input always produces same output.
292
+ */
293
+ export function catalogResolve(index, text, options = {}) {
294
+ const { threshold = 20, limit = 12 } = options;
295
+ const queryTokens = normalizeText(text);
296
+ const rawQueryNorm = normalizeId(text);
297
+ if (queryTokens.length === 0 && rawQueryNorm.length === 0) {
298
+ return [];
299
+ }
300
+ // Build flow alias map for scoring
301
+ const flowAliases = buildFlowAliasMap(index.flows);
302
+ // Score each component
303
+ const candidates = [];
304
+ for (const component of index.components) {
305
+ const { score, signals } = scoreComponent(component, queryTokens, rawQueryNorm, flowAliases);
306
+ if (score >= threshold) {
307
+ candidates.push({ id: component.id, score, signals });
308
+ }
309
+ }
310
+ // Sort by score descending, then by id for stability
311
+ candidates.sort((a, b) => {
312
+ if (b.score !== a.score)
313
+ return b.score - a.score;
314
+ return a.id.localeCompare(b.id);
315
+ });
316
+ return candidates.slice(0, limit);
317
+ }
318
+ //# sourceMappingURL=resolve.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"resolve.js","sourceRoot":"","sources":["../../../core/catalog/resolve.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,31 @@
1
+ /**
2
+ * Meta-repo scaffold generator — `dt catalog scaffold`.
3
+ *
4
+ * Generates the canonical meta-repo directory layout including:
5
+ * architecture.md, domains.md, glossary.md, conventions.md,
6
+ * platform.yaml, registry.yaml, adr/, catalog/, catalog/flows/, schemas/
7
+ *
8
+ * Spec: specification-multi-repo-context.md §4.5 meta-repo layout + §15 CI.
9
+ */
10
+ export interface ScaffoldOptions {
11
+ /** Target output directory for the scaffold. Defaults to current directory. */
12
+ outDir: string;
13
+ /** Overwrite existing files if true. Default: false. */
14
+ force?: boolean;
15
+ }
16
+ export interface ScaffoldResult {
17
+ /** Absolute paths of all files created. */
18
+ created: string[];
19
+ /** Absolute paths of files that were skipped (already existed and force=false). */
20
+ skipped: string[];
21
+ /** Absolute paths of directories created. */
22
+ directories: string[];
23
+ }
24
+ /**
25
+ * Generate the meta-repo scaffold.
26
+ *
27
+ * Creates the canonical directory layout and template files.
28
+ * By default, does NOT overwrite existing files (use force=true to override).
29
+ */
30
+ export declare function catalogScaffold(options: ScaffoldOptions): ScaffoldResult;
31
+ //# sourceMappingURL=scaffold.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"scaffold.d.ts","sourceRoot":"","sources":["../../../core/catalog/scaffold.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAOH,MAAM,WAAW,eAAe;IAC9B,+EAA+E;IAC/E,MAAM,EAAE,MAAM,CAAC;IACf,wDAAwD;IACxD,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,cAAc;IAC7B,2CAA2C;IAC3C,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,mFAAmF;IACnF,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,6CAA6C;IAC7C,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAsFD;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,eAAe,GAAG,cAAc,CAkDxE"}
@@ -0,0 +1,141 @@
1
+ /**
2
+ * Meta-repo scaffold generator — `dt catalog scaffold`.
3
+ *
4
+ * Generates the canonical meta-repo directory layout including:
5
+ * architecture.md, domains.md, glossary.md, conventions.md,
6
+ * platform.yaml, registry.yaml, adr/, catalog/, catalog/flows/, schemas/
7
+ *
8
+ * Spec: specification-multi-repo-context.md §4.5 meta-repo layout + §15 CI.
9
+ */
10
+ import { existsSync, mkdirSync, writeFileSync } from "node:fs";
11
+ import { join } from "node:path";
12
+ /* ─── Template Content ────────────────────────────────────────────────── */
13
+ const TEMPLATE_FILES = {
14
+ "architecture.md": `# Architecture
15
+
16
+ > Document the high-level architectural overview of the system here.
17
+ > Include diagrams, component boundaries, and design principles.
18
+
19
+ ## Overview
20
+
21
+ <!-- Describe the overall system architecture -->
22
+
23
+ ## Key Decisions
24
+
25
+ <!-- Reference ADRs for significant architectural decisions -->
26
+ `,
27
+ "domains.md": `# Domains
28
+
29
+ > List and describe the business domains in this system.
30
+
31
+ | Domain | Description | Owner |
32
+ |--------|-------------|-------|
33
+ | <!-- domain-name --> | <!-- brief description --> | <!-- team --> |
34
+ `,
35
+ "glossary.md": `# Glossary
36
+
37
+ > Canonical definitions of terms used across the system.
38
+
39
+ | Term | Definition |
40
+ |------|-----------|
41
+ | <!-- term --> | <!-- definition --> |
42
+ `,
43
+ "conventions.md": `# Conventions
44
+
45
+ > Shared development and documentation conventions across all repositories.
46
+
47
+ ## Naming
48
+
49
+ <!-- Naming conventions for services, contracts, fields -->
50
+
51
+ ## Versioning
52
+
53
+ <!-- Versioning strategy for APIs and schemas -->
54
+
55
+ ## Documentation
56
+
57
+ <!-- Documentation standards -->
58
+ `,
59
+ "platform.yaml": `# Platform configuration
60
+ # Describes the deployment platform and shared infrastructure.
61
+
62
+ platform:
63
+ name: ""
64
+ cloud: "" # aws | gcp | azure | on-prem
65
+ environments:
66
+ - name: production
67
+ url: ""
68
+ - name: staging
69
+ url: ""
70
+ `,
71
+ "registry.yaml": `# Service Registry
72
+ # Lists all repositories that contribute component manifests to the catalog.
73
+ # Used by \`dt catalog build --registry registry.yaml\`.
74
+
75
+ repos: []
76
+ # Example:
77
+ # repos:
78
+ # - id: payment-service
79
+ # url: https://github.com/acme/payment-service.git
80
+ # branch: main
81
+ # path: "." # path to component.json within the repo
82
+ `,
83
+ };
84
+ /** Directories to create (relative to outDir). */
85
+ const SCAFFOLD_DIRS = ["adr", "catalog", "catalog/flows", "catalog/components", "schemas"];
86
+ /* ─── Implementation ──────────────────────────────────────────────────── */
87
+ /**
88
+ * Generate the meta-repo scaffold.
89
+ *
90
+ * Creates the canonical directory layout and template files.
91
+ * By default, does NOT overwrite existing files (use force=true to override).
92
+ */
93
+ export function catalogScaffold(options) {
94
+ const { outDir, force = false } = options;
95
+ const result = {
96
+ created: [],
97
+ skipped: [],
98
+ directories: [],
99
+ };
100
+ // Ensure the output directory exists
101
+ if (!existsSync(outDir)) {
102
+ mkdirSync(outDir, { recursive: true });
103
+ result.directories.push(outDir);
104
+ }
105
+ // Create directories
106
+ for (const dir of SCAFFOLD_DIRS) {
107
+ const dirPath = join(outDir, dir);
108
+ if (!existsSync(dirPath)) {
109
+ mkdirSync(dirPath, { recursive: true });
110
+ result.directories.push(dirPath);
111
+ }
112
+ }
113
+ // Create .gitkeep files in empty directories to ensure they persist in git
114
+ for (const dir of SCAFFOLD_DIRS) {
115
+ const gitkeepPath = join(outDir, dir, ".gitkeep");
116
+ if (!existsSync(gitkeepPath)) {
117
+ writeFileSync(gitkeepPath, "");
118
+ result.created.push(gitkeepPath);
119
+ }
120
+ else if (!force) {
121
+ result.skipped.push(gitkeepPath);
122
+ }
123
+ else {
124
+ writeFileSync(gitkeepPath, "");
125
+ result.created.push(gitkeepPath);
126
+ }
127
+ }
128
+ // Create template files
129
+ for (const [filename, content] of Object.entries(TEMPLATE_FILES)) {
130
+ const filePath = join(outDir, filename);
131
+ if (existsSync(filePath) && !force) {
132
+ result.skipped.push(filePath);
133
+ }
134
+ else {
135
+ writeFileSync(filePath, content, "utf-8");
136
+ result.created.push(filePath);
137
+ }
138
+ }
139
+ return result;
140
+ }
141
+ //# sourceMappingURL=scaffold.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"scaffold.js","sourceRoot":"","sources":["../../../core/catalog/scaffold.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,50 @@
1
+ /**
2
+ * Local schema validator for catalog artifacts (component.json, flow, scope-output).
3
+ * Spec: specification-multi-repo-context.md sections 4.6, 5, 6.2, 8.3.
4
+ *
5
+ * Validates entirely offline against the bundled JSON Schemas (draft 2020-12)
6
+ * using ajv's Ajv2020 class. No network access; no remote $ref resolution.
7
+ *
8
+ * This module is reused by:
9
+ * - `dt validate-component` (this story, S-010) — component.json only.
10
+ * - `dt catalog validate` V01 check (S-012) — same component schema.
11
+ */
12
+ export type ArtifactKind = "component" | "flow" | "scope-output";
13
+ /**
14
+ * A single structured validation error, derived from an ajv ErrorObject.
15
+ */
16
+ export interface ValidationErrorDetail {
17
+ path: string;
18
+ message: string;
19
+ keyword: string;
20
+ params: Record<string, unknown>;
21
+ }
22
+ /**
23
+ * Result of validating an artifact against its schema.
24
+ */
25
+ export interface ValidateArtifactResult {
26
+ valid: boolean;
27
+ errors: ValidationErrorDetail[];
28
+ }
29
+ /**
30
+ * Resolve the absolute path to a bundled schema file.
31
+ * Walks up from this module's directory to find the package-level `schemas/` dir,
32
+ * covering both source (`core/catalog/`) and compiled (`dist/core/catalog/`) layouts.
33
+ */
34
+ export declare function resolveSchemaPath(kind: ArtifactKind): string;
35
+ /**
36
+ * Validate an already-parsed artifact object against its schema.
37
+ * No I/O — pure function, easy to unit test.
38
+ */
39
+ export declare function validateArtifact(kind: ArtifactKind, data: unknown): ValidateArtifactResult;
40
+ /**
41
+ * Read and parse a JSON file, then validate it against the given artifact schema.
42
+ * Throws only for I/O / JSON-parse failures — schema violations are reported
43
+ * in the returned result, not thrown.
44
+ */
45
+ export declare function validateArtifactFile(kind: ArtifactKind, filePath: string): ValidateArtifactResult;
46
+ /**
47
+ * Convenience wrapper for the CLI: validate a component.json file.
48
+ */
49
+ export declare function validateComponentFile(filePath: string): ValidateArtifactResult;
50
+ //# sourceMappingURL=validate-component.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"validate-component.d.ts","sourceRoot":"","sources":["../../../core/catalog/validate-component.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAMH,MAAM,MAAM,YAAY,GAAG,WAAW,GAAG,MAAM,GAAG,cAAc,CAAC;AAQjE;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,qBAAqB,EAAE,CAAC;CACjC;AAKD;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,YAAY,GAAG,MAAM,CAc5D;AA2BD;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,OAAO,GAAG,sBAAsB,CAU1F;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,GAAG,sBAAsB,CAcjG;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,sBAAsB,CAE9E"}
@@ -0,0 +1,105 @@
1
+ /**
2
+ * Local schema validator for catalog artifacts (component.json, flow, scope-output).
3
+ * Spec: specification-multi-repo-context.md sections 4.6, 5, 6.2, 8.3.
4
+ *
5
+ * Validates entirely offline against the bundled JSON Schemas (draft 2020-12)
6
+ * using ajv's Ajv2020 class. No network access; no remote $ref resolution.
7
+ *
8
+ * This module is reused by:
9
+ * - `dt validate-component` (this story, S-010) — component.json only.
10
+ * - `dt catalog validate` V01 check (S-012) — same component schema.
11
+ */
12
+ import { readFileSync } from "node:fs";
13
+ import { resolve, join } from "node:path";
14
+ import { Ajv2020 } from "ajv/dist/2020.js";
15
+ const SCHEMA_FILENAMES = {
16
+ component: "component.schema.json",
17
+ flow: "flow.schema.json",
18
+ "scope-output": "scope-output.schema.json",
19
+ };
20
+ const ajv = new Ajv2020({ allErrors: true, strict: true });
21
+ const compiledValidators = new Map();
22
+ /**
23
+ * Resolve the absolute path to a bundled schema file.
24
+ * Walks up from this module's directory to find the package-level `schemas/` dir,
25
+ * covering both source (`core/catalog/`) and compiled (`dist/core/catalog/`) layouts.
26
+ */
27
+ export function resolveSchemaPath(kind) {
28
+ const filename = SCHEMA_FILENAMES[kind];
29
+ let dir = import.meta.dirname;
30
+ for (let i = 0; i < 6; i++) {
31
+ const candidate = join(dir, "schemas", filename);
32
+ try {
33
+ readFileSync(candidate, "utf-8");
34
+ return candidate;
35
+ }
36
+ catch {
37
+ // not found here, keep walking up
38
+ }
39
+ dir = resolve(dir, "..");
40
+ }
41
+ throw new Error(`Could not locate schema file: ${filename}`);
42
+ }
43
+ function loadSchema(kind) {
44
+ const path = resolveSchemaPath(kind);
45
+ const raw = readFileSync(path, "utf-8");
46
+ return JSON.parse(raw);
47
+ }
48
+ function getValidator(kind) {
49
+ const cached = compiledValidators.get(kind);
50
+ if (cached)
51
+ return cached;
52
+ const schema = loadSchema(kind);
53
+ const validateFn = ajv.compile(schema);
54
+ compiledValidators.set(kind, validateFn);
55
+ return validateFn;
56
+ }
57
+ function toDetail(err) {
58
+ return {
59
+ path: err.instancePath || "/",
60
+ message: err.message ?? "validation error",
61
+ keyword: err.keyword,
62
+ params: err.params,
63
+ };
64
+ }
65
+ /**
66
+ * Validate an already-parsed artifact object against its schema.
67
+ * No I/O — pure function, easy to unit test.
68
+ */
69
+ export function validateArtifact(kind, data) {
70
+ const validateFn = getValidator(kind);
71
+ const valid = validateFn(data);
72
+ if (valid) {
73
+ return { valid: true, errors: [] };
74
+ }
75
+ const errors = (validateFn.errors ?? []).map(toDetail);
76
+ return { valid: false, errors };
77
+ }
78
+ /**
79
+ * Read and parse a JSON file, then validate it against the given artifact schema.
80
+ * Throws only for I/O / JSON-parse failures — schema violations are reported
81
+ * in the returned result, not thrown.
82
+ */
83
+ export function validateArtifactFile(kind, filePath) {
84
+ const absPath = resolve(filePath);
85
+ const raw = readFileSync(absPath, "utf-8");
86
+ let data;
87
+ try {
88
+ data = JSON.parse(raw);
89
+ }
90
+ catch (err) {
91
+ const msg = err instanceof Error ? err.message : String(err);
92
+ return {
93
+ valid: false,
94
+ errors: [{ path: "/", message: `Invalid JSON: ${msg}`, keyword: "parse", params: {} }],
95
+ };
96
+ }
97
+ return validateArtifact(kind, data);
98
+ }
99
+ /**
100
+ * Convenience wrapper for the CLI: validate a component.json file.
101
+ */
102
+ export function validateComponentFile(filePath) {
103
+ return validateArtifactFile("component", filePath);
104
+ }
105
+ //# sourceMappingURL=validate-component.js.map