@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
@@ -1,20 +1,187 @@
1
1
  #!/usr/bin/env bash
2
- # dev-tasks PreToolUse guard for Bash commands.
2
+ # dev-tasks PreToolUse guard for Bash commands AND the mutating GitHub MCP
3
+ # tool surface (see Rule 5 below).
3
4
  #
4
- # Enforces three repository invariants deterministically (not left to the model):
5
- # 1. No agent may merge or push into the default branch `main`.
5
+ # Enforces five repository invariants deterministically (not left to the model):
6
+ # 1. No agent may merge or push into the repository's default branch (resolved
7
+ # dynamically — see resolve_default_branch() below; falls back to `main`).
8
+ # This covers `git push`, `git merge` while HEAD is the default branch,
9
+ # `gh pr merge` (base resolved via `gh pr view`, not a `--base` text check),
10
+ # `gh pr merge --admin` (blocked outright), `gh pr merge --auto` when the
11
+ # resolved base is the default branch, and the raw-git escape of merging a
12
+ # `story/*`/`issue/*` branch directly into an `integration/*` branch (the
13
+ # reviewable path is `gh pr merge <n> --squash --delete-branch`).
6
14
  # 2. `git commit` messages must follow Conventional Commits.
7
15
  # 3. `gh issue|pr create|edit|comment|review` must not pass a multi-line body
8
16
  # inline via `--body`; `--body-file` (or stdin `--body-file -`) is required.
17
+ # 4. Tags are human-only: no agent may create, move, delete, or push a tag,
18
+ # or cut a GitHub release. Reading tags (`git tag -l`, `git describe`) is
19
+ # allowed. The tag-push detector matches an exact `vX.Y.Z` ref position
20
+ # (bare token or refspec destination), not any substring, so a branch
21
+ # named e.g. `issue/42-bump-v1.2.3` is not misdetected as a tag push.
22
+ # 5. (Issue #178) The same "no write to the default branch" invariant as
23
+ # rule 1, enforced on the mutating GitHub MCP tool surface, not just
24
+ # `Bash`. Before this rule, `.claude/settings.json` matched `"Bash"`
25
+ # only, so any consumer with the GitHub MCP server enabled had NO
26
+ # enforcement whatsoever on `mcp__github__merge_pull_request`,
27
+ # `enable_pr_auto_merge`, `push_files`, `create_or_update_file`,
28
+ # `delete_file`, or `create_branch` — a total bypass of rules 1-4 on
29
+ # that tool surface. This rule is dispatched on the PreToolUse payload's
30
+ # structured `tool_name` field (an exact match against the six names
31
+ # above) and reads the matching structured `tool_input` fields directly
32
+ # (`pullNumber`, `owner`, `repo`, `branch`) — never a regex over a
33
+ # stringified `tool_input` blob, since MCP calls arrive as real JSON,
34
+ # not a shell command string that needs tokenizing.
9
35
  #
10
36
  # Contract: receives the PreToolUse hook payload as JSON on stdin. Exit code 2
11
37
  # blocks the tool call and returns stderr to Claude as feedback; exit 0 allows.
12
38
  # Any unexpected error exits 0 (fail-open) so the guard never wedges a session.
39
+ #
40
+ # Fail-open exception (rules 1 and 5 only): resolving a `gh pr merge` (or
41
+ # `mcp__github__merge_pull_request` / `enable_pr_auto_merge`) PR's base
42
+ # branch requires calling `gh pr view`. If that lookup fails for any reason —
43
+ # `gh` missing, unauthenticated, network error, or (rule 5 only) the MCP
44
+ # payload not carrying enough information to identify the PR at all — this
45
+ # rule fails CLOSED (blocks the call) instead of open, because failing open
46
+ # here would let an unreviewed PR merge into the default branch go through
47
+ # undetected. Every other rule in this script keeps the global fail-open
48
+ # contract. Rule 5's jq dependency is a further, narrower fail-open
49
+ # exception: MCP `tool_input` is structured JSON with fields that can
50
+ # legitimately contain arbitrary text (commit messages, file contents), so
51
+ # unlike rule 1-4's flat command-string parsing, correctly reading them
52
+ # requires a real JSON parser — if `jq` is unavailable, rule 5 fails open
53
+ # (skips its checks) rather than falling back to a regex over stringified
54
+ # JSON, which was rejected as unsafe for exactly this task's fields.
55
+ #
56
+ # Scope and limits: this is a best-effort, defense-in-depth LOCAL check over
57
+ # shell command TEXT (rules 1-4) and structured tool_input JSON (rule 5) — a
58
+ # flag-aware tokenizer plus pattern matching for the former, direct field
59
+ # access for the latter — not a real shell parser and not a completeness
60
+ # guarantee against every possible flag/argument/payload construction an
61
+ # agent (or a determined adversary) could produce. Rounds of independent
62
+ # audit against this file have repeatedly found and closed specific bypasses
63
+ # (ref-qualified merge targets, value-consuming flags whose value was
64
+ # mistaken for the real argument, the MCP bypass rule 5 now closes, etc.) —
65
+ # that pattern is expected to continue: text-based command parsing can
66
+ # always be evaded by a sufficiently creative future command form, in this
67
+ # script or any script like it, and a new mutating tool surface (a different
68
+ # MCP server, a future first-party tool) can always reopen the same class of
69
+ # gap rule 5 closes today. Server-side branch protection on the remote
70
+ # (tracked separately, outside this file) is the actual durable control;
71
+ # this hook narrows the window and catches the common cases, it does not
72
+ # replace that control.
13
73
 
14
74
  set -uo pipefail
15
75
 
16
76
  payload="$(cat 2>/dev/null || true)"
17
77
 
78
+ # --- Rule 5 dispatch: mutating GitHub MCP tool surface -----------------------
79
+ # Extract tool_name. Prefer jq; fall back to a permissive grep (tool_name is
80
+ # always a flat top-level string, so the grep fallback is safe here — unlike
81
+ # the richer tool_input fields rule 5 needs below, which require jq).
82
+ if command -v jq >/dev/null 2>&1; then
83
+ tool_name="$(printf '%s' "$payload" | jq -r '.tool_name // empty' 2>/dev/null || true)"
84
+ else
85
+ tool_name="$(printf '%s' "$payload" | grep -o '"tool_name"[[:space:]]*:[[:space:]]*"[^"]*"' | head -1 | sed 's/.*"tool_name"[[:space:]]*:[[:space:]]*"//; s/"$//')"
86
+ fi
87
+
88
+ mcp_block() {
89
+ printf 'BLOCKED by dev-tasks git-guard (rule 5, MCP): %s\n' "$1" >&2
90
+ exit 2
91
+ }
92
+
93
+ # Resolve the repository's default branch. Cached in $__default_branch_cache
94
+ # so repeated calls in one invocation only do the work once. Order: local
95
+ # symbolic-ref (no network) -> `gh repo view` (network, only if needed) ->
96
+ # literal fallback "main". Defined here (ahead of the rule 5 dispatch below,
97
+ # which needs it) rather than down near rule 1 — both rules share it.
98
+ __default_branch_cache=""
99
+ resolve_default_branch() {
100
+ if [ -n "$__default_branch_cache" ]; then
101
+ printf '%s' "$__default_branch_cache"
102
+ return 0
103
+ fi
104
+ local ref branch
105
+ ref="$(git symbolic-ref refs/remotes/origin/HEAD 2>/dev/null || true)"
106
+ branch="${ref##*/}"
107
+ if [ -z "$branch" ] && command -v gh >/dev/null 2>&1; then
108
+ branch="$(gh repo view --json defaultBranchRef -q .defaultBranchRef.name 2>/dev/null || true)"
109
+ fi
110
+ [ -z "$branch" ] && branch="main"
111
+ __default_branch_cache="$branch"
112
+ printf '%s' "$branch"
113
+ }
114
+
115
+ case "$tool_name" in
116
+ mcp__github__merge_pull_request | mcp__github__enable_pr_auto_merge)
117
+ if ! command -v jq >/dev/null 2>&1; then
118
+ exit 0 # fail-open: cannot safely read structured tool_input without jq.
119
+ fi
120
+ pr_number="$(printf '%s' "$payload" | jq -r '.tool_input.pullNumber // .tool_input.pull_number // empty' 2>/dev/null || true)"
121
+ owner="$(printf '%s' "$payload" | jq -r '.tool_input.owner // empty' 2>/dev/null || true)"
122
+ repo_name="$(printf '%s' "$payload" | jq -r '.tool_input.repo // empty' 2>/dev/null || true)"
123
+
124
+ if [ -z "$pr_number" ]; then
125
+ mcp_block "could not identify the pull request (missing 'pullNumber' in tool_input). Refusing (fail-closed): an unidentified PR could target the default branch. Do not retry with a different tool or command to work around this — stop and ask the user to supply the PR number, or merge it themselves."
126
+ fi
127
+
128
+ base=""
129
+ lookup_ok=0
130
+ if command -v gh >/dev/null 2>&1; then
131
+ if [ -n "$owner" ] && [ -n "$repo_name" ]; then
132
+ base="$(gh pr view "$pr_number" --repo "$owner/$repo_name" --json baseRefName -q .baseRefName 2>/dev/null)" && lookup_ok=1
133
+ else
134
+ base="$(gh pr view "$pr_number" --json baseRefName -q .baseRefName 2>/dev/null)" && lookup_ok=1
135
+ fi
136
+ fi
137
+
138
+ if [ "$lookup_ok" -ne 1 ] || [ -z "$base" ]; then
139
+ mcp_block "could not verify PR #$pr_number's base branch via 'gh pr view' (gh missing, unauthenticated, or a network error). Refusing to proceed (fail-closed): an unverified base could be the default branch. Do not fall back to an unverified merge path — stop and ask the user to check 'gh auth status'/network access, or merge it themselves."
140
+ fi
141
+
142
+ default_branch="$(resolve_default_branch)"
143
+ if [ "$base" = "$default_branch" ]; then
144
+ if [ "$tool_name" = "mcp__github__enable_pr_auto_merge" ]; then
145
+ mcp_block "enabling auto-merge on a PR targeting '$default_branch' is not allowed. Only the user may merge into $default_branch."
146
+ fi
147
+ mcp_block "merging a PR into '$default_branch' via the MCP tool is not allowed. Only the user may merge into $default_branch."
148
+ fi
149
+ exit 0
150
+ ;;
151
+ mcp__github__push_files | mcp__github__create_or_update_file | mcp__github__delete_file)
152
+ if ! command -v jq >/dev/null 2>&1; then
153
+ exit 0 # fail-open: cannot safely read structured tool_input without jq.
154
+ fi
155
+ target_branch="$(printf '%s' "$payload" | jq -r '.tool_input.branch // empty' 2>/dev/null || true)"
156
+ default_branch="$(resolve_default_branch)"
157
+ # A missing/empty `branch` is not a safe "not the default branch" case:
158
+ # the GitHub Contents/push-files API commits directly to the repository's
159
+ # default branch when `branch` is omitted, so an absent value is exactly
160
+ # as unsafe as an explicit match and must be blocked identically.
161
+ if [ -z "$target_branch" ] || [ "$target_branch" = "$default_branch" ]; then
162
+ display="${target_branch:-$default_branch (implicit — no 'branch' given)}"
163
+ mcp_block "$tool_name would write to '$default_branch' (target: '$display'). Only the user may commit directly to $default_branch; write to a feature branch and open a PR."
164
+ fi
165
+ exit 0
166
+ ;;
167
+ mcp__github__create_branch)
168
+ if ! command -v jq >/dev/null 2>&1; then
169
+ exit 0 # fail-open: cannot safely read structured tool_input without jq.
170
+ fi
171
+ new_branch="$(printf '%s' "$payload" | jq -r '.tool_input.branch // empty' 2>/dev/null || true)"
172
+ default_branch="$(resolve_default_branch)"
173
+ # Case-fold both sides: a branch named e.g. 'Main' or 'MAIN' is just as
174
+ # unsafe as an exact 'main' match on case-insensitive-aware remotes/tools
175
+ # and must be blocked identically.
176
+ new_branch_lc="$(printf '%s' "$new_branch" | tr '[:upper:]' '[:lower:]')"
177
+ default_branch_lc="$(printf '%s' "$default_branch" | tr '[:upper:]' '[:lower:]')"
178
+ if [ -n "$new_branch" ] && [ "$new_branch_lc" = "$default_branch_lc" ]; then
179
+ mcp_block "creating a branch named '$default_branch' (the default branch) via the MCP tool is not allowed. Create a feature branch instead (e.g. 'issue/<n>-short-description' or 'story/<id>-short-description')."
180
+ fi
181
+ exit 0
182
+ ;;
183
+ esac
184
+
18
185
  # Extract the command string. Prefer jq; fall back to a permissive grep.
19
186
  if command -v jq >/dev/null 2>&1; then
20
187
  cmd="$(printf '%s' "$payload" | jq -r '.tool_input.command // empty' 2>/dev/null || true)"
@@ -33,32 +200,277 @@ block() {
33
200
  exit 2
34
201
  }
35
202
 
36
- # --- Rule 1: never merge/push into main ---------------------------------------
37
- # Block `git push ... main` (pushing to the main branch) and any merge/PR-merge
38
- # that targets main. Branch-creation and normal feature pushes are unaffected.
39
- case "$norm" in
40
- *"git push"*" main"*|*"git push"*":main"*|*"git push"*" origin main"*|*"git push"*" HEAD:main"*)
41
- block "pushing to 'main' is not allowed. Open a PR; only the user may merge into main." ;;
42
- esac
203
+ # resolve_default_branch() is defined above, ahead of the rule 5 MCP
204
+ # dispatch block, since both rule 1 (below) and rule 5 share it.
205
+
206
+ # Quote-aware token splitter: splits $1 into tokens honoring shell quoting so
207
+ # a flag value containing an embedded space (e.g. `-m "merge note"` or
208
+ # `--body "some text"`) becomes a single token instead of splitting on that
209
+ # space — one token per output line. Built on `xargs -n1`, which only ever
210
+ # passes each token through to `printf '%s\n'`; it never evaluates or
211
+ # executes any part of the input, so untrusted command text cannot trigger
212
+ # code execution through this path (unlike e.g. `eval`).
213
+ tokenize() {
214
+ printf '%s' "$1" | xargs -n1 -- printf '%s\n' 2>/dev/null
215
+ }
216
+
217
+ # Does any `git push` destination token in $norm equal $1? Checks bare tokens
218
+ # and the destination (right-hand) side of `src:dst` refspecs; strips a
219
+ # leading `+` (force-push shorthand) before comparing. Flags are skipped.
220
+ push_targets_ref() {
221
+ local target="$1" rest tok dst
222
+ rest="$(printf '%s' "$norm" | sed -n 's/.*git[[:space:]][[:space:]]*push[[:space:]][[:space:]]*//p')"
223
+ for tok in $rest; do
224
+ case "$tok" in
225
+ -*) continue ;;
226
+ esac
227
+ tok="${tok#+}"
228
+ dst="${tok##*:}"
229
+ if [ "$tok" = "$target" ] || [ "$dst" = "$target" ]; then
230
+ return 0
231
+ fi
232
+ done
233
+ return 1
234
+ }
235
+
236
+ # `git merge` flags (long or short) that consume a FOLLOWING token as their
237
+ # value, per `git merge -h`: -s/--strategy, -X/--strategy-option, -m/--message,
238
+ # -F/--file, --into-name, --cleanup. `--flag=value` joined forms need no
239
+ # special handling here since they already arrive as a single token.
240
+ _git_merge_value_flags="-s --strategy -X --strategy-option -m --message -F --file --into-name --cleanup"
241
+
242
+ # First non-flag, non-flag-value token after `git merge` (the ref being
243
+ # merged). Flag-aware: skips both a value-consuming flag and the token that
244
+ # supplies its value, so e.g. `-m "merge note"` or `--strategy-option theirs`
245
+ # don't cause the flag's VALUE to be misread as the merge target.
246
+ git_merge_arg() {
247
+ local rest tok flag skip_next=0 is_value_flag
248
+ rest="$(printf '%s' "$norm" | sed -n 's/.*git[[:space:]][[:space:]]*merge[[:space:]][[:space:]]*//p')"
249
+ while IFS= read -r tok; do
250
+ if [ "$skip_next" -eq 1 ]; then
251
+ skip_next=0
252
+ continue
253
+ fi
254
+ case "$tok" in
255
+ -*)
256
+ is_value_flag=0
257
+ for flag in $_git_merge_value_flags; do
258
+ if [ "$tok" = "$flag" ]; then
259
+ is_value_flag=1
260
+ break
261
+ fi
262
+ done
263
+ [ "$is_value_flag" -eq 1 ] && skip_next=1
264
+ continue
265
+ ;;
266
+ esac
267
+ printf '%s' "$tok"
268
+ return 0
269
+ done < <(tokenize "$rest")
270
+ printf ''
271
+ }
43
272
 
44
- # `git merge` while the checked-out branch is main (i.e. merging INTO main).
273
+ # Strip known ref-qualifying prefixes (`refs/heads/`, fully-qualified
274
+ # `refs/remotes/<remote>/`, bare `remotes/<remote>/`, or a bare `<remote>/`
275
+ # shorthand as in `origin/story/1-x`) from a merge argument so the story/issue
276
+ # check recognizes the ref-qualified forms documented as canonical merge
277
+ # syntax in .claude/skills/git-ops/SKILL.md (e.g. `git merge origin/story/1-x`)
278
+ # identically to the bare `story/1-x` form. Without this, `git merge
279
+ # origin/story/1-x`, `git merge remotes/origin/story/1-x`, `git merge
280
+ # refs/heads/story/1-x`, and `git merge refs/remotes/origin/story/1-x` all
281
+ # bypassed the rule 1b block entirely.
282
+ strip_merge_ref_prefix() {
283
+ local ref="$1" candidate
284
+ ref="${ref#refs/heads/}"
285
+ ref="${ref#refs/remotes/}"
286
+ case "$ref" in
287
+ remotes/*)
288
+ ref="${ref#remotes/}"
289
+ ref="${ref#*/}"
290
+ ;;
291
+ esac
292
+ case "$ref" in
293
+ story/*|issue/*) : ;;
294
+ */*)
295
+ candidate="${ref#*/}"
296
+ case "$candidate" in
297
+ story/*|issue/*) ref="$candidate" ;;
298
+ esac
299
+ ;;
300
+ esac
301
+ printf '%s' "$ref"
302
+ }
303
+
304
+ # `gh pr merge` flags (long or short) that consume a FOLLOWING token as their
305
+ # value, per `gh help pr merge`: -A/--author-email, -b/--body, -F/--body-file,
306
+ # --match-head-commit, -t/--subject, -R/--repo. `--flag=value` joined forms
307
+ # need no special handling here since they already arrive as a single token.
308
+ _gh_pr_merge_value_flags="-A --author-email -b --body -F --body-file --match-head-commit -t --subject -R --repo"
309
+
310
+ # True (0) if $1 is one of the gh-pr-merge value-consuming flags above.
311
+ _gh_pr_merge_is_value_flag() {
312
+ local tok="$1" flag
313
+ for flag in $_gh_pr_merge_value_flags; do
314
+ [ "$tok" = "$flag" ] && return 0
315
+ done
316
+ return 1
317
+ }
318
+
319
+ # Extract a `gh pr merge` PR number: a digit-only token right after `merge`
320
+ # (skipping flags and their values), or a `#123` reference anywhere in the
321
+ # command. Empty if none given (the command then targets the current
322
+ # branch's PR). Flag-aware: skips both a value-consuming flag and the token
323
+ # that supplies its value, so e.g. `--subject 99 42` doesn't misread the
324
+ # `--subject` value `99` as the PR number instead of the real target `42`.
325
+ gh_pr_merge_number() {
326
+ local rest tok skip_next=0
327
+ rest="$(printf '%s' "$norm" | sed -n 's/.*gh[[:space:]][[:space:]]*pr[[:space:]][[:space:]]*merge[[:space:]][[:space:]]*//p')"
328
+ while IFS= read -r tok; do
329
+ if [ "$skip_next" -eq 1 ]; then
330
+ skip_next=0
331
+ continue
332
+ fi
333
+ case "$tok" in
334
+ [0-9]*)
335
+ printf '%s' "${tok%%[!0-9]*}"
336
+ return 0
337
+ ;;
338
+ '#'[0-9]*)
339
+ printf '%s' "${tok#\#}"
340
+ return 0
341
+ ;;
342
+ -*)
343
+ _gh_pr_merge_is_value_flag "$tok" && skip_next=1
344
+ continue
345
+ ;;
346
+ *) break ;;
347
+ esac
348
+ done < <(tokenize "$rest")
349
+ printf ''
350
+ }
351
+
352
+ # First non-flag, non-flag-value token after `gh pr merge`, whatever its
353
+ # shape: a bare PR number, a `#123` reference, a branch name, or a PR URL.
354
+ # `gh pr merge` (and `gh pr view`) accept all four as a valid target. Empty if
355
+ # none given (the command then targets the current branch's PR). Used as a
356
+ # fail-closed fallback so a branch-name or URL target is verified directly
357
+ # via `gh pr view <target>` instead of silently falling back to checking the
358
+ # CURRENT branch's PR — which would let a crafted `gh pr merge
359
+ # <other-branch-or-url>` merge a different, unverified PR while the guard
360
+ # checks the wrong one. Flag-aware like gh_pr_merge_number(): skips both a
361
+ # value-consuming flag and the token supplying its value (e.g. `--repo
362
+ # owner/repo`), so the flag's value is never misread as the target.
363
+ gh_pr_merge_target() {
364
+ local rest tok skip_next=0
365
+ rest="$(printf '%s' "$norm" | sed -n 's/.*gh[[:space:]][[:space:]]*pr[[:space:]][[:space:]]*merge[[:space:]][[:space:]]*//p')"
366
+ while IFS= read -r tok; do
367
+ if [ "$skip_next" -eq 1 ]; then
368
+ skip_next=0
369
+ continue
370
+ fi
371
+ case "$tok" in
372
+ -*)
373
+ _gh_pr_merge_is_value_flag "$tok" && skip_next=1
374
+ continue
375
+ ;;
376
+ esac
377
+ printf '%s' "$tok"
378
+ return 0
379
+ done < <(tokenize "$rest")
380
+ printf ''
381
+ }
382
+
383
+ # --- Rule 1: never merge/push into the default branch -------------------------
384
+
385
+ # `git push` targeting the default branch (resolved dynamically; not hardcoded
386
+ # to `main` so a repo on `master`/`trunk` is protected identically).
387
+ if printf '%s' "$norm" | grep -Eq '(^|[;&|[:space:]])git +push'; then
388
+ default_branch="$(resolve_default_branch)"
389
+ if push_targets_ref "$default_branch"; then
390
+ block "pushing to '$default_branch' is not allowed. Open a PR; only the user may merge into $default_branch."
391
+ fi
392
+ fi
393
+
394
+ # `git merge`: two independent checks.
45
395
  if printf '%s' "$norm" | grep -Eq '(^|[;&|[:space:]])git +merge([[:space:]]|$)'; then
46
396
  current_branch="$(git rev-parse --abbrev-ref HEAD 2>/dev/null || echo '')"
47
- if [ "$current_branch" = "main" ]; then
48
- block "merging into 'main' is not allowed. Only the user may approve and merge PRs into main."
397
+ default_branch="$(resolve_default_branch)"
398
+
399
+ # 1a. Merging INTO the default branch via raw git.
400
+ if [ "$current_branch" = "$default_branch" ]; then
401
+ block "merging into '$default_branch' is not allowed. Only the user may approve and merge PRs into $default_branch."
49
402
  fi
403
+
404
+ # 1b. Raw-git escape: merging a story/issue branch directly into an
405
+ # integration branch bypasses PR review entirely. This is the confirmed
406
+ # live defect's unreviewable path — block it and name the reviewable one.
407
+ merge_arg="$(strip_merge_ref_prefix "$(git_merge_arg)")"
408
+ case "$current_branch" in
409
+ integration/*)
410
+ case "$merge_arg" in
411
+ story/*|issue/*)
412
+ block "raw 'git merge' of a story/issue branch into an integration branch is not allowed — it bypasses PR review. Use 'gh pr merge <n> --squash --delete-branch' instead."
413
+ ;;
414
+ esac
415
+ ;;
416
+ esac
50
417
  fi
51
418
 
52
- # `gh pr merge` targeting main (either via --base main or merging a PR onto main).
53
- if printf '%s' "$norm" | grep -Eq 'gh +pr +merge'; then
54
- if printf '%s' "$norm" | grep -Eq -- '--base[ =]main|-B[ =]main'; then
55
- block "merging a PR into 'main' is not allowed. Only the user may merge into main."
419
+ # `gh pr merge`: resolve the PR's actual base via `gh pr view` (the `--base`
420
+ # flag does not exist on `gh pr merge` — it belongs to `gh pr create` — so a
421
+ # text check for it was always vacuous and blocked the tool's own canonical
422
+ # merge command). Fails CLOSED if the lookup itself fails; see header.
423
+ if printf '%s' "$norm" | grep -Eq '(^|[;&|[:space:]])gh +pr +merge([[:space:]]|$)'; then
424
+ # `--admin` bypasses branch protection outright; never allowed for agents.
425
+ if printf '%s' "$norm" | grep -Eq -- '(^|[[:space:]])--admin([[:space:]]|$)'; then
426
+ block "'gh pr merge --admin' bypasses branch protection and is not allowed for agents. Only the user may merge with --admin, or via GitHub's UI/API directly."
427
+ fi
428
+
429
+ pr_num="$(gh_pr_merge_number)"
430
+ pr_target="$(gh_pr_merge_target)"
431
+ if [ -n "$pr_num" ]; then
432
+ # Bare number or `#123` reference.
433
+ view_arg="$pr_num"
434
+ elif [ -n "$pr_target" ]; then
435
+ # Non-numeric token: a branch name or PR URL. Both are valid `gh pr view`
436
+ # arguments — pass the target straight through rather than falling back
437
+ # to the current branch's PR (see gh_pr_merge_target header).
438
+ view_arg="$pr_target"
439
+ else
440
+ view_arg=""
56
441
  fi
57
- # No explicit base given: gh defaults to the PR's base. Warn-block to be safe
58
- # for the common case where PRs target main. Story PRs targeting integration
59
- # branches should pass --base <integration-branch> explicitly.
60
- if ! printf '%s' "$norm" | grep -Eq -- '--base[ =]|-B[ =]'; then
61
- block "refusing 'gh pr merge' without an explicit --base. PRs to main require user approval; for integration branches pass --base <integration-branch>."
442
+
443
+ if [ -n "$view_arg" ]; then
444
+ verify_cmd="gh pr view $view_arg --json baseRefName -q .baseRefName"
445
+ else
446
+ verify_cmd="gh pr view --json baseRefName -q .baseRefName"
447
+ fi
448
+
449
+ base=""
450
+ lookup_ok=0
451
+ if command -v gh >/dev/null 2>&1; then
452
+ if [ -n "$view_arg" ]; then
453
+ base="$(gh pr view "$view_arg" --json baseRefName -q .baseRefName 2>/dev/null)" && lookup_ok=1
454
+ else
455
+ base="$(gh pr view --json baseRefName -q .baseRefName 2>/dev/null)" && lookup_ok=1
456
+ fi
457
+ fi
458
+
459
+ if [ "$lookup_ok" -ne 1 ] || [ -z "$base" ]; then
460
+ # Fail-closed exception to this script's default fail-open contract —
461
+ # see header. An unverifiable base must not be treated as safe.
462
+ block "could not verify the PR's base branch via '$verify_cmd' (gh missing, unauthenticated, or a network error). Refusing to merge (fail-closed): an unverified base could be the default branch. Do not fall back to an unverified merge path or a different tool surface — stop and ask the user to check 'gh auth status'/network access, or merge it themselves."
463
+ fi
464
+
465
+ default_branch="$(resolve_default_branch)"
466
+ if [ "$base" = "$default_branch" ]; then
467
+ block "merging a PR into '$default_branch' is not allowed. Only the user may merge into $default_branch."
468
+ fi
469
+
470
+ # `--auto` on a PR whose base is the default branch defers an unapproved
471
+ # merge rather than preventing one — same block, just scheduled.
472
+ if printf '%s' "$norm" | grep -Eq -- '(^|[[:space:]])--auto([[:space:]]|$)' && [ "$base" = "$default_branch" ]; then
473
+ block "'gh pr merge --auto' on a PR targeting '$default_branch' is not allowed. Only the user may merge into $default_branch."
62
474
  fi
63
475
  fi
64
476
 
@@ -92,4 +504,53 @@ if printf '%s' "$norm" | grep -Eq '(^|[;&|[:space:]])gh +(issue|pr) +(create|edi
92
504
  fi
93
505
  fi
94
506
 
507
+ # --- Rule 4: tags are human-only ---------------------------------------------
508
+ # Agents may not create, move, delete, or force tags, push tags, or cut a
509
+ # GitHub release. Reading tags is allowed: `git tag -l`, `git tag --list`,
510
+ # `git tag -n`, `git tag` with no args, and `git describe --tags`.
511
+ if printf '%s' "$norm" | grep -Eq '(^|[;&|[:space:]])git +tag([[:space:]]|$)'; then
512
+ # Allow pure list/read forms.
513
+ if printf '%s' "$norm" | grep -Eq '(^|[;&|[:space:]])git +tag +(-l|--list|-n[0-9]*)([[:space:]]|$)'; then
514
+ :
515
+ elif printf '%s' "$norm" | grep -Eq '(^|[;&|[:space:]])git +tag[[:space:]]*$'; then
516
+ : # `git tag` with no further arguments lists tags.
517
+ else
518
+ block "creating, moving, deleting, or forcing a git tag is not allowed. Tags are human-only, annotated, and point at a 'main' commit. See github-ops 'Tags'."
519
+ fi
520
+ fi
521
+
522
+ # Block tag pushes: `--tags`, refs/tags/*, or a push whose destination token
523
+ # (bare, or the right-hand side of a `src:dst` refspec) is an exact `vX.Y.Z`
524
+ # ref — not merely a substring, so a branch like `issue/42-bump-v1.2.3` is not
525
+ # misdetected as a tag push.
526
+ if printf '%s' "$norm" | grep -Eq '(^|[;&|[:space:]])git +push'; then
527
+ is_tag_push=0
528
+ if printf '%s' "$norm" | grep -Eq -- '--tags'; then
529
+ is_tag_push=1
530
+ elif printf '%s' "$norm" | grep -Eq 'refs/tags/'; then
531
+ is_tag_push=1
532
+ else
533
+ rest="$(printf '%s' "$norm" | sed -n 's/.*git[[:space:]][[:space:]]*push[[:space:]][[:space:]]*//p')"
534
+ for tok in $rest; do
535
+ case "$tok" in
536
+ -*) continue ;;
537
+ esac
538
+ tok="${tok#+}"
539
+ dst="${tok##*:}"
540
+ if printf '%s' "$dst" | grep -Eq '^v[0-9]+\.[0-9]+\.[0-9]+$'; then
541
+ is_tag_push=1
542
+ break
543
+ fi
544
+ done
545
+ fi
546
+ if [ "$is_tag_push" -eq 1 ]; then
547
+ block "pushing a tag is not allowed. Tags are created and pushed by a human only. See github-ops 'Tags'."
548
+ fi
549
+ fi
550
+
551
+ # Block `gh release create` (cutting a release implies creating a tag).
552
+ if printf '%s' "$norm" | grep -Eq 'gh +release +create'; then
553
+ block "cutting a GitHub release is human-only (it creates a tag). See github-ops 'Tags'."
554
+ fi
555
+
95
556
  exit 0
@@ -80,13 +80,7 @@ The artifact **MUST** contain exactly these ten sections, in this order:
80
80
  2. If the question is vague or spans more than one answerable topic, ask **one** focused clarification. Do not proceed with an unfocused survey.
81
81
  3. Identify the target scope: files, directories, modules, or packages likely relevant.
82
82
 
83
- ### Phase 2 — Multi-Repo Detection
84
-
85
- 1. Check for `component.json` in the repository root.
86
- 2. **If present:** Consume `dt context` / `dt catalog` output to identify cross-repo boundaries, dependencies, and contracts. Cite catalog output as a source in Provenance.
87
- 3. **If absent or `dt` unavailable:** Fall back to direct file scanning (grep, tree-sitter, file search). Record the fallback in Provenance — never fail outright.
88
-
89
- ### Phase 3 — Slice Execution
83
+ ### Phase 2 — Slice Execution
90
84
 
91
85
  For each of the eight slices (S1-S8):
92
86
 
@@ -95,7 +89,7 @@ For each of the eight slices (S1-S8):
95
89
  3. If no evidence exists for a slice, mark it `N/A` with a reason (e.g., "No UI surfaces exist in this area").
96
90
  4. Rank findings by relevance to the research question, not alphabetically.
97
91
 
98
- ### Phase 4 — Synthesis
92
+ ### Phase 3 — Synthesis
99
93
 
100
94
  1. Write the **Answer first** section: directly answer the research question in <= 10 lines using the evidence gathered.
101
95
  2. Compile the **Relevance-ranked file map** from the top findings across all slices (max 30 files).
@@ -105,13 +99,13 @@ For each of the eight slices (S1-S8):
105
99
  6. Populate **Not investigated** with areas deliberately skipped (out of scope, budget exhausted, tooling unavailable).
106
100
  7. Assign a **Confidence** level based on coverage completeness, source quality, and known gaps.
107
101
 
108
- ### Phase 5 — Budget Enforcement
102
+ ### Phase 4 — Budget Enforcement
109
103
 
110
104
  1. Count report lines. If > 250, remove the lowest-relevance findings until compliant and record omissions under "Not Investigated".
111
105
  2. Count cited files. If > 30, collapse the lowest-relevance entries and record omissions.
112
106
  3. Final check: all ten sections present and in order; all eight slices addressed; both caps satisfied.
113
107
 
114
- ### Phase 6 — Provenance and Output
108
+ ### Phase 5 — Provenance and Output
115
109
 
116
110
  1. Record in Provenance:
117
111
  - Repository name
@@ -120,7 +114,6 @@ For each of the eight slices (S1-S8):
120
114
  - Invoking agent (e.g., `product-engineer`, `developer`, `planner`)
121
115
  - Research question (verbatim)
122
116
  - Date (ISO 8601)
123
- - Multi-repo source: `dt context` or `direct scanning (fallback)`
124
117
  2. Write the artifact to the contract path.
125
118
  3. Optionally post a one-line summary as a GitHub issue comment.
126
119