@llipe.com/dev-tasks 0.6.7 → 0.7.4

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 +98 -0
  17. package/README.md +39 -7
  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,209 @@
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
+ /**
19
+ * Compare two AsyncAPI specs and return diff findings.
20
+ * Skips payloads with `payload_confidence: low` by default.
21
+ */
22
+ export function diffAsyncApi(base, head, options = {}) {
23
+ const findings = [];
24
+ const baseSpec = base;
25
+ const headSpec = head;
26
+ const skipBelow = options.skipBelowConfidence ?? "low";
27
+ const baseChannels = baseSpec.channels ?? {};
28
+ const headChannels = headSpec.channels ?? {};
29
+ // Check removed channels
30
+ for (const name of Object.keys(baseChannels)) {
31
+ if (!(name in headChannels)) {
32
+ findings.push({
33
+ kind: "breaking",
34
+ code: "channel-removed",
35
+ message: `Channel '${name}' was removed`,
36
+ path: `channels.${name}`,
37
+ });
38
+ continue;
39
+ }
40
+ // Channel exists in both — diff messages/operations
41
+ const baseChannel = baseChannels[name];
42
+ const headChannel = headChannels[name];
43
+ diffChannel(name, baseChannel, headChannel, skipBelow, findings);
44
+ }
45
+ // Check added channels (non-breaking)
46
+ for (const name of Object.keys(headChannels)) {
47
+ if (!(name in baseChannels)) {
48
+ findings.push({
49
+ kind: "non-breaking",
50
+ code: "channel-added",
51
+ message: `Channel '${name}' was added`,
52
+ path: `channels.${name}`,
53
+ });
54
+ }
55
+ }
56
+ return {
57
+ contractType: "asyncapi",
58
+ breaking: findings.some((f) => f.kind === "breaking"),
59
+ findings,
60
+ };
61
+ }
62
+ /**
63
+ * Check if a confidence level should be skipped.
64
+ */
65
+ function shouldSkip(confidence, skipBelow) {
66
+ if (!confidence)
67
+ return false;
68
+ if (skipBelow === "low")
69
+ return confidence === "low";
70
+ if (skipBelow === "medium")
71
+ return confidence === "low" || confidence === "medium";
72
+ return false;
73
+ }
74
+ function diffChannel(name, baseChannel, headChannel, skipBelow, findings) {
75
+ // Skip entire channel if payload confidence is low
76
+ if (shouldSkip(baseChannel["x-payload-confidence"], skipBelow))
77
+ return;
78
+ if (shouldSkip(headChannel["x-payload-confidence"], skipBelow))
79
+ return;
80
+ // AsyncAPI 2.x: subscribe/publish
81
+ if (baseChannel.subscribe || headChannel.subscribe) {
82
+ diffOperationMessages(`channels.${name}.subscribe`, getMessages(baseChannel.subscribe), getMessages(headChannel.subscribe), skipBelow, findings);
83
+ }
84
+ if (baseChannel.publish || headChannel.publish) {
85
+ diffOperationMessages(`channels.${name}.publish`, getMessages(baseChannel.publish), getMessages(headChannel.publish), skipBelow, findings);
86
+ }
87
+ // AsyncAPI 3.x: messages map
88
+ if (baseChannel.messages || headChannel.messages) {
89
+ const baseMsgs = baseChannel.messages ?? {};
90
+ const headMsgs = headChannel.messages ?? {};
91
+ for (const msgName of Object.keys(baseMsgs)) {
92
+ if (!(msgName in headMsgs))
93
+ continue; // message removal handled at channel level
94
+ const baseMsg = baseMsgs[msgName];
95
+ const headMsg = headMsgs[msgName];
96
+ if (shouldSkip(baseMsg["x-payload-confidence"], skipBelow))
97
+ continue;
98
+ if (shouldSkip(headMsg["x-payload-confidence"], skipBelow))
99
+ continue;
100
+ if (baseMsg.payload && headMsg.payload) {
101
+ diffSchema(`channels.${name}.messages.${msgName}.payload`, baseMsg.payload, headMsg.payload, findings);
102
+ }
103
+ }
104
+ }
105
+ }
106
+ function getMessages(op) {
107
+ if (!op?.message)
108
+ return [];
109
+ const msg = op.message;
110
+ if ("oneOf" in msg && Array.isArray(msg.oneOf)) {
111
+ return msg.oneOf;
112
+ }
113
+ return [msg];
114
+ }
115
+ function diffOperationMessages(path, baseMessages, headMessages, skipBelow, findings) {
116
+ // Compare by index (positional) for simplicity
117
+ const maxLen = Math.max(baseMessages.length, headMessages.length);
118
+ for (let i = 0; i < maxLen; i++) {
119
+ const baseMsg = baseMessages[i];
120
+ const headMsg = headMessages[i];
121
+ if (!baseMsg || !headMsg)
122
+ continue;
123
+ if (shouldSkip(baseMsg["x-payload-confidence"], skipBelow))
124
+ continue;
125
+ if (shouldSkip(headMsg["x-payload-confidence"], skipBelow))
126
+ continue;
127
+ if (baseMsg.payload && headMsg.payload) {
128
+ diffSchema(`${path}.message[${i}].payload`, baseMsg.payload, headMsg.payload, findings);
129
+ }
130
+ }
131
+ }
132
+ function diffSchema(path, baseSchema, headSchema, findings) {
133
+ // Type change → breaking
134
+ if (baseSchema.type && headSchema.type && baseSchema.type !== headSchema.type) {
135
+ findings.push({
136
+ kind: "breaking",
137
+ code: "field-type-changed",
138
+ message: `Field type changed from '${baseSchema.type}' to '${headSchema.type}'`,
139
+ path: `${path}.type`,
140
+ });
141
+ }
142
+ // Enum narrowing/widening
143
+ diffEnum(path, baseSchema.enum, headSchema.enum, findings);
144
+ // New required fields
145
+ const baseRequired = new Set(baseSchema.required ?? []);
146
+ const headRequired = new Set(headSchema.required ?? []);
147
+ const baseProps = baseSchema.properties ?? {};
148
+ const headProps = headSchema.properties ?? {};
149
+ for (const field of headRequired) {
150
+ if (!baseRequired.has(field) && !(field in baseProps)) {
151
+ findings.push({
152
+ kind: "breaking",
153
+ code: "field-added-required",
154
+ message: `New required field '${field}' added`,
155
+ path: `${path}.properties.${field}`,
156
+ });
157
+ }
158
+ else if (!baseRequired.has(field) && field in baseProps) {
159
+ findings.push({
160
+ kind: "breaking",
161
+ code: "field-made-required",
162
+ message: `Field '${field}' changed from optional to required`,
163
+ path: `${path}.properties.${field}`,
164
+ });
165
+ }
166
+ }
167
+ // New optional fields → non-breaking
168
+ for (const field of Object.keys(headProps)) {
169
+ if (!(field in baseProps) && !headRequired.has(field)) {
170
+ findings.push({
171
+ kind: "non-breaking",
172
+ code: "field-added-optional",
173
+ message: `New optional field '${field}' added`,
174
+ path: `${path}.properties.${field}`,
175
+ });
176
+ }
177
+ }
178
+ // Recurse into shared properties
179
+ for (const field of Object.keys(headProps)) {
180
+ if (field in baseProps) {
181
+ diffSchema(`${path}.properties.${field}`, baseProps[field], headProps[field], findings);
182
+ }
183
+ }
184
+ }
185
+ function diffEnum(path, baseEnum, headEnum, findings) {
186
+ if (!baseEnum || !headEnum)
187
+ return;
188
+ const baseSet = new Set(baseEnum.map(String));
189
+ const headSet = new Set(headEnum.map(String));
190
+ const removed = [...baseSet].filter((v) => !headSet.has(v));
191
+ const added = [...headSet].filter((v) => !baseSet.has(v));
192
+ if (removed.length > 0) {
193
+ findings.push({
194
+ kind: "breaking",
195
+ code: "enum-narrowed",
196
+ message: `Enum values removed: ${removed.join(", ")}`,
197
+ path: `${path}.enum`,
198
+ });
199
+ }
200
+ if (added.length > 0) {
201
+ findings.push({
202
+ kind: "non-breaking",
203
+ code: "enum-widened",
204
+ message: `Enum values added: ${added.join(", ")}`,
205
+ path: `${path}.enum`,
206
+ });
207
+ }
208
+ }
209
+ //# sourceMappingURL=asyncapi-diff.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"asyncapi-diff.js","sourceRoot":"","sources":["../../../core/verify/asyncapi-diff.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,39 @@
1
+ /**
2
+ * Contract-diff orchestrator.
3
+ *
4
+ * Detects the contract type (OpenAPI or AsyncAPI), loads base/head versions,
5
+ * delegates to the appropriate comparator, and aggregates results.
6
+ *
7
+ * Key behaviors:
8
+ * - No LLM used (RF-50)
9
+ * - Contracts with `payload_confidence: low` are excluded
10
+ * - Breaking change detected → exit 8
11
+ * - No breaking changes → exit 0
12
+ */
13
+ import type { ContractDiffResult } from "./types.js";
14
+ /**
15
+ * Detect the contract type from a parsed spec document.
16
+ */
17
+ export declare function detectContractType(spec: Record<string, unknown>): "openapi" | "asyncapi" | null;
18
+ /**
19
+ * Load and parse a contract spec from a file path.
20
+ * Supports JSON and YAML.
21
+ */
22
+ export declare function loadSpec(filePath: string): Record<string, unknown>;
23
+ /**
24
+ * Options for the contract-diff orchestrator.
25
+ */
26
+ export interface RunContractDiffOptions {
27
+ /** Path to the base (old) contract spec */
28
+ basePath: string;
29
+ /** Path to the head (new) contract spec */
30
+ headPath: string;
31
+ }
32
+ /**
33
+ * Run contract-diff: load specs, detect type, delegate to comparator.
34
+ *
35
+ * @returns ContractDiffResult with findings.
36
+ * @throws Error if specs cannot be loaded or type cannot be detected.
37
+ */
38
+ export declare function runContractDiff(options: RunContractDiffOptions): ContractDiffResult;
39
+ //# sourceMappingURL=contract-diff.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"contract-diff.d.ts","sourceRoot":"","sources":["../../../core/verify/contract-diff.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAMH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAErD;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GAAG,UAAU,GAAG,IAAI,CAQ/F;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAWlE;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,2CAA2C;IAC3C,QAAQ,EAAE,MAAM,CAAC;IACjB,2CAA2C;IAC3C,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,sBAAsB,GAAG,kBAAkB,CAoBnF"}
@@ -0,0 +1,63 @@
1
+ /**
2
+ * Contract-diff orchestrator.
3
+ *
4
+ * Detects the contract type (OpenAPI or AsyncAPI), loads base/head versions,
5
+ * delegates to the appropriate comparator, and aggregates results.
6
+ *
7
+ * Key behaviors:
8
+ * - No LLM used (RF-50)
9
+ * - Contracts with `payload_confidence: low` are excluded
10
+ * - Breaking change detected → exit 8
11
+ * - No breaking changes → exit 0
12
+ */
13
+ import { readFileSync } from "node:fs";
14
+ import { parse as parseYaml } from "yaml";
15
+ import { diffOpenApi } from "./openapi-diff.js";
16
+ import { diffAsyncApi } from "./asyncapi-diff.js";
17
+ /**
18
+ * Detect the contract type from a parsed spec document.
19
+ */
20
+ export function detectContractType(spec) {
21
+ if (typeof spec.openapi === "string" && spec.openapi.startsWith("3")) {
22
+ return "openapi";
23
+ }
24
+ if (typeof spec.asyncapi === "string") {
25
+ return "asyncapi";
26
+ }
27
+ return null;
28
+ }
29
+ /**
30
+ * Load and parse a contract spec from a file path.
31
+ * Supports JSON and YAML.
32
+ */
33
+ export function loadSpec(filePath) {
34
+ const content = readFileSync(filePath, "utf-8");
35
+ const trimmed = content.trim();
36
+ // Try JSON first
37
+ if (trimmed.startsWith("{")) {
38
+ return JSON.parse(trimmed);
39
+ }
40
+ // Otherwise YAML
41
+ return parseYaml(trimmed);
42
+ }
43
+ /**
44
+ * Run contract-diff: load specs, detect type, delegate to comparator.
45
+ *
46
+ * @returns ContractDiffResult with findings.
47
+ * @throws Error if specs cannot be loaded or type cannot be detected.
48
+ */
49
+ export function runContractDiff(options) {
50
+ const { basePath, headPath } = options;
51
+ const baseSpec = loadSpec(basePath);
52
+ const headSpec = loadSpec(headPath);
53
+ // Detect contract type from base (authoritative) with head as fallback
54
+ const contractType = detectContractType(baseSpec) ?? detectContractType(headSpec);
55
+ if (!contractType) {
56
+ throw new Error("Unable to detect contract type. Spec must contain 'openapi: 3.x' or 'asyncapi: x.x'.");
57
+ }
58
+ if (contractType === "openapi") {
59
+ return diffOpenApi(baseSpec, headSpec);
60
+ }
61
+ return diffAsyncApi(baseSpec, headSpec);
62
+ }
63
+ //# sourceMappingURL=contract-diff.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"contract-diff.js","sourceRoot":"","sources":["../../../core/verify/contract-diff.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,KAAK,IAAI,SAAS,EAAE,MAAM,MAAM,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAGlD;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,IAA6B;IAC9D,IAAI,OAAO,IAAI,CAAC,OAAO,KAAK,QAAQ,IAAI,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACrE,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,IAAI,OAAO,IAAI,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;QACtC,OAAO,UAAU,CAAC;IACpB,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,QAAQ,CAAC,QAAgB;IACvC,MAAM,OAAO,GAAG,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAChD,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;IAE/B,iBAAiB;IACjB,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QAC5B,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAA4B,CAAC;IACxD,CAAC;IAED,iBAAiB;IACjB,OAAO,SAAS,CAAC,OAAO,CAA4B,CAAC;AACvD,CAAC;AAYD;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,OAA+B;IAC7D,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC;IAEvC,MAAM,QAAQ,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC;IACpC,MAAM,QAAQ,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAEpC,uEAAuE;IACvE,MAAM,YAAY,GAAG,kBAAkB,CAAC,QAAQ,CAAC,IAAI,kBAAkB,CAAC,QAAQ,CAAC,CAAC;IAElF,IAAI,CAAC,YAAY,EAAE,CAAC;QAClB,MAAM,IAAI,KAAK,CACb,sFAAsF,CACvF,CAAC;IACJ,CAAC;IAED,IAAI,YAAY,KAAK,SAAS,EAAE,CAAC;QAC/B,OAAO,WAAW,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IACzC,CAAC;IAED,OAAO,YAAY,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;AAC1C,CAAC"}
@@ -0,0 +1,47 @@
1
+ /**
2
+ * Drift heuristic: computes docs/code recency per component.
3
+ *
4
+ * Uses `git log` to determine the last commit date for source paths and
5
+ * docs paths, then computes a drift score (days difference). This is a
6
+ * prioritization signal, not a proof of staleness.
7
+ *
8
+ * Spec: §6.6, RF-52.
9
+ */
10
+ import type { CatalogIndex, ComponentSummary } from "../catalog/index-model.js";
11
+ import type { DriftResult, DriftEntry, DriftOptions } from "./types.js";
12
+ /**
13
+ * Get the last commit date for a set of paths in a git repository.
14
+ * Returns the date as a Date object, or null if no commits are found.
15
+ *
16
+ * @param paths - Glob patterns or directory paths to check.
17
+ * @param repoRoot - Root of the git repository.
18
+ */
19
+ export declare function getLastCommitDate(paths: string[], repoRoot: string): Date | null;
20
+ /**
21
+ * Compute the number of days between a date and now.
22
+ */
23
+ export declare function daysAgo(date: Date | null, now?: Date): number;
24
+ /**
25
+ * Derive source and docs paths from a component summary.
26
+ *
27
+ * Heuristic:
28
+ * - Source paths: from component's provides[].source or fallback to "src/"
29
+ * - Docs paths: "docs/" relative to the component's repo
30
+ */
31
+ export declare function deriveComponentPaths(component: ComponentSummary): {
32
+ sourcePaths: string[];
33
+ docsPaths: string[];
34
+ };
35
+ /**
36
+ * Compute drift for a single component.
37
+ */
38
+ export declare function computeComponentDrift(component: ComponentSummary, repoRoot: string, threshold: number, now?: Date): DriftEntry;
39
+ /**
40
+ * Run drift analysis across components in the catalog.
41
+ *
42
+ * @param index - The catalog index.
43
+ * @param options - Drift analysis options.
44
+ * @returns DriftResult with all entries and stale entries.
45
+ */
46
+ export declare function runDrift(index: CatalogIndex, options?: DriftOptions): DriftResult;
47
+ //# sourceMappingURL=drift.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"drift.d.ts","sourceRoot":"","sources":["../../../core/verify/drift.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAChF,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAKxE;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAkBhF;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,EAAE,GAAG,GAAE,IAAiB,GAAG,MAAM,CAIzE;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,gBAAgB,GAAG;IACjE,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB,CAmBA;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,SAAS,EAAE,gBAAgB,EAC3B,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,GAAG,GAAE,IAAiB,GACrB,UAAU,CAyBZ;AAED;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,YAAY,EAAE,OAAO,GAAE,YAAiB,GAAG,WAAW,CAwBrF"}
@@ -0,0 +1,122 @@
1
+ /**
2
+ * Drift heuristic: computes docs/code recency per component.
3
+ *
4
+ * Uses `git log` to determine the last commit date for source paths and
5
+ * docs paths, then computes a drift score (days difference). This is a
6
+ * prioritization signal, not a proof of staleness.
7
+ *
8
+ * Spec: §6.6, RF-52.
9
+ */
10
+ import { execSync } from "node:child_process";
11
+ /** Default staleness threshold in days */
12
+ const DEFAULT_THRESHOLD = 30;
13
+ /**
14
+ * Get the last commit date for a set of paths in a git repository.
15
+ * Returns the date as a Date object, or null if no commits are found.
16
+ *
17
+ * @param paths - Glob patterns or directory paths to check.
18
+ * @param repoRoot - Root of the git repository.
19
+ */
20
+ export function getLastCommitDate(paths, repoRoot) {
21
+ if (paths.length === 0)
22
+ return null;
23
+ try {
24
+ // Use git log to find the most recent commit touching any of the paths
25
+ const result = execSync(`git log -1 --format=%aI -- ${paths.map((p) => `"${p}"`).join(" ")}`, {
26
+ cwd: repoRoot,
27
+ encoding: "utf-8",
28
+ timeout: 10_000,
29
+ stdio: ["pipe", "pipe", "pipe"],
30
+ }).trim();
31
+ if (!result)
32
+ return null;
33
+ const date = new Date(result);
34
+ return isNaN(date.getTime()) ? null : date;
35
+ }
36
+ catch {
37
+ return null;
38
+ }
39
+ }
40
+ /**
41
+ * Compute the number of days between a date and now.
42
+ */
43
+ export function daysAgo(date, now = new Date()) {
44
+ if (!date)
45
+ return Infinity;
46
+ const diffMs = now.getTime() - date.getTime();
47
+ return Math.floor(diffMs / (1000 * 60 * 60 * 24));
48
+ }
49
+ /**
50
+ * Derive source and docs paths from a component summary.
51
+ *
52
+ * Heuristic:
53
+ * - Source paths: from component's provides[].source or fallback to "src/"
54
+ * - Docs paths: "docs/" relative to the component's repo
55
+ */
56
+ export function deriveComponentPaths(component) {
57
+ const sourcePaths = [];
58
+ // Collect source paths from provides entries
59
+ for (const p of component.provides) {
60
+ if (p.source) {
61
+ sourcePaths.push(p.source);
62
+ }
63
+ }
64
+ // Fallback: use common source directories
65
+ if (sourcePaths.length === 0) {
66
+ sourcePaths.push("src/");
67
+ }
68
+ // Docs paths: conventional docs directory
69
+ const docsPaths = ["docs/", "README.md"];
70
+ return { sourcePaths, docsPaths };
71
+ }
72
+ /**
73
+ * Compute drift for a single component.
74
+ */
75
+ export function computeComponentDrift(component, repoRoot, threshold, now = new Date()) {
76
+ const { sourcePaths, docsPaths } = deriveComponentPaths(component);
77
+ const sourceDate = getLastCommitDate(sourcePaths, repoRoot);
78
+ const docsDate = getLastCommitDate(docsPaths, repoRoot);
79
+ const sourceDaysAgo = daysAgo(sourceDate, now);
80
+ const docsDaysAgo = daysAgo(docsDate, now);
81
+ // Drift = how much more stale docs are compared to source
82
+ // If source was changed recently but docs weren't, drift is high
83
+ const driftDays = docsDaysAgo === Infinity || sourceDaysAgo === Infinity ? 0 : docsDaysAgo - sourceDaysAgo;
84
+ const stale = driftDays > threshold;
85
+ return {
86
+ id: component.id,
87
+ name: component.name,
88
+ repo: component.repo,
89
+ sourceDaysAgo: sourceDaysAgo === Infinity ? -1 : sourceDaysAgo,
90
+ docsDaysAgo: docsDaysAgo === Infinity ? -1 : docsDaysAgo,
91
+ driftDays: Math.max(0, driftDays),
92
+ stale,
93
+ };
94
+ }
95
+ /**
96
+ * Run drift analysis across components in the catalog.
97
+ *
98
+ * @param index - The catalog index.
99
+ * @param options - Drift analysis options.
100
+ * @returns DriftResult with all entries and stale entries.
101
+ */
102
+ export function runDrift(index, options = {}) {
103
+ const { id, threshold = DEFAULT_THRESHOLD, repoRoot = "." } = options;
104
+ const now = new Date();
105
+ // Filter to specific component if --id provided
106
+ let components;
107
+ if (id) {
108
+ const component = index.components.find((c) => c.id === id);
109
+ components = component ? [component] : [];
110
+ }
111
+ else {
112
+ components = index.components;
113
+ }
114
+ const entries = components.map((c) => computeComponentDrift(c, repoRoot, threshold, now));
115
+ const staleEntries = entries.filter((e) => e.stale);
116
+ return {
117
+ threshold,
118
+ entries,
119
+ staleEntries,
120
+ };
121
+ }
122
+ //# sourceMappingURL=drift.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"drift.js","sourceRoot":"","sources":["../../../core/verify/drift.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,22 @@
1
+ /**
2
+ * Impact analysis: lists consumers affected by a contract change.
3
+ *
4
+ * Reads the inverted consumer index from the catalog and returns each
5
+ * consumer's criticality. Optionally emits per-consumer derived tasks
6
+ * via the tracker provider (RF-54).
7
+ *
8
+ * Spec: §6.6, RF-51, RF-54.
9
+ */
10
+ import type { CatalogIndex } from "../catalog/index-model.js";
11
+ import type { TrackerProvider } from "../providers/tracker.js";
12
+ import type { ImpactResult, ImpactOptions } from "./types.js";
13
+ /**
14
+ * Run impact analysis for a given contract id against the catalog index.
15
+ *
16
+ * @param index - The catalog index (contains contracts map and components).
17
+ * @param options - Impact analysis options.
18
+ * @param trackerProvider - Optional tracker provider override (defaults to resolveTrackerProvider).
19
+ * @returns ImpactResult or null if the contract is not found.
20
+ */
21
+ export declare function runImpact(index: CatalogIndex, options: ImpactOptions, trackerProvider?: TrackerProvider): Promise<ImpactResult | null>;
22
+ //# sourceMappingURL=impact.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"impact.d.ts","sourceRoot":"","sources":["../../../core/verify/impact.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAE/D,OAAO,KAAK,EAAE,YAAY,EAAoC,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhG;;;;;;;GAOG;AACH,wBAAsB,SAAS,CAC7B,KAAK,EAAE,YAAY,EACnB,OAAO,EAAE,aAAa,EACtB,eAAe,CAAC,EAAE,eAAe,GAChC,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CA+E9B"}
@@ -0,0 +1,93 @@
1
+ /**
2
+ * Impact analysis: lists consumers affected by a contract change.
3
+ *
4
+ * Reads the inverted consumer index from the catalog and returns each
5
+ * consumer's criticality. Optionally emits per-consumer derived tasks
6
+ * via the tracker provider (RF-54).
7
+ *
8
+ * Spec: §6.6, RF-51, RF-54.
9
+ */
10
+ import { resolveTrackerProvider } from "../providers/tracker.js";
11
+ /**
12
+ * Run impact analysis for a given contract id against the catalog index.
13
+ *
14
+ * @param index - The catalog index (contains contracts map and components).
15
+ * @param options - Impact analysis options.
16
+ * @param trackerProvider - Optional tracker provider override (defaults to resolveTrackerProvider).
17
+ * @returns ImpactResult or null if the contract is not found.
18
+ */
19
+ export async function runImpact(index, options, trackerProvider) {
20
+ const { contractId, emitTasks = false } = options;
21
+ const provider = trackerProvider ?? resolveTrackerProvider();
22
+ // Look up the contract in the inverted consumer index
23
+ const contractEntry = index.contracts[contractId];
24
+ if (!contractEntry) {
25
+ return null;
26
+ }
27
+ // Resolve each consumer to its full component for criticality
28
+ const consumers = [];
29
+ for (const consumerId of contractEntry.consumers) {
30
+ const component = index.components.find((c) => c.id === consumerId);
31
+ if (!component)
32
+ continue;
33
+ // Find the specific consumption entry to get per-relationship criticality
34
+ const consumeEntry = component.consumes.find((c) => c.contract === contractId);
35
+ const criticality = consumeEntry?.criticality ?? component.criticality;
36
+ consumers.push({
37
+ id: component.id,
38
+ name: component.name,
39
+ repo: component.repo,
40
+ criticality,
41
+ });
42
+ }
43
+ // Emit tasks if requested
44
+ const taskResults = [];
45
+ let tasksEmitted = false;
46
+ if (emitTasks) {
47
+ if (!provider.isAvailable()) {
48
+ // Graceful degradation: report that provider is unavailable
49
+ for (const consumer of consumers) {
50
+ taskResults.push({
51
+ consumerId: consumer.id,
52
+ success: false,
53
+ error: "No tracker provider configured. Install a platform provider to enable --emit-tasks.",
54
+ });
55
+ }
56
+ }
57
+ else {
58
+ tasksEmitted = true;
59
+ for (const consumer of consumers) {
60
+ const result = await provider.emitTask({
61
+ repo: consumer.repo,
62
+ title: `[Impact] Contract "${contractId}" changed — review consumer "${consumer.id}"`,
63
+ body: [
64
+ `Contract \`${contractId}\` (provided by \`${contractEntry.provider}\`) has changed.`,
65
+ ``,
66
+ `Consumer \`${consumer.id}\` (criticality: ${consumer.criticality}) may be affected.`,
67
+ `Please review and update your integration accordingly.`,
68
+ ].join("\n"),
69
+ labels: ["contract-impact", `criticality:${consumer.criticality}`],
70
+ metadata: {
71
+ contractId,
72
+ consumerId: consumer.id,
73
+ criticality: consumer.criticality,
74
+ },
75
+ });
76
+ taskResults.push({
77
+ consumerId: consumer.id,
78
+ success: result.success,
79
+ taskUrl: result.taskUrl,
80
+ error: result.error,
81
+ });
82
+ }
83
+ }
84
+ }
85
+ return {
86
+ contractId,
87
+ provider: contractEntry.provider,
88
+ consumers,
89
+ tasksEmitted,
90
+ taskResults,
91
+ };
92
+ }
93
+ //# sourceMappingURL=impact.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"impact.js","sourceRoot":"","sources":["../../../core/verify/impact.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,10 @@
1
+ /**
2
+ * Verify module — contract-diff, impact, and drift.
3
+ */
4
+ export { runContractDiff, detectContractType, loadSpec } from "./contract-diff.js";
5
+ export { diffOpenApi } from "./openapi-diff.js";
6
+ export { diffAsyncApi } from "./asyncapi-diff.js";
7
+ export { runImpact } from "./impact.js";
8
+ export { runDrift, computeComponentDrift, deriveComponentPaths, getLastCommitDate, daysAgo, } from "./drift.js";
9
+ export type { ContractDiffResult, ContractDiffOptions, DiffFinding, ChangeKind, PayloadConfidence, ImpactResult, ImpactConsumer, ImpactTaskResult, ImpactOptions, DriftResult, DriftEntry, DriftOptions, } from "./types.js";
10
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../core/verify/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AACnF,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EACL,QAAQ,EACR,qBAAqB,EACrB,oBAAoB,EACpB,iBAAiB,EACjB,OAAO,GACR,MAAM,YAAY,CAAC;AACpB,YAAY,EACV,kBAAkB,EAClB,mBAAmB,EACnB,WAAW,EACX,UAAU,EACV,iBAAiB,EACjB,YAAY,EACZ,cAAc,EACd,gBAAgB,EAChB,aAAa,EACb,WAAW,EACX,UAAU,EACV,YAAY,GACb,MAAM,YAAY,CAAC"}