@cbartens/bkit 5.5.1 → 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 (425) hide show
  1. package/.bkit/README.md +167 -154
  2. package/.bkit/core/.agents/context.md +95 -29
  3. package/.bkit/core/.agents/docs.md +18 -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 +112 -102
  9. package/.bkit/core/.agents/skills.md +63 -15
  10. package/.bkit/core/.bkit/README.md +167 -154
  11. package/.bkit/core/.bkit/authoring.md +747 -0
  12. package/.bkit/core/.bkit/cli.md +407 -0
  13. package/.bkit/core/.bkit/cloud.md +283 -195
  14. package/.bkit/core/.bkit/comparison.md +45 -43
  15. package/.bkit/core/.bkit/install.md +166 -95
  16. package/.bkit/core/.bkit/jsonl.md +339 -196
  17. package/.bkit/core/.bkit/pipeline.md +142 -145
  18. package/.bkit/core/.bkit/prompts.md +295 -264
  19. package/.bkit/core/.bkit/providers.md +460 -277
  20. package/.bkit/core/.bkit/router.md +69 -0
  21. package/.bkit/core/.bkit/templates.md +530 -256
  22. package/.bkit/core/.bkit/trackers.md +116 -65
  23. package/.bkit/core/.bkit/workflows.md +742 -618
  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 +6 -80
  33. package/.bkit/core/docs/templates/bkit-audit-accessibility.md +128 -130
  34. package/.bkit/core/docs/templates/bkit-audit-adoption.md +104 -94
  35. package/.bkit/core/docs/templates/bkit-audit-agents.md +96 -98
  36. package/.bkit/core/docs/templates/bkit-audit-aio-seo.md +100 -103
  37. package/.bkit/core/docs/templates/bkit-audit-analytics.md +141 -107
  38. package/.bkit/core/docs/templates/bkit-audit-annotations.md +99 -97
  39. package/.bkit/core/docs/templates/bkit-audit-app-performance.md +122 -121
  40. package/.bkit/core/docs/templates/bkit-audit-app-store.md +158 -101
  41. package/.bkit/core/docs/templates/bkit-audit-architecture.md +114 -96
  42. package/.bkit/core/docs/templates/bkit-audit-ci-performance.md +76 -97
  43. package/.bkit/core/docs/templates/bkit-audit-config.md +123 -101
  44. package/.bkit/core/docs/templates/bkit-audit-cost.md +86 -99
  45. package/.bkit/core/docs/templates/bkit-audit-coverage.md +76 -93
  46. package/.bkit/core/docs/templates/bkit-audit-database.md +102 -95
  47. package/.bkit/core/docs/templates/bkit-audit-dead-code.md +165 -108
  48. package/.bkit/core/docs/templates/bkit-audit-deferrals.md +115 -109
  49. package/.bkit/core/docs/templates/bkit-audit-dependencies.md +265 -113
  50. package/.bkit/core/docs/templates/bkit-audit-documentation.md +119 -118
  51. package/.bkit/core/docs/templates/bkit-audit-duplication.md +140 -111
  52. package/.bkit/core/docs/templates/bkit-audit-failures.md +111 -106
  53. package/.bkit/core/docs/templates/bkit-audit-flakes.md +100 -99
  54. package/.bkit/core/docs/templates/bkit-audit-gates.md +107 -103
  55. package/.bkit/core/docs/templates/bkit-audit-issues.md +105 -105
  56. package/.bkit/core/docs/templates/bkit-audit-llm.md +134 -85
  57. package/.bkit/core/docs/templates/bkit-audit-logs.md +124 -125
  58. package/.bkit/core/docs/templates/bkit-audit-models.md +99 -78
  59. package/.bkit/core/docs/templates/bkit-audit-privacy.md +56 -76
  60. package/.bkit/core/docs/templates/bkit-audit-prompts.md +63 -78
  61. package/.bkit/core/docs/templates/bkit-audit-red-team.md +125 -93
  62. package/.bkit/core/docs/templates/bkit-audit-reliability.md +97 -96
  63. package/.bkit/core/docs/templates/bkit-audit-repo.md +170 -98
  64. package/.bkit/core/docs/templates/bkit-audit-security.md +207 -121
  65. package/.bkit/core/docs/templates/bkit-audit-slop.md +78 -95
  66. package/.bkit/core/docs/templates/bkit-audit-testing.md +163 -139
  67. package/.bkit/core/docs/templates/bkit-audit-usability.md +114 -96
  68. package/.bkit/core/docs/templates/bkit-plan.md +158 -281
  69. package/.bkit/core/engine/checks/after/auth.ts +40 -37
  70. package/.bkit/core/engine/checks/after/ci-yml.ts +104 -31
  71. package/.bkit/core/engine/checks/after/github.ts +95 -17
  72. package/.bkit/core/engine/checks/after/index.ts +21 -8
  73. package/.bkit/core/engine/checks/after/suppression.ts +8 -5
  74. package/.bkit/core/engine/checks/after/tools.ts +125 -123
  75. package/.bkit/core/engine/checks/before/context-fetch.ts +227 -33
  76. package/.bkit/core/engine/checks/before/env.ts +3 -3
  77. package/.bkit/core/engine/checks/before/files.ts +5 -4
  78. package/.bkit/core/engine/checks/before/index.ts +25 -1
  79. package/.bkit/core/engine/checks/before/repo.ts +208 -2
  80. package/.bkit/core/engine/checks/status-holes.ts +916 -123
  81. package/.bkit/core/engine/checks/tips/catalogue.ts +82 -20
  82. package/.bkit/core/engine/checks/tips/detect.ts +66 -0
  83. package/.bkit/core/engine/checks/tips/index.ts +52 -11
  84. package/.bkit/core/engine/cli.ts +251 -130
  85. package/.bkit/core/engine/commands/analysis.ts +282 -199
  86. package/.bkit/core/engine/commands/ci/ci.ts +363 -29
  87. package/.bkit/core/engine/commands/ci/pins.ts +172 -0
  88. package/.bkit/core/engine/commands/ci/push-gate.ts +223 -0
  89. package/.bkit/core/engine/commands/comply.ts +77 -103
  90. package/.bkit/core/engine/commands/install/doctor.ts +2 -2
  91. package/.bkit/core/engine/commands/install/install.ts +57 -18
  92. package/.bkit/core/engine/commands/install/uninstall.ts +86 -55
  93. package/.bkit/core/engine/commands/install/upgrade.ts +32 -15
  94. package/.bkit/core/engine/commands/land.ts +139 -18
  95. package/.bkit/core/engine/commands/lib.ts +381 -22
  96. package/.bkit/core/engine/commands/registry.ts +10 -2
  97. package/.bkit/core/engine/commands/setup/setup.ts +8 -7
  98. package/.bkit/core/engine/commands/stats.ts +260 -0
  99. package/.bkit/core/engine/commands/tips.ts +10 -5
  100. package/.bkit/core/engine/commands/workflow/branches.ts +2215 -176
  101. package/.bkit/core/engine/commands/workflow/challenge.ts +748 -0
  102. package/.bkit/core/engine/commands/workflow/completeness.ts +109 -0
  103. package/.bkit/core/engine/commands/workflow/context.ts +1249 -47
  104. package/.bkit/core/engine/commands/workflow/counters.ts +483 -95
  105. package/.bkit/core/engine/commands/workflow/decisions.ts +585 -0
  106. package/.bkit/core/engine/commands/workflow/disk.ts +238 -56
  107. package/.bkit/core/engine/commands/workflow/fids.ts +811 -33
  108. package/.bkit/core/engine/commands/workflow/issues.ts +413 -64
  109. package/.bkit/core/engine/commands/workflow/ledgers.ts +1333 -36
  110. package/.bkit/core/engine/commands/workflow/locks.ts +28 -2
  111. package/.bkit/core/engine/commands/workflow/plan-blocks.ts +691 -0
  112. package/.bkit/core/engine/commands/workflow/plan-versions.ts +21 -0
  113. package/.bkit/core/engine/commands/workflow/plans.ts +257 -0
  114. package/.bkit/core/engine/commands/workflow/prs.ts +178 -33
  115. package/.bkit/core/engine/commands/workflow/repo.ts +66 -8
  116. package/.bkit/core/engine/commands/workflow/roadmap.ts +72 -22
  117. package/.bkit/core/engine/commands/workflow/run-facts.ts +492 -0
  118. package/.bkit/core/engine/commands/workflow/runs.ts +827 -79
  119. package/.bkit/core/engine/commands/workflow/runtime.ts +25 -1
  120. package/.bkit/core/engine/commands/workflow/skills.ts +1 -0
  121. package/.bkit/core/engine/commands/workflow/status.ts +329 -33
  122. package/.bkit/core/engine/commands/workflow/step-table.ts +381 -0
  123. package/.bkit/core/engine/commands/workflow/steps.ts +841 -105
  124. package/.bkit/core/engine/commands/workflow/summary-findings.ts +177 -0
  125. package/.bkit/core/engine/commands/workflow/summary.ts +544 -0
  126. package/.bkit/core/engine/commands/workflow/tasks.ts +409 -0
  127. package/.bkit/core/engine/commands/workflow/test-blocks.ts +254 -0
  128. package/.bkit/core/engine/commands/workflow/tests-changed.ts +201 -0
  129. package/.bkit/core/engine/commands/workflow/tests.ts +2124 -330
  130. package/.bkit/core/engine/commands/workflow/tracker.ts +1195 -0
  131. package/.bkit/core/engine/commands/workflow/workflows.ts +1197 -235
  132. package/.bkit/core/engine/commands/workflow/worktrees.ts +543 -24
  133. package/.bkit/core/engine/install/cloud-env.ts +251 -121
  134. package/.bkit/core/engine/install/context-ci-workflow.ts +102 -0
  135. package/.bkit/core/engine/install/manifest.ts +67 -17
  136. package/.bkit/core/engine/install/modules/antigravity.ts +3 -2
  137. package/.bkit/core/engine/install/modules/cloud.ts +24 -16
  138. package/.bkit/core/engine/install/modules/codex.ts +15 -2
  139. package/.bkit/core/engine/install/modules/core.ts +1196 -45
  140. package/.bkit/core/engine/install/modules/cursor.ts +6 -6
  141. package/.bkit/core/engine/install/modules/opencode.ts +18 -6
  142. package/.bkit/core/engine/install/template-notes.ts +130 -0
  143. package/.bkit/core/engine/install/version-file.ts +9 -4
  144. package/.bkit/core/engine/install/write.ts +5 -0
  145. package/.bkit/core/engine/ledgers/compact.ts +124 -0
  146. package/.bkit/core/engine/ledgers/journal.ts +291 -0
  147. package/.bkit/core/engine/ledgers/migrate.ts +92 -0
  148. package/.bkit/core/engine/ledgers/status.ts +249 -21
  149. package/.bkit/core/engine/ledgers/telemetry.ts +1397 -253
  150. package/.bkit/core/engine/render/hosts.ts +118 -14
  151. package/.bkit/core/engine/render/models.ts +12 -0
  152. package/.bkit/core/engine/shared/bkit-latest.ts +26 -4
  153. package/.bkit/core/engine/shared/branches.ts +4 -1
  154. package/.bkit/core/engine/shared/dep-updater.ts +60 -0
  155. package/.bkit/core/engine/shared/egress.ts +8 -1
  156. package/.bkit/core/engine/shared/json.ts +25 -7
  157. package/.bkit/core/engine/shared/package-manager.ts +9 -0
  158. package/.bkit/core/engine/shared/settings.ts +243 -31
  159. package/.bkit/core/engine/shared/text.ts +361 -0
  160. package/.bkit/core/engine/shared/timeouts.ts +2 -0
  161. package/.bkit/core/engine/tools/cli-doc.ts +111 -0
  162. package/.bkit/core/engine/tools/grammar-density.ts +215 -0
  163. package/.bkit/core/engine/tools/instructions-sources.ts +832 -0
  164. package/.bkit/core/engine/tools/instructions.ts +1802 -0
  165. package/.bkit/core/hooks/antigravity-hook.js +25 -10
  166. package/.bkit/core/hooks/gateguard-engine.js +54 -29
  167. package/.bkit/core/hooks/guardrails-shell.js +4 -5
  168. package/.bkit/core/hooks/guardrails-tiers.js +10 -4
  169. package/.bkit/core/hooks/preflight-linear.sh +9 -9
  170. package/.bkit/core/hooks/preflight-rules.sh +8 -0
  171. package/.bkit/core/hooks/readguard-engine.js +29 -10
  172. package/.bkit/core/hooks/session-rules-advisory.js +61 -0
  173. package/.bkit/core/prompts/bkit-audit-generate.md +202 -94
  174. package/.bkit/core/prompts/bkit-build-challenge-1.md +76 -34
  175. package/.bkit/core/prompts/bkit-build-challenge-2.md +85 -38
  176. package/.bkit/core/prompts/bkit-build-install-skills.md +50 -28
  177. package/.bkit/core/prompts/bkit-build-plan-convert.md +85 -0
  178. package/.bkit/core/prompts/bkit-build-plan-current.md +59 -36
  179. package/.bkit/core/prompts/bkit-build-plan-gaps-remediate.md +101 -36
  180. package/.bkit/core/prompts/bkit-build-plan-tasks.md +149 -0
  181. package/.bkit/core/prompts/bkit-build-plan-tests.md +120 -0
  182. package/.bkit/core/prompts/bkit-build-plan-verify.md +104 -43
  183. package/.bkit/core/prompts/bkit-debug-abort-handover.md +47 -32
  184. package/.bkit/core/prompts/bkit-debug-failure-diagnose.md +109 -57
  185. package/.bkit/core/prompts/bkit-debug-failure-remediate.md +65 -39
  186. package/.bkit/core/prompts/bkit-debug-failure-reproduce.md +53 -31
  187. package/.bkit/core/prompts/bkit-debug-failure-soak.md +65 -34
  188. package/.bkit/core/prompts/bkit-design-brainstorm-ideate-1.md +46 -31
  189. package/.bkit/core/prompts/bkit-design-brainstorm-ideate-2.md +45 -31
  190. package/.bkit/core/prompts/bkit-design-brainstorm-ideate-3.md +43 -30
  191. package/.bkit/core/prompts/bkit-design-generate.md +80 -46
  192. package/.bkit/core/prompts/bkit-design-organise.md +83 -32
  193. package/.bkit/core/prompts/bkit-design-review-1.md +70 -50
  194. package/.bkit/core/prompts/bkit-design-review-2.md +65 -46
  195. package/.bkit/core/prompts/bkit-design-spike.md +64 -40
  196. package/.bkit/core/prompts/bkit-design-update.md +53 -28
  197. package/.bkit/core/prompts/bkit-plan-generate.md +101 -29
  198. package/.bkit/core/prompts/bkit-plan-review-1.md +78 -41
  199. package/.bkit/core/prompts/bkit-plan-review-2.md +78 -35
  200. package/.bkit/core/prompts/bkit-plan-scope-check.md +116 -0
  201. package/.bkit/core/prompts/bkit-plan-update.md +86 -31
  202. package/.bkit/core/prompts/bkit-ship-conflict-resolve.md +94 -50
  203. package/.bkit/core/prompts/bkit-ship-deferred-sweep.md +91 -41
  204. package/.bkit/core/prompts/bkit-ship-update-docs.md +45 -24
  205. package/.bkit/core/prompts/bkit-utility-compress-markdown.md +65 -49
  206. package/.bkit/core/prompts/bkit-utility-update-decisions.md +87 -42
  207. package/.bkit/core/prompts/bkit-utility-update-deferrals.md +81 -37
  208. package/.bkit/core/prompts/bkit-utility-update-documentation.md +43 -25
  209. package/.bkit/core/prompts/bkit-utility-update-failures.md +84 -37
  210. package/.bkit/core/prompts/bkit-utility-update-knowledge.md +88 -42
  211. package/.bkit/core/prompts/bkit-utility-update-roadmap.md +92 -39
  212. package/.bkit/core/prompts/bkit-utility-update-tracker.md +159 -60
  213. package/.bkit/core/workflows/bkit-auto.md +89 -58
  214. package/.bkit/core/workflows/bkit-build.md +967 -517
  215. package/.bkit/core/workflows/bkit-debug.md +555 -387
  216. package/.bkit/core/workflows/bkit-design.md +319 -283
  217. package/.bkit/core/workflows/bkit-plan.md +319 -342
  218. package/.bkit/core/workflows/bkit-ship.md +525 -328
  219. package/.bkit/shared/.agents/plugins/bkit/hooks.json +10 -0
  220. package/.bkit/shared/.bkit/.env.example +2 -2
  221. package/.bkit/shared/.claude/bkit-cloud.md +12 -10
  222. package/.bkit/shared/.claude/settings.json +14 -0
  223. package/.bkit/shared/.codex/bkit-cloud.md +98 -0
  224. package/.bkit/shared/.codex/hooks.json +20 -0
  225. package/.bkit/shared/.cursor/bkit-cloud.md +3 -3
  226. package/.bkit/shared/.cursor/mcp.json +1 -1
  227. package/.bkit/shared/.cursor/rules/bkit-rules.mdc +1 -1
  228. package/.bkit/shared/.gitattributes +1 -1
  229. package/.bkit/shared/.mcp.json +1 -1
  230. package/.bkit/shared/.opencode/opencode.json +12 -1
  231. package/.bkit/shared/CLAUDE.md +6 -2
  232. package/.bkit/shared/GEMINI.md +5 -2
  233. package/.bkit/shared/docs/architecture.md +4 -7
  234. package/.bkit/shared/docs/data-schema.md +4 -7
  235. package/.bkit/shared/docs/deployments.md +241 -168
  236. package/.bkit/shared/docs/design.md +11 -12
  237. package/.bkit/shared/docs/noise.md +8 -7
  238. package/.bkit/shared/docs/observability.md +5 -8
  239. package/.bkit/shared/docs/security.md +35 -17
  240. package/.bkit/shared/docs/setup.md +29 -18
  241. package/.bkit/shared/docs/technology.md +3 -6
  242. package/.bkit/shared/docs/testing.md +289 -174
  243. package/.bkit/shared/gitignore +6 -2
  244. package/.bkit/templates/.claude/hooks/bkit-cloud-bootstrap.sh +15 -16
  245. package/.bkit/templates/.cursor/Dockerfile +12 -8
  246. package/.bkit/templates/.cursor/environment.json +1 -1
  247. package/.bkit/templates/.github/ISSUE_TEMPLATE/bkit-bug.yml +10 -8
  248. package/.bkit/templates/.github/ISSUE_TEMPLATE/bkit-change.yml +45 -12
  249. package/.bkit/templates/.github/ISSUE_TEMPLATE/bkit-idea.yml +3 -3
  250. package/.bkit/templates/.github/renovate.json5 +34 -6
  251. package/.bkit/templates/.github/workflows/bkit-ci.yml +54 -51
  252. package/.bkit/templates/.github/workflows/bkit-cloud.yml +34 -33
  253. package/.bkit/templates/.github/workflows/bkit-health.yml +97 -0
  254. package/.bkit/templates/.github/workflows/bkit-renovate.yml +5 -4
  255. package/.bkit/templates/.github/workflows/bkit-trivy.yml +5 -4
  256. package/.bkit/templates/.husky/pre-commit +2 -2
  257. package/.bkit/templates/.husky/pre-push +96 -36
  258. package/.bkit/templates/.prettierignore +6 -0
  259. package/.bkit/templates/.vale.ini +27 -27
  260. package/.bkit/templates/context/bkit-cloudrun.md +23 -15
  261. package/.bkit/templates/context/bkit-expo.md +70 -52
  262. package/.bkit/templates/context/bkit-github.md +93 -56
  263. package/.bkit/templates/context/bkit-inngest.md +21 -15
  264. package/.bkit/templates/context/bkit-maestro.md +22 -16
  265. package/.bkit/templates/context/bkit-playwright.md +23 -17
  266. package/.bkit/templates/context/bkit-resend.md +12 -10
  267. package/.bkit/templates/context/bkit-sentry.md +30 -20
  268. package/.bkit/templates/context/bkit-serena.md +8 -7
  269. package/.bkit/templates/context/bkit-stripe.md +14 -13
  270. package/.bkit/templates/context/bkit-supabase.md +16 -13
  271. package/.bkit/templates/context/bkit-tavily.md +14 -11
  272. package/.bkit/templates/context/bkit-vercel.md +27 -18
  273. package/.bkit/templates/docs/capabilities.md +15 -14
  274. package/.bkit/templates/scripts/ci/{check-accepted-divergences.mjs → bkit-check-accepted-divergences.mjs} +6 -3
  275. package/.bkit/templates/scripts/ci/{check-accepted-divergences.test.mjs → bkit-check-accepted-divergences.test.mjs} +3 -3
  276. package/.bkit/templates/scripts/ci/{check-capstone.mjs → bkit-check-capstone.mjs} +2 -2
  277. package/.bkit/templates/scripts/ci/{check-capstone.test.mjs → bkit-check-capstone.test.mjs} +4 -4
  278. package/.bkit/templates/scripts/ci/{check-dependency-audit.mjs → bkit-check-dependency-audit.mjs} +103 -18
  279. package/.bkit/templates/scripts/ci/{check-dependency-audit.test.mjs → bkit-check-dependency-audit.test.mjs} +31 -3
  280. package/.bkit/templates/scripts/ci/bkit-machine-lock.sh +387 -0
  281. package/.bkit/templates/scripts/ci/bkit-test-awake.mjs +75 -0
  282. package/.bkit/templates/scripts/ci/bkit-test-awake.test.mjs +160 -0
  283. package/.bkit/templates/scripts/ci/lanes/{resolve-push-base.mjs → bkit-resolve-push-base.mjs} +3 -3
  284. package/.bkit/templates/scripts/ci/lanes/{resolve-push-base.test.mjs → bkit-resolve-push-base.test.mjs} +4 -4
  285. package/.bkit/templates/scripts/cleanup/bkit-disk-prune.mjs +10 -2
  286. package/.bkit/templates/scripts/graphify/bkit-graph-drift.py +1 -1
  287. package/.bkit/templates/scripts/graphify/bkit-graph-eager.py +3 -3
  288. package/.bkit/templates/scripts/graphify/bkit-graph-embed.py +63 -0
  289. package/.bkit/templates/scripts/graphify/bkit-graph-imports.py +2 -2
  290. package/.bkit/templates/scripts/graphify/bkit-graph-pre-push.sh +69 -18
  291. package/.bkit/templates/scripts/graphify/bkit-graph-repair.py +3 -3
  292. package/.bkit/templates/scripts/graphify/bkit-graph-surface.py +1 -1
  293. package/.bkit/templates/scripts/graphify/bkit-graphify-graphml.py +1 -1
  294. package/.bkit/templates/scripts/graphify/bkit-graphify-rollup.py +197 -126
  295. package/.bkit/templates/scripts/graphify/bkit-graphify.sh +64 -41
  296. package/.bkit/templates/scripts/slop/bkit-slop-type-suppression.mjs +23 -7
  297. package/.bkit/templates/slop-scan.config.json +9 -2
  298. package/CHANGELOG.md +231 -0
  299. package/README.md +278 -89
  300. package/dist/checks/after/auth.js +36 -33
  301. package/dist/checks/after/ci-yml.js +91 -30
  302. package/dist/checks/after/github.js +91 -17
  303. package/dist/checks/after/index.js +22 -11
  304. package/dist/checks/after/suppression.js +8 -5
  305. package/dist/checks/after/tools.js +111 -114
  306. package/dist/checks/before/context-fetch.js +218 -33
  307. package/dist/checks/before/env.js +3 -3
  308. package/dist/checks/before/files.js +5 -3
  309. package/dist/checks/before/index.js +20 -3
  310. package/dist/checks/before/repo.js +197 -2
  311. package/dist/checks/status-holes.js +739 -114
  312. package/dist/checks/tips/catalogue.js +70 -19
  313. package/dist/checks/tips/detect.js +62 -0
  314. package/dist/checks/tips/index.js +51 -9
  315. package/dist/cli.js +234 -124
  316. package/dist/commands/analysis.js +174 -141
  317. package/dist/commands/ci/ci.js +302 -25
  318. package/dist/commands/ci/pins.js +142 -0
  319. package/dist/commands/ci/push-gate.js +194 -0
  320. package/dist/commands/comply.js +54 -91
  321. package/dist/commands/install/doctor.js +2 -2
  322. package/dist/commands/install/install.js +50 -19
  323. package/dist/commands/install/uninstall.js +82 -55
  324. package/dist/commands/install/upgrade.js +21 -11
  325. package/dist/commands/land.js +137 -17
  326. package/dist/commands/lib.js +295 -21
  327. package/dist/commands/registry.js +10 -2
  328. package/dist/commands/setup/setup.js +8 -7
  329. package/dist/commands/stats.js +175 -0
  330. package/dist/commands/tips.js +7 -3
  331. package/dist/commands/workflow/branches.js +1873 -152
  332. package/dist/commands/workflow/challenge.js +609 -0
  333. package/dist/commands/workflow/completeness.js +97 -0
  334. package/dist/commands/workflow/context.js +1045 -46
  335. package/dist/commands/workflow/counters.js +385 -86
  336. package/dist/commands/workflow/decisions.js +484 -0
  337. package/dist/commands/workflow/disk.js +214 -56
  338. package/dist/commands/workflow/fids.js +706 -33
  339. package/dist/commands/workflow/issues.js +349 -59
  340. package/dist/commands/workflow/ledgers.js +1123 -37
  341. package/dist/commands/workflow/locks.js +26 -2
  342. package/dist/commands/workflow/plan-blocks.js +501 -0
  343. package/dist/commands/workflow/plan-versions.js +22 -0
  344. package/dist/commands/workflow/plans.js +205 -0
  345. package/dist/commands/workflow/prs.js +154 -35
  346. package/dist/commands/workflow/repo.js +58 -8
  347. package/dist/commands/workflow/roadmap.js +58 -23
  348. package/dist/commands/workflow/run-facts.js +421 -0
  349. package/dist/commands/workflow/runs.js +670 -72
  350. package/dist/commands/workflow/runtime.js +15 -1
  351. package/dist/commands/workflow/skills.js +1 -0
  352. package/dist/commands/workflow/status.js +282 -34
  353. package/dist/commands/workflow/step-table.js +308 -0
  354. package/dist/commands/workflow/steps.js +703 -96
  355. package/dist/commands/workflow/summary-findings.js +117 -0
  356. package/dist/commands/workflow/summary.js +388 -0
  357. package/dist/commands/workflow/tasks.js +378 -0
  358. package/dist/commands/workflow/test-blocks.js +231 -0
  359. package/dist/commands/workflow/tests-changed.js +172 -0
  360. package/dist/commands/workflow/tests.js +1695 -305
  361. package/dist/commands/workflow/tracker.js +983 -0
  362. package/dist/commands/workflow/workflows.js +1014 -222
  363. package/dist/commands/workflow/worktrees.js +432 -26
  364. package/dist/install/cloud-env.js +233 -99
  365. package/dist/install/context-ci-workflow.js +85 -0
  366. package/dist/install/manifest.js +64 -17
  367. package/dist/install/modules/antigravity.js +3 -2
  368. package/dist/install/modules/cloud.js +25 -16
  369. package/dist/install/modules/codex.js +12 -2
  370. package/dist/install/modules/core.js +1090 -48
  371. package/dist/install/modules/cursor.js +6 -6
  372. package/dist/install/modules/opencode.js +13 -7
  373. package/dist/install/template-notes.js +116 -0
  374. package/dist/install/version-file.js +9 -4
  375. package/dist/ledgers/compact.js +87 -0
  376. package/dist/ledgers/journal.js +233 -0
  377. package/dist/ledgers/migrate.js +81 -0
  378. package/dist/ledgers/status.js +176 -13
  379. package/dist/ledgers/telemetry.js +1010 -125
  380. package/dist/render/hosts.js +104 -14
  381. package/dist/render/models.js +12 -0
  382. package/dist/shared/bkit-latest.js +26 -4
  383. package/dist/shared/branches.js +3 -1
  384. package/dist/shared/dep-updater.js +49 -0
  385. package/dist/shared/egress.js +8 -1
  386. package/dist/shared/json.js +20 -7
  387. package/dist/shared/package-manager.js +6 -0
  388. package/dist/shared/settings.js +181 -24
  389. package/dist/shared/text.js +333 -0
  390. package/dist/shared/timeouts.js +2 -0
  391. package/dist/tools/cli-doc.js +97 -0
  392. package/dist/tools/grammar-density.js +183 -0
  393. package/dist/tools/instructions-sources.js +720 -0
  394. package/dist/tools/instructions.js +1623 -0
  395. package/package.json +156 -51
  396. package/.bkit/core/.bkit/lite.md +0 -73
  397. package/.bkit/core/engine/commands/harvest.ts +0 -459
  398. package/.bkit/core/engine/commands/workflow/workstreams.ts +0 -166
  399. package/.bkit/core/engine/tools/wording.ts +0 -748
  400. package/.bkit/core/prompts/bkit-build-challenge-reconcile.md +0 -69
  401. package/.bkit/core/prompts/bkit-build-challenge-remediate.md +0 -71
  402. package/.bkit/core/prompts/bkit-build-challenge-tests.md +0 -74
  403. package/.bkit/core/prompts/bkit-build-plan-execute.md +0 -76
  404. package/.bkit/core/prompts/bkit-build-summary.md +0 -94
  405. package/.bkit/core/prompts/bkit-debug-summary.md +0 -96
  406. package/.bkit/core/prompts/bkit-design-summary.md +0 -107
  407. package/.bkit/core/prompts/bkit-plan-complexity-check.md +0 -67
  408. package/.bkit/core/prompts/bkit-plan-complexity-split.md +0 -88
  409. package/.bkit/core/prompts/bkit-plan-review-3.md +0 -93
  410. package/.bkit/core/prompts/bkit-plan-scope-check-1.md +0 -85
  411. package/.bkit/core/prompts/bkit-plan-scope-check-2.md +0 -85
  412. package/.bkit/core/prompts/bkit-plan-summary.md +0 -107
  413. package/.bkit/core/prompts/bkit-ship-summary.md +0 -78
  414. package/.bkit/templates/scripts/ci/bkit-local-stack-lock.sh +0 -194
  415. package/dist/commands/harvest.js +0 -353
  416. package/dist/commands/workflow/workstreams.js +0 -143
  417. package/dist/tools/wording.js +0 -680
  418. /package/.bkit/templates/.vale/styles/{House → Bkit}/Filler.yml +0 -0
  419. /package/.bkit/templates/.vale/styles/{House → Bkit}/Hedging.yml +0 -0
  420. /package/.bkit/templates/.vale/styles/{House → Bkit}/LLMSlop.yml +0 -0
  421. /package/.bkit/templates/.vale/styles/{House → Bkit}/Verbose.yml +0 -0
  422. /package/.bkit/templates/scripts/ci/{accepted-advisories.json → bkit-accepted-advisories.json} +0 -0
  423. /package/.bkit/templates/scripts/ci/{accepted-divergences.json → bkit-accepted-divergences.json} +0 -0
  424. /package/.bkit/templates/scripts/launchd/{launchd.env.example → bkit-launchd.env.example} +0 -0
  425. /package/.bkit/templates/scripts/launchd/{ai.bkit.launchd.plist → bkit-launchd.plist} +0 -0
@@ -34,7 +34,8 @@ import { removeOpencodeProviderBlock, renderOpencodeAgentsCommands, renderOpenco
34
34
  import { applyModelOverrides, buildOpencodeModelLookup, parseEffortMap, } from "../../render/models.js";
35
35
  import { readInstallingVersion } from "../../shared/package-json.js";
36
36
  import { readBkitConfig } from "../../shared/settings.js";
37
- import { CLAUDE_CLOUD_RELPATH, CURSOR_CLOUD_RELPATH, resolveClaudeDerivedAllows, } from "../../install/cloud-env.js";
37
+ import { SEEDED_BKIT_DEFAULTS } from "../../install/modules/core.js";
38
+ import { CLAUDE_CLOUD_RELPATH, CODEX_CLOUD_RELPATH, CURSOR_CLOUD_RELPATH, resolveClaudeDerivedAllows, } from "../../install/cloud-env.js";
38
39
  import { LOG_PREFIX, setLogPrefix } from "../../shared/log-prefix.js";
39
40
  import { unusedTrackerMcpServers } from "../../checks/before/mcp.js";
40
41
  // ---------------------------------------------------------------------------
@@ -257,8 +258,10 @@ const CORE_TEMPLATE_DOCTRINE = [
257
258
  { path: ".agents/docs.md", format: "markered-text", module: "core" },
258
259
  { path: ".agents/rules.md", format: "markered-text", module: "core" },
259
260
  { path: ".agents/skills.md", format: "markered-text", module: "core" },
260
- // 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.
261
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" },
262
265
  ];
263
266
  /**
264
267
  * The top-level `docs/*.md` the core payload pass installs: each carries bkit's managed
@@ -654,7 +657,7 @@ export async function runUninstall(modules, ctx) {
654
657
  }
655
658
  }
656
659
  // Full/core uninstall: strip the `bkit` install-state object from package.json
657
- // (issueTracker / opencodeProvider(s) / cloudAgents), whatever keys it holds. Scripts
660
+ // (tracker / providers / cloud and every other section), whatever keys it holds. Scripts
658
661
  // and devDeps are the consumer's and stay. No try/catch — malformed package.json is a hard failure on full
659
662
  // teardown (same as a missing dest would be).
660
663
  if (moduleList.includes("core") && !ctx.dryRun) {
@@ -669,8 +672,8 @@ export async function runUninstall(modules, ctx) {
669
672
  }
670
673
  }
671
674
  }
672
- // Targeted uninstall: drop the `bkit.*` keys the removed module records, so its advisories
673
- // stop firing. Core keeps every other key.
675
+ // Targeted uninstall: reset the `bkit.*` keys the removed module records to unset, so its
676
+ // advisories stop firing. Core keeps every other key.
674
677
  if (!moduleList.includes("core")) {
675
678
  stripModuleBkitKeys(moduleList, ctx, result);
676
679
  }
@@ -751,31 +754,25 @@ export async function runUninstall(modules, ctx) {
751
754
  }
752
755
  }
753
756
  }
754
- // Remove the generated `.claude/bkit-cloud.md` (untracked, gitignored — holds resolved
755
- // secrets). It is not in the manifest, so the table-driven pass never sees it;
756
- // delete it explicitly when the claude host is uninstalled so a live-secrets file
757
- // is never left behind. Pushed to result.deleted so a dry-run reports it too.
758
- if (moduleList.includes("claude")) {
759
- const cloudAbs = path.join(ctx.cwd, CLAUDE_CLOUD_RELPATH);
760
- if (fs.existsSync(cloudAbs)) {
761
- result.deleted.push(CLAUDE_CLOUD_RELPATH);
762
- if (!ctx.dryRun) {
763
- fs.rmSync(cloudAbs, { force: true });
764
- console.log(`${ctx.logPrefix} delete: ${CLAUDE_CLOUD_RELPATH} (generated cloud setup doc)`);
765
- }
766
- }
767
- }
768
- // Same for the Cursor twin `.cursor/bkit-cloud.md` (writeCursorCloudDoc) — untracked,
769
- // gitignored, holds resolved secrets; delete it explicitly when the cursor host is
770
- // uninstalled so a live-secrets file is never left behind.
771
- if (moduleList.includes("cursor")) {
772
- const cloudAbs = path.join(ctx.cwd, CURSOR_CLOUD_RELPATH);
773
- if (fs.existsSync(cloudAbs)) {
774
- result.deleted.push(CURSOR_CLOUD_RELPATH);
775
- if (!ctx.dryRun) {
776
- fs.rmSync(cloudAbs, { force: true });
777
- console.log(`${ctx.logPrefix} delete: ${CURSOR_CLOUD_RELPATH} (generated cloud setup doc)`);
778
- }
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)`);
779
776
  }
780
777
  }
781
778
  // Full/core uninstall: the consumer's template copies (`.bkit/templates/`) are
@@ -863,15 +860,33 @@ export async function runUninstall(modules, ctx) {
863
860
  }
864
861
  return result;
865
862
  }
866
- /** `package.json` `bkit.*` keys each module records on install. */
863
+ /** `package.json` `bkit.*` keys (dotted paths) each module records on install. */
867
864
  const MODULE_BKIT_KEYS = {
868
- cloud: ["cloudAgents"],
869
- opencode: ["opencodeProvider", "opencodeProviders"],
865
+ cloud: ["cloud.agent"],
866
+ opencode: ["providers.opencode.default", "providers.opencode.installed"],
870
867
  };
868
+ /** The object at dotted `keys` under `root`; null when a step is absent or not an object. */
869
+ function objectAt(root, keys) {
870
+ let node = root;
871
+ for (const k of keys) {
872
+ const next = node[k];
873
+ if (!isJsonObject(next))
874
+ return null;
875
+ node = next;
876
+ }
877
+ return node;
878
+ }
879
+ /** The seeded value at dotted `key` in SEEDED_BKIT_DEFAULTS, copied. */
880
+ function seededValue(key) {
881
+ const segs = key.split(".");
882
+ const parent = objectAt(SEEDED_BKIT_DEFAULTS, segs.slice(0, -1));
883
+ return structuredClone(parent?.[segs[segs.length - 1]]);
884
+ }
871
885
  /**
872
- * Remove the `bkit.*` keys recorded by the modules in `moduleList` from the consumer's
873
- * package.json, keeping its indent. Lists each removed key in `result.stripped`; a dry run
874
- * lists without writing.
886
+ * Reset the `bkit.*` keys recorded by the modules in `moduleList` to the value install
887
+ * seeds (`""` / `[]`, read as unset), keeping the package.json indent. Deleting them
888
+ * would leave `bkit check` reporting the seeded key as missing. Lists each reset key in
889
+ * `result.stripped`; a dry run lists without writing.
875
890
  */
876
891
  function stripModuleBkitKeys(moduleList, ctx, result) {
877
892
  const keys = moduleList.flatMap((m) => MODULE_BKIT_KEYS[m] ?? []);
@@ -886,14 +901,22 @@ function stripModuleBkitKeys(moduleList, ctx, result) {
886
901
  if (pkg === null || !isJsonObject(pkg.bkit))
887
902
  return;
888
903
  const bkit = pkg.bkit;
889
- const present = keys.filter((k) => k in bkit);
890
- if (present.length === 0)
904
+ const reset = keys.filter((k) => {
905
+ const segs = k.split(".");
906
+ const parent = objectAt(bkit, segs.slice(0, -1));
907
+ const key = segs[segs.length - 1];
908
+ return (parent !== null &&
909
+ key in parent &&
910
+ JSON.stringify(parent[key]) !== JSON.stringify(seededValue(k)));
911
+ });
912
+ if (reset.length === 0)
891
913
  return;
892
- for (const k of present) {
893
- delete bkit[k];
914
+ for (const k of reset) {
915
+ const segs = k.split(".");
916
+ objectAt(bkit, segs.slice(0, -1))[segs[segs.length - 1]] = seededValue(k);
894
917
  result.stripped.push(`package.json#bkit.${k}`);
895
918
  }
896
- console.log(`${ctx.logPrefix}${ctx.dryRun ? " [dry-run]" : ""} package.json: removed bkit.${present.join(", bkit.")}`);
919
+ console.log(`${ctx.logPrefix}${ctx.dryRun ? " [dry-run]" : ""} package.json: reset bkit.${reset.join(", bkit.")} to unset`);
897
920
  if (ctx.dryRun)
898
921
  return;
899
922
  const indentMatch = raw.match(/\n([ \t]+)"/);
@@ -908,8 +931,8 @@ function stripModuleBkitKeys(moduleList, ctx, result) {
908
931
  *
909
932
  * Distinct from bare `bkit uninstall --opencode` (full host teardown):
910
933
  * - Removes the provider block from `.opencode/opencode.json`
911
- * - Updates `bkit.opencodeProviders` in `package.json`
912
- * - If the removed provider was the active one, re-points `bkit.opencodeProvider`
934
+ * - Updates `bkit.providers.opencode.installed` in `package.json`
935
+ * - If the removed provider was the active one, re-points `bkit.providers.opencode.default`
913
936
  * to the first remaining provider and emits a re-render advisory
914
937
  * - If no providers remain, falls through to full host teardown via `runUninstall`
915
938
  */
@@ -923,7 +946,7 @@ export async function runSurgicalOpencodeUninstall(providerKey, dryRun, cwd) {
923
946
  if (ws.writes.length > 0) {
924
947
  console.log(`${LOG_PREFIX}${tag} removed provider block "${providerKey}" from opencode.json`);
925
948
  }
926
- // 2. Update bkit.opencodeProviders in package.json (read inline — no detectOpencodeProviders import)
949
+ // 2. Update bkit.providers.opencode.installed in package.json (read inline — no detectOpencodeProviders import)
927
950
  const pkgPath = path.join(cwd, "package.json");
928
951
  let remainingProviders = [];
929
952
  let wasActive = false;
@@ -936,31 +959,35 @@ export async function runSurgicalOpencodeUninstall(providerKey, dryRun, cwd) {
936
959
  console.warn(`${LOG_PREFIX} package.json is malformed — skipping bkit section update`);
937
960
  return;
938
961
  }
939
- const bkit = (pkg.bkit ?? {});
940
- const arr = Array.isArray(bkit.opencodeProviders)
941
- ? [...bkit.opencodeProviders]
942
- : [];
962
+ const opencode = objectAt(pkg, ["bkit", "providers", "opencode"]) ?? {};
963
+ const arr = Array.isArray(opencode.installed) ? [...opencode.installed] : [];
943
964
  remainingProviders = arr.filter((p) => p !== providerKey);
944
- wasActive = bkit.opencodeProvider === providerKey;
965
+ wasActive = opencode.default === providerKey;
945
966
  if (wasActive && remainingProviders.length > 0) {
946
967
  newActive = remainingProviders[0];
947
968
  }
948
969
  if (!dryRun) {
949
- bkit.opencodeProviders = remainingProviders;
970
+ opencode.installed = remainingProviders;
950
971
  if (wasActive) {
951
972
  if (newActive !== null) {
952
- bkit.opencodeProvider = newActive;
973
+ opencode.default = newActive;
953
974
  }
954
975
  else {
955
- delete bkit.opencodeProvider;
976
+ delete opencode.default;
956
977
  }
957
978
  }
958
- pkg.bkit = bkit;
979
+ if (objectAt(pkg, ["bkit", "providers", "opencode"]) === null) {
980
+ const bkit = objectAt(pkg, ["bkit"]) ?? {};
981
+ const providers = objectAt(bkit, ["providers"]) ?? {};
982
+ providers.opencode = opencode;
983
+ bkit.providers = providers;
984
+ pkg.bkit = bkit;
985
+ }
959
986
  const indentMatch = raw.match(/\n([ \t]+)"/);
960
987
  const indent = indentMatch ? indentMatch[1] : " ";
961
988
  fs.writeFileSync(pkgPath, JSON.stringify(pkg, null, indent) + "\n", "utf-8");
962
- console.log(`${LOG_PREFIX} updated package.json: opencodeProviders=[${remainingProviders.join(", ")}]` +
963
- (wasActive ? ` opencodeProvider=${newActive ?? "(removed)"}` : ""));
989
+ console.log(`${LOG_PREFIX} updated package.json: bkit.providers.opencode.installed=[${remainingProviders.join(", ")}]` +
990
+ (wasActive ? ` bkit.providers.opencode.default=${newActive ?? "(removed)"}` : ""));
964
991
  }
965
992
  }
966
993
  // 3. If none remain → full host teardown
@@ -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,
@@ -1,14 +1,24 @@
1
- // The one way bkit lands a commit on dev: build it in a detached throwaway
2
- // worktree off a fresh origin/dev and push it as dev. The main checkout's
3
- // branch, index and edits are never touched, and local dev commits missing from
4
- // origin/dev are never pushed. dev moved underneath → rebuild on the new dev and
5
- // push again, with backoff. Used by the design / plan close, the build / debug
6
- // roadmap mirror, and ship's close and FAILED record. The throwaway runs no git
7
- // hooks: what it lands is bookkeeping only (docs, logs, ledgers, `[skip ci]`).
1
+ // The one way bkit lands commits on dev from a throwaway: build them in a
2
+ // detached worktree off a fresh origin/dev and push it as dev. The main
3
+ // checkout's branch, index and edits are never touched, and local dev commits
4
+ // missing from origin/dev are never pushed as they stand — a caller that wants
5
+ // some of them replays exactly those. dev moved underneath → rebuild on the new
6
+ // dev and push again, with backoff. Used by the design / plan close, the
7
+ // build / debug roadmap mirror, ship's close and FAILED record, and the
8
+ // own-commit push of a debug run in place on dev, which replays the run's
9
+ // commits. The throwaway runs its declared gate explicitly before pushing.
10
+ import { spawnSync } from "node:child_process";
8
11
  import * as fs from "node:fs";
9
12
  import * as path from "node:path";
10
13
  import { CommandError, DEV, EXIT, git, runGit } from "./lib.js";
11
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";
12
22
  const REMOTE = "origin";
13
23
  const UPSTREAM = `${REMOTE}/${DEV}`;
14
24
  /** dev moved before git sent anything: git compared the remote's dev and stopped. */
@@ -17,6 +27,20 @@ const MOVED_BEFORE = /\[rejected\][^\n]*\((?:fetch first|non-fast-forward)\)/;
17
27
  const MOVED_DURING = /\[remote rejected\][^\n]*\((?:incorrect old value provided|cannot lock ref[^\n]*)\)/;
18
28
  /** The server turned the push away: branch protection, a ruleset, an HTTP 403. */
19
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);
20
44
  /** A dev push rejected only because dev moved: rebuild on the new dev, push again. */
21
45
  export const devMoved = (stderr) => MOVED_BEFORE.test(stderr) || MOVED_DURING.test(stderr);
22
46
  /** A dev push the server refused for a reason other than dev moving. */
@@ -78,26 +102,119 @@ export async function withoutHooks(fn) {
78
102
  delete process.env[value];
79
103
  }
80
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
+ }
81
187
  /**
82
- * Land one commit on dev: per attempt, fetch dev, add `dir` detached at
83
- * origin/dev, let `build` make the commit there, push `HEAD:dev` — git hooks
84
- * off. `build` throwing stops the landing with that throw. A server refusal runs
85
- * `refused` on the built commit first, when given. `dir` is removed on every path.
188
+ * Land on dev what `build` makes: per attempt, fetch dev, add `dir` detached at
189
+ * origin/dev, let `build` make one or more commits there (a bookkeeping commit,
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`
192
+ * throwing stops the landing with that throw. A server refusal runs `refused` on
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.
86
196
  */
87
197
  export async function pushToDev(o) {
88
- o.log("git hooks skipped in the throwaway dev checkout — it lands bookkeeping only");
198
+ o.log("git hooks skipped in the throwaway dev checkout — its declared minimum or full gate runs explicitly");
89
199
  for (let attempt = 1;; attempt++) {
90
200
  let wait = 0;
91
201
  dropLandTree(o.root, o.dir);
92
202
  try {
93
203
  const outcome = await withoutHooks(async () => {
94
- const fetched = runGit(o.root, ["fetch", REMOTE, DEV]);
95
- 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";
96
208
  return { kind: "fetch-failed", stderr: fetched.stderr };
209
+ }
97
210
  const added = runGit(o.root, ["worktree", "add", "--detach", o.dir, UPSTREAM]);
98
211
  if (!added.ok)
99
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");
100
216
  o.build(o.dir, attempt);
217
+ checkLanding(o.root, o.dir, base, o.log);
101
218
  const pushed = runGit(o.dir, ["push", REMOTE, `HEAD:${DEV}`]);
102
219
  if (pushed.ok) {
103
220
  return {
@@ -112,14 +229,17 @@ export async function pushToDev(o) {
112
229
  }
113
230
  if (!devMoved(pushed.stderr))
114
231
  return { kind: "push-failed", stderr: pushed.stderr };
115
- return null;
232
+ return "moved";
116
233
  });
117
- if (outcome !== null)
234
+ if (typeof outcome !== "string")
118
235
  return outcome;
119
236
  if (attempt >= TIMEOUTS.LAND_ATTEMPTS)
120
237
  return { kind: "exhausted", attempts: attempt };
121
238
  wait = landBackoffMs(attempt);
122
- 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`);
123
243
  }
124
244
  finally {
125
245
  dropLandTree(o.root, o.dir);