@llipe.com/dev-tasks 0.11.0 → 0.16.2

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 (618) hide show
  1. package/.claude/agents/developer.md +138 -62
  2. package/.claude/agents/github-ops.md +48 -4
  3. package/.claude/agents/housekeeping.md +44 -7
  4. package/.claude/agents/qa-engineer.md +24 -11
  5. package/.claude/agents/researcher.md +26 -6
  6. package/.claude/agents/technical-writer.md +64 -7
  7. package/.claude/agents/ux-engineer.md +1 -0
  8. package/.claude/agents/verifier.md +63 -6
  9. package/.claude/commands/developer.md +2 -266
  10. package/.claude/commands/infra-engineer.md +92 -0
  11. package/.claude/commands/planner.md +98 -29
  12. package/.claude/commands/product-engineer.md +69 -11
  13. package/.claude/commands/researcher.md +4 -5
  14. package/.claude/commands/technical-writer.md +1 -1
  15. package/.claude/hooks/branch-guard.sh +30 -0
  16. package/.claude/hooks/git-guard.sh +573 -24
  17. package/.claude/skills/activity-codebase-research/SKILL.md +4 -11
  18. package/.claude/skills/activity-generate-spec/SKILL.md +34 -10
  19. package/.claude/skills/activity-grill/SKILL.md +150 -0
  20. package/.claude/skills/activity-init/SKILL.md +121 -71
  21. package/.claude/skills/activity-refine/SKILL.md +75 -15
  22. package/.claude/skills/activity-test-standards/SKILL.md +25 -0
  23. package/.claude/skills/aws-ops/SKILL.md +155 -0
  24. package/.claude/skills/deploy-ops/SKILL.md +121 -0
  25. package/.claude/skills/fly-ops/SKILL.md +138 -0
  26. package/.claude/skills/git-ops/SKILL.md +27 -7
  27. package/.claude/skills/implement/SKILL.md +61 -12
  28. package/.claude/skills/memo-cli-usage/REFERENCE.md +230 -17
  29. package/.claude/skills/memo-cli-usage/SKILL.md +68 -13
  30. package/.claude/skills/plan/SKILL.md +43 -1
  31. package/.claude/skills/supabase-ops/SKILL.md +109 -0
  32. package/.github/agents/developer.agent.md +103 -38
  33. package/.github/agents/github-ops.agent.md +46 -4
  34. package/.github/agents/housekeeping.agent.md +43 -7
  35. package/.github/agents/infra-engineer.agent.md +139 -0
  36. package/.github/agents/planner.agent.md +79 -10
  37. package/.github/agents/product-engineer.agent.md +69 -11
  38. package/.github/agents/qa-engineer.agent.md +23 -11
  39. package/.github/agents/researcher.agent.md +25 -6
  40. package/.github/agents/technical-writer.agent.md +63 -7
  41. package/.github/agents/verifier.agent.md +61 -5
  42. package/.github/instructions/implement.instructions.md +61 -12
  43. package/.github/instructions/plan.instructions.md +43 -1
  44. package/.github/prompts/infra-engineer.prompt.md +12 -0
  45. package/.github/prompts/product-engineer-init.prompt.md +5 -6
  46. package/.github/prompts/researcher.prompt.md +4 -5
  47. package/.github/prompts/technical-writer.prompt.md +1 -1
  48. package/.github/skills/activity-codebase-research/SKILL.md +4 -16
  49. package/.github/skills/activity-generate-spec/SKILL.md +34 -10
  50. package/.github/skills/activity-grill/SKILL.md +145 -0
  51. package/.github/skills/activity-init/SKILL.md +120 -70
  52. package/.github/skills/activity-refine/SKILL.md +75 -15
  53. package/.github/skills/activity-test-standards/SKILL.md +25 -0
  54. package/.github/skills/aws-ops/SKILL.md +150 -0
  55. package/.github/skills/deploy-ops/SKILL.md +116 -0
  56. package/.github/skills/fly-ops/SKILL.md +133 -0
  57. package/.github/skills/git-ops/SKILL.md +27 -7
  58. package/.github/skills/memo-cli-usage/REFERENCE.md +230 -17
  59. package/.github/skills/memo-cli-usage/SKILL.md +68 -13
  60. package/.github/skills/supabase-ops/SKILL.md +104 -0
  61. package/.kiro/agents/developer.md +104 -39
  62. package/.kiro/agents/github-ops.md +46 -4
  63. package/.kiro/agents/housekeeping.md +44 -8
  64. package/.kiro/agents/infra-engineer.md +102 -0
  65. package/.kiro/agents/planner.md +87 -21
  66. package/.kiro/agents/product-engineer.md +72 -14
  67. package/.kiro/agents/qa-engineer.md +24 -12
  68. package/.kiro/agents/researcher.md +26 -7
  69. package/.kiro/agents/technical-writer.md +66 -10
  70. package/.kiro/agents/verifier.md +62 -6
  71. package/.kiro/hooks/scripts/git-guard.sh +96 -10
  72. package/.kiro/skills/activity-codebase-research/SKILL.md +4 -11
  73. package/.kiro/skills/activity-generate-spec/SKILL.md +34 -10
  74. package/.kiro/skills/activity-grill/SKILL.md +150 -0
  75. package/.kiro/skills/activity-init/SKILL.md +121 -71
  76. package/.kiro/skills/activity-refine/SKILL.md +75 -15
  77. package/.kiro/skills/activity-test-standards/SKILL.md +25 -0
  78. package/.kiro/skills/aws-ops/SKILL.md +155 -0
  79. package/.kiro/skills/deploy-ops/SKILL.md +121 -0
  80. package/.kiro/skills/fly-ops/SKILL.md +138 -0
  81. package/.kiro/skills/git-ops/SKILL.md +27 -7
  82. package/.kiro/skills/memo-cli-usage/REFERENCE.md +230 -17
  83. package/.kiro/skills/memo-cli-usage/SKILL.md +68 -13
  84. package/.kiro/skills/supabase-ops/SKILL.md +109 -0
  85. package/.kiro/steering/implement.md +61 -12
  86. package/.kiro/steering/plan.md +43 -1
  87. package/AGENTS.md +67 -114
  88. package/AGENTS.md.template +126 -0
  89. package/CHANGELOG.md +182 -0
  90. package/CLAUDE.md +25 -19
  91. package/CLAUDE.md.template +104 -0
  92. package/README.md +168 -146
  93. package/TESTING.md +84 -148
  94. package/bundle-manifest.json +43 -2
  95. package/dist/bin/dev-tasks.js +65 -3
  96. package/dist/bin/dev-tasks.js.map +1 -1
  97. package/dist/{adapters/cli → bin}/parse-args.d.ts +2 -6
  98. package/dist/bin/parse-args.d.ts.map +1 -0
  99. package/dist/{adapters/cli → bin}/parse-args.js +2 -18
  100. package/dist/bin/parse-args.js.map +1 -0
  101. package/dist/core/checks/decision-log-format.d.ts +44 -0
  102. package/dist/core/checks/decision-log-format.d.ts.map +1 -0
  103. package/dist/core/checks/decision-log-format.js +171 -0
  104. package/dist/core/checks/decision-log-format.js.map +1 -0
  105. package/dist/core/checks/docs-structure.d.ts +82 -0
  106. package/dist/core/checks/docs-structure.d.ts.map +1 -0
  107. package/dist/core/checks/docs-structure.js +285 -0
  108. package/dist/core/checks/docs-structure.js.map +1 -0
  109. package/dist/core/checks/glossary.d.ts +178 -0
  110. package/dist/core/checks/glossary.d.ts.map +1 -0
  111. package/dist/core/checks/glossary.js +651 -0
  112. package/dist/core/checks/glossary.js.map +1 -0
  113. package/dist/core/checks/index.d.ts +19 -0
  114. package/dist/core/checks/index.d.ts.map +1 -0
  115. package/dist/core/checks/index.js +16 -0
  116. package/dist/core/checks/index.js.map +1 -0
  117. package/dist/core/checks/run.d.ts +22 -0
  118. package/dist/core/checks/run.d.ts.map +1 -0
  119. package/dist/core/checks/run.js +51 -0
  120. package/dist/core/checks/run.js.map +1 -0
  121. package/dist/core/distribution/doctor.d.ts +46 -1
  122. package/dist/core/distribution/doctor.d.ts.map +1 -1
  123. package/dist/core/distribution/doctor.js +161 -2
  124. package/dist/core/distribution/doctor.js.map +1 -1
  125. package/dist/core/distribution/index.d.ts +9 -3
  126. package/dist/core/distribution/index.d.ts.map +1 -1
  127. package/dist/core/distribution/index.js +5 -2
  128. package/dist/core/distribution/index.js.map +1 -1
  129. package/dist/core/distribution/install-if-absent.d.ts +46 -0
  130. package/dist/core/distribution/install-if-absent.d.ts.map +1 -0
  131. package/dist/core/distribution/install-if-absent.js +81 -0
  132. package/dist/core/distribution/install-if-absent.js.map +1 -0
  133. package/dist/core/distribution/install.d.ts.map +1 -1
  134. package/dist/core/distribution/install.js +5 -0
  135. package/dist/core/distribution/install.js.map +1 -1
  136. package/dist/core/distribution/migrate-docs.d.ts +64 -0
  137. package/dist/core/distribution/migrate-docs.d.ts.map +1 -0
  138. package/dist/core/distribution/migrate-docs.js +139 -0
  139. package/dist/core/distribution/migrate-docs.js.map +1 -0
  140. package/dist/core/distribution/profiles.d.ts +49 -0
  141. package/dist/core/distribution/profiles.d.ts.map +1 -1
  142. package/dist/core/distribution/profiles.js +45 -0
  143. package/dist/core/distribution/profiles.js.map +1 -1
  144. package/dist/core/distribution/update.d.ts +14 -0
  145. package/dist/core/distribution/update.d.ts.map +1 -1
  146. package/dist/core/distribution/update.js +77 -3
  147. package/dist/core/distribution/update.js.map +1 -1
  148. package/dist/core/distribution/workspace.d.ts +84 -0
  149. package/dist/core/distribution/workspace.d.ts.map +1 -0
  150. package/dist/core/distribution/workspace.js +276 -0
  151. package/dist/core/distribution/workspace.js.map +1 -0
  152. package/dist/core/exit-codes.d.ts +15 -35
  153. package/dist/core/exit-codes.d.ts.map +1 -1
  154. package/dist/core/exit-codes.js +15 -36
  155. package/dist/core/exit-codes.js.map +1 -1
  156. package/dist/core/index.d.ts +1 -6
  157. package/dist/core/index.d.ts.map +1 -1
  158. package/dist/core/index.js +1 -7
  159. package/dist/core/index.js.map +1 -1
  160. package/package.json +17 -32
  161. package/templates/claude/settings.json +48 -0
  162. package/templates/domain/ubiquitous-language.md +28 -0
  163. package/templates/infra/environments.yaml +16 -0
  164. package/templates/infra/redaction-patterns.txt +47 -0
  165. package/templates/runbooks/README.md +14 -0
  166. package/templates/runbooks/runbook-template.md +40 -0
  167. package/templates/scripts/deploy-status.sh +89 -0
  168. package/templates/scripts/deploy-verify.sh +85 -0
  169. package/templates/scripts/deploy.sh +284 -0
  170. package/templates/scripts/release.sh +170 -0
  171. package/templates/scripts/rollback.sh +109 -0
  172. package/templates/workflows/deploy-dev.yml +66 -0
  173. package/templates/workflows/deploy-prod.yml +66 -0
  174. package/templates/workflows/rollback.yml +77 -0
  175. package/.claude/skills/activity-contract-validation/SKILL.md +0 -167
  176. package/.github/skills/activity-contract-validation/SKILL.md +0 -167
  177. package/.kiro/skills/activity-contract-validation/SKILL.md +0 -167
  178. package/dist/adapters/cli/catalog-build.d.ts +0 -30
  179. package/dist/adapters/cli/catalog-build.d.ts.map +0 -1
  180. package/dist/adapters/cli/catalog-build.js +0 -73
  181. package/dist/adapters/cli/catalog-build.js.map +0 -1
  182. package/dist/adapters/cli/catalog-query.d.ts +0 -13
  183. package/dist/adapters/cli/catalog-query.d.ts.map +0 -1
  184. package/dist/adapters/cli/catalog-query.js +0 -329
  185. package/dist/adapters/cli/catalog-query.js.map +0 -1
  186. package/dist/adapters/cli/catalog-scaffold.d.ts +0 -24
  187. package/dist/adapters/cli/catalog-scaffold.d.ts.map +0 -1
  188. package/dist/adapters/cli/catalog-scaffold.js +0 -46
  189. package/dist/adapters/cli/catalog-scaffold.js.map +0 -1
  190. package/dist/adapters/cli/catalog-validate.d.ts +0 -35
  191. package/dist/adapters/cli/catalog-validate.d.ts.map +0 -1
  192. package/dist/adapters/cli/catalog-validate.js +0 -122
  193. package/dist/adapters/cli/catalog-validate.js.map +0 -1
  194. package/dist/adapters/cli/ctx-assemble.d.ts +0 -19
  195. package/dist/adapters/cli/ctx-assemble.d.ts.map +0 -1
  196. package/dist/adapters/cli/ctx-assemble.js +0 -293
  197. package/dist/adapters/cli/ctx-assemble.js.map +0 -1
  198. package/dist/adapters/cli/ctx-fetch.d.ts +0 -49
  199. package/dist/adapters/cli/ctx-fetch.d.ts.map +0 -1
  200. package/dist/adapters/cli/ctx-fetch.js +0 -267
  201. package/dist/adapters/cli/ctx-fetch.js.map +0 -1
  202. package/dist/adapters/cli/extract-all.d.ts +0 -31
  203. package/dist/adapters/cli/extract-all.d.ts.map +0 -1
  204. package/dist/adapters/cli/extract-all.js +0 -374
  205. package/dist/adapters/cli/extract-all.js.map +0 -1
  206. package/dist/adapters/cli/extract-asyncapi.d.ts +0 -26
  207. package/dist/adapters/cli/extract-asyncapi.d.ts.map +0 -1
  208. package/dist/adapters/cli/extract-asyncapi.js +0 -142
  209. package/dist/adapters/cli/extract-asyncapi.js.map +0 -1
  210. package/dist/adapters/cli/extract-component.d.ts +0 -24
  211. package/dist/adapters/cli/extract-component.d.ts.map +0 -1
  212. package/dist/adapters/cli/extract-component.js +0 -198
  213. package/dist/adapters/cli/extract-component.js.map +0 -1
  214. package/dist/adapters/cli/extract-detect.d.ts +0 -19
  215. package/dist/adapters/cli/extract-detect.d.ts.map +0 -1
  216. package/dist/adapters/cli/extract-detect.js +0 -98
  217. package/dist/adapters/cli/extract-detect.js.map +0 -1
  218. package/dist/adapters/cli/extract-openapi.d.ts +0 -29
  219. package/dist/adapters/cli/extract-openapi.d.ts.map +0 -1
  220. package/dist/adapters/cli/extract-openapi.js +0 -111
  221. package/dist/adapters/cli/extract-openapi.js.map +0 -1
  222. package/dist/adapters/cli/extract-schema.d.ts +0 -15
  223. package/dist/adapters/cli/extract-schema.d.ts.map +0 -1
  224. package/dist/adapters/cli/extract-schema.js +0 -39
  225. package/dist/adapters/cli/extract-schema.js.map +0 -1
  226. package/dist/adapters/cli/index.d.ts +0 -6
  227. package/dist/adapters/cli/index.d.ts.map +0 -1
  228. package/dist/adapters/cli/index.js +0 -5
  229. package/dist/adapters/cli/index.js.map +0 -1
  230. package/dist/adapters/cli/init.d.ts +0 -37
  231. package/dist/adapters/cli/init.d.ts.map +0 -1
  232. package/dist/adapters/cli/init.js +0 -336
  233. package/dist/adapters/cli/init.js.map +0 -1
  234. package/dist/adapters/cli/parse-args.d.ts.map +0 -1
  235. package/dist/adapters/cli/parse-args.js.map +0 -1
  236. package/dist/adapters/cli/scope-gate.d.ts +0 -25
  237. package/dist/adapters/cli/scope-gate.d.ts.map +0 -1
  238. package/dist/adapters/cli/scope-gate.js +0 -157
  239. package/dist/adapters/cli/scope-gate.js.map +0 -1
  240. package/dist/adapters/cli/scope.d.ts +0 -26
  241. package/dist/adapters/cli/scope.d.ts.map +0 -1
  242. package/dist/adapters/cli/scope.js +0 -172
  243. package/dist/adapters/cli/scope.js.map +0 -1
  244. package/dist/adapters/cli/validate-component.d.ts +0 -24
  245. package/dist/adapters/cli/validate-component.d.ts.map +0 -1
  246. package/dist/adapters/cli/validate-component.js +0 -62
  247. package/dist/adapters/cli/validate-component.js.map +0 -1
  248. package/dist/adapters/cli/verify-contract-diff.d.ts +0 -21
  249. package/dist/adapters/cli/verify-contract-diff.d.ts.map +0 -1
  250. package/dist/adapters/cli/verify-contract-diff.js +0 -69
  251. package/dist/adapters/cli/verify-contract-diff.js.map +0 -1
  252. package/dist/adapters/cli/verify-drift.d.ts +0 -24
  253. package/dist/adapters/cli/verify-drift.d.ts.map +0 -1
  254. package/dist/adapters/cli/verify-drift.js +0 -103
  255. package/dist/adapters/cli/verify-drift.js.map +0 -1
  256. package/dist/adapters/cli/verify-impact.d.ts +0 -23
  257. package/dist/adapters/cli/verify-impact.d.ts.map +0 -1
  258. package/dist/adapters/cli/verify-impact.js +0 -119
  259. package/dist/adapters/cli/verify-impact.js.map +0 -1
  260. package/dist/adapters/mcp/index.d.ts +0 -5
  261. package/dist/adapters/mcp/index.d.ts.map +0 -1
  262. package/dist/adapters/mcp/index.js +0 -2
  263. package/dist/adapters/mcp/index.js.map +0 -1
  264. package/dist/bin/dt.d.ts +0 -7
  265. package/dist/bin/dt.d.ts.map +0 -1
  266. package/dist/bin/dt.js +0 -647
  267. package/dist/bin/dt.js.map +0 -1
  268. package/dist/core/catalog/build.d.ts +0 -143
  269. package/dist/core/catalog/build.d.ts.map +0 -1
  270. package/dist/core/catalog/build.js +0 -475
  271. package/dist/core/catalog/build.js.map +0 -1
  272. package/dist/core/catalog/checks/index.d.ts +0 -18
  273. package/dist/core/catalog/checks/index.d.ts.map +0 -1
  274. package/dist/core/catalog/checks/index.js +0 -18
  275. package/dist/core/catalog/checks/index.js.map +0 -1
  276. package/dist/core/catalog/checks/v01-schema.d.ts +0 -17
  277. package/dist/core/catalog/checks/v01-schema.d.ts.map +0 -1
  278. package/dist/core/catalog/checks/v01-schema.js +0 -57
  279. package/dist/core/catalog/checks/v01-schema.js.map +0 -1
  280. package/dist/core/catalog/checks/v02-v03-identity.d.ts +0 -14
  281. package/dist/core/catalog/checks/v02-v03-identity.d.ts.map +0 -1
  282. package/dist/core/catalog/checks/v02-v03-identity.js +0 -60
  283. package/dist/core/catalog/checks/v02-v03-identity.js.map +0 -1
  284. package/dist/core/catalog/checks/v04-referential-integrity.d.ts +0 -7
  285. package/dist/core/catalog/checks/v04-referential-integrity.d.ts.map +0 -1
  286. package/dist/core/catalog/checks/v04-referential-integrity.js +0 -32
  287. package/dist/core/catalog/checks/v04-referential-integrity.js.map +0 -1
  288. package/dist/core/catalog/checks/v05-domain-existence.d.ts +0 -6
  289. package/dist/core/catalog/checks/v05-domain-existence.d.ts.map +0 -1
  290. package/dist/core/catalog/checks/v05-domain-existence.js +0 -23
  291. package/dist/core/catalog/checks/v05-domain-existence.js.map +0 -1
  292. package/dist/core/catalog/checks/v06-v07-paths.d.ts +0 -29
  293. package/dist/core/catalog/checks/v06-v07-paths.d.ts.map +0 -1
  294. package/dist/core/catalog/checks/v06-v07-paths.js +0 -107
  295. package/dist/core/catalog/checks/v06-v07-paths.js.map +0 -1
  296. package/dist/core/catalog/checks/v08-v10-contracts.d.ts +0 -13
  297. package/dist/core/catalog/checks/v08-v10-contracts.d.ts.map +0 -1
  298. package/dist/core/catalog/checks/v08-v10-contracts.js +0 -70
  299. package/dist/core/catalog/checks/v08-v10-contracts.js.map +0 -1
  300. package/dist/core/catalog/checks/v11-manual-fields.d.ts +0 -16
  301. package/dist/core/catalog/checks/v11-manual-fields.d.ts.map +0 -1
  302. package/dist/core/catalog/checks/v11-manual-fields.js +0 -60
  303. package/dist/core/catalog/checks/v11-manual-fields.js.map +0 -1
  304. package/dist/core/catalog/checks/v12-cycles.d.ts +0 -8
  305. package/dist/core/catalog/checks/v12-cycles.d.ts.map +0 -1
  306. package/dist/core/catalog/checks/v12-cycles.js +0 -28
  307. package/dist/core/catalog/checks/v12-cycles.js.map +0 -1
  308. package/dist/core/catalog/checks/v13-orphan-contracts.d.ts +0 -7
  309. package/dist/core/catalog/checks/v13-orphan-contracts.d.ts.map +0 -1
  310. package/dist/core/catalog/checks/v13-orphan-contracts.js +0 -33
  311. package/dist/core/catalog/checks/v13-orphan-contracts.js.map +0 -1
  312. package/dist/core/catalog/checks/v14-v15-lifecycle.d.ts +0 -8
  313. package/dist/core/catalog/checks/v14-v15-lifecycle.d.ts.map +0 -1
  314. package/dist/core/catalog/checks/v14-v15-lifecycle.js +0 -42
  315. package/dist/core/catalog/checks/v14-v15-lifecycle.js.map +0 -1
  316. package/dist/core/catalog/checks/v16-deprecated-consumers.d.ts +0 -7
  317. package/dist/core/catalog/checks/v16-deprecated-consumers.d.ts.map +0 -1
  318. package/dist/core/catalog/checks/v16-deprecated-consumers.js +0 -47
  319. package/dist/core/catalog/checks/v16-deprecated-consumers.js.map +0 -1
  320. package/dist/core/catalog/checks/v17-low-confidence.d.ts +0 -7
  321. package/dist/core/catalog/checks/v17-low-confidence.d.ts.map +0 -1
  322. package/dist/core/catalog/checks/v17-low-confidence.js +0 -32
  323. package/dist/core/catalog/checks/v17-low-confidence.js.map +0 -1
  324. package/dist/core/catalog/checks/v18-low-payload.d.ts +0 -7
  325. package/dist/core/catalog/checks/v18-low-payload.d.ts.map +0 -1
  326. package/dist/core/catalog/checks/v18-low-payload.js +0 -33
  327. package/dist/core/catalog/checks/v18-low-payload.js.map +0 -1
  328. package/dist/core/catalog/checks/v19-domain-membership.d.ts +0 -8
  329. package/dist/core/catalog/checks/v19-domain-membership.d.ts.map +0 -1
  330. package/dist/core/catalog/checks/v19-domain-membership.js +0 -55
  331. package/dist/core/catalog/checks/v19-domain-membership.js.map +0 -1
  332. package/dist/core/catalog/coverage.d.ts +0 -39
  333. package/dist/core/catalog/coverage.d.ts.map +0 -1
  334. package/dist/core/catalog/coverage.js +0 -62
  335. package/dist/core/catalog/coverage.js.map +0 -1
  336. package/dist/core/catalog/graph.d.ts +0 -49
  337. package/dist/core/catalog/graph.d.ts.map +0 -1
  338. package/dist/core/catalog/graph.js +0 -114
  339. package/dist/core/catalog/graph.js.map +0 -1
  340. package/dist/core/catalog/index-model.d.ts +0 -96
  341. package/dist/core/catalog/index-model.d.ts.map +0 -1
  342. package/dist/core/catalog/index-model.js +0 -8
  343. package/dist/core/catalog/index-model.js.map +0 -1
  344. package/dist/core/catalog/index.d.ts +0 -5
  345. package/dist/core/catalog/index.d.ts.map +0 -1
  346. package/dist/core/catalog/index.js +0 -2
  347. package/dist/core/catalog/index.js.map +0 -1
  348. package/dist/core/catalog/queries.d.ts +0 -69
  349. package/dist/core/catalog/queries.d.ts.map +0 -1
  350. package/dist/core/catalog/queries.js +0 -165
  351. package/dist/core/catalog/queries.js.map +0 -1
  352. package/dist/core/catalog/resolve.d.ts +0 -47
  353. package/dist/core/catalog/resolve.d.ts.map +0 -1
  354. package/dist/core/catalog/resolve.js +0 -318
  355. package/dist/core/catalog/resolve.js.map +0 -1
  356. package/dist/core/catalog/scaffold.d.ts +0 -31
  357. package/dist/core/catalog/scaffold.d.ts.map +0 -1
  358. package/dist/core/catalog/scaffold.js +0 -141
  359. package/dist/core/catalog/scaffold.js.map +0 -1
  360. package/dist/core/catalog/validate-component.d.ts +0 -50
  361. package/dist/core/catalog/validate-component.d.ts.map +0 -1
  362. package/dist/core/catalog/validate-component.js +0 -105
  363. package/dist/core/catalog/validate-component.js.map +0 -1
  364. package/dist/core/catalog/validate.d.ts +0 -71
  365. package/dist/core/catalog/validate.d.ts.map +0 -1
  366. package/dist/core/catalog/validate.js +0 -103
  367. package/dist/core/catalog/validate.js.map +0 -1
  368. package/dist/core/context/assemble.d.ts +0 -126
  369. package/dist/core/context/assemble.d.ts.map +0 -1
  370. package/dist/core/context/assemble.js +0 -197
  371. package/dist/core/context/assemble.js.map +0 -1
  372. package/dist/core/context/cache.d.ts +0 -60
  373. package/dist/core/context/cache.d.ts.map +0 -1
  374. package/dist/core/context/cache.js +0 -236
  375. package/dist/core/context/cache.js.map +0 -1
  376. package/dist/core/context/exit-codes.d.ts +0 -28
  377. package/dist/core/context/exit-codes.d.ts.map +0 -1
  378. package/dist/core/context/exit-codes.js +0 -28
  379. package/dist/core/context/exit-codes.js.map +0 -1
  380. package/dist/core/context/fetch.d.ts +0 -55
  381. package/dist/core/context/fetch.d.ts.map +0 -1
  382. package/dist/core/context/fetch.js +0 -112
  383. package/dist/core/context/fetch.js.map +0 -1
  384. package/dist/core/context/index.d.ts +0 -11
  385. package/dist/core/context/index.d.ts.map +0 -1
  386. package/dist/core/context/index.js +0 -8
  387. package/dist/core/context/index.js.map +0 -1
  388. package/dist/core/context/init.d.ts +0 -179
  389. package/dist/core/context/init.d.ts.map +0 -1
  390. package/dist/core/context/init.js +0 -532
  391. package/dist/core/context/init.js.map +0 -1
  392. package/dist/core/context/layers/architecture-layer.d.ts +0 -13
  393. package/dist/core/context/layers/architecture-layer.d.ts.map +0 -1
  394. package/dist/core/context/layers/architecture-layer.js +0 -24
  395. package/dist/core/context/layers/architecture-layer.js.map +0 -1
  396. package/dist/core/context/layers/contracts-layer.d.ts +0 -13
  397. package/dist/core/context/layers/contracts-layer.d.ts.map +0 -1
  398. package/dist/core/context/layers/contracts-layer.js +0 -83
  399. package/dist/core/context/layers/contracts-layer.js.map +0 -1
  400. package/dist/core/context/layers/conventions-delta-layer.d.ts +0 -13
  401. package/dist/core/context/layers/conventions-delta-layer.d.ts.map +0 -1
  402. package/dist/core/context/layers/conventions-delta-layer.js +0 -37
  403. package/dist/core/context/layers/conventions-delta-layer.js.map +0 -1
  404. package/dist/core/context/layers/flow-layer.d.ts +0 -14
  405. package/dist/core/context/layers/flow-layer.d.ts.map +0 -1
  406. package/dist/core/context/layers/flow-layer.js +0 -61
  407. package/dist/core/context/layers/flow-layer.js.map +0 -1
  408. package/dist/core/context/layers/index-layer.d.ts +0 -13
  409. package/dist/core/context/layers/index-layer.d.ts.map +0 -1
  410. package/dist/core/context/layers/index-layer.js +0 -77
  411. package/dist/core/context/layers/index-layer.js.map +0 -1
  412. package/dist/core/context/layers/primary-layer.d.ts +0 -16
  413. package/dist/core/context/layers/primary-layer.d.ts.map +0 -1
  414. package/dist/core/context/layers/primary-layer.js +0 -61
  415. package/dist/core/context/layers/primary-layer.js.map +0 -1
  416. package/dist/core/context/layers/secondary-layer.d.ts +0 -19
  417. package/dist/core/context/layers/secondary-layer.d.ts.map +0 -1
  418. package/dist/core/context/layers/secondary-layer.js +0 -52
  419. package/dist/core/context/layers/secondary-layer.js.map +0 -1
  420. package/dist/core/context/session-lock.d.ts +0 -114
  421. package/dist/core/context/session-lock.d.ts.map +0 -1
  422. package/dist/core/context/session-lock.js +0 -90
  423. package/dist/core/context/session-lock.js.map +0 -1
  424. package/dist/core/context/tokens.d.ts +0 -35
  425. package/dist/core/context/tokens.d.ts.map +0 -1
  426. package/dist/core/context/tokens.js +0 -88
  427. package/dist/core/context/tokens.js.map +0 -1
  428. package/dist/core/extract/asyncapi/declared.d.ts +0 -19
  429. package/dist/core/extract/asyncapi/declared.d.ts.map +0 -1
  430. package/dist/core/extract/asyncapi/declared.js +0 -168
  431. package/dist/core/extract/asyncapi/declared.js.map +0 -1
  432. package/dist/core/extract/asyncapi/index.d.ts +0 -12
  433. package/dist/core/extract/asyncapi/index.d.ts.map +0 -1
  434. package/dist/core/extract/asyncapi/index.js +0 -8
  435. package/dist/core/extract/asyncapi/index.js.map +0 -1
  436. package/dist/core/extract/asyncapi/payloads.d.ts +0 -20
  437. package/dist/core/extract/asyncapi/payloads.d.ts.map +0 -1
  438. package/dist/core/extract/asyncapi/payloads.js +0 -421
  439. package/dist/core/extract/asyncapi/payloads.js.map +0 -1
  440. package/dist/core/extract/asyncapi/topics.d.ts +0 -27
  441. package/dist/core/extract/asyncapi/topics.d.ts.map +0 -1
  442. package/dist/core/extract/asyncapi/topics.js +0 -368
  443. package/dist/core/extract/asyncapi/topics.js.map +0 -1
  444. package/dist/core/extract/asyncapi/types.d.ts +0 -129
  445. package/dist/core/extract/asyncapi/types.d.ts.map +0 -1
  446. package/dist/core/extract/asyncapi/types.js +0 -5
  447. package/dist/core/extract/asyncapi/types.js.map +0 -1
  448. package/dist/core/extract/asyncapi/validate.d.ts +0 -29
  449. package/dist/core/extract/asyncapi/validate.d.ts.map +0 -1
  450. package/dist/core/extract/asyncapi/validate.js +0 -156
  451. package/dist/core/extract/asyncapi/validate.js.map +0 -1
  452. package/dist/core/extract/component.d.ts +0 -204
  453. package/dist/core/extract/component.d.ts.map +0 -1
  454. package/dist/core/extract/component.js +0 -258
  455. package/dist/core/extract/component.js.map +0 -1
  456. package/dist/core/extract/detect.d.ts +0 -35
  457. package/dist/core/extract/detect.d.ts.map +0 -1
  458. package/dist/core/extract/detect.js +0 -89
  459. package/dist/core/extract/detect.js.map +0 -1
  460. package/dist/core/extract/index.d.ts +0 -12
  461. package/dist/core/extract/index.d.ts.map +0 -1
  462. package/dist/core/extract/index.js +0 -6
  463. package/dist/core/extract/index.js.map +0 -1
  464. package/dist/core/extract/ladder.d.ts +0 -79
  465. package/dist/core/extract/ladder.d.ts.map +0 -1
  466. package/dist/core/extract/ladder.js +0 -70
  467. package/dist/core/extract/ladder.js.map +0 -1
  468. package/dist/core/extract/openapi/index.d.ts +0 -43
  469. package/dist/core/extract/openapi/index.d.ts.map +0 -1
  470. package/dist/core/extract/openapi/index.js +0 -142
  471. package/dist/core/extract/openapi/index.js.map +0 -1
  472. package/dist/core/extract/openapi/route1.d.ts +0 -36
  473. package/dist/core/extract/openapi/route1.d.ts.map +0 -1
  474. package/dist/core/extract/openapi/route1.js +0 -333
  475. package/dist/core/extract/openapi/route1.js.map +0 -1
  476. package/dist/core/extract/openapi/route2-introspect.d.ts +0 -18
  477. package/dist/core/extract/openapi/route2-introspect.d.ts.map +0 -1
  478. package/dist/core/extract/openapi/route2-introspect.js +0 -249
  479. package/dist/core/extract/openapi/route2-introspect.js.map +0 -1
  480. package/dist/core/extract/openapi/route2.d.ts +0 -69
  481. package/dist/core/extract/openapi/route2.d.ts.map +0 -1
  482. package/dist/core/extract/openapi/route2.js +0 -211
  483. package/dist/core/extract/openapi/route2.js.map +0 -1
  484. package/dist/core/extract/openapi/route3.d.ts +0 -26
  485. package/dist/core/extract/openapi/route3.d.ts.map +0 -1
  486. package/dist/core/extract/openapi/route3.js +0 -737
  487. package/dist/core/extract/openapi/route3.js.map +0 -1
  488. package/dist/core/extract/openapi/types.d.ts +0 -125
  489. package/dist/core/extract/openapi/types.d.ts.map +0 -1
  490. package/dist/core/extract/openapi/types.js +0 -5
  491. package/dist/core/extract/openapi/types.js.map +0 -1
  492. package/dist/core/extract/openapi/validate.d.ts +0 -29
  493. package/dist/core/extract/openapi/validate.d.ts.map +0 -1
  494. package/dist/core/extract/openapi/validate.js +0 -200
  495. package/dist/core/extract/openapi/validate.js.map +0 -1
  496. package/dist/core/extract/orm/drizzle.d.ts +0 -20
  497. package/dist/core/extract/orm/drizzle.d.ts.map +0 -1
  498. package/dist/core/extract/orm/drizzle.js +0 -283
  499. package/dist/core/extract/orm/drizzle.js.map +0 -1
  500. package/dist/core/extract/orm/information-schema.d.ts +0 -26
  501. package/dist/core/extract/orm/information-schema.d.ts.map +0 -1
  502. package/dist/core/extract/orm/information-schema.js +0 -142
  503. package/dist/core/extract/orm/information-schema.js.map +0 -1
  504. package/dist/core/extract/orm/prisma.d.ts +0 -23
  505. package/dist/core/extract/orm/prisma.d.ts.map +0 -1
  506. package/dist/core/extract/orm/prisma.js +0 -234
  507. package/dist/core/extract/orm/prisma.js.map +0 -1
  508. package/dist/core/extract/orm/typeorm.d.ts +0 -22
  509. package/dist/core/extract/orm/typeorm.d.ts.map +0 -1
  510. package/dist/core/extract/orm/typeorm.js +0 -269
  511. package/dist/core/extract/orm/typeorm.js.map +0 -1
  512. package/dist/core/extract/orm/types.d.ts +0 -97
  513. package/dist/core/extract/orm/types.d.ts.map +0 -1
  514. package/dist/core/extract/orm/types.js +0 -6
  515. package/dist/core/extract/orm/types.js.map +0 -1
  516. package/dist/core/extract/prompt.d.ts +0 -21
  517. package/dist/core/extract/prompt.d.ts.map +0 -1
  518. package/dist/core/extract/prompt.js +0 -79
  519. package/dist/core/extract/prompt.js.map +0 -1
  520. package/dist/core/extract/provider.d.ts +0 -121
  521. package/dist/core/extract/provider.d.ts.map +0 -1
  522. package/dist/core/extract/provider.js +0 -6
  523. package/dist/core/extract/provider.js.map +0 -1
  524. package/dist/core/extract/providers/node-ts.d.ts +0 -69
  525. package/dist/core/extract/providers/node-ts.d.ts.map +0 -1
  526. package/dist/core/extract/providers/node-ts.js +0 -320
  527. package/dist/core/extract/providers/node-ts.js.map +0 -1
  528. package/dist/core/extract/render/schema-md.d.ts +0 -16
  529. package/dist/core/extract/render/schema-md.d.ts.map +0 -1
  530. package/dist/core/extract/render/schema-md.js +0 -140
  531. package/dist/core/extract/render/schema-md.js.map +0 -1
  532. package/dist/core/extract/report.d.ts +0 -125
  533. package/dist/core/extract/report.d.ts.map +0 -1
  534. package/dist/core/extract/report.js +0 -52
  535. package/dist/core/extract/report.js.map +0 -1
  536. package/dist/core/extract/schema.d.ts +0 -34
  537. package/dist/core/extract/schema.d.ts.map +0 -1
  538. package/dist/core/extract/schema.js +0 -146
  539. package/dist/core/extract/schema.js.map +0 -1
  540. package/dist/core/extract/workspaces.d.ts +0 -33
  541. package/dist/core/extract/workspaces.d.ts.map +0 -1
  542. package/dist/core/extract/workspaces.js +0 -193
  543. package/dist/core/extract/workspaces.js.map +0 -1
  544. package/dist/core/providers/index.d.ts +0 -6
  545. package/dist/core/providers/index.d.ts.map +0 -1
  546. package/dist/core/providers/index.js +0 -2
  547. package/dist/core/providers/index.js.map +0 -1
  548. package/dist/core/providers/tracker.d.ts +0 -74
  549. package/dist/core/providers/tracker.d.ts.map +0 -1
  550. package/dist/core/providers/tracker.js +0 -38
  551. package/dist/core/providers/tracker.js.map +0 -1
  552. package/dist/core/scope/calibration.d.ts +0 -25
  553. package/dist/core/scope/calibration.d.ts.map +0 -1
  554. package/dist/core/scope/calibration.js +0 -52
  555. package/dist/core/scope/calibration.js.map +0 -1
  556. package/dist/core/scope/closure.d.ts +0 -31
  557. package/dist/core/scope/closure.d.ts.map +0 -1
  558. package/dist/core/scope/closure.js +0 -68
  559. package/dist/core/scope/closure.js.map +0 -1
  560. package/dist/core/scope/gate.d.ts +0 -41
  561. package/dist/core/scope/gate.d.ts.map +0 -1
  562. package/dist/core/scope/gate.js +0 -165
  563. package/dist/core/scope/gate.js.map +0 -1
  564. package/dist/core/scope/index.d.ts +0 -18
  565. package/dist/core/scope/index.d.ts.map +0 -1
  566. package/dist/core/scope/index.js +0 -12
  567. package/dist/core/scope/index.js.map +0 -1
  568. package/dist/core/scope/partition.d.ts +0 -36
  569. package/dist/core/scope/partition.d.ts.map +0 -1
  570. package/dist/core/scope/partition.js +0 -78
  571. package/dist/core/scope/partition.js.map +0 -1
  572. package/dist/core/scope/prompt.d.ts +0 -39
  573. package/dist/core/scope/prompt.d.ts.map +0 -1
  574. package/dist/core/scope/prompt.js +0 -123
  575. package/dist/core/scope/prompt.js.map +0 -1
  576. package/dist/core/scope/scoping.d.ts +0 -52
  577. package/dist/core/scope/scoping.d.ts.map +0 -1
  578. package/dist/core/scope/scoping.js +0 -99
  579. package/dist/core/scope/scoping.js.map +0 -1
  580. package/dist/core/scope/types.d.ts +0 -77
  581. package/dist/core/scope/types.d.ts.map +0 -1
  582. package/dist/core/scope/types.js +0 -5
  583. package/dist/core/scope/types.js.map +0 -1
  584. package/dist/core/scope/validate.d.ts +0 -47
  585. package/dist/core/scope/validate.d.ts.map +0 -1
  586. package/dist/core/scope/validate.js +0 -90
  587. package/dist/core/scope/validate.js.map +0 -1
  588. package/dist/core/verify/asyncapi-diff.d.ts +0 -34
  589. package/dist/core/verify/asyncapi-diff.d.ts.map +0 -1
  590. package/dist/core/verify/asyncapi-diff.js +0 -209
  591. package/dist/core/verify/asyncapi-diff.js.map +0 -1
  592. package/dist/core/verify/contract-diff.d.ts +0 -39
  593. package/dist/core/verify/contract-diff.d.ts.map +0 -1
  594. package/dist/core/verify/contract-diff.js +0 -63
  595. package/dist/core/verify/contract-diff.js.map +0 -1
  596. package/dist/core/verify/drift.d.ts +0 -47
  597. package/dist/core/verify/drift.d.ts.map +0 -1
  598. package/dist/core/verify/drift.js +0 -122
  599. package/dist/core/verify/drift.js.map +0 -1
  600. package/dist/core/verify/impact.d.ts +0 -22
  601. package/dist/core/verify/impact.d.ts.map +0 -1
  602. package/dist/core/verify/impact.js +0 -93
  603. package/dist/core/verify/impact.js.map +0 -1
  604. package/dist/core/verify/index.d.ts +0 -10
  605. package/dist/core/verify/index.d.ts.map +0 -1
  606. package/dist/core/verify/index.js +0 -9
  607. package/dist/core/verify/index.js.map +0 -1
  608. package/dist/core/verify/openapi-diff.d.ts +0 -29
  609. package/dist/core/verify/openapi-diff.d.ts.map +0 -1
  610. package/dist/core/verify/openapi-diff.js +0 -291
  611. package/dist/core/verify/openapi-diff.js.map +0 -1
  612. package/dist/core/verify/types.d.ts +0 -138
  613. package/dist/core/verify/types.d.ts.map +0 -1
  614. package/dist/core/verify/types.js +0 -5
  615. package/dist/core/verify/types.js.map +0 -1
  616. package/schemas/component.schema.json +0 -203
  617. package/schemas/flow.schema.json +0 -75
  618. package/schemas/scope-output.schema.json +0 -62
@@ -0,0 +1,66 @@
1
+ # templates/workflows/deploy-prod.yml
2
+ #
3
+ # Consumer-owned production deploy workflow, delivered by infra-engineer via
4
+ # deploy-ops. Fires only on an exact-semver annotated release tag and runs
5
+ # behind the GitHub `production` environment, whose required reviewer stops the
6
+ # job until a human approves. It deploys by calling the canonical
7
+ # templates/scripts/deploy.sh prod — no inline aws/flyctl/supabase deploy logic.
8
+ #
9
+ # Prune the tool setup steps your target does not use when you scaffold this.
10
+
11
+ name: Deploy prod
12
+
13
+ on:
14
+ push:
15
+ tags:
16
+ - "v[0-9]+.[0-9]+.[0-9]+"
17
+
18
+ # OIDC for AWS role assumption; no long-lived cloud keys in the repo.
19
+ permissions:
20
+ contents: read
21
+ id-token: write
22
+
23
+ concurrency:
24
+ group: deploy-prod
25
+ cancel-in-progress: false
26
+
27
+ jobs:
28
+ deploy-prod:
29
+ name: Deploy production environment
30
+ runs-on: ubuntu-latest
31
+ # Required reviewer on this environment holds the job until a human approves.
32
+ environment: production
33
+
34
+ steps:
35
+ - name: Checkout repository
36
+ uses: actions/checkout@v4
37
+ with:
38
+ fetch-depth: 0 # scripts assert the tag is annotated and on main
39
+
40
+ # ── Tool setup (version-pinned; prune what you do not use) ──────────────
41
+ - name: Configure AWS credentials (OIDC)
42
+ uses: aws-actions/configure-aws-credentials@v4
43
+ with:
44
+ role-to-assume: ${{ secrets.AWS_DEPLOY_ROLE_ARN }}
45
+ aws-region: ${{ vars.AWS_REGION }}
46
+
47
+ - name: Set up flyctl
48
+ uses: superfly/flyctl-actions/setup-flyctl@v1
49
+
50
+ - name: Set up Supabase CLI
51
+ uses: supabase/setup-cli@v1
52
+ with:
53
+ version: latest
54
+
55
+ - name: Set up yq
56
+ uses: mikefarah/yq@v4
57
+
58
+ # ── Deploy via the canonical script only ────────────────────────────────
59
+ # The human-only guard requires INFRA_HUMAN_APPROVED=1; the protected
60
+ # environment reviewer approval is what authorizes this run.
61
+ - name: Deploy prod
62
+ env:
63
+ FLY_API_TOKEN: ${{ secrets.FLY_API_TOKEN }}
64
+ SUPABASE_ACCESS_TOKEN: ${{ secrets.SUPABASE_ACCESS_TOKEN }}
65
+ INFRA_HUMAN_APPROVED: "1"
66
+ run: bash templates/scripts/deploy.sh prod
@@ -0,0 +1,77 @@
1
+ # templates/workflows/rollback.yml
2
+ #
3
+ # Consumer-owned rollback workflow, delivered by infra-engineer via deploy-ops.
4
+ # Dispatched on demand (workflow_dispatch) with an environment input, it rolls
5
+ # an environment back to its previous good version by calling the canonical
6
+ # templates/scripts/rollback.sh — no inline aws/flyctl/supabase logic.
7
+ #
8
+ # When the `environment` input names a production environment, the job runs
9
+ # behind the GitHub `production` environment reviewer. Prune the tool setup
10
+ # steps your target does not use when you scaffold this.
11
+
12
+ name: Rollback
13
+
14
+ on:
15
+ workflow_dispatch:
16
+ inputs:
17
+ environment:
18
+ description: "Environment to roll back (must exist in infra/environments.yaml)"
19
+ required: true
20
+ type: string
21
+ to_version:
22
+ description: "Optional explicit version to roll back to (defaults to previous good)"
23
+ required: false
24
+ type: string
25
+
26
+ permissions:
27
+ contents: read
28
+ id-token: write
29
+
30
+ concurrency:
31
+ group: rollback-${{ github.event.inputs.environment }}
32
+ cancel-in-progress: false
33
+
34
+ jobs:
35
+ rollback:
36
+ name: Roll back ${{ github.event.inputs.environment }}
37
+ runs-on: ubuntu-latest
38
+ # Rollbacks of production run behind the same reviewer gate as deploys.
39
+ environment: production
40
+
41
+ steps:
42
+ - name: Checkout repository
43
+ uses: actions/checkout@v4
44
+ with:
45
+ fetch-depth: 0 # rollback.sh resolves the previous good version from history
46
+
47
+ # ── Tool setup (version-pinned; prune what you do not use) ──────────────
48
+ - name: Configure AWS credentials (OIDC)
49
+ uses: aws-actions/configure-aws-credentials@v4
50
+ with:
51
+ role-to-assume: ${{ secrets.AWS_DEPLOY_ROLE_ARN }}
52
+ aws-region: ${{ vars.AWS_REGION }}
53
+
54
+ - name: Set up flyctl
55
+ uses: superfly/flyctl-actions/setup-flyctl@v1
56
+
57
+ - name: Set up Supabase CLI
58
+ uses: supabase/setup-cli@v1
59
+ with:
60
+ version: latest
61
+
62
+ - name: Set up yq
63
+ uses: mikefarah/yq@v4
64
+
65
+ # ── Roll back via the canonical script only ─────────────────────────────
66
+ - name: Roll back
67
+ env:
68
+ FLY_API_TOKEN: ${{ secrets.FLY_API_TOKEN }}
69
+ SUPABASE_ACCESS_TOKEN: ${{ secrets.SUPABASE_ACCESS_TOKEN }}
70
+ INFRA_HUMAN_APPROVED: "1"
71
+ ROLLBACK_TO_VERSION: ${{ github.event.inputs.to_version }}
72
+ run: |
73
+ if [ -n "${ROLLBACK_TO_VERSION}" ]; then
74
+ bash templates/scripts/rollback.sh "${{ github.event.inputs.environment }}" --to "${ROLLBACK_TO_VERSION}"
75
+ else
76
+ bash templates/scripts/rollback.sh "${{ github.event.inputs.environment }}"
77
+ fi
@@ -1,167 +0,0 @@
1
- ---
2
- name: activity-contract-validation
3
- description: "Validate API contracts against implementation using dt verify (contract-diff, impact, drift). Detects breaking changes, consumer impact, and spec-to-code staleness. Use when checking API boundary integrity."
4
- ---
5
-
6
- # Activity: Contract Validation
7
-
8
- Detect API spec drift, breaking changes, and consumer impact using the `dt verify` family. This skill wires existing extraction and verification tooling into the QA path.
9
-
10
- ---
11
-
12
- > **RFC 2119 Notice:** The key words **MUST**, **MUST NOT**, **REQUIRED**, **SHALL**, **SHALL NOT**, **SHOULD**, **SHOULD NOT**, **RECOMMENDED**, **MAY**, and **OPTIONAL** in this document are to be interpreted as described in [RFC 2119](https://www.rfc-editor.org/rfc/rfc2119).
13
-
14
- ## Goal
15
-
16
- Detect misalignment between API specifications and implementation before it reaches consumers. Contract validation checks the boundary — it does not test internal behavior.
17
-
18
- Consult `/TESTING.md` first. Its Contract Validation layer boundary governs.
19
-
20
- ## Contract Validation Boundary
21
-
22
- - **MUST** validate the API boundary (endpoints, schemas, events) against the specification.
23
- - **MUST NOT** test internal business logic — that belongs at Layer 1 or 2.
24
- - **MUST NOT** require a running server — operates on static specs and source analysis.
25
- - **MAY** complement live testing but is not a substitute for E2E.
26
-
27
- ## Part 1 — Prerequisite Detection
28
-
29
- ### Check `dt` availability
30
-
31
- ```bash
32
- which dt && dt --version
33
- ```
34
-
35
- - If `dt` is not found: emit `SKIPPED(dt not installed)` and provide manual instructions.
36
- - If `dt` is found but not configured for the repo: emit `SKIPPED(dt not configured — run dt init)`.
37
-
38
- ### Detect API specifications
39
-
40
- Search the repository for:
41
-
42
- - `openapi.yaml`, `openapi.json`, `swagger.yaml`, `swagger.json` (or under `docs/`, `api/`, `specs/`)
43
- - `asyncapi.yaml`, `asyncapi.json`
44
- - `component.json` (dt-managed extraction output)
45
-
46
- If no specs found: emit `SKIPPED(no OpenAPI or AsyncAPI spec found in repository)`.
47
-
48
- ## Part 2 — Contract Diff (Breaking Change Detection)
49
-
50
- Run against the base branch to detect breaking changes introduced by the current work:
51
-
52
- ```bash
53
- dt verify contract-diff --base origin/main --head HEAD
54
- ```
55
-
56
- ### Findings classification
57
-
58
- | Exit code | Meaning | Severity |
59
- | --------- | ------------------------- | -------- |
60
- | 0 | No breaking changes | — |
61
- | 8 | Breaking changes detected | Critical |
62
- | 1 | Execution error | Blocked |
63
-
64
- ### Report format
65
-
66
- For each breaking change found:
67
-
68
- ```markdown
69
- | Finding | Severity | Path | Description |
70
- | ------- | -------- | ------------------------------- | ------------------------------------------ |
71
- | BREAK-1 | critical | POST /api/orders → request body | Required field `customerId` removed |
72
- | BREAK-2 | major | GET /api/users → response | Field `email` type changed string → object |
73
- ```
74
-
75
- ## Part 3 — Impact Analysis (Consumer Enumeration)
76
-
77
- When breaking changes are detected, identify affected consumers:
78
-
79
- ```bash
80
- dt verify impact --contract <contract-id>
81
- ```
82
-
83
- Report:
84
-
85
- - List of consumers that depend on the changed contract.
86
- - Per consumer: which endpoints/events they consume.
87
- - Recommendation: notify consumers, or validate with consumer-driven tests.
88
-
89
- ## Part 4 — Drift Detection (Spec-to-Implementation Staleness)
90
-
91
- Check whether the specification and implementation have diverged:
92
-
93
- ```bash
94
- dt verify drift [--id <component-id>]
95
- ```
96
-
97
- ### Drift types
98
-
99
- | Type | Description | Severity |
100
- | --------------- | ----------------------------------------------- | -------- |
101
- | Spec-ahead | Spec documents endpoints not in code | Major |
102
- | Code-ahead | Code has endpoints not in spec | Major |
103
- | Stale | Spec not updated in >90 days while code changed | Minor |
104
- | Schema-mismatch | Response shape differs from spec | Critical |
105
-
106
- ### Report format
107
-
108
- Same risk-ranked table format as `activity-coverage-gap-analysis`:
109
-
110
- ```markdown
111
- | Finding | Severity | Component | Description | Days since spec update |
112
- | ------- | -------- | ------------ | ---------------------------------------------- | ---------------------- |
113
- | DRIFT-1 | critical | api-gateway | Response schema mismatch: /api/orders | — |
114
- | DRIFT-2 | major | api-gateway | 12 endpoints in code, 8 in spec | — |
115
- | DRIFT-3 | minor | auth-service | Spec unchanged 120 days, 14 code commits since | 120 |
116
- ```
117
-
118
- ## Part 5 — Integration with Coverage Gate
119
-
120
- Contract validation findings **MUST** be reported alongside coverage in the `coverage_gate` path:
121
-
122
- - Breaking changes → block completion (critical findings).
123
- - Drift findings → report but do not block (route to follow-up or drift-reconciliation).
124
- - No spec found → skip with reason (does not count as a gap).
125
-
126
- ### Aggregated output
127
-
128
- ```markdown
129
- ## Contract Validation Summary
130
-
131
- - **Spec detected:** OpenAPI 3.1 at `api/openapi.yaml`
132
- - **Breaking changes:** 0 | **Drift findings:** 2 | **Impact:** N/A
133
- - **Status:** PASS (no breaking changes)
134
-
135
- ### Drift Findings (non-blocking)
136
-
137
- | ... |
138
- ```
139
-
140
- ## Fallback — Manual Validation
141
-
142
- When `dt` is not installed, provide these manual steps:
143
-
144
- 1. **Diff specs manually:** compare `api/openapi.yaml` across branches.
145
- 2. **Check for undocumented endpoints:** search route handlers not in the spec.
146
- 3. **Schema validation:** run `npx @redocly/cli lint api/openapi.yaml` or equivalent.
147
- 4. **Consumer notification:** manually identify consumers from project documentation.
148
-
149
- ## Output
150
-
151
- - `dt` availability status
152
- - Spec detection result (type, path, version)
153
- - Breaking changes (count, details, severity)
154
- - Consumer impact (when applicable)
155
- - Drift findings (count, details, severity, days since update)
156
- - Aggregated status for `coverage_gate` integration
157
- - Manual fallback instructions (when `dt` unavailable)
158
-
159
- ## Final Instructions
160
-
161
- 1. You **MUST** check `dt` availability before attempting verification.
162
- 2. You **MUST** emit `SKIPPED` with a reason when prerequisites are missing.
163
- 3. You **MUST** classify findings by severity using the tables above.
164
- 4. You **MUST** report breaking changes as critical findings that block completion.
165
- 5. You **MUST** report drift as non-blocking findings for follow-up.
166
- 6. You **MUST NOT** test internal business logic — contract validation is boundary-only.
167
- 7. You **MUST NOT** install `dt` or any dependency — detect and recommend only.
@@ -1,167 +0,0 @@
1
- ---
2
- name: activity-contract-validation
3
- description: "Validate API contracts against implementation using dt verify (contract-diff, impact, drift). Detects breaking changes, consumer impact, and spec-to-code staleness. Use when checking API boundary integrity."
4
- ---
5
-
6
- # Activity: Contract Validation
7
-
8
- Detect API spec drift, breaking changes, and consumer impact using the `dt verify` family. This skill wires existing extraction and verification tooling into the QA path.
9
-
10
- ---
11
-
12
- > **RFC 2119 Notice:** The key words **MUST**, **MUST NOT**, **REQUIRED**, **SHALL**, **SHALL NOT**, **SHOULD**, **SHOULD NOT**, **RECOMMENDED**, **MAY**, and **OPTIONAL** in this document are to be interpreted as described in [RFC 2119](https://www.rfc-editor.org/rfc/rfc2119).
13
-
14
- ## Goal
15
-
16
- Detect misalignment between API specifications and implementation before it reaches consumers. Contract validation checks the boundary — it does not test internal behavior.
17
-
18
- Consult `/TESTING.md` first. Its Contract Validation layer boundary governs.
19
-
20
- ## Contract Validation Boundary
21
-
22
- - **MUST** validate the API boundary (endpoints, schemas, events) against the specification.
23
- - **MUST NOT** test internal business logic — that belongs at Layer 1 or 2.
24
- - **MUST NOT** require a running server — operates on static specs and source analysis.
25
- - **MAY** complement live testing but is not a substitute for E2E.
26
-
27
- ## Part 1 — Prerequisite Detection
28
-
29
- ### Check `dt` availability
30
-
31
- ```bash
32
- which dt && dt --version
33
- ```
34
-
35
- - If `dt` is not found: emit `SKIPPED(dt not installed)` and provide manual instructions.
36
- - If `dt` is found but not configured for the repo: emit `SKIPPED(dt not configured — run dt init)`.
37
-
38
- ### Detect API specifications
39
-
40
- Search the repository for:
41
-
42
- - `openapi.yaml`, `openapi.json`, `swagger.yaml`, `swagger.json` (or under `docs/`, `api/`, `specs/`)
43
- - `asyncapi.yaml`, `asyncapi.json`
44
- - `component.json` (dt-managed extraction output)
45
-
46
- If no specs found: emit `SKIPPED(no OpenAPI or AsyncAPI spec found in repository)`.
47
-
48
- ## Part 2 — Contract Diff (Breaking Change Detection)
49
-
50
- Run against the base branch to detect breaking changes introduced by the current work:
51
-
52
- ```bash
53
- dt verify contract-diff --base origin/main --head HEAD
54
- ```
55
-
56
- ### Findings classification
57
-
58
- | Exit code | Meaning | Severity |
59
- | --------- | ------------------------- | -------- |
60
- | 0 | No breaking changes | — |
61
- | 8 | Breaking changes detected | Critical |
62
- | 1 | Execution error | Blocked |
63
-
64
- ### Report format
65
-
66
- For each breaking change found:
67
-
68
- ```markdown
69
- | Finding | Severity | Path | Description |
70
- | ------- | -------- | ------------------------------- | ------------------------------------------ |
71
- | BREAK-1 | critical | POST /api/orders → request body | Required field `customerId` removed |
72
- | BREAK-2 | major | GET /api/users → response | Field `email` type changed string → object |
73
- ```
74
-
75
- ## Part 3 — Impact Analysis (Consumer Enumeration)
76
-
77
- When breaking changes are detected, identify affected consumers:
78
-
79
- ```bash
80
- dt verify impact --contract <contract-id>
81
- ```
82
-
83
- Report:
84
-
85
- - List of consumers that depend on the changed contract.
86
- - Per consumer: which endpoints/events they consume.
87
- - Recommendation: notify consumers, or validate with consumer-driven tests.
88
-
89
- ## Part 4 — Drift Detection (Spec-to-Implementation Staleness)
90
-
91
- Check whether the specification and implementation have diverged:
92
-
93
- ```bash
94
- dt verify drift [--id <component-id>]
95
- ```
96
-
97
- ### Drift types
98
-
99
- | Type | Description | Severity |
100
- | --------------- | ----------------------------------------------- | -------- |
101
- | Spec-ahead | Spec documents endpoints not in code | Major |
102
- | Code-ahead | Code has endpoints not in spec | Major |
103
- | Stale | Spec not updated in >90 days while code changed | Minor |
104
- | Schema-mismatch | Response shape differs from spec | Critical |
105
-
106
- ### Report format
107
-
108
- Same risk-ranked table format as `activity-coverage-gap-analysis`:
109
-
110
- ```markdown
111
- | Finding | Severity | Component | Description | Days since spec update |
112
- | ------- | -------- | ------------ | ---------------------------------------------- | ---------------------- |
113
- | DRIFT-1 | critical | api-gateway | Response schema mismatch: /api/orders | — |
114
- | DRIFT-2 | major | api-gateway | 12 endpoints in code, 8 in spec | — |
115
- | DRIFT-3 | minor | auth-service | Spec unchanged 120 days, 14 code commits since | 120 |
116
- ```
117
-
118
- ## Part 5 — Integration with Coverage Gate
119
-
120
- Contract validation findings **MUST** be reported alongside coverage in the `coverage_gate` path:
121
-
122
- - Breaking changes → block completion (critical findings).
123
- - Drift findings → report but do not block (route to follow-up or drift-reconciliation).
124
- - No spec found → skip with reason (does not count as a gap).
125
-
126
- ### Aggregated output
127
-
128
- ```markdown
129
- ## Contract Validation Summary
130
-
131
- - **Spec detected:** OpenAPI 3.1 at `api/openapi.yaml`
132
- - **Breaking changes:** 0 | **Drift findings:** 2 | **Impact:** N/A
133
- - **Status:** PASS (no breaking changes)
134
-
135
- ### Drift Findings (non-blocking)
136
-
137
- | ... |
138
- ```
139
-
140
- ## Fallback — Manual Validation
141
-
142
- When `dt` is not installed, provide these manual steps:
143
-
144
- 1. **Diff specs manually:** compare `api/openapi.yaml` across branches.
145
- 2. **Check for undocumented endpoints:** search route handlers not in the spec.
146
- 3. **Schema validation:** run `npx @redocly/cli lint api/openapi.yaml` or equivalent.
147
- 4. **Consumer notification:** manually identify consumers from project documentation.
148
-
149
- ## Output
150
-
151
- - `dt` availability status
152
- - Spec detection result (type, path, version)
153
- - Breaking changes (count, details, severity)
154
- - Consumer impact (when applicable)
155
- - Drift findings (count, details, severity, days since update)
156
- - Aggregated status for `coverage_gate` integration
157
- - Manual fallback instructions (when `dt` unavailable)
158
-
159
- ## Final Instructions
160
-
161
- 1. You **MUST** check `dt` availability before attempting verification.
162
- 2. You **MUST** emit `SKIPPED` with a reason when prerequisites are missing.
163
- 3. You **MUST** classify findings by severity using the tables above.
164
- 4. You **MUST** report breaking changes as critical findings that block completion.
165
- 5. You **MUST** report drift as non-blocking findings for follow-up.
166
- 6. You **MUST NOT** test internal business logic — contract validation is boundary-only.
167
- 7. You **MUST NOT** install `dt` or any dependency — detect and recommend only.
@@ -1,167 +0,0 @@
1
- ---
2
- name: activity-contract-validation
3
- description: "Validate API contracts against implementation using dt verify (contract-diff, impact, drift). Detects breaking changes, consumer impact, and spec-to-code staleness. Use when checking API boundary integrity."
4
- ---
5
-
6
- # Activity: Contract Validation
7
-
8
- Detect API spec drift, breaking changes, and consumer impact using the `dt verify` family. This skill wires existing extraction and verification tooling into the QA path.
9
-
10
- ---
11
-
12
- > **RFC 2119 Notice:** The key words **MUST**, **MUST NOT**, **REQUIRED**, **SHALL**, **SHALL NOT**, **SHOULD**, **SHOULD NOT**, **RECOMMENDED**, **MAY**, and **OPTIONAL** in this document are to be interpreted as described in [RFC 2119](https://www.rfc-editor.org/rfc/rfc2119).
13
-
14
- ## Goal
15
-
16
- Detect misalignment between API specifications and implementation before it reaches consumers. Contract validation checks the boundary — it does not test internal behavior.
17
-
18
- Consult `/TESTING.md` first. Its Contract Validation layer boundary governs.
19
-
20
- ## Contract Validation Boundary
21
-
22
- - **MUST** validate the API boundary (endpoints, schemas, events) against the specification.
23
- - **MUST NOT** test internal business logic — that belongs at Layer 1 or 2.
24
- - **MUST NOT** require a running server — operates on static specs and source analysis.
25
- - **MAY** complement live testing but is not a substitute for E2E.
26
-
27
- ## Part 1 — Prerequisite Detection
28
-
29
- ### Check `dt` availability
30
-
31
- ```bash
32
- which dt && dt --version
33
- ```
34
-
35
- - If `dt` is not found: emit `SKIPPED(dt not installed)` and provide manual instructions.
36
- - If `dt` is found but not configured for the repo: emit `SKIPPED(dt not configured — run dt init)`.
37
-
38
- ### Detect API specifications
39
-
40
- Search the repository for:
41
-
42
- - `openapi.yaml`, `openapi.json`, `swagger.yaml`, `swagger.json` (or under `docs/`, `api/`, `specs/`)
43
- - `asyncapi.yaml`, `asyncapi.json`
44
- - `component.json` (dt-managed extraction output)
45
-
46
- If no specs found: emit `SKIPPED(no OpenAPI or AsyncAPI spec found in repository)`.
47
-
48
- ## Part 2 — Contract Diff (Breaking Change Detection)
49
-
50
- Run against the base branch to detect breaking changes introduced by the current work:
51
-
52
- ```bash
53
- dt verify contract-diff --base origin/main --head HEAD
54
- ```
55
-
56
- ### Findings classification
57
-
58
- | Exit code | Meaning | Severity |
59
- | --------- | ------------------------- | -------- |
60
- | 0 | No breaking changes | — |
61
- | 8 | Breaking changes detected | Critical |
62
- | 1 | Execution error | Blocked |
63
-
64
- ### Report format
65
-
66
- For each breaking change found:
67
-
68
- ```markdown
69
- | Finding | Severity | Path | Description |
70
- | ------- | -------- | ------------------------------- | ------------------------------------------ |
71
- | BREAK-1 | critical | POST /api/orders → request body | Required field `customerId` removed |
72
- | BREAK-2 | major | GET /api/users → response | Field `email` type changed string → object |
73
- ```
74
-
75
- ## Part 3 — Impact Analysis (Consumer Enumeration)
76
-
77
- When breaking changes are detected, identify affected consumers:
78
-
79
- ```bash
80
- dt verify impact --contract <contract-id>
81
- ```
82
-
83
- Report:
84
-
85
- - List of consumers that depend on the changed contract.
86
- - Per consumer: which endpoints/events they consume.
87
- - Recommendation: notify consumers, or validate with consumer-driven tests.
88
-
89
- ## Part 4 — Drift Detection (Spec-to-Implementation Staleness)
90
-
91
- Check whether the specification and implementation have diverged:
92
-
93
- ```bash
94
- dt verify drift [--id <component-id>]
95
- ```
96
-
97
- ### Drift types
98
-
99
- | Type | Description | Severity |
100
- | --------------- | ----------------------------------------------- | -------- |
101
- | Spec-ahead | Spec documents endpoints not in code | Major |
102
- | Code-ahead | Code has endpoints not in spec | Major |
103
- | Stale | Spec not updated in >90 days while code changed | Minor |
104
- | Schema-mismatch | Response shape differs from spec | Critical |
105
-
106
- ### Report format
107
-
108
- Same risk-ranked table format as `activity-coverage-gap-analysis`:
109
-
110
- ```markdown
111
- | Finding | Severity | Component | Description | Days since spec update |
112
- | ------- | -------- | ------------ | ---------------------------------------------- | ---------------------- |
113
- | DRIFT-1 | critical | api-gateway | Response schema mismatch: /api/orders | — |
114
- | DRIFT-2 | major | api-gateway | 12 endpoints in code, 8 in spec | — |
115
- | DRIFT-3 | minor | auth-service | Spec unchanged 120 days, 14 code commits since | 120 |
116
- ```
117
-
118
- ## Part 5 — Integration with Coverage Gate
119
-
120
- Contract validation findings **MUST** be reported alongside coverage in the `coverage_gate` path:
121
-
122
- - Breaking changes → block completion (critical findings).
123
- - Drift findings → report but do not block (route to follow-up or drift-reconciliation).
124
- - No spec found → skip with reason (does not count as a gap).
125
-
126
- ### Aggregated output
127
-
128
- ```markdown
129
- ## Contract Validation Summary
130
-
131
- - **Spec detected:** OpenAPI 3.1 at `api/openapi.yaml`
132
- - **Breaking changes:** 0 | **Drift findings:** 2 | **Impact:** N/A
133
- - **Status:** PASS (no breaking changes)
134
-
135
- ### Drift Findings (non-blocking)
136
-
137
- | ... |
138
- ```
139
-
140
- ## Fallback — Manual Validation
141
-
142
- When `dt` is not installed, provide these manual steps:
143
-
144
- 1. **Diff specs manually:** compare `api/openapi.yaml` across branches.
145
- 2. **Check for undocumented endpoints:** search route handlers not in the spec.
146
- 3. **Schema validation:** run `npx @redocly/cli lint api/openapi.yaml` or equivalent.
147
- 4. **Consumer notification:** manually identify consumers from project documentation.
148
-
149
- ## Output
150
-
151
- - `dt` availability status
152
- - Spec detection result (type, path, version)
153
- - Breaking changes (count, details, severity)
154
- - Consumer impact (when applicable)
155
- - Drift findings (count, details, severity, days since update)
156
- - Aggregated status for `coverage_gate` integration
157
- - Manual fallback instructions (when `dt` unavailable)
158
-
159
- ## Final Instructions
160
-
161
- 1. You **MUST** check `dt` availability before attempting verification.
162
- 2. You **MUST** emit `SKIPPED` with a reason when prerequisites are missing.
163
- 3. You **MUST** classify findings by severity using the tables above.
164
- 4. You **MUST** report breaking changes as critical findings that block completion.
165
- 5. You **MUST** report drift as non-blocking findings for follow-up.
166
- 6. You **MUST NOT** test internal business logic — contract validation is boundary-only.
167
- 7. You **MUST NOT** install `dt` or any dependency — detect and recommend only.
@@ -1,30 +0,0 @@
1
- /**
2
- * CLI handler for `dt catalog build --registry <path> [--concurrency 8] [--json]`.
3
- *
4
- * Aggregates component manifests from a registry and generates catalog/index.yaml.
5
- * Idempotent: nothing written when nothing changed.
6
- * Exit codes: 0 = success, 3 = partial failure (some repos errored).
7
- */
8
- export interface CatalogBuildOptions {
9
- json: boolean;
10
- registry?: string;
11
- concurrency?: number;
12
- catalogDir?: string;
13
- }
14
- export interface CatalogBuildOutput {
15
- success: boolean;
16
- written: boolean;
17
- components_count: number;
18
- errors_count: number;
19
- errors: Array<{
20
- repo: string;
21
- error: string;
22
- }>;
23
- generated_at: string;
24
- }
25
- /**
26
- * Run the `dt catalog build` command.
27
- * Returns the process exit code: 0 if all repos succeeded, 3 if partial failure.
28
- */
29
- export declare function runCatalogBuild(options: CatalogBuildOptions): Promise<number>;
30
- //# sourceMappingURL=catalog-build.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"catalog-build.d.ts","sourceRoot":"","sources":["../../../adapters/cli/catalog-build.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAOH,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,OAAO,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,gBAAgB,EAAE,MAAM,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC/C,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;;GAGG;AACH,wBAAsB,eAAe,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,MAAM,CAAC,CAmDnF"}