@cbartens/bkit 5.5.1 → 6.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (425) hide show
  1. package/.bkit/README.md +167 -154
  2. package/.bkit/core/.agents/context.md +95 -29
  3. package/.bkit/core/.agents/docs.md +18 -15
  4. package/.bkit/core/.agents/plugins/bkit/hooks/bkit-gateguard.cjs +1 -0
  5. package/.bkit/core/.agents/plugins/bkit/hooks/bkit-guardrails.cjs +6 -5
  6. package/.bkit/core/.agents/plugins/bkit/hooks/bkit-readguard.cjs +1 -0
  7. package/.bkit/core/.agents/plugins/bkit/hooks/bkit-rules.cjs +65 -0
  8. package/.bkit/core/.agents/rules.md +112 -102
  9. package/.bkit/core/.agents/skills.md +63 -15
  10. package/.bkit/core/.bkit/README.md +167 -154
  11. package/.bkit/core/.bkit/authoring.md +747 -0
  12. package/.bkit/core/.bkit/cli.md +407 -0
  13. package/.bkit/core/.bkit/cloud.md +283 -195
  14. package/.bkit/core/.bkit/comparison.md +45 -43
  15. package/.bkit/core/.bkit/install.md +166 -95
  16. package/.bkit/core/.bkit/jsonl.md +339 -196
  17. package/.bkit/core/.bkit/pipeline.md +142 -145
  18. package/.bkit/core/.bkit/prompts.md +295 -264
  19. package/.bkit/core/.bkit/providers.md +460 -277
  20. package/.bkit/core/.bkit/router.md +69 -0
  21. package/.bkit/core/.bkit/templates.md +530 -256
  22. package/.bkit/core/.bkit/trackers.md +116 -65
  23. package/.bkit/core/.bkit/workflows.md +742 -618
  24. package/.bkit/core/.claude/hooks/bkit-gateguard.cjs +2 -2
  25. package/.bkit/core/.claude/hooks/bkit-guardrails.cjs +3 -3
  26. package/.bkit/core/.claude/hooks/bkit-preflight.sh +45 -14
  27. package/.bkit/core/.codex/hooks/bkit-guardrails.cjs +3 -3
  28. package/.bkit/core/.codex/hooks/bkit-rules.cjs +57 -0
  29. package/.bkit/core/.cursor/hooks/bkit-guardrails.cjs +7 -7
  30. package/.bkit/core/.cursor/hooks/bkit-preflight.sh +47 -12
  31. package/.bkit/core/.opencode/plugin/bkit-rules.js +89 -0
  32. package/.bkit/core/AGENTS.md +6 -80
  33. package/.bkit/core/docs/templates/bkit-audit-accessibility.md +128 -130
  34. package/.bkit/core/docs/templates/bkit-audit-adoption.md +104 -94
  35. package/.bkit/core/docs/templates/bkit-audit-agents.md +96 -98
  36. package/.bkit/core/docs/templates/bkit-audit-aio-seo.md +100 -103
  37. package/.bkit/core/docs/templates/bkit-audit-analytics.md +141 -107
  38. package/.bkit/core/docs/templates/bkit-audit-annotations.md +99 -97
  39. package/.bkit/core/docs/templates/bkit-audit-app-performance.md +122 -121
  40. package/.bkit/core/docs/templates/bkit-audit-app-store.md +158 -101
  41. package/.bkit/core/docs/templates/bkit-audit-architecture.md +114 -96
  42. package/.bkit/core/docs/templates/bkit-audit-ci-performance.md +76 -97
  43. package/.bkit/core/docs/templates/bkit-audit-config.md +123 -101
  44. package/.bkit/core/docs/templates/bkit-audit-cost.md +86 -99
  45. package/.bkit/core/docs/templates/bkit-audit-coverage.md +76 -93
  46. package/.bkit/core/docs/templates/bkit-audit-database.md +102 -95
  47. package/.bkit/core/docs/templates/bkit-audit-dead-code.md +165 -108
  48. package/.bkit/core/docs/templates/bkit-audit-deferrals.md +115 -109
  49. package/.bkit/core/docs/templates/bkit-audit-dependencies.md +265 -113
  50. package/.bkit/core/docs/templates/bkit-audit-documentation.md +119 -118
  51. package/.bkit/core/docs/templates/bkit-audit-duplication.md +140 -111
  52. package/.bkit/core/docs/templates/bkit-audit-failures.md +111 -106
  53. package/.bkit/core/docs/templates/bkit-audit-flakes.md +100 -99
  54. package/.bkit/core/docs/templates/bkit-audit-gates.md +107 -103
  55. package/.bkit/core/docs/templates/bkit-audit-issues.md +105 -105
  56. package/.bkit/core/docs/templates/bkit-audit-llm.md +134 -85
  57. package/.bkit/core/docs/templates/bkit-audit-logs.md +124 -125
  58. package/.bkit/core/docs/templates/bkit-audit-models.md +99 -78
  59. package/.bkit/core/docs/templates/bkit-audit-privacy.md +56 -76
  60. package/.bkit/core/docs/templates/bkit-audit-prompts.md +63 -78
  61. package/.bkit/core/docs/templates/bkit-audit-red-team.md +125 -93
  62. package/.bkit/core/docs/templates/bkit-audit-reliability.md +97 -96
  63. package/.bkit/core/docs/templates/bkit-audit-repo.md +170 -98
  64. package/.bkit/core/docs/templates/bkit-audit-security.md +207 -121
  65. package/.bkit/core/docs/templates/bkit-audit-slop.md +78 -95
  66. package/.bkit/core/docs/templates/bkit-audit-testing.md +163 -139
  67. package/.bkit/core/docs/templates/bkit-audit-usability.md +114 -96
  68. package/.bkit/core/docs/templates/bkit-plan.md +158 -281
  69. package/.bkit/core/engine/checks/after/auth.ts +40 -37
  70. package/.bkit/core/engine/checks/after/ci-yml.ts +104 -31
  71. package/.bkit/core/engine/checks/after/github.ts +95 -17
  72. package/.bkit/core/engine/checks/after/index.ts +21 -8
  73. package/.bkit/core/engine/checks/after/suppression.ts +8 -5
  74. package/.bkit/core/engine/checks/after/tools.ts +125 -123
  75. package/.bkit/core/engine/checks/before/context-fetch.ts +227 -33
  76. package/.bkit/core/engine/checks/before/env.ts +3 -3
  77. package/.bkit/core/engine/checks/before/files.ts +5 -4
  78. package/.bkit/core/engine/checks/before/index.ts +25 -1
  79. package/.bkit/core/engine/checks/before/repo.ts +208 -2
  80. package/.bkit/core/engine/checks/status-holes.ts +916 -123
  81. package/.bkit/core/engine/checks/tips/catalogue.ts +82 -20
  82. package/.bkit/core/engine/checks/tips/detect.ts +66 -0
  83. package/.bkit/core/engine/checks/tips/index.ts +52 -11
  84. package/.bkit/core/engine/cli.ts +251 -130
  85. package/.bkit/core/engine/commands/analysis.ts +282 -199
  86. package/.bkit/core/engine/commands/ci/ci.ts +363 -29
  87. package/.bkit/core/engine/commands/ci/pins.ts +172 -0
  88. package/.bkit/core/engine/commands/ci/push-gate.ts +223 -0
  89. package/.bkit/core/engine/commands/comply.ts +77 -103
  90. package/.bkit/core/engine/commands/install/doctor.ts +2 -2
  91. package/.bkit/core/engine/commands/install/install.ts +57 -18
  92. package/.bkit/core/engine/commands/install/uninstall.ts +86 -55
  93. package/.bkit/core/engine/commands/install/upgrade.ts +32 -15
  94. package/.bkit/core/engine/commands/land.ts +139 -18
  95. package/.bkit/core/engine/commands/lib.ts +381 -22
  96. package/.bkit/core/engine/commands/registry.ts +10 -2
  97. package/.bkit/core/engine/commands/setup/setup.ts +8 -7
  98. package/.bkit/core/engine/commands/stats.ts +260 -0
  99. package/.bkit/core/engine/commands/tips.ts +10 -5
  100. package/.bkit/core/engine/commands/workflow/branches.ts +2215 -176
  101. package/.bkit/core/engine/commands/workflow/challenge.ts +748 -0
  102. package/.bkit/core/engine/commands/workflow/completeness.ts +109 -0
  103. package/.bkit/core/engine/commands/workflow/context.ts +1249 -47
  104. package/.bkit/core/engine/commands/workflow/counters.ts +483 -95
  105. package/.bkit/core/engine/commands/workflow/decisions.ts +585 -0
  106. package/.bkit/core/engine/commands/workflow/disk.ts +238 -56
  107. package/.bkit/core/engine/commands/workflow/fids.ts +811 -33
  108. package/.bkit/core/engine/commands/workflow/issues.ts +413 -64
  109. package/.bkit/core/engine/commands/workflow/ledgers.ts +1333 -36
  110. package/.bkit/core/engine/commands/workflow/locks.ts +28 -2
  111. package/.bkit/core/engine/commands/workflow/plan-blocks.ts +691 -0
  112. package/.bkit/core/engine/commands/workflow/plan-versions.ts +21 -0
  113. package/.bkit/core/engine/commands/workflow/plans.ts +257 -0
  114. package/.bkit/core/engine/commands/workflow/prs.ts +178 -33
  115. package/.bkit/core/engine/commands/workflow/repo.ts +66 -8
  116. package/.bkit/core/engine/commands/workflow/roadmap.ts +72 -22
  117. package/.bkit/core/engine/commands/workflow/run-facts.ts +492 -0
  118. package/.bkit/core/engine/commands/workflow/runs.ts +827 -79
  119. package/.bkit/core/engine/commands/workflow/runtime.ts +25 -1
  120. package/.bkit/core/engine/commands/workflow/skills.ts +1 -0
  121. package/.bkit/core/engine/commands/workflow/status.ts +329 -33
  122. package/.bkit/core/engine/commands/workflow/step-table.ts +381 -0
  123. package/.bkit/core/engine/commands/workflow/steps.ts +841 -105
  124. package/.bkit/core/engine/commands/workflow/summary-findings.ts +177 -0
  125. package/.bkit/core/engine/commands/workflow/summary.ts +544 -0
  126. package/.bkit/core/engine/commands/workflow/tasks.ts +409 -0
  127. package/.bkit/core/engine/commands/workflow/test-blocks.ts +254 -0
  128. package/.bkit/core/engine/commands/workflow/tests-changed.ts +201 -0
  129. package/.bkit/core/engine/commands/workflow/tests.ts +2124 -330
  130. package/.bkit/core/engine/commands/workflow/tracker.ts +1195 -0
  131. package/.bkit/core/engine/commands/workflow/workflows.ts +1197 -235
  132. package/.bkit/core/engine/commands/workflow/worktrees.ts +543 -24
  133. package/.bkit/core/engine/install/cloud-env.ts +251 -121
  134. package/.bkit/core/engine/install/context-ci-workflow.ts +102 -0
  135. package/.bkit/core/engine/install/manifest.ts +67 -17
  136. package/.bkit/core/engine/install/modules/antigravity.ts +3 -2
  137. package/.bkit/core/engine/install/modules/cloud.ts +24 -16
  138. package/.bkit/core/engine/install/modules/codex.ts +15 -2
  139. package/.bkit/core/engine/install/modules/core.ts +1196 -45
  140. package/.bkit/core/engine/install/modules/cursor.ts +6 -6
  141. package/.bkit/core/engine/install/modules/opencode.ts +18 -6
  142. package/.bkit/core/engine/install/template-notes.ts +130 -0
  143. package/.bkit/core/engine/install/version-file.ts +9 -4
  144. package/.bkit/core/engine/install/write.ts +5 -0
  145. package/.bkit/core/engine/ledgers/compact.ts +124 -0
  146. package/.bkit/core/engine/ledgers/journal.ts +291 -0
  147. package/.bkit/core/engine/ledgers/migrate.ts +92 -0
  148. package/.bkit/core/engine/ledgers/status.ts +249 -21
  149. package/.bkit/core/engine/ledgers/telemetry.ts +1397 -253
  150. package/.bkit/core/engine/render/hosts.ts +118 -14
  151. package/.bkit/core/engine/render/models.ts +12 -0
  152. package/.bkit/core/engine/shared/bkit-latest.ts +26 -4
  153. package/.bkit/core/engine/shared/branches.ts +4 -1
  154. package/.bkit/core/engine/shared/dep-updater.ts +60 -0
  155. package/.bkit/core/engine/shared/egress.ts +8 -1
  156. package/.bkit/core/engine/shared/json.ts +25 -7
  157. package/.bkit/core/engine/shared/package-manager.ts +9 -0
  158. package/.bkit/core/engine/shared/settings.ts +243 -31
  159. package/.bkit/core/engine/shared/text.ts +361 -0
  160. package/.bkit/core/engine/shared/timeouts.ts +2 -0
  161. package/.bkit/core/engine/tools/cli-doc.ts +111 -0
  162. package/.bkit/core/engine/tools/grammar-density.ts +215 -0
  163. package/.bkit/core/engine/tools/instructions-sources.ts +832 -0
  164. package/.bkit/core/engine/tools/instructions.ts +1802 -0
  165. package/.bkit/core/hooks/antigravity-hook.js +25 -10
  166. package/.bkit/core/hooks/gateguard-engine.js +54 -29
  167. package/.bkit/core/hooks/guardrails-shell.js +4 -5
  168. package/.bkit/core/hooks/guardrails-tiers.js +10 -4
  169. package/.bkit/core/hooks/preflight-linear.sh +9 -9
  170. package/.bkit/core/hooks/preflight-rules.sh +8 -0
  171. package/.bkit/core/hooks/readguard-engine.js +29 -10
  172. package/.bkit/core/hooks/session-rules-advisory.js +61 -0
  173. package/.bkit/core/prompts/bkit-audit-generate.md +202 -94
  174. package/.bkit/core/prompts/bkit-build-challenge-1.md +76 -34
  175. package/.bkit/core/prompts/bkit-build-challenge-2.md +85 -38
  176. package/.bkit/core/prompts/bkit-build-install-skills.md +50 -28
  177. package/.bkit/core/prompts/bkit-build-plan-convert.md +85 -0
  178. package/.bkit/core/prompts/bkit-build-plan-current.md +59 -36
  179. package/.bkit/core/prompts/bkit-build-plan-gaps-remediate.md +101 -36
  180. package/.bkit/core/prompts/bkit-build-plan-tasks.md +149 -0
  181. package/.bkit/core/prompts/bkit-build-plan-tests.md +120 -0
  182. package/.bkit/core/prompts/bkit-build-plan-verify.md +104 -43
  183. package/.bkit/core/prompts/bkit-debug-abort-handover.md +47 -32
  184. package/.bkit/core/prompts/bkit-debug-failure-diagnose.md +109 -57
  185. package/.bkit/core/prompts/bkit-debug-failure-remediate.md +65 -39
  186. package/.bkit/core/prompts/bkit-debug-failure-reproduce.md +53 -31
  187. package/.bkit/core/prompts/bkit-debug-failure-soak.md +65 -34
  188. package/.bkit/core/prompts/bkit-design-brainstorm-ideate-1.md +46 -31
  189. package/.bkit/core/prompts/bkit-design-brainstorm-ideate-2.md +45 -31
  190. package/.bkit/core/prompts/bkit-design-brainstorm-ideate-3.md +43 -30
  191. package/.bkit/core/prompts/bkit-design-generate.md +80 -46
  192. package/.bkit/core/prompts/bkit-design-organise.md +83 -32
  193. package/.bkit/core/prompts/bkit-design-review-1.md +70 -50
  194. package/.bkit/core/prompts/bkit-design-review-2.md +65 -46
  195. package/.bkit/core/prompts/bkit-design-spike.md +64 -40
  196. package/.bkit/core/prompts/bkit-design-update.md +53 -28
  197. package/.bkit/core/prompts/bkit-plan-generate.md +101 -29
  198. package/.bkit/core/prompts/bkit-plan-review-1.md +78 -41
  199. package/.bkit/core/prompts/bkit-plan-review-2.md +78 -35
  200. package/.bkit/core/prompts/bkit-plan-scope-check.md +116 -0
  201. package/.bkit/core/prompts/bkit-plan-update.md +86 -31
  202. package/.bkit/core/prompts/bkit-ship-conflict-resolve.md +94 -50
  203. package/.bkit/core/prompts/bkit-ship-deferred-sweep.md +91 -41
  204. package/.bkit/core/prompts/bkit-ship-update-docs.md +45 -24
  205. package/.bkit/core/prompts/bkit-utility-compress-markdown.md +65 -49
  206. package/.bkit/core/prompts/bkit-utility-update-decisions.md +87 -42
  207. package/.bkit/core/prompts/bkit-utility-update-deferrals.md +81 -37
  208. package/.bkit/core/prompts/bkit-utility-update-documentation.md +43 -25
  209. package/.bkit/core/prompts/bkit-utility-update-failures.md +84 -37
  210. package/.bkit/core/prompts/bkit-utility-update-knowledge.md +88 -42
  211. package/.bkit/core/prompts/bkit-utility-update-roadmap.md +92 -39
  212. package/.bkit/core/prompts/bkit-utility-update-tracker.md +159 -60
  213. package/.bkit/core/workflows/bkit-auto.md +89 -58
  214. package/.bkit/core/workflows/bkit-build.md +967 -517
  215. package/.bkit/core/workflows/bkit-debug.md +555 -387
  216. package/.bkit/core/workflows/bkit-design.md +319 -283
  217. package/.bkit/core/workflows/bkit-plan.md +319 -342
  218. package/.bkit/core/workflows/bkit-ship.md +525 -328
  219. package/.bkit/shared/.agents/plugins/bkit/hooks.json +10 -0
  220. package/.bkit/shared/.bkit/.env.example +2 -2
  221. package/.bkit/shared/.claude/bkit-cloud.md +12 -10
  222. package/.bkit/shared/.claude/settings.json +14 -0
  223. package/.bkit/shared/.codex/bkit-cloud.md +98 -0
  224. package/.bkit/shared/.codex/hooks.json +20 -0
  225. package/.bkit/shared/.cursor/bkit-cloud.md +3 -3
  226. package/.bkit/shared/.cursor/mcp.json +1 -1
  227. package/.bkit/shared/.cursor/rules/bkit-rules.mdc +1 -1
  228. package/.bkit/shared/.gitattributes +1 -1
  229. package/.bkit/shared/.mcp.json +1 -1
  230. package/.bkit/shared/.opencode/opencode.json +12 -1
  231. package/.bkit/shared/CLAUDE.md +6 -2
  232. package/.bkit/shared/GEMINI.md +5 -2
  233. package/.bkit/shared/docs/architecture.md +4 -7
  234. package/.bkit/shared/docs/data-schema.md +4 -7
  235. package/.bkit/shared/docs/deployments.md +241 -168
  236. package/.bkit/shared/docs/design.md +11 -12
  237. package/.bkit/shared/docs/noise.md +8 -7
  238. package/.bkit/shared/docs/observability.md +5 -8
  239. package/.bkit/shared/docs/security.md +35 -17
  240. package/.bkit/shared/docs/setup.md +29 -18
  241. package/.bkit/shared/docs/technology.md +3 -6
  242. package/.bkit/shared/docs/testing.md +289 -174
  243. package/.bkit/shared/gitignore +6 -2
  244. package/.bkit/templates/.claude/hooks/bkit-cloud-bootstrap.sh +15 -16
  245. package/.bkit/templates/.cursor/Dockerfile +12 -8
  246. package/.bkit/templates/.cursor/environment.json +1 -1
  247. package/.bkit/templates/.github/ISSUE_TEMPLATE/bkit-bug.yml +10 -8
  248. package/.bkit/templates/.github/ISSUE_TEMPLATE/bkit-change.yml +45 -12
  249. package/.bkit/templates/.github/ISSUE_TEMPLATE/bkit-idea.yml +3 -3
  250. package/.bkit/templates/.github/renovate.json5 +34 -6
  251. package/.bkit/templates/.github/workflows/bkit-ci.yml +54 -51
  252. package/.bkit/templates/.github/workflows/bkit-cloud.yml +34 -33
  253. package/.bkit/templates/.github/workflows/bkit-health.yml +97 -0
  254. package/.bkit/templates/.github/workflows/bkit-renovate.yml +5 -4
  255. package/.bkit/templates/.github/workflows/bkit-trivy.yml +5 -4
  256. package/.bkit/templates/.husky/pre-commit +2 -2
  257. package/.bkit/templates/.husky/pre-push +96 -36
  258. package/.bkit/templates/.prettierignore +6 -0
  259. package/.bkit/templates/.vale.ini +27 -27
  260. package/.bkit/templates/context/bkit-cloudrun.md +23 -15
  261. package/.bkit/templates/context/bkit-expo.md +70 -52
  262. package/.bkit/templates/context/bkit-github.md +93 -56
  263. package/.bkit/templates/context/bkit-inngest.md +21 -15
  264. package/.bkit/templates/context/bkit-maestro.md +22 -16
  265. package/.bkit/templates/context/bkit-playwright.md +23 -17
  266. package/.bkit/templates/context/bkit-resend.md +12 -10
  267. package/.bkit/templates/context/bkit-sentry.md +30 -20
  268. package/.bkit/templates/context/bkit-serena.md +8 -7
  269. package/.bkit/templates/context/bkit-stripe.md +14 -13
  270. package/.bkit/templates/context/bkit-supabase.md +16 -13
  271. package/.bkit/templates/context/bkit-tavily.md +14 -11
  272. package/.bkit/templates/context/bkit-vercel.md +27 -18
  273. package/.bkit/templates/docs/capabilities.md +15 -14
  274. package/.bkit/templates/scripts/ci/{check-accepted-divergences.mjs → bkit-check-accepted-divergences.mjs} +6 -3
  275. package/.bkit/templates/scripts/ci/{check-accepted-divergences.test.mjs → bkit-check-accepted-divergences.test.mjs} +3 -3
  276. package/.bkit/templates/scripts/ci/{check-capstone.mjs → bkit-check-capstone.mjs} +2 -2
  277. package/.bkit/templates/scripts/ci/{check-capstone.test.mjs → bkit-check-capstone.test.mjs} +4 -4
  278. package/.bkit/templates/scripts/ci/{check-dependency-audit.mjs → bkit-check-dependency-audit.mjs} +103 -18
  279. package/.bkit/templates/scripts/ci/{check-dependency-audit.test.mjs → bkit-check-dependency-audit.test.mjs} +31 -3
  280. package/.bkit/templates/scripts/ci/bkit-machine-lock.sh +387 -0
  281. package/.bkit/templates/scripts/ci/bkit-test-awake.mjs +75 -0
  282. package/.bkit/templates/scripts/ci/bkit-test-awake.test.mjs +160 -0
  283. package/.bkit/templates/scripts/ci/lanes/{resolve-push-base.mjs → bkit-resolve-push-base.mjs} +3 -3
  284. package/.bkit/templates/scripts/ci/lanes/{resolve-push-base.test.mjs → bkit-resolve-push-base.test.mjs} +4 -4
  285. package/.bkit/templates/scripts/cleanup/bkit-disk-prune.mjs +10 -2
  286. package/.bkit/templates/scripts/graphify/bkit-graph-drift.py +1 -1
  287. package/.bkit/templates/scripts/graphify/bkit-graph-eager.py +3 -3
  288. package/.bkit/templates/scripts/graphify/bkit-graph-embed.py +63 -0
  289. package/.bkit/templates/scripts/graphify/bkit-graph-imports.py +2 -2
  290. package/.bkit/templates/scripts/graphify/bkit-graph-pre-push.sh +69 -18
  291. package/.bkit/templates/scripts/graphify/bkit-graph-repair.py +3 -3
  292. package/.bkit/templates/scripts/graphify/bkit-graph-surface.py +1 -1
  293. package/.bkit/templates/scripts/graphify/bkit-graphify-graphml.py +1 -1
  294. package/.bkit/templates/scripts/graphify/bkit-graphify-rollup.py +197 -126
  295. package/.bkit/templates/scripts/graphify/bkit-graphify.sh +64 -41
  296. package/.bkit/templates/scripts/slop/bkit-slop-type-suppression.mjs +23 -7
  297. package/.bkit/templates/slop-scan.config.json +9 -2
  298. package/CHANGELOG.md +231 -0
  299. package/README.md +278 -89
  300. package/dist/checks/after/auth.js +36 -33
  301. package/dist/checks/after/ci-yml.js +91 -30
  302. package/dist/checks/after/github.js +91 -17
  303. package/dist/checks/after/index.js +22 -11
  304. package/dist/checks/after/suppression.js +8 -5
  305. package/dist/checks/after/tools.js +111 -114
  306. package/dist/checks/before/context-fetch.js +218 -33
  307. package/dist/checks/before/env.js +3 -3
  308. package/dist/checks/before/files.js +5 -3
  309. package/dist/checks/before/index.js +20 -3
  310. package/dist/checks/before/repo.js +197 -2
  311. package/dist/checks/status-holes.js +739 -114
  312. package/dist/checks/tips/catalogue.js +70 -19
  313. package/dist/checks/tips/detect.js +62 -0
  314. package/dist/checks/tips/index.js +51 -9
  315. package/dist/cli.js +234 -124
  316. package/dist/commands/analysis.js +174 -141
  317. package/dist/commands/ci/ci.js +302 -25
  318. package/dist/commands/ci/pins.js +142 -0
  319. package/dist/commands/ci/push-gate.js +194 -0
  320. package/dist/commands/comply.js +54 -91
  321. package/dist/commands/install/doctor.js +2 -2
  322. package/dist/commands/install/install.js +50 -19
  323. package/dist/commands/install/uninstall.js +82 -55
  324. package/dist/commands/install/upgrade.js +21 -11
  325. package/dist/commands/land.js +137 -17
  326. package/dist/commands/lib.js +295 -21
  327. package/dist/commands/registry.js +10 -2
  328. package/dist/commands/setup/setup.js +8 -7
  329. package/dist/commands/stats.js +175 -0
  330. package/dist/commands/tips.js +7 -3
  331. package/dist/commands/workflow/branches.js +1873 -152
  332. package/dist/commands/workflow/challenge.js +609 -0
  333. package/dist/commands/workflow/completeness.js +97 -0
  334. package/dist/commands/workflow/context.js +1045 -46
  335. package/dist/commands/workflow/counters.js +385 -86
  336. package/dist/commands/workflow/decisions.js +484 -0
  337. package/dist/commands/workflow/disk.js +214 -56
  338. package/dist/commands/workflow/fids.js +706 -33
  339. package/dist/commands/workflow/issues.js +349 -59
  340. package/dist/commands/workflow/ledgers.js +1123 -37
  341. package/dist/commands/workflow/locks.js +26 -2
  342. package/dist/commands/workflow/plan-blocks.js +501 -0
  343. package/dist/commands/workflow/plan-versions.js +22 -0
  344. package/dist/commands/workflow/plans.js +205 -0
  345. package/dist/commands/workflow/prs.js +154 -35
  346. package/dist/commands/workflow/repo.js +58 -8
  347. package/dist/commands/workflow/roadmap.js +58 -23
  348. package/dist/commands/workflow/run-facts.js +421 -0
  349. package/dist/commands/workflow/runs.js +670 -72
  350. package/dist/commands/workflow/runtime.js +15 -1
  351. package/dist/commands/workflow/skills.js +1 -0
  352. package/dist/commands/workflow/status.js +282 -34
  353. package/dist/commands/workflow/step-table.js +308 -0
  354. package/dist/commands/workflow/steps.js +703 -96
  355. package/dist/commands/workflow/summary-findings.js +117 -0
  356. package/dist/commands/workflow/summary.js +388 -0
  357. package/dist/commands/workflow/tasks.js +378 -0
  358. package/dist/commands/workflow/test-blocks.js +231 -0
  359. package/dist/commands/workflow/tests-changed.js +172 -0
  360. package/dist/commands/workflow/tests.js +1695 -305
  361. package/dist/commands/workflow/tracker.js +983 -0
  362. package/dist/commands/workflow/workflows.js +1014 -222
  363. package/dist/commands/workflow/worktrees.js +432 -26
  364. package/dist/install/cloud-env.js +233 -99
  365. package/dist/install/context-ci-workflow.js +85 -0
  366. package/dist/install/manifest.js +64 -17
  367. package/dist/install/modules/antigravity.js +3 -2
  368. package/dist/install/modules/cloud.js +25 -16
  369. package/dist/install/modules/codex.js +12 -2
  370. package/dist/install/modules/core.js +1090 -48
  371. package/dist/install/modules/cursor.js +6 -6
  372. package/dist/install/modules/opencode.js +13 -7
  373. package/dist/install/template-notes.js +116 -0
  374. package/dist/install/version-file.js +9 -4
  375. package/dist/ledgers/compact.js +87 -0
  376. package/dist/ledgers/journal.js +233 -0
  377. package/dist/ledgers/migrate.js +81 -0
  378. package/dist/ledgers/status.js +176 -13
  379. package/dist/ledgers/telemetry.js +1010 -125
  380. package/dist/render/hosts.js +104 -14
  381. package/dist/render/models.js +12 -0
  382. package/dist/shared/bkit-latest.js +26 -4
  383. package/dist/shared/branches.js +3 -1
  384. package/dist/shared/dep-updater.js +49 -0
  385. package/dist/shared/egress.js +8 -1
  386. package/dist/shared/json.js +20 -7
  387. package/dist/shared/package-manager.js +6 -0
  388. package/dist/shared/settings.js +181 -24
  389. package/dist/shared/text.js +333 -0
  390. package/dist/shared/timeouts.js +2 -0
  391. package/dist/tools/cli-doc.js +97 -0
  392. package/dist/tools/grammar-density.js +183 -0
  393. package/dist/tools/instructions-sources.js +720 -0
  394. package/dist/tools/instructions.js +1623 -0
  395. package/package.json +156 -51
  396. package/.bkit/core/.bkit/lite.md +0 -73
  397. package/.bkit/core/engine/commands/harvest.ts +0 -459
  398. package/.bkit/core/engine/commands/workflow/workstreams.ts +0 -166
  399. package/.bkit/core/engine/tools/wording.ts +0 -748
  400. package/.bkit/core/prompts/bkit-build-challenge-reconcile.md +0 -69
  401. package/.bkit/core/prompts/bkit-build-challenge-remediate.md +0 -71
  402. package/.bkit/core/prompts/bkit-build-challenge-tests.md +0 -74
  403. package/.bkit/core/prompts/bkit-build-plan-execute.md +0 -76
  404. package/.bkit/core/prompts/bkit-build-summary.md +0 -94
  405. package/.bkit/core/prompts/bkit-debug-summary.md +0 -96
  406. package/.bkit/core/prompts/bkit-design-summary.md +0 -107
  407. package/.bkit/core/prompts/bkit-plan-complexity-check.md +0 -67
  408. package/.bkit/core/prompts/bkit-plan-complexity-split.md +0 -88
  409. package/.bkit/core/prompts/bkit-plan-review-3.md +0 -93
  410. package/.bkit/core/prompts/bkit-plan-scope-check-1.md +0 -85
  411. package/.bkit/core/prompts/bkit-plan-scope-check-2.md +0 -85
  412. package/.bkit/core/prompts/bkit-plan-summary.md +0 -107
  413. package/.bkit/core/prompts/bkit-ship-summary.md +0 -78
  414. package/.bkit/templates/scripts/ci/bkit-local-stack-lock.sh +0 -194
  415. package/dist/commands/harvest.js +0 -353
  416. package/dist/commands/workflow/workstreams.js +0 -143
  417. package/dist/tools/wording.js +0 -680
  418. /package/.bkit/templates/.vale/styles/{House → Bkit}/Filler.yml +0 -0
  419. /package/.bkit/templates/.vale/styles/{House → Bkit}/Hedging.yml +0 -0
  420. /package/.bkit/templates/.vale/styles/{House → Bkit}/LLMSlop.yml +0 -0
  421. /package/.bkit/templates/.vale/styles/{House → Bkit}/Verbose.yml +0 -0
  422. /package/.bkit/templates/scripts/ci/{accepted-advisories.json → bkit-accepted-advisories.json} +0 -0
  423. /package/.bkit/templates/scripts/ci/{accepted-divergences.json → bkit-accepted-divergences.json} +0 -0
  424. /package/.bkit/templates/scripts/launchd/{launchd.env.example → bkit-launchd.env.example} +0 -0
  425. /package/.bkit/templates/scripts/launchd/{ai.bkit.launchd.plist → bkit-launchd.plist} +0 -0
@@ -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,6 +64,50 @@ 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
+
75
+ /** `bkit.workflows.tasks`: the plan caps `tests plan-check` and `challenge merge` enforce. */
76
+ export interface TaskCaps {
77
+ /** Tasks in one task group. */
78
+ maxPerGroup: number;
79
+ /** Planned TEST FIRST tests in one task group. */
80
+ maxTestsPerGroup: number;
81
+ /** TEST FIRST tests one task names. */
82
+ maxTestsPerTask: number;
83
+ /** Distinct test files one task's TEST FIRST names. */
84
+ maxTestFilesPerTask: number;
85
+ }
86
+
87
+ /** Every point a workflow can stop and ask the owner at, as `<workflow>.<point>`. */
88
+ export const ASK_POINTS = [
89
+ "design.grill",
90
+ "build.verify",
91
+ "build.challenge",
92
+ "build.tests",
93
+ "debug.fix",
94
+ "debug.soak",
95
+ "ship.merge",
96
+ ] as const;
97
+ export type AskPoint = (typeof ASK_POINTS)[number];
98
+
99
+ /** One `bkit.workflows.<workflow>.<point>` block. */
100
+ export interface AskSetting {
101
+ /** Stop and ask the owner; false = carry on with the recommendation. Headless never asks. */
102
+ ask: boolean;
103
+ /** The hard limit: `maxTurns` for the grill, `maxAttempts` elsewhere. */
104
+ max: number;
105
+ }
106
+
107
+ /** The limit key a point's block holds. */
108
+ export const limitKey = (point: AskPoint): "maxTurns" | "maxAttempts" =>
109
+ point === "design.grill" ? "maxTurns" : "maxAttempts";
110
+
66
111
  export interface BkitConfig {
67
112
  /** CI workflow file under `.github/workflows/`. */
68
113
  ciWorkflow: string;
@@ -83,26 +128,60 @@ export interface BkitConfig {
83
128
  /** `bkit.jira`. */
84
129
  jira: JiraConfig;
85
130
  /** CI lanes whose `skipped` conclusion refuses a ship merge; empty = the capstone's green decides. */
86
- shipGateRequiredLanes: string[];
131
+ ciRequired: string[];
87
132
  /**
88
- * Globs (`:(glob)` git pathspecs) for paths a push may carry and still run only
89
- * `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.
90
136
  */
91
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[];
92
150
  /** The opencode provider recorded on install; null = absent or not a supported provider. */
93
151
  opencodeProvider: OpencodeProvider | null;
94
152
  /** Every installed opencode provider, supported ones only; empty = none recorded. */
95
153
  opencodeProviders: OpencodeProvider[];
96
154
  /** The post-CI cloud-agent variant; `none` is both the default and the explicit opt-out. */
97
155
  cloudAgents: CloudAgents;
98
- /** `bkit.depUpdater` is `"none"`: silences the missing-dependency-updater advisory. */
99
- depUpdaterOptOut: boolean;
100
- /** `bkit.issueTracker` is present with any value, so `none` is a choice, not an undecided install. */
156
+ /** Per ask point: whether to ask, and its hard limit; each invalid key takes its default. */
157
+ asks: Record<AskPoint, AskSetting>;
158
+ /** Plan caps; each key that is not an integer >= 1 takes its default. */
159
+ tasks: TaskCaps;
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;
164
+ /** `bkit.tracker.default` is set, so `none` is a choice; absent or `""` (what install seeds) = undecided. */
101
165
  issueTrackerExplicit: boolean;
102
- /** `bkit.cloudAgents` is present with any value, so `none` is a choice, not an undecided install. */
166
+ /** `bkit.cloud.agent` is set, so `none` is a choice; absent or `""` (what install seeds) = undecided. */
103
167
  cloudAgentsExplicit: boolean;
104
168
  }
105
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
+
106
185
  export const CONFIG_DEFAULTS: Readonly<BkitConfig> = {
107
186
  ciWorkflow: "bkit-ci.yml",
108
187
  capstoneJob: "bkit-tests-check",
@@ -115,14 +194,29 @@ export const CONFIG_DEFAULTS: Readonly<BkitConfig> = {
115
194
  // `started` is a state type every Linear team has; In Review is a name a default team lacks.
116
195
  linear: { team: null, project: null, progress: "started", review: "In Review" },
117
196
  jira: { site: null, project: null, progress: "In Progress", review: "In Review" },
118
- shipGateRequiredLanes: [],
119
- // What bkit's workflows write: plan / design / build logs and the ledgers. Never
120
- // `docs/**`: a project doc can be a test's input, so a docs edit can red a test.
121
- 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: [],
122
203
  opencodeProvider: null,
123
204
  opencodeProviders: [],
124
205
  cloudAgents: DEFAULT_CLOUD_AGENTS,
125
- depUpdaterOptOut: false,
206
+ // `.bkit/workflows.md` § Ask points.
207
+ asks: {
208
+ "design.grill": { ask: true, max: 6 },
209
+ "build.verify": { ask: true, max: 2 },
210
+ "build.challenge": { ask: true, max: 2 },
211
+ "build.tests": { ask: true, max: 2 },
212
+ "debug.fix": { ask: true, max: 2 },
213
+ "debug.soak": { ask: true, max: 2 },
214
+ "ship.merge": { ask: true, max: 2 },
215
+ },
216
+ // Plan caps, `.bkit/workflows.md` § Test-first.
217
+ tasks: { maxPerGroup: 5, maxTestsPerGroup: 25, maxTestsPerTask: 10, maxTestFilesPerTask: 3 },
218
+ buildPublish: { remote: true, local: true },
219
+ depUpdater: null,
126
220
  issueTrackerExplicit: false,
127
221
  cloudAgentsExplicit: false,
128
222
  };
@@ -142,6 +236,104 @@ function trackerStates(raw: Record<string, unknown>, defaults: TrackerStates): T
142
236
  };
143
237
  }
144
238
 
239
+ const parseDepUpdater = (v: unknown): DepUpdater | "none" | null =>
240
+ v === "none" || DEP_UPDATERS.includes(v as DepUpdater) ? (v as DepUpdater | "none") : null;
241
+
242
+ const TASK_CAP_KEYS = Object.keys(CONFIG_DEFAULTS.tasks) as (keyof TaskCaps)[];
243
+
244
+ const validCap = (v: unknown): v is number => Number.isInteger(v) && (v as number) >= 1;
245
+
246
+ /**
247
+ * The keys of a `bkit.workflows.tasks` value that fall back to their default: each set key
248
+ * that is not an integer >= 1, or `["tasks"]` when the value is set but not an object.
249
+ */
250
+ export function invalidTaskCaps(raw: unknown): string[] {
251
+ if (raw === undefined) return [];
252
+ if (raw === null || typeof raw !== "object" || Array.isArray(raw)) return ["tasks"];
253
+ const set = raw as Record<string, unknown>;
254
+ return TASK_CAP_KEYS.filter((k) => set[k] !== undefined && !validCap(set[k]));
255
+ }
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
+
283
+ /** `bkit.workflows.tasks` read key by key; a missing or invalid key takes its default. */
284
+ function taskCaps(raw: unknown): TaskCaps {
285
+ const set = record(raw);
286
+ const caps = { ...CONFIG_DEFAULTS.tasks };
287
+ for (const k of TASK_CAP_KEYS) if (validCap(set[k])) caps[k] = set[k];
288
+ return caps;
289
+ }
290
+
291
+ /** The `bkit.workflows.<workflow>.<point>` block `workflows` holds for `point`. */
292
+ const askBlock = (workflows: Record<string, unknown>, point: AskPoint): unknown => {
293
+ const [workflow, name] = point.split(".") as [string, string];
294
+ const block = workflows[workflow];
295
+ return block !== null && typeof block === "object" && !Array.isArray(block)
296
+ ? (block as Record<string, unknown>)[name]
297
+ : undefined;
298
+ };
299
+
300
+ /**
301
+ * The dotted keys under `bkit.workflows` that fall back to their default: each set `ask`
302
+ * that is not a boolean, each set limit that is not an integer >= 1, or the point itself
303
+ * when it is set but not an object.
304
+ */
305
+ export function invalidAskSettings(workflows: unknown): string[] {
306
+ const set = record(workflows);
307
+ const bad: string[] = [];
308
+ for (const point of ASK_POINTS) {
309
+ const raw = askBlock(set, point);
310
+ if (raw === undefined) continue;
311
+ if (raw === null || typeof raw !== "object" || Array.isArray(raw)) {
312
+ bad.push(point);
313
+ continue;
314
+ }
315
+ const block = raw as Record<string, unknown>;
316
+ if (block.ask !== undefined && typeof block.ask !== "boolean") bad.push(`${point}.ask`);
317
+ const key = limitKey(point);
318
+ if (block[key] !== undefined && !validCap(block[key])) bad.push(`${point}.${key}`);
319
+ }
320
+ return bad;
321
+ }
322
+
323
+ /** Every ask point read from `bkit.workflows`; a missing or invalid key takes its default. */
324
+ function askSettings(workflows: Record<string, unknown>): Record<AskPoint, AskSetting> {
325
+ const out = {} as Record<AskPoint, AskSetting>;
326
+ for (const point of ASK_POINTS) {
327
+ const block = record(askBlock(workflows, point));
328
+ const limit = block[limitKey(point)];
329
+ out[point] = {
330
+ ask: typeof block.ask === "boolean" ? block.ask : CONFIG_DEFAULTS.asks[point].ask,
331
+ max: validCap(limit) ? limit : CONFIG_DEFAULTS.asks[point].max,
332
+ };
333
+ }
334
+ return out;
335
+ }
336
+
145
337
  /**
146
338
  * Read `package.json` `bkit` from `root` (the main checkout). A missing file,
147
339
  * missing key, or wrongly typed value falls back to the default for that key.
@@ -149,21 +341,32 @@ function trackerStates(raw: Record<string, unknown>, defaults: TrackerStates): T
149
341
  export function readBkitConfig(root: string): BkitConfig {
150
342
  // A missing or unparseable package.json takes every default; `bkit check` reports the file.
151
343
  const read = readPackageJson(root);
152
- const bkit = ((read.ok ? read.pkg.bkit : undefined) ?? {}) as Record<string, unknown>;
153
- const worktree = (bkit.worktree ?? {}) as Record<string, unknown>;
344
+ const bkit = record(read.ok ? read.pkg.bkit : undefined);
345
+ const tracker = record(bkit.tracker);
346
+ const cloud = record(bkit.cloud);
347
+ const opencode = record(record(bkit.providers).opencode);
348
+ const testing = record(bkit.testing);
349
+ const workflows = record(bkit.workflows);
350
+ const worktree = record(workflows.worktree);
351
+ const ciSkip = testing.ciSkipPaths;
352
+ const generated = testing.ciGenerated;
154
353
  const copy = worktree.copy;
155
- const minFreeGb = ((bkit.disk ?? {}) as Record<string, unknown>).minFreeGb;
156
- const lanes = bkit.shipGateRequiredLanes;
157
- const book = bkit.minPushPaths;
158
- const provider = bkit.opencodeProvider;
159
- const providers = bkit.opencodeProviders;
160
- const github = record(bkit.github);
161
- const linear = record(bkit.linear);
162
- const jira = record(bkit.jira);
354
+ const minFreeGb = workflows.minFreeGb;
355
+ const lanes = testing.ciRequired;
356
+ const book = testing.minPushPaths;
357
+ const provider = opencode.default;
358
+ const providers = opencode.installed;
359
+ const github = record(tracker.github);
360
+ const linear = record(tracker.linear);
361
+ const jira = record(tracker.jira);
163
362
  const projectUrl = optionalString(github.project);
164
363
  return {
165
- ciWorkflow: nonEmptyString(bkit.ciWorkflow) ? bkit.ciWorkflow : CONFIG_DEFAULTS.ciWorkflow,
166
- capstoneJob: nonEmptyString(bkit.capstoneJob) ? bkit.capstoneJob : CONFIG_DEFAULTS.capstoneJob,
364
+ ciWorkflow: nonEmptyString(testing.ciWorkflow)
365
+ ? testing.ciWorkflow
366
+ : CONFIG_DEFAULTS.ciWorkflow,
367
+ capstoneJob: nonEmptyString(testing.ciCapstone)
368
+ ? testing.ciCapstone
369
+ : CONFIG_DEFAULTS.capstoneJob,
167
370
  worktreeCopy:
168
371
  Array.isArray(copy) && copy.every(nonEmptyString)
169
372
  ? [...copy]
@@ -174,7 +377,7 @@ export function readBkitConfig(root: string): BkitConfig {
174
377
  typeof minFreeGb === "number" && Number.isFinite(minFreeGb) && minFreeGb >= 0
175
378
  ? minFreeGb
176
379
  : CONFIG_DEFAULTS.diskMinFreeGb,
177
- issueTracker: parseIssueTracker(bkit.issueTracker) ?? CONFIG_DEFAULTS.issueTracker,
380
+ issueTracker: parseIssueTracker(tracker.default) ?? CONFIG_DEFAULTS.issueTracker,
178
381
  github: {
179
382
  project:
180
383
  github.project === false ? false : projectUrl ? parseGithubBoardUrl(projectUrl) : null,
@@ -191,11 +394,12 @@ export function readBkitConfig(root: string): BkitConfig {
191
394
  project: optionalString(jira.project),
192
395
  ...trackerStates(jira, CONFIG_DEFAULTS.jira),
193
396
  },
194
- shipGateRequiredLanes: Array.isArray(lanes) ? lanes.filter(nonEmptyString) : [],
195
- // An explicit [] is kept: it switches the min push off.
397
+ ciRequired: Array.isArray(lanes) ? lanes.filter(nonEmptyString) : [],
196
398
  minPushPaths: Array.isArray(book)
197
399
  ? book.filter(nonEmptyString)
198
400
  : [...CONFIG_DEFAULTS.minPushPaths],
401
+ ciSkipPaths: Array.isArray(ciSkip) ? ciSkip.filter(nonEmptyString) : [],
402
+ ciGenerated: Array.isArray(generated) ? generated.filter(nonEmptyString) : [],
199
403
  opencodeProvider:
200
404
  typeof provider === "string" && isOpencodeProvider(provider) ? provider : null,
201
405
  opencodeProviders: Array.isArray(providers)
@@ -203,13 +407,21 @@ export function readBkitConfig(root: string): BkitConfig {
203
407
  (v): v is OpencodeProvider => typeof v === "string" && isOpencodeProvider(v),
204
408
  )
205
409
  : [],
206
- cloudAgents: parseCloudAgents(bkit.cloudAgents) ?? CONFIG_DEFAULTS.cloudAgents,
207
- depUpdaterOptOut: bkit.depUpdater === "none",
208
- issueTrackerExplicit: bkit.issueTracker !== undefined,
209
- cloudAgentsExplicit: bkit.cloudAgents !== undefined,
410
+ cloudAgents: parseCloudAgents(cloud.agent) ?? CONFIG_DEFAULTS.cloudAgents,
411
+ asks: askSettings(workflows),
412
+ tasks: taskCaps(workflows.tasks),
413
+ buildPublish: buildPublish(record(workflows.build).publish),
414
+ depUpdater: parseDepUpdater(record(bkit.dependencies).updater),
415
+ issueTrackerExplicit: tracker.default !== undefined && tracker.default !== "",
416
+ cloudAgentsExplicit: cloud.agent !== undefined && cloud.agent !== "",
210
417
  };
211
418
  }
212
419
 
420
+ /** The CI workflow file `bkit.testing.ciWorkflow` names, as `.github/workflows/<file>` relative to `root`. */
421
+ export function ciWorkflowPath(root: string): string {
422
+ return `.github/workflows/${readBkitConfig(root).ciWorkflow}`;
423
+ }
424
+
213
425
  /** Where the wired tracker's issues live, for the workflows' tracker calls. */
214
426
  export interface TrackerScope {
215
427
  /** Linear team key; null under any other tracker or when unset. */