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