@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
@@ -89,18 +89,100 @@ export function antigravityToolsBlock(toolsBlock) {
89
89
  }
90
90
  return out;
91
91
  }
92
+ /**
93
+ * Thinking-effort values each model exposes on each variant-carrying opencode gateway
94
+ * (`reasoning_options` effort values in models.dev, read 2026-10-28; models.dev provider
95
+ * `opencode` = bkit key `opencode-zen`). One model can differ per gateway — `deepseek-v4.1-flash`
96
+ * has `none` on OpenRouter only — and OpenCode hard-errors on a `variant:` the model does not
97
+ * expose there. An empty list = `toggle`-only or no reasoning options: no effort variant at all.
98
+ * ollama has no entry: it carries no variant on any model (applyOpencodeAgent skips it). An
99
+ * unlisted gateway or model passes the mapped value through unchanged.
100
+ */
101
+ const OPENCODE_VARIANT_LEVELS = {
102
+ openrouter: {
103
+ "deepseek-v4.1-flash": ["none", "low", "high", "max"],
104
+ "minimax-m3.1-flash": ["low", "medium", "high", "xhigh", "max"],
105
+ "glm-5.3-flash": ["low", "high", "max"],
106
+ "gemini-4-argon": ["low", "medium", "high"],
107
+ "gpt-6.1-sol": ["low", "medium", "high", "xhigh", "max"],
108
+ "mimo-v2.6-pro": [],
109
+ "kimi-k3": ["none", "low", "high", "max"],
110
+ },
111
+ "opencode-zen": {
112
+ "deepseek-v4.1-flash": ["low", "high", "max"],
113
+ "minimax-m3.1-flash": ["low", "medium", "high", "xhigh", "max"],
114
+ "glm-5.3-flash": ["low", "high", "max"],
115
+ "gemini-4-argon": ["low", "medium", "high"],
116
+ "gpt-6.1-sol": ["low", "medium", "high", "xhigh", "max"],
117
+ "kimi-k3": ["low", "high", "max"],
118
+ },
119
+ "opencode-go": {
120
+ "deepseek-v4.1-flash": ["low", "high", "max"],
121
+ "minimax-m3.1-flash": ["low", "medium", "high", "xhigh", "max"],
122
+ "glm-5.3-flash": ["low", "high", "max"],
123
+ "gemini-4-argon": ["low", "medium", "high"],
124
+ "mimo-v2.6-pro": [],
125
+ "kimi-k3": ["max"],
126
+ },
127
+ };
128
+ const VARIANT_RANK = ["none", "low", "medium", "high", "xhigh", "max"];
129
+ /**
130
+ * Models at or above the sonnet bar on the LiveBench 2.0 board (`providers.md` § LiveBench 2.0
131
+ * board). They keep the agent's own Claude effort on opencode; every other model takes the
132
+ * "OpenCode" ladder, which raises it to the top rung to close the gap to the bar.
133
+ */
134
+ const OPENCODE_AT_BAR_MODELS = [
135
+ "claude-fable-5.1",
136
+ "gpt-6-astra",
137
+ "claude-opus-5.5",
138
+ "gpt-6.1-sol",
139
+ "claude-sonnet-5.5",
140
+ ];
141
+ /** The effort ladder for `model` on opencode: the agent's own for an at-bar model, else "opencode". */
142
+ function opencodeEffortProgram(model) {
143
+ const slug = model.split("/").pop() ?? model;
144
+ return OPENCODE_AT_BAR_MODELS.includes(slug) ? "claude" : "opencode";
145
+ }
146
+ /**
147
+ * The variant to emit for `model` on gateway `provider` at mapped `variant`: the value itself
148
+ * when the model exposes it there, else the highest level it does expose at or under it, else
149
+ * its lowest. A model with no effort control gets null, so no `variant:` line is written.
150
+ */
151
+ export function clampOpencodeVariant(provider, model, variant) {
152
+ if (!variant)
153
+ return null;
154
+ const gatewayLevels = Object.entries(OPENCODE_VARIANT_LEVELS).find(([gateway]) => gateway === provider)?.[1];
155
+ if (!gatewayLevels)
156
+ return variant;
157
+ const slug = Object.keys(gatewayLevels)
158
+ .sort((a, b) => b.length - a.length)
159
+ .find((key) => model.split("/").pop()?.includes(key) || model.includes(key));
160
+ if (!slug)
161
+ return variant;
162
+ const levels = gatewayLevels[slug];
163
+ if (levels.length === 0)
164
+ return null;
165
+ if (levels.includes(variant))
166
+ return variant;
167
+ const wanted = VARIANT_RANK.indexOf(variant);
168
+ const atOrUnder = levels
169
+ .filter((l) => VARIANT_RANK.indexOf(l) <= wanted)
170
+ .sort((a, b) => VARIANT_RANK.indexOf(b) - VARIANT_RANK.indexOf(a));
171
+ return atOrUnder[0] ?? levels[0];
172
+ }
92
173
  /**
93
174
  * OC1: opencode agent frontmatter rewrite.
94
175
  * Emits: mode, name, description, model, tools (Claude array → opencode object map),
95
- * variant (the effort table's value for this agent, from the one shared "OpenCode"
96
- * ladder). The variant is a SEPARATE field, not a `#`-suffix on the model: 1.x reads
97
- * `variant:` natively, 2.0 joins `model` + `variant` internally, and a variant joined
98
- * to the model string with `#` breaks 1.x (its model id lookup keeps the suffix). The
99
- * ollama gateway is exempt from `variant:` — its provider builds model entries with no
100
- * variants, so any variant there is a hard 2.0 error; omit it and let opencode use its
101
- * own default. Drops: Claude-only fields (permissionMode, maxTurns, is_background,
102
- * readonly) and the original effort field. Hard-fails with non-zero exit if model
103
- * lookup missing for name.
176
+ * variant (the effort table's value for this agent from the one shared "OpenCode" ladder, or
177
+ * the agent's own Claude effort on an at-bar model, clamped by clampOpencodeVariant to what
178
+ * the pinned model exposes on this gateway). The
179
+ * variant is a SEPARATE field, not a `#`-suffix on the model: 1.x reads `variant:` natively,
180
+ * 2.0 joins `model` + `variant` internally, and a variant joined to the model string with `#`
181
+ * breaks 1.x (its model id lookup keeps the suffix). The ollama gateway is exempt from
182
+ * `variant:` — its provider builds model entries with no variants, so any variant there is a
183
+ * hard 2.0 error; omit it and let opencode use its own default. Drops: Claude-only fields
184
+ * (permissionMode, maxTurns, is_background, readonly) and the original effort field.
185
+ * Hard-fails with non-zero exit if model lookup missing for name.
104
186
  */
105
187
  export function applyOpencodeAgent(content, opencodeModelLookup, effortMap, provider) {
106
188
  const subagent = requireSubagentModel(content, opencodeModelLookup, "opencode");
@@ -110,6 +192,7 @@ export function applyOpencodeAgent(content, opencodeModelLookup, effortMap, prov
110
192
  const description = parsed.get("description") ?? "";
111
193
  const effort = parsed.get("effort");
112
194
  const toolsBlock = extractFrontmatterField(fmBlock, "tools");
195
+ // autoCompactWindow dropped: no per-agent setting, see providers.md § Context compaction.
113
196
  let newFm = "---\n";
114
197
  newFm += `mode: subagent\n`;
115
198
  newFm += `name: ${name}\n`;
@@ -120,13 +203,14 @@ export function applyOpencodeAgent(content, opencodeModelLookup, effortMap, prov
120
203
  else {
121
204
  newFm += `description: ${description}\n`;
122
205
  }
123
- // Thinking effort is a model variant in its own `variant:` field. Program-keyed: every
124
- // opencode gateway shares the one "OpenCode" ladder; the gateway is not consulted —
125
- // except ollama, which cannot carry a variant at all (see the function docstring).
206
+ // Thinking effort is a model variant in its own `variant:` field. Every opencode gateway
207
+ // shares the one "OpenCode" ladder, except that an at-bar model keeps the agent's own
208
+ // effort; the gateway decides only which rungs the pinned model exposes, and ollama
209
+ // carries no variant at all (see the function docstring).
126
210
  const modelPin = formatModelPin("opencode", provider ?? "", opencodeModel);
127
211
  newFm += `model: ${modelPin}\n`;
128
212
  const variant = provider !== "ollama" && effort && effortMap
129
- ? lookupEffort(effortMap, "opencode", effort)
213
+ ? clampOpencodeVariant(provider ?? "", opencodeModel, lookupEffort(effortMap, opencodeEffortProgram(opencodeModel), effort))
130
214
  : null;
131
215
  if (variant)
132
216
  newFm += `variant: ${variant}\n`;
@@ -195,6 +279,7 @@ export function applyCodexAgent(content, codexModelLookup, effortMap) {
195
279
  const { afterFm, parsed, name, model } = subagent;
196
280
  const body = afterFm.trim();
197
281
  const effort = parsed.get("effort");
282
+ // autoCompactWindow dropped: a role file's model_auto_compact_token_limit is discarded (openai/codex core/src/agent/role.rs:37-48).
198
283
  let out = "";
199
284
  out += tomlString("name", name);
200
285
  out += tomlString("description", parsed.get("description") ?? "");
@@ -358,6 +443,7 @@ export function applyT3(content, modelLookup, effortMap) {
358
443
  const description = parsed.get("description") ?? "";
359
444
  const effort = parsed.get("effort");
360
445
  const toolsBlock = extractFrontmatterField(fmBlock, "tools");
446
+ // autoCompactWindow dropped: no per-agent setting, see providers.md § Context compaction.
361
447
  let newFm = "---\n";
362
448
  newFm += `name: ${name}\n`;
363
449
  if (description.includes("\n")) {
@@ -421,6 +507,7 @@ export function applyAntigravityPrompt(content, modelLookup, effortMap) {
421
507
  const description = parsed.get("description") ?? "";
422
508
  const effort = parsed.get("effort");
423
509
  const toolsBlock = extractFrontmatterField(fmBlock, "tools");
510
+ // autoCompactWindow dropped: no per-agent setting, see providers.md § Context compaction.
424
511
  let newFm = "---\n";
425
512
  newFm += `name: ${name}\n`;
426
513
  if (description.includes("\n")) {
@@ -432,7 +519,10 @@ export function applyAntigravityPrompt(content, modelLookup, effortMap) {
432
519
  }
433
520
  newFm += `model: ${formatModelPin("antigravity", "google", model)}\n`;
434
521
  if (effort && effortMap) {
435
- newFm += `effort: ${lookupEffort(effortMap, "antigravity", effort)}\n`;
522
+ // Same per-model ceiling as opencode's variant: gemini-4-argon stops at `high`, so an
523
+ // xhigh/max agent must not ask Antigravity for a rung the model does not expose.
524
+ const mapped = lookupEffort(effortMap, "antigravity", effort);
525
+ newFm += `effort: ${mapped === "max" && model.includes("gemini-4-argon") ? "high" : mapped}\n`;
436
526
  }
437
527
  newFm += antigravityToolsBlock(toolsBlock);
438
528
  newFm += "---\n";
@@ -189,6 +189,18 @@ export function applyModelOverrides(lookup, providerKey, overridesPath) {
189
189
  }
190
190
  }
191
191
  }
192
+ /**
193
+ * Override rows (from `overridesPath`) naming no agent in `known`, deduplicated in file
194
+ * order. `applyModelOverrides` skips such rows, so they are reported, not applied.
195
+ */
196
+ export function unknownModelOverrides(overridesPath, known) {
197
+ const out = [];
198
+ for (const o of parseModelOverrides(overridesPath)) {
199
+ if (!known.has(o.prompt) && !out.includes(o.prompt))
200
+ out.push(o.prompt);
201
+ }
202
+ return out;
203
+ }
192
204
  // column → (sourceEffort → target)
193
205
  /**
194
206
  * Program → prompts.md effort-table column header.
@@ -83,8 +83,8 @@ export function lookupLatestPublished(cwd, timeoutS = TIMEOUTS.BKIT_LATEST_LOOKU
83
83
  const version = (res.stdout ?? "").trim().replace(/^v/, "");
84
84
  return SEMVER_RE.test(version) ? version : null;
85
85
  }
86
- /** The cached registry answer when still fresh: a version, or null for a remembered failure. */
87
- function readCache(file, now) {
86
+ /** The cache file's registry answer and when it was asked, however old; undefined when unreadable. */
87
+ function readCacheEntry(file) {
88
88
  if (!fs.existsSync(file))
89
89
  return undefined;
90
90
  const parsed = parseJson(fs.readFileSync(file, "utf-8"));
@@ -94,8 +94,30 @@ function readCache(file, now) {
94
94
  if (typeof checkedAt !== "number")
95
95
  return undefined;
96
96
  const value = typeof latest === "string" && SEMVER_RE.test(latest) ? latest : null;
97
- const ttl = value === null ? TIMEOUTS.BKIT_LATEST_RETRY_S : TIMEOUTS.BKIT_LATEST_CACHE_S;
98
- return now - checkedAt < ttl * 1000 && now >= checkedAt ? { latest: value } : undefined;
97
+ return { latest: value, checkedAt };
98
+ }
99
+ /** The cached registry answer when still fresh: a version, or null for a remembered failure. */
100
+ function readCache(file, now) {
101
+ const entry = readCacheEntry(file);
102
+ if (entry === undefined)
103
+ return undefined;
104
+ const { latest, checkedAt } = entry;
105
+ const ttl = latest === null ? TIMEOUTS.BKIT_LATEST_RETRY_S : TIMEOUTS.BKIT_LATEST_CACHE_S;
106
+ return now - checkedAt < ttl * 1000 && now >= checkedAt ? { latest } : undefined;
107
+ }
108
+ /**
109
+ * True when the release last cached in `gitCommonDir` is newer than this repo's bkit,
110
+ * however old that answer is: a release once seen stays newer until the repo upgrades.
111
+ * Never asks the registry, so local callers (setup tips) can use it, and ignores
112
+ * `NO_UPDATE_CHECK_ENV`: that skips the lookup, while a release already seen stays
113
+ * true. False when the cache or the pin leave nothing to compare.
114
+ */
115
+ export function cachedBkitOutdated(root, gitCommonDir) {
116
+ const version = readBkitVersion(path.join(root, ".bkit", "version"))?.pinnedVersion || null;
117
+ if (version === null)
118
+ return false;
119
+ const latest = readCacheEntry(path.join(gitCommonDir, BKIT_LATEST_CACHE))?.latest ?? null;
120
+ return latest !== null && compareSemver(version, latest) === -1;
99
121
  }
100
122
  /** Remember the registry answer; a cache that cannot be written only costs a lookup next run. */
101
123
  function writeCache(file, latest, now) {
@@ -5,7 +5,9 @@
5
5
  // this one rule.
6
6
  /** The integration branch feature work lands on. */
7
7
  export const DEV = "dev";
8
+ /** The release branch: bkit never opens a PR into it or merges into it. */
9
+ export const MAIN = "main";
8
10
  /** True for `dev` and `main`: no feature work happens on them, no force-push touches them. */
9
11
  export function isSharedBranch(branch) {
10
- return branch === DEV || branch === "main";
12
+ return branch === DEV || branch === MAIN;
11
13
  }
@@ -0,0 +1,49 @@
1
+ // shared/dep-updater.ts — which dependency updater a repo runs, read from the config files the
2
+ // updater itself reads.
3
+ import * as fs from "node:fs";
4
+ import * as path from "node:path";
5
+ import { readPackageJson } from "./package-json.js";
6
+ export const DEP_UPDATERS = ["renovate", "dependabot"];
7
+ export const DEP_UPDATER_NAMES = {
8
+ renovate: "Renovate",
9
+ dependabot: "Dependabot",
10
+ };
11
+ // Renovate's repository config locations, in its lookup order (docs.renovatebot.com
12
+ // § Configuration options); a `renovate` block in package.json comes last.
13
+ const RENOVATE_FILES = [
14
+ "renovate.json",
15
+ "renovate.jsonc",
16
+ "renovate.json5",
17
+ ".github/renovate.json",
18
+ ".github/renovate.jsonc",
19
+ ".github/renovate.json5",
20
+ ".gitlab/renovate.json",
21
+ ".gitlab/renovate.jsonc",
22
+ ".gitlab/renovate.json5",
23
+ ".renovaterc",
24
+ ".renovaterc.json",
25
+ ".renovaterc.jsonc",
26
+ ".renovaterc.json5",
27
+ ];
28
+ const DEPENDABOT_FILES = [".github/dependabot.yml", ".github/dependabot.yaml"];
29
+ const firstExisting = (cwd, files) => files.find((f) => fs.existsSync(path.join(cwd, f))) ?? null;
30
+ export function findDepUpdaterConfigs(cwd) {
31
+ let renovate = firstExisting(cwd, RENOVATE_FILES);
32
+ if (!renovate) {
33
+ const read = readPackageJson(cwd);
34
+ const block = read.ok ? read.pkg.renovate : undefined;
35
+ if (block !== null && typeof block === "object" && !Array.isArray(block)) {
36
+ renovate = "package.json";
37
+ }
38
+ }
39
+ return { renovate, dependabot: firstExisting(cwd, DEPENDABOT_FILES) };
40
+ }
41
+ /** The one updater whose config is present; null when there is none, or both. */
42
+ export function detectDepUpdater(cwd) {
43
+ const { renovate, dependabot } = findDepUpdaterConfigs(cwd);
44
+ if (renovate && !dependabot)
45
+ return "renovate";
46
+ if (dependabot && !renovate)
47
+ return "dependabot";
48
+ return null;
49
+ }
@@ -10,7 +10,7 @@ export const OPENCODE_PROVIDERS = [
10
10
  "ollama",
11
11
  // opencode-native gateways — two DISTINCT models.dev providers with separate catalogs.
12
12
  // CLI: opencode-zen / opencode-go. Agent model pins: opencode/<id> (Zen built-in id) and
13
- // opencode-go/<id>. Both auth via BKIT_OPENCODE_API_KEY. See providers.md § Models.
13
+ // opencode-go/<id>. Both auth via BKIT_OPENCODE_API_KEY. See providers.md § Provider models.
14
14
  "opencode-zen",
15
15
  "opencode-go",
16
16
  ];
@@ -103,6 +103,13 @@ export const BKIT_EGRESS_SOURCES = [
103
103
  hosts: ["api.githubcopilot.com"],
104
104
  bases: ["githubcopilot.com"],
105
105
  },
106
+ // The engine's own tracker calls (`gh api` REST and GraphQL), beside the MCP server.
107
+ {
108
+ id: "tracker-github-api",
109
+ kind: "tracker-mcp",
110
+ hosts: ["api.github.com"],
111
+ bases: ["github.com"],
112
+ },
106
113
  {
107
114
  id: "mcp-linear",
108
115
  kind: "tracker-mcp",
@@ -1,4 +1,4 @@
1
- // shared/json.ts — `JSON.parse` without the throw, for consumer-authored input.
1
+ // shared/json.ts — `JSON.parse` and file reads without the throw, for consumer-authored input.
2
2
  //
3
3
  // Every read of a file bkit does not own (package.json, .mcp.json, settings JSON,
4
4
  // .bkit/version) must fail open into a result the caller reports in its own terms,
@@ -16,15 +16,28 @@ export function parseJson(raw) {
16
16
  return { ok: false };
17
17
  }
18
18
  }
19
- /** `parseJson` over the file at `file`; `{ ok: false }` also when the file cannot be read. */
20
- export function readJsonFile(file) {
21
- let raw;
19
+ /** The file at `file` as UTF-8 text, or `{ ok: false }` when it cannot be read. */
20
+ export function readTextFile(file) {
22
21
  try {
23
- raw = fs.readFileSync(file, "utf-8");
22
+ return { ok: true, text: fs.readFileSync(file, "utf-8") };
24
23
  }
25
24
  catch {
26
- // Missing, unreadable or a directory: the result says so, like malformed JSON.
25
+ // Missing, unreadable or a directory: the result says so, and the caller reports it.
27
26
  return { ok: false };
28
27
  }
29
- return parseJson(raw);
28
+ }
29
+ /** The entry names of the directory `dir`, or `{ ok: false }` when it cannot be read. */
30
+ export function readDirNames(dir) {
31
+ try {
32
+ return { ok: true, names: fs.readdirSync(dir) };
33
+ }
34
+ catch {
35
+ // Missing, unreadable or not a directory: the result says so, and the caller reports it.
36
+ return { ok: false };
37
+ }
38
+ }
39
+ /** `parseJson` over the file at `file`; `{ ok: false }` also when the file cannot be read. */
40
+ export function readJsonFile(file) {
41
+ const read = readTextFile(file);
42
+ return read.ok ? parseJson(read.text) : { ok: false };
30
43
  }
@@ -3,6 +3,12 @@
3
3
  // bkit installs and upgrades itself with pnpm, so a consumer repo is a pnpm repo.
4
4
  // Every command that runs a package script or an install builds the command here,
5
5
  // so changing that decision is a change to this file only.
6
+ import * as path from "node:path";
7
+ import { getTemplatesRoot } from "./package-roots.js";
8
+ /** Protect local macOS tests; other platforms keep their original command. */
9
+ export const testCommand = (argv, platform = process.platform) => platform === "darwin"
10
+ ? [process.execPath, path.join(getTemplatesRoot(), "scripts/ci/bkit-test-awake.mjs"), ...argv]
11
+ : argv;
6
12
  /** The package manager that runs `package.json` scripts and installs. */
7
13
  export const PACKAGE_RUNNER = "pnpm";
8
14
  /** argv for running one `package.json` script, e.g. `bkit:gate:static-unit`. */
@@ -4,6 +4,7 @@
4
4
  // a check name, or an app folder.
5
5
  import { DEFAULT_CLOUD_AGENTS, DEFAULT_ISSUE_TRACKER, parseCloudAgents, parseIssueTracker, } from "../install/manifest.js";
6
6
  import { isOpencodeProvider } from "../render/models.js";
7
+ import { DEP_UPDATERS } from "./dep-updater.js";
7
8
  import { readPackageJson } from "./package-json.js";
8
9
  const BOARD_URL = /^https:\/\/github\.com\/(orgs|users)\/([^/?#\s]+)\/projects\/([1-9][0-9]*)(?:[/?#].*)?$/;
9
10
  /** The board a `https://github.com/{orgs|users}/<login>/projects/<n>[/views/…]` URL names; null otherwise. */
@@ -13,6 +14,31 @@ export function parseGithubBoardUrl(url) {
13
14
  return null;
14
15
  return { ownerType: m[1] === "orgs" ? "org" : "user", owner: m[2], number: Number(m[3]) };
15
16
  }
17
+ /** Every point a workflow can stop and ask the owner at, as `<workflow>.<point>`. */
18
+ export const ASK_POINTS = [
19
+ "design.grill",
20
+ "build.verify",
21
+ "build.challenge",
22
+ "build.tests",
23
+ "debug.fix",
24
+ "debug.soak",
25
+ "ship.merge",
26
+ ];
27
+ /** The limit key a point's block holds. */
28
+ export const limitKey = (point) => point === "design.grill" ? "maxTurns" : "maxAttempts";
29
+ /**
30
+ * The `{job}/{step}` CI steps of bkit's `bkit-ci.yml` template whose failure a
31
+ * `bkit:generate` fixes: the capability register and the mirror drift check. Always
32
+ * counted; `bkit.testing.ciGenerated` adds to it and cannot remove it.
33
+ */
34
+ export const CI_GENERATED_FLOOR = [
35
+ "bkit-tests-static/Check Capability Register",
36
+ "bkit-tests-static/Run bkit Check",
37
+ ];
38
+ /** The CI steps ship regenerates for: the floor plus the repo's `bkit.testing.ciGenerated`. */
39
+ export const ciGeneratedSteps = (cfg) => [
40
+ ...new Set([...CI_GENERATED_FLOOR, ...cfg.ciGenerated]),
41
+ ];
16
42
  export const CONFIG_DEFAULTS = {
17
43
  ciWorkflow: "bkit-ci.yml",
18
44
  capstoneJob: "bkit-tests-check",
@@ -25,14 +51,29 @@ export const CONFIG_DEFAULTS = {
25
51
  // `started` is a state type every Linear team has; In Review is a name a default team lacks.
26
52
  linear: { team: null, project: null, progress: "started", review: "In Review" },
27
53
  jira: { site: null, project: null, progress: "In Progress", review: "In Review" },
28
- shipGateRequiredLanes: [],
29
- // What bkit's workflows write: plan / design / build logs and the ledgers. Never
30
- // `docs/**`: a project doc can be a test's input, so a docs edit can red a test.
31
- minPushPaths: ["docs/plans/**", "docs/*.jsonl", ".bkit/*.jsonl"],
54
+ ciRequired: [],
55
+ // Nothing beyond what bkit writes. Never seed `docs/**`: a project doc can be a test's
56
+ // input, so a docs edit can red a test; a repo that knows its tests opts in.
57
+ minPushPaths: [],
58
+ ciSkipPaths: [],
59
+ ciGenerated: [],
32
60
  opencodeProvider: null,
33
61
  opencodeProviders: [],
34
62
  cloudAgents: DEFAULT_CLOUD_AGENTS,
35
- depUpdaterOptOut: false,
63
+ // `.bkit/workflows.md` § Ask points.
64
+ asks: {
65
+ "design.grill": { ask: true, max: 6 },
66
+ "build.verify": { ask: true, max: 2 },
67
+ "build.challenge": { ask: true, max: 2 },
68
+ "build.tests": { ask: true, max: 2 },
69
+ "debug.fix": { ask: true, max: 2 },
70
+ "debug.soak": { ask: true, max: 2 },
71
+ "ship.merge": { ask: true, max: 2 },
72
+ },
73
+ // Plan caps, `.bkit/workflows.md` § Test-first.
74
+ tasks: { maxPerGroup: 5, maxTestsPerGroup: 25, maxTestsPerTask: 10, maxTestFilesPerTask: 3 },
75
+ buildPublish: { remote: true, local: true },
76
+ depUpdater: null,
36
77
  issueTrackerExplicit: false,
37
78
  cloudAgentsExplicit: false,
38
79
  };
@@ -46,6 +87,103 @@ function trackerStates(raw, defaults) {
46
87
  review: nonEmptyString(raw.review) ? raw.review.trim() : defaults.review,
47
88
  };
48
89
  }
90
+ const parseDepUpdater = (v) => v === "none" || DEP_UPDATERS.includes(v) ? v : null;
91
+ const TASK_CAP_KEYS = Object.keys(CONFIG_DEFAULTS.tasks);
92
+ const validCap = (v) => Number.isInteger(v) && v >= 1;
93
+ /**
94
+ * The keys of a `bkit.workflows.tasks` value that fall back to their default: each set key
95
+ * that is not an integer >= 1, or `["tasks"]` when the value is set but not an object.
96
+ */
97
+ export function invalidTaskCaps(raw) {
98
+ if (raw === undefined)
99
+ return [];
100
+ if (raw === null || typeof raw !== "object" || Array.isArray(raw))
101
+ return ["tasks"];
102
+ const set = raw;
103
+ return TASK_CAP_KEYS.filter((k) => set[k] !== undefined && !validCap(set[k]));
104
+ }
105
+ /**
106
+ * The dotted keys of a `bkit.workflows.build` value that fall back to their default:
107
+ * `build` when set but not an object, `build.publish` when set but not an object,
108
+ * `build.publish.local` when set but not a boolean. `remote` is never listed: the
109
+ * preflight advisory `bkit-build-publish-remote` owns it.
110
+ */
111
+ export function invalidBuildPublish(raw) {
112
+ if (raw === undefined)
113
+ return [];
114
+ if (raw === null || typeof raw !== "object" || Array.isArray(raw))
115
+ return ["build"];
116
+ const publish = raw.publish;
117
+ if (publish === undefined)
118
+ return [];
119
+ if (publish === null || typeof publish !== "object" || Array.isArray(publish))
120
+ return ["build.publish"];
121
+ const local = publish.local;
122
+ return local !== undefined && typeof local !== "boolean" ? ["build.publish.local"] : [];
123
+ }
124
+ /** `bkit.workflows.build.publish`; `remote` always resolves `true`. */
125
+ function buildPublish(raw) {
126
+ const { local } = record(raw);
127
+ return {
128
+ remote: true,
129
+ local: typeof local === "boolean" ? local : CONFIG_DEFAULTS.buildPublish.local,
130
+ };
131
+ }
132
+ /** `bkit.workflows.tasks` read key by key; a missing or invalid key takes its default. */
133
+ function taskCaps(raw) {
134
+ const set = record(raw);
135
+ const caps = { ...CONFIG_DEFAULTS.tasks };
136
+ for (const k of TASK_CAP_KEYS)
137
+ if (validCap(set[k]))
138
+ caps[k] = set[k];
139
+ return caps;
140
+ }
141
+ /** The `bkit.workflows.<workflow>.<point>` block `workflows` holds for `point`. */
142
+ const askBlock = (workflows, point) => {
143
+ const [workflow, name] = point.split(".");
144
+ const block = workflows[workflow];
145
+ return block !== null && typeof block === "object" && !Array.isArray(block)
146
+ ? block[name]
147
+ : undefined;
148
+ };
149
+ /**
150
+ * The dotted keys under `bkit.workflows` that fall back to their default: each set `ask`
151
+ * that is not a boolean, each set limit that is not an integer >= 1, or the point itself
152
+ * when it is set but not an object.
153
+ */
154
+ export function invalidAskSettings(workflows) {
155
+ const set = record(workflows);
156
+ const bad = [];
157
+ for (const point of ASK_POINTS) {
158
+ const raw = askBlock(set, point);
159
+ if (raw === undefined)
160
+ continue;
161
+ if (raw === null || typeof raw !== "object" || Array.isArray(raw)) {
162
+ bad.push(point);
163
+ continue;
164
+ }
165
+ const block = raw;
166
+ if (block.ask !== undefined && typeof block.ask !== "boolean")
167
+ bad.push(`${point}.ask`);
168
+ const key = limitKey(point);
169
+ if (block[key] !== undefined && !validCap(block[key]))
170
+ bad.push(`${point}.${key}`);
171
+ }
172
+ return bad;
173
+ }
174
+ /** Every ask point read from `bkit.workflows`; a missing or invalid key takes its default. */
175
+ function askSettings(workflows) {
176
+ const out = {};
177
+ for (const point of ASK_POINTS) {
178
+ const block = record(askBlock(workflows, point));
179
+ const limit = block[limitKey(point)];
180
+ out[point] = {
181
+ ask: typeof block.ask === "boolean" ? block.ask : CONFIG_DEFAULTS.asks[point].ask,
182
+ max: validCap(limit) ? limit : CONFIG_DEFAULTS.asks[point].max,
183
+ };
184
+ }
185
+ return out;
186
+ }
49
187
  /**
50
188
  * Read `package.json` `bkit` from `root` (the main checkout). A missing file,
51
189
  * missing key, or wrongly typed value falls back to the default for that key.
@@ -53,21 +191,32 @@ function trackerStates(raw, defaults) {
53
191
  export function readBkitConfig(root) {
54
192
  // A missing or unparseable package.json takes every default; `bkit check` reports the file.
55
193
  const read = readPackageJson(root);
56
- const bkit = ((read.ok ? read.pkg.bkit : undefined) ?? {});
57
- const worktree = (bkit.worktree ?? {});
194
+ const bkit = record(read.ok ? read.pkg.bkit : undefined);
195
+ const tracker = record(bkit.tracker);
196
+ const cloud = record(bkit.cloud);
197
+ const opencode = record(record(bkit.providers).opencode);
198
+ const testing = record(bkit.testing);
199
+ const workflows = record(bkit.workflows);
200
+ const worktree = record(workflows.worktree);
201
+ const ciSkip = testing.ciSkipPaths;
202
+ const generated = testing.ciGenerated;
58
203
  const copy = worktree.copy;
59
- const minFreeGb = (bkit.disk ?? {}).minFreeGb;
60
- const lanes = bkit.shipGateRequiredLanes;
61
- const book = bkit.minPushPaths;
62
- const provider = bkit.opencodeProvider;
63
- const providers = bkit.opencodeProviders;
64
- const github = record(bkit.github);
65
- const linear = record(bkit.linear);
66
- const jira = record(bkit.jira);
204
+ const minFreeGb = workflows.minFreeGb;
205
+ const lanes = testing.ciRequired;
206
+ const book = testing.minPushPaths;
207
+ const provider = opencode.default;
208
+ const providers = opencode.installed;
209
+ const github = record(tracker.github);
210
+ const linear = record(tracker.linear);
211
+ const jira = record(tracker.jira);
67
212
  const projectUrl = optionalString(github.project);
68
213
  return {
69
- ciWorkflow: nonEmptyString(bkit.ciWorkflow) ? bkit.ciWorkflow : CONFIG_DEFAULTS.ciWorkflow,
70
- capstoneJob: nonEmptyString(bkit.capstoneJob) ? bkit.capstoneJob : CONFIG_DEFAULTS.capstoneJob,
214
+ ciWorkflow: nonEmptyString(testing.ciWorkflow)
215
+ ? testing.ciWorkflow
216
+ : CONFIG_DEFAULTS.ciWorkflow,
217
+ capstoneJob: nonEmptyString(testing.ciCapstone)
218
+ ? testing.ciCapstone
219
+ : CONFIG_DEFAULTS.capstoneJob,
71
220
  worktreeCopy: Array.isArray(copy) && copy.every(nonEmptyString)
72
221
  ? [...copy]
73
222
  : [...CONFIG_DEFAULTS.worktreeCopy],
@@ -75,7 +224,7 @@ export function readBkitConfig(root) {
75
224
  diskMinFreeGb: typeof minFreeGb === "number" && Number.isFinite(minFreeGb) && minFreeGb >= 0
76
225
  ? minFreeGb
77
226
  : CONFIG_DEFAULTS.diskMinFreeGb,
78
- issueTracker: parseIssueTracker(bkit.issueTracker) ?? CONFIG_DEFAULTS.issueTracker,
227
+ issueTracker: parseIssueTracker(tracker.default) ?? CONFIG_DEFAULTS.issueTracker,
79
228
  github: {
80
229
  project: github.project === false ? false : projectUrl ? parseGithubBoardUrl(projectUrl) : null,
81
230
  projectUrl,
@@ -91,21 +240,29 @@ export function readBkitConfig(root) {
91
240
  project: optionalString(jira.project),
92
241
  ...trackerStates(jira, CONFIG_DEFAULTS.jira),
93
242
  },
94
- shipGateRequiredLanes: Array.isArray(lanes) ? lanes.filter(nonEmptyString) : [],
95
- // An explicit [] is kept: it switches the min push off.
243
+ ciRequired: Array.isArray(lanes) ? lanes.filter(nonEmptyString) : [],
96
244
  minPushPaths: Array.isArray(book)
97
245
  ? book.filter(nonEmptyString)
98
246
  : [...CONFIG_DEFAULTS.minPushPaths],
247
+ ciSkipPaths: Array.isArray(ciSkip) ? ciSkip.filter(nonEmptyString) : [],
248
+ ciGenerated: Array.isArray(generated) ? generated.filter(nonEmptyString) : [],
99
249
  opencodeProvider: typeof provider === "string" && isOpencodeProvider(provider) ? provider : null,
100
250
  opencodeProviders: Array.isArray(providers)
101
251
  ? providers.filter((v) => typeof v === "string" && isOpencodeProvider(v))
102
252
  : [],
103
- cloudAgents: parseCloudAgents(bkit.cloudAgents) ?? CONFIG_DEFAULTS.cloudAgents,
104
- depUpdaterOptOut: bkit.depUpdater === "none",
105
- issueTrackerExplicit: bkit.issueTracker !== undefined,
106
- cloudAgentsExplicit: bkit.cloudAgents !== undefined,
253
+ cloudAgents: parseCloudAgents(cloud.agent) ?? CONFIG_DEFAULTS.cloudAgents,
254
+ asks: askSettings(workflows),
255
+ tasks: taskCaps(workflows.tasks),
256
+ buildPublish: buildPublish(record(workflows.build).publish),
257
+ depUpdater: parseDepUpdater(record(bkit.dependencies).updater),
258
+ issueTrackerExplicit: tracker.default !== undefined && tracker.default !== "",
259
+ cloudAgentsExplicit: cloud.agent !== undefined && cloud.agent !== "",
107
260
  };
108
261
  }
262
+ /** The CI workflow file `bkit.testing.ciWorkflow` names, as `.github/workflows/<file>` relative to `root`. */
263
+ export function ciWorkflowPath(root) {
264
+ return `.github/workflows/${readBkitConfig(root).ciWorkflow}`;
265
+ }
109
266
  export function trackerScope(cfg) {
110
267
  const none = { trackerTeam: null, trackerProject: null, trackerSite: null, trackerBoard: null };
111
268
  if (cfg.issueTracker === "github")