@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
@@ -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
+ }
@@ -19,7 +19,7 @@ const TRACKER_TOKENS: Partial<Record<IssueTracker, { key: string; description: s
19
19
  "Linear personal API key for the Linear MCP server and the Linear preflight hook (generate at https://linear.app/settings/api)",
20
20
  },
21
21
  jira: {
22
- key: "BKIT_JIRA_API_TOKEN",
22
+ key: "BKIT_JIRA_API_KEY",
23
23
  description:
24
24
  'Atlassian API token with scopes for the app "Atlassian MCP V2", sent as Bearer to the Jira MCP server (create at https://id.atlassian.com/manage-profile/security/api-tokens; see .bkit/trackers.md § jira)',
25
25
  },
@@ -37,7 +37,7 @@ function tokenKeys(tracker: IssueTracker): string[] {
37
37
  * copied it to .bkit/.env and filled in their tokens.
38
38
  */
39
39
  // `tracker` adds its own token to the token prose (`TRACKER_TOKENS`). Defaults to
40
- // `linear`; the real Phase-3 caller passes the consumer's resolved `bkit.issueTracker`.
40
+ // `linear`; the real Phase-3 caller passes the consumer's resolved `bkit.tracker.default`.
41
41
  export function detectMissingDotenv(
42
42
  cwd: string,
43
43
  tracker: IssueTracker = "linear",
@@ -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
 
@@ -8,6 +8,7 @@ import { extractManagedBlock, stripManagedBlock } from "../../install/managed-bl
8
8
  import { readTemplate } from "../../render/parts.js";
9
9
  import { findTemplateSource, getPkgRoot } from "../../shared/package-roots.js";
10
10
  import { parseJson } from "../../shared/json.js";
11
+ import { ciWorkflowPath } from "../../shared/settings.js";
11
12
  import type { PreflightFinding } from "./index.js";
12
13
 
13
14
  /**
@@ -77,11 +78,12 @@ export function detectGitignoreBlockDuplicates(cwd: string): PreflightFinding |
77
78
  * surfaces — pure cost (artifact upload + storage) with zero diagnostic payoff.
78
79
  *
79
80
  * "Hostile" gap per the BAR-224 signal-vs-noise classification. Reads the consumer's
80
- * own bkit-ci.yml, active lines only: YAML comment lines are dropped first, so a commented
81
+ * own CI workflow (`bkit.testing.ciWorkflow`, default `bkit-ci.yml`), active lines only: YAML comment lines are dropped first, so a commented
81
82
  * template stub or a commented-out example never fires.
82
83
  */
83
84
  export function detectPlaywrightReporterHostile(cwd: string): PreflightFinding | null {
84
- const ciPath = path.join(cwd, ".github", "workflows", "bkit-ci.yml");
85
+ const ciRel = ciWorkflowPath(cwd);
86
+ const ciPath = path.join(cwd, ciRel);
85
87
  if (!fs.existsSync(ciPath)) return null;
86
88
  const content = fs.readFileSync(ciPath, "utf-8");
87
89
  // Filter out YAML comment lines (those starting with optional whitespace + `#`) before
@@ -99,8 +101,7 @@ export function detectPlaywrightReporterHostile(cwd: string): PreflightFinding |
99
101
  return {
100
102
  id: "playwright-reporter-line-override-hostile",
101
103
  severity: "advisory",
102
- detect:
103
- ".github/workflows/bkit-ci.yml has a `playwright test` invocation that passes `--reporter=line`. Under `[verbose ci]` with `--trace=on`, trace artifacts are written but no reporter surfaces them — pure cost.",
104
+ detect: `${ciRel} has a \`playwright test\` invocation that passes \`--reporter=line\`. Under \`[verbose ci]\` with \`--trace=on\`, trace artifacts are written but no reporter surfaces them — pure cost.`,
104
105
  action:
105
106
  'Drop the `--reporter=line` flag so `playwright.config.ts`\'s configured reporter chain runs (typically `[list, html, github, json]`). Verbose-aware pattern: have `test:e2e` read `VERBOSE_CI` and append `--trace=on` to its own `playwright test` call (e.g. `TRACE=; [ "$VERBOSE_CI" = "1" ] && TRACE=--trace=on; playwright test $TRACE`), then run it plainly as `pnpm test:e2e` — do NOT pass `--trace=on` through a turbo / pnpm `-- --trace=on` passthrough, which appends to the script string and breaks any test:e2e ending in a bash construct (fi / done / esac). Never pass `--reporter`. Note that `--video` and `--screenshot` are NOT Playwright CLI flags (they\'re `use:` keys in playwright.config.ts); the trace.zip already captures snapshots / network / console / source. Default-mode output stays clean via the config\'s `list` reporter.',
106
107
  };
@@ -10,6 +10,7 @@
10
10
  // readBkitConfig — from shared/settings.ts (the consumer's `bkit` settings)
11
11
  // readInstallingVersion — from shared/package-json.ts (the version of the bkit doing the install)
12
12
  // readTemplate — from render/parts.ts (template with its shared parts spliced in)
13
+ // parsePlanBlocks — from commands/workflow/plan-blocks.ts (a plan's group and task blocks)
13
14
 
14
15
  import type { ModuleFlag } from "../../cli.js";
15
16
  import { readInstallingVersion } from "../../shared/package-json.js";
@@ -20,6 +21,11 @@ import {
20
21
  detectMalformedPackageJson,
21
22
  detectNoPackageJson,
22
23
  detectNotGitRepo,
24
+ detectInvalidAskSettings,
25
+ detectBuildPublish,
26
+ detectInvalidTaskCaps,
27
+ detectTaskCapFormStale,
28
+ detectUnmarkedPlans,
23
29
  } from "./repo.js";
24
30
  import {
25
31
  MARKERED_TEXT_DRIFT_PATHS,
@@ -34,6 +40,7 @@ import {
34
40
  detectContextFetchMissing,
35
41
  detectContextFetchProvisionMissing,
36
42
  detectContextFetchSourceNotEnabled,
43
+ detectContextFetchUnbounded,
37
44
  } from "./context-fetch.js";
38
45
  import { detectExtraMcpServers, detectMissingMcpServers } from "./mcp.js";
39
46
 
@@ -75,7 +82,7 @@ export function dedupeById(findings: PreflightFinding[]): PreflightFinding[] {
75
82
  * installingVersion: used by detectBkitVersionMajorDowngrade; defaults to the
76
83
  * package's own version read from its package.json at runtime.
77
84
  * issueTracker: when provided, narrows tracker-specific checks (e.g. MCP server
78
- * requirements). When omitted, read from consumer's `bkit.issueTracker` in package.json.
85
+ * requirements). When omitted, read from consumer's `bkit.tracker.default` in package.json.
79
86
  *
80
87
  * GitHub tracker gate: when `issueTracker === "github"`, the Linear preflight
81
88
  * gate is a no-op — the GitHub gate is enforced by workflow Step 1 via MCP.
@@ -128,6 +135,20 @@ export function runPreflight(
128
135
  const versionPinStale = detectBkitVersionPinStale(cwd);
129
136
  if (versionPinStale) advisories.push(versionPinStale);
130
137
 
138
+ const invalidTaskCaps = detectInvalidTaskCaps(cwd);
139
+ if (invalidTaskCaps) advisories.push(invalidTaskCaps);
140
+
141
+ advisories.push(...detectBuildPublish(cwd));
142
+
143
+ const taskCapFormStale = detectTaskCapFormStale(cwd);
144
+ if (taskCapFormStale) advisories.push(taskCapFormStale);
145
+
146
+ const invalidAsks = detectInvalidAskSettings(cwd);
147
+ if (invalidAsks) advisories.push(invalidAsks);
148
+
149
+ const unmarkedPlans = detectUnmarkedPlans(cwd);
150
+ if (unmarkedPlans) advisories.push(unmarkedPlans);
151
+
131
152
  // BAR-224: [verbose ci] marker advisories
132
153
 
133
154
  const playwrightReporterHostile = detectPlaywrightReporterHostile(cwd);
@@ -145,6 +166,9 @@ export function runPreflight(
145
166
  const contextFetchProvision = detectContextFetchProvisionMissing(cwd);
146
167
  if (contextFetchProvision) advisories.push(contextFetchProvision);
147
168
 
169
+ const contextFetchUnbounded = detectContextFetchUnbounded(cwd);
170
+ if (contextFetchUnbounded) advisories.push(contextFetchUnbounded);
171
+
148
172
  // bkit-not-on-path advisory — suggest the shell alias for local development.
149
173
  const bkitNotOnPath = detectBkitNotOnPath();
150
174
  if (bkitNotOnPath) advisories.push(bkitNotOnPath);
@@ -1,11 +1,22 @@
1
1
  // checks/before/repo.ts — repo preconditions: package.json present and parseable, a git repo,
2
- // bkit on PATH.
2
+ // valid plan caps, a change issue form showing them, plans in task-block form, bkit on PATH.
3
3
 
4
4
  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 { ModuleFlag } from "../../cli.js";
8
- import { readJsonFile } from "../../shared/json.js";
8
+ import { parsePlanBlocks } from "../../commands/workflow/plan-blocks.js";
9
+ import { parseJson, readJsonFile } from "../../shared/json.js";
10
+ import {
11
+ ASK_POINTS,
12
+ CONFIG_DEFAULTS,
13
+ invalidAskSettings,
14
+ invalidBuildPublish,
15
+ invalidTaskCaps,
16
+ limitKey,
17
+ readBkitConfig,
18
+ type TaskCaps,
19
+ } from "../../shared/settings.js";
9
20
  import type { PreflightFinding } from "./index.js";
10
21
  import { isCloudOrCi } from "./env.js";
11
22
 
@@ -49,6 +60,201 @@ export function detectNotGitRepo(cwd: string, modules: Set<ModuleFlag>): Preflig
49
60
  };
50
61
  }
51
62
 
63
+ /**
64
+ * Advisory: `package.json` `bkit.workflows.tasks` holds a plan cap that is not an integer >= 1.
65
+ * Each such key falls back to its default in `readBkitConfig`.
66
+ */
67
+ export function detectInvalidTaskCaps(cwd: string): PreflightFinding | null {
68
+ const workflows = bkitWorkflows(cwd);
69
+ if (workflows === null) return null;
70
+ const bad = invalidTaskCaps(workflows.tasks);
71
+ if (bad.length === 0) return null;
72
+ const caps = CONFIG_DEFAULTS.tasks;
73
+ const keys = bad[0] === "tasks" ? (Object.keys(caps) as (keyof typeof caps)[]) : bad;
74
+ const named = bad.map((k) => `\`bkit.workflows.${k === "tasks" ? k : `tasks.${k}`}\``).join(", ");
75
+ return {
76
+ id: "bkit-tasks-invalid",
77
+ severity: "advisory",
78
+ detect: `package.json ${named} is not a whole number of 1 or more, so the plan check uses the default instead.`,
79
+ action: `Set each to a whole number of 1 or more in package.json, or delete it to keep the default: ${keys
80
+ .map((k) => `\`bkit.workflows.tasks.${k}\` (default ${caps[k as keyof typeof caps]})`)
81
+ .join(", ")}.`,
82
+ };
83
+ }
84
+
85
+ /**
86
+ * Advisory: `package.json` `bkit.workflows.build.publish` holds a refused or invalid value.
87
+ * `remote: false` is refused (a cloud run always publishes); a non-object block or a
88
+ * non-boolean `local` falls back to its default. One finding per key.
89
+ */
90
+ export function detectBuildPublish(cwd: string): PreflightFinding[] {
91
+ const workflows = bkitWorkflows(cwd);
92
+ if (workflows === null) return [];
93
+ const out: PreflightFinding[] = [];
94
+ const publish = (workflows.build as { publish?: unknown } | null | undefined)?.publish;
95
+ if (
96
+ publish !== null &&
97
+ typeof publish === "object" &&
98
+ !Array.isArray(publish) &&
99
+ (publish as { remote?: unknown }).remote !== undefined &&
100
+ (publish as { remote?: unknown }).remote !== true
101
+ ) {
102
+ out.push({
103
+ id: "bkit-build-publish-remote",
104
+ severity: "advisory",
105
+ detect:
106
+ "package.json `bkit.workflows.build.publish.remote` is not `true`, so a cloud or CI run still publishes.",
107
+ action:
108
+ "Delete `bkit.workflows.build.publish.remote` or set it to `true`; hold a local build with `bkit.workflows.build.publish.local` set to `false`.",
109
+ });
110
+ }
111
+ const bad = invalidBuildPublish(workflows.build);
112
+ if (bad.length > 0) {
113
+ out.push({
114
+ id: "bkit-build-publish-invalid",
115
+ severity: "advisory",
116
+ detect: `package.json ${bad.map((k) => `\`bkit.workflows.${k}\``).join(", ")} is not ${bad[0] === "build.publish.local" ? "a boolean" : "an object"}, so the default (publish) is used instead.`,
117
+ action:
118
+ "Set `bkit.workflows.build.publish.local` to `true` or `false`, or delete the block to keep the default (`true`).",
119
+ });
120
+ }
121
+ return out;
122
+ }
123
+
124
+ const TASK_CAP_KEY = /`bkit\.workflows\.tasks\.(\w+)`/g;
125
+
126
+ /**
127
+ * Each `bkit.workflows.tasks.<key>` the text names with a `(default N)` after it, on the same
128
+ * line and before the next named key.
129
+ */
130
+ export function taskCapDefaultsNamed(text: string): { key: string; value: number }[] {
131
+ const hits = [...text.matchAll(TASK_CAP_KEY)];
132
+ return hits.flatMap((m, i) => {
133
+ const from = m.index + m[0].length;
134
+ const lineEnd = text.indexOf("\n", from);
135
+ const end = Math.min(hits[i + 1]?.index ?? text.length, lineEnd === -1 ? text.length : lineEnd);
136
+ const n = /\(default (\d+)\)/.exec(text.slice(from, end));
137
+ return n ? [{ key: m[1]!, value: Number(n[1]) }] : [];
138
+ });
139
+ }
140
+
141
+ const CHANGE_FORM = ".github/ISSUE_TEMPLATE/bkit-change.yml";
142
+
143
+ /**
144
+ * Advisory: the change issue form names a plan cap with a `(default N)` that differs from the
145
+ * value `readBkitConfig` gives for that key.
146
+ */
147
+ export function detectTaskCapFormStale(cwd: string): PreflightFinding | null {
148
+ const file = path.join(cwd, CHANGE_FORM);
149
+ if (!fs.existsSync(file)) return null;
150
+ const caps = readBkitConfig(cwd).tasks;
151
+ const isCap = (k: string): k is keyof TaskCaps => Object.hasOwn(caps, k);
152
+ const stale = new Map<keyof TaskCaps, number>();
153
+ for (const { key, value } of taskCapDefaultsNamed(fs.readFileSync(file, "utf-8"))) {
154
+ if (isCap(key) && caps[key] !== value) stale.set(key, value);
155
+ }
156
+ if (stale.size === 0) return null;
157
+ const rows = [...stale];
158
+ return {
159
+ id: "bkit-tasks-form-stale",
160
+ severity: "advisory",
161
+ detect: `${CHANGE_FORM} shows plan caps that differ from package.json: ${rows
162
+ .map(([k, v]) => `\`bkit.workflows.tasks.${k}\` (default ${v}) is ${caps[k]}`)
163
+ .join(", ")}.`,
164
+ action: `In ${CHANGE_FORM}, change the number in each "(default N)" after the key: ${rows
165
+ .map(([k, v]) => `\`bkit.workflows.tasks.${k}\` "(default ${v})" → "(default ${caps[k]})"`)
166
+ .join(
167
+ ", ",
168
+ )}. Or set the key in package.json \`bkit.workflows.tasks\` to the number the form shows.`,
169
+ };
170
+ }
171
+
172
+ /** `package.json` `bkit.workflows` as an object; null when the file or block is unusable. */
173
+ function bkitWorkflows(cwd: string): Record<string, unknown> | null {
174
+ const read = readJsonFile(path.join(cwd, "package.json"));
175
+ if (!read.ok) return null;
176
+ const bkit = (read.value as { bkit?: unknown } | null)?.bkit;
177
+ if (bkit === null || typeof bkit !== "object" || Array.isArray(bkit)) return null;
178
+ const workflows = (bkit as { workflows?: unknown }).workflows;
179
+ return workflows !== null && typeof workflows === "object" && !Array.isArray(workflows)
180
+ ? (workflows as Record<string, unknown>)
181
+ : {};
182
+ }
183
+
184
+ /**
185
+ * Advisory when a `bkit.workflows.<workflow>.<point>` block holds an `ask` that is not
186
+ * true/false, a limit that is not a whole number of 1 or more, or is not an object. Each such
187
+ * key falls back to its default in `readBkitConfig`.
188
+ */
189
+ export function detectInvalidAskSettings(cwd: string): PreflightFinding | null {
190
+ const workflows = bkitWorkflows(cwd);
191
+ if (workflows === null) return null;
192
+ const bad = invalidAskSettings(workflows);
193
+ if (bad.length === 0) return null;
194
+ const defaults = bad.map((k) => {
195
+ const point = ASK_POINTS.find((p) => k === p || k.startsWith(`${p}.`))!;
196
+ const d = CONFIG_DEFAULTS.asks[point];
197
+ return `\`bkit.workflows.${point}\` (default \`{ "ask": ${d.ask}, "${limitKey(point)}": ${d.max} }\`)`;
198
+ });
199
+ return {
200
+ id: "bkit-ask-settings-invalid",
201
+ severity: "advisory",
202
+ detect: `package.json ${bad.map((k) => `\`bkit.workflows.${k}\``).join(", ")} is not valid (\`ask\` takes true or false, a limit a whole number of 1 or more), so the default is used instead.`,
203
+ action: `Fix or delete each in package.json: ${[...new Set(defaults)].join(", ")}.`,
204
+ };
205
+ }
206
+
207
+ const PLAN_FILE = /^(.+)-plan\.md$/;
208
+
209
+ /** The FID's `docs/plans/{month}/logs/{FID}/status.jsonl` holds a ship `workflow-done` row. */
210
+ function fidShipped(monthDir: string, fid: string): boolean {
211
+ const file = path.join(monthDir, "logs", fid, "status.jsonl");
212
+ if (!fs.existsSync(file)) return false;
213
+ return fs
214
+ .readFileSync(file, "utf-8")
215
+ .split("\n")
216
+ .some((line) => {
217
+ const row = parseJson(line);
218
+ if (!row.ok || typeof row.value !== "object" || row.value === null) return false;
219
+ const { type, workflow } = row.value as { type?: unknown; workflow?: unknown };
220
+ return type === "workflow-done" && workflow === "ship";
221
+ });
222
+ }
223
+
224
+ /**
225
+ * Advisory: a `docs/plans/{YYYYMM}/{FID}-plan.md` whose FID has not shipped holds no task
226
+ * blocks, so `/bkit-build` Step 3 converts it on the FID's next build. `archive/` and
227
+ * `logs/` sit below the month folder and are not read.
228
+ */
229
+ export function detectUnmarkedPlans(cwd: string): PreflightFinding | null {
230
+ const plans = path.join(cwd, "docs", "plans");
231
+ if (!fs.existsSync(plans)) return null;
232
+ const unmarked: string[] = [];
233
+ for (const month of fs.readdirSync(plans, { withFileTypes: true })) {
234
+ if (!month.isDirectory()) continue;
235
+ const monthDir = path.join(plans, month.name);
236
+ for (const entry of fs.readdirSync(monthDir, { withFileTypes: true })) {
237
+ const fid = entry.isFile() ? PLAN_FILE.exec(entry.name)?.[1] : undefined;
238
+ if (fid === undefined) continue;
239
+ const text = fs.readFileSync(path.join(monthDir, entry.name), "utf-8");
240
+ if (parsePlanBlocks(text).tasks.length > 0 || fidShipped(monthDir, fid)) continue;
241
+ unmarked.push(`docs/plans/${month.name}/${entry.name}`);
242
+ }
243
+ }
244
+ if (unmarked.length === 0) return null;
245
+ unmarked.sort();
246
+ const one = unmarked.length === 1;
247
+ return {
248
+ id: "plan-task-markers-missing",
249
+ severity: "advisory",
250
+ detect: `${unmarked.length} ${one ? "plan has" : "plans have"} no task markers and will be converted to group and task blocks on the next \`/bkit-build\` of ${one ? "its" : "their"} FID: ${unmarked
251
+ .map((p) => `\`${p}\``)
252
+ .join(", ")}.`,
253
+ action:
254
+ "Nothing to do by hand: this matters only for builds still to run, and plans of shipped FIDs are not listed.",
255
+ };
256
+ }
257
+
52
258
  /**
53
259
  * Advisory: `bkit` is not on PATH.
54
260
  * bkit is a devDependency — without a shell alias, every invocation requires