@cbartens/bkit 0.0.0-stage → 5.0.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 (373) hide show
  1. package/.bkit/README.md +421 -0
  2. package/.bkit/core/.agents/context.md +95 -0
  3. package/.bkit/core/.agents/docs.md +62 -0
  4. package/.bkit/core/.agents/rules.md +147 -0
  5. package/.bkit/core/.agents/skills.md +43 -0
  6. package/.bkit/core/.bkit/LICENSE.md +151 -0
  7. package/.bkit/core/.bkit/README.md +421 -0
  8. package/.bkit/core/.bkit/cloud.md +502 -0
  9. package/.bkit/core/.bkit/comparison.md +318 -0
  10. package/.bkit/core/.bkit/install.md +496 -0
  11. package/.bkit/core/.bkit/jsonl.md +497 -0
  12. package/.bkit/core/.bkit/prompts.md +474 -0
  13. package/.bkit/core/.bkit/providers.md +598 -0
  14. package/.bkit/core/.bkit/templates.md +471 -0
  15. package/.bkit/core/.bkit/trackers.md +95 -0
  16. package/.bkit/core/.bkit/workflows.md +1546 -0
  17. package/.bkit/core/.claude/hooks/bkit-gateguard.cjs +82 -0
  18. package/.bkit/core/.claude/hooks/bkit-guardrails.cjs +93 -0
  19. package/.bkit/core/.claude/hooks/bkit-preflight.sh +74 -0
  20. package/.bkit/core/.codex/hooks/bkit-gateguard.cjs +115 -0
  21. package/.bkit/core/.codex/hooks/bkit-guardrails.cjs +135 -0
  22. package/.bkit/core/.cursor/hooks/bkit-gateguard.cjs +111 -0
  23. package/.bkit/core/.cursor/hooks/bkit-guardrails.cjs +169 -0
  24. package/.bkit/core/.cursor/hooks/bkit-preflight.sh +63 -0
  25. package/.bkit/core/.opencode/plugin/bkit-gateguard.js +225 -0
  26. package/.bkit/core/AGENTS.md +77 -0
  27. package/.bkit/core/LICENSE.md +149 -0
  28. package/.bkit/core/docs/templates/bkit-audit-accessibility.md +272 -0
  29. package/.bkit/core/docs/templates/bkit-audit-adoption.md +223 -0
  30. package/.bkit/core/docs/templates/bkit-audit-agents.md +230 -0
  31. package/.bkit/core/docs/templates/bkit-audit-aio-seo.md +227 -0
  32. package/.bkit/core/docs/templates/bkit-audit-analytics.md +266 -0
  33. package/.bkit/core/docs/templates/bkit-audit-annotations.md +230 -0
  34. package/.bkit/core/docs/templates/bkit-audit-app-performance.md +270 -0
  35. package/.bkit/core/docs/templates/bkit-audit-app-store.md +254 -0
  36. package/.bkit/core/docs/templates/bkit-audit-architecture.md +221 -0
  37. package/.bkit/core/docs/templates/bkit-audit-ci-performance.md +241 -0
  38. package/.bkit/core/docs/templates/bkit-audit-config.md +230 -0
  39. package/.bkit/core/docs/templates/bkit-audit-cost.md +218 -0
  40. package/.bkit/core/docs/templates/bkit-audit-coverage.md +221 -0
  41. package/.bkit/core/docs/templates/bkit-audit-database.md +229 -0
  42. package/.bkit/core/docs/templates/bkit-audit-dead-code.md +251 -0
  43. package/.bkit/core/docs/templates/bkit-audit-deferrals.md +283 -0
  44. package/.bkit/core/docs/templates/bkit-audit-dependencies.md +268 -0
  45. package/.bkit/core/docs/templates/bkit-audit-documentation.md +280 -0
  46. package/.bkit/core/docs/templates/bkit-audit-duplication.md +253 -0
  47. package/.bkit/core/docs/templates/bkit-audit-failures.md +259 -0
  48. package/.bkit/core/docs/templates/bkit-audit-flakes.md +237 -0
  49. package/.bkit/core/docs/templates/bkit-audit-gates.md +250 -0
  50. package/.bkit/core/docs/templates/bkit-audit-issues.md +273 -0
  51. package/.bkit/core/docs/templates/bkit-audit-llm.md +239 -0
  52. package/.bkit/core/docs/templates/bkit-audit-logs.md +266 -0
  53. package/.bkit/core/docs/templates/bkit-audit-models.md +210 -0
  54. package/.bkit/core/docs/templates/bkit-audit-privacy.md +211 -0
  55. package/.bkit/core/docs/templates/bkit-audit-prompts.md +216 -0
  56. package/.bkit/core/docs/templates/bkit-audit-red-team.md +220 -0
  57. package/.bkit/core/docs/templates/bkit-audit-reliability.md +222 -0
  58. package/.bkit/core/docs/templates/bkit-audit-repo.md +224 -0
  59. package/.bkit/core/docs/templates/bkit-audit-security.md +274 -0
  60. package/.bkit/core/docs/templates/bkit-audit-slop.md +200 -0
  61. package/.bkit/core/docs/templates/bkit-audit-testing.md +270 -0
  62. package/.bkit/core/docs/templates/bkit-audit-usability.md +237 -0
  63. package/.bkit/core/docs/templates/bkit-plan.md +476 -0
  64. package/.bkit/core/engine/checks/after/auth.ts +247 -0
  65. package/.bkit/core/engine/checks/after/ci-yml.ts +739 -0
  66. package/.bkit/core/engine/checks/after/github.ts +424 -0
  67. package/.bkit/core/engine/checks/after/index.ts +556 -0
  68. package/.bkit/core/engine/checks/after/managed.ts +217 -0
  69. package/.bkit/core/engine/checks/after/tools.ts +427 -0
  70. package/.bkit/core/engine/checks/after/vercel.ts +101 -0
  71. package/.bkit/core/engine/checks/before/context-fetch.ts +429 -0
  72. package/.bkit/core/engine/checks/before/env.ts +201 -0
  73. package/.bkit/core/engine/checks/before/files.ts +202 -0
  74. package/.bkit/core/engine/checks/before/index.ts +206 -0
  75. package/.bkit/core/engine/checks/before/mcp.ts +127 -0
  76. package/.bkit/core/engine/checks/before/repo.ts +77 -0
  77. package/.bkit/core/engine/checks/before/version.ts +67 -0
  78. package/.bkit/core/engine/checks/status-holes.ts +479 -0
  79. package/.bkit/core/engine/cli.ts +871 -0
  80. package/.bkit/core/engine/commands/analysis.ts +550 -0
  81. package/.bkit/core/engine/commands/ci/ci.ts +483 -0
  82. package/.bkit/core/engine/commands/comply.ts +415 -0
  83. package/.bkit/core/engine/commands/harvest.ts +459 -0
  84. package/.bkit/core/engine/commands/install/check.ts +70 -0
  85. package/.bkit/core/engine/commands/install/doctor.ts +247 -0
  86. package/.bkit/core/engine/commands/install/install.ts +528 -0
  87. package/.bkit/core/engine/commands/install/uninstall.ts +972 -0
  88. package/.bkit/core/engine/commands/install/upgrade.ts +1026 -0
  89. package/.bkit/core/engine/commands/launch.ts +139 -0
  90. package/.bkit/core/engine/commands/lib.ts +494 -0
  91. package/.bkit/core/engine/commands/registry.ts +53 -0
  92. package/.bkit/core/engine/commands/setup/setup.ts +184 -0
  93. package/.bkit/core/engine/commands/telemetry.ts +32 -0
  94. package/.bkit/core/engine/commands/workflow/branches.ts +1514 -0
  95. package/.bkit/core/engine/commands/workflow/context.ts +961 -0
  96. package/.bkit/core/engine/commands/workflow/counters.ts +268 -0
  97. package/.bkit/core/engine/commands/workflow/fids.ts +243 -0
  98. package/.bkit/core/engine/commands/workflow/issues.ts +675 -0
  99. package/.bkit/core/engine/commands/workflow/ledgers.ts +575 -0
  100. package/.bkit/core/engine/commands/workflow/locks.ts +478 -0
  101. package/.bkit/core/engine/commands/workflow/prs.ts +1087 -0
  102. package/.bkit/core/engine/commands/workflow/repo.ts +220 -0
  103. package/.bkit/core/engine/commands/workflow/roadmap.ts +576 -0
  104. package/.bkit/core/engine/commands/workflow/runs.ts +2140 -0
  105. package/.bkit/core/engine/commands/workflow/runtime.ts +300 -0
  106. package/.bkit/core/engine/commands/workflow/skills.ts +118 -0
  107. package/.bkit/core/engine/commands/workflow/status.ts +455 -0
  108. package/.bkit/core/engine/commands/workflow/steps.ts +1300 -0
  109. package/.bkit/core/engine/commands/workflow/tests.ts +161 -0
  110. package/.bkit/core/engine/commands/workflow/workflows.ts +1573 -0
  111. package/.bkit/core/engine/commands/workflow/workstreams.ts +164 -0
  112. package/.bkit/core/engine/commands/workflow/worktrees.ts +534 -0
  113. package/.bkit/core/engine/install/cloud-env.ts +925 -0
  114. package/.bkit/core/engine/install/managed-block.ts +212 -0
  115. package/.bkit/core/engine/install/manifest.ts +448 -0
  116. package/.bkit/core/engine/install/modules/claude.ts +362 -0
  117. package/.bkit/core/engine/install/modules/cloud.ts +174 -0
  118. package/.bkit/core/engine/install/modules/codex.ts +219 -0
  119. package/.bkit/core/engine/install/modules/core.ts +600 -0
  120. package/.bkit/core/engine/install/modules/cursor.ts +231 -0
  121. package/.bkit/core/engine/install/modules/index.ts +242 -0
  122. package/.bkit/core/engine/install/modules/opencode.ts +573 -0
  123. package/.bkit/core/engine/install/placeholders.ts +108 -0
  124. package/.bkit/core/engine/install/template-copies.ts +119 -0
  125. package/.bkit/core/engine/install/version-file.ts +284 -0
  126. package/.bkit/core/engine/install/write.ts +467 -0
  127. package/.bkit/core/engine/ledgers/clamp-log.ts +32 -0
  128. package/.bkit/core/engine/ledgers/status.ts +213 -0
  129. package/.bkit/core/engine/ledgers/telemetry.ts +1143 -0
  130. package/.bkit/core/engine/render/hosts.ts +372 -0
  131. package/.bkit/core/engine/render/models.ts +323 -0
  132. package/.bkit/core/engine/render/parts.ts +38 -0
  133. package/.bkit/core/engine/render/trackers.ts +170 -0
  134. package/.bkit/core/engine/shared/egress.ts +345 -0
  135. package/.bkit/core/engine/shared/json.ts +16 -0
  136. package/.bkit/core/engine/shared/log-prefix.ts +9 -0
  137. package/.bkit/core/engine/shared/package-json.ts +29 -0
  138. package/.bkit/core/engine/shared/package-manager.ts +38 -0
  139. package/.bkit/core/engine/shared/package-roots.ts +163 -0
  140. package/.bkit/core/engine/shared/protected-paths.ts +164 -0
  141. package/.bkit/core/engine/shared/settings.ts +72 -0
  142. package/.bkit/core/engine/shared/timeouts.ts +20 -0
  143. package/.bkit/core/engine/tools/wording.ts +748 -0
  144. package/.bkit/core/hooks/gateguard-edit-payload.js +18 -0
  145. package/.bkit/core/hooks/gateguard-engine.js +193 -0
  146. package/.bkit/core/hooks/guardrails-shell.js +154 -0
  147. package/.bkit/core/hooks/guardrails-tiers.js +68 -0
  148. package/.bkit/core/hooks/preflight-linear.sh +73 -0
  149. package/.bkit/core/prompts/bkit-audit-generate.md +66 -0
  150. package/.bkit/core/prompts/bkit-build-challenge-1.md +79 -0
  151. package/.bkit/core/prompts/bkit-build-challenge-2.md +81 -0
  152. package/.bkit/core/prompts/bkit-build-challenge-reconcile.md +68 -0
  153. package/.bkit/core/prompts/bkit-build-challenge-remediate.md +70 -0
  154. package/.bkit/core/prompts/bkit-build-challenge-tests.md +73 -0
  155. package/.bkit/core/prompts/bkit-build-install-skills.md +67 -0
  156. package/.bkit/core/prompts/bkit-build-plan-current.md +75 -0
  157. package/.bkit/core/prompts/bkit-build-plan-execute.md +72 -0
  158. package/.bkit/core/prompts/bkit-build-plan-gaps-remediate.md +73 -0
  159. package/.bkit/core/prompts/bkit-build-plan-verify.md +88 -0
  160. package/.bkit/core/prompts/bkit-build-summary.md +93 -0
  161. package/.bkit/core/prompts/bkit-debug-abort-handover.md +90 -0
  162. package/.bkit/core/prompts/bkit-debug-failure-diagnose.md +151 -0
  163. package/.bkit/core/prompts/bkit-debug-failure-remediate.md +78 -0
  164. package/.bkit/core/prompts/bkit-debug-failure-soak.md +73 -0
  165. package/.bkit/core/prompts/bkit-debug-summary.md +95 -0
  166. package/.bkit/core/prompts/bkit-design-brainstorm-ideate-1.md +72 -0
  167. package/.bkit/core/prompts/bkit-design-brainstorm-ideate-2.md +72 -0
  168. package/.bkit/core/prompts/bkit-design-brainstorm-ideate-3.md +75 -0
  169. package/.bkit/core/prompts/bkit-design-generate.md +110 -0
  170. package/.bkit/core/prompts/bkit-design-organise.md +85 -0
  171. package/.bkit/core/prompts/bkit-design-review-1.md +121 -0
  172. package/.bkit/core/prompts/bkit-design-review-2.md +111 -0
  173. package/.bkit/core/prompts/bkit-design-spike.md +97 -0
  174. package/.bkit/core/prompts/bkit-design-summary.md +106 -0
  175. package/.bkit/core/prompts/bkit-design-update.md +66 -0
  176. package/.bkit/core/prompts/bkit-plan-complexity-check.md +66 -0
  177. package/.bkit/core/prompts/bkit-plan-complexity-split.md +87 -0
  178. package/.bkit/core/prompts/bkit-plan-generate.md +74 -0
  179. package/.bkit/core/prompts/bkit-plan-review-1.md +90 -0
  180. package/.bkit/core/prompts/bkit-plan-review-2.md +80 -0
  181. package/.bkit/core/prompts/bkit-plan-review-3.md +92 -0
  182. package/.bkit/core/prompts/bkit-plan-scope-check-1.md +84 -0
  183. package/.bkit/core/prompts/bkit-plan-scope-check-2.md +84 -0
  184. package/.bkit/core/prompts/bkit-plan-summary.md +106 -0
  185. package/.bkit/core/prompts/bkit-plan-update.md +68 -0
  186. package/.bkit/core/prompts/bkit-ship-conflict-resolve.md +90 -0
  187. package/.bkit/core/prompts/bkit-ship-deferred-sweep.md +94 -0
  188. package/.bkit/core/prompts/bkit-ship-summary.md +77 -0
  189. package/.bkit/core/prompts/bkit-ship-update-docs.md +71 -0
  190. package/.bkit/core/prompts/bkit-utility-compress-markdown.md +91 -0
  191. package/.bkit/core/prompts/bkit-utility-update-decisions.md +75 -0
  192. package/.bkit/core/prompts/bkit-utility-update-deferrals.md +76 -0
  193. package/.bkit/core/prompts/bkit-utility-update-documentation.md +61 -0
  194. package/.bkit/core/prompts/bkit-utility-update-failures.md +76 -0
  195. package/.bkit/core/prompts/bkit-utility-update-knowledge.md +75 -0
  196. package/.bkit/core/prompts/bkit-utility-update-roadmap.md +82 -0
  197. package/.bkit/core/workflows/bkit-auto.md +121 -0
  198. package/.bkit/core/workflows/bkit-build.md +802 -0
  199. package/.bkit/core/workflows/bkit-debug.md +642 -0
  200. package/.bkit/core/workflows/bkit-design.md +495 -0
  201. package/.bkit/core/workflows/bkit-plan.md +510 -0
  202. package/.bkit/core/workflows/bkit-ship.md +650 -0
  203. package/.bkit/shared/.bkit/.env.example +108 -0
  204. package/.bkit/shared/.claude/bkit-cloud.md +117 -0
  205. package/.bkit/shared/.claude/settings.json +88 -0
  206. package/.bkit/shared/.codex/hooks.json +26 -0
  207. package/.bkit/shared/.cursor/bkit-cloud.md +84 -0
  208. package/.bkit/shared/.cursor/hooks.json +26 -0
  209. package/.bkit/shared/.cursor/mcp.json +15 -0
  210. package/.bkit/shared/.cursor/rules/bkit-rules.mdc +12 -0
  211. package/.bkit/shared/.gitattributes +37 -0
  212. package/.bkit/shared/.mcp.json +16 -0
  213. package/.bkit/shared/.opencode/opencode.json +62 -0
  214. package/.bkit/shared/CLAUDE.md +11 -0
  215. package/.bkit/shared/LICENSE.md +22 -0
  216. package/.bkit/shared/docs/architecture.md +19 -0
  217. package/.bkit/shared/docs/data-schema.md +19 -0
  218. package/.bkit/shared/docs/deployments.md +438 -0
  219. package/.bkit/shared/docs/design.md +39 -0
  220. package/.bkit/shared/docs/noise.md +19 -0
  221. package/.bkit/shared/docs/observability.md +25 -0
  222. package/.bkit/shared/docs/security.md +42 -0
  223. package/.bkit/shared/docs/setup.md +30 -0
  224. package/.bkit/shared/docs/technology.md +18 -0
  225. package/.bkit/shared/docs/testing.md +413 -0
  226. package/.bkit/shared/gitignore +92 -0
  227. package/.bkit/templates/.claude/hooks/bkit-cloud-bootstrap.sh +192 -0
  228. package/.bkit/templates/.cursor/Dockerfile +68 -0
  229. package/.bkit/templates/.cursor/environment.json +6 -0
  230. package/.bkit/templates/.cursor/settings.json +11 -0
  231. package/.bkit/templates/.envrc +7 -0
  232. package/.bkit/templates/.github/dependabot.yml +52 -0
  233. package/.bkit/templates/.github/renovate.json5 +239 -0
  234. package/.bkit/templates/.github/workflows/bkit-ci.yml +1082 -0
  235. package/.bkit/templates/.github/workflows/bkit-cloud.yml +566 -0
  236. package/.bkit/templates/.github/workflows/bkit-renovate.yml +107 -0
  237. package/.bkit/templates/.graphifyignore +108 -0
  238. package/.bkit/templates/.husky/pre-commit +16 -0
  239. package/.bkit/templates/.husky/pre-push +91 -0
  240. package/.bkit/templates/.lintstagedrc.json +3 -0
  241. package/.bkit/templates/.prettierignore +41 -0
  242. package/.bkit/templates/.serena/project.yml +243 -0
  243. package/.bkit/templates/.vale/styles/House/Filler.yml +11 -0
  244. package/.bkit/templates/.vale/styles/House/Hedging.yml +12 -0
  245. package/.bkit/templates/.vale/styles/House/LLMSlop.yml +13 -0
  246. package/.bkit/templates/.vale/styles/House/Verbose.yml +12 -0
  247. package/.bkit/templates/.vale.ini +67 -0
  248. package/.bkit/templates/LICENSE.md +22 -0
  249. package/.bkit/templates/context/bkit-cloudrun.md +84 -0
  250. package/.bkit/templates/context/bkit-expo.md +186 -0
  251. package/.bkit/templates/context/bkit-github.md +79 -0
  252. package/.bkit/templates/context/bkit-inngest.md +45 -0
  253. package/.bkit/templates/context/bkit-maestro.md +76 -0
  254. package/.bkit/templates/context/bkit-playwright.md +62 -0
  255. package/.bkit/templates/context/bkit-resend.md +36 -0
  256. package/.bkit/templates/context/bkit-sentry.md +65 -0
  257. package/.bkit/templates/context/bkit-serena.md +33 -0
  258. package/.bkit/templates/context/bkit-stripe.md +36 -0
  259. package/.bkit/templates/context/bkit-supabase.md +59 -0
  260. package/.bkit/templates/context/bkit-tavily.md +49 -0
  261. package/.bkit/templates/context/bkit-vercel.md +64 -0
  262. package/.bkit/templates/docs/capabilities.md +72 -0
  263. package/.bkit/templates/scripts/ci/accepted-divergences.json +21 -0
  264. package/.bkit/templates/scripts/ci/check-accepted-divergences.mjs +152 -0
  265. package/.bkit/templates/scripts/ci/check-accepted-divergences.test.mjs +130 -0
  266. package/.bkit/templates/scripts/ci/lanes/resolve-push-base.mjs +98 -0
  267. package/.bkit/templates/scripts/ci/lanes/resolve-push-base.test.mjs +86 -0
  268. package/.bkit/templates/scripts/graphify/bkit-graph-drift-rules.json +23 -0
  269. package/.bkit/templates/scripts/graphify/bkit-graph-drift.py +208 -0
  270. package/.bkit/templates/scripts/graphify/bkit-graph-eager-rules.json +35 -0
  271. package/.bkit/templates/scripts/graphify/bkit-graph-eager.py +236 -0
  272. package/.bkit/templates/scripts/graphify/bkit-graph-external-rules.json +17 -0
  273. package/.bkit/templates/scripts/graphify/bkit-graph-imports.py +290 -0
  274. package/.bkit/templates/scripts/graphify/bkit-graph-pre-push.sh +19 -0
  275. package/.bkit/templates/scripts/graphify/bkit-graph-repair.py +120 -0
  276. package/.bkit/templates/scripts/graphify/bkit-graph-surface.py +232 -0
  277. package/.bkit/templates/scripts/graphify/bkit-graphify-graphml.py +36 -0
  278. package/.bkit/templates/scripts/graphify/bkit-graphify-rollup.py +927 -0
  279. package/.bkit/templates/scripts/graphify/bkit-graphify.sh +351 -0
  280. package/.bkit/templates/scripts/launchd/ai.bkit.launchd.plist +26 -0
  281. package/.bkit/templates/scripts/launchd/bkit-launchd-env.sh +53 -0
  282. package/.bkit/templates/scripts/launchd/launchd.env.example +13 -0
  283. package/.bkit/templates/scripts/prettier/bkit-insert-ignore.mjs +275 -0
  284. package/.bkit/templates/scripts/secrets/bkit-secrets.config.mjs +66 -0
  285. package/.bkit/templates/scripts/secrets/bkit-secrets.mjs +785 -0
  286. package/.bkit/templates/scripts/serena/bkit-serena-mcp.sh +30 -0
  287. package/.bkit/templates/scripts/serena/bkit-serena.mcp.json +9 -0
  288. package/.bkit/templates/scripts/slop/bkit-slop-type-suppression.mjs +286 -0
  289. package/.bkit/templates/slop-scan.config.json +120 -0
  290. package/CHANGELOG.md +1486 -0
  291. package/LICENSE.md +161 -0
  292. package/README.md +185 -2
  293. package/dist/checks/after/auth.js +232 -0
  294. package/dist/checks/after/ci-yml.js +718 -0
  295. package/dist/checks/after/github.js +400 -0
  296. package/dist/checks/after/index.js +447 -0
  297. package/dist/checks/after/managed.js +187 -0
  298. package/dist/checks/after/tools.js +351 -0
  299. package/dist/checks/after/vercel.js +102 -0
  300. package/dist/checks/before/context-fetch.js +426 -0
  301. package/dist/checks/before/env.js +173 -0
  302. package/dist/checks/before/files.js +185 -0
  303. package/dist/checks/before/index.js +162 -0
  304. package/dist/checks/before/mcp.js +111 -0
  305. package/dist/checks/before/repo.js +71 -0
  306. package/dist/checks/before/version.js +60 -0
  307. package/dist/checks/status-holes.js +393 -0
  308. package/dist/cli.js +692 -0
  309. package/dist/commands/analysis.js +325 -0
  310. package/dist/commands/ci/ci.js +438 -0
  311. package/dist/commands/comply.js +310 -0
  312. package/dist/commands/harvest.js +354 -0
  313. package/dist/commands/install/check.js +61 -0
  314. package/dist/commands/install/doctor.js +207 -0
  315. package/dist/commands/install/install.js +461 -0
  316. package/dist/commands/install/uninstall.js +815 -0
  317. package/dist/commands/install/upgrade.js +771 -0
  318. package/dist/commands/launch.js +118 -0
  319. package/dist/commands/lib.js +362 -0
  320. package/dist/commands/registry.js +50 -0
  321. package/dist/commands/setup/setup.js +158 -0
  322. package/dist/commands/telemetry.js +29 -0
  323. package/dist/commands/workflow/branches.js +1265 -0
  324. package/dist/commands/workflow/context.js +846 -0
  325. package/dist/commands/workflow/counters.js +227 -0
  326. package/dist/commands/workflow/fids.js +224 -0
  327. package/dist/commands/workflow/issues.js +585 -0
  328. package/dist/commands/workflow/ledgers.js +472 -0
  329. package/dist/commands/workflow/locks.js +364 -0
  330. package/dist/commands/workflow/prs.js +904 -0
  331. package/dist/commands/workflow/repo.js +199 -0
  332. package/dist/commands/workflow/roadmap.js +495 -0
  333. package/dist/commands/workflow/runs.js +1717 -0
  334. package/dist/commands/workflow/runtime.js +257 -0
  335. package/dist/commands/workflow/skills.js +110 -0
  336. package/dist/commands/workflow/status.js +392 -0
  337. package/dist/commands/workflow/steps.js +1093 -0
  338. package/dist/commands/workflow/tests.js +144 -0
  339. package/dist/commands/workflow/workflows.js +1342 -0
  340. package/dist/commands/workflow/workstreams.js +141 -0
  341. package/dist/commands/workflow/worktrees.js +473 -0
  342. package/dist/install/cloud-env.js +819 -0
  343. package/dist/install/managed-block.js +182 -0
  344. package/dist/install/manifest.js +376 -0
  345. package/dist/install/modules/claude.js +288 -0
  346. package/dist/install/modules/cloud.js +152 -0
  347. package/dist/install/modules/codex.js +193 -0
  348. package/dist/install/modules/core.js +511 -0
  349. package/dist/install/modules/cursor.js +186 -0
  350. package/dist/install/modules/index.js +152 -0
  351. package/dist/install/modules/opencode.js +504 -0
  352. package/dist/install/placeholders.js +87 -0
  353. package/dist/install/template-copies.js +106 -0
  354. package/dist/install/version-file.js +204 -0
  355. package/dist/install/write.js +342 -0
  356. package/dist/ledgers/clamp-log.js +27 -0
  357. package/dist/ledgers/status.js +156 -0
  358. package/dist/ledgers/telemetry.js +637 -0
  359. package/dist/render/hosts.js +339 -0
  360. package/dist/render/models.js +288 -0
  361. package/dist/render/parts.js +33 -0
  362. package/dist/render/trackers.js +135 -0
  363. package/dist/shared/egress.js +299 -0
  364. package/dist/shared/json.js +16 -0
  365. package/dist/shared/log-prefix.js +7 -0
  366. package/dist/shared/package-json.js +22 -0
  367. package/dist/shared/package-manager.js +32 -0
  368. package/dist/shared/package-roots.js +145 -0
  369. package/dist/shared/protected-paths.js +153 -0
  370. package/dist/shared/settings.js +44 -0
  371. package/dist/shared/timeouts.js +19 -0
  372. package/dist/tools/wording.js +680 -0
  373. package/package.json +101 -4
@@ -0,0 +1,575 @@
1
+ // bkit ledgers commit|union|only-bookkeeping — stage and commit bookkeeping by
2
+ // an allow-list, never `git add -A`.
3
+ //
4
+ // The pathspec is built by `git ls-files` against quoted globs, so git does the
5
+ // matching and an unmatched glob is empty output, never a shell abort. Staging
6
+ // and committing read that list NUL-delimited from a file. An empty list stops
7
+ // before `git commit`: `git commit --pathspec-from-file=<empty file>` commits
8
+ // everything already in the index, not nothing.
9
+
10
+ import { spawnSync } from "node:child_process";
11
+ import * as fs from "node:fs";
12
+ import * as os from "node:os";
13
+ import * as path from "node:path";
14
+
15
+ import { gitEnv } from "../../ledgers/telemetry.js";
16
+ import { CommandError, EXIT, type CommandSpec, type FlagSpec, type RunContext } from "../lib.js";
17
+ import { str } from "./status.js";
18
+
19
+ /** Root is not a directory or repo, git is too old, or a ref does not resolve. */
20
+ export const EXIT_ROOT = 3;
21
+ /** `git add` / `git add -u` / mkdir / copy failed. */
22
+ export const EXIT_STAGE = 4;
23
+ /** `git commit` failed. */
24
+ export const EXIT_COMMIT = 5;
25
+ /** The bookkeeping pathspec matched nothing; refusing to reach `git commit`. */
26
+ export const EXIT_EMPTY = 6;
27
+ /** only-bookkeeping: a non-bookkeeping path changed, or from is not an ancestor of to. */
28
+ export const EXIT_NOT_BOOKKEEPING = 7;
29
+
30
+ const SCOPES = ["core", "full", "pr"] as const;
31
+ export type Scope = (typeof SCOPES)[number];
32
+ const MODES = ["stage", "commit", "commit-allow-empty"];
33
+
34
+ /**
35
+ * The bookkeeping allow-list. Plain git pathspec `*` crosses `/`, so the
36
+ * top-level-only entry uses the `:(glob)` magic.
37
+ */
38
+ export function bookPathspecs(month: string, fid: string, scope: Scope): string[] {
39
+ const specs = [
40
+ `docs/plans/${month}/logs/${fid}/*`,
41
+ ".bkit/friction.jsonl",
42
+ ".bkit/stats.jsonl",
43
+ "docs/plans/*/logs/*/*.jsonl",
44
+ "docs/*.jsonl",
45
+ ".bkit/*.jsonl",
46
+ // A projection of .bkit/issues.jsonl, but a .md, so no *.jsonl glob reaches it.
47
+ "docs/roadmap.md",
48
+ ];
49
+ if (scope === "full" || scope === "pr") {
50
+ specs.push(
51
+ "docs/deferrals.jsonl",
52
+ "docs/failures.jsonl",
53
+ "docs/knowledge.jsonl",
54
+ "docs/decisions.jsonl",
55
+ "skills-lock.json",
56
+ ".agents/skills/*",
57
+ ".claude/skills/*",
58
+ ".cursor/skills/*",
59
+ ".opencode/skills/*",
60
+ );
61
+ }
62
+ // `pr` adds the project docs ship's docs sync edits, for the commit that rides
63
+ // the PR. Kept out of `full` so a close on a laptop's dev checkout never sweeps
64
+ // unrelated dirty docs into its commit.
65
+ if (scope === "pr") specs.push(":(glob)docs/*.md");
66
+ return specs;
67
+ }
68
+
69
+ /** Ledgers a worktree teardown carries into the destination checkout. */
70
+ const UNION_PATHSPECS = [
71
+ "docs/plans/*/logs/*/*.jsonl",
72
+ "docs/*.jsonl",
73
+ ".bkit/*.jsonl",
74
+ // ship writes its SHIPPED row into the worktree before the merge so it rides
75
+ // the PR; carrying it into a dev checkout from a run that never merged would
76
+ // mark the feature shipped.
77
+ ":(exclude).bkit/issues.jsonl",
78
+ ];
79
+
80
+ interface GitResult {
81
+ status: number | null;
82
+ stdout: string;
83
+ stderr: string;
84
+ }
85
+
86
+ /** `git <args>` in `cwd`, never throwing and never trimming (NUL-delimited output). */
87
+ function gitRaw(cwd: string, args: string[]): GitResult {
88
+ const res = spawnSync("git", args, {
89
+ cwd,
90
+ encoding: "utf-8",
91
+ env: gitEnv(),
92
+ maxBuffer: 1 << 28,
93
+ });
94
+ return { status: res.status, stdout: res.stdout ?? "", stderr: (res.stderr ?? "").trim() };
95
+ }
96
+
97
+ const nulList = (out: string) => out.split("\0").filter((p) => p !== "");
98
+
99
+ function requireRepo(root: string): void {
100
+ if (!fs.existsSync(root) || !fs.statSync(root).isDirectory()) {
101
+ throw new CommandError(EXIT_ROOT, `root not a directory: ${root}`);
102
+ }
103
+ if (gitRaw(root, ["rev-parse", "--git-dir"]).status !== 0) {
104
+ throw new CommandError(EXIT_ROOT, `root not a git repo: ${root}`);
105
+ }
106
+ }
107
+
108
+ /** `--pathspec-from-file` needs git >= 2.25. */
109
+ function requireGitVersion(): void {
110
+ const res = spawnSync("git", ["--version"], { encoding: "utf-8", env: gitEnv() });
111
+ const m = /(\d+)\.(\d+)/.exec(res.stdout ?? "");
112
+ const [major, minor] = m ? [Number(m[1]), Number(m[2])] : [0, 0];
113
+ if (major < 2 || (major === 2 && minor < 25)) {
114
+ throw new CommandError(
115
+ EXIT_ROOT,
116
+ `git >= 2.25 required for --pathspec-from-file (found '${m ? `${major}.${minor}` : "unknown"}')`,
117
+ );
118
+ }
119
+ }
120
+
121
+ const required = (ctx: RunContext, name: string): string => {
122
+ const v = str(ctx.flags[name]);
123
+ if (!v)
124
+ throw new CommandError(
125
+ EXIT.USAGE,
126
+ `--${name.replace(/[A-Z]/g, (c) => `-${c.toLowerCase()}`)} is required`,
127
+ );
128
+ return v;
129
+ };
130
+
131
+ const rootOf = (ctx: RunContext) => path.resolve(ctx.cwd, str(ctx.flags.root) ?? ".");
132
+
133
+ const ROOT_FLAG: FlagSpec = {
134
+ name: "root",
135
+ type: "string",
136
+ help: "checkout to stage in (default: the working directory)",
137
+ };
138
+ const MONTH_FLAG: FlagSpec = {
139
+ name: "month",
140
+ type: "string",
141
+ required: true,
142
+ help: "YYYYMM bucket of the feature's logs",
143
+ };
144
+ const FID_FLAG: FlagSpec = { name: "fid", type: "string", required: true, help: "feature id" };
145
+
146
+ /** Tracked files with uncommitted changes (`git status --porcelain` minus untracked). */
147
+ function dirtyTracked(root: string): string[] {
148
+ return gitRaw(root, ["status", "--porcelain"])
149
+ .stdout.split("\n")
150
+ .filter((l) => l !== "" && !l.startsWith("??"));
151
+ }
152
+
153
+ // ---------------------------------------------------------------------------
154
+ // Command
155
+ // ---------------------------------------------------------------------------
156
+
157
+ export const ledgersCommand: CommandSpec = {
158
+ noun: "ledgers",
159
+ summary:
160
+ "Stage and commit bookkeeping by allow-list; union ledgers; check a range is bookkeeping only.",
161
+ verbs: {
162
+ commit: {
163
+ summary: "Stage (and commit) the bookkeeping allow-list for one feature.",
164
+ flags: [
165
+ ROOT_FLAG,
166
+ MONTH_FLAG,
167
+ FID_FLAG,
168
+ {
169
+ name: "scope",
170
+ type: "string",
171
+ required: true,
172
+ help: "core (logs + ledgers) | full (+ docs ledgers, skills) | pr (+ top-level docs/*.md)",
173
+ },
174
+ {
175
+ name: "mode",
176
+ type: "string",
177
+ required: true,
178
+ help: "stage | commit (skips when nothing changed) | commit-allow-empty",
179
+ },
180
+ {
181
+ name: "stage-tracked-updates",
182
+ type: "boolean",
183
+ help: "run `git add -u` first (stages every tracked change)",
184
+ },
185
+ {
186
+ name: "squash-of",
187
+ type: "string",
188
+ help: "after `git merge --squash <ref>`, also commit every path <ref> brought in, as staged",
189
+ },
190
+ {
191
+ name: "only-if-dirty-tracked",
192
+ type: "boolean",
193
+ help: "do nothing unless a tracked file has uncommitted changes (the pre-worktree commit)",
194
+ },
195
+ { name: "message", type: "string", help: "commit message (required for commit modes)" },
196
+ ],
197
+ output: {
198
+ outcome:
199
+ "committed | staged | nothing-to-commit | clean (no tracked changes, with --only-if-dirty-tracked)",
200
+ commit: "the new commit's sha, or null",
201
+ paths: "bookkeeping paths the allow-list matched",
202
+ squashPaths: "paths the --squash-of ref brought in",
203
+ },
204
+ exitCodes: {
205
+ [EXIT_ROOT]:
206
+ "root not a directory or git repo, git < 2.25, or --squash-of does not resolve",
207
+ [EXIT_STAGE]: "staging failed (git add / git add -u)",
208
+ [EXIT_COMMIT]: "git commit failed",
209
+ [EXIT_EMPTY]: "the allow-list matched nothing — refusing to commit the whole index",
210
+ },
211
+ run: (ctx) => commit(ctx),
212
+ },
213
+ union: {
214
+ summary:
215
+ "Append a worktree's new ledger rows into another checkout (never .bkit/issues.jsonl).",
216
+ flags: [
217
+ { name: "src", type: "string", required: true, help: "worktree to read ledgers from" },
218
+ { name: "dst", type: "string", required: true, help: "checkout to append them to" },
219
+ ],
220
+ output: { unioned: "ledgers swept", files: "their paths, relative to both roots" },
221
+ exitCodes: {
222
+ [EXIT_ROOT]: "src not a directory or git repo",
223
+ [EXIT_STAGE]: "mkdir or copy into dst failed",
224
+ },
225
+ run: (ctx) => union(ctx),
226
+ },
227
+ "only-bookkeeping": {
228
+ summary: "Exit 0 when every path changed in from..to is on the --scope=pr allow-list.",
229
+ flags: [
230
+ ROOT_FLAG,
231
+ MONTH_FLAG,
232
+ FID_FLAG,
233
+ { name: "from", type: "string", required: true, help: "commit CI validated" },
234
+ { name: "to", type: "string", required: true, help: "head to accept" },
235
+ ],
236
+ output: {
237
+ onlyBookkeeping: "true when every changed path is bookkeeping",
238
+ ancestor: "whether from is an ancestor of to",
239
+ outside: "changed paths outside the allow-list",
240
+ },
241
+ exitCodes: {
242
+ [EXIT_ROOT]: "root not a repo, a commit does not resolve, or git diff failed",
243
+ [EXIT_NOT_BOOKKEEPING]: "a non-bookkeeping path changed, or from is not an ancestor of to",
244
+ },
245
+ run: (ctx) => onlyBookkeeping(ctx),
246
+ },
247
+ },
248
+ };
249
+
250
+ export interface BookkeepingCommit {
251
+ /** Checkout to stage in. */
252
+ root: string;
253
+ month: string;
254
+ fid: string;
255
+ scope: Scope;
256
+ mode: "stage" | "commit" | "commit-allow-empty";
257
+ message?: string;
258
+ stageTrackedUpdates?: boolean;
259
+ squashOf?: string;
260
+ onlyIfDirtyTracked?: boolean;
261
+ }
262
+
263
+ export interface BookkeepingResult {
264
+ outcome: "committed" | "staged" | "nothing-to-commit" | "clean";
265
+ commit: string | null;
266
+ paths: string[];
267
+ squashPaths: string[];
268
+ }
269
+
270
+ /**
271
+ * Stage (and commit) the bookkeeping allow-list for one feature. Throws a
272
+ * CommandError with EXIT_ROOT / EXIT_STAGE / EXIT_COMMIT / EXIT_EMPTY.
273
+ */
274
+ export function commitBookkeeping(
275
+ o: BookkeepingCommit,
276
+ log: (m: string) => void,
277
+ ): BookkeepingResult {
278
+ const { root, month, fid, scope, mode, message, squashOf } = o;
279
+ if (!SCOPES.includes(scope)) {
280
+ throw new CommandError(EXIT.USAGE, `--scope must be core, full, or pr (got '${scope}')`);
281
+ }
282
+ if (!MODES.includes(mode)) {
283
+ throw new CommandError(
284
+ EXIT.USAGE,
285
+ `--mode must be stage, commit, or commit-allow-empty (got '${mode}')`,
286
+ );
287
+ }
288
+ if (mode !== "stage" && !message)
289
+ throw new CommandError(EXIT.USAGE, `--message is required for --mode=${mode}`);
290
+ if (mode === "stage" && squashOf !== undefined) {
291
+ throw new CommandError(EXIT.USAGE, "--squash-of applies to commit modes only");
292
+ }
293
+
294
+ requireRepo(root);
295
+ if (
296
+ squashOf !== undefined &&
297
+ gitRaw(root, ["rev-parse", "-q", "--verify", `${squashOf}^{commit}`]).status !== 0
298
+ ) {
299
+ throw new CommandError(EXIT_ROOT, `--squash-of: unknown commit: ${squashOf}`);
300
+ }
301
+ requireGitVersion();
302
+
303
+ if (o.onlyIfDirtyTracked === true) {
304
+ const dirty = dirtyTracked(root);
305
+ if (dirty.length === 0) {
306
+ log("no tracked file has uncommitted changes — nothing to commit");
307
+ return { outcome: "clean", commit: null, paths: [], squashPaths: [] };
308
+ }
309
+ for (const line of dirty) log(line);
310
+ }
311
+
312
+ if (o.stageTrackedUpdates === true) {
313
+ const res = gitRaw(root, ["add", "-u"]);
314
+ if (res.status !== 0) throw new CommandError(EXIT_STAGE, `'git add -u' failed: ${res.stderr}`);
315
+ }
316
+
317
+ const specs = bookPathspecs(month, fid, scope);
318
+ const listed = gitRaw(root, [
319
+ "ls-files",
320
+ "-z",
321
+ "--cached",
322
+ "--others",
323
+ "--exclude-standard",
324
+ "--",
325
+ ...specs,
326
+ ]);
327
+ if (listed.status !== 0) {
328
+ throw new CommandError(
329
+ EXIT_ROOT,
330
+ `'git ls-files' failed while building the pathspec: ${listed.stderr}`,
331
+ );
332
+ }
333
+ const paths = nulList(listed.stdout);
334
+ let squashPaths: string[] = [];
335
+ if (squashOf !== undefined) {
336
+ const diff = gitRaw(root, ["diff", "--name-only", "-z", "--no-renames", `HEAD...${squashOf}`]);
337
+ if (diff.status !== 0) {
338
+ throw new CommandError(
339
+ EXIT_ROOT,
340
+ `'git diff' failed while listing the paths ${squashOf} brought in: ${diff.stderr}`,
341
+ );
342
+ }
343
+ squashPaths = nulList(diff.stdout);
344
+ }
345
+
346
+ if (mode !== "stage" && paths.length + squashPaths.length === 0) {
347
+ // The pre-worktree commit records only bookkeeping; a dirty tree with none
348
+ // of it (a fresh consumer repo) has nothing of ours to commit, and stopping
349
+ // here never reaches `git commit`.
350
+ if (o.onlyIfDirtyTracked === true) {
351
+ log(`no bookkeeping under scope=${scope} in ${root} — nothing to commit`);
352
+ return { outcome: "nothing-to-commit", commit: null, paths, squashPaths };
353
+ }
354
+ throw new CommandError(
355
+ EXIT_EMPTY,
356
+ `empty pathspec list — refusing to commit (nothing under scope=${scope} matched in ${root})`,
357
+ );
358
+ }
359
+
360
+ const tmp = fs.mkdtempSync(path.join(os.tmpdir(), "bkit-ledgers-"));
361
+ try {
362
+ const bookList = path.join(tmp, "book");
363
+ const commitList = path.join(tmp, "commit");
364
+ fs.writeFileSync(bookList, paths.map((p) => `${p}\0`).join(""));
365
+ fs.writeFileSync(commitList, [...paths, ...squashPaths].map((p) => `${p}\0`).join(""));
366
+
367
+ const add = gitRaw(root, ["add", `--pathspec-from-file=${bookList}`, "--pathspec-file-nul"]);
368
+ if (add.status !== 0) throw new CommandError(EXIT_STAGE, `'git add' failed: ${add.stderr}`);
369
+
370
+ if (mode === "stage") {
371
+ log(`staged (scope=${scope})`);
372
+ return { outcome: "staged", commit: null, paths, squashPaths };
373
+ }
374
+ if (
375
+ mode === "commit" &&
376
+ gitRaw(root, ["diff", "--cached", "--quiet", "--", ...specs, ...squashPaths]).status === 0
377
+ ) {
378
+ log("nothing to commit");
379
+ return { outcome: "nothing-to-commit", commit: null, paths, squashPaths };
380
+ }
381
+ const made = gitRaw(root, [
382
+ "commit",
383
+ ...(mode === "commit-allow-empty" ? ["--allow-empty"] : []),
384
+ `--pathspec-from-file=${commitList}`,
385
+ "--pathspec-file-nul",
386
+ "-m",
387
+ message!,
388
+ ]);
389
+ if (made.status !== 0) {
390
+ throw new CommandError(
391
+ EXIT_COMMIT,
392
+ `'git commit' failed: ${made.stderr || made.stdout.trim()}`,
393
+ );
394
+ }
395
+ return {
396
+ outcome: "committed",
397
+ commit: gitRaw(root, ["rev-parse", "HEAD"]).stdout.trim(),
398
+ paths,
399
+ squashPaths,
400
+ };
401
+ } finally {
402
+ fs.rmSync(tmp, { recursive: true, force: true });
403
+ }
404
+ }
405
+
406
+ function commit(ctx: RunContext): number {
407
+ const f = ctx.flags;
408
+ ctx.emit({
409
+ ...commitBookkeeping(
410
+ {
411
+ root: rootOf(ctx),
412
+ month: required(ctx, "month"),
413
+ fid: required(ctx, "fid"),
414
+ scope: String(f.scope) as Scope,
415
+ mode: String(f.mode) as BookkeepingCommit["mode"],
416
+ message: str(f.message),
417
+ stageTrackedUpdates: f.stageTrackedUpdates === true,
418
+ squashOf: str(f.squashOf),
419
+ onlyIfDirtyTracked: f.onlyIfDirtyTracked === true,
420
+ },
421
+ ctx.log,
422
+ ),
423
+ });
424
+ return EXIT.OK;
425
+ }
426
+
427
+ /** Lines as `grep` reads them: a final newline ends the last line, it does not start an empty one. */
428
+ const fileLines = (text: string) => (text === "" ? [] : text.replace(/\n$/, "").split("\n"));
429
+
430
+ /**
431
+ * Append a worktree's new ledger rows into another checkout (never
432
+ * .bkit/issues.jsonl). Throws EXIT_ROOT / EXIT_STAGE.
433
+ */
434
+ export function unionLedgers(src: string, dst: string): string[] {
435
+ if (!fs.existsSync(src) || !fs.statSync(src).isDirectory()) {
436
+ throw new CommandError(EXIT_ROOT, `src not a directory: ${src}`);
437
+ }
438
+ if (gitRaw(src, ["rev-parse", "--git-dir"]).status !== 0) {
439
+ throw new CommandError(EXIT_ROOT, `src not a git repo: ${src}`);
440
+ }
441
+ const listed = gitRaw(src, [
442
+ "ls-files",
443
+ "-z",
444
+ "--cached",
445
+ "--others",
446
+ "--exclude-standard",
447
+ "--",
448
+ ...UNION_PATHSPECS,
449
+ ]);
450
+ const files: string[] = [];
451
+ for (const rel of nulList(listed.stdout)) {
452
+ const from = path.join(src, rel);
453
+ if (!fs.existsSync(from) || !fs.statSync(from).isFile()) continue;
454
+ const to = path.join(dst, rel);
455
+ const made = mkdirp(path.dirname(to));
456
+ if (made) throw new CommandError(EXIT_STAGE, `mkdir failed for ${path.dirname(to)}: ${made}`);
457
+ if (fs.existsSync(to) && fs.statSync(to).isFile()) {
458
+ const existing = fs.readFileSync(to, "utf-8");
459
+ const have = new Set(fileLines(existing));
460
+ const fresh = fileLines(fs.readFileSync(from, "utf-8")).filter((l) => !have.has(l));
461
+ const block = fresh.join("\n").replace(/\n+$/, "");
462
+ // A destination missing its final newline would glue the first new row
463
+ // onto its last one, leaving a line that is not JSON.
464
+ const sep = existing !== "" && !existing.endsWith("\n") ? "\n" : "";
465
+ if (block !== "") fs.appendFileSync(to, `${sep}${block}\n`);
466
+ } else {
467
+ const copied = copy(from, to);
468
+ if (copied) throw new CommandError(EXIT_STAGE, `copy failed for ${rel}: ${copied}`);
469
+ }
470
+ files.push(rel);
471
+ }
472
+ return files;
473
+ }
474
+
475
+ function union(ctx: RunContext): number {
476
+ const src = path.resolve(ctx.cwd, String(ctx.flags.src));
477
+ const dst = path.resolve(ctx.cwd, String(ctx.flags.dst));
478
+ const files = unionLedgers(src, dst);
479
+ ctx.log(`swept ${files.length} ledger(s) from ${src} into ${dst}`);
480
+ ctx.emit({ unioned: files.length, files });
481
+ return EXIT.OK;
482
+ }
483
+
484
+ /** mkdir -p; the error text, or undefined on success. */
485
+ function mkdirp(dir: string): string | undefined {
486
+ try {
487
+ fs.mkdirSync(dir, { recursive: true });
488
+ return undefined;
489
+ } catch (err) {
490
+ // Reported as the command's staging exit code, with the reason.
491
+ return (err as Error).message;
492
+ }
493
+ }
494
+
495
+ function copy(from: string, to: string): string | undefined {
496
+ try {
497
+ fs.copyFileSync(from, to);
498
+ return undefined;
499
+ } catch (err) {
500
+ // Reported as the command's staging exit code, with the reason.
501
+ return (err as Error).message;
502
+ }
503
+ }
504
+
505
+ export type BookkeepingCheck =
506
+ | { kind: "ok" }
507
+ | { kind: "unknown-commit"; ref: string }
508
+ | { kind: "not-ancestor" }
509
+ | { kind: "diff-failed"; stderr: string }
510
+ | { kind: "outside"; outside: string[] };
511
+
512
+ /**
513
+ * Whether `to` is `from` plus bookkeeping-only commits (the `pr` allow-list). One
514
+ * check for `ledgers only-bookkeeping` and the ship gate's carry-forward.
515
+ */
516
+ export function checkOnlyBookkeeping(
517
+ root: string,
518
+ o: { month: string; fid: string; from: string; to: string },
519
+ ): BookkeepingCheck {
520
+ for (const ref of [o.from, o.to]) {
521
+ if (gitRaw(root, ["cat-file", "-e", `${ref}^{commit}`]).status !== 0) {
522
+ return { kind: "unknown-commit", ref };
523
+ }
524
+ }
525
+ if (gitRaw(root, ["merge-base", "--is-ancestor", o.from, o.to]).status !== 0) {
526
+ return { kind: "not-ancestor" };
527
+ }
528
+ const changed = (specs: string[]) =>
529
+ gitRaw(root, [
530
+ "diff",
531
+ "--name-only",
532
+ "-z",
533
+ "--no-renames",
534
+ o.from,
535
+ o.to,
536
+ ...(specs.length ? ["--", ...specs] : []),
537
+ ]);
538
+ const all = changed([]);
539
+ const book = changed(bookPathspecs(o.month, o.fid, "pr"));
540
+ if (all.status !== 0 || book.status !== 0) {
541
+ return { kind: "diff-failed", stderr: all.status !== 0 ? all.stderr : book.stderr };
542
+ }
543
+ const allowed = new Set(nulList(book.stdout));
544
+ const outside = [...new Set(nulList(all.stdout).filter((p) => !allowed.has(p)))].sort();
545
+ return outside.length ? { kind: "outside", outside } : { kind: "ok" };
546
+ }
547
+
548
+ function onlyBookkeeping(ctx: RunContext): number {
549
+ const month = required(ctx, "month");
550
+ const fid = required(ctx, "fid");
551
+ const from = required(ctx, "from");
552
+ const to = required(ctx, "to");
553
+ const root = rootOf(ctx);
554
+ requireRepo(root);
555
+ const check = checkOnlyBookkeeping(root, { month, fid, from, to });
556
+ switch (check.kind) {
557
+ case "unknown-commit":
558
+ throw new CommandError(EXIT_ROOT, `unknown commit: ${check.ref}`);
559
+ case "diff-failed":
560
+ throw new CommandError(EXIT_ROOT, `'git diff' failed for ${from}..${to}: ${check.stderr}`);
561
+ case "not-ancestor":
562
+ ctx.log(`${from} is not an ancestor of ${to}`);
563
+ ctx.emit({ onlyBookkeeping: false, ancestor: false, outside: [] });
564
+ return EXIT_NOT_BOOKKEEPING;
565
+ case "outside":
566
+ ctx.log(`non-bookkeeping paths changed in ${from}..${to}:`);
567
+ for (const p of check.outside) ctx.log(` ${p}`);
568
+ ctx.emit({ onlyBookkeeping: false, ancestor: true, outside: check.outside });
569
+ return EXIT_NOT_BOOKKEEPING;
570
+ case "ok":
571
+ ctx.log(`every path changed in ${from}..${to} is bookkeeping`);
572
+ ctx.emit({ onlyBookkeeping: true, ancestor: true, outside: [] });
573
+ return EXIT.OK;
574
+ }
575
+ }