@cbartens/bkit 0.0.0-stage → 5.0.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (375) hide show
  1. package/.bkit/README.md +417 -0
  2. package/.bkit/core/.agents/context.md +95 -0
  3. package/.bkit/core/.agents/docs.md +62 -0
  4. package/.bkit/core/.agents/rules.md +147 -0
  5. package/.bkit/core/.agents/skills.md +43 -0
  6. package/.bkit/core/.bkit/LICENSE.md +151 -0
  7. package/.bkit/core/.bkit/README.md +417 -0
  8. package/.bkit/core/.bkit/cloud.md +493 -0
  9. package/.bkit/core/.bkit/comparison.md +321 -0
  10. package/.bkit/core/.bkit/install.md +401 -0
  11. package/.bkit/core/.bkit/jsonl.md +497 -0
  12. package/.bkit/core/.bkit/prompts.md +474 -0
  13. package/.bkit/core/.bkit/providers.md +598 -0
  14. package/.bkit/core/.bkit/templates.md +470 -0
  15. package/.bkit/core/.bkit/trackers.md +95 -0
  16. package/.bkit/core/.bkit/workflows.md +1550 -0
  17. package/.bkit/core/.claude/hooks/bkit-gateguard.cjs +82 -0
  18. package/.bkit/core/.claude/hooks/bkit-guardrails.cjs +93 -0
  19. package/.bkit/core/.claude/hooks/bkit-preflight.sh +74 -0
  20. package/.bkit/core/.codex/hooks/bkit-gateguard.cjs +115 -0
  21. package/.bkit/core/.codex/hooks/bkit-guardrails.cjs +135 -0
  22. package/.bkit/core/.cursor/hooks/bkit-gateguard.cjs +111 -0
  23. package/.bkit/core/.cursor/hooks/bkit-guardrails.cjs +169 -0
  24. package/.bkit/core/.cursor/hooks/bkit-preflight.sh +63 -0
  25. package/.bkit/core/.opencode/plugin/bkit-gateguard.js +225 -0
  26. package/.bkit/core/AGENTS.md +77 -0
  27. package/.bkit/core/LICENSE.md +149 -0
  28. package/.bkit/core/docs/templates/bkit-audit-accessibility.md +272 -0
  29. package/.bkit/core/docs/templates/bkit-audit-adoption.md +223 -0
  30. package/.bkit/core/docs/templates/bkit-audit-agents.md +230 -0
  31. package/.bkit/core/docs/templates/bkit-audit-aio-seo.md +227 -0
  32. package/.bkit/core/docs/templates/bkit-audit-analytics.md +266 -0
  33. package/.bkit/core/docs/templates/bkit-audit-annotations.md +230 -0
  34. package/.bkit/core/docs/templates/bkit-audit-app-performance.md +270 -0
  35. package/.bkit/core/docs/templates/bkit-audit-app-store.md +254 -0
  36. package/.bkit/core/docs/templates/bkit-audit-architecture.md +221 -0
  37. package/.bkit/core/docs/templates/bkit-audit-ci-performance.md +241 -0
  38. package/.bkit/core/docs/templates/bkit-audit-config.md +230 -0
  39. package/.bkit/core/docs/templates/bkit-audit-cost.md +218 -0
  40. package/.bkit/core/docs/templates/bkit-audit-coverage.md +221 -0
  41. package/.bkit/core/docs/templates/bkit-audit-database.md +229 -0
  42. package/.bkit/core/docs/templates/bkit-audit-dead-code.md +251 -0
  43. package/.bkit/core/docs/templates/bkit-audit-deferrals.md +283 -0
  44. package/.bkit/core/docs/templates/bkit-audit-dependencies.md +268 -0
  45. package/.bkit/core/docs/templates/bkit-audit-documentation.md +280 -0
  46. package/.bkit/core/docs/templates/bkit-audit-duplication.md +253 -0
  47. package/.bkit/core/docs/templates/bkit-audit-failures.md +259 -0
  48. package/.bkit/core/docs/templates/bkit-audit-flakes.md +237 -0
  49. package/.bkit/core/docs/templates/bkit-audit-gates.md +250 -0
  50. package/.bkit/core/docs/templates/bkit-audit-issues.md +273 -0
  51. package/.bkit/core/docs/templates/bkit-audit-llm.md +239 -0
  52. package/.bkit/core/docs/templates/bkit-audit-logs.md +266 -0
  53. package/.bkit/core/docs/templates/bkit-audit-models.md +210 -0
  54. package/.bkit/core/docs/templates/bkit-audit-privacy.md +211 -0
  55. package/.bkit/core/docs/templates/bkit-audit-prompts.md +216 -0
  56. package/.bkit/core/docs/templates/bkit-audit-red-team.md +220 -0
  57. package/.bkit/core/docs/templates/bkit-audit-reliability.md +222 -0
  58. package/.bkit/core/docs/templates/bkit-audit-repo.md +224 -0
  59. package/.bkit/core/docs/templates/bkit-audit-security.md +274 -0
  60. package/.bkit/core/docs/templates/bkit-audit-slop.md +200 -0
  61. package/.bkit/core/docs/templates/bkit-audit-testing.md +270 -0
  62. package/.bkit/core/docs/templates/bkit-audit-usability.md +237 -0
  63. package/.bkit/core/docs/templates/bkit-plan.md +476 -0
  64. package/.bkit/core/engine/checks/after/auth.ts +149 -0
  65. package/.bkit/core/engine/checks/after/ci-yml.ts +701 -0
  66. package/.bkit/core/engine/checks/after/github.ts +424 -0
  67. package/.bkit/core/engine/checks/after/index.ts +530 -0
  68. package/.bkit/core/engine/checks/after/managed.ts +217 -0
  69. package/.bkit/core/engine/checks/after/suppression.ts +53 -0
  70. package/.bkit/core/engine/checks/after/tools.ts +427 -0
  71. package/.bkit/core/engine/checks/before/context-fetch.ts +429 -0
  72. package/.bkit/core/engine/checks/before/env.ts +187 -0
  73. package/.bkit/core/engine/checks/before/files.ts +204 -0
  74. package/.bkit/core/engine/checks/before/index.ts +206 -0
  75. package/.bkit/core/engine/checks/before/mcp.ts +127 -0
  76. package/.bkit/core/engine/checks/before/repo.ts +77 -0
  77. package/.bkit/core/engine/checks/before/version.ts +67 -0
  78. package/.bkit/core/engine/checks/status-holes.ts +479 -0
  79. package/.bkit/core/engine/cli.ts +867 -0
  80. package/.bkit/core/engine/commands/analysis.ts +550 -0
  81. package/.bkit/core/engine/commands/ci/ci.ts +483 -0
  82. package/.bkit/core/engine/commands/comply.ts +415 -0
  83. package/.bkit/core/engine/commands/harvest.ts +459 -0
  84. package/.bkit/core/engine/commands/install/check.ts +70 -0
  85. package/.bkit/core/engine/commands/install/doctor.ts +254 -0
  86. package/.bkit/core/engine/commands/install/install.ts +550 -0
  87. package/.bkit/core/engine/commands/install/uninstall.ts +995 -0
  88. package/.bkit/core/engine/commands/install/upgrade.ts +1037 -0
  89. package/.bkit/core/engine/commands/launch.ts +139 -0
  90. package/.bkit/core/engine/commands/lib.ts +495 -0
  91. package/.bkit/core/engine/commands/registry.ts +53 -0
  92. package/.bkit/core/engine/commands/setup/setup.ts +184 -0
  93. package/.bkit/core/engine/commands/telemetry.ts +32 -0
  94. package/.bkit/core/engine/commands/workflow/branches.ts +1514 -0
  95. package/.bkit/core/engine/commands/workflow/context.ts +961 -0
  96. package/.bkit/core/engine/commands/workflow/counters.ts +268 -0
  97. package/.bkit/core/engine/commands/workflow/fids.ts +243 -0
  98. package/.bkit/core/engine/commands/workflow/issues.ts +675 -0
  99. package/.bkit/core/engine/commands/workflow/ledgers.ts +575 -0
  100. package/.bkit/core/engine/commands/workflow/locks.ts +478 -0
  101. package/.bkit/core/engine/commands/workflow/prs.ts +1087 -0
  102. package/.bkit/core/engine/commands/workflow/repo.ts +220 -0
  103. package/.bkit/core/engine/commands/workflow/roadmap.ts +576 -0
  104. package/.bkit/core/engine/commands/workflow/runs.ts +2140 -0
  105. package/.bkit/core/engine/commands/workflow/runtime.ts +300 -0
  106. package/.bkit/core/engine/commands/workflow/skills.ts +118 -0
  107. package/.bkit/core/engine/commands/workflow/status.ts +455 -0
  108. package/.bkit/core/engine/commands/workflow/steps.ts +1300 -0
  109. package/.bkit/core/engine/commands/workflow/tests.ts +161 -0
  110. package/.bkit/core/engine/commands/workflow/workflows.ts +1573 -0
  111. package/.bkit/core/engine/commands/workflow/workstreams.ts +164 -0
  112. package/.bkit/core/engine/commands/workflow/worktrees.ts +534 -0
  113. package/.bkit/core/engine/install/cloud-env.ts +924 -0
  114. package/.bkit/core/engine/install/managed-block.ts +212 -0
  115. package/.bkit/core/engine/install/manifest.ts +448 -0
  116. package/.bkit/core/engine/install/modules/claude.ts +362 -0
  117. package/.bkit/core/engine/install/modules/cloud.ts +173 -0
  118. package/.bkit/core/engine/install/modules/codex.ts +219 -0
  119. package/.bkit/core/engine/install/modules/core.ts +620 -0
  120. package/.bkit/core/engine/install/modules/cursor.ts +231 -0
  121. package/.bkit/core/engine/install/modules/index.ts +242 -0
  122. package/.bkit/core/engine/install/modules/opencode.ts +573 -0
  123. package/.bkit/core/engine/install/payload-links.ts +150 -0
  124. package/.bkit/core/engine/install/placeholders.ts +108 -0
  125. package/.bkit/core/engine/install/template-copies.ts +119 -0
  126. package/.bkit/core/engine/install/version-file.ts +284 -0
  127. package/.bkit/core/engine/install/write.ts +467 -0
  128. package/.bkit/core/engine/ledgers/clamp-log.ts +32 -0
  129. package/.bkit/core/engine/ledgers/status.ts +213 -0
  130. package/.bkit/core/engine/ledgers/telemetry.ts +1143 -0
  131. package/.bkit/core/engine/render/hosts.ts +372 -0
  132. package/.bkit/core/engine/render/models.ts +323 -0
  133. package/.bkit/core/engine/render/parts.ts +38 -0
  134. package/.bkit/core/engine/render/trackers.ts +170 -0
  135. package/.bkit/core/engine/shared/egress.ts +345 -0
  136. package/.bkit/core/engine/shared/json.ts +16 -0
  137. package/.bkit/core/engine/shared/log-prefix.ts +9 -0
  138. package/.bkit/core/engine/shared/package-json.ts +29 -0
  139. package/.bkit/core/engine/shared/package-manager.ts +38 -0
  140. package/.bkit/core/engine/shared/package-roots.ts +163 -0
  141. package/.bkit/core/engine/shared/protected-paths.ts +164 -0
  142. package/.bkit/core/engine/shared/settings.ts +72 -0
  143. package/.bkit/core/engine/shared/timeouts.ts +20 -0
  144. package/.bkit/core/engine/tools/wording.ts +748 -0
  145. package/.bkit/core/hooks/gateguard-edit-payload.js +18 -0
  146. package/.bkit/core/hooks/gateguard-engine.js +193 -0
  147. package/.bkit/core/hooks/guardrails-shell.js +154 -0
  148. package/.bkit/core/hooks/guardrails-tiers.js +68 -0
  149. package/.bkit/core/hooks/preflight-linear.sh +73 -0
  150. package/.bkit/core/prompts/bkit-audit-generate.md +66 -0
  151. package/.bkit/core/prompts/bkit-build-challenge-1.md +79 -0
  152. package/.bkit/core/prompts/bkit-build-challenge-2.md +81 -0
  153. package/.bkit/core/prompts/bkit-build-challenge-reconcile.md +68 -0
  154. package/.bkit/core/prompts/bkit-build-challenge-remediate.md +70 -0
  155. package/.bkit/core/prompts/bkit-build-challenge-tests.md +73 -0
  156. package/.bkit/core/prompts/bkit-build-install-skills.md +67 -0
  157. package/.bkit/core/prompts/bkit-build-plan-current.md +75 -0
  158. package/.bkit/core/prompts/bkit-build-plan-execute.md +72 -0
  159. package/.bkit/core/prompts/bkit-build-plan-gaps-remediate.md +73 -0
  160. package/.bkit/core/prompts/bkit-build-plan-verify.md +88 -0
  161. package/.bkit/core/prompts/bkit-build-summary.md +93 -0
  162. package/.bkit/core/prompts/bkit-debug-abort-handover.md +90 -0
  163. package/.bkit/core/prompts/bkit-debug-failure-diagnose.md +151 -0
  164. package/.bkit/core/prompts/bkit-debug-failure-remediate.md +78 -0
  165. package/.bkit/core/prompts/bkit-debug-failure-soak.md +73 -0
  166. package/.bkit/core/prompts/bkit-debug-summary.md +95 -0
  167. package/.bkit/core/prompts/bkit-design-brainstorm-ideate-1.md +72 -0
  168. package/.bkit/core/prompts/bkit-design-brainstorm-ideate-2.md +72 -0
  169. package/.bkit/core/prompts/bkit-design-brainstorm-ideate-3.md +75 -0
  170. package/.bkit/core/prompts/bkit-design-generate.md +110 -0
  171. package/.bkit/core/prompts/bkit-design-organise.md +85 -0
  172. package/.bkit/core/prompts/bkit-design-review-1.md +121 -0
  173. package/.bkit/core/prompts/bkit-design-review-2.md +111 -0
  174. package/.bkit/core/prompts/bkit-design-spike.md +97 -0
  175. package/.bkit/core/prompts/bkit-design-summary.md +106 -0
  176. package/.bkit/core/prompts/bkit-design-update.md +66 -0
  177. package/.bkit/core/prompts/bkit-plan-complexity-check.md +66 -0
  178. package/.bkit/core/prompts/bkit-plan-complexity-split.md +87 -0
  179. package/.bkit/core/prompts/bkit-plan-generate.md +74 -0
  180. package/.bkit/core/prompts/bkit-plan-review-1.md +90 -0
  181. package/.bkit/core/prompts/bkit-plan-review-2.md +80 -0
  182. package/.bkit/core/prompts/bkit-plan-review-3.md +92 -0
  183. package/.bkit/core/prompts/bkit-plan-scope-check-1.md +84 -0
  184. package/.bkit/core/prompts/bkit-plan-scope-check-2.md +84 -0
  185. package/.bkit/core/prompts/bkit-plan-summary.md +106 -0
  186. package/.bkit/core/prompts/bkit-plan-update.md +68 -0
  187. package/.bkit/core/prompts/bkit-ship-conflict-resolve.md +90 -0
  188. package/.bkit/core/prompts/bkit-ship-deferred-sweep.md +94 -0
  189. package/.bkit/core/prompts/bkit-ship-summary.md +77 -0
  190. package/.bkit/core/prompts/bkit-ship-update-docs.md +71 -0
  191. package/.bkit/core/prompts/bkit-utility-compress-markdown.md +91 -0
  192. package/.bkit/core/prompts/bkit-utility-update-decisions.md +75 -0
  193. package/.bkit/core/prompts/bkit-utility-update-deferrals.md +76 -0
  194. package/.bkit/core/prompts/bkit-utility-update-documentation.md +61 -0
  195. package/.bkit/core/prompts/bkit-utility-update-failures.md +76 -0
  196. package/.bkit/core/prompts/bkit-utility-update-knowledge.md +75 -0
  197. package/.bkit/core/prompts/bkit-utility-update-roadmap.md +82 -0
  198. package/.bkit/core/workflows/bkit-auto.md +121 -0
  199. package/.bkit/core/workflows/bkit-build.md +802 -0
  200. package/.bkit/core/workflows/bkit-debug.md +649 -0
  201. package/.bkit/core/workflows/bkit-design.md +495 -0
  202. package/.bkit/core/workflows/bkit-plan.md +510 -0
  203. package/.bkit/core/workflows/bkit-ship.md +650 -0
  204. package/.bkit/shared/.bkit/.env.example +86 -0
  205. package/.bkit/shared/.claude/bkit-cloud.md +117 -0
  206. package/.bkit/shared/.claude/settings.json +88 -0
  207. package/.bkit/shared/.codex/hooks.json +26 -0
  208. package/.bkit/shared/.cursor/bkit-cloud.md +84 -0
  209. package/.bkit/shared/.cursor/hooks.json +26 -0
  210. package/.bkit/shared/.cursor/mcp.json +15 -0
  211. package/.bkit/shared/.cursor/rules/bkit-rules.mdc +12 -0
  212. package/.bkit/shared/.gitattributes +37 -0
  213. package/.bkit/shared/.mcp.json +16 -0
  214. package/.bkit/shared/.opencode/opencode.json +62 -0
  215. package/.bkit/shared/CLAUDE.md +11 -0
  216. package/.bkit/shared/LICENSE.md +22 -0
  217. package/.bkit/shared/docs/architecture.md +19 -0
  218. package/.bkit/shared/docs/data-schema.md +19 -0
  219. package/.bkit/shared/docs/deployments.md +433 -0
  220. package/.bkit/shared/docs/design.md +39 -0
  221. package/.bkit/shared/docs/noise.md +19 -0
  222. package/.bkit/shared/docs/observability.md +25 -0
  223. package/.bkit/shared/docs/security.md +42 -0
  224. package/.bkit/shared/docs/setup.md +30 -0
  225. package/.bkit/shared/docs/technology.md +18 -0
  226. package/.bkit/shared/docs/testing.md +413 -0
  227. package/.bkit/shared/gitignore +97 -0
  228. package/.bkit/templates/.claude/hooks/bkit-cloud-bootstrap.sh +187 -0
  229. package/.bkit/templates/.cursor/Dockerfile +68 -0
  230. package/.bkit/templates/.cursor/environment.json +6 -0
  231. package/.bkit/templates/.cursor/settings.json +11 -0
  232. package/.bkit/templates/.envrc +7 -0
  233. package/.bkit/templates/.github/dependabot.yml +52 -0
  234. package/.bkit/templates/.github/renovate.json5 +224 -0
  235. package/.bkit/templates/.github/workflows/bkit-ci.yml +1062 -0
  236. package/.bkit/templates/.github/workflows/bkit-cloud.yml +564 -0
  237. package/.bkit/templates/.github/workflows/bkit-renovate.yml +102 -0
  238. package/.bkit/templates/.graphifyignore +108 -0
  239. package/.bkit/templates/.husky/pre-commit +16 -0
  240. package/.bkit/templates/.husky/pre-push +91 -0
  241. package/.bkit/templates/.lintstagedrc.json +3 -0
  242. package/.bkit/templates/.prettierignore +41 -0
  243. package/.bkit/templates/.serena/project.yml +243 -0
  244. package/.bkit/templates/.vale/styles/House/Filler.yml +11 -0
  245. package/.bkit/templates/.vale/styles/House/Hedging.yml +12 -0
  246. package/.bkit/templates/.vale/styles/House/LLMSlop.yml +13 -0
  247. package/.bkit/templates/.vale/styles/House/Verbose.yml +12 -0
  248. package/.bkit/templates/.vale.ini +67 -0
  249. package/.bkit/templates/LICENSE.md +22 -0
  250. package/.bkit/templates/context/bkit-cloudrun.md +84 -0
  251. package/.bkit/templates/context/bkit-expo.md +186 -0
  252. package/.bkit/templates/context/bkit-github.md +79 -0
  253. package/.bkit/templates/context/bkit-inngest.md +45 -0
  254. package/.bkit/templates/context/bkit-maestro.md +76 -0
  255. package/.bkit/templates/context/bkit-playwright.md +62 -0
  256. package/.bkit/templates/context/bkit-resend.md +36 -0
  257. package/.bkit/templates/context/bkit-sentry.md +65 -0
  258. package/.bkit/templates/context/bkit-serena.md +33 -0
  259. package/.bkit/templates/context/bkit-stripe.md +36 -0
  260. package/.bkit/templates/context/bkit-supabase.md +59 -0
  261. package/.bkit/templates/context/bkit-tavily.md +49 -0
  262. package/.bkit/templates/context/bkit-vercel.md +64 -0
  263. package/.bkit/templates/docs/capabilities.md +72 -0
  264. package/.bkit/templates/scripts/ci/accepted-divergences.json +21 -0
  265. package/.bkit/templates/scripts/ci/check-accepted-divergences.mjs +152 -0
  266. package/.bkit/templates/scripts/ci/check-accepted-divergences.test.mjs +130 -0
  267. package/.bkit/templates/scripts/ci/lanes/resolve-push-base.mjs +98 -0
  268. package/.bkit/templates/scripts/ci/lanes/resolve-push-base.test.mjs +86 -0
  269. package/.bkit/templates/scripts/graphify/bkit-graph-drift-rules.json +23 -0
  270. package/.bkit/templates/scripts/graphify/bkit-graph-drift.py +208 -0
  271. package/.bkit/templates/scripts/graphify/bkit-graph-eager-rules.json +35 -0
  272. package/.bkit/templates/scripts/graphify/bkit-graph-eager.py +236 -0
  273. package/.bkit/templates/scripts/graphify/bkit-graph-external-rules.json +17 -0
  274. package/.bkit/templates/scripts/graphify/bkit-graph-imports.py +290 -0
  275. package/.bkit/templates/scripts/graphify/bkit-graph-pre-push.sh +19 -0
  276. package/.bkit/templates/scripts/graphify/bkit-graph-repair.py +120 -0
  277. package/.bkit/templates/scripts/graphify/bkit-graph-surface.py +232 -0
  278. package/.bkit/templates/scripts/graphify/bkit-graphify-graphml.py +36 -0
  279. package/.bkit/templates/scripts/graphify/bkit-graphify-rollup.py +927 -0
  280. package/.bkit/templates/scripts/graphify/bkit-graphify.sh +351 -0
  281. package/.bkit/templates/scripts/launchd/ai.bkit.launchd.plist +26 -0
  282. package/.bkit/templates/scripts/launchd/bkit-launchd-env.sh +53 -0
  283. package/.bkit/templates/scripts/launchd/launchd.env.example +13 -0
  284. package/.bkit/templates/scripts/prettier/bkit-insert-ignore.mjs +275 -0
  285. package/.bkit/templates/scripts/secrets/bkit-secrets.config.mjs +66 -0
  286. package/.bkit/templates/scripts/secrets/bkit-secrets.mjs +785 -0
  287. package/.bkit/templates/scripts/serena/bkit-serena-mcp.sh +30 -0
  288. package/.bkit/templates/scripts/serena/bkit-serena.mcp.json +9 -0
  289. package/.bkit/templates/scripts/slop/bkit-slop-type-suppression.mjs +286 -0
  290. package/.bkit/templates/slop-scan.config.json +120 -0
  291. package/CHANGELOG.md +1503 -0
  292. package/LICENSE.md +161 -0
  293. package/README.md +184 -2
  294. package/dist/checks/after/auth.js +140 -0
  295. package/dist/checks/after/ci-yml.js +681 -0
  296. package/dist/checks/after/github.js +400 -0
  297. package/dist/checks/after/index.js +431 -0
  298. package/dist/checks/after/managed.js +187 -0
  299. package/dist/checks/after/suppression.js +39 -0
  300. package/dist/checks/after/tools.js +351 -0
  301. package/dist/checks/before/context-fetch.js +426 -0
  302. package/dist/checks/before/env.js +163 -0
  303. package/dist/checks/before/files.js +187 -0
  304. package/dist/checks/before/index.js +162 -0
  305. package/dist/checks/before/mcp.js +111 -0
  306. package/dist/checks/before/repo.js +71 -0
  307. package/dist/checks/before/version.js +60 -0
  308. package/dist/checks/status-holes.js +393 -0
  309. package/dist/cli.js +688 -0
  310. package/dist/commands/analysis.js +325 -0
  311. package/dist/commands/ci/ci.js +438 -0
  312. package/dist/commands/comply.js +310 -0
  313. package/dist/commands/harvest.js +354 -0
  314. package/dist/commands/install/check.js +61 -0
  315. package/dist/commands/install/doctor.js +209 -0
  316. package/dist/commands/install/install.js +475 -0
  317. package/dist/commands/install/uninstall.js +839 -0
  318. package/dist/commands/install/upgrade.js +782 -0
  319. package/dist/commands/launch.js +118 -0
  320. package/dist/commands/lib.js +363 -0
  321. package/dist/commands/registry.js +50 -0
  322. package/dist/commands/setup/setup.js +158 -0
  323. package/dist/commands/telemetry.js +29 -0
  324. package/dist/commands/workflow/branches.js +1265 -0
  325. package/dist/commands/workflow/context.js +846 -0
  326. package/dist/commands/workflow/counters.js +227 -0
  327. package/dist/commands/workflow/fids.js +224 -0
  328. package/dist/commands/workflow/issues.js +585 -0
  329. package/dist/commands/workflow/ledgers.js +472 -0
  330. package/dist/commands/workflow/locks.js +364 -0
  331. package/dist/commands/workflow/prs.js +904 -0
  332. package/dist/commands/workflow/repo.js +199 -0
  333. package/dist/commands/workflow/roadmap.js +495 -0
  334. package/dist/commands/workflow/runs.js +1717 -0
  335. package/dist/commands/workflow/runtime.js +257 -0
  336. package/dist/commands/workflow/skills.js +110 -0
  337. package/dist/commands/workflow/status.js +392 -0
  338. package/dist/commands/workflow/steps.js +1093 -0
  339. package/dist/commands/workflow/tests.js +144 -0
  340. package/dist/commands/workflow/workflows.js +1342 -0
  341. package/dist/commands/workflow/workstreams.js +141 -0
  342. package/dist/commands/workflow/worktrees.js +473 -0
  343. package/dist/install/cloud-env.js +818 -0
  344. package/dist/install/managed-block.js +182 -0
  345. package/dist/install/manifest.js +376 -0
  346. package/dist/install/modules/claude.js +288 -0
  347. package/dist/install/modules/cloud.js +151 -0
  348. package/dist/install/modules/codex.js +193 -0
  349. package/dist/install/modules/core.js +531 -0
  350. package/dist/install/modules/cursor.js +186 -0
  351. package/dist/install/modules/index.js +152 -0
  352. package/dist/install/modules/opencode.js +504 -0
  353. package/dist/install/payload-links.js +119 -0
  354. package/dist/install/placeholders.js +87 -0
  355. package/dist/install/template-copies.js +106 -0
  356. package/dist/install/version-file.js +204 -0
  357. package/dist/install/write.js +342 -0
  358. package/dist/ledgers/clamp-log.js +27 -0
  359. package/dist/ledgers/status.js +156 -0
  360. package/dist/ledgers/telemetry.js +637 -0
  361. package/dist/render/hosts.js +339 -0
  362. package/dist/render/models.js +288 -0
  363. package/dist/render/parts.js +33 -0
  364. package/dist/render/trackers.js +135 -0
  365. package/dist/shared/egress.js +299 -0
  366. package/dist/shared/json.js +16 -0
  367. package/dist/shared/log-prefix.js +7 -0
  368. package/dist/shared/package-json.js +22 -0
  369. package/dist/shared/package-manager.js +32 -0
  370. package/dist/shared/package-roots.js +145 -0
  371. package/dist/shared/protected-paths.js +153 -0
  372. package/dist/shared/settings.js +44 -0
  373. package/dist/shared/timeouts.js +19 -0
  374. package/dist/tools/wording.js +680 -0
  375. package/package.json +101 -4
@@ -0,0 +1,550 @@
1
+ // commands/install/install.ts — `bkit install` and `bkit check`: preflight, module dispatch,
2
+ // post-install checks. Check runs the same pipeline in dry-run mode.
3
+
4
+ import * as fs from "node:fs";
5
+ import * as path from "node:path";
6
+ import { OPENCODE_PROVIDERS } from "../../shared/egress.js";
7
+ import { type ModuleFlag, type CloudVariant } from "../../cli.js";
8
+ import { getPkgRoot } from "../../shared/package-roots.js";
9
+ import { type ModuleContext, dispatchModules } from "../../install/modules/index.js";
10
+ import {
11
+ type IssueTracker,
12
+ DEFAULT_ISSUE_TRACKER,
13
+ parseIssueTracker,
14
+ type ModuleName,
15
+ } from "../../install/manifest.js";
16
+ import { LOG_PREFIX, setLogPrefix } from "../../shared/log-prefix.js";
17
+ import type { ParsedArgs } from "../../cli.js";
18
+ import { detectInstalledModules, reportCheckDrift } from "./check.js";
19
+ import { runPreflight } from "../../checks/before/index.js";
20
+ import {
21
+ formatChecklist,
22
+ readChangelogVersionDelta,
23
+ runPostInstallCheck,
24
+ writeAdvisoriesArtifact,
25
+ } from "../../checks/after/index.js";
26
+ import type { SuppressionNote } from "../../checks/after/suppression.js";
27
+ import { findMissingOwnedHooks, detectOwnedHookMissing } from "../../checks/after/managed.js";
28
+ import { resolveTokens } from "../../install/placeholders.js";
29
+ import {
30
+ type EffortMap,
31
+ parseModelLookup,
32
+ applyModelOverrides,
33
+ buildOpencodeModelLookup,
34
+ parseEffortMap,
35
+ } from "../../render/models.js";
36
+ import { getBkitDocsRoot } from "../../shared/package-roots.js";
37
+ import type { WriteSet } from "../../install/write.js";
38
+ import { type UninstallContext, runUninstall } from "./uninstall.js";
39
+
40
+ // ---------------------------------------------------------------------------
41
+ // Staging scratch area
42
+ //
43
+ // `.bkit-staging/` is a per-run SCRATCH area: modules render derived files there
44
+ // (e.g. opencode.json) before comparing/merging into the consumer destination.
45
+ // runInstall Phase 2 cleans it up after every dispatch — success or failure —
46
+ // via `finally { discardAllStaging() }`. Dispatch writes module files directly to
47
+ // their destinations and is NOT atomic across modules; `bkit install` is idempotent,
48
+ // so re-running completes a partial install.
49
+ // ---------------------------------------------------------------------------
50
+
51
+ /** Staging root dir (relative to cwd). */
52
+ export const STAGING_ROOT = ".bkit-staging";
53
+
54
+ /**
55
+ * Discard ALL staging dirs under STAGING_ROOT (cleanup on mid-install failure).
56
+ */
57
+ export function discardAllStaging(cwd = process.cwd()): void {
58
+ const stagingRoot = path.join(cwd, STAGING_ROOT);
59
+ if (fs.existsSync(stagingRoot)) {
60
+ fs.rmSync(stagingRoot, { recursive: true, force: true });
61
+ }
62
+ }
63
+
64
+ /**
65
+ * The installed opencode provider, or exit(1) with the fix.
66
+ *
67
+ * `bkit check` / `bkit upgrade` take no `--opencode=` flag, so they read the provider the
68
+ * consumer actually installed (package.json `bkit.opencodeProvider`, else the opencode.json
69
+ * provider block). There is no default: a repo carrying `.opencode/` with no recorded
70
+ * provider is a broken install.
71
+ *
72
+ * Call ONLY on a path already known to need the opencode host, never speculatively.
73
+ */
74
+ export function requireOpencodeProvider(cwd: string, context: string): string {
75
+ const detected = detectOpencodeProvider(cwd);
76
+ if (!detected) {
77
+ console.error(
78
+ `${LOG_PREFIX} ${context}: the opencode host is installed but no provider is recorded ` +
79
+ `(package.json \`bkit.opencodeProvider\` and .opencode/opencode.json are both silent). ` +
80
+ `Re-run \`bkit install --opencode=<provider>\` — one of ${OPENCODE_PROVIDERS.join(", ")}.`,
81
+ );
82
+ process.exit(1);
83
+ }
84
+ return detected;
85
+ }
86
+
87
+ /**
88
+ * Read the installing bkit version from the package root's package.json.
89
+ * Returns "0.0.0" when unreadable (e.g. dev tree without a package.json at the
90
+ * resolved root) — keeps the advisories artifact informational, not fatal.
91
+ */
92
+ export function getInstallingVersion(): string {
93
+ try {
94
+ const pkgJsonPath = path.join(getPkgRoot(), "package.json");
95
+ if (fs.existsSync(pkgJsonPath)) {
96
+ const pkg = JSON.parse(fs.readFileSync(pkgJsonPath, "utf-8")) as { version?: string };
97
+ return pkg.version ?? "0.0.0";
98
+ }
99
+ } catch {
100
+ return "0.0.0"; // best-effort: unreadable/garbled package.json
101
+ }
102
+ return "0.0.0";
103
+ }
104
+
105
+ /**
106
+ * Render a resolved module set back into valid CLI flags for
107
+ * recovery-hint text. Skips core (implicit) and spells opt-ins with their value flags.
108
+ */
109
+ export function modulesToCliFlags(
110
+ mods: Set<ModuleFlag>,
111
+ opencodeProvider: string | null,
112
+ cloudVariant: CloudVariant | null,
113
+ ): string {
114
+ const out: string[] = [];
115
+ if (mods.has("claude")) out.push("--claude");
116
+ if (mods.has("cursor")) out.push("--cursor");
117
+ if (mods.has("opencode")) out.push(`--opencode=${opencodeProvider ?? "<provider>"}`);
118
+ if (mods.has("codex")) out.push("--codex");
119
+ if (mods.has("cloud")) out.push(`--auto=${cloudVariant ?? "<variant>"}`);
120
+ return out.join(" ");
121
+ }
122
+
123
+ /**
124
+ * Symmetric cloud/tracker constraint (FINAL SCOPE decision 3/4): cloud=claude and
125
+ * cloud=opencode both require tracker=github (both use the bkit-cloud.yml template);
126
+ * cloud=cursor requires tracker=linear. Mismatch is a hard error — checked BEFORE
127
+ * any package.json write so no state is recorded on mismatch ("no files written
128
+ * on hard error" invariant). Returns the error message to print, or `null` when
129
+ * the tracker matches (or no cloud module/variant is in play).
130
+ */
131
+ export function validateCloudTrackerMatch(
132
+ cloudVariant: CloudVariant | null,
133
+ hasCloudModule: boolean,
134
+ issueTracker: IssueTracker,
135
+ ): string | null {
136
+ if (cloudVariant === null || !hasCloudModule) return null;
137
+ const requiredTracker: IssueTracker = cloudVariant === "cursor" ? "linear" : "github";
138
+ if (issueTracker === requiredTracker) return null;
139
+ return (
140
+ `[bkit] --auto=${cloudVariant} requires tracker=${requiredTracker}, ` +
141
+ `but the resolved tracker is "${issueTracker}". ` +
142
+ (issueTracker === DEFAULT_ISSUE_TRACKER || issueTracker === "none"
143
+ ? `Set the tracker first: bkit install --tracker=${requiredTracker} --auto=${cloudVariant}`
144
+ : `Re-run with the matching tracker: bkit install --tracker=${requiredTracker} --auto=${cloudVariant} (tracker switching is free).`)
145
+ );
146
+ }
147
+
148
+ /**
149
+ * Detect the bkit opencode provider key a consumer installed.
150
+ *
151
+ * Resolution order:
152
+ * 1. `package.json` `bkit.opencodeProvider` — the authoritative record written on install.
153
+ * This is the ONLY signal for managed-auth gateways (opencode) whose opencode.json carries no
154
+ * custom provider block.
155
+ * 2. `.opencode/opencode.json` first provider key — for installs without the manifest field
156
+ * (the block is keyed by provider id, matching renderOpencodeJson).
157
+ * 3. null — caller falls back to the install default so the model lookup still resolves.
158
+ *
159
+ * The manifest value is validated against the allowlist so a hand-edited package.json cannot
160
+ * smuggle an unsupported provider into the render path.
161
+ */
162
+ export function detectOpencodeProvider(cwd: string): string | null {
163
+ const pkgPath = path.join(cwd, "package.json");
164
+ if (fs.existsSync(pkgPath)) {
165
+ try {
166
+ const pkg = JSON.parse(fs.readFileSync(pkgPath, "utf-8")) as {
167
+ bkit?: { opencodeProvider?: unknown };
168
+ };
169
+ const stored = pkg.bkit?.opencodeProvider;
170
+ if (
171
+ typeof stored === "string" &&
172
+ (OPENCODE_PROVIDERS as readonly string[]).includes(stored)
173
+ ) {
174
+ return stored;
175
+ }
176
+ } catch {
177
+ // unparseable package.json — fall through to opencode.json detection
178
+ }
179
+ }
180
+ const jsonPath = path.join(cwd, ".opencode", "opencode.json");
181
+ if (!fs.existsSync(jsonPath)) return null;
182
+ try {
183
+ const cfg = JSON.parse(fs.readFileSync(jsonPath, "utf-8")) as {
184
+ provider?: Record<string, unknown>;
185
+ };
186
+ if (cfg.provider && typeof cfg.provider === "object") {
187
+ const first = Object.keys(cfg.provider)[0];
188
+ if (!first) return null;
189
+ // Zen's opencode.json block is keyed by the built-in id `opencode`, not the CLI key.
190
+ return first === "opencode" ? "opencode-zen" : first;
191
+ }
192
+ } catch {
193
+ return null; // unparseable opencode.json — fall back to the default provider
194
+ }
195
+ return null;
196
+ }
197
+
198
+ /**
199
+ * Returns all bkit-installed opencode providers from the consumer package.json
200
+ * `bkit.opencodeProviders` array, filtered to valid OPENCODE_PROVIDERS entries; [] when
201
+ * the field is absent.
202
+ */
203
+ export function detectOpencodeProviders(cwd: string): string[] {
204
+ const pkgPath = path.join(cwd, "package.json");
205
+ if (!fs.existsSync(pkgPath)) return [];
206
+ try {
207
+ const pkg = JSON.parse(fs.readFileSync(pkgPath, "utf-8")) as {
208
+ bkit?: { opencodeProviders?: unknown };
209
+ };
210
+ const arr = pkg.bkit?.opencodeProviders;
211
+ if (Array.isArray(arr)) {
212
+ return arr.filter(
213
+ (v): v is string =>
214
+ typeof v === "string" && (OPENCODE_PROVIDERS as readonly string[]).includes(v),
215
+ );
216
+ }
217
+ } catch {
218
+ // unparseable — return empty
219
+ }
220
+ return [];
221
+ }
222
+
223
+ /** `bkit install`, and `bkit check` (the same pipeline, dry-run). */
224
+ export async function runInstall(
225
+ args: Pick<
226
+ ParsedArgs,
227
+ "verb" | "modules" | "tracker" | "cloudVariant" | "opencodeProvider" | "uninstallFlags"
228
+ >,
229
+ ): Promise<void> {
230
+ const { verb, modules, tracker, cloudVariant, opencodeProvider, uninstallFlags } = args;
231
+ const dryRun = verb === "check";
232
+ if (dryRun) setLogPrefix("[bkit-check]");
233
+
234
+ if (dryRun) console.log(`${LOG_PREFIX} Running in check (dry-run) mode`);
235
+
236
+ // `bkit check` scopes drift detection to what is INSTALLED (detected by sentinel files),
237
+ // not to a fixed full set. `install` keeps its explicit resolved set.
238
+ const effectiveModules = verb === "check" ? detectInstalledModules(process.cwd()) : modules;
239
+
240
+ // RENDER-input provider resolution. `bkit check` takes no `--opencode=` flag, so the parsed
241
+ // `opencodeProvider` is null on the check path; it falls back to the INSTALLED provider
242
+ // (package.json `bkit.opencodeProvider`, else the opencode.json provider block). On install
243
+ // `?? detect` never fires: opencode joins the module set only when `--opencode=<provider>`
244
+ // was given. The PARSED `opencodeProvider` alone drives the persist-to-package.json logic
245
+ // below (gated on `!dryRun` + a real flag). The tracker is resolved from package.json below,
246
+ // so the tracker-dependent opencode mcp block renders the same way on check.
247
+ const renderOpencodeProvider = opencodeProvider ?? detectOpencodeProvider(process.cwd());
248
+
249
+ // Resolve issueTracker: --tracker= flag overrides; else read bkit.issueTracker from consumer
250
+ // package.json; else default to "none".
251
+ // A `--tracker=` value always applies, whether first-set or a re-set of an
252
+ // already-recorded tracker.
253
+ // Resolved BEFORE preflight: preflight's tracker-dependent detectors grade the tracker
254
+ // this run INSTALLS, not the one on disk from the previous run. Read-only — no writes here.
255
+ let issueTracker: IssueTracker = DEFAULT_ISSUE_TRACKER;
256
+ {
257
+ const consumerPkgPath = path.join(process.cwd(), "package.json");
258
+ if (fs.existsSync(consumerPkgPath)) {
259
+ try {
260
+ const pkg = JSON.parse(fs.readFileSync(consumerPkgPath, "utf-8")) as Record<
261
+ string,
262
+ unknown
263
+ >;
264
+ const bkitField = pkg.bkit as Record<string, unknown> | undefined;
265
+ const stored = parseIssueTracker(bkitField?.issueTracker);
266
+ if (stored !== null) issueTracker = stored;
267
+ } catch {
268
+ // non-fatal — keep default
269
+ }
270
+ }
271
+ if (tracker !== null) issueTracker = tracker;
272
+ }
273
+
274
+ // --- Phase 1: Preflight (read-only, before any writes) ---
275
+ // Must run BEFORE resolveTokens to short-circuit cleanly on blockers.
276
+ const { blockers, advisories: preflightAdvisories } = runPreflight(
277
+ effectiveModules,
278
+ process.cwd(),
279
+ undefined,
280
+ issueTracker,
281
+ );
282
+ if (blockers.length > 0) {
283
+ console.log(`${LOG_PREFIX} Preflight blockers detected — aborting.`);
284
+ const blockerBanner = formatChecklist(blockers);
285
+ if (blockerBanner) console.log(blockerBanner);
286
+ process.exit(1);
287
+ }
288
+
289
+ // Resolve tokens once for the whole install
290
+ const tokens = await resolveTokens(process.cwd()).catch((err: unknown) => {
291
+ console.error(`${LOG_PREFIX} Token resolution failed: ${(err as Error).message}`);
292
+ process.exit(1);
293
+ });
294
+
295
+ // Parse model lookup (needed for cursor transforms).
296
+ // DEFAULTS come from the PACKAGE's .bkit/prompts.md § Models (authoritative, matches the
297
+ // prompt files about to be installed).
298
+ // OVERRIDES come from the CONSUMER's installed .bkit/prompts.md `## Model Overrides`
299
+ // section (below `bkit:end`) — per-agent, per-provider, preserved across upgrades.
300
+ let modelLookup: Map<string, string> = new Map();
301
+ let opencodeModelLookup: Map<string, string> = new Map();
302
+ let codexModelLookup: Map<string, string> = new Map();
303
+ let effortMap: EffortMap = new Map();
304
+ const promptsMdPath = path.join(getBkitDocsRoot(), "prompts.md");
305
+ const consumerPromptsMdPath = path.join(process.cwd(), ".bkit", "prompts.md");
306
+ if (fs.existsSync(promptsMdPath)) {
307
+ try {
308
+ modelLookup = parseModelLookup(promptsMdPath);
309
+ } catch {
310
+ // Not fatal — cursor module will fail per-file if a model is missing
311
+ }
312
+ // Consumer overrides merge after the base parse — parseModelOverrides is internally
313
+ // guarded (returns [] when the file/section is absent), so it needs no catch here.
314
+ applyModelOverrides(modelLookup, "cursor", consumerPromptsMdPath);
315
+ if (effectiveModules.has("opencode")) {
316
+ // On install `--opencode=<provider>` already set this; on check it comes from what the
317
+ // consumer installed. Either way the opencode host cannot render without a real one.
318
+ const provider =
319
+ renderOpencodeProvider ?? requireOpencodeProvider(process.cwd(), "opencode render");
320
+ try {
321
+ opencodeModelLookup = buildOpencodeModelLookup(promptsMdPath, provider);
322
+ } catch {
323
+ // Not fatal — opencode module will fail per-file if a model is missing
324
+ }
325
+ applyModelOverrides(opencodeModelLookup, provider, consumerPromptsMdPath);
326
+ }
327
+ if (effectiveModules.has("codex")) {
328
+ // Codex is nullary — one gateway (`openai`), so there is nothing to detect.
329
+ try {
330
+ codexModelLookup = buildOpencodeModelLookup(promptsMdPath, "openai");
331
+ } catch {
332
+ // Not fatal — codex module will fail per-file if a model is missing
333
+ }
334
+ applyModelOverrides(codexModelLookup, "openai", consumerPromptsMdPath);
335
+ }
336
+ effortMap = parseEffortMap(promptsMdPath);
337
+ }
338
+
339
+ // Seed preflight advisories into ctx so modules can accumulate into the same list.
340
+ const advisories: import("../../checks/before/index.js").PreflightFinding[] = [
341
+ ...preflightAdvisories,
342
+ ];
343
+
344
+ const ws: WriteSet = { writes: [] };
345
+ const postDispatch: Array<() => void> = [];
346
+
347
+ // Symmetric cloud/tracker constraint (FINAL SCOPE decision 3/4) — see
348
+ // validateCloudTrackerMatch for the full rationale. Checked BEFORE any
349
+ // package.json write so no state is recorded on mismatch.
350
+ const cloudTrackerError = validateCloudTrackerMatch(
351
+ cloudVariant,
352
+ modules.has("cloud"),
353
+ issueTracker,
354
+ );
355
+ if (cloudTrackerError) {
356
+ console.error(cloudTrackerError);
357
+ process.exit(1);
358
+ }
359
+ if (cloudVariant !== null && modules.has("cloud")) {
360
+ // auto=opencode additionally requires the local opencode host to be installed first
361
+ // (the cloud job runs against the committed .opencode/ — no model is hard-coded in YAML).
362
+ if (cloudVariant === "opencode" && !fs.existsSync(path.join(process.cwd(), ".opencode"))) {
363
+ console.error(
364
+ `[bkit] --auto=opencode requires the local opencode host to be installed first.\n` +
365
+ `Run: bkit install --opencode=<provider> (e.g. --opencode=opencode-zen)\n` +
366
+ `The cloud opencode job runs against the committed .opencode/ config — without it there is nothing to run.`,
367
+ );
368
+ process.exit(1);
369
+ }
370
+ }
371
+
372
+ // Persist bkit manifest fields to consumer package.json AFTER all hard-error gates pass.
373
+ // This preserves the "no files written on mismatch" invariant. Two fields are recorded:
374
+ // - issueTracker: when a `--tracker=` value was given this run.
375
+ // - opencodeProvider: when an `--opencode=<provider>` value was given this run. This is
376
+ // the authoritative provider record detectOpencodeProvider reads on upgrade — REQUIRED
377
+ // for managed-auth gateways (opencode), whose opencode.json carries no provider block to
378
+ // detect from. Both are merged in one read-modify-write to avoid double-writing.
379
+ const persistTracker = tracker !== null;
380
+ const persistProvider = opencodeProvider !== null && effectiveModules.has("opencode");
381
+ if ((persistTracker || persistProvider) && !dryRun) {
382
+ const consumerPkgPath2 = path.join(process.cwd(), "package.json");
383
+ if (fs.existsSync(consumerPkgPath2)) {
384
+ try {
385
+ const raw = fs.readFileSync(consumerPkgPath2, "utf-8");
386
+ const pkg = JSON.parse(raw) as Record<string, unknown>;
387
+ const bkit = (pkg.bkit ?? {}) as Record<string, unknown>;
388
+ if (persistTracker) bkit.issueTracker = tracker;
389
+ if (persistProvider) {
390
+ bkit.opencodeProvider = opencodeProvider; // active (drives agent frontmatter)
391
+ // Update providers array (deduped).
392
+ const existingArr: string[] = Array.isArray(bkit.opencodeProviders)
393
+ ? [...(bkit.opencodeProviders as string[])]
394
+ : [];
395
+ if (!existingArr.includes(opencodeProvider!)) {
396
+ existingArr.push(opencodeProvider!);
397
+ }
398
+ bkit.opencodeProviders = existingArr;
399
+ }
400
+ pkg.bkit = bkit;
401
+ const indentMatch = raw.match(/\n([ \t]+)"/);
402
+ const indent = indentMatch ? indentMatch[1] : " ";
403
+ const trailingNewline = raw.endsWith("\n") ? "\n" : "";
404
+ fs.writeFileSync(
405
+ consumerPkgPath2,
406
+ JSON.stringify(pkg, null, indent) + trailingNewline,
407
+ "utf-8",
408
+ );
409
+ if (persistTracker) {
410
+ console.log(`${LOG_PREFIX} Set bkit.issueTracker = "${tracker}" in package.json`);
411
+ }
412
+ if (persistProvider) {
413
+ console.log(
414
+ `${LOG_PREFIX} Set bkit.opencodeProvider = "${opencodeProvider}" and updated bkit.opencodeProviders in package.json`,
415
+ );
416
+ }
417
+ } catch {
418
+ // non-fatal
419
+ }
420
+ }
421
+ }
422
+
423
+ const ctx: ModuleContext = {
424
+ dryRun,
425
+ tokens,
426
+ modelLookup,
427
+ opencodeModelLookup,
428
+ codexModelLookup,
429
+ effortMap,
430
+ opencodeProvider: renderOpencodeProvider,
431
+ advisories,
432
+ ws,
433
+ logPrefix: LOG_PREFIX,
434
+ postDispatch,
435
+ issueTracker,
436
+ cloudVariant,
437
+ // Stamped into every rendered agent + command as the managed-version marker.
438
+ version: getInstallingVersion(),
439
+ };
440
+
441
+ // --- Phase 2: Install (current behaviour — dispatch modules) ---
442
+ // check dispatches the detected installed set; install dispatches the resolved set.
443
+ //
444
+ // `.bkit-staging/` is a per-run scratch area for rendered files (e.g. opencode.json) — NOT a
445
+ // cross-module commit/rollback transaction. Module fns write directly to their consumer
446
+ // destinations, so a mid-dispatch failure can leave files already written (postDispatch — the
447
+ // `.bkit/version` pin — does not run). The error is surfaced, never swallowed, and the scratch
448
+ // dir is always cleaned up. `bkit install` is idempotent, so re-running completes a partial
449
+ // install. See README § Install staging directory.
450
+ try {
451
+ dispatchModules(effectiveModules, ctx);
452
+ } finally {
453
+ discardAllStaging();
454
+ }
455
+
456
+ const totalWrites = ws.writes.length;
457
+
458
+ // Done banner first so the line count is easy to find above the checklist.
459
+ // For check, "would occur" makes intent explicit; for install, writes already happened.
460
+ if (dryRun) {
461
+ console.log(`${LOG_PREFIX} ${totalWrites} write(s) would occur.`);
462
+ } else {
463
+ console.log(`${LOG_PREFIX} Done. ${totalWrites} write(s).`);
464
+ }
465
+
466
+ // Phase 2 has completed its writes. Re-run Phase 1 detection and use its result for the
467
+ // post-install checklist, so the banner reflects the state on disk AFTER the writes.
468
+ // Otherwise a drift finding Phase 2 just resolved (tier2-json-drift, tier2-text-drift,
469
+ // bkit-version-pin-stale) is still reported as unresolved, contradicting the "Done"
470
+ // banner above. `check` (dryRun) wrote nothing, so its Phase 1 findings already describe
471
+ // the current state and are kept as-is. Module-accumulated advisories (pushed during
472
+ // dispatch) are preserved; only the Phase 1 seeds are replaced, in their original order.
473
+ if (!dryRun) {
474
+ const moduleAdvisories = advisories.slice(preflightAdvisories.length);
475
+ const { advisories: freshPreflightAdvisories } = runPreflight(
476
+ effectiveModules,
477
+ process.cwd(),
478
+ undefined,
479
+ issueTracker,
480
+ );
481
+ ctx.advisories = [...freshPreflightAdvisories, ...moduleAdvisories];
482
+ }
483
+
484
+ // --- Phase 3: Post-install checks (re-detect + unified output) ---
485
+ // Runs for both install AND check — detectors are read-only, so check produces
486
+ // the same advisory set as install would emit against the same filesystem state.
487
+ // Changelog version-delta header (A7): surface what changed in the installed version.
488
+ try {
489
+ const pkgJsonPath = path.join(getPkgRoot(), "package.json");
490
+ if (fs.existsSync(pkgJsonPath)) {
491
+ const pkg = JSON.parse(fs.readFileSync(pkgJsonPath, "utf-8")) as { version?: string };
492
+ const deltaHeader = readChangelogVersionDelta(pkg.version ?? "");
493
+ if (deltaHeader) console.log(deltaHeader);
494
+ }
495
+ } catch (err) {
496
+ void err; // Non-fatal — changelog header is informational
497
+ }
498
+ const suppressed: SuppressionNote[] = [];
499
+ const postFindings = runPostInstallCheck(ctx.advisories, process.cwd(), suppressed);
500
+ // check only: install has just written every hook file of the modules it dispatched, and a
501
+ // missing bkit-cloud-bootstrap.sh after `install --claude` is not that run's fault.
502
+ const missingHooks = dryRun ? findMissingOwnedHooks(process.cwd(), effectiveModules) : [];
503
+ const missingHooksFinding = detectOwnedHookMissing(missingHooks);
504
+ if (missingHooksFinding) postFindings.push(missingHooksFinding);
505
+ const banner = formatChecklist(postFindings, suppressed);
506
+ if (banner) console.log(banner);
507
+ writeAdvisoriesArtifact(postFindings, {
508
+ cwd: process.cwd(),
509
+ mode: dryRun ? "check" : "install",
510
+ version: getInstallingVersion(),
511
+ logPrefix: LOG_PREFIX,
512
+ suppressed,
513
+ });
514
+
515
+ // Check mode: exit 1 on drift (see reportCheckDrift).
516
+ if (dryRun) {
517
+ reportCheckDrift(postFindings, totalWrites, missingHooks);
518
+ return;
519
+ }
520
+
521
+ // P2.T9: exit-1 on Phase 3 blockers + recovery action text.
522
+ // Blockers in Phase 3 are actionable hard-fails (e.g. gh-bkit-token gap in CI).
523
+ // Advisory findings are informational only and do NOT exit-1.
524
+ const phase3Blockers = postFindings.filter((f) => f.severity === "blocker");
525
+ if (phase3Blockers.length > 0) {
526
+ const recoveryFlags = modulesToCliFlags(effectiveModules, opencodeProvider, cloudVariant);
527
+ const recoveryLine = `pnpm bkit uninstall ${recoveryFlags} && <fix the issue> && pnpm bkit install ${recoveryFlags}`;
528
+ console.error(
529
+ `${LOG_PREFIX} ${phase3Blockers.length} Phase 3 blocker(s) detected. Recovery:\n ${recoveryLine}`,
530
+ );
531
+ // P2.T10: --auto-revert: run uninstall in-process before exit-1
532
+ if (uninstallFlags.autoRevert) {
533
+ console.log(`${LOG_PREFIX} --auto-revert: reverting install...`);
534
+ const uninstallCtx: UninstallContext = {
535
+ cwd: process.cwd(),
536
+ dryRun: false,
537
+ // force: true — auto-revert must delete byte-equal-text files (e.g. .bkit/version)
538
+ // that were just written in this install run. Without force, the hash guard keeps
539
+ // any of them whose hash `.bkit/version` does not record.
540
+ force: true,
541
+ nuke: false,
542
+ yes: true,
543
+ logPrefix: "[bkit-uninstall]",
544
+ };
545
+ await runUninstall([...effectiveModules] as ModuleName[], uninstallCtx);
546
+ console.log(`${LOG_PREFIX} --auto-revert: uninstall complete. Exiting 1.`);
547
+ }
548
+ process.exit(1);
549
+ }
550
+ }