@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,102 @@
1
+ // install/context-ci-workflow.ts — the CI-run lookup in the consumer's `context=ci` and
2
+ // `context=e2e` blocks in `.agents/context.md`.
3
+ //
4
+ // A lookup without `--workflow` takes the newest run of any workflow on the branch. Other
5
+ // workflows (a security scan, a cloud agent) often finish after CI and pass, so the block reads
6
+ // their run and reports nothing failing. The consumer owns the copies below
7
+ // `<!-- bkit:end -->`, so upgrade rewrites a lookup only when it is byte-identical to the line
8
+ // an older bkit template carried. Register: docs/migrations.md.
9
+
10
+ import * as fs from "node:fs";
11
+ import * as path from "node:path";
12
+
13
+ import { readBkitConfig } from "../shared/settings.js";
14
+ import { findLineAnchoredMarkers, selectMarkers } from "./managed-block.js";
15
+ import type { WriteSet } from "./write.js";
16
+
17
+ const CONTEXT_FILE = path.join(".agents", "context.md");
18
+ const LOOKUP_TAIL = '=$(gh run list --branch "$(git branch --show-current)" --limit 1 \\';
19
+ /** The shipped lookup's first line: `RUN_JSON` in `bkit-github.md`, `RUN_ID` in the e2e blocks. */
20
+ const SHIPPED_LOOKUP = new RegExp(
21
+ `^(RUN_JSON|RUN_ID)${LOOKUP_TAIL.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")}$`,
22
+ );
23
+ /** Any lookup of the current branch's runs, shipped or edited. */
24
+ const ANY_LOOKUP = /gh run list --branch "\$\(git branch --show-current\)"/;
25
+ const NAMES_WORKFLOW = /(?:^|\s)(?:--workflow|-w)(?:\s|=)/;
26
+ const PLAIN_FILE_NAME = /^[\w.-]+$/;
27
+
28
+ export interface CiLookupResult {
29
+ /** The file with every shipped lookup below `<!-- bkit:end -->` scoped to the CI workflow. */
30
+ content: string;
31
+ /** How many lookups were rewritten. */
32
+ rewritten: number;
33
+ /** Lookups below `<!-- bkit:end -->` that read every workflow's runs and were left as written. */
34
+ unscoped: string[];
35
+ }
36
+
37
+ /**
38
+ * Rewrites each shipped CI-run lookup below the first line-anchored `<!-- bkit:end -->` so it
39
+ * reads only `workflow`'s runs: a `CI_WORKFLOW="${CI_WORKFLOW:-<workflow>}"` line goes above
40
+ * it, and the lookup gains `--workflow "$CI_WORKFLOW"`. A lookup that names a workflow on
41
+ * either line is already scoped and stays. An edited lookup, or any lookup when `workflow` is
42
+ * not a plain file name, stays and is listed in `unscoped`. A line ending in CR keeps it.
43
+ */
44
+ export function scopeCiRunLookups(content: string, workflow: string): CiLookupResult {
45
+ const endAt = findLineAnchoredMarkers(content, selectMarkers("html-comment")[1])[0];
46
+ if (endAt === undefined) return { content, rewritten: 0, unscoped: [] };
47
+ const lines = content.slice(endAt).split("\n");
48
+ const plainName = PLAIN_FILE_NAME.test(workflow);
49
+ const out: string[] = [];
50
+ const unscoped: string[] = [];
51
+ let rewritten = 0;
52
+ lines.forEach((line, i) => {
53
+ const bare = line.replace(/\r$/, "");
54
+ const next = lines[i + 1] ?? "";
55
+ if (!ANY_LOOKUP.test(bare) || NAMES_WORKFLOW.test(bare) || NAMES_WORKFLOW.test(next)) {
56
+ out.push(line);
57
+ return;
58
+ }
59
+ if (!plainName || !SHIPPED_LOOKUP.test(bare)) {
60
+ unscoped.push(bare);
61
+ out.push(line);
62
+ return;
63
+ }
64
+ const cr = line.endsWith("\r") ? "\r" : "";
65
+ out.push(`CI_WORKFLOW="\${CI_WORKFLOW:-${workflow}}"${cr}`);
66
+ out.push(line.replace(" --limit 1 ", ' --workflow "$CI_WORKFLOW" --limit 1 '));
67
+ rewritten++;
68
+ });
69
+ if (rewritten === 0) return { content, rewritten, unscoped };
70
+ return { content: content.slice(0, endAt) + out.join("\n"), rewritten, unscoped };
71
+ }
72
+
73
+ /** Absolute paths already named in this process. */
74
+ const warned = new Set<string>();
75
+
76
+ /**
77
+ * Migration (installs up to 6.0.x, `docs/migrations.md`): scopes each shipped CI-run lookup in
78
+ * `.agents/context.md` to the workflow file `bkit.testing.ciWorkflow` names. Recorded in ws as
79
+ * an update; the canonical hash covers the managed block only. A lookup it leaves unscoped is
80
+ * named once per process, so the consumer can add `--workflow` by hand.
81
+ */
82
+ export function migrateContextCiWorkflow(dryRun: boolean, ws: WriteSet, logPrefix: string): void {
83
+ if (!fs.lstatSync(CONTEXT_FILE, { throwIfNoEntry: false })?.isFile()) return;
84
+ const workflow = readBkitConfig(process.cwd()).ciWorkflow;
85
+ const result = scopeCiRunLookups(fs.readFileSync(CONTEXT_FILE, "utf-8"), workflow);
86
+ // Upgrade runs this pass again as its closing dry-run check, so each file is named once.
87
+ const abs = path.resolve(CONTEXT_FILE);
88
+ if (result.unscoped.length > 0 && !warned.has(abs)) {
89
+ warned.add(abs);
90
+ console.warn(
91
+ `${logPrefix} ${CONTEXT_FILE}: ${result.unscoped.length} CI run lookup(s) read the newest run of every workflow on the branch, so a later passing workflow hides a failed ${workflow} run. Add \`--workflow "${workflow}"\` to each \`gh run list --branch\` line by hand (the shipped form in .bkit/templates/context/bkit-github.md shows how).`,
92
+ );
93
+ }
94
+ if (result.rewritten === 0) return;
95
+ if (!dryRun) fs.writeFileSync(CONTEXT_FILE, result.content, "utf-8");
96
+ if (!ws.writes.some((w) => path.normalize(w.path) === CONTEXT_FILE)) {
97
+ ws.writes.push({ path: CONTEXT_FILE, action: "update" });
98
+ }
99
+ console.log(
100
+ `${logPrefix} ${dryRun ? "[dry-run] " : ""}core: ${CONTEXT_FILE} — CI run lookups now read only ${workflow} runs (${result.rewritten})`,
101
+ );
102
+ }
@@ -137,19 +137,20 @@ const CORE_MANIFEST: ManifestEntry[] = [
137
137
  // `.bkit/core/.bkit/` and are read from there at runtime (getBkitDocsRoot); these
138
138
  // consumer copies are force-overwritten mirrors (writeTier1) so a consumer can read
139
139
  // them in-repo. Whole file is bkit-owned → byte-equal-text (refreshed every install);
140
- // prompts.md and lite.md are markered-text, keeping the consumer section below `bkit:end`.
140
+ // prompts.md is markered-text, keeping the consumer section below `bkit:end`.
141
141
  { path: ".bkit/authoring.md", format: "byte-equal-text", module: "core" },
142
142
  { path: ".bkit/cloud.md", format: "byte-equal-text", module: "core" },
143
+ { path: ".bkit/cli.md", format: "byte-equal-text", module: "core" },
143
144
  { path: ".bkit/comparison.md", format: "byte-equal-text", module: "core" },
144
145
  { path: ".bkit/install.md", format: "byte-equal-text", module: "core" },
145
146
  { path: ".bkit/jsonl.md", format: "byte-equal-text", module: "core" },
146
147
  // The MIT notice that travels with the files bkit writes: the full text and copyright
147
148
  // notice. Sourced from `.bkit/core/.bkit/LICENSE.md`.
148
149
  { path: ".bkit/LICENSE.md", format: "byte-equal-text", module: "core" },
149
- { path: ".bkit/lite.md", format: "markered-text", module: "core" },
150
150
  { path: ".bkit/pipeline.md", format: "byte-equal-text", module: "core" },
151
151
  { path: ".bkit/providers.md", format: "byte-equal-text", module: "core" },
152
152
  { path: ".bkit/prompts.md", format: "markered-text", module: "core" },
153
+ { path: ".bkit/router.md", format: "byte-equal-text", module: "core" },
153
154
  { path: ".bkit/templates.md", format: "byte-equal-text", module: "core" },
154
155
  { path: ".bkit/trackers.md", format: "byte-equal-text", module: "core" },
155
156
  { path: ".bkit/workflows.md", format: "byte-equal-text", module: "core" },
@@ -209,7 +210,7 @@ const CLAUDE_MANIFEST: ManifestEntry[] = [
209
210
  // (bkit-tests-static / -unit / -integration / -e2e / -live). Where a step is not a
210
211
  // tier (`format`, the ship gate) the name spells out the actual steps. One exception:
211
212
  // `min` sits off the chain: the least a push runs, on a push that changes no code
212
- // (`bkit.testing.minPushPaths`); its steps are whatever that push can still break.
213
+ // (what bkit writes, plus `bkit.testing.minPushPaths`); its steps are whatever that push can still break.
213
214
  //
214
215
  // The consumer owns every value: a turbo monorepo writes `turbo run … --filter`,
215
216
  // a Python repo writes `ruff check && pytest`. bkit never reads a value — only
@@ -218,7 +219,7 @@ const CLAUDE_MANIFEST: ManifestEntry[] = [
218
219
  // Seeded by core on every install and upgrade (seedCorePackageJsonScripts,
219
220
  // install/modules/index.ts): add-if-missing, so a name already present is never touched,
220
221
  // and uninstall leaves every name in place. The tool scripts the defaults chain
221
- // (typecheck, lint, format:check, lint:prose, slop:delta, lint-staged) are the
222
+ // (typecheck, lint, format:check, bkit:lint:prose, bkit:slop:delta, lint-staged) are the
222
223
  // consumer's to add — `.bkit/templates.md` lists them; the
223
224
  // `gate-missing-called-scripts` advisory names any that are missing.
224
225
  //
@@ -227,7 +228,7 @@ const CLAUDE_MANIFEST: ManifestEntry[] = [
227
228
  // directly, one step each.
228
229
  //
229
230
  // `lint:slop` is in no gate: `slop-scan scan` is report-only and never fails. The gate
230
- // that fails on new findings is `slop:delta`.
231
+ // that fails on new findings is `bkit:slop:delta`.
231
232
  //
232
233
  // NOT SEEDED: the three deeper gates (…-integration, …-integration-e2e,
233
234
  // …-integration-e2e-live) are absent unless the consumer writes them. Each is one line
@@ -239,17 +240,17 @@ export const BKIT_GATE_SCRIPTS: Readonly<Record<string, string>> = {
239
240
  // `.husky/pre-commit`: prettier --write over staged files, and nothing else —
240
241
  // seconds, not minutes. Prose is a whole-repo scan, so it gates at pre-push.
241
242
  "bkit:gate:format": "pnpm lint-staged",
242
- // `.husky/pre-push` on a min push (every file matches `bkit.testing.minPushPaths`): no code, so
243
+ // `.husky/pre-push` on a min push (every file is one bkit writes or `bkit.testing.minPushPaths` adds): no code, so
243
244
  // no typecheck, lint or tests. Off the chain. Add any test that reads a min-push file.
244
- "bkit:gate:min": "pnpm format:check && pnpm lint:prose && pnpm slop:delta",
245
+ "bkit:gate:min": "pnpm format:check && pnpm bkit:lint:prose && pnpm bkit:slop:delta",
245
246
  // Everything that needs no test runner. Every part has a matching step in the
246
247
  // bkit-tests-static CI job; audits/templates/template-ci-yml.test.ts fails when one is missing.
247
248
  // Callers: build's plan-execute loop between tasks, and the `.husky/pre-push` revert
248
249
  // path.
249
250
  "bkit:gate:static":
250
- "pnpm typecheck && pnpm lint && pnpm format:check && pnpm lint:prose && pnpm slop:delta",
251
+ "pnpm typecheck && pnpm lint && pnpm format:check && pnpm bkit:lint:prose && pnpm bkit:slop:delta",
251
252
  // The default local gate: `.husky/pre-push` (when no `…-integration` gate is declared),
252
- // build Step 11, the remediates. `pnpm test` is the unit tier only: a test file the
253
+ // build Steps 8 and 12, the remediates. `pnpm test` is the unit tier only: a test file the
253
254
  // integration gate also runs must not match it.
254
255
  "bkit:gate:static-unit": "pnpm bkit:gate:static && pnpm test",
255
256
  // Ship's conflict-resolve, the only caller whose dependency graph may have just
@@ -283,18 +284,25 @@ export const BKIT_DEBUG_GATES: readonly string[] = [
283
284
  ];
284
285
 
285
286
  /**
286
- * What `/bkit-build` Step 11 will run, in DESCENDING order — first one declared wins.
287
+ * What `/bkit-build` Step 12 will run, in DESCENDING order — first one declared wins.
288
+ * The Step 8 group gate runs `BKIT_GROUP_GATES` instead.
287
289
  *
288
290
  * Build stops at integration; E2E and live are not in this list.
289
291
  *
290
- * Neither entry is seeded: declaring `bkit:gate:static-unit-integration` opts the build
291
- * loop and the pre-push hook into the integration tier.
292
+ * Declaring `bkit:gate:static-unit-integration` (never seeded) opts Step 12 and the
293
+ * pre-push hook into the integration tier.
292
294
  */
293
295
  export const BKIT_BUILD_GATES: readonly string[] = [
294
296
  "bkit:gate:static-unit-integration",
295
297
  "bkit:gate:static-unit",
296
298
  ];
297
299
 
300
+ /**
301
+ * What `/bkit-build` Step 8 runs after every group but the last, and hands the Step 9 fix
302
+ * round: static checks and the unit tier. Integration runs once, at Step 12.
303
+ */
304
+ export const BKIT_GROUP_GATES: readonly string[] = ["bkit:gate:static-unit"];
305
+
298
306
  /**
299
307
  * What `.husky/pre-push` runs on a full push, in DESCENDING order — first one declared wins.
300
308
  *
@@ -314,6 +322,23 @@ export const BKIT_PUSH_GATES: readonly string[] = [
314
322
  */
315
323
  export const BKIT_TEST_FILE_SCRIPT = "bkit:test:file";
316
324
 
325
+ /**
326
+ * Lints ONE test file — `pnpm bkit:lint:file <repo-relative path>`, exit 0 when clean.
327
+ * `bkit tests red` runs it before recording a red, so a lint rewrite never lands after
328
+ * the red. Never seeded: install, check and upgrade advise when `bkit:test:file` is
329
+ * declared and this is not (detectGateAdvisories).
330
+ */
331
+ export const BKIT_LINT_FILE_SCRIPT = "bkit:lint:file";
332
+
333
+ /**
334
+ * Checks only what changed — `pnpm bkit:gate:changed <repo-relative path>...`, exit 0
335
+ * when clean: the tests that import the files, the tests that name their paths, and
336
+ * static checks on the files. `bkit tests changed` passes the files and falls back to a
337
+ * whole gate when this is undeclared. Never seeded: install, check and upgrade advise
338
+ * when it is missing (detectGateAdvisories).
339
+ */
340
+ export const BKIT_GATE_CHANGED_SCRIPT = "bkit:gate:changed";
341
+
317
342
  /**
318
343
  * The deeper gates, shallowest first, with what declaring each one costs.
319
344
  *
@@ -412,6 +437,13 @@ export const OPENCODE_MANIFEST: ManifestEntry[] = [
412
437
  format: "markered-text",
413
438
  module: "opencode",
414
439
  },
440
+ // bkit-rules.js — same split as bkit-gateguard.js. Delivers the rules-read advisory
441
+ // on the session's first tool call (opencode has no session-start event).
442
+ {
443
+ path: ".opencode/plugin/bkit-rules.js",
444
+ format: "markered-text",
445
+ module: "opencode",
446
+ },
415
447
  // Agent and command mirrors are managed dynamically (not listed individually here —
416
448
  // the exact set depends on the bkit-prefix prompt/workflow files at install time).
417
449
  // Uninstall uses the BKIT_PREFIX filter for .opencode/agents/ and .opencode/commands/.
@@ -449,6 +481,14 @@ export const CODEX_MANIFEST: ManifestEntry[] = [
449
481
  format: "markered-text",
450
482
  module: "codex",
451
483
  },
484
+ // bkit-rules.cjs — Tier-2 markered-text. Delivers the rules-read advisory once per
485
+ // session as `additionalContext` on the first tool call (Codex has no session-start
486
+ // event). Registered on two single-value matchers, `apply_patch` and `Bash`.
487
+ {
488
+ path: ".codex/hooks/bkit-rules.cjs",
489
+ format: "markered-text",
490
+ module: "codex",
491
+ },
452
492
  // Agent mirrors (.codex/agents/*.toml) and workflow skills (.agents/skills/bkit-*/) are
453
493
  // managed dynamically — the set follows the bkit-prefix prompt/workflow files at install.
454
494
  ];
@@ -486,6 +526,14 @@ export const ANTIGRAVITY_MANIFEST: ManifestEntry[] = [
486
526
  format: "markered-text",
487
527
  module: "antigravity",
488
528
  },
529
+ // bkit-rules.cjs — Tier-2 markered-text. Delivers the rules-read advisory once per
530
+ // session by denying the first tool call with the advisory as the reason (Antigravity's
531
+ // only channel to the model); the identical retry is allowed.
532
+ {
533
+ path: ".agents/plugins/bkit/hooks/bkit-rules.cjs",
534
+ format: "markered-text",
535
+ module: "antigravity",
536
+ },
489
537
  // Root GEMINI.md — Antigravity workspace-rule redirect to .agents/rules.md, owned by the
490
538
  // antigravity module: `uninstall --antigravity` removes it; other installs leave it.
491
539
  { path: "GEMINI.md", format: "markered-text", module: "antigravity" },
@@ -198,8 +198,9 @@ export function runAntigravityModule(ctx: ModuleContext): void {
198
198
  }
199
199
  }
200
200
 
201
- // --- bkit-gateguard.cjs / bkit-readguard.cjs — Tier-2 markered-text, twins of the Claude/Codex hooks ---
202
- for (const hook of ["bkit-gateguard.cjs", "bkit-readguard.cjs"]) {
201
+ // --- bkit-gateguard.cjs / bkit-readguard.cjs / bkit-rules.cjs — Tier-2 markered-text,
202
+ // twins of the Claude/Codex hooks ---
203
+ for (const hook of ["bkit-gateguard.cjs", "bkit-readguard.cjs", "bkit-rules.cjs"]) {
203
204
  const hookSrc = path.join(pluginHooksSrc, hook);
204
205
  const hookDst = path.join(ANTIGRAVITY_HOOKS_DIR, hook);
205
206
  if (fs.existsSync(hookSrc)) {
@@ -54,7 +54,7 @@ function setConsumerBkitField(field: string, value: string, dryRun: boolean): vo
54
54
  // The cloud workflow is a template (`.bkit/templates.md`). Shared first step of the
55
55
  // claude and opencode setup advisories.
56
56
  const CLOUD_WORKFLOW_ADOPT_STEP =
57
- " - Copy `.bkit/templates/.github/workflows/bkit-cloud.yml` to `.github/workflows/bkit-cloud.yml` and own it: bkit never writes or overwrites that file. Replace the `{{CLOUD_RUNNER}}` placeholder in both jobs' `runs-on` with a runner label (e.g. `ubuntu-latest`). `.bkit/templates.md` lists every placeholder; on each `bkit upgrade`, diff the refreshed template against your copy.\n";
57
+ " - Copy `.bkit/templates/.github/workflows/bkit-cloud.yml` to `.github/workflows/bkit-cloud.yml` and own it: bkit never writes or overwrites that file after you copy it. The one exception is a brand migration: `bkit upgrade` rewrites exact shipped old names in it and leaves any edited line. Replace the `{{CLOUD_RUNNER}}` placeholder in both jobs' `runs-on` with a runner label (e.g. `ubuntu-latest`). `.bkit/templates.md` lists every placeholder; on each `bkit upgrade`, diff the refreshed template against your copy.\n";
58
58
 
59
59
  // ---------------------------------------------------------------------------
60
60
  // runCloudModule — opt-in cloud-agent integration
@@ -110,7 +110,7 @@ export function runCloudModule(ctx: ModuleContext): void {
110
110
  "Cloud env config splits across the repo (`.claude/hooks/bkit-cloud-bootstrap.sh`, a copy-and-own template you adopt) and the Claude app dashboard (setup script + env vars + auth tokens, manual).",
111
111
  action:
112
112
  "Two locations to touch — full recipe in bkit's `cloud.md`.\n\n" +
113
- "IN REPO (copy-and-own; bkit never writes it):\n" +
113
+ "IN REPO (copy-and-own; bkit never writes it, apart from brand migrations that rewrite exact shipped old names):\n" +
114
114
  " - Adopt `.bkit/templates/.claude/hooks/bkit-cloud-bootstrap.sh` as `.claude/hooks/bkit-cloud-bootstrap.sh` and edit it freely — the baseline runs `pnpm install` / `vale sync` and the gh login on each cloud session; add your own repo-specific steps (Supabase start, turbo prebuild, etc. — examples inlined). The `.claude/settings.json` SessionStart entry runs it only when present (`test -f … || true`).\n\n" +
115
115
  "IN CLAUDE APP (claude.ai/code → environment selector → + Add environment):\n" +
116
116
  " - Name: the repo name (e.g. `acme-web`) — one environment per repo, since secrets are per-repo.\n" +
@@ -163,7 +163,7 @@ export function runCloudModule(ctx: ModuleContext): void {
163
163
  " - Allowed concurrency: latest-supersedes.\n" +
164
164
  " - Set `BKIT_LINEAR_API_KEY` as a **Runtime Secret** in the Cloud Agents dashboard (https://cursor.com/dashboard/cloud-agents) → your environment → Secrets tab.\n" +
165
165
  " - Label the issue `bkit:auto` in Linear before pushing the build commit.\n\n" +
166
- "IN REPO (copy each template and own it; bkit never writes or overwrites these files — see `.bkit/templates.md`):\n" +
166
+ "IN REPO (copy each template and own it; bkit never writes or overwrites these files, apart from brand migrations that rewrite exact shipped old names — see `.bkit/templates.md`):\n" +
167
167
  " - `.bkit/templates/.cursor/Dockerfile` → `.cursor/Dockerfile`: change Node major if `engines.node` differs from 20; add Playwright / Supabase CLI / extra apt deps.\n" +
168
168
  " - `.bkit/templates/.cursor/environment.json` → `.cursor/environment.json`: set `install` / `start` / `terminals[]` / `env` for your stack.",
169
169
  });
@@ -14,6 +14,7 @@ import {
14
14
  import { type IssueTracker, DEFAULT_ISSUE_TRACKER } from "../manifest.js";
15
15
  import { substituteWorkflow } from "../../render/trackers.js";
16
16
  import { readInstallingVersion } from "../../shared/package-json.js";
17
+ import { writeCodexCloudDoc } from "../cloud-env.js";
17
18
  import type { ModuleContext } from "./index.js";
18
19
  import { BKIT_PREFIX, installFile, listMdFiles, removeOrphans, trackMirrorWrite } from "./core.js";
19
20
 
@@ -168,8 +169,9 @@ export function runCodexModule(ctx: ModuleContext): void {
168
169
  }
169
170
  }
170
171
 
171
- // --- bkit-gateguard.cjs / bkit-readguard.cjs — Tier-2 markered-text, twins of the Claude hooks ---
172
- for (const hook of ["bkit-gateguard.cjs", "bkit-readguard.cjs"]) {
172
+ // --- bkit-gateguard.cjs / bkit-readguard.cjs / bkit-rules.cjs — Tier-2 markered-text,
173
+ // twins of the Claude hooks ---
174
+ for (const hook of ["bkit-gateguard.cjs", "bkit-readguard.cjs", "bkit-rules.cjs"]) {
173
175
  const hookSrc = path.join(codexHooks, hook);
174
176
  const hookDst = `.codex/hooks/${hook}`;
175
177
  if (fs.existsSync(hookSrc)) {
@@ -195,6 +197,17 @@ export function runCodexModule(ctx: ModuleContext): void {
195
197
  }
196
198
  }
197
199
 
200
+ // Generated copy-paste-ready Codex Cloud setup doc — `.codex/bkit-cloud.md`. Twin of
201
+ // `.claude/bkit-cloud.md` (runClaudeModule): UNTRACKED + gitignored, inlines REAL secret
202
+ // values resolved from `.envrc`, never enters ws.writes / canonicalHashes / `bkit check`
203
+ // drift. Skipped on dry-run (`bkit check`), which never writes secrets. Upgrade
204
+ // regenerates it via the same helper (see runUpgrade caller).
205
+ if (!dryRun && writeCodexCloudDoc(process.cwd(), ctx.tokens)) {
206
+ console.log(
207
+ `${logPrefix} ${tag}codex: .codex/bkit-cloud.md (generated — gitignored, holds resolved secrets)`,
208
+ );
209
+ }
210
+
198
211
  advisories.push({
199
212
  id: "codex-setup",
200
213
  severity: "advisory",