@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
@@ -180,7 +180,7 @@ export async function runDoctor(
180
180
  id: "opencode-provider-missing",
181
181
  severity: "blocker",
182
182
  detect:
183
- "`.opencode/` is present but no provider is recorded — neither package.json `bkit.opencodeProvider` nor an `opencode.json` provider block.",
183
+ "`.opencode/` is present but no provider is recorded — neither package.json `bkit.providers.opencode.default` nor an `opencode.json` provider block.",
184
184
  action: `Re-run \`bkit install --opencode=<provider>\` (${OPENCODE_PROVIDERS.join(", ")}). Until then \`bkit check\` and \`bkit upgrade\` exit 1 rather than render every agent pin against a substitute provider.`,
185
185
  });
186
186
  }
@@ -222,7 +222,7 @@ export async function runDoctor(
222
222
  let detectedProvider: string | null = detectOpencodeProvider(process.cwd());
223
223
  if (opencodeProvider) detectedProvider = opencodeProvider;
224
224
 
225
- // Multi-provider: all installed providers. bkit.opencodeProviders when populated,
225
+ // Multi-provider: all installed providers. bkit.providers.opencode.installed when populated,
226
226
  // else the single detected provider.
227
227
  const allProviders = detectOpencodeProviders(process.cwd());
228
228
  const activeProvider = detectedProvider ?? allProviders[0] ?? null;
@@ -32,11 +32,17 @@ import {
32
32
  type EffortMap,
33
33
  parseModelLookup,
34
34
  applyModelOverrides,
35
+ unknownModelOverrides,
35
36
  buildOpencodeModelLookup,
36
37
  buildAntigravityModelLookup,
37
38
  parseEffortMap,
38
39
  } from "../../render/models.js";
39
40
  import { getBkitDocsRoot } from "../../shared/package-roots.js";
41
+ import {
42
+ migrateBkitLayout,
43
+ migrateGithubProjectKey,
44
+ migrateLinearTeamKey,
45
+ } from "../../install/modules/core.js";
40
46
  import type { WriteSet } from "../../install/write.js";
41
47
  import { type UninstallContext, removeUnusedTrackerMcpEntries, runUninstall } from "./uninstall.js";
42
48
 
@@ -68,7 +74,7 @@ export function discardAllStaging(cwd = process.cwd()): void {
68
74
  * The installed opencode provider, or exit(1) with the fix.
69
75
  *
70
76
  * `bkit check` / `bkit upgrade` take no `--opencode=` flag, so they read the provider the
71
- * consumer actually installed (package.json `bkit.opencodeProvider`, else the opencode.json
77
+ * consumer actually installed (package.json `bkit.providers.opencode.default`, else the opencode.json
72
78
  * provider block). There is no default: a repo carrying `.opencode/` with no recorded
73
79
  * provider is a broken install.
74
80
  *
@@ -79,7 +85,7 @@ export function requireOpencodeProvider(cwd: string, context: string): string {
79
85
  if (!detected) {
80
86
  console.error(
81
87
  `${LOG_PREFIX} ${context}: the opencode host is installed but no provider is recorded ` +
82
- `(package.json \`bkit.opencodeProvider\` and .opencode/opencode.json are both silent). ` +
88
+ `(package.json \`bkit.providers.opencode.default\` and .opencode/opencode.json are both silent). ` +
83
89
  `Re-run \`bkit install --opencode=<provider>\` — one of ${OPENCODE_PROVIDERS.join(", ")}.`,
84
90
  );
85
91
  process.exit(1);
@@ -131,11 +137,20 @@ export function validateCloudTrackerMatch(
131
137
  );
132
138
  }
133
139
 
140
+ /** `parent[key]` as an object, set to a fresh `{}` first when it is absent or not an object. */
141
+ function section(parent: Record<string, unknown>, key: string): Record<string, unknown> {
142
+ const v = parent[key];
143
+ if (v !== null && typeof v === "object" && !Array.isArray(v)) return v as Record<string, unknown>;
144
+ const fresh: Record<string, unknown> = {};
145
+ parent[key] = fresh;
146
+ return fresh;
147
+ }
148
+
134
149
  /**
135
150
  * Detect the bkit opencode provider key a consumer installed.
136
151
  *
137
152
  * Resolution order:
138
- * 1. `package.json` `bkit.opencodeProvider` — the authoritative record written on install.
153
+ * 1. `package.json` `bkit.providers.opencode.default` — the authoritative record written on install.
139
154
  * This is the ONLY signal for managed-auth gateways (opencode) whose opencode.json carries no
140
155
  * custom provider block.
141
156
  * 2. `.opencode/opencode.json` first provider key — for installs without the manifest field
@@ -165,7 +180,7 @@ export function detectOpencodeProvider(cwd: string): string | null {
165
180
 
166
181
  /**
167
182
  * Returns all bkit-installed opencode providers from the consumer package.json
168
- * `bkit.opencodeProviders` array, filtered to valid OPENCODE_PROVIDERS entries; [] when
183
+ * `bkit.providers.opencode.installed` array, filtered to valid OPENCODE_PROVIDERS entries; [] when
169
184
  * the field is absent.
170
185
  */
171
186
  export function detectOpencodeProviders(cwd: string): string[] {
@@ -227,6 +242,18 @@ export async function runInstall(
227
242
  if (upgradeReport) console.log(`${LOG_PREFIX} Checking advisories (read-only)`);
228
243
  else if (dryRun) console.log(`${LOG_PREFIX} Running in check (dry-run) mode`);
229
244
 
245
+ // The package.json key moves run before anything below reads `bkit` settings: the tracker,
246
+ // the opencode provider and the cloud agent are read from the new paths only, so a 5.x
247
+ // layout read first renders every host as if no tracker were set. The core module runs
248
+ // the same moves again; each is a no-op once applied. Check moves nothing and reports
249
+ // the old keys as drift.
250
+ const ws: WriteSet = { writes: [] };
251
+ if (!dryRun) {
252
+ migrateLinearTeamKey(false, ws, LOG_PREFIX);
253
+ migrateGithubProjectKey(false, ws, LOG_PREFIX);
254
+ migrateBkitLayout(false, ws, LOG_PREFIX);
255
+ }
256
+
230
257
  // `bkit check` scopes drift detection to what is INSTALLED (detected by sentinel files),
231
258
  // not to a fixed full set. `install` keeps its explicit resolved set, plus every installed
232
259
  // host when `--tracker=` is given: each host renders tracker-specific commands, agents and
@@ -240,14 +267,14 @@ export async function runInstall(
240
267
 
241
268
  // RENDER-input provider resolution. `bkit check` takes no `--opencode=` flag, so the parsed
242
269
  // `opencodeProvider` is null on the check path; it falls back to the INSTALLED provider
243
- // (package.json `bkit.opencodeProvider`, else the opencode.json provider block). On install
270
+ // (package.json `bkit.providers.opencode.default`, else the opencode.json provider block). On install
244
271
  // `?? detect` fires only when opencode joins as an installed host under `--tracker=`; with
245
272
  // `--opencode=<provider>` the flag wins. The PARSED `opencodeProvider` alone drives the persist-to-package.json logic
246
273
  // below (gated on `!dryRun` + a real flag). The tracker is resolved from package.json below,
247
274
  // so the tracker-dependent opencode mcp block renders the same way on check.
248
275
  const renderOpencodeProvider = opencodeProvider ?? detectOpencodeProvider(process.cwd());
249
276
 
250
- // Resolve issueTracker: --tracker= flag overrides; else read bkit.issueTracker from consumer
277
+ // Resolve issueTracker: --tracker= flag overrides; else read bkit.tracker.default from consumer
251
278
  // package.json; else default to "none".
252
279
  // A `--tracker=` value always applies, whether first-set or a re-set of an
253
280
  // already-recorded tracker.
@@ -344,8 +371,20 @@ export async function runInstall(
344
371
 
345
372
  // Seed preflight advisories into ctx so modules can accumulate into the same list.
346
373
  const advisories: PreflightFinding[] = [...preflightAdvisories];
374
+ const deadOverrides =
375
+ modelLookup.size > 0
376
+ ? unknownModelOverrides(consumerPromptsMdPath, new Set(modelLookup.keys()))
377
+ : [];
378
+ if (deadOverrides.length > 0) {
379
+ advisories.push({
380
+ id: "model-override-unknown-agent",
381
+ severity: "advisory",
382
+ detect: `.bkit/prompts.md § Model Overrides names agents bkit no longer ships: ${deadOverrides.join(", ")}. Those rows are not applied.`,
383
+ action:
384
+ "Delete the rows, or move each pin to the agent that now does that work (see .bkit/prompts.md § Models).",
385
+ });
386
+ }
347
387
 
348
- const ws: WriteSet = { writes: [] };
349
388
  const postDispatch: Array<() => void> = [];
350
389
 
351
390
  // Symmetric cloud/tracker constraint (FINAL SCOPE decision 3/4) — see
@@ -375,8 +414,8 @@ export async function runInstall(
375
414
 
376
415
  // Persist bkit manifest fields to consumer package.json AFTER all hard-error gates pass.
377
416
  // This preserves the "no files written on mismatch" invariant. Two fields are recorded:
378
- // - issueTracker: when a `--tracker=` value was given this run.
379
- // - opencodeProvider: when an `--opencode=<provider>` value was given this run. This is
417
+ // - tracker.default: when a `--tracker=` value was given this run.
418
+ // - providers.opencode.default: when an `--opencode=<provider>` value was given this run. This is
380
419
  // the authoritative provider record detectOpencodeProvider reads on upgrade — REQUIRED
381
420
  // for managed-auth gateways (opencode), whose opencode.json carries no provider block to
382
421
  // detect from. Both are merged in one read-modify-write to avoid double-writing.
@@ -391,20 +430,20 @@ export async function runInstall(
391
430
  const parsed = parseJson(raw);
392
431
  if (parsed.ok) {
393
432
  const pkg = parsed.value as Record<string, unknown>;
394
- const bkit = (pkg.bkit ?? {}) as Record<string, unknown>;
395
- if (persistTracker) bkit.issueTracker = tracker;
433
+ const bkit = section(pkg, "bkit");
434
+ if (persistTracker) section(bkit, "tracker").default = tracker;
396
435
  if (persistProvider) {
397
- bkit.opencodeProvider = opencodeProvider; // active (drives agent frontmatter)
436
+ const opencode = section(section(bkit, "providers"), "opencode");
437
+ opencode.default = opencodeProvider; // active (drives agent frontmatter)
398
438
  // Update providers array (deduped).
399
- const existingArr: string[] = Array.isArray(bkit.opencodeProviders)
400
- ? [...(bkit.opencodeProviders as string[])]
439
+ const existingArr: string[] = Array.isArray(opencode.installed)
440
+ ? [...(opencode.installed as string[])]
401
441
  : [];
402
442
  if (!existingArr.includes(opencodeProvider!)) {
403
443
  existingArr.push(opencodeProvider!);
404
444
  }
405
- bkit.opencodeProviders = existingArr;
445
+ opencode.installed = existingArr;
406
446
  }
407
- pkg.bkit = bkit;
408
447
  const indentMatch = raw.match(/\n([ \t]+)"/);
409
448
  const indent = indentMatch ? indentMatch[1] : " ";
410
449
  const trailingNewline = raw.endsWith("\n") ? "\n" : "";
@@ -414,11 +453,11 @@ export async function runInstall(
414
453
  "utf-8",
415
454
  );
416
455
  if (persistTracker) {
417
- console.log(`${LOG_PREFIX} Set bkit.issueTracker = "${tracker}" in package.json`);
456
+ console.log(`${LOG_PREFIX} Set bkit.tracker.default = "${tracker}" in package.json`);
418
457
  }
419
458
  if (persistProvider) {
420
459
  console.log(
421
- `${LOG_PREFIX} Set bkit.opencodeProvider = "${opencodeProvider}" and updated bkit.opencodeProviders in package.json`,
460
+ `${LOG_PREFIX} Set bkit.providers.opencode.default = "${opencodeProvider}" and updated bkit.providers.opencode.installed in package.json`,
422
461
  );
423
462
  }
424
463
  }
@@ -61,8 +61,10 @@ import {
61
61
  } from "../../render/models.js";
62
62
  import { readInstallingVersion } from "../../shared/package-json.js";
63
63
  import { readBkitConfig } from "../../shared/settings.js";
64
+ import { SEEDED_BKIT_DEFAULTS } from "../../install/modules/core.js";
64
65
  import {
65
66
  CLAUDE_CLOUD_RELPATH,
67
+ CODEX_CLOUD_RELPATH,
66
68
  CURSOR_CLOUD_RELPATH,
67
69
  resolveClaudeDerivedAllows,
68
70
  } from "../../install/cloud-env.js";
@@ -377,8 +379,10 @@ const CORE_TEMPLATE_DOCTRINE: ManifestEntry[] = [
377
379
  { path: ".agents/docs.md", format: "markered-text", module: "core" },
378
380
  { path: ".agents/rules.md", format: "markered-text", module: "core" },
379
381
  { path: ".agents/skills.md", format: "markered-text", module: "core" },
380
- // Retired path of `.bkit/lite.md` (5.1.0 – 5.2.4), for an install never upgraded since.
382
+ // Retired `.agents/shortcuts.md` (5.1.0 – 5.2.4), for an install never upgraded since.
381
383
  { path: ".agents/shortcuts.md", format: "markered-text", module: "core" },
384
+ // Retired `.bkit/lite.md` (5.2.5 – 6.0.0), for an install never upgraded since.
385
+ { path: ".bkit/lite.md", format: "markered-text", module: "core" },
382
386
  ];
383
387
 
384
388
  /**
@@ -818,7 +822,7 @@ export async function runUninstall(
818
822
  }
819
823
 
820
824
  // Full/core uninstall: strip the `bkit` install-state object from package.json
821
- // (issueTracker / opencodeProvider(s) / cloudAgents), whatever keys it holds. Scripts
825
+ // (tracker / providers / cloud and every other section), whatever keys it holds. Scripts
822
826
  // and devDeps are the consumer's and stay. No try/catch — malformed package.json is a hard failure on full
823
827
  // teardown (same as a missing dest would be).
824
828
  if (moduleList.includes("core") && !ctx.dryRun) {
@@ -834,8 +838,8 @@ export async function runUninstall(
834
838
  }
835
839
  }
836
840
 
837
- // Targeted uninstall: drop the `bkit.*` keys the removed module records, so its advisories
838
- // stop firing. Core keeps every other key.
841
+ // Targeted uninstall: reset the `bkit.*` keys the removed module records to unset, so its
842
+ // advisories stop firing. Core keeps every other key.
839
843
  if (!moduleList.includes("core")) {
840
844
  stripModuleBkitKeys(moduleList, ctx, result);
841
845
  }
@@ -909,32 +913,23 @@ export async function runUninstall(
909
913
  }
910
914
  }
911
915
 
912
- // Remove the generated `.claude/bkit-cloud.md` (untracked, gitignored — holds resolved
913
- // secrets). It is not in the manifest, so the table-driven pass never sees it;
914
- // delete it explicitly when the claude host is uninstalled so a live-secrets file
915
- // is never left behind. Pushed to result.deleted so a dry-run reports it too.
916
- if (moduleList.includes("claude")) {
917
- const cloudAbs = path.join(ctx.cwd, CLAUDE_CLOUD_RELPATH);
918
- if (fs.existsSync(cloudAbs)) {
919
- result.deleted.push(CLAUDE_CLOUD_RELPATH);
920
- if (!ctx.dryRun) {
921
- fs.rmSync(cloudAbs, { force: true });
922
- console.log(`${ctx.logPrefix} delete: ${CLAUDE_CLOUD_RELPATH} (generated cloud setup doc)`);
923
- }
924
- }
925
- }
926
-
927
- // Same for the Cursor twin `.cursor/bkit-cloud.md` (writeCursorCloudDoc) — untracked,
928
- // gitignored, holds resolved secrets; delete it explicitly when the cursor host is
929
- // uninstalled so a live-secrets file is never left behind.
930
- if (moduleList.includes("cursor")) {
931
- const cloudAbs = path.join(ctx.cwd, CURSOR_CLOUD_RELPATH);
932
- if (fs.existsSync(cloudAbs)) {
933
- result.deleted.push(CURSOR_CLOUD_RELPATH);
934
- if (!ctx.dryRun) {
935
- fs.rmSync(cloudAbs, { force: true });
936
- console.log(`${ctx.logPrefix} delete: ${CURSOR_CLOUD_RELPATH} (generated cloud setup doc)`);
937
- }
916
+ // Remove each uninstalled host's generated `<host>/bkit-cloud.md` (untracked,
917
+ // gitignored — holds resolved secrets). Not in the manifest, so the table-driven pass
918
+ // never sees them; delete explicitly so a live-secrets file is never left behind.
919
+ // Pushed to result.deleted so a dry-run reports them too.
920
+ const cloudDocs: ReadonlyArray<readonly [ModuleFlag, string]> = [
921
+ ["claude", CLAUDE_CLOUD_RELPATH],
922
+ ["cursor", CURSOR_CLOUD_RELPATH],
923
+ ["codex", CODEX_CLOUD_RELPATH],
924
+ ];
925
+ for (const [host, relPath] of cloudDocs) {
926
+ if (!moduleList.includes(host)) continue;
927
+ const cloudAbs = path.join(ctx.cwd, relPath);
928
+ if (!fs.existsSync(cloudAbs)) continue;
929
+ result.deleted.push(relPath);
930
+ if (!ctx.dryRun) {
931
+ fs.rmSync(cloudAbs, { force: true });
932
+ console.log(`${ctx.logPrefix} delete: ${relPath} (generated cloud setup doc)`);
938
933
  }
939
934
  }
940
935
 
@@ -1035,16 +1030,38 @@ export async function runUninstall(
1035
1030
  return result;
1036
1031
  }
1037
1032
 
1038
- /** `package.json` `bkit.*` keys each module records on install. */
1033
+ /** `package.json` `bkit.*` keys (dotted paths) each module records on install. */
1039
1034
  const MODULE_BKIT_KEYS: Partial<Record<ModuleName, readonly string[]>> = {
1040
- cloud: ["cloudAgents"],
1041
- opencode: ["opencodeProvider", "opencodeProviders"],
1035
+ cloud: ["cloud.agent"],
1036
+ opencode: ["providers.opencode.default", "providers.opencode.installed"],
1042
1037
  };
1043
1038
 
1039
+ /** The object at dotted `keys` under `root`; null when a step is absent or not an object. */
1040
+ function objectAt(
1041
+ root: Record<string, unknown>,
1042
+ keys: readonly string[],
1043
+ ): Record<string, unknown> | null {
1044
+ let node: Record<string, unknown> = root;
1045
+ for (const k of keys) {
1046
+ const next = node[k];
1047
+ if (!isJsonObject(next as JsonValue)) return null;
1048
+ node = next as Record<string, unknown>;
1049
+ }
1050
+ return node;
1051
+ }
1052
+
1053
+ /** The seeded value at dotted `key` in SEEDED_BKIT_DEFAULTS, copied. */
1054
+ function seededValue(key: string): unknown {
1055
+ const segs = key.split(".");
1056
+ const parent = objectAt(SEEDED_BKIT_DEFAULTS as Record<string, unknown>, segs.slice(0, -1));
1057
+ return structuredClone(parent?.[segs[segs.length - 1]!]);
1058
+ }
1059
+
1044
1060
  /**
1045
- * Remove the `bkit.*` keys recorded by the modules in `moduleList` from the consumer's
1046
- * package.json, keeping its indent. Lists each removed key in `result.stripped`; a dry run
1047
- * lists without writing.
1061
+ * Reset the `bkit.*` keys recorded by the modules in `moduleList` to the value install
1062
+ * seeds (`""` / `[]`, read as unset), keeping the package.json indent. Deleting them
1063
+ * would leave `bkit check` reporting the seeded key as missing. Lists each reset key in
1064
+ * `result.stripped`; a dry run lists without writing.
1048
1065
  */
1049
1066
  function stripModuleBkitKeys(
1050
1067
  moduleList: ModuleName[],
@@ -1060,14 +1077,24 @@ function stripModuleBkitKeys(
1060
1077
  const pkg = parsed.ok ? (parsed.value as Record<string, unknown> | null) : null;
1061
1078
  if (pkg === null || !isJsonObject(pkg.bkit as JsonValue)) return;
1062
1079
  const bkit = pkg.bkit as Record<string, unknown>;
1063
- const present = keys.filter((k) => k in bkit);
1064
- if (present.length === 0) return;
1065
- for (const k of present) {
1066
- delete bkit[k];
1080
+ const reset = keys.filter((k) => {
1081
+ const segs = k.split(".");
1082
+ const parent = objectAt(bkit, segs.slice(0, -1));
1083
+ const key = segs[segs.length - 1]!;
1084
+ return (
1085
+ parent !== null &&
1086
+ key in parent &&
1087
+ JSON.stringify(parent[key]) !== JSON.stringify(seededValue(k))
1088
+ );
1089
+ });
1090
+ if (reset.length === 0) return;
1091
+ for (const k of reset) {
1092
+ const segs = k.split(".");
1093
+ objectAt(bkit, segs.slice(0, -1))![segs[segs.length - 1]!] = seededValue(k);
1067
1094
  result.stripped.push(`package.json#bkit.${k}`);
1068
1095
  }
1069
1096
  console.log(
1070
- `${ctx.logPrefix}${ctx.dryRun ? " [dry-run]" : ""} package.json: removed bkit.${present.join(", bkit.")}`,
1097
+ `${ctx.logPrefix}${ctx.dryRun ? " [dry-run]" : ""} package.json: reset bkit.${reset.join(", bkit.")} to unset`,
1071
1098
  );
1072
1099
  if (ctx.dryRun) return;
1073
1100
  const indentMatch = raw.match(/\n([ \t]+)"/);
@@ -1084,8 +1111,8 @@ function stripModuleBkitKeys(
1084
1111
  *
1085
1112
  * Distinct from bare `bkit uninstall --opencode` (full host teardown):
1086
1113
  * - Removes the provider block from `.opencode/opencode.json`
1087
- * - Updates `bkit.opencodeProviders` in `package.json`
1088
- * - If the removed provider was the active one, re-points `bkit.opencodeProvider`
1114
+ * - Updates `bkit.providers.opencode.installed` in `package.json`
1115
+ * - If the removed provider was the active one, re-points `bkit.providers.opencode.default`
1089
1116
  * to the first remaining provider and emits a re-render advisory
1090
1117
  * - If no providers remain, falls through to full host teardown via `runUninstall`
1091
1118
  */
@@ -1105,7 +1132,7 @@ export async function runSurgicalOpencodeUninstall(
1105
1132
  console.log(`${LOG_PREFIX}${tag} removed provider block "${providerKey}" from opencode.json`);
1106
1133
  }
1107
1134
 
1108
- // 2. Update bkit.opencodeProviders in package.json (read inline — no detectOpencodeProviders import)
1135
+ // 2. Update bkit.providers.opencode.installed in package.json (read inline — no detectOpencodeProviders import)
1109
1136
  const pkgPath = path.join(cwd, "package.json");
1110
1137
  let remainingProviders: string[] = [];
1111
1138
  let wasActive = false;
@@ -1119,32 +1146,36 @@ export async function runSurgicalOpencodeUninstall(
1119
1146
  console.warn(`${LOG_PREFIX} package.json is malformed — skipping bkit section update`);
1120
1147
  return;
1121
1148
  }
1122
- const bkit = (pkg.bkit ?? {}) as Record<string, unknown>;
1123
- const arr = Array.isArray(bkit.opencodeProviders)
1124
- ? [...(bkit.opencodeProviders as string[])]
1125
- : [];
1149
+ const opencode = objectAt(pkg, ["bkit", "providers", "opencode"]) ?? {};
1150
+ const arr = Array.isArray(opencode.installed) ? [...(opencode.installed as string[])] : [];
1126
1151
  remainingProviders = arr.filter((p) => p !== providerKey);
1127
- wasActive = bkit.opencodeProvider === providerKey;
1152
+ wasActive = opencode.default === providerKey;
1128
1153
  if (wasActive && remainingProviders.length > 0) {
1129
1154
  newActive = remainingProviders[0]!;
1130
1155
  }
1131
1156
 
1132
1157
  if (!dryRun) {
1133
- bkit.opencodeProviders = remainingProviders;
1158
+ opencode.installed = remainingProviders;
1134
1159
  if (wasActive) {
1135
1160
  if (newActive !== null) {
1136
- bkit.opencodeProvider = newActive;
1161
+ opencode.default = newActive;
1137
1162
  } else {
1138
- delete bkit.opencodeProvider;
1163
+ delete opencode.default;
1139
1164
  }
1140
1165
  }
1141
- pkg.bkit = bkit;
1166
+ if (objectAt(pkg, ["bkit", "providers", "opencode"]) === null) {
1167
+ const bkit = objectAt(pkg, ["bkit"]) ?? {};
1168
+ const providers = objectAt(bkit, ["providers"]) ?? {};
1169
+ providers.opencode = opencode;
1170
+ bkit.providers = providers;
1171
+ pkg.bkit = bkit;
1172
+ }
1142
1173
  const indentMatch = raw.match(/\n([ \t]+)"/);
1143
1174
  const indent = indentMatch ? indentMatch[1] : " ";
1144
1175
  fs.writeFileSync(pkgPath, JSON.stringify(pkg, null, indent) + "\n", "utf-8");
1145
1176
  console.log(
1146
- `${LOG_PREFIX} updated package.json: opencodeProviders=[${remainingProviders.join(", ")}]` +
1147
- (wasActive ? ` opencodeProvider=${newActive ?? "(removed)"}` : ""),
1177
+ `${LOG_PREFIX} updated package.json: bkit.providers.opencode.installed=[${remainingProviders.join(", ")}]` +
1178
+ (wasActive ? ` bkit.providers.opencode.default=${newActive ?? "(removed)"}` : ""),
1148
1179
  );
1149
1180
  }
1150
1181
  }
@@ -63,8 +63,10 @@ import { detectInstalledModules } from "./check.js";
63
63
  import { remapTemplateDest } from "../../install/template-copies.js";
64
64
  import {
65
65
  CLAUDE_CLOUD_RELPATH,
66
+ CODEX_CLOUD_RELPATH,
66
67
  CURSOR_CLOUD_RELPATH,
67
68
  writeClaudeCloudDoc,
69
+ writeCodexCloudDoc,
68
70
  writeCursorCloudDoc,
69
71
  writeCursorCliPermissionsArtifact,
70
72
  } from "../../install/cloud-env.js";
@@ -736,13 +738,19 @@ export async function runUpgradeCommand(upgradeFlags: UpgradeFlags): Promise<voi
736
738
  } else if (ent.isFile()) {
737
739
  // Single shared dotfile remap (gitignore → .gitignore, npmignore → .npmignore).
738
740
  const relPath = remapTemplateDest(entRel);
739
- // `.claude/bkit-cloud.md` + `.cursor/bkit-cloud.md` are GENERATED output files
740
- // (writeClaudeCloudDoc / writeCursorCloudDoc), not payload files to reconcile:
741
- // install/upgrade regenerate them with resolved secret values, so the raw
742
- // source is never a byte-match and the walk must never drift-flag or
741
+ // `.claude/` + `.cursor/` + `.codex/bkit-cloud.md` are GENERATED output files
742
+ // (writeClaudeCloudDoc / writeCursorCloudDoc / writeCodexCloudDoc), not payload
743
+ // files to reconcile: install/upgrade regenerate them with resolved secret values,
744
+ // so the raw source is never a byte-match and the walk must never drift-flag or
743
745
  // overwrite them. Regenerated explicitly in the runUpgrade block below
744
746
  // (host-gated, non-dry-run).
745
- if (relPath === CLAUDE_CLOUD_RELPATH || relPath === CURSOR_CLOUD_RELPATH) continue;
747
+ if (
748
+ relPath === CLAUDE_CLOUD_RELPATH ||
749
+ relPath === CURSOR_CLOUD_RELPATH ||
750
+ relPath === CODEX_CLOUD_RELPATH
751
+ ) {
752
+ continue;
753
+ }
746
754
  if (relPath === MCP_ROOT_RELPATH || relPath === CURSOR_MCP_RELPATH) continue;
747
755
  const entry = entryByPath.get(relPath);
748
756
  const ownerModule = entry?.module;
@@ -961,16 +969,23 @@ export async function runUpgradeCommand(upgradeFlags: UpgradeFlags): Promise<voi
961
969
  }
962
970
  }
963
971
 
964
- // Same for `.cursor/bkit-cloud.md` — cursor-host-gated twin (see writeCursorCloudDoc).
965
- // Uses upgradeTracker so the Linear/GitHub env-var policy matches the installed
966
- // tracker; excluded from the payload walk above for the same reason as the Claude doc.
972
+ // Same for `.cursor/bkit-cloud.md` and `.codex/bkit-cloud.md` — host-gated twins (see
973
+ // writeCursorCloudDoc / writeCodexCloudDoc); excluded from the payload walk above for
974
+ // the same reason as the Claude doc.
967
975
  if (!upgradeFlags.dryRun && renderModules.has("cursor") && tokens) {
968
- if (writeCursorCloudDoc(process.cwd(), tokens, upgradeTracker)) {
976
+ if (writeCursorCloudDoc(process.cwd(), tokens)) {
969
977
  console.log(
970
978
  `${LOG_PREFIX} upgrade: .cursor/bkit-cloud.md (regenerated — gitignored, holds resolved secrets)`,
971
979
  );
972
980
  }
973
981
  }
982
+ if (!upgradeFlags.dryRun && renderModules.has("codex") && tokens) {
983
+ if (writeCodexCloudDoc(process.cwd(), tokens)) {
984
+ console.log(
985
+ `${LOG_PREFIX} upgrade: .codex/bkit-cloud.md (regenerated — gitignored, holds resolved secrets)`,
986
+ );
987
+ }
988
+ }
974
989
 
975
990
  // Network allowlist + MCP allows — OpenCode from renderOpencodeJson; Claude enrich
976
991
  // below; `.bkit/allowlist.json` in renderManagedOutputs above; Cursor
@@ -1010,12 +1025,14 @@ export async function runUpgradeCommand(upgradeFlags: UpgradeFlags): Promise<voi
1010
1025
  // exit), so feed those writes into canonicalHashes — keeping install/upgrade `.bkit/version`
1011
1026
  // parity.
1012
1027
  if (!upgradeFlags.dryRun) {
1013
- const renderedDocPaths = renderWs.writes.map((w) =>
1014
- path.relative(
1015
- process.cwd(),
1016
- path.isAbsolute(w.path) ? w.path : path.resolve(process.cwd(), w.path),
1017
- ),
1018
- );
1028
+ const renderedDocPaths = renderWs.writes
1029
+ .filter((w) => !w.unhashed)
1030
+ .map((w) =>
1031
+ path.relative(
1032
+ process.cwd(),
1033
+ path.isAbsolute(w.path) ? w.path : path.resolve(process.cwd(), w.path),
1034
+ ),
1035
+ );
1019
1036
  updateCanonicalHashesAfterUpgrade(
1020
1037
  {
1021
1038
  updated: [