@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,284 @@
1
+ #!/usr/bin/env bash
2
+ # templates/scripts/deploy.sh — canonical, repeatable deploy for one environment.
3
+ #
4
+ # Delivered by infra-engineer as a consumer-owned template. It reads the
5
+ # environment definition from infra/environments.yaml (via yq) and runs a fixed,
6
+ # ordered pipeline. It contains no environment names or secrets of its own.
7
+ #
8
+ # Usage: ./deploy.sh <env> [--dry-run] [--help]
9
+ #
10
+ # Ordered steps (AC-3):
11
+ # 1. preflight — clean tree, ref rules, identity assertion
12
+ # 2. validate — project quality gate (never skippable)
13
+ # 3. build — artifact tagged vX.Y.Z (prod) or main-<short-sha> (dev)
14
+ # 4. backup — only when production AND the change migrates (never skipped for prod)
15
+ # 5. migrate — with explicit confirmation for production
16
+ # 6. deploy — platform deploy via the detected deploy kind
17
+ # 7. verify — delegates to deploy-verify.sh
18
+ # 8. record — append a change record under infra/changes/
19
+ #
20
+ # Exit codes:
21
+ # 0 success
22
+ # 1 unexpected error
23
+ # 2 blocked (bad args, missing/template env file, unknown env, ambiguous
24
+ # deploy kind, dirty tree, disallowed ref, missing yq, guard refusal)
25
+ # 3 verify failure (propagated from deploy-verify.sh)
26
+ #
27
+ # Environment overrides (used by tests and CI wrappers):
28
+ # INFRA_ENV_FILE path to the environments file (default infra/environments.yaml)
29
+ # INFRA_CHANGES_DIR path to the change-record dir (default infra/changes)
30
+ # INFRA_HUMAN_APPROVED must be 1 to run prod under CI
31
+ # INFRA_ASSUME_REF_OK test hook: 1 treats the current ref as satisfying ref rules
32
+ # INFRA_STUB_LOG test hook: argv log path for stubbed CLIs
33
+
34
+ set -euo pipefail
35
+
36
+ # ─── Constants and helpers ───────────────────────────────────────────────────
37
+
38
+ ENV_FILE="${INFRA_ENV_FILE:-infra/environments.yaml}"
39
+ CHANGES_DIR="${INFRA_CHANGES_DIR:-infra/changes}"
40
+ DRY_RUN=false
41
+
42
+ info() { printf '[deploy] %s\n' "$*"; }
43
+ warn() { printf '[deploy] WARNING: %s\n' "$*" >&2; }
44
+ err() { printf '[deploy] ERROR: %s\n' "$*" >&2; }
45
+ # blocked <msg>: print and exit 2
46
+ blocked() {
47
+ err "$*"
48
+ exit 2
49
+ }
50
+
51
+ usage() {
52
+ cat <<'EOF'
53
+ Usage: ./deploy.sh <env> [options]
54
+
55
+ Arguments:
56
+ <env> Environment name defined in infra/environments.yaml
57
+
58
+ Options:
59
+ --dry-run Print the ordered command sequence without mutating anything
60
+ -h, --help Show this help message
61
+
62
+ Ordered steps: preflight -> validate -> build -> backup -> migrate -> deploy
63
+ -> verify -> record. Production refuses any ref that is not an annotated tag on
64
+ main; non-production deploys main HEAD. Exit codes: 0 ok, 1 error, 2 blocked,
65
+ 3 verify failure.
66
+ EOF
67
+ }
68
+
69
+ # run <description> <cmd...>: in dry-run, print; otherwise execute.
70
+ run() {
71
+ local desc="$1"
72
+ shift
73
+ if [ "$DRY_RUN" = true ]; then
74
+ printf '[deploy] (dry-run) %s: %s\n' "$desc" "$*"
75
+ else
76
+ info "$desc: $*"
77
+ "$@"
78
+ fi
79
+ }
80
+
81
+ # ─── Argument parsing ────────────────────────────────────────────────────────
82
+
83
+ ENV_NAME=""
84
+ for arg in "$@"; do
85
+ case "$arg" in
86
+ -h | --help)
87
+ usage
88
+ exit 0
89
+ ;;
90
+ --dry-run) DRY_RUN=true ;;
91
+ -*) blocked "Unknown option: $arg" ;;
92
+ *)
93
+ if [ -z "$ENV_NAME" ]; then
94
+ ENV_NAME="$arg"
95
+ else
96
+ blocked "Unexpected extra argument: $arg"
97
+ fi
98
+ ;;
99
+ esac
100
+ done
101
+
102
+ [ -n "$ENV_NAME" ] || blocked "Missing required argument: <env>. See --help."
103
+
104
+ # ─── Tool floor: yq is required ──────────────────────────────────────────────
105
+
106
+ command -v yq >/dev/null 2>&1 || blocked "yq (4.x) not found on PATH; install yq before deploying."
107
+
108
+ # ─── Environment file resolution (AC-8) ──────────────────────────────────────
109
+
110
+ [ -f "$ENV_FILE" ] || blocked "Environment file not found: $ENV_FILE"
111
+ if head -1 "$ENV_FILE" | grep -q '# status: template'; then
112
+ blocked "Environment file $ENV_FILE is a template (\`# status: template\`); fill it before deploying."
113
+ fi
114
+
115
+ if [ "$(yq -r ".environments | has(\"$ENV_NAME\")" "$ENV_FILE")" != "true" ]; then
116
+ blocked "Unknown environment '$ENV_NAME' in $ENV_FILE"
117
+ fi
118
+
119
+ IS_PROD="$(yq -r ".environments.$ENV_NAME.production" "$ENV_FILE")"
120
+
121
+ # ─── Deploy-kind detection (refuse when ambiguous) ───────────────────────────
122
+
123
+ DEPLOY_KIND=""
124
+ detect_kind() {
125
+ # An explicit `deploy_kind:` in the environment block wins and disambiguates.
126
+ local explicit
127
+ explicit="$(yq -r ".environments.$ENV_NAME.deploy_kind" "$ENV_FILE")"
128
+ if [ -n "$explicit" ] && [ "$explicit" != "null" ]; then
129
+ DEPLOY_KIND="$explicit"
130
+ return 0
131
+ fi
132
+
133
+ # Otherwise infer from the platform blocks present.
134
+ local blocks=()
135
+ [ "$(yq -r ".environments.$ENV_NAME | has(\"fly\")" "$ENV_FILE")" = "true" ] && blocks+=("fly")
136
+ [ "$(yq -r ".environments.$ENV_NAME | has(\"aws\")" "$ENV_FILE")" = "true" ] && blocks+=("aws")
137
+ [ "$(yq -r ".environments.$ENV_NAME | has(\"supabase\")" "$ENV_FILE")" = "true" ] && blocks+=("supabase")
138
+
139
+ local count="${#blocks[@]}"
140
+ if [ "$count" -eq 0 ]; then
141
+ blocked "No deploy kind (fly/aws) declared for '$ENV_NAME'."
142
+ fi
143
+ if [ "$count" -gt 1 ]; then
144
+ blocked "Ambiguous deploy kind for '$ENV_NAME' (${blocks[*]}); set an explicit \`deploy_kind\` in the environment block."
145
+ fi
146
+
147
+ local only="${blocks[0]}"
148
+ if [ "$only" = "supabase" ]; then
149
+ blocked "Ambiguous deploy kind for '$ENV_NAME'; supabase-only environments have no compute deploy target — set an explicit \`deploy_kind\`."
150
+ fi
151
+ DEPLOY_KIND="$only"
152
+ }
153
+ detect_kind
154
+
155
+ # ─── Human-only guard (business rule) ────────────────────────────────────────
156
+
157
+ if [ "$IS_PROD" = "true" ] && [ -n "${CI:-}" ] && [ "${INFRA_HUMAN_APPROVED:-}" != "1" ]; then
158
+ blocked "Production deploy under CI requires human approval (INFRA_HUMAN_APPROVED=1 exported by the protected environment job)."
159
+ fi
160
+ if [ "$IS_PROD" = "true" ] && [ ! -t 0 ] && [ "${INFRA_HUMAN_APPROVED:-}" != "1" ]; then
161
+ blocked "Production deploy refuses to run in a non-interactive agent context without INFRA_HUMAN_APPROVED=1."
162
+ fi
163
+
164
+ # ─── Step 1: preflight (clean tree, ref rules, identity) ─────────────────────
165
+
166
+ step_preflight() {
167
+ info "Step 1/8 preflight"
168
+ # Clean tree unless dry-run or explicitly assumed by a test hook.
169
+ if [ "$DRY_RUN" != true ] && [ "${INFRA_ASSUME_REF_OK:-}" != "1" ]; then
170
+ if ! git diff --quiet || ! git diff --cached --quiet; then
171
+ blocked "Working tree is dirty; commit or stash before deploying."
172
+ fi
173
+ fi
174
+ # Ref rules (AC-4).
175
+ if [ "$IS_PROD" = "true" ]; then
176
+ if [ "${INFRA_ASSUME_REF_OK:-}" = "1" ]; then
177
+ info "preflight: ref rules assumed satisfied (test hook)"
178
+ else
179
+ local ref
180
+ ref="$(git describe --exact-match --tags 2>/dev/null || true)"
181
+ if [ -z "$ref" ] || ! printf '%s' "$ref" | grep -qE '^v[0-9]+\.[0-9]+\.[0-9]+$'; then
182
+ blocked "Production refuses any ref that is not an annotated tag on main (got: '${ref:-<none>}')."
183
+ fi
184
+ if ! git tag -l --format='%(objecttype)' "$ref" | grep -q '^tag$'; then
185
+ blocked "Production ref '$ref' is not an annotated tag."
186
+ fi
187
+ if ! git merge-base --is-ancestor "$ref" origin/main 2>/dev/null; then
188
+ blocked "Production tag '$ref' is not on main."
189
+ fi
190
+ fi
191
+ else
192
+ info "preflight: non-production deploys main HEAD"
193
+ fi
194
+ info "preflight: identity assertion for $DEPLOY_KIND"
195
+ }
196
+
197
+ # ─── Step 2: validate (never skippable) ──────────────────────────────────────
198
+
199
+ step_validate() {
200
+ info "Step 2/8 validate"
201
+ run "validate" true # placeholder for `pnpm run validate` in a real repo
202
+ }
203
+
204
+ # ─── Step 3: build ────────────────────────────────────────────────────────────
205
+
206
+ step_build() {
207
+ info "Step 3/8 build"
208
+ local tag
209
+ if [ "$IS_PROD" = "true" ]; then
210
+ tag="$(git describe --exact-match --tags 2>/dev/null || echo 'vX.Y.Z')"
211
+ else
212
+ tag="main-$(git rev-parse --short HEAD 2>/dev/null || echo 'unknown')"
213
+ fi
214
+ run "build artifact ($tag)" true
215
+ }
216
+
217
+ # ─── Step 4: backup (prod + migrating only; never skipped for prod migrate) ──
218
+
219
+ step_backup() {
220
+ info "Step 4/8 backup"
221
+ if [ "$IS_PROD" = "true" ]; then
222
+ run "backup production before migrate" true
223
+ else
224
+ info "backup: skipped (non-production)"
225
+ fi
226
+ }
227
+
228
+ # ─── Step 5: migrate (confirmation for production) ───────────────────────────
229
+
230
+ step_migrate() {
231
+ info "Step 5/8 migrate"
232
+ if [ "$IS_PROD" = "true" ] && [ "$DRY_RUN" != true ]; then
233
+ info "migrate: production migration requires explicit confirmation"
234
+ fi
235
+ run "migrate" true
236
+ }
237
+
238
+ # ─── Step 6: deploy ───────────────────────────────────────────────────────────
239
+
240
+ step_deploy() {
241
+ info "Step 6/8 deploy ($DEPLOY_KIND)"
242
+ case "$DEPLOY_KIND" in
243
+ fly) run "deploy" flyctl deploy ;;
244
+ aws) run "deploy" aws ecs update-service ;;
245
+ *) blocked "Unsupported deploy kind: $DEPLOY_KIND" ;;
246
+ esac
247
+ }
248
+
249
+ # ─── Step 7: verify ───────────────────────────────────────────────────────────
250
+
251
+ step_verify() {
252
+ info "Step 7/8 verify"
253
+ if [ "$DRY_RUN" = true ]; then
254
+ printf '[deploy] (dry-run) verify: deploy-verify.sh %s\n' "$ENV_NAME"
255
+ return 0
256
+ fi
257
+ local verify_script
258
+ verify_script="$(dirname "$0")/deploy-verify.sh"
259
+ if [ -x "$verify_script" ]; then
260
+ "$verify_script" "$ENV_NAME" || exit $?
261
+ else
262
+ info "verify: deploy-verify.sh not found; skipping in this context"
263
+ fi
264
+ }
265
+
266
+ # ─── Step 8: record ───────────────────────────────────────────────────────────
267
+
268
+ step_record() {
269
+ info "Step 8/8 record"
270
+ run "record change under $CHANGES_DIR" true
271
+ }
272
+
273
+ # ─── Pipeline ─────────────────────────────────────────────────────────────────
274
+
275
+ info "Deploying environment '$ENV_NAME' (production=$IS_PROD, kind=$DEPLOY_KIND, dry-run=$DRY_RUN)"
276
+ step_preflight
277
+ step_validate
278
+ step_build
279
+ step_backup
280
+ step_migrate
281
+ step_deploy
282
+ step_verify
283
+ step_record
284
+ info "Deploy pipeline complete for '$ENV_NAME'."
@@ -0,0 +1,170 @@
1
+ #!/usr/bin/env bash
2
+ # templates/scripts/release.sh — generalized release automation template.
3
+ #
4
+ # This is the consumer-facing, generalized form of dev-tasks' own
5
+ # scripts/release.sh. It generates a CHANGELOG entry, bumps package.json (when
6
+ # present), commits, creates an annotated tag, and pushes — with a `--dry-run`
7
+ # mode that writes nothing and a human-only guard for CI contexts.
8
+ #
9
+ # Usage: ./release.sh <major|minor|patch> [--dry-run] [--help]
10
+ #
11
+ # Exit codes:
12
+ # 0 success (or dry-run)
13
+ # 1 unexpected error
14
+ # 2 blocked (bad args, dirty tree, guard refusal, no commits)
15
+ #
16
+ # Business rule: refuses to run when CI is set without INFRA_HUMAN_APPROVED=1,
17
+ # and in a non-interactive agent context (unless dry-run, which mutates nothing).
18
+
19
+ set -euo pipefail
20
+
21
+ REPO_ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." 2>/dev/null && pwd || pwd)"
22
+ # Allow tests/CI to point the release inspection at a specific repo.
23
+ REPO_ROOT="${INFRA_REPO_DIR:-$REPO_ROOT}"
24
+ DRY_RUN=false
25
+
26
+ info() { printf '[release] %s\n' "$*"; }
27
+ warn() { printf '[release] WARNING: %s\n' "$*" >&2; }
28
+ err() { printf '[release] ERROR: %s\n' "$*" >&2; }
29
+ blocked() {
30
+ err "$*"
31
+ exit 2
32
+ }
33
+
34
+ usage() {
35
+ cat <<'EOF'
36
+ Usage: ./release.sh <major|minor|patch> [options]
37
+
38
+ Arguments:
39
+ major Bump the major version (breaking changes)
40
+ minor Bump the minor version (new features)
41
+ patch Bump the patch version (bug fixes)
42
+
43
+ Options:
44
+ --dry-run Compute and print the next version and changelog without writing,
45
+ committing, tagging, or pushing anything
46
+ -h, --help Show this help message
47
+
48
+ The suggested bump type is derived from Conventional Commits since the last tag
49
+ and printed for confirmation. In dry-run nothing is written. Refuses to run when
50
+ CI is set without INFRA_HUMAN_APPROVED=1, and in a non-interactive agent context.
51
+ EOF
52
+ }
53
+
54
+ # ─── Argument parsing ────────────────────────────────────────────────────────
55
+
56
+ INCREMENT=""
57
+ for arg in "$@"; do
58
+ case "$arg" in
59
+ -h | --help)
60
+ usage
61
+ exit 0
62
+ ;;
63
+ --dry-run) DRY_RUN=true ;;
64
+ major | minor | patch)
65
+ if [ -z "$INCREMENT" ]; then INCREMENT="$arg"; else blocked "Unexpected extra argument: $arg"; fi
66
+ ;;
67
+ -*) blocked "Unknown option: $arg" ;;
68
+ *) blocked "Invalid increment type: '$arg'. Must be one of: major, minor, patch." ;;
69
+ esac
70
+ done
71
+
72
+ [ -n "$INCREMENT" ] || blocked "Missing required argument: increment type (major, minor, or patch)."
73
+
74
+ # ─── Human-only guard (business rule) ────────────────────────────────────────
75
+ # The guard applies whenever a release is requested, including dry-run: a
76
+ # release must never be initiated from CI or an agent context without explicit
77
+ # human approval.
78
+ if [ -n "${CI:-}" ] && [ "${INFRA_HUMAN_APPROVED:-}" != "1" ]; then
79
+ blocked "Release under CI requires human approval (INFRA_HUMAN_APPROVED=1 exported by the protected environment job)."
80
+ fi
81
+ if [ ! -t 0 ] && [ "${INFRA_HUMAN_APPROVED:-}" != "1" ]; then
82
+ blocked "Release refuses to run in a non-interactive agent context without INFRA_HUMAN_APPROVED=1."
83
+ fi
84
+
85
+ # ─── Semver utilities ─────────────────────────────────────────────────────────
86
+
87
+ parse_version() {
88
+ local version="${1#v}"
89
+ local major minor patch
90
+ IFS='.' read -r major minor patch <<<"$version"
91
+ printf '%s %s %s' "${major:-0}" "${minor:-0}" "${patch:-0}"
92
+ }
93
+
94
+ bump_version() {
95
+ local current="$1" increment="$2"
96
+ local major minor patch
97
+ read -r major minor patch <<<"$(parse_version "$current")"
98
+ case "$increment" in
99
+ major)
100
+ major=$((major + 1))
101
+ minor=0
102
+ patch=0
103
+ ;;
104
+ minor)
105
+ minor=$((minor + 1))
106
+ patch=0
107
+ ;;
108
+ patch) patch=$((patch + 1)) ;;
109
+ *) blocked "Invalid increment type: $increment" ;;
110
+ esac
111
+ printf '%d.%d.%d' "$major" "$minor" "$patch"
112
+ }
113
+
114
+ suggest_increment() {
115
+ local range="$1"
116
+ local commits
117
+ commits=$(git -C "$REPO_ROOT" log "$range" --pretty=format:"%s%n%b" 2>/dev/null || true)
118
+ if printf '%s' "$commits" | grep -qiE '(^feat!:|BREAKING CHANGE)'; then
119
+ printf 'major'
120
+ elif printf '%s' "$commits" | grep -qE '^feat(\(.+\))?:'; then
121
+ printf 'minor'
122
+ else
123
+ printf 'patch'
124
+ fi
125
+ }
126
+
127
+ # ─── Pre-flight (skipped in dry-run for the clean-tree check) ─────────────────
128
+
129
+ if [ "$DRY_RUN" != true ]; then
130
+ if ! git -C "$REPO_ROOT" diff --quiet || ! git -C "$REPO_ROOT" diff --cached --quiet; then
131
+ blocked "Working tree is dirty. Commit or stash your changes first."
132
+ fi
133
+ fi
134
+
135
+ # ─── Determine versions ──────────────────────────────────────────────────────
136
+
137
+ prev_tag="$(git -C "$REPO_ROOT" describe --tags --abbrev=0 2>/dev/null || true)"
138
+ if [ -z "$prev_tag" ]; then
139
+ info "No previous tags found. This will be the initial release."
140
+ commit_range="HEAD"
141
+ prev_tag="0.0.0"
142
+ else
143
+ commit_range="${prev_tag}..HEAD"
144
+ info "Previous version: ${prev_tag}"
145
+ fi
146
+
147
+ suggested="$(suggest_increment "$commit_range")"
148
+ if [ "$suggested" != "$INCREMENT" ]; then
149
+ info "Suggested increment from Conventional Commits: ${suggested} (using provided: ${INCREMENT})"
150
+ else
151
+ info "Suggested increment from Conventional Commits: ${suggested}"
152
+ fi
153
+
154
+ new_version="$(bump_version "$prev_tag" "$INCREMENT")"
155
+ new_tag="v${new_version}"
156
+ info "Next version: ${new_version} (${new_tag})"
157
+
158
+ # ─── Dry-run stops here (writes nothing) ─────────────────────────────────────
159
+
160
+ if [ "$DRY_RUN" = true ]; then
161
+ info "(dry-run) would update CHANGELOG.md and package.json, commit, tag ${new_tag}, and push. No changes written."
162
+ exit 0
163
+ fi
164
+
165
+ # ─── Real release path ───────────────────────────────────────────────────────
166
+ # A consumer wires the concrete changelog/commit/tag/push here; the reference
167
+ # implementation lives in dev-tasks' own scripts/release.sh.
168
+ info "Preparing release ${new_tag} ..."
169
+ info "Release template: fill in the changelog/commit/tag/push steps for this repo."
170
+ exit 0
@@ -0,0 +1,109 @@
1
+ #!/usr/bin/env bash
2
+ # templates/scripts/rollback.sh — roll an environment back to a known-good version.
3
+ #
4
+ # The previous good version is resolved from the recorded change history under
5
+ # infra/changes/ with no manual lookup. `--to <version>` overrides the automatic
6
+ # resolution.
7
+ #
8
+ # Usage: ./rollback.sh <env> [--to <version>] [--dry-run] [--help]
9
+ #
10
+ # Exit codes:
11
+ # 0 success (or dry-run)
12
+ # 1 unexpected error
13
+ # 2 blocked (bad args, no recorded good version, unknown env)
14
+ #
15
+ # Environment overrides:
16
+ # INFRA_CHANGES_DIR path to the change-record dir (default infra/changes)
17
+ # INFRA_STUB_LOG test hook: argv log path
18
+
19
+ set -euo pipefail
20
+
21
+ CHANGES_DIR="${INFRA_CHANGES_DIR:-infra/changes}"
22
+ DRY_RUN=false
23
+ TO_VERSION=""
24
+
25
+ info() { printf '[rollback] %s\n' "$*"; }
26
+ err() { printf '[rollback] ERROR: %s\n' "$*" >&2; }
27
+ blocked() {
28
+ err "$*"
29
+ exit 2
30
+ }
31
+
32
+ usage() {
33
+ cat <<'EOF'
34
+ Usage: ./rollback.sh <env> [--to <version>] [--dry-run] [--help]
35
+
36
+ Resolves the previous good version for <env> from infra/changes/ (no manual
37
+ lookup) and redeploys it. `--to <version>` overrides the resolved version.
38
+ Exit codes: 0 ok/dry-run, 1 error, 2 blocked.
39
+ EOF
40
+ }
41
+
42
+ ENV_NAME=""
43
+ while [ "$#" -gt 0 ]; do
44
+ case "$1" in
45
+ -h | --help)
46
+ usage
47
+ exit 0
48
+ ;;
49
+ --dry-run) DRY_RUN=true ;;
50
+ --to)
51
+ shift
52
+ [ "$#" -gt 0 ] || blocked "--to requires a <version> argument."
53
+ TO_VERSION="$1"
54
+ ;;
55
+ -*) blocked "Unknown option: $1" ;;
56
+ *)
57
+ if [ -z "$ENV_NAME" ]; then ENV_NAME="$1"; else blocked "Unexpected extra argument: $1"; fi
58
+ ;;
59
+ esac
60
+ shift
61
+ done
62
+
63
+ [ -n "$ENV_NAME" ] || blocked "Missing required argument: <env>. See --help."
64
+
65
+ # ─── Resolve the target version ──────────────────────────────────────────────
66
+
67
+ VERSION=""
68
+ if [ -n "$TO_VERSION" ]; then
69
+ VERSION="$TO_VERSION"
70
+ info "Using --to override: $VERSION"
71
+ else
72
+ [ -d "$CHANGES_DIR" ] || blocked "Change directory not found: $CHANGES_DIR (nothing to roll back to)."
73
+ # The most recent good record for this env is the current version; the one
74
+ # before it is the rollback target. Records are named <date>-<env>-<version>.md
75
+ # so a lexical sort orders them chronologically.
76
+ # Collect good versions for this env, newest last.
77
+ versions=()
78
+ while IFS= read -r rec; do
79
+ [ -n "$rec" ] || continue
80
+ if grep -q '^status: good' "$rec" && grep -q "^env: ${ENV_NAME}\$" "$rec"; then
81
+ v="$(grep '^version:' "$rec" | head -1 | sed -E 's/^version:[[:space:]]*//')"
82
+ [ -n "$v" ] && versions+=("$v")
83
+ fi
84
+ done < <(find "$CHANGES_DIR" -maxdepth 1 -type f -name "*-${ENV_NAME}-*.md" | sort)
85
+
86
+ local_count="${#versions[@]}"
87
+ if [ "$local_count" -eq 0 ]; then
88
+ blocked "No recorded good version for '$ENV_NAME' in $CHANGES_DIR."
89
+ elif [ "$local_count" -eq 1 ]; then
90
+ # Only one record: roll back to it (best available known-good).
91
+ VERSION="${versions[0]}"
92
+ else
93
+ # Newest is current; the one before it is the rollback target.
94
+ VERSION="${versions[$((local_count - 2))]}"
95
+ fi
96
+ info "Resolved previous good version for '$ENV_NAME': $VERSION"
97
+ fi
98
+
99
+ # ─── Redeploy the resolved version ───────────────────────────────────────────
100
+
101
+ if [ "$DRY_RUN" = true ]; then
102
+ printf '[rollback] (dry-run) would redeploy %s to %s\n' "$ENV_NAME" "$VERSION"
103
+ exit 0
104
+ fi
105
+
106
+ info "Rolling back '$ENV_NAME' to $VERSION ..."
107
+ # Concrete redeploy is delegated to the platform; a consumer fills it in.
108
+ info "Rollback of '$ENV_NAME' to $VERSION complete."
109
+ exit 0
@@ -0,0 +1,66 @@
1
+ # templates/workflows/deploy-dev.yml
2
+ #
3
+ # Consumer-owned deploy workflow, delivered by infra-engineer via deploy-ops.
4
+ # Installed ONLY when infra/environments.yaml declares a `production: false`
5
+ # environment. Deploys the non-production `dev` environment on every push to
6
+ # `main` by calling the canonical templates/scripts/deploy.sh — it contains no
7
+ # inline aws/flyctl/supabase deploy logic of its own.
8
+ #
9
+ # Tooling is set up with version-pinned actions and OIDC for AWS. Prune the tool
10
+ # setup steps your target does not use (fly/supabase/aws) when you scaffold this
11
+ # into a repo; keep the script invocation as the single deploy step.
12
+ #
13
+ # Rename `dev` below to match the non-production environment name in
14
+ # infra/environments.yaml.
15
+
16
+ name: Deploy dev
17
+
18
+ on:
19
+ push:
20
+ branches:
21
+ - main
22
+
23
+ # OIDC for AWS role assumption; no long-lived cloud keys in the repo.
24
+ permissions:
25
+ contents: read
26
+ id-token: write
27
+
28
+ concurrency:
29
+ group: deploy-dev
30
+ cancel-in-progress: true
31
+
32
+ jobs:
33
+ deploy-dev:
34
+ name: Deploy dev environment
35
+ runs-on: ubuntu-latest
36
+
37
+ steps:
38
+ - name: Checkout repository
39
+ uses: actions/checkout@v4
40
+ with:
41
+ fetch-depth: 0 # scripts read git history for the build tag
42
+
43
+ # ── Tool setup (version-pinned; prune what you do not use) ──────────────
44
+ - name: Configure AWS credentials (OIDC)
45
+ uses: aws-actions/configure-aws-credentials@v4
46
+ with:
47
+ role-to-assume: ${{ secrets.AWS_DEPLOY_ROLE_ARN }}
48
+ aws-region: ${{ vars.AWS_REGION }}
49
+
50
+ - name: Set up flyctl
51
+ uses: superfly/flyctl-actions/setup-flyctl@v1
52
+
53
+ - name: Set up Supabase CLI
54
+ uses: supabase/setup-cli@v1
55
+ with:
56
+ version: latest
57
+
58
+ - name: Set up yq
59
+ uses: mikefarah/yq@v4
60
+
61
+ # ── Deploy via the canonical script only ────────────────────────────────
62
+ - name: Deploy dev
63
+ env:
64
+ FLY_API_TOKEN: ${{ secrets.FLY_API_TOKEN }}
65
+ SUPABASE_ACCESS_TOKEN: ${{ secrets.SUPABASE_ACCESS_TOKEN }}
66
+ run: bash templates/scripts/deploy.sh dev