@cbartens/bkit 6.0.0 → 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 (375) hide show
  1. package/.bkit/README.md +154 -151
  2. package/.bkit/core/.agents/context.md +95 -29
  3. package/.bkit/core/.agents/docs.md +17 -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 +108 -107
  9. package/.bkit/core/.agents/skills.md +63 -15
  10. package/.bkit/core/.bkit/README.md +154 -151
  11. package/.bkit/core/.bkit/authoring.md +714 -84
  12. package/.bkit/core/.bkit/cli.md +407 -0
  13. package/.bkit/core/.bkit/cloud.md +281 -193
  14. package/.bkit/core/.bkit/comparison.md +43 -41
  15. package/.bkit/core/.bkit/install.md +154 -84
  16. package/.bkit/core/.bkit/jsonl.md +193 -130
  17. package/.bkit/core/.bkit/pipeline.md +114 -114
  18. package/.bkit/core/.bkit/prompts.md +272 -165
  19. package/.bkit/core/.bkit/providers.md +457 -271
  20. package/.bkit/core/.bkit/router.md +69 -0
  21. package/.bkit/core/.bkit/templates.md +529 -256
  22. package/.bkit/core/.bkit/trackers.md +80 -52
  23. package/.bkit/core/.bkit/workflows.md +589 -504
  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 +5 -73
  33. package/.bkit/core/docs/templates/bkit-audit-accessibility.md +127 -105
  34. package/.bkit/core/docs/templates/bkit-audit-adoption.md +104 -70
  35. package/.bkit/core/docs/templates/bkit-audit-agents.md +94 -72
  36. package/.bkit/core/docs/templates/bkit-audit-aio-seo.md +99 -78
  37. package/.bkit/core/docs/templates/bkit-audit-analytics.md +140 -82
  38. package/.bkit/core/docs/templates/bkit-audit-annotations.md +98 -72
  39. package/.bkit/core/docs/templates/bkit-audit-app-performance.md +121 -96
  40. package/.bkit/core/docs/templates/bkit-audit-app-store.md +157 -76
  41. package/.bkit/core/docs/templates/bkit-audit-architecture.md +113 -71
  42. package/.bkit/core/docs/templates/bkit-audit-ci-performance.md +75 -72
  43. package/.bkit/core/docs/templates/bkit-audit-config.md +122 -76
  44. package/.bkit/core/docs/templates/bkit-audit-cost.md +85 -74
  45. package/.bkit/core/docs/templates/bkit-audit-coverage.md +75 -68
  46. package/.bkit/core/docs/templates/bkit-audit-database.md +101 -70
  47. package/.bkit/core/docs/templates/bkit-audit-dead-code.md +164 -83
  48. package/.bkit/core/docs/templates/bkit-audit-deferrals.md +115 -86
  49. package/.bkit/core/docs/templates/bkit-audit-dependencies.md +264 -88
  50. package/.bkit/core/docs/templates/bkit-audit-documentation.md +118 -93
  51. package/.bkit/core/docs/templates/bkit-audit-duplication.md +139 -86
  52. package/.bkit/core/docs/templates/bkit-audit-failures.md +110 -81
  53. package/.bkit/core/docs/templates/bkit-audit-flakes.md +99 -74
  54. package/.bkit/core/docs/templates/bkit-audit-gates.md +105 -77
  55. package/.bkit/core/docs/templates/bkit-audit-issues.md +104 -80
  56. package/.bkit/core/docs/templates/bkit-audit-llm.md +131 -58
  57. package/.bkit/core/docs/templates/bkit-audit-logs.md +123 -100
  58. package/.bkit/core/docs/templates/bkit-audit-models.md +98 -53
  59. package/.bkit/core/docs/templates/bkit-audit-privacy.md +56 -52
  60. package/.bkit/core/docs/templates/bkit-audit-prompts.md +63 -54
  61. package/.bkit/core/docs/templates/bkit-audit-red-team.md +124 -68
  62. package/.bkit/core/docs/templates/bkit-audit-reliability.md +95 -70
  63. package/.bkit/core/docs/templates/bkit-audit-repo.md +169 -73
  64. package/.bkit/core/docs/templates/bkit-audit-security.md +206 -96
  65. package/.bkit/core/docs/templates/bkit-audit-slop.md +77 -70
  66. package/.bkit/core/docs/templates/bkit-audit-testing.md +162 -114
  67. package/.bkit/core/docs/templates/bkit-audit-usability.md +113 -71
  68. package/.bkit/core/docs/templates/bkit-plan.md +138 -132
  69. package/.bkit/core/engine/checks/after/auth.ts +40 -37
  70. package/.bkit/core/engine/checks/after/ci-yml.ts +65 -2
  71. package/.bkit/core/engine/checks/after/index.ts +12 -2
  72. package/.bkit/core/engine/checks/after/tools.ts +80 -33
  73. package/.bkit/core/engine/checks/before/context-fetch.ts +227 -33
  74. package/.bkit/core/engine/checks/before/env.ts +1 -1
  75. package/.bkit/core/engine/checks/before/index.ts +7 -0
  76. package/.bkit/core/engine/checks/before/repo.ts +40 -0
  77. package/.bkit/core/engine/checks/status-holes.ts +916 -123
  78. package/.bkit/core/engine/checks/tips/catalogue.ts +68 -17
  79. package/.bkit/core/engine/checks/tips/detect.ts +32 -0
  80. package/.bkit/core/engine/checks/tips/index.ts +47 -6
  81. package/.bkit/core/engine/cli.ts +238 -84
  82. package/.bkit/core/engine/commands/analysis.ts +128 -76
  83. package/.bkit/core/engine/commands/ci/ci.ts +363 -29
  84. package/.bkit/core/engine/commands/ci/pins.ts +172 -0
  85. package/.bkit/core/engine/commands/ci/push-gate.ts +223 -0
  86. package/.bkit/core/engine/commands/install/uninstall.ts +21 -27
  87. package/.bkit/core/engine/commands/install/upgrade.ts +32 -15
  88. package/.bkit/core/engine/commands/land.ts +126 -11
  89. package/.bkit/core/engine/commands/lib.ts +303 -6
  90. package/.bkit/core/engine/commands/registry.ts +6 -2
  91. package/.bkit/core/engine/commands/setup/setup.ts +1 -0
  92. package/.bkit/core/engine/commands/stats.ts +91 -35
  93. package/.bkit/core/engine/commands/workflow/branches.ts +1477 -117
  94. package/.bkit/core/engine/commands/workflow/challenge.ts +114 -39
  95. package/.bkit/core/engine/commands/workflow/completeness.ts +109 -0
  96. package/.bkit/core/engine/commands/workflow/context.ts +433 -55
  97. package/.bkit/core/engine/commands/workflow/counters.ts +244 -39
  98. package/.bkit/core/engine/commands/workflow/decisions.ts +61 -17
  99. package/.bkit/core/engine/commands/workflow/disk.ts +237 -55
  100. package/.bkit/core/engine/commands/workflow/fids.ts +19 -1
  101. package/.bkit/core/engine/commands/workflow/issues.ts +6 -0
  102. package/.bkit/core/engine/commands/workflow/ledgers.ts +458 -18
  103. package/.bkit/core/engine/commands/workflow/locks.ts +2 -0
  104. package/.bkit/core/engine/commands/workflow/plan-blocks.ts +124 -15
  105. package/.bkit/core/engine/commands/workflow/plans.ts +257 -0
  106. package/.bkit/core/engine/commands/workflow/prs.ts +12 -3
  107. package/.bkit/core/engine/commands/workflow/repo.ts +8 -0
  108. package/.bkit/core/engine/commands/workflow/roadmap.ts +56 -15
  109. package/.bkit/core/engine/commands/workflow/run-facts.ts +22 -31
  110. package/.bkit/core/engine/commands/workflow/runs.ts +652 -34
  111. package/.bkit/core/engine/commands/workflow/runtime.ts +3 -0
  112. package/.bkit/core/engine/commands/workflow/skills.ts +1 -0
  113. package/.bkit/core/engine/commands/workflow/status.ts +200 -17
  114. package/.bkit/core/engine/commands/workflow/step-table.ts +75 -33
  115. package/.bkit/core/engine/commands/workflow/steps.ts +635 -24
  116. package/.bkit/core/engine/commands/workflow/summary-findings.ts +177 -0
  117. package/.bkit/core/engine/commands/workflow/summary.ts +192 -46
  118. package/.bkit/core/engine/commands/workflow/tasks.ts +409 -0
  119. package/.bkit/core/engine/commands/workflow/test-blocks.ts +254 -0
  120. package/.bkit/core/engine/commands/workflow/tests-changed.ts +201 -0
  121. package/.bkit/core/engine/commands/workflow/tests.ts +1285 -356
  122. package/.bkit/core/engine/commands/workflow/workflows.ts +228 -43
  123. package/.bkit/core/engine/commands/workflow/worktrees.ts +389 -47
  124. package/.bkit/core/engine/install/cloud-env.ts +251 -121
  125. package/.bkit/core/engine/install/context-ci-workflow.ts +102 -0
  126. package/.bkit/core/engine/install/manifest.ts +60 -12
  127. package/.bkit/core/engine/install/modules/antigravity.ts +3 -2
  128. package/.bkit/core/engine/install/modules/cloud.ts +3 -3
  129. package/.bkit/core/engine/install/modules/codex.ts +15 -2
  130. package/.bkit/core/engine/install/modules/core.ts +956 -52
  131. package/.bkit/core/engine/install/modules/cursor.ts +6 -6
  132. package/.bkit/core/engine/install/modules/opencode.ts +16 -4
  133. package/.bkit/core/engine/install/template-notes.ts +130 -0
  134. package/.bkit/core/engine/install/version-file.ts +3 -2
  135. package/.bkit/core/engine/install/write.ts +5 -0
  136. package/.bkit/core/engine/ledgers/compact.ts +124 -0
  137. package/.bkit/core/engine/ledgers/journal.ts +291 -0
  138. package/.bkit/core/engine/ledgers/status.ts +160 -9
  139. package/.bkit/core/engine/ledgers/telemetry.ts +158 -21
  140. package/.bkit/core/engine/render/hosts.ts +114 -14
  141. package/.bkit/core/engine/shared/bkit-latest.ts +26 -4
  142. package/.bkit/core/engine/shared/dep-updater.ts +60 -0
  143. package/.bkit/core/engine/shared/egress.ts +1 -1
  144. package/.bkit/core/engine/shared/package-manager.ts +9 -0
  145. package/.bkit/core/engine/shared/settings.ts +92 -17
  146. package/.bkit/core/engine/shared/timeouts.ts +2 -0
  147. package/.bkit/core/engine/tools/cli-doc.ts +111 -0
  148. package/.bkit/core/engine/tools/grammar-density.ts +1 -1
  149. package/.bkit/core/engine/tools/instructions-sources.ts +15 -17
  150. package/.bkit/core/engine/tools/instructions.ts +94 -43
  151. package/.bkit/core/hooks/antigravity-hook.js +25 -10
  152. package/.bkit/core/hooks/gateguard-engine.js +53 -29
  153. package/.bkit/core/hooks/guardrails-shell.js +4 -4
  154. package/.bkit/core/hooks/guardrails-tiers.js +3 -3
  155. package/.bkit/core/hooks/preflight-linear.sh +9 -9
  156. package/.bkit/core/hooks/preflight-rules.sh +8 -0
  157. package/.bkit/core/hooks/readguard-engine.js +29 -10
  158. package/.bkit/core/hooks/session-rules-advisory.js +61 -0
  159. package/.bkit/core/prompts/bkit-audit-generate.md +187 -116
  160. package/.bkit/core/prompts/bkit-build-challenge-1.md +56 -37
  161. package/.bkit/core/prompts/bkit-build-challenge-2.md +65 -45
  162. package/.bkit/core/prompts/bkit-build-install-skills.md +38 -29
  163. package/.bkit/core/prompts/bkit-build-plan-convert.md +43 -32
  164. package/.bkit/core/prompts/bkit-build-plan-current.md +49 -39
  165. package/.bkit/core/prompts/bkit-build-plan-gaps-remediate.md +79 -55
  166. package/.bkit/core/prompts/bkit-build-plan-tasks.md +149 -0
  167. package/.bkit/core/prompts/bkit-build-plan-tests.md +120 -0
  168. package/.bkit/core/prompts/bkit-build-plan-verify.md +87 -50
  169. package/.bkit/core/prompts/bkit-debug-abort-handover.md +36 -35
  170. package/.bkit/core/prompts/bkit-debug-failure-diagnose.md +96 -64
  171. package/.bkit/core/prompts/bkit-debug-failure-remediate.md +54 -45
  172. package/.bkit/core/prompts/bkit-debug-failure-reproduce.md +42 -33
  173. package/.bkit/core/prompts/bkit-debug-failure-soak.md +53 -37
  174. package/.bkit/core/prompts/bkit-design-brainstorm-ideate-1.md +35 -30
  175. package/.bkit/core/prompts/bkit-design-brainstorm-ideate-2.md +34 -29
  176. package/.bkit/core/prompts/bkit-design-brainstorm-ideate-3.md +32 -28
  177. package/.bkit/core/prompts/bkit-design-generate.md +68 -52
  178. package/.bkit/core/prompts/bkit-design-organise.md +73 -35
  179. package/.bkit/core/prompts/bkit-design-review-1.md +58 -54
  180. package/.bkit/core/prompts/bkit-design-review-2.md +54 -50
  181. package/.bkit/core/prompts/bkit-design-spike.md +54 -47
  182. package/.bkit/core/prompts/bkit-design-update.md +42 -31
  183. package/.bkit/core/prompts/bkit-plan-generate.md +76 -58
  184. package/.bkit/core/prompts/bkit-plan-review-1.md +63 -49
  185. package/.bkit/core/prompts/bkit-plan-review-2.md +60 -48
  186. package/.bkit/core/prompts/bkit-plan-scope-check.md +53 -46
  187. package/.bkit/core/prompts/bkit-plan-update.md +70 -52
  188. package/.bkit/core/prompts/bkit-ship-conflict-resolve.md +82 -50
  189. package/.bkit/core/prompts/bkit-ship-deferred-sweep.md +80 -45
  190. package/.bkit/core/prompts/bkit-ship-update-docs.md +35 -29
  191. package/.bkit/core/prompts/bkit-utility-compress-markdown.md +55 -49
  192. package/.bkit/core/prompts/bkit-utility-update-decisions.md +76 -49
  193. package/.bkit/core/prompts/bkit-utility-update-deferrals.md +70 -41
  194. package/.bkit/core/prompts/bkit-utility-update-documentation.md +33 -30
  195. package/.bkit/core/prompts/bkit-utility-update-failures.md +73 -43
  196. package/.bkit/core/prompts/bkit-utility-update-knowledge.md +77 -50
  197. package/.bkit/core/prompts/bkit-utility-update-roadmap.md +77 -45
  198. package/.bkit/core/prompts/bkit-utility-update-tracker.md +144 -68
  199. package/.bkit/core/workflows/bkit-auto.md +53 -30
  200. package/.bkit/core/workflows/bkit-build.md +635 -304
  201. package/.bkit/core/workflows/bkit-debug.md +301 -148
  202. package/.bkit/core/workflows/bkit-design.md +167 -95
  203. package/.bkit/core/workflows/bkit-plan.md +172 -84
  204. package/.bkit/core/workflows/bkit-ship.md +299 -152
  205. package/.bkit/shared/.agents/plugins/bkit/hooks.json +10 -0
  206. package/.bkit/shared/.claude/bkit-cloud.md +12 -10
  207. package/.bkit/shared/.claude/settings.json +3 -0
  208. package/.bkit/shared/.codex/bkit-cloud.md +98 -0
  209. package/.bkit/shared/.codex/hooks.json +20 -0
  210. package/.bkit/shared/.cursor/bkit-cloud.md +3 -3
  211. package/.bkit/shared/.opencode/opencode.json +1 -1
  212. package/.bkit/shared/CLAUDE.md +5 -1
  213. package/.bkit/shared/GEMINI.md +4 -1
  214. package/.bkit/shared/docs/architecture.md +4 -7
  215. package/.bkit/shared/docs/data-schema.md +4 -7
  216. package/.bkit/shared/docs/deployments.md +239 -166
  217. package/.bkit/shared/docs/design.md +11 -12
  218. package/.bkit/shared/docs/noise.md +8 -7
  219. package/.bkit/shared/docs/observability.md +5 -8
  220. package/.bkit/shared/docs/security.md +35 -17
  221. package/.bkit/shared/docs/setup.md +29 -18
  222. package/.bkit/shared/docs/technology.md +3 -6
  223. package/.bkit/shared/docs/testing.md +282 -176
  224. package/.bkit/shared/gitignore +6 -2
  225. package/.bkit/templates/.claude/hooks/bkit-cloud-bootstrap.sh +15 -16
  226. package/.bkit/templates/.cursor/Dockerfile +12 -8
  227. package/.bkit/templates/.cursor/environment.json +1 -1
  228. package/.bkit/templates/.github/ISSUE_TEMPLATE/bkit-bug.yml +10 -8
  229. package/.bkit/templates/.github/ISSUE_TEMPLATE/bkit-change.yml +24 -12
  230. package/.bkit/templates/.github/ISSUE_TEMPLATE/bkit-idea.yml +3 -3
  231. package/.bkit/templates/.github/renovate.json5 +34 -6
  232. package/.bkit/templates/.github/workflows/bkit-ci.yml +53 -50
  233. package/.bkit/templates/.github/workflows/bkit-cloud.yml +13 -14
  234. package/.bkit/templates/.github/workflows/bkit-health.yml +97 -0
  235. package/.bkit/templates/.github/workflows/bkit-renovate.yml +5 -4
  236. package/.bkit/templates/.github/workflows/bkit-trivy.yml +5 -4
  237. package/.bkit/templates/.husky/pre-commit +2 -2
  238. package/.bkit/templates/.husky/pre-push +95 -35
  239. package/.bkit/templates/.prettierignore +6 -7
  240. package/.bkit/templates/.vale.ini +27 -27
  241. package/.bkit/templates/context/bkit-cloudrun.md +23 -15
  242. package/.bkit/templates/context/bkit-expo.md +70 -52
  243. package/.bkit/templates/context/bkit-github.md +93 -56
  244. package/.bkit/templates/context/bkit-inngest.md +21 -15
  245. package/.bkit/templates/context/bkit-maestro.md +22 -16
  246. package/.bkit/templates/context/bkit-playwright.md +23 -17
  247. package/.bkit/templates/context/bkit-resend.md +12 -10
  248. package/.bkit/templates/context/bkit-sentry.md +30 -20
  249. package/.bkit/templates/context/bkit-serena.md +8 -7
  250. package/.bkit/templates/context/bkit-stripe.md +14 -13
  251. package/.bkit/templates/context/bkit-supabase.md +16 -13
  252. package/.bkit/templates/context/bkit-tavily.md +14 -11
  253. package/.bkit/templates/context/bkit-vercel.md +27 -18
  254. package/.bkit/templates/docs/capabilities.md +15 -14
  255. package/.bkit/templates/scripts/ci/{check-accepted-divergences.mjs → bkit-check-accepted-divergences.mjs} +6 -3
  256. package/.bkit/templates/scripts/ci/{check-accepted-divergences.test.mjs → bkit-check-accepted-divergences.test.mjs} +3 -3
  257. package/.bkit/templates/scripts/ci/{check-capstone.mjs → bkit-check-capstone.mjs} +2 -2
  258. package/.bkit/templates/scripts/ci/{check-capstone.test.mjs → bkit-check-capstone.test.mjs} +4 -4
  259. package/.bkit/templates/scripts/ci/{check-dependency-audit.mjs → bkit-check-dependency-audit.mjs} +103 -18
  260. package/.bkit/templates/scripts/ci/{check-dependency-audit.test.mjs → bkit-check-dependency-audit.test.mjs} +31 -3
  261. package/.bkit/templates/scripts/ci/bkit-machine-lock.sh +387 -0
  262. package/.bkit/templates/scripts/ci/bkit-test-awake.mjs +75 -0
  263. package/.bkit/templates/scripts/ci/bkit-test-awake.test.mjs +160 -0
  264. package/.bkit/templates/scripts/ci/lanes/{resolve-push-base.mjs → bkit-resolve-push-base.mjs} +3 -3
  265. package/.bkit/templates/scripts/ci/lanes/{resolve-push-base.test.mjs → bkit-resolve-push-base.test.mjs} +4 -4
  266. package/.bkit/templates/scripts/cleanup/bkit-disk-prune.mjs +9 -1
  267. package/.bkit/templates/scripts/graphify/bkit-graph-drift.py +1 -1
  268. package/.bkit/templates/scripts/graphify/bkit-graph-eager.py +3 -3
  269. package/.bkit/templates/scripts/graphify/bkit-graph-embed.py +63 -0
  270. package/.bkit/templates/scripts/graphify/bkit-graph-imports.py +2 -2
  271. package/.bkit/templates/scripts/graphify/bkit-graph-pre-push.sh +69 -18
  272. package/.bkit/templates/scripts/graphify/bkit-graph-repair.py +3 -3
  273. package/.bkit/templates/scripts/graphify/bkit-graph-surface.py +1 -1
  274. package/.bkit/templates/scripts/graphify/bkit-graphify-graphml.py +1 -1
  275. package/.bkit/templates/scripts/graphify/bkit-graphify-rollup.py +197 -126
  276. package/.bkit/templates/scripts/graphify/bkit-graphify.sh +64 -41
  277. package/.bkit/templates/scripts/slop/bkit-slop-type-suppression.mjs +23 -7
  278. package/.bkit/templates/slop-scan.config.json +9 -2
  279. package/CHANGELOG.md +119 -0
  280. package/README.md +250 -76
  281. package/dist/checks/after/auth.js +36 -33
  282. package/dist/checks/after/ci-yml.js +52 -2
  283. package/dist/checks/after/index.js +12 -4
  284. package/dist/checks/after/tools.js +73 -33
  285. package/dist/checks/before/context-fetch.js +218 -33
  286. package/dist/checks/before/env.js +1 -1
  287. package/dist/checks/before/index.js +6 -2
  288. package/dist/checks/before/repo.js +35 -1
  289. package/dist/checks/status-holes.js +739 -114
  290. package/dist/checks/tips/catalogue.js +59 -17
  291. package/dist/checks/tips/detect.js +30 -0
  292. package/dist/checks/tips/index.js +48 -6
  293. package/dist/cli.js +222 -84
  294. package/dist/commands/analysis.js +77 -53
  295. package/dist/commands/ci/ci.js +302 -25
  296. package/dist/commands/ci/pins.js +142 -0
  297. package/dist/commands/ci/push-gate.js +194 -0
  298. package/dist/commands/install/uninstall.js +23 -27
  299. package/dist/commands/install/upgrade.js +21 -11
  300. package/dist/commands/land.js +126 -10
  301. package/dist/commands/lib.js +244 -5
  302. package/dist/commands/registry.js +6 -2
  303. package/dist/commands/setup/setup.js +1 -0
  304. package/dist/commands/stats.js +69 -30
  305. package/dist/commands/workflow/branches.js +1232 -111
  306. package/dist/commands/workflow/challenge.js +90 -37
  307. package/dist/commands/workflow/completeness.js +97 -0
  308. package/dist/commands/workflow/context.js +371 -51
  309. package/dist/commands/workflow/counters.js +206 -40
  310. package/dist/commands/workflow/decisions.js +60 -17
  311. package/dist/commands/workflow/disk.js +213 -55
  312. package/dist/commands/workflow/fids.js +18 -1
  313. package/dist/commands/workflow/issues.js +6 -0
  314. package/dist/commands/workflow/ledgers.js +372 -21
  315. package/dist/commands/workflow/locks.js +2 -0
  316. package/dist/commands/workflow/plan-blocks.js +78 -14
  317. package/dist/commands/workflow/plans.js +205 -0
  318. package/dist/commands/workflow/prs.js +12 -3
  319. package/dist/commands/workflow/repo.js +6 -0
  320. package/dist/commands/workflow/roadmap.js +50 -17
  321. package/dist/commands/workflow/run-facts.js +23 -28
  322. package/dist/commands/workflow/runs.js +530 -33
  323. package/dist/commands/workflow/runtime.js +3 -0
  324. package/dist/commands/workflow/skills.js +1 -0
  325. package/dist/commands/workflow/status.js +166 -19
  326. package/dist/commands/workflow/step-table.js +61 -29
  327. package/dist/commands/workflow/steps.js +542 -26
  328. package/dist/commands/workflow/summary-findings.js +117 -0
  329. package/dist/commands/workflow/summary.js +154 -41
  330. package/dist/commands/workflow/tasks.js +378 -0
  331. package/dist/commands/workflow/test-blocks.js +231 -0
  332. package/dist/commands/workflow/tests-changed.js +172 -0
  333. package/dist/commands/workflow/tests.js +1013 -321
  334. package/dist/commands/workflow/workflows.js +191 -38
  335. package/dist/commands/workflow/worktrees.js +310 -42
  336. package/dist/install/cloud-env.js +233 -99
  337. package/dist/install/context-ci-workflow.js +85 -0
  338. package/dist/install/manifest.js +57 -12
  339. package/dist/install/modules/antigravity.js +3 -2
  340. package/dist/install/modules/cloud.js +3 -3
  341. package/dist/install/modules/codex.js +12 -2
  342. package/dist/install/modules/core.js +851 -53
  343. package/dist/install/modules/cursor.js +6 -6
  344. package/dist/install/modules/opencode.js +11 -5
  345. package/dist/install/template-notes.js +116 -0
  346. package/dist/install/version-file.js +3 -2
  347. package/dist/ledgers/compact.js +87 -0
  348. package/dist/ledgers/journal.js +233 -0
  349. package/dist/ledgers/status.js +115 -5
  350. package/dist/ledgers/telemetry.js +121 -17
  351. package/dist/render/hosts.js +100 -14
  352. package/dist/shared/bkit-latest.js +26 -4
  353. package/dist/shared/dep-updater.js +49 -0
  354. package/dist/shared/egress.js +1 -1
  355. package/dist/shared/package-manager.js +6 -0
  356. package/dist/shared/settings.js +59 -10
  357. package/dist/shared/timeouts.js +2 -0
  358. package/dist/tools/cli-doc.js +97 -0
  359. package/dist/tools/grammar-density.js +1 -1
  360. package/dist/tools/instructions-sources.js +15 -16
  361. package/dist/tools/instructions.js +83 -39
  362. package/package.json +58 -42
  363. package/.bkit/core/.bkit/lite.md +0 -73
  364. package/.bkit/core/engine/commands/workflow/workstreams.ts +0 -172
  365. package/.bkit/core/prompts/bkit-build-plan-execute.md +0 -124
  366. package/.bkit/templates/scripts/ci/bkit-local-stack-lock.sh +0 -194
  367. package/dist/commands/workflow/workstreams.js +0 -149
  368. /package/.bkit/templates/.vale/styles/{House → Bkit}/Filler.yml +0 -0
  369. /package/.bkit/templates/.vale/styles/{House → Bkit}/Hedging.yml +0 -0
  370. /package/.bkit/templates/.vale/styles/{House → Bkit}/LLMSlop.yml +0 -0
  371. /package/.bkit/templates/.vale/styles/{House → Bkit}/Verbose.yml +0 -0
  372. /package/.bkit/templates/scripts/ci/{accepted-advisories.json → bkit-accepted-advisories.json} +0 -0
  373. /package/.bkit/templates/scripts/ci/{accepted-divergences.json → bkit-accepted-divergences.json} +0 -0
  374. /package/.bkit/templates/scripts/launchd/{launchd.env.example → bkit-launchd.env.example} +0 -0
  375. /package/.bkit/templates/scripts/launchd/{ai.bkit.launchd.plist → bkit-launchd.plist} +0 -0
@@ -133,6 +133,17 @@ export const SEVERITY_KINDS = new Set(["friction", "deferral", "failure"]);
133
133
  export const TRIAGE_STATUSES = new Set(["OPEN", "TRIAGED", "CLOSED"]);
134
134
  /** The `ACTIVE` / `SUPERSEDED` lifecycle shared by `decision` and `knowledge`. */
135
135
  export const DECISION_STATUSES = new Set(["ACTIVE", "SUPERSEDED"]);
136
+ /**
137
+ * The kinds whose rows carry `firstTs` + `updates` (`.bkit/jsonl.md` § Compaction):
138
+ * the keyed kinds of the ledgers `bkit ledgers compact` rewrites to their fold winners.
139
+ */
140
+ export const AGED_KINDS = new Set([
141
+ "deferral",
142
+ "failure",
143
+ "knowledge",
144
+ "decision",
145
+ "feature",
146
+ ]);
136
147
  export const FEATURE_STATUSES = new Set([
137
148
  "DESIGNED",
138
149
  "PLANNED",
@@ -164,7 +175,7 @@ export const UNJUSTIFIED_REASON = "unjustified";
164
175
  * § Ledgers & Writers). EXHAUSTIVE: a subagent absent from this set does not
165
176
  * write the kind at all.
166
177
  *
167
- * `@bkit-build-plan-execute` and `@bkit-build-plan-gaps-remediate` are not in it: a
178
+ * `@bkit-build-plan-tasks` and `@bkit-build-plan-gaps-remediate` are not in it: a
168
179
  * blocked plan task's record is its `BLOCKED` log line, which the next verify pass reads.
169
180
  *
170
181
  * Orchestrator-written rows carry no `subagent` and are outside this check.
@@ -194,6 +205,11 @@ export const APPEND_LEDGERS = {
194
205
  };
195
206
  /** The workflows whose close writes `.bkit/stats.jsonl` rows (`bkit workflows close`, `bkit comply`). */
196
207
  const CLOSING_WORKFLOWS = new Set(["design", "plan", "build", "debug", "ship"]);
208
+ /**
209
+ * The stats writers: the closing workflows, plus `utility`, a direct chat outside any
210
+ * workflow (`by.step` `manual`), the owner deciding in it.
211
+ */
212
+ const STATS_WRITERS = new Set([...CLOSING_WORKFLOWS, "utility"]);
197
213
  /**
198
214
  * `.bkit/jsonl.md` § Ledgers & Writers as code, for the kinds in
199
215
  * {@link APPEND_LEDGERS}. EXHAUSTIVE: a name absent from a set does not write the
@@ -207,31 +223,37 @@ export const KIND_WRITERS = {
207
223
  "bkit-plan-update",
208
224
  "bkit-utility-update-decisions",
209
225
  ]),
210
- // Build: Decision Pause accept; plan: an open question answered after close; ship: an
211
- // assumed accept the owner confirms (`bkit decisions apply --by=owner`). All ONLY after
212
- // explicit human approval.
213
- orchestrators: new Set(["build", "plan", "ship"]),
226
+ // Build: Decision Pause accept; plan: an open question answered after close; design: an
227
+ // open question answered by the owner at close (the human decides, the orchestrator
228
+ // records); ship: an assumed accept the owner confirms (`bkit decisions apply --by=owner`);
229
+ // utility: a direct chat outside any workflow (`by.step` `manual`), the owner deciding in it.
230
+ // All ONLY after explicit human approval.
231
+ orchestrators: new Set(["design", "build", "plan", "ship", "utility"]),
214
232
  },
215
233
  // Build: `bkit challenge merge` writes each LOW challenge finding (`low-severity`). Ship:
216
234
  // `bkit decisions pending --defer` writes each assumed accept nobody confirmed (`needs-decision`).
217
- deferral: { subagents: DEFERRAL_WRITERS, orchestrators: new Set(["build", "ship"]) },
235
+ // Utility: a direct chat outside any workflow (`by.step` `manual`), the owner deciding in it.
236
+ deferral: { subagents: DEFERRAL_WRITERS, orchestrators: new Set(["build", "ship", "utility"]) },
218
237
  failure: { subagents: ANY_WRITER, orchestrators: ANY_WRITER },
219
238
  knowledge: {
220
239
  subagents: new Set([
221
- "bkit-build-plan-execute",
240
+ "bkit-build-plan-tests",
241
+ "bkit-build-plan-tasks",
222
242
  "bkit-build-plan-gaps-remediate",
223
243
  "bkit-debug-failure-remediate",
224
244
  "bkit-utility-update-knowledge",
225
245
  ]),
226
- orchestrators: new Set(),
246
+ // Utility: a direct chat outside any workflow (`by.step` `manual`), the owner deciding in it.
247
+ orchestrators: new Set(["utility"]),
227
248
  },
228
249
  friction: {
229
250
  subagents: new Set(),
230
- orchestrators: new Set(["design", "plan", "build", "debug", "ship"]),
251
+ // Utility: a direct chat outside any workflow (`by.step` `manual`) that meets friction.
252
+ orchestrators: new Set(["design", "plan", "build", "debug", "ship", "auto", "utility"]),
231
253
  },
232
- compliance: { subagents: new Set(), orchestrators: CLOSING_WORKFLOWS },
233
- counter: { subagents: new Set(), orchestrators: CLOSING_WORKFLOWS },
234
- outcome: { subagents: new Set(), orchestrators: CLOSING_WORKFLOWS },
254
+ compliance: { subagents: new Set(), orchestrators: STATS_WRITERS },
255
+ counter: { subagents: new Set(), orchestrators: STATS_WRITERS },
256
+ outcome: { subagents: new Set(), orchestrators: STATS_WRITERS },
235
257
  };
236
258
  const writerList = (w) => w === ANY_WRITER ? "any" : w.size === 0 ? "none" : [...w].join(", ");
237
259
  /** A row's `by` block, or an empty one when it has none. */
@@ -285,13 +307,14 @@ export function mintTs(after) {
285
307
  * tokens" per build group). Rows store peaks only; readers judge them against this.
286
308
  */
287
309
  export const AGENT_CONTEXT_CAP = 160_000;
288
- export const OUTCOME_ENDINGS = new Set(["done", "close-failed"]);
310
+ export const OUTCOME_ENDINGS = new Set(["done", "close-failed", "held"]);
289
311
  export const RUN_ENDINGS = new Set([
290
312
  "done",
291
313
  "close-failed",
292
314
  "failed",
293
315
  "decision-pause",
294
316
  "stopped",
317
+ "held",
295
318
  ]);
296
319
  // ---------------------------------------------------------------------------
297
320
  // Identity — per-kind composite tuple for dedup (NOT bare ts)
@@ -776,7 +799,7 @@ export function totalsProblem(row) {
776
799
  checks.push(() => eq("build.challenge.findings.total", findings["total"], sumOf(["CRITICAL", "HIGH", "MEDIUM", "LOW"].map((s) => findings[s]))));
777
800
  }
778
801
  if (typeof build["redTests"] === "number" && isObj(field(steps, "byStep"))) {
779
- checks.push(() => eq("build.redTests", build["redTests"], Number(field(steps, "byStep", "build-task-red", "n") ?? 0)));
802
+ checks.push(() => eq("build.redTests", build["redTests"], Number(field(steps, "byStep", "build-tests-red", "n") ?? 0)));
780
803
  }
781
804
  }
782
805
  const usage = row["usage"];
@@ -984,6 +1007,23 @@ export function validate(event) {
984
1007
  else if (e["reason"] !== undefined) {
985
1008
  return { ok: false, reason: `${kind} rows do not carry reason` };
986
1009
  }
1010
+ // firstTs / updates — the entry's age and row count, set by the writer (withLineage).
1011
+ if (AGED_KINDS.has(kind)) {
1012
+ const first = e["firstTs"];
1013
+ if (first !== undefined && (typeof first !== "number" || !(first <= e["ts"]))) {
1014
+ return { ok: false, reason: "firstTs must be a number no later than ts" };
1015
+ }
1016
+ const updates = e["updates"];
1017
+ if (updates !== undefined && (!Number.isInteger(updates) || updates < 1)) {
1018
+ return { ok: false, reason: "updates must be a positive integer" };
1019
+ }
1020
+ }
1021
+ else {
1022
+ for (const f of ["firstTs", "updates"]) {
1023
+ if (e[f] !== undefined)
1024
+ return { ok: false, reason: `${kind} rows do not carry ${f}` };
1025
+ }
1026
+ }
987
1027
  const run = isObj(e["run"]) ? e["run"] : undefined;
988
1028
  if (kind === "compliance" || kind === "counter") {
989
1029
  if (typeof run?.["parentSha"] !== "string" || run["parentSha"] === "") {
@@ -1035,7 +1075,13 @@ export function validate(event) {
1035
1075
  if (!OUTCOME_ENDINGS.has(e["ending"])) {
1036
1076
  return {
1037
1077
  ok: false,
1038
- reason: `outcome ending must be done|close-failed (got: ${String(e["ending"])})`,
1078
+ reason: `outcome ending must be ${[...OUTCOME_ENDINGS].join("|")} (got: ${String(e["ending"])})`,
1079
+ };
1080
+ }
1081
+ if (e["publish"] !== undefined && typeof e["publish"] !== "boolean") {
1082
+ return {
1083
+ ok: false,
1084
+ reason: `outcome publish must be a boolean (got: ${String(e["publish"])})`,
1039
1085
  };
1040
1086
  }
1041
1087
  const ledgers = e["ledgers"];
@@ -1218,6 +1264,64 @@ export function fold(events) {
1218
1264
  }
1219
1265
  return state;
1220
1266
  }
1267
+ const positiveInt = (v) => Number.isInteger(v) && v > 0 ? v : undefined;
1268
+ /**
1269
+ * `firstTs` + `updates` of one entry from all of its rows, in any order. A row
1270
+ * carrying `updates` stands for that many rows, so the count survives compaction;
1271
+ * each later row adds one. Rows sharing a numeric `ts` are one write: a compacted
1272
+ * winner beside the pre-compaction copy a union merge brought back.
1273
+ */
1274
+ export function lineage(rows) {
1275
+ let firstTs;
1276
+ let updates = 0;
1277
+ let prev;
1278
+ for (const r of [...rows].sort((a, b) => compareTs({ ts: a.ts }, { ts: b.ts }))) {
1279
+ for (const t of [r.firstTs, r.ts]) {
1280
+ if (typeof t === "number" && Number.isFinite(t) && (firstTs === undefined || t < firstTs)) {
1281
+ firstTs = t;
1282
+ }
1283
+ }
1284
+ const own = positiveInt(r.updates);
1285
+ const at = tsOrder(r.ts);
1286
+ updates =
1287
+ at === prev && Number.isFinite(at)
1288
+ ? Math.max(updates, own ?? updates)
1289
+ : Math.max(own ?? 0, updates + 1);
1290
+ prev = at;
1291
+ }
1292
+ return firstTs === undefined ? { updates } : { firstTs, updates };
1293
+ }
1294
+ /** `row` with `firstTs` + `updates` set to `l`, placed right after `ts` (at the end when it has none). */
1295
+ export function placeLineage(row, l) {
1296
+ const fields = l.firstTs === undefined ? {} : { firstTs: l.firstTs };
1297
+ fields["updates"] = l.updates;
1298
+ const out = {};
1299
+ for (const [k, v] of Object.entries(row)) {
1300
+ if (k === "firstTs" || k === "updates")
1301
+ continue;
1302
+ out[k] = v;
1303
+ if (k === "ts")
1304
+ Object.assign(out, fields);
1305
+ }
1306
+ return "ts" in row ? out : { ...out, ...fields };
1307
+ }
1308
+ /** True for a row `bkit ledgers compact` folds: an {@link AGED_KINDS} kind with a non-empty string `key`. */
1309
+ export const isAgedRow = (row) => AGED_KINDS.has(String(row["kind"])) && typeof row["key"] === "string" && row["key"] !== "";
1310
+ /**
1311
+ * `row` about to be appended, with `firstTs` + `updates` carried forward from
1312
+ * `prior` (rows already in its ledger) and any supplied values replaced. A row
1313
+ * {@link isAgedRow} rejects is returned unchanged.
1314
+ */
1315
+ export function withLineage(prior, row) {
1316
+ if (!isAgedRow(row))
1317
+ return row;
1318
+ const id = identity(normalizeEvent(row));
1319
+ const same = prior
1320
+ .map(normalizeEvent)
1321
+ .filter((p) => isAgedRow(p) && identity(p) === id);
1322
+ const { firstTs: _first, updates: _updates, ...fresh } = row;
1323
+ return placeLineage(row, lineage([...same, fresh]));
1324
+ }
1221
1325
  /** Reads every existing file in `paths` and folds all events together. */
1222
1326
  export function foldFrom(paths) {
1223
1327
  let allEvents = [];
@@ -1377,8 +1481,8 @@ export function workflowTelemetry(result, workflow) {
1377
1481
  show("lines.total.files", (r) => r.lines?.total?.files);
1378
1482
  }
1379
1483
  show("plan.total.tasks", (r) => r.plan?.total?.tasks);
1380
- if (cur.ending === "close-failed")
1381
- row("ending", "close-failed", "—");
1484
+ if (cur.ending === "close-failed" || cur.ending === "held")
1485
+ row("ending", cur.ending, "—");
1382
1486
  // Instinct-loop deltas — friction is the featured signal (shown even at 0).
1383
1487
  show("ledgers.friction.added", (r) => r.ledgers?.friction?.added);
1384
1488
  show("ledgers.deferrals.added", (r) => r.ledgers?.deferrals?.added);
@@ -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");
@@ -121,13 +203,14 @@ export function applyOpencodeAgent(content, opencodeModelLookup, effortMap, prov
121
203
  else {
122
204
  newFm += `description: ${description}\n`;
123
205
  }
124
- // Thinking effort is a model variant in its own `variant:` field. Program-keyed: every
125
- // opencode gateway shares the one "OpenCode" ladder; the gateway is not consulted —
126
- // 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).
127
210
  const modelPin = formatModelPin("opencode", provider ?? "", opencodeModel);
128
211
  newFm += `model: ${modelPin}\n`;
129
212
  const variant = provider !== "ollama" && effort && effortMap
130
- ? lookupEffort(effortMap, "opencode", effort)
213
+ ? clampOpencodeVariant(provider ?? "", opencodeModel, lookupEffort(effortMap, opencodeEffortProgram(opencodeModel), effort))
131
214
  : null;
132
215
  if (variant)
133
216
  newFm += `variant: ${variant}\n`;
@@ -436,7 +519,10 @@ export function applyAntigravityPrompt(content, modelLookup, effortMap) {
436
519
  }
437
520
  newFm += `model: ${formatModelPin("antigravity", "google", model)}\n`;
438
521
  if (effort && effortMap) {
439
- 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`;
440
526
  }
441
527
  newFm += antigravityToolsBlock(toolsBlock);
442
528
  newFm += "---\n";
@@ -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) {
@@ -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
  ];
@@ -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. */
@@ -25,6 +26,19 @@ export const ASK_POINTS = [
25
26
  ];
26
27
  /** The limit key a point's block holds. */
27
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
+ ];
28
42
  export const CONFIG_DEFAULTS = {
29
43
  ciWorkflow: "bkit-ci.yml",
30
44
  capstoneJob: "bkit-tests-check",
@@ -37,10 +51,12 @@ export const CONFIG_DEFAULTS = {
37
51
  // `started` is a state type every Linear team has; In Review is a name a default team lacks.
38
52
  linear: { team: null, project: null, progress: "started", review: "In Review" },
39
53
  jira: { site: null, project: null, progress: "In Progress", review: "In Review" },
40
- shipGateRequiredLanes: [],
41
- // What bkit's workflows write: plan / design / build logs and the ledgers. Never
42
- // `docs/**`: a project doc can be a test's input, so a docs edit can red a test.
43
- 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: [],
44
60
  opencodeProvider: null,
45
61
  opencodeProviders: [],
46
62
  cloudAgents: DEFAULT_CLOUD_AGENTS,
@@ -55,8 +71,9 @@ export const CONFIG_DEFAULTS = {
55
71
  "ship.merge": { ask: true, max: 2 },
56
72
  },
57
73
  // Plan caps, `.bkit/workflows.md` § Test-first.
58
- tasks: { maxPerGroup: 3, maxTestsPerGroup: 15, maxTestsPerTask: 10, maxTestFilesPerTask: 3 },
59
- depUpdaterOptOut: false,
74
+ tasks: { maxPerGroup: 5, maxTestsPerGroup: 25, maxTestsPerTask: 10, maxTestFilesPerTask: 3 },
75
+ buildPublish: { remote: true, local: true },
76
+ depUpdater: null,
60
77
  issueTrackerExplicit: false,
61
78
  cloudAgentsExplicit: false,
62
79
  };
@@ -70,6 +87,7 @@ function trackerStates(raw, defaults) {
70
87
  review: nonEmptyString(raw.review) ? raw.review.trim() : defaults.review,
71
88
  };
72
89
  }
90
+ const parseDepUpdater = (v) => v === "none" || DEP_UPDATERS.includes(v) ? v : null;
73
91
  const TASK_CAP_KEYS = Object.keys(CONFIG_DEFAULTS.tasks);
74
92
  const validCap = (v) => Number.isInteger(v) && v >= 1;
75
93
  /**
@@ -84,6 +102,33 @@ export function invalidTaskCaps(raw) {
84
102
  const set = raw;
85
103
  return TASK_CAP_KEYS.filter((k) => set[k] !== undefined && !validCap(set[k]));
86
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
+ }
87
132
  /** `bkit.workflows.tasks` read key by key; a missing or invalid key takes its default. */
88
133
  function taskCaps(raw) {
89
134
  const set = record(raw);
@@ -153,9 +198,11 @@ export function readBkitConfig(root) {
153
198
  const testing = record(bkit.testing);
154
199
  const workflows = record(bkit.workflows);
155
200
  const worktree = record(workflows.worktree);
201
+ const ciSkip = testing.ciSkipPaths;
202
+ const generated = testing.ciGenerated;
156
203
  const copy = worktree.copy;
157
204
  const minFreeGb = workflows.minFreeGb;
158
- const lanes = testing.shipGate;
205
+ const lanes = testing.ciRequired;
159
206
  const book = testing.minPushPaths;
160
207
  const provider = opencode.default;
161
208
  const providers = opencode.installed;
@@ -193,11 +240,12 @@ export function readBkitConfig(root) {
193
240
  project: optionalString(jira.project),
194
241
  ...trackerStates(jira, CONFIG_DEFAULTS.jira),
195
242
  },
196
- shipGateRequiredLanes: Array.isArray(lanes) ? lanes.filter(nonEmptyString) : [],
197
- // An explicit [] is kept: it switches the min push off.
243
+ ciRequired: Array.isArray(lanes) ? lanes.filter(nonEmptyString) : [],
198
244
  minPushPaths: Array.isArray(book)
199
245
  ? book.filter(nonEmptyString)
200
246
  : [...CONFIG_DEFAULTS.minPushPaths],
247
+ ciSkipPaths: Array.isArray(ciSkip) ? ciSkip.filter(nonEmptyString) : [],
248
+ ciGenerated: Array.isArray(generated) ? generated.filter(nonEmptyString) : [],
201
249
  opencodeProvider: typeof provider === "string" && isOpencodeProvider(provider) ? provider : null,
202
250
  opencodeProviders: Array.isArray(providers)
203
251
  ? providers.filter((v) => typeof v === "string" && isOpencodeProvider(v))
@@ -205,7 +253,8 @@ export function readBkitConfig(root) {
205
253
  cloudAgents: parseCloudAgents(cloud.agent) ?? CONFIG_DEFAULTS.cloudAgents,
206
254
  asks: askSettings(workflows),
207
255
  tasks: taskCaps(workflows.tasks),
208
- depUpdaterOptOut: record(bkit.dependencies).updater === "none",
256
+ buildPublish: buildPublish(record(workflows.build).publish),
257
+ depUpdater: parseDepUpdater(record(bkit.dependencies).updater),
209
258
  issueTrackerExplicit: tracker.default !== undefined && tracker.default !== "",
210
259
  cloudAgentsExplicit: cloud.agent !== undefined && cloud.agent !== "",
211
260
  };
@@ -23,4 +23,6 @@ export const TIMEOUTS = {
23
23
  BKIT_LATEST_RETRY_S: 3600,
24
24
  /** Seconds the registry lookup may take before it counts as failed. */
25
25
  BKIT_LATEST_LOOKUP_TIMEOUT_S: 5,
26
+ /** Seconds `worktrees setup` waits for a running disk sweep before refusing; under one agent shell call. */
27
+ DISK_SETUP_SWEEP_WAIT_S: 60,
26
28
  };