@cbartens/bkit 6.0.0 → 6.1.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 (375) hide show
  1. package/.bkit/README.md +154 -151
  2. package/.bkit/core/.agents/context.md +95 -29
  3. package/.bkit/core/.agents/docs.md +17 -15
  4. package/.bkit/core/.agents/plugins/bkit/hooks/bkit-gateguard.cjs +1 -0
  5. package/.bkit/core/.agents/plugins/bkit/hooks/bkit-guardrails.cjs +6 -5
  6. package/.bkit/core/.agents/plugins/bkit/hooks/bkit-readguard.cjs +1 -0
  7. package/.bkit/core/.agents/plugins/bkit/hooks/bkit-rules.cjs +65 -0
  8. package/.bkit/core/.agents/rules.md +108 -107
  9. package/.bkit/core/.agents/skills.md +63 -15
  10. package/.bkit/core/.bkit/README.md +154 -151
  11. package/.bkit/core/.bkit/authoring.md +714 -84
  12. package/.bkit/core/.bkit/cli.md +407 -0
  13. package/.bkit/core/.bkit/cloud.md +281 -193
  14. package/.bkit/core/.bkit/comparison.md +43 -41
  15. package/.bkit/core/.bkit/install.md +154 -84
  16. package/.bkit/core/.bkit/jsonl.md +193 -130
  17. package/.bkit/core/.bkit/pipeline.md +114 -114
  18. package/.bkit/core/.bkit/prompts.md +272 -165
  19. package/.bkit/core/.bkit/providers.md +457 -271
  20. package/.bkit/core/.bkit/router.md +69 -0
  21. package/.bkit/core/.bkit/templates.md +529 -256
  22. package/.bkit/core/.bkit/trackers.md +80 -52
  23. package/.bkit/core/.bkit/workflows.md +589 -504
  24. package/.bkit/core/.claude/hooks/bkit-gateguard.cjs +2 -2
  25. package/.bkit/core/.claude/hooks/bkit-guardrails.cjs +3 -3
  26. package/.bkit/core/.claude/hooks/bkit-preflight.sh +45 -14
  27. package/.bkit/core/.codex/hooks/bkit-guardrails.cjs +3 -3
  28. package/.bkit/core/.codex/hooks/bkit-rules.cjs +57 -0
  29. package/.bkit/core/.cursor/hooks/bkit-guardrails.cjs +7 -7
  30. package/.bkit/core/.cursor/hooks/bkit-preflight.sh +47 -12
  31. package/.bkit/core/.opencode/plugin/bkit-rules.js +89 -0
  32. package/.bkit/core/AGENTS.md +5 -73
  33. package/.bkit/core/docs/templates/bkit-audit-accessibility.md +127 -105
  34. package/.bkit/core/docs/templates/bkit-audit-adoption.md +104 -70
  35. package/.bkit/core/docs/templates/bkit-audit-agents.md +94 -72
  36. package/.bkit/core/docs/templates/bkit-audit-aio-seo.md +99 -78
  37. package/.bkit/core/docs/templates/bkit-audit-analytics.md +140 -82
  38. package/.bkit/core/docs/templates/bkit-audit-annotations.md +98 -72
  39. package/.bkit/core/docs/templates/bkit-audit-app-performance.md +121 -96
  40. package/.bkit/core/docs/templates/bkit-audit-app-store.md +157 -76
  41. package/.bkit/core/docs/templates/bkit-audit-architecture.md +113 -71
  42. package/.bkit/core/docs/templates/bkit-audit-ci-performance.md +75 -72
  43. package/.bkit/core/docs/templates/bkit-audit-config.md +122 -76
  44. package/.bkit/core/docs/templates/bkit-audit-cost.md +85 -74
  45. package/.bkit/core/docs/templates/bkit-audit-coverage.md +75 -68
  46. package/.bkit/core/docs/templates/bkit-audit-database.md +101 -70
  47. package/.bkit/core/docs/templates/bkit-audit-dead-code.md +164 -83
  48. package/.bkit/core/docs/templates/bkit-audit-deferrals.md +115 -86
  49. package/.bkit/core/docs/templates/bkit-audit-dependencies.md +264 -88
  50. package/.bkit/core/docs/templates/bkit-audit-documentation.md +118 -93
  51. package/.bkit/core/docs/templates/bkit-audit-duplication.md +139 -86
  52. package/.bkit/core/docs/templates/bkit-audit-failures.md +110 -81
  53. package/.bkit/core/docs/templates/bkit-audit-flakes.md +99 -74
  54. package/.bkit/core/docs/templates/bkit-audit-gates.md +105 -77
  55. package/.bkit/core/docs/templates/bkit-audit-issues.md +104 -80
  56. package/.bkit/core/docs/templates/bkit-audit-llm.md +131 -58
  57. package/.bkit/core/docs/templates/bkit-audit-logs.md +123 -100
  58. package/.bkit/core/docs/templates/bkit-audit-models.md +98 -53
  59. package/.bkit/core/docs/templates/bkit-audit-privacy.md +56 -52
  60. package/.bkit/core/docs/templates/bkit-audit-prompts.md +63 -54
  61. package/.bkit/core/docs/templates/bkit-audit-red-team.md +124 -68
  62. package/.bkit/core/docs/templates/bkit-audit-reliability.md +95 -70
  63. package/.bkit/core/docs/templates/bkit-audit-repo.md +169 -73
  64. package/.bkit/core/docs/templates/bkit-audit-security.md +206 -96
  65. package/.bkit/core/docs/templates/bkit-audit-slop.md +77 -70
  66. package/.bkit/core/docs/templates/bkit-audit-testing.md +162 -114
  67. package/.bkit/core/docs/templates/bkit-audit-usability.md +113 -71
  68. package/.bkit/core/docs/templates/bkit-plan.md +138 -132
  69. package/.bkit/core/engine/checks/after/auth.ts +40 -37
  70. package/.bkit/core/engine/checks/after/ci-yml.ts +65 -2
  71. package/.bkit/core/engine/checks/after/index.ts +12 -2
  72. package/.bkit/core/engine/checks/after/tools.ts +80 -33
  73. package/.bkit/core/engine/checks/before/context-fetch.ts +227 -33
  74. package/.bkit/core/engine/checks/before/env.ts +1 -1
  75. package/.bkit/core/engine/checks/before/index.ts +7 -0
  76. package/.bkit/core/engine/checks/before/repo.ts +40 -0
  77. package/.bkit/core/engine/checks/status-holes.ts +916 -123
  78. package/.bkit/core/engine/checks/tips/catalogue.ts +68 -17
  79. package/.bkit/core/engine/checks/tips/detect.ts +32 -0
  80. package/.bkit/core/engine/checks/tips/index.ts +47 -6
  81. package/.bkit/core/engine/cli.ts +238 -84
  82. package/.bkit/core/engine/commands/analysis.ts +128 -76
  83. package/.bkit/core/engine/commands/ci/ci.ts +363 -29
  84. package/.bkit/core/engine/commands/ci/pins.ts +172 -0
  85. package/.bkit/core/engine/commands/ci/push-gate.ts +223 -0
  86. package/.bkit/core/engine/commands/install/uninstall.ts +21 -27
  87. package/.bkit/core/engine/commands/install/upgrade.ts +32 -15
  88. package/.bkit/core/engine/commands/land.ts +126 -11
  89. package/.bkit/core/engine/commands/lib.ts +303 -6
  90. package/.bkit/core/engine/commands/registry.ts +6 -2
  91. package/.bkit/core/engine/commands/setup/setup.ts +1 -0
  92. package/.bkit/core/engine/commands/stats.ts +91 -35
  93. package/.bkit/core/engine/commands/workflow/branches.ts +1477 -117
  94. package/.bkit/core/engine/commands/workflow/challenge.ts +114 -39
  95. package/.bkit/core/engine/commands/workflow/completeness.ts +109 -0
  96. package/.bkit/core/engine/commands/workflow/context.ts +433 -55
  97. package/.bkit/core/engine/commands/workflow/counters.ts +244 -39
  98. package/.bkit/core/engine/commands/workflow/decisions.ts +61 -17
  99. package/.bkit/core/engine/commands/workflow/disk.ts +237 -55
  100. package/.bkit/core/engine/commands/workflow/fids.ts +19 -1
  101. package/.bkit/core/engine/commands/workflow/issues.ts +6 -0
  102. package/.bkit/core/engine/commands/workflow/ledgers.ts +458 -18
  103. package/.bkit/core/engine/commands/workflow/locks.ts +2 -0
  104. package/.bkit/core/engine/commands/workflow/plan-blocks.ts +124 -15
  105. package/.bkit/core/engine/commands/workflow/plans.ts +257 -0
  106. package/.bkit/core/engine/commands/workflow/prs.ts +12 -3
  107. package/.bkit/core/engine/commands/workflow/repo.ts +8 -0
  108. package/.bkit/core/engine/commands/workflow/roadmap.ts +56 -15
  109. package/.bkit/core/engine/commands/workflow/run-facts.ts +22 -31
  110. package/.bkit/core/engine/commands/workflow/runs.ts +652 -34
  111. package/.bkit/core/engine/commands/workflow/runtime.ts +3 -0
  112. package/.bkit/core/engine/commands/workflow/skills.ts +1 -0
  113. package/.bkit/core/engine/commands/workflow/status.ts +200 -17
  114. package/.bkit/core/engine/commands/workflow/step-table.ts +75 -33
  115. package/.bkit/core/engine/commands/workflow/steps.ts +635 -24
  116. package/.bkit/core/engine/commands/workflow/summary-findings.ts +177 -0
  117. package/.bkit/core/engine/commands/workflow/summary.ts +192 -46
  118. package/.bkit/core/engine/commands/workflow/tasks.ts +409 -0
  119. package/.bkit/core/engine/commands/workflow/test-blocks.ts +254 -0
  120. package/.bkit/core/engine/commands/workflow/tests-changed.ts +201 -0
  121. package/.bkit/core/engine/commands/workflow/tests.ts +1285 -356
  122. package/.bkit/core/engine/commands/workflow/workflows.ts +228 -43
  123. package/.bkit/core/engine/commands/workflow/worktrees.ts +389 -47
  124. package/.bkit/core/engine/install/cloud-env.ts +251 -121
  125. package/.bkit/core/engine/install/context-ci-workflow.ts +102 -0
  126. package/.bkit/core/engine/install/manifest.ts +60 -12
  127. package/.bkit/core/engine/install/modules/antigravity.ts +3 -2
  128. package/.bkit/core/engine/install/modules/cloud.ts +3 -3
  129. package/.bkit/core/engine/install/modules/codex.ts +15 -2
  130. package/.bkit/core/engine/install/modules/core.ts +956 -52
  131. package/.bkit/core/engine/install/modules/cursor.ts +6 -6
  132. package/.bkit/core/engine/install/modules/opencode.ts +16 -4
  133. package/.bkit/core/engine/install/template-notes.ts +130 -0
  134. package/.bkit/core/engine/install/version-file.ts +3 -2
  135. package/.bkit/core/engine/install/write.ts +5 -0
  136. package/.bkit/core/engine/ledgers/compact.ts +124 -0
  137. package/.bkit/core/engine/ledgers/journal.ts +291 -0
  138. package/.bkit/core/engine/ledgers/status.ts +160 -9
  139. package/.bkit/core/engine/ledgers/telemetry.ts +158 -21
  140. package/.bkit/core/engine/render/hosts.ts +114 -14
  141. package/.bkit/core/engine/shared/bkit-latest.ts +26 -4
  142. package/.bkit/core/engine/shared/dep-updater.ts +60 -0
  143. package/.bkit/core/engine/shared/egress.ts +1 -1
  144. package/.bkit/core/engine/shared/package-manager.ts +9 -0
  145. package/.bkit/core/engine/shared/settings.ts +92 -17
  146. package/.bkit/core/engine/shared/timeouts.ts +2 -0
  147. package/.bkit/core/engine/tools/cli-doc.ts +111 -0
  148. package/.bkit/core/engine/tools/grammar-density.ts +1 -1
  149. package/.bkit/core/engine/tools/instructions-sources.ts +15 -17
  150. package/.bkit/core/engine/tools/instructions.ts +94 -43
  151. package/.bkit/core/hooks/antigravity-hook.js +25 -10
  152. package/.bkit/core/hooks/gateguard-engine.js +53 -29
  153. package/.bkit/core/hooks/guardrails-shell.js +4 -4
  154. package/.bkit/core/hooks/guardrails-tiers.js +3 -3
  155. package/.bkit/core/hooks/preflight-linear.sh +9 -9
  156. package/.bkit/core/hooks/preflight-rules.sh +8 -0
  157. package/.bkit/core/hooks/readguard-engine.js +29 -10
  158. package/.bkit/core/hooks/session-rules-advisory.js +61 -0
  159. package/.bkit/core/prompts/bkit-audit-generate.md +187 -116
  160. package/.bkit/core/prompts/bkit-build-challenge-1.md +56 -37
  161. package/.bkit/core/prompts/bkit-build-challenge-2.md +65 -45
  162. package/.bkit/core/prompts/bkit-build-install-skills.md +38 -29
  163. package/.bkit/core/prompts/bkit-build-plan-convert.md +43 -32
  164. package/.bkit/core/prompts/bkit-build-plan-current.md +49 -39
  165. package/.bkit/core/prompts/bkit-build-plan-gaps-remediate.md +79 -55
  166. package/.bkit/core/prompts/bkit-build-plan-tasks.md +149 -0
  167. package/.bkit/core/prompts/bkit-build-plan-tests.md +120 -0
  168. package/.bkit/core/prompts/bkit-build-plan-verify.md +87 -50
  169. package/.bkit/core/prompts/bkit-debug-abort-handover.md +36 -35
  170. package/.bkit/core/prompts/bkit-debug-failure-diagnose.md +96 -64
  171. package/.bkit/core/prompts/bkit-debug-failure-remediate.md +54 -45
  172. package/.bkit/core/prompts/bkit-debug-failure-reproduce.md +42 -33
  173. package/.bkit/core/prompts/bkit-debug-failure-soak.md +53 -37
  174. package/.bkit/core/prompts/bkit-design-brainstorm-ideate-1.md +35 -30
  175. package/.bkit/core/prompts/bkit-design-brainstorm-ideate-2.md +34 -29
  176. package/.bkit/core/prompts/bkit-design-brainstorm-ideate-3.md +32 -28
  177. package/.bkit/core/prompts/bkit-design-generate.md +68 -52
  178. package/.bkit/core/prompts/bkit-design-organise.md +73 -35
  179. package/.bkit/core/prompts/bkit-design-review-1.md +58 -54
  180. package/.bkit/core/prompts/bkit-design-review-2.md +54 -50
  181. package/.bkit/core/prompts/bkit-design-spike.md +54 -47
  182. package/.bkit/core/prompts/bkit-design-update.md +42 -31
  183. package/.bkit/core/prompts/bkit-plan-generate.md +76 -58
  184. package/.bkit/core/prompts/bkit-plan-review-1.md +63 -49
  185. package/.bkit/core/prompts/bkit-plan-review-2.md +60 -48
  186. package/.bkit/core/prompts/bkit-plan-scope-check.md +53 -46
  187. package/.bkit/core/prompts/bkit-plan-update.md +70 -52
  188. package/.bkit/core/prompts/bkit-ship-conflict-resolve.md +82 -50
  189. package/.bkit/core/prompts/bkit-ship-deferred-sweep.md +80 -45
  190. package/.bkit/core/prompts/bkit-ship-update-docs.md +35 -29
  191. package/.bkit/core/prompts/bkit-utility-compress-markdown.md +55 -49
  192. package/.bkit/core/prompts/bkit-utility-update-decisions.md +76 -49
  193. package/.bkit/core/prompts/bkit-utility-update-deferrals.md +70 -41
  194. package/.bkit/core/prompts/bkit-utility-update-documentation.md +33 -30
  195. package/.bkit/core/prompts/bkit-utility-update-failures.md +73 -43
  196. package/.bkit/core/prompts/bkit-utility-update-knowledge.md +77 -50
  197. package/.bkit/core/prompts/bkit-utility-update-roadmap.md +77 -45
  198. package/.bkit/core/prompts/bkit-utility-update-tracker.md +144 -68
  199. package/.bkit/core/workflows/bkit-auto.md +53 -30
  200. package/.bkit/core/workflows/bkit-build.md +635 -304
  201. package/.bkit/core/workflows/bkit-debug.md +301 -148
  202. package/.bkit/core/workflows/bkit-design.md +167 -95
  203. package/.bkit/core/workflows/bkit-plan.md +172 -84
  204. package/.bkit/core/workflows/bkit-ship.md +299 -152
  205. package/.bkit/shared/.agents/plugins/bkit/hooks.json +10 -0
  206. package/.bkit/shared/.claude/bkit-cloud.md +12 -10
  207. package/.bkit/shared/.claude/settings.json +3 -0
  208. package/.bkit/shared/.codex/bkit-cloud.md +98 -0
  209. package/.bkit/shared/.codex/hooks.json +20 -0
  210. package/.bkit/shared/.cursor/bkit-cloud.md +3 -3
  211. package/.bkit/shared/.opencode/opencode.json +1 -1
  212. package/.bkit/shared/CLAUDE.md +5 -1
  213. package/.bkit/shared/GEMINI.md +4 -1
  214. package/.bkit/shared/docs/architecture.md +4 -7
  215. package/.bkit/shared/docs/data-schema.md +4 -7
  216. package/.bkit/shared/docs/deployments.md +239 -166
  217. package/.bkit/shared/docs/design.md +11 -12
  218. package/.bkit/shared/docs/noise.md +8 -7
  219. package/.bkit/shared/docs/observability.md +5 -8
  220. package/.bkit/shared/docs/security.md +35 -17
  221. package/.bkit/shared/docs/setup.md +29 -18
  222. package/.bkit/shared/docs/technology.md +3 -6
  223. package/.bkit/shared/docs/testing.md +282 -176
  224. package/.bkit/shared/gitignore +6 -2
  225. package/.bkit/templates/.claude/hooks/bkit-cloud-bootstrap.sh +15 -16
  226. package/.bkit/templates/.cursor/Dockerfile +12 -8
  227. package/.bkit/templates/.cursor/environment.json +1 -1
  228. package/.bkit/templates/.github/ISSUE_TEMPLATE/bkit-bug.yml +10 -8
  229. package/.bkit/templates/.github/ISSUE_TEMPLATE/bkit-change.yml +24 -12
  230. package/.bkit/templates/.github/ISSUE_TEMPLATE/bkit-idea.yml +3 -3
  231. package/.bkit/templates/.github/renovate.json5 +34 -6
  232. package/.bkit/templates/.github/workflows/bkit-ci.yml +53 -50
  233. package/.bkit/templates/.github/workflows/bkit-cloud.yml +13 -14
  234. package/.bkit/templates/.github/workflows/bkit-health.yml +97 -0
  235. package/.bkit/templates/.github/workflows/bkit-renovate.yml +5 -4
  236. package/.bkit/templates/.github/workflows/bkit-trivy.yml +5 -4
  237. package/.bkit/templates/.husky/pre-commit +2 -2
  238. package/.bkit/templates/.husky/pre-push +95 -35
  239. package/.bkit/templates/.prettierignore +6 -7
  240. package/.bkit/templates/.vale.ini +27 -27
  241. package/.bkit/templates/context/bkit-cloudrun.md +23 -15
  242. package/.bkit/templates/context/bkit-expo.md +70 -52
  243. package/.bkit/templates/context/bkit-github.md +93 -56
  244. package/.bkit/templates/context/bkit-inngest.md +21 -15
  245. package/.bkit/templates/context/bkit-maestro.md +22 -16
  246. package/.bkit/templates/context/bkit-playwright.md +23 -17
  247. package/.bkit/templates/context/bkit-resend.md +12 -10
  248. package/.bkit/templates/context/bkit-sentry.md +30 -20
  249. package/.bkit/templates/context/bkit-serena.md +8 -7
  250. package/.bkit/templates/context/bkit-stripe.md +14 -13
  251. package/.bkit/templates/context/bkit-supabase.md +16 -13
  252. package/.bkit/templates/context/bkit-tavily.md +14 -11
  253. package/.bkit/templates/context/bkit-vercel.md +27 -18
  254. package/.bkit/templates/docs/capabilities.md +15 -14
  255. package/.bkit/templates/scripts/ci/{check-accepted-divergences.mjs → bkit-check-accepted-divergences.mjs} +6 -3
  256. package/.bkit/templates/scripts/ci/{check-accepted-divergences.test.mjs → bkit-check-accepted-divergences.test.mjs} +3 -3
  257. package/.bkit/templates/scripts/ci/{check-capstone.mjs → bkit-check-capstone.mjs} +2 -2
  258. package/.bkit/templates/scripts/ci/{check-capstone.test.mjs → bkit-check-capstone.test.mjs} +4 -4
  259. package/.bkit/templates/scripts/ci/{check-dependency-audit.mjs → bkit-check-dependency-audit.mjs} +103 -18
  260. package/.bkit/templates/scripts/ci/{check-dependency-audit.test.mjs → bkit-check-dependency-audit.test.mjs} +31 -3
  261. package/.bkit/templates/scripts/ci/bkit-machine-lock.sh +387 -0
  262. package/.bkit/templates/scripts/ci/bkit-test-awake.mjs +75 -0
  263. package/.bkit/templates/scripts/ci/bkit-test-awake.test.mjs +160 -0
  264. package/.bkit/templates/scripts/ci/lanes/{resolve-push-base.mjs → bkit-resolve-push-base.mjs} +3 -3
  265. package/.bkit/templates/scripts/ci/lanes/{resolve-push-base.test.mjs → bkit-resolve-push-base.test.mjs} +4 -4
  266. package/.bkit/templates/scripts/cleanup/bkit-disk-prune.mjs +9 -1
  267. package/.bkit/templates/scripts/graphify/bkit-graph-drift.py +1 -1
  268. package/.bkit/templates/scripts/graphify/bkit-graph-eager.py +3 -3
  269. package/.bkit/templates/scripts/graphify/bkit-graph-embed.py +63 -0
  270. package/.bkit/templates/scripts/graphify/bkit-graph-imports.py +2 -2
  271. package/.bkit/templates/scripts/graphify/bkit-graph-pre-push.sh +69 -18
  272. package/.bkit/templates/scripts/graphify/bkit-graph-repair.py +3 -3
  273. package/.bkit/templates/scripts/graphify/bkit-graph-surface.py +1 -1
  274. package/.bkit/templates/scripts/graphify/bkit-graphify-graphml.py +1 -1
  275. package/.bkit/templates/scripts/graphify/bkit-graphify-rollup.py +197 -126
  276. package/.bkit/templates/scripts/graphify/bkit-graphify.sh +64 -41
  277. package/.bkit/templates/scripts/slop/bkit-slop-type-suppression.mjs +23 -7
  278. package/.bkit/templates/slop-scan.config.json +9 -2
  279. package/CHANGELOG.md +119 -0
  280. package/README.md +250 -76
  281. package/dist/checks/after/auth.js +36 -33
  282. package/dist/checks/after/ci-yml.js +52 -2
  283. package/dist/checks/after/index.js +12 -4
  284. package/dist/checks/after/tools.js +73 -33
  285. package/dist/checks/before/context-fetch.js +218 -33
  286. package/dist/checks/before/env.js +1 -1
  287. package/dist/checks/before/index.js +6 -2
  288. package/dist/checks/before/repo.js +35 -1
  289. package/dist/checks/status-holes.js +739 -114
  290. package/dist/checks/tips/catalogue.js +59 -17
  291. package/dist/checks/tips/detect.js +30 -0
  292. package/dist/checks/tips/index.js +48 -6
  293. package/dist/cli.js +222 -84
  294. package/dist/commands/analysis.js +77 -53
  295. package/dist/commands/ci/ci.js +302 -25
  296. package/dist/commands/ci/pins.js +142 -0
  297. package/dist/commands/ci/push-gate.js +194 -0
  298. package/dist/commands/install/uninstall.js +23 -27
  299. package/dist/commands/install/upgrade.js +21 -11
  300. package/dist/commands/land.js +126 -10
  301. package/dist/commands/lib.js +244 -5
  302. package/dist/commands/registry.js +6 -2
  303. package/dist/commands/setup/setup.js +1 -0
  304. package/dist/commands/stats.js +69 -30
  305. package/dist/commands/workflow/branches.js +1232 -111
  306. package/dist/commands/workflow/challenge.js +90 -37
  307. package/dist/commands/workflow/completeness.js +97 -0
  308. package/dist/commands/workflow/context.js +371 -51
  309. package/dist/commands/workflow/counters.js +206 -40
  310. package/dist/commands/workflow/decisions.js +60 -17
  311. package/dist/commands/workflow/disk.js +213 -55
  312. package/dist/commands/workflow/fids.js +18 -1
  313. package/dist/commands/workflow/issues.js +6 -0
  314. package/dist/commands/workflow/ledgers.js +372 -21
  315. package/dist/commands/workflow/locks.js +2 -0
  316. package/dist/commands/workflow/plan-blocks.js +78 -14
  317. package/dist/commands/workflow/plans.js +205 -0
  318. package/dist/commands/workflow/prs.js +12 -3
  319. package/dist/commands/workflow/repo.js +6 -0
  320. package/dist/commands/workflow/roadmap.js +50 -17
  321. package/dist/commands/workflow/run-facts.js +23 -28
  322. package/dist/commands/workflow/runs.js +530 -33
  323. package/dist/commands/workflow/runtime.js +3 -0
  324. package/dist/commands/workflow/skills.js +1 -0
  325. package/dist/commands/workflow/status.js +166 -19
  326. package/dist/commands/workflow/step-table.js +61 -29
  327. package/dist/commands/workflow/steps.js +542 -26
  328. package/dist/commands/workflow/summary-findings.js +117 -0
  329. package/dist/commands/workflow/summary.js +154 -41
  330. package/dist/commands/workflow/tasks.js +378 -0
  331. package/dist/commands/workflow/test-blocks.js +231 -0
  332. package/dist/commands/workflow/tests-changed.js +172 -0
  333. package/dist/commands/workflow/tests.js +1013 -321
  334. package/dist/commands/workflow/workflows.js +191 -38
  335. package/dist/commands/workflow/worktrees.js +310 -42
  336. package/dist/install/cloud-env.js +233 -99
  337. package/dist/install/context-ci-workflow.js +85 -0
  338. package/dist/install/manifest.js +57 -12
  339. package/dist/install/modules/antigravity.js +3 -2
  340. package/dist/install/modules/cloud.js +3 -3
  341. package/dist/install/modules/codex.js +12 -2
  342. package/dist/install/modules/core.js +851 -53
  343. package/dist/install/modules/cursor.js +6 -6
  344. package/dist/install/modules/opencode.js +11 -5
  345. package/dist/install/template-notes.js +116 -0
  346. package/dist/install/version-file.js +3 -2
  347. package/dist/ledgers/compact.js +87 -0
  348. package/dist/ledgers/journal.js +233 -0
  349. package/dist/ledgers/status.js +115 -5
  350. package/dist/ledgers/telemetry.js +121 -17
  351. package/dist/render/hosts.js +100 -14
  352. package/dist/shared/bkit-latest.js +26 -4
  353. package/dist/shared/dep-updater.js +49 -0
  354. package/dist/shared/egress.js +1 -1
  355. package/dist/shared/package-manager.js +6 -0
  356. package/dist/shared/settings.js +59 -10
  357. package/dist/shared/timeouts.js +2 -0
  358. package/dist/tools/cli-doc.js +97 -0
  359. package/dist/tools/grammar-density.js +1 -1
  360. package/dist/tools/instructions-sources.js +15 -16
  361. package/dist/tools/instructions.js +83 -39
  362. package/package.json +58 -42
  363. package/.bkit/core/.bkit/lite.md +0 -73
  364. package/.bkit/core/engine/commands/workflow/workstreams.ts +0 -172
  365. package/.bkit/core/prompts/bkit-build-plan-execute.md +0 -124
  366. package/.bkit/templates/scripts/ci/bkit-local-stack-lock.sh +0 -194
  367. package/dist/commands/workflow/workstreams.js +0 -149
  368. /package/.bkit/templates/.vale/styles/{House → Bkit}/Filler.yml +0 -0
  369. /package/.bkit/templates/.vale/styles/{House → Bkit}/Hedging.yml +0 -0
  370. /package/.bkit/templates/.vale/styles/{House → Bkit}/LLMSlop.yml +0 -0
  371. /package/.bkit/templates/.vale/styles/{House → Bkit}/Verbose.yml +0 -0
  372. /package/.bkit/templates/scripts/ci/{accepted-advisories.json → bkit-accepted-advisories.json} +0 -0
  373. /package/.bkit/templates/scripts/ci/{accepted-divergences.json → bkit-accepted-divergences.json} +0 -0
  374. /package/.bkit/templates/scripts/launchd/{launchd.env.example → bkit-launchd.env.example} +0 -0
  375. /package/.bkit/templates/scripts/launchd/{ai.bkit.launchd.plist → bkit-launchd.plist} +0 -0
@@ -0,0 +1,194 @@
1
+ // Local full-gate receipts, shared by linked worktrees and bound to committed trees.
2
+ import { spawnSync } from "node:child_process";
3
+ import { createHash, randomUUID } from "node:crypto";
4
+ import * as fs from "node:fs";
5
+ import * as os from "node:os";
6
+ import * as path from "node:path";
7
+ import { gitEnv } from "../../ledgers/telemetry.js";
8
+ import { parseJson, readJsonFile } from "../../shared/json.js";
9
+ import { readPackageJson } from "../../shared/package-json.js";
10
+ import { scriptCommand, testCommand } from "../../shared/package-manager.js";
11
+ import { EXIT, git, outboxRoot, runGit } from "../lib.js";
12
+ import { changedOutside } from "../workflow/ledgers.js";
13
+ const UNIT = "bkit:gate:static-unit";
14
+ const INTEGRATION = "bkit:gate:static-unit-integration";
15
+ const SHA = /^(?:[0-9a-f]{40}|[0-9a-f]{64})$/;
16
+ function scriptsOf(pkg) {
17
+ if (!pkg || typeof pkg !== "object" || !("scripts" in pkg))
18
+ return null;
19
+ const scripts = pkg.scripts;
20
+ if (!scripts || typeof scripts !== "object" || Array.isArray(scripts))
21
+ return null;
22
+ return scripts;
23
+ }
24
+ function gateDefinition(pkg) {
25
+ const values = scriptsOf(pkg);
26
+ if (!values)
27
+ return null;
28
+ const gate = typeof values[INTEGRATION] === "string" ? INTEGRATION : UNIT;
29
+ if (typeof values[gate] !== "string" || values[gate].trim() === "")
30
+ return null;
31
+ const fingerprint = createHash("sha256")
32
+ .update(JSON.stringify(Object.entries(values).sort(([a], [b]) => a.localeCompare(b))))
33
+ .digest("hex");
34
+ return { gate, fingerprint };
35
+ }
36
+ /** The deepest full push gate declared by this checkout. */
37
+ export function requiredPushGate(cwd) {
38
+ const pkg = readPackageJson(cwd);
39
+ return pkg.ok ? (gateDefinition(pkg.pkg)?.gate ?? null) : null;
40
+ }
41
+ const receiptPath = (cwd, sha) => {
42
+ const outbox = outboxRoot(cwd);
43
+ return outbox ? path.join(outbox, "push-gates", `${sha}.json`) : null;
44
+ };
45
+ function cleanHead(cwd) {
46
+ const status = git(cwd, [
47
+ "status",
48
+ "--porcelain",
49
+ "--untracked-files=all",
50
+ "--ignore-submodules=none",
51
+ ]);
52
+ if (status !== "")
53
+ return null;
54
+ const sha = git(cwd, ["rev-parse", "--verify", "HEAD^{commit}"]);
55
+ const tree = git(cwd, ["rev-parse", "--verify", "HEAD^{tree}"]);
56
+ return sha && tree ? { sha, tree } : null;
57
+ }
58
+ /** Execute a consumer gate; only a successful deepest full gate on an unchanged clean tree earns proof. */
59
+ export function runPushGate(cwd, gate, log) {
60
+ const pkg = readPackageJson(cwd);
61
+ const script = pkg.ok ? scriptsOf(pkg.pkg)?.[gate] : null;
62
+ if (typeof script !== "string" || script.trim() === "") {
63
+ log(`package.json must declare a non-empty ${gate} script`);
64
+ return EXIT.USAGE;
65
+ }
66
+ const definition = pkg.ok ? gateDefinition(pkg.pkg) : null;
67
+ const before = cleanHead(cwd);
68
+ const head = git(cwd, ["rev-parse", "--verify", "HEAD^{commit}"]);
69
+ const file = head ? receiptPath(cwd, head) : null;
70
+ const attempt = file && definition?.gate === gate ? path.join(`${file}.running`, randomUUID()) : null;
71
+ const fail = () => {
72
+ if (!attempt || !file)
73
+ return;
74
+ fs.mkdirSync(path.dirname(file), { recursive: true });
75
+ fs.writeFileSync(`${file}.failed`, JSON.stringify({ version: 1, sha: head, gate, passed: false }) + "\n");
76
+ fs.rmSync(file, { force: true });
77
+ };
78
+ if (attempt) {
79
+ fs.mkdirSync(path.dirname(attempt), { recursive: true });
80
+ fs.writeFileSync(attempt, JSON.stringify({ pid: process.pid, sha: head }) + "\n");
81
+ fail();
82
+ }
83
+ const finish = (code) => {
84
+ if (attempt)
85
+ fs.rmSync(attempt, { force: true });
86
+ return code;
87
+ };
88
+ const argv = testCommand(scriptCommand(gate));
89
+ log(`running ${scriptCommand(gate).join(" ")}`);
90
+ const result = spawnSync(argv[0], argv.slice(1), {
91
+ cwd,
92
+ env: gitEnv(),
93
+ stdio: ["ignore", 2, 2],
94
+ });
95
+ const status = result.error
96
+ ? 127
97
+ : (result.status ??
98
+ 128 + ((result.signal ? os.constants.signals[result.signal] : undefined) ?? 1));
99
+ if (result.error)
100
+ log(result.error.message);
101
+ if (status !== 0 || !before || definition?.gate !== gate) {
102
+ fail();
103
+ return finish(status);
104
+ }
105
+ const after = cleanHead(cwd);
106
+ const afterPkg = readPackageJson(cwd);
107
+ if (after?.sha !== before.sha ||
108
+ after.tree !== before.tree ||
109
+ !afterPkg.ok ||
110
+ gateDefinition(afterPkg.pkg)?.fingerprint !== definition.fingerprint) {
111
+ log("full gate passed, but the checkout changed — no reusable push receipt");
112
+ fail();
113
+ return finish(status);
114
+ }
115
+ if (file) {
116
+ fs.mkdirSync(path.dirname(file), { recursive: true });
117
+ fs.writeFileSync(file, JSON.stringify({ version: 1, ...before, ...definition, passed: true }) + "\n");
118
+ fs.rmSync(`${file}.failed`, { force: true });
119
+ log(`recorded full push gate for ${before.sha}`);
120
+ }
121
+ return finish(status);
122
+ }
123
+ /** Pending files survive interrupted runners; one read suffices to block earlier proof. */
124
+ function pendingAttempt(file) {
125
+ const dir = `${file}.running`;
126
+ if (!fs.existsSync(dir))
127
+ return false;
128
+ const handle = fs.opendirSync(dir);
129
+ try {
130
+ return handle.readSync() !== null;
131
+ }
132
+ finally {
133
+ handle.closeSync();
134
+ }
135
+ }
136
+ function validReceipt(cwd, file, sha, definition) {
137
+ const read = readJsonFile(file);
138
+ if (!read.ok || !read.value || typeof read.value !== "object")
139
+ return false;
140
+ const receipt = read.value;
141
+ return (receipt.version === 1 &&
142
+ receipt.passed === true &&
143
+ receipt.sha === sha &&
144
+ receipt.gate === definition.gate &&
145
+ receipt.fingerprint === definition.fingerprint &&
146
+ receipt.tree === git(cwd, ["rev-parse", `${sha}^{tree}`]));
147
+ }
148
+ /** Every commit not covered by this success must be free of failed or unreadable gate evidence. */
149
+ function noLaterFailure(cwd, dir, sha, newSha, definition) {
150
+ const range = git(cwd, ["rev-list", "--max-count=129", newSha, `^${sha}`]);
151
+ if (range === null)
152
+ return false;
153
+ const commits = range ? range.split("\n") : [];
154
+ if (commits.length > 128)
155
+ return false;
156
+ for (const commit of [sha, ...commits]) {
157
+ const file = path.join(dir, `${commit}.json`);
158
+ if (fs.existsSync(`${file}.failed`) ||
159
+ pendingAttempt(file) ||
160
+ (fs.existsSync(file) && !validReceipt(cwd, file, commit, definition)))
161
+ return false;
162
+ }
163
+ return true;
164
+ }
165
+ /** A bounded ancestor search; absent, malformed or stale proof always requires the full gate. */
166
+ export function hasVerifiedIncrement(cwd, oldSha, newSha, paths) {
167
+ if (!SHA.test(oldSha) ||
168
+ !SHA.test(newSha) ||
169
+ /^0+$/.test(oldSha) ||
170
+ !runGit(cwd, ["merge-base", "--is-ancestor", oldSha, newSha]).ok)
171
+ return false;
172
+ const raw = git(cwd, ["show", `${newSha}:package.json`]);
173
+ const parsed = raw === null ? null : parseJson(raw);
174
+ const definition = parsed?.ok ? gateDefinition(parsed.value) : null;
175
+ const localPkg = readPackageJson(cwd);
176
+ if (!definition ||
177
+ !localPkg.ok ||
178
+ gateDefinition(localPkg.pkg)?.fingerprint !== definition.fingerprint)
179
+ return false;
180
+ const ancestors = git(cwd, ["rev-list", "--max-count=128", oldSha]);
181
+ const firstFile = receiptPath(cwd, oldSha);
182
+ if (!ancestors || !firstFile)
183
+ return false;
184
+ const dir = path.dirname(firstFile);
185
+ for (const sha of ancestors.split("\n")) {
186
+ const file = path.join(dir, `${sha}.json`);
187
+ if (!validReceipt(cwd, file, sha, definition))
188
+ continue;
189
+ const diff = changedOutside(cwd, sha, newSha, paths);
190
+ if (diff.ok && diff.outside.length === 0 && noLaterFailure(cwd, dir, sha, newSha, definition))
191
+ return true;
192
+ }
193
+ return false;
194
+ }
@@ -35,7 +35,7 @@ import { applyModelOverrides, buildOpencodeModelLookup, parseEffortMap, } from "
35
35
  import { readInstallingVersion } from "../../shared/package-json.js";
36
36
  import { readBkitConfig } from "../../shared/settings.js";
37
37
  import { SEEDED_BKIT_DEFAULTS } from "../../install/modules/core.js";
38
- import { CLAUDE_CLOUD_RELPATH, CURSOR_CLOUD_RELPATH, resolveClaudeDerivedAllows, } from "../../install/cloud-env.js";
38
+ import { CLAUDE_CLOUD_RELPATH, CODEX_CLOUD_RELPATH, CURSOR_CLOUD_RELPATH, resolveClaudeDerivedAllows, } from "../../install/cloud-env.js";
39
39
  import { LOG_PREFIX, setLogPrefix } from "../../shared/log-prefix.js";
40
40
  import { unusedTrackerMcpServers } from "../../checks/before/mcp.js";
41
41
  // ---------------------------------------------------------------------------
@@ -258,8 +258,10 @@ const CORE_TEMPLATE_DOCTRINE = [
258
258
  { path: ".agents/docs.md", format: "markered-text", module: "core" },
259
259
  { path: ".agents/rules.md", format: "markered-text", module: "core" },
260
260
  { path: ".agents/skills.md", format: "markered-text", module: "core" },
261
- // Retired path of `.bkit/lite.md` (5.1.0 – 5.2.4), for an install never upgraded since.
261
+ // Retired `.agents/shortcuts.md` (5.1.0 – 5.2.4), for an install never upgraded since.
262
262
  { path: ".agents/shortcuts.md", format: "markered-text", module: "core" },
263
+ // Retired `.bkit/lite.md` (5.2.5 – 6.0.0), for an install never upgraded since.
264
+ { path: ".bkit/lite.md", format: "markered-text", module: "core" },
263
265
  ];
264
266
  /**
265
267
  * The top-level `docs/*.md` the core payload pass installs: each carries bkit's managed
@@ -752,31 +754,25 @@ export async function runUninstall(modules, ctx) {
752
754
  }
753
755
  }
754
756
  }
755
- // Remove the generated `.claude/bkit-cloud.md` (untracked, gitignored — holds resolved
756
- // secrets). It is not in the manifest, so the table-driven pass never sees it;
757
- // delete it explicitly when the claude host is uninstalled so a live-secrets file
758
- // is never left behind. Pushed to result.deleted so a dry-run reports it too.
759
- if (moduleList.includes("claude")) {
760
- const cloudAbs = path.join(ctx.cwd, CLAUDE_CLOUD_RELPATH);
761
- if (fs.existsSync(cloudAbs)) {
762
- result.deleted.push(CLAUDE_CLOUD_RELPATH);
763
- if (!ctx.dryRun) {
764
- fs.rmSync(cloudAbs, { force: true });
765
- console.log(`${ctx.logPrefix} delete: ${CLAUDE_CLOUD_RELPATH} (generated cloud setup doc)`);
766
- }
767
- }
768
- }
769
- // Same for the Cursor twin `.cursor/bkit-cloud.md` (writeCursorCloudDoc) — untracked,
770
- // gitignored, holds resolved secrets; delete it explicitly when the cursor host is
771
- // uninstalled so a live-secrets file is never left behind.
772
- if (moduleList.includes("cursor")) {
773
- const cloudAbs = path.join(ctx.cwd, CURSOR_CLOUD_RELPATH);
774
- if (fs.existsSync(cloudAbs)) {
775
- result.deleted.push(CURSOR_CLOUD_RELPATH);
776
- if (!ctx.dryRun) {
777
- fs.rmSync(cloudAbs, { force: true });
778
- console.log(`${ctx.logPrefix} delete: ${CURSOR_CLOUD_RELPATH} (generated cloud setup doc)`);
779
- }
757
+ // Remove each uninstalled host's generated `<host>/bkit-cloud.md` (untracked,
758
+ // gitignored — holds resolved secrets). Not in the manifest, so the table-driven pass
759
+ // never sees them; delete explicitly so a live-secrets file is never left behind.
760
+ // Pushed to result.deleted so a dry-run reports them too.
761
+ const cloudDocs = [
762
+ ["claude", CLAUDE_CLOUD_RELPATH],
763
+ ["cursor", CURSOR_CLOUD_RELPATH],
764
+ ["codex", CODEX_CLOUD_RELPATH],
765
+ ];
766
+ for (const [host, relPath] of cloudDocs) {
767
+ if (!moduleList.includes(host))
768
+ continue;
769
+ const cloudAbs = path.join(ctx.cwd, relPath);
770
+ if (!fs.existsSync(cloudAbs))
771
+ continue;
772
+ result.deleted.push(relPath);
773
+ if (!ctx.dryRun) {
774
+ fs.rmSync(cloudAbs, { force: true });
775
+ console.log(`${ctx.logPrefix} delete: ${relPath} (generated cloud setup doc)`);
780
776
  }
781
777
  }
782
778
  // Full/core uninstall: the consumer's template copies (`.bkit/templates/`) are
@@ -37,7 +37,7 @@ import { readBkitConfig } from "../../shared/settings.js";
37
37
  import { detectInstalledHostModules } from "../../install/hosts.js";
38
38
  import { detectInstalledModules } from "./check.js";
39
39
  import { remapTemplateDest } from "../../install/template-copies.js";
40
- import { CLAUDE_CLOUD_RELPATH, CURSOR_CLOUD_RELPATH, writeClaudeCloudDoc, writeCursorCloudDoc, writeCursorCliPermissionsArtifact, } from "../../install/cloud-env.js";
40
+ import { CLAUDE_CLOUD_RELPATH, CODEX_CLOUD_RELPATH, CURSOR_CLOUD_RELPATH, writeClaudeCloudDoc, writeCodexCloudDoc, writeCursorCloudDoc, writeCursorCliPermissionsArtifact, } from "../../install/cloud-env.js";
41
41
  import { syncTemplateCopies, formatTemplateChanges } from "../../install/template-copies.js";
42
42
  import { formatPayloadLinkChanges, syncPayloadLinks } from "../../install/payload-links.js";
43
43
  import { renderOpencodeJson, reconcileOpencodeJson } from "../../install/modules/opencode.js";
@@ -512,14 +512,17 @@ export async function runUpgradeCommand(upgradeFlags) {
512
512
  else if (ent.isFile()) {
513
513
  // Single shared dotfile remap (gitignore → .gitignore, npmignore → .npmignore).
514
514
  const relPath = remapTemplateDest(entRel);
515
- // `.claude/bkit-cloud.md` + `.cursor/bkit-cloud.md` are GENERATED output files
516
- // (writeClaudeCloudDoc / writeCursorCloudDoc), not payload files to reconcile:
517
- // install/upgrade regenerate them with resolved secret values, so the raw
518
- // source is never a byte-match and the walk must never drift-flag or
515
+ // `.claude/` + `.cursor/` + `.codex/bkit-cloud.md` are GENERATED output files
516
+ // (writeClaudeCloudDoc / writeCursorCloudDoc / writeCodexCloudDoc), not payload
517
+ // files to reconcile: install/upgrade regenerate them with resolved secret values,
518
+ // so the raw source is never a byte-match and the walk must never drift-flag or
519
519
  // overwrite them. Regenerated explicitly in the runUpgrade block below
520
520
  // (host-gated, non-dry-run).
521
- if (relPath === CLAUDE_CLOUD_RELPATH || relPath === CURSOR_CLOUD_RELPATH)
521
+ if (relPath === CLAUDE_CLOUD_RELPATH ||
522
+ relPath === CURSOR_CLOUD_RELPATH ||
523
+ relPath === CODEX_CLOUD_RELPATH) {
522
524
  continue;
525
+ }
523
526
  if (relPath === MCP_ROOT_RELPATH || relPath === CURSOR_MCP_RELPATH)
524
527
  continue;
525
528
  const entry = entryByPath.get(relPath);
@@ -725,14 +728,19 @@ export async function runUpgradeCommand(upgradeFlags) {
725
728
  console.log(`${LOG_PREFIX} upgrade: .claude/bkit-cloud.md (regenerated — gitignored, holds resolved secrets)`);
726
729
  }
727
730
  }
728
- // Same for `.cursor/bkit-cloud.md` — cursor-host-gated twin (see writeCursorCloudDoc).
729
- // Uses upgradeTracker so the Linear/GitHub env-var policy matches the installed
730
- // tracker; excluded from the payload walk above for the same reason as the Claude doc.
731
+ // Same for `.cursor/bkit-cloud.md` and `.codex/bkit-cloud.md` — host-gated twins (see
732
+ // writeCursorCloudDoc / writeCodexCloudDoc); excluded from the payload walk above for
733
+ // the same reason as the Claude doc.
731
734
  if (!upgradeFlags.dryRun && renderModules.has("cursor") && tokens) {
732
- if (writeCursorCloudDoc(process.cwd(), tokens, upgradeTracker)) {
735
+ if (writeCursorCloudDoc(process.cwd(), tokens)) {
733
736
  console.log(`${LOG_PREFIX} upgrade: .cursor/bkit-cloud.md (regenerated — gitignored, holds resolved secrets)`);
734
737
  }
735
738
  }
739
+ if (!upgradeFlags.dryRun && renderModules.has("codex") && tokens) {
740
+ if (writeCodexCloudDoc(process.cwd(), tokens)) {
741
+ console.log(`${LOG_PREFIX} upgrade: .codex/bkit-cloud.md (regenerated — gitignored, holds resolved secrets)`);
742
+ }
743
+ }
736
744
  // Network allowlist + MCP allows — OpenCode from renderOpencodeJson; Claude enrich
737
745
  // below; `.bkit/allowlist.json` in renderManagedOutputs above; Cursor
738
746
  // `.cursor/cli.json` only when cursor module installed. Written artifacts get their
@@ -763,7 +771,9 @@ export async function runUpgradeCommand(upgradeFlags) {
763
771
  // exit), so feed those writes into canonicalHashes — keeping install/upgrade `.bkit/version`
764
772
  // parity.
765
773
  if (!upgradeFlags.dryRun) {
766
- const renderedDocPaths = renderWs.writes.map((w) => path.relative(process.cwd(), path.isAbsolute(w.path) ? w.path : path.resolve(process.cwd(), w.path)));
774
+ const renderedDocPaths = renderWs.writes
775
+ .filter((w) => !w.unhashed)
776
+ .map((w) => path.relative(process.cwd(), path.isAbsolute(w.path) ? w.path : path.resolve(process.cwd(), w.path)));
767
777
  updateCanonicalHashesAfterUpgrade({
768
778
  updated: [
769
779
  ...result.updated,
@@ -6,12 +6,19 @@
6
6
  // dev and push again, with backoff. Used by the design / plan close, the
7
7
  // build / debug roadmap mirror, ship's close and FAILED record, and the
8
8
  // own-commit push of a debug run in place on dev, which replays the run's
9
- // commits. The throwaway runs no git hooks: it lands bookkeeping (docs, logs,
10
- // ledgers, `[skip ci]`) or the commits a debug run on dev made.
9
+ // commits. The throwaway runs its declared gate explicitly before pushing.
10
+ import { spawnSync } from "node:child_process";
11
11
  import * as fs from "node:fs";
12
12
  import * as path from "node:path";
13
13
  import { CommandError, DEV, EXIT, git, runGit } from "./lib.js";
14
14
  import { TIMEOUTS } from "../shared/timeouts.js";
15
+ import { gitEnv } from "../ledgers/telemetry.js";
16
+ import { readBkitConfig } from "../shared/settings.js";
17
+ import { readPackageJson } from "../shared/package-json.js";
18
+ import { installCommand } from "../shared/package-manager.js";
19
+ import { minPushPathspecs } from "./ci/ci.js";
20
+ import { requiredPushGate, runPushGate } from "./ci/push-gate.js";
21
+ import { changedOutside } from "./workflow/ledgers.js";
15
22
  const REMOTE = "origin";
16
23
  const UPSTREAM = `${REMOTE}/${DEV}`;
17
24
  /** dev moved before git sent anything: git compared the remote's dev and stopped. */
@@ -20,6 +27,20 @@ const MOVED_BEFORE = /\[rejected\][^\n]*\((?:fetch first|non-fast-forward)\)/;
20
27
  const MOVED_DURING = /\[remote rejected\][^\n]*\((?:incorrect old value provided|cannot lock ref[^\n]*)\)/;
21
28
  /** The server turned the push away: branch protection, a ruleset, an HTTP 403. */
22
29
  const REFUSED = /\[remote rejected\]|returned error: 403|\bGH0\d\d\b/;
30
+ /**
31
+ * The refspec every dev fetch uses. A bare `git fetch origin dev` writes only
32
+ * FETCH_HEAD when the clone's fetch refspec does not cover `dev` (a single-branch
33
+ * clone), leaving `origin/dev` stale; a landing built on it is rejected on every push.
34
+ */
35
+ export const DEV_REFSPEC = `+refs/heads/${DEV}:refs/remotes/${UPSTREAM}`;
36
+ /** Fetch origin's dev into `origin/dev`, whatever the clone's fetch refspec covers. */
37
+ export const fetchDev = (cwd) => runGit(cwd, ["fetch", REMOTE, DEV_REFSPEC]);
38
+ /**
39
+ * A dev fetch that failed only because another git process in this clone (a
40
+ * second landing's fetch or push) updated or held `origin/dev` while it ran.
41
+ */
42
+ const DEV_REF_RACE = new RegExp(`cannot lock ref 'refs/remotes/${UPSTREAM}'`);
43
+ export const devRefRace = (stderr) => DEV_REF_RACE.test(stderr);
23
44
  /** A dev push rejected only because dev moved: rebuild on the new dev, push again. */
24
45
  export const devMoved = (stderr) => MOVED_BEFORE.test(stderr) || MOVED_DURING.test(stderr);
25
46
  /** A dev push the server refused for a reason other than dev moving. */
@@ -81,27 +102,119 @@ export async function withoutHooks(fn) {
81
102
  delete process.env[value];
82
103
  }
83
104
  }
105
+ /** Copy ignored inputs without replacing anything in the built checkout. */
106
+ function prepareLandInputs(root, dir, log) {
107
+ const config = readBkitConfig(dir);
108
+ const sourceRoot = fs.realpathSync(root);
109
+ for (const entry of config.worktreeCopy) {
110
+ const relative = path.normalize(entry);
111
+ if (path.isAbsolute(relative) || relative === ".." || relative.startsWith(`..${path.sep}`)) {
112
+ log(`landing input is outside the checkout — skipped: ${entry}`);
113
+ continue;
114
+ }
115
+ const source = path.join(root, relative);
116
+ const destination = path.join(dir, relative);
117
+ const tracked = runGit(dir, ["ls-files", "--", relative]);
118
+ if (!tracked.ok)
119
+ throw new CommandError(EXIT.NO, `cannot inspect landing input: ${entry}`);
120
+ if (tracked.stdout || fs.existsSync(destination))
121
+ continue;
122
+ if (!runGit(dir, ["check-ignore", "-q", "--", relative]).ok)
123
+ continue;
124
+ if (!fs.existsSync(source)) {
125
+ log(`landing input absent in the main checkout: ${entry}`);
126
+ continue;
127
+ }
128
+ fs.mkdirSync(path.dirname(destination), { recursive: true });
129
+ fs.cpSync(source, destination, {
130
+ recursive: true,
131
+ dereference: true,
132
+ filter: (file) => {
133
+ const actual = fs.realpathSync(file);
134
+ if (actual !== sourceRoot && !actual.startsWith(`${sourceRoot}${path.sep}`)) {
135
+ throw new CommandError(EXIT.NO, `landing input resolves outside the checkout: ${entry}`);
136
+ }
137
+ return true;
138
+ },
139
+ });
140
+ }
141
+ if (config.worktreeInstall) {
142
+ const [command, ...args] = installCommand({ frozen: true });
143
+ if (!fs.existsSync(path.join(dir, "pnpm-workspace.yaml")))
144
+ args.push("--ignore-workspace");
145
+ log("installing frozen dependencies in the throwaway dev checkout");
146
+ const result = spawnSync(command, args, {
147
+ cwd: dir,
148
+ env: gitEnv(),
149
+ encoding: "utf8",
150
+ maxBuffer: 1 << 26,
151
+ });
152
+ if (result.error || result.status !== 0) {
153
+ for (const line of `${result.stdout ?? ""}${result.stderr ?? ""}`
154
+ .trim()
155
+ .split("\n")
156
+ .slice(-20))
157
+ log(line);
158
+ throw new CommandError(EXIT.NO, "landing dependency install failed — nothing pushed");
159
+ }
160
+ }
161
+ }
162
+ /** Validate the committed landing against the freshly fetched base before sending it. */
163
+ function checkLanding(root, dir, base, log) {
164
+ const head = git(dir, ["rev-parse", "HEAD"]);
165
+ const unchanged = () => head !== null &&
166
+ git(dir, ["rev-parse", "HEAD"]) === head &&
167
+ git(dir, ["status", "--porcelain", "--untracked-files=all", "--ignore-submodules=none"]) === "";
168
+ if (!unchanged())
169
+ throw new CommandError(EXIT.NO, "landing checkout is not clean — nothing pushed");
170
+ if (!readPackageJson(dir).ok)
171
+ throw new CommandError(EXIT.NO, "landing package.json is unreadable — nothing pushed");
172
+ const diff = changedOutside(dir, base, head, minPushPathspecs(readBkitConfig(dir)));
173
+ if (!diff.ok)
174
+ throw new CommandError(EXIT.NO, `cannot classify landing: ${diff.stderr}`);
175
+ const gate = diff.outside.length === 0 ? "bkit:gate:min" : requiredPushGate(dir);
176
+ if (!gate)
177
+ throw new CommandError(EXIT.NO, "landing has no declared full gate — nothing pushed");
178
+ prepareLandInputs(root, dir, log);
179
+ if (!unchanged())
180
+ throw new CommandError(EXIT.NO, "landing preparation changed the checkout — nothing pushed");
181
+ const status = runPushGate(dir, gate, log);
182
+ if (status !== 0)
183
+ throw new CommandError(EXIT.NO, `landing ${gate} failed (exit ${status}) — nothing pushed`);
184
+ if (!unchanged())
185
+ throw new CommandError(EXIT.NO, "landing gate changed the checkout — nothing pushed");
186
+ }
84
187
  /**
85
188
  * Land on dev what `build` makes: per attempt, fetch dev, add `dir` detached at
86
189
  * origin/dev, let `build` make one or more commits there (a bookkeeping commit,
87
- * or a replay of a run's commits), push `HEAD:dev` — git hooks off. `build`
190
+ * or a replay of a run's commits), validate the checkout, then push `HEAD:dev`.
191
+ * Git hooks are off; the minimum or full local gate runs explicitly. `build`
88
192
  * throwing stops the landing with that throw. A server refusal runs `refused` on
89
- * the built commits first, when given. `dir` is removed on every path.
193
+ * the built commits first, when given. dev moving, or another landing in this
194
+ * clone updating `origin/dev` during the fetch, retries with backoff within
195
+ * LAND_ATTEMPTS. `dir` is removed on every path.
90
196
  */
91
197
  export async function pushToDev(o) {
92
- o.log("git hooks skipped in the throwaway dev checkout — it lands bookkeeping, or the commits a debug run on dev made");
198
+ o.log("git hooks skipped in the throwaway dev checkout — its declared minimum or full gate runs explicitly");
93
199
  for (let attempt = 1;; attempt++) {
94
200
  let wait = 0;
95
201
  dropLandTree(o.root, o.dir);
96
202
  try {
97
203
  const outcome = await withoutHooks(async () => {
98
- const fetched = runGit(o.root, ["fetch", REMOTE, DEV]);
99
- if (!fetched.ok)
204
+ const fetched = fetchDev(o.root);
205
+ if (!fetched.ok) {
206
+ if (devRefRace(fetched.stderr) && attempt < TIMEOUTS.LAND_ATTEMPTS)
207
+ return "raced";
100
208
  return { kind: "fetch-failed", stderr: fetched.stderr };
209
+ }
101
210
  const added = runGit(o.root, ["worktree", "add", "--detach", o.dir, UPSTREAM]);
102
211
  if (!added.ok)
103
212
  return { kind: "setup-failed", stderr: added.stderr };
213
+ const base = git(o.dir, ["rev-parse", "HEAD"]);
214
+ if (!base)
215
+ throw new CommandError(EXIT.NO, "cannot read the fetched landing base");
104
216
  o.build(o.dir, attempt);
217
+ checkLanding(o.root, o.dir, base, o.log);
105
218
  const pushed = runGit(o.dir, ["push", REMOTE, `HEAD:${DEV}`]);
106
219
  if (pushed.ok) {
107
220
  return {
@@ -116,14 +229,17 @@ export async function pushToDev(o) {
116
229
  }
117
230
  if (!devMoved(pushed.stderr))
118
231
  return { kind: "push-failed", stderr: pushed.stderr };
119
- return null;
232
+ return "moved";
120
233
  });
121
- if (outcome !== null)
234
+ if (typeof outcome !== "string")
122
235
  return outcome;
123
236
  if (attempt >= TIMEOUTS.LAND_ATTEMPTS)
124
237
  return { kind: "exhausted", attempts: attempt };
125
238
  wait = landBackoffMs(attempt);
126
- o.log(`dev moved before push ${attempt} of ${TIMEOUTS.LAND_ATTEMPTS} — rebuilding on the new dev in ${(wait / 1000).toFixed(1)}s`);
239
+ const s = (wait / 1000).toFixed(1);
240
+ o.log(outcome === "moved"
241
+ ? `dev moved before push ${attempt} of ${TIMEOUTS.LAND_ATTEMPTS} — rebuilding on the new dev in ${s}s`
242
+ : `another git process updated ${UPSTREAM} during the fetch of try ${attempt} of ${TIMEOUTS.LAND_ATTEMPTS} — fetching again in ${s}s`);
127
243
  }
128
244
  finally {
129
245
  dropLandTree(o.root, o.dir);