@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
@@ -647,6 +647,70 @@ export function detectGhaFloatingTags(cwd: string): PreflightFinding | null {
647
647
  };
648
648
  }
649
649
 
650
+ /**
651
+ * CI template copies named without the `bkit-` prefix: unprefixed path → template name, both
652
+ * relative to the repo root.
653
+ */
654
+ const CI_SCRIPT_DIR = "scripts/ci";
655
+ const ciScriptUnit = (...files: string[]): ReadonlyArray<readonly [string, string]> =>
656
+ files.map((file) => {
657
+ const slash = file.lastIndexOf("/");
658
+ const dir = slash === -1 ? "" : file.slice(0, slash + 1);
659
+ return [`${CI_SCRIPT_DIR}/${file}`, `${CI_SCRIPT_DIR}/${dir}bkit-${file.slice(slash + 1)}`];
660
+ });
661
+
662
+ /**
663
+ * The renamed files grouped into units that move together: a script, its test and the
664
+ * data file it reads. `bkit upgrade` moves a unit only whole.
665
+ */
666
+ export const CI_SCRIPT_UNITS: ReadonlyArray<ReadonlyArray<readonly [string, string]>> = [
667
+ ciScriptUnit("check-capstone.mjs", "check-capstone.test.mjs"),
668
+ ciScriptUnit(
669
+ "check-dependency-audit.mjs",
670
+ "check-dependency-audit.test.mjs",
671
+ "accepted-advisories.json",
672
+ ),
673
+ ciScriptUnit(
674
+ "check-accepted-divergences.mjs",
675
+ "check-accepted-divergences.test.mjs",
676
+ "accepted-divergences.json",
677
+ ),
678
+ ciScriptUnit("lanes/resolve-push-base.mjs", "lanes/resolve-push-base.test.mjs"),
679
+ ];
680
+
681
+ export const CI_SCRIPT_RENAMES: ReadonlyArray<readonly [string, string]> = CI_SCRIPT_UNITS.flat();
682
+
683
+ /**
684
+ * Detect CI template copies named without the `bkit-` prefix. They keep working while every
685
+ * reference uses the same old name; the risk is renaming a file without its references — the
686
+ * CI dependency-audit step is guarded by `hashFiles(...)` and silently skips. The copies are the
687
+ * consumer's: `bkit upgrade` moves the unedited ones (`migrateBrandedTemplateFiles`), and this
688
+ * advisory names the ones it leaves (edited, or a `bkit-` target already present); the action
689
+ * inlines the rename and the reference edit.
690
+ */
691
+ export function detectCiScriptsOldNames(cwd: string): PreflightFinding | null {
692
+ const found = CI_SCRIPT_RENAMES.filter(([oldPath]) => fs.existsSync(path.join(cwd, oldPath)));
693
+ if (found.length === 0) return null;
694
+ const moves = found
695
+ .filter(([, newPath]) => !fs.existsSync(path.join(cwd, newPath)))
696
+ .map(([oldPath, newPath]) => ` git mv ${oldPath} ${newPath}`);
697
+ const both = found
698
+ .filter(([, newPath]) => fs.existsSync(path.join(cwd, newPath)))
699
+ .map(([oldPath, newPath]) => ` ${oldPath} (also present: ${newPath})`);
700
+ const pairs = found.map(([oldPath, newPath]) => `${oldPath} → ${newPath}`).join(", ");
701
+ return {
702
+ id: "ci-scripts-old-names",
703
+ severity: "advisory",
704
+ detect: `${found.length} CI template ${found.length === 1 ? "copy uses its" : "copies use their"} old name without the \`bkit-\` prefix: ${found.map(([oldPath]) => `\`${oldPath}\``).join(", ")}. They work while every reference uses the old name too; renaming a file without its references makes the CI dependency-audit step skip silently.`,
705
+ action:
706
+ (moves.length > 0 ? `Rename:\n\n${moves.join("\n")}\n\n` : "") +
707
+ (both.length > 0
708
+ ? `Both names present — move any edits (accepted advisories, registry rows) into the new file, then \`git rm\` the old one:\n\n${both.join("\n")}\n\n`
709
+ : "") +
710
+ `In the same commit, replace each old path with its new one in \`.github/workflows/*.yml\`, \`.husky/pre-push\`, \`package.json\` and the files under \`scripts/ci/\` (the scripts name their JSON files): ${pairs}. Then \`grep -rn -E "(^|[^a-z-])(check-capstone|check-dependency-audit|check-accepted-divergences|accepted-advisories|accepted-divergences|resolve-push-base)(\\.test)?\\.(mjs|json)" .github .husky package.json scripts/ci\` prints nothing.`,
711
+ };
712
+ }
713
+
650
714
  /**
651
715
  * Detect whether the consumer composed a gate on bkit's `Detect Direct Push` step
652
716
  * outputs (`should_force_build` / `should_run_full`). The bkit-ci.yml template ships these
@@ -705,8 +769,7 @@ export function detectRunLevelsNotComposed(cwd: string): PreflightFinding | null
705
769
  action:
706
770
  "`docs/deployments.md` documents bkit's none / partial / full run-level shape — the matrix is documentation-only until you compose at least one consumer-side gate. Examples:\n\n" +
707
771
  " - A deploy job: `if: steps.detect.outputs.should_force_build == 'true' || github.ref == 'refs/heads/main'`\n" +
708
- " - An E2E job: enable the `bkit-stub:e2e` block (which already gates on `should_run_full`).\n" +
709
- " - A smoke workflow: copy the `bkit-stub:smoke` block to `.github/workflows/smoke.yml`.\n\n" +
772
+ " - An E2E job: enable the `bkit-stub:e2e` block (which already gates on `should_run_full`).\n\n" +
710
773
  `If your consumer doesn't need run-level tiers (single-track CI, no preview deploys), dismiss by removing the \`Detect Direct Push\` step from ${ciRel}. Note this also disables \`[force cache]\` / \`[force build]\` / \`[force full]\` tag detection.`,
711
774
  };
712
775
  }
@@ -27,11 +27,13 @@ import {
27
27
  import {
28
28
  buildDepUpdaterSetupAdvisory,
29
29
  detectBkitStubs,
30
+ detectValeMissing,
30
31
  detectValePackageNotSynced,
31
32
  detectWorkflowLintToolsMissing,
32
33
  } from "./tools.js";
33
34
  import {
34
35
  detectBkitCloudYmlAlwaysTrueGate,
36
+ detectCiScriptsOldNames,
35
37
  detectCiYmlCapstoneContractDrift,
36
38
  detectCiYmlMissingActionlint,
37
39
  detectCiYmlRunInjection,
@@ -172,7 +174,7 @@ export function renderAdvisoriesMarkdown(
172
174
  // This is a generated, gitignored artifact — not authored prose. Advisory
173
175
  // strings (and reproduced config snippets like `.vale.ini`'s `write-good.So =
174
176
  // NO`) legitimately contain sentence-initial "So" and slop tokens. The shipped
175
- // `lint:prose` globs on-disk `.agents/*.md`, so without this whole-file Vale
177
+ // `bkit:lint:prose` globs on-disk `.agents/*.md`, so without this whole-file Vale
176
178
  // skip the husky hooks fail on a file the consumer cannot edit.
177
179
  lines.push("<!-- vale off -->");
178
180
  lines.push("");
@@ -362,7 +364,7 @@ export function runPostInstallCheck(
362
364
  const ghMcpToken = detectGhMcpToken(cwd);
363
365
  if (ghMcpToken) phase3.push(ghMcpToken);
364
366
 
365
- // Main branch protection — bkit's PR-base gates (build Step 14, ship Step 2)
367
+ // Main branch protection — bkit's PR-base gates (build Step 16, ship Step 2)
366
368
  // assert feat/* PRs target dev. Enforcing it at the GitHub layer needs branch
367
369
  // protection on main restricting merges to PRs from dev.
368
370
  const protectionStatus = detectMainBranchProtection();
@@ -436,6 +438,10 @@ export function runPostInstallCheck(
436
438
  const cloudGate = detectBkitCloudYmlAlwaysTrueGate(cwd);
437
439
  if (cloudGate) phase3.push(cloudGate);
438
440
 
441
+ // CI template copies named without the `bkit-` prefix.
442
+ const ciScriptNames = detectCiScriptsOldNames(cwd);
443
+ if (ciScriptNames) phase3.push(ciScriptNames);
444
+
439
445
  // Self-installed opencode.yml (/oc handler) drifted from the installed opencode provider —
440
446
  // it hardcodes a model + secret that `bkit install --opencode=` does not rewrite. Not for
441
447
  // claude.yml (its @claude handler is provider-fixed). bkit-cloud.yml self-syncs, so exempt.
@@ -474,6 +480,10 @@ export function runPostInstallCheck(
474
480
  const runLevels = detectRunLevelsNotComposed(cwd);
475
481
  if (runLevels) phase3.push(runLevels);
476
482
 
483
+ // vale missing while bkit:lint:prose runs the prose gate
484
+ const valeMissing = detectValeMissing(cwd);
485
+ if (valeMissing) phase3.push(valeMissing);
486
+
477
487
  // vale not synced
478
488
  const vale = detectValePackageNotSynced(cwd);
479
489
  if (vale) phase3.push(vale);
@@ -5,7 +5,13 @@ import * as fs from "node:fs";
5
5
  import * as path from "node:path";
6
6
  import { spawnSync } from "node:child_process";
7
7
  import type { PreflightFinding } from "../before/index.js";
8
+ import { readPackageJson } from "../../shared/package-json.js";
8
9
  import { ciWorkflowPath, readBkitConfig } from "../../shared/settings.js";
10
+ import {
11
+ DEP_UPDATER_NAMES,
12
+ type DepUpdater,
13
+ findDepUpdaterConfigs,
14
+ } from "../../shared/dep-updater.js";
9
15
 
10
16
  /** True when `cmd --version` runs (binary on PATH, exits 0). */
11
17
  function toolVersionRuns(cmd: string): boolean {
@@ -16,12 +22,37 @@ function toolVersionRuns(cmd: string): boolean {
16
22
  return res.status === 0;
17
23
  }
18
24
 
25
+ /**
26
+ * Detect a prose gate that cannot run here: package.json `bkit:lint:prose` calls `bkit ci prose`,
27
+ * which fails without vale, and vale is not on PATH. Null when the gate is not adopted.
28
+ */
29
+ export function detectValeMissing(cwd: string): PreflightFinding | null {
30
+ const read = readPackageJson(cwd);
31
+ if (!read.ok) return null;
32
+ const scripts = read.pkg["scripts"];
33
+ const lintProse =
34
+ typeof scripts === "object" && scripts !== null
35
+ ? (scripts as Record<string, unknown>)["bkit:lint:prose"]
36
+ : undefined;
37
+ if (typeof lintProse !== "string" || !lintProse.includes("bkit ci prose")) return null;
38
+ if (toolVersionRuns("vale")) return null;
39
+
40
+ return {
41
+ id: "vale-not-installed",
42
+ severity: "advisory",
43
+ detect:
44
+ "package.json `bkit:lint:prose` runs `bkit ci prose`, but vale is not on PATH — the prose gate fails, so every pre-push gate that runs `bkit:lint:prose` fails on this machine.",
45
+ action:
46
+ "Install vale, then download its styles:\n\n brew install vale # macOS; other platforms: https://vale.sh/docs/install\n vale sync\n\nCI and the cloud templates install vale already; this is for local machines.",
47
+ };
48
+ }
49
+
19
50
  /**
20
51
  * Detect whether vale is installed but write-good styles are not synced.
21
- * Returns null if vale is not on PATH (silent skip — not an error).
52
+ * Returns null if vale is not on PATH (`detectValeMissing` covers that case).
22
53
  */
23
54
  export function detectValePackageNotSynced(cwd: string): PreflightFinding | null {
24
- if (!toolVersionRuns("vale")) return null; // vale not on PATH — silent skip
55
+ if (!toolVersionRuns("vale")) return null; // vale not on PATH — detectValeMissing
25
56
 
26
57
  if (fs.existsSync(path.join(cwd, ".vale", "styles", "write-good"))) return null;
27
58
 
@@ -33,7 +64,7 @@ export function detectValePackageNotSynced(cwd: string): PreflightFinding | null
33
64
  detect:
34
65
  "vale is on PATH but the repo has no .vale.ini and .vale/styles/write-good/ is absent — prose linting does not run.",
35
66
  action:
36
- "Adopt bkit's Vale template first: copy .bkit/templates/.vale.ini to .vale.ini and .bkit/templates/.vale/styles/House/*.yml to .vale/styles/House/. Then run `vale sync` (one-time per repo) to download the write-good package the copied .vale.ini names. `vale sync` reads its package list from .vale.ini, so it cannot fetch write-good before that file exists.",
67
+ "Adopt bkit's Vale template first: copy .bkit/templates/.vale.ini to .vale.ini and .bkit/templates/.vale/styles/Bkit/*.yml to .vale/styles/Bkit/. Then run `vale sync` (one-time per repo) to download the write-good package the copied .vale.ini names. `vale sync` reads its package list from .vale.ini, so it cannot fetch write-good before that file exists.",
37
68
  };
38
69
  }
39
70
 
@@ -42,7 +73,7 @@ export function detectValePackageNotSynced(cwd: string): PreflightFinding | null
42
73
  severity: "advisory",
43
74
  detect: "vale is on PATH but .vale/styles/write-good/ is absent — vale packages not synced.",
44
75
  action:
45
- "Run `vale sync` (one-time per repo) to download the write-good package. lint:prose tries to self-heal this (copy from the main worktree, then `vale sync`) and warns loudly on stderr if it cannot — but until the package is present, prose linting does not run.",
76
+ "Run `vale sync` (one-time per repo) to download the write-good package. bkit:lint:prose tries to self-heal this (copy from the main worktree, then `vale sync`) and fails if it cannot.",
46
77
  };
47
78
  }
48
79
 
@@ -130,11 +161,6 @@ const BKIT_STUBS: BkitStub[] = [
130
161
  description:
131
162
  "Run `pnpm test:e2e` gated on `should_run_full` (the `[force full]` commit/PR tag) or `needs_e2e` (auto-force-e2e). Pairs with vercel-await for PR-time runs against the preview deployment.",
132
163
  },
133
- {
134
- id: "smoke",
135
- description:
136
- "Post-CI smoke test triggered by `workflow_run` after main-CI succeeds. Cannot share a file with push/pull_request triggers — copy the commented YAML to a new `.github/workflows/smoke.yml` file.",
137
- },
138
164
  {
139
165
  id: "coverage",
140
166
  description:
@@ -226,7 +252,7 @@ const BKIT_STUBS: BkitStub[] = [
226
252
  {
227
253
  id: "health",
228
254
  description:
229
- "Copy the commented workflow to .github/workflows/health.yml. workflow_run after CI succeeds on the default branch; smoke the deployment this SHA promoted. Not a required check. DROP if you have no deployed health URL.",
255
+ "Copy .bkit/templates/.github/workflows/bkit-health.yml to .github/workflows/bkit-health.yml, then replace {{DEFAULT_BRANCH}} and {{PRODUCTION_URL}} and swap the Vercel lookup for your host's API. It runs after every finished CI run on the default branch, green or red, probes production only when production serves that run's commit, and fails when it cannot tell. Not a required check. DROP if you have no deployed health URL.",
230
256
  },
231
257
  ];
232
258
 
@@ -314,33 +340,24 @@ const UPDATER_EXAMPLE_PATHS = [
314
340
  ".bkit/templates/.github/dependabot.yml",
315
341
  ].join("\n ");
316
342
 
317
- function updaterConfigPaths(cwd: string): { renovate: string | null; dependabot: string | null } {
318
- const renovateJson5 = path.join(cwd, ".github", "renovate.json5");
319
- const renovateJson = path.join(cwd, ".github", "renovate.json");
320
- const dependabotYml = path.join(cwd, ".github", "dependabot.yml");
321
- const dependabotYaml = path.join(cwd, ".github", "dependabot.yaml");
322
- const renovate = fs.existsSync(renovateJson5)
323
- ? renovateJson5
324
- : fs.existsSync(renovateJson)
325
- ? renovateJson
326
- : null;
327
- const dependabot = fs.existsSync(dependabotYml)
328
- ? dependabotYml
329
- : fs.existsSync(dependabotYaml)
330
- ? dependabotYaml
331
- : null;
332
- return { renovate, dependabot };
333
- }
343
+ const UPDATER_EXAMPLE: Readonly<Record<DepUpdater, string>> = {
344
+ renovate: ".bkit/templates/.github/renovate.json5",
345
+ dependabot: ".bkit/templates/.github/dependabot.yml",
346
+ };
334
347
 
335
348
  /**
336
- * Read-only dependency-updater check.
349
+ * Read-only dependency-updater check: `bkit.dependencies.updater` against the configs present.
337
350
  *
338
351
  * - Both Renovate and Dependabot configs → they open competing PRs.
339
- * - No updater config, workflows exist, and the opt-out is unset → point
352
+ * - One config, and the setting does not name it → blocker.
353
+ * - The setting names an updater whose config is absent → blocker.
354
+ * - No updater config, workflows exist, and the setting is unset → point
340
355
  * at the example templates.
341
356
  */
342
357
  export function buildDepUpdaterSetupAdvisory(cwd: string): PreflightFinding | null {
343
- const { renovate, dependabot } = updaterConfigPaths(cwd);
358
+ const configs = findDepUpdaterConfigs(cwd);
359
+ const { renovate, dependabot } = configs;
360
+ const setting = readBkitConfig(cwd).depUpdater;
344
361
 
345
362
  if (renovate && dependabot) {
346
363
  return {
@@ -353,8 +370,38 @@ export function buildDepUpdaterSetupAdvisory(cwd: string): PreflightFinding | nu
353
370
  };
354
371
  }
355
372
 
356
- if (renovate || dependabot) return null;
357
- if (readBkitConfig(cwd).depUpdaterOptOut) return null;
373
+ const found: DepUpdater | null = renovate ? "renovate" : dependabot ? "dependabot" : null;
374
+ if (found) {
375
+ if (setting === found) return null;
376
+ const name = DEP_UPDATER_NAMES[found];
377
+ const file = configs[found];
378
+ if (setting === null) {
379
+ return {
380
+ id: "dep-updater-unset",
381
+ severity: "blocker",
382
+ detect: `${name} config found (\`${file}\`), but \`bkit.dependencies.updater\` is not \`"${found}"\`.`,
383
+ action: `Set \`bkit.dependencies.updater\` to \`"${found}"\` in package.json. \`bkit upgrade\` sets it when the field is empty.`,
384
+ };
385
+ }
386
+ return {
387
+ id: "dep-updater-mismatch",
388
+ severity: "blocker",
389
+ detect: `\`bkit.dependencies.updater\` is \`"${setting}"\`, but the repo has a ${name} config (\`${file}\`).`,
390
+ action: `Set \`bkit.dependencies.updater\` to \`"${found}"\` in package.json, or delete \`${file}\` and turn ${name} off in the host UI.`,
391
+ };
392
+ }
393
+
394
+ if (setting === "renovate" || setting === "dependabot") {
395
+ const name = DEP_UPDATER_NAMES[setting];
396
+ return {
397
+ id: "dep-updater-mismatch",
398
+ severity: "blocker",
399
+ detect: `\`bkit.dependencies.updater\` is \`"${setting}"\`, but no ${name} config was found, so nothing bumps dependencies.`,
400
+ action: `Copy \`${UPDATER_EXAMPLE[setting]}\` into place and own it, or set \`bkit.dependencies.updater\` to the updater you run, or \`"none"\`. See .bkit/templates.md.`,
401
+ };
402
+ }
403
+
404
+ if (setting === "none") return null;
358
405
  if (!fs.existsSync(path.join(cwd, ".github", "workflows"))) return null;
359
406
 
360
407
  return {
@@ -365,6 +412,6 @@ export function buildDepUpdaterSetupAdvisory(cwd: string): PreflightFinding | nu
365
412
  action:
366
413
  "Copy one example and own it:\n\n" +
367
414
  ` ${UPDATER_EXAMPLE_PATHS}\n\n` +
368
- 'Use one updater, not both. To silence this advisory, set `bkit.dependencies.updater` to `"none"` in package.json. See .bkit/templates.md.',
415
+ 'Use one updater, not both, and set `bkit.dependencies.updater` to its name (`"renovate"` or `"dependabot"`) in package.json. To silence this advisory, set it to `"none"`. See .bkit/templates.md.',
369
416
  };
370
417
  }
@@ -1,5 +1,5 @@
1
1
  // checks/before/context-fetch.ts — the context-fetch blocks in `.agents/context.md`: present,
2
- // covering each context, sources enabled, provision blocks in place.
2
+ // covering each context, sources enabled, provision blocks in place, output bounded.
3
3
 
4
4
  import * as fs from "node:fs";
5
5
  import * as path from "node:path";
@@ -87,6 +87,184 @@ function parseContextFetchStarts(section: string): { name: string; context: stri
87
87
  return out;
88
88
  }
89
89
 
90
+ /**
91
+ * A `context-fetch` marker block with its fenced bash body, in document order. `context` is
92
+ * `""` for a provision block, which carries no `context=` attribute.
93
+ */
94
+ type ContextFetchBlock = {
95
+ kind: "start" | "provision";
96
+ name: string;
97
+ context: string;
98
+ body: string[];
99
+ };
100
+
101
+ /**
102
+ * Parse a consumer section into its `context-fetch` blocks, each with its fenced body. Only
103
+ * NAMED start blocks can be matched to a provision sibling (keyed by name), so an unnamed
104
+ * block is parked under `""`. The `bkit context` runner (commands/workflow/context.ts) and
105
+ * these advisories read the same markers.
106
+ */
107
+ function parseContextFetchBlocks(consumer: string): ContextFetchBlock[] {
108
+ const blocks: ContextFetchBlock[] = [];
109
+ let cur: ContextFetchBlock | null = null;
110
+ let inFence = false;
111
+ for (const line of consumer.split("\n")) {
112
+ const startM = parseContextFetchStart(line);
113
+ const provM = /^<!-- context-fetch:provision ([\w.-]+) -->$/.exec(line);
114
+ if (startM) {
115
+ cur = { kind: "start", name: startM.name, context: startM.context, body: [] };
116
+ inFence = false;
117
+ blocks.push(cur);
118
+ continue;
119
+ }
120
+ if (provM) {
121
+ cur = { kind: "provision", name: provM[1]!, context: "", body: [] };
122
+ inFence = false;
123
+ blocks.push(cur);
124
+ continue;
125
+ }
126
+ if (/^<!-- context-fetch:(end|none|start|provision)/.test(line)) {
127
+ cur = null;
128
+ inFence = false;
129
+ continue;
130
+ }
131
+ if (cur && /^```/.test(line)) {
132
+ inFence = !inFence;
133
+ continue;
134
+ }
135
+ if (cur && inFence) cur.body.push(line);
136
+ }
137
+ return blocks;
138
+ }
139
+
140
+ /**
141
+ * Drop shell comments from a block body before matching bound markers, so a bound named
142
+ * only in the block's mandated `# Customise:` comment never makes an unbounded block look
143
+ * bounded. A full-line comment is always a comment; a `#` at the start of a word outside
144
+ * quotes begins one too (the shell rule), including straight after a control operator
145
+ * (`;`, `|`, `&`, `(`, `)`). A `#` inside quotes (a `jq` regex, a banner) is data and
146
+ * stays, or `printf "===== # ====="` would read as a comment and truncate the line. Quote
147
+ * state persists across lines because a quoted `jq` program may span several. A heredoc
148
+ * body (`<<WORD`, `<<'WORD'`, `<<-WORD` up to the line holding only `WORD`) is data: it is
149
+ * kept whole and its quotes and `#` change nothing, so an apostrophe in it never leaves
150
+ * the lines after its terminator read as quoted. A `<<<` here-string opens no body.
151
+ */
152
+ function stripShellComments(text: string): string {
153
+ const out: string[] = [];
154
+ let quote: "'" | '"' | null = null;
155
+ let escaped = false;
156
+ // Terminators of the heredocs opened so far, in the order their bodies follow.
157
+ const heredocs: { word: string; tabs: boolean }[] = [];
158
+ for (const line of text.split("\n")) {
159
+ const open = heredocs[0];
160
+ if (open) {
161
+ out.push(line);
162
+ if ((open.tabs ? line.replace(/^\t+/, "") : line) === open.word) heredocs.shift();
163
+ continue;
164
+ }
165
+ let end = line.length;
166
+ for (let i = 0; i < line.length; i++) {
167
+ const ch = line[i]!;
168
+ if (quote === "'") {
169
+ if (ch === "'") quote = null;
170
+ continue;
171
+ }
172
+ if (quote === '"') {
173
+ if (escaped) escaped = false;
174
+ else if (ch === "\\") escaped = true;
175
+ else if (ch === '"') quote = null;
176
+ continue;
177
+ }
178
+ if (ch === "\\") {
179
+ i++;
180
+ continue;
181
+ }
182
+ if (ch === "'" || ch === '"') {
183
+ quote = ch;
184
+ continue;
185
+ }
186
+ if (ch === "<" && line[i + 1] === "<") {
187
+ if (line[i + 2] === "<") {
188
+ i += 2; // `<<<` here-string
189
+ continue;
190
+ }
191
+ const heredoc = /^<<(-?)[ \t]*\\?(["']?)([A-Za-z_]\w*)\2/.exec(line.slice(i));
192
+ if (heredoc) heredocs.push({ word: heredoc[3]!, tabs: heredoc[1] === "-" });
193
+ i += heredoc ? heredoc[0].length - 1 : 1;
194
+ continue;
195
+ }
196
+ if (ch === "#" && (i === 0 || /[\s;|&()]/.test(line[i - 1]!))) {
197
+ end = i;
198
+ break;
199
+ }
200
+ }
201
+ out.push(line.slice(0, end));
202
+ }
203
+ return out.join("\n");
204
+ }
205
+
206
+ /**
207
+ * Markers proving a `context-fetch` block bounds its own stdout at the source, matched
208
+ * against the block body with its shell comments removed. One entry maps to a real bound in
209
+ * a shipped block: a row / line cap (`--limit`, an API or SQL `limit`, `per_page`, `head` /
210
+ * `tail` / `--tail`, `--stat-count`, any `--max-*` such as `--max-rows` / `--max-pages` /
211
+ * `--max-items` / `--max-results`, `max_results`, `grep -m` / `rg -m` / `--max-count`,
212
+ * `--page-size` / `--per-page` / `--first`, a jq / Python slice `[0:N]`, a `sed -n 'A,Bp'`
213
+ * range, an `awk 'NR<=N'` guard, a `size` field), a page / count cap (`*_MAX_*`,
214
+ * `*_MAX_PAGES`, a `*_N` knob, a shell loop `-lt` guard), or a window / severity filter
215
+ * (`--since` / `--until` / `--freshness` / `SINCE` / `UNTIL` / `statsPeriod` / a lowercase
216
+ * `since=` / `until=`, a `severity` / `level` filter). A timeout, retry, redirect or
217
+ * connection setting (`--max-time`, `curl -m`, `--max-redirs`), a tool's own verbosity
218
+ * (`--log-level=`) and a hyphenated `*-size=` flag (`--buffer-size=`) cap nothing the block
219
+ * prints and never count. The tavily block counts as bounded on its `max_results:5` and
220
+ * `head -c` alone. A body is unbounded only when it matches none.
221
+ */
222
+ const CONTEXT_FETCH_BOUND_RES: readonly RegExp[] = [
223
+ // Row / line caps.
224
+ /--limit\b/,
225
+ /\blimit\b["']?[ \t]*[=:]?[ \t]*["'$]?\d/i,
226
+ /(^|[\s|;(])head[ \t]+-/,
227
+ /(^|[\s|;(])tail[ \t]+-/,
228
+ /--tail[= ]/,
229
+ /--stat-count/,
230
+ // --max-pages / --max-items / --max-results / --max-rows / --max-count; not --max-time.
231
+ /--max-(?!(?:time|redirs|retries|wait|duration|age|connections)(?![\w-]))[\w-]+/,
232
+ /max_results/,
233
+ /\bper_page\b["']?[ \t]*[=:][ \t]*["'$]?\d/i,
234
+ /--page-size\b/,
235
+ /--per-page\b/,
236
+ /--first\b/,
237
+ /\b(?:[ef]?grep|rg)\b[^\n|;&]*[ \t]-m[ \t]*["'$]?\d/, // grep -m 20, not curl -m 30
238
+ /--max-count\b/,
239
+ /[\[(][ \t]*\d*[ \t]*:[ \t]*\d+/, // jq / Python slice: .[0:10], [:10], [0:10]
240
+ /\bsed\b[^\n]*[ \t]-n[ \t]*['"]?[0-9]+[ \t]*,[ \t]*[0-9]+p/, // sed -n '1,200p'
241
+ /\bNR[ \t]*<=?[ \t]*[0-9$]/, // awk 'NR<=500'
242
+ /(?<!\w)(?<!\w-)size["']?[ \t]*[=:][ \t]*["']?\d/i, // request / option body field, not --buffer-size=
243
+ // Page / count caps.
244
+ /_MAX_/,
245
+ /[A-Z][A-Z0-9]*_N\b/,
246
+ /(^|[\s|;(])-l[et][ \t]+["'$]?\d/, // shell loop guard: [ "$N" -lt 20 ]
247
+ // Window / severity filters.
248
+ /--since\b/,
249
+ /--until\b/,
250
+ /--freshness\b/,
251
+ /\bsince[ \t]*[=:]/i, // since=1h, since: 2h
252
+ /\buntil[ \t]*[=:]/i,
253
+ /SINCE/,
254
+ /UNTIL/,
255
+ /statsPeriod/,
256
+ /--severity\b/,
257
+ /\bseverity[ \t]*([=:]|[<>]=?)/i,
258
+ /--level\b/,
259
+ /(?<!\w)(?<!log-)level[ \t]*([=:]|[<>]=?)/i, // not --log-level=
260
+ ];
261
+
262
+ /** True when a `context-fetch` block body carries at least one output bound (see the list). */
263
+ export function blockBoundsOutput(body: readonly string[]): boolean {
264
+ const text = stripShellComments(body.join("\n"));
265
+ return CONTEXT_FETCH_BOUND_RES.some((re) => re.test(text));
266
+ }
267
+
90
268
  /**
91
269
  * Map of context-fetch source name -> predicate proving THIS repo actually runs
92
270
  * that backend. Evidence-gates `context-fetch-source-not-enabled`
@@ -333,38 +511,7 @@ export function detectContextFetchProvisionMissing(cwd: string): PreflightFindin
333
511
  if (contextFetchDismissesAll(consumer)) return null;
334
512
 
335
513
  // Parse the consumer section into named start / provision blocks with fenced bodies.
336
- type Block = { kind: "start" | "provision"; name: string; body: string[] };
337
- const blocks: Block[] = [];
338
- let cur: Block | null = null;
339
- let inFence = false;
340
- for (const line of consumer.split("\n")) {
341
- const startM = parseContextFetchStart(line);
342
- const provM = /^<!-- context-fetch:provision ([\w.-]+) -->$/.exec(line);
343
- if (startM) {
344
- // Unnamed blocks cannot be matched to a provision sibling (which is keyed
345
- // by name), so they are parked under "" and filtered out downstream.
346
- cur = { kind: "start", name: startM.name, body: [] };
347
- inFence = false;
348
- blocks.push(cur);
349
- continue;
350
- }
351
- if (provM) {
352
- cur = { kind: "provision", name: provM[1]!, body: [] };
353
- inFence = false;
354
- blocks.push(cur);
355
- continue;
356
- }
357
- if (/^<!-- context-fetch:(end|none|start|provision)/.test(line)) {
358
- cur = null;
359
- inFence = false;
360
- continue;
361
- }
362
- if (cur && /^```/.test(line)) {
363
- inFence = !inFence;
364
- continue;
365
- }
366
- if (cur && inFence) cur.body.push(line);
367
- }
514
+ const blocks = parseContextFetchBlocks(consumer);
368
515
 
369
516
  const provisionNames = new Set(blocks.filter((b) => b.kind === "provision").map((b) => b.name));
370
517
  const provisionBody = blocks
@@ -407,3 +554,50 @@ export function detectContextFetchProvisionMissing(cwd: string): PreflightFindin
407
554
  action: `For each flagged block, add a sibling \`<!-- context-fetch:provision <name> -->\` block below \`<!-- bkit:end -->\` — SAME name as the fetch block — whose bash body installs the CLI, self-guarded and install-only: \`command -v ${firstCli} >/dev/null 2>&1 || <install ${firstCli}>\` (e.g. \`pnpm add -g ${firstCli}\` for an npm-published CLI). If \`.bkit/templates/context/\` ships a ready-made \`context-fetch:provision ${firstName}\` recipe, copy that. Then re-run \`bkit install\` so the recipe bakes into \`.claude/bkit-cloud.md\`'s setup script; \`.claude/hooks/bkit-cloud-bootstrap.sh\` runs the same recipe on gh-runner / resumed sessions. A block that fetches via an MCP tool or only universal tools (curl/jq/date) needs no provision.`,
408
555
  };
409
556
  }
557
+
558
+ /**
559
+ * Advisory: the consumer section enables a `context-fetch` block whose bash body bounds no
560
+ * output — no row / line cap, page cap or window filter. `/bkit-debug` runs every enabled
561
+ * block and writes its stdout straight into that context's artifact, so an unbounded block
562
+ * downloads a whole-run dump; only the post-hoc 3000-line / 400 KB clamp catches it, and
563
+ * the failure lines a diagnosis needs can fall outside the kept head 500 + tail 1000.
564
+ *
565
+ * Distinct from `context-fetch-missing` (which owns the no-blocks case): this only runs
566
+ * once at least one block exists. The blanket opt-out (`<!-- context-fetch:none intentional -->`)
567
+ * dismisses it; a context-scoped marker (`context-fetch:none e2e`) does not, because the
568
+ * runner still runs a block that is present.
569
+ */
570
+ export function detectContextFetchUnbounded(cwd: string): PreflightFinding | null {
571
+ const filePath = path.join(cwd, ".agents", "context.md");
572
+ if (!fs.existsSync(filePath)) return null;
573
+ const content = fs.readFileSync(filePath, "utf-8");
574
+ const endIdx = content.search(/^<!-- bkit:end -->$/m);
575
+ if (endIdx === -1) return null;
576
+ const consumer = content.slice(endIdx);
577
+ if (contextFetchDismissesAll(consumer)) return null;
578
+
579
+ // Only the blocks the runner actually runs can download anything: a block whose
580
+ // `context=` is unknown is narrated NOT RUN, and one with no fenced body is refused
581
+ // before it runs (`bkit context list-blocks` / `run-block`). Neither is bounded here.
582
+ const runnable = parseContextFetchBlocks(consumer).filter(
583
+ (b) =>
584
+ b.kind === "start" &&
585
+ CONTEXT_FETCH_CONTEXTS.includes(b.context) &&
586
+ b.body.some((l) => l.trim() !== ""),
587
+ );
588
+ // No runnable block => `context-fetch-missing` owns the empty case (no double-fire).
589
+ if (runnable.length === 0) return null;
590
+
591
+ const unbounded = runnable.filter((b) => !blockBoundsOutput(b.body));
592
+ if (unbounded.length === 0) return null;
593
+
594
+ const items = unbounded.map((b) => `${b.name || "(unnamed)"} (\`context=${b.context}\`)`);
595
+ const list = items.join(", ");
596
+ const plural = items.length > 1;
597
+ return {
598
+ id: "context-fetch-unbounded",
599
+ severity: "advisory",
600
+ detect: `\`.agents/context.md\` enables context-fetch block${plural ? "s" : ""} below \`<!-- bkit:end -->\` that bound no output: ${list}. \`/bkit-debug\` runs every enabled block and writes its stdout straight into that context's artifact, so ${plural ? "these blocks" : "this block"} download${plural ? "" : "s"} a whole-run dump — only the post-hoc 3000-line / 400 KB clamp catches it, and the failure lines a diagnosis needs can fall outside the kept head 500 + tail 1000.`,
601
+ action: `Bound each flagged block at the source: add a row / line cap (\`--limit N\`, \`head -n N\`, \`tail -n N\` / \`--tail N\`, \`--stat-count N\`, \`grep -m N\` / \`--max-count N\`, a \`--max-*\` row or page cap (\`--max-rows N\`, \`--max-pages N\`, \`--max-items N\`, \`--max-results N\`),\`--page-size N\` / \`--per-page N\` / \`--first N\`, a jq / SQL slice (\`.[0:N]\`, \`limit N\`), a \`sed -n 'A,Bp'\` / \`awk 'NR<=N'\` range, the API's \`max_results\` / \`per_page\` / \`limit\` param, or a request-body \`size\` field), a page cap (\`<NAME>_MAX_PAGES\`, a \`*_N\` count variable, or a shell loop guard \`[ "$N" -lt M ]\`), or a window / severity filter (\`--since\` / \`--until\` / \`--freshness\` / \`SINCE\` / \`UNTIL\`, \`statsPeriod\`, or a \`severity\` / \`level\` filter) in the block body — not only in its \`# Customise:\` comment. A timeout (\`--max-time\`, \`curl -m\`) or the tool's own \`--log-level\` caps nothing the block prints. Raise the cap only when the cause sits outside the kept window: \`/bkit-debug\` clamps the artifact post hoc at 3000 lines / 400 KB (head 500 + tail 1000 + every error-matching line), so an unbounded dump can drop the very failure lines a diagnosis needs.`,
602
+ };
603
+ }
@@ -51,7 +51,7 @@ export function detectMissingDotenv(
51
51
  id: "mcp-env-missing-dotenv",
52
52
  severity: "advisory",
53
53
  detect: `.bkit/.env.example exists but .bkit/.env does not. MCP servers and agent tooling will not have access to ${tokens}.`,
54
- action: `[mcp-env] Copy .bkit/.env.example to .bkit/.env and fill in your tokens (${tokens}). Then run \`direnv allow\` to auto-export them into your shell. .bkit/.env is gitignored and safe to commit-skip.`,
54
+ action: `[mcp-env] Copy .bkit/.env.example to .bkit/.env and fill in your tokens (${tokens}) — in a git worktree, copy the main checkout's .bkit/.env instead, or run \`bkit worktrees setup\` to link it. Then run \`direnv allow\` to auto-export them into your shell. .bkit/.env is gitignored and safe to commit-skip.`,
55
55
  };
56
56
  }
57
57
 
@@ -22,6 +22,7 @@ import {
22
22
  detectNoPackageJson,
23
23
  detectNotGitRepo,
24
24
  detectInvalidAskSettings,
25
+ detectBuildPublish,
25
26
  detectInvalidTaskCaps,
26
27
  detectTaskCapFormStale,
27
28
  detectUnmarkedPlans,
@@ -39,6 +40,7 @@ import {
39
40
  detectContextFetchMissing,
40
41
  detectContextFetchProvisionMissing,
41
42
  detectContextFetchSourceNotEnabled,
43
+ detectContextFetchUnbounded,
42
44
  } from "./context-fetch.js";
43
45
  import { detectExtraMcpServers, detectMissingMcpServers } from "./mcp.js";
44
46
 
@@ -136,6 +138,8 @@ export function runPreflight(
136
138
  const invalidTaskCaps = detectInvalidTaskCaps(cwd);
137
139
  if (invalidTaskCaps) advisories.push(invalidTaskCaps);
138
140
 
141
+ advisories.push(...detectBuildPublish(cwd));
142
+
139
143
  const taskCapFormStale = detectTaskCapFormStale(cwd);
140
144
  if (taskCapFormStale) advisories.push(taskCapFormStale);
141
145
 
@@ -162,6 +166,9 @@ export function runPreflight(
162
166
  const contextFetchProvision = detectContextFetchProvisionMissing(cwd);
163
167
  if (contextFetchProvision) advisories.push(contextFetchProvision);
164
168
 
169
+ const contextFetchUnbounded = detectContextFetchUnbounded(cwd);
170
+ if (contextFetchUnbounded) advisories.push(contextFetchUnbounded);
171
+
165
172
  // bkit-not-on-path advisory — suggest the shell alias for local development.
166
173
  const bkitNotOnPath = detectBkitNotOnPath();
167
174
  if (bkitNotOnPath) advisories.push(bkitNotOnPath);