@cbartens/bkit 0.0.0-stage → 5.0.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (375) hide show
  1. package/.bkit/README.md +417 -0
  2. package/.bkit/core/.agents/context.md +95 -0
  3. package/.bkit/core/.agents/docs.md +62 -0
  4. package/.bkit/core/.agents/rules.md +147 -0
  5. package/.bkit/core/.agents/skills.md +43 -0
  6. package/.bkit/core/.bkit/LICENSE.md +151 -0
  7. package/.bkit/core/.bkit/README.md +417 -0
  8. package/.bkit/core/.bkit/cloud.md +493 -0
  9. package/.bkit/core/.bkit/comparison.md +321 -0
  10. package/.bkit/core/.bkit/install.md +401 -0
  11. package/.bkit/core/.bkit/jsonl.md +497 -0
  12. package/.bkit/core/.bkit/prompts.md +474 -0
  13. package/.bkit/core/.bkit/providers.md +598 -0
  14. package/.bkit/core/.bkit/templates.md +470 -0
  15. package/.bkit/core/.bkit/trackers.md +95 -0
  16. package/.bkit/core/.bkit/workflows.md +1550 -0
  17. package/.bkit/core/.claude/hooks/bkit-gateguard.cjs +82 -0
  18. package/.bkit/core/.claude/hooks/bkit-guardrails.cjs +93 -0
  19. package/.bkit/core/.claude/hooks/bkit-preflight.sh +74 -0
  20. package/.bkit/core/.codex/hooks/bkit-gateguard.cjs +115 -0
  21. package/.bkit/core/.codex/hooks/bkit-guardrails.cjs +135 -0
  22. package/.bkit/core/.cursor/hooks/bkit-gateguard.cjs +111 -0
  23. package/.bkit/core/.cursor/hooks/bkit-guardrails.cjs +169 -0
  24. package/.bkit/core/.cursor/hooks/bkit-preflight.sh +63 -0
  25. package/.bkit/core/.opencode/plugin/bkit-gateguard.js +225 -0
  26. package/.bkit/core/AGENTS.md +77 -0
  27. package/.bkit/core/LICENSE.md +149 -0
  28. package/.bkit/core/docs/templates/bkit-audit-accessibility.md +272 -0
  29. package/.bkit/core/docs/templates/bkit-audit-adoption.md +223 -0
  30. package/.bkit/core/docs/templates/bkit-audit-agents.md +230 -0
  31. package/.bkit/core/docs/templates/bkit-audit-aio-seo.md +227 -0
  32. package/.bkit/core/docs/templates/bkit-audit-analytics.md +266 -0
  33. package/.bkit/core/docs/templates/bkit-audit-annotations.md +230 -0
  34. package/.bkit/core/docs/templates/bkit-audit-app-performance.md +270 -0
  35. package/.bkit/core/docs/templates/bkit-audit-app-store.md +254 -0
  36. package/.bkit/core/docs/templates/bkit-audit-architecture.md +221 -0
  37. package/.bkit/core/docs/templates/bkit-audit-ci-performance.md +241 -0
  38. package/.bkit/core/docs/templates/bkit-audit-config.md +230 -0
  39. package/.bkit/core/docs/templates/bkit-audit-cost.md +218 -0
  40. package/.bkit/core/docs/templates/bkit-audit-coverage.md +221 -0
  41. package/.bkit/core/docs/templates/bkit-audit-database.md +229 -0
  42. package/.bkit/core/docs/templates/bkit-audit-dead-code.md +251 -0
  43. package/.bkit/core/docs/templates/bkit-audit-deferrals.md +283 -0
  44. package/.bkit/core/docs/templates/bkit-audit-dependencies.md +268 -0
  45. package/.bkit/core/docs/templates/bkit-audit-documentation.md +280 -0
  46. package/.bkit/core/docs/templates/bkit-audit-duplication.md +253 -0
  47. package/.bkit/core/docs/templates/bkit-audit-failures.md +259 -0
  48. package/.bkit/core/docs/templates/bkit-audit-flakes.md +237 -0
  49. package/.bkit/core/docs/templates/bkit-audit-gates.md +250 -0
  50. package/.bkit/core/docs/templates/bkit-audit-issues.md +273 -0
  51. package/.bkit/core/docs/templates/bkit-audit-llm.md +239 -0
  52. package/.bkit/core/docs/templates/bkit-audit-logs.md +266 -0
  53. package/.bkit/core/docs/templates/bkit-audit-models.md +210 -0
  54. package/.bkit/core/docs/templates/bkit-audit-privacy.md +211 -0
  55. package/.bkit/core/docs/templates/bkit-audit-prompts.md +216 -0
  56. package/.bkit/core/docs/templates/bkit-audit-red-team.md +220 -0
  57. package/.bkit/core/docs/templates/bkit-audit-reliability.md +222 -0
  58. package/.bkit/core/docs/templates/bkit-audit-repo.md +224 -0
  59. package/.bkit/core/docs/templates/bkit-audit-security.md +274 -0
  60. package/.bkit/core/docs/templates/bkit-audit-slop.md +200 -0
  61. package/.bkit/core/docs/templates/bkit-audit-testing.md +270 -0
  62. package/.bkit/core/docs/templates/bkit-audit-usability.md +237 -0
  63. package/.bkit/core/docs/templates/bkit-plan.md +476 -0
  64. package/.bkit/core/engine/checks/after/auth.ts +149 -0
  65. package/.bkit/core/engine/checks/after/ci-yml.ts +701 -0
  66. package/.bkit/core/engine/checks/after/github.ts +424 -0
  67. package/.bkit/core/engine/checks/after/index.ts +530 -0
  68. package/.bkit/core/engine/checks/after/managed.ts +217 -0
  69. package/.bkit/core/engine/checks/after/suppression.ts +53 -0
  70. package/.bkit/core/engine/checks/after/tools.ts +427 -0
  71. package/.bkit/core/engine/checks/before/context-fetch.ts +429 -0
  72. package/.bkit/core/engine/checks/before/env.ts +187 -0
  73. package/.bkit/core/engine/checks/before/files.ts +204 -0
  74. package/.bkit/core/engine/checks/before/index.ts +206 -0
  75. package/.bkit/core/engine/checks/before/mcp.ts +127 -0
  76. package/.bkit/core/engine/checks/before/repo.ts +77 -0
  77. package/.bkit/core/engine/checks/before/version.ts +67 -0
  78. package/.bkit/core/engine/checks/status-holes.ts +479 -0
  79. package/.bkit/core/engine/cli.ts +867 -0
  80. package/.bkit/core/engine/commands/analysis.ts +550 -0
  81. package/.bkit/core/engine/commands/ci/ci.ts +483 -0
  82. package/.bkit/core/engine/commands/comply.ts +415 -0
  83. package/.bkit/core/engine/commands/harvest.ts +459 -0
  84. package/.bkit/core/engine/commands/install/check.ts +70 -0
  85. package/.bkit/core/engine/commands/install/doctor.ts +254 -0
  86. package/.bkit/core/engine/commands/install/install.ts +550 -0
  87. package/.bkit/core/engine/commands/install/uninstall.ts +995 -0
  88. package/.bkit/core/engine/commands/install/upgrade.ts +1037 -0
  89. package/.bkit/core/engine/commands/launch.ts +139 -0
  90. package/.bkit/core/engine/commands/lib.ts +495 -0
  91. package/.bkit/core/engine/commands/registry.ts +53 -0
  92. package/.bkit/core/engine/commands/setup/setup.ts +184 -0
  93. package/.bkit/core/engine/commands/telemetry.ts +32 -0
  94. package/.bkit/core/engine/commands/workflow/branches.ts +1514 -0
  95. package/.bkit/core/engine/commands/workflow/context.ts +961 -0
  96. package/.bkit/core/engine/commands/workflow/counters.ts +268 -0
  97. package/.bkit/core/engine/commands/workflow/fids.ts +243 -0
  98. package/.bkit/core/engine/commands/workflow/issues.ts +675 -0
  99. package/.bkit/core/engine/commands/workflow/ledgers.ts +575 -0
  100. package/.bkit/core/engine/commands/workflow/locks.ts +478 -0
  101. package/.bkit/core/engine/commands/workflow/prs.ts +1087 -0
  102. package/.bkit/core/engine/commands/workflow/repo.ts +220 -0
  103. package/.bkit/core/engine/commands/workflow/roadmap.ts +576 -0
  104. package/.bkit/core/engine/commands/workflow/runs.ts +2140 -0
  105. package/.bkit/core/engine/commands/workflow/runtime.ts +300 -0
  106. package/.bkit/core/engine/commands/workflow/skills.ts +118 -0
  107. package/.bkit/core/engine/commands/workflow/status.ts +455 -0
  108. package/.bkit/core/engine/commands/workflow/steps.ts +1300 -0
  109. package/.bkit/core/engine/commands/workflow/tests.ts +161 -0
  110. package/.bkit/core/engine/commands/workflow/workflows.ts +1573 -0
  111. package/.bkit/core/engine/commands/workflow/workstreams.ts +164 -0
  112. package/.bkit/core/engine/commands/workflow/worktrees.ts +534 -0
  113. package/.bkit/core/engine/install/cloud-env.ts +924 -0
  114. package/.bkit/core/engine/install/managed-block.ts +212 -0
  115. package/.bkit/core/engine/install/manifest.ts +448 -0
  116. package/.bkit/core/engine/install/modules/claude.ts +362 -0
  117. package/.bkit/core/engine/install/modules/cloud.ts +173 -0
  118. package/.bkit/core/engine/install/modules/codex.ts +219 -0
  119. package/.bkit/core/engine/install/modules/core.ts +620 -0
  120. package/.bkit/core/engine/install/modules/cursor.ts +231 -0
  121. package/.bkit/core/engine/install/modules/index.ts +242 -0
  122. package/.bkit/core/engine/install/modules/opencode.ts +573 -0
  123. package/.bkit/core/engine/install/payload-links.ts +150 -0
  124. package/.bkit/core/engine/install/placeholders.ts +108 -0
  125. package/.bkit/core/engine/install/template-copies.ts +119 -0
  126. package/.bkit/core/engine/install/version-file.ts +284 -0
  127. package/.bkit/core/engine/install/write.ts +467 -0
  128. package/.bkit/core/engine/ledgers/clamp-log.ts +32 -0
  129. package/.bkit/core/engine/ledgers/status.ts +213 -0
  130. package/.bkit/core/engine/ledgers/telemetry.ts +1143 -0
  131. package/.bkit/core/engine/render/hosts.ts +372 -0
  132. package/.bkit/core/engine/render/models.ts +323 -0
  133. package/.bkit/core/engine/render/parts.ts +38 -0
  134. package/.bkit/core/engine/render/trackers.ts +170 -0
  135. package/.bkit/core/engine/shared/egress.ts +345 -0
  136. package/.bkit/core/engine/shared/json.ts +16 -0
  137. package/.bkit/core/engine/shared/log-prefix.ts +9 -0
  138. package/.bkit/core/engine/shared/package-json.ts +29 -0
  139. package/.bkit/core/engine/shared/package-manager.ts +38 -0
  140. package/.bkit/core/engine/shared/package-roots.ts +163 -0
  141. package/.bkit/core/engine/shared/protected-paths.ts +164 -0
  142. package/.bkit/core/engine/shared/settings.ts +72 -0
  143. package/.bkit/core/engine/shared/timeouts.ts +20 -0
  144. package/.bkit/core/engine/tools/wording.ts +748 -0
  145. package/.bkit/core/hooks/gateguard-edit-payload.js +18 -0
  146. package/.bkit/core/hooks/gateguard-engine.js +193 -0
  147. package/.bkit/core/hooks/guardrails-shell.js +154 -0
  148. package/.bkit/core/hooks/guardrails-tiers.js +68 -0
  149. package/.bkit/core/hooks/preflight-linear.sh +73 -0
  150. package/.bkit/core/prompts/bkit-audit-generate.md +66 -0
  151. package/.bkit/core/prompts/bkit-build-challenge-1.md +79 -0
  152. package/.bkit/core/prompts/bkit-build-challenge-2.md +81 -0
  153. package/.bkit/core/prompts/bkit-build-challenge-reconcile.md +68 -0
  154. package/.bkit/core/prompts/bkit-build-challenge-remediate.md +70 -0
  155. package/.bkit/core/prompts/bkit-build-challenge-tests.md +73 -0
  156. package/.bkit/core/prompts/bkit-build-install-skills.md +67 -0
  157. package/.bkit/core/prompts/bkit-build-plan-current.md +75 -0
  158. package/.bkit/core/prompts/bkit-build-plan-execute.md +72 -0
  159. package/.bkit/core/prompts/bkit-build-plan-gaps-remediate.md +73 -0
  160. package/.bkit/core/prompts/bkit-build-plan-verify.md +88 -0
  161. package/.bkit/core/prompts/bkit-build-summary.md +93 -0
  162. package/.bkit/core/prompts/bkit-debug-abort-handover.md +90 -0
  163. package/.bkit/core/prompts/bkit-debug-failure-diagnose.md +151 -0
  164. package/.bkit/core/prompts/bkit-debug-failure-remediate.md +78 -0
  165. package/.bkit/core/prompts/bkit-debug-failure-soak.md +73 -0
  166. package/.bkit/core/prompts/bkit-debug-summary.md +95 -0
  167. package/.bkit/core/prompts/bkit-design-brainstorm-ideate-1.md +72 -0
  168. package/.bkit/core/prompts/bkit-design-brainstorm-ideate-2.md +72 -0
  169. package/.bkit/core/prompts/bkit-design-brainstorm-ideate-3.md +75 -0
  170. package/.bkit/core/prompts/bkit-design-generate.md +110 -0
  171. package/.bkit/core/prompts/bkit-design-organise.md +85 -0
  172. package/.bkit/core/prompts/bkit-design-review-1.md +121 -0
  173. package/.bkit/core/prompts/bkit-design-review-2.md +111 -0
  174. package/.bkit/core/prompts/bkit-design-spike.md +97 -0
  175. package/.bkit/core/prompts/bkit-design-summary.md +106 -0
  176. package/.bkit/core/prompts/bkit-design-update.md +66 -0
  177. package/.bkit/core/prompts/bkit-plan-complexity-check.md +66 -0
  178. package/.bkit/core/prompts/bkit-plan-complexity-split.md +87 -0
  179. package/.bkit/core/prompts/bkit-plan-generate.md +74 -0
  180. package/.bkit/core/prompts/bkit-plan-review-1.md +90 -0
  181. package/.bkit/core/prompts/bkit-plan-review-2.md +80 -0
  182. package/.bkit/core/prompts/bkit-plan-review-3.md +92 -0
  183. package/.bkit/core/prompts/bkit-plan-scope-check-1.md +84 -0
  184. package/.bkit/core/prompts/bkit-plan-scope-check-2.md +84 -0
  185. package/.bkit/core/prompts/bkit-plan-summary.md +106 -0
  186. package/.bkit/core/prompts/bkit-plan-update.md +68 -0
  187. package/.bkit/core/prompts/bkit-ship-conflict-resolve.md +90 -0
  188. package/.bkit/core/prompts/bkit-ship-deferred-sweep.md +94 -0
  189. package/.bkit/core/prompts/bkit-ship-summary.md +77 -0
  190. package/.bkit/core/prompts/bkit-ship-update-docs.md +71 -0
  191. package/.bkit/core/prompts/bkit-utility-compress-markdown.md +91 -0
  192. package/.bkit/core/prompts/bkit-utility-update-decisions.md +75 -0
  193. package/.bkit/core/prompts/bkit-utility-update-deferrals.md +76 -0
  194. package/.bkit/core/prompts/bkit-utility-update-documentation.md +61 -0
  195. package/.bkit/core/prompts/bkit-utility-update-failures.md +76 -0
  196. package/.bkit/core/prompts/bkit-utility-update-knowledge.md +75 -0
  197. package/.bkit/core/prompts/bkit-utility-update-roadmap.md +82 -0
  198. package/.bkit/core/workflows/bkit-auto.md +121 -0
  199. package/.bkit/core/workflows/bkit-build.md +802 -0
  200. package/.bkit/core/workflows/bkit-debug.md +649 -0
  201. package/.bkit/core/workflows/bkit-design.md +495 -0
  202. package/.bkit/core/workflows/bkit-plan.md +510 -0
  203. package/.bkit/core/workflows/bkit-ship.md +650 -0
  204. package/.bkit/shared/.bkit/.env.example +86 -0
  205. package/.bkit/shared/.claude/bkit-cloud.md +117 -0
  206. package/.bkit/shared/.claude/settings.json +88 -0
  207. package/.bkit/shared/.codex/hooks.json +26 -0
  208. package/.bkit/shared/.cursor/bkit-cloud.md +84 -0
  209. package/.bkit/shared/.cursor/hooks.json +26 -0
  210. package/.bkit/shared/.cursor/mcp.json +15 -0
  211. package/.bkit/shared/.cursor/rules/bkit-rules.mdc +12 -0
  212. package/.bkit/shared/.gitattributes +37 -0
  213. package/.bkit/shared/.mcp.json +16 -0
  214. package/.bkit/shared/.opencode/opencode.json +62 -0
  215. package/.bkit/shared/CLAUDE.md +11 -0
  216. package/.bkit/shared/LICENSE.md +22 -0
  217. package/.bkit/shared/docs/architecture.md +19 -0
  218. package/.bkit/shared/docs/data-schema.md +19 -0
  219. package/.bkit/shared/docs/deployments.md +433 -0
  220. package/.bkit/shared/docs/design.md +39 -0
  221. package/.bkit/shared/docs/noise.md +19 -0
  222. package/.bkit/shared/docs/observability.md +25 -0
  223. package/.bkit/shared/docs/security.md +42 -0
  224. package/.bkit/shared/docs/setup.md +30 -0
  225. package/.bkit/shared/docs/technology.md +18 -0
  226. package/.bkit/shared/docs/testing.md +413 -0
  227. package/.bkit/shared/gitignore +97 -0
  228. package/.bkit/templates/.claude/hooks/bkit-cloud-bootstrap.sh +187 -0
  229. package/.bkit/templates/.cursor/Dockerfile +68 -0
  230. package/.bkit/templates/.cursor/environment.json +6 -0
  231. package/.bkit/templates/.cursor/settings.json +11 -0
  232. package/.bkit/templates/.envrc +7 -0
  233. package/.bkit/templates/.github/dependabot.yml +52 -0
  234. package/.bkit/templates/.github/renovate.json5 +224 -0
  235. package/.bkit/templates/.github/workflows/bkit-ci.yml +1062 -0
  236. package/.bkit/templates/.github/workflows/bkit-cloud.yml +564 -0
  237. package/.bkit/templates/.github/workflows/bkit-renovate.yml +102 -0
  238. package/.bkit/templates/.graphifyignore +108 -0
  239. package/.bkit/templates/.husky/pre-commit +16 -0
  240. package/.bkit/templates/.husky/pre-push +91 -0
  241. package/.bkit/templates/.lintstagedrc.json +3 -0
  242. package/.bkit/templates/.prettierignore +41 -0
  243. package/.bkit/templates/.serena/project.yml +243 -0
  244. package/.bkit/templates/.vale/styles/House/Filler.yml +11 -0
  245. package/.bkit/templates/.vale/styles/House/Hedging.yml +12 -0
  246. package/.bkit/templates/.vale/styles/House/LLMSlop.yml +13 -0
  247. package/.bkit/templates/.vale/styles/House/Verbose.yml +12 -0
  248. package/.bkit/templates/.vale.ini +67 -0
  249. package/.bkit/templates/LICENSE.md +22 -0
  250. package/.bkit/templates/context/bkit-cloudrun.md +84 -0
  251. package/.bkit/templates/context/bkit-expo.md +186 -0
  252. package/.bkit/templates/context/bkit-github.md +79 -0
  253. package/.bkit/templates/context/bkit-inngest.md +45 -0
  254. package/.bkit/templates/context/bkit-maestro.md +76 -0
  255. package/.bkit/templates/context/bkit-playwright.md +62 -0
  256. package/.bkit/templates/context/bkit-resend.md +36 -0
  257. package/.bkit/templates/context/bkit-sentry.md +65 -0
  258. package/.bkit/templates/context/bkit-serena.md +33 -0
  259. package/.bkit/templates/context/bkit-stripe.md +36 -0
  260. package/.bkit/templates/context/bkit-supabase.md +59 -0
  261. package/.bkit/templates/context/bkit-tavily.md +49 -0
  262. package/.bkit/templates/context/bkit-vercel.md +64 -0
  263. package/.bkit/templates/docs/capabilities.md +72 -0
  264. package/.bkit/templates/scripts/ci/accepted-divergences.json +21 -0
  265. package/.bkit/templates/scripts/ci/check-accepted-divergences.mjs +152 -0
  266. package/.bkit/templates/scripts/ci/check-accepted-divergences.test.mjs +130 -0
  267. package/.bkit/templates/scripts/ci/lanes/resolve-push-base.mjs +98 -0
  268. package/.bkit/templates/scripts/ci/lanes/resolve-push-base.test.mjs +86 -0
  269. package/.bkit/templates/scripts/graphify/bkit-graph-drift-rules.json +23 -0
  270. package/.bkit/templates/scripts/graphify/bkit-graph-drift.py +208 -0
  271. package/.bkit/templates/scripts/graphify/bkit-graph-eager-rules.json +35 -0
  272. package/.bkit/templates/scripts/graphify/bkit-graph-eager.py +236 -0
  273. package/.bkit/templates/scripts/graphify/bkit-graph-external-rules.json +17 -0
  274. package/.bkit/templates/scripts/graphify/bkit-graph-imports.py +290 -0
  275. package/.bkit/templates/scripts/graphify/bkit-graph-pre-push.sh +19 -0
  276. package/.bkit/templates/scripts/graphify/bkit-graph-repair.py +120 -0
  277. package/.bkit/templates/scripts/graphify/bkit-graph-surface.py +232 -0
  278. package/.bkit/templates/scripts/graphify/bkit-graphify-graphml.py +36 -0
  279. package/.bkit/templates/scripts/graphify/bkit-graphify-rollup.py +927 -0
  280. package/.bkit/templates/scripts/graphify/bkit-graphify.sh +351 -0
  281. package/.bkit/templates/scripts/launchd/ai.bkit.launchd.plist +26 -0
  282. package/.bkit/templates/scripts/launchd/bkit-launchd-env.sh +53 -0
  283. package/.bkit/templates/scripts/launchd/launchd.env.example +13 -0
  284. package/.bkit/templates/scripts/prettier/bkit-insert-ignore.mjs +275 -0
  285. package/.bkit/templates/scripts/secrets/bkit-secrets.config.mjs +66 -0
  286. package/.bkit/templates/scripts/secrets/bkit-secrets.mjs +785 -0
  287. package/.bkit/templates/scripts/serena/bkit-serena-mcp.sh +30 -0
  288. package/.bkit/templates/scripts/serena/bkit-serena.mcp.json +9 -0
  289. package/.bkit/templates/scripts/slop/bkit-slop-type-suppression.mjs +286 -0
  290. package/.bkit/templates/slop-scan.config.json +120 -0
  291. package/CHANGELOG.md +1503 -0
  292. package/LICENSE.md +161 -0
  293. package/README.md +184 -2
  294. package/dist/checks/after/auth.js +140 -0
  295. package/dist/checks/after/ci-yml.js +681 -0
  296. package/dist/checks/after/github.js +400 -0
  297. package/dist/checks/after/index.js +431 -0
  298. package/dist/checks/after/managed.js +187 -0
  299. package/dist/checks/after/suppression.js +39 -0
  300. package/dist/checks/after/tools.js +351 -0
  301. package/dist/checks/before/context-fetch.js +426 -0
  302. package/dist/checks/before/env.js +163 -0
  303. package/dist/checks/before/files.js +187 -0
  304. package/dist/checks/before/index.js +162 -0
  305. package/dist/checks/before/mcp.js +111 -0
  306. package/dist/checks/before/repo.js +71 -0
  307. package/dist/checks/before/version.js +60 -0
  308. package/dist/checks/status-holes.js +393 -0
  309. package/dist/cli.js +688 -0
  310. package/dist/commands/analysis.js +325 -0
  311. package/dist/commands/ci/ci.js +438 -0
  312. package/dist/commands/comply.js +310 -0
  313. package/dist/commands/harvest.js +354 -0
  314. package/dist/commands/install/check.js +61 -0
  315. package/dist/commands/install/doctor.js +209 -0
  316. package/dist/commands/install/install.js +475 -0
  317. package/dist/commands/install/uninstall.js +839 -0
  318. package/dist/commands/install/upgrade.js +782 -0
  319. package/dist/commands/launch.js +118 -0
  320. package/dist/commands/lib.js +363 -0
  321. package/dist/commands/registry.js +50 -0
  322. package/dist/commands/setup/setup.js +158 -0
  323. package/dist/commands/telemetry.js +29 -0
  324. package/dist/commands/workflow/branches.js +1265 -0
  325. package/dist/commands/workflow/context.js +846 -0
  326. package/dist/commands/workflow/counters.js +227 -0
  327. package/dist/commands/workflow/fids.js +224 -0
  328. package/dist/commands/workflow/issues.js +585 -0
  329. package/dist/commands/workflow/ledgers.js +472 -0
  330. package/dist/commands/workflow/locks.js +364 -0
  331. package/dist/commands/workflow/prs.js +904 -0
  332. package/dist/commands/workflow/repo.js +199 -0
  333. package/dist/commands/workflow/roadmap.js +495 -0
  334. package/dist/commands/workflow/runs.js +1717 -0
  335. package/dist/commands/workflow/runtime.js +257 -0
  336. package/dist/commands/workflow/skills.js +110 -0
  337. package/dist/commands/workflow/status.js +392 -0
  338. package/dist/commands/workflow/steps.js +1093 -0
  339. package/dist/commands/workflow/tests.js +144 -0
  340. package/dist/commands/workflow/workflows.js +1342 -0
  341. package/dist/commands/workflow/workstreams.js +141 -0
  342. package/dist/commands/workflow/worktrees.js +473 -0
  343. package/dist/install/cloud-env.js +818 -0
  344. package/dist/install/managed-block.js +182 -0
  345. package/dist/install/manifest.js +376 -0
  346. package/dist/install/modules/claude.js +288 -0
  347. package/dist/install/modules/cloud.js +151 -0
  348. package/dist/install/modules/codex.js +193 -0
  349. package/dist/install/modules/core.js +531 -0
  350. package/dist/install/modules/cursor.js +186 -0
  351. package/dist/install/modules/index.js +152 -0
  352. package/dist/install/modules/opencode.js +504 -0
  353. package/dist/install/payload-links.js +119 -0
  354. package/dist/install/placeholders.js +87 -0
  355. package/dist/install/template-copies.js +106 -0
  356. package/dist/install/version-file.js +204 -0
  357. package/dist/install/write.js +342 -0
  358. package/dist/ledgers/clamp-log.js +27 -0
  359. package/dist/ledgers/status.js +156 -0
  360. package/dist/ledgers/telemetry.js +637 -0
  361. package/dist/render/hosts.js +339 -0
  362. package/dist/render/models.js +288 -0
  363. package/dist/render/parts.js +33 -0
  364. package/dist/render/trackers.js +135 -0
  365. package/dist/shared/egress.js +299 -0
  366. package/dist/shared/json.js +16 -0
  367. package/dist/shared/log-prefix.js +7 -0
  368. package/dist/shared/package-json.js +22 -0
  369. package/dist/shared/package-manager.js +32 -0
  370. package/dist/shared/package-roots.js +145 -0
  371. package/dist/shared/protected-paths.js +153 -0
  372. package/dist/shared/settings.js +44 -0
  373. package/dist/shared/timeouts.js +19 -0
  374. package/dist/tools/wording.js +680 -0
  375. package/package.json +101 -4
@@ -0,0 +1,530 @@
1
+ // checks/after/index.ts — Phase 3: re-detect AFTER writes; produce the unified output.
2
+ // runPostInstallCheck calls the detectors in this folder (one file per group of findings);
3
+ // this file also formats the checklist and writes `.bkit/advisories.md`.
4
+
5
+ import * as fs from "node:fs";
6
+ import * as path from "node:path";
7
+ import { type PreflightFinding, dedupeById } from "../before/index.js";
8
+ import {
9
+ detectMissingDotenv,
10
+ detectBlankDotenvKeys,
11
+ detectDirenvMissing,
12
+ detectDirenvNotAllowed,
13
+ } from "../before/env.js";
14
+ import { getPkgRoot } from "../../shared/package-roots.js";
15
+ import { detectOpencodeYmlProviderDrift } from "../../install/modules/opencode.js";
16
+ import { TEMPLATES_POINTER } from "../../install/template-copies.js";
17
+ import { detectManagedStale } from "./managed.js";
18
+ import {
19
+ buildCloudDashboardsAdvisory,
20
+ detectCiRouterSecrets,
21
+ detectShellGhMcpToken,
22
+ hasGithubMcpServer,
23
+ } from "./auth.js";
24
+ import {
25
+ buildCloudSetupAdvisory,
26
+ buildGithubProjectAdvisory,
27
+ buildTrackerSetupAdvisory,
28
+ detectActionsWritePermissions,
29
+ detectGithubProjectFieldIdFormat,
30
+ detectMainBranchProtection,
31
+ readConsumerIssueTracker,
32
+ } from "./github.js";
33
+ import {
34
+ buildDepUpdaterSetupAdvisory,
35
+ detectBkitStubs,
36
+ detectValePackageNotSynced,
37
+ detectWorkflowLintToolsMissing,
38
+ } from "./tools.js";
39
+ import {
40
+ detectBkitCloudYmlAlwaysTrueGate,
41
+ detectCiYmlCapstoneContractDrift,
42
+ detectCiYmlMissingActionlint,
43
+ detectCiYmlRunInjection,
44
+ detectGhaFloatingTags,
45
+ detectRunLevelsNotComposed,
46
+ detectTaggedTestsWithoutCiHome,
47
+ detectTestIntegrationEnv,
48
+ detectTurboIntegrationInputs,
49
+ } from "./ci-yml.js";
50
+ import { type SuppressionNote, type SuppressionReporter } from "./suppression.js";
51
+
52
+ // ---------------------------------------------------------------------------
53
+ // formatChecklist — pure renderer
54
+ // ---------------------------------------------------------------------------
55
+
56
+ // ---------------------------------------------------------------------------
57
+ // Shared advisory text — the console checklist (`formatChecklist`) and the
58
+ // `.bkit/advisories.md` artifact (`renderAdvisoriesMarkdown`) render the SAME
59
+ // words; only the medium decoration differs (`#` / `**` / `>` in markdown, the
60
+ // `===` banner in the console). One source, so the two can never drift.
61
+ // ---------------------------------------------------------------------------
62
+
63
+ /** Title line, shared by both surfaces. */
64
+ export const ADVISORIES_TITLE = "bkit advisories";
65
+
66
+ /** Agent instruction line, shared by both surfaces. */
67
+ export const ADVISORIES_AGENT_INSTRUCTIONS =
68
+ "INSTRUCTIONS FOR AN AI AGENT — copy this file (or specific items) into a coding assistant to apply each item. Each ACTION is self-contained.";
69
+
70
+ /** `N finding(s) — B blocker, A advisory.` — the summary both surfaces print. */
71
+ export function advisoriesSummary(findings: PreflightFinding[]): string {
72
+ const blockerCount = findings.filter((f) => f.severity === "blocker").length;
73
+ const advisoryCount = findings.filter((f) => f.severity === "advisory").length;
74
+ return `${findings.length} finding(s) — ${blockerCount} blocker, ${advisoryCount} advisory.`;
75
+ }
76
+
77
+ /**
78
+ * The suppressed-advisory lines both surfaces print. One entry per opt-out, so a package
79
+ * that dismissed an advisory is never silently invisible. Returns `[]` when nothing was
80
+ * suppressed — callers then emit no such block.
81
+ */
82
+ export function suppressedNoteLines(suppressed: SuppressionNote[]): string[] {
83
+ if (suppressed.length === 0) return [];
84
+ const n = suppressed.length;
85
+ return [
86
+ `${n} advisor${n === 1 ? "y" : "ies"} suppressed by bkit.ignoreAdvisories:`,
87
+ ...suppressed.map((note) => `- ${note.id} (${note.scope})`),
88
+ ];
89
+ }
90
+
91
+ /**
92
+ * Format a list of findings into the post-install console checklist.
93
+ * Returns `""` when findings AND suppressed are both empty — callers can `if (banner)` to
94
+ * stay silent. No console.log inside — caller logs.
95
+ *
96
+ * Same content as `renderAdvisoriesMarkdown`: title, summary, agent instructions
97
+ * and template pointer are the shared strings; only the separators differ from
98
+ * the markdown form.
99
+ *
100
+ * Format per finding:
101
+ * --- i/N [severity] id ---
102
+ * Detect: ...
103
+ * Action: ...
104
+ *
105
+ * `suppressed` is appended as its own block (see `suppressedNoteLines`) — a dismissed
106
+ * advisory stays visible even when nothing else fired.
107
+ */
108
+ export function formatChecklist(
109
+ findings: PreflightFinding[],
110
+ suppressed: SuppressionNote[] = [],
111
+ ): string {
112
+ if (findings.length === 0 && suppressed.length === 0) return "";
113
+
114
+ const banner = "=".repeat(58);
115
+ const total = findings.length;
116
+ const lines: string[] = [];
117
+
118
+ lines.push("");
119
+ lines.push(banner);
120
+ lines.push(ADVISORIES_TITLE);
121
+ lines.push(banner);
122
+ lines.push("");
123
+ if (findings.length > 0) {
124
+ lines.push(advisoriesSummary(findings));
125
+ lines.push("");
126
+ lines.push(ADVISORIES_AGENT_INSTRUCTIONS);
127
+ lines.push("");
128
+ lines.push(TEMPLATES_POINTER);
129
+ lines.push("");
130
+ }
131
+
132
+ for (let i = 0; i < findings.length; i++) {
133
+ const f = findings[i]!;
134
+ lines.push(`--- ${i + 1}/${total} [${f.severity}] ${f.id} ---`);
135
+ lines.push(`Detect: ${f.detect}`);
136
+ lines.push(`Action: ${f.action}`);
137
+ lines.push("");
138
+ }
139
+
140
+ const suppressedLines = suppressedNoteLines(suppressed);
141
+ if (suppressedLines.length > 0) {
142
+ lines.push(...suppressedLines);
143
+ lines.push("");
144
+ }
145
+
146
+ lines.push(banner);
147
+ lines.push("");
148
+
149
+ return lines.join("\n");
150
+ }
151
+
152
+ // ---------------------------------------------------------------------------
153
+ // Advisories artifact — `.bkit/advisories.md`
154
+ // ---------------------------------------------------------------------------
155
+
156
+ export type AdvisoriesMode = "install" | "check" | "doctor";
157
+
158
+ /**
159
+ * Render findings as a markdown artifact suitable for `.bkit/advisories.md`.
160
+ * Renders the SAME content as `formatChecklist` (shared title, summary, agent
161
+ * instructions, template pointer and suppressed block) in markdown form, so the file can
162
+ * be referenced and revisited between installs. Overwritten on every run.
163
+ */
164
+ export function renderAdvisoriesMarkdown(
165
+ findings: PreflightFinding[],
166
+ opts: { mode: AdvisoriesMode; version: string },
167
+ suppressed: SuppressionNote[] = [],
168
+ ): string {
169
+ const lines: string[] = [];
170
+ // This is a generated, gitignored artifact — not authored prose. Advisory
171
+ // strings (and reproduced config snippets like `.vale.ini`'s `write-good.So =
172
+ // NO`) legitimately contain sentence-initial "So" and slop tokens. The shipped
173
+ // `lint:prose` globs on-disk `.agents/*.md`, so without this whole-file Vale
174
+ // skip the husky hooks fail on a file the consumer cannot edit.
175
+ lines.push("<!-- vale off -->");
176
+ lines.push("");
177
+ lines.push(`# ${ADVISORIES_TITLE}`);
178
+ lines.push("");
179
+ lines.push(`_bkit: ${opts.version}_ `);
180
+ lines.push(`_Mode: ${opts.mode}_`);
181
+ lines.push("");
182
+ lines.push(
183
+ "> Auto-generated by `bkit install` / `bkit check` / `bkit doctor`. Overwritten on each run.",
184
+ );
185
+ lines.push("");
186
+
187
+ if (findings.length === 0 && suppressed.length === 0) {
188
+ lines.push("**No advisories.** Last run was clean.");
189
+ lines.push("");
190
+ return lines.join("\n");
191
+ }
192
+
193
+ if (findings.length > 0) {
194
+ lines.push(advisoriesSummary(findings));
195
+ lines.push("");
196
+ lines.push(`> ${ADVISORIES_AGENT_INSTRUCTIONS}`);
197
+ lines.push("");
198
+ lines.push(`> ${TEMPLATES_POINTER}`);
199
+ lines.push("");
200
+ }
201
+
202
+ const total = findings.length;
203
+ for (let i = 0; i < total; i++) {
204
+ const f = findings[i]!;
205
+ lines.push(`## ${i + 1}/${total} [${f.severity}] ${f.id}`);
206
+ lines.push("");
207
+ lines.push(`**Detect:** ${f.detect}`);
208
+ lines.push("");
209
+ lines.push(`**Action:** ${f.action}`);
210
+ lines.push("");
211
+ }
212
+
213
+ const suppressedLines = suppressedNoteLines(suppressed);
214
+ if (suppressedLines.length > 0) {
215
+ lines.push(...suppressedLines);
216
+ lines.push("");
217
+ }
218
+
219
+ return lines.join("\n");
220
+ }
221
+
222
+ /**
223
+ * Write `.bkit/advisories.md` in the consumer's cwd. Best-effort:
224
+ * mkdir -p `.agents/`, write the rendered markdown, log a one-line status.
225
+ * Any I/O failure is logged but does not throw — the artifact is informational.
226
+ */
227
+ export function writeAdvisoriesArtifact(
228
+ findings: PreflightFinding[],
229
+ opts: {
230
+ cwd: string;
231
+ mode: AdvisoriesMode;
232
+ version: string;
233
+ logPrefix: string;
234
+ suppressed?: SuppressionNote[];
235
+ },
236
+ ): void {
237
+ const dir = path.join(opts.cwd, ".bkit");
238
+ const filePath = path.join(dir, "advisories.md");
239
+ try {
240
+ fs.mkdirSync(dir, { recursive: true });
241
+ const content = renderAdvisoriesMarkdown(
242
+ findings,
243
+ {
244
+ mode: opts.mode,
245
+ version: opts.version,
246
+ },
247
+ opts.suppressed ?? [],
248
+ );
249
+ fs.writeFileSync(filePath, content);
250
+ const n = findings.length;
251
+ console.log(`${opts.logPrefix} Wrote .bkit/advisories.md (${n} item${n === 1 ? "" : "s"}).`);
252
+ } catch (err) {
253
+ console.error(
254
+ `${opts.logPrefix} Failed to write .bkit/advisories.md: ${(err as Error).message}`,
255
+ );
256
+ }
257
+ }
258
+
259
+ // ---------------------------------------------------------------------------
260
+ // Changelog version-delta header (A7)
261
+ // ---------------------------------------------------------------------------
262
+
263
+ /**
264
+ * Read the bkit CHANGELOG.md (from the package root) and extract the release
265
+ * delta for `version`: the header line plus the section's lead summary (the
266
+ * prose before the first `###` sub-heading). Returns a formatted string for
267
+ * display in post-install output, or null if CHANGELOG.md is absent or the
268
+ * version is not found.
269
+ *
270
+ * Version header format in CHANGELOG.md: `## [X.Y.Z] — YYYY-MM-DD`
271
+ *
272
+ * Bounded on purpose: an install/check banner must not dump a whole release
273
+ * section. When a section has no lead paragraph the sub-heading names stand in,
274
+ * so the banner is never an empty header.
275
+ */
276
+ export function readChangelogVersionDelta(version: string): string | null {
277
+ try {
278
+ const changelogPath = path.join(getPkgRoot(), "CHANGELOG.md");
279
+ if (!fs.existsSync(changelogPath)) return null;
280
+ const content = fs.readFileSync(changelogPath, "utf-8");
281
+ const lines = content.split(/\r?\n/);
282
+ // Find the header line for this version.
283
+ const versionEscaped = version.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
284
+ const headerRe = new RegExp(`^## \\[${versionEscaped}\\]`);
285
+ const start = lines.findIndex((line) => headerRe.test(line));
286
+ if (start === -1) return null;
287
+
288
+ // The section runs to the next top-level `## ` header (or EOF).
289
+ let end = lines.length;
290
+ for (let i = start + 1; i < lines.length; i++) {
291
+ if (/^## /.test(lines[i])) {
292
+ end = i;
293
+ break;
294
+ }
295
+ }
296
+ const section = lines.slice(start + 1, end);
297
+ const header = lines[start].replace(/^## /, "");
298
+
299
+ // Lead summary: the prose between the header and the first `###` sub-heading.
300
+ const firstSub = section.findIndex((line) => /^### /.test(line));
301
+ const leadEnd = firstSub === -1 ? section.length : firstSub;
302
+ let summary = section.slice(0, leadEnd).join("\n").trim();
303
+ if (!summary) {
304
+ summary = section
305
+ .filter((line) => /^### /.test(line))
306
+ .map((line) => line.replace(/^### /, "").trim())
307
+ .join(", ");
308
+ }
309
+
310
+ const headline = `[bkit] What's new in v${version}: ${header}`;
311
+ return summary ? `${headline}\n${summary}` : headline;
312
+ } catch {
313
+ return null;
314
+ }
315
+ }
316
+
317
+ // ---------------------------------------------------------------------------
318
+ // runPostInstallCheck — main Phase 3 entry point
319
+ // ---------------------------------------------------------------------------
320
+
321
+ /**
322
+ * Re-run credential + bkit-ci.yml + vale-sync detectors after writes.
323
+ *
324
+ * - Intra-phase dedup: Phase 3 findings are deduped by id (first occurrence wins).
325
+ * - Cross-phase dedup: Phase 3 wins on id conflict (re-detection is more accurate).
326
+ *
327
+ * Runs unconditionally for both `bkit install` and `bkit check` — detectors are
328
+ * read-only (env probes, gh/vale CLI version checks, file reads) and produce the
329
+ * same advisory set against the same filesystem state regardless of caller.
330
+ *
331
+ * cwd defaults to process.cwd().
332
+ *
333
+ * Pass `suppressed` to collect the advisories a package opted out of via
334
+ * `bkit.ignoreAdvisories` (one note per id + owning package); the caller renders them with
335
+ * `suppressedNoteLines` so a dismissal stays visible. Omitted by callers that do not render.
336
+ */
337
+ export function runPostInstallCheck(
338
+ preflightAdvisories: PreflightFinding[],
339
+ cwd: string = process.cwd(),
340
+ suppressed?: SuppressionNote[],
341
+ ): PreflightFinding[] {
342
+ const phase3: PreflightFinding[] = [];
343
+ const onSuppressed: SuppressionReporter | undefined = suppressed
344
+ ? (note) => suppressed.push(note)
345
+ : undefined;
346
+
347
+ // Managed-version marker gate — in `bkit check`, a blocker on main/dev (or a PR into
348
+ // them) and a non-blocking advisory on feature branches when any stamped file's marker
349
+ // drifts from the installed version. No-op in real install/upgrade (re-stamped Phase 2).
350
+ const managedStale = detectManagedStale(cwd);
351
+ if (managedStale) phase3.push(managedStale);
352
+
353
+ // BKIT_GH_TOKEN shell env — authenticates the GitHub MCP server
354
+ // (`Authorization: Bearer ${BKIT_GH_TOKEN}` in .mcp.json), which powers the entire
355
+ // tracker + PR + Projects MCP surface. Only flags when a github MCP server is
356
+ // configured, and never in CI.
357
+ if (hasGithubMcpServer(cwd) && !process.env.CI) {
358
+ const ghMcpTokenStatus = detectShellGhMcpToken();
359
+ if (ghMcpTokenStatus === "missing") {
360
+ phase3.push({
361
+ id: "gh-mcp-token-unset-shell",
362
+ severity: "advisory",
363
+ detect:
364
+ "BKIT_GH_TOKEN is not set in the shell environment (undefined). The GitHub MCP server authenticates with `Authorization: Bearer ${BKIT_GH_TOKEN}` — without it, every tracker, PR, and board MCP call fails to connect.",
365
+ action:
366
+ "Set BKIT_GH_TOKEN in .bkit/.env (canonical local-secrets file, gitignored), then `direnv allow` and restart your editor so MCP servers pick it up:\n\n cp .bkit/.env.example .bkit/.env # if not already done\n # edit .bkit/.env — set BKIT_GH_TOKEN=<fine-grained PAT>\n direnv allow\n\nThe PAT needs Contents, Pull requests, Issues, and Actions read & write (plus organization-scoped Projects read & write if you use board sync). Generate at: https://github.com/settings/tokens. In cloud sessions (Claude Code web / Cursor Background Agents) set BKIT_GH_TOKEN in the dashboard env vars instead — repo files are not read for secrets there.",
367
+ });
368
+ } else if (ghMcpTokenStatus === "empty") {
369
+ phase3.push({
370
+ id: "gh-mcp-token-empty-shell",
371
+ severity: "advisory",
372
+ detect:
373
+ 'BKIT_GH_TOKEN is set to an empty string (BKIT_GH_TOKEN=""). The GitHub MCP server sends an empty bearer token and fails to authenticate — distinct from unset, same effect.',
374
+ action:
375
+ "Set a non-empty BKIT_GH_TOKEN in .bkit/.env (fine-grained PAT with Contents / Pull requests / Issues / Actions read & write), then `direnv allow` and restart your editor so MCP servers reload.",
376
+ });
377
+ }
378
+ }
379
+
380
+ // Main branch protection — bkit's PR-base gates (build Step 17, ship Step 2)
381
+ // assert feat/* PRs target dev. Enforcing it at the GitHub layer needs branch
382
+ // protection on main restricting merges to PRs from dev.
383
+ const protectionStatus = detectMainBranchProtection();
384
+ const scriptHint =
385
+ "\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.capstoneJob` (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.ciWorkflow` file before requiring it.";
386
+ if (protectionStatus === "missing") {
387
+ phase3.push({
388
+ id: "main-branch-protection-missing",
389
+ severity: "advisory",
390
+ detect: "main has no branch protection rule.",
391
+ action:
392
+ "main only ever moves via a release PR (release/* -> main); bkit's build/ship workflows keep all feat/* PRs on dev. Gate main at the GitHub layer:\n\n" +
393
+ " Settings → Branches → Add rule → Branch name pattern: main\n" +
394
+ " - Require a pull request before merging\n" +
395
+ " - Require status checks: bkit-tests-check (the always-on capstone — required-check green then means 'the planned tiers ran', not just 'nothing failed'; do NOT require bkit-tests-scope, it is always green)\n" +
396
+ " - Do not allow bypassing the above settings (enforce for admins)\n" +
397
+ " - Require linear history; block force-pushes and deletions\n\n" +
398
+ "enforce-for-admins is load-bearing: agents act with the owner's admin token, so an admin-bypass exemption means the agent is the bypass. Covering admins is the only way protection actually constrains agents. dev is intentionally left unprotected — operators choose direct-push or feat/PR and own that tests ran." +
399
+ scriptHint,
400
+ });
401
+ }
402
+
403
+ // Optional post-install decisions (opt-in add-ons):
404
+ // 1. Issue tracker — branch on bkit.issueTracker.
405
+ // 2. Dependency updater — read-only. Suggests an example template. Never writes config.
406
+ // 3. Cloud agents — branch on bkit-cloud.yml presence.
407
+ const trackerSetup = buildTrackerSetupAdvisory(cwd);
408
+ if (trackerSetup) phase3.push(trackerSetup);
409
+ // GitHub Projects v2 board-sync prerequisites (config + toolset + PAT scope) —
410
+ // absent any prerequisite, sync silently no-ops.
411
+ const githubProjectSetup = buildGithubProjectAdvisory(cwd);
412
+ if (githubProjectSetup) phase3.push(githubProjectSetup);
413
+ // A configured board can still silently no-op if statusFieldId holds the GraphQL
414
+ // node id instead of the numeric field id projects_write requires.
415
+ const githubProjectFieldId = detectGithubProjectFieldIdFormat(cwd);
416
+ if (githubProjectFieldId) phase3.push(githubProjectFieldId);
417
+ const depUpdaterSetup = buildDepUpdaterSetupAdvisory(cwd);
418
+ if (depUpdaterSetup) phase3.push(depUpdaterSetup);
419
+ const cloudSetup = buildCloudSetupAdvisory(cwd);
420
+ if (cloudSetup) phase3.push(cloudSetup);
421
+
422
+ // bkit-cloud.yml needs the ANTHROPIC_API_KEY repo secret.
423
+ for (const f of detectCiRouterSecrets(cwd)) phase3.push(f);
424
+
425
+ // bkit-cloud.yml also needs repo Actions write permissions + PR-creation
426
+ // allowance, else `actions/checkout` and `gh pr create` 403. Detectable at the
427
+ // repo level via the Actions API; org-level policy can still override.
428
+ if (fs.existsSync(path.join(cwd, ".github", "workflows", "bkit-cloud.yml"))) {
429
+ if (detectActionsWritePermissions() === "missing") {
430
+ phase3.push({
431
+ id: "actions-write-permissions-missing",
432
+ severity: "advisory",
433
+ detect:
434
+ "GitHub Actions default workflow permissions on this repo are read-only and/or PR creation by Actions is disabled. `.github/workflows/bkit-cloud.yml` cannot push status commits or open/merge PRs — `actions/checkout` and `gh pr create` will 403.",
435
+ action:
436
+ "Grant Actions write access at BOTH org and repo level:\n\n Settings -> Actions -> General -> Workflow permissions\n - Read and write permissions\n - Allow GitHub Actions to create and approve pull requests\n\nOr via CLI (repo level):\n\n gh api -X PUT repos/{owner}/{repo}/actions/permissions/workflow -f default_workflow_permissions=write -F can_approve_pull_request_reviews=true\n\nThe org-level toggle is not readable with a repo-scoped token — if the repo setting looks correct but workflows still 403, check the organization Actions policy (it can override the repo).",
437
+ });
438
+ }
439
+ // "unknown" -> silent skip (gh CLI unavailable / unauthenticated).
440
+ }
441
+
442
+ // Cloud / IDE-online dashboards — Cursor Background Agents + Claude Code on the web
443
+ // read env vars from their respective online dashboards, NOT from repo files.
444
+ // The same three secrets that GitHub Actions needs must be mirrored there.
445
+ const cloudDashboardsAdvisory = buildCloudDashboardsAdvisory(cwd);
446
+ if (cloudDashboardsAdvisory) phase3.push(cloudDashboardsAdvisory);
447
+
448
+ // GHA action SHA pinning (KN-3). Updater configs are consumer-owned examples.
449
+ const gha = detectGhaFloatingTags(cwd);
450
+ if (gha) phase3.push(gha);
451
+
452
+ // bkit-cloud.yml always-true auto-route gate (block scalar wrapping ${{ }}).
453
+ const cloudGate = detectBkitCloudYmlAlwaysTrueGate(cwd);
454
+ if (cloudGate) phase3.push(cloudGate);
455
+
456
+ // Self-installed opencode.yml (/oc handler) drifted from the installed opencode provider —
457
+ // it hardcodes a model + secret that `bkit install --opencode=` does not rewrite. Not for
458
+ // claude.yml (its @claude handler is provider-fixed). bkit-cloud.yml self-syncs, so exempt.
459
+ const opencodeYmlDrift = detectOpencodeYmlProviderDrift(cwd);
460
+ if (opencodeYmlDrift) phase3.push(opencodeYmlDrift);
461
+
462
+ // bkit-ci.yml missing actionlint (GHA-aware lint; yaml.safe_load is not sufficient).
463
+ const ciActionlint = detectCiYmlMissingActionlint(cwd);
464
+ if (ciActionlint) phase3.push(ciActionlint);
465
+
466
+ // bkit-ci.yml untrusted input inlined into a run: body (GHA script-injection sink). Nothing
467
+ // back-fills the template's env-indirection fix onto a copy adopted before it.
468
+ const ciRunInjection = detectCiYmlRunInjection(cwd);
469
+ if (ciRunInjection) phase3.push(ciRunInjection);
470
+
471
+ // bkit-ci.yml capstone drifted from canonical contract (warning-only presence checks).
472
+ const capstoneDrift = detectCiYmlCapstoneContractDrift(cwd);
473
+ if (capstoneDrift) phase3.push(capstoneDrift);
474
+
475
+ // @live/@smoke-tagged tests whose owning package declares no test:live/test:smoke
476
+ // script — "no CI home".
477
+ const taggedNoHome = detectTaggedTestsWithoutCiHome(cwd, onSuppressed);
478
+ if (taggedNoHome) phase3.push(taggedNoHome);
479
+
480
+ // bkit-stub sentinels in shipped templates — one advisory per still-commented stub.
481
+ for (const stub of detectBkitStubs(cwd)) phase3.push(stub);
482
+
483
+ // turbo.json inputs for cache-replay safety (KN-24).
484
+ for (const f of detectTurboIntegrationInputs(cwd)) phase3.push(f);
485
+
486
+ // test:integration runtime env (KN-23 false-confidence loop).
487
+ const integrationEnv = detectTestIntegrationEnv(cwd, onSuppressed);
488
+ if (integrationEnv) phase3.push(integrationEnv);
489
+
490
+ // Consumer composed run-levels on bkit primitives (else docs/deployments.md matrix is doc-only).
491
+ const runLevels = detectRunLevelsNotComposed(cwd);
492
+ if (runLevels) phase3.push(runLevels);
493
+
494
+ // vale not synced
495
+ const vale = detectValePackageNotSynced(cwd);
496
+ if (vale) phase3.push(vale);
497
+
498
+ // actionlint + shellcheck for local pre-push workflow linting (CI has both)
499
+ const wfLintTools = detectWorkflowLintToolsMissing(cwd);
500
+ if (wfLintTools) phase3.push(wfLintTools);
501
+
502
+ // [mcp-env] direnv + .bkit/.env advisories.
503
+ // Wired here in Phase 3 — the .bkit/.env.example scaffold only exists after
504
+ // writes, so Phase 1 cannot see it on first install.
505
+ // Pass the consumer's tracker so the mcp-env prose omits BKIT_LINEAR_API_KEY on github/none
506
+ // repos.
507
+ const mcpEnvTracker = readConsumerIssueTracker(cwd);
508
+ const missingDotenv = detectMissingDotenv(cwd, mcpEnvTracker);
509
+ if (missingDotenv) phase3.push(missingDotenv);
510
+ phase3.push(...detectBlankDotenvKeys(cwd, mcpEnvTracker));
511
+ const direnvMissing = detectDirenvMissing(cwd, mcpEnvTracker);
512
+ if (direnvMissing) phase3.push(direnvMissing);
513
+ const direnvNotAllowed = detectDirenvNotAllowed(cwd, mcpEnvTracker);
514
+ if (direnvNotAllowed) phase3.push(direnvNotAllowed);
515
+
516
+ // Intra-phase dedup (first occurrence wins)
517
+ const deduped = dedupeById(phase3);
518
+
519
+ // Dedupe the incoming preflightAdvisories (ctx.advisories may contain module-emitted
520
+ // duplicates in addition to runPreflight's already-deduped output).
521
+ const dedupedPreflight = dedupeById(preflightAdvisories);
522
+
523
+ // Cross-phase dedup: Phase 3 wins on conflict (remove preflight entries whose id
524
+ // appears in Phase 3, then merge Phase 3 at the front for the winning position).
525
+ const phase3Ids = new Set(deduped.map((f) => f.id));
526
+ const filteredPreflight = dedupedPreflight.filter((f) => !phase3Ids.has(f.id));
527
+
528
+ // Final order: preflight advisories (that weren't superseded) first, then Phase 3
529
+ return [...filteredPreflight, ...deduped];
530
+ }