@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
  import * as fs from "node:fs";
4
4
  import * as path from "node:path";
5
5
  import { getTemplatesRoot } from "../../shared/package-roots.js";
@@ -82,6 +82,176 @@ function parseContextFetchStarts(section) {
82
82
  }
83
83
  return out;
84
84
  }
85
+ /**
86
+ * Parse a consumer section into its `context-fetch` blocks, each with its fenced body. Only
87
+ * NAMED start blocks can be matched to a provision sibling (keyed by name), so an unnamed
88
+ * block is parked under `""`. The `bkit context` runner (commands/workflow/context.ts) and
89
+ * these advisories read the same markers.
90
+ */
91
+ function parseContextFetchBlocks(consumer) {
92
+ const blocks = [];
93
+ let cur = null;
94
+ let inFence = false;
95
+ for (const line of consumer.split("\n")) {
96
+ const startM = parseContextFetchStart(line);
97
+ const provM = /^<!-- context-fetch:provision ([\w.-]+) -->$/.exec(line);
98
+ if (startM) {
99
+ cur = { kind: "start", name: startM.name, context: startM.context, body: [] };
100
+ inFence = false;
101
+ blocks.push(cur);
102
+ continue;
103
+ }
104
+ if (provM) {
105
+ cur = { kind: "provision", name: provM[1], context: "", body: [] };
106
+ inFence = false;
107
+ blocks.push(cur);
108
+ continue;
109
+ }
110
+ if (/^<!-- context-fetch:(end|none|start|provision)/.test(line)) {
111
+ cur = null;
112
+ inFence = false;
113
+ continue;
114
+ }
115
+ if (cur && /^```/.test(line)) {
116
+ inFence = !inFence;
117
+ continue;
118
+ }
119
+ if (cur && inFence)
120
+ cur.body.push(line);
121
+ }
122
+ return blocks;
123
+ }
124
+ /**
125
+ * Drop shell comments from a block body before matching bound markers, so a bound named
126
+ * only in the block's mandated `# Customise:` comment never makes an unbounded block look
127
+ * bounded. A full-line comment is always a comment; a `#` at the start of a word outside
128
+ * quotes begins one too (the shell rule), including straight after a control operator
129
+ * (`;`, `|`, `&`, `(`, `)`). A `#` inside quotes (a `jq` regex, a banner) is data and
130
+ * stays, or `printf "===== # ====="` would read as a comment and truncate the line. Quote
131
+ * state persists across lines because a quoted `jq` program may span several. A heredoc
132
+ * body (`<<WORD`, `<<'WORD'`, `<<-WORD` up to the line holding only `WORD`) is data: it is
133
+ * kept whole and its quotes and `#` change nothing, so an apostrophe in it never leaves
134
+ * the lines after its terminator read as quoted. A `<<<` here-string opens no body.
135
+ */
136
+ function stripShellComments(text) {
137
+ const out = [];
138
+ let quote = null;
139
+ let escaped = false;
140
+ // Terminators of the heredocs opened so far, in the order their bodies follow.
141
+ const heredocs = [];
142
+ for (const line of text.split("\n")) {
143
+ const open = heredocs[0];
144
+ if (open) {
145
+ out.push(line);
146
+ if ((open.tabs ? line.replace(/^\t+/, "") : line) === open.word)
147
+ heredocs.shift();
148
+ continue;
149
+ }
150
+ let end = line.length;
151
+ for (let i = 0; i < line.length; i++) {
152
+ const ch = line[i];
153
+ if (quote === "'") {
154
+ if (ch === "'")
155
+ quote = null;
156
+ continue;
157
+ }
158
+ if (quote === '"') {
159
+ if (escaped)
160
+ escaped = false;
161
+ else if (ch === "\\")
162
+ escaped = true;
163
+ else if (ch === '"')
164
+ quote = null;
165
+ continue;
166
+ }
167
+ if (ch === "\\") {
168
+ i++;
169
+ continue;
170
+ }
171
+ if (ch === "'" || ch === '"') {
172
+ quote = ch;
173
+ continue;
174
+ }
175
+ if (ch === "<" && line[i + 1] === "<") {
176
+ if (line[i + 2] === "<") {
177
+ i += 2; // `<<<` here-string
178
+ continue;
179
+ }
180
+ const heredoc = /^<<(-?)[ \t]*\\?(["']?)([A-Za-z_]\w*)\2/.exec(line.slice(i));
181
+ if (heredoc)
182
+ heredocs.push({ word: heredoc[3], tabs: heredoc[1] === "-" });
183
+ i += heredoc ? heredoc[0].length - 1 : 1;
184
+ continue;
185
+ }
186
+ if (ch === "#" && (i === 0 || /[\s;|&()]/.test(line[i - 1]))) {
187
+ end = i;
188
+ break;
189
+ }
190
+ }
191
+ out.push(line.slice(0, end));
192
+ }
193
+ return out.join("\n");
194
+ }
195
+ /**
196
+ * Markers proving a `context-fetch` block bounds its own stdout at the source, matched
197
+ * against the block body with its shell comments removed. One entry maps to a real bound in
198
+ * a shipped block: a row / line cap (`--limit`, an API or SQL `limit`, `per_page`, `head` /
199
+ * `tail` / `--tail`, `--stat-count`, any `--max-*` such as `--max-rows` / `--max-pages` /
200
+ * `--max-items` / `--max-results`, `max_results`, `grep -m` / `rg -m` / `--max-count`,
201
+ * `--page-size` / `--per-page` / `--first`, a jq / Python slice `[0:N]`, a `sed -n 'A,Bp'`
202
+ * range, an `awk 'NR<=N'` guard, a `size` field), a page / count cap (`*_MAX_*`,
203
+ * `*_MAX_PAGES`, a `*_N` knob, a shell loop `-lt` guard), or a window / severity filter
204
+ * (`--since` / `--until` / `--freshness` / `SINCE` / `UNTIL` / `statsPeriod` / a lowercase
205
+ * `since=` / `until=`, a `severity` / `level` filter). A timeout, retry, redirect or
206
+ * connection setting (`--max-time`, `curl -m`, `--max-redirs`), a tool's own verbosity
207
+ * (`--log-level=`) and a hyphenated `*-size=` flag (`--buffer-size=`) cap nothing the block
208
+ * prints and never count. The tavily block counts as bounded on its `max_results:5` and
209
+ * `head -c` alone. A body is unbounded only when it matches none.
210
+ */
211
+ const CONTEXT_FETCH_BOUND_RES = [
212
+ // Row / line caps.
213
+ /--limit\b/,
214
+ /\blimit\b["']?[ \t]*[=:]?[ \t]*["'$]?\d/i,
215
+ /(^|[\s|;(])head[ \t]+-/,
216
+ /(^|[\s|;(])tail[ \t]+-/,
217
+ /--tail[= ]/,
218
+ /--stat-count/,
219
+ // --max-pages / --max-items / --max-results / --max-rows / --max-count; not --max-time.
220
+ /--max-(?!(?:time|redirs|retries|wait|duration|age|connections)(?![\w-]))[\w-]+/,
221
+ /max_results/,
222
+ /\bper_page\b["']?[ \t]*[=:][ \t]*["'$]?\d/i,
223
+ /--page-size\b/,
224
+ /--per-page\b/,
225
+ /--first\b/,
226
+ /\b(?:[ef]?grep|rg)\b[^\n|;&]*[ \t]-m[ \t]*["'$]?\d/, // grep -m 20, not curl -m 30
227
+ /--max-count\b/,
228
+ /[\[(][ \t]*\d*[ \t]*:[ \t]*\d+/, // jq / Python slice: .[0:10], [:10], [0:10]
229
+ /\bsed\b[^\n]*[ \t]-n[ \t]*['"]?[0-9]+[ \t]*,[ \t]*[0-9]+p/, // sed -n '1,200p'
230
+ /\bNR[ \t]*<=?[ \t]*[0-9$]/, // awk 'NR<=500'
231
+ /(?<!\w)(?<!\w-)size["']?[ \t]*[=:][ \t]*["']?\d/i, // request / option body field, not --buffer-size=
232
+ // Page / count caps.
233
+ /_MAX_/,
234
+ /[A-Z][A-Z0-9]*_N\b/,
235
+ /(^|[\s|;(])-l[et][ \t]+["'$]?\d/, // shell loop guard: [ "$N" -lt 20 ]
236
+ // Window / severity filters.
237
+ /--since\b/,
238
+ /--until\b/,
239
+ /--freshness\b/,
240
+ /\bsince[ \t]*[=:]/i, // since=1h, since: 2h
241
+ /\buntil[ \t]*[=:]/i,
242
+ /SINCE/,
243
+ /UNTIL/,
244
+ /statsPeriod/,
245
+ /--severity\b/,
246
+ /\bseverity[ \t]*([=:]|[<>]=?)/i,
247
+ /--level\b/,
248
+ /(?<!\w)(?<!log-)level[ \t]*([=:]|[<>]=?)/i, // not --log-level=
249
+ ];
250
+ /** True when a `context-fetch` block body carries at least one output bound (see the list). */
251
+ export function blockBoundsOutput(body) {
252
+ const text = stripShellComments(body.join("\n"));
253
+ return CONTEXT_FETCH_BOUND_RES.some((re) => re.test(text));
254
+ }
85
255
  /**
86
256
  * Map of context-fetch source name -> predicate proving THIS repo actually runs
87
257
  * that backend. Evidence-gates `context-fetch-source-not-enabled`
@@ -329,38 +499,8 @@ export function detectContextFetchProvisionMissing(cwd) {
329
499
  const consumer = content.slice(endIdx);
330
500
  if (contextFetchDismissesAll(consumer))
331
501
  return null;
332
- const blocks = [];
333
- let cur = null;
334
- let inFence = false;
335
- for (const line of consumer.split("\n")) {
336
- const startM = parseContextFetchStart(line);
337
- const provM = /^<!-- context-fetch:provision ([\w.-]+) -->$/.exec(line);
338
- if (startM) {
339
- // Unnamed blocks cannot be matched to a provision sibling (which is keyed
340
- // by name), so they are parked under "" and filtered out downstream.
341
- cur = { kind: "start", name: startM.name, body: [] };
342
- inFence = false;
343
- blocks.push(cur);
344
- continue;
345
- }
346
- if (provM) {
347
- cur = { kind: "provision", name: provM[1], body: [] };
348
- inFence = false;
349
- blocks.push(cur);
350
- continue;
351
- }
352
- if (/^<!-- context-fetch:(end|none|start|provision)/.test(line)) {
353
- cur = null;
354
- inFence = false;
355
- continue;
356
- }
357
- if (cur && /^```/.test(line)) {
358
- inFence = !inFence;
359
- continue;
360
- }
361
- if (cur && inFence)
362
- cur.body.push(line);
363
- }
502
+ // Parse the consumer section into named start / provision blocks with fenced bodies.
503
+ const blocks = parseContextFetchBlocks(consumer);
364
504
  const provisionNames = new Set(blocks.filter((b) => b.kind === "provision").map((b) => b.name));
365
505
  const provisionBody = blocks
366
506
  .filter((b) => b.kind === "provision")
@@ -404,3 +544,48 @@ export function detectContextFetchProvisionMissing(cwd) {
404
544
  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.`,
405
545
  };
406
546
  }
547
+ /**
548
+ * Advisory: the consumer section enables a `context-fetch` block whose bash body bounds no
549
+ * output — no row / line cap, page cap or window filter. `/bkit-debug` runs every enabled
550
+ * block and writes its stdout straight into that context's artifact, so an unbounded block
551
+ * downloads a whole-run dump; only the post-hoc 3000-line / 400 KB clamp catches it, and
552
+ * the failure lines a diagnosis needs can fall outside the kept head 500 + tail 1000.
553
+ *
554
+ * Distinct from `context-fetch-missing` (which owns the no-blocks case): this only runs
555
+ * once at least one block exists. The blanket opt-out (`<!-- context-fetch:none intentional -->`)
556
+ * dismisses it; a context-scoped marker (`context-fetch:none e2e`) does not, because the
557
+ * runner still runs a block that is present.
558
+ */
559
+ export function detectContextFetchUnbounded(cwd) {
560
+ const filePath = path.join(cwd, ".agents", "context.md");
561
+ if (!fs.existsSync(filePath))
562
+ return null;
563
+ const content = fs.readFileSync(filePath, "utf-8");
564
+ const endIdx = content.search(/^<!-- bkit:end -->$/m);
565
+ if (endIdx === -1)
566
+ return null;
567
+ const consumer = content.slice(endIdx);
568
+ if (contextFetchDismissesAll(consumer))
569
+ return null;
570
+ // Only the blocks the runner actually runs can download anything: a block whose
571
+ // `context=` is unknown is narrated NOT RUN, and one with no fenced body is refused
572
+ // before it runs (`bkit context list-blocks` / `run-block`). Neither is bounded here.
573
+ const runnable = parseContextFetchBlocks(consumer).filter((b) => b.kind === "start" &&
574
+ CONTEXT_FETCH_CONTEXTS.includes(b.context) &&
575
+ b.body.some((l) => l.trim() !== ""));
576
+ // No runnable block => `context-fetch-missing` owns the empty case (no double-fire).
577
+ if (runnable.length === 0)
578
+ return null;
579
+ const unbounded = runnable.filter((b) => !blockBoundsOutput(b.body));
580
+ if (unbounded.length === 0)
581
+ return null;
582
+ const items = unbounded.map((b) => `${b.name || "(unnamed)"} (\`context=${b.context}\`)`);
583
+ const list = items.join(", ");
584
+ const plural = items.length > 1;
585
+ return {
586
+ id: "context-fetch-unbounded",
587
+ severity: "advisory",
588
+ 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.`,
589
+ 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.`,
590
+ };
591
+ }
@@ -13,7 +13,7 @@ const TRACKER_TOKENS = {
13
13
  description: "Linear personal API key for the Linear MCP server and the Linear preflight hook (generate at https://linear.app/settings/api)",
14
14
  },
15
15
  jira: {
16
- key: "BKIT_JIRA_API_TOKEN",
16
+ key: "BKIT_JIRA_API_KEY",
17
17
  description: '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)',
18
18
  },
19
19
  };
@@ -28,7 +28,7 @@ function tokenKeys(tracker) {
28
28
  * copied it to .bkit/.env and filled in their tokens.
29
29
  */
30
30
  // `tracker` adds its own token to the token prose (`TRACKER_TOKENS`). Defaults to
31
- // `linear`; the real Phase-3 caller passes the consumer's resolved `bkit.issueTracker`.
31
+ // `linear`; the real Phase-3 caller passes the consumer's resolved `bkit.tracker.default`.
32
32
  export function detectMissingDotenv(cwd, tracker = "linear") {
33
33
  const examplePath = path.join(cwd, ".bkit", ".env.example");
34
34
  const envPath = path.join(cwd, ".bkit", ".env");
@@ -41,7 +41,7 @@ export function detectMissingDotenv(cwd, tracker = "linear") {
41
41
  id: "mcp-env-missing-dotenv",
42
42
  severity: "advisory",
43
43
  detect: `.bkit/.env.example exists but .bkit/.env does not. MCP servers and agent tooling will not have access to ${tokens}.`,
44
- 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.`,
44
+ 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.`,
45
45
  };
46
46
  }
47
47
  /**
@@ -7,6 +7,7 @@ import { extractManagedBlock, stripManagedBlock } from "../../install/managed-bl
7
7
  import { readTemplate } from "../../render/parts.js";
8
8
  import { findTemplateSource, getPkgRoot } from "../../shared/package-roots.js";
9
9
  import { parseJson } from "../../shared/json.js";
10
+ import { ciWorkflowPath } from "../../shared/settings.js";
10
11
  /**
11
12
  * Strip out content inside bkit-managed block markers (HTML and slash style).
12
13
  * Used by detectors that need to inspect only consumer-owned content.
@@ -67,11 +68,12 @@ export function detectGitignoreBlockDuplicates(cwd) {
67
68
  * surfaces — pure cost (artifact upload + storage) with zero diagnostic payoff.
68
69
  *
69
70
  * "Hostile" gap per the BAR-224 signal-vs-noise classification. Reads the consumer's
70
- * own bkit-ci.yml, active lines only: YAML comment lines are dropped first, so a commented
71
+ * own CI workflow (`bkit.testing.ciWorkflow`, default `bkit-ci.yml`), active lines only: YAML comment lines are dropped first, so a commented
71
72
  * template stub or a commented-out example never fires.
72
73
  */
73
74
  export function detectPlaywrightReporterHostile(cwd) {
74
- const ciPath = path.join(cwd, ".github", "workflows", "bkit-ci.yml");
75
+ const ciRel = ciWorkflowPath(cwd);
76
+ const ciPath = path.join(cwd, ciRel);
75
77
  if (!fs.existsSync(ciPath))
76
78
  return null;
77
79
  const content = fs.readFileSync(ciPath, "utf-8");
@@ -92,7 +94,7 @@ export function detectPlaywrightReporterHostile(cwd) {
92
94
  return {
93
95
  id: "playwright-reporter-line-override-hostile",
94
96
  severity: "advisory",
95
- detect: ".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.",
97
+ 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.`,
96
98
  action: '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.',
97
99
  };
98
100
  }
@@ -10,12 +10,13 @@
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
  import { readInstallingVersion } from "../../shared/package-json.js";
14
15
  import { readBkitConfig } from "../../shared/settings.js";
15
- import { detectBkitNotOnPath, detectMalformedPackageJson, detectNoPackageJson, detectNotGitRepo, } from "./repo.js";
16
+ import { detectBkitNotOnPath, detectMalformedPackageJson, detectNoPackageJson, detectNotGitRepo, detectInvalidAskSettings, detectBuildPublish, detectInvalidTaskCaps, detectTaskCapFormStale, detectUnmarkedPlans, } from "./repo.js";
16
17
  import { MARKERED_TEXT_DRIFT_PATHS, detectGitignoreBlockDuplicates, detectPlaywrightReporterHostile, detectTier2JsonDrift, detectTier2TextDrift, } from "./files.js";
17
18
  import { detectBkitVersionMajorDowngrade, detectBkitVersionPinStale } from "./version.js";
18
- import { detectContextFetchContextMissing, detectContextFetchMissing, detectContextFetchProvisionMissing, detectContextFetchSourceNotEnabled, } from "./context-fetch.js";
19
+ import { detectContextFetchContextMissing, detectContextFetchMissing, detectContextFetchProvisionMissing, detectContextFetchSourceNotEnabled, detectContextFetchUnbounded, } from "./context-fetch.js";
19
20
  import { detectExtraMcpServers, detectMissingMcpServers } from "./mcp.js";
20
21
  // ---------------------------------------------------------------------------
21
22
  // Internal helper
@@ -42,7 +43,7 @@ export function dedupeById(findings) {
42
43
  * installingVersion: used by detectBkitVersionMajorDowngrade; defaults to the
43
44
  * package's own version read from its package.json at runtime.
44
45
  * issueTracker: when provided, narrows tracker-specific checks (e.g. MCP server
45
- * requirements). When omitted, read from consumer's `bkit.issueTracker` in package.json.
46
+ * requirements). When omitted, read from consumer's `bkit.tracker.default` in package.json.
46
47
  *
47
48
  * GitHub tracker gate: when `issueTracker === "github"`, the Linear preflight
48
49
  * gate is a no-op — the GitHub gate is enforced by workflow Step 1 via MCP.
@@ -87,6 +88,19 @@ export function runPreflight(modules, cwd = process.cwd(), installingVersion, is
87
88
  const versionPinStale = detectBkitVersionPinStale(cwd);
88
89
  if (versionPinStale)
89
90
  advisories.push(versionPinStale);
91
+ const invalidTaskCaps = detectInvalidTaskCaps(cwd);
92
+ if (invalidTaskCaps)
93
+ advisories.push(invalidTaskCaps);
94
+ advisories.push(...detectBuildPublish(cwd));
95
+ const taskCapFormStale = detectTaskCapFormStale(cwd);
96
+ if (taskCapFormStale)
97
+ advisories.push(taskCapFormStale);
98
+ const invalidAsks = detectInvalidAskSettings(cwd);
99
+ if (invalidAsks)
100
+ advisories.push(invalidAsks);
101
+ const unmarkedPlans = detectUnmarkedPlans(cwd);
102
+ if (unmarkedPlans)
103
+ advisories.push(unmarkedPlans);
90
104
  // BAR-224: [verbose ci] marker advisories
91
105
  const playwrightReporterHostile = detectPlaywrightReporterHostile(cwd);
92
106
  if (playwrightReporterHostile)
@@ -103,6 +117,9 @@ export function runPreflight(modules, cwd = process.cwd(), installingVersion, is
103
117
  const contextFetchProvision = detectContextFetchProvisionMissing(cwd);
104
118
  if (contextFetchProvision)
105
119
  advisories.push(contextFetchProvision);
120
+ const contextFetchUnbounded = detectContextFetchUnbounded(cwd);
121
+ if (contextFetchUnbounded)
122
+ advisories.push(contextFetchUnbounded);
106
123
  // bkit-not-on-path advisory — suggest the shell alias for local development.
107
124
  const bkitNotOnPath = detectBkitNotOnPath();
108
125
  if (bkitNotOnPath)
@@ -1,9 +1,11 @@
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
  import * as fs from "node:fs";
4
4
  import * as path from "node:path";
5
5
  import { spawnSync } from "node:child_process";
6
- import { readJsonFile } from "../../shared/json.js";
6
+ import { parsePlanBlocks } from "../../commands/workflow/plan-blocks.js";
7
+ import { parseJson, readJsonFile } from "../../shared/json.js";
8
+ import { ASK_POINTS, CONFIG_DEFAULTS, invalidAskSettings, invalidBuildPublish, invalidTaskCaps, limitKey, readBkitConfig, } from "../../shared/settings.js";
7
9
  import { isCloudOrCi } from "./env.js";
8
10
  // ---------------------------------------------------------------------------
9
11
  // Blocker detectors
@@ -43,6 +45,199 @@ export function detectNotGitRepo(cwd, modules) {
43
45
  action: "Run `git init` to initialise a git repo, then re-run. bkit installs into a git repository — its managed .gitignore/.gitattributes blocks require one (core is implicit; there is no --core flag to omit).",
44
46
  };
45
47
  }
48
+ /**
49
+ * Advisory: `package.json` `bkit.workflows.tasks` holds a plan cap that is not an integer >= 1.
50
+ * Each such key falls back to its default in `readBkitConfig`.
51
+ */
52
+ export function detectInvalidTaskCaps(cwd) {
53
+ const workflows = bkitWorkflows(cwd);
54
+ if (workflows === null)
55
+ return null;
56
+ const bad = invalidTaskCaps(workflows.tasks);
57
+ if (bad.length === 0)
58
+ return null;
59
+ const caps = CONFIG_DEFAULTS.tasks;
60
+ const keys = bad[0] === "tasks" ? Object.keys(caps) : bad;
61
+ const named = bad.map((k) => `\`bkit.workflows.${k === "tasks" ? k : `tasks.${k}`}\``).join(", ");
62
+ return {
63
+ id: "bkit-tasks-invalid",
64
+ severity: "advisory",
65
+ detect: `package.json ${named} is not a whole number of 1 or more, so the plan check uses the default instead.`,
66
+ action: `Set each to a whole number of 1 or more in package.json, or delete it to keep the default: ${keys
67
+ .map((k) => `\`bkit.workflows.tasks.${k}\` (default ${caps[k]})`)
68
+ .join(", ")}.`,
69
+ };
70
+ }
71
+ /**
72
+ * Advisory: `package.json` `bkit.workflows.build.publish` holds a refused or invalid value.
73
+ * `remote: false` is refused (a cloud run always publishes); a non-object block or a
74
+ * non-boolean `local` falls back to its default. One finding per key.
75
+ */
76
+ export function detectBuildPublish(cwd) {
77
+ const workflows = bkitWorkflows(cwd);
78
+ if (workflows === null)
79
+ return [];
80
+ const out = [];
81
+ const publish = workflows.build?.publish;
82
+ if (publish !== null &&
83
+ typeof publish === "object" &&
84
+ !Array.isArray(publish) &&
85
+ publish.remote !== undefined &&
86
+ publish.remote !== true) {
87
+ out.push({
88
+ id: "bkit-build-publish-remote",
89
+ severity: "advisory",
90
+ detect: "package.json `bkit.workflows.build.publish.remote` is not `true`, so a cloud or CI run still publishes.",
91
+ action: "Delete `bkit.workflows.build.publish.remote` or set it to `true`; hold a local build with `bkit.workflows.build.publish.local` set to `false`.",
92
+ });
93
+ }
94
+ const bad = invalidBuildPublish(workflows.build);
95
+ if (bad.length > 0) {
96
+ out.push({
97
+ id: "bkit-build-publish-invalid",
98
+ severity: "advisory",
99
+ 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.`,
100
+ action: "Set `bkit.workflows.build.publish.local` to `true` or `false`, or delete the block to keep the default (`true`).",
101
+ });
102
+ }
103
+ return out;
104
+ }
105
+ const TASK_CAP_KEY = /`bkit\.workflows\.tasks\.(\w+)`/g;
106
+ /**
107
+ * Each `bkit.workflows.tasks.<key>` the text names with a `(default N)` after it, on the same
108
+ * line and before the next named key.
109
+ */
110
+ export function taskCapDefaultsNamed(text) {
111
+ const hits = [...text.matchAll(TASK_CAP_KEY)];
112
+ return hits.flatMap((m, i) => {
113
+ const from = m.index + m[0].length;
114
+ const lineEnd = text.indexOf("\n", from);
115
+ const end = Math.min(hits[i + 1]?.index ?? text.length, lineEnd === -1 ? text.length : lineEnd);
116
+ const n = /\(default (\d+)\)/.exec(text.slice(from, end));
117
+ return n ? [{ key: m[1], value: Number(n[1]) }] : [];
118
+ });
119
+ }
120
+ const CHANGE_FORM = ".github/ISSUE_TEMPLATE/bkit-change.yml";
121
+ /**
122
+ * Advisory: the change issue form names a plan cap with a `(default N)` that differs from the
123
+ * value `readBkitConfig` gives for that key.
124
+ */
125
+ export function detectTaskCapFormStale(cwd) {
126
+ const file = path.join(cwd, CHANGE_FORM);
127
+ if (!fs.existsSync(file))
128
+ return null;
129
+ const caps = readBkitConfig(cwd).tasks;
130
+ const isCap = (k) => Object.hasOwn(caps, k);
131
+ const stale = new Map();
132
+ for (const { key, value } of taskCapDefaultsNamed(fs.readFileSync(file, "utf-8"))) {
133
+ if (isCap(key) && caps[key] !== value)
134
+ stale.set(key, value);
135
+ }
136
+ if (stale.size === 0)
137
+ return null;
138
+ const rows = [...stale];
139
+ return {
140
+ id: "bkit-tasks-form-stale",
141
+ severity: "advisory",
142
+ detect: `${CHANGE_FORM} shows plan caps that differ from package.json: ${rows
143
+ .map(([k, v]) => `\`bkit.workflows.tasks.${k}\` (default ${v}) is ${caps[k]}`)
144
+ .join(", ")}.`,
145
+ action: `In ${CHANGE_FORM}, change the number in each "(default N)" after the key: ${rows
146
+ .map(([k, v]) => `\`bkit.workflows.tasks.${k}\` "(default ${v})" → "(default ${caps[k]})"`)
147
+ .join(", ")}. Or set the key in package.json \`bkit.workflows.tasks\` to the number the form shows.`,
148
+ };
149
+ }
150
+ /** `package.json` `bkit.workflows` as an object; null when the file or block is unusable. */
151
+ function bkitWorkflows(cwd) {
152
+ const read = readJsonFile(path.join(cwd, "package.json"));
153
+ if (!read.ok)
154
+ return null;
155
+ const bkit = read.value?.bkit;
156
+ if (bkit === null || typeof bkit !== "object" || Array.isArray(bkit))
157
+ return null;
158
+ const workflows = bkit.workflows;
159
+ return workflows !== null && typeof workflows === "object" && !Array.isArray(workflows)
160
+ ? workflows
161
+ : {};
162
+ }
163
+ /**
164
+ * Advisory when a `bkit.workflows.<workflow>.<point>` block holds an `ask` that is not
165
+ * true/false, a limit that is not a whole number of 1 or more, or is not an object. Each such
166
+ * key falls back to its default in `readBkitConfig`.
167
+ */
168
+ export function detectInvalidAskSettings(cwd) {
169
+ const workflows = bkitWorkflows(cwd);
170
+ if (workflows === null)
171
+ return null;
172
+ const bad = invalidAskSettings(workflows);
173
+ if (bad.length === 0)
174
+ return null;
175
+ const defaults = bad.map((k) => {
176
+ const point = ASK_POINTS.find((p) => k === p || k.startsWith(`${p}.`));
177
+ const d = CONFIG_DEFAULTS.asks[point];
178
+ return `\`bkit.workflows.${point}\` (default \`{ "ask": ${d.ask}, "${limitKey(point)}": ${d.max} }\`)`;
179
+ });
180
+ return {
181
+ id: "bkit-ask-settings-invalid",
182
+ severity: "advisory",
183
+ 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.`,
184
+ action: `Fix or delete each in package.json: ${[...new Set(defaults)].join(", ")}.`,
185
+ };
186
+ }
187
+ const PLAN_FILE = /^(.+)-plan\.md$/;
188
+ /** The FID's `docs/plans/{month}/logs/{FID}/status.jsonl` holds a ship `workflow-done` row. */
189
+ function fidShipped(monthDir, fid) {
190
+ const file = path.join(monthDir, "logs", fid, "status.jsonl");
191
+ if (!fs.existsSync(file))
192
+ return false;
193
+ return fs
194
+ .readFileSync(file, "utf-8")
195
+ .split("\n")
196
+ .some((line) => {
197
+ const row = parseJson(line);
198
+ if (!row.ok || typeof row.value !== "object" || row.value === null)
199
+ return false;
200
+ const { type, workflow } = row.value;
201
+ return type === "workflow-done" && workflow === "ship";
202
+ });
203
+ }
204
+ /**
205
+ * Advisory: a `docs/plans/{YYYYMM}/{FID}-plan.md` whose FID has not shipped holds no task
206
+ * blocks, so `/bkit-build` Step 3 converts it on the FID's next build. `archive/` and
207
+ * `logs/` sit below the month folder and are not read.
208
+ */
209
+ export function detectUnmarkedPlans(cwd) {
210
+ const plans = path.join(cwd, "docs", "plans");
211
+ if (!fs.existsSync(plans))
212
+ return null;
213
+ const unmarked = [];
214
+ for (const month of fs.readdirSync(plans, { withFileTypes: true })) {
215
+ if (!month.isDirectory())
216
+ continue;
217
+ const monthDir = path.join(plans, month.name);
218
+ for (const entry of fs.readdirSync(monthDir, { withFileTypes: true })) {
219
+ const fid = entry.isFile() ? PLAN_FILE.exec(entry.name)?.[1] : undefined;
220
+ if (fid === undefined)
221
+ continue;
222
+ const text = fs.readFileSync(path.join(monthDir, entry.name), "utf-8");
223
+ if (parsePlanBlocks(text).tasks.length > 0 || fidShipped(monthDir, fid))
224
+ continue;
225
+ unmarked.push(`docs/plans/${month.name}/${entry.name}`);
226
+ }
227
+ }
228
+ if (unmarked.length === 0)
229
+ return null;
230
+ unmarked.sort();
231
+ const one = unmarked.length === 1;
232
+ return {
233
+ id: "plan-task-markers-missing",
234
+ severity: "advisory",
235
+ 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
236
+ .map((p) => `\`${p}\``)
237
+ .join(", ")}.`,
238
+ action: "Nothing to do by hand: this matters only for builds still to run, and plans of shipped FIDs are not listed.",
239
+ };
240
+ }
46
241
  /**
47
242
  * Advisory: `bkit` is not on PATH.
48
243
  * bkit is a devDependency — without a shell alias, every invocation requires