@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,187 @@
1
+ // checks/before/files.ts — consumer files bkit shares: `.gitignore` block duplicates, a hostile
2
+ // Playwright reporter, managed-text and managed-JSON drift.
3
+ import * as fs from "node:fs";
4
+ import * as path from "node:path";
5
+ import { deepContains } from "../../install/write.js";
6
+ import { extractManagedBlock, stripManagedBlock } from "../../install/managed-block.js";
7
+ import { readTemplate } from "../../render/parts.js";
8
+ import { findTemplateSource, getPkgRoot } from "../../shared/package-roots.js";
9
+ import { parseJson } from "../../shared/json.js";
10
+ /**
11
+ * Strip out content inside bkit-managed block markers (HTML and slash style).
12
+ * Used by detectors that need to inspect only consumer-owned content.
13
+ *
14
+ * Uses line-anchored marker detection (via stripManagedBlock from install/managed-block.ts; KN-8).
15
+ * Applies both marker styles sequentially: `<!-- bkit:start -->` and `// bkit:start`.
16
+ */
17
+ export function stripBkitBlock(content) {
18
+ return stripManagedBlock(stripManagedBlock(content, "html-comment"), "slash-comment");
19
+ }
20
+ /**
21
+ * Detect when a line bkit's .gitignore managed block contributes is already
22
+ * present elsewhere in the file. Benign (git ignores duplicates) but worth
23
+ * surfacing — the bkit-managed block should be the single source of truth.
24
+ */
25
+ const BKIT_GITIGNORE_LINES = [
26
+ ".worktrees/",
27
+ "docs/plans/*/logs/**/raw/",
28
+ "docs/plans/*/logs/**/.lock",
29
+ ".husky/_",
30
+ ".bkit/advisories.md",
31
+ ".bkit/.env",
32
+ ".bkit/core",
33
+ ".bkit/shared",
34
+ ];
35
+ export function detectGitignoreBlockDuplicates(cwd) {
36
+ const gitignorePath = path.join(cwd, ".gitignore");
37
+ if (!fs.existsSync(gitignorePath))
38
+ return null;
39
+ const content = fs.readFileSync(gitignorePath, "utf-8");
40
+ const outsideBkit = stripBkitBlock(content);
41
+ const outsideLines = outsideBkit
42
+ .split("\n")
43
+ .map((l) => l.trim())
44
+ .filter(Boolean);
45
+ const dupes = BKIT_GITIGNORE_LINES.filter((bl) => outsideLines.includes(bl));
46
+ if (dupes.length === 0)
47
+ return null;
48
+ return {
49
+ id: "gitignore-block-duplicates",
50
+ severity: "advisory",
51
+ detect: `.gitignore lists [${dupes.join(", ")}] both inside the bkit-managed block and outside it (consumer-owned region).`,
52
+ action: `Git ignores duplicates harmlessly, but cleaner to remove the consumer-side line(s) so the bkit-managed block is the single source of truth. Affected lines: ${dupes.join(", ")}.`,
53
+ };
54
+ }
55
+ // ---------------------------------------------------------------------------
56
+ // Phase 1 JSON advisories / blockers (BAR-167)
57
+ // ---------------------------------------------------------------------------
58
+ // ---------------------------------------------------------------------------
59
+ // [verbose ci] marker advisories (BAR-224)
60
+ // ---------------------------------------------------------------------------
61
+ // No presence detector for the bkit-ci.yml verbose-CI `env:`: bkit-ci.yml is the
62
+ // consumer's copy of a template, so bkit never checks it.
63
+ /**
64
+ * Advisory: consumer's Playwright invocation passes `--reporter=line`, which
65
+ * overrides the configured reporter chain in `playwright.config.ts`. Under
66
+ * `[verbose ci]` with `--trace=on`, this writes trace artifacts that no reporter
67
+ * surfaces — pure cost (artifact upload + storage) with zero diagnostic payoff.
68
+ *
69
+ * "Hostile" gap per the BAR-224 signal-vs-noise classification. Reads the consumer's
70
+ * own bkit-ci.yml, active lines only: YAML comment lines are dropped first, so a commented
71
+ * template stub or a commented-out example never fires.
72
+ */
73
+ export function detectPlaywrightReporterHostile(cwd) {
74
+ const ciPath = path.join(cwd, ".github", "workflows", "bkit-ci.yml");
75
+ if (!fs.existsSync(ciPath))
76
+ return null;
77
+ const content = fs.readFileSync(ciPath, "utf-8");
78
+ // Filter out YAML comment lines (those starting with optional whitespace + `#`) before
79
+ // matching: bkit-shipped commented stubs and commented-out consumer examples never fire.
80
+ // Not `stripBkitBlock`: its strict line-anchored marker detection misses indented YAML
81
+ // markers.
82
+ const activeContent = content
83
+ .split("\n")
84
+ .filter((line) => !/^\s*#/.test(line))
85
+ .join("\n");
86
+ // Match a literal `playwright test` invocation followed (anywhere) by `--reporter=line`.
87
+ // Both substrings must appear in active (non-comment) content. Heuristic but conservative.
88
+ if (!/playwright\s+test/.test(activeContent))
89
+ return null;
90
+ if (!/--reporter[= ]line\b/.test(activeContent))
91
+ return null;
92
+ return {
93
+ id: "playwright-reporter-line-override-hostile",
94
+ severity: "advisory",
95
+ detect: ".github/workflows/bkit-ci.yml has a `playwright test` invocation that passes `--reporter=line`. Under `[verbose ci]` with `--trace=on`, trace artifacts are written but no reporter surfaces them — pure cost.",
96
+ action: 'Drop the `--reporter=line` flag so `playwright.config.ts`\'s configured reporter chain runs (typically `[list, html, github, json]`). Verbose-aware pattern: have `test:e2e` read `VERBOSE_CI` and append `--trace=on` to its own `playwright test` call (e.g. `TRACE=; [ "$VERBOSE_CI" = "1" ] && TRACE=--trace=on; playwright test $TRACE`), then run it plainly as `pnpm test:e2e` — do NOT pass `--trace=on` through a turbo / pnpm `-- --trace=on` passthrough, which appends to the script string and breaks any test:e2e ending in a bash construct (fi / done / esac). Never pass `--reporter`. Note that `--video` and `--screenshot` are NOT Playwright CLI flags (they\'re `use:` keys in playwright.config.ts); the trace.zip already captures snapshots / network / console / source. Default-mode output stays clean via the config\'s `list` reporter.',
97
+ };
98
+ }
99
+ /**
100
+ * Advisory: detect when a JSON file is missing content the template owns.
101
+ * Runs deepContains(template, consumerFile) — fires when ok=false.
102
+ * Severity: advisory.
103
+ */
104
+ export function detectTier2JsonDrift(cwd, relPath) {
105
+ const absPath = path.join(cwd, relPath);
106
+ const templatePath = findTemplateSource(relPath);
107
+ if (!fs.existsSync(absPath) || templatePath === null || !fs.existsSync(templatePath))
108
+ return null;
109
+ // Malformed JSON on either side is handled elsewhere; a parse failure is not drift.
110
+ const consumerParsed = parseJson(fs.readFileSync(absPath, "utf-8"));
111
+ const templateParsed = parseJson(fs.readFileSync(templatePath, "utf-8"));
112
+ if (!consumerParsed.ok || !templateParsed.ok)
113
+ return null;
114
+ const consumerDoc = consumerParsed.value;
115
+ const templateDoc = templateParsed.value;
116
+ const result = deepContains(templateDoc, consumerDoc);
117
+ if (result.ok)
118
+ return null;
119
+ const details = [
120
+ ...result.missing.map((p) => `missing: ${p}`),
121
+ ...result.mismatched.map((p) => `mismatched: ${p}`),
122
+ ]
123
+ .slice(0, 5)
124
+ .join("; ");
125
+ return {
126
+ id: `tier2-json-drift`,
127
+ severity: "advisory",
128
+ detect: `${relPath} is missing bkit-owned content: ${details}.`,
129
+ action: "Run `pnpm bkit install` to restore the bkit-owned scope. Consumer-only keys outside the template tree will be preserved.",
130
+ };
131
+ }
132
+ /**
133
+ * Advisory: detect when a markered-text file's bkit-managed block is missing a line the
134
+ * template's block carries.
135
+ *
136
+ * Fires when the consumer file and the template both carry a bkit-managed block and the
137
+ * consumer block lacks a required template line. A consumer file without markers is
138
+ * consumer-owned and never flagged. Content outside the markers is never compared.
139
+ */
140
+ export function detectTier2TextDrift(cwd, relPath) {
141
+ const absPath = path.join(cwd, relPath);
142
+ const templatePath = findTemplateSource(relPath);
143
+ if (!fs.existsSync(absPath) || templatePath === null || !fs.existsSync(templatePath))
144
+ return null;
145
+ const templateBlock = extractManagedBlock(readTemplate(templatePath));
146
+ if (templateBlock === null)
147
+ return null;
148
+ const consumerBlock = extractManagedBlock(fs.readFileSync(absPath, "utf-8"));
149
+ if (consumerBlock === null)
150
+ return null;
151
+ // Significant lines = load-bearing block content: non-blank, non-comment, trimmed (indentation
152
+ // is not semantic). Comment lines never trip drift.
153
+ const significantLines = (body) => body
154
+ .split("\n")
155
+ .map((l) => l.trim())
156
+ .filter((t) => t !== "" && !t.startsWith("#") && !t.startsWith("//") && !t.startsWith("<!--"));
157
+ // A required line is real bkit content the consumer must retain. A bare YAML mapping key (`env:`)
158
+ // is structural scaffolding. A `{{TOKEN}}` line renders per-consumer, so it can never be matched
159
+ // literally. Neither counts as content for drift. (`${{ … }}` is a GitHub Actions expression,
160
+ // NOT a bkit token — the negative lookbehind keeps those enforced.)
161
+ const isStructural = (line) => /^[A-Za-z0-9_.-]+:$/.test(line);
162
+ const hasBkitToken = (line) => /(?<!\$)\{\{[^}]+\}\}/.test(line);
163
+ // Subset / presence: the block drifts only if the consumer is MISSING a required bkit line.
164
+ // Extras, reordering, re-indentation and comments are all fine.
165
+ const consumerLines = new Set(significantLines(consumerBlock));
166
+ const dropped = significantLines(templateBlock).filter((l) => !isStructural(l) && !hasBkitToken(l) && !consumerLines.has(l));
167
+ if (dropped.length === 0)
168
+ return null;
169
+ return {
170
+ id: "tier2-text-drift",
171
+ severity: "advisory",
172
+ detect: `${relPath} has a bkit-managed block missing ${dropped.length} line(s) of the shipped template.`,
173
+ action: `Re-sync the bkit-managed block in ${relPath} from ${path.relative(getPkgRoot(), templatePath)} ` +
174
+ "(run `pnpm bkit install`, or copy the block between its `bkit:start`/`bkit:end` markers). " +
175
+ "Content outside the markers is preserved.",
176
+ };
177
+ }
178
+ /**
179
+ * Consumer files whose bkit-managed blocks `detectTier2TextDrift` compares (partial
180
+ * ownership: bkit's block, the consumer's rest). Templates are the consumer's files and
181
+ * are never compared. Exported so tests can reference it without duplication.
182
+ */
183
+ export const MARKERED_TEXT_DRIFT_PATHS = [
184
+ "AGENTS.md",
185
+ "CLAUDE.md",
186
+ ".gitignore",
187
+ ];
@@ -0,0 +1,162 @@
1
+ // checks/before/index.ts — Phase 1: read-only detection BEFORE any writes. runPreflight calls
2
+ // the detectors in this folder (one file per group of findings) in a fixed order.
3
+ // Nothing in checks/before/ imports install/modules/ — preflight is upstream of module dispatch.
4
+ //
5
+ // Allow-list for cross-module imports (BAR-167 Phase 1+2):
6
+ // readBkitVersion — from install/version-file.ts (version pin reader)
7
+ // deepContains — from install/write.ts (JSON containment primitive)
8
+ // extractManagedBlock — from install/managed-block.ts (marker block extraction)
9
+ // findTemplateSource — from shared/package-roots.ts (dest → payload source, the dotfile remap)
10
+ // parseIssueTracker — from install/manifest.ts (pure data, no cycle)
11
+ // readTemplate — from render/parts.ts (template with its shared parts spliced in)
12
+ import * as fs from "node:fs";
13
+ import * as path from "node:path";
14
+ import { getPkgRoot } from "../../shared/package-roots.js";
15
+ import { parseIssueTracker, DEFAULT_ISSUE_TRACKER, } from "../../install/manifest.js";
16
+ import { detectBkitNotOnPath, detectMalformedPackageJson, detectNoPackageJson, detectNotGitRepo, } from "./repo.js";
17
+ import { MARKERED_TEXT_DRIFT_PATHS, detectGitignoreBlockDuplicates, detectPlaywrightReporterHostile, detectTier2JsonDrift, detectTier2TextDrift, } from "./files.js";
18
+ import { detectBkitVersionMajorDowngrade, detectBkitVersionPinStale } from "./version.js";
19
+ import { detectContextFetchContextMissing, detectContextFetchMissing, detectContextFetchProvisionMissing, detectContextFetchSourceNotEnabled, } from "./context-fetch.js";
20
+ import { detectExtraMcpServers, detectMissingMcpServers } from "./mcp.js";
21
+ // ---------------------------------------------------------------------------
22
+ // Internal helper
23
+ // ---------------------------------------------------------------------------
24
+ // Deduplicate an array of findings by `id`, first occurrence wins.
25
+ export function dedupeById(findings) {
26
+ const seen = new Set();
27
+ return findings.filter((f) => {
28
+ if (seen.has(f.id))
29
+ return false;
30
+ seen.add(f.id);
31
+ return true;
32
+ });
33
+ }
34
+ // ---------------------------------------------------------------------------
35
+ // runPreflight — main Phase 1 entry point
36
+ // ---------------------------------------------------------------------------
37
+ /**
38
+ * Read `bkit.issueTracker` from the consumer's package.json.
39
+ * Returns the tracker value or the default ("none") when absent / unreadable.
40
+ * Internal helper — not exported; use runPreflight's `issueTracker` param.
41
+ */
42
+ function readConsumerIssueTrackerForPreflight(cwd) {
43
+ const pkgPath = path.join(cwd, "package.json");
44
+ if (!fs.existsSync(pkgPath))
45
+ return DEFAULT_ISSUE_TRACKER;
46
+ try {
47
+ const pkg = JSON.parse(fs.readFileSync(pkgPath, "utf-8"));
48
+ const bkitField = pkg.bkit;
49
+ const parsed = parseIssueTracker(bkitField?.issueTracker);
50
+ return parsed ?? DEFAULT_ISSUE_TRACKER;
51
+ }
52
+ catch {
53
+ return DEFAULT_ISSUE_TRACKER;
54
+ }
55
+ }
56
+ /**
57
+ * Run all Phase 1 (read-only) detectors.
58
+ * Returns deduplicated { blockers, advisories } — intra-phase dedup by id,
59
+ * first occurrence wins.
60
+ *
61
+ * cwd defaults to process.cwd(). Pass explicitly in tests.
62
+ * installingVersion: used by detectBkitVersionMajorDowngrade; defaults to the
63
+ * package's own version read from its package.json at runtime.
64
+ * issueTracker: when provided, narrows tracker-specific checks (e.g. MCP server
65
+ * requirements). When omitted, read from consumer's `bkit.issueTracker` in package.json.
66
+ *
67
+ * GitHub tracker gate: when `issueTracker === "github"`, the Linear preflight
68
+ * gate is a no-op — the GitHub gate is enforced by workflow Step 1 via MCP.
69
+ */
70
+ export function runPreflight(modules, cwd = process.cwd(), installingVersion, issueTracker) {
71
+ // Resolve installing version if not provided
72
+ let version = installingVersion;
73
+ if (!version) {
74
+ try {
75
+ const pkgJsonPath = path.join(getPkgRoot(), "package.json");
76
+ if (fs.existsSync(pkgJsonPath)) {
77
+ const pkg = JSON.parse(fs.readFileSync(pkgJsonPath, "utf-8"));
78
+ version = pkg.version ?? "0.0.0";
79
+ }
80
+ else {
81
+ version = "0.0.0";
82
+ }
83
+ }
84
+ catch {
85
+ version = "0.0.0";
86
+ }
87
+ }
88
+ // Resolve issueTracker: use provided value or read from consumer package.json.
89
+ // GitHub tracker gate: when issueTracker === "github", Linear preflight is a no-op
90
+ // (the GitHub gate is enforced by workflow Step 1 via MCP — hook is no-op).
91
+ const resolvedTracker = issueTracker ?? readConsumerIssueTrackerForPreflight(cwd);
92
+ const blockers = [];
93
+ const advisories = [];
94
+ // --- Blocker detectors ---
95
+ const noPackageJson = detectNoPackageJson(cwd);
96
+ if (noPackageJson)
97
+ blockers.push(noPackageJson);
98
+ const malformedPackageJson = detectMalformedPackageJson(cwd);
99
+ if (malformedPackageJson)
100
+ blockers.push(malformedPackageJson);
101
+ const notGitRepo = detectNotGitRepo(cwd, modules);
102
+ if (notGitRepo)
103
+ blockers.push(notGitRepo);
104
+ // --- Advisory detectors ---
105
+ // Phase 1: JSON containment drift advisory
106
+ for (const relPath of [".claude/settings.json", ".cursor/hooks.json"]) {
107
+ const driftAdvisory = detectTier2JsonDrift(cwd, relPath);
108
+ if (driftAdvisory)
109
+ advisories.push(driftAdvisory);
110
+ }
111
+ // Phase 2: markered-text block drift advisory (BAR-167)
112
+ for (const relPath of MARKERED_TEXT_DRIFT_PATHS) {
113
+ const textDriftAdvisory = detectTier2TextDrift(cwd, relPath);
114
+ if (textDriftAdvisory)
115
+ advisories.push(textDriftAdvisory);
116
+ }
117
+ const gitignoreDup = detectGitignoreBlockDuplicates(cwd);
118
+ if (gitignoreDup)
119
+ advisories.push(gitignoreDup);
120
+ const versionMajorDowngrade = detectBkitVersionMajorDowngrade(cwd, version);
121
+ if (versionMajorDowngrade)
122
+ advisories.push(versionMajorDowngrade);
123
+ const versionPinStale = detectBkitVersionPinStale(cwd);
124
+ if (versionPinStale)
125
+ advisories.push(versionPinStale);
126
+ // BAR-224: [verbose ci] marker advisories
127
+ const playwrightReporterHostile = detectPlaywrightReporterHostile(cwd);
128
+ if (playwrightReporterHostile)
129
+ advisories.push(playwrightReporterHostile);
130
+ const contextFetch = detectContextFetchMissing(cwd);
131
+ if (contextFetch)
132
+ advisories.push(contextFetch);
133
+ const contextFetchContext = detectContextFetchContextMissing(cwd);
134
+ if (contextFetchContext)
135
+ advisories.push(contextFetchContext);
136
+ const contextFetchSource = detectContextFetchSourceNotEnabled(cwd);
137
+ if (contextFetchSource)
138
+ advisories.push(contextFetchSource);
139
+ const contextFetchProvision = detectContextFetchProvisionMissing(cwd);
140
+ if (contextFetchProvision)
141
+ advisories.push(contextFetchProvision);
142
+ // bkit-not-on-path advisory — suggest the shell alias for local development.
143
+ const bkitNotOnPath = detectBkitNotOnPath();
144
+ if (bkitNotOnPath)
145
+ advisories.push(bkitNotOnPath);
146
+ // Missing MCP server advisory — one finding per missing required key, per file.
147
+ // Tracker-aware: when issueTracker === "github", only github MCP server is required
148
+ // (the Linear gate is a no-op on the GitHub tracker; the gate runs in workflow Step 1 via MCP).
149
+ // Extra MCP server advisory — one finding per bkit-managed server that the
150
+ // resolved tracker does not use (e.g. a stale `linear` entry under `github`).
151
+ for (const relPath of [".mcp.json", ".cursor/mcp.json"]) {
152
+ advisories.push(...detectMissingMcpServers(cwd, relPath, resolvedTracker));
153
+ advisories.push(...detectExtraMcpServers(cwd, relPath, resolvedTracker));
154
+ }
155
+ // [mcp-env] detectors run in Phase 3 (runPostInstallCheck in checks/after/index.ts),
156
+ // not here: the .bkit/.env.example scaffold exists only after writes. Detectors are
157
+ // exported from this file for the postinstall module.
158
+ return {
159
+ blockers: dedupeById(blockers),
160
+ advisories: dedupeById(advisories),
161
+ };
162
+ }
@@ -0,0 +1,111 @@
1
+ // checks/before/mcp.ts — the MCP servers the configured tracker needs: missing and extra.
2
+ import * as fs from "node:fs";
3
+ import * as path from "node:path";
4
+ import { parseJson } from "../../shared/json.js";
5
+ // ---------------------------------------------------------------------------
6
+ // Advisory: missing MCP server entries in .mcp.json / .cursor/mcp.json
7
+ // ---------------------------------------------------------------------------
8
+ /** Every MCP server key bkit manages; `requiredMcpServersForTracker` picks the required subset. */
9
+ const REQUIRED_MCP_SERVERS = ["linear", "github"];
10
+ /**
11
+ * Return the MCP server keys required for a given issue tracker.
12
+ *
13
+ * - `github` → only `github` MCP server required (Linear gate is a no-op on GitHub tracker).
14
+ * - `linear` → both `linear` and `github` required (Linear tracker still dispatches via GitHub PR).
15
+ * - `none` → `github` only (tracker calls are no-ops; GitHub surface still needed for PR ops).
16
+ */
17
+ export function requiredMcpServersForTracker(tracker) {
18
+ if (tracker === "github")
19
+ return ["github"];
20
+ if (tracker === "linear")
21
+ return ["linear", "github"];
22
+ return ["github"]; // none — only GitHub for PR surface
23
+ }
24
+ /**
25
+ * Advisory: one finding per missing required MCP server key in a given mcp.json file.
26
+ *
27
+ * Semantics:
28
+ * - File absent → return [] (the next install writes it)
29
+ * - File malformed → return [] (parse-failure is a different advisory class)
30
+ * - File present, mcpServers missing a required key → one advisory per missing key
31
+ * - File present, all required keys present → return []
32
+ *
33
+ * `issueTracker` selects which MCP servers are required.
34
+ *
35
+ * Follows `[context] Message` advisory format.
36
+ */
37
+ export function detectMissingMcpServers(cwd, relPath, issueTracker) {
38
+ const absPath = path.join(cwd, relPath);
39
+ if (!fs.existsSync(absPath))
40
+ return [];
41
+ const parsed = parseJson(fs.readFileSync(absPath, "utf-8"));
42
+ if (!parsed.ok || typeof parsed.value !== "object" || parsed.value === null)
43
+ return []; // malformed JSON — skip silently
44
+ const doc = parsed.value;
45
+ const mcpServers = doc.mcpServers !== null && typeof doc.mcpServers === "object" && !Array.isArray(doc.mcpServers)
46
+ ? doc.mcpServers
47
+ : null;
48
+ const requiredServers = requiredMcpServersForTracker(issueTracker);
49
+ const findings = [];
50
+ for (const key of requiredServers) {
51
+ if (mcpServers && Object.prototype.hasOwnProperty.call(mcpServers, key))
52
+ continue;
53
+ const urlHint = key === "linear"
54
+ ? `"url": "https://mcp.linear.app/mcp"`
55
+ : key === "github"
56
+ ? `"url": "https://api.githubcopilot.com/mcp/"`
57
+ : `"url": "<server-url>"`;
58
+ findings.push({
59
+ id: `mcp-missing-server-${key}-${relPath.replace(/[^a-z0-9]/gi, "-")}`,
60
+ severity: "advisory",
61
+ detect: `${relPath} is missing the ${key} MCP server in mcpServers.`,
62
+ action: `[mcp] ${relPath} is missing the ${key} MCP server. Add it to mcpServers: {"${key}": {${urlHint}}}`,
63
+ });
64
+ }
65
+ return findings;
66
+ }
67
+ /**
68
+ * Advisory: one finding per bkit-managed MCP server that is present in the file
69
+ * but NOT required by the resolved tracker (the symmetric counterpart to
70
+ * `detectMissingMcpServers`). Catches the stale-leftover case — e.g. a repo
71
+ * switched to `--tracker=github` but still carries the `linear` entry.
72
+ *
73
+ * Only flags servers bkit itself manages (`REQUIRED_MCP_SERVERS`). Consumer-added
74
+ * MCP servers (custom tooling, other providers) are never flagged for removal.
75
+ *
76
+ * Semantics:
77
+ * - File absent / malformed / no mcpServers → return []
78
+ * - bkit-managed server present but not in `requiredMcpServersForTracker(tracker)` → one advisory
79
+ *
80
+ * Follows `[context] Message` advisory format.
81
+ */
82
+ export function detectExtraMcpServers(cwd, relPath, issueTracker) {
83
+ const absPath = path.join(cwd, relPath);
84
+ if (!fs.existsSync(absPath))
85
+ return [];
86
+ const parsed = parseJson(fs.readFileSync(absPath, "utf-8"));
87
+ if (!parsed.ok || typeof parsed.value !== "object" || parsed.value === null)
88
+ return []; // malformed JSON — skip silently
89
+ const doc = parsed.value;
90
+ const mcpServers = doc.mcpServers !== null && typeof doc.mcpServers === "object" && !Array.isArray(doc.mcpServers)
91
+ ? doc.mcpServers
92
+ : null;
93
+ if (!mcpServers)
94
+ return [];
95
+ const allowed = requiredMcpServersForTracker(issueTracker);
96
+ const findings = [];
97
+ // Only consider servers bkit manages — never flag consumer-added MCP servers.
98
+ for (const key of REQUIRED_MCP_SERVERS) {
99
+ if (allowed.includes(key))
100
+ continue;
101
+ if (!Object.prototype.hasOwnProperty.call(mcpServers, key))
102
+ continue;
103
+ findings.push({
104
+ id: `mcp-extra-server-${key}-${relPath.replace(/[^a-z0-9]/gi, "-")}`,
105
+ severity: "advisory",
106
+ detect: `${relPath} has the ${key} MCP server but the ${issueTracker} tracker does not use it.`,
107
+ action: `[mcp] ${relPath} carries the ${key} MCP server, which is not used by the ${issueTracker} tracker. Remove the "${key}" entry from mcpServers.`,
108
+ });
109
+ }
110
+ return findings;
111
+ }
@@ -0,0 +1,71 @@
1
+ // checks/before/repo.ts — repo preconditions: package.json present and parseable, a git repo,
2
+ // bkit on PATH.
3
+ import * as fs from "node:fs";
4
+ import * as path from "node:path";
5
+ import { spawnSync } from "node:child_process";
6
+ import { isCloudOrCi } from "./env.js";
7
+ // ---------------------------------------------------------------------------
8
+ // Blocker detectors
9
+ // ---------------------------------------------------------------------------
10
+ export function detectNoPackageJson(cwd) {
11
+ if (fs.existsSync(path.join(cwd, "package.json")))
12
+ return null;
13
+ return {
14
+ id: "no-package-json",
15
+ severity: "blocker",
16
+ detect: "package.json not found in the current directory.",
17
+ action: "Run `npm init -y` to create a minimal package.json, or copy one from an existing project, then re-run `pnpm bkit install`.",
18
+ };
19
+ }
20
+ export function detectMalformedPackageJson(cwd) {
21
+ const pkgPath = path.join(cwd, "package.json");
22
+ if (!fs.existsSync(pkgPath))
23
+ return null;
24
+ try {
25
+ JSON.parse(fs.readFileSync(pkgPath, "utf-8"));
26
+ return null;
27
+ }
28
+ catch {
29
+ return {
30
+ id: "malformed-package-json",
31
+ severity: "blocker",
32
+ detect: "package.json exists but contains invalid JSON.",
33
+ action: "Fix the JSON syntax error in package.json (run `node -e \"JSON.parse(require('fs').readFileSync('package.json','utf8'))\"` to locate the error), then re-run `pnpm bkit install`.",
34
+ };
35
+ }
36
+ }
37
+ export function detectNotGitRepo(cwd, modules) {
38
+ if (!modules.has("core"))
39
+ return null;
40
+ if (fs.existsSync(path.join(cwd, ".git")))
41
+ return null;
42
+ return {
43
+ id: "not-git-repo",
44
+ severity: "blocker",
45
+ detect: "core install requested but .git/ directory not found — this is not a git repository.",
46
+ action: "Run `git init` to initialise a git repo, then re-run. bkit installs into a git repository — its managed .gitignore/.gitattributes blocks require one (core is implicit; there is no --core flag to omit).",
47
+ };
48
+ }
49
+ /**
50
+ * Advisory: `bkit` is not on PATH.
51
+ * bkit is a devDependency — without a shell alias, every invocation requires
52
+ * `pnpm bkit <verb>` or `pnpm exec bkit <verb>`. Suggest the one-line alias.
53
+ * Short-circuits in CI / cloud environments where the alias is irrelevant.
54
+ */
55
+ export function detectBkitNotOnPath() {
56
+ if (isCloudOrCi())
57
+ return null;
58
+ const result = spawnSync("which", ["bkit"], { encoding: "utf-8" });
59
+ if (result.status === 0 && result.stdout.trim())
60
+ return null;
61
+ return {
62
+ id: "bkit-not-on-path",
63
+ severity: "advisory",
64
+ detect: "`bkit` is not on PATH — commands must be run as `pnpm bkit <verb>` or `pnpm exec bkit <verb>`.",
65
+ action: "[bkit] Add a shell alias so you can type `bkit <verb>` directly. Add to ~/.zshrc (or ~/.bashrc), then reload:\n\n" +
66
+ " alias bkit='pnpm bkit'\n" +
67
+ " source ~/.zshrc\n\n" +
68
+ "For `bkit cursor` / `bkit opencode` (GUI app launchers), run from the repo root in\n" +
69
+ "an external terminal (Terminal.app / iTerm2) — not from inside the running app.",
70
+ };
71
+ }
@@ -0,0 +1,60 @@
1
+ // checks/before/version.ts — the `.bkit/version` pin against the installing version.
2
+ import * as path from "node:path";
3
+ import { readBkitVersion } from "../../install/version-file.js";
4
+ import { readPackageJson } from "../../shared/package-json.js";
5
+ // ---------------------------------------------------------------------------
6
+ // Advisory detectors
7
+ // ---------------------------------------------------------------------------
8
+ export function detectBkitVersionMajorDowngrade(cwd, installingVersion) {
9
+ const onDisk = readBkitVersion(path.join(cwd, ".bkit", "version"))?.pinnedVersion ?? "";
10
+ if (!onDisk)
11
+ return null; // absent / unparseable / no pin — guard against parseInt("") = NaN
12
+ const onDiskMajor = parseInt(onDisk.split(".")[0] ?? "0", 10);
13
+ const installingMajor = parseInt(installingVersion.split(".")[0] ?? "0", 10);
14
+ if (Number.isNaN(onDiskMajor) || Number.isNaN(installingMajor))
15
+ return null; // malformed version strings — no false advisory
16
+ if (onDiskMajor <= installingMajor)
17
+ return null;
18
+ return {
19
+ id: "bkit-version-major-downgrade",
20
+ severity: "advisory",
21
+ detect: `On-disk .bkit/version major (${onDiskMajor}) is greater than the installing version major (${installingMajor}). This is a major-version downgrade.`,
22
+ action: `If this is intentional, proceed. Otherwise, check your @cbartens/bkit version pin in package.json and ensure you're installing the intended version. Current on-disk: ${onDisk}, installing: ${installingVersion}.`,
23
+ };
24
+ }
25
+ export function detectBkitVersionPinStale(cwd) {
26
+ const read = readPackageJson(path.join(cwd, "node_modules", "@cbartens", "bkit"));
27
+ if (!read.ok)
28
+ return null;
29
+ const version = read.pkg["version"];
30
+ const installedVersion = typeof version === "string" ? version : "";
31
+ const onDiskVersion = readBkitVersion(path.join(cwd, ".bkit", "version"))?.pinnedVersion ?? "";
32
+ if (!installedVersion || !onDiskVersion)
33
+ return null;
34
+ // Compare semver: installed > onDisk → pin is stale
35
+ if (!semverGt(installedVersion, onDiskVersion))
36
+ return null;
37
+ return {
38
+ id: "bkit-version-pin-stale",
39
+ severity: "advisory",
40
+ detect: `node_modules/@cbartens/bkit version (${installedVersion}) is newer than .bkit/version (${onDiskVersion}). Consumer ran \`pnpm add -D @cbartens/bkit@${installedVersion}\` but did not re-run the bkit installer.`,
41
+ action: "Run `pnpm bkit upgrade` to resync the .agents payload + version pin across everything you have installed, then commit the result. `pnpm add` does not run the bkit installer — bkit's payload must be re-synced after every `@cbartens/bkit` version bump.",
42
+ };
43
+ }
44
+ // ---------------------------------------------------------------------------
45
+ // Internal semver comparison helper
46
+ // ---------------------------------------------------------------------------
47
+ /** Returns true if versionA > versionB (basic semver, no pre-release). */
48
+ function semverGt(a, b) {
49
+ const pa = a.replace(/^v/, "").split(".").map(Number);
50
+ const pb = b.replace(/^v/, "").split(".").map(Number);
51
+ for (let i = 0; i < 3; i++) {
52
+ const av = pa[i] ?? 0;
53
+ const bv = pb[i] ?? 0;
54
+ if (av > bv)
55
+ return true;
56
+ if (av < bv)
57
+ return false;
58
+ }
59
+ return false;
60
+ }