@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
@@ -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,
@@ -123,14 +215,19 @@ export function applyOpencodeAgent(
123
215
  } else {
124
216
  newFm += `description: ${description}\n`;
125
217
  }
126
- // Thinking effort is a model variant in its own `variant:` field. Program-keyed: every
127
- // opencode gateway shares the one "OpenCode" ladder; the gateway is not consulted —
128
- // 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).
129
222
  const modelPin = formatModelPin("opencode", provider ?? "", opencodeModel);
130
223
  newFm += `model: ${modelPin}\n`;
131
224
  const variant =
132
225
  provider !== "ollama" && effort && effortMap
133
- ? lookupEffort(effortMap, "opencode", effort)
226
+ ? clampOpencodeVariant(
227
+ provider ?? "",
228
+ opencodeModel,
229
+ lookupEffort(effortMap, opencodeEffortProgram(opencodeModel), effort),
230
+ )
134
231
  : null;
135
232
  if (variant) newFm += `variant: ${variant}\n`;
136
233
  newFm += opencodeToolsBlock(toolsBlock);
@@ -494,7 +591,10 @@ export function applyAntigravityPrompt(
494
591
  }
495
592
  newFm += `model: ${formatModelPin("antigravity", "google", model)}\n`;
496
593
  if (effort && effortMap) {
497
- 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`;
498
598
  }
499
599
  newFm += antigravityToolsBlock(toolsBlock);
500
600
  newFm += "---\n";
@@ -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. */
@@ -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;
@@ -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
 
@@ -12,6 +12,7 @@ import {
12
12
  type IssueTracker,
13
13
  } from "../install/manifest.js";
14
14
  import { isOpencodeProvider } from "../render/models.js";
15
+ import { DEP_UPDATERS, type DepUpdater } from "./dep-updater.js";
15
16
  import type { OpencodeProvider } from "./egress.js";
16
17
  import { readPackageJson } from "./package-json.js";
17
18
 
@@ -63,11 +64,19 @@ export interface JiraConfig extends TrackerStates {
63
64
  project: string | null;
64
65
  }
65
66
 
67
+ /** `bkit.workflows.build.publish`: whether a build ends by publishing (push, PR) or holds. */
68
+ export interface BuildPublish {
69
+ /** Always `true`: a non-local runtime always publishes. */
70
+ remote: true;
71
+ /** `false` holds a local build: nothing is pushed, the worktree is kept. */
72
+ local: boolean;
73
+ }
74
+
66
75
  /** `bkit.workflows.tasks`: the plan caps `tests plan-check` and `challenge merge` enforce. */
67
76
  export interface TaskCaps {
68
- /** Tasks in one plan group. */
77
+ /** Tasks in one task group. */
69
78
  maxPerGroup: number;
70
- /** Planned TEST FIRST tests in one plan group. */
79
+ /** Planned TEST FIRST tests in one task group. */
71
80
  maxTestsPerGroup: number;
72
81
  /** TEST FIRST tests one task names. */
73
82
  maxTestsPerTask: number;
@@ -119,12 +128,25 @@ export interface BkitConfig {
119
128
  /** `bkit.jira`. */
120
129
  jira: JiraConfig;
121
130
  /** CI lanes whose `skipped` conclusion refuses a ship merge; empty = the capstone's green decides. */
122
- shipGateRequiredLanes: string[];
131
+ ciRequired: string[];
123
132
  /**
124
- * Globs (`:(glob)` git pathspecs) for paths a push may carry and still run only
125
- * `bkit:gate:min` in `.husky/pre-push`; empty = every push runs the full hook.
133
+ * Globs (`:(glob)` git pathspecs) for paths a push may carry, on top of what bkit's
134
+ * workflows write (ship's bookkeeping allow-list, `docs/plans/**`, `ciSkipPaths`), and
135
+ * still run only `bkit:gate:min` in `.husky/pre-push`; empty = that floor alone.
126
136
  */
127
137
  minPushPaths: string[];
138
+ /**
139
+ * Globs (`:(glob)` git pathspecs) for the project docs ship's `[skip ci]` bookkeeping
140
+ * commit may carry onto the PR without a CI run, beyond the frozen allow-list
141
+ * (`bkit.testing.ciSkipPaths`, e.g. `CHANGELOG.md`, `README.md`); empty = none.
142
+ */
143
+ ciSkipPaths: string[];
144
+ /**
145
+ * `{job}/{step}` CI steps whose failure `bkit:generate` fixes, on top of
146
+ * `CI_GENERATED_FLOOR`: ship regenerates instead of failing when every failed step is
147
+ * on the list (`bkit.testing.ciGenerated`); empty = that floor alone.
148
+ */
149
+ ciGenerated: string[];
128
150
  /** The opencode provider recorded on install; null = absent or not a supported provider. */
129
151
  opencodeProvider: OpencodeProvider | null;
130
152
  /** Every installed opencode provider, supported ones only; empty = none recorded. */
@@ -135,14 +157,31 @@ export interface BkitConfig {
135
157
  asks: Record<AskPoint, AskSetting>;
136
158
  /** Plan caps; each key that is not an integer >= 1 takes its default. */
137
159
  tasks: TaskCaps;
138
- /** `bkit.dependencies.updater` is `"none"`: silences the missing-dependency-updater advisory. */
139
- depUpdaterOptOut: boolean;
160
+ /** Build ending; `remote` is always `true`, `local` defaults `true`. */
161
+ buildPublish: BuildPublish;
162
+ /** `bkit.dependencies.updater`: the updater the repo runs, or `none`; null = absent, `""` or unrecognised. */
163
+ depUpdater: DepUpdater | "none" | null;
140
164
  /** `bkit.tracker.default` is set, so `none` is a choice; absent or `""` (what install seeds) = undecided. */
141
165
  issueTrackerExplicit: boolean;
142
166
  /** `bkit.cloud.agent` is set, so `none` is a choice; absent or `""` (what install seeds) = undecided. */
143
167
  cloudAgentsExplicit: boolean;
144
168
  }
145
169
 
170
+ /**
171
+ * The `{job}/{step}` CI steps of bkit's `bkit-ci.yml` template whose failure a
172
+ * `bkit:generate` fixes: the capability register and the mirror drift check. Always
173
+ * counted; `bkit.testing.ciGenerated` adds to it and cannot remove it.
174
+ */
175
+ export const CI_GENERATED_FLOOR: readonly string[] = [
176
+ "bkit-tests-static/Check Capability Register",
177
+ "bkit-tests-static/Run bkit Check",
178
+ ];
179
+
180
+ /** The CI steps ship regenerates for: the floor plus the repo's `bkit.testing.ciGenerated`. */
181
+ export const ciGeneratedSteps = (cfg: Pick<BkitConfig, "ciGenerated">): string[] => [
182
+ ...new Set([...CI_GENERATED_FLOOR, ...cfg.ciGenerated]),
183
+ ];
184
+
146
185
  export const CONFIG_DEFAULTS: Readonly<BkitConfig> = {
147
186
  ciWorkflow: "bkit-ci.yml",
148
187
  capstoneJob: "bkit-tests-check",
@@ -155,10 +194,12 @@ export const CONFIG_DEFAULTS: Readonly<BkitConfig> = {
155
194
  // `started` is a state type every Linear team has; In Review is a name a default team lacks.
156
195
  linear: { team: null, project: null, progress: "started", review: "In Review" },
157
196
  jira: { site: null, project: null, progress: "In Progress", review: "In Review" },
158
- shipGateRequiredLanes: [],
159
- // What bkit's workflows write: plan / design / build logs and the ledgers. Never
160
- // `docs/**`: a project doc can be a test's input, so a docs edit can red a test.
161
- minPushPaths: ["docs/plans/**", "docs/*.jsonl", ".bkit/*.jsonl"],
197
+ ciRequired: [],
198
+ // Nothing beyond what bkit writes. Never seed `docs/**`: a project doc can be a test's
199
+ // input, so a docs edit can red a test; a repo that knows its tests opts in.
200
+ minPushPaths: [],
201
+ ciSkipPaths: [],
202
+ ciGenerated: [],
162
203
  opencodeProvider: null,
163
204
  opencodeProviders: [],
164
205
  cloudAgents: DEFAULT_CLOUD_AGENTS,
@@ -173,8 +214,9 @@ export const CONFIG_DEFAULTS: Readonly<BkitConfig> = {
173
214
  "ship.merge": { ask: true, max: 2 },
174
215
  },
175
216
  // Plan caps, `.bkit/workflows.md` § Test-first.
176
- tasks: { maxPerGroup: 3, maxTestsPerGroup: 15, maxTestsPerTask: 10, maxTestFilesPerTask: 3 },
177
- depUpdaterOptOut: false,
217
+ tasks: { maxPerGroup: 5, maxTestsPerGroup: 25, maxTestsPerTask: 10, maxTestFilesPerTask: 3 },
218
+ buildPublish: { remote: true, local: true },
219
+ depUpdater: null,
178
220
  issueTrackerExplicit: false,
179
221
  cloudAgentsExplicit: false,
180
222
  };
@@ -194,6 +236,9 @@ function trackerStates(raw: Record<string, unknown>, defaults: TrackerStates): T
194
236
  };
195
237
  }
196
238
 
239
+ const parseDepUpdater = (v: unknown): DepUpdater | "none" | null =>
240
+ v === "none" || DEP_UPDATERS.includes(v as DepUpdater) ? (v as DepUpdater | "none") : null;
241
+
197
242
  const TASK_CAP_KEYS = Object.keys(CONFIG_DEFAULTS.tasks) as (keyof TaskCaps)[];
198
243
 
199
244
  const validCap = (v: unknown): v is number => Number.isInteger(v) && (v as number) >= 1;
@@ -209,6 +254,32 @@ export function invalidTaskCaps(raw: unknown): string[] {
209
254
  return TASK_CAP_KEYS.filter((k) => set[k] !== undefined && !validCap(set[k]));
210
255
  }
211
256
 
257
+ /**
258
+ * The dotted keys of a `bkit.workflows.build` value that fall back to their default:
259
+ * `build` when set but not an object, `build.publish` when set but not an object,
260
+ * `build.publish.local` when set but not a boolean. `remote` is never listed: the
261
+ * preflight advisory `bkit-build-publish-remote` owns it.
262
+ */
263
+ export function invalidBuildPublish(raw: unknown): string[] {
264
+ if (raw === undefined) return [];
265
+ if (raw === null || typeof raw !== "object" || Array.isArray(raw)) return ["build"];
266
+ const publish = (raw as Record<string, unknown>).publish;
267
+ if (publish === undefined) return [];
268
+ if (publish === null || typeof publish !== "object" || Array.isArray(publish))
269
+ return ["build.publish"];
270
+ const local = (publish as Record<string, unknown>).local;
271
+ return local !== undefined && typeof local !== "boolean" ? ["build.publish.local"] : [];
272
+ }
273
+
274
+ /** `bkit.workflows.build.publish`; `remote` always resolves `true`. */
275
+ function buildPublish(raw: unknown): BuildPublish {
276
+ const { local } = record(raw);
277
+ return {
278
+ remote: true,
279
+ local: typeof local === "boolean" ? local : CONFIG_DEFAULTS.buildPublish.local,
280
+ };
281
+ }
282
+
212
283
  /** `bkit.workflows.tasks` read key by key; a missing or invalid key takes its default. */
213
284
  function taskCaps(raw: unknown): TaskCaps {
214
285
  const set = record(raw);
@@ -277,9 +348,11 @@ export function readBkitConfig(root: string): BkitConfig {
277
348
  const testing = record(bkit.testing);
278
349
  const workflows = record(bkit.workflows);
279
350
  const worktree = record(workflows.worktree);
351
+ const ciSkip = testing.ciSkipPaths;
352
+ const generated = testing.ciGenerated;
280
353
  const copy = worktree.copy;
281
354
  const minFreeGb = workflows.minFreeGb;
282
- const lanes = testing.shipGate;
355
+ const lanes = testing.ciRequired;
283
356
  const book = testing.minPushPaths;
284
357
  const provider = opencode.default;
285
358
  const providers = opencode.installed;
@@ -321,11 +394,12 @@ export function readBkitConfig(root: string): BkitConfig {
321
394
  project: optionalString(jira.project),
322
395
  ...trackerStates(jira, CONFIG_DEFAULTS.jira),
323
396
  },
324
- shipGateRequiredLanes: Array.isArray(lanes) ? lanes.filter(nonEmptyString) : [],
325
- // An explicit [] is kept: it switches the min push off.
397
+ ciRequired: Array.isArray(lanes) ? lanes.filter(nonEmptyString) : [],
326
398
  minPushPaths: Array.isArray(book)
327
399
  ? book.filter(nonEmptyString)
328
400
  : [...CONFIG_DEFAULTS.minPushPaths],
401
+ ciSkipPaths: Array.isArray(ciSkip) ? ciSkip.filter(nonEmptyString) : [],
402
+ ciGenerated: Array.isArray(generated) ? generated.filter(nonEmptyString) : [],
329
403
  opencodeProvider:
330
404
  typeof provider === "string" && isOpencodeProvider(provider) ? provider : null,
331
405
  opencodeProviders: Array.isArray(providers)
@@ -336,7 +410,8 @@ export function readBkitConfig(root: string): BkitConfig {
336
410
  cloudAgents: parseCloudAgents(cloud.agent) ?? CONFIG_DEFAULTS.cloudAgents,
337
411
  asks: askSettings(workflows),
338
412
  tasks: taskCaps(workflows.tasks),
339
- depUpdaterOptOut: record(bkit.dependencies).updater === "none",
413
+ buildPublish: buildPublish(record(workflows.build).publish),
414
+ depUpdater: parseDepUpdater(record(bkit.dependencies).updater),
340
415
  issueTrackerExplicit: tracker.default !== undefined && tracker.default !== "",
341
416
  cloudAgentsExplicit: cloud.agent !== undefined && cloud.agent !== "",
342
417
  };
@@ -24,4 +24,6 @@ export const TIMEOUTS = {
24
24
  BKIT_LATEST_RETRY_S: 3600,
25
25
  /** Seconds the registry lookup may take before it counts as failed. */
26
26
  BKIT_LATEST_LOOKUP_TIMEOUT_S: 5,
27
+ /** Seconds `worktrees setup` waits for a running disk sweep before refusing; under one agent shell call. */
28
+ DISK_SETUP_SWEEP_WAIT_S: 60,
27
29
  } as const;
@@ -0,0 +1,111 @@
1
+ // tools/cli-doc.ts — check and sync the generated region of `.bkit/cli.md`.
2
+ //
3
+ // The region lists every `bkit <verb>` (`cli.ts` `CLASSIC_VERB_HELP`) and every
4
+ // `bkit <noun> <verb>` (`commands/registry.ts`), rendered from the same specs `--help`
5
+ // prints. Check mode runs in the test suite (`tools/cli-doc.test.ts`); write mode is
6
+ // `pnpm cli:sync`. Text outside the region is hand-written and kept as is.
7
+
8
+ import * as fs from "node:fs";
9
+ import * as path from "node:path";
10
+ import { fileURLToPath } from "node:url";
11
+
12
+ import { CLASSIC_VERB_HELP } from "../cli.js";
13
+ import type { CommandSpec, FlagSpec } from "../commands/lib.js";
14
+ import { COMMANDS } from "../commands/registry.js";
15
+
16
+ export const DOC_PATH = path.join(".bkit", "core", ".bkit", "cli.md");
17
+ export const REGION_START = "<!-- cli:start -->";
18
+ export const REGION_END = "<!-- cli:end -->";
19
+
20
+ export const USE_LABEL = { "by-hand": "by hand", workflow: "workflow" } as const;
21
+
22
+ /** A markdown table cell: pipes escaped, newlines flattened, `—` when empty. */
23
+ const cell = (text: string) => text.replace(/\|/g, "\\|").replace(/\s*\n\s*/g, " ") || "—";
24
+
25
+ const flagCell = (flags: readonly FlagSpec[]) =>
26
+ flags.map((f) => (f.required ? `**\`--${f.name}\`**` : `\`--${f.name}\``)).join(" ");
27
+
28
+ function table(head: string[], rows: string[][]): string[] {
29
+ return [
30
+ "<!-- prettier-ignore -->",
31
+ `| ${head.join(" | ")} |`,
32
+ `| ${head.map(() => "---").join(" | ")} |`,
33
+ ...rows.map((r) => `| ${r.join(" | ")} |`),
34
+ ];
35
+ }
36
+
37
+ function nounSection(cmd: CommandSpec): string[] {
38
+ const rows = Object.entries(cmd.verbs).map(([verb, spec]) => [
39
+ `\`${verb}\``,
40
+ USE_LABEL[spec.use],
41
+ cell(flagCell(spec.flags)),
42
+ cell(spec.summary),
43
+ ]);
44
+ return [
45
+ `### \`${cmd.noun}\``,
46
+ "",
47
+ cell(cmd.summary),
48
+ "",
49
+ ...table(["Verb", "Use", "Flags", "What it does"], rows),
50
+ "",
51
+ ];
52
+ }
53
+
54
+ /** The generated region, markers included. */
55
+ export function renderRegion(): string {
56
+ const classic = CLASSIC_VERB_HELP.map(({ verb, args, flags, summary }) => [
57
+ `\`${["bkit", verb, ...args.split(" ").filter((w) => /^[a-z]/.test(w))].join(" ")}\``,
58
+ cell(flags.map((f) => `\`${f}\``).join(" ")),
59
+ cell(summary),
60
+ ]);
61
+ const nouns = [...COMMANDS].sort((a, b) => a.noun.localeCompare(b.noun));
62
+ return [
63
+ REGION_START,
64
+ "",
65
+ "## Commands you run",
66
+ "",
67
+ ...table(["Command", "Flags", "What it does"], classic),
68
+ "",
69
+ "## Workflow commands",
70
+ "",
71
+ "Use: `by hand` = safe and useful outside a workflow run; `workflow` = a workflow step only (writes run state, takes locks, commits, pushes or posts). **Bold** flag = required.",
72
+ "",
73
+ ...nouns.flatMap(nounSection),
74
+ REGION_END,
75
+ ].join("\n");
76
+ }
77
+
78
+ /** Offset of `marker` standing alone on a line, else -1 (prose may quote the marker inline). */
79
+ function markerLine(text: string, marker: string): number {
80
+ return new RegExp(`^${marker}$`, "m").exec(text)?.index ?? -1;
81
+ }
82
+
83
+ /** `text` with its generated region replaced by `renderRegion()`; throws when the markers are missing. */
84
+ export function syncDoc(text: string): string {
85
+ const start = markerLine(text, REGION_START);
86
+ const end = markerLine(text, REGION_END);
87
+ if (start < 0 || end < start) {
88
+ throw new Error(`${DOC_PATH}: missing ${REGION_START} / ${REGION_END}`);
89
+ }
90
+ return text.slice(0, start) + renderRegion() + text.slice(end + REGION_END.length);
91
+ }
92
+
93
+ function main(argv: string[]): number {
94
+ const file = path.join(process.cwd(), DOC_PATH);
95
+ const text = fs.readFileSync(file, "utf-8");
96
+ const synced = syncDoc(text);
97
+ if (synced === text) return 0;
98
+ if (argv.includes("--write")) {
99
+ fs.writeFileSync(file, synced, "utf-8");
100
+ console.error(`[bkit-cli] rewrote ${DOC_PATH}`);
101
+ return 0;
102
+ }
103
+ console.error(`[bkit-cli] ${DOC_PATH}: generated region stale (run pnpm cli:sync)`);
104
+ return 1;
105
+ }
106
+
107
+ if (process.argv[1] && fs.existsSync(process.argv[1])) {
108
+ if (fs.realpathSync(fileURLToPath(import.meta.url)) === fs.realpathSync(process.argv[1])) {
109
+ process.exitCode = main(process.argv.slice(2));
110
+ }
111
+ }
@@ -1,6 +1,6 @@
1
1
  // tools/grammar-density.ts — articles (`a`, `an`, `the`) per 1,000 words of agent text.
2
2
  //
3
- // The measure behind `.bkit/core/.bkit/authoring.md` § Notation, Grammar: clipped text
3
+ // The measure behind `.bkit/core/.bkit/authoring.md` § All Agent-Read Files, Plain, complete sentences: clipped text
4
4
  // drops articles, plain English keeps them. `pnpm grammar:density` prints one row per
5
5
  // group for the working tree, `--rev=<rev>` for a past commit, and `--diff=<base>..<head>`
6
6
  // for only the lines `<head>` added. Repo-only tooling, like `tools/instructions.ts`.