@llipe.com/dev-tasks 0.11.0 → 0.16.1

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 (617) hide show
  1. package/.claude/agents/developer.md +105 -43
  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 +61 -6
  7. package/.claude/agents/ux-engineer.md +1 -0
  8. package/.claude/agents/verifier.md +48 -6
  9. package/.claude/commands/developer.md +2 -266
  10. package/.claude/commands/infra-engineer.md +92 -0
  11. package/.claude/commands/planner.md +44 -23
  12. package/.claude/commands/product-engineer.md +21 -9
  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 +483 -22
  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 +49 -4
  28. package/.claude/skills/memo-cli-usage/REFERENCE.md +230 -17
  29. package/.claude/skills/memo-cli-usage/SKILL.md +66 -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 +70 -19
  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 +25 -4
  37. package/.github/agents/product-engineer.agent.md +21 -9
  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 +60 -6
  41. package/.github/agents/verifier.agent.md +46 -5
  42. package/.github/instructions/implement.instructions.md +49 -4
  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 +66 -13
  60. package/.github/skills/supabase-ops/SKILL.md +104 -0
  61. package/.kiro/agents/developer.md +71 -20
  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 +33 -15
  66. package/.kiro/agents/product-engineer.md +24 -12
  67. package/.kiro/agents/qa-engineer.md +24 -12
  68. package/.kiro/agents/researcher.md +26 -7
  69. package/.kiro/agents/technical-writer.md +63 -9
  70. package/.kiro/agents/verifier.md +47 -6
  71. package/.kiro/skills/activity-codebase-research/SKILL.md +4 -11
  72. package/.kiro/skills/activity-generate-spec/SKILL.md +34 -10
  73. package/.kiro/skills/activity-grill/SKILL.md +150 -0
  74. package/.kiro/skills/activity-init/SKILL.md +121 -71
  75. package/.kiro/skills/activity-refine/SKILL.md +75 -15
  76. package/.kiro/skills/activity-test-standards/SKILL.md +25 -0
  77. package/.kiro/skills/aws-ops/SKILL.md +155 -0
  78. package/.kiro/skills/deploy-ops/SKILL.md +121 -0
  79. package/.kiro/skills/fly-ops/SKILL.md +138 -0
  80. package/.kiro/skills/git-ops/SKILL.md +27 -7
  81. package/.kiro/skills/memo-cli-usage/REFERENCE.md +230 -17
  82. package/.kiro/skills/memo-cli-usage/SKILL.md +66 -13
  83. package/.kiro/skills/supabase-ops/SKILL.md +109 -0
  84. package/.kiro/steering/implement.md +49 -4
  85. package/.kiro/steering/plan.md +43 -1
  86. package/AGENTS.md +60 -109
  87. package/AGENTS.md.template +124 -0
  88. package/CHANGELOG.md +163 -0
  89. package/CLAUDE.md +23 -18
  90. package/CLAUDE.md.template +103 -0
  91. package/README.md +168 -146
  92. package/TESTING.md +84 -148
  93. package/bundle-manifest.json +43 -2
  94. package/dist/bin/dev-tasks.js +65 -3
  95. package/dist/bin/dev-tasks.js.map +1 -1
  96. package/dist/{adapters/cli → bin}/parse-args.d.ts +2 -6
  97. package/dist/bin/parse-args.d.ts.map +1 -0
  98. package/dist/{adapters/cli → bin}/parse-args.js +2 -18
  99. package/dist/bin/parse-args.js.map +1 -0
  100. package/dist/core/checks/decision-log-format.d.ts +44 -0
  101. package/dist/core/checks/decision-log-format.d.ts.map +1 -0
  102. package/dist/core/checks/decision-log-format.js +171 -0
  103. package/dist/core/checks/decision-log-format.js.map +1 -0
  104. package/dist/core/checks/docs-structure.d.ts +82 -0
  105. package/dist/core/checks/docs-structure.d.ts.map +1 -0
  106. package/dist/core/checks/docs-structure.js +285 -0
  107. package/dist/core/checks/docs-structure.js.map +1 -0
  108. package/dist/core/checks/glossary.d.ts +178 -0
  109. package/dist/core/checks/glossary.d.ts.map +1 -0
  110. package/dist/core/checks/glossary.js +651 -0
  111. package/dist/core/checks/glossary.js.map +1 -0
  112. package/dist/core/checks/index.d.ts +19 -0
  113. package/dist/core/checks/index.d.ts.map +1 -0
  114. package/dist/core/checks/index.js +16 -0
  115. package/dist/core/checks/index.js.map +1 -0
  116. package/dist/core/checks/run.d.ts +22 -0
  117. package/dist/core/checks/run.d.ts.map +1 -0
  118. package/dist/core/checks/run.js +51 -0
  119. package/dist/core/checks/run.js.map +1 -0
  120. package/dist/core/distribution/doctor.d.ts +46 -1
  121. package/dist/core/distribution/doctor.d.ts.map +1 -1
  122. package/dist/core/distribution/doctor.js +161 -2
  123. package/dist/core/distribution/doctor.js.map +1 -1
  124. package/dist/core/distribution/index.d.ts +9 -3
  125. package/dist/core/distribution/index.d.ts.map +1 -1
  126. package/dist/core/distribution/index.js +5 -2
  127. package/dist/core/distribution/index.js.map +1 -1
  128. package/dist/core/distribution/install-if-absent.d.ts +46 -0
  129. package/dist/core/distribution/install-if-absent.d.ts.map +1 -0
  130. package/dist/core/distribution/install-if-absent.js +81 -0
  131. package/dist/core/distribution/install-if-absent.js.map +1 -0
  132. package/dist/core/distribution/install.d.ts.map +1 -1
  133. package/dist/core/distribution/install.js +5 -0
  134. package/dist/core/distribution/install.js.map +1 -1
  135. package/dist/core/distribution/migrate-docs.d.ts +64 -0
  136. package/dist/core/distribution/migrate-docs.d.ts.map +1 -0
  137. package/dist/core/distribution/migrate-docs.js +139 -0
  138. package/dist/core/distribution/migrate-docs.js.map +1 -0
  139. package/dist/core/distribution/profiles.d.ts +49 -0
  140. package/dist/core/distribution/profiles.d.ts.map +1 -1
  141. package/dist/core/distribution/profiles.js +45 -0
  142. package/dist/core/distribution/profiles.js.map +1 -1
  143. package/dist/core/distribution/update.d.ts +14 -0
  144. package/dist/core/distribution/update.d.ts.map +1 -1
  145. package/dist/core/distribution/update.js +77 -3
  146. package/dist/core/distribution/update.js.map +1 -1
  147. package/dist/core/distribution/workspace.d.ts +84 -0
  148. package/dist/core/distribution/workspace.d.ts.map +1 -0
  149. package/dist/core/distribution/workspace.js +276 -0
  150. package/dist/core/distribution/workspace.js.map +1 -0
  151. package/dist/core/exit-codes.d.ts +15 -35
  152. package/dist/core/exit-codes.d.ts.map +1 -1
  153. package/dist/core/exit-codes.js +15 -36
  154. package/dist/core/exit-codes.js.map +1 -1
  155. package/dist/core/index.d.ts +1 -6
  156. package/dist/core/index.d.ts.map +1 -1
  157. package/dist/core/index.js +1 -7
  158. package/dist/core/index.js.map +1 -1
  159. package/package.json +17 -32
  160. package/templates/claude/settings.json +48 -0
  161. package/templates/domain/ubiquitous-language.md +28 -0
  162. package/templates/infra/environments.yaml +16 -0
  163. package/templates/infra/redaction-patterns.txt +47 -0
  164. package/templates/runbooks/README.md +14 -0
  165. package/templates/runbooks/runbook-template.md +40 -0
  166. package/templates/scripts/deploy-status.sh +89 -0
  167. package/templates/scripts/deploy-verify.sh +85 -0
  168. package/templates/scripts/deploy.sh +284 -0
  169. package/templates/scripts/release.sh +170 -0
  170. package/templates/scripts/rollback.sh +109 -0
  171. package/templates/workflows/deploy-dev.yml +66 -0
  172. package/templates/workflows/deploy-prod.yml +66 -0
  173. package/templates/workflows/rollback.yml +77 -0
  174. package/.claude/skills/activity-contract-validation/SKILL.md +0 -167
  175. package/.github/skills/activity-contract-validation/SKILL.md +0 -167
  176. package/.kiro/skills/activity-contract-validation/SKILL.md +0 -167
  177. package/dist/adapters/cli/catalog-build.d.ts +0 -30
  178. package/dist/adapters/cli/catalog-build.d.ts.map +0 -1
  179. package/dist/adapters/cli/catalog-build.js +0 -73
  180. package/dist/adapters/cli/catalog-build.js.map +0 -1
  181. package/dist/adapters/cli/catalog-query.d.ts +0 -13
  182. package/dist/adapters/cli/catalog-query.d.ts.map +0 -1
  183. package/dist/adapters/cli/catalog-query.js +0 -329
  184. package/dist/adapters/cli/catalog-query.js.map +0 -1
  185. package/dist/adapters/cli/catalog-scaffold.d.ts +0 -24
  186. package/dist/adapters/cli/catalog-scaffold.d.ts.map +0 -1
  187. package/dist/adapters/cli/catalog-scaffold.js +0 -46
  188. package/dist/adapters/cli/catalog-scaffold.js.map +0 -1
  189. package/dist/adapters/cli/catalog-validate.d.ts +0 -35
  190. package/dist/adapters/cli/catalog-validate.d.ts.map +0 -1
  191. package/dist/adapters/cli/catalog-validate.js +0 -122
  192. package/dist/adapters/cli/catalog-validate.js.map +0 -1
  193. package/dist/adapters/cli/ctx-assemble.d.ts +0 -19
  194. package/dist/adapters/cli/ctx-assemble.d.ts.map +0 -1
  195. package/dist/adapters/cli/ctx-assemble.js +0 -293
  196. package/dist/adapters/cli/ctx-assemble.js.map +0 -1
  197. package/dist/adapters/cli/ctx-fetch.d.ts +0 -49
  198. package/dist/adapters/cli/ctx-fetch.d.ts.map +0 -1
  199. package/dist/adapters/cli/ctx-fetch.js +0 -267
  200. package/dist/adapters/cli/ctx-fetch.js.map +0 -1
  201. package/dist/adapters/cli/extract-all.d.ts +0 -31
  202. package/dist/adapters/cli/extract-all.d.ts.map +0 -1
  203. package/dist/adapters/cli/extract-all.js +0 -374
  204. package/dist/adapters/cli/extract-all.js.map +0 -1
  205. package/dist/adapters/cli/extract-asyncapi.d.ts +0 -26
  206. package/dist/adapters/cli/extract-asyncapi.d.ts.map +0 -1
  207. package/dist/adapters/cli/extract-asyncapi.js +0 -142
  208. package/dist/adapters/cli/extract-asyncapi.js.map +0 -1
  209. package/dist/adapters/cli/extract-component.d.ts +0 -24
  210. package/dist/adapters/cli/extract-component.d.ts.map +0 -1
  211. package/dist/adapters/cli/extract-component.js +0 -198
  212. package/dist/adapters/cli/extract-component.js.map +0 -1
  213. package/dist/adapters/cli/extract-detect.d.ts +0 -19
  214. package/dist/adapters/cli/extract-detect.d.ts.map +0 -1
  215. package/dist/adapters/cli/extract-detect.js +0 -98
  216. package/dist/adapters/cli/extract-detect.js.map +0 -1
  217. package/dist/adapters/cli/extract-openapi.d.ts +0 -29
  218. package/dist/adapters/cli/extract-openapi.d.ts.map +0 -1
  219. package/dist/adapters/cli/extract-openapi.js +0 -111
  220. package/dist/adapters/cli/extract-openapi.js.map +0 -1
  221. package/dist/adapters/cli/extract-schema.d.ts +0 -15
  222. package/dist/adapters/cli/extract-schema.d.ts.map +0 -1
  223. package/dist/adapters/cli/extract-schema.js +0 -39
  224. package/dist/adapters/cli/extract-schema.js.map +0 -1
  225. package/dist/adapters/cli/index.d.ts +0 -6
  226. package/dist/adapters/cli/index.d.ts.map +0 -1
  227. package/dist/adapters/cli/index.js +0 -5
  228. package/dist/adapters/cli/index.js.map +0 -1
  229. package/dist/adapters/cli/init.d.ts +0 -37
  230. package/dist/adapters/cli/init.d.ts.map +0 -1
  231. package/dist/adapters/cli/init.js +0 -336
  232. package/dist/adapters/cli/init.js.map +0 -1
  233. package/dist/adapters/cli/parse-args.d.ts.map +0 -1
  234. package/dist/adapters/cli/parse-args.js.map +0 -1
  235. package/dist/adapters/cli/scope-gate.d.ts +0 -25
  236. package/dist/adapters/cli/scope-gate.d.ts.map +0 -1
  237. package/dist/adapters/cli/scope-gate.js +0 -157
  238. package/dist/adapters/cli/scope-gate.js.map +0 -1
  239. package/dist/adapters/cli/scope.d.ts +0 -26
  240. package/dist/adapters/cli/scope.d.ts.map +0 -1
  241. package/dist/adapters/cli/scope.js +0 -172
  242. package/dist/adapters/cli/scope.js.map +0 -1
  243. package/dist/adapters/cli/validate-component.d.ts +0 -24
  244. package/dist/adapters/cli/validate-component.d.ts.map +0 -1
  245. package/dist/adapters/cli/validate-component.js +0 -62
  246. package/dist/adapters/cli/validate-component.js.map +0 -1
  247. package/dist/adapters/cli/verify-contract-diff.d.ts +0 -21
  248. package/dist/adapters/cli/verify-contract-diff.d.ts.map +0 -1
  249. package/dist/adapters/cli/verify-contract-diff.js +0 -69
  250. package/dist/adapters/cli/verify-contract-diff.js.map +0 -1
  251. package/dist/adapters/cli/verify-drift.d.ts +0 -24
  252. package/dist/adapters/cli/verify-drift.d.ts.map +0 -1
  253. package/dist/adapters/cli/verify-drift.js +0 -103
  254. package/dist/adapters/cli/verify-drift.js.map +0 -1
  255. package/dist/adapters/cli/verify-impact.d.ts +0 -23
  256. package/dist/adapters/cli/verify-impact.d.ts.map +0 -1
  257. package/dist/adapters/cli/verify-impact.js +0 -119
  258. package/dist/adapters/cli/verify-impact.js.map +0 -1
  259. package/dist/adapters/mcp/index.d.ts +0 -5
  260. package/dist/adapters/mcp/index.d.ts.map +0 -1
  261. package/dist/adapters/mcp/index.js +0 -2
  262. package/dist/adapters/mcp/index.js.map +0 -1
  263. package/dist/bin/dt.d.ts +0 -7
  264. package/dist/bin/dt.d.ts.map +0 -1
  265. package/dist/bin/dt.js +0 -647
  266. package/dist/bin/dt.js.map +0 -1
  267. package/dist/core/catalog/build.d.ts +0 -143
  268. package/dist/core/catalog/build.d.ts.map +0 -1
  269. package/dist/core/catalog/build.js +0 -475
  270. package/dist/core/catalog/build.js.map +0 -1
  271. package/dist/core/catalog/checks/index.d.ts +0 -18
  272. package/dist/core/catalog/checks/index.d.ts.map +0 -1
  273. package/dist/core/catalog/checks/index.js +0 -18
  274. package/dist/core/catalog/checks/index.js.map +0 -1
  275. package/dist/core/catalog/checks/v01-schema.d.ts +0 -17
  276. package/dist/core/catalog/checks/v01-schema.d.ts.map +0 -1
  277. package/dist/core/catalog/checks/v01-schema.js +0 -57
  278. package/dist/core/catalog/checks/v01-schema.js.map +0 -1
  279. package/dist/core/catalog/checks/v02-v03-identity.d.ts +0 -14
  280. package/dist/core/catalog/checks/v02-v03-identity.d.ts.map +0 -1
  281. package/dist/core/catalog/checks/v02-v03-identity.js +0 -60
  282. package/dist/core/catalog/checks/v02-v03-identity.js.map +0 -1
  283. package/dist/core/catalog/checks/v04-referential-integrity.d.ts +0 -7
  284. package/dist/core/catalog/checks/v04-referential-integrity.d.ts.map +0 -1
  285. package/dist/core/catalog/checks/v04-referential-integrity.js +0 -32
  286. package/dist/core/catalog/checks/v04-referential-integrity.js.map +0 -1
  287. package/dist/core/catalog/checks/v05-domain-existence.d.ts +0 -6
  288. package/dist/core/catalog/checks/v05-domain-existence.d.ts.map +0 -1
  289. package/dist/core/catalog/checks/v05-domain-existence.js +0 -23
  290. package/dist/core/catalog/checks/v05-domain-existence.js.map +0 -1
  291. package/dist/core/catalog/checks/v06-v07-paths.d.ts +0 -29
  292. package/dist/core/catalog/checks/v06-v07-paths.d.ts.map +0 -1
  293. package/dist/core/catalog/checks/v06-v07-paths.js +0 -107
  294. package/dist/core/catalog/checks/v06-v07-paths.js.map +0 -1
  295. package/dist/core/catalog/checks/v08-v10-contracts.d.ts +0 -13
  296. package/dist/core/catalog/checks/v08-v10-contracts.d.ts.map +0 -1
  297. package/dist/core/catalog/checks/v08-v10-contracts.js +0 -70
  298. package/dist/core/catalog/checks/v08-v10-contracts.js.map +0 -1
  299. package/dist/core/catalog/checks/v11-manual-fields.d.ts +0 -16
  300. package/dist/core/catalog/checks/v11-manual-fields.d.ts.map +0 -1
  301. package/dist/core/catalog/checks/v11-manual-fields.js +0 -60
  302. package/dist/core/catalog/checks/v11-manual-fields.js.map +0 -1
  303. package/dist/core/catalog/checks/v12-cycles.d.ts +0 -8
  304. package/dist/core/catalog/checks/v12-cycles.d.ts.map +0 -1
  305. package/dist/core/catalog/checks/v12-cycles.js +0 -28
  306. package/dist/core/catalog/checks/v12-cycles.js.map +0 -1
  307. package/dist/core/catalog/checks/v13-orphan-contracts.d.ts +0 -7
  308. package/dist/core/catalog/checks/v13-orphan-contracts.d.ts.map +0 -1
  309. package/dist/core/catalog/checks/v13-orphan-contracts.js +0 -33
  310. package/dist/core/catalog/checks/v13-orphan-contracts.js.map +0 -1
  311. package/dist/core/catalog/checks/v14-v15-lifecycle.d.ts +0 -8
  312. package/dist/core/catalog/checks/v14-v15-lifecycle.d.ts.map +0 -1
  313. package/dist/core/catalog/checks/v14-v15-lifecycle.js +0 -42
  314. package/dist/core/catalog/checks/v14-v15-lifecycle.js.map +0 -1
  315. package/dist/core/catalog/checks/v16-deprecated-consumers.d.ts +0 -7
  316. package/dist/core/catalog/checks/v16-deprecated-consumers.d.ts.map +0 -1
  317. package/dist/core/catalog/checks/v16-deprecated-consumers.js +0 -47
  318. package/dist/core/catalog/checks/v16-deprecated-consumers.js.map +0 -1
  319. package/dist/core/catalog/checks/v17-low-confidence.d.ts +0 -7
  320. package/dist/core/catalog/checks/v17-low-confidence.d.ts.map +0 -1
  321. package/dist/core/catalog/checks/v17-low-confidence.js +0 -32
  322. package/dist/core/catalog/checks/v17-low-confidence.js.map +0 -1
  323. package/dist/core/catalog/checks/v18-low-payload.d.ts +0 -7
  324. package/dist/core/catalog/checks/v18-low-payload.d.ts.map +0 -1
  325. package/dist/core/catalog/checks/v18-low-payload.js +0 -33
  326. package/dist/core/catalog/checks/v18-low-payload.js.map +0 -1
  327. package/dist/core/catalog/checks/v19-domain-membership.d.ts +0 -8
  328. package/dist/core/catalog/checks/v19-domain-membership.d.ts.map +0 -1
  329. package/dist/core/catalog/checks/v19-domain-membership.js +0 -55
  330. package/dist/core/catalog/checks/v19-domain-membership.js.map +0 -1
  331. package/dist/core/catalog/coverage.d.ts +0 -39
  332. package/dist/core/catalog/coverage.d.ts.map +0 -1
  333. package/dist/core/catalog/coverage.js +0 -62
  334. package/dist/core/catalog/coverage.js.map +0 -1
  335. package/dist/core/catalog/graph.d.ts +0 -49
  336. package/dist/core/catalog/graph.d.ts.map +0 -1
  337. package/dist/core/catalog/graph.js +0 -114
  338. package/dist/core/catalog/graph.js.map +0 -1
  339. package/dist/core/catalog/index-model.d.ts +0 -96
  340. package/dist/core/catalog/index-model.d.ts.map +0 -1
  341. package/dist/core/catalog/index-model.js +0 -8
  342. package/dist/core/catalog/index-model.js.map +0 -1
  343. package/dist/core/catalog/index.d.ts +0 -5
  344. package/dist/core/catalog/index.d.ts.map +0 -1
  345. package/dist/core/catalog/index.js +0 -2
  346. package/dist/core/catalog/index.js.map +0 -1
  347. package/dist/core/catalog/queries.d.ts +0 -69
  348. package/dist/core/catalog/queries.d.ts.map +0 -1
  349. package/dist/core/catalog/queries.js +0 -165
  350. package/dist/core/catalog/queries.js.map +0 -1
  351. package/dist/core/catalog/resolve.d.ts +0 -47
  352. package/dist/core/catalog/resolve.d.ts.map +0 -1
  353. package/dist/core/catalog/resolve.js +0 -318
  354. package/dist/core/catalog/resolve.js.map +0 -1
  355. package/dist/core/catalog/scaffold.d.ts +0 -31
  356. package/dist/core/catalog/scaffold.d.ts.map +0 -1
  357. package/dist/core/catalog/scaffold.js +0 -141
  358. package/dist/core/catalog/scaffold.js.map +0 -1
  359. package/dist/core/catalog/validate-component.d.ts +0 -50
  360. package/dist/core/catalog/validate-component.d.ts.map +0 -1
  361. package/dist/core/catalog/validate-component.js +0 -105
  362. package/dist/core/catalog/validate-component.js.map +0 -1
  363. package/dist/core/catalog/validate.d.ts +0 -71
  364. package/dist/core/catalog/validate.d.ts.map +0 -1
  365. package/dist/core/catalog/validate.js +0 -103
  366. package/dist/core/catalog/validate.js.map +0 -1
  367. package/dist/core/context/assemble.d.ts +0 -126
  368. package/dist/core/context/assemble.d.ts.map +0 -1
  369. package/dist/core/context/assemble.js +0 -197
  370. package/dist/core/context/assemble.js.map +0 -1
  371. package/dist/core/context/cache.d.ts +0 -60
  372. package/dist/core/context/cache.d.ts.map +0 -1
  373. package/dist/core/context/cache.js +0 -236
  374. package/dist/core/context/cache.js.map +0 -1
  375. package/dist/core/context/exit-codes.d.ts +0 -28
  376. package/dist/core/context/exit-codes.d.ts.map +0 -1
  377. package/dist/core/context/exit-codes.js +0 -28
  378. package/dist/core/context/exit-codes.js.map +0 -1
  379. package/dist/core/context/fetch.d.ts +0 -55
  380. package/dist/core/context/fetch.d.ts.map +0 -1
  381. package/dist/core/context/fetch.js +0 -112
  382. package/dist/core/context/fetch.js.map +0 -1
  383. package/dist/core/context/index.d.ts +0 -11
  384. package/dist/core/context/index.d.ts.map +0 -1
  385. package/dist/core/context/index.js +0 -8
  386. package/dist/core/context/index.js.map +0 -1
  387. package/dist/core/context/init.d.ts +0 -179
  388. package/dist/core/context/init.d.ts.map +0 -1
  389. package/dist/core/context/init.js +0 -532
  390. package/dist/core/context/init.js.map +0 -1
  391. package/dist/core/context/layers/architecture-layer.d.ts +0 -13
  392. package/dist/core/context/layers/architecture-layer.d.ts.map +0 -1
  393. package/dist/core/context/layers/architecture-layer.js +0 -24
  394. package/dist/core/context/layers/architecture-layer.js.map +0 -1
  395. package/dist/core/context/layers/contracts-layer.d.ts +0 -13
  396. package/dist/core/context/layers/contracts-layer.d.ts.map +0 -1
  397. package/dist/core/context/layers/contracts-layer.js +0 -83
  398. package/dist/core/context/layers/contracts-layer.js.map +0 -1
  399. package/dist/core/context/layers/conventions-delta-layer.d.ts +0 -13
  400. package/dist/core/context/layers/conventions-delta-layer.d.ts.map +0 -1
  401. package/dist/core/context/layers/conventions-delta-layer.js +0 -37
  402. package/dist/core/context/layers/conventions-delta-layer.js.map +0 -1
  403. package/dist/core/context/layers/flow-layer.d.ts +0 -14
  404. package/dist/core/context/layers/flow-layer.d.ts.map +0 -1
  405. package/dist/core/context/layers/flow-layer.js +0 -61
  406. package/dist/core/context/layers/flow-layer.js.map +0 -1
  407. package/dist/core/context/layers/index-layer.d.ts +0 -13
  408. package/dist/core/context/layers/index-layer.d.ts.map +0 -1
  409. package/dist/core/context/layers/index-layer.js +0 -77
  410. package/dist/core/context/layers/index-layer.js.map +0 -1
  411. package/dist/core/context/layers/primary-layer.d.ts +0 -16
  412. package/dist/core/context/layers/primary-layer.d.ts.map +0 -1
  413. package/dist/core/context/layers/primary-layer.js +0 -61
  414. package/dist/core/context/layers/primary-layer.js.map +0 -1
  415. package/dist/core/context/layers/secondary-layer.d.ts +0 -19
  416. package/dist/core/context/layers/secondary-layer.d.ts.map +0 -1
  417. package/dist/core/context/layers/secondary-layer.js +0 -52
  418. package/dist/core/context/layers/secondary-layer.js.map +0 -1
  419. package/dist/core/context/session-lock.d.ts +0 -114
  420. package/dist/core/context/session-lock.d.ts.map +0 -1
  421. package/dist/core/context/session-lock.js +0 -90
  422. package/dist/core/context/session-lock.js.map +0 -1
  423. package/dist/core/context/tokens.d.ts +0 -35
  424. package/dist/core/context/tokens.d.ts.map +0 -1
  425. package/dist/core/context/tokens.js +0 -88
  426. package/dist/core/context/tokens.js.map +0 -1
  427. package/dist/core/extract/asyncapi/declared.d.ts +0 -19
  428. package/dist/core/extract/asyncapi/declared.d.ts.map +0 -1
  429. package/dist/core/extract/asyncapi/declared.js +0 -168
  430. package/dist/core/extract/asyncapi/declared.js.map +0 -1
  431. package/dist/core/extract/asyncapi/index.d.ts +0 -12
  432. package/dist/core/extract/asyncapi/index.d.ts.map +0 -1
  433. package/dist/core/extract/asyncapi/index.js +0 -8
  434. package/dist/core/extract/asyncapi/index.js.map +0 -1
  435. package/dist/core/extract/asyncapi/payloads.d.ts +0 -20
  436. package/dist/core/extract/asyncapi/payloads.d.ts.map +0 -1
  437. package/dist/core/extract/asyncapi/payloads.js +0 -421
  438. package/dist/core/extract/asyncapi/payloads.js.map +0 -1
  439. package/dist/core/extract/asyncapi/topics.d.ts +0 -27
  440. package/dist/core/extract/asyncapi/topics.d.ts.map +0 -1
  441. package/dist/core/extract/asyncapi/topics.js +0 -368
  442. package/dist/core/extract/asyncapi/topics.js.map +0 -1
  443. package/dist/core/extract/asyncapi/types.d.ts +0 -129
  444. package/dist/core/extract/asyncapi/types.d.ts.map +0 -1
  445. package/dist/core/extract/asyncapi/types.js +0 -5
  446. package/dist/core/extract/asyncapi/types.js.map +0 -1
  447. package/dist/core/extract/asyncapi/validate.d.ts +0 -29
  448. package/dist/core/extract/asyncapi/validate.d.ts.map +0 -1
  449. package/dist/core/extract/asyncapi/validate.js +0 -156
  450. package/dist/core/extract/asyncapi/validate.js.map +0 -1
  451. package/dist/core/extract/component.d.ts +0 -204
  452. package/dist/core/extract/component.d.ts.map +0 -1
  453. package/dist/core/extract/component.js +0 -258
  454. package/dist/core/extract/component.js.map +0 -1
  455. package/dist/core/extract/detect.d.ts +0 -35
  456. package/dist/core/extract/detect.d.ts.map +0 -1
  457. package/dist/core/extract/detect.js +0 -89
  458. package/dist/core/extract/detect.js.map +0 -1
  459. package/dist/core/extract/index.d.ts +0 -12
  460. package/dist/core/extract/index.d.ts.map +0 -1
  461. package/dist/core/extract/index.js +0 -6
  462. package/dist/core/extract/index.js.map +0 -1
  463. package/dist/core/extract/ladder.d.ts +0 -79
  464. package/dist/core/extract/ladder.d.ts.map +0 -1
  465. package/dist/core/extract/ladder.js +0 -70
  466. package/dist/core/extract/ladder.js.map +0 -1
  467. package/dist/core/extract/openapi/index.d.ts +0 -43
  468. package/dist/core/extract/openapi/index.d.ts.map +0 -1
  469. package/dist/core/extract/openapi/index.js +0 -142
  470. package/dist/core/extract/openapi/index.js.map +0 -1
  471. package/dist/core/extract/openapi/route1.d.ts +0 -36
  472. package/dist/core/extract/openapi/route1.d.ts.map +0 -1
  473. package/dist/core/extract/openapi/route1.js +0 -333
  474. package/dist/core/extract/openapi/route1.js.map +0 -1
  475. package/dist/core/extract/openapi/route2-introspect.d.ts +0 -18
  476. package/dist/core/extract/openapi/route2-introspect.d.ts.map +0 -1
  477. package/dist/core/extract/openapi/route2-introspect.js +0 -249
  478. package/dist/core/extract/openapi/route2-introspect.js.map +0 -1
  479. package/dist/core/extract/openapi/route2.d.ts +0 -69
  480. package/dist/core/extract/openapi/route2.d.ts.map +0 -1
  481. package/dist/core/extract/openapi/route2.js +0 -211
  482. package/dist/core/extract/openapi/route2.js.map +0 -1
  483. package/dist/core/extract/openapi/route3.d.ts +0 -26
  484. package/dist/core/extract/openapi/route3.d.ts.map +0 -1
  485. package/dist/core/extract/openapi/route3.js +0 -737
  486. package/dist/core/extract/openapi/route3.js.map +0 -1
  487. package/dist/core/extract/openapi/types.d.ts +0 -125
  488. package/dist/core/extract/openapi/types.d.ts.map +0 -1
  489. package/dist/core/extract/openapi/types.js +0 -5
  490. package/dist/core/extract/openapi/types.js.map +0 -1
  491. package/dist/core/extract/openapi/validate.d.ts +0 -29
  492. package/dist/core/extract/openapi/validate.d.ts.map +0 -1
  493. package/dist/core/extract/openapi/validate.js +0 -200
  494. package/dist/core/extract/openapi/validate.js.map +0 -1
  495. package/dist/core/extract/orm/drizzle.d.ts +0 -20
  496. package/dist/core/extract/orm/drizzle.d.ts.map +0 -1
  497. package/dist/core/extract/orm/drizzle.js +0 -283
  498. package/dist/core/extract/orm/drizzle.js.map +0 -1
  499. package/dist/core/extract/orm/information-schema.d.ts +0 -26
  500. package/dist/core/extract/orm/information-schema.d.ts.map +0 -1
  501. package/dist/core/extract/orm/information-schema.js +0 -142
  502. package/dist/core/extract/orm/information-schema.js.map +0 -1
  503. package/dist/core/extract/orm/prisma.d.ts +0 -23
  504. package/dist/core/extract/orm/prisma.d.ts.map +0 -1
  505. package/dist/core/extract/orm/prisma.js +0 -234
  506. package/dist/core/extract/orm/prisma.js.map +0 -1
  507. package/dist/core/extract/orm/typeorm.d.ts +0 -22
  508. package/dist/core/extract/orm/typeorm.d.ts.map +0 -1
  509. package/dist/core/extract/orm/typeorm.js +0 -269
  510. package/dist/core/extract/orm/typeorm.js.map +0 -1
  511. package/dist/core/extract/orm/types.d.ts +0 -97
  512. package/dist/core/extract/orm/types.d.ts.map +0 -1
  513. package/dist/core/extract/orm/types.js +0 -6
  514. package/dist/core/extract/orm/types.js.map +0 -1
  515. package/dist/core/extract/prompt.d.ts +0 -21
  516. package/dist/core/extract/prompt.d.ts.map +0 -1
  517. package/dist/core/extract/prompt.js +0 -79
  518. package/dist/core/extract/prompt.js.map +0 -1
  519. package/dist/core/extract/provider.d.ts +0 -121
  520. package/dist/core/extract/provider.d.ts.map +0 -1
  521. package/dist/core/extract/provider.js +0 -6
  522. package/dist/core/extract/provider.js.map +0 -1
  523. package/dist/core/extract/providers/node-ts.d.ts +0 -69
  524. package/dist/core/extract/providers/node-ts.d.ts.map +0 -1
  525. package/dist/core/extract/providers/node-ts.js +0 -320
  526. package/dist/core/extract/providers/node-ts.js.map +0 -1
  527. package/dist/core/extract/render/schema-md.d.ts +0 -16
  528. package/dist/core/extract/render/schema-md.d.ts.map +0 -1
  529. package/dist/core/extract/render/schema-md.js +0 -140
  530. package/dist/core/extract/render/schema-md.js.map +0 -1
  531. package/dist/core/extract/report.d.ts +0 -125
  532. package/dist/core/extract/report.d.ts.map +0 -1
  533. package/dist/core/extract/report.js +0 -52
  534. package/dist/core/extract/report.js.map +0 -1
  535. package/dist/core/extract/schema.d.ts +0 -34
  536. package/dist/core/extract/schema.d.ts.map +0 -1
  537. package/dist/core/extract/schema.js +0 -146
  538. package/dist/core/extract/schema.js.map +0 -1
  539. package/dist/core/extract/workspaces.d.ts +0 -33
  540. package/dist/core/extract/workspaces.d.ts.map +0 -1
  541. package/dist/core/extract/workspaces.js +0 -193
  542. package/dist/core/extract/workspaces.js.map +0 -1
  543. package/dist/core/providers/index.d.ts +0 -6
  544. package/dist/core/providers/index.d.ts.map +0 -1
  545. package/dist/core/providers/index.js +0 -2
  546. package/dist/core/providers/index.js.map +0 -1
  547. package/dist/core/providers/tracker.d.ts +0 -74
  548. package/dist/core/providers/tracker.d.ts.map +0 -1
  549. package/dist/core/providers/tracker.js +0 -38
  550. package/dist/core/providers/tracker.js.map +0 -1
  551. package/dist/core/scope/calibration.d.ts +0 -25
  552. package/dist/core/scope/calibration.d.ts.map +0 -1
  553. package/dist/core/scope/calibration.js +0 -52
  554. package/dist/core/scope/calibration.js.map +0 -1
  555. package/dist/core/scope/closure.d.ts +0 -31
  556. package/dist/core/scope/closure.d.ts.map +0 -1
  557. package/dist/core/scope/closure.js +0 -68
  558. package/dist/core/scope/closure.js.map +0 -1
  559. package/dist/core/scope/gate.d.ts +0 -41
  560. package/dist/core/scope/gate.d.ts.map +0 -1
  561. package/dist/core/scope/gate.js +0 -165
  562. package/dist/core/scope/gate.js.map +0 -1
  563. package/dist/core/scope/index.d.ts +0 -18
  564. package/dist/core/scope/index.d.ts.map +0 -1
  565. package/dist/core/scope/index.js +0 -12
  566. package/dist/core/scope/index.js.map +0 -1
  567. package/dist/core/scope/partition.d.ts +0 -36
  568. package/dist/core/scope/partition.d.ts.map +0 -1
  569. package/dist/core/scope/partition.js +0 -78
  570. package/dist/core/scope/partition.js.map +0 -1
  571. package/dist/core/scope/prompt.d.ts +0 -39
  572. package/dist/core/scope/prompt.d.ts.map +0 -1
  573. package/dist/core/scope/prompt.js +0 -123
  574. package/dist/core/scope/prompt.js.map +0 -1
  575. package/dist/core/scope/scoping.d.ts +0 -52
  576. package/dist/core/scope/scoping.d.ts.map +0 -1
  577. package/dist/core/scope/scoping.js +0 -99
  578. package/dist/core/scope/scoping.js.map +0 -1
  579. package/dist/core/scope/types.d.ts +0 -77
  580. package/dist/core/scope/types.d.ts.map +0 -1
  581. package/dist/core/scope/types.js +0 -5
  582. package/dist/core/scope/types.js.map +0 -1
  583. package/dist/core/scope/validate.d.ts +0 -47
  584. package/dist/core/scope/validate.d.ts.map +0 -1
  585. package/dist/core/scope/validate.js +0 -90
  586. package/dist/core/scope/validate.js.map +0 -1
  587. package/dist/core/verify/asyncapi-diff.d.ts +0 -34
  588. package/dist/core/verify/asyncapi-diff.d.ts.map +0 -1
  589. package/dist/core/verify/asyncapi-diff.js +0 -209
  590. package/dist/core/verify/asyncapi-diff.js.map +0 -1
  591. package/dist/core/verify/contract-diff.d.ts +0 -39
  592. package/dist/core/verify/contract-diff.d.ts.map +0 -1
  593. package/dist/core/verify/contract-diff.js +0 -63
  594. package/dist/core/verify/contract-diff.js.map +0 -1
  595. package/dist/core/verify/drift.d.ts +0 -47
  596. package/dist/core/verify/drift.d.ts.map +0 -1
  597. package/dist/core/verify/drift.js +0 -122
  598. package/dist/core/verify/drift.js.map +0 -1
  599. package/dist/core/verify/impact.d.ts +0 -22
  600. package/dist/core/verify/impact.d.ts.map +0 -1
  601. package/dist/core/verify/impact.js +0 -93
  602. package/dist/core/verify/impact.js.map +0 -1
  603. package/dist/core/verify/index.d.ts +0 -10
  604. package/dist/core/verify/index.d.ts.map +0 -1
  605. package/dist/core/verify/index.js +0 -9
  606. package/dist/core/verify/index.js.map +0 -1
  607. package/dist/core/verify/openapi-diff.d.ts +0 -29
  608. package/dist/core/verify/openapi-diff.d.ts.map +0 -1
  609. package/dist/core/verify/openapi-diff.js +0 -291
  610. package/dist/core/verify/openapi-diff.js.map +0 -1
  611. package/dist/core/verify/types.d.ts +0 -138
  612. package/dist/core/verify/types.d.ts.map +0 -1
  613. package/dist/core/verify/types.js +0 -5
  614. package/dist/core/verify/types.js.map +0 -1
  615. package/schemas/component.schema.json +0 -203
  616. package/schemas/flow.schema.json +0 -75
  617. 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"}