@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
@@ -3,6 +3,7 @@
3
3
 
4
4
  import { type EffortMap, formatModelPin, lookupEffort } from "./models.js";
5
5
  import { LOG_PREFIX } from "../shared/log-prefix.js";
6
+ import type { OpencodeProvider } from "../shared/egress.js";
6
7
 
7
8
  /**
8
9
  * Convert a Claude `tools:` frontmatter block (a YAML array of capitalized tool names,
@@ -86,18 +87,109 @@ export function antigravityToolsBlock(toolsBlock: string | null): string {
86
87
  return out;
87
88
  }
88
89
 
90
+ /**
91
+ * Thinking-effort values each model exposes on each variant-carrying opencode gateway
92
+ * (`reasoning_options` effort values in models.dev, read 2026-10-28; models.dev provider
93
+ * `opencode` = bkit key `opencode-zen`). One model can differ per gateway — `deepseek-v4.1-flash`
94
+ * has `none` on OpenRouter only — and OpenCode hard-errors on a `variant:` the model does not
95
+ * expose there. An empty list = `toggle`-only or no reasoning options: no effort variant at all.
96
+ * ollama has no entry: it carries no variant on any model (applyOpencodeAgent skips it). An
97
+ * unlisted gateway or model passes the mapped value through unchanged.
98
+ */
99
+ const OPENCODE_VARIANT_LEVELS: Record<
100
+ Exclude<OpencodeProvider, "ollama">,
101
+ Record<string, string[]>
102
+ > = {
103
+ openrouter: {
104
+ "deepseek-v4.1-flash": ["none", "low", "high", "max"],
105
+ "minimax-m3.1-flash": ["low", "medium", "high", "xhigh", "max"],
106
+ "glm-5.3-flash": ["low", "high", "max"],
107
+ "gemini-4-argon": ["low", "medium", "high"],
108
+ "gpt-6.1-sol": ["low", "medium", "high", "xhigh", "max"],
109
+ "mimo-v2.6-pro": [],
110
+ "kimi-k3": ["none", "low", "high", "max"],
111
+ },
112
+ "opencode-zen": {
113
+ "deepseek-v4.1-flash": ["low", "high", "max"],
114
+ "minimax-m3.1-flash": ["low", "medium", "high", "xhigh", "max"],
115
+ "glm-5.3-flash": ["low", "high", "max"],
116
+ "gemini-4-argon": ["low", "medium", "high"],
117
+ "gpt-6.1-sol": ["low", "medium", "high", "xhigh", "max"],
118
+ "kimi-k3": ["low", "high", "max"],
119
+ },
120
+ "opencode-go": {
121
+ "deepseek-v4.1-flash": ["low", "high", "max"],
122
+ "minimax-m3.1-flash": ["low", "medium", "high", "xhigh", "max"],
123
+ "glm-5.3-flash": ["low", "high", "max"],
124
+ "gemini-4-argon": ["low", "medium", "high"],
125
+ "mimo-v2.6-pro": [],
126
+ "kimi-k3": ["max"],
127
+ },
128
+ };
129
+
130
+ const VARIANT_RANK = ["none", "low", "medium", "high", "xhigh", "max"];
131
+
132
+ /**
133
+ * Models at or above the sonnet bar on the LiveBench 2.0 board (`providers.md` § LiveBench 2.0
134
+ * board). They keep the agent's own Claude effort on opencode; every other model takes the
135
+ * "OpenCode" ladder, which raises it to the top rung to close the gap to the bar.
136
+ */
137
+ const OPENCODE_AT_BAR_MODELS = [
138
+ "claude-fable-5.1",
139
+ "gpt-6-astra",
140
+ "claude-opus-5.5",
141
+ "gpt-6.1-sol",
142
+ "claude-sonnet-5.5",
143
+ ];
144
+
145
+ /** The effort ladder for `model` on opencode: the agent's own for an at-bar model, else "opencode". */
146
+ function opencodeEffortProgram(model: string): string {
147
+ const slug = model.split("/").pop() ?? model;
148
+ return OPENCODE_AT_BAR_MODELS.includes(slug) ? "claude" : "opencode";
149
+ }
150
+
151
+ /**
152
+ * The variant to emit for `model` on gateway `provider` at mapped `variant`: the value itself
153
+ * when the model exposes it there, else the highest level it does expose at or under it, else
154
+ * its lowest. A model with no effort control gets null, so no `variant:` line is written.
155
+ */
156
+ export function clampOpencodeVariant(
157
+ provider: string,
158
+ model: string,
159
+ variant: string | null,
160
+ ): string | null {
161
+ if (!variant) return null;
162
+ const gatewayLevels = Object.entries(OPENCODE_VARIANT_LEVELS).find(
163
+ ([gateway]) => gateway === provider,
164
+ )?.[1];
165
+ if (!gatewayLevels) return variant;
166
+ const slug = Object.keys(gatewayLevels)
167
+ .sort((a, b) => b.length - a.length)
168
+ .find((key) => model.split("/").pop()?.includes(key) || model.includes(key));
169
+ if (!slug) return variant;
170
+ const levels = gatewayLevels[slug];
171
+ if (levels.length === 0) return null;
172
+ if (levels.includes(variant)) return variant;
173
+ const wanted = VARIANT_RANK.indexOf(variant);
174
+ const atOrUnder = levels
175
+ .filter((l) => VARIANT_RANK.indexOf(l) <= wanted)
176
+ .sort((a, b) => VARIANT_RANK.indexOf(b) - VARIANT_RANK.indexOf(a));
177
+ return atOrUnder[0] ?? levels[0];
178
+ }
179
+
89
180
  /**
90
181
  * OC1: opencode agent frontmatter rewrite.
91
182
  * Emits: mode, name, description, model, tools (Claude array → opencode object map),
92
- * variant (the effort table's value for this agent, from the one shared "OpenCode"
93
- * ladder). The variant is a SEPARATE field, not a `#`-suffix on the model: 1.x reads
94
- * `variant:` natively, 2.0 joins `model` + `variant` internally, and a variant joined
95
- * to the model string with `#` breaks 1.x (its model id lookup keeps the suffix). The
96
- * ollama gateway is exempt from `variant:` — its provider builds model entries with no
97
- * variants, so any variant there is a hard 2.0 error; omit it and let opencode use its
98
- * own default. Drops: Claude-only fields (permissionMode, maxTurns, is_background,
99
- * readonly) and the original effort field. Hard-fails with non-zero exit if model
100
- * lookup missing for name.
183
+ * variant (the effort table's value for this agent from the one shared "OpenCode" ladder, or
184
+ * the agent's own Claude effort on an at-bar model, clamped by clampOpencodeVariant to what
185
+ * the pinned model exposes on this gateway). The
186
+ * variant is a SEPARATE field, not a `#`-suffix on the model: 1.x reads `variant:` natively,
187
+ * 2.0 joins `model` + `variant` internally, and a variant joined to the model string with `#`
188
+ * breaks 1.x (its model id lookup keeps the suffix). The ollama gateway is exempt from
189
+ * `variant:` — its provider builds model entries with no variants, so any variant there is a
190
+ * hard 2.0 error; omit it and let opencode use its own default. Drops: Claude-only fields
191
+ * (permissionMode, maxTurns, is_background, readonly) and the original effort field.
192
+ * Hard-fails with non-zero exit if model lookup missing for name.
101
193
  */
102
194
  export function applyOpencodeAgent(
103
195
  content: string,
@@ -113,6 +205,7 @@ export function applyOpencodeAgent(
113
205
  const effort = parsed.get("effort");
114
206
  const toolsBlock = extractFrontmatterField(fmBlock, "tools");
115
207
 
208
+ // autoCompactWindow dropped: no per-agent setting, see providers.md § Context compaction.
116
209
  let newFm = "---\n";
117
210
  newFm += `mode: subagent\n`;
118
211
  newFm += `name: ${name}\n`;
@@ -122,14 +215,19 @@ export function applyOpencodeAgent(
122
215
  } else {
123
216
  newFm += `description: ${description}\n`;
124
217
  }
125
- // Thinking effort is a model variant in its own `variant:` field. Program-keyed: every
126
- // opencode gateway shares the one "OpenCode" ladder; the gateway is not consulted —
127
- // except ollama, which cannot carry a variant at all (see the function docstring).
218
+ // Thinking effort is a model variant in its own `variant:` field. Every opencode gateway
219
+ // shares the one "OpenCode" ladder, except that an at-bar model keeps the agent's own
220
+ // effort; the gateway decides only which rungs the pinned model exposes, and ollama
221
+ // carries no variant at all (see the function docstring).
128
222
  const modelPin = formatModelPin("opencode", provider ?? "", opencodeModel);
129
223
  newFm += `model: ${modelPin}\n`;
130
224
  const variant =
131
225
  provider !== "ollama" && effort && effortMap
132
- ? lookupEffort(effortMap, "opencode", effort)
226
+ ? clampOpencodeVariant(
227
+ provider ?? "",
228
+ opencodeModel,
229
+ lookupEffort(effortMap, opencodeEffortProgram(opencodeModel), effort),
230
+ )
133
231
  : null;
134
232
  if (variant) newFm += `variant: ${variant}\n`;
135
233
  newFm += opencodeToolsBlock(toolsBlock);
@@ -203,6 +301,7 @@ export function applyCodexAgent(
203
301
  const body = afterFm.trim();
204
302
 
205
303
  const effort = parsed.get("effort");
304
+ // autoCompactWindow dropped: a role file's model_auto_compact_token_limit is discarded (openai/codex core/src/agent/role.rs:37-48).
206
305
  let out = "";
207
306
  out += tomlString("name", name);
208
307
  out += tomlString("description", parsed.get("description") ?? "");
@@ -398,6 +497,7 @@ export function applyT3(
398
497
  const effort = parsed.get("effort");
399
498
  const toolsBlock = extractFrontmatterField(fmBlock, "tools");
400
499
 
500
+ // autoCompactWindow dropped: no per-agent setting, see providers.md § Context compaction.
401
501
  let newFm = "---\n";
402
502
  newFm += `name: ${name}\n`;
403
503
  if (description.includes("\n")) {
@@ -480,6 +580,7 @@ export function applyAntigravityPrompt(
480
580
  const effort = parsed.get("effort");
481
581
  const toolsBlock = extractFrontmatterField(fmBlock, "tools");
482
582
 
583
+ // autoCompactWindow dropped: no per-agent setting, see providers.md § Context compaction.
483
584
  let newFm = "---\n";
484
585
  newFm += `name: ${name}\n`;
485
586
  if (description.includes("\n")) {
@@ -490,7 +591,10 @@ export function applyAntigravityPrompt(
490
591
  }
491
592
  newFm += `model: ${formatModelPin("antigravity", "google", model)}\n`;
492
593
  if (effort && effortMap) {
493
- newFm += `effort: ${lookupEffort(effortMap, "antigravity", effort)}\n`;
594
+ // Same per-model ceiling as opencode's variant: gemini-4-argon stops at `high`, so an
595
+ // xhigh/max agent must not ask Antigravity for a rung the model does not expose.
596
+ const mapped = lookupEffort(effortMap, "antigravity", effort);
597
+ newFm += `effort: ${mapped === "max" && model.includes("gemini-4-argon") ? "high" : mapped}\n`;
494
598
  }
495
599
  newFm += antigravityToolsBlock(toolsBlock);
496
600
  newFm += "---\n";
@@ -219,6 +219,18 @@ export function applyModelOverrides(
219
219
  }
220
220
  }
221
221
 
222
+ /**
223
+ * Override rows (from `overridesPath`) naming no agent in `known`, deduplicated in file
224
+ * order. `applyModelOverrides` skips such rows, so they are reported, not applied.
225
+ */
226
+ export function unknownModelOverrides(overridesPath: string, known: ReadonlySet<string>): string[] {
227
+ const out: string[] = [];
228
+ for (const o of parseModelOverrides(overridesPath)) {
229
+ if (!known.has(o.prompt) && !out.includes(o.prompt)) out.push(o.prompt);
230
+ }
231
+ return out;
232
+ }
233
+
222
234
  /**
223
235
  * Effort → provider thinking map from prompts.md.
224
236
  * Row key = Default column (canonical prompt `effort:`).
@@ -99,16 +99,38 @@ export interface BkitLatestDeps {
99
99
  lookup?: (cwd: string) => string | null;
100
100
  }
101
101
 
102
- /** The cached registry answer when still fresh: a version, or null for a remembered failure. */
103
- function readCache(file: string, now: number): { latest: string | null } | undefined {
102
+ /** The cache file's registry answer and when it was asked, however old; undefined when unreadable. */
103
+ function readCacheEntry(file: string): { latest: string | null; checkedAt: number } | undefined {
104
104
  if (!fs.existsSync(file)) return undefined;
105
105
  const parsed = parseJson(fs.readFileSync(file, "utf-8"));
106
106
  if (!parsed.ok || typeof parsed.value !== "object" || parsed.value === null) return undefined;
107
107
  const { latest, checkedAt } = parsed.value as { latest?: unknown; checkedAt?: unknown };
108
108
  if (typeof checkedAt !== "number") return undefined;
109
109
  const value = typeof latest === "string" && SEMVER_RE.test(latest) ? latest : null;
110
- const ttl = value === null ? TIMEOUTS.BKIT_LATEST_RETRY_S : TIMEOUTS.BKIT_LATEST_CACHE_S;
111
- return now - checkedAt < ttl * 1000 && now >= checkedAt ? { latest: value } : undefined;
110
+ return { latest: value, checkedAt };
111
+ }
112
+
113
+ /** The cached registry answer when still fresh: a version, or null for a remembered failure. */
114
+ function readCache(file: string, now: number): { latest: string | null } | undefined {
115
+ const entry = readCacheEntry(file);
116
+ if (entry === undefined) return undefined;
117
+ const { latest, checkedAt } = entry;
118
+ const ttl = latest === null ? TIMEOUTS.BKIT_LATEST_RETRY_S : TIMEOUTS.BKIT_LATEST_CACHE_S;
119
+ return now - checkedAt < ttl * 1000 && now >= checkedAt ? { latest } : undefined;
120
+ }
121
+
122
+ /**
123
+ * True when the release last cached in `gitCommonDir` is newer than this repo's bkit,
124
+ * however old that answer is: a release once seen stays newer until the repo upgrades.
125
+ * Never asks the registry, so local callers (setup tips) can use it, and ignores
126
+ * `NO_UPDATE_CHECK_ENV`: that skips the lookup, while a release already seen stays
127
+ * true. False when the cache or the pin leave nothing to compare.
128
+ */
129
+ export function cachedBkitOutdated(root: string, gitCommonDir: string): boolean {
130
+ const version = readBkitVersion(path.join(root, ".bkit", "version"))?.pinnedVersion || null;
131
+ if (version === null) return false;
132
+ const latest = readCacheEntry(path.join(gitCommonDir, BKIT_LATEST_CACHE))?.latest ?? null;
133
+ return latest !== null && compareSemver(version, latest) === -1;
112
134
  }
113
135
 
114
136
  /** Remember the registry answer; a cache that cannot be written only costs a lookup next run. */
@@ -7,7 +7,10 @@
7
7
  /** The integration branch feature work lands on. */
8
8
  export const DEV = "dev";
9
9
 
10
+ /** The release branch: bkit never opens a PR into it or merges into it. */
11
+ export const MAIN = "main";
12
+
10
13
  /** True for `dev` and `main`: no feature work happens on them, no force-push touches them. */
11
14
  export function isSharedBranch(branch: string): boolean {
12
- return branch === DEV || branch === "main";
15
+ return branch === DEV || branch === MAIN;
13
16
  }
@@ -0,0 +1,60 @@
1
+ // shared/dep-updater.ts — which dependency updater a repo runs, read from the config files the
2
+ // updater itself reads.
3
+
4
+ import * as fs from "node:fs";
5
+ import * as path from "node:path";
6
+ import { readPackageJson } from "./package-json.js";
7
+
8
+ export const DEP_UPDATERS = ["renovate", "dependabot"] as const;
9
+ export type DepUpdater = (typeof DEP_UPDATERS)[number];
10
+
11
+ export const DEP_UPDATER_NAMES: Readonly<Record<DepUpdater, string>> = {
12
+ renovate: "Renovate",
13
+ dependabot: "Dependabot",
14
+ };
15
+
16
+ // Renovate's repository config locations, in its lookup order (docs.renovatebot.com
17
+ // § Configuration options); a `renovate` block in package.json comes last.
18
+ const RENOVATE_FILES = [
19
+ "renovate.json",
20
+ "renovate.jsonc",
21
+ "renovate.json5",
22
+ ".github/renovate.json",
23
+ ".github/renovate.jsonc",
24
+ ".github/renovate.json5",
25
+ ".gitlab/renovate.json",
26
+ ".gitlab/renovate.jsonc",
27
+ ".gitlab/renovate.json5",
28
+ ".renovaterc",
29
+ ".renovaterc.json",
30
+ ".renovaterc.jsonc",
31
+ ".renovaterc.json5",
32
+ ];
33
+
34
+ const DEPENDABOT_FILES = [".github/dependabot.yml", ".github/dependabot.yaml"];
35
+
36
+ /** Each updater's config, as a path relative to `cwd`; null when absent. */
37
+ export type DepUpdaterConfigs = Record<DepUpdater, string | null>;
38
+
39
+ const firstExisting = (cwd: string, files: string[]): string | null =>
40
+ files.find((f) => fs.existsSync(path.join(cwd, f))) ?? null;
41
+
42
+ export function findDepUpdaterConfigs(cwd: string): DepUpdaterConfigs {
43
+ let renovate = firstExisting(cwd, RENOVATE_FILES);
44
+ if (!renovate) {
45
+ const read = readPackageJson(cwd);
46
+ const block = read.ok ? read.pkg.renovate : undefined;
47
+ if (block !== null && typeof block === "object" && !Array.isArray(block)) {
48
+ renovate = "package.json";
49
+ }
50
+ }
51
+ return { renovate, dependabot: firstExisting(cwd, DEPENDABOT_FILES) };
52
+ }
53
+
54
+ /** The one updater whose config is present; null when there is none, or both. */
55
+ export function detectDepUpdater(cwd: string): DepUpdater | null {
56
+ const { renovate, dependabot } = findDepUpdaterConfigs(cwd);
57
+ if (renovate && !dependabot) return "renovate";
58
+ if (dependabot && !renovate) return "dependabot";
59
+ return null;
60
+ }
@@ -11,7 +11,7 @@ export const OPENCODE_PROVIDERS = [
11
11
  "ollama",
12
12
  // opencode-native gateways — two DISTINCT models.dev providers with separate catalogs.
13
13
  // CLI: opencode-zen / opencode-go. Agent model pins: opencode/<id> (Zen built-in id) and
14
- // opencode-go/<id>. Both auth via BKIT_OPENCODE_API_KEY. See providers.md § Models.
14
+ // opencode-go/<id>. Both auth via BKIT_OPENCODE_API_KEY. See providers.md § Provider models.
15
15
  "opencode-zen",
16
16
  "opencode-go",
17
17
  ] as const;
@@ -148,6 +148,13 @@ export const BKIT_EGRESS_SOURCES: readonly EgressSource[] = [
148
148
  hosts: ["api.githubcopilot.com"],
149
149
  bases: ["githubcopilot.com"],
150
150
  },
151
+ // The engine's own tracker calls (`gh api` REST and GraphQL), beside the MCP server.
152
+ {
153
+ id: "tracker-github-api",
154
+ kind: "tracker-mcp",
155
+ hosts: ["api.github.com"],
156
+ bases: ["github.com"],
157
+ },
151
158
  {
152
159
  id: "mcp-linear",
153
160
  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,
@@ -20,14 +20,32 @@ export function parseJson(raw: string): JsonRead {
20
20
  }
21
21
  }
22
22
 
23
- /** `parseJson` over the file at `file`; `{ ok: false }` also when the file cannot be read. */
24
- export function readJsonFile(file: string): JsonRead {
25
- let raw: string;
23
+ export type TextRead = { ok: true; text: string } | { ok: false };
24
+
25
+ /** The file at `file` as UTF-8 text, or `{ ok: false }` when it cannot be read. */
26
+ export function readTextFile(file: string): TextRead {
27
+ try {
28
+ return { ok: true, text: fs.readFileSync(file, "utf-8") };
29
+ } catch {
30
+ // Missing, unreadable or a directory: the result says so, and the caller reports it.
31
+ return { ok: false };
32
+ }
33
+ }
34
+
35
+ export type DirRead = { ok: true; names: string[] } | { ok: false };
36
+
37
+ /** The entry names of the directory `dir`, or `{ ok: false }` when it cannot be read. */
38
+ export function readDirNames(dir: string): DirRead {
26
39
  try {
27
- raw = fs.readFileSync(file, "utf-8");
40
+ return { ok: true, names: fs.readdirSync(dir) };
28
41
  } catch {
29
- // Missing, unreadable or a directory: the result says so, like malformed JSON.
42
+ // Missing, unreadable or not a directory: the result says so, and the caller reports it.
30
43
  return { ok: false };
31
44
  }
32
- return parseJson(raw);
45
+ }
46
+
47
+ /** `parseJson` over the file at `file`; `{ ok: false }` also when the file cannot be read. */
48
+ export function readJsonFile(file: string): JsonRead {
49
+ const read = readTextFile(file);
50
+ return read.ok ? parseJson(read.text) : { ok: false };
33
51
  }
@@ -4,6 +4,15 @@
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
6
 
7
+ import * as path from "node:path";
8
+ import { getTemplatesRoot } from "./package-roots.js";
9
+
10
+ /** Protect local macOS tests; other platforms keep their original command. */
11
+ export const testCommand = (argv: string[], platform: string = process.platform): string[] =>
12
+ platform === "darwin"
13
+ ? [process.execPath, path.join(getTemplatesRoot(), "scripts/ci/bkit-test-awake.mjs"), ...argv]
14
+ : argv;
15
+
7
16
  /** The package manager that runs `package.json` scripts and installs. */
8
17
  export const PACKAGE_RUNNER = "pnpm";
9
18