@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,424 @@
1
+ // checks/after/github.ts — GitHub repo settings and tracker setup: branch protection, Actions
2
+ // write permission, tracker choice, the projects toolset and project field ids, and the cloud
3
+ // auto-routing workflow.
4
+
5
+ import * as fs from "node:fs";
6
+ import * as path from "node:path";
7
+ import { execFileSync } from "node:child_process";
8
+ import type { PreflightFinding } from "../before/index.js";
9
+ import {
10
+ parseIssueTracker,
11
+ DEFAULT_ISSUE_TRACKER,
12
+ type IssueTracker,
13
+ parseCloudAgents,
14
+ DEFAULT_CLOUD_AGENTS,
15
+ type CloudAgents,
16
+ } from "../../install/manifest.js";
17
+ import type { TokenPresence } from "./auth.js";
18
+
19
+ /**
20
+ * Detect whether branch protection is configured on `main`.
21
+ * Returns "present" | "missing" | "unknown".
22
+ * "unknown" if gh CLI is unavailable, unauthenticated, or not a GitHub repo;
23
+ * "missing" if the API returns 404 (no protection rule); "present" otherwise.
24
+ */
25
+ export function detectMainBranchProtection(): TokenPresence {
26
+ try {
27
+ execFileSync("gh", ["api", "repos/{owner}/{repo}/branches/main/protection"], {
28
+ stdio: ["ignore", "pipe", "pipe"],
29
+ timeout: 5000,
30
+ });
31
+ return "present";
32
+ } catch (err) {
33
+ const stderr = (err as { stderr?: Buffer }).stderr?.toString() ?? "";
34
+ if (stderr.includes("Branch not protected") || stderr.includes("HTTP 404")) {
35
+ return "missing";
36
+ }
37
+ return "unknown";
38
+ }
39
+ }
40
+
41
+ /**
42
+ * Detect whether the repo's default GitHub Actions workflow permissions let the
43
+ * bkit-cloud.yml push status commits and open/merge PRs. Reads
44
+ * `repos/{owner}/{repo}/actions/permissions/workflow`:
45
+ * - default_workflow_permissions: "read" | "write"
46
+ * - can_approve_pull_request_reviews: boolean
47
+ * Returns "present" only when permissions are "write" AND PR creation/approval is
48
+ * allowed; "missing" otherwise; "unknown" if gh CLI is unavailable / unauthed.
49
+ * Repo-level only — org-level defaults are not reliably readable with a repo token
50
+ * (an org policy can still override a correct-looking repo setting).
51
+ */
52
+ export function detectActionsWritePermissions(): TokenPresence {
53
+ try {
54
+ const out = execFileSync("gh", ["api", "repos/{owner}/{repo}/actions/permissions/workflow"], {
55
+ encoding: "utf-8",
56
+ stdio: ["ignore", "pipe", "pipe"],
57
+ timeout: 5000,
58
+ });
59
+ const parsed = JSON.parse(out) as {
60
+ default_workflow_permissions?: string;
61
+ can_approve_pull_request_reviews?: boolean;
62
+ };
63
+ const canWrite = parsed.default_workflow_permissions === "write";
64
+ const canApprovePrs = parsed.can_approve_pull_request_reviews === true;
65
+ return canWrite && canApprovePrs ? "present" : "missing";
66
+ } catch {
67
+ return "unknown";
68
+ }
69
+ }
70
+
71
+ /**
72
+ * Read `bkit.issueTracker` from the consumer's package.json.
73
+ * Returns the tracker value or the default ("none") when absent / unreadable.
74
+ */
75
+ export function readConsumerIssueTracker(cwd: string): IssueTracker {
76
+ const pkgPath = path.join(cwd, "package.json");
77
+ if (!fs.existsSync(pkgPath)) return DEFAULT_ISSUE_TRACKER;
78
+ try {
79
+ const pkg = JSON.parse(fs.readFileSync(pkgPath, "utf-8")) as Record<string, unknown>;
80
+ const bkitField = pkg.bkit as Record<string, unknown> | undefined;
81
+ const parsed = parseIssueTracker(bkitField?.issueTracker);
82
+ return parsed ?? DEFAULT_ISSUE_TRACKER;
83
+ } catch {
84
+ return DEFAULT_ISSUE_TRACKER;
85
+ }
86
+ }
87
+
88
+ /**
89
+ * Emit a tracker-specific setup advisory.
90
+ *
91
+ * - `github` → GitHub tracker: MCP auth is browser OAuth — no PAT needed for tracker calls.
92
+ * - `linear` → existing Linear setup message (BKIT_LINEAR_API_KEY + LINEAR_ISSUE_ID).
93
+ * - `none` → prompt to run `bkit install --tracker=github` or `--tracker=linear`.
94
+ *
95
+ * Only fires when bkit workflows are installed (.claude/ or .cursor/ present).
96
+ */
97
+ export function buildTrackerSetupAdvisory(cwd: string): PreflightFinding | null {
98
+ const hasClaude = fs.existsSync(path.join(cwd, ".claude"));
99
+ const hasCursor = fs.existsSync(path.join(cwd, ".cursor"));
100
+ if (!hasClaude && !hasCursor) return null;
101
+
102
+ const tracker = readConsumerIssueTracker(cwd);
103
+
104
+ if (tracker === "github") {
105
+ return {
106
+ id: "tracker-setup-github",
107
+ severity: "advisory",
108
+ detect:
109
+ "bkit tracker is configured as `github`. GitHub Issues + Projects v2 is the active tracker.",
110
+ action:
111
+ "GitHub tracker: MCP auth is browser OAuth — run `gh auth login` once for CLI surface. No PAT needed for tracker calls. The GitHub MCP server uses OAuth automatically on first tool call. Ensure the `github` MCP server is configured in `.mcp.json` and `.cursor/mcp.json`.",
112
+ };
113
+ }
114
+
115
+ if (tracker === "linear") {
116
+ return {
117
+ id: "tracker-setup-linear",
118
+ severity: "advisory",
119
+ detect: "bkit tracker is configured as `linear`. Linear is the active tracker.",
120
+ action:
121
+ "Linear tracker: set `BKIT_LINEAR_API_KEY` in `.bkit/.env` (generate at https://linear.app/settings/api). `LINEAR_ISSUE_ID` is injected per-session by the Linear integration — do not hardcode. Run `direnv allow` after setting the key so MCP servers and the preflight hook can authenticate.",
122
+ };
123
+ }
124
+
125
+ // tracker === "none". Distinguish opt-out (explicit `bkit.issueTracker: "none"`)
126
+ // from undecided (field absent). An explicit `none` silences the nudge, as with the
127
+ // dep-updater advisory.
128
+ if (hasExplicitIssueTrackerField(cwd)) return null;
129
+
130
+ return {
131
+ id: "tracker-setup-none",
132
+ severity: "advisory",
133
+ detect:
134
+ "bkit tracker is not configured (`bkit.issueTracker` absent). Workflows run but every tracker call is a no-op.",
135
+ action:
136
+ 'Optional post-install decision. Run `bkit install --tracker=github` (recommended) or `bkit install --tracker=linear` to enable tracker integration. GitHub tracker uses browser OAuth — no PAT required. Linear tracker requires `BKIT_LINEAR_API_KEY` in `.bkit/.env`. To opt out and silence this advisory, set `bkit.issueTracker` to `"none"` in package.json.',
137
+ };
138
+ }
139
+
140
+ /** True when package.json has an explicit `bkit.issueTracker` field (any value). */
141
+ function hasExplicitIssueTrackerField(cwd: string): boolean {
142
+ const pkgPath = path.join(cwd, "package.json");
143
+ if (!fs.existsSync(pkgPath)) return false;
144
+ try {
145
+ const pkg = JSON.parse(fs.readFileSync(pkgPath, "utf-8")) as Record<string, unknown>;
146
+ const bkitField = pkg.bkit as Record<string, unknown> | undefined;
147
+ return bkitField !== undefined && bkitField.issueTracker !== undefined;
148
+ } catch {
149
+ return false;
150
+ }
151
+ }
152
+
153
+ /**
154
+ * Classify the `bkit.githubProject` board-sync config in package.json:
155
+ * - "configured" → object with at least `owner` + `number` (the lookup keys)
156
+ * - "opted-out" → set to `false` ("no board sync" — stay quiet)
157
+ * - "absent" → missing, malformed, or unreadable
158
+ */
159
+ function readGithubProjectConfig(cwd: string): "configured" | "opted-out" | "absent" {
160
+ const pkgPath = path.join(cwd, "package.json");
161
+ if (!fs.existsSync(pkgPath)) return "absent";
162
+ try {
163
+ const pkg = JSON.parse(fs.readFileSync(pkgPath, "utf-8")) as Record<string, unknown>;
164
+ const bkitField = pkg.bkit as Record<string, unknown> | undefined;
165
+ const gp = bkitField?.githubProject;
166
+ if (gp === false) return "opted-out";
167
+ if (gp && typeof gp === "object" && !Array.isArray(gp)) {
168
+ const obj = gp as Record<string, unknown>;
169
+ if (obj.owner !== undefined && obj.number !== undefined) return "configured";
170
+ }
171
+ return "absent";
172
+ } catch {
173
+ return "absent";
174
+ }
175
+ }
176
+
177
+ /**
178
+ * Inspect the root `.mcp.json` github server's `X-MCP-Toolsets` header for the
179
+ * `projects` toolset (required for Projects v2 board sync):
180
+ * - "present" → header lists `projects`
181
+ * - "missing" → github server has a toolset header that omits `projects`
182
+ * (installs predating the toolset addition)
183
+ * - "unknown" → no `.mcp.json`, no github server, or no header (can't judge)
184
+ *
185
+ * Scoped to root `.mcp.json` only — bkit omits the header from `.cursor/mcp.json`.
186
+ */
187
+ export function detectProjectsToolset(cwd: string): TokenPresence {
188
+ const mcpPath = path.join(cwd, ".mcp.json");
189
+ if (!fs.existsSync(mcpPath)) return "unknown";
190
+ try {
191
+ const cfg = JSON.parse(fs.readFileSync(mcpPath, "utf-8")) as Record<string, unknown>;
192
+ const servers = cfg.mcpServers as Record<string, unknown> | undefined;
193
+ const gh = servers?.github as Record<string, unknown> | undefined;
194
+ const headers = gh?.headers as Record<string, unknown> | undefined;
195
+ const toolsets = headers?.["X-MCP-Toolsets"];
196
+ if (typeof toolsets !== "string") return "unknown";
197
+ return toolsets
198
+ .split(",")
199
+ .map((s) => s.trim())
200
+ .includes("projects")
201
+ ? "present"
202
+ : "missing";
203
+ } catch {
204
+ return "unknown";
205
+ }
206
+ }
207
+
208
+ /**
209
+ * GitHub Projects v2 board-sync prerequisite advisory. Board status sync needs
210
+ * THREE things, none of which install seeds or verifies end-to-end:
211
+ * `bkit.githubProject` config, the `projects` MCP toolset, and an org-scoped
212
+ * Projects R/W PAT. Absent any of the first two (the detectable ones), board
213
+ * sync silently no-ops — `bkit.githubProject` alone is useless if the toolset
214
+ * lacks `projects`, and vice versa. Emits one advisory naming what's missing.
215
+ *
216
+ * Gates: workflows installed (.claude/ or .cursor/) AND tracker === "github".
217
+ * Stays quiet on explicit opt-out (`bkit.githubProject: false`) or when both
218
+ * detectable prerequisites are satisfied (PAT scope can't be checked locally).
219
+ */
220
+ export function buildGithubProjectAdvisory(cwd: string): PreflightFinding | null {
221
+ const hasClaude = fs.existsSync(path.join(cwd, ".claude"));
222
+ const hasCursor = fs.existsSync(path.join(cwd, ".cursor"));
223
+ if (!hasClaude && !hasCursor) return null;
224
+ if (readConsumerIssueTracker(cwd) !== "github") return null;
225
+
226
+ const configState = readGithubProjectConfig(cwd);
227
+ if (configState === "opted-out") return null;
228
+
229
+ const toolset = detectProjectsToolset(cwd);
230
+ const configOk = configState === "configured";
231
+ const toolsetOk = toolset === "present";
232
+ if (configOk && toolsetOk) return null;
233
+
234
+ const missing: string[] = [];
235
+ if (!configOk) missing.push("`bkit.githubProject` is absent from package.json");
236
+ if (toolset === "missing")
237
+ missing.push("the `projects` toolset is missing from `.mcp.json` `X-MCP-Toolsets`");
238
+ const missingPhrase = missing.length > 0 ? `: ${missing.join("; ")}` : "";
239
+
240
+ return {
241
+ id: "github-project-board-sync-unconfigured",
242
+ severity: "advisory",
243
+ detect:
244
+ `GitHub tracker is active but Projects v2 board status sync is not fully configured${missingPhrase}. ` +
245
+ "Board sync silently no-ops — workflows never reflect phase on the project board.",
246
+ action:
247
+ "Board status sync is optional (workflows never gate on it) but invisible when half-configured. All three prerequisites are required:\n\n" +
248
+ "1. Add `bkit.githubProject` to package.json (org-owned board only — fine-grained PATs cannot reach user-owned projects):\n\n" +
249
+ ' "bkit": {\n' +
250
+ ' "githubProject": {\n' +
251
+ ' "owner": "<org>", "number": <project-number>,\n' +
252
+ ' "statusFieldId": <numeric-field-id>, "progressOptionId": "<option-id>",\n' +
253
+ ' "reviewOptionId": "<option-id>", "doneOptionId": "<option-id>"\n' +
254
+ " }\n" +
255
+ " }\n\n" +
256
+ " Discover the ids: `gh api /orgs/<org>/projectsV2/<number>/fields --jq '.[] | select(.name==\"Status\")'` → the Status field's " +
257
+ "numeric `id` → `statusFieldId` (a JSON number, NOT quoted); each `options[].id` (e.g. `47fc9ee4`) → " +
258
+ "the option ids (quoted strings). `gh project field-list`'s `id` is the GraphQL node id (`PVTSSF_…`) " +
259
+ "and must NOT be used for `statusFieldId` — `projects_write` rejects it with " +
260
+ "`updated_field.id: value must be a number`.\n\n" +
261
+ "2. Ensure the root `.mcp.json` github server enables the `projects` toolset:\n\n" +
262
+ ' "X-MCP-Toolsets": "context,issues,pull_requests,repos,users,projects"\n\n' +
263
+ "3. The `BKIT_GH_TOKEN` PAT needs organization-scoped Projects read & write (repo scope is not enough).\n\n" +
264
+ "To opt out and silence this advisory, set `bkit.githubProject` to `false` in package.json.",
265
+ };
266
+ }
267
+
268
+ /**
269
+ * Static-validate the `statusFieldId` shape on an otherwise-configured board.
270
+ * Projects v2 board sync feeds `statusFieldId` straight into `projects_write`
271
+ * `updated_field.id`, which requires the NUMERIC field id; a GraphQL node id
272
+ * (`PVTSSF_…` — what `gh project field-list` returns) or any non-number value is
273
+ * rejected with `updated_field.id: value must be a number`, and best-effort sync then
274
+ * no-ops silently. Checked at install/check time, no network needed.
275
+ *
276
+ * Gates: workflows installed AND tracker === "github" AND `bkit.githubProject` is
277
+ * an object carrying `owner` + `number` (an otherwise-usable board) AND
278
+ * `statusFieldId` is present but not a JSON number. An absent `statusFieldId` is
279
+ * the setup advisory's job; opt-out (`false`) and absent config never reach here.
280
+ */
281
+ export function detectGithubProjectFieldIdFormat(cwd: string): PreflightFinding | null {
282
+ const hasClaude = fs.existsSync(path.join(cwd, ".claude"));
283
+ const hasCursor = fs.existsSync(path.join(cwd, ".cursor"));
284
+ if (!hasClaude && !hasCursor) return null;
285
+ if (readConsumerIssueTracker(cwd) !== "github") return null;
286
+
287
+ const pkgPath = path.join(cwd, "package.json");
288
+ if (!fs.existsSync(pkgPath)) return null;
289
+ let gp: Record<string, unknown> | undefined;
290
+ try {
291
+ const pkg = JSON.parse(fs.readFileSync(pkgPath, "utf-8")) as Record<string, unknown>;
292
+ const bkitField = pkg.bkit as Record<string, unknown> | undefined;
293
+ const raw = bkitField?.githubProject;
294
+ if (raw && typeof raw === "object" && !Array.isArray(raw)) gp = raw as Record<string, unknown>;
295
+ } catch {
296
+ return null;
297
+ }
298
+ // Only judge a board that is otherwise configured (owner + number present) and
299
+ // has a statusFieldId set — absent statusFieldId is handled by the setup advisory.
300
+ if (!gp || gp.owner === undefined || gp.number === undefined) return null;
301
+ const sfid = gp.statusFieldId;
302
+ if (sfid === undefined || typeof sfid === "number") return null; // absent or already correct
303
+
304
+ const looksLikeNodeId = typeof sfid === "string" && /^PVT/.test(sfid);
305
+ const shape = looksLikeNodeId
306
+ ? "a GraphQL node id (`PVTSSF_…`)"
307
+ : `a ${typeof sfid} (\`${String(sfid)}\`)`;
308
+
309
+ return {
310
+ id: "github-project-status-field-id-format",
311
+ severity: "advisory",
312
+ detect:
313
+ `\`bkit.githubProject.statusFieldId\` is ${shape}, but Projects v2 board sync feeds it to ` +
314
+ "`projects_write` `updated_field.id`, which requires the numeric field id and rejects anything " +
315
+ "else (`updated_field.id: value must be a number`). Board sync silently no-ops — the board never reflects phase.",
316
+ action:
317
+ "Re-derive the numeric Status field id and store it unquoted:\n\n" +
318
+ " gh api /orgs/<org>/projectsV2/<number>/fields --jq '.[] | select(.name==\"Status\")'\n\n" +
319
+ "The Status field's numeric `id` (e.g. `350038178`) → `statusFieldId` (a JSON number, NOT quoted); " +
320
+ "each `options[].id` (e.g. `47fc9ee4`) → the option ids (quoted strings). `gh project field-list`'s " +
321
+ "`id` is the GraphQL node id (`PVTSSF_…`) and must NOT be used for `statusFieldId`.",
322
+ };
323
+ }
324
+
325
+ /**
326
+ * Read `bkit.cloudAgents` from the consumer's package.json. Returns the value
327
+ * or the default ("none") when absent / unreadable.
328
+ */
329
+ export function readConsumerCloudAgents(cwd: string): CloudAgents {
330
+ const pkgPath = path.join(cwd, "package.json");
331
+ if (!fs.existsSync(pkgPath)) return DEFAULT_CLOUD_AGENTS;
332
+ try {
333
+ const pkg = JSON.parse(fs.readFileSync(pkgPath, "utf-8")) as Record<string, unknown>;
334
+ const bkitField = pkg.bkit as Record<string, unknown> | undefined;
335
+ const parsed = parseCloudAgents(bkitField?.cloudAgents);
336
+ return parsed ?? DEFAULT_CLOUD_AGENTS;
337
+ } catch {
338
+ return DEFAULT_CLOUD_AGENTS;
339
+ }
340
+ }
341
+
342
+ /** True when package.json has an explicit `bkit.cloudAgents` field (any value). */
343
+ function hasExplicitCloudAgentsField(cwd: string): boolean {
344
+ const pkgPath = path.join(cwd, "package.json");
345
+ if (!fs.existsSync(pkgPath)) return false;
346
+ try {
347
+ const pkg = JSON.parse(fs.readFileSync(pkgPath, "utf-8")) as Record<string, unknown>;
348
+ const bkitField = pkg.bkit as Record<string, unknown> | undefined;
349
+ return bkitField !== undefined && bkitField.cloudAgents !== undefined;
350
+ } catch {
351
+ return false;
352
+ }
353
+ }
354
+
355
+ /**
356
+ * Emit a cloud-agents setup advisory (parity with the tracker / dep-updater
357
+ * advisories). Post-CI auto-routing (`bkit-cloud.yml`) is opt-in via
358
+ * `bkit install --auto=claude`; it does NOT ship with a default install. This nudges
359
+ * consumers to make the choice post-install.
360
+ *
361
+ * Also performs the cloud=claude config-consistency assertion: when
362
+ * `bkit.cloudAgents === "claude"` but the installed `bkit-cloud.yml` lacks
363
+ * `id-token: write`, it surfaces a consistency warning (exit-1 signal surfaced via
364
+ * the `blocker` severity in the checks/before/index.ts caller).
365
+ *
366
+ * Resolution order (file presence is authoritative, package.json field is the
367
+ * opt-out):
368
+ * - `.github/workflows/bkit-cloud.yml` present → `cloud-router` (informational; active)
369
+ * - `bkit.cloudAgents === "none"` → null (opt-out — stay quiet)
370
+ * - otherwise (undecided) → `cloud-router-none` (nudge to choose)
371
+ *
372
+ * Only fires when there is a `.github/workflows/` dir (the router wakes on a CI
373
+ * completion event).
374
+ */
375
+ export function buildCloudSetupAdvisory(cwd: string): PreflightFinding | null {
376
+ const routerPath = path.join(cwd, ".github", "workflows", "bkit-cloud.yml");
377
+
378
+ if (fs.existsSync(routerPath)) {
379
+ // Config-consistency assertion: cloud=claude requires id-token: write.
380
+ // If the recorded variant is "claude" and the workflow file lacks id-token: write,
381
+ // surface a consistency finding.
382
+ const recordedVariant = readConsumerCloudAgents(cwd);
383
+ if (recordedVariant === "claude") {
384
+ const workflowContent = fs.readFileSync(routerPath, "utf-8");
385
+ if (!workflowContent.includes("id-token: write")) {
386
+ return {
387
+ id: "cloud-claude-missing-id-token",
388
+ severity: "blocker",
389
+ detect:
390
+ "`bkit.cloudAgents` is `claude` but `.github/workflows/bkit-cloud.yml` lacks `id-token: write`. `claude-code-action@v1` will fail at boot with an OIDC error.",
391
+ action:
392
+ "Re-run `pnpm bkit install --auto=claude --tracker=github` to regenerate the workflow with `id-token: write` and the App-auth framing. Also verify the Claude GitHub App is installed (`/install-github-app`). See bkit's `cloud.md` § Post-CI auto-routing.",
393
+ };
394
+ }
395
+ }
396
+
397
+ return {
398
+ id: "cloud-router",
399
+ severity: "advisory",
400
+ detect:
401
+ "Cloud agents: post-CI auto-routing is active (`.github/workflows/bkit-cloud.yml` present). The Claude GitHub App is required — run `/install-github-app` (Claude Code CLI) once if not already done.",
402
+ action: `The workflow requires: the \`ANTHROPIC_API_KEY\` repo secret, the Claude GitHub App (\`/install-github-app\`), and GitHub Actions write permissions (org AND repo). See the \`bkit-auto-setup\` advisory (emitted by \`bkit install --auto=claude\`) and bkit's \`cloud.md\` § Post-CI auto-routing for the full checklist.`,
403
+ };
404
+ }
405
+
406
+ // No router present — distinguish opt-out from undecided.
407
+ if (readConsumerCloudAgents(cwd) === "none" && hasExplicitCloudAgentsField(cwd)) {
408
+ return null; // consumer explicitly chose `none` — stay quiet
409
+ }
410
+
411
+ // Only nudge if there's a workflows dir for the router to wake on.
412
+ if (!fs.existsSync(path.join(cwd, ".github", "workflows"))) return null;
413
+
414
+ return {
415
+ id: "cloud-router-none",
416
+ severity: "advisory",
417
+ detect:
418
+ "Cloud agents: post-CI auto-routing is not configured. `.github/workflows/` exists but no `bkit-cloud.yml` — CI pass/fail does not auto-dispatch bkit-ship / bkit-debug.",
419
+ action:
420
+ "Optional post-install decision. For a GitHub-tracker repo: `pnpm bkit install --auto=claude --tracker=github`. For a Linear-tracker repo: `pnpm bkit install --auto=cursor --tracker=linear`.\n\n" +
421
+ "Prerequisites for `--auto=claude`: `ANTHROPIC_API_KEY` repo secret + Claude GitHub App (`/install-github-app`) + GitHub Actions write permissions.\n\n" +
422
+ 'To opt out and silence this advisory, set `bkit.cloudAgents` to `"none"` in package.json.',
423
+ };
424
+ }