@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
@@ -11,8 +11,7 @@ import { runCommand } from "./commands/lib.js";
11
11
  import { launchApp } from "./commands/launch.js";
12
12
  import { runStatus, runDoctor } from "./commands/install/doctor.js";
13
13
  import { runComplyCommand } from "./commands/comply.js";
14
- import { runHarvestCommand } from "./commands/harvest.js";
15
- import { runAnalysisCommand } from "./commands/analysis.js";
14
+ import { runStatsCommand } from "./commands/stats.js";
16
15
  import { runTelemetryCommand } from "./commands/telemetry.js";
17
16
  import { runTipsCommand } from "./commands/tips.js";
18
17
  import { runUpgradeCommand } from "./commands/install/upgrade.js";
@@ -47,8 +46,7 @@ export const CLASSIC_VERBS: ReadonlySet<string> = new Set([
47
46
  "uninstall",
48
47
  "upgrade",
49
48
  "comply",
50
- "harvest",
51
- "analysis",
49
+ "stats",
52
50
  "telemetry",
53
51
  "tips",
54
52
  "cursor",
@@ -66,8 +64,7 @@ export type Verb =
66
64
  | "cursor"
67
65
  | "opencode"
68
66
  | "comply"
69
- | "harvest"
70
- | "analysis"
67
+ | "stats"
71
68
  | "telemetry"
72
69
  | "tips"
73
70
  | "help";
@@ -260,24 +257,12 @@ export function parseArgs(argv: string[]): ParsedArgs {
260
257
  } else if (firstArg === "comply") {
261
258
  verb = "comply";
262
259
  args.shift();
263
- } else if (firstArg === "harvest") {
264
- verb = "harvest";
260
+ } else if (firstArg === "stats") {
261
+ verb = "stats";
265
262
  args.shift();
266
- // harvest takes no flags — reject any remaining args
263
+ // stats takes no flags — reject any remaining positional args
267
264
  if (args.length > 0 && !args[0]?.startsWith("-")) {
268
- console.error(
269
- `[bkit] \`bkit harvest\` takes no positional args. Run \`bkit help\` for usage.`,
270
- );
271
- process.exit(1);
272
- }
273
- } else if (firstArg === "analysis") {
274
- verb = "analysis";
275
- args.shift();
276
- // analysis takes no flags — reject any remaining positional args
277
- if (args.length > 0 && !args[0]?.startsWith("-")) {
278
- console.error(
279
- `[bkit] \`bkit analysis\` takes no positional args. Run \`bkit help\` for usage.`,
280
- );
265
+ console.error(`[bkit] \`bkit stats\` takes no positional args. Run \`bkit help\` for usage.`);
281
266
  process.exit(1);
282
267
  }
283
268
  } else if (firstArg === "telemetry") {
@@ -580,106 +565,245 @@ export function parseArgs(argv: string[]): ParsedArgs {
580
565
  };
581
566
  }
582
567
 
568
+ /** One `bkit <verb>` entry of the usage text; `.bkit/cli.md` renders the same list. */
569
+ export interface ClassicVerbHelp {
570
+ verb: Verb;
571
+ /** What follows the verb on its usage line. */
572
+ args: string;
573
+ /** One line for the `.bkit/cli.md` table. */
574
+ summary: string;
575
+ /** Every flag the verb takes. */
576
+ flags: readonly string[];
577
+ /** The usage text's description, one printed line each. */
578
+ detail: readonly string[];
579
+ }
580
+
581
+ export const CLASSIC_VERB_HELP: readonly ClassicVerbHelp[] = [
582
+ {
583
+ verb: "install",
584
+ args: "<module-flags>",
585
+ summary: "Install or re-sync the named modules plus the core files.",
586
+ flags: [
587
+ "--claude",
588
+ "--codex",
589
+ "--antigravity",
590
+ "--cursor",
591
+ "--opencode=<provider>",
592
+ "--auto=<claude|cursor|opencode>",
593
+ "--tracker=<name>",
594
+ "--auto-revert",
595
+ ],
596
+ detail: [
597
+ "Install (or re-sync) the named modules + the implicit",
598
+ "core foundation. At least one module flag is REQUIRED —",
599
+ "a bare `bkit install` errors (name the modules below).",
600
+ "Hosts compose: --claude --codex --antigravity --cursor",
601
+ "--opencode=<provider>.",
602
+ ],
603
+ },
604
+ {
605
+ verb: "check",
606
+ args: "",
607
+ summary: "Drift gate: exit 1 when a managed file needs re-rendering. The CI gate.",
608
+ flags: [],
609
+ detail: [
610
+ "Dry-run — drift-check everything already installed (no",
611
+ "module flags). Exits 1 when a managed file needs",
612
+ "re-rendering. Copies under .bkit/templates/ are refreshed by",
613
+ "install/upgrade and checked for staleness — adopt one by",
614
+ "copying it elsewhere; that copy is yours. The CI gate.",
615
+ "Changes no managed file; rewrites .bkit/advisories.md.",
616
+ ],
617
+ },
618
+ {
619
+ verb: "upgrade",
620
+ args: "[--to=<version>|--latest] [--auto-apply] [--dry-run]",
621
+ summary: "Re-render everything installed; --to / --latest bump @cbartens/bkit first.",
622
+ flags: ["--to=<version>", "--latest", "--auto-apply", "--dry-run"],
623
+ detail: [
624
+ "Upgrade everything installed (no module flags). Diffs old",
625
+ "vs new templates; conflict list emitted to stderr. Use",
626
+ "--auto-apply for CI (apply non-conflicting; exit non-zero",
627
+ "on any conflict). Only a whole file you edited since bkit",
628
+ "wrote it conflicts; rendered files (agents, commands,",
629
+ "skills, .bkit/*.md) are always re-rendered — bkit check",
630
+ "flags an edit to one.",
631
+ "--to=<version> / --latest atomically BUMP @cbartens/bkit",
632
+ "(pnpm add), then re-render + re-pin in one step — so a",
633
+ "version bump can never drift from its rendered mirrors.",
634
+ "This is the supported way to move bkit versions; a bare",
635
+ "`pnpm add @cbartens/bkit` alone leaves mirrors stale.",
636
+ ],
637
+ },
638
+ {
639
+ verb: "uninstall",
640
+ args: "[module-flags]",
641
+ summary: "Remove bkit-managed files and strip managed blocks; no flags = everything.",
642
+ flags: [
643
+ "--claude",
644
+ "--codex",
645
+ "--antigravity",
646
+ "--cursor",
647
+ "--opencode=<provider>",
648
+ "--auto=<claude|cursor|opencode>",
649
+ "--dry-run",
650
+ "--force",
651
+ "--nuke",
652
+ "--yes",
653
+ ],
654
+ detail: [
655
+ "Remove bkit-managed files + strip managed blocks.",
656
+ "No flags = full removal — ALL modules incl. opt-in add-ons",
657
+ "(cloud/opencode) + core. Consumer-owned updater configs",
658
+ "(renovate.json5, dependabot.yml, bkit-renovate.yml) are left in place. Consumer-modified",
659
+ "files, your own files under docs/, and generated artefacts",
660
+ "(.bkit/advisories.md, .bkit/friction.jsonl) are preserved (use",
661
+ "--nuke to force-remove manifest-listed files). Target with the",
662
+ "same module flags as install (e.g. uninstall --claude); a",
663
+ "targeted uninstall leaves core untouched.",
664
+ ],
665
+ },
666
+ {
667
+ verb: "doctor",
668
+ args: "",
669
+ summary: "Preflight and advisory replay; rewrites .bkit/advisories.md only. Exits 0.",
670
+ flags: [],
671
+ detail: [
672
+ "Preflight + post-install advisory replay (changes no",
673
+ "managed file; rewrites .bkit/advisories.md). Diagnose",
674
+ "token surfaces and config drift. Exits 0.",
675
+ ],
676
+ },
677
+ {
678
+ verb: "tips",
679
+ args: "[--workflow=<name>] [--all]",
680
+ summary: "What this repo has not set up yet, most useful first. Exits 0.",
681
+ flags: ["--workflow=<name>", "--all"],
682
+ detail: [
683
+ "Setup tips: what this repo has not set up yet, most useful",
684
+ "first, each with a sentence to ask your agent. Top three",
685
+ "by default; --workflow=design|plan|build|debug|ship puts",
686
+ "the tips that matter there first and prints one (each",
687
+ "workflow runs this at its close; audit and utility do the",
688
+ "same for audits and the ledger / roadmap updaters);",
689
+ '--all lists every one. Ends with a star line ("bkit-star"',
690
+ "in bkit.advisories.ignore silences it), except under",
691
+ "--workflow=audit|utility. Local checks only. Exits 0.",
692
+ ],
693
+ },
694
+ {
695
+ verb: "status",
696
+ args: "",
697
+ summary: "Current host and provider. Writes nothing. Exits 0.",
698
+ flags: [],
699
+ detail: [
700
+ "Read-only host/provider status. Reports current host+provider",
701
+ "(sampled from .claude/, .cursor/, package.json, and the",
702
+ "opencode agent model pins in .opencode/agents/).",
703
+ "Writes nothing. Exits 0.",
704
+ ],
705
+ },
706
+ {
707
+ verb: "cursor",
708
+ args: "",
709
+ summary: "Launch Cursor with .bkit/.env loaded into its environment.",
710
+ flags: [],
711
+ detail: [
712
+ "Launch Cursor with .bkit/.env loaded into its environment.",
713
+ "macOS GUI apps launched from the Dock/Finder do not inherit",
714
+ "the login shell env (direnv stays shell-only), so MCP token",
715
+ "placeholders resolve empty. This verb execs the app binary",
716
+ "directly with the per-repo .bkit/.env merged in. Quit Cursor",
717
+ "before running — a running instance ignores the new env.",
718
+ "Override binary path via BKIT_CURSOR_BIN=<path>.",
719
+ ],
720
+ },
721
+ {
722
+ verb: "opencode",
723
+ args: "",
724
+ summary: "Launch the OpenCode desktop app with .bkit/.env loaded.",
725
+ flags: [],
726
+ detail: [
727
+ "Same as `bkit cursor` but for the OpenCode desktop app.",
728
+ "Override binary path via BKIT_OPENCODE_BIN=<path>.",
729
+ ],
730
+ },
731
+ {
732
+ verb: "comply",
733
+ args: "--phase=<phase>",
734
+ summary: "Compliance grader for one workflow phase; appends stats rows. Exits 0.",
735
+ flags: ["--phase=<phase>"],
736
+ detail: [
737
+ "Run the compliance grader advisory step.",
738
+ "Checks the diff since parentSha for violations",
739
+ "(no-mirror-edit, skip-ci-not-head). Advisory only —",
740
+ 'never gates a workflow. Appends kind:"compliance"',
741
+ "rows to .bkit/stats.jsonl. Fail-open: always exits 0.",
742
+ "Valid phases: design, plan, build, debug, ship.",
743
+ ],
744
+ },
745
+ {
746
+ verb: "telemetry",
747
+ args: "summary [--phase=<workflow>]",
748
+ summary: "One workflow run's metrics against the median of the previous five. Exits 0.",
749
+ flags: ["--phase=<workflow>"],
750
+ detail: [
751
+ "Per-workflow telemetry report: THIS run's metrics",
752
+ "(duration, size, friction/deferrals/failures added,",
753
+ "compliance) against med·5 — the median of the previous 5",
754
+ "same-workflow runs. The close step of every /bkit-*",
755
+ "workflow calls this and posts it to the tracker comment.",
756
+ "--phase=<workflow>: the workflow to report",
757
+ "(design|plan|build|debug|ship). Without it, prints the",
758
+ "ledger-health line only. Read-only: exits 0.",
759
+ ],
760
+ },
761
+ {
762
+ verb: "stats",
763
+ args: "",
764
+ summary: "This repo's stats report, written to .bkit/stats.md. Exits 0.",
765
+ flags: [],
766
+ detail: [
767
+ "This repo's stats report: counts, durations, change-size vs",
768
+ "outcome, counterSource trust, per-rule and per-version",
769
+ "compliance, and the unjustified-deferral rate per",
770
+ "(subagent, model). Reads .bkit/stats.jsonl,",
771
+ ".bkit/friction.jsonl and docs/deferrals.jsonl of THIS repo",
772
+ "only; writes .bkit/stats.md and prints it.",
773
+ "Advisory + inform-only: exits 0.",
774
+ ],
775
+ },
776
+ {
777
+ verb: "help",
778
+ args: "",
779
+ summary: "Print the usage text.",
780
+ flags: [],
781
+ detail: ["Print this message."],
782
+ },
783
+ ];
784
+
785
+ /** Usage line width: a synopsis up to this long shares its line with the first detail line. */
786
+ const SYNOPSIS_WIDTH = 29;
787
+
788
+ /** The usage text's `bkit <verb>` list, rendered from `CLASSIC_VERB_HELP`. */
789
+ function classicUsage(): string {
790
+ const indent = " ".repeat(SYNOPSIS_WIDTH + 4);
791
+ return CLASSIC_VERB_HELP.flatMap(({ verb, args, detail }) => {
792
+ const synopsis = `bkit ${verb}${args ? ` ${args}` : ""}`;
793
+ if (synopsis.length > SYNOPSIS_WIDTH) {
794
+ return [` ${synopsis}`, ...detail.map((d) => indent + d)];
795
+ }
796
+ const [first = "", ...rest] = detail;
797
+ return [` ${synopsis.padEnd(SYNOPSIS_WIDTH)} ${first}`, ...rest.map((d) => indent + d)];
798
+ }).join("\n");
799
+ }
800
+
583
801
  export function printUsage(): void {
584
802
  console.log(
585
803
  `bkit — agent-stack consolidation CLI
586
804
 
587
805
  Usage:
588
- bkit install <module-flags> Install (or re-sync) the named modules + the implicit
589
- core foundation. At least one module flag is REQUIRED —
590
- a bare \`bkit install\` errors (name the modules below).
591
- Hosts compose: --claude --cursor --codex --antigravity
592
- --opencode=<provider>.
593
- bkit check Dry-run — drift-check everything already installed (no
594
- module flags). Exits 1 when a managed file needs
595
- re-rendering. Copies under .bkit/templates/ are refreshed by
596
- install/upgrade and checked for staleness — adopt one by
597
- copying it elsewhere; that copy is yours. The CI gate.
598
- Changes no managed file; rewrites .bkit/advisories.md.
599
- bkit upgrade [--to=<version>|--latest] [--auto-apply] [--dry-run]
600
- Upgrade everything installed (no module flags). Diffs old
601
- vs new templates; conflict list emitted to stderr. Use
602
- --auto-apply for CI (apply non-conflicting; exit non-zero
603
- on any conflict). Only a whole file you edited since bkit
604
- wrote it conflicts; rendered files (agents, commands,
605
- skills, .bkit/*.md) are always re-rendered — bkit check
606
- flags an edit to one.
607
- --to=<version> / --latest atomically BUMP @cbartens/bkit
608
- (pnpm add), then re-render + re-pin in one step — so a
609
- version bump can never drift from its rendered mirrors.
610
- This is the supported way to move bkit versions; a bare
611
- \`pnpm add @cbartens/bkit\` alone leaves mirrors stale.
612
- bkit uninstall [module-flags] Remove bkit-managed files + strip managed blocks.
613
- No flags = full removal — ALL modules incl. opt-in add-ons
614
- (cloud/opencode) + core. Consumer-owned updater configs
615
- (renovate.json5, dependabot.yml, bkit-renovate.yml) are left in place. Consumer-modified
616
- files, your own files under docs/, and generated artefacts
617
- (.bkit/advisories.md, .bkit/friction.jsonl) are preserved (use
618
- --nuke to force-remove manifest-listed files). Target with the
619
- same module flags as install (e.g. uninstall --claude); a
620
- targeted uninstall leaves core untouched.
621
- bkit doctor Preflight + post-install advisory replay (changes no
622
- managed file; rewrites .bkit/advisories.md). Diagnose
623
- token surfaces and config drift. Exits 0.
624
- bkit tips [--workflow=<name>] [--all]
625
- Setup tips: what this repo has not set up yet, most useful
626
- first, each with a sentence to ask your agent. Top three
627
- by default; --workflow=design|plan|build|debug|ship puts
628
- the tips that matter there first and prints one (each
629
- workflow runs this at its close; audit and utility do the
630
- same for audits and the ledger / roadmap updaters);
631
- --all lists every one. Ends with a star line ("bkit-star"
632
- in bkit.ignoreAdvisories silences it), except under
633
- --workflow=audit|utility. Local checks only. Exits 0.
634
- bkit status Read-only host/provider status. Reports current host+provider
635
- (sampled from .claude/, .cursor/, package.json, and the
636
- opencode agent model pins in .opencode/agents/).
637
- Writes nothing. Exits 0.
638
- bkit cursor Launch Cursor with .bkit/.env loaded into its environment.
639
- macOS GUI apps launched from the Dock/Finder do not inherit
640
- the login shell env (direnv stays shell-only), so MCP token
641
- placeholders resolve empty. This verb execs the app binary
642
- directly with the per-repo .bkit/.env merged in. Quit Cursor
643
- before running — a running instance ignores the new env.
644
- Override binary path via BKIT_CURSOR_BIN=<path>.
645
- bkit opencode Same as \`bkit cursor\` but for the opencode desktop app.
646
- Override binary path via BKIT_OPENCODE_BIN=<path>.
647
- bkit comply --phase=<phase> Run the compliance grader advisory step.
648
- Checks the diff since parentSha for violations
649
- (no-mirror-edit, skip-ci-not-head). Advisory only —
650
- never gates a workflow. Appends kind:"compliance"
651
- rows to .bkit/stats.jsonl. Fail-open: always exits 0.
652
- Valid phases: design, plan, build, debug, ship.
653
- bkit harvest Cross-repo harvest — COPIES consumer .bkit/stats.jsonl
654
- and MOVES .bkit/friction.jsonl into harvest/ (COUNT-ONLY
655
- for docs/deferrals.jsonl and docs/failures.jsonl).
656
- Reads consumer paths from harvest/consumers.md.
657
- DESTRUCTIVE: harvested friction rows are REMOVED from
658
- the consumer, but only after they are fsync'd and read
659
- back from harvest/. stats.jsonl is never modified.
660
- harvest/ accumulates and is never cleared; it is
661
- gitignored, so it is the only record of pruned rows —
662
- back it up. Never commits
663
- in any repo. Deduplicates by per-kind composite
664
- identity. Advisory + fail-open: exits 0.
665
- bkit telemetry summary [--phase=<workflow>]
666
- Per-workflow telemetry report: THIS run's metrics
667
- (duration, size, friction/deferrals/failures added,
668
- compliance) against med·5 — the median of the previous 5
669
- same-workflow runs. The close step of every /bkit-*
670
- workflow calls this and posts it to the tracker comment.
671
- --phase=<workflow>: the workflow to report
672
- (design|plan|build|debug|ship). Without it, prints the
673
- ledger-health line only. Read-only: exits 0.
674
- bkit analysis Cross-repo analysis — reports counts/rates/elapsed-time,
675
- change-size vs outcome regression, dispatch-size threshold,
676
- counterSource trust labelling, per-rule compliance
677
- rate over kind:"compliance" rows, and the
678
- unjustified-deferral rate per (subagent, model)
679
- over kind:"deferral" rows. Reads from harvest/,
680
- .bkit/stats.jsonl and docs/deferrals.jsonl.
681
- Advisory + inform-only: exits 0.
682
- bkit help Print this message.
806
+ ${classicUsage()}
683
807
 
684
808
  Core (implicit — no flag; installed/upgraded on every install):
685
809
  AGENTS.md (cross-host dispatch router), .agents/rules.md + .agents/context.md +
@@ -687,7 +811,7 @@ Core (implicit — no flag; installed/upgraded on every install):
687
811
  .gitattributes managed blocks, docs/, .bkit/*.md, .bkit/version, the template copies in
688
812
  .bkit/templates/, and the bkit:gate:* / bkit:deps:* package.json scripts every workflow
689
813
  runs (added when missing, never overwritten, left by uninstall). The tool scripts those
690
- gates chain (typecheck, lint, format:check, lint:prose, slop:delta) and their devDeps are
814
+ gates chain (typecheck, lint, format:check, bkit:lint:prose, bkit:slop:delta) and their devDeps are
691
815
  yours to add: see .bkit/templates.md.
692
816
 
693
817
  Module flags (composable; symmetric install ↔ uninstall):
@@ -705,7 +829,7 @@ Module flags (composable; symmetric install ↔ uninstall):
705
829
  Ships .opencode/** (agents, commands, opencode.json, bkit-gateguard.js,
706
830
  bkit-readguard.js).
707
831
  Configure your provider key; verify with \`bkit doctor\`. All installed
708
- providers tracked in bkit.opencodeProviders.
832
+ providers tracked in bkit.providers.opencode.installed.
709
833
  --codex Codex CLI host. BARE flag — takes no value: Codex runs on one gateway
710
834
  (openai), so only --opencode is provider-pluggable. Ships .codex/agents/*.toml
711
835
  + .codex/hooks.json + .codex/hooks/bkit-{gateguard,guardrails,readguard}.cjs,
@@ -723,6 +847,8 @@ Dependency updaters (copy an example and own it):
723
847
  .bkit/templates/.github/renovate.json5
724
848
  .bkit/templates/.github/workflows/bkit-renovate.yml (self-hosted runner, optional)
725
849
  .bkit/templates/.github/dependabot.yml
850
+ Install records the one present in bkit.dependencies.updater; bkit check
851
+ blocks when that value and the configs disagree.
726
852
  All templates and install steps: .bkit/templates.md
727
853
 
728
854
  --auto=<claude|cursor|opencode>
@@ -736,7 +862,7 @@ Dependency updaters (copy an example and own it):
736
862
 
737
863
  Cross-cutting / modifiers:
738
864
  --tracker=<name> Wire issue tracker integration. Values: github, linear, jira, none
739
- (default). Records bkit.issueTracker in package.json and substitutes
865
+ (default). Records bkit.tracker.default in package.json and substitutes
740
866
  tracker snippets into command mirrors. Re-renders every installed
741
867
  host, and works alone (bkit install --tracker=github). Switching is
742
868
  free; a switch removes the old linear or jira MCP entry unless you
@@ -754,7 +880,7 @@ Uninstall flags:
754
880
  --dry-run Print decision table (FILE / DECISION / REASON) without writing.
755
881
  --opencode=<provider>
756
882
  Surgical provider removal: removes that provider's block from
757
- opencode.json + drops it from bkit.opencodeProviders. Does NOT remove
883
+ opencode.json + drops it from bkit.providers.opencode.installed. Does NOT remove
758
884
  agents/commands/gateguard. If the removed provider was active, the first
759
885
  remaining provider becomes active and the agents are re-rendered to its
760
886
  model pins.
@@ -802,7 +928,7 @@ function commandsUsage(): string {
802
928
  return [
803
929
  "",
804
930
  "",
805
- "Workflow commands (bkit <noun> <verb> --flags; JSON on stdout; bkit <noun> --help):",
931
+ "Workflow commands (bkit <noun> <verb> --flags; text on stdout, --json for JSON; bkit <noun> --help):",
806
932
  ...COMMANDS.map((c) => ` bkit ${c.noun.padEnd(width)} ${c.summary}`),
807
933
  ].join("\n");
808
934
  }
@@ -823,7 +949,7 @@ export function validateModuleFlagsForVerb(
823
949
  if (verb === "install" && moduleFlags.size === 0 && tracker === null) {
824
950
  return (
825
951
  "[bkit] `bkit install` requires at least one module flag. Name what to install: " +
826
- "--claude, --cursor, --codex, --antigravity, --opencode=<provider> (plus opt-in " +
952
+ "--claude, --codex, --antigravity, --cursor, --opencode=<provider> (plus opt-in " +
827
953
  `--auto=<${CLOUD_VARIANTS.join("|")}>), or --tracker=<name> alone to switch the ` +
828
954
  "tracker on what is installed. Run `bkit help` for usage."
829
955
  );
@@ -884,13 +1010,8 @@ export async function main() {
884
1010
  return;
885
1011
  }
886
1012
 
887
- if (verb === "harvest") {
888
- runHarvestCommand();
889
- return;
890
- }
891
-
892
- if (verb === "analysis") {
893
- runAnalysisCommand();
1013
+ if (verb === "stats") {
1014
+ runStatsCommand();
894
1015
  return;
895
1016
  }
896
1017