@joshuafolkken/kit 1.1035.0 → 1.1094.0

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 (605) hide show
  1. package/.claude/settings.json +9 -8
  2. package/.claude/skills/epic-commands/SKILL.md +5 -7
  3. package/.claude/skills/verify-ui/SKILL.md +1 -1
  4. package/.claude/skills/workflow-commands/SKILL.md +21 -13
  5. package/.claude/skills/workflow-commands/background-commands.md +5 -4
  6. package/.claude/skills/workflow-commands/backlogrun-child.md +3 -3
  7. package/.claude/skills/workflow-commands/backlogrun-lanes.md +9 -7
  8. package/.claude/skills/workflow-commands/backlogrun-park.md +6 -0
  9. package/.claude/skills/workflow-commands/backlogrun-progress.md +31 -37
  10. package/.claude/skills/workflow-commands/backlogrun-steps.md +25 -25
  11. package/.claude/skills/workflow-commands/backlogrun.md +2 -2
  12. package/.claude/skills/workflow-commands/chain-rule.md +6 -4
  13. package/.claude/skills/workflow-commands/delegation.md +3 -3
  14. package/.claude/skills/workflow-commands/followup-reference.md +3 -3
  15. package/.claude/skills/workflow-commands/followup.md +7 -3
  16. package/.claude/skills/workflow-commands/fullrun-steps.md +3 -2
  17. package/.claude/skills/workflow-commands/fullrun.md +3 -2
  18. package/.claude/skills/workflow-commands/halfrun.md +16 -19
  19. package/.claude/skills/workflow-commands/issue-comments.md +2 -2
  20. package/.claude/skills/workflow-commands/issue-fold-existing.md +10 -10
  21. package/.claude/skills/workflow-commands/issue-scout.md +1 -1
  22. package/.claude/skills/workflow-commands/kickoff.md +9 -4
  23. package/.claude/skills/workflow-commands/latest-gate.md +1 -1
  24. package/.claude/skills/workflow-commands/needs-human-review.md +1 -1
  25. package/.claude/skills/workflow-commands/observation-filing.md +44 -89
  26. package/.claude/skills/workflow-commands/pre-gate-cut.md +33 -36
  27. package/.claude/skills/workflow-commands/prerequisite.md +1 -1
  28. package/.claude/skills/workflow-commands/prrun.md +36 -0
  29. package/.claude/skills/workflow-commands/retrospective.md +1 -1
  30. package/.claude/skills/workflow-commands/working-tree-hold.md +24 -4
  31. package/.codex/hooks.json +16 -20
  32. package/.github/actions/setup-pnpm/action.yml +93 -0
  33. package/.github/dependabot.yml +5 -1
  34. package/.github/workflows/auto-tag.yml +21 -0
  35. package/.github/workflows/ci.yml +26 -128
  36. package/.github/workflows/pr-classification.yml +5 -41
  37. package/.github/workflows/publish.yml +42 -48
  38. package/.github/workflows/sonar-qube.yml +37 -4
  39. package/AGENTS.md +12 -2
  40. package/CLAUDE.md +15 -16
  41. package/GEMINI.md +14 -2
  42. package/README.md +59 -18
  43. package/SECURITY.md +36 -6
  44. package/cspell/index.yaml +2 -1
  45. package/dist/CLAUDE.md +15 -16
  46. package/dist/config-merge/index.js +15 -3
  47. package/dist/hooks/batch-guard.js +4 -4
  48. package/dist/hooks/{chunk-Y27M6A7X.js → chunk-3C4YCCEF.js} +5 -13
  49. package/dist/hooks/{chunk-D67KVGGY.js → chunk-7ZPFAVR7.js} +17 -88
  50. package/dist/hooks/{chunk-HOYJU5RM.js → chunk-E54KGFEQ.js} +11 -4
  51. package/dist/hooks/{chunk-KG6PZD72.js → chunk-IL27YTPH.js} +2 -2
  52. package/dist/hooks/{chunk-GJT4BNVE.js → chunk-KHWHKJOM.js} +3 -3
  53. package/dist/hooks/{chunk-HU66PWWL.js → chunk-M2XDCUKD.js} +1076 -509
  54. package/dist/hooks/{chunk-GLBDBJOK.js → chunk-NKOG3XAV.js} +199 -304
  55. package/dist/hooks/{chunk-ZXNE6NY3.js → chunk-O4LL4HTI.js} +2 -7
  56. package/dist/hooks/{chunk-XPLP27WA.js → chunk-OIZUHPJI.js} +5 -27
  57. package/dist/hooks/{chunk-EIFCAJRB.js → chunk-UD24EAIL.js} +2546 -1636
  58. package/dist/hooks/codex-hook-adapter.js +10 -11
  59. package/dist/hooks/duplicate-read-guard.js +5 -5
  60. package/dist/hooks/format-edited.js +15 -34
  61. package/dist/hooks/inputs.json +279 -0
  62. package/dist/hooks/investigation-guard.js +5 -5
  63. package/dist/hooks/pretool-guard.js +23 -16
  64. package/dist/hooks/session-lang.js +0 -1
  65. package/dist/hooks/stop-guard.js +188 -509
  66. package/dist/josh.js +166 -225
  67. package/dist/managed-marker/index.js +2 -1
  68. package/dist/version/index.js +412 -64
  69. package/eslint/rules/promise.js +5 -0
  70. package/package.json +13 -8
  71. package/prompts/collaboration-workflow/file-edits.md +6 -53
  72. package/prompts/collaboration-workflow/issue-citation.md +5 -5
  73. package/prompts/collaboration-workflow/operating-rules.md +4 -4
  74. package/prompts/collaboration-workflow/overview.md +13 -1
  75. package/prompts/collaboration-workflow/report-format.md +1 -1
  76. package/prompts/collaboration-workflow/residency.md +4 -4
  77. package/prompts/collaboration-workflow/rule-delivery.md +5 -36
  78. package/prompts/collaboration-workflow/shell-body.md +7 -9
  79. package/prompts/collaboration-workflow/turn-batching.md +21 -37
  80. package/prompts/collaboration-workflow/upstream-interrupt.md +1 -1
  81. package/prompts/collaboration-workflow/wip-cap.md +36 -36
  82. package/prompts/collaboration-workflow.md +5 -8
  83. package/prompts/review-rubric.md +1 -1
  84. package/prompts/review.md +3 -3
  85. package/prompts/sonar-hotspot-handling.md +12 -4
  86. package/prompts/testing-guide.md +3 -3
  87. package/scripts/adopt/adopt-toolkits.ts +2 -2
  88. package/scripts/adopt/adopt.ts +0 -2
  89. package/scripts/agent/agent-argv.ts +0 -2
  90. package/scripts/agent/agent-diagnostics.ts +1 -1
  91. package/scripts/agent/agent-role-profile.ts +0 -7
  92. package/scripts/agent/claude-agent-argv.ts +0 -2
  93. package/scripts/agent/codex-agent-argv.ts +1 -1
  94. package/scripts/agent/codex-hooks.ts +92 -0
  95. package/scripts/agent/interactive-ask.ts +1 -1
  96. package/scripts/auto-ok/auto-ok-cli.ts +15 -25
  97. package/scripts/backlog/backlog-budget.ts +0 -2
  98. package/scripts/backlog/backlog-defect-priority.ts +2 -2
  99. package/scripts/backlog/backlog-drive-cli.ts +10 -8
  100. package/scripts/backlog/backlog-drive-named-offer.ts +16 -3
  101. package/scripts/backlog/backlog-drive-named.ts +2 -1
  102. package/scripts/backlog/backlog-drive.ts +76 -16
  103. package/scripts/backlog/backlog-named.ts +0 -3
  104. package/scripts/backlog/backlog-next.ts +32 -22
  105. package/scripts/backlog/backlog-offer-cli.ts +0 -5
  106. package/scripts/backlog/backlog-plan-cli.ts +6 -8
  107. package/scripts/backlog/backlog-plan.ts +1 -1
  108. package/scripts/backlog/backlog-pool.ts +34 -17
  109. package/scripts/backlog/backlog-rank.ts +106 -0
  110. package/scripts/backlog/backlog-ready.ts +19 -3
  111. package/scripts/backlog/backlog-scope.ts +1 -3
  112. package/scripts/backlog/backlog-stalled-detect.ts +2 -2
  113. package/scripts/backlog/backlog-stalled.ts +0 -1
  114. package/scripts/backlog/backlog-waves.ts +47 -31
  115. package/scripts/behavior/behavior-cli.ts +1 -1
  116. package/scripts/build/build-codex-hooks.ts +26 -0
  117. package/scripts/build/build-hooks.ts +92 -11
  118. package/scripts/build/hook-bundle-stamp.ts +111 -0
  119. package/scripts/cases/cases-cli.ts +1 -1
  120. package/scripts/cases/cases-logic.ts +1 -1
  121. package/scripts/ci/composite-actions.ts +30 -0
  122. package/scripts/ci/pr-classification.ts +3 -3
  123. package/scripts/claude/workflow-destination.ts +10 -1
  124. package/scripts/clone/clone-fingerprint.ts +0 -1
  125. package/scripts/clone/clone-scan-cli.ts +1 -1
  126. package/scripts/clone/clone-scan.ts +1 -1
  127. package/scripts/config-merge/json-format.ts +0 -1
  128. package/scripts/config-merge/patch-yaml-list.ts +1 -1
  129. package/scripts/cost-runtime/codex-usage.ts +2 -9
  130. package/scripts/cost-runtime/cost-attribute.ts +0 -1
  131. package/scripts/cost-runtime/cost-cli.ts +0 -3
  132. package/scripts/cost-runtime/cost-corpus.ts +0 -2
  133. package/scripts/cost-runtime/cost-format.ts +0 -3
  134. package/scripts/cost-runtime/cost-pricing.ts +0 -1
  135. package/scripts/cost-runtime/cost-tokens.ts +0 -1
  136. package/scripts/delegation/delegation-cli.ts +1 -1
  137. package/scripts/delegation/delegation-policy.ts +11 -1
  138. package/scripts/delegation/duplicate-read-guard.ts +0 -8
  139. package/scripts/delegation/fanout-cli.ts +1 -1
  140. package/scripts/delegation/fanout.ts +0 -2
  141. package/scripts/delegation/investigation-reads.ts +1 -164
  142. package/scripts/discovery/repo-map-logic.ts +0 -1
  143. package/scripts/discovery/repo-party-cli.ts +1 -1
  144. package/scripts/doctor/doctor-consumer.ts +4 -6
  145. package/scripts/doctor/doctor-logic.ts +0 -4
  146. package/scripts/doctor/doctor.ts +14 -9
  147. package/scripts/document/document-byte-budget.ts +8 -9
  148. package/scripts/document/document-byte-check.ts +0 -1
  149. package/scripts/document/document-read-cli.ts +0 -2
  150. package/scripts/document/document-section-cli.ts +1 -1
  151. package/scripts/document/document-section.ts +0 -3
  152. package/scripts/document/edit-files-cli.ts +0 -1
  153. package/scripts/document/entry-read-budget.ts +13 -4
  154. package/scripts/document/lane-child-read-set.ts +1 -6
  155. package/scripts/document/read-files-cli.ts +0 -4
  156. package/scripts/document/read-set-cli.ts +0 -2
  157. package/scripts/document/read-set-point-of-use.ts +1 -0
  158. package/scripts/document/read-set-pricing.ts +0 -1
  159. package/scripts/document/read-set-trim.ts +1 -1
  160. package/scripts/epic/epic-add.ts +1 -1
  161. package/scripts/epic/epic-audit-cli.ts +1 -4
  162. package/scripts/epic/epic-audit-orphans.ts +1 -3
  163. package/scripts/epic/epic-audit-rationale.ts +0 -1
  164. package/scripts/epic/epic-audit-report.ts +0 -2
  165. package/scripts/epic/epic-audit.ts +5 -4
  166. package/scripts/epic/epic-bundle-cli.ts +1 -1
  167. package/scripts/epic/epic-bundle-evidence.ts +0 -1
  168. package/scripts/epic/epic-bundle-referenced.ts +1 -5
  169. package/scripts/epic/epic-bundle.ts +0 -4
  170. package/scripts/epic/epic-busy.ts +4 -5
  171. package/scripts/epic/epic-candidate-confirm.ts +0 -5
  172. package/scripts/epic/epic-classify.ts +2 -2
  173. package/scripts/epic/epic-cli-argv.ts +0 -1
  174. package/scripts/epic/epic-close-comment.ts +1 -1
  175. package/scripts/epic/epic-close.ts +5 -2
  176. package/scripts/epic/epic-cross-repo.ts +2 -4
  177. package/scripts/epic/epic-decision.ts +0 -1
  178. package/scripts/epic/epic-fetch.ts +2 -2
  179. package/scripts/epic/epic-index.ts +2 -3
  180. package/scripts/epic/epic-issue.ts +1 -15
  181. package/scripts/epic/epic-lane-offer.ts +20 -30
  182. package/scripts/epic/epic-nested.ts +1 -1
  183. package/scripts/epic/epic-next-read.ts +1 -3
  184. package/scripts/epic/epic-next-views.ts +0 -1
  185. package/scripts/epic/epic-next.ts +1 -10
  186. package/scripts/epic/epic-parse.ts +0 -1
  187. package/scripts/epic/epic-promote.ts +0 -9
  188. package/scripts/epic/epic-rank.ts +37 -0
  189. package/scripts/epic/epic-read.ts +1 -2
  190. package/scripts/epic/epic-reconcile.ts +1 -1
  191. package/scripts/epic/epic-reference.ts +1 -13
  192. package/scripts/epic/epic-relation-recheck.ts +1 -1
  193. package/scripts/epic/epic-relations.ts +1 -1
  194. package/scripts/epic/epic-remove.ts +1 -1
  195. package/scripts/epic/epic-report.ts +0 -1
  196. package/scripts/epic/epic-run.ts +2 -3
  197. package/scripts/epic/epic-shape.ts +1 -1
  198. package/scripts/epic/epic-solo-stale.ts +107 -0
  199. package/scripts/epic/epic-solo.ts +32 -30
  200. package/scripts/epic/epic-triage.ts +1 -1
  201. package/scripts/epic/epic-validate.ts +1 -1
  202. package/scripts/epic/epic.ts +1 -1
  203. package/scripts/exports/unused-members-cli.ts +53 -0
  204. package/scripts/{git → followup}/followup-issue-number.ts +1 -6
  205. package/scripts/{git → followup}/git-followup-cleanup.ts +2 -1
  206. package/scripts/{git → followup}/git-followup-finish.ts +1 -3
  207. package/scripts/{git → followup}/git-followup-flush.ts +2 -2
  208. package/scripts/{git → followup}/git-followup-issue-close.ts +2 -2
  209. package/scripts/{git → followup}/git-followup-label.ts +4 -4
  210. package/scripts/followup/git-followup-merged.ts +112 -0
  211. package/scripts/{git → followup}/git-followup-pending.ts +1 -1
  212. package/scripts/{git → followup}/git-followup-workflow.ts +19 -11
  213. package/scripts/{git → followup}/git-pr-followup-wrapup.ts +9 -3
  214. package/scripts/{git → followup}/git-pr-followup.ts +53 -16
  215. package/scripts/gate/core-budget.ts +3 -9
  216. package/scripts/gate/gate-plan.ts +7 -4
  217. package/scripts/gate/gate-report.ts +0 -6
  218. package/scripts/gate/gate-tree.ts +1 -1
  219. package/scripts/gate/pre-commit-type-check.ts +0 -6
  220. package/scripts/gate/project-checks.ts +7 -8
  221. package/scripts/gate/scoped-green.ts +0 -1
  222. package/scripts/gate/type-check-step.ts +1 -1
  223. package/scripts/gate/verification-gate.ts +0 -2
  224. package/scripts/gh/fix-gh-packages.ts +15 -12
  225. package/scripts/gh/gh-spawn.ts +2 -2
  226. package/scripts/{git → gh}/git-ai-review-scan.ts +1 -5
  227. package/scripts/{git → gh}/git-gh-check.ts +2 -1
  228. package/scripts/{git → gh}/git-gh-exec.ts +1 -1
  229. package/scripts/{git → gh}/git-gh-failure.ts +1 -1
  230. package/scripts/{git → gh}/git-gh-helpers.ts +0 -1
  231. package/scripts/{git → gh}/git-gh-issue-list.ts +2 -0
  232. package/scripts/{git → gh}/git-gh-issue-read.ts +1 -1
  233. package/scripts/{git → gh}/git-gh-issue-rest.ts +6 -3
  234. package/scripts/{git → gh}/git-gh-pr-read.ts +24 -0
  235. package/scripts/{git → gh}/git-gh-pr-rest.ts +5 -2
  236. package/scripts/{git → gh}/git-gh-pr-review.ts +2 -2
  237. package/scripts/{git → gh}/git-gh-pr-rollup.ts +1 -3
  238. package/scripts/{git → gh}/git-gh-pr.ts +3 -1
  239. package/scripts/{git → gh}/git-pr-ai-review.ts +2 -5
  240. package/scripts/{git → gh}/git-pr-checks-eval.ts +0 -10
  241. package/scripts/{git → gh}/git-pr-checks-parse.ts +4 -20
  242. package/scripts/{git → gh}/git-pr-checks.ts +2 -1
  243. package/scripts/{git → gh}/git-pr-coderabbit.ts +2 -5
  244. package/scripts/{git → gh}/git-pr-confirmation.ts +1 -3
  245. package/scripts/{git → gh}/git-pr-managed-config.ts +2 -3
  246. package/scripts/{git → gh}/git-pr.ts +3 -3
  247. package/scripts/git/changed-file-scope.ts +0 -1
  248. package/scripts/git/git-branch.ts +3 -6
  249. package/scripts/git/git-command.ts +1 -1
  250. package/scripts/git/git-commit.ts +1 -1
  251. package/scripts/git/git-common-directory.ts +80 -24
  252. package/scripts/git/git-error.ts +66 -9
  253. package/scripts/git/git-execa-error.ts +6 -1
  254. package/scripts/git/git-issue.ts +1 -1
  255. package/scripts/git/git-preflight.ts +24 -6
  256. package/scripts/git/git-prompt.ts +6 -31
  257. package/scripts/git/git-push-transport.ts +12 -69
  258. package/scripts/git/git-push.ts +1 -1
  259. package/scripts/git/git-spawn.ts +79 -3
  260. package/scripts/git/git-ssh-keepalive.ts +74 -0
  261. package/scripts/git/git-staging.ts +1 -0
  262. package/scripts/git/git-status.ts +1 -1
  263. package/scripts/git/git-workflow.ts +1 -1
  264. package/scripts/git/gone-branch.ts +4 -2
  265. package/scripts/git/listing-cutoff.ts +1 -1
  266. package/scripts/git/main-merge.ts +1 -1
  267. package/scripts/git/main-sync.ts +19 -1
  268. package/scripts/git/parse-json-array.ts +0 -3
  269. package/scripts/git/repository-lock.ts +16 -16
  270. package/scripts/git/{git-stash.ts → stash/git-stash.ts} +1 -1
  271. package/scripts/git/{stash-pop-args.ts → stash/stash-pop-args.ts} +1 -1
  272. package/scripts/git/{stash-pop-cli.ts → stash/stash-pop-cli.ts} +0 -1
  273. package/scripts/git/{stash-sweep-lock.ts → stash/stash-sweep-lock.ts} +3 -3
  274. package/scripts/hooks/codex-hook-adapter.ts +0 -1
  275. package/scripts/hooks/edited-cspell.ts +1 -1
  276. package/scripts/hooks/format-edited-cli.ts +15 -0
  277. package/scripts/hooks/format-edited-file.ts +4 -9
  278. package/scripts/hooks/pre-push-unit.ts +0 -4
  279. package/scripts/hooks/pretool-guard-cli.ts +21 -0
  280. package/scripts/hooks/pretool-guard.ts +36 -19
  281. package/scripts/hooks/reserved-run.ts +1 -1
  282. package/scripts/hooks/step-zero-notice.ts +76 -0
  283. package/scripts/hooks/stop-guard.ts +47 -21
  284. package/scripts/init/claude-plugin-config.ts +4 -5
  285. package/scripts/init/hook-command-rewrite.ts +16 -8
  286. package/scripts/init/hook-launch.ts +41 -15
  287. package/scripts/init/init-basic.ts +2 -5
  288. package/scripts/init/init-logic.ts +7 -0
  289. package/scripts/init/init.ts +0 -3
  290. package/scripts/init/project-profile.ts +6 -11
  291. package/scripts/init/start-exec.ts +8 -2
  292. package/scripts/init/start-plan.ts +18 -5
  293. package/scripts/init/start-setup-pr.ts +52 -25
  294. package/scripts/init/start-steps.ts +42 -9
  295. package/scripts/init/start.ts +40 -10
  296. package/scripts/issue/behavior-change-lint.ts +0 -1
  297. package/scripts/issue/defect-rate-cli.ts +3 -3
  298. package/scripts/issue/defect-rate.ts +1 -2
  299. package/scripts/{git → issue}/git-next-issues.ts +37 -8
  300. package/scripts/issue/issue-backlinks-cli.ts +1 -5
  301. package/scripts/issue/issue-cite-cli.ts +2 -6
  302. package/scripts/issue/issue-cite.ts +19 -3
  303. package/scripts/issue/issue-classification.ts +1 -9
  304. package/scripts/issue/issue-closing-pr.ts +4 -4
  305. package/scripts/issue/issue-comment-cli.ts +2 -2
  306. package/scripts/issue/issue-file-cli.ts +5 -5
  307. package/scripts/issue/issue-file.ts +2 -2
  308. package/scripts/issue/issue-fold-cli.ts +1 -1
  309. package/scripts/issue/issue-fold-existing-cli.ts +1 -1
  310. package/scripts/{git → issue}/issue-labels.ts +20 -0
  311. package/scripts/issue/issue-lint-cli.ts +1 -1
  312. package/scripts/issue/issue-merged.ts +2 -2
  313. package/scripts/issue/issue-rank.ts +89 -0
  314. package/scripts/issue/issue-read-cli.ts +8 -47
  315. package/scripts/issue/issue-read.ts +0 -2
  316. package/scripts/issue/issue-report-failures.ts +80 -0
  317. package/scripts/issue/issue-scout-cli.ts +1 -7
  318. package/scripts/issue/issue-scout-closed.ts +2 -2
  319. package/scripts/issue/issue-scout.ts +0 -2
  320. package/scripts/issue/issue-state-cli.ts +5 -46
  321. package/scripts/issue/issue-state.ts +1 -5
  322. package/scripts/issue/markdown-section.ts +1 -1
  323. package/scripts/issue/measure-rerun-cli.ts +1 -1
  324. package/scripts/issue/reproduction-measure.ts +1 -1
  325. package/scripts/josh/cli-body.ts +1 -1
  326. package/scripts/josh/file-map-stamp.ts +0 -3
  327. package/scripts/josh/josh-command-map.ts +2 -102
  328. package/scripts/josh/josh-commands-ai.ts +9 -102
  329. package/scripts/josh/josh-commands-backlog.ts +5 -1
  330. package/scripts/josh/josh-commands-development.ts +10 -3
  331. package/scripts/josh/josh-commands-issue.ts +2 -2
  332. package/scripts/josh/josh-commands-maintenance.ts +7 -0
  333. package/scripts/josh/josh-commands-project.ts +7 -1
  334. package/scripts/josh/josh-commands-run.ts +114 -0
  335. package/scripts/josh/josh-commands-versioning.ts +8 -0
  336. package/scripts/josh/josh-commands-workflow.ts +2 -2
  337. package/scripts/josh/path-decision.ts +0 -3
  338. package/scripts/josh/process-owner.ts +16 -0
  339. package/scripts/josh/session-language-cli.ts +0 -1
  340. package/scripts/lane/lane-await.ts +3 -6
  341. package/scripts/lane/lane-capacity.ts +6 -3
  342. package/scripts/lane/lane-child-invocation.ts +20 -7
  343. package/scripts/lane/lane-child-marker.ts +16 -2
  344. package/scripts/lane/lane-cli.ts +33 -18
  345. package/scripts/lane/lane-close.ts +1 -3
  346. package/scripts/lane/lane-dispatch.ts +3 -4
  347. package/scripts/lane/lane-environment.ts +0 -9
  348. package/scripts/lane/lane-handoff.ts +38 -0
  349. package/scripts/lane/lane-launch-cli.ts +21 -11
  350. package/scripts/lane/lane-open.ts +0 -3
  351. package/scripts/lane/lane-output.ts +0 -1
  352. package/scripts/lane/lane-registry.ts +9 -0
  353. package/scripts/lane/lane-report.ts +10 -4
  354. package/scripts/lane/openai-lane-ship.ts +2 -0
  355. package/scripts/lane/openai-lane-supervisor-decision.ts +2 -1
  356. package/scripts/lane/openai-lane-supervisor.ts +6 -4
  357. package/scripts/lane/openai-review-broker.ts +3 -0
  358. package/scripts/lib/bounded-pool.ts +1 -0
  359. package/scripts/lib/json-value.ts +5 -4
  360. package/scripts/lib/poll.ts +3 -1
  361. package/scripts/lib/timed-fetch.ts +15 -0
  362. package/scripts/lib/timeouts.ts +13 -0
  363. package/scripts/{yaml → lib}/yaml-document.ts +3 -1
  364. package/scripts/{bytes → lines}/bytes-command.ts +0 -2
  365. package/scripts/lines/lines-command.ts +0 -1
  366. package/scripts/lint/lint-related-scope.ts +0 -1
  367. package/scripts/lint/lint-related.ts +1 -1
  368. package/scripts/{git → notify}/telegram-notify.ts +2 -2
  369. package/scripts/{git → notify}/telegram-test.ts +4 -4
  370. package/scripts/observations/observation-ledger-home.ts +0 -1
  371. package/scripts/observations/observation-ledger-line.ts +0 -1
  372. package/scripts/observations/observation-ledger-migrate.ts +1 -1
  373. package/scripts/observations/observations-flush-landing.ts +3 -3
  374. package/scripts/observations/observations-flush.ts +2 -2
  375. package/scripts/overrides/lockfile-overrides.ts +1 -1
  376. package/scripts/overrides/overrides-logic.ts +1 -1
  377. package/scripts/package/package-scout-cli.ts +2 -7
  378. package/scripts/package/package-scout.ts +0 -2
  379. package/scripts/propagate/propagate-git-failure.ts +0 -1
  380. package/scripts/propagate/propagate-git.ts +0 -2
  381. package/scripts/propagate/propagate-plan.ts +185 -0
  382. package/scripts/propagate/propagate-publish.ts +2 -3
  383. package/scripts/propagate/propagate-run.ts +5 -3
  384. package/scripts/propagate/propagate-steps.ts +19 -6
  385. package/scripts/propagate/propagate-targets.ts +13 -6
  386. package/scripts/propagate/propagate.ts +60 -46
  387. package/scripts/refactor/import-graph.ts +0 -1
  388. package/scripts/refactor/refactor-lint.ts +0 -2
  389. package/scripts/refactor/refactor-scan.ts +0 -1
  390. package/scripts/refactor/refactor-targets.ts +0 -1
  391. package/scripts/registry-migration/migrate-logic.ts +1 -2
  392. package/scripts/registry-migration/migrate.ts +19 -9
  393. package/scripts/release/github-release-cli.ts +8 -6
  394. package/scripts/release/github-release-environment.ts +46 -0
  395. package/scripts/release/github-release.ts +151 -94
  396. package/scripts/release/release-history.ts +0 -1
  397. package/scripts/release/release-plan.ts +0 -1
  398. package/scripts/release/release-publish.ts +2 -3
  399. package/scripts/release/release-scope-cli.ts +1 -2
  400. package/scripts/release/release-tag.ts +2 -4
  401. package/scripts/repo/auto-merge-setting-logic.ts +1 -4
  402. package/scripts/repo/repo-setting.ts +1 -1
  403. package/scripts/repo/repository-labels.ts +3 -3
  404. package/scripts/repo/required-checks-logic.ts +206 -0
  405. package/scripts/repo/required-checks-report.ts +71 -0
  406. package/scripts/repo/ruleset-check-cli.ts +53 -0
  407. package/scripts/repo/ruleset-check.ts +147 -0
  408. package/scripts/report/report-lint-cli.ts +0 -4
  409. package/scripts/review/disposition-cli.ts +1 -1
  410. package/scripts/review/live-evidence.ts +1 -1
  411. package/scripts/review/review-attest-cli.ts +0 -6
  412. package/scripts/review/review-attest.ts +48 -16
  413. package/scripts/review/review-brief-cli.ts +72 -8
  414. package/scripts/review/review-brief.ts +67 -9
  415. package/scripts/review/review-diff-parts.ts +89 -0
  416. package/scripts/review/review-diff-write.ts +97 -0
  417. package/scripts/review/review-finding-ledger.ts +0 -1
  418. package/scripts/review/review-record-cli.ts +1 -1
  419. package/scripts/review/review-record.ts +0 -1
  420. package/scripts/review/review-round2-cli.ts +1 -1
  421. package/scripts/review/review-stamps.ts +6 -2
  422. package/scripts/review/review-tree.ts +14 -2
  423. package/scripts/rules/decision-oracle-stage.ts +18 -0
  424. package/scripts/rules/decision-oracle.ts +10 -7
  425. package/scripts/rules/delivered-rules.ts +9 -1
  426. package/scripts/rules/destructive-command.ts +119 -0
  427. package/scripts/rules/direct-filing.ts +1 -1
  428. package/scripts/rules/file-body.ts +0 -3
  429. package/scripts/rules/filing-cap.ts +0 -2
  430. package/scripts/rules/gh-api.ts +7 -2
  431. package/scripts/rules/git-argv.ts +18 -7
  432. package/scripts/rules/git-force.ts +0 -2
  433. package/scripts/rules/implementation-cut.ts +1 -2
  434. package/scripts/rules/index-guard.ts +71 -0
  435. package/scripts/rules/issue-citation.ts +50 -25
  436. package/scripts/rules/issue-fold.ts +1 -2
  437. package/scripts/rules/lane-background.ts +15 -7
  438. package/scripts/rules/lane-carry-conflict.ts +1 -2
  439. package/scripts/rules/lane-park.ts +14 -8
  440. package/scripts/rules/last-prompt.ts +1 -0
  441. package/scripts/rules/oracle-consulted.ts +1 -1
  442. package/scripts/rules/oracle-firing.ts +1 -0
  443. package/scripts/rules/oracle-list-cli.ts +0 -3
  444. package/scripts/rules/permission-guards.ts +14 -0
  445. package/scripts/rules/pre-gate-cut.ts +2 -2
  446. package/scripts/rules/protected-files.ts +74 -0
  447. package/scripts/rules/reply-language.ts +1 -1
  448. package/scripts/rules/rule-body-guard.ts +0 -3
  449. package/scripts/rules/rule-value-cli.ts +0 -1
  450. package/scripts/rules/shell-body-trigger.ts +0 -1
  451. package/scripts/rules/shell-segments.ts +0 -1
  452. package/scripts/rules/stop-rules.ts +13 -5
  453. package/scripts/rules/tail-commands.ts +1 -1
  454. package/scripts/rules/test-declared-commit.ts +1 -1
  455. package/scripts/rules/third-party-write.ts +0 -1
  456. package/scripts/rules/worktree-guard.ts +26 -9
  457. package/scripts/run/run-carry-cli.ts +0 -2
  458. package/scripts/run/run-carry-stash.ts +2 -2
  459. package/scripts/run/run-carry-streak.ts +1 -1
  460. package/scripts/run/run-cut-cli.ts +0 -7
  461. package/scripts/run/run-cut.ts +8 -54
  462. package/scripts/run/run-ending-cli.ts +1 -1
  463. package/scripts/run/run-ending.ts +1 -4
  464. package/scripts/run/run-entry-cli.ts +101 -24
  465. package/scripts/run/run-entry.ts +0 -1
  466. package/scripts/run/run-event-cli.ts +0 -2
  467. package/scripts/run/run-event-follow.ts +1 -0
  468. package/scripts/run/run-event-render.ts +1 -1
  469. package/scripts/run/run-event-scope.ts +53 -4
  470. package/scripts/run/run-event-stream.ts +0 -3
  471. package/scripts/run/run-event-watch.ts +1 -0
  472. package/scripts/run/run-halfrun-resume.ts +20 -7
  473. package/scripts/run/run-headless.ts +24 -8
  474. package/scripts/run/run-hold-cli.ts +33 -10
  475. package/scripts/run/run-hold.ts +25 -5
  476. package/scripts/run/run-issue-number.ts +1 -1
  477. package/scripts/run/run-liveness-cli.ts +1 -1
  478. package/scripts/run/run-liveness.ts +2 -3
  479. package/scripts/run/run-merge-cli.ts +5 -13
  480. package/scripts/run/run-merge-steps.ts +5 -5
  481. package/scripts/run/run-merge.ts +1 -1
  482. package/scripts/run/run-next-cli.ts +1 -1
  483. package/scripts/run/run-parent-cut-hook.ts +143 -0
  484. package/scripts/run/run-preflight.ts +2 -9
  485. package/scripts/run/run-prep-cli.ts +2 -2
  486. package/scripts/run/run-prep-locate.ts +1 -1
  487. package/scripts/run/run-progress-cli.ts +4 -7
  488. package/scripts/run/run-progress-clock.ts +6 -34
  489. package/scripts/run/run-progress-config.ts +0 -4
  490. package/scripts/run/run-progress-read.ts +3 -3
  491. package/scripts/run/run-progress.ts +22 -10
  492. package/scripts/run/run-prrun-resume.ts +117 -0
  493. package/scripts/run/run-report-cli.ts +1 -2
  494. package/scripts/run/run-report.ts +0 -1
  495. package/scripts/run/run-retrospective.ts +1 -1
  496. package/scripts/run/run-review-cli.ts +0 -3
  497. package/scripts/run/run-review-steps.ts +2 -0
  498. package/scripts/run/run-review.ts +0 -2
  499. package/scripts/run/run-ship-cli.ts +27 -77
  500. package/scripts/run/run-ship-detach.ts +1 -0
  501. package/scripts/run/run-ship-next.ts +106 -0
  502. package/scripts/run/run-ship-preflight.ts +87 -0
  503. package/scripts/run/run-ship-return.ts +8 -3
  504. package/scripts/run/run-ship-review-steps.ts +23 -30
  505. package/scripts/run/run-ship-review.ts +20 -0
  506. package/scripts/run/run-ship-scoped.ts +45 -0
  507. package/scripts/run/run-ship-stage.ts +5 -1
  508. package/scripts/run/run-ship-steps.ts +105 -0
  509. package/scripts/run/run-ship.ts +2 -1
  510. package/scripts/run/run-stage-read.ts +62 -0
  511. package/scripts/run/run-stage.ts +160 -0
  512. package/scripts/run/run-status-cli.ts +1 -1
  513. package/scripts/run/run-step-cli.ts +21 -14
  514. package/scripts/run/run-step.ts +1 -1
  515. package/scripts/run/run-stop-notify.ts +1 -3
  516. package/scripts/run/run-stranded-cli.ts +0 -4
  517. package/scripts/run/run-stranded-detect.ts +2 -2
  518. package/scripts/run/run-tail-cli.ts +17 -11
  519. package/scripts/run/run-tail.ts +2 -0
  520. package/scripts/run/run-tidy-lanes.ts +2 -1
  521. package/scripts/run/run-tidy-stashes.ts +12 -12
  522. package/scripts/run/run-wake-cli.ts +4 -5
  523. package/scripts/run/run-wake-describe.ts +19 -1
  524. package/scripts/run/run-wake-loop.ts +2 -2
  525. package/scripts/run/run-wake.ts +2 -4
  526. package/scripts/run/run-watcher-guard-cli.ts +0 -4
  527. package/scripts/run/run-watcher-guard.ts +9 -7
  528. package/scripts/run/run-watcher-hook.ts +1 -1
  529. package/scripts/safe-chain/ci-installer-pin.ts +11 -5
  530. package/scripts/safe-chain/project-config.ts +1 -1
  531. package/scripts/security/security-audit-provision-logic.ts +0 -1
  532. package/scripts/security/security-audit-provision.ts +3 -2
  533. package/scripts/security/security-audit.ts +0 -1
  534. package/scripts/security/security-updates-logic.ts +0 -1
  535. package/scripts/sonar/sonar-hotspots-cli.ts +10 -52
  536. package/scripts/sonar/sonar-hotspots.ts +0 -1
  537. package/scripts/sonar/sonar-new-code-cli.ts +150 -0
  538. package/scripts/sonar/sonar-new-code.ts +79 -0
  539. package/scripts/sonar/sonar-project.ts +97 -0
  540. package/scripts/split/split-assess-cli.ts +1 -1
  541. package/scripts/split/split-assess.ts +2 -5
  542. package/scripts/sync/managed-config-scope-cli.ts +1 -1
  543. package/scripts/sync/skill-migration.ts +0 -1
  544. package/scripts/sync/sync-hook-safety.ts +2 -3
  545. package/scripts/sync/sync.ts +1 -8
  546. package/scripts/sync/template-source-logic.ts +0 -1
  547. package/scripts/sync/workflow-pin-logic.ts +16 -28
  548. package/scripts/test/test-declared-logic.ts +0 -1
  549. package/scripts/test/test-declared.ts +0 -2
  550. package/scripts/test/test-red-commit.ts +2 -2
  551. package/scripts/test/test-red.ts +14 -7
  552. package/scripts/test/test-type-logic.ts +1 -1
  553. package/scripts/test/unit-worker-share.ts +7 -16
  554. package/scripts/time-runtime/time-batch-guard.ts +1 -2
  555. package/scripts/time-runtime/time-bundle-call.ts +2 -3
  556. package/scripts/time-runtime/time-bundles.ts +0 -4
  557. package/scripts/time-runtime/time-density-hook.ts +0 -2
  558. package/scripts/time-runtime/time-followup-stage.ts +1 -1
  559. package/scripts/time-runtime/time-format.ts +0 -73
  560. package/scripts/time-runtime/time-round-trips.ts +0 -4
  561. package/scripts/time-runtime/time-single-check.ts +1 -1
  562. package/scripts/time-runtime/time-spans.ts +1 -1
  563. package/scripts/time-runtime/time-transcript-line.ts +1 -2
  564. package/scripts/ui/ui-routes-cli.ts +0 -5
  565. package/scripts/ui/ui-routes.ts +0 -5
  566. package/scripts/version/effective-upstream.ts +2 -2
  567. package/scripts/version/latest-corepack.ts +7 -9
  568. package/scripts/version/latest-scope-cli.ts +0 -2
  569. package/scripts/version/latest-update.ts +0 -2
  570. package/scripts/version/npm-registry.ts +97 -0
  571. package/scripts/version/publishable-range-check.ts +1 -1
  572. package/scripts/version/release-hold.ts +0 -4
  573. package/scripts/version/running-binary.ts +2 -2
  574. package/scripts/version/version-check-logic.ts +0 -2
  575. package/scripts/version/version-commands.ts +5 -4
  576. package/scripts/version/version-remote.ts +28 -14
  577. package/scripts/version/version-targets.ts +4 -4
  578. package/templates/sonar-project.properties +28 -1
  579. package/templates/workflows/dependabot-auto-merge.yml +5 -3
  580. package/templates/workflows/github-release.yml +81 -0
  581. package/prompts/collaboration-workflow/cross-repo-epic.md +0 -5
  582. package/prompts/collaboration-workflow/epic-audit.md +0 -5
  583. package/prompts/collaboration-workflow/epic-bundle.md +0 -5
  584. package/scripts/init/plugin-install-hint.ts +0 -47
  585. package/scripts/version/parse-json.ts +0 -13
  586. /package/scripts/{git → followup}/git-followup-stages.ts +0 -0
  587. /package/scripts/{git → gh}/git-gh-api-path.ts +0 -0
  588. /package/scripts/{git → gh}/git-gh-command.ts +0 -0
  589. /package/scripts/{git → gh}/git-gh-issue-write.ts +0 -0
  590. /package/scripts/{git → gh}/git-gh-issue.ts +0 -0
  591. /package/scripts/{git → gh}/git-gh-pr-auto-merge.ts +0 -0
  592. /package/scripts/{git → gh}/git-gh-pr-snapshot.ts +0 -0
  593. /package/scripts/{git → gh}/git-gh-reachability.ts +0 -0
  594. /package/scripts/{git → gh}/git-gh-repo.ts +0 -0
  595. /package/scripts/{git → gh}/git-gh-rest-state.ts +0 -0
  596. /package/scripts/{git → gh}/git-pr-checks-watch.ts +0 -0
  597. /package/scripts/{git → gh}/git-pr-error.ts +0 -0
  598. /package/scripts/{git → gh}/git-pr-messages.ts +0 -0
  599. /package/scripts/{git → gh}/github-issue-url.ts +0 -0
  600. /package/scripts/git/{stash-orphans.ts → stash/stash-orphans.ts} +0 -0
  601. /package/scripts/{git → issue}/issue-reference.ts +0 -0
  602. /package/scripts/{git → lib}/animation-helpers.ts +0 -0
  603. /package/scripts/{git → lib}/git-animation.ts +0 -0
  604. /package/scripts/{git → notify}/git-notify.ts +0 -0
  605. /package/scripts/{git → notify}/telegram-test-logic.ts +0 -0
@@ -70,10 +70,7 @@ function main(argv: ReadonlyArray<string>): void {
70
70
  }
71
71
 
72
72
  const oracle_list_cli = {
73
- format_oracle,
74
- main,
75
73
  print_list,
76
- run,
77
74
  }
78
75
 
79
76
  if (process.argv[1] === fileURLToPath(import.meta.url)) main(process.argv.slice(ARGV_OFFSET))
@@ -0,0 +1,14 @@
1
+ import { destructive_command } from './destructive-command'
2
+ import { index_guard } from './index-guard'
3
+ import { protected_files } from './protected-files'
4
+
5
+ // The three rows that close the deny-list bypasses (joshuafolkken/kit#2983), gathered so
6
+ // `delivered-rules.ts` spreads one entry. Each reads argv or a file path rather than a glob: an index
7
+ // mutation in any git spelling, a recursive forced `rm` or a destructive `gh` call, and a Read of
8
+ // `.env` or an edit of a consumer's `.claude/settings.json`. Their triggers are disjoint from every
9
+ // other row's — `git restore` is split with `worktree-mutation` by `--staged` alone.
10
+ const ROWS = [index_guard.ROW, destructive_command.ROW, protected_files.ROW] as const
11
+
12
+ const permission_guards = { ROWS }
13
+
14
+ export { permission_guards }
@@ -44,8 +44,8 @@ const HOLD_COMMANDS: ReadonlySet<string> = new Set(['run:hold'])
44
44
  // predicate exists to keep it out of.
45
45
  const HOLD_MODE_FLAG = /(?:^|\s)--release(?:[=\s]|$)/u
46
46
 
47
- // **Alias-expanded rather than matched as text**, so `pnpm josh ga` and `pnpm josh rct` are the same
48
- // calls as their canonical spellings. Segment-wise for the reason every other row here is: one shell
47
+ // **Alias-expanded rather than matched as text**, so `pnpm josh ga` is the same call as `pnpm josh
48
+ // gate`. Segment-wise for the reason every other row here is: one shell
49
49
  // line carries several commands, and a name quoted inside a body is not the command being invoked.
50
50
  //
51
51
  // **One reading of that question rather than one per name set.** Four predicates here differ only in
@@ -0,0 +1,74 @@
1
+ import path from 'node:path'
2
+ import { doctor_consumer } from '#scripts/doctor/doctor-consumer'
3
+ import { json_value } from '#scripts/lib/json-value'
4
+ import type { GuardedCall } from '#scripts/time-runtime/time-batch-guard'
5
+
6
+ // The trigger and the delivered text behind the `protected-file` row of `delivered-rules.ts`
7
+ // (joshuafolkken/kit#2983): the two files a run's own file tools must not touch.
8
+ //
9
+ // - **`.env` is never read.** It carries the Telegram bot token, and a Read lands it in the transcript.
10
+ // The scripts that need it load it in their own process, so refusing the tool costs them nothing.
11
+ // - **`.claude/settings.json` is never edited in a consumer repository.** It is the deny list and the
12
+ // hooks that enforce every other rule, so a run that rewrites it can switch the guards off; `josh
13
+ // sync` owns it there. Only a kit consumer's file is refused — decided per file from the repository
14
+ // the settings file sits in, not the session's directory — so kit's own edits (it is the file's
15
+ // source) and the user-level `~/.claude/settings.json`, which belongs to no repository, both pass.
16
+ //
17
+ // It fires on every occurrence, for the reason `git-force.ts` does.
18
+
19
+ const READ_TOOL = 'Read'
20
+ const EDIT_TOOLS: ReadonlySet<string> = new Set(['Edit', 'Write'])
21
+ const ENVIRONMENT_FILE = '.env'
22
+ const SETTINGS_FILE = path.join('.claude', 'settings.json')
23
+
24
+ function file_path_of(call: GuardedCall): string {
25
+ if (!json_value.is_record(call.input)) return ''
26
+
27
+ const value = call.input['file_path']
28
+
29
+ return typeof value === 'string' ? value : ''
30
+ }
31
+
32
+ function is_environment_read(call: GuardedCall): boolean {
33
+ return call.name === READ_TOOL && path.basename(file_path_of(call)) === ENVIRONMENT_FILE
34
+ }
35
+
36
+ // The repository the settings file belongs to is two levels above it (`<root>/.claude/settings.json`).
37
+ function is_consumer_settings_edit(
38
+ call: GuardedCall,
39
+ is_kit_consumer: (root: string) => boolean,
40
+ ): boolean {
41
+ if (!EDIT_TOOLS.has(call.name)) return false
42
+
43
+ const file_path = path.resolve(file_path_of(call))
44
+
45
+ if (!file_path.endsWith(`${path.sep}${SETTINGS_FILE}`)) return false
46
+
47
+ return is_kit_consumer(path.dirname(path.dirname(file_path)))
48
+ }
49
+
50
+ function is_protected_file_call(
51
+ call: GuardedCall,
52
+ is_kit_consumer: (root: string) => boolean = doctor_consumer.is_kit_consumer,
53
+ ): boolean {
54
+ return is_environment_read(call) || is_consumer_settings_edit(call, is_kit_consumer)
55
+ }
56
+
57
+ const PROTECTED_FILE_REASON =
58
+ '⛔ protected file: `.env` holds the Telegram bot token, so reading it puts a secret in the ' +
59
+ 'transcript — the scripts that need it load it in their own process. `.claude/settings.json` in a ' +
60
+ 'consumer repository is the deny list and the hooks every other rule rests on, so a run must not ' +
61
+ 'rewrite it; `josh sync` owns it, and a change belongs upstream in kit (`CLAUDE.md` → "Route ' +
62
+ 'distributed-doc / config changes upstream to kit"). Leave both files alone, or ask the user. ' +
63
+ '**This rule fires on every occurrence, not once per run.**'
64
+
65
+ const ROW = {
66
+ id: 'protected-file',
67
+ is_trigger: is_protected_file_call,
68
+ reason: PROTECTED_FILE_REASON,
69
+ decide: (): boolean => true,
70
+ }
71
+
72
+ const protected_files = { ROW, is_protected_file_call }
73
+
74
+ export { protected_files }
@@ -111,6 +111,6 @@ function is_mismatch(message: string, lang: string): boolean {
111
111
  return matches_share(prose, script, pattern) < MATCH_SHARE_FLOOR
112
112
  }
113
113
 
114
- const reply_language = { MIN_PROSE_LETTERS, is_mismatch, script_of }
114
+ const reply_language = { is_mismatch, script_of }
115
115
 
116
116
  export { reply_language }
@@ -192,11 +192,8 @@ const ROW = {
192
192
  const rule_body_guard = {
193
193
  RULE_BODY_REASON,
194
194
  ROW,
195
- adds_rule_prose,
196
195
  answered_placement,
197
196
  is_rule_document,
198
- prose_of,
199
- runs_placement_oracle,
200
197
  writes_rule_prose,
201
198
  }
202
199
 
@@ -117,7 +117,6 @@ if (process.argv[1] === fileURLToPath(import.meta.url)) {
117
117
  }
118
118
 
119
119
  const rule_value_cli = {
120
- gather_runs,
121
120
  group_by_run,
122
121
  render,
123
122
  row,
@@ -196,7 +196,6 @@ const SHELL_BODY_REASON =
196
196
  const shell_body_trigger = {
197
197
  SHELL_BODY_REASON,
198
198
  carries_a_body,
199
- is_safe_body_form,
200
199
  is_shell_evaluated_body,
201
200
  keeps_body_safe,
202
201
  }
@@ -37,7 +37,6 @@ function is_josh_command(segment: string, names: ReadonlySet<string>): boolean {
37
37
  }
38
38
 
39
39
  const shell_segments = {
40
- SEGMENT_SEPARATOR,
41
40
  is_josh_command,
42
41
  segments_of,
43
42
  }
@@ -45,6 +45,9 @@ interface StopContext {
45
45
  hold_present: boolean
46
46
  // `git status --porcelain` came back empty.
47
47
  tree_clean: boolean
48
+ // That record carries a `prrun` stop mark (joshuafolkken/kit#3023): the run stopped at a green pull
49
+ // request and keeps the hold over a clean tree on purpose, so a person can look before it merges.
50
+ prrun_stopped: boolean
48
51
  // A `confirmation` notify is on this run's transcript tail.
49
52
  notified: boolean
50
53
  // The turn's session-facing reply text.
@@ -75,6 +78,9 @@ interface StopContext {
75
78
  // A backgrounded subagent this run launched has not finished — `lane_background.pending_agent_ids`
76
79
  // (joshuafolkken/kit#2774). Apart from `background_pending`, since only a subagent is sure to end.
77
80
  agent_pending: boolean
81
+ // This lane child handed its region to a running detached ship — `lane_handoff.is_handed_off`
82
+ // (joshuafolkken/kit#2962). The supervisor notifies on its own outcome, so nobody waits on this stop.
83
+ handed_off: boolean
78
84
  // The resolved `JOSH_SESSION_LANG` — `session_language.resolve_session_lang` (joshuafolkken/kit#2470).
79
85
  session_lang: string
80
86
  }
@@ -105,8 +111,8 @@ const HOLD_RELEASE_REASON =
105
111
  'place, so the next run here runs `git switch main && git pull` believing the tree is free while ' +
106
112
  'you hold it. `.claude/skills/workflow-commands/SKILL.md` → §2f: a stop that leaves the tree clean ' +
107
113
  'releases the hold with `pnpm josh run:release <N>` (bare for a `new` entry). A `halfrun` ' +
108
- 'pre-commit stop and a `needs-human-review` stop keep the hold because their tree is dirty — this ' +
109
- 'row is silent there. Release it, then end with a one-line confirmation that it was released — do ' +
114
+ 'pre-commit stop and a `needs-human-review` stop keep the hold because their tree is dirty, and a ' +
115
+ '`prrun` stop keeps it by its stop mark — this row is silent there. Release it, then end with a one-line confirmation that it was released — do ' +
110
116
  'not repeat your previous reply.'
111
117
 
112
118
  // **A refusal that corrects rather than advises** (joshuafolkken/kit#2247). The bare `#N` is already
@@ -232,8 +238,11 @@ function needs_filing(context: StopContext): boolean {
232
238
  // notify there says "nothing needed" and dilutes the ones that do. A backgrounded command does not
233
239
  // count: a dev server never ends, and a stop behind it would leave a person silently waiting. A lane
234
240
  // child never reaches this with a task running: `needs_background_wait` answers it first.
241
+ //
242
+ // **A lane handed to the detached ship stands them down too** (joshuafolkken/kit#2962): the hold now
243
+ // belongs to the supervisor driving the merge, and the person hears from that supervisor's own notify.
235
244
  function is_held_idle(context: StopContext): boolean {
236
- return context.hold_present && !context.agent_pending
245
+ return context.hold_present && !context.agent_pending && !context.handed_off
237
246
  }
238
247
 
239
248
  function needs_notify(context: StopContext): boolean {
@@ -241,7 +250,7 @@ function needs_notify(context: StopContext): boolean {
241
250
  }
242
251
 
243
252
  function needs_release(context: StopContext): boolean {
244
- return is_held_idle(context) && context.tree_clean
253
+ return is_held_idle(context) && context.tree_clean && !context.prrun_stopped
245
254
  }
246
255
 
247
256
  function citation_reason(context: StopContext): string | undefined {
@@ -345,7 +354,6 @@ const stop_rules = {
345
354
  STOP_NOTIFY_REASON,
346
355
  SWITCH_ENV_KEY,
347
356
  block_envelope,
348
- block_reason,
349
357
  build_language_reason,
350
358
  count_headless_refusals,
351
359
  is_enabled,
@@ -30,6 +30,6 @@ function prior_bash_commands(tail: string): ReadonlyArray<string> {
30
30
  return tail.split('\n').flatMap((line) => bash_commands_of(line))
31
31
  }
32
32
 
33
- const tail_commands = { bash_commands_of, is_bash_use, prior_bash_commands }
33
+ const tail_commands = { is_bash_use, prior_bash_commands }
34
34
 
35
35
  export { tail_commands }
@@ -46,6 +46,6 @@ const REASON =
46
46
  // reason above.
47
47
  const ROW = { id: 'test-declared', is_trigger: is_untested_commit, reason: REASON }
48
48
 
49
- const test_declared_commit = { REASON, ROW, is_untested_commit }
49
+ const test_declared_commit = { REASON, ROW }
50
50
 
51
51
  export { test_declared_commit }
@@ -83,7 +83,6 @@ const ROW = {
83
83
  const third_party_write = {
84
84
  ROW,
85
85
  THIRD_PARTY_WRITE_REASON,
86
- is_third_party_write_segment,
87
86
  writes_third_party,
88
87
  }
89
88
 
@@ -36,8 +36,8 @@ function is_worktree_checkout(args: ReadonlyArray<string>): boolean {
36
36
  }
37
37
 
38
38
  // `git restore <path>` discards working-tree changes. `--staged` / `-S` alone is an index restore —
39
- // that is the deny list's territory (`git restore --staged*` / `-S*`), so a pure index restore is not
40
- // refused twice. Anything touching the worktree (the default, or an explicit `--worktree` / `-W`) is.
39
+ // that is the `index-mutation` row's (`index-guard.ts`), so a pure index restore is not claimed by two
40
+ // rows. Anything touching the worktree (the default, or an explicit `--worktree` / `-W`) is this row's.
41
41
  const STAGED_LONG = '--staged'
42
42
  const STAGED_LETTER = 'S'
43
43
  const WORKTREE_LONG = '--worktree'
@@ -83,14 +83,33 @@ function is_unauthorized_stash(args: ReadonlyArray<string>): boolean {
83
83
  return true
84
84
  }
85
85
 
86
+ // `git clean` deletes untracked files, which no commit can bring back (joshuafolkken/kit#2983). It
87
+ // refuses to act without a force (`clean.requireForce`), so a force — `--force`, or a cluster carrying
88
+ // `f` — is what marks the destructive call; `git clean -n` is a dry run and passes.
89
+ const CLEAN_SUBCOMMAND = 'clean'
90
+ const FORCE_LONG = '--force'
91
+ const FORCE_LETTER = 'f'
92
+
93
+ function is_forced_clean(args: ReadonlyArray<string>): boolean {
94
+ return args.some(
95
+ (argument) => argument === FORCE_LONG || git_argv.short_cluster_has(argument, FORCE_LETTER),
96
+ )
97
+ }
98
+
99
+ // Each subcommand this row judges, with the predicate that reads its arguments.
100
+ const JUDGED_SUBCOMMANDS: ReadonlyMap<string, (args: ReadonlyArray<string>) => boolean> = new Map([
101
+ [CHECKOUT_SUBCOMMAND, is_worktree_checkout],
102
+ [RESTORE_SUBCOMMAND, touches_worktree],
103
+ [CLEAN_SUBCOMMAND, is_forced_clean],
104
+ [STASH_SUBCOMMAND, is_unauthorized_stash],
105
+ ])
106
+
86
107
  function is_unauthorized_segment(segment: string): boolean {
87
108
  const call = git_argv.parse(segment)
88
109
 
89
110
  if (call === undefined) return false
90
- if (call.subcommand === CHECKOUT_SUBCOMMAND) return is_worktree_checkout(call.args)
91
- if (call.subcommand === RESTORE_SUBCOMMAND) return touches_worktree(call.args)
92
111
 
93
- return call.subcommand === STASH_SUBCOMMAND && is_unauthorized_stash(call.args)
112
+ return JUDGED_SUBCOMMANDS.get(call.subcommand ?? '')?.(call.args) === true
94
113
  }
95
114
 
96
115
  function is_unauthorized_worktree_change(command: string): boolean {
@@ -101,8 +120,8 @@ function is_unauthorized_worktree_change(command: string): boolean {
101
120
  // and — for a stash — the message form that is allowed. `pnpm josh git` and `pnpm josh stash:pop` are
102
121
  // invisible to this trigger, so a run that uses them is never refused.
103
122
  const WORKTREE_MUTATION_REASON =
104
- '⛔ unauthorized working-tree change: `git checkout -- <path>`, `git restore <path>` and an ' +
105
- 'unauthorized `git stash` mutate the working tree or the repository-wide stash every work tree ' +
123
+ '⛔ unauthorized working-tree change: `git checkout -- <path>`, `git restore <path>`, a forced ' +
124
+ '`git clean` and an unauthorized `git stash` discard work or mutate the repository-wide stash every work tree ' +
106
125
  'shares, and none is on the `.claude/settings.json` deny list (`operating-rules.md`). Do not run ' +
107
126
  'them on your own judgement. A commit goes through `pnpm josh git`; a stash pop goes through `pnpm ' +
108
127
  'josh stash:pop "<message>"`, never a positional `git stash pop` a shared stack lets another lane ' +
@@ -121,9 +140,7 @@ const ROW = {
121
140
  const worktree_guard = {
122
141
  ROW,
123
142
  WORKTREE_MUTATION_REASON,
124
- is_unauthorized_stash,
125
143
  is_unauthorized_worktree_change,
126
- is_worktree_checkout,
127
144
  touches_worktree,
128
145
  }
129
146
 
@@ -447,11 +447,9 @@ const run_carry_cli = {
447
447
  RESUMED_VERDICT,
448
448
  STANDING_VERDICT,
449
449
  UNKNOWN_VERDICT,
450
- UNREADABLE_VERDICT,
451
450
  // Re-exported rather than restated: the usage line belongs to the half that parses, and a second
452
451
  // copy of it here would drift from the flags it describes.
453
452
  USAGE: run_carry_args.USAGE,
454
- main,
455
453
  run,
456
454
  }
457
455
 
@@ -1,5 +1,5 @@
1
- import { git_stash } from '#scripts/git/git-stash'
2
- import { stash_orphans } from '#scripts/git/stash-orphans'
1
+ import { git_stash } from '#scripts/git/stash/git-stash'
2
+ import { stash_orphans } from '#scripts/git/stash/stash-orphans'
3
3
  import { issue_state_cli } from '#scripts/issue/issue-state-cli'
4
4
  import { bounded_pool } from '#scripts/lib/bounded-pool'
5
5
 
@@ -107,7 +107,7 @@ function next_state(carry: StreakCarry, change: StreakChange, now: Date): Streak
107
107
  }
108
108
  }
109
109
 
110
- const run_carry_streak = { OUTAGE_FOLD_WINDOW_MS, next_state }
110
+ const run_carry_streak = { next_state }
111
111
 
112
112
  export type { StreakCarry, StreakChange, StreakState }
113
113
  export { run_carry_streak }
@@ -45,8 +45,6 @@ const {
45
45
  STALE_VERDICT,
46
46
  SUCCESS_EXIT_CODE,
47
47
  UNDER_THRESHOLD_VERDICT,
48
- UNKNOWN_VERDICT,
49
- UNREADABLE_VERDICT,
50
48
  UNREADY_VERDICT,
51
49
  refuse_unready,
52
50
  report,
@@ -423,18 +421,13 @@ const run_cut_cli = {
423
421
  FAILED_VERDICT,
424
422
  FRESH_VERDICT,
425
423
  HANDED_OFF_VERDICT,
426
- INCOMPLETE_VERDICT,
427
424
  NOT_A_LANE_VERDICT,
428
425
  OVER_VERDICT,
429
426
  RESUME_IMPL_VERDICT,
430
427
  RESUME_VERDICT,
431
428
  STALE_VERDICT,
432
429
  UNDER_THRESHOLD_VERDICT,
433
- UNKNOWN_VERDICT,
434
- UNREADABLE_VERDICT,
435
430
  UNREADY_VERDICT,
436
- USAGE: run_cut_args.USAGE,
437
- main,
438
431
  run,
439
432
  }
440
433
 
@@ -1,10 +1,8 @@
1
- import { execFileSync } from 'node:child_process'
2
1
  import { agent_role_profile } from '#scripts/agent/agent-role-profile'
3
2
  import { backlog_budget } from '#scripts/backlog/backlog-budget'
4
3
  import { CONTEXT_CUT_THRESHOLD } from '#scripts/cost-runtime/context-cut-threshold'
5
- import { git_utilities } from '#scripts/git/constants'
6
4
  import { git_command } from '#scripts/git/git-command'
7
- import { git_location_environment } from '#scripts/git/git-location-environment'
5
+ import { git_common_directory } from '#scripts/git/git-common-directory'
8
6
  import { stamp_file } from '#scripts/josh/stamp-file'
9
7
  import { lane_child_invocation } from '#scripts/lane/lane-child-invocation'
10
8
  import { z } from 'zod'
@@ -60,14 +58,6 @@ const IMPLEMENTATION_CONTEXT_THRESHOLD = CONTEXT_CUT_THRESHOLD
60
58
  const CUT_MAX_AGE_MS = backlog_budget.WHOLE_RUN_BUDGET_MS
61
59
  const CUT_MAX_AGE_HOURS = backlog_budget.WHOLE_RUN_BUDGET_HOURS
62
60
 
63
- // The synchronous git read runs inside a `PreToolUse` hook, which holds the tool call for as long as
64
- // it takes; `rev-parse` takes no lock, so anything past a second is a fault rather than slow work.
65
- const GIT_READ_TIMEOUT_MS = 5000
66
-
67
- // The two lines `GIT_DIRECTORY_ARGUMENTS` prints, in order: the work tree's own git directory, then the
68
- // common one every lane of a repository shares. `git_directories` reads the same two asynchronously.
69
- const WORKTREE_DIRECTORY_INDEX = 0
70
-
71
61
  const END_COMMAND = 'pnpm josh run:cut --end'
72
62
  const READ_COMMAND = 'pnpm josh run:cut --json'
73
63
 
@@ -224,10 +214,10 @@ function read_cut(target: string, now: Date = new Date()): CutRead {
224
214
 
225
215
  // **The same read as `read_cut(cut_path(await worktree_directory()))`, taken synchronously**
226
216
  // (joshuafolkken/kit#1864). The pre-gate cut is enforced from a `PreToolUse` guard, and a guard
227
- // answers synchronously or not at all — so the one git call the path derivation needs is made here
228
- // with `git_command.GIT_DIRECTORY_ARGUMENTS`, the same argument list the asynchronous reader uses,
229
- // rather than a second spelling of it. Everything after the path is already shared: `cut_path` keys
230
- // the record and `classify` parses and expires it.
217
+ // answers synchronously or not at all — so the one git call the path derivation needs is
218
+ // `git_common_directory.own()`, the synchronous twin of the asynchronous reader, rather than a second
219
+ // spelling of it. Everything after the path is already shared: `cut_path` keys the record and
220
+ // `classify` parses and expires it.
231
221
  //
232
222
  // **A fault reads as "no cut was taken", and that direction is deliberate rather than fail-open.** A
233
223
  // checkout git cannot describe, a record that will not parse and an expired one all come back
@@ -235,47 +225,11 @@ function read_cut(target: string, now: Date = new Date()): CutRead {
235
225
  // The alternative errs the other way: a read fault would be taken for "already cut" and the guard
236
226
  // would go quiet on exactly the run it exists for. The cost of this direction is one refusal a lane
237
227
  // can answer by reissuing, since that row is delivered once per run.
238
- function git_directories_sync(cwd?: string): ReadonlyArray<string> {
239
- try {
240
- // The binary is resolved through `git_utilities` exactly as `git-spawn.ts` resolves it, so this
241
- // call does not answer to whatever `PATH` happens to hold. It runs the binary directly with an
242
- // argument array and no `shell` option, and both are internally controlled, never untrusted
243
- // input.
244
- const output = execFileSync(
245
- git_utilities.get_git_command_for_spawn(),
246
- [...git_command.GIT_DIRECTORY_ARGUMENTS],
247
- // git's own diagnostics are discarded: a checkout it cannot describe is already the
248
- // `undefined` below, and a hook that let `fatal: not a git repository` through would print it
249
- // in front of a tool call that is about to be allowed.
250
- // A `PreToolUse` hook holds the tool call while it runs, so the read is bounded rather than
251
- // left to whatever git does.
252
- // `cwd` is set only by `lane_cut_sync`, which reads another lane's record from the parent.
253
- // With a `cwd`, the git location variables are cleared so it is what git answers for: a hook
254
- // exports `GIT_DIR`, which beats `cwd` and would name the hook's checkout instead
255
- // (joshuafolkken/kit#2515). Without one the environment is kept, so this read resolves the same
256
- // checkout as the asynchronous `git_directories` that writes the record.
257
- {
258
- cwd,
259
- env:
260
- cwd === undefined
261
- ? process.env
262
- : { ...process.env, ...git_location_environment.location_free_environment() },
263
- encoding: 'utf8',
264
- stdio: ['ignore', 'pipe', 'ignore'],
265
- timeout: GIT_READ_TIMEOUT_MS,
266
- },
267
- ) // NOSONAR
268
-
269
- return output.split('\n').filter((line) => line !== '')
270
- } catch {
271
- return []
272
- }
273
- }
274
-
228
+ //
275
229
  // The work tree's own git directory (index 0), the same read `git_directories` makes asynchronously —
276
230
  // the record and the pre-gate guard both key on it.
277
231
  function worktree_git_directory_sync(): string | undefined {
278
- return git_directories_sync()[WORKTREE_DIRECTORY_INDEX]
232
+ return git_common_directory.own()
279
233
  }
280
234
 
281
235
  // **The directory is injectable so a test never has to write to the live record.** Keyed to the work
@@ -297,7 +251,7 @@ function carried_cut_sync(
297
251
  // lane's own git directory, so the parent — standing in the main checkout — resolves that directory
298
252
  // from the lane's path rather than its own, and gets the record path back to mark it.
299
253
  function lane_cut_sync(lane_directory: string): { target: string; cut: RunCut } | undefined {
300
- const directory = git_directories_sync(lane_directory)[WORKTREE_DIRECTORY_INDEX]
254
+ const directory = git_common_directory.own(lane_directory)
301
255
 
302
256
  if (directory === undefined) return undefined
303
257
 
@@ -101,7 +101,7 @@ async function main(argv: ReadonlyArray<string>): Promise<void> {
101
101
  process.exitCode = await run(argv)
102
102
  }
103
103
 
104
- const run_ending_cli = { USAGE, main, parse_request, run }
104
+ const run_ending_cli = { USAGE, parse_request, run }
105
105
 
106
106
  if (process.argv[1] === fileURLToPath(import.meta.url)) await main(process.argv.slice(ARGV_OFFSET))
107
107
 
@@ -2,7 +2,7 @@ import { readFileSync } from 'node:fs'
2
2
  import { agent_exit_record } from '#scripts/agent/agent-exit-record'
3
3
  import { api_outage } from '#scripts/agent/api-outage'
4
4
  import type { ClaudeResultEvent } from '#scripts/agent/claude-result-event'
5
- import { git_gh_issue_read } from '#scripts/git/git-gh-issue-read'
5
+ import { git_gh_issue_read } from '#scripts/gh/git-gh-issue-read'
6
6
  import { issue_state } from '#scripts/issue/issue-state'
7
7
  import { run_cut } from './run-cut'
8
8
  import { run_hold } from './run-hold'
@@ -222,9 +222,6 @@ async function check(request: EndingRequest): Promise<EndingDecision> {
222
222
  const run_ending = {
223
223
  check,
224
224
  decide,
225
- describe_exit,
226
- read_child_closed,
227
- read_cut_taken,
228
225
  read_exit,
229
226
  }
230
227