@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
@@ -1,20 +1,195 @@
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
+ #
23
+ # Rules 1 and 4 read each command's arguments from its own simple-command
24
+ # segment (split at `&&`, `||`, `;`, `|`, `&`, and newlines outside quotes —
25
+ # see command_segments()), never from the rest of the command string. A
26
+ # chained `gh pr create --base main` is not a push to `main`, a `--tags` in a
27
+ # commit message is not a tag push, and every push or merge in a chain is
28
+ # checked, not only the last one (issue #256).
29
+ #
30
+ # 5. (Issue #178) The same "no write to the default branch" invariant as
31
+ # rule 1, enforced on the mutating GitHub MCP tool surface, not just
32
+ # `Bash`. Before this rule, `.claude/settings.json` matched `"Bash"`
33
+ # only, so any consumer with the GitHub MCP server enabled had NO
34
+ # enforcement whatsoever on `mcp__github__merge_pull_request`,
35
+ # `enable_pr_auto_merge`, `push_files`, `create_or_update_file`,
36
+ # `delete_file`, or `create_branch` — a total bypass of rules 1-4 on
37
+ # that tool surface. This rule is dispatched on the PreToolUse payload's
38
+ # structured `tool_name` field (an exact match against the six names
39
+ # above) and reads the matching structured `tool_input` fields directly
40
+ # (`pullNumber`, `owner`, `repo`, `branch`) — never a regex over a
41
+ # stringified `tool_input` blob, since MCP calls arrive as real JSON,
42
+ # not a shell command string that needs tokenizing.
9
43
  #
10
44
  # Contract: receives the PreToolUse hook payload as JSON on stdin. Exit code 2
11
45
  # blocks the tool call and returns stderr to Claude as feedback; exit 0 allows.
12
46
  # Any unexpected error exits 0 (fail-open) so the guard never wedges a session.
47
+ #
48
+ # Fail-open exception (rules 1 and 5 only): resolving a `gh pr merge` (or
49
+ # `mcp__github__merge_pull_request` / `enable_pr_auto_merge`) PR's base
50
+ # branch requires calling `gh pr view`. If that lookup fails for any reason —
51
+ # `gh` missing, unauthenticated, network error, or (rule 5 only) the MCP
52
+ # payload not carrying enough information to identify the PR at all — this
53
+ # rule fails CLOSED (blocks the call) instead of open, because failing open
54
+ # here would let an unreviewed PR merge into the default branch go through
55
+ # undetected. Every other rule in this script keeps the global fail-open
56
+ # contract. Rule 5's jq dependency is a further, narrower fail-open
57
+ # exception: MCP `tool_input` is structured JSON with fields that can
58
+ # legitimately contain arbitrary text (commit messages, file contents), so
59
+ # unlike rule 1-4's flat command-string parsing, correctly reading them
60
+ # requires a real JSON parser — if `jq` is unavailable, rule 5 fails open
61
+ # (skips its checks) rather than falling back to a regex over stringified
62
+ # JSON, which was rejected as unsafe for exactly this task's fields.
63
+ #
64
+ # Scope and limits: this is a best-effort, defense-in-depth LOCAL check over
65
+ # shell command TEXT (rules 1-4) and structured tool_input JSON (rule 5) — a
66
+ # flag-aware tokenizer plus pattern matching for the former, direct field
67
+ # access for the latter — not a real shell parser and not a completeness
68
+ # guarantee against every possible flag/argument/payload construction an
69
+ # agent (or a determined adversary) could produce. Rounds of independent
70
+ # audit against this file have repeatedly found and closed specific bypasses
71
+ # (ref-qualified merge targets, value-consuming flags whose value was
72
+ # mistaken for the real argument, the MCP bypass rule 5 now closes, etc.) —
73
+ # that pattern is expected to continue: text-based command parsing can
74
+ # always be evaded by a sufficiently creative future command form, in this
75
+ # script or any script like it, and a new mutating tool surface (a different
76
+ # MCP server, a future first-party tool) can always reopen the same class of
77
+ # gap rule 5 closes today. Server-side branch protection on the remote
78
+ # (tracked separately, outside this file) is the actual durable control;
79
+ # this hook narrows the window and catches the common cases, it does not
80
+ # replace that control.
13
81
 
14
82
  set -uo pipefail
15
83
 
16
84
  payload="$(cat 2>/dev/null || true)"
17
85
 
86
+ # --- Rule 5 dispatch: mutating GitHub MCP tool surface -----------------------
87
+ # Extract tool_name. Prefer jq; fall back to a permissive grep (tool_name is
88
+ # always a flat top-level string, so the grep fallback is safe here — unlike
89
+ # the richer tool_input fields rule 5 needs below, which require jq).
90
+ if command -v jq >/dev/null 2>&1; then
91
+ tool_name="$(printf '%s' "$payload" | jq -r '.tool_name // empty' 2>/dev/null || true)"
92
+ else
93
+ tool_name="$(printf '%s' "$payload" | grep -o '"tool_name"[[:space:]]*:[[:space:]]*"[^"]*"' | head -1 | sed 's/.*"tool_name"[[:space:]]*:[[:space:]]*"//; s/"$//')"
94
+ fi
95
+
96
+ mcp_block() {
97
+ printf 'BLOCKED by dev-tasks git-guard (rule 5, MCP): %s\n' "$1" >&2
98
+ exit 2
99
+ }
100
+
101
+ # Resolve the repository's default branch. Cached in $__default_branch_cache
102
+ # so repeated calls in one invocation only do the work once. Order: local
103
+ # symbolic-ref (no network) -> `gh repo view` (network, only if needed) ->
104
+ # literal fallback "main". Defined here (ahead of the rule 5 dispatch below,
105
+ # which needs it) rather than down near rule 1 — both rules share it.
106
+ __default_branch_cache=""
107
+ resolve_default_branch() {
108
+ if [ -n "$__default_branch_cache" ]; then
109
+ printf '%s' "$__default_branch_cache"
110
+ return 0
111
+ fi
112
+ local ref branch
113
+ ref="$(git symbolic-ref refs/remotes/origin/HEAD 2>/dev/null || true)"
114
+ branch="${ref##*/}"
115
+ if [ -z "$branch" ] && command -v gh >/dev/null 2>&1; then
116
+ branch="$(gh repo view --json defaultBranchRef -q .defaultBranchRef.name 2>/dev/null || true)"
117
+ fi
118
+ [ -z "$branch" ] && branch="main"
119
+ __default_branch_cache="$branch"
120
+ printf '%s' "$branch"
121
+ }
122
+
123
+ case "$tool_name" in
124
+ mcp__github__merge_pull_request | mcp__github__enable_pr_auto_merge)
125
+ if ! command -v jq >/dev/null 2>&1; then
126
+ exit 0 # fail-open: cannot safely read structured tool_input without jq.
127
+ fi
128
+ pr_number="$(printf '%s' "$payload" | jq -r '.tool_input.pullNumber // .tool_input.pull_number // empty' 2>/dev/null || true)"
129
+ owner="$(printf '%s' "$payload" | jq -r '.tool_input.owner // empty' 2>/dev/null || true)"
130
+ repo_name="$(printf '%s' "$payload" | jq -r '.tool_input.repo // empty' 2>/dev/null || true)"
131
+
132
+ if [ -z "$pr_number" ]; then
133
+ 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."
134
+ fi
135
+
136
+ base=""
137
+ lookup_ok=0
138
+ if command -v gh >/dev/null 2>&1; then
139
+ if [ -n "$owner" ] && [ -n "$repo_name" ]; then
140
+ base="$(gh pr view "$pr_number" --repo "$owner/$repo_name" --json baseRefName -q .baseRefName 2>/dev/null)" && lookup_ok=1
141
+ else
142
+ base="$(gh pr view "$pr_number" --json baseRefName -q .baseRefName 2>/dev/null)" && lookup_ok=1
143
+ fi
144
+ fi
145
+
146
+ if [ "$lookup_ok" -ne 1 ] || [ -z "$base" ]; then
147
+ 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."
148
+ fi
149
+
150
+ default_branch="$(resolve_default_branch)"
151
+ if [ "$base" = "$default_branch" ]; then
152
+ if [ "$tool_name" = "mcp__github__enable_pr_auto_merge" ]; then
153
+ mcp_block "enabling auto-merge on a PR targeting '$default_branch' is not allowed. Only the user may merge into $default_branch."
154
+ fi
155
+ mcp_block "merging a PR into '$default_branch' via the MCP tool is not allowed. Only the user may merge into $default_branch."
156
+ fi
157
+ exit 0
158
+ ;;
159
+ mcp__github__push_files | mcp__github__create_or_update_file | mcp__github__delete_file)
160
+ if ! command -v jq >/dev/null 2>&1; then
161
+ exit 0 # fail-open: cannot safely read structured tool_input without jq.
162
+ fi
163
+ target_branch="$(printf '%s' "$payload" | jq -r '.tool_input.branch // empty' 2>/dev/null || true)"
164
+ default_branch="$(resolve_default_branch)"
165
+ # A missing/empty `branch` is not a safe "not the default branch" case:
166
+ # the GitHub Contents/push-files API commits directly to the repository's
167
+ # default branch when `branch` is omitted, so an absent value is exactly
168
+ # as unsafe as an explicit match and must be blocked identically.
169
+ if [ -z "$target_branch" ] || [ "$target_branch" = "$default_branch" ]; then
170
+ display="${target_branch:-$default_branch (implicit — no 'branch' given)}"
171
+ 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."
172
+ fi
173
+ exit 0
174
+ ;;
175
+ mcp__github__create_branch)
176
+ if ! command -v jq >/dev/null 2>&1; then
177
+ exit 0 # fail-open: cannot safely read structured tool_input without jq.
178
+ fi
179
+ new_branch="$(printf '%s' "$payload" | jq -r '.tool_input.branch // empty' 2>/dev/null || true)"
180
+ default_branch="$(resolve_default_branch)"
181
+ # Case-fold both sides: a branch named e.g. 'Main' or 'MAIN' is just as
182
+ # unsafe as an exact 'main' match on case-insensitive-aware remotes/tools
183
+ # and must be blocked identically.
184
+ new_branch_lc="$(printf '%s' "$new_branch" | tr '[:upper:]' '[:lower:]')"
185
+ default_branch_lc="$(printf '%s' "$default_branch" | tr '[:upper:]' '[:lower:]')"
186
+ if [ -n "$new_branch" ] && [ "$new_branch_lc" = "$default_branch_lc" ]; then
187
+ 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')."
188
+ fi
189
+ exit 0
190
+ ;;
191
+ esac
192
+
18
193
  # Extract the command string. Prefer jq; fall back to a permissive grep.
19
194
  if command -v jq >/dev/null 2>&1; then
20
195
  cmd="$(printf '%s' "$payload" | jq -r '.tool_input.command // empty' 2>/dev/null || true)"
@@ -33,34 +208,380 @@ block() {
33
208
  exit 2
34
209
  }
35
210
 
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
211
+ # resolve_default_branch() is defined above, ahead of the rule 5 MCP
212
+ # dispatch block, since both rule 1 (below) and rule 5 share it.
213
+
214
+ # Quote-aware token splitter: splits $1 into tokens honoring shell quoting so
215
+ # a flag value containing an embedded space (e.g. `-m "merge note"` or
216
+ # `--body "some text"`) becomes a single token instead of splitting on that
217
+ # space — one token per output line. Built on `xargs -n1`, which only ever
218
+ # passes each token through to `printf '%s\n'`; it never evaluates or
219
+ # executes any part of the input, so untrusted command text cannot trigger
220
+ # code execution through this path (unlike e.g. `eval`).
221
+ tokenize() {
222
+ printf '%s' "$1" | xargs -n1 -- printf '%s\n' 2>/dev/null
223
+ }
224
+
225
+ # Split the raw command into simple-command segments, one per output line,
226
+ # at `&&`, `||`, `;`, `|`, `&`, and newlines outside single or double quotes
227
+ # (backslash escapes honored). Every rule that reads a command's arguments
228
+ # reads them from its own segment, never from the rest of the string. Before
229
+ # this, `git push -u origin feat && gh pr create --base main` read `main` as
230
+ # a push destination, `--tags` anywhere in the string read as a tag push, and
231
+ # a greedy `.*git push` match checked only the LAST push in a chained
232
+ # command, so `git push origin main && git push origin feat` was allowed
233
+ # (issue #256). Portable awk only: macOS ships BSD awk, not gawk.
234
+ command_segments() {
235
+ printf '%s\n' "$cmd" | awk '
236
+ { s = s (NR > 1 ? "\n" : "") $0 }
237
+ END {
238
+ out = ""; q = ""; n = length(s)
239
+ for (i = 1; i <= n; i++) {
240
+ c = substr(s, i, 1)
241
+ if (q != "") {
242
+ # Inside quotes a newline is part of the argument, never a
243
+ # separator: map it to a space so the segment stays whole.
244
+ if (c == "\n") { out = out " "; continue }
245
+ if (c == q) { q = ""; out = out c; continue }
246
+ if (c == "\\" && q == "\"" && i < n) {
247
+ d = substr(s, i + 1, 1); i++
248
+ if (d != "\n") out = out c d # backslash-newline is a continuation
249
+ continue
250
+ }
251
+ out = out c
252
+ continue
253
+ }
254
+ if (c == "\\" && i < n) {
255
+ d = substr(s, i + 1, 1); i++
256
+ if (d != "\n") out = out c d # backslash-newline is a continuation
257
+ continue
258
+ }
259
+ if (c == "\"" || c == "\047") { q = c; out = out c; continue }
260
+ if (c == ";" || c == "|" || c == "&" || c == "\n") { out = out "\n"; continue }
261
+ out = out c
262
+ }
263
+ print out
264
+ }'
265
+ }
266
+
267
+ # Segments matching the extended regex $1, whitespace-normalized, one per line.
268
+ segments_matching() {
269
+ command_segments | tr -s ' \t' ' ' | grep -E -- "$1"
270
+ }
271
+
272
+ # Argument tokens following EACH `git push` in segment $1, one per line.
273
+ # Quotes, backticks, parentheses, and separators are stripped from tokens so
274
+ # `$(git push origin main)` and `bash -c "git push origin main"` still yield
275
+ # `main`. Every occurrence in the segment is read, not just the last one.
276
+ push_tokens() {
277
+ printf '%s\n' "$1" | awk '{ n = split($0, parts, /git[ \t]+push/); for (i = 2; i <= n; i++) print parts[i] }' \
278
+ | tr -s ' \t' '\n\n' | tr -d "\"'\`();|&" | sed 's/[<>].*//' | grep -v '^$'
279
+ }
280
+
281
+ # A command word counts when it appears at a segment's start, after
282
+ # whitespace, after an opening quote, backtick, or parenthesis, or after a
283
+ # path (`/usr/bin/git`).
284
+ _cmd_prefix="(^|[[:space:](\`\"'/])"
285
+ _push_segment_re="${_cmd_prefix}git +push([[:space:]]|$)"
286
+
287
+ # Does any `git push` destination in the command equal branch $1? Reads each
288
+ # push segment's own tokens only. Checks bare tokens and the destination
289
+ # (right-hand) side of `src:dst` refspecs, strips a leading `+` (force-push
290
+ # shorthand) and a `refs/heads/` prefix before comparing. Flags are skipped.
291
+ push_targets_ref() {
292
+ local target="$1" seg tok dst
293
+ while IFS= read -r seg; do
294
+ while IFS= read -r tok; do
295
+ case "$tok" in
296
+ -*) continue ;;
297
+ esac
298
+ tok="${tok#+}"
299
+ dst="${tok##*:}"
300
+ tok="${tok#refs/heads/}"
301
+ dst="${dst#refs/heads/}"
302
+ if [ "$tok" = "$target" ] || [ "$dst" = "$target" ]; then
303
+ return 0
304
+ fi
305
+ done < <(push_tokens "$seg")
306
+ done < <(segments_matching "$_push_segment_re")
307
+ return 1
308
+ }
43
309
 
44
- # `git merge` while the checked-out branch is main (i.e. merging INTO main).
45
- if printf '%s' "$norm" | grep -Eq '(^|[;&|[:space:]])git +merge([[:space:]]|$)'; then
310
+ # Does any push segment push tags? `--tags`, `--follow-tags`, and `--mirror`
311
+ # (which pushes every ref, tags included) as flags of the push itself; a
312
+ # `refs/tags/` refspec; or a destination that is exactly `vX.Y.Z` — anchored,
313
+ # so a branch named e.g. `issue/42-bump-v1.2.3` is not a tag push. The words
314
+ # appearing elsewhere in the command (a commit message, an echo) do not count.
315
+ push_is_tag_push() {
316
+ local seg tok dst
317
+ while IFS= read -r seg; do
318
+ while IFS= read -r tok; do
319
+ case "$tok" in
320
+ --tags | --follow-tags | --mirror) return 0 ;;
321
+ *refs/tags/*) return 0 ;;
322
+ -*) continue ;;
323
+ esac
324
+ tok="${tok#+}"
325
+ dst="${tok##*:}"
326
+ if printf '%s' "$dst" | grep -Eq '^v[0-9]+\.[0-9]+\.[0-9]+$'; then
327
+ return 0
328
+ fi
329
+ done < <(push_tokens "$seg")
330
+ done < <(segments_matching "$_push_segment_re")
331
+ return 1
332
+ }
333
+
334
+ # `git merge` flags (long or short) that consume a FOLLOWING token as their
335
+ # value, per `git merge -h`: -s/--strategy, -X/--strategy-option, -m/--message,
336
+ # -F/--file, --into-name, --cleanup. `--flag=value` joined forms need no
337
+ # special handling here since they already arrive as a single token.
338
+ _git_merge_value_flags="-s --strategy -X --strategy-option -m --message -F --file --into-name --cleanup"
339
+
340
+ # First non-flag, non-flag-value token after `git merge` (the ref being
341
+ # merged). Flag-aware: skips both a value-consuming flag and the token that
342
+ # supplies its value, so e.g. `-m "merge note"` or `--strategy-option theirs`
343
+ # don't cause the flag's VALUE to be misread as the merge target.
344
+ git_merge_arg() {
345
+ local rest tok flag skip_next=0 is_value_flag
346
+ rest="$(printf '%s' "$norm" | sed -n 's/.*git[[:space:]][[:space:]]*merge[[:space:]][[:space:]]*//p')"
347
+ while IFS= read -r tok; do
348
+ if [ "$skip_next" -eq 1 ]; then
349
+ skip_next=0
350
+ continue
351
+ fi
352
+ case "$tok" in
353
+ -*)
354
+ is_value_flag=0
355
+ for flag in $_git_merge_value_flags; do
356
+ if [ "$tok" = "$flag" ]; then
357
+ is_value_flag=1
358
+ break
359
+ fi
360
+ done
361
+ [ "$is_value_flag" -eq 1 ] && skip_next=1
362
+ continue
363
+ ;;
364
+ esac
365
+ printf '%s' "$tok"
366
+ return 0
367
+ done < <(tokenize "$rest")
368
+ printf ''
369
+ }
370
+
371
+ # Strip known ref-qualifying prefixes (`refs/heads/`, fully-qualified
372
+ # `refs/remotes/<remote>/`, bare `remotes/<remote>/`, or a bare `<remote>/`
373
+ # shorthand as in `origin/story/1-x`) from a merge argument so the story/issue
374
+ # check recognizes the ref-qualified forms documented as canonical merge
375
+ # syntax in .claude/skills/git-ops/SKILL.md (e.g. `git merge origin/story/1-x`)
376
+ # identically to the bare `story/1-x` form. Without this, `git merge
377
+ # origin/story/1-x`, `git merge remotes/origin/story/1-x`, `git merge
378
+ # refs/heads/story/1-x`, and `git merge refs/remotes/origin/story/1-x` all
379
+ # bypassed the rule 1b block entirely.
380
+ strip_merge_ref_prefix() {
381
+ local ref="$1" candidate
382
+ ref="${ref#refs/heads/}"
383
+ ref="${ref#refs/remotes/}"
384
+ case "$ref" in
385
+ remotes/*)
386
+ ref="${ref#remotes/}"
387
+ ref="${ref#*/}"
388
+ ;;
389
+ esac
390
+ case "$ref" in
391
+ story/*|issue/*) : ;;
392
+ */*)
393
+ candidate="${ref#*/}"
394
+ case "$candidate" in
395
+ story/*|issue/*) ref="$candidate" ;;
396
+ esac
397
+ ;;
398
+ esac
399
+ printf '%s' "$ref"
400
+ }
401
+
402
+ # `gh pr merge` flags (long or short) that consume a FOLLOWING token as their
403
+ # value, per `gh help pr merge`: -A/--author-email, -b/--body, -F/--body-file,
404
+ # --match-head-commit, -t/--subject, -R/--repo. `--flag=value` joined forms
405
+ # need no special handling here since they already arrive as a single token.
406
+ _gh_pr_merge_value_flags="-A --author-email -b --body -F --body-file --match-head-commit -t --subject -R --repo"
407
+
408
+ # True (0) if $1 is one of the gh-pr-merge value-consuming flags above.
409
+ _gh_pr_merge_is_value_flag() {
410
+ local tok="$1" flag
411
+ for flag in $_gh_pr_merge_value_flags; do
412
+ [ "$tok" = "$flag" ] && return 0
413
+ done
414
+ return 1
415
+ }
416
+
417
+ # Extract a `gh pr merge` PR number: a digit-only token right after `merge`
418
+ # (skipping flags and their values), or a `#123` reference anywhere in the
419
+ # command. Empty if none given (the command then targets the current
420
+ # branch's PR). Flag-aware: skips both a value-consuming flag and the token
421
+ # that supplies its value, so e.g. `--subject 99 42` doesn't misread the
422
+ # `--subject` value `99` as the PR number instead of the real target `42`.
423
+ gh_pr_merge_number() {
424
+ local rest tok skip_next=0
425
+ rest="$(printf '%s' "$norm" | sed -n 's/.*gh[[:space:]][[:space:]]*pr[[:space:]][[:space:]]*merge[[:space:]][[:space:]]*//p')"
426
+ while IFS= read -r tok; do
427
+ if [ "$skip_next" -eq 1 ]; then
428
+ skip_next=0
429
+ continue
430
+ fi
431
+ case "$tok" in
432
+ [0-9]*)
433
+ printf '%s' "${tok%%[!0-9]*}"
434
+ return 0
435
+ ;;
436
+ '#'[0-9]*)
437
+ printf '%s' "${tok#\#}"
438
+ return 0
439
+ ;;
440
+ -*)
441
+ _gh_pr_merge_is_value_flag "$tok" && skip_next=1
442
+ continue
443
+ ;;
444
+ *) break ;;
445
+ esac
446
+ done < <(tokenize "$rest")
447
+ printf ''
448
+ }
449
+
450
+ # First non-flag, non-flag-value token after `gh pr merge`, whatever its
451
+ # shape: a bare PR number, a `#123` reference, a branch name, or a PR URL.
452
+ # `gh pr merge` (and `gh pr view`) accept all four as a valid target. Empty if
453
+ # none given (the command then targets the current branch's PR). Used as a
454
+ # fail-closed fallback so a branch-name or URL target is verified directly
455
+ # via `gh pr view <target>` instead of silently falling back to checking the
456
+ # CURRENT branch's PR — which would let a crafted `gh pr merge
457
+ # <other-branch-or-url>` merge a different, unverified PR while the guard
458
+ # checks the wrong one. Flag-aware like gh_pr_merge_number(): skips both a
459
+ # value-consuming flag and the token supplying its value (e.g. `--repo
460
+ # owner/repo`), so the flag's value is never misread as the target.
461
+ gh_pr_merge_target() {
462
+ local rest tok skip_next=0
463
+ rest="$(printf '%s' "$norm" | sed -n 's/.*gh[[:space:]][[:space:]]*pr[[:space:]][[:space:]]*merge[[:space:]][[:space:]]*//p')"
464
+ while IFS= read -r tok; do
465
+ if [ "$skip_next" -eq 1 ]; then
466
+ skip_next=0
467
+ continue
468
+ fi
469
+ case "$tok" in
470
+ -*)
471
+ _gh_pr_merge_is_value_flag "$tok" && skip_next=1
472
+ continue
473
+ ;;
474
+ esac
475
+ printf '%s' "$tok"
476
+ return 0
477
+ done < <(tokenize "$rest")
478
+ printf ''
479
+ }
480
+
481
+ # --- Rule 1: never merge/push into the default branch -------------------------
482
+
483
+ # `git push` targeting the default branch (resolved dynamically; not hardcoded
484
+ # to `main` so a repo on `master`/`trunk` is protected identically).
485
+ if printf '%s' "$norm" | grep -Eq "$_push_segment_re|[;&|]git +push"; then
486
+ default_branch="$(resolve_default_branch)"
487
+ if push_targets_ref "$default_branch"; then
488
+ block "pushing to '$default_branch' is not allowed. Open a PR; only the user may merge into $default_branch."
489
+ fi
490
+ fi
491
+
492
+ # `git merge`: two independent checks.
493
+ if printf '%s' "$norm" | grep -Eq "${_cmd_prefix}git +merge([[:space:]]|$)|[;&|]git +merge([[:space:]]|$)"; then
46
494
  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."
495
+ default_branch="$(resolve_default_branch)"
496
+
497
+ # 1a. Merging INTO the default branch via raw git.
498
+ if [ "$current_branch" = "$default_branch" ]; then
499
+ block "merging into '$default_branch' is not allowed. Only the user may approve and merge PRs into $default_branch."
49
500
  fi
501
+
502
+ # 1b. Raw-git escape: merging a story/issue branch directly into an
503
+ # integration branch bypasses PR review entirely. This is the confirmed
504
+ # live defect's unreviewable path — block it and name the reviewable one.
505
+ # Checked per segment, so every merge in a chained command is read with
506
+ # its own arguments (issue #256).
507
+ _full_norm="$norm"
508
+ while IFS= read -r norm; do
509
+ merge_arg="$(strip_merge_ref_prefix "$(git_merge_arg)")"
510
+ case "$current_branch" in
511
+ integration/*)
512
+ case "$merge_arg" in
513
+ story/*|issue/*)
514
+ 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."
515
+ ;;
516
+ esac
517
+ ;;
518
+ esac
519
+ done < <(segments_matching "${_cmd_prefix}git +merge([[:space:]]|$)")
520
+ norm="$_full_norm"
50
521
  fi
51
522
 
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."
523
+ # `gh pr merge`: resolve the PR's actual base via `gh pr view` (the `--base`
524
+ # flag does not exist on `gh pr merge` — it belongs to `gh pr create` — so a
525
+ # text check for it was always vacuous and blocked the tool's own canonical
526
+ # merge command). Fails CLOSED if the lookup itself fails; see header.
527
+ # Checked per segment, so every `gh pr merge` in a chained command is read
528
+ # with its own arguments and flags (issue #256). Commands inside the loop read
529
+ # stdin from /dev/null so they cannot consume the segment list.
530
+ _full_norm="$norm"
531
+ while IFS= read -r norm; do
532
+ # `--admin` bypasses branch protection outright; never allowed for agents.
533
+ if printf '%s' "$norm" | grep -Eq -- '(^|[[:space:]])--admin([[:space:]]|$)'; then
534
+ 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."
535
+ fi
536
+
537
+ pr_num="$(gh_pr_merge_number)"
538
+ pr_target="$(gh_pr_merge_target)"
539
+ if [ -n "$pr_num" ]; then
540
+ # Bare number or `#123` reference.
541
+ view_arg="$pr_num"
542
+ elif [ -n "$pr_target" ]; then
543
+ # Non-numeric token: a branch name or PR URL. Both are valid `gh pr view`
544
+ # arguments — pass the target straight through rather than falling back
545
+ # to the current branch's PR (see gh_pr_merge_target header).
546
+ view_arg="$pr_target"
547
+ else
548
+ view_arg=""
56
549
  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>."
550
+
551
+ if [ -n "$view_arg" ]; then
552
+ verify_cmd="gh pr view $view_arg --json baseRefName -q .baseRefName"
553
+ else
554
+ verify_cmd="gh pr view --json baseRefName -q .baseRefName"
555
+ fi
556
+
557
+ base=""
558
+ lookup_ok=0
559
+ if command -v gh >/dev/null 2>&1; then
560
+ if [ -n "$view_arg" ]; then
561
+ base="$(gh pr view "$view_arg" --json baseRefName -q .baseRefName 2>/dev/null </dev/null)" && lookup_ok=1
562
+ else
563
+ base="$(gh pr view --json baseRefName -q .baseRefName 2>/dev/null </dev/null)" && lookup_ok=1
564
+ fi
565
+ fi
566
+
567
+ if [ "$lookup_ok" -ne 1 ] || [ -z "$base" ]; then
568
+ # Fail-closed exception to this script's default fail-open contract —
569
+ # see header. An unverifiable base must not be treated as safe.
570
+ 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."
62
571
  fi
63
- fi
572
+
573
+ default_branch="$(resolve_default_branch </dev/null)"
574
+ if [ "$base" = "$default_branch" ]; then
575
+ block "merging a PR into '$default_branch' is not allowed. Only the user may merge into $default_branch."
576
+ fi
577
+
578
+ # `--auto` on a PR whose base is the default branch defers an unapproved
579
+ # merge rather than preventing one — same block, just scheduled.
580
+ if printf '%s' "$norm" | grep -Eq -- '(^|[[:space:]])--auto([[:space:]]|$)' && [ "$base" = "$default_branch" ]; then
581
+ block "'gh pr merge --auto' on a PR targeting '$default_branch' is not allowed. Only the user may merge into $default_branch."
582
+ fi
583
+ done < <(segments_matching "${_cmd_prefix}gh +pr +merge([[:space:]]|$)")
584
+ norm="$_full_norm"
64
585
 
65
586
  # --- Rule 2: Conventional Commits for git commit ------------------------------
66
587
  # Inspect inline -m / --message messages. Commits via editor or -F file are not
@@ -92,4 +613,32 @@ if printf '%s' "$norm" | grep -Eq '(^|[;&|[:space:]])gh +(issue|pr) +(create|edi
92
613
  fi
93
614
  fi
94
615
 
616
+ # --- Rule 4: tags are human-only ---------------------------------------------
617
+ # Agents may not create, move, delete, or force tags, push tags, or cut a
618
+ # GitHub release. Reading tags is allowed: `git tag -l`, `git tag --list`,
619
+ # `git tag -n`, `git tag` with no args, and `git describe --tags`.
620
+ # Checked per segment (issue #256): one read form must not let another
621
+ # segment's tag creation through, e.g. `git tag --list; git tag v1.0.0`.
622
+ while IFS= read -r _seg; do
623
+ # Allow pure list/read forms.
624
+ if printf '%s' "$_seg" | grep -Eq "${_cmd_prefix}git +tag +(-l|--list|-n[0-9]*)([[:space:]\"'\`)]|$)"; then
625
+ :
626
+ elif printf '%s' "$_seg" | grep -Eq '(^|[[:space:]])git +tag[[:space:]]*$'; then
627
+ : # `git tag` with no further arguments lists tags.
628
+ else
629
+ 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'."
630
+ fi
631
+ done < <(segments_matching "${_cmd_prefix}git +tag([[:space:]]|$)")
632
+
633
+ # Block tag pushes, read from each push segment's own arguments only: see
634
+ # push_is_tag_push.
635
+ if push_is_tag_push; then
636
+ block "pushing a tag is not allowed. Tags are created and pushed by a human only. See github-ops 'Tags'."
637
+ fi
638
+
639
+ # Block `gh release create` (cutting a release implies creating a tag).
640
+ if printf '%s' "$norm" | grep -Eq 'gh +release +create'; then
641
+ block "cutting a GitHub release is human-only (it creates a tag). See github-ops 'Tags'."
642
+ fi
643
+
95
644
  exit 0