@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
package/dist/cli.js CHANGED
@@ -10,8 +10,7 @@ import { runCommand } from "./commands/lib.js";
10
10
  import { launchApp } from "./commands/launch.js";
11
11
  import { runStatus, runDoctor } from "./commands/install/doctor.js";
12
12
  import { runComplyCommand } from "./commands/comply.js";
13
- import { runHarvestCommand } from "./commands/harvest.js";
14
- import { runAnalysisCommand } from "./commands/analysis.js";
13
+ import { runStatsCommand } from "./commands/stats.js";
15
14
  import { runTelemetryCommand } from "./commands/telemetry.js";
16
15
  import { runTipsCommand } from "./commands/tips.js";
17
16
  import { runUpgradeCommand } from "./commands/install/upgrade.js";
@@ -39,8 +38,7 @@ export const CLASSIC_VERBS = new Set([
39
38
  "uninstall",
40
39
  "upgrade",
41
40
  "comply",
42
- "harvest",
43
- "analysis",
41
+ "stats",
44
42
  "telemetry",
45
43
  "tips",
46
44
  "cursor",
@@ -149,21 +147,12 @@ export function parseArgs(argv) {
149
147
  verb = "comply";
150
148
  args.shift();
151
149
  }
152
- else if (firstArg === "harvest") {
153
- verb = "harvest";
150
+ else if (firstArg === "stats") {
151
+ verb = "stats";
154
152
  args.shift();
155
- // harvest takes no flags — reject any remaining args
153
+ // stats takes no flags — reject any remaining positional args
156
154
  if (args.length > 0 && !args[0]?.startsWith("-")) {
157
- console.error(`[bkit] \`bkit harvest\` takes no positional args. Run \`bkit help\` for usage.`);
158
- process.exit(1);
159
- }
160
- }
161
- else if (firstArg === "analysis") {
162
- verb = "analysis";
163
- args.shift();
164
- // analysis takes no flags — reject any remaining positional args
165
- if (args.length > 0 && !args[0]?.startsWith("-")) {
166
- console.error(`[bkit] \`bkit analysis\` takes no positional args. Run \`bkit help\` for usage.`);
155
+ console.error(`[bkit] \`bkit stats\` takes no positional args. Run \`bkit help\` for usage.`);
167
156
  process.exit(1);
168
157
  }
169
158
  }
@@ -424,105 +413,228 @@ export function parseArgs(argv) {
424
413
  tipsWorkflow,
425
414
  };
426
415
  }
416
+ export const CLASSIC_VERB_HELP = [
417
+ {
418
+ verb: "install",
419
+ args: "<module-flags>",
420
+ summary: "Install or re-sync the named modules plus the core files.",
421
+ flags: [
422
+ "--claude",
423
+ "--codex",
424
+ "--antigravity",
425
+ "--cursor",
426
+ "--opencode=<provider>",
427
+ "--auto=<claude|cursor|opencode>",
428
+ "--tracker=<name>",
429
+ "--auto-revert",
430
+ ],
431
+ detail: [
432
+ "Install (or re-sync) the named modules + the implicit",
433
+ "core foundation. At least one module flag is REQUIRED —",
434
+ "a bare `bkit install` errors (name the modules below).",
435
+ "Hosts compose: --claude --codex --antigravity --cursor",
436
+ "--opencode=<provider>.",
437
+ ],
438
+ },
439
+ {
440
+ verb: "check",
441
+ args: "",
442
+ summary: "Drift gate: exit 1 when a managed file needs re-rendering. The CI gate.",
443
+ flags: [],
444
+ detail: [
445
+ "Dry-run — drift-check everything already installed (no",
446
+ "module flags). Exits 1 when a managed file needs",
447
+ "re-rendering. Copies under .bkit/templates/ are refreshed by",
448
+ "install/upgrade and checked for staleness — adopt one by",
449
+ "copying it elsewhere; that copy is yours. The CI gate.",
450
+ "Changes no managed file; rewrites .bkit/advisories.md.",
451
+ ],
452
+ },
453
+ {
454
+ verb: "upgrade",
455
+ args: "[--to=<version>|--latest] [--auto-apply] [--dry-run]",
456
+ summary: "Re-render everything installed; --to / --latest bump @cbartens/bkit first.",
457
+ flags: ["--to=<version>", "--latest", "--auto-apply", "--dry-run"],
458
+ detail: [
459
+ "Upgrade everything installed (no module flags). Diffs old",
460
+ "vs new templates; conflict list emitted to stderr. Use",
461
+ "--auto-apply for CI (apply non-conflicting; exit non-zero",
462
+ "on any conflict). Only a whole file you edited since bkit",
463
+ "wrote it conflicts; rendered files (agents, commands,",
464
+ "skills, .bkit/*.md) are always re-rendered — bkit check",
465
+ "flags an edit to one.",
466
+ "--to=<version> / --latest atomically BUMP @cbartens/bkit",
467
+ "(pnpm add), then re-render + re-pin in one step — so a",
468
+ "version bump can never drift from its rendered mirrors.",
469
+ "This is the supported way to move bkit versions; a bare",
470
+ "`pnpm add @cbartens/bkit` alone leaves mirrors stale.",
471
+ ],
472
+ },
473
+ {
474
+ verb: "uninstall",
475
+ args: "[module-flags]",
476
+ summary: "Remove bkit-managed files and strip managed blocks; no flags = everything.",
477
+ flags: [
478
+ "--claude",
479
+ "--codex",
480
+ "--antigravity",
481
+ "--cursor",
482
+ "--opencode=<provider>",
483
+ "--auto=<claude|cursor|opencode>",
484
+ "--dry-run",
485
+ "--force",
486
+ "--nuke",
487
+ "--yes",
488
+ ],
489
+ detail: [
490
+ "Remove bkit-managed files + strip managed blocks.",
491
+ "No flags = full removal — ALL modules incl. opt-in add-ons",
492
+ "(cloud/opencode) + core. Consumer-owned updater configs",
493
+ "(renovate.json5, dependabot.yml, bkit-renovate.yml) are left in place. Consumer-modified",
494
+ "files, your own files under docs/, and generated artefacts",
495
+ "(.bkit/advisories.md, .bkit/friction.jsonl) are preserved (use",
496
+ "--nuke to force-remove manifest-listed files). Target with the",
497
+ "same module flags as install (e.g. uninstall --claude); a",
498
+ "targeted uninstall leaves core untouched.",
499
+ ],
500
+ },
501
+ {
502
+ verb: "doctor",
503
+ args: "",
504
+ summary: "Preflight and advisory replay; rewrites .bkit/advisories.md only. Exits 0.",
505
+ flags: [],
506
+ detail: [
507
+ "Preflight + post-install advisory replay (changes no",
508
+ "managed file; rewrites .bkit/advisories.md). Diagnose",
509
+ "token surfaces and config drift. Exits 0.",
510
+ ],
511
+ },
512
+ {
513
+ verb: "tips",
514
+ args: "[--workflow=<name>] [--all]",
515
+ summary: "What this repo has not set up yet, most useful first. Exits 0.",
516
+ flags: ["--workflow=<name>", "--all"],
517
+ detail: [
518
+ "Setup tips: what this repo has not set up yet, most useful",
519
+ "first, each with a sentence to ask your agent. Top three",
520
+ "by default; --workflow=design|plan|build|debug|ship puts",
521
+ "the tips that matter there first and prints one (each",
522
+ "workflow runs this at its close; audit and utility do the",
523
+ "same for audits and the ledger / roadmap updaters);",
524
+ '--all lists every one. Ends with a star line ("bkit-star"',
525
+ "in bkit.advisories.ignore silences it), except under",
526
+ "--workflow=audit|utility. Local checks only. Exits 0.",
527
+ ],
528
+ },
529
+ {
530
+ verb: "status",
531
+ args: "",
532
+ summary: "Current host and provider. Writes nothing. Exits 0.",
533
+ flags: [],
534
+ detail: [
535
+ "Read-only host/provider status. Reports current host+provider",
536
+ "(sampled from .claude/, .cursor/, package.json, and the",
537
+ "opencode agent model pins in .opencode/agents/).",
538
+ "Writes nothing. Exits 0.",
539
+ ],
540
+ },
541
+ {
542
+ verb: "cursor",
543
+ args: "",
544
+ summary: "Launch Cursor with .bkit/.env loaded into its environment.",
545
+ flags: [],
546
+ detail: [
547
+ "Launch Cursor with .bkit/.env loaded into its environment.",
548
+ "macOS GUI apps launched from the Dock/Finder do not inherit",
549
+ "the login shell env (direnv stays shell-only), so MCP token",
550
+ "placeholders resolve empty. This verb execs the app binary",
551
+ "directly with the per-repo .bkit/.env merged in. Quit Cursor",
552
+ "before running — a running instance ignores the new env.",
553
+ "Override binary path via BKIT_CURSOR_BIN=<path>.",
554
+ ],
555
+ },
556
+ {
557
+ verb: "opencode",
558
+ args: "",
559
+ summary: "Launch the OpenCode desktop app with .bkit/.env loaded.",
560
+ flags: [],
561
+ detail: [
562
+ "Same as `bkit cursor` but for the OpenCode desktop app.",
563
+ "Override binary path via BKIT_OPENCODE_BIN=<path>.",
564
+ ],
565
+ },
566
+ {
567
+ verb: "comply",
568
+ args: "--phase=<phase>",
569
+ summary: "Compliance grader for one workflow phase; appends stats rows. Exits 0.",
570
+ flags: ["--phase=<phase>"],
571
+ detail: [
572
+ "Run the compliance grader advisory step.",
573
+ "Checks the diff since parentSha for violations",
574
+ "(no-mirror-edit, skip-ci-not-head). Advisory only —",
575
+ 'never gates a workflow. Appends kind:"compliance"',
576
+ "rows to .bkit/stats.jsonl. Fail-open: always exits 0.",
577
+ "Valid phases: design, plan, build, debug, ship.",
578
+ ],
579
+ },
580
+ {
581
+ verb: "telemetry",
582
+ args: "summary [--phase=<workflow>]",
583
+ summary: "One workflow run's metrics against the median of the previous five. Exits 0.",
584
+ flags: ["--phase=<workflow>"],
585
+ detail: [
586
+ "Per-workflow telemetry report: THIS run's metrics",
587
+ "(duration, size, friction/deferrals/failures added,",
588
+ "compliance) against med·5 — the median of the previous 5",
589
+ "same-workflow runs. The close step of every /bkit-*",
590
+ "workflow calls this and posts it to the tracker comment.",
591
+ "--phase=<workflow>: the workflow to report",
592
+ "(design|plan|build|debug|ship). Without it, prints the",
593
+ "ledger-health line only. Read-only: exits 0.",
594
+ ],
595
+ },
596
+ {
597
+ verb: "stats",
598
+ args: "",
599
+ summary: "This repo's stats report, written to .bkit/stats.md. Exits 0.",
600
+ flags: [],
601
+ detail: [
602
+ "This repo's stats report: counts, durations, change-size vs",
603
+ "outcome, counterSource trust, per-rule and per-version",
604
+ "compliance, and the unjustified-deferral rate per",
605
+ "(subagent, model). Reads .bkit/stats.jsonl,",
606
+ ".bkit/friction.jsonl and docs/deferrals.jsonl of THIS repo",
607
+ "only; writes .bkit/stats.md and prints it.",
608
+ "Advisory + inform-only: exits 0.",
609
+ ],
610
+ },
611
+ {
612
+ verb: "help",
613
+ args: "",
614
+ summary: "Print the usage text.",
615
+ flags: [],
616
+ detail: ["Print this message."],
617
+ },
618
+ ];
619
+ /** Usage line width: a synopsis up to this long shares its line with the first detail line. */
620
+ const SYNOPSIS_WIDTH = 29;
621
+ /** The usage text's `bkit <verb>` list, rendered from `CLASSIC_VERB_HELP`. */
622
+ function classicUsage() {
623
+ const indent = " ".repeat(SYNOPSIS_WIDTH + 4);
624
+ return CLASSIC_VERB_HELP.flatMap(({ verb, args, detail }) => {
625
+ const synopsis = `bkit ${verb}${args ? ` ${args}` : ""}`;
626
+ if (synopsis.length > SYNOPSIS_WIDTH) {
627
+ return [` ${synopsis}`, ...detail.map((d) => indent + d)];
628
+ }
629
+ const [first = "", ...rest] = detail;
630
+ return [` ${synopsis.padEnd(SYNOPSIS_WIDTH)} ${first}`, ...rest.map((d) => indent + d)];
631
+ }).join("\n");
632
+ }
427
633
  export function printUsage() {
428
634
  console.log(`bkit — agent-stack consolidation CLI
429
635
 
430
636
  Usage:
431
- bkit install <module-flags> Install (or re-sync) the named modules + the implicit
432
- core foundation. At least one module flag is REQUIRED —
433
- a bare \`bkit install\` errors (name the modules below).
434
- Hosts compose: --claude --cursor --codex --antigravity
435
- --opencode=<provider>.
436
- bkit check Dry-run — drift-check everything already installed (no
437
- module flags). Exits 1 when a managed file needs
438
- re-rendering. Copies under .bkit/templates/ are refreshed by
439
- install/upgrade and checked for staleness — adopt one by
440
- copying it elsewhere; that copy is yours. The CI gate.
441
- Changes no managed file; rewrites .bkit/advisories.md.
442
- bkit upgrade [--to=<version>|--latest] [--auto-apply] [--dry-run]
443
- Upgrade everything installed (no module flags). Diffs old
444
- vs new templates; conflict list emitted to stderr. Use
445
- --auto-apply for CI (apply non-conflicting; exit non-zero
446
- on any conflict). Only a whole file you edited since bkit
447
- wrote it conflicts; rendered files (agents, commands,
448
- skills, .bkit/*.md) are always re-rendered — bkit check
449
- flags an edit to one.
450
- --to=<version> / --latest atomically BUMP @cbartens/bkit
451
- (pnpm add), then re-render + re-pin in one step — so a
452
- version bump can never drift from its rendered mirrors.
453
- This is the supported way to move bkit versions; a bare
454
- \`pnpm add @cbartens/bkit\` alone leaves mirrors stale.
455
- bkit uninstall [module-flags] Remove bkit-managed files + strip managed blocks.
456
- No flags = full removal — ALL modules incl. opt-in add-ons
457
- (cloud/opencode) + core. Consumer-owned updater configs
458
- (renovate.json5, dependabot.yml, bkit-renovate.yml) are left in place. Consumer-modified
459
- files, your own files under docs/, and generated artefacts
460
- (.bkit/advisories.md, .bkit/friction.jsonl) are preserved (use
461
- --nuke to force-remove manifest-listed files). Target with the
462
- same module flags as install (e.g. uninstall --claude); a
463
- targeted uninstall leaves core untouched.
464
- bkit doctor Preflight + post-install advisory replay (changes no
465
- managed file; rewrites .bkit/advisories.md). Diagnose
466
- token surfaces and config drift. Exits 0.
467
- bkit tips [--workflow=<name>] [--all]
468
- Setup tips: what this repo has not set up yet, most useful
469
- first, each with a sentence to ask your agent. Top three
470
- by default; --workflow=design|plan|build|debug|ship puts
471
- the tips that matter there first and prints one (each
472
- workflow runs this at its close; audit and utility do the
473
- same for audits and the ledger / roadmap updaters);
474
- --all lists every one. Ends with a star line ("bkit-star"
475
- in bkit.ignoreAdvisories silences it), except under
476
- --workflow=audit|utility. Local checks only. Exits 0.
477
- bkit status Read-only host/provider status. Reports current host+provider
478
- (sampled from .claude/, .cursor/, package.json, and the
479
- opencode agent model pins in .opencode/agents/).
480
- Writes nothing. Exits 0.
481
- bkit cursor Launch Cursor with .bkit/.env loaded into its environment.
482
- macOS GUI apps launched from the Dock/Finder do not inherit
483
- the login shell env (direnv stays shell-only), so MCP token
484
- placeholders resolve empty. This verb execs the app binary
485
- directly with the per-repo .bkit/.env merged in. Quit Cursor
486
- before running — a running instance ignores the new env.
487
- Override binary path via BKIT_CURSOR_BIN=<path>.
488
- bkit opencode Same as \`bkit cursor\` but for the opencode desktop app.
489
- Override binary path via BKIT_OPENCODE_BIN=<path>.
490
- bkit comply --phase=<phase> Run the compliance grader advisory step.
491
- Checks the diff since parentSha for violations
492
- (no-mirror-edit, skip-ci-not-head). Advisory only —
493
- never gates a workflow. Appends kind:"compliance"
494
- rows to .bkit/stats.jsonl. Fail-open: always exits 0.
495
- Valid phases: design, plan, build, debug, ship.
496
- bkit harvest Cross-repo harvest — COPIES consumer .bkit/stats.jsonl
497
- and MOVES .bkit/friction.jsonl into harvest/ (COUNT-ONLY
498
- for docs/deferrals.jsonl and docs/failures.jsonl).
499
- Reads consumer paths from harvest/consumers.md.
500
- DESTRUCTIVE: harvested friction rows are REMOVED from
501
- the consumer, but only after they are fsync'd and read
502
- back from harvest/. stats.jsonl is never modified.
503
- harvest/ accumulates and is never cleared; it is
504
- gitignored, so it is the only record of pruned rows —
505
- back it up. Never commits
506
- in any repo. Deduplicates by per-kind composite
507
- identity. Advisory + fail-open: exits 0.
508
- bkit telemetry summary [--phase=<workflow>]
509
- Per-workflow telemetry report: THIS run's metrics
510
- (duration, size, friction/deferrals/failures added,
511
- compliance) against med·5 — the median of the previous 5
512
- same-workflow runs. The close step of every /bkit-*
513
- workflow calls this and posts it to the tracker comment.
514
- --phase=<workflow>: the workflow to report
515
- (design|plan|build|debug|ship). Without it, prints the
516
- ledger-health line only. Read-only: exits 0.
517
- bkit analysis Cross-repo analysis — reports counts/rates/elapsed-time,
518
- change-size vs outcome regression, dispatch-size threshold,
519
- counterSource trust labelling, per-rule compliance
520
- rate over kind:"compliance" rows, and the
521
- unjustified-deferral rate per (subagent, model)
522
- over kind:"deferral" rows. Reads from harvest/,
523
- .bkit/stats.jsonl and docs/deferrals.jsonl.
524
- Advisory + inform-only: exits 0.
525
- bkit help Print this message.
637
+ ${classicUsage()}
526
638
 
527
639
  Core (implicit — no flag; installed/upgraded on every install):
528
640
  AGENTS.md (cross-host dispatch router), .agents/rules.md + .agents/context.md +
@@ -530,7 +642,7 @@ Core (implicit — no flag; installed/upgraded on every install):
530
642
  .gitattributes managed blocks, docs/, .bkit/*.md, .bkit/version, the template copies in
531
643
  .bkit/templates/, and the bkit:gate:* / bkit:deps:* package.json scripts every workflow
532
644
  runs (added when missing, never overwritten, left by uninstall). The tool scripts those
533
- gates chain (typecheck, lint, format:check, lint:prose, slop:delta) and their devDeps are
645
+ gates chain (typecheck, lint, format:check, bkit:lint:prose, bkit:slop:delta) and their devDeps are
534
646
  yours to add: see .bkit/templates.md.
535
647
 
536
648
  Module flags (composable; symmetric install ↔ uninstall):
@@ -548,7 +660,7 @@ Module flags (composable; symmetric install ↔ uninstall):
548
660
  Ships .opencode/** (agents, commands, opencode.json, bkit-gateguard.js,
549
661
  bkit-readguard.js).
550
662
  Configure your provider key; verify with \`bkit doctor\`. All installed
551
- providers tracked in bkit.opencodeProviders.
663
+ providers tracked in bkit.providers.opencode.installed.
552
664
  --codex Codex CLI host. BARE flag — takes no value: Codex runs on one gateway
553
665
  (openai), so only --opencode is provider-pluggable. Ships .codex/agents/*.toml
554
666
  + .codex/hooks.json + .codex/hooks/bkit-{gateguard,guardrails,readguard}.cjs,
@@ -566,6 +678,8 @@ Dependency updaters (copy an example and own it):
566
678
  .bkit/templates/.github/renovate.json5
567
679
  .bkit/templates/.github/workflows/bkit-renovate.yml (self-hosted runner, optional)
568
680
  .bkit/templates/.github/dependabot.yml
681
+ Install records the one present in bkit.dependencies.updater; bkit check
682
+ blocks when that value and the configs disagree.
569
683
  All templates and install steps: .bkit/templates.md
570
684
 
571
685
  --auto=<claude|cursor|opencode>
@@ -579,7 +693,7 @@ Dependency updaters (copy an example and own it):
579
693
 
580
694
  Cross-cutting / modifiers:
581
695
  --tracker=<name> Wire issue tracker integration. Values: github, linear, jira, none
582
- (default). Records bkit.issueTracker in package.json and substitutes
696
+ (default). Records bkit.tracker.default in package.json and substitutes
583
697
  tracker snippets into command mirrors. Re-renders every installed
584
698
  host, and works alone (bkit install --tracker=github). Switching is
585
699
  free; a switch removes the old linear or jira MCP entry unless you
@@ -597,7 +711,7 @@ Uninstall flags:
597
711
  --dry-run Print decision table (FILE / DECISION / REASON) without writing.
598
712
  --opencode=<provider>
599
713
  Surgical provider removal: removes that provider's block from
600
- opencode.json + drops it from bkit.opencodeProviders. Does NOT remove
714
+ opencode.json + drops it from bkit.providers.opencode.installed. Does NOT remove
601
715
  agents/commands/gateguard. If the removed provider was active, the first
602
716
  remaining provider becomes active and the agents are re-rendered to its
603
717
  model pins.
@@ -644,7 +758,7 @@ function commandsUsage() {
644
758
  return [
645
759
  "",
646
760
  "",
647
- "Workflow commands (bkit <noun> <verb> --flags; JSON on stdout; bkit <noun> --help):",
761
+ "Workflow commands (bkit <noun> <verb> --flags; text on stdout, --json for JSON; bkit <noun> --help):",
648
762
  ...COMMANDS.map((c) => ` bkit ${c.noun.padEnd(width)} ${c.summary}`),
649
763
  ].join("\n");
650
764
  }
@@ -659,7 +773,7 @@ function commandsUsage() {
659
773
  export function validateModuleFlagsForVerb(verb, moduleFlags, tracker = null) {
660
774
  if (verb === "install" && moduleFlags.size === 0 && tracker === null) {
661
775
  return ("[bkit] `bkit install` requires at least one module flag. Name what to install: " +
662
- "--claude, --cursor, --codex, --antigravity, --opencode=<provider> (plus opt-in " +
776
+ "--claude, --codex, --antigravity, --cursor, --opencode=<provider> (plus opt-in " +
663
777
  `--auto=<${CLOUD_VARIANTS.join("|")}>), or --tracker=<name> alone to switch the ` +
664
778
  "tracker on what is installed. Run `bkit help` for usage.");
665
779
  }
@@ -698,12 +812,8 @@ export async function main() {
698
812
  runComplyCommand(complyPhase);
699
813
  return;
700
814
  }
701
- if (verb === "harvest") {
702
- runHarvestCommand();
703
- return;
704
- }
705
- if (verb === "analysis") {
706
- runAnalysisCommand();
815
+ if (verb === "stats") {
816
+ runStatsCommand();
707
817
  return;
708
818
  }
709
819
  if (verb === "telemetry") {