@cbartens/bkit 6.1.0 → 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 (317) 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 +43 -33
  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 +99 -36
  15. package/.bkit/core/.bkit/templates.md +167 -37
  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 +161 -37
  64. package/.bkit/core/engine/checks/after/index.ts +18 -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 +124 -19
  74. package/.bkit/core/engine/commands/ci/push-gate.ts +101 -43
  75. package/.bkit/core/engine/commands/install/doctor.ts +5 -5
  76. package/.bkit/core/engine/commands/install/install.ts +28 -25
  77. package/.bkit/core/engine/commands/install/uninstall.ts +42 -30
  78. package/.bkit/core/engine/commands/install/upgrade.ts +14 -2
  79. package/.bkit/core/engine/commands/land.ts +2 -3
  80. package/.bkit/core/engine/commands/lib.ts +394 -39
  81. package/.bkit/core/engine/commands/registry.ts +1 -1
  82. package/.bkit/core/engine/commands/workflow/branches.ts +351 -78
  83. package/.bkit/core/engine/commands/workflow/challenge.ts +63 -14
  84. package/.bkit/core/engine/commands/workflow/context.ts +71 -10
  85. package/.bkit/core/engine/commands/workflow/counters.ts +298 -23
  86. package/.bkit/core/engine/commands/workflow/decisions.ts +260 -125
  87. package/.bkit/core/engine/commands/workflow/disk.ts +2 -1
  88. package/.bkit/core/engine/commands/workflow/feature-base.ts +66 -0
  89. package/.bkit/core/engine/commands/workflow/issues.ts +312 -17
  90. package/.bkit/core/engine/commands/workflow/junit.ts +204 -0
  91. package/.bkit/core/engine/commands/workflow/ledgers.ts +904 -99
  92. package/.bkit/core/engine/commands/workflow/locks.ts +186 -29
  93. package/.bkit/core/engine/commands/workflow/loops.ts +87 -0
  94. package/.bkit/core/engine/commands/workflow/open-decision.ts +251 -0
  95. package/.bkit/core/engine/commands/workflow/plan-blocks.ts +8 -0
  96. package/.bkit/core/engine/commands/workflow/plans.ts +1 -1
  97. package/.bkit/core/engine/commands/workflow/prs.ts +311 -16
  98. package/.bkit/core/engine/commands/workflow/repo.ts +1 -1
  99. package/.bkit/core/engine/commands/workflow/run-facts.ts +6 -0
  100. package/.bkit/core/engine/commands/workflow/runs.ts +877 -174
  101. package/.bkit/core/engine/commands/workflow/runtime.ts +12 -4
  102. package/.bkit/core/engine/commands/workflow/status.ts +324 -11
  103. package/.bkit/core/engine/commands/workflow/step-table.ts +41 -15
  104. package/.bkit/core/engine/commands/workflow/steps.ts +604 -29
  105. package/.bkit/core/engine/commands/workflow/summary-findings.ts +1 -1
  106. package/.bkit/core/engine/commands/workflow/summary.ts +314 -8
  107. package/.bkit/core/engine/commands/workflow/tasks.ts +400 -27
  108. package/.bkit/core/engine/commands/workflow/tests-base.ts +319 -0
  109. package/.bkit/core/engine/commands/workflow/tests-changed.ts +138 -74
  110. package/.bkit/core/engine/commands/workflow/tests-jump.ts +93 -0
  111. package/.bkit/core/engine/commands/workflow/tests.ts +815 -182
  112. package/.bkit/core/engine/commands/workflow/tracker.ts +1134 -137
  113. package/.bkit/core/engine/commands/workflow/workflows.ts +100 -72
  114. package/.bkit/core/engine/commands/workflow/worktrees.ts +421 -57
  115. package/.bkit/core/engine/install/cloud-env.ts +38 -10
  116. package/.bkit/core/engine/install/managed-block.ts +105 -0
  117. package/.bkit/core/engine/install/manifest.ts +7 -1
  118. package/.bkit/core/engine/install/modules/claude.ts +6 -2
  119. package/.bkit/core/engine/install/modules/cloud.ts +84 -95
  120. package/.bkit/core/engine/install/modules/codex.ts +10 -2
  121. package/.bkit/core/engine/install/modules/core.ts +202 -26
  122. package/.bkit/core/engine/install/modules/opencode.ts +18 -23
  123. package/.bkit/core/engine/install/network-allowlist.ts +8 -3
  124. package/.bkit/core/engine/install/project-docs.ts +650 -0
  125. package/.bkit/core/engine/install/template-copies.ts +58 -5
  126. package/.bkit/core/engine/install/write.ts +128 -7
  127. package/.bkit/core/engine/ledgers/journal.ts +18 -10
  128. package/.bkit/core/engine/ledgers/migrate.ts +20 -8
  129. package/.bkit/core/engine/ledgers/status.ts +604 -8
  130. package/.bkit/core/engine/ledgers/telemetry.ts +115 -13
  131. package/.bkit/core/engine/render/trackers.ts +46 -11
  132. package/.bkit/core/engine/shared/package-manager.ts +7 -3
  133. package/.bkit/core/engine/shared/settings.ts +12 -1
  134. package/.bkit/core/engine/shared/text.ts +14 -0
  135. package/.bkit/core/engine/tools/instructions-sources.ts +1 -0
  136. package/.bkit/core/engine/tools/instructions.ts +116 -20
  137. package/.bkit/core/hooks/antigravity-hook.js +20 -4
  138. package/.bkit/core/hooks/gateguard-edit-payload.js +8 -5
  139. package/.bkit/core/hooks/gateguard-engine.js +249 -23
  140. package/.bkit/core/hooks/guardrails-deny.js +167 -0
  141. package/.bkit/core/hooks/guardrails-read.js +3 -3
  142. package/.bkit/core/hooks/guardrails-shell.js +1122 -167
  143. package/.bkit/core/hooks/guardrails-tiers.js +247 -176
  144. package/.bkit/core/hooks/preflight-tracker.sh +219 -0
  145. package/.bkit/core/prompts/bkit-audit-generate.md +23 -6
  146. package/.bkit/core/prompts/bkit-build-challenge-1.md +5 -4
  147. package/.bkit/core/prompts/bkit-build-challenge-2.md +6 -5
  148. package/.bkit/core/prompts/bkit-build-install-skills.md +2 -2
  149. package/.bkit/core/prompts/bkit-build-plan-convert.md +21 -7
  150. package/.bkit/core/prompts/bkit-build-plan-current.md +5 -4
  151. package/.bkit/core/prompts/bkit-build-plan-gaps-remediate.md +22 -17
  152. package/.bkit/core/prompts/bkit-build-plan-tasks.md +16 -12
  153. package/.bkit/core/prompts/bkit-build-plan-tests.md +14 -10
  154. package/.bkit/core/prompts/bkit-build-plan-verify.md +21 -8
  155. package/.bkit/core/prompts/bkit-debug-abort-handover.md +10 -5
  156. package/.bkit/core/prompts/bkit-debug-failure-diagnose.md +22 -6
  157. package/.bkit/core/prompts/bkit-debug-failure-remediate.md +19 -3
  158. package/.bkit/core/prompts/bkit-debug-failure-reproduce.md +22 -6
  159. package/.bkit/core/prompts/bkit-debug-failure-soak.md +10 -7
  160. package/.bkit/core/prompts/bkit-design-brainstorm-ideate-1.md +3 -3
  161. package/.bkit/core/prompts/bkit-design-brainstorm-ideate-2.md +4 -4
  162. package/.bkit/core/prompts/bkit-design-brainstorm-ideate-3.md +3 -3
  163. package/.bkit/core/prompts/bkit-design-generate.md +6 -4
  164. package/.bkit/core/prompts/bkit-design-organise.md +4 -3
  165. package/.bkit/core/prompts/bkit-design-review-1.md +5 -4
  166. package/.bkit/core/prompts/bkit-design-review-2.md +6 -5
  167. package/.bkit/core/prompts/bkit-design-spike.md +4 -3
  168. package/.bkit/core/prompts/bkit-design-update.md +6 -4
  169. package/.bkit/core/prompts/bkit-plan-generate.md +35 -14
  170. package/.bkit/core/prompts/bkit-plan-review-1.md +9 -7
  171. package/.bkit/core/prompts/bkit-plan-review-2.md +9 -7
  172. package/.bkit/core/prompts/bkit-plan-scope-check.md +8 -6
  173. package/.bkit/core/prompts/bkit-plan-update.md +22 -8
  174. package/.bkit/core/prompts/bkit-ship-conflict-resolve.md +11 -8
  175. package/.bkit/core/prompts/bkit-ship-deferred-sweep.md +9 -5
  176. package/.bkit/core/prompts/bkit-ship-update-docs.md +26 -4
  177. package/.bkit/core/prompts/bkit-utility-compress-markdown.md +3 -3
  178. package/.bkit/core/prompts/bkit-utility-update-decisions.md +10 -7
  179. package/.bkit/core/prompts/bkit-utility-update-deferrals.md +8 -5
  180. package/.bkit/core/prompts/bkit-utility-update-documentation.md +31 -7
  181. package/.bkit/core/prompts/bkit-utility-update-failures.md +8 -5
  182. package/.bkit/core/prompts/bkit-utility-update-knowledge.md +10 -7
  183. package/.bkit/core/prompts/bkit-utility-update-roadmap.md +4 -4
  184. package/.bkit/core/prompts/bkit-utility-update-tracker.md +4 -4
  185. package/.bkit/core/workflows/bkit-auto.md +23 -11
  186. package/.bkit/core/workflows/bkit-build.md +331 -100
  187. package/.bkit/core/workflows/bkit-debug.md +135 -64
  188. package/.bkit/core/workflows/bkit-design.md +58 -32
  189. package/.bkit/core/workflows/bkit-plan.md +73 -45
  190. package/.bkit/core/workflows/bkit-ship.md +233 -167
  191. package/.bkit/shared/.agents/plugins/bkit/hooks.json +1 -1
  192. package/.bkit/shared/.bkit/.env.example +5 -0
  193. package/.bkit/shared/.claude/bkit-cloud.md +7 -7
  194. package/.bkit/shared/.claude/settings.json +5 -1
  195. package/.bkit/shared/.cursor/bkit-cloud.md +1 -1
  196. package/.bkit/shared/.cursor/hooks.json +1 -1
  197. package/.bkit/shared/.opencode/opencode.json +11 -2
  198. package/.bkit/templates/.claude/hooks/bkit-cloud-bootstrap.sh +27 -0
  199. package/.bkit/templates/.cursor/Dockerfile +7 -7
  200. package/.bkit/templates/.github/ISSUE_TEMPLATE/bkit-idea.yml +1 -1
  201. package/.bkit/templates/.github/dependabot.yml +5 -0
  202. package/.bkit/templates/.github/renovate.json5 +5 -3
  203. package/.bkit/templates/.github/workflows/bkit-ci.yml +11 -11
  204. package/.bkit/templates/.github/workflows/bkit-cloud.yml +525 -161
  205. package/.bkit/templates/.github/workflows/bkit-renovate.yml +2 -2
  206. package/.bkit/templates/.husky/pre-push +123 -6
  207. package/.bkit/templates/context/bkit-serena.md +1 -1
  208. package/.bkit/templates/context/bkit-vercel.md +103 -59
  209. package/.bkit/templates/docs/architecture.md +98 -0
  210. package/.bkit/templates/docs/capabilities.md +33 -37
  211. package/.bkit/templates/docs/components.md +142 -0
  212. package/.bkit/templates/docs/data-schema.md +87 -0
  213. package/.bkit/{shared → templates}/docs/deployments.md +128 -142
  214. package/.bkit/templates/docs/design.md +117 -0
  215. package/.bkit/templates/docs/noise.md +54 -0
  216. package/.bkit/templates/docs/observability.md +99 -0
  217. package/.bkit/templates/docs/security.md +137 -0
  218. package/.bkit/templates/docs/setup.md +93 -0
  219. package/.bkit/templates/docs/technology.md +70 -0
  220. package/.bkit/{shared → templates}/docs/testing.md +200 -87
  221. package/.bkit/templates/scripts/ci/bkit-check-accepted-divergences.mjs +1 -6
  222. package/.bkit/templates/scripts/ci/bkit-machine-lock.sh +511 -103
  223. package/.bkit/templates/scripts/ci/bkit-test-awake.mjs +314 -28
  224. package/.bkit/templates/scripts/ci/bkit-test-awake.test.mjs +500 -1
  225. package/.bkit/templates/scripts/graphify/bkit-graphify-graphml.py +1 -1
  226. package/.bkit/templates/scripts/graphify/bkit-graphify-rollup.py +91 -62
  227. package/.bkit/templates/scripts/graphify/bkit-graphify.sh +59 -11
  228. package/.bkit/templates/slop-scan.config.json +2 -0
  229. package/CHANGELOG.md +79 -0
  230. package/DETAILS.md +661 -0
  231. package/README.md +73 -604
  232. package/dist/checks/after/auth.js +114 -46
  233. package/dist/checks/after/github.js +138 -35
  234. package/dist/checks/after/index.js +16 -4
  235. package/dist/checks/after/tools.js +224 -1
  236. package/dist/checks/before/files.js +59 -1
  237. package/dist/checks/before/index.js +7 -1
  238. package/dist/checks/status-holes.js +20 -21
  239. package/dist/checks/tips/catalogue.js +99 -10
  240. package/dist/checks/tips/detect.js +35 -3
  241. package/dist/checks/tips/index.js +1 -1
  242. package/dist/cli.js +13 -13
  243. package/dist/commands/ci/ci.js +113 -20
  244. package/dist/commands/ci/push-gate.js +79 -44
  245. package/dist/commands/install/doctor.js +5 -5
  246. package/dist/commands/install/install.js +23 -22
  247. package/dist/commands/install/uninstall.js +36 -30
  248. package/dist/commands/install/upgrade.js +10 -2
  249. package/dist/commands/land.js +2 -3
  250. package/dist/commands/lib.js +323 -25
  251. package/dist/commands/workflow/branches.js +312 -72
  252. package/dist/commands/workflow/challenge.js +66 -13
  253. package/dist/commands/workflow/context.js +46 -10
  254. package/dist/commands/workflow/counters.js +231 -23
  255. package/dist/commands/workflow/decisions.js +221 -106
  256. package/dist/commands/workflow/disk.js +2 -1
  257. package/dist/commands/workflow/feature-base.js +60 -0
  258. package/dist/commands/workflow/issues.js +243 -15
  259. package/dist/commands/workflow/junit.js +137 -0
  260. package/dist/commands/workflow/ledgers.js +726 -112
  261. package/dist/commands/workflow/locks.js +150 -29
  262. package/dist/commands/workflow/loops.js +67 -0
  263. package/dist/commands/workflow/open-decision.js +199 -0
  264. package/dist/commands/workflow/plan-blocks.js +6 -0
  265. package/dist/commands/workflow/plans.js +1 -1
  266. package/dist/commands/workflow/prs.js +272 -16
  267. package/dist/commands/workflow/repo.js +1 -1
  268. package/dist/commands/workflow/run-facts.js +6 -0
  269. package/dist/commands/workflow/runs.js +747 -155
  270. package/dist/commands/workflow/runtime.js +8 -4
  271. package/dist/commands/workflow/status.js +259 -13
  272. package/dist/commands/workflow/step-table.js +41 -15
  273. package/dist/commands/workflow/steps.js +530 -26
  274. package/dist/commands/workflow/summary-findings.js +1 -1
  275. package/dist/commands/workflow/summary.js +289 -8
  276. package/dist/commands/workflow/tasks.js +294 -27
  277. package/dist/commands/workflow/tests-base.js +266 -0
  278. package/dist/commands/workflow/tests-changed.js +130 -56
  279. package/dist/commands/workflow/tests-jump.js +77 -0
  280. package/dist/commands/workflow/tests.js +608 -131
  281. package/dist/commands/workflow/tracker.js +920 -112
  282. package/dist/commands/workflow/workflows.js +80 -59
  283. package/dist/commands/workflow/worktrees.js +387 -58
  284. package/dist/install/cloud-env.js +32 -10
  285. package/dist/install/managed-block.js +101 -0
  286. package/dist/install/manifest.js +7 -1
  287. package/dist/install/modules/claude.js +6 -2
  288. package/dist/install/modules/cloud.js +73 -86
  289. package/dist/install/modules/codex.js +9 -2
  290. package/dist/install/modules/core.js +190 -27
  291. package/dist/install/modules/opencode.js +18 -23
  292. package/dist/install/network-allowlist.js +8 -3
  293. package/dist/install/project-docs.js +551 -0
  294. package/dist/install/template-copies.js +55 -5
  295. package/dist/install/write.js +117 -5
  296. package/dist/ledgers/journal.js +10 -8
  297. package/dist/ledgers/migrate.js +20 -9
  298. package/dist/ledgers/status.js +461 -8
  299. package/dist/ledgers/telemetry.js +71 -13
  300. package/dist/render/trackers.js +21 -12
  301. package/dist/shared/package-manager.js +7 -2
  302. package/dist/shared/settings.js +8 -0
  303. package/dist/shared/text.js +13 -0
  304. package/dist/tools/instructions-sources.js +1 -0
  305. package/dist/tools/instructions.js +97 -24
  306. package/package.json +23 -15
  307. package/.bkit/core/hooks/preflight-linear.sh +0 -73
  308. package/.bkit/shared/docs/architecture.md +0 -16
  309. package/.bkit/shared/docs/data-schema.md +0 -16
  310. package/.bkit/shared/docs/design.md +0 -38
  311. package/.bkit/shared/docs/noise.md +0 -20
  312. package/.bkit/shared/docs/observability.md +0 -22
  313. package/.bkit/shared/docs/security.md +0 -62
  314. package/.bkit/shared/docs/setup.md +0 -52
  315. package/.bkit/shared/docs/technology.md +0 -15
  316. /package/.bkit/templates/{.lintstagedrc.json → lintstagedrc.example.json} +0 -0
  317. /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",
@@ -219,6 +229,67 @@ function ghAsEngine(args) {
219
229
  env: token ? { ...process.env, GH_TOKEN: token } : process.env,
220
230
  });
221
231
  }
232
+ const TRIVY_PROTECTION_ACTION = "Before landing a check rename, save the branch-protection and applicable ruleset settings. " +
233
+ "Coordinate `trivy` → `bkit-trivy` with the workflow change; verify the new check on the candidate commit before requiring it. " +
234
+ "Change only that context, preserving strict mode, app_id / integration_id bindings, bypass policies and unrelated checks. " +
235
+ "Never disable protection to unblock the rename. Re-read the settings and run `bkit doctor` afterwards. This advisory changes no remote settings.";
236
+ /** Inspect existing protected branches without changing their checks or rulesets. */
237
+ export function buildTrivyProtectionAdvisory(cwd) {
238
+ if (!fs.existsSync(path.join(cwd, ".github", "workflows", "bkit-trivy.yml")))
239
+ return null;
240
+ const stale = [];
241
+ let incomplete = false;
242
+ try {
243
+ const response = parseJson(ghAsEngine(["api", "repos/{owner}/{repo}/branches?protected=true&per_page=11"]));
244
+ if (!response.ok || !Array.isArray(response.value))
245
+ throw new Error("Branch list unavailable");
246
+ const branches = response.value;
247
+ incomplete = branches.length > 10;
248
+ for (const branch of branches.slice(0, 10)) {
249
+ if (typeof branch.name !== "string") {
250
+ incomplete = true;
251
+ continue;
252
+ }
253
+ const contexts = branch.protection?.required_status_checks?.contexts ?? [];
254
+ if (contexts.includes("trivy"))
255
+ stale.push(branch.name);
256
+ const rules = parseJson(ghAsEngine([
257
+ "api",
258
+ `repos/{owner}/{repo}/rules/branches/${encodeURIComponent(branch.name)}?per_page=100`,
259
+ ]));
260
+ if (!rules.ok || !Array.isArray(rules.value)) {
261
+ incomplete = true;
262
+ continue;
263
+ }
264
+ if (rules.value.length === 100)
265
+ incomplete = true;
266
+ for (const rule of rules.value) {
267
+ if (rule?.type === "required_status_checks" &&
268
+ Array.isArray(rule.parameters?.required_status_checks) &&
269
+ rule.parameters.required_status_checks.some((check) => check.context === "trivy"))
270
+ stale.push(branch.name);
271
+ }
272
+ }
273
+ }
274
+ catch {
275
+ incomplete = true;
276
+ }
277
+ if (stale.length > 0)
278
+ return {
279
+ id: "trivy-required-check-rename",
280
+ severity: "advisory",
281
+ detect: `Protected branches still require \`trivy\`: ${[...new Set(stale)].join(", ")}. The template emits \`bkit-trivy\`.${incomplete ? " Other protection was not fully checked." : ""}`,
282
+ action: TRIVY_PROTECTION_ACTION,
283
+ };
284
+ if (incomplete)
285
+ return {
286
+ id: "trivy-required-check-unchecked",
287
+ severity: "advisory",
288
+ detect: "Trivy required checks are unchecked: a GitHub read failed or exceeded the scan limit (10 protected branches, 100 rules per branch).",
289
+ action: "Inspect all affected branches and rulesets in GitHub Settings. " + TRIVY_PROTECTION_ACTION,
290
+ };
291
+ return null;
292
+ }
222
293
  /**
223
294
  * Whether the engine's token can move cards on the configured board: "present",
224
295
  * "missing", or "unknown" (gh unavailable or unauthenticated). A classic token lists its
@@ -283,55 +354,87 @@ export function buildGithubProjectTokenScopeAdvisory(cwd) {
283
354
  /**
284
355
  * Emit a cloud-agents setup advisory (parity with the tracker / dep-updater
285
356
  * advisories). Post-CI auto-routing (`bkit-cloud.yml`) is opt-in via
286
- * `bkit install --auto=claude`; it does NOT ship with a default install. This nudges
287
- * 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.
288
359
  *
289
- * Also performs the cloud=claude config-consistency assertion: when
290
- * `bkit.cloud.agent === "claude"` but the installed `bkit-cloud.yml` lacks
291
- * `id-token: write`, it surfaces a consistency warning (exit-1 signal surfaced via
292
- * 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)
293
369
  *
294
- * Resolution order (file presence is authoritative, package.json field is the
295
- * opt-out):
296
- * - `.github/workflows/bkit-cloud.yml` present → `cloud-router` (informational; active)
297
- * - `bkit.cloud.agent === "none"` → null (opt-out — stay quiet)
298
- * - `bkit.tracker.default === "jira"` → null (Jira runs locally only)
299
- * - otherwise (undecided) → `cloud-router-none` (nudge to choose)
300
- *
301
- * 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
302
371
  * completion event).
303
372
  */
304
373
  export function buildCloudSetupAdvisory(cwd) {
305
374
  const routerPath = path.join(cwd, ".github", "workflows", "bkit-cloud.yml");
306
375
  if (fs.existsSync(routerPath)) {
307
- // Config-consistency assertion: cloud=claude requires id-token: write.
308
- // If the recorded variant is "claude" and the workflow file lacks id-token: write,
309
- // surface a consistency finding.
310
- if (readBkitConfig(cwd).cloudAgents === "claude") {
311
- const workflowContent = fs.readFileSync(routerPath, "utf-8");
312
- if (!workflowContent.includes("id-token: write")) {
313
- return {
314
- id: "cloud-claude-missing-id-token",
315
- severity: "blocker",
316
- 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.",
317
- 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.",
318
- };
319
- }
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
+ };
320
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)";
321
426
  return {
322
427
  id: "cloud-router",
323
428
  severity: "advisory",
324
- 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.",
325
- 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".`,
326
431
  };
327
432
  }
328
433
  // No router present — distinguish opt-out from undecided.
329
- const { cloudAgents, cloudAgentsExplicit, issueTracker } = readBkitConfig(cwd);
434
+ const { cloudAgents, cloudAgentsExplicit } = readBkitConfig(cwd);
330
435
  if (cloudAgents === "none" && cloudAgentsExplicit) {
331
436
  return null; // consumer explicitly chose `none` — stay quiet
332
437
  }
333
- if (issueTracker === "jira")
334
- return null; // no cloud setup exists for a Jira tracker
335
438
  // Only nudge if there's a workflows dir for the router to wake on.
336
439
  if (!fs.existsSync(path.join(cwd, ".github", "workflows")))
337
440
  return null;
@@ -339,8 +442,8 @@ export function buildCloudSetupAdvisory(cwd) {
339
442
  id: "cloud-router-none",
340
443
  severity: "advisory",
341
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.",
342
- 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" +
343
- "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" +
344
447
  'To opt out and silence this advisory, set `bkit.cloud.agent` to `"none"` in package.json.',
345
448
  };
346
449
  }
@@ -10,9 +10,10 @@ import { readBkitConfig } from "../../shared/settings.js";
10
10
  import { detectOpencodeYmlProviderDrift } from "../../install/modules/opencode.js";
11
11
  import { detectManagedDuplicate, detectManagedStale } from "./managed.js";
12
12
  import { buildCloudDashboardsAdvisory, detectCiRouterSecrets, detectGhMcpToken } from "./auth.js";
13
- import { buildCloudSetupAdvisory, buildGithubProjectAdvisory, buildGithubProjectTokenScopeAdvisory, buildTrackerSetupAdvisory, detectActionsWritePermissions, detectMainBranchProtection, } from "./github.js";
14
- import { buildDepUpdaterSetupAdvisory, detectBkitStubs, detectValeMissing, detectValePackageNotSynced, detectWorkflowLintToolsMissing, } from "./tools.js";
13
+ import { buildCloudSetupAdvisory, buildGithubProjectAdvisory, buildGithubProjectTokenScopeAdvisory, buildTrackerSetupAdvisory, buildTrivyProtectionAdvisory, detectActionsWritePermissions, detectMainBranchProtection, } from "./github.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,14 +262,18 @@ 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)
269
271
  // assert feat/* PRs target dev. Enforcing it at the GitHub layer needs branch
270
272
  // protection on main restricting merges to PRs from dev.
271
273
  const protectionStatus = detectMainBranchProtection();
274
+ const trivyProtection = buildTrivyProtectionAdvisory(cwd);
275
+ if (trivyProtection)
276
+ phase3.push(trivyProtection);
272
277
  const scriptHint = "\n\nQuick path: run `bkit setup protect-main --dry-run` to preview the policy, then drop `--dry-run` to apply. It requires the CI capstone job named by `package.json` `bkit.testing.ciCapstone` (default `bkit-tests-check`, so the required check means 'validated', not just 'tests job did not fail') and pre-flights that the job exists in the `bkit.testing.ciWorkflow` file before requiring it.";
273
278
  if (protectionStatus === "missing") {
274
279
  phase3.push({
@@ -368,6 +373,13 @@ export function runPostInstallCheck(preflightAdvisories, cwd = process.cwd(), su
368
373
  // bkit-stub sentinels in shipped templates — one advisory per still-commented stub.
369
374
  for (const stub of detectBkitStubs(cwd))
370
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
+ }
371
383
  // turbo.json inputs for cache-replay safety (KN-24).
372
384
  for (const f of detectTurboIntegrationInputs(cwd))
373
385
  phase3.push(f);