@cbartens/bkit 6.1.1 → 6.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (313) hide show
  1. package/.bkit/README.md +14 -12
  2. package/.bkit/core/.agents/docs.md +1 -11
  3. package/.bkit/core/.agents/plugins/bkit/hooks/bkit-gateguard.cjs +30 -9
  4. package/.bkit/core/.agents/plugins/bkit/hooks/bkit-guardrails.cjs +25 -27
  5. package/.bkit/core/.agents/rules.md +22 -9
  6. package/.bkit/core/.bkit/README.md +13 -11
  7. package/.bkit/core/.bkit/authoring.md +58 -13
  8. package/.bkit/core/.bkit/cli.md +42 -32
  9. package/.bkit/core/.bkit/cloud.md +93 -30
  10. package/.bkit/core/.bkit/install.md +55 -16
  11. package/.bkit/core/.bkit/jsonl.md +24 -7
  12. package/.bkit/core/.bkit/pipeline.md +8 -8
  13. package/.bkit/core/.bkit/prompts.md +160 -43
  14. package/.bkit/core/.bkit/providers.md +97 -36
  15. package/.bkit/core/.bkit/templates.md +162 -34
  16. package/.bkit/core/.bkit/trackers.md +39 -6
  17. package/.bkit/core/.bkit/workflows.md +344 -136
  18. package/.bkit/core/.claude/hooks/bkit-guardrails.cjs +50 -27
  19. package/.bkit/core/.claude/hooks/bkit-preflight.sh +11 -11
  20. package/.bkit/core/.codex/hooks/bkit-gateguard.cjs +13 -8
  21. package/.bkit/core/.codex/hooks/bkit-guardrails.cjs +14 -25
  22. package/.bkit/core/.cursor/hooks/bkit-guardrails.cjs +20 -9
  23. package/.bkit/core/.cursor/hooks/bkit-preflight.sh +8 -8
  24. package/.bkit/core/.opencode/plugin/bkit-gateguard.js +14 -4
  25. package/.bkit/core/.opencode/plugin/bkit-guardrails.js +114 -0
  26. package/.bkit/core/docs/templates/bkit-audit-accessibility.md +1 -1
  27. package/.bkit/core/docs/templates/bkit-audit-adoption.md +30 -6
  28. package/.bkit/core/docs/templates/bkit-audit-agents.md +1 -1
  29. package/.bkit/core/docs/templates/bkit-audit-aio-seo.md +1 -1
  30. package/.bkit/core/docs/templates/bkit-audit-analytics.md +1 -1
  31. package/.bkit/core/docs/templates/bkit-audit-annotations.md +1 -1
  32. package/.bkit/core/docs/templates/bkit-audit-app-performance.md +1 -1
  33. package/.bkit/core/docs/templates/bkit-audit-app-store.md +1 -1
  34. package/.bkit/core/docs/templates/bkit-audit-architecture.md +1 -1
  35. package/.bkit/core/docs/templates/bkit-audit-ci-performance.md +2 -2
  36. package/.bkit/core/docs/templates/bkit-audit-config.md +3 -2
  37. package/.bkit/core/docs/templates/bkit-audit-cost.md +1 -1
  38. package/.bkit/core/docs/templates/bkit-audit-coverage.md +1 -1
  39. package/.bkit/core/docs/templates/bkit-audit-database.md +3 -3
  40. package/.bkit/core/docs/templates/bkit-audit-dead-code.md +1 -1
  41. package/.bkit/core/docs/templates/bkit-audit-deferrals.md +1 -1
  42. package/.bkit/core/docs/templates/bkit-audit-dependencies.md +3 -3
  43. package/.bkit/core/docs/templates/bkit-audit-documentation.md +32 -2
  44. package/.bkit/core/docs/templates/bkit-audit-duplication.md +1 -1
  45. package/.bkit/core/docs/templates/bkit-audit-failures.md +1 -1
  46. package/.bkit/core/docs/templates/bkit-audit-flakes.md +2 -2
  47. package/.bkit/core/docs/templates/bkit-audit-gates.md +5 -3
  48. package/.bkit/core/docs/templates/bkit-audit-issues.md +1 -1
  49. package/.bkit/core/docs/templates/bkit-audit-llm.md +2 -2
  50. package/.bkit/core/docs/templates/bkit-audit-logs.md +1 -1
  51. package/.bkit/core/docs/templates/bkit-audit-models.md +2 -2
  52. package/.bkit/core/docs/templates/bkit-audit-privacy.md +1 -1
  53. package/.bkit/core/docs/templates/bkit-audit-prompts.md +1 -1
  54. package/.bkit/core/docs/templates/bkit-audit-red-team.md +2 -2
  55. package/.bkit/core/docs/templates/bkit-audit-reliability.md +3 -2
  56. package/.bkit/core/docs/templates/bkit-audit-repo.md +1 -1
  57. package/.bkit/core/docs/templates/bkit-audit-security.md +1 -1
  58. package/.bkit/core/docs/templates/bkit-audit-slop.md +1 -1
  59. package/.bkit/core/docs/templates/bkit-audit-testing.md +3 -2
  60. package/.bkit/core/docs/templates/bkit-audit-usability.md +1 -1
  61. package/.bkit/core/docs/templates/bkit-plan.md +38 -8
  62. package/.bkit/core/engine/checks/after/auth.ts +118 -47
  63. package/.bkit/core/engine/checks/after/github.ts +89 -37
  64. package/.bkit/core/engine/checks/after/index.ts +15 -3
  65. package/.bkit/core/engine/checks/after/tools.ts +245 -1
  66. package/.bkit/core/engine/checks/before/files.ts +59 -1
  67. package/.bkit/core/engine/checks/before/index.ts +8 -0
  68. package/.bkit/core/engine/checks/status-holes.ts +20 -26
  69. package/.bkit/core/engine/checks/tips/catalogue.ts +107 -10
  70. package/.bkit/core/engine/checks/tips/detect.ts +36 -3
  71. package/.bkit/core/engine/checks/tips/index.ts +1 -1
  72. package/.bkit/core/engine/cli.ts +13 -13
  73. package/.bkit/core/engine/commands/ci/ci.ts +64 -11
  74. package/.bkit/core/engine/commands/ci/push-gate.ts +101 -43
  75. package/.bkit/core/engine/commands/install/install.ts +28 -25
  76. package/.bkit/core/engine/commands/install/uninstall.ts +42 -30
  77. package/.bkit/core/engine/commands/install/upgrade.ts +14 -2
  78. package/.bkit/core/engine/commands/land.ts +2 -3
  79. package/.bkit/core/engine/commands/lib.ts +394 -39
  80. package/.bkit/core/engine/commands/registry.ts +1 -1
  81. package/.bkit/core/engine/commands/workflow/branches.ts +351 -78
  82. package/.bkit/core/engine/commands/workflow/challenge.ts +63 -14
  83. package/.bkit/core/engine/commands/workflow/context.ts +71 -10
  84. package/.bkit/core/engine/commands/workflow/counters.ts +298 -23
  85. package/.bkit/core/engine/commands/workflow/decisions.ts +260 -125
  86. package/.bkit/core/engine/commands/workflow/disk.ts +2 -1
  87. package/.bkit/core/engine/commands/workflow/feature-base.ts +66 -0
  88. package/.bkit/core/engine/commands/workflow/issues.ts +312 -17
  89. package/.bkit/core/engine/commands/workflow/junit.ts +204 -0
  90. package/.bkit/core/engine/commands/workflow/ledgers.ts +904 -99
  91. package/.bkit/core/engine/commands/workflow/locks.ts +186 -29
  92. package/.bkit/core/engine/commands/workflow/loops.ts +87 -0
  93. package/.bkit/core/engine/commands/workflow/open-decision.ts +251 -0
  94. package/.bkit/core/engine/commands/workflow/plan-blocks.ts +8 -0
  95. package/.bkit/core/engine/commands/workflow/plans.ts +1 -1
  96. package/.bkit/core/engine/commands/workflow/prs.ts +311 -16
  97. package/.bkit/core/engine/commands/workflow/repo.ts +1 -1
  98. package/.bkit/core/engine/commands/workflow/run-facts.ts +6 -0
  99. package/.bkit/core/engine/commands/workflow/runs.ts +877 -174
  100. package/.bkit/core/engine/commands/workflow/runtime.ts +12 -4
  101. package/.bkit/core/engine/commands/workflow/status.ts +324 -11
  102. package/.bkit/core/engine/commands/workflow/step-table.ts +41 -15
  103. package/.bkit/core/engine/commands/workflow/steps.ts +604 -29
  104. package/.bkit/core/engine/commands/workflow/summary-findings.ts +1 -1
  105. package/.bkit/core/engine/commands/workflow/summary.ts +314 -8
  106. package/.bkit/core/engine/commands/workflow/tasks.ts +400 -27
  107. package/.bkit/core/engine/commands/workflow/tests-base.ts +319 -0
  108. package/.bkit/core/engine/commands/workflow/tests-changed.ts +138 -74
  109. package/.bkit/core/engine/commands/workflow/tests-jump.ts +93 -0
  110. package/.bkit/core/engine/commands/workflow/tests.ts +815 -182
  111. package/.bkit/core/engine/commands/workflow/tracker.ts +1134 -137
  112. package/.bkit/core/engine/commands/workflow/workflows.ts +100 -72
  113. package/.bkit/core/engine/commands/workflow/worktrees.ts +421 -57
  114. package/.bkit/core/engine/install/cloud-env.ts +38 -10
  115. package/.bkit/core/engine/install/managed-block.ts +105 -0
  116. package/.bkit/core/engine/install/manifest.ts +7 -1
  117. package/.bkit/core/engine/install/modules/claude.ts +6 -2
  118. package/.bkit/core/engine/install/modules/cloud.ts +84 -95
  119. package/.bkit/core/engine/install/modules/codex.ts +10 -2
  120. package/.bkit/core/engine/install/modules/core.ts +148 -14
  121. package/.bkit/core/engine/install/modules/opencode.ts +18 -23
  122. package/.bkit/core/engine/install/network-allowlist.ts +8 -3
  123. package/.bkit/core/engine/install/project-docs.ts +650 -0
  124. package/.bkit/core/engine/install/template-copies.ts +58 -5
  125. package/.bkit/core/engine/install/write.ts +128 -7
  126. package/.bkit/core/engine/ledgers/journal.ts +18 -10
  127. package/.bkit/core/engine/ledgers/migrate.ts +20 -8
  128. package/.bkit/core/engine/ledgers/status.ts +604 -8
  129. package/.bkit/core/engine/ledgers/telemetry.ts +115 -13
  130. package/.bkit/core/engine/render/trackers.ts +3 -1
  131. package/.bkit/core/engine/shared/package-manager.ts +7 -3
  132. package/.bkit/core/engine/shared/settings.ts +12 -1
  133. package/.bkit/core/engine/shared/text.ts +14 -0
  134. package/.bkit/core/engine/tools/instructions-sources.ts +1 -0
  135. package/.bkit/core/engine/tools/instructions.ts +116 -20
  136. package/.bkit/core/hooks/antigravity-hook.js +20 -4
  137. package/.bkit/core/hooks/gateguard-edit-payload.js +8 -5
  138. package/.bkit/core/hooks/gateguard-engine.js +249 -23
  139. package/.bkit/core/hooks/guardrails-deny.js +167 -0
  140. package/.bkit/core/hooks/guardrails-read.js +3 -3
  141. package/.bkit/core/hooks/guardrails-shell.js +1122 -167
  142. package/.bkit/core/hooks/guardrails-tiers.js +247 -176
  143. package/.bkit/core/hooks/preflight-tracker.sh +219 -0
  144. package/.bkit/core/prompts/bkit-audit-generate.md +23 -6
  145. package/.bkit/core/prompts/bkit-build-challenge-1.md +5 -4
  146. package/.bkit/core/prompts/bkit-build-challenge-2.md +6 -5
  147. package/.bkit/core/prompts/bkit-build-install-skills.md +2 -2
  148. package/.bkit/core/prompts/bkit-build-plan-convert.md +21 -7
  149. package/.bkit/core/prompts/bkit-build-plan-current.md +5 -4
  150. package/.bkit/core/prompts/bkit-build-plan-gaps-remediate.md +22 -17
  151. package/.bkit/core/prompts/bkit-build-plan-tasks.md +16 -12
  152. package/.bkit/core/prompts/bkit-build-plan-tests.md +14 -10
  153. package/.bkit/core/prompts/bkit-build-plan-verify.md +21 -8
  154. package/.bkit/core/prompts/bkit-debug-abort-handover.md +10 -5
  155. package/.bkit/core/prompts/bkit-debug-failure-diagnose.md +22 -6
  156. package/.bkit/core/prompts/bkit-debug-failure-remediate.md +19 -3
  157. package/.bkit/core/prompts/bkit-debug-failure-reproduce.md +22 -6
  158. package/.bkit/core/prompts/bkit-debug-failure-soak.md +10 -7
  159. package/.bkit/core/prompts/bkit-design-brainstorm-ideate-1.md +3 -3
  160. package/.bkit/core/prompts/bkit-design-brainstorm-ideate-2.md +4 -4
  161. package/.bkit/core/prompts/bkit-design-brainstorm-ideate-3.md +3 -3
  162. package/.bkit/core/prompts/bkit-design-generate.md +6 -4
  163. package/.bkit/core/prompts/bkit-design-organise.md +4 -3
  164. package/.bkit/core/prompts/bkit-design-review-1.md +5 -4
  165. package/.bkit/core/prompts/bkit-design-review-2.md +6 -5
  166. package/.bkit/core/prompts/bkit-design-spike.md +4 -3
  167. package/.bkit/core/prompts/bkit-design-update.md +6 -4
  168. package/.bkit/core/prompts/bkit-plan-generate.md +35 -14
  169. package/.bkit/core/prompts/bkit-plan-review-1.md +9 -7
  170. package/.bkit/core/prompts/bkit-plan-review-2.md +9 -7
  171. package/.bkit/core/prompts/bkit-plan-scope-check.md +8 -6
  172. package/.bkit/core/prompts/bkit-plan-update.md +22 -8
  173. package/.bkit/core/prompts/bkit-ship-conflict-resolve.md +11 -8
  174. package/.bkit/core/prompts/bkit-ship-deferred-sweep.md +9 -5
  175. package/.bkit/core/prompts/bkit-ship-update-docs.md +26 -4
  176. package/.bkit/core/prompts/bkit-utility-compress-markdown.md +3 -3
  177. package/.bkit/core/prompts/bkit-utility-update-decisions.md +10 -7
  178. package/.bkit/core/prompts/bkit-utility-update-deferrals.md +8 -5
  179. package/.bkit/core/prompts/bkit-utility-update-documentation.md +31 -7
  180. package/.bkit/core/prompts/bkit-utility-update-failures.md +8 -5
  181. package/.bkit/core/prompts/bkit-utility-update-knowledge.md +10 -7
  182. package/.bkit/core/prompts/bkit-utility-update-roadmap.md +4 -4
  183. package/.bkit/core/prompts/bkit-utility-update-tracker.md +4 -4
  184. package/.bkit/core/workflows/bkit-auto.md +23 -11
  185. package/.bkit/core/workflows/bkit-build.md +331 -100
  186. package/.bkit/core/workflows/bkit-debug.md +135 -64
  187. package/.bkit/core/workflows/bkit-design.md +58 -32
  188. package/.bkit/core/workflows/bkit-plan.md +73 -45
  189. package/.bkit/core/workflows/bkit-ship.md +233 -167
  190. package/.bkit/shared/.agents/plugins/bkit/hooks.json +1 -1
  191. package/.bkit/shared/.bkit/.env.example +5 -0
  192. package/.bkit/shared/.claude/bkit-cloud.md +7 -7
  193. package/.bkit/shared/.claude/settings.json +5 -1
  194. package/.bkit/shared/.cursor/bkit-cloud.md +1 -1
  195. package/.bkit/shared/.cursor/hooks.json +1 -1
  196. package/.bkit/shared/.opencode/opencode.json +11 -2
  197. package/.bkit/templates/.claude/hooks/bkit-cloud-bootstrap.sh +27 -0
  198. package/.bkit/templates/.cursor/Dockerfile +7 -7
  199. package/.bkit/templates/.github/ISSUE_TEMPLATE/bkit-idea.yml +1 -1
  200. package/.bkit/templates/.github/dependabot.yml +5 -0
  201. package/.bkit/templates/.github/renovate.json5 +5 -3
  202. package/.bkit/templates/.github/workflows/bkit-ci.yml +11 -11
  203. package/.bkit/templates/.github/workflows/bkit-cloud.yml +525 -161
  204. package/.bkit/templates/.github/workflows/bkit-renovate.yml +2 -2
  205. package/.bkit/templates/.husky/pre-push +123 -6
  206. package/.bkit/templates/context/bkit-serena.md +1 -1
  207. package/.bkit/templates/docs/architecture.md +98 -0
  208. package/.bkit/templates/docs/capabilities.md +33 -37
  209. package/.bkit/templates/docs/components.md +142 -0
  210. package/.bkit/templates/docs/data-schema.md +87 -0
  211. package/.bkit/{shared → templates}/docs/deployments.md +128 -142
  212. package/.bkit/templates/docs/design.md +117 -0
  213. package/.bkit/templates/docs/noise.md +54 -0
  214. package/.bkit/templates/docs/observability.md +99 -0
  215. package/.bkit/templates/docs/security.md +137 -0
  216. package/.bkit/templates/docs/setup.md +93 -0
  217. package/.bkit/templates/docs/technology.md +70 -0
  218. package/.bkit/{shared → templates}/docs/testing.md +200 -87
  219. package/.bkit/templates/scripts/ci/bkit-machine-lock.sh +511 -103
  220. package/.bkit/templates/scripts/ci/bkit-test-awake.mjs +228 -35
  221. package/.bkit/templates/scripts/ci/bkit-test-awake.test.mjs +270 -2
  222. package/.bkit/templates/scripts/graphify/bkit-graphify-graphml.py +1 -1
  223. package/.bkit/templates/scripts/graphify/bkit-graphify-rollup.py +92 -63
  224. package/.bkit/templates/scripts/graphify/bkit-graphify.sh +59 -11
  225. package/.bkit/templates/slop-scan.config.json +2 -0
  226. package/CHANGELOG.md +64 -0
  227. package/DETAILS.md +24 -19
  228. package/README.md +1 -1
  229. package/dist/checks/after/auth.js +114 -46
  230. package/dist/checks/after/github.js +77 -35
  231. package/dist/checks/after/index.js +12 -3
  232. package/dist/checks/after/tools.js +224 -1
  233. package/dist/checks/before/files.js +59 -1
  234. package/dist/checks/before/index.js +7 -1
  235. package/dist/checks/status-holes.js +20 -21
  236. package/dist/checks/tips/catalogue.js +99 -10
  237. package/dist/checks/tips/detect.js +35 -3
  238. package/dist/checks/tips/index.js +1 -1
  239. package/dist/cli.js +13 -13
  240. package/dist/commands/ci/ci.js +56 -12
  241. package/dist/commands/ci/push-gate.js +79 -44
  242. package/dist/commands/install/install.js +23 -22
  243. package/dist/commands/install/uninstall.js +36 -30
  244. package/dist/commands/install/upgrade.js +10 -2
  245. package/dist/commands/land.js +2 -3
  246. package/dist/commands/lib.js +323 -25
  247. package/dist/commands/workflow/branches.js +312 -72
  248. package/dist/commands/workflow/challenge.js +66 -13
  249. package/dist/commands/workflow/context.js +46 -10
  250. package/dist/commands/workflow/counters.js +231 -23
  251. package/dist/commands/workflow/decisions.js +221 -106
  252. package/dist/commands/workflow/disk.js +2 -1
  253. package/dist/commands/workflow/feature-base.js +60 -0
  254. package/dist/commands/workflow/issues.js +243 -15
  255. package/dist/commands/workflow/junit.js +137 -0
  256. package/dist/commands/workflow/ledgers.js +726 -112
  257. package/dist/commands/workflow/locks.js +150 -29
  258. package/dist/commands/workflow/loops.js +67 -0
  259. package/dist/commands/workflow/open-decision.js +199 -0
  260. package/dist/commands/workflow/plan-blocks.js +6 -0
  261. package/dist/commands/workflow/plans.js +1 -1
  262. package/dist/commands/workflow/prs.js +272 -16
  263. package/dist/commands/workflow/repo.js +1 -1
  264. package/dist/commands/workflow/run-facts.js +6 -0
  265. package/dist/commands/workflow/runs.js +747 -155
  266. package/dist/commands/workflow/runtime.js +8 -4
  267. package/dist/commands/workflow/status.js +259 -13
  268. package/dist/commands/workflow/step-table.js +41 -15
  269. package/dist/commands/workflow/steps.js +530 -26
  270. package/dist/commands/workflow/summary-findings.js +1 -1
  271. package/dist/commands/workflow/summary.js +289 -8
  272. package/dist/commands/workflow/tasks.js +294 -27
  273. package/dist/commands/workflow/tests-base.js +266 -0
  274. package/dist/commands/workflow/tests-changed.js +130 -56
  275. package/dist/commands/workflow/tests-jump.js +77 -0
  276. package/dist/commands/workflow/tests.js +608 -131
  277. package/dist/commands/workflow/tracker.js +920 -112
  278. package/dist/commands/workflow/workflows.js +80 -59
  279. package/dist/commands/workflow/worktrees.js +387 -58
  280. package/dist/install/cloud-env.js +32 -10
  281. package/dist/install/managed-block.js +101 -0
  282. package/dist/install/manifest.js +7 -1
  283. package/dist/install/modules/claude.js +6 -2
  284. package/dist/install/modules/cloud.js +73 -86
  285. package/dist/install/modules/codex.js +9 -2
  286. package/dist/install/modules/core.js +133 -14
  287. package/dist/install/modules/opencode.js +18 -23
  288. package/dist/install/network-allowlist.js +8 -3
  289. package/dist/install/project-docs.js +551 -0
  290. package/dist/install/template-copies.js +55 -5
  291. package/dist/install/write.js +117 -5
  292. package/dist/ledgers/journal.js +10 -8
  293. package/dist/ledgers/migrate.js +20 -9
  294. package/dist/ledgers/status.js +461 -8
  295. package/dist/ledgers/telemetry.js +71 -13
  296. package/dist/render/trackers.js +3 -1
  297. package/dist/shared/package-manager.js +7 -2
  298. package/dist/shared/settings.js +8 -0
  299. package/dist/shared/text.js +13 -0
  300. package/dist/tools/instructions-sources.js +1 -0
  301. package/dist/tools/instructions.js +97 -24
  302. package/package.json +22 -15
  303. package/.bkit/core/hooks/preflight-linear.sh +0 -73
  304. package/.bkit/shared/docs/architecture.md +0 -16
  305. package/.bkit/shared/docs/data-schema.md +0 -16
  306. package/.bkit/shared/docs/design.md +0 -38
  307. package/.bkit/shared/docs/noise.md +0 -20
  308. package/.bkit/shared/docs/observability.md +0 -22
  309. package/.bkit/shared/docs/security.md +0 -62
  310. package/.bkit/shared/docs/setup.md +0 -52
  311. package/.bkit/shared/docs/technology.md +0 -15
  312. /package/.bkit/templates/{.lintstagedrc.json → lintstagedrc.example.json} +0 -0
  313. /package/.bkit/templates/{.prettierignore → prettierignore.example} +0 -0
@@ -4,6 +4,8 @@ import * as fs from "node:fs";
4
4
  import * as path from "node:path";
5
5
  import { spawnSync } from "node:child_process";
6
6
  import { readJsonFile } from "../../shared/json.js";
7
+ import { readBkitConfig } from "../../shared/settings.js";
8
+ import { OPENCODE_PROVIDER_DEFAULTS } from "../../shared/egress.js";
7
9
  /**
8
10
  * Detect whether BKIT_GH_TOKEN is set in the shell environment. Distinguishes
9
11
  * empty from unset so action text can guide the user precisely. Never reads the
@@ -126,11 +128,25 @@ export function buildCloudDashboardsAdvisory(cwd) {
126
128
  return null;
127
129
  const sections = [];
128
130
  if (hasRouter) {
129
- sections.push("**GitHub Actions** (used by bkit-cloud.yml and your own workflows):\n" +
130
- " gh secret set ANTHROPIC_API_KEY --body='<value>'\n\n" +
131
- " Verify: `gh secret list | grep -E 'ANTHROPIC_API_KEY'`\n\n" +
132
- " Keyless alternative for bkit-cloud.yml (workload identity federation): leave the secret unset and set the `ANTHROPIC_FEDERATION_RULE_ID` + `ANTHROPIC_ORGANIZATION_ID` repo variables (`gh variable set`) from a Claude Console federation rule.\n\n" +
133
- " ANTHROPIC_API_KEY is read from the Anthropic dashboard (https://console.anthropic.com/settings/keys); `.bkit/.env` holds the same value as BKIT_ANTHROPIC_API_KEY. The Claude GitHub App (`/install-github-app`) is also required for `cloud=claude`.");
131
+ const config = readBkitConfig(cwd);
132
+ const agent = config.cloudAgents === "none" ? "claude" : config.cloudAgents;
133
+ let secret = "BKIT_ANTHROPIC_API_KEY";
134
+ if (agent === "codex")
135
+ secret = "BKIT_OPENAI_API_KEY";
136
+ else if (agent === "opencode")
137
+ secret = config.opencodeProvider
138
+ ? OPENCODE_PROVIDER_DEFAULTS[config.opencodeProvider].envVar
139
+ : "BKIT_<PROVIDER>_API_KEY";
140
+ let text = "**GitHub Actions** (used by bkit-cloud.yml and your own workflows):\n" +
141
+ ` gh secret set ${secret} --body='<value>'\n\n` +
142
+ ` Verify: \`gh secret list | grep -E '${secret}'\`\n\n`;
143
+ if (agent === "claude")
144
+ text +=
145
+ " Keyless alternative for bkit-cloud.yml (workload identity federation): leave the secret unset and set the `ANTHROPIC_FEDERATION_RULE_ID` + `ANTHROPIC_ORGANIZATION_ID` repo variables (`gh variable set`) from a Claude Console federation rule.\n\n" +
146
+ " BKIT_ANTHROPIC_API_KEY is read from the Anthropic dashboard (https://console.anthropic.com/settings/keys); `.bkit/.env` holds the same value. The Claude GitHub App (`/install-github-app`) is also required for `cloud=claude`.";
147
+ else
148
+ text += ` \`.bkit/.env\` holds the same value as ${secret}.`;
149
+ sections.push(text);
134
150
  }
135
151
  for (const [, text] of present)
136
152
  sections.push(text);
@@ -146,61 +162,113 @@ export function buildCloudDashboardsAdvisory(cwd) {
146
162
  }
147
163
  /** Repo variables that, both set, switch bkit-cloud.yml's claude job to workload identity federation. */
148
164
  const FEDERATION_VARIABLES = ["ANTHROPIC_FEDERATION_RULE_ID", "ANTHROPIC_ORGANIZATION_ID"];
165
+ const LEGACY_ANTHROPIC = "ANTHROPIC_API_KEY";
166
+ const BKIT_ANTHROPIC = "BKIT_ANTHROPIC_API_KEY";
149
167
  /**
150
- * Detect whether `bkit-cloud.yml`'s claude job has a credential. Only fires when
151
- * `.github/workflows/bkit-cloud.yml` exists. The claude job (claude-code-action) takes the
152
- * `ANTHROPIC_API_KEY` repo secret OR workload identity federation (both
153
- * `FEDERATION_VARIABLES` repo variables). The workflow is GitHub-tracker only — no
154
- * `BKIT_LINEAR_API_KEY` dependency. Silent when gh cannot list secrets; when only the
155
- * variables are unlistable, a missing key still raises the missing-credential finding.
168
+ * Secret findings for the adopted `bkit-cloud.yml`, per recorded variant and tracker.
169
+ * Only fires when `.github/workflows/bkit-cloud.yml` exists. Every finding is keyed on the
170
+ * secret names the adopted copy reads (`secrets.BKIT_` sniff): a legacy copy keeps its
171
+ * legacy names and gets no rename finding; a current copy gets `BKIT_` names plus
172
+ * `cloud-router-secret-renamed` when only the legacy twin is set. Claude: the key secret or
173
+ * workload identity federation (both `FEDERATION_VARIABLES` repo variables). Codex:
174
+ * `BKIT_OPENAI_API_KEY`. Linear / Jira: the tracker key (current copies only). Silent when
175
+ * gh cannot list secrets; when only the variables are unlistable, a missing key still
176
+ * raises the missing-credential finding.
156
177
  */
157
178
  export function detectCiRouterSecrets(cwd) {
158
179
  const routerPath = path.join(cwd, ".github", "workflows", "bkit-cloud.yml");
159
180
  if (!fs.existsSync(routerPath))
160
181
  return [];
161
- const key = detectGhSecret("ANTHROPIC_API_KEY");
162
- if (key === "unknown")
182
+ const names = listGhNames("secret");
183
+ if (names === null)
163
184
  return [];
185
+ const content = fs.readFileSync(routerPath, "utf-8");
186
+ const legacy = !content.includes("secrets.BKIT_");
187
+ const config = readBkitConfig(cwd);
188
+ const agent = config.cloudAgents === "none" ? "claude" : config.cloudAgents;
189
+ const findings = [];
190
+ if (!legacy && (config.issueTracker === "linear" || config.issueTracker === "jira")) {
191
+ const tk = config.issueTracker === "linear" ? "BKIT_LINEAR_API_KEY" : "BKIT_JIRA_API_KEY";
192
+ if (!names.includes(tk))
193
+ findings.push({
194
+ id: "cloud-router-tracker-secret-missing",
195
+ severity: "advisory",
196
+ detect: `The \`${tk}\` repo secret is not set. The router reads the \`bkit:auto\` label from ${config.issueTracker} with it; without it the router starts no agent.`,
197
+ action: `\`gh secret set ${tk} --body='<paste-value-here>'\`, then verify with \`gh secret list\`.`,
198
+ });
199
+ }
200
+ if (agent === "codex") {
201
+ if (!legacy && !names.includes("BKIT_OPENAI_API_KEY"))
202
+ findings.push({
203
+ id: "codex-api-key-secret-missing",
204
+ severity: "advisory",
205
+ detect: "`bkit.cloud.agent` is `codex` but the `BKIT_OPENAI_API_KEY` repo secret is not set; the codex job exits no-op.",
206
+ action: "`gh secret set BKIT_OPENAI_API_KEY --body='<paste-value-here>'`, then verify with `gh secret list`.",
207
+ });
208
+ return findings;
209
+ }
210
+ if (agent === "opencode") {
211
+ const envVar = config.opencodeProvider
212
+ ? OPENCODE_PROVIDER_DEFAULTS[config.opencodeProvider].envVar
213
+ : null;
214
+ if (!legacy && envVar && names.includes("OPENCODE_PROVIDER_KEY") && !names.includes(envVar))
215
+ findings.push({
216
+ id: "cloud-router-secret-renamed",
217
+ severity: "advisory",
218
+ detect: `The legacy \`OPENCODE_PROVIDER_KEY\` repo secret is set but \`${envVar}\`, the name the router now reads, is not.`,
219
+ action: `\`gh secret set ${envVar} --body='<same-value>'\`, then \`gh secret delete OPENCODE_PROVIDER_KEY\`.`,
220
+ });
221
+ return findings;
222
+ }
223
+ if (agent !== "claude")
224
+ return findings;
225
+ const keyName = legacy ? LEGACY_ANTHROPIC : BKIT_ANTHROPIC;
226
+ if (!legacy && names.includes(LEGACY_ANTHROPIC) && !names.includes(BKIT_ANTHROPIC)) {
227
+ findings.push({
228
+ id: "cloud-router-secret-renamed",
229
+ severity: "advisory",
230
+ detect: `The legacy \`${LEGACY_ANTHROPIC}\` repo secret is set but \`${BKIT_ANTHROPIC}\`, the name the router now reads, is not.`,
231
+ action: `\`gh secret set ${BKIT_ANTHROPIC} --body='<same-value>'\`, then \`gh secret delete ${LEGACY_ANTHROPIC}\`.`,
232
+ });
233
+ return findings;
234
+ }
235
+ const keyPresent = names.includes(keyName);
164
236
  const variables = listGhNames("variable");
165
237
  const federated = variables !== null && FEDERATION_VARIABLES.every((v) => variables.includes(v));
166
- if (key === "present" && federated) {
167
- return [
168
- {
169
- id: "anthropic-api-key-shadows-federation",
170
- severity: "advisory",
171
- detect: "The `ANTHROPIC_API_KEY` repo secret and the `ANTHROPIC_FEDERATION_RULE_ID` + `ANTHROPIC_ORGANIZATION_ID` repo variables are all set. claude-code-action uses the key and skips workload identity federation.",
172
- action: "To run keyless, delete the secret: `gh secret delete ANTHROPIC_API_KEY`. To stay on the key, delete the variables: `gh variable delete ANTHROPIC_FEDERATION_RULE_ID` and `gh variable delete ANTHROPIC_ORGANIZATION_ID`.",
173
- },
174
- ];
238
+ if (keyPresent && federated) {
239
+ findings.push({
240
+ id: "anthropic-api-key-shadows-federation",
241
+ severity: "advisory",
242
+ detect: `The \`${keyName}\` repo secret and the \`ANTHROPIC_FEDERATION_RULE_ID\` + \`ANTHROPIC_ORGANIZATION_ID\` repo variables are all set. claude-code-action uses the key and skips workload identity federation.`,
243
+ action: `To run keyless, delete the secret: \`gh secret delete ${keyName}\`. To stay on the key, delete the variables: \`gh variable delete ANTHROPIC_FEDERATION_RULE_ID\` and \`gh variable delete ANTHROPIC_ORGANIZATION_ID\`.`,
244
+ });
245
+ return findings;
175
246
  }
176
- if (key === "present")
177
- return [];
247
+ if (keyPresent)
248
+ return findings;
178
249
  if (federated) {
179
- if (fs.readFileSync(routerPath, "utf-8").includes("anthropic_federation_rule_id:"))
180
- return [];
181
- return [
182
- {
250
+ if (!content.includes("anthropic_federation_rule_id:"))
251
+ findings.push({
183
252
  id: "anthropic-federation-template-stale",
184
253
  severity: "advisory",
185
254
  detect: "The `ANTHROPIC_FEDERATION_RULE_ID` + `ANTHROPIC_ORGANIZATION_ID` repo variables are set, but `.github/workflows/bkit-cloud.yml` does not pass `anthropic_federation_rule_id` to claude-code-action — the claude job exits no-op.",
186
255
  action: "Re-copy the template: `cp .bkit/templates/.github/workflows/bkit-cloud.yml .github/workflows/bkit-cloud.yml`, then re-apply your own edits (the `runs-on` runner at minimum).",
187
- },
188
- ];
256
+ });
257
+ return findings;
189
258
  }
190
- return [
191
- {
192
- id: "anthropic-api-key-secret-missing",
193
- severity: "advisory",
194
- detect: variables === null
195
- ? "gh confirms the `ANTHROPIC_API_KEY` repo secret is not set on this GitHub repo, and could not list repo variables to check for the `ANTHROPIC_FEDERATION_RULE_ID` + `ANTHROPIC_ORGANIZATION_ID` federation variables."
196
- : "gh confirms neither the `ANTHROPIC_API_KEY` repo secret nor both `ANTHROPIC_FEDERATION_RULE_ID` + `ANTHROPIC_ORGANIZATION_ID` repo variables are set on this GitHub repo.",
197
- action: "`.github/workflows/bkit-cloud.yml`'s claude job needs one claude credential; without it, the job exits no-op. Set ONE of:\n\n" +
198
- "- API key:\n\n gh secret set ANTHROPIC_API_KEY --body='<paste-value-here>'\n\n" +
199
- "- Workload identity federation (keyless): Claude Console → Settings → Workload identity → Connect workload → GitHub Actions creates the issuer, service account and federation rule. Then:\n\n" +
200
- " gh variable set ANTHROPIC_FEDERATION_RULE_ID --body='fdrl_...'\n" +
201
- " gh variable set ANTHROPIC_ORGANIZATION_ID --body='<organization-uuid>'\n\n" +
202
- " Optional: `ANTHROPIC_SERVICE_ACCOUNT_ID` (`svac_...`) and `ANTHROPIC_WORKSPACE_ID` (`wrkspc_...`, needed when the rule covers more than one workspace).\n\n" +
203
- "Then verify: `gh secret list` / `gh variable list`. The workflow itself does not need redeploying — both are read at run time.",
204
- },
205
- ];
259
+ findings.push({
260
+ id: "anthropic-api-key-secret-missing",
261
+ severity: "advisory",
262
+ detect: variables === null
263
+ ? `gh confirms the \`${keyName}\` repo secret is not set on this GitHub repo, and could not list repo variables to check for the \`ANTHROPIC_FEDERATION_RULE_ID\` + \`ANTHROPIC_ORGANIZATION_ID\` federation variables.`
264
+ : `gh confirms neither the \`${keyName}\` repo secret nor both \`ANTHROPIC_FEDERATION_RULE_ID\` + \`ANTHROPIC_ORGANIZATION_ID\` repo variables are set on this GitHub repo.`,
265
+ action: "`.github/workflows/bkit-cloud.yml`'s claude job needs one claude credential; without it, the job exits no-op. Set ONE of:\n\n" +
266
+ `- API key:\n\n gh secret set ${keyName} --body='<paste-value-here>'\n\n` +
267
+ "- Workload identity federation (keyless): Claude Console → Settings → Workload identity → Connect workload → GitHub Actions creates the issuer, service account and federation rule. Then:\n\n" +
268
+ " gh variable set ANTHROPIC_FEDERATION_RULE_ID --body='fdrl_...'\n" +
269
+ " gh variable set ANTHROPIC_ORGANIZATION_ID --body='<organization-uuid>'\n\n" +
270
+ " Optional: `ANTHROPIC_SERVICE_ACCOUNT_ID` (`svac_...`) and `ANTHROPIC_WORKSPACE_ID` (`wrkspc_...`, needed when the rule covers more than one workspace).\n\n" +
271
+ "Then verify: `gh secret list` / `gh variable list`. The workflow itself does not need redeploying — both are read at run time.",
272
+ });
273
+ return findings;
206
274
  }
@@ -4,6 +4,7 @@
4
4
  import * as fs from "node:fs";
5
5
  import * as path from "node:path";
6
6
  import { execFileSync } from "node:child_process";
7
+ import { ISSUE_TRACKERS } from "../../install/manifest.js";
7
8
  import { MCP_TOOLSETS_HEADER, parseToolsets } from "../../install/write.js";
8
9
  import { parseJson, readJsonFile } from "../../shared/json.js";
9
10
  import { readBkitConfig } from "../../shared/settings.js";
@@ -66,6 +67,7 @@ export function detectActionsWritePermissions() {
66
67
  * - `github` → GitHub tracker: the GitHub MCP server authenticates with `BKIT_GH_TOKEN`; `gh` uses `gh auth login`.
67
68
  * - `linear` → existing Linear setup message (BKIT_LINEAR_API_KEY + LINEAR_ISSUE_ID).
68
69
  * - `jira` → admin switch, BKIT_JIRA_API_KEY and `bkit.tracker.jira` in package.json.
70
+ * - unknown → blocker naming the value and the valid names (the tracker guard fails on it too).
69
71
  * - `none` → prompt to run `bkit install --tracker=github`, `--tracker=linear` or `--tracker=jira`.
70
72
  *
71
73
  * Only fires when bkit workflows are installed (.claude/ or .cursor/ present).
@@ -75,7 +77,15 @@ export function buildTrackerSetupAdvisory(cwd) {
75
77
  const hasCursor = fs.existsSync(path.join(cwd, ".cursor"));
76
78
  if (!hasClaude && !hasCursor)
77
79
  return null;
78
- const { issueTracker: tracker, issueTrackerExplicit } = readBkitConfig(cwd);
80
+ const { issueTracker: tracker, issueTrackerExplicit, issueTrackerUnknown } = readBkitConfig(cwd);
81
+ if (issueTrackerUnknown !== null) {
82
+ return {
83
+ id: "tracker-setup-unknown",
84
+ severity: "blocker",
85
+ detect: `\`bkit.tracker.default\` in package.json is "${issueTrackerUnknown}", which names no tracker bkit knows. bkit reads it as \`none\`, and the session-start tracker guard fails in every session it checks.`,
86
+ action: `Set \`bkit.tracker.default\` to one of: ${ISSUE_TRACKERS.join(", ")} (lowercase), or run \`bkit install --tracker=<name>\`.`,
87
+ };
88
+ }
79
89
  if (tracker === "github") {
80
90
  return {
81
91
  id: "tracker-setup-github",
@@ -344,55 +354,87 @@ export function buildGithubProjectTokenScopeAdvisory(cwd) {
344
354
  /**
345
355
  * Emit a cloud-agents setup advisory (parity with the tracker / dep-updater
346
356
  * advisories). Post-CI auto-routing (`bkit-cloud.yml`) is opt-in via
347
- * `bkit install --auto=claude`; it does NOT ship with a default install. This nudges
348
- * consumers to make the choice post-install.
357
+ * `bkit install --auto=<claude|opencode|codex|cursor>`; it does NOT ship with a default
358
+ * install. This nudges consumers to make the choice post-install.
349
359
  *
350
- * Also performs the cloud=claude config-consistency assertion: when
351
- * `bkit.cloud.agent === "claude"` but the installed `bkit-cloud.yml` lacks
352
- * `id-token: write`, it surfaces a consistency warning (exit-1 signal surfaced via
353
- * the `blocker` severity in the checks/before/index.ts caller).
360
+ * Resolution order (file presence is authoritative, package.json field is the opt-out):
361
+ * - router present, claude without `id-token: write` → `cloud-claude-missing-id-token` (blocker)
362
+ * - router present, linear / jira, copy says it serves GitHub only → `cloud-router-tracker-stale`
363
+ * - router present, `cloud.agent` codex, no `openai/codex-action` → `cloud-router-codex-missing`
364
+ * - router present, `cloud.agent` absent → `cloud-router-agent-unset`
365
+ * - router present, `cloud.agent` none / cursor → `cloud-router` (router starts nothing)
366
+ * - router present otherwise → `cloud-router` (informational)
367
+ * - `bkit.cloud.agent === "none"` (explicit) → null (opt-out — stay quiet)
368
+ * - otherwise (undecided) → `cloud-router-none` (nudge)
354
369
  *
355
- * Resolution order (file presence is authoritative, package.json field is the
356
- * opt-out):
357
- * - `.github/workflows/bkit-cloud.yml` present → `cloud-router` (informational; active)
358
- * - `bkit.cloud.agent === "none"` → null (opt-out — stay quiet)
359
- * - `bkit.tracker.default === "jira"` → null (Jira runs locally only)
360
- * - otherwise (undecided) → `cloud-router-none` (nudge to choose)
361
- *
362
- * Only fires when there is a `.github/workflows/` dir (the router wakes on a CI
370
+ * Only nudges when there is a `.github/workflows/` dir (the router wakes on a CI
363
371
  * completion event).
364
372
  */
365
373
  export function buildCloudSetupAdvisory(cwd) {
366
374
  const routerPath = path.join(cwd, ".github", "workflows", "bkit-cloud.yml");
367
375
  if (fs.existsSync(routerPath)) {
368
- // Config-consistency assertion: cloud=claude requires id-token: write.
369
- // If the recorded variant is "claude" and the workflow file lacks id-token: write,
370
- // surface a consistency finding.
371
- if (readBkitConfig(cwd).cloudAgents === "claude") {
372
- const workflowContent = fs.readFileSync(routerPath, "utf-8");
373
- if (!workflowContent.includes("id-token: write")) {
374
- return {
375
- id: "cloud-claude-missing-id-token",
376
- severity: "blocker",
377
- detect: "`bkit.cloud.agent` is `claude` but `.github/workflows/bkit-cloud.yml` lacks `id-token: write`. `claude-code-action@v1` will fail at boot with an OIDC error.",
378
- action: "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.",
379
- };
380
- }
376
+ const { cloudAgents, cloudAgentsExplicit, issueTracker } = readBkitConfig(cwd);
377
+ const content = fs.readFileSync(routerPath, "utf-8");
378
+ const recopy = "Re-copy the template: `cp .bkit/templates/.github/workflows/bkit-cloud.yml .github/workflows/bkit-cloud.yml`, then re-apply your own edits (the `runs-on` runner and the `{{NODE_VERSION}}` value).";
379
+ if (cloudAgents === "claude" && !content.includes("id-token: write")) {
380
+ return {
381
+ id: "cloud-claude-missing-id-token",
382
+ severity: "blocker",
383
+ detect: "`bkit.cloud.agent` is `claude` but `.github/workflows/bkit-cloud.yml` lacks `id-token: write`. `claude-code-action@v1` will fail at boot with an OIDC error.",
384
+ action: `${recopy} Also verify the Claude GitHub App is installed (\`/install-github-app\`). See bkit's \`cloud.md\` § Post-CI auto-routing.`,
385
+ };
386
+ }
387
+ if ((issueTracker === "linear" || issueTracker === "jira") &&
388
+ content.includes("serves the GitHub tracker only")) {
389
+ return {
390
+ id: "cloud-router-tracker-stale",
391
+ severity: "advisory",
392
+ detect: `\`bkit.tracker.default\` is \`${issueTracker}\` but the adopted \`.github/workflows/bkit-cloud.yml\` serves the GitHub tracker only: it never dispatches an agent for ${issueTracker} issues.`,
393
+ action: recopy,
394
+ };
395
+ }
396
+ if (cloudAgents === "codex" && !content.includes("openai/codex-action")) {
397
+ return {
398
+ id: "cloud-router-codex-missing",
399
+ severity: "advisory",
400
+ detect: "`bkit.cloud.agent` is `codex` but the adopted `.github/workflows/bkit-cloud.yml` has no `openai/codex-action` job, so no Codex run starts.",
401
+ action: recopy,
402
+ };
403
+ }
404
+ if (!cloudAgentsExplicit) {
405
+ return {
406
+ id: "cloud-router-agent-unset",
407
+ severity: "advisory",
408
+ detect: "`.github/workflows/bkit-cloud.yml` is present but `bkit.cloud.agent` is not recorded, so the router cannot tell which agent job to start.",
409
+ action: "Record the variant: `pnpm bkit install --auto=claude`, `--auto=opencode` or `--auto=codex` (the agent whose credential you set).",
410
+ };
411
+ }
412
+ if (cloudAgents === "none" || cloudAgents === "cursor") {
413
+ return {
414
+ id: "cloud-router",
415
+ severity: "advisory",
416
+ detect: `\`.github/workflows/bkit-cloud.yml\` is present but \`bkit.cloud.agent\` is \`${cloudAgents}\`: the router starts no agent job for \`${cloudAgents}\`, so CI results dispatch nothing.`,
417
+ action: "Record the agent whose credential you set: `pnpm bkit install --auto=claude`, `--auto=opencode` or `--auto=codex`.",
418
+ };
381
419
  }
420
+ const claude = cloudAgents === "claude";
421
+ const secret = cloudAgents === "codex"
422
+ ? "`BKIT_OPENAI_API_KEY` repo secret"
423
+ : cloudAgents === "opencode"
424
+ ? "opencode provider's `BKIT_` repo secret"
425
+ : "`BKIT_ANTHROPIC_API_KEY` repo secret OR the `ANTHROPIC_FEDERATION_RULE_ID` + `ANTHROPIC_ORGANIZATION_ID` repo variables (keyless workload identity federation)";
382
426
  return {
383
427
  id: "cloud-router",
384
428
  severity: "advisory",
385
- detect: "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.",
386
- action: `The workflow requires: the \`ANTHROPIC_API_KEY\` repo secret OR the \`ANTHROPIC_FEDERATION_RULE_ID\` + \`ANTHROPIC_ORGANIZATION_ID\` repo variables (keyless workload identity federation), 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.\n\nbkit's agents comment as you, so every workflow those comments trigger notifies you, even ones that skip. To see only failures: GitHub → Settings → Notifications → System → Actions → "Only notify for failed workflows".`,
429
+ detect: `Cloud agents: post-CI auto-routing is configured for \`${cloudAgents}\` (\`.github/workflows/bkit-cloud.yml\` present).${claude ? " The Claude GitHub App is required — run `/install-github-app` (Claude Code CLI) once if not already done." : ""}`,
430
+ action: `The workflow requires: the ${secret}${claude ? ", 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=${cloudAgents}\`) and bkit's \`cloud.md\` § Post-CI auto-routing for the full checklist.\n\nbkit's agents comment as you, so every workflow those comments trigger notifies you, even ones that skip. To see only failures: GitHub → Settings → Notifications → System → Actions → "Only notify for failed workflows".`,
387
431
  };
388
432
  }
389
433
  // No router present — distinguish opt-out from undecided.
390
- const { cloudAgents, cloudAgentsExplicit, issueTracker } = readBkitConfig(cwd);
434
+ const { cloudAgents, cloudAgentsExplicit } = readBkitConfig(cwd);
391
435
  if (cloudAgents === "none" && cloudAgentsExplicit) {
392
436
  return null; // consumer explicitly chose `none` — stay quiet
393
437
  }
394
- if (issueTracker === "jira")
395
- return null; // no cloud setup exists for a Jira tracker
396
438
  // Only nudge if there's a workflows dir for the router to wake on.
397
439
  if (!fs.existsSync(path.join(cwd, ".github", "workflows")))
398
440
  return null;
@@ -400,8 +442,8 @@ export function buildCloudSetupAdvisory(cwd) {
400
442
  id: "cloud-router-none",
401
443
  severity: "advisory",
402
444
  detect: "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.",
403
- action: "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" +
404
- "Prerequisites for `--auto=claude`: `ANTHROPIC_API_KEY` repo secret (or the `ANTHROPIC_FEDERATION_RULE_ID` + `ANTHROPIC_ORGANIZATION_ID` repo variables for keyless workload identity federation) + Claude GitHub App (`/install-github-app`) + GitHub Actions write permissions.\n\n" +
445
+ action: "Optional post-install decision: `pnpm bkit install --auto=<claude|opencode|codex|cursor>` (any variant works with your wired tracker; `codex` also needs `--codex`).\n\n" +
446
+ "Prerequisites: the variant's `BKIT_` repo secret (`BKIT_ANTHROPIC_API_KEY`, `BKIT_OPENAI_API_KEY` or the opencode provider's key; claude may use the `ANTHROPIC_FEDERATION_RULE_ID` + `ANTHROPIC_ORGANIZATION_ID` repo variables instead), the tracker key under Linear / Jira, the Claude GitHub App (`/install-github-app`) for claude, and GitHub Actions write permissions.\n\n" +
405
447
  'To opt out and silence this advisory, set `bkit.cloud.agent` to `"none"` in package.json.',
406
448
  };
407
449
  }
@@ -11,8 +11,9 @@ import { detectOpencodeYmlProviderDrift } from "../../install/modules/opencode.j
11
11
  import { detectManagedDuplicate, detectManagedStale } from "./managed.js";
12
12
  import { buildCloudDashboardsAdvisory, detectCiRouterSecrets, detectGhMcpToken } from "./auth.js";
13
13
  import { buildCloudSetupAdvisory, buildGithubProjectAdvisory, buildGithubProjectTokenScopeAdvisory, buildTrackerSetupAdvisory, buildTrivyProtectionAdvisory, detectActionsWritePermissions, detectMainBranchProtection, } from "./github.js";
14
- import { buildDepUpdaterSetupAdvisory, detectBkitStubs, detectValeMissing, detectValePackageNotSynced, detectWorkflowLintToolsMissing, } from "./tools.js";
14
+ import { buildDepUpdaterSetupAdvisory, detectBkitStubs, detectProjectDocs, detectValeMissing, detectValePackageNotSynced, detectWorkflowLintToolsMissing, } from "./tools.js";
15
15
  import { detectBkitCloudYmlAlwaysTrueGate, detectCiScriptsOldNames, detectCiYmlCapstoneContractDrift, detectCiYmlMissingActionlint, detectCiYmlRunInjection, detectGhaFloatingTags, detectRunLevelsNotComposed, detectTaggedTestsWithoutCiHome, detectTestIntegrationEnv, detectTurboIntegrationInputs, } from "./ci-yml.js";
16
+ import { isAdvisorySuppressed, } from "./suppression.js";
16
17
  import { dropTipSilencedAdvisories, setupTipsChecklistLines, setupTipsMarkdownLines, } from "../tips/index.js";
17
18
  // ---------------------------------------------------------------------------
18
19
  // formatChecklist — pure renderer
@@ -261,8 +262,9 @@ export function runPostInstallCheck(preflightAdvisories, cwd = process.cwd(), su
261
262
  const managedDuplicate = detectManagedDuplicate(cwd);
262
263
  if (managedDuplicate)
263
264
  phase3.push(managedDuplicate);
264
- // BKIT_GH_TOKEN shell env — authenticates the GitHub MCP server.
265
- const ghMcpToken = detectGhMcpToken(cwd);
265
+ // BKIT_GH_TOKEN shell env — authenticates the GitHub MCP server. Skipped inside the pre-push
266
+ // hook's inner run, which unsets the .bkit/.env keys on purpose (BKIT_PRE_PUSH_LOGGED is set).
267
+ const ghMcpToken = process.env.BKIT_PRE_PUSH_LOGGED ? null : detectGhMcpToken(cwd);
266
268
  if (ghMcpToken)
267
269
  phase3.push(ghMcpToken);
268
270
  // Main branch protection — bkit's PR-base gates (build Step 16, ship Step 2)
@@ -371,6 +373,13 @@ export function runPostInstallCheck(preflightAdvisories, cwd = process.cwd(), su
371
373
  // bkit-stub sentinels in shipped templates — one advisory per still-commented stub.
372
374
  for (const stub of detectBkitStubs(cwd))
373
375
  phase3.push(stub);
376
+ // Project documents (docs/*.md): missing, empty, starter-only or unindexed. Advisory only.
377
+ for (const f of detectProjectDocs(cwd)) {
378
+ if (!isAdvisorySuppressed(cwd, f.id, f.severity))
379
+ phase3.push(f);
380
+ else
381
+ onSuppressed?.({ id: f.id, scope: "." });
382
+ }
374
383
  // turbo.json inputs for cache-replay safety (KN-24).
375
384
  for (const f of detectTurboIntegrationInputs(cwd))
376
385
  phase3.push(f);