@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,172 @@
1
+ // bkit ci pins — download each version + sha256 pinned tool and check its hash.
2
+ //
3
+ // A file pins a tool as `<TOOL>_VERSION` plus `<TOOL>_SHA256` (shell `X="v"`, `export X=v`,
4
+ // Dockerfile `ARG X=v`) and downloads it from a URL that spells `${<TOOL>_VERSION}`.
5
+ // Renovate bumps the version and leaves the hash, so a version-only bump fails only when
6
+ // the image is rebuilt or the setup script reruns. This check fails first, naming the tool:
7
+ // on a hash that differs, a download that fails, or a downloaded version with no hash.
8
+ // A version no URL in the file uses (pnpm through corepack) is not a download: skipped.
9
+
10
+ import { createHash } from "node:crypto";
11
+ import * as fs from "node:fs";
12
+ import * as path from "node:path";
13
+
14
+ import { CommandError, EXIT, type RunContext } from "../lib.js";
15
+
16
+ /** One tool's pin in one file. */
17
+ export interface Pin {
18
+ tool: string;
19
+ version: string | null;
20
+ sha256: string | null;
21
+ /** The download URL with every known `*_VERSION` filled in; null when no URL uses the version. */
22
+ url: string | null;
23
+ /** Set when the pin cannot be checked as written. */
24
+ problem: "missing-sha256" | "missing-version" | "unresolved-url" | "ambiguous-url" | null;
25
+ }
26
+
27
+ export type PinStatus = "ok" | "mismatch" | "unreachable" | "skipped" | NonNullable<Pin["problem"]>;
28
+
29
+ export interface PinResult {
30
+ file: string;
31
+ tool: string;
32
+ version: string | null;
33
+ url: string | null;
34
+ status: PinStatus;
35
+ expected: string | null;
36
+ actual: string | null;
37
+ error: string | null;
38
+ }
39
+
40
+ export type Download = (url: string) => Promise<Buffer>;
41
+
42
+ const ASSIGNMENT =
43
+ /^\s*(?:ARG\s+|export\s+)?([A-Z][A-Z0-9]*)_(VERSION|SHA256)=("?)([^"\s]+)\3\s*$/gm;
44
+ const URL = /https?:\/\/[^\s"'<>]+/g;
45
+ const VERSION_REF = /\$\{?([A-Z][A-Z0-9]*)_VERSION\}?/g;
46
+ const ATTEMPTS = 3;
47
+ const TIMEOUT_MS = 120_000;
48
+
49
+ /** Every `*_VERSION` / `*_SHA256` pin in `text`, with the URL its version downloads from. */
50
+ export function parsePins(text: string): Pin[] {
51
+ const versions = new Map<string, string>();
52
+ const hashes = new Map<string, string>();
53
+ for (const m of text.matchAll(ASSIGNMENT)) {
54
+ (m[2] === "VERSION" ? versions : hashes).set(m[1], m[4]);
55
+ }
56
+ const urls = new Map<string, Set<string>>();
57
+ for (const [raw] of text.matchAll(URL)) {
58
+ for (const ref of raw.matchAll(VERSION_REF)) {
59
+ const filled = raw.replace(VERSION_REF, (whole, tool: string) => versions.get(tool) ?? whole);
60
+ const seen = urls.get(ref[1]) ?? new Set<string>();
61
+ urls.set(ref[1], seen.add(filled));
62
+ }
63
+ }
64
+
65
+ const tools = [...new Set([...versions.keys(), ...hashes.keys()])].sort();
66
+ return tools.map((tool): Pin => {
67
+ const version = versions.get(tool) ?? null;
68
+ const sha256 = hashes.get(tool) ?? null;
69
+ const found = [...(urls.get(tool) ?? [])];
70
+ const url = found.length === 1 ? found[0] : null;
71
+ const problem =
72
+ version === null
73
+ ? "missing-version"
74
+ : found.length > 1
75
+ ? "ambiguous-url"
76
+ : url !== null && url.includes("$")
77
+ ? "unresolved-url"
78
+ : url !== null && sha256 === null
79
+ ? "missing-sha256"
80
+ : null;
81
+ return { tool, version, sha256, url, problem };
82
+ });
83
+ }
84
+
85
+ /** GET `url` and return its body; retried, a non-2xx status or a timeout throws. */
86
+ export const fetchAsset: Download = async (url) => {
87
+ let last: unknown;
88
+ for (let attempt = 1; attempt <= ATTEMPTS; attempt++) {
89
+ try {
90
+ const res = await fetch(url, { signal: AbortSignal.timeout(TIMEOUT_MS) });
91
+ if (!res.ok) throw new Error(`HTTP ${res.status}`);
92
+ return Buffer.from(await res.arrayBuffer());
93
+ } catch (err) {
94
+ last = err;
95
+ }
96
+ }
97
+ throw last instanceof Error ? last : new Error(String(last));
98
+ };
99
+
100
+ /** Check every pin of every file; each URL is downloaded once. */
101
+ export async function checkPins(
102
+ files: { file: string; text: string }[],
103
+ download: Download,
104
+ ): Promise<PinResult[]> {
105
+ const digests = new Map<string, Promise<string>>();
106
+ const digest = (url: string) => {
107
+ const known = digests.get(url);
108
+ if (known) return known;
109
+ const pending = download(url).then((body) => createHash("sha256").update(body).digest("hex"));
110
+ digests.set(url, pending);
111
+ return pending;
112
+ };
113
+
114
+ const results: PinResult[] = [];
115
+ for (const { file, text } of files) {
116
+ for (const pin of parsePins(text)) {
117
+ const base = { file, tool: pin.tool, version: pin.version, url: pin.url };
118
+ const expected = pin.sha256?.toLowerCase() ?? null;
119
+ const none = { expected, actual: null, error: null };
120
+ if (pin.problem) {
121
+ results.push({ ...base, ...none, status: pin.problem });
122
+ } else if (pin.url === null || expected === null) {
123
+ results.push({ ...base, ...none, status: "skipped" });
124
+ } else {
125
+ try {
126
+ const actual = await digest(pin.url);
127
+ const status = actual === expected ? "ok" : "mismatch";
128
+ results.push({ ...base, expected, actual, error: null, status });
129
+ } catch (err) {
130
+ const error = err instanceof Error ? err.message : String(err);
131
+ results.push({ ...base, ...none, status: "unreachable", error });
132
+ }
133
+ }
134
+ }
135
+ }
136
+ return results;
137
+ }
138
+
139
+ const FAILURE: Record<Exclude<PinStatus, "ok" | "skipped">, (r: PinResult) => string> = {
140
+ mismatch: (r) => `sha256 is ${r.actual}, the pin says ${r.expected} (${r.url})`,
141
+ unreachable: (r) => `download failed: ${r.error} (${r.url})`,
142
+ "missing-sha256": (r) => `downloaded from ${r.url} but has no ${r.tool}_SHA256 beside it`,
143
+ "missing-version": (r) => `${r.tool}_SHA256 has no ${r.tool}_VERSION beside it`,
144
+ "unresolved-url": (r) => `download URL still has an unknown variable: ${r.url}`,
145
+ "ambiguous-url": (r) => `${r.tool}_VERSION is used in more than one download URL`,
146
+ };
147
+
148
+ /** `bkit ci pins`: exit 0 when every download pin's sha256 matches what its URL serves. */
149
+ export async function pins(ctx: RunContext, download: Download = fetchAsset): Promise<number> {
150
+ const given = ctx.flags.file;
151
+ const names = Array.isArray(given) ? given : typeof given === "string" ? [given] : [];
152
+ if (names.length === 0) throw new CommandError(EXIT.USAGE, "give at least one --file");
153
+ const files = names.map((file) => {
154
+ const abs = path.resolve(ctx.cwd, file);
155
+ if (!fs.existsSync(abs)) throw new CommandError(EXIT.USAGE, `no such file: ${file}`);
156
+ return { file, text: fs.readFileSync(abs, "utf-8") };
157
+ });
158
+
159
+ const results = await checkPins(files, download);
160
+ for (const r of results) {
161
+ const label = `${r.tool} ${r.version ?? "(no version)"} in ${r.file}`;
162
+ if (r.status === "ok") ctx.log(`ok ${label}`);
163
+ else if (r.status === "skipped") ctx.log(`skipped ${label}: no download URL uses it`);
164
+ else ctx.log(`FAIL ${label}: ${FAILURE[r.status](r)}`);
165
+ }
166
+ for (const { file } of files) {
167
+ if (!results.some((r) => r.file === file)) ctx.log(`no *_VERSION / *_SHA256 pins in ${file}`);
168
+ }
169
+ const passed = results.every((r) => r.status === "ok" || r.status === "skipped");
170
+ ctx.emit({ passed, pins: results });
171
+ return passed ? EXIT.OK : EXIT.NO;
172
+ }
@@ -0,0 +1,223 @@
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
+
14
+ const UNIT = "bkit:gate:static-unit";
15
+ const INTEGRATION = "bkit:gate:static-unit-integration";
16
+ const SHA = /^(?:[0-9a-f]{40}|[0-9a-f]{64})$/;
17
+
18
+ function scriptsOf(pkg: unknown): Record<string, unknown> | null {
19
+ if (!pkg || typeof pkg !== "object" || !("scripts" in pkg)) return null;
20
+ const scripts = pkg.scripts;
21
+ if (!scripts || typeof scripts !== "object" || Array.isArray(scripts)) return null;
22
+ return scripts as Record<string, unknown>;
23
+ }
24
+
25
+ function gateDefinition(pkg: unknown): { gate: string; fingerprint: string } | null {
26
+ const values = scriptsOf(pkg);
27
+ if (!values) return null;
28
+ const gate = typeof values[INTEGRATION] === "string" ? INTEGRATION : UNIT;
29
+ if (typeof values[gate] !== "string" || values[gate].trim() === "") return null;
30
+ const fingerprint = createHash("sha256")
31
+ .update(JSON.stringify(Object.entries(values).sort(([a], [b]) => a.localeCompare(b))))
32
+ .digest("hex");
33
+ return { gate, fingerprint };
34
+ }
35
+
36
+ /** The deepest full push gate declared by this checkout. */
37
+ export function requiredPushGate(cwd: string): string | null {
38
+ const pkg = readPackageJson(cwd);
39
+ return pkg.ok ? (gateDefinition(pkg.pkg)?.gate ?? null) : null;
40
+ }
41
+
42
+ const receiptPath = (cwd: string, sha: string): string | null => {
43
+ const outbox = outboxRoot(cwd);
44
+ return outbox ? path.join(outbox, "push-gates", `${sha}.json`) : null;
45
+ };
46
+
47
+ function cleanHead(cwd: string): { sha: string; tree: string } | null {
48
+ const status = git(cwd, [
49
+ "status",
50
+ "--porcelain",
51
+ "--untracked-files=all",
52
+ "--ignore-submodules=none",
53
+ ]);
54
+ if (status !== "") return null;
55
+ const sha = git(cwd, ["rev-parse", "--verify", "HEAD^{commit}"]);
56
+ const tree = git(cwd, ["rev-parse", "--verify", "HEAD^{tree}"]);
57
+ return sha && tree ? { sha, tree } : null;
58
+ }
59
+
60
+ /** Execute a consumer gate; only a successful deepest full gate on an unchanged clean tree earns proof. */
61
+ export function runPushGate(cwd: string, gate: string, log: (message: string) => void): number {
62
+ const pkg = readPackageJson(cwd);
63
+ const script = pkg.ok ? scriptsOf(pkg.pkg)?.[gate] : null;
64
+ if (typeof script !== "string" || script.trim() === "") {
65
+ log(`package.json must declare a non-empty ${gate} script`);
66
+ return EXIT.USAGE;
67
+ }
68
+ const definition = pkg.ok ? gateDefinition(pkg.pkg) : null;
69
+ const before = cleanHead(cwd);
70
+ const head = git(cwd, ["rev-parse", "--verify", "HEAD^{commit}"]);
71
+ const file = head ? receiptPath(cwd, head) : null;
72
+ const attempt =
73
+ file && definition?.gate === gate ? path.join(`${file}.running`, randomUUID()) : null;
74
+ const fail = () => {
75
+ if (!attempt || !file) return;
76
+ fs.mkdirSync(path.dirname(file), { recursive: true });
77
+ fs.writeFileSync(
78
+ `${file}.failed`,
79
+ JSON.stringify({ version: 1, sha: head, gate, passed: false }) + "\n",
80
+ );
81
+ fs.rmSync(file, { force: true });
82
+ };
83
+ if (attempt) {
84
+ fs.mkdirSync(path.dirname(attempt), { recursive: true });
85
+ fs.writeFileSync(attempt, JSON.stringify({ pid: process.pid, sha: head }) + "\n");
86
+ fail();
87
+ }
88
+ const finish = (code: number) => {
89
+ if (attempt) fs.rmSync(attempt, { force: true });
90
+ return code;
91
+ };
92
+ const argv = testCommand(scriptCommand(gate));
93
+ log(`running ${scriptCommand(gate).join(" ")}`);
94
+ const result = spawnSync(argv[0]!, argv.slice(1), {
95
+ cwd,
96
+ env: gitEnv(),
97
+ stdio: ["ignore", 2, 2],
98
+ });
99
+ const status = result.error
100
+ ? 127
101
+ : (result.status ??
102
+ 128 + ((result.signal ? os.constants.signals[result.signal] : undefined) ?? 1));
103
+ if (result.error) log(result.error.message);
104
+ if (status !== 0 || !before || definition?.gate !== gate) {
105
+ fail();
106
+ return finish(status);
107
+ }
108
+ const after = cleanHead(cwd);
109
+ const afterPkg = readPackageJson(cwd);
110
+ if (
111
+ after?.sha !== before.sha ||
112
+ after.tree !== before.tree ||
113
+ !afterPkg.ok ||
114
+ gateDefinition(afterPkg.pkg)?.fingerprint !== definition.fingerprint
115
+ ) {
116
+ log("full gate passed, but the checkout changed — no reusable push receipt");
117
+ fail();
118
+ return finish(status);
119
+ }
120
+ if (file) {
121
+ fs.mkdirSync(path.dirname(file), { recursive: true });
122
+ fs.writeFileSync(
123
+ file,
124
+ JSON.stringify({ version: 1, ...before, ...definition, passed: true }) + "\n",
125
+ );
126
+ fs.rmSync(`${file}.failed`, { force: true });
127
+ log(`recorded full push gate for ${before.sha}`);
128
+ }
129
+ return finish(status);
130
+ }
131
+
132
+ /** Pending files survive interrupted runners; one read suffices to block earlier proof. */
133
+ function pendingAttempt(file: string): boolean {
134
+ const dir = `${file}.running`;
135
+ if (!fs.existsSync(dir)) return false;
136
+ const handle = fs.opendirSync(dir);
137
+ try {
138
+ return handle.readSync() !== null;
139
+ } finally {
140
+ handle.closeSync();
141
+ }
142
+ }
143
+
144
+ function validReceipt(
145
+ cwd: string,
146
+ file: string,
147
+ sha: string,
148
+ definition: { gate: string; fingerprint: string },
149
+ ): boolean {
150
+ const read = readJsonFile(file);
151
+ if (!read.ok || !read.value || typeof read.value !== "object") return false;
152
+ const receipt = read.value as Record<string, unknown>;
153
+ return (
154
+ receipt.version === 1 &&
155
+ receipt.passed === true &&
156
+ receipt.sha === sha &&
157
+ receipt.gate === definition.gate &&
158
+ receipt.fingerprint === definition.fingerprint &&
159
+ receipt.tree === git(cwd, ["rev-parse", `${sha}^{tree}`])
160
+ );
161
+ }
162
+
163
+ /** Every commit not covered by this success must be free of failed or unreadable gate evidence. */
164
+ function noLaterFailure(
165
+ cwd: string,
166
+ dir: string,
167
+ sha: string,
168
+ newSha: string,
169
+ definition: { gate: string; fingerprint: string },
170
+ ): boolean {
171
+ const range = git(cwd, ["rev-list", "--max-count=129", newSha, `^${sha}`]);
172
+ if (range === null) return false;
173
+ const commits = range ? range.split("\n") : [];
174
+ if (commits.length > 128) return false;
175
+ for (const commit of [sha, ...commits]) {
176
+ const file = path.join(dir, `${commit}.json`);
177
+ if (
178
+ fs.existsSync(`${file}.failed`) ||
179
+ pendingAttempt(file) ||
180
+ (fs.existsSync(file) && !validReceipt(cwd, file, commit, definition))
181
+ )
182
+ return false;
183
+ }
184
+ return true;
185
+ }
186
+
187
+ /** A bounded ancestor search; absent, malformed or stale proof always requires the full gate. */
188
+ export function hasVerifiedIncrement(
189
+ cwd: string,
190
+ oldSha: string,
191
+ newSha: string,
192
+ paths: string[],
193
+ ): boolean {
194
+ if (
195
+ !SHA.test(oldSha) ||
196
+ !SHA.test(newSha) ||
197
+ /^0+$/.test(oldSha) ||
198
+ !runGit(cwd, ["merge-base", "--is-ancestor", oldSha, newSha]).ok
199
+ )
200
+ return false;
201
+ const raw = git(cwd, ["show", `${newSha}:package.json`]);
202
+ const parsed = raw === null ? null : parseJson(raw);
203
+ const definition = parsed?.ok ? gateDefinition(parsed.value) : null;
204
+ const localPkg = readPackageJson(cwd);
205
+ if (
206
+ !definition ||
207
+ !localPkg.ok ||
208
+ gateDefinition(localPkg.pkg)?.fingerprint !== definition.fingerprint
209
+ )
210
+ return false;
211
+ const ancestors = git(cwd, ["rev-list", "--max-count=128", oldSha]);
212
+ const firstFile = receiptPath(cwd, oldSha);
213
+ if (!ancestors || !firstFile) return false;
214
+ const dir = path.dirname(firstFile);
215
+ for (const sha of ancestors.split("\n")) {
216
+ const file = path.join(dir, `${sha}.json`);
217
+ if (!validReceipt(cwd, file, sha, definition)) continue;
218
+ const diff = changedOutside(cwd, sha, newSha, paths);
219
+ if (diff.ok && diff.outside.length === 0 && noLaterFailure(cwd, dir, sha, newSha, definition))
220
+ return true;
221
+ }
222
+ return false;
223
+ }
@@ -64,6 +64,7 @@ import { readBkitConfig } from "../../shared/settings.js";
64
64
  import { SEEDED_BKIT_DEFAULTS } from "../../install/modules/core.js";
65
65
  import {
66
66
  CLAUDE_CLOUD_RELPATH,
67
+ CODEX_CLOUD_RELPATH,
67
68
  CURSOR_CLOUD_RELPATH,
68
69
  resolveClaudeDerivedAllows,
69
70
  } from "../../install/cloud-env.js";
@@ -378,8 +379,10 @@ const CORE_TEMPLATE_DOCTRINE: ManifestEntry[] = [
378
379
  { path: ".agents/docs.md", format: "markered-text", module: "core" },
379
380
  { path: ".agents/rules.md", format: "markered-text", module: "core" },
380
381
  { path: ".agents/skills.md", format: "markered-text", module: "core" },
381
- // Retired path of `.bkit/lite.md` (5.1.0 – 5.2.4), for an install never upgraded since.
382
+ // Retired `.agents/shortcuts.md` (5.1.0 – 5.2.4), for an install never upgraded since.
382
383
  { path: ".agents/shortcuts.md", format: "markered-text", module: "core" },
384
+ // Retired `.bkit/lite.md` (5.2.5 – 6.0.0), for an install never upgraded since.
385
+ { path: ".bkit/lite.md", format: "markered-text", module: "core" },
383
386
  ];
384
387
 
385
388
  /**
@@ -910,32 +913,23 @@ export async function runUninstall(
910
913
  }
911
914
  }
912
915
 
913
- // Remove the generated `.claude/bkit-cloud.md` (untracked, gitignored — holds resolved
914
- // secrets). It is not in the manifest, so the table-driven pass never sees it;
915
- // delete it explicitly when the claude host is uninstalled so a live-secrets file
916
- // is never left behind. Pushed to result.deleted so a dry-run reports it too.
917
- if (moduleList.includes("claude")) {
918
- const cloudAbs = path.join(ctx.cwd, CLAUDE_CLOUD_RELPATH);
919
- if (fs.existsSync(cloudAbs)) {
920
- result.deleted.push(CLAUDE_CLOUD_RELPATH);
921
- if (!ctx.dryRun) {
922
- fs.rmSync(cloudAbs, { force: true });
923
- console.log(`${ctx.logPrefix} delete: ${CLAUDE_CLOUD_RELPATH} (generated cloud setup doc)`);
924
- }
925
- }
926
- }
927
-
928
- // Same for the Cursor twin `.cursor/bkit-cloud.md` (writeCursorCloudDoc) — untracked,
929
- // gitignored, holds resolved secrets; delete it explicitly when the cursor host is
930
- // uninstalled so a live-secrets file is never left behind.
931
- if (moduleList.includes("cursor")) {
932
- const cloudAbs = path.join(ctx.cwd, CURSOR_CLOUD_RELPATH);
933
- if (fs.existsSync(cloudAbs)) {
934
- result.deleted.push(CURSOR_CLOUD_RELPATH);
935
- if (!ctx.dryRun) {
936
- fs.rmSync(cloudAbs, { force: true });
937
- console.log(`${ctx.logPrefix} delete: ${CURSOR_CLOUD_RELPATH} (generated cloud setup doc)`);
938
- }
916
+ // Remove each uninstalled host's generated `<host>/bkit-cloud.md` (untracked,
917
+ // gitignored — holds resolved secrets). Not in the manifest, so the table-driven pass
918
+ // never sees them; delete explicitly so a live-secrets file is never left behind.
919
+ // Pushed to result.deleted so a dry-run reports them too.
920
+ const cloudDocs: ReadonlyArray<readonly [ModuleFlag, string]> = [
921
+ ["claude", CLAUDE_CLOUD_RELPATH],
922
+ ["cursor", CURSOR_CLOUD_RELPATH],
923
+ ["codex", CODEX_CLOUD_RELPATH],
924
+ ];
925
+ for (const [host, relPath] of cloudDocs) {
926
+ if (!moduleList.includes(host)) continue;
927
+ const cloudAbs = path.join(ctx.cwd, relPath);
928
+ if (!fs.existsSync(cloudAbs)) continue;
929
+ result.deleted.push(relPath);
930
+ if (!ctx.dryRun) {
931
+ fs.rmSync(cloudAbs, { force: true });
932
+ console.log(`${ctx.logPrefix} delete: ${relPath} (generated cloud setup doc)`);
939
933
  }
940
934
  }
941
935
 
@@ -63,8 +63,10 @@ import { detectInstalledModules } from "./check.js";
63
63
  import { remapTemplateDest } from "../../install/template-copies.js";
64
64
  import {
65
65
  CLAUDE_CLOUD_RELPATH,
66
+ CODEX_CLOUD_RELPATH,
66
67
  CURSOR_CLOUD_RELPATH,
67
68
  writeClaudeCloudDoc,
69
+ writeCodexCloudDoc,
68
70
  writeCursorCloudDoc,
69
71
  writeCursorCliPermissionsArtifact,
70
72
  } from "../../install/cloud-env.js";
@@ -736,13 +738,19 @@ export async function runUpgradeCommand(upgradeFlags: UpgradeFlags): Promise<voi
736
738
  } else if (ent.isFile()) {
737
739
  // Single shared dotfile remap (gitignore → .gitignore, npmignore → .npmignore).
738
740
  const relPath = remapTemplateDest(entRel);
739
- // `.claude/bkit-cloud.md` + `.cursor/bkit-cloud.md` are GENERATED output files
740
- // (writeClaudeCloudDoc / writeCursorCloudDoc), not payload files to reconcile:
741
- // install/upgrade regenerate them with resolved secret values, so the raw
742
- // source is never a byte-match and the walk must never drift-flag or
741
+ // `.claude/` + `.cursor/` + `.codex/bkit-cloud.md` are GENERATED output files
742
+ // (writeClaudeCloudDoc / writeCursorCloudDoc / writeCodexCloudDoc), not payload
743
+ // files to reconcile: install/upgrade regenerate them with resolved secret values,
744
+ // so the raw source is never a byte-match and the walk must never drift-flag or
743
745
  // overwrite them. Regenerated explicitly in the runUpgrade block below
744
746
  // (host-gated, non-dry-run).
745
- if (relPath === CLAUDE_CLOUD_RELPATH || relPath === CURSOR_CLOUD_RELPATH) continue;
747
+ if (
748
+ relPath === CLAUDE_CLOUD_RELPATH ||
749
+ relPath === CURSOR_CLOUD_RELPATH ||
750
+ relPath === CODEX_CLOUD_RELPATH
751
+ ) {
752
+ continue;
753
+ }
746
754
  if (relPath === MCP_ROOT_RELPATH || relPath === CURSOR_MCP_RELPATH) continue;
747
755
  const entry = entryByPath.get(relPath);
748
756
  const ownerModule = entry?.module;
@@ -961,16 +969,23 @@ export async function runUpgradeCommand(upgradeFlags: UpgradeFlags): Promise<voi
961
969
  }
962
970
  }
963
971
 
964
- // Same for `.cursor/bkit-cloud.md` — cursor-host-gated twin (see writeCursorCloudDoc).
965
- // Uses upgradeTracker so the Linear/GitHub env-var policy matches the installed
966
- // tracker; excluded from the payload walk above for the same reason as the Claude doc.
972
+ // Same for `.cursor/bkit-cloud.md` and `.codex/bkit-cloud.md` — host-gated twins (see
973
+ // writeCursorCloudDoc / writeCodexCloudDoc); excluded from the payload walk above for
974
+ // the same reason as the Claude doc.
967
975
  if (!upgradeFlags.dryRun && renderModules.has("cursor") && tokens) {
968
- if (writeCursorCloudDoc(process.cwd(), tokens, upgradeTracker)) {
976
+ if (writeCursorCloudDoc(process.cwd(), tokens)) {
969
977
  console.log(
970
978
  `${LOG_PREFIX} upgrade: .cursor/bkit-cloud.md (regenerated — gitignored, holds resolved secrets)`,
971
979
  );
972
980
  }
973
981
  }
982
+ if (!upgradeFlags.dryRun && renderModules.has("codex") && tokens) {
983
+ if (writeCodexCloudDoc(process.cwd(), tokens)) {
984
+ console.log(
985
+ `${LOG_PREFIX} upgrade: .codex/bkit-cloud.md (regenerated — gitignored, holds resolved secrets)`,
986
+ );
987
+ }
988
+ }
974
989
 
975
990
  // Network allowlist + MCP allows — OpenCode from renderOpencodeJson; Claude enrich
976
991
  // below; `.bkit/allowlist.json` in renderManagedOutputs above; Cursor
@@ -1010,12 +1025,14 @@ export async function runUpgradeCommand(upgradeFlags: UpgradeFlags): Promise<voi
1010
1025
  // exit), so feed those writes into canonicalHashes — keeping install/upgrade `.bkit/version`
1011
1026
  // parity.
1012
1027
  if (!upgradeFlags.dryRun) {
1013
- const renderedDocPaths = renderWs.writes.map((w) =>
1014
- path.relative(
1015
- process.cwd(),
1016
- path.isAbsolute(w.path) ? w.path : path.resolve(process.cwd(), w.path),
1017
- ),
1018
- );
1028
+ const renderedDocPaths = renderWs.writes
1029
+ .filter((w) => !w.unhashed)
1030
+ .map((w) =>
1031
+ path.relative(
1032
+ process.cwd(),
1033
+ path.isAbsolute(w.path) ? w.path : path.resolve(process.cwd(), w.path),
1034
+ ),
1035
+ );
1019
1036
  updateCanonicalHashesAfterUpgrade(
1020
1037
  {
1021
1038
  updated: [