@cbartens/bkit 5.5.1 → 6.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (425) hide show
  1. package/.bkit/README.md +167 -154
  2. package/.bkit/core/.agents/context.md +95 -29
  3. package/.bkit/core/.agents/docs.md +18 -15
  4. package/.bkit/core/.agents/plugins/bkit/hooks/bkit-gateguard.cjs +1 -0
  5. package/.bkit/core/.agents/plugins/bkit/hooks/bkit-guardrails.cjs +6 -5
  6. package/.bkit/core/.agents/plugins/bkit/hooks/bkit-readguard.cjs +1 -0
  7. package/.bkit/core/.agents/plugins/bkit/hooks/bkit-rules.cjs +65 -0
  8. package/.bkit/core/.agents/rules.md +112 -102
  9. package/.bkit/core/.agents/skills.md +63 -15
  10. package/.bkit/core/.bkit/README.md +167 -154
  11. package/.bkit/core/.bkit/authoring.md +747 -0
  12. package/.bkit/core/.bkit/cli.md +407 -0
  13. package/.bkit/core/.bkit/cloud.md +283 -195
  14. package/.bkit/core/.bkit/comparison.md +45 -43
  15. package/.bkit/core/.bkit/install.md +166 -95
  16. package/.bkit/core/.bkit/jsonl.md +339 -196
  17. package/.bkit/core/.bkit/pipeline.md +142 -145
  18. package/.bkit/core/.bkit/prompts.md +295 -264
  19. package/.bkit/core/.bkit/providers.md +460 -277
  20. package/.bkit/core/.bkit/router.md +69 -0
  21. package/.bkit/core/.bkit/templates.md +530 -256
  22. package/.bkit/core/.bkit/trackers.md +116 -65
  23. package/.bkit/core/.bkit/workflows.md +742 -618
  24. package/.bkit/core/.claude/hooks/bkit-gateguard.cjs +2 -2
  25. package/.bkit/core/.claude/hooks/bkit-guardrails.cjs +3 -3
  26. package/.bkit/core/.claude/hooks/bkit-preflight.sh +45 -14
  27. package/.bkit/core/.codex/hooks/bkit-guardrails.cjs +3 -3
  28. package/.bkit/core/.codex/hooks/bkit-rules.cjs +57 -0
  29. package/.bkit/core/.cursor/hooks/bkit-guardrails.cjs +7 -7
  30. package/.bkit/core/.cursor/hooks/bkit-preflight.sh +47 -12
  31. package/.bkit/core/.opencode/plugin/bkit-rules.js +89 -0
  32. package/.bkit/core/AGENTS.md +6 -80
  33. package/.bkit/core/docs/templates/bkit-audit-accessibility.md +128 -130
  34. package/.bkit/core/docs/templates/bkit-audit-adoption.md +104 -94
  35. package/.bkit/core/docs/templates/bkit-audit-agents.md +96 -98
  36. package/.bkit/core/docs/templates/bkit-audit-aio-seo.md +100 -103
  37. package/.bkit/core/docs/templates/bkit-audit-analytics.md +141 -107
  38. package/.bkit/core/docs/templates/bkit-audit-annotations.md +99 -97
  39. package/.bkit/core/docs/templates/bkit-audit-app-performance.md +122 -121
  40. package/.bkit/core/docs/templates/bkit-audit-app-store.md +158 -101
  41. package/.bkit/core/docs/templates/bkit-audit-architecture.md +114 -96
  42. package/.bkit/core/docs/templates/bkit-audit-ci-performance.md +76 -97
  43. package/.bkit/core/docs/templates/bkit-audit-config.md +123 -101
  44. package/.bkit/core/docs/templates/bkit-audit-cost.md +86 -99
  45. package/.bkit/core/docs/templates/bkit-audit-coverage.md +76 -93
  46. package/.bkit/core/docs/templates/bkit-audit-database.md +102 -95
  47. package/.bkit/core/docs/templates/bkit-audit-dead-code.md +165 -108
  48. package/.bkit/core/docs/templates/bkit-audit-deferrals.md +115 -109
  49. package/.bkit/core/docs/templates/bkit-audit-dependencies.md +265 -113
  50. package/.bkit/core/docs/templates/bkit-audit-documentation.md +119 -118
  51. package/.bkit/core/docs/templates/bkit-audit-duplication.md +140 -111
  52. package/.bkit/core/docs/templates/bkit-audit-failures.md +111 -106
  53. package/.bkit/core/docs/templates/bkit-audit-flakes.md +100 -99
  54. package/.bkit/core/docs/templates/bkit-audit-gates.md +107 -103
  55. package/.bkit/core/docs/templates/bkit-audit-issues.md +105 -105
  56. package/.bkit/core/docs/templates/bkit-audit-llm.md +134 -85
  57. package/.bkit/core/docs/templates/bkit-audit-logs.md +124 -125
  58. package/.bkit/core/docs/templates/bkit-audit-models.md +99 -78
  59. package/.bkit/core/docs/templates/bkit-audit-privacy.md +56 -76
  60. package/.bkit/core/docs/templates/bkit-audit-prompts.md +63 -78
  61. package/.bkit/core/docs/templates/bkit-audit-red-team.md +125 -93
  62. package/.bkit/core/docs/templates/bkit-audit-reliability.md +97 -96
  63. package/.bkit/core/docs/templates/bkit-audit-repo.md +170 -98
  64. package/.bkit/core/docs/templates/bkit-audit-security.md +207 -121
  65. package/.bkit/core/docs/templates/bkit-audit-slop.md +78 -95
  66. package/.bkit/core/docs/templates/bkit-audit-testing.md +163 -139
  67. package/.bkit/core/docs/templates/bkit-audit-usability.md +114 -96
  68. package/.bkit/core/docs/templates/bkit-plan.md +158 -281
  69. package/.bkit/core/engine/checks/after/auth.ts +40 -37
  70. package/.bkit/core/engine/checks/after/ci-yml.ts +104 -31
  71. package/.bkit/core/engine/checks/after/github.ts +95 -17
  72. package/.bkit/core/engine/checks/after/index.ts +21 -8
  73. package/.bkit/core/engine/checks/after/suppression.ts +8 -5
  74. package/.bkit/core/engine/checks/after/tools.ts +125 -123
  75. package/.bkit/core/engine/checks/before/context-fetch.ts +227 -33
  76. package/.bkit/core/engine/checks/before/env.ts +3 -3
  77. package/.bkit/core/engine/checks/before/files.ts +5 -4
  78. package/.bkit/core/engine/checks/before/index.ts +25 -1
  79. package/.bkit/core/engine/checks/before/repo.ts +208 -2
  80. package/.bkit/core/engine/checks/status-holes.ts +916 -123
  81. package/.bkit/core/engine/checks/tips/catalogue.ts +82 -20
  82. package/.bkit/core/engine/checks/tips/detect.ts +66 -0
  83. package/.bkit/core/engine/checks/tips/index.ts +52 -11
  84. package/.bkit/core/engine/cli.ts +251 -130
  85. package/.bkit/core/engine/commands/analysis.ts +282 -199
  86. package/.bkit/core/engine/commands/ci/ci.ts +363 -29
  87. package/.bkit/core/engine/commands/ci/pins.ts +172 -0
  88. package/.bkit/core/engine/commands/ci/push-gate.ts +223 -0
  89. package/.bkit/core/engine/commands/comply.ts +77 -103
  90. package/.bkit/core/engine/commands/install/doctor.ts +2 -2
  91. package/.bkit/core/engine/commands/install/install.ts +57 -18
  92. package/.bkit/core/engine/commands/install/uninstall.ts +86 -55
  93. package/.bkit/core/engine/commands/install/upgrade.ts +32 -15
  94. package/.bkit/core/engine/commands/land.ts +139 -18
  95. package/.bkit/core/engine/commands/lib.ts +381 -22
  96. package/.bkit/core/engine/commands/registry.ts +10 -2
  97. package/.bkit/core/engine/commands/setup/setup.ts +8 -7
  98. package/.bkit/core/engine/commands/stats.ts +260 -0
  99. package/.bkit/core/engine/commands/tips.ts +10 -5
  100. package/.bkit/core/engine/commands/workflow/branches.ts +2215 -176
  101. package/.bkit/core/engine/commands/workflow/challenge.ts +748 -0
  102. package/.bkit/core/engine/commands/workflow/completeness.ts +109 -0
  103. package/.bkit/core/engine/commands/workflow/context.ts +1249 -47
  104. package/.bkit/core/engine/commands/workflow/counters.ts +483 -95
  105. package/.bkit/core/engine/commands/workflow/decisions.ts +585 -0
  106. package/.bkit/core/engine/commands/workflow/disk.ts +238 -56
  107. package/.bkit/core/engine/commands/workflow/fids.ts +811 -33
  108. package/.bkit/core/engine/commands/workflow/issues.ts +413 -64
  109. package/.bkit/core/engine/commands/workflow/ledgers.ts +1333 -36
  110. package/.bkit/core/engine/commands/workflow/locks.ts +28 -2
  111. package/.bkit/core/engine/commands/workflow/plan-blocks.ts +691 -0
  112. package/.bkit/core/engine/commands/workflow/plan-versions.ts +21 -0
  113. package/.bkit/core/engine/commands/workflow/plans.ts +257 -0
  114. package/.bkit/core/engine/commands/workflow/prs.ts +178 -33
  115. package/.bkit/core/engine/commands/workflow/repo.ts +66 -8
  116. package/.bkit/core/engine/commands/workflow/roadmap.ts +72 -22
  117. package/.bkit/core/engine/commands/workflow/run-facts.ts +492 -0
  118. package/.bkit/core/engine/commands/workflow/runs.ts +827 -79
  119. package/.bkit/core/engine/commands/workflow/runtime.ts +25 -1
  120. package/.bkit/core/engine/commands/workflow/skills.ts +1 -0
  121. package/.bkit/core/engine/commands/workflow/status.ts +329 -33
  122. package/.bkit/core/engine/commands/workflow/step-table.ts +381 -0
  123. package/.bkit/core/engine/commands/workflow/steps.ts +841 -105
  124. package/.bkit/core/engine/commands/workflow/summary-findings.ts +177 -0
  125. package/.bkit/core/engine/commands/workflow/summary.ts +544 -0
  126. package/.bkit/core/engine/commands/workflow/tasks.ts +409 -0
  127. package/.bkit/core/engine/commands/workflow/test-blocks.ts +254 -0
  128. package/.bkit/core/engine/commands/workflow/tests-changed.ts +201 -0
  129. package/.bkit/core/engine/commands/workflow/tests.ts +2124 -330
  130. package/.bkit/core/engine/commands/workflow/tracker.ts +1195 -0
  131. package/.bkit/core/engine/commands/workflow/workflows.ts +1197 -235
  132. package/.bkit/core/engine/commands/workflow/worktrees.ts +543 -24
  133. package/.bkit/core/engine/install/cloud-env.ts +251 -121
  134. package/.bkit/core/engine/install/context-ci-workflow.ts +102 -0
  135. package/.bkit/core/engine/install/manifest.ts +67 -17
  136. package/.bkit/core/engine/install/modules/antigravity.ts +3 -2
  137. package/.bkit/core/engine/install/modules/cloud.ts +24 -16
  138. package/.bkit/core/engine/install/modules/codex.ts +15 -2
  139. package/.bkit/core/engine/install/modules/core.ts +1196 -45
  140. package/.bkit/core/engine/install/modules/cursor.ts +6 -6
  141. package/.bkit/core/engine/install/modules/opencode.ts +18 -6
  142. package/.bkit/core/engine/install/template-notes.ts +130 -0
  143. package/.bkit/core/engine/install/version-file.ts +9 -4
  144. package/.bkit/core/engine/install/write.ts +5 -0
  145. package/.bkit/core/engine/ledgers/compact.ts +124 -0
  146. package/.bkit/core/engine/ledgers/journal.ts +291 -0
  147. package/.bkit/core/engine/ledgers/migrate.ts +92 -0
  148. package/.bkit/core/engine/ledgers/status.ts +249 -21
  149. package/.bkit/core/engine/ledgers/telemetry.ts +1397 -253
  150. package/.bkit/core/engine/render/hosts.ts +118 -14
  151. package/.bkit/core/engine/render/models.ts +12 -0
  152. package/.bkit/core/engine/shared/bkit-latest.ts +26 -4
  153. package/.bkit/core/engine/shared/branches.ts +4 -1
  154. package/.bkit/core/engine/shared/dep-updater.ts +60 -0
  155. package/.bkit/core/engine/shared/egress.ts +8 -1
  156. package/.bkit/core/engine/shared/json.ts +25 -7
  157. package/.bkit/core/engine/shared/package-manager.ts +9 -0
  158. package/.bkit/core/engine/shared/settings.ts +243 -31
  159. package/.bkit/core/engine/shared/text.ts +361 -0
  160. package/.bkit/core/engine/shared/timeouts.ts +2 -0
  161. package/.bkit/core/engine/tools/cli-doc.ts +111 -0
  162. package/.bkit/core/engine/tools/grammar-density.ts +215 -0
  163. package/.bkit/core/engine/tools/instructions-sources.ts +832 -0
  164. package/.bkit/core/engine/tools/instructions.ts +1802 -0
  165. package/.bkit/core/hooks/antigravity-hook.js +25 -10
  166. package/.bkit/core/hooks/gateguard-engine.js +54 -29
  167. package/.bkit/core/hooks/guardrails-shell.js +4 -5
  168. package/.bkit/core/hooks/guardrails-tiers.js +10 -4
  169. package/.bkit/core/hooks/preflight-linear.sh +9 -9
  170. package/.bkit/core/hooks/preflight-rules.sh +8 -0
  171. package/.bkit/core/hooks/readguard-engine.js +29 -10
  172. package/.bkit/core/hooks/session-rules-advisory.js +61 -0
  173. package/.bkit/core/prompts/bkit-audit-generate.md +202 -94
  174. package/.bkit/core/prompts/bkit-build-challenge-1.md +76 -34
  175. package/.bkit/core/prompts/bkit-build-challenge-2.md +85 -38
  176. package/.bkit/core/prompts/bkit-build-install-skills.md +50 -28
  177. package/.bkit/core/prompts/bkit-build-plan-convert.md +85 -0
  178. package/.bkit/core/prompts/bkit-build-plan-current.md +59 -36
  179. package/.bkit/core/prompts/bkit-build-plan-gaps-remediate.md +101 -36
  180. package/.bkit/core/prompts/bkit-build-plan-tasks.md +149 -0
  181. package/.bkit/core/prompts/bkit-build-plan-tests.md +120 -0
  182. package/.bkit/core/prompts/bkit-build-plan-verify.md +104 -43
  183. package/.bkit/core/prompts/bkit-debug-abort-handover.md +47 -32
  184. package/.bkit/core/prompts/bkit-debug-failure-diagnose.md +109 -57
  185. package/.bkit/core/prompts/bkit-debug-failure-remediate.md +65 -39
  186. package/.bkit/core/prompts/bkit-debug-failure-reproduce.md +53 -31
  187. package/.bkit/core/prompts/bkit-debug-failure-soak.md +65 -34
  188. package/.bkit/core/prompts/bkit-design-brainstorm-ideate-1.md +46 -31
  189. package/.bkit/core/prompts/bkit-design-brainstorm-ideate-2.md +45 -31
  190. package/.bkit/core/prompts/bkit-design-brainstorm-ideate-3.md +43 -30
  191. package/.bkit/core/prompts/bkit-design-generate.md +80 -46
  192. package/.bkit/core/prompts/bkit-design-organise.md +83 -32
  193. package/.bkit/core/prompts/bkit-design-review-1.md +70 -50
  194. package/.bkit/core/prompts/bkit-design-review-2.md +65 -46
  195. package/.bkit/core/prompts/bkit-design-spike.md +64 -40
  196. package/.bkit/core/prompts/bkit-design-update.md +53 -28
  197. package/.bkit/core/prompts/bkit-plan-generate.md +101 -29
  198. package/.bkit/core/prompts/bkit-plan-review-1.md +78 -41
  199. package/.bkit/core/prompts/bkit-plan-review-2.md +78 -35
  200. package/.bkit/core/prompts/bkit-plan-scope-check.md +116 -0
  201. package/.bkit/core/prompts/bkit-plan-update.md +86 -31
  202. package/.bkit/core/prompts/bkit-ship-conflict-resolve.md +94 -50
  203. package/.bkit/core/prompts/bkit-ship-deferred-sweep.md +91 -41
  204. package/.bkit/core/prompts/bkit-ship-update-docs.md +45 -24
  205. package/.bkit/core/prompts/bkit-utility-compress-markdown.md +65 -49
  206. package/.bkit/core/prompts/bkit-utility-update-decisions.md +87 -42
  207. package/.bkit/core/prompts/bkit-utility-update-deferrals.md +81 -37
  208. package/.bkit/core/prompts/bkit-utility-update-documentation.md +43 -25
  209. package/.bkit/core/prompts/bkit-utility-update-failures.md +84 -37
  210. package/.bkit/core/prompts/bkit-utility-update-knowledge.md +88 -42
  211. package/.bkit/core/prompts/bkit-utility-update-roadmap.md +92 -39
  212. package/.bkit/core/prompts/bkit-utility-update-tracker.md +159 -60
  213. package/.bkit/core/workflows/bkit-auto.md +89 -58
  214. package/.bkit/core/workflows/bkit-build.md +967 -517
  215. package/.bkit/core/workflows/bkit-debug.md +555 -387
  216. package/.bkit/core/workflows/bkit-design.md +319 -283
  217. package/.bkit/core/workflows/bkit-plan.md +319 -342
  218. package/.bkit/core/workflows/bkit-ship.md +525 -328
  219. package/.bkit/shared/.agents/plugins/bkit/hooks.json +10 -0
  220. package/.bkit/shared/.bkit/.env.example +2 -2
  221. package/.bkit/shared/.claude/bkit-cloud.md +12 -10
  222. package/.bkit/shared/.claude/settings.json +14 -0
  223. package/.bkit/shared/.codex/bkit-cloud.md +98 -0
  224. package/.bkit/shared/.codex/hooks.json +20 -0
  225. package/.bkit/shared/.cursor/bkit-cloud.md +3 -3
  226. package/.bkit/shared/.cursor/mcp.json +1 -1
  227. package/.bkit/shared/.cursor/rules/bkit-rules.mdc +1 -1
  228. package/.bkit/shared/.gitattributes +1 -1
  229. package/.bkit/shared/.mcp.json +1 -1
  230. package/.bkit/shared/.opencode/opencode.json +12 -1
  231. package/.bkit/shared/CLAUDE.md +6 -2
  232. package/.bkit/shared/GEMINI.md +5 -2
  233. package/.bkit/shared/docs/architecture.md +4 -7
  234. package/.bkit/shared/docs/data-schema.md +4 -7
  235. package/.bkit/shared/docs/deployments.md +241 -168
  236. package/.bkit/shared/docs/design.md +11 -12
  237. package/.bkit/shared/docs/noise.md +8 -7
  238. package/.bkit/shared/docs/observability.md +5 -8
  239. package/.bkit/shared/docs/security.md +35 -17
  240. package/.bkit/shared/docs/setup.md +29 -18
  241. package/.bkit/shared/docs/technology.md +3 -6
  242. package/.bkit/shared/docs/testing.md +289 -174
  243. package/.bkit/shared/gitignore +6 -2
  244. package/.bkit/templates/.claude/hooks/bkit-cloud-bootstrap.sh +15 -16
  245. package/.bkit/templates/.cursor/Dockerfile +12 -8
  246. package/.bkit/templates/.cursor/environment.json +1 -1
  247. package/.bkit/templates/.github/ISSUE_TEMPLATE/bkit-bug.yml +10 -8
  248. package/.bkit/templates/.github/ISSUE_TEMPLATE/bkit-change.yml +45 -12
  249. package/.bkit/templates/.github/ISSUE_TEMPLATE/bkit-idea.yml +3 -3
  250. package/.bkit/templates/.github/renovate.json5 +34 -6
  251. package/.bkit/templates/.github/workflows/bkit-ci.yml +54 -51
  252. package/.bkit/templates/.github/workflows/bkit-cloud.yml +34 -33
  253. package/.bkit/templates/.github/workflows/bkit-health.yml +97 -0
  254. package/.bkit/templates/.github/workflows/bkit-renovate.yml +5 -4
  255. package/.bkit/templates/.github/workflows/bkit-trivy.yml +5 -4
  256. package/.bkit/templates/.husky/pre-commit +2 -2
  257. package/.bkit/templates/.husky/pre-push +96 -36
  258. package/.bkit/templates/.prettierignore +6 -0
  259. package/.bkit/templates/.vale.ini +27 -27
  260. package/.bkit/templates/context/bkit-cloudrun.md +23 -15
  261. package/.bkit/templates/context/bkit-expo.md +70 -52
  262. package/.bkit/templates/context/bkit-github.md +93 -56
  263. package/.bkit/templates/context/bkit-inngest.md +21 -15
  264. package/.bkit/templates/context/bkit-maestro.md +22 -16
  265. package/.bkit/templates/context/bkit-playwright.md +23 -17
  266. package/.bkit/templates/context/bkit-resend.md +12 -10
  267. package/.bkit/templates/context/bkit-sentry.md +30 -20
  268. package/.bkit/templates/context/bkit-serena.md +8 -7
  269. package/.bkit/templates/context/bkit-stripe.md +14 -13
  270. package/.bkit/templates/context/bkit-supabase.md +16 -13
  271. package/.bkit/templates/context/bkit-tavily.md +14 -11
  272. package/.bkit/templates/context/bkit-vercel.md +27 -18
  273. package/.bkit/templates/docs/capabilities.md +15 -14
  274. package/.bkit/templates/scripts/ci/{check-accepted-divergences.mjs → bkit-check-accepted-divergences.mjs} +6 -3
  275. package/.bkit/templates/scripts/ci/{check-accepted-divergences.test.mjs → bkit-check-accepted-divergences.test.mjs} +3 -3
  276. package/.bkit/templates/scripts/ci/{check-capstone.mjs → bkit-check-capstone.mjs} +2 -2
  277. package/.bkit/templates/scripts/ci/{check-capstone.test.mjs → bkit-check-capstone.test.mjs} +4 -4
  278. package/.bkit/templates/scripts/ci/{check-dependency-audit.mjs → bkit-check-dependency-audit.mjs} +103 -18
  279. package/.bkit/templates/scripts/ci/{check-dependency-audit.test.mjs → bkit-check-dependency-audit.test.mjs} +31 -3
  280. package/.bkit/templates/scripts/ci/bkit-machine-lock.sh +387 -0
  281. package/.bkit/templates/scripts/ci/bkit-test-awake.mjs +75 -0
  282. package/.bkit/templates/scripts/ci/bkit-test-awake.test.mjs +160 -0
  283. package/.bkit/templates/scripts/ci/lanes/{resolve-push-base.mjs → bkit-resolve-push-base.mjs} +3 -3
  284. package/.bkit/templates/scripts/ci/lanes/{resolve-push-base.test.mjs → bkit-resolve-push-base.test.mjs} +4 -4
  285. package/.bkit/templates/scripts/cleanup/bkit-disk-prune.mjs +10 -2
  286. package/.bkit/templates/scripts/graphify/bkit-graph-drift.py +1 -1
  287. package/.bkit/templates/scripts/graphify/bkit-graph-eager.py +3 -3
  288. package/.bkit/templates/scripts/graphify/bkit-graph-embed.py +63 -0
  289. package/.bkit/templates/scripts/graphify/bkit-graph-imports.py +2 -2
  290. package/.bkit/templates/scripts/graphify/bkit-graph-pre-push.sh +69 -18
  291. package/.bkit/templates/scripts/graphify/bkit-graph-repair.py +3 -3
  292. package/.bkit/templates/scripts/graphify/bkit-graph-surface.py +1 -1
  293. package/.bkit/templates/scripts/graphify/bkit-graphify-graphml.py +1 -1
  294. package/.bkit/templates/scripts/graphify/bkit-graphify-rollup.py +197 -126
  295. package/.bkit/templates/scripts/graphify/bkit-graphify.sh +64 -41
  296. package/.bkit/templates/scripts/slop/bkit-slop-type-suppression.mjs +23 -7
  297. package/.bkit/templates/slop-scan.config.json +9 -2
  298. package/CHANGELOG.md +231 -0
  299. package/README.md +278 -89
  300. package/dist/checks/after/auth.js +36 -33
  301. package/dist/checks/after/ci-yml.js +91 -30
  302. package/dist/checks/after/github.js +91 -17
  303. package/dist/checks/after/index.js +22 -11
  304. package/dist/checks/after/suppression.js +8 -5
  305. package/dist/checks/after/tools.js +111 -114
  306. package/dist/checks/before/context-fetch.js +218 -33
  307. package/dist/checks/before/env.js +3 -3
  308. package/dist/checks/before/files.js +5 -3
  309. package/dist/checks/before/index.js +20 -3
  310. package/dist/checks/before/repo.js +197 -2
  311. package/dist/checks/status-holes.js +739 -114
  312. package/dist/checks/tips/catalogue.js +70 -19
  313. package/dist/checks/tips/detect.js +62 -0
  314. package/dist/checks/tips/index.js +51 -9
  315. package/dist/cli.js +234 -124
  316. package/dist/commands/analysis.js +174 -141
  317. package/dist/commands/ci/ci.js +302 -25
  318. package/dist/commands/ci/pins.js +142 -0
  319. package/dist/commands/ci/push-gate.js +194 -0
  320. package/dist/commands/comply.js +54 -91
  321. package/dist/commands/install/doctor.js +2 -2
  322. package/dist/commands/install/install.js +50 -19
  323. package/dist/commands/install/uninstall.js +82 -55
  324. package/dist/commands/install/upgrade.js +21 -11
  325. package/dist/commands/land.js +137 -17
  326. package/dist/commands/lib.js +295 -21
  327. package/dist/commands/registry.js +10 -2
  328. package/dist/commands/setup/setup.js +8 -7
  329. package/dist/commands/stats.js +175 -0
  330. package/dist/commands/tips.js +7 -3
  331. package/dist/commands/workflow/branches.js +1873 -152
  332. package/dist/commands/workflow/challenge.js +609 -0
  333. package/dist/commands/workflow/completeness.js +97 -0
  334. package/dist/commands/workflow/context.js +1045 -46
  335. package/dist/commands/workflow/counters.js +385 -86
  336. package/dist/commands/workflow/decisions.js +484 -0
  337. package/dist/commands/workflow/disk.js +214 -56
  338. package/dist/commands/workflow/fids.js +706 -33
  339. package/dist/commands/workflow/issues.js +349 -59
  340. package/dist/commands/workflow/ledgers.js +1123 -37
  341. package/dist/commands/workflow/locks.js +26 -2
  342. package/dist/commands/workflow/plan-blocks.js +501 -0
  343. package/dist/commands/workflow/plan-versions.js +22 -0
  344. package/dist/commands/workflow/plans.js +205 -0
  345. package/dist/commands/workflow/prs.js +154 -35
  346. package/dist/commands/workflow/repo.js +58 -8
  347. package/dist/commands/workflow/roadmap.js +58 -23
  348. package/dist/commands/workflow/run-facts.js +421 -0
  349. package/dist/commands/workflow/runs.js +670 -72
  350. package/dist/commands/workflow/runtime.js +15 -1
  351. package/dist/commands/workflow/skills.js +1 -0
  352. package/dist/commands/workflow/status.js +282 -34
  353. package/dist/commands/workflow/step-table.js +308 -0
  354. package/dist/commands/workflow/steps.js +703 -96
  355. package/dist/commands/workflow/summary-findings.js +117 -0
  356. package/dist/commands/workflow/summary.js +388 -0
  357. package/dist/commands/workflow/tasks.js +378 -0
  358. package/dist/commands/workflow/test-blocks.js +231 -0
  359. package/dist/commands/workflow/tests-changed.js +172 -0
  360. package/dist/commands/workflow/tests.js +1695 -305
  361. package/dist/commands/workflow/tracker.js +983 -0
  362. package/dist/commands/workflow/workflows.js +1014 -222
  363. package/dist/commands/workflow/worktrees.js +432 -26
  364. package/dist/install/cloud-env.js +233 -99
  365. package/dist/install/context-ci-workflow.js +85 -0
  366. package/dist/install/manifest.js +64 -17
  367. package/dist/install/modules/antigravity.js +3 -2
  368. package/dist/install/modules/cloud.js +25 -16
  369. package/dist/install/modules/codex.js +12 -2
  370. package/dist/install/modules/core.js +1090 -48
  371. package/dist/install/modules/cursor.js +6 -6
  372. package/dist/install/modules/opencode.js +13 -7
  373. package/dist/install/template-notes.js +116 -0
  374. package/dist/install/version-file.js +9 -4
  375. package/dist/ledgers/compact.js +87 -0
  376. package/dist/ledgers/journal.js +233 -0
  377. package/dist/ledgers/migrate.js +81 -0
  378. package/dist/ledgers/status.js +176 -13
  379. package/dist/ledgers/telemetry.js +1010 -125
  380. package/dist/render/hosts.js +104 -14
  381. package/dist/render/models.js +12 -0
  382. package/dist/shared/bkit-latest.js +26 -4
  383. package/dist/shared/branches.js +3 -1
  384. package/dist/shared/dep-updater.js +49 -0
  385. package/dist/shared/egress.js +8 -1
  386. package/dist/shared/json.js +20 -7
  387. package/dist/shared/package-manager.js +6 -0
  388. package/dist/shared/settings.js +181 -24
  389. package/dist/shared/text.js +333 -0
  390. package/dist/shared/timeouts.js +2 -0
  391. package/dist/tools/cli-doc.js +97 -0
  392. package/dist/tools/grammar-density.js +183 -0
  393. package/dist/tools/instructions-sources.js +720 -0
  394. package/dist/tools/instructions.js +1623 -0
  395. package/package.json +156 -51
  396. package/.bkit/core/.bkit/lite.md +0 -73
  397. package/.bkit/core/engine/commands/harvest.ts +0 -459
  398. package/.bkit/core/engine/commands/workflow/workstreams.ts +0 -166
  399. package/.bkit/core/engine/tools/wording.ts +0 -748
  400. package/.bkit/core/prompts/bkit-build-challenge-reconcile.md +0 -69
  401. package/.bkit/core/prompts/bkit-build-challenge-remediate.md +0 -71
  402. package/.bkit/core/prompts/bkit-build-challenge-tests.md +0 -74
  403. package/.bkit/core/prompts/bkit-build-plan-execute.md +0 -76
  404. package/.bkit/core/prompts/bkit-build-summary.md +0 -94
  405. package/.bkit/core/prompts/bkit-debug-summary.md +0 -96
  406. package/.bkit/core/prompts/bkit-design-summary.md +0 -107
  407. package/.bkit/core/prompts/bkit-plan-complexity-check.md +0 -67
  408. package/.bkit/core/prompts/bkit-plan-complexity-split.md +0 -88
  409. package/.bkit/core/prompts/bkit-plan-review-3.md +0 -93
  410. package/.bkit/core/prompts/bkit-plan-scope-check-1.md +0 -85
  411. package/.bkit/core/prompts/bkit-plan-scope-check-2.md +0 -85
  412. package/.bkit/core/prompts/bkit-plan-summary.md +0 -107
  413. package/.bkit/core/prompts/bkit-ship-summary.md +0 -78
  414. package/.bkit/templates/scripts/ci/bkit-local-stack-lock.sh +0 -194
  415. package/dist/commands/harvest.js +0 -353
  416. package/dist/commands/workflow/workstreams.js +0 -143
  417. package/dist/tools/wording.js +0 -680
  418. /package/.bkit/templates/.vale/styles/{House → Bkit}/Filler.yml +0 -0
  419. /package/.bkit/templates/.vale/styles/{House → Bkit}/Hedging.yml +0 -0
  420. /package/.bkit/templates/.vale/styles/{House → Bkit}/LLMSlop.yml +0 -0
  421. /package/.bkit/templates/.vale/styles/{House → Bkit}/Verbose.yml +0 -0
  422. /package/.bkit/templates/scripts/ci/{accepted-advisories.json → bkit-accepted-advisories.json} +0 -0
  423. /package/.bkit/templates/scripts/ci/{accepted-divergences.json → bkit-accepted-divergences.json} +0 -0
  424. /package/.bkit/templates/scripts/launchd/{launchd.env.example → bkit-launchd.env.example} +0 -0
  425. /package/.bkit/templates/scripts/launchd/{ai.bkit.launchd.plist → bkit-launchd.plist} +0 -0
@@ -25,7 +25,7 @@ export const OPTIN_MODULES = new Set(["cloud", "opencode", "codex", "antigravity
25
25
  * `render/trackers.ts`.
26
26
  */
27
27
  export const ISSUE_TRACKERS = ["github", "linear", "jira", "none"];
28
- /** Default tracker when consumer manifest has no `bkit.issueTracker` field. */
28
+ /** Default tracker when consumer manifest has no `bkit.tracker.default` field. */
29
29
  export const DEFAULT_ISSUE_TRACKER = "none";
30
30
  /**
31
31
  * Narrow an unknown string to `IssueTracker` or return `null` if invalid.
@@ -51,15 +51,15 @@ export function parseIssueTracker(value) {
51
51
  * presence). Requires `tracker=github` + local opencode host (`bkit install --opencode=<provider>`).
52
52
  * - `none` — explicit opt-out; silences the post-install nudge advisory.
53
53
  *
54
- * Recorded in `package.json` `bkit.cloudAgents`. Presence of the adopted copy
54
+ * Recorded in `package.json` `bkit.cloud.agent`. Presence of the adopted copy
55
55
  * (`bkit-cloud.yml` for github-host variants; `.cursor/Dockerfile` for cursor) is the authoritative
56
56
  * "active" signal; the package.json field only distinguishes an opt-out from
57
57
  * an undecided install.
58
58
  *
59
- * Single self-describing field (mirrors `bkit.issueTracker`).
59
+ * Single self-describing field (mirrors `bkit.tracker.default`).
60
60
  */
61
61
  export const CLOUD_MODES = ["claude", "cursor", "opencode", "none"];
62
- /** Default when consumer manifest has no `bkit.cloudAgents` field (undecided). */
62
+ /** Default when consumer manifest has no `bkit.cloud.agent` field (undecided). */
63
63
  export const DEFAULT_CLOUD_AGENTS = "none";
64
64
  /** Narrow an unknown string to `CloudAgents` or return `null` if invalid. */
65
65
  export function parseCloudAgents(value) {
@@ -89,18 +89,20 @@ const CORE_MANIFEST = [
89
89
  // `.bkit/core/.bkit/` and are read from there at runtime (getBkitDocsRoot); these
90
90
  // consumer copies are force-overwritten mirrors (writeTier1) so a consumer can read
91
91
  // them in-repo. Whole file is bkit-owned → byte-equal-text (refreshed every install);
92
- // prompts.md and lite.md are markered-text, keeping the consumer section below `bkit:end`.
92
+ // prompts.md is markered-text, keeping the consumer section below `bkit:end`.
93
+ { path: ".bkit/authoring.md", format: "byte-equal-text", module: "core" },
93
94
  { path: ".bkit/cloud.md", format: "byte-equal-text", module: "core" },
95
+ { path: ".bkit/cli.md", format: "byte-equal-text", module: "core" },
94
96
  { path: ".bkit/comparison.md", format: "byte-equal-text", module: "core" },
95
97
  { path: ".bkit/install.md", format: "byte-equal-text", module: "core" },
96
98
  { path: ".bkit/jsonl.md", format: "byte-equal-text", module: "core" },
97
99
  // The MIT notice that travels with the files bkit writes: the full text and copyright
98
100
  // notice. Sourced from `.bkit/core/.bkit/LICENSE.md`.
99
101
  { path: ".bkit/LICENSE.md", format: "byte-equal-text", module: "core" },
100
- { path: ".bkit/lite.md", format: "markered-text", module: "core" },
101
102
  { path: ".bkit/pipeline.md", format: "byte-equal-text", module: "core" },
102
103
  { path: ".bkit/providers.md", format: "byte-equal-text", module: "core" },
103
104
  { path: ".bkit/prompts.md", format: "markered-text", module: "core" },
105
+ { path: ".bkit/router.md", format: "byte-equal-text", module: "core" },
104
106
  { path: ".bkit/templates.md", format: "byte-equal-text", module: "core" },
105
107
  { path: ".bkit/trackers.md", format: "byte-equal-text", module: "core" },
106
108
  { path: ".bkit/workflows.md", format: "byte-equal-text", module: "core" },
@@ -158,7 +160,7 @@ const CLAUDE_MANIFEST = [
158
160
  // (bkit-tests-static / -unit / -integration / -e2e / -live). Where a step is not a
159
161
  // tier (`format`, the ship gate) the name spells out the actual steps. One exception:
160
162
  // `min` sits off the chain: the least a push runs, on a push that changes no code
161
- // (`bkit.minPushPaths`); its steps are whatever that push can still break.
163
+ // (what bkit writes, plus `bkit.testing.minPushPaths`); its steps are whatever that push can still break.
162
164
  //
163
165
  // The consumer owns every value: a turbo monorepo writes `turbo run … --filter`,
164
166
  // a Python repo writes `ruff check && pytest`. bkit never reads a value — only
@@ -167,7 +169,7 @@ const CLAUDE_MANIFEST = [
167
169
  // Seeded by core on every install and upgrade (seedCorePackageJsonScripts,
168
170
  // install/modules/index.ts): add-if-missing, so a name already present is never touched,
169
171
  // and uninstall leaves every name in place. The tool scripts the defaults chain
170
- // (typecheck, lint, format:check, lint:prose, slop:delta, lint-staged) are the
172
+ // (typecheck, lint, format:check, bkit:lint:prose, bkit:slop:delta, lint-staged) are the
171
173
  // consumer's to add — `.bkit/templates.md` lists them; the
172
174
  // `gate-missing-called-scripts` advisory names any that are missing.
173
175
  //
@@ -176,7 +178,7 @@ const CLAUDE_MANIFEST = [
176
178
  // directly, one step each.
177
179
  //
178
180
  // `lint:slop` is in no gate: `slop-scan scan` is report-only and never fails. The gate
179
- // that fails on new findings is `slop:delta`.
181
+ // that fails on new findings is `bkit:slop:delta`.
180
182
  //
181
183
  // NOT SEEDED: the three deeper gates (…-integration, …-integration-e2e,
182
184
  // …-integration-e2e-live) are absent unless the consumer writes them. Each is one line
@@ -188,16 +190,16 @@ export const BKIT_GATE_SCRIPTS = {
188
190
  // `.husky/pre-commit`: prettier --write over staged files, and nothing else —
189
191
  // seconds, not minutes. Prose is a whole-repo scan, so it gates at pre-push.
190
192
  "bkit:gate:format": "pnpm lint-staged",
191
- // `.husky/pre-push` on a min push (every file matches `bkit.minPushPaths`): no code, so
193
+ // `.husky/pre-push` on a min push (every file is one bkit writes or `bkit.testing.minPushPaths` adds): no code, so
192
194
  // no typecheck, lint or tests. Off the chain. Add any test that reads a min-push file.
193
- "bkit:gate:min": "pnpm format:check && pnpm lint:prose && pnpm slop:delta",
195
+ "bkit:gate:min": "pnpm format:check && pnpm bkit:lint:prose && pnpm bkit:slop:delta",
194
196
  // Everything that needs no test runner. Every part has a matching step in the
195
197
  // bkit-tests-static CI job; audits/templates/template-ci-yml.test.ts fails when one is missing.
196
198
  // Callers: build's plan-execute loop between tasks, and the `.husky/pre-push` revert
197
199
  // path.
198
- "bkit:gate:static": "pnpm typecheck && pnpm lint && pnpm format:check && pnpm lint:prose && pnpm slop:delta",
200
+ "bkit:gate:static": "pnpm typecheck && pnpm lint && pnpm format:check && pnpm bkit:lint:prose && pnpm bkit:slop:delta",
199
201
  // The default local gate: `.husky/pre-push` (when no `…-integration` gate is declared),
200
- // build Step 14, the remediates. `pnpm test` is the unit tier only: a test file the
202
+ // build Steps 8 and 12, the remediates. `pnpm test` is the unit tier only: a test file the
201
203
  // integration gate also runs must not match it.
202
204
  "bkit:gate:static-unit": "pnpm bkit:gate:static && pnpm test",
203
205
  // Ship's conflict-resolve, the only caller whose dependency graph may have just
@@ -224,20 +226,27 @@ export const BKIT_GATE_SCRIPTS = {
224
226
  export const BKIT_DEBUG_GATES = [
225
227
  "bkit:gate:static-unit-integration-e2e-live",
226
228
  "bkit:gate:static-unit-integration-e2e",
229
+ "bkit:gate:static-unit-integration",
227
230
  "bkit:gate:static-unit",
228
231
  ];
229
232
  /**
230
- * What `/bkit-build` Step 14 will run, in DESCENDING order — first one declared wins.
233
+ * What `/bkit-build` Step 12 will run, in DESCENDING order — first one declared wins.
234
+ * The Step 8 group gate runs `BKIT_GROUP_GATES` instead.
231
235
  *
232
236
  * Build stops at integration; E2E and live are not in this list.
233
237
  *
234
- * Neither entry is seeded: declaring `bkit:gate:static-unit-integration` opts the build
235
- * loop and the pre-push hook into the integration tier.
238
+ * Declaring `bkit:gate:static-unit-integration` (never seeded) opts Step 12 and the
239
+ * pre-push hook into the integration tier.
236
240
  */
237
241
  export const BKIT_BUILD_GATES = [
238
242
  "bkit:gate:static-unit-integration",
239
243
  "bkit:gate:static-unit",
240
244
  ];
245
+ /**
246
+ * What `/bkit-build` Step 8 runs after every group but the last, and hands the Step 9 fix
247
+ * round: static checks and the unit tier. Integration runs once, at Step 12.
248
+ */
249
+ export const BKIT_GROUP_GATES = ["bkit:gate:static-unit"];
241
250
  /**
242
251
  * What `.husky/pre-push` runs on a full push, in DESCENDING order — first one declared wins.
243
252
  *
@@ -255,6 +264,21 @@ export const BKIT_PUSH_GATES = [
255
264
  * upgrade advise when it is missing (detectGateAdvisories).
256
265
  */
257
266
  export const BKIT_TEST_FILE_SCRIPT = "bkit:test:file";
267
+ /**
268
+ * Lints ONE test file — `pnpm bkit:lint:file <repo-relative path>`, exit 0 when clean.
269
+ * `bkit tests red` runs it before recording a red, so a lint rewrite never lands after
270
+ * the red. Never seeded: install, check and upgrade advise when `bkit:test:file` is
271
+ * declared and this is not (detectGateAdvisories).
272
+ */
273
+ export const BKIT_LINT_FILE_SCRIPT = "bkit:lint:file";
274
+ /**
275
+ * Checks only what changed — `pnpm bkit:gate:changed <repo-relative path>...`, exit 0
276
+ * when clean: the tests that import the files, the tests that name their paths, and
277
+ * static checks on the files. `bkit tests changed` passes the files and falls back to a
278
+ * whole gate when this is undeclared. Never seeded: install, check and upgrade advise
279
+ * when it is missing (detectGateAdvisories).
280
+ */
281
+ export const BKIT_GATE_CHANGED_SCRIPT = "bkit:gate:changed";
258
282
  /**
259
283
  * The deeper gates, shallowest first, with what declaring each one costs.
260
284
  *
@@ -347,6 +371,13 @@ export const OPENCODE_MANIFEST = [
347
371
  format: "markered-text",
348
372
  module: "opencode",
349
373
  },
374
+ // bkit-rules.js — same split as bkit-gateguard.js. Delivers the rules-read advisory
375
+ // on the session's first tool call (opencode has no session-start event).
376
+ {
377
+ path: ".opencode/plugin/bkit-rules.js",
378
+ format: "markered-text",
379
+ module: "opencode",
380
+ },
350
381
  // Agent and command mirrors are managed dynamically (not listed individually here —
351
382
  // the exact set depends on the bkit-prefix prompt/workflow files at install time).
352
383
  // Uninstall uses the BKIT_PREFIX filter for .opencode/agents/ and .opencode/commands/.
@@ -383,6 +414,14 @@ export const CODEX_MANIFEST = [
383
414
  format: "markered-text",
384
415
  module: "codex",
385
416
  },
417
+ // bkit-rules.cjs — Tier-2 markered-text. Delivers the rules-read advisory once per
418
+ // session as `additionalContext` on the first tool call (Codex has no session-start
419
+ // event). Registered on two single-value matchers, `apply_patch` and `Bash`.
420
+ {
421
+ path: ".codex/hooks/bkit-rules.cjs",
422
+ format: "markered-text",
423
+ module: "codex",
424
+ },
386
425
  // Agent mirrors (.codex/agents/*.toml) and workflow skills (.agents/skills/bkit-*/) are
387
426
  // managed dynamically — the set follows the bkit-prefix prompt/workflow files at install.
388
427
  ];
@@ -419,6 +458,14 @@ export const ANTIGRAVITY_MANIFEST = [
419
458
  format: "markered-text",
420
459
  module: "antigravity",
421
460
  },
461
+ // bkit-rules.cjs — Tier-2 markered-text. Delivers the rules-read advisory once per
462
+ // session by denying the first tool call with the advisory as the reason (Antigravity's
463
+ // only channel to the model); the identical retry is allowed.
464
+ {
465
+ path: ".agents/plugins/bkit/hooks/bkit-rules.cjs",
466
+ format: "markered-text",
467
+ module: "antigravity",
468
+ },
422
469
  // Root GEMINI.md — Antigravity workspace-rule redirect to .agents/rules.md, owned by the
423
470
  // antigravity module: `uninstall --antigravity` removes it; other installs leave it.
424
471
  { path: "GEMINI.md", format: "markered-text", module: "antigravity" },
@@ -431,7 +478,7 @@ export const ANTIGRAVITY_MANIFEST = [
431
478
  // (bkit-cloud.yml), bkit-cloud-bootstrap.sh and the Cursor Background Agent files
432
479
  // (.cursor/Dockerfile, .cursor/environment.json) ship as templates
433
480
  // (`.bkit/templates.md`); the consumer copies and owns them. Each variant only
434
- // records `bkit.cloudAgents` and prints its setup advisories.
481
+ // records `bkit.cloud.agent` and prints its setup advisories.
435
482
  export const CLOUD_MANIFEST_CLAUDE = [];
436
483
  export const CLOUD_MANIFEST_OPENCODE = [];
437
484
  export const CLOUD_MANIFEST_CURSOR = [];
@@ -161,8 +161,9 @@ export function runAntigravityModule(ctx) {
161
161
  console.log(`${logPrefix} ${tag}antigravity: ${jsonDst}`);
162
162
  }
163
163
  }
164
- // --- bkit-gateguard.cjs / bkit-readguard.cjs — Tier-2 markered-text, twins of the Claude/Codex hooks ---
165
- for (const hook of ["bkit-gateguard.cjs", "bkit-readguard.cjs"]) {
164
+ // --- bkit-gateguard.cjs / bkit-readguard.cjs / bkit-rules.cjs — Tier-2 markered-text,
165
+ // twins of the Claude/Codex hooks ---
166
+ for (const hook of ["bkit-gateguard.cjs", "bkit-readguard.cjs", "bkit-rules.cjs"]) {
166
167
  const hookSrc = path.join(pluginHooksSrc, hook);
167
168
  const hookDst = path.join(ANTIGRAVITY_HOOKS_DIR, hook);
168
169
  if (fs.existsSync(hookSrc)) {
@@ -10,11 +10,12 @@ import { parseJson } from "../../shared/json.js";
10
10
  // ---------------------------------------------------------------------------
11
11
  /**
12
12
  * Persist a `bkit.<field>` value into the consumer's package.json so the
13
- * post-install advisory can tell "deliberately none" from "undecided". Mirrors
14
- * the `bkit.issueTracker` persist logic in commands/install/install.ts. Used for the opt-in
15
- * decisions recorded by their owning modules (`cloudAgents`). No-op
16
- * on dry-run or when package.json is absent/unparseable (non-fatal — the config
17
- * file presence is still the primary signal).
13
+ * post-install advisory can tell "deliberately none" from "undecided". `field` is a
14
+ * dotted path (`cloud.agent`); each missing section on the way is created. Mirrors
15
+ * the `bkit.tracker.default` persist logic in commands/install/install.ts. Used for the opt-in
16
+ * decisions recorded by their owning modules (`cloud.agent`). No-op
17
+ * on dry-run, when package.json is absent/unparseable, or when a section on the path
18
+ * holds a non-object (non-fatal — the config file presence is still the primary signal).
18
19
  */
19
20
  function setConsumerBkitField(field, value, dryRun) {
20
21
  if (dryRun)
@@ -28,11 +29,19 @@ function setConsumerBkitField(field, value, dryRun) {
28
29
  if (!parsed.ok)
29
30
  return;
30
31
  const pkg = parsed.value;
31
- const bkit = (pkg.bkit ?? {});
32
- if (bkit[field] === value)
32
+ const keys = ["bkit", ...field.split(".")];
33
+ const leaf = keys.pop();
34
+ let parent = pkg;
35
+ for (const k of keys) {
36
+ parent[k] ??= {};
37
+ const next = parent[k];
38
+ if (next === null || typeof next !== "object" || Array.isArray(next))
39
+ return;
40
+ parent = next;
41
+ }
42
+ if (parent[leaf] === value)
33
43
  return; // already set — avoid a no-op rewrite
34
- bkit[field] = value;
35
- pkg.bkit = bkit;
44
+ parent[leaf] = value;
36
45
  const indentMatch = raw.match(/\n([ \t]+)"/);
37
46
  const indent = indentMatch ? indentMatch[1] : " ";
38
47
  const trailingNewline = raw.endsWith("\n") ? "\n" : "";
@@ -44,14 +53,14 @@ function setConsumerBkitField(field, value, dryRun) {
44
53
  }
45
54
  // The cloud workflow is a template (`.bkit/templates.md`). Shared first step of the
46
55
  // claude and opencode setup advisories.
47
- const CLOUD_WORKFLOW_ADOPT_STEP = " - 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";
56
+ const CLOUD_WORKFLOW_ADOPT_STEP = " - 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";
48
57
  // ---------------------------------------------------------------------------
49
58
  // runCloudModule — opt-in cloud-agent integration
50
59
  // ---------------------------------------------------------------------------
51
60
  //
52
61
  // NOT shipped by a default install — opt-in via `bkit install --auto=<variant>`,
53
62
  // so a default install ships ZERO cloud footprint. Every variant records
54
- // `bkit.cloudAgents` and prints its setup advisories; none writes a file. The cloud
63
+ // `bkit.cloud.agent` and prints its setup advisories; none writes a file. The cloud
55
64
  // workflow (bkit-cloud.yml), bkit-cloud-bootstrap.sh and the Cursor Background Agent
56
65
  // files (.cursor/Dockerfile, .cursor/environment.json) are templates the advisories
57
66
  // point at.
@@ -66,7 +75,7 @@ export function runCloudModule(ctx) {
66
75
  if (variant === "claude") {
67
76
  // --- cloud=claude: GitHub-tracker path ---
68
77
  // Record the variant so the post-install advisory and `bkit check` stay consistent.
69
- setConsumerBkitField("cloudAgents", "claude", dryRun);
78
+ setConsumerBkitField("cloud.agent", "claude", dryRun);
70
79
  // Advisory — cloud=claude setup checklist (App required; id-token: write).
71
80
  advisories.push({
72
81
  id: "bkit-cloud-setup",
@@ -90,7 +99,7 @@ export function runCloudModule(ctx) {
90
99
  severity: "advisory",
91
100
  detect: "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).",
92
101
  action: "Two locations to touch — full recipe in bkit's `cloud.md`.\n\n" +
93
- "IN REPO (copy-and-own; bkit never writes it):\n" +
102
+ "IN REPO (copy-and-own; bkit never writes it, apart from brand migrations that rewrite exact shipped old names):\n" +
94
103
  " - 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" +
95
104
  "IN CLAUDE APP (claude.ai/code → environment selector → + Add environment):\n" +
96
105
  " - Name: the repo name (e.g. `acme-web`) — one environment per repo, since secrets are per-repo.\n" +
@@ -103,7 +112,7 @@ export function runCloudModule(ctx) {
103
112
  else if (variant === "opencode") {
104
113
  // --- cloud=opencode: GitHub-tracker path (same bkit-cloud.yml template, no OIDC) ---
105
114
  // Record the variant.
106
- setConsumerBkitField("cloudAgents", "opencode", dryRun);
115
+ setConsumerBkitField("cloud.agent", "opencode", dryRun);
107
116
  // Advisory — cloud=opencode setup checklist.
108
117
  advisories.push({
109
118
  id: "bkit-cloud-setup",
@@ -123,7 +132,7 @@ export function runCloudModule(ctx) {
123
132
  else {
124
133
  // --- cloud=cursor: Linear-tracker path ---
125
134
  // Record the variant.
126
- setConsumerBkitField("cloudAgents", "cursor", dryRun);
135
+ setConsumerBkitField("cloud.agent", "cursor", dryRun);
127
136
  // Advisory — cloud=cursor setup checklist.
128
137
  advisories.push({
129
138
  id: "bkit-cloud-setup",
@@ -137,7 +146,7 @@ export function runCloudModule(ctx) {
137
146
  " - Allowed concurrency: latest-supersedes.\n" +
138
147
  " - 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" +
139
148
  " - Label the issue `bkit:auto` in Linear before pushing the build commit.\n\n" +
140
- "IN REPO (copy each template and own it; bkit never writes or overwrites these files — see `.bkit/templates.md`):\n" +
149
+ "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" +
141
150
  " - `.bkit/templates/.cursor/Dockerfile` → `.cursor/Dockerfile`: change Node major if `engines.node` differs from 20; add Playwright / Supabase CLI / extra apt deps.\n" +
142
151
  " - `.bkit/templates/.cursor/environment.json` → `.cursor/environment.json`: set `install` / `start` / `terminals[]` / `env` for your stack.",
143
152
  });
@@ -8,6 +8,7 @@ import { getCoreRoot, getSharedRoot, getWorkflowsRoot, getPromptsRoot, } from ".
8
8
  import { DEFAULT_ISSUE_TRACKER } from "../manifest.js";
9
9
  import { substituteWorkflow } from "../../render/trackers.js";
10
10
  import { readInstallingVersion } from "../../shared/package-json.js";
11
+ import { writeCodexCloudDoc } from "../cloud-env.js";
11
12
  import { BKIT_PREFIX, installFile, listMdFiles, removeOrphans, trackMirrorWrite } from "./core.js";
12
13
  /**
13
14
  * Convert a workflow orchestrator (`.bkit/core/workflows/*.md`) into a Codex SKILL.md.
@@ -141,8 +142,9 @@ export function runCodexModule(ctx) {
141
142
  console.log(`${logPrefix} ${tag}codex: ${jsonDst}`);
142
143
  }
143
144
  }
144
- // --- bkit-gateguard.cjs / bkit-readguard.cjs — Tier-2 markered-text, twins of the Claude hooks ---
145
- for (const hook of ["bkit-gateguard.cjs", "bkit-readguard.cjs"]) {
145
+ // --- bkit-gateguard.cjs / bkit-readguard.cjs / bkit-rules.cjs — Tier-2 markered-text,
146
+ // twins of the Claude hooks ---
147
+ for (const hook of ["bkit-gateguard.cjs", "bkit-readguard.cjs", "bkit-rules.cjs"]) {
146
148
  const hookSrc = path.join(codexHooks, hook);
147
149
  const hookDst = `.codex/hooks/${hook}`;
148
150
  if (fs.existsSync(hookSrc)) {
@@ -170,6 +172,14 @@ export function runCodexModule(ctx) {
170
172
  console.log(`${logPrefix} ${tag}codex: ${railDst}`);
171
173
  }
172
174
  }
175
+ // Generated copy-paste-ready Codex Cloud setup doc — `.codex/bkit-cloud.md`. Twin of
176
+ // `.claude/bkit-cloud.md` (runClaudeModule): UNTRACKED + gitignored, inlines REAL secret
177
+ // values resolved from `.envrc`, never enters ws.writes / canonicalHashes / `bkit check`
178
+ // drift. Skipped on dry-run (`bkit check`), which never writes secrets. Upgrade
179
+ // regenerates it via the same helper (see runUpgrade caller).
180
+ if (!dryRun && writeCodexCloudDoc(process.cwd(), ctx.tokens)) {
181
+ console.log(`${logPrefix} ${tag}codex: .codex/bkit-cloud.md (generated — gitignored, holds resolved secrets)`);
182
+ }
173
183
  advisories.push({
174
184
  id: "codex-setup",
175
185
  severity: "advisory",