@cbartens/bkit 5.5.1 → 6.1.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 (425) hide show
  1. package/.bkit/README.md +167 -154
  2. package/.bkit/core/.agents/context.md +95 -29
  3. package/.bkit/core/.agents/docs.md +18 -15
  4. package/.bkit/core/.agents/plugins/bkit/hooks/bkit-gateguard.cjs +1 -0
  5. package/.bkit/core/.agents/plugins/bkit/hooks/bkit-guardrails.cjs +6 -5
  6. package/.bkit/core/.agents/plugins/bkit/hooks/bkit-readguard.cjs +1 -0
  7. package/.bkit/core/.agents/plugins/bkit/hooks/bkit-rules.cjs +65 -0
  8. package/.bkit/core/.agents/rules.md +112 -102
  9. package/.bkit/core/.agents/skills.md +63 -15
  10. package/.bkit/core/.bkit/README.md +167 -154
  11. package/.bkit/core/.bkit/authoring.md +747 -0
  12. package/.bkit/core/.bkit/cli.md +407 -0
  13. package/.bkit/core/.bkit/cloud.md +283 -195
  14. package/.bkit/core/.bkit/comparison.md +45 -43
  15. package/.bkit/core/.bkit/install.md +166 -95
  16. package/.bkit/core/.bkit/jsonl.md +339 -196
  17. package/.bkit/core/.bkit/pipeline.md +142 -145
  18. package/.bkit/core/.bkit/prompts.md +295 -264
  19. package/.bkit/core/.bkit/providers.md +460 -277
  20. package/.bkit/core/.bkit/router.md +69 -0
  21. package/.bkit/core/.bkit/templates.md +530 -256
  22. package/.bkit/core/.bkit/trackers.md +116 -65
  23. package/.bkit/core/.bkit/workflows.md +742 -618
  24. package/.bkit/core/.claude/hooks/bkit-gateguard.cjs +2 -2
  25. package/.bkit/core/.claude/hooks/bkit-guardrails.cjs +3 -3
  26. package/.bkit/core/.claude/hooks/bkit-preflight.sh +45 -14
  27. package/.bkit/core/.codex/hooks/bkit-guardrails.cjs +3 -3
  28. package/.bkit/core/.codex/hooks/bkit-rules.cjs +57 -0
  29. package/.bkit/core/.cursor/hooks/bkit-guardrails.cjs +7 -7
  30. package/.bkit/core/.cursor/hooks/bkit-preflight.sh +47 -12
  31. package/.bkit/core/.opencode/plugin/bkit-rules.js +89 -0
  32. package/.bkit/core/AGENTS.md +6 -80
  33. package/.bkit/core/docs/templates/bkit-audit-accessibility.md +128 -130
  34. package/.bkit/core/docs/templates/bkit-audit-adoption.md +104 -94
  35. package/.bkit/core/docs/templates/bkit-audit-agents.md +96 -98
  36. package/.bkit/core/docs/templates/bkit-audit-aio-seo.md +100 -103
  37. package/.bkit/core/docs/templates/bkit-audit-analytics.md +141 -107
  38. package/.bkit/core/docs/templates/bkit-audit-annotations.md +99 -97
  39. package/.bkit/core/docs/templates/bkit-audit-app-performance.md +122 -121
  40. package/.bkit/core/docs/templates/bkit-audit-app-store.md +158 -101
  41. package/.bkit/core/docs/templates/bkit-audit-architecture.md +114 -96
  42. package/.bkit/core/docs/templates/bkit-audit-ci-performance.md +76 -97
  43. package/.bkit/core/docs/templates/bkit-audit-config.md +123 -101
  44. package/.bkit/core/docs/templates/bkit-audit-cost.md +86 -99
  45. package/.bkit/core/docs/templates/bkit-audit-coverage.md +76 -93
  46. package/.bkit/core/docs/templates/bkit-audit-database.md +102 -95
  47. package/.bkit/core/docs/templates/bkit-audit-dead-code.md +165 -108
  48. package/.bkit/core/docs/templates/bkit-audit-deferrals.md +115 -109
  49. package/.bkit/core/docs/templates/bkit-audit-dependencies.md +265 -113
  50. package/.bkit/core/docs/templates/bkit-audit-documentation.md +119 -118
  51. package/.bkit/core/docs/templates/bkit-audit-duplication.md +140 -111
  52. package/.bkit/core/docs/templates/bkit-audit-failures.md +111 -106
  53. package/.bkit/core/docs/templates/bkit-audit-flakes.md +100 -99
  54. package/.bkit/core/docs/templates/bkit-audit-gates.md +107 -103
  55. package/.bkit/core/docs/templates/bkit-audit-issues.md +105 -105
  56. package/.bkit/core/docs/templates/bkit-audit-llm.md +134 -85
  57. package/.bkit/core/docs/templates/bkit-audit-logs.md +124 -125
  58. package/.bkit/core/docs/templates/bkit-audit-models.md +99 -78
  59. package/.bkit/core/docs/templates/bkit-audit-privacy.md +56 -76
  60. package/.bkit/core/docs/templates/bkit-audit-prompts.md +63 -78
  61. package/.bkit/core/docs/templates/bkit-audit-red-team.md +125 -93
  62. package/.bkit/core/docs/templates/bkit-audit-reliability.md +97 -96
  63. package/.bkit/core/docs/templates/bkit-audit-repo.md +170 -98
  64. package/.bkit/core/docs/templates/bkit-audit-security.md +207 -121
  65. package/.bkit/core/docs/templates/bkit-audit-slop.md +78 -95
  66. package/.bkit/core/docs/templates/bkit-audit-testing.md +163 -139
  67. package/.bkit/core/docs/templates/bkit-audit-usability.md +114 -96
  68. package/.bkit/core/docs/templates/bkit-plan.md +158 -281
  69. package/.bkit/core/engine/checks/after/auth.ts +40 -37
  70. package/.bkit/core/engine/checks/after/ci-yml.ts +104 -31
  71. package/.bkit/core/engine/checks/after/github.ts +95 -17
  72. package/.bkit/core/engine/checks/after/index.ts +21 -8
  73. package/.bkit/core/engine/checks/after/suppression.ts +8 -5
  74. package/.bkit/core/engine/checks/after/tools.ts +125 -123
  75. package/.bkit/core/engine/checks/before/context-fetch.ts +227 -33
  76. package/.bkit/core/engine/checks/before/env.ts +3 -3
  77. package/.bkit/core/engine/checks/before/files.ts +5 -4
  78. package/.bkit/core/engine/checks/before/index.ts +25 -1
  79. package/.bkit/core/engine/checks/before/repo.ts +208 -2
  80. package/.bkit/core/engine/checks/status-holes.ts +916 -123
  81. package/.bkit/core/engine/checks/tips/catalogue.ts +82 -20
  82. package/.bkit/core/engine/checks/tips/detect.ts +66 -0
  83. package/.bkit/core/engine/checks/tips/index.ts +52 -11
  84. package/.bkit/core/engine/cli.ts +251 -130
  85. package/.bkit/core/engine/commands/analysis.ts +282 -199
  86. package/.bkit/core/engine/commands/ci/ci.ts +363 -29
  87. package/.bkit/core/engine/commands/ci/pins.ts +172 -0
  88. package/.bkit/core/engine/commands/ci/push-gate.ts +223 -0
  89. package/.bkit/core/engine/commands/comply.ts +77 -103
  90. package/.bkit/core/engine/commands/install/doctor.ts +2 -2
  91. package/.bkit/core/engine/commands/install/install.ts +57 -18
  92. package/.bkit/core/engine/commands/install/uninstall.ts +86 -55
  93. package/.bkit/core/engine/commands/install/upgrade.ts +32 -15
  94. package/.bkit/core/engine/commands/land.ts +139 -18
  95. package/.bkit/core/engine/commands/lib.ts +381 -22
  96. package/.bkit/core/engine/commands/registry.ts +10 -2
  97. package/.bkit/core/engine/commands/setup/setup.ts +8 -7
  98. package/.bkit/core/engine/commands/stats.ts +260 -0
  99. package/.bkit/core/engine/commands/tips.ts +10 -5
  100. package/.bkit/core/engine/commands/workflow/branches.ts +2215 -176
  101. package/.bkit/core/engine/commands/workflow/challenge.ts +748 -0
  102. package/.bkit/core/engine/commands/workflow/completeness.ts +109 -0
  103. package/.bkit/core/engine/commands/workflow/context.ts +1249 -47
  104. package/.bkit/core/engine/commands/workflow/counters.ts +483 -95
  105. package/.bkit/core/engine/commands/workflow/decisions.ts +585 -0
  106. package/.bkit/core/engine/commands/workflow/disk.ts +238 -56
  107. package/.bkit/core/engine/commands/workflow/fids.ts +811 -33
  108. package/.bkit/core/engine/commands/workflow/issues.ts +413 -64
  109. package/.bkit/core/engine/commands/workflow/ledgers.ts +1333 -36
  110. package/.bkit/core/engine/commands/workflow/locks.ts +28 -2
  111. package/.bkit/core/engine/commands/workflow/plan-blocks.ts +691 -0
  112. package/.bkit/core/engine/commands/workflow/plan-versions.ts +21 -0
  113. package/.bkit/core/engine/commands/workflow/plans.ts +257 -0
  114. package/.bkit/core/engine/commands/workflow/prs.ts +178 -33
  115. package/.bkit/core/engine/commands/workflow/repo.ts +66 -8
  116. package/.bkit/core/engine/commands/workflow/roadmap.ts +72 -22
  117. package/.bkit/core/engine/commands/workflow/run-facts.ts +492 -0
  118. package/.bkit/core/engine/commands/workflow/runs.ts +827 -79
  119. package/.bkit/core/engine/commands/workflow/runtime.ts +25 -1
  120. package/.bkit/core/engine/commands/workflow/skills.ts +1 -0
  121. package/.bkit/core/engine/commands/workflow/status.ts +329 -33
  122. package/.bkit/core/engine/commands/workflow/step-table.ts +381 -0
  123. package/.bkit/core/engine/commands/workflow/steps.ts +841 -105
  124. package/.bkit/core/engine/commands/workflow/summary-findings.ts +177 -0
  125. package/.bkit/core/engine/commands/workflow/summary.ts +544 -0
  126. package/.bkit/core/engine/commands/workflow/tasks.ts +409 -0
  127. package/.bkit/core/engine/commands/workflow/test-blocks.ts +254 -0
  128. package/.bkit/core/engine/commands/workflow/tests-changed.ts +201 -0
  129. package/.bkit/core/engine/commands/workflow/tests.ts +2124 -330
  130. package/.bkit/core/engine/commands/workflow/tracker.ts +1195 -0
  131. package/.bkit/core/engine/commands/workflow/workflows.ts +1197 -235
  132. package/.bkit/core/engine/commands/workflow/worktrees.ts +543 -24
  133. package/.bkit/core/engine/install/cloud-env.ts +251 -121
  134. package/.bkit/core/engine/install/context-ci-workflow.ts +102 -0
  135. package/.bkit/core/engine/install/manifest.ts +67 -17
  136. package/.bkit/core/engine/install/modules/antigravity.ts +3 -2
  137. package/.bkit/core/engine/install/modules/cloud.ts +24 -16
  138. package/.bkit/core/engine/install/modules/codex.ts +15 -2
  139. package/.bkit/core/engine/install/modules/core.ts +1196 -45
  140. package/.bkit/core/engine/install/modules/cursor.ts +6 -6
  141. package/.bkit/core/engine/install/modules/opencode.ts +18 -6
  142. package/.bkit/core/engine/install/template-notes.ts +130 -0
  143. package/.bkit/core/engine/install/version-file.ts +9 -4
  144. package/.bkit/core/engine/install/write.ts +5 -0
  145. package/.bkit/core/engine/ledgers/compact.ts +124 -0
  146. package/.bkit/core/engine/ledgers/journal.ts +291 -0
  147. package/.bkit/core/engine/ledgers/migrate.ts +92 -0
  148. package/.bkit/core/engine/ledgers/status.ts +249 -21
  149. package/.bkit/core/engine/ledgers/telemetry.ts +1397 -253
  150. package/.bkit/core/engine/render/hosts.ts +118 -14
  151. package/.bkit/core/engine/render/models.ts +12 -0
  152. package/.bkit/core/engine/shared/bkit-latest.ts +26 -4
  153. package/.bkit/core/engine/shared/branches.ts +4 -1
  154. package/.bkit/core/engine/shared/dep-updater.ts +60 -0
  155. package/.bkit/core/engine/shared/egress.ts +8 -1
  156. package/.bkit/core/engine/shared/json.ts +25 -7
  157. package/.bkit/core/engine/shared/package-manager.ts +9 -0
  158. package/.bkit/core/engine/shared/settings.ts +243 -31
  159. package/.bkit/core/engine/shared/text.ts +361 -0
  160. package/.bkit/core/engine/shared/timeouts.ts +2 -0
  161. package/.bkit/core/engine/tools/cli-doc.ts +111 -0
  162. package/.bkit/core/engine/tools/grammar-density.ts +215 -0
  163. package/.bkit/core/engine/tools/instructions-sources.ts +832 -0
  164. package/.bkit/core/engine/tools/instructions.ts +1802 -0
  165. package/.bkit/core/hooks/antigravity-hook.js +25 -10
  166. package/.bkit/core/hooks/gateguard-engine.js +54 -29
  167. package/.bkit/core/hooks/guardrails-shell.js +4 -5
  168. package/.bkit/core/hooks/guardrails-tiers.js +10 -4
  169. package/.bkit/core/hooks/preflight-linear.sh +9 -9
  170. package/.bkit/core/hooks/preflight-rules.sh +8 -0
  171. package/.bkit/core/hooks/readguard-engine.js +29 -10
  172. package/.bkit/core/hooks/session-rules-advisory.js +61 -0
  173. package/.bkit/core/prompts/bkit-audit-generate.md +202 -94
  174. package/.bkit/core/prompts/bkit-build-challenge-1.md +76 -34
  175. package/.bkit/core/prompts/bkit-build-challenge-2.md +85 -38
  176. package/.bkit/core/prompts/bkit-build-install-skills.md +50 -28
  177. package/.bkit/core/prompts/bkit-build-plan-convert.md +85 -0
  178. package/.bkit/core/prompts/bkit-build-plan-current.md +59 -36
  179. package/.bkit/core/prompts/bkit-build-plan-gaps-remediate.md +101 -36
  180. package/.bkit/core/prompts/bkit-build-plan-tasks.md +149 -0
  181. package/.bkit/core/prompts/bkit-build-plan-tests.md +120 -0
  182. package/.bkit/core/prompts/bkit-build-plan-verify.md +104 -43
  183. package/.bkit/core/prompts/bkit-debug-abort-handover.md +47 -32
  184. package/.bkit/core/prompts/bkit-debug-failure-diagnose.md +109 -57
  185. package/.bkit/core/prompts/bkit-debug-failure-remediate.md +65 -39
  186. package/.bkit/core/prompts/bkit-debug-failure-reproduce.md +53 -31
  187. package/.bkit/core/prompts/bkit-debug-failure-soak.md +65 -34
  188. package/.bkit/core/prompts/bkit-design-brainstorm-ideate-1.md +46 -31
  189. package/.bkit/core/prompts/bkit-design-brainstorm-ideate-2.md +45 -31
  190. package/.bkit/core/prompts/bkit-design-brainstorm-ideate-3.md +43 -30
  191. package/.bkit/core/prompts/bkit-design-generate.md +80 -46
  192. package/.bkit/core/prompts/bkit-design-organise.md +83 -32
  193. package/.bkit/core/prompts/bkit-design-review-1.md +70 -50
  194. package/.bkit/core/prompts/bkit-design-review-2.md +65 -46
  195. package/.bkit/core/prompts/bkit-design-spike.md +64 -40
  196. package/.bkit/core/prompts/bkit-design-update.md +53 -28
  197. package/.bkit/core/prompts/bkit-plan-generate.md +101 -29
  198. package/.bkit/core/prompts/bkit-plan-review-1.md +78 -41
  199. package/.bkit/core/prompts/bkit-plan-review-2.md +78 -35
  200. package/.bkit/core/prompts/bkit-plan-scope-check.md +116 -0
  201. package/.bkit/core/prompts/bkit-plan-update.md +86 -31
  202. package/.bkit/core/prompts/bkit-ship-conflict-resolve.md +94 -50
  203. package/.bkit/core/prompts/bkit-ship-deferred-sweep.md +91 -41
  204. package/.bkit/core/prompts/bkit-ship-update-docs.md +45 -24
  205. package/.bkit/core/prompts/bkit-utility-compress-markdown.md +65 -49
  206. package/.bkit/core/prompts/bkit-utility-update-decisions.md +87 -42
  207. package/.bkit/core/prompts/bkit-utility-update-deferrals.md +81 -37
  208. package/.bkit/core/prompts/bkit-utility-update-documentation.md +43 -25
  209. package/.bkit/core/prompts/bkit-utility-update-failures.md +84 -37
  210. package/.bkit/core/prompts/bkit-utility-update-knowledge.md +88 -42
  211. package/.bkit/core/prompts/bkit-utility-update-roadmap.md +92 -39
  212. package/.bkit/core/prompts/bkit-utility-update-tracker.md +159 -60
  213. package/.bkit/core/workflows/bkit-auto.md +89 -58
  214. package/.bkit/core/workflows/bkit-build.md +967 -517
  215. package/.bkit/core/workflows/bkit-debug.md +555 -387
  216. package/.bkit/core/workflows/bkit-design.md +319 -283
  217. package/.bkit/core/workflows/bkit-plan.md +319 -342
  218. package/.bkit/core/workflows/bkit-ship.md +525 -328
  219. package/.bkit/shared/.agents/plugins/bkit/hooks.json +10 -0
  220. package/.bkit/shared/.bkit/.env.example +2 -2
  221. package/.bkit/shared/.claude/bkit-cloud.md +12 -10
  222. package/.bkit/shared/.claude/settings.json +14 -0
  223. package/.bkit/shared/.codex/bkit-cloud.md +98 -0
  224. package/.bkit/shared/.codex/hooks.json +20 -0
  225. package/.bkit/shared/.cursor/bkit-cloud.md +3 -3
  226. package/.bkit/shared/.cursor/mcp.json +1 -1
  227. package/.bkit/shared/.cursor/rules/bkit-rules.mdc +1 -1
  228. package/.bkit/shared/.gitattributes +1 -1
  229. package/.bkit/shared/.mcp.json +1 -1
  230. package/.bkit/shared/.opencode/opencode.json +12 -1
  231. package/.bkit/shared/CLAUDE.md +6 -2
  232. package/.bkit/shared/GEMINI.md +5 -2
  233. package/.bkit/shared/docs/architecture.md +4 -7
  234. package/.bkit/shared/docs/data-schema.md +4 -7
  235. package/.bkit/shared/docs/deployments.md +241 -168
  236. package/.bkit/shared/docs/design.md +11 -12
  237. package/.bkit/shared/docs/noise.md +8 -7
  238. package/.bkit/shared/docs/observability.md +5 -8
  239. package/.bkit/shared/docs/security.md +35 -17
  240. package/.bkit/shared/docs/setup.md +29 -18
  241. package/.bkit/shared/docs/technology.md +3 -6
  242. package/.bkit/shared/docs/testing.md +289 -174
  243. package/.bkit/shared/gitignore +6 -2
  244. package/.bkit/templates/.claude/hooks/bkit-cloud-bootstrap.sh +15 -16
  245. package/.bkit/templates/.cursor/Dockerfile +12 -8
  246. package/.bkit/templates/.cursor/environment.json +1 -1
  247. package/.bkit/templates/.github/ISSUE_TEMPLATE/bkit-bug.yml +10 -8
  248. package/.bkit/templates/.github/ISSUE_TEMPLATE/bkit-change.yml +45 -12
  249. package/.bkit/templates/.github/ISSUE_TEMPLATE/bkit-idea.yml +3 -3
  250. package/.bkit/templates/.github/renovate.json5 +34 -6
  251. package/.bkit/templates/.github/workflows/bkit-ci.yml +54 -51
  252. package/.bkit/templates/.github/workflows/bkit-cloud.yml +34 -33
  253. package/.bkit/templates/.github/workflows/bkit-health.yml +97 -0
  254. package/.bkit/templates/.github/workflows/bkit-renovate.yml +5 -4
  255. package/.bkit/templates/.github/workflows/bkit-trivy.yml +5 -4
  256. package/.bkit/templates/.husky/pre-commit +2 -2
  257. package/.bkit/templates/.husky/pre-push +96 -36
  258. package/.bkit/templates/.prettierignore +6 -0
  259. package/.bkit/templates/.vale.ini +27 -27
  260. package/.bkit/templates/context/bkit-cloudrun.md +23 -15
  261. package/.bkit/templates/context/bkit-expo.md +70 -52
  262. package/.bkit/templates/context/bkit-github.md +93 -56
  263. package/.bkit/templates/context/bkit-inngest.md +21 -15
  264. package/.bkit/templates/context/bkit-maestro.md +22 -16
  265. package/.bkit/templates/context/bkit-playwright.md +23 -17
  266. package/.bkit/templates/context/bkit-resend.md +12 -10
  267. package/.bkit/templates/context/bkit-sentry.md +30 -20
  268. package/.bkit/templates/context/bkit-serena.md +8 -7
  269. package/.bkit/templates/context/bkit-stripe.md +14 -13
  270. package/.bkit/templates/context/bkit-supabase.md +16 -13
  271. package/.bkit/templates/context/bkit-tavily.md +14 -11
  272. package/.bkit/templates/context/bkit-vercel.md +27 -18
  273. package/.bkit/templates/docs/capabilities.md +15 -14
  274. package/.bkit/templates/scripts/ci/{check-accepted-divergences.mjs → bkit-check-accepted-divergences.mjs} +6 -3
  275. package/.bkit/templates/scripts/ci/{check-accepted-divergences.test.mjs → bkit-check-accepted-divergences.test.mjs} +3 -3
  276. package/.bkit/templates/scripts/ci/{check-capstone.mjs → bkit-check-capstone.mjs} +2 -2
  277. package/.bkit/templates/scripts/ci/{check-capstone.test.mjs → bkit-check-capstone.test.mjs} +4 -4
  278. package/.bkit/templates/scripts/ci/{check-dependency-audit.mjs → bkit-check-dependency-audit.mjs} +103 -18
  279. package/.bkit/templates/scripts/ci/{check-dependency-audit.test.mjs → bkit-check-dependency-audit.test.mjs} +31 -3
  280. package/.bkit/templates/scripts/ci/bkit-machine-lock.sh +387 -0
  281. package/.bkit/templates/scripts/ci/bkit-test-awake.mjs +75 -0
  282. package/.bkit/templates/scripts/ci/bkit-test-awake.test.mjs +160 -0
  283. package/.bkit/templates/scripts/ci/lanes/{resolve-push-base.mjs → bkit-resolve-push-base.mjs} +3 -3
  284. package/.bkit/templates/scripts/ci/lanes/{resolve-push-base.test.mjs → bkit-resolve-push-base.test.mjs} +4 -4
  285. package/.bkit/templates/scripts/cleanup/bkit-disk-prune.mjs +10 -2
  286. package/.bkit/templates/scripts/graphify/bkit-graph-drift.py +1 -1
  287. package/.bkit/templates/scripts/graphify/bkit-graph-eager.py +3 -3
  288. package/.bkit/templates/scripts/graphify/bkit-graph-embed.py +63 -0
  289. package/.bkit/templates/scripts/graphify/bkit-graph-imports.py +2 -2
  290. package/.bkit/templates/scripts/graphify/bkit-graph-pre-push.sh +69 -18
  291. package/.bkit/templates/scripts/graphify/bkit-graph-repair.py +3 -3
  292. package/.bkit/templates/scripts/graphify/bkit-graph-surface.py +1 -1
  293. package/.bkit/templates/scripts/graphify/bkit-graphify-graphml.py +1 -1
  294. package/.bkit/templates/scripts/graphify/bkit-graphify-rollup.py +197 -126
  295. package/.bkit/templates/scripts/graphify/bkit-graphify.sh +64 -41
  296. package/.bkit/templates/scripts/slop/bkit-slop-type-suppression.mjs +23 -7
  297. package/.bkit/templates/slop-scan.config.json +9 -2
  298. package/CHANGELOG.md +231 -0
  299. package/README.md +278 -89
  300. package/dist/checks/after/auth.js +36 -33
  301. package/dist/checks/after/ci-yml.js +91 -30
  302. package/dist/checks/after/github.js +91 -17
  303. package/dist/checks/after/index.js +22 -11
  304. package/dist/checks/after/suppression.js +8 -5
  305. package/dist/checks/after/tools.js +111 -114
  306. package/dist/checks/before/context-fetch.js +218 -33
  307. package/dist/checks/before/env.js +3 -3
  308. package/dist/checks/before/files.js +5 -3
  309. package/dist/checks/before/index.js +20 -3
  310. package/dist/checks/before/repo.js +197 -2
  311. package/dist/checks/status-holes.js +739 -114
  312. package/dist/checks/tips/catalogue.js +70 -19
  313. package/dist/checks/tips/detect.js +62 -0
  314. package/dist/checks/tips/index.js +51 -9
  315. package/dist/cli.js +234 -124
  316. package/dist/commands/analysis.js +174 -141
  317. package/dist/commands/ci/ci.js +302 -25
  318. package/dist/commands/ci/pins.js +142 -0
  319. package/dist/commands/ci/push-gate.js +194 -0
  320. package/dist/commands/comply.js +54 -91
  321. package/dist/commands/install/doctor.js +2 -2
  322. package/dist/commands/install/install.js +50 -19
  323. package/dist/commands/install/uninstall.js +82 -55
  324. package/dist/commands/install/upgrade.js +21 -11
  325. package/dist/commands/land.js +137 -17
  326. package/dist/commands/lib.js +295 -21
  327. package/dist/commands/registry.js +10 -2
  328. package/dist/commands/setup/setup.js +8 -7
  329. package/dist/commands/stats.js +175 -0
  330. package/dist/commands/tips.js +7 -3
  331. package/dist/commands/workflow/branches.js +1873 -152
  332. package/dist/commands/workflow/challenge.js +609 -0
  333. package/dist/commands/workflow/completeness.js +97 -0
  334. package/dist/commands/workflow/context.js +1045 -46
  335. package/dist/commands/workflow/counters.js +385 -86
  336. package/dist/commands/workflow/decisions.js +484 -0
  337. package/dist/commands/workflow/disk.js +214 -56
  338. package/dist/commands/workflow/fids.js +706 -33
  339. package/dist/commands/workflow/issues.js +349 -59
  340. package/dist/commands/workflow/ledgers.js +1123 -37
  341. package/dist/commands/workflow/locks.js +26 -2
  342. package/dist/commands/workflow/plan-blocks.js +501 -0
  343. package/dist/commands/workflow/plan-versions.js +22 -0
  344. package/dist/commands/workflow/plans.js +205 -0
  345. package/dist/commands/workflow/prs.js +154 -35
  346. package/dist/commands/workflow/repo.js +58 -8
  347. package/dist/commands/workflow/roadmap.js +58 -23
  348. package/dist/commands/workflow/run-facts.js +421 -0
  349. package/dist/commands/workflow/runs.js +670 -72
  350. package/dist/commands/workflow/runtime.js +15 -1
  351. package/dist/commands/workflow/skills.js +1 -0
  352. package/dist/commands/workflow/status.js +282 -34
  353. package/dist/commands/workflow/step-table.js +308 -0
  354. package/dist/commands/workflow/steps.js +703 -96
  355. package/dist/commands/workflow/summary-findings.js +117 -0
  356. package/dist/commands/workflow/summary.js +388 -0
  357. package/dist/commands/workflow/tasks.js +378 -0
  358. package/dist/commands/workflow/test-blocks.js +231 -0
  359. package/dist/commands/workflow/tests-changed.js +172 -0
  360. package/dist/commands/workflow/tests.js +1695 -305
  361. package/dist/commands/workflow/tracker.js +983 -0
  362. package/dist/commands/workflow/workflows.js +1014 -222
  363. package/dist/commands/workflow/worktrees.js +432 -26
  364. package/dist/install/cloud-env.js +233 -99
  365. package/dist/install/context-ci-workflow.js +85 -0
  366. package/dist/install/manifest.js +64 -17
  367. package/dist/install/modules/antigravity.js +3 -2
  368. package/dist/install/modules/cloud.js +25 -16
  369. package/dist/install/modules/codex.js +12 -2
  370. package/dist/install/modules/core.js +1090 -48
  371. package/dist/install/modules/cursor.js +6 -6
  372. package/dist/install/modules/opencode.js +13 -7
  373. package/dist/install/template-notes.js +116 -0
  374. package/dist/install/version-file.js +9 -4
  375. package/dist/ledgers/compact.js +87 -0
  376. package/dist/ledgers/journal.js +233 -0
  377. package/dist/ledgers/migrate.js +81 -0
  378. package/dist/ledgers/status.js +176 -13
  379. package/dist/ledgers/telemetry.js +1010 -125
  380. package/dist/render/hosts.js +104 -14
  381. package/dist/render/models.js +12 -0
  382. package/dist/shared/bkit-latest.js +26 -4
  383. package/dist/shared/branches.js +3 -1
  384. package/dist/shared/dep-updater.js +49 -0
  385. package/dist/shared/egress.js +8 -1
  386. package/dist/shared/json.js +20 -7
  387. package/dist/shared/package-manager.js +6 -0
  388. package/dist/shared/settings.js +181 -24
  389. package/dist/shared/text.js +333 -0
  390. package/dist/shared/timeouts.js +2 -0
  391. package/dist/tools/cli-doc.js +97 -0
  392. package/dist/tools/grammar-density.js +183 -0
  393. package/dist/tools/instructions-sources.js +720 -0
  394. package/dist/tools/instructions.js +1623 -0
  395. package/package.json +156 -51
  396. package/.bkit/core/.bkit/lite.md +0 -73
  397. package/.bkit/core/engine/commands/harvest.ts +0 -459
  398. package/.bkit/core/engine/commands/workflow/workstreams.ts +0 -166
  399. package/.bkit/core/engine/tools/wording.ts +0 -748
  400. package/.bkit/core/prompts/bkit-build-challenge-reconcile.md +0 -69
  401. package/.bkit/core/prompts/bkit-build-challenge-remediate.md +0 -71
  402. package/.bkit/core/prompts/bkit-build-challenge-tests.md +0 -74
  403. package/.bkit/core/prompts/bkit-build-plan-execute.md +0 -76
  404. package/.bkit/core/prompts/bkit-build-summary.md +0 -94
  405. package/.bkit/core/prompts/bkit-debug-summary.md +0 -96
  406. package/.bkit/core/prompts/bkit-design-summary.md +0 -107
  407. package/.bkit/core/prompts/bkit-plan-complexity-check.md +0 -67
  408. package/.bkit/core/prompts/bkit-plan-complexity-split.md +0 -88
  409. package/.bkit/core/prompts/bkit-plan-review-3.md +0 -93
  410. package/.bkit/core/prompts/bkit-plan-scope-check-1.md +0 -85
  411. package/.bkit/core/prompts/bkit-plan-scope-check-2.md +0 -85
  412. package/.bkit/core/prompts/bkit-plan-summary.md +0 -107
  413. package/.bkit/core/prompts/bkit-ship-summary.md +0 -78
  414. package/.bkit/templates/scripts/ci/bkit-local-stack-lock.sh +0 -194
  415. package/dist/commands/harvest.js +0 -353
  416. package/dist/commands/workflow/workstreams.js +0 -143
  417. package/dist/tools/wording.js +0 -680
  418. /package/.bkit/templates/.vale/styles/{House → Bkit}/Filler.yml +0 -0
  419. /package/.bkit/templates/.vale/styles/{House → Bkit}/Hedging.yml +0 -0
  420. /package/.bkit/templates/.vale/styles/{House → Bkit}/LLMSlop.yml +0 -0
  421. /package/.bkit/templates/.vale/styles/{House → Bkit}/Verbose.yml +0 -0
  422. /package/.bkit/templates/scripts/ci/{accepted-advisories.json → bkit-accepted-advisories.json} +0 -0
  423. /package/.bkit/templates/scripts/ci/{accepted-divergences.json → bkit-accepted-divergences.json} +0 -0
  424. /package/.bkit/templates/scripts/launchd/{launchd.env.example → bkit-launchd.env.example} +0 -0
  425. /package/.bkit/templates/scripts/launchd/{ai.bkit.launchd.plist → bkit-launchd.plist} +0 -0
@@ -58,7 +58,7 @@ jobs:
58
58
  steps:
59
59
  - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
60
60
  with:
61
- # Full history so slop:delta can materialise the PR base ref as a worktree.
61
+ # Full history so bkit:slop:delta can materialise the PR base ref as a worktree.
62
62
  fetch-depth: 0
63
63
 
64
64
  # Node/TS toolchain region. On a non-Node repo, replace these steps with your
@@ -191,15 +191,15 @@ jobs:
191
191
  run: pnpm format:check
192
192
 
193
193
  # vale is not on the runner and .vale/styles/ is gitignored, so without this step
194
- # `pnpm lint:prose` guard-skips (write-good missing) and the prose gate is silently
194
+ # `pnpm bkit:lint:prose` guard-skips (write-good missing) and the prose gate is silently
195
195
  # dead. Pinned tarball + `vale sync` (else E100: write-good missing).
196
196
  - name: Install Vale
197
197
  env:
198
198
  # renovate: datasource=github-releases depName=errata-ai/vale
199
- VALE_VERSION: "3.9.1"
199
+ VALE_VERSION: "3.24.0"
200
200
  # sha256 of vale_${VALE_VERSION}_Linux_64-bit.tar.gz (from the release's checksums.txt).
201
201
  # Bump alongside VALE_VERSION; verified before extract so a tampered/CDN-swapped tarball fails closed.
202
- VALE_SHA256: "fbc2eb47d0b8c50220ed1a2c5c611fbe0904ed567d638143d482016a18fd2db0"
202
+ VALE_SHA256: "867534ddb678abca7f214bc4706ead0922bd5252ffe8035fc227013f66c8b214"
203
203
  run: |
204
204
  curl -fsSL --retry 3 --retry-all-errors "https://github.com/errata-ai/vale/releases/download/v${VALE_VERSION}/vale_${VALE_VERSION}_Linux_64-bit.tar.gz" -o "$RUNNER_TEMP/vale.tar.gz"
205
205
  echo "${VALE_SHA256} $RUNNER_TEMP/vale.tar.gz" | sha256sum -c -
@@ -213,7 +213,7 @@ jobs:
213
213
  done
214
214
 
215
215
  - name: Run Vale Prose Lint
216
- run: pnpm lint:prose
216
+ run: pnpm bkit:lint:prose
217
217
 
218
218
  - name: Run Slop Scan
219
219
  run: pnpm lint:slop
@@ -225,7 +225,7 @@ jobs:
225
225
  if: github.event_name == 'pull_request'
226
226
  env:
227
227
  BASE_SHA: ${{ github.event.pull_request.base.sha }}
228
- run: pnpm slop:delta "$BASE_SHA"
228
+ run: pnpm bkit:slop:delta "$BASE_SHA"
229
229
 
230
230
  # actionlint validates .github/workflows/* with GitHub-Actions-aware rules
231
231
  # (${{ }} expression syntax, shellcheck on run: blocks). A YAML linter accepts
@@ -247,36 +247,55 @@ jobs:
247
247
  - name: Run bkit Check
248
248
  run: pnpm bkit check
249
249
 
250
+ # Version + sha256 pins: Renovate bumps a *_VERSION and leaves its *_SHA256, so the
251
+ # break shows only when the image is rebuilt. This downloads each pinned tool and fails
252
+ # the PR naming the tool whose hash differs. deployments.md § Dependency updaters.
253
+ # Self-skips when the repo has no .cursor/Dockerfile.
254
+ - name: Check Pinned Checksums
255
+ if: hashFiles('.cursor/Dockerfile') != ''
256
+ run: pnpm bkit ci pins --file=.cursor/Dockerfile
257
+
250
258
  # Dependency-audit gate: fails on a high or critical advisory in the lockfile that
251
- # scripts/ci/accepted-advisories.json does not accept with a reason and an in-date expiry.
259
+ # scripts/ci/bkit-accepted-advisories.json does not accept with a reason and an in-date expiry.
252
260
  # Self-skips when the guard is absent — a repo that did not adopt
253
- # scripts/ci/check-dependency-audit.mjs is a no-op. deployments.md § Dependency updaters.
261
+ # scripts/ci/bkit-check-dependency-audit.mjs is a no-op. deployments.md § Dependency updaters.
254
262
  - name: Check Dependency Audit
255
- if: hashFiles('scripts/ci/check-dependency-audit.mjs') != ''
256
- run: node scripts/ci/check-dependency-audit.mjs
263
+ if: hashFiles('scripts/ci/bkit-check-dependency-audit.mjs') != ''
264
+ run: node scripts/ci/bkit-check-dependency-audit.mjs
257
265
 
258
266
  # Capability-register freshness gate: rebuild the graph with graphify and fail when
259
267
  # docs/capabilities.md is not what this tree produces, so the register cannot drift
260
268
  # silently. Self-skips when the graphify wrapper is absent — a repo that did not adopt
261
269
  # scripts/graphify/ is a no-op. graphify is pinned because its output must match the
262
270
  # committed register to the byte: bump GRAPHIFY_SPEC (bkit-graphify.sh) and refresh the register together.
263
- # Push events only — a pull_request checkout is the MERGE ref, whose tree (base + head)
264
- # can differ from the head the register was built against: a false red no author can clear.
271
+ # Every event, PRs included, judging the tree that lands. A pull_request checkout is
272
+ # GitHub's test merge of the PR into its base: the tree a squash merge puts on the base,
273
+ # so its verdict is the post-merge push run's verdict. A PR behind its base can red here
274
+ # with a clean head, when two branches' registers merge line by line into a file no
275
+ # rebuild produces; merging the base into the branch, `pnpm bkit:graph:refresh` and a commit
276
+ # clear it. `check-at HEAD` rebuilds in a throwaway worktree of the checked-out commit —
277
+ # the same primitive the pre-push gate runs — so the release installed, the script run
278
+ # and the register judged all come from that one tree.
265
279
  - name: Setup uv
266
- if: github.event_name == 'push' && hashFiles('scripts/graphify/bkit-graphify.sh') != ''
267
- uses: astral-sh/setup-uv@1c37ad07a6a961277cf70c0d37d6f313000f5884 # v10.3.0
280
+ if: hashFiles('scripts/graphify/bkit-graphify.sh') != ''
281
+ uses: astral-sh/setup-uv@18d369b23da25a81e9458561248e1aafff6a70fa # v10.3.1
268
282
  with:
269
- version: "0.13.0"
283
+ version: "0.13.4"
270
284
 
271
285
  - name: Check Capability Register
272
- if: github.event_name == 'push' && hashFiles('scripts/graphify/bkit-graphify.sh') != ''
286
+ if: hashFiles('scripts/graphify/bkit-graphify.sh') != ''
273
287
  # graphify release pinned once: GRAPHIFY_SPEC in bkit-graphify.sh. Same release here,
274
288
  # in the pre-push gate and by hand.
275
289
  run: |
276
290
  uv tool install "$(bash scripts/graphify/bkit-graphify.sh spec)"
277
291
  # `uv tool install` drops the shim in ~/.local/bin, not on this step's PATH.
278
292
  export PATH="$HOME/.local/bin:$PATH"
279
- pnpm graph:check
293
+ if ! bash scripts/graphify/bkit-graphify.sh check-at HEAD; then
294
+ if [ "$GITHUB_EVENT_NAME" = pull_request ]; then
295
+ echo "::error title=Capability register::Checked this PR merged into $GITHUB_BASE_REF. If the branch is behind $GITHUB_BASE_REF, merge $GITHUB_BASE_REF into it first, then pnpm bkit:graph:refresh, commit and push."
296
+ fi
297
+ exit 1
298
+ fi
280
299
 
281
300
  # ── bkit-tests-unit ───────────────────────────────────────────────────────
282
301
  # Unit lane. Parallel sibling of bkit-tests-static. Integration, E2E, deploy-await,
@@ -472,7 +491,7 @@ jobs:
472
491
  # # the floor as its target, to the job summary; comments on same-repo PRs only. No floor yet → drop
473
492
  # # vite-config-path (a missing file only warns, on every run).
474
493
  # if: ${{ !cancelled() && hashFiles('coverage/unit/coverage-summary.json') != '' }}
475
- # uses: davelosert/vitest-coverage-report-action@c4bbc33a89b7ace0e63d35f1f7d4bcee31155a73 # v2.13.0
494
+ # uses: davelosert/vitest-coverage-report-action@8f86cfb56ed6d5613ea8cdc5259f207fbfd51ece # v2.13.1
476
495
  # with:
477
496
  # name: unit
478
497
  # json-summary-path: coverage/unit/coverage-summary.json
@@ -484,7 +503,7 @@ jobs:
484
503
  # - name: Report Integration Coverage on PR
485
504
  # # hashFiles guard: skip cleanly when the repo has no integration tier (no coverage/integration report produced).
486
505
  # if: github.event_name == 'pull_request' && github.event.pull_request.head.repo.full_name == github.repository && hashFiles('coverage/integration/coverage-summary.json') != ''
487
- # uses: davelosert/vitest-coverage-report-action@c4bbc33a89b7ace0e63d35f1f7d4bcee31155a73 # v2.13.0
506
+ # uses: davelosert/vitest-coverage-report-action@8f86cfb56ed6d5613ea8cdc5259f207fbfd51ece # v2.13.1
488
507
  # with:
489
508
  # name: integration
490
509
  # json-summary-path: coverage/integration/coverage-summary.json
@@ -576,7 +595,7 @@ jobs:
576
595
  # - name: Report E2E Coverage on PR
577
596
  # # Same gate as Run E2E Tests (coverage exists only if E2E ran); hashFiles skips repos that produced no E2E report.
578
597
  # if: (steps.detect.outputs.should_run_full == 'true' || steps.e2e-paths.outputs.needs_e2e == 'true') && github.event_name == 'pull_request' && github.event.pull_request.head.repo.full_name == github.repository && hashFiles('coverage/e2e/coverage-summary.json') != ''
579
- # uses: davelosert/vitest-coverage-report-action@c4bbc33a89b7ace0e63d35f1f7d4bcee31155a73 # v2.13.0
598
+ # uses: davelosert/vitest-coverage-report-action@8f86cfb56ed6d5613ea8cdc5259f207fbfd51ece # v2.13.1
580
599
  # with:
581
600
  # name: e2e
582
601
  # json-summary-path: coverage/e2e/coverage-summary.json
@@ -605,12 +624,12 @@ jobs:
605
624
  # ── bkit-tests-check ──────────────────────────────────────────────────────
606
625
  # Capstone and sole branch-protection required check. `bkit runs gate` (/bkit-ship) merges
607
626
  # only when this job is present and green at the head; `bkit setup protect-main` requires
608
- # it. Its name is `package.json` `bkit.capstoneJob` (default bkit-tests-check).
627
+ # it. Its name is `package.json` `bkit.testing.ciCapstone` (default bkit-tests-check).
609
628
  # needs: every lane — a lane missing here cannot red the capstone. if: !cancelled(), never
610
629
  # always(): a concurrency cancel must not stamp a failure. Each lane must succeed; a failed,
611
630
  # skipped or cancelled lane reds it. A lane that writes an executed-test count must have run
612
631
  # more than 0 tests. Each lane you adopt from the reference below joins needs: and the assert.
613
- # The assert is scripts/ci/check-capstone.mjs, required with this file (copy it from
632
+ # The assert is scripts/ci/bkit-check-capstone.mjs, required with this file (copy it from
614
633
  # .bkit/templates/scripts/ci/); the step reds when the script is missing.
615
634
  bkit-tests-check:
616
635
  needs: [bkit-tests-static, bkit-tests-unit]
@@ -624,8 +643,8 @@ jobs:
624
643
  - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
625
644
 
626
645
  - name: Assert Lanes Passed
627
- # The verdict is scripts/ci/check-capstone.mjs (copy it with this file from
628
- # .bkit/templates/scripts/ci/; check-capstone.test.mjs tests it). Every lane in LANES
646
+ # The verdict is scripts/ci/bkit-check-capstone.mjs (copy it with this file from
647
+ # .bkit/templates/scripts/ci/; bkit-check-capstone.test.mjs tests it). Every lane in LANES
629
648
  # must succeed; a lane with a *_RAN variable must have run more than 0 tests.
630
649
  # EMPTY_COUNT=warn: a lane that writes no count yet warns instead of failing; delete it
631
650
  # once every counted lane writes one. Add each lane you adopt to LANES and to its
@@ -637,26 +656,11 @@ jobs:
637
656
  UNIT_RESULT: ${{ needs.bkit-tests-unit.result }}
638
657
  UNIT_RAN: ${{ needs.bkit-tests-unit.outputs.tests_ran }}
639
658
  run: |
640
- if [ ! -f scripts/ci/check-capstone.mjs ]; then
641
- echo "::error::scripts/ci/check-capstone.mjs is missing. Copy it from .bkit/templates/scripts/ci/ into scripts/ci/; without it bkit-tests-check cannot tell a green lane from a lane that ran no tests."
659
+ if [ ! -f scripts/ci/bkit-check-capstone.mjs ]; then
660
+ echo "::error::scripts/ci/bkit-check-capstone.mjs is missing. Copy it from .bkit/templates/scripts/ci/ into scripts/ci/; without it bkit-tests-check cannot tell a green lane from a lane that ran no tests."
642
661
  exit 1
643
662
  fi
644
- node scripts/ci/check-capstone.mjs
645
-
646
- # bkit-stub:smoke — Post-CI smoke triggered by workflow_run on {{DEFAULT_BRANCH}}. To enable: copy the YAML below into .github/workflows/smoke.yml (separate file — workflow_run cannot share a file with push/pull_request) and delete this stub header.
647
- # name: Smoke
648
- # on:
649
- # workflow_run:
650
- # workflows: ["CI"]
651
- # types: [completed]
652
- # branches: [{{DEFAULT_BRANCH}}]
653
- # jobs:
654
- # smoke:
655
- # if: github.event.workflow_run.conclusion == 'success'
656
- # runs-on: ubuntu-latest
657
- # steps:
658
- # - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
659
- # - run: ./scripts/ci/smoke-test.sh
663
+ node scripts/ci/bkit-check-capstone.mjs
660
664
 
661
665
  # =============================================================================
662
666
  # FULL CI SCAFFOLD REFERENCE — job graph, needs, if, step names. This is the target.
@@ -737,7 +741,7 @@ jobs:
737
741
  # # package.json, which pins turbo EXACTLY — never typed here, or this lane drifts from every
738
742
  # # install-bearing lane: npm i -g "turbo@$(node -p "require('./package.json').devDependencies.turbo")"
739
743
  # - name: Resolve Base Ref # [M] push base = the branch's last green run; shipped:
740
- # # scripts/ci/lanes/resolve-push-base.mjs (falls back to github.event.before). deployments.md
744
+ # # scripts/ci/lanes/bkit-resolve-push-base.mjs (falls back to github.event.before). deployments.md
741
745
  # # § One run per branch or pull request.
742
746
  # bkit-stub:affected-graph — [M] turbo changed-packages. Stdout ≠ stderr. deployments.md § turbo `//`.
743
747
  # - name: Detect Affected Packages # [M] sets web_affected / global_dep_changed
@@ -791,13 +795,13 @@ jobs:
791
795
  # - name: Run Lint # [U] static checks FAIL-FAST before env pull; PRs scope --filter=...[origin/<base>]
792
796
  # - name: Run Typecheck # [U]
793
797
  # - name: Run Prettier # [U] CI-side format gate (hook-bypass net)
794
- # - name: Run Vale Prose Lint # [U] same root lint:prose pre-push runs (local==CI)
798
+ # - name: Run Vale Prose Lint # [U] same root bkit:lint:prose pre-push runs (local==CI)
795
799
  # - name: Run Slop Scan (full) # [U] advisory baseline
796
800
  # - name: Run Slop Scan (delta) # every event, against the planner base. deployments.md § One run.
797
801
  # - name: Tear Down Base Worktree # if: always()
798
802
  # - name: Run bkit Check # [U] drift gate (same as pre-push); catches --no-verify/web-edit/cloud drift
799
- # - name: Check Accepted Divergences # [U] node scripts/ci/check-accepted-divergences.mjs — every event-keyed step is registered; stale rows fail too. testing.md § Accepted divergences.
800
- # - name: Check Dependency Audit # [U] node scripts/ci/check-dependency-audit.mjs — high/critical advisories fail unless accepted with a reason + expiry. deployments.md § Dependency updaters.
803
+ # - name: Check Accepted Divergences # [U] node scripts/ci/bkit-check-accepted-divergences.mjs — every event-keyed step is registered; stale rows fail too. testing.md § Accepted divergences.
804
+ # - name: Check Dependency Audit # [U] node scripts/ci/bkit-check-dependency-audit.mjs — high/critical advisories fail unless accepted with a reason + expiry. deployments.md § Dependency updaters.
801
805
  # - name: Pull Vercel Env Vars # [D] preview vs prod env by branch; set CI_ENV_FILE; FAIL-FAST if critical secrets empty
802
806
  # - name: Assert Environment Shape # [D] env-shape checker (e.g. env-check.sh)
803
807
  # # Resolve URL and remote db push are NOT steps in this catalogue.
@@ -1008,11 +1012,10 @@ jobs:
1008
1012
  # setting (e.g. Vercel Deployment Checks) stays empty — this job is the promotion.
1009
1013
  #
1010
1014
  # === JOB 6 — health (separate workflow) ===
1011
- # bkit-stub:health — copy into .github/workflows/health.yml. workflow_run cannot share a file with
1012
- # push / pull_request. WHEN: you have a live URL to smoke after CI. Trigger on CI completed, default
1013
- # branch only, if the CI run succeeded. Then hit the health URL of the deployment this SHA promoted.
1014
- # e.g. poll the host until that deployment is ready, then GET /health. Not a required check.
1015
- # DROP if you have no deployed health URL.
1015
+ # bkit-stub:health — copy .bkit/templates/.github/workflows/bkit-health.yml to
1016
+ # .github/workflows/bkit-health.yml. WHEN: bkit-tests-deploy promotes and you have a live health URL.
1017
+ # Runs after every finished CI run on {{DEFAULT_BRANCH}}, green or red, and probes only when production
1018
+ # serves that run's commit. Not a required check. DROP if you have no deployed health URL.
1016
1019
  #
1017
1020
  # COMPOSES WITH bkit-cloud.yml: it routes on workflow_run.conclusion (success->ship, failure->debug);
1018
1021
  # a red bkit-tests-check turns the whole run red, so the router reads the capstone for free. See .bkit/cloud.md.
@@ -18,7 +18,7 @@ name: bkit-cloud
18
18
  # - workflow_run (CI completion on feat/**): success -> ship, failure -> debug
19
19
  # - workflow_run (CI completion on dev): success -> no-op (regression check passed),
20
20
  # failure -> /bkit-debug {FID} (FID recovered from squash-merge commit scope;
21
- # loop-bounded by MAX_DEV_DISPATCH_ATTEMPTS). [skip ci] close commits never trigger CI.
21
+ # capped at debug fix + soak maxAttempts dispatches). [skip ci] close commits never trigger CI.
22
22
  # - workflow_dispatch: pick ANY phase (ship|debug|design|plan|build) for an issue.
23
23
  # design/plan/build have no tracker-event trigger; they run only via dispatch.
24
24
  #
@@ -83,11 +83,6 @@ concurrency:
83
83
  # `dev-dispatch-dropped` row to the job summary + a `::warning::`.
84
84
  cancel-in-progress: ${{ github.event.workflow_run.head_branch != 'dev' }}
85
85
 
86
- # Cap on dev-triggered debug dispatches per FID (distinct failed dev CI SHAs).
87
- # A bkit test holds it equal to MAX_DEV_DISPATCH_ATTEMPTS in `bkit counters max`.
88
- env:
89
- MAX_DEV_DISPATCH_ATTEMPTS: 3
90
-
91
86
  jobs:
92
87
  # ---------------------------------------------------------------------------
93
88
  # context job — checks which runner secrets are set and resolves phase + arg ONCE
@@ -98,7 +93,7 @@ jobs:
98
93
  # this job is skipped, both runner jobs are skipped with it.
99
94
  # ---------------------------------------------------------------------------
100
95
  context:
101
- name: context (${{ github.event_name }})
96
+ name: bkit-cloud-context (${{ github.event_name }})
102
97
  if: >-
103
98
  github.event_name == 'workflow_dispatch'
104
99
  || (
@@ -192,9 +187,9 @@ jobs:
192
187
  set -euo pipefail
193
188
  # Cloud runs serve the GitHub tracker only: Linear cloud runs start from Cursor's
194
189
  # Linear integration, and Jira runs locally only. Unset tracker → continue.
195
- TRACKER=$(sed -n 's/.*"issueTracker"[[:space:]]*:[[:space:]]*"\([a-z]*\)".*/\1/p' package.json 2>/dev/null | head -1 || true)
190
+ TRACKER=$(jq -r '.bkit.tracker.default // empty | strings' package.json 2>/dev/null || true)
196
191
  if [ -n "$TRACKER" ] && [ "$TRACKER" != "github" ]; then
197
- echo "::notice::bkit.issueTracker is '$TRACKER' — bkit-cloud.yml serves the GitHub tracker only; no-op exit."
192
+ echo "::notice::bkit.tracker.default is '$TRACKER' — bkit-cloud.yml serves the GitHub tracker only; no-op exit."
198
193
  echo "skip=true" >> "$GITHUB_OUTPUT"; exit 0
199
194
  fi
200
195
  if [ "$EVENT" = "workflow_dispatch" ]; then
@@ -216,8 +211,12 @@ jobs:
216
211
  # bkit_dev_dispatch_guard <FID> <HEAD_SHA> — cap-check +
217
212
  # counter-write + fail-closed-verify for the post-merge debug
218
213
  # surface (dev CI failure). One post-feat/** debug budget per FID.
219
- # Returns 1 (caller must skip) once the FID has MAX_DEV_DISPATCH_
220
- # ATTEMPTS distinct failed-CI SHAs recorded, or if the counter row
214
+ # Returns 1 (caller must skip) once the FID has DEBUG_CAP distinct
215
+ # failed-CI SHAs recorded — DEBUG_CAP = package.json
216
+ # bkit.workflows.debug fix + soak maxAttempts (2 each when unset or
217
+ # not a whole number of 1 or more; the engine falls back the same
218
+ # way) — every debug run makes at least one attempt, so more
219
+ # dispatches could never run one — or if the counter row
221
220
  # cannot be durably landed on origin/dev (fail-closed: one push
222
221
  # retry against a re-fetched dev, then VERIFY landing before
223
222
  # proceeding). Returns 0 to proceed to dispatch.
@@ -235,11 +234,14 @@ jobs:
235
234
  # The caller invokes this function as `... || { skip }`, which
236
235
  # suppresses `set -e` for the whole body. An explicit test, not
237
236
  # `${VAR:?}`: the `:?` expansion exits the whole shell even from
238
- # inside a `|| {}`-guarded function. Fail closed when the
239
- # workflow-level env does not define a whole-number cap.
240
- case "${MAX_DEV_DISPATCH_ATTEMPTS:-}" in
237
+ # inside a `|| {}`-guarded function. Fail closed when the cap
238
+ # cannot be read as a whole number.
239
+ local debug_cap
240
+ debug_cap=$(jq -r 'def lim($p): ((if ($p | type) == "object" then $p.maxAttempts else null end) // 2) | if type == "number" and . >= 1 and floor == . then . else 2 end;
241
+ (.bkit.workflows.debug // {}) as $d | lim($d.fix // {}) + lim($d.soak // {})' package.json 2>/dev/null || true)
242
+ case "${debug_cap:-}" in
241
243
  '' | *[!0-9]*)
242
- echo "::notice::MAX_DEV_DISPATCH_ATTEMPTS is not set to a whole number — refusing to dispatch uncounted (fail-closed)."
244
+ echo "::notice::package.json bkit.workflows.debug limits are unreadable — refusing to dispatch uncounted (fail-closed)."
243
245
  return 1
244
246
  ;;
245
247
  esac
@@ -265,8 +267,8 @@ jobs:
265
267
  return 1
266
268
  fi
267
269
  fi
268
- if [ "$dev_count" -ge "$MAX_DEV_DISPATCH_ATTEMPTS" ]; then
269
- echo "::notice::FID $guard_fid exhausted $MAX_DEV_DISPATCH_ATTEMPTS dev-triggered debug dispatches — operator review required (delete dev-dispatch rows in status.jsonl to reset)."
270
+ if [ "$dev_count" -ge "$debug_cap" ]; then
271
+ echo "::notice::FID $guard_fid exhausted $debug_cap dev-triggered debug dispatches — operator review required (delete dev-dispatch rows in status.jsonl to reset)."
270
272
  return 1
271
273
  fi
272
274
  parent_sha=$(git -C "$GITHUB_WORKSPACE" rev-parse origin/dev 2>/dev/null || echo "")
@@ -441,9 +443,9 @@ jobs:
441
443
  fi
442
444
  fi
443
445
 
444
- # feat/** is NOT capped by MAX_DEV_DISPATCH_ATTEMPTS: pre-merge,
445
- # PR-scoped, bounded by the in-session MAX_DEBUG_ATTEMPT /
446
- # MAX_NORMAL_ATTEMPT counters. The dev arm above is the only
446
+ # feat/** is NOT capped here: pre-merge, PR-scoped, bounded by
447
+ # the debug workflow's fix and soak limits, which count across
448
+ # every debug run of the FID. The dev arm above is the only
447
449
  # capped surface.
448
450
  fi
449
451
  fi
@@ -467,7 +469,7 @@ jobs:
467
469
  # `/install-github-app` in the consumer repo.
468
470
  # ---------------------------------------------------------------------------
469
471
  run:
470
- name: claude (${{ github.event_name }})
472
+ name: bkit-cloud-claude (${{ github.event_name }})
471
473
  needs: context
472
474
  if: needs.context.outputs.claude == 'true' && needs.context.outputs.skip != 'true'
473
475
  runs-on: {{CLOUD_RUNNER}}
@@ -493,13 +495,13 @@ jobs:
493
495
  token: ${{ github.token }}
494
496
 
495
497
  # Installs the vale binary for bkit-cloud-bootstrap.sh's `vale sync` and the dispatched
496
- # phase's lint:prose (as the cloud.md web env's setup script does). Pinned tarball +
498
+ # phase's bkit:lint:prose (as the cloud.md web env's setup script does). Pinned tarball +
497
499
  # SHA mirror bkit-ci.yml.
498
500
  - name: Install vale
499
501
  env:
500
502
  # renovate: datasource=github-releases depName=errata-ai/vale
501
- VALE_VERSION: "3.9.1"
502
- VALE_SHA256: "fbc2eb47d0b8c50220ed1a2c5c611fbe0904ed567d638143d482016a18fd2db0"
503
+ VALE_VERSION: "3.24.0"
504
+ VALE_SHA256: "867534ddb678abca7f214bc4706ead0922bd5252ffe8035fc227013f66c8b214"
503
505
  run: |
504
506
  curl -fsSL --retry 3 --retry-all-errors "https://github.com/errata-ai/vale/releases/download/v${VALE_VERSION}/vale_${VALE_VERSION}_Linux_64-bit.tar.gz" -o "$RUNNER_TEMP/vale.tar.gz"
505
507
  echo "${VALE_SHA256} $RUNNER_TEMP/vale.tar.gz" | sha256sum -c -
@@ -512,7 +514,7 @@ jobs:
512
514
  git config user.email 'bkit-auto@users.noreply.github.com'
513
515
 
514
516
  - name: Dispatch /bkit-auto on Claude Code runner
515
- uses: anthropics/claude-code-action@1d6de8cb0c237e7c15e9e1bdf973826ebae490cc # v1.0.248
517
+ uses: anthropics/claude-code-action@aa8a7738e48bf30a40ee499ce818bef081c5ab5e # v1.0.257
516
518
  with:
517
519
  # Orchestrator contract: `/bkit-auto <phase> <arg>` where <arg> is the open
518
520
  # PR number (ship/debug) or the tracker issue number/id (design/plan/build).
@@ -542,7 +544,7 @@ jobs:
542
544
  # opencode.json ${VAR} reference resolves regardless of which provider is installed.
543
545
  # ---------------------------------------------------------------------------
544
546
  opencode:
545
- name: opencode (${{ github.event_name }})
547
+ name: bkit-cloud-opencode (${{ github.event_name }})
546
548
  needs: context
547
549
  if: needs.context.outputs.opencode == 'true' && needs.context.outputs.skip != 'true'
548
550
  runs-on: {{CLOUD_RUNNER}}
@@ -565,14 +567,13 @@ jobs:
565
567
 
566
568
  - name: Install opencode
567
569
  run: |
568
- # Version-pinned. No updater bumps this pin: take the new version from bkit's
569
- # template when `bkit upgrade` lists this file, or bump it by hand.
570
- # 2.0.x ships ONLY on npm as `@opencode/cli` — there is no 2.x GitHub release (latest
571
- # is v1.19.0), so the curl installer (https://opencode.ai/install downloads GitHub
572
- # release binaries) cannot fetch 2.0.26. npm's postinstall selects the runner's
573
- # platform binary.
570
+ # Version-pinned. Renovate bumps it through the `# renovate:` line below; without
571
+ # Renovate, take the new version from bkit's template when `bkit upgrade` lists
572
+ # this file. Installed from npm (`@opencode/cli`): the curl installer
573
+ # (https://opencode.ai/install) installs OpenCode 1 only and refuses a 2.x version.
574
+ # npm's postinstall selects the runner's platform binary.
574
575
  # renovate: datasource=npm depName=@opencode/cli
575
- npm install -g @opencode/cli@2.0.26
576
+ npm install -g @opencode/cli@2.1.2
576
577
  echo "$(npm prefix -g)/bin" >> "$GITHUB_PATH"
577
578
 
578
579
  - name: Dispatch /bkit-auto on opencode runner
@@ -0,0 +1,97 @@
1
+ # Example health check. Copy it to `.github/workflows/bkit-health.yml` and own it.
2
+ # bkit install does not write this file and does not overwrite a copy.
3
+ #
4
+ # Probes production after every finished bkit-ci run on the default branch, whatever the run's
5
+ # conclusion: bkit-tests-deploy promotes before the E2E and @live lanes run, so a red run can
6
+ # still have put a release live. The probe runs only when production serves the run's commit,
7
+ # and the job fails, rather than skips, when it cannot tell. Not a required check.
8
+ # See `.bkit/templates.md` § Health check.
9
+ #
10
+ # Fits a deploy that bkit-ci promotes. When the host deploys on its own after merge, trigger on
11
+ # `deployment_status` instead (`docs/deployments.md` § Smoke trigger plumbing).
12
+ # `Did This Run Promote?` asks Vercel; swap it for your host's API. The probe is host-agnostic.
13
+ name: bkit-health
14
+
15
+ on:
16
+ workflow_run:
17
+ # The `name:` of your CI workflow.
18
+ workflows: [bkit-ci]
19
+ types: [completed]
20
+ branches: [{{DEFAULT_BRANCH}}]
21
+
22
+ permissions:
23
+ contents: read
24
+
25
+ concurrency:
26
+ # workflow_run sets github.ref to the default branch, so key by the CI run's branch.
27
+ group: bkit-health-${{ github.event.workflow_run.head_branch }}
28
+ cancel-in-progress: true
29
+
30
+ env:
31
+ PRODUCTION_URL: "{{PRODUCTION_URL}}"
32
+ HEALTH_PATH: /api/health
33
+
34
+ jobs:
35
+ promoted:
36
+ name: bkit-health-promoted
37
+ runs-on: ubuntu-latest
38
+ timeout-minutes: 2
39
+ outputs:
40
+ live: ${{ steps.live.outputs.live }}
41
+ steps:
42
+ - name: Did This Run Promote?
43
+ id: live
44
+ env:
45
+ VERCEL_TOKEN: ${{ secrets.VERCEL_TOKEN }}
46
+ VERCEL_TEAM_ID: ${{ secrets.VERCEL_TEAM_ID }}
47
+ HEAD_SHA: ${{ github.event.workflow_run.head_sha }}
48
+ run: |
49
+ host="${PRODUCTION_URL#*://}"
50
+ host="${host%%/*}"
51
+ resp=$(curl -sS --max-time 30 -w '\n%{http_code}' -H "Authorization: Bearer $VERCEL_TOKEN" \
52
+ "https://api.vercel.com/v13/deployments/${host}?teamId=${VERCEL_TEAM_ID}" || true)
53
+ code=$(printf '%s\n' "$resp" | tail -1)
54
+ body=$(printf '%s\n' "$resp" | sed '$d')
55
+ if [ "$code" != "200" ]; then
56
+ echo "::error::Could not read which deployment production serves (HTTP ${code:-none}). Failing, because a skipped probe would look green."
57
+ exit 1
58
+ fi
59
+ live_sha=$(printf '%s' "$body" | jq -r '.meta.githubCommitSha // empty')
60
+ if [ "$live_sha" = "$HEAD_SHA" ]; then
61
+ echo "live=true" >> "$GITHUB_OUTPUT"
62
+ echo "Production serves ${HEAD_SHA}, this run's commit: probing it."
63
+ else
64
+ echo "live=false" >> "$GITHUB_OUTPUT"
65
+ echo "Production serves '${live_sha:-nothing}', not ${HEAD_SHA}: this run released nothing to probe."
66
+ fi
67
+
68
+ health:
69
+ name: bkit-health
70
+ needs: promoted
71
+ if: needs.promoted.outputs.live == 'true'
72
+ runs-on: ubuntu-latest
73
+ timeout-minutes: 5
74
+ steps:
75
+ # A deployment the host reports as live can still be warming up, so retry until it
76
+ # answers. Check the body your endpoint returns as well as the status, so a 200 from
77
+ # an error page fails.
78
+ - name: Probe Health Endpoint
79
+ run: |
80
+ url="${PRODUCTION_URL%/}${HEALTH_PATH}"
81
+ deadline=$(( $(date +%s) + 240 ))
82
+ while :; do
83
+ code=$(curl -sS -o /dev/null -w '%{http_code}' --max-time 10 "$url" || echo 000)
84
+ if [ "$code" = "200" ]; then
85
+ echo "$url answered 200."
86
+ exit 0
87
+ fi
88
+ if [ "$(date +%s)" -ge "$deadline" ]; then
89
+ echo "::error::$url did not answer 200 within 240s (last HTTP $code)."
90
+ exit 1
91
+ fi
92
+ sleep 10
93
+ done
94
+
95
+ # Add your own probes as further steps: a curl script over key routes, or a small tagged
96
+ # browser suite. A step that runs a repo script needs `actions/checkout` first, with
97
+ # `ref: ${{ github.event.workflow_run.head_sha }}` so it runs the released commit's code.
@@ -13,7 +13,7 @@
13
13
  #
14
14
  # SHA-pin the action. This file is yours, so Renovate may bump the pin. Do NOT add
15
15
  # this path to renovate.json5 `ignorePaths`.
16
- name: Renovate
16
+ name: bkit-renovate
17
17
 
18
18
  on:
19
19
  workflow_dispatch:
@@ -30,7 +30,7 @@ on:
30
30
  type: string
31
31
  schedule:
32
32
  # Wake the bot once a day, at an off-hour minute. Renovate's OWN schedule in
33
- # renovate.json5 ("before 6am on Monday") gates when normal update PRs open;
33
+ # renovate.json5 (all of Monday, UTC) gates when normal update PRs open;
34
34
  # osvVulnerabilityAlerts CVE PRs bypass it and open on the next daily wake.
35
35
  # Do NOT narrow this cron to Monday-only.
36
36
  - cron: "17 6 * * *"
@@ -49,6 +49,7 @@ concurrency:
49
49
 
50
50
  jobs:
51
51
  renovate:
52
+ name: bkit-renovate
52
53
  runs-on: ubuntu-latest # ~16 GB. Edit this label in your copy.
53
54
  timeout-minutes: 30
54
55
  steps:
@@ -65,7 +66,7 @@ jobs:
65
66
  # app-id: ${{ secrets.RENOVATE_APP_ID }}
66
67
  # private-key: ${{ secrets.RENOVATE_APP_PRIVATE_KEY }}
67
68
  # then set `token: ${{ steps.app-token.outputs.token }}` below.
68
- - uses: renovatebot/github-action@230ce922b08968d0a4f6f70f295601daff09ef1d # v46.3.7
69
+ - uses: renovatebot/github-action@a63d9a7bc606f7336fd20b47f2f32259a35e6213 # v46.3.9
69
70
  with:
70
71
  # PAT secret (default). FINE-GRAINED repository permissions (this repo):
71
72
  # Contents: Read and write · Pull requests: Read and write ·
@@ -84,7 +85,7 @@ jobs:
84
85
  # uses GitHub releases (they carry publish dates, so `minimumReleaseAge` applies);
85
86
  # the image tags on ghcr.io carry none.
86
87
  # renovate: datasource=github-releases depName=renovatebot/renovate
87
- renovate-version: "44.151.0"
88
+ renovate-version: "44.176.2"
88
89
  env:
89
90
  # Scope to THIS repo only — never org-wide autodiscover.
90
91
  RENOVATE_REPOSITORIES: ${{ github.repository }}
@@ -11,7 +11,7 @@
11
11
  # `aquasecurity/trivy-action` or `setup-trivy` by tag: in March 2026 their tags were
12
12
  # re-pointed at a credential stealer. This file is yours, so Renovate bumps the tag and
13
13
  # digest together. Do NOT add this path to renovate.json5 `ignorePaths`.
14
- name: Trivy
14
+ name: bkit-trivy
15
15
 
16
16
  on:
17
17
  workflow_dispatch:
@@ -33,6 +33,7 @@ concurrency:
33
33
 
34
34
  jobs:
35
35
  trivy:
36
+ name: bkit-trivy
36
37
  runs-on: ubuntu-latest # Edit this label in your copy.
37
38
  timeout-minutes: 15
38
39
  steps:
@@ -40,14 +41,14 @@ jobs:
40
41
  with:
41
42
  persist-credentials: false
42
43
 
43
- # `scripts/ci/check-dependency-audit.mjs` (bkit-ci.yml `Check Dependency Audit`)
44
- # already gates pnpm-lock.yaml against `accepted-advisories.json`; scanning it here
44
+ # `scripts/ci/bkit-check-dependency-audit.mjs` (bkit-ci.yml `Check Dependency Audit`)
45
+ # already gates pnpm-lock.yaml against `bkit-accepted-advisories.json`; scanning it here
45
46
  # too would need every acceptance twice. Without that gate, Trivy owns the lockfile.
46
47
  - name: Plan Scan
47
48
  id: plan
48
49
  run: |
49
50
  args=""
50
- if [ -f scripts/ci/check-dependency-audit.mjs ]; then
51
+ if [ -f scripts/ci/bkit-check-dependency-audit.mjs ]; then
51
52
  args="$args --skip-files pnpm-lock.yaml"
52
53
  fi
53
54
  if [ -f .trivyignore.yaml ]; then
@@ -3,11 +3,11 @@
3
3
  # bkit install does not write this file and does not overwrite a copy.
4
4
  #
5
5
  # FAST local gate only: format staged files (seconds). Heavier gates
6
- # (typecheck/unit/format:check/prose), the enforcing slop gate (slop:delta) and the
6
+ # (typecheck/unit/format:check/prose), the enforcing slop gate (bkit:slop:delta) and the
7
7
  # integration tier are in pre-push; E2E/@live run ONLY in CI (bkit-tests / bkit-tests-live,
8
8
  # enforced by bkit-tests-check) — see bkit-ci.yml § FULL CI SCAFFOLD REFERENCE. Rule: nothing
9
9
  # here that pre-push runs again, and nothing that takes more than a few seconds. (lint:slop is `slop-scan scan` — report-only, never
10
- # fails; the gate that fails on NEW findings is `slop:delta`, which runs in pre-push.)
10
+ # fails; the gate that fails on NEW findings is `bkit:slop:delta`, which runs in pre-push.)
11
11
  #
12
12
  # WHAT it runs lives in package.json `bkit:gate:format`, not here — the same script
13
13
  # the bkit agent workflows dispatch through; change the gate there. Add repo-specific