@cbartens/bkit 6.0.0 → 6.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (375) hide show
  1. package/.bkit/README.md +154 -151
  2. package/.bkit/core/.agents/context.md +95 -29
  3. package/.bkit/core/.agents/docs.md +17 -15
  4. package/.bkit/core/.agents/plugins/bkit/hooks/bkit-gateguard.cjs +1 -0
  5. package/.bkit/core/.agents/plugins/bkit/hooks/bkit-guardrails.cjs +6 -5
  6. package/.bkit/core/.agents/plugins/bkit/hooks/bkit-readguard.cjs +1 -0
  7. package/.bkit/core/.agents/plugins/bkit/hooks/bkit-rules.cjs +65 -0
  8. package/.bkit/core/.agents/rules.md +108 -107
  9. package/.bkit/core/.agents/skills.md +63 -15
  10. package/.bkit/core/.bkit/README.md +154 -151
  11. package/.bkit/core/.bkit/authoring.md +714 -84
  12. package/.bkit/core/.bkit/cli.md +407 -0
  13. package/.bkit/core/.bkit/cloud.md +281 -193
  14. package/.bkit/core/.bkit/comparison.md +43 -41
  15. package/.bkit/core/.bkit/install.md +154 -84
  16. package/.bkit/core/.bkit/jsonl.md +193 -130
  17. package/.bkit/core/.bkit/pipeline.md +114 -114
  18. package/.bkit/core/.bkit/prompts.md +272 -165
  19. package/.bkit/core/.bkit/providers.md +457 -271
  20. package/.bkit/core/.bkit/router.md +69 -0
  21. package/.bkit/core/.bkit/templates.md +529 -256
  22. package/.bkit/core/.bkit/trackers.md +80 -52
  23. package/.bkit/core/.bkit/workflows.md +589 -504
  24. package/.bkit/core/.claude/hooks/bkit-gateguard.cjs +2 -2
  25. package/.bkit/core/.claude/hooks/bkit-guardrails.cjs +3 -3
  26. package/.bkit/core/.claude/hooks/bkit-preflight.sh +45 -14
  27. package/.bkit/core/.codex/hooks/bkit-guardrails.cjs +3 -3
  28. package/.bkit/core/.codex/hooks/bkit-rules.cjs +57 -0
  29. package/.bkit/core/.cursor/hooks/bkit-guardrails.cjs +7 -7
  30. package/.bkit/core/.cursor/hooks/bkit-preflight.sh +47 -12
  31. package/.bkit/core/.opencode/plugin/bkit-rules.js +89 -0
  32. package/.bkit/core/AGENTS.md +5 -73
  33. package/.bkit/core/docs/templates/bkit-audit-accessibility.md +127 -105
  34. package/.bkit/core/docs/templates/bkit-audit-adoption.md +104 -70
  35. package/.bkit/core/docs/templates/bkit-audit-agents.md +94 -72
  36. package/.bkit/core/docs/templates/bkit-audit-aio-seo.md +99 -78
  37. package/.bkit/core/docs/templates/bkit-audit-analytics.md +140 -82
  38. package/.bkit/core/docs/templates/bkit-audit-annotations.md +98 -72
  39. package/.bkit/core/docs/templates/bkit-audit-app-performance.md +121 -96
  40. package/.bkit/core/docs/templates/bkit-audit-app-store.md +157 -76
  41. package/.bkit/core/docs/templates/bkit-audit-architecture.md +113 -71
  42. package/.bkit/core/docs/templates/bkit-audit-ci-performance.md +75 -72
  43. package/.bkit/core/docs/templates/bkit-audit-config.md +122 -76
  44. package/.bkit/core/docs/templates/bkit-audit-cost.md +85 -74
  45. package/.bkit/core/docs/templates/bkit-audit-coverage.md +75 -68
  46. package/.bkit/core/docs/templates/bkit-audit-database.md +101 -70
  47. package/.bkit/core/docs/templates/bkit-audit-dead-code.md +164 -83
  48. package/.bkit/core/docs/templates/bkit-audit-deferrals.md +115 -86
  49. package/.bkit/core/docs/templates/bkit-audit-dependencies.md +264 -88
  50. package/.bkit/core/docs/templates/bkit-audit-documentation.md +118 -93
  51. package/.bkit/core/docs/templates/bkit-audit-duplication.md +139 -86
  52. package/.bkit/core/docs/templates/bkit-audit-failures.md +110 -81
  53. package/.bkit/core/docs/templates/bkit-audit-flakes.md +99 -74
  54. package/.bkit/core/docs/templates/bkit-audit-gates.md +105 -77
  55. package/.bkit/core/docs/templates/bkit-audit-issues.md +104 -80
  56. package/.bkit/core/docs/templates/bkit-audit-llm.md +131 -58
  57. package/.bkit/core/docs/templates/bkit-audit-logs.md +123 -100
  58. package/.bkit/core/docs/templates/bkit-audit-models.md +98 -53
  59. package/.bkit/core/docs/templates/bkit-audit-privacy.md +56 -52
  60. package/.bkit/core/docs/templates/bkit-audit-prompts.md +63 -54
  61. package/.bkit/core/docs/templates/bkit-audit-red-team.md +124 -68
  62. package/.bkit/core/docs/templates/bkit-audit-reliability.md +95 -70
  63. package/.bkit/core/docs/templates/bkit-audit-repo.md +169 -73
  64. package/.bkit/core/docs/templates/bkit-audit-security.md +206 -96
  65. package/.bkit/core/docs/templates/bkit-audit-slop.md +77 -70
  66. package/.bkit/core/docs/templates/bkit-audit-testing.md +162 -114
  67. package/.bkit/core/docs/templates/bkit-audit-usability.md +113 -71
  68. package/.bkit/core/docs/templates/bkit-plan.md +138 -132
  69. package/.bkit/core/engine/checks/after/auth.ts +40 -37
  70. package/.bkit/core/engine/checks/after/ci-yml.ts +65 -2
  71. package/.bkit/core/engine/checks/after/index.ts +12 -2
  72. package/.bkit/core/engine/checks/after/tools.ts +80 -33
  73. package/.bkit/core/engine/checks/before/context-fetch.ts +227 -33
  74. package/.bkit/core/engine/checks/before/env.ts +1 -1
  75. package/.bkit/core/engine/checks/before/index.ts +7 -0
  76. package/.bkit/core/engine/checks/before/repo.ts +40 -0
  77. package/.bkit/core/engine/checks/status-holes.ts +916 -123
  78. package/.bkit/core/engine/checks/tips/catalogue.ts +68 -17
  79. package/.bkit/core/engine/checks/tips/detect.ts +32 -0
  80. package/.bkit/core/engine/checks/tips/index.ts +47 -6
  81. package/.bkit/core/engine/cli.ts +238 -84
  82. package/.bkit/core/engine/commands/analysis.ts +128 -76
  83. package/.bkit/core/engine/commands/ci/ci.ts +363 -29
  84. package/.bkit/core/engine/commands/ci/pins.ts +172 -0
  85. package/.bkit/core/engine/commands/ci/push-gate.ts +223 -0
  86. package/.bkit/core/engine/commands/install/uninstall.ts +21 -27
  87. package/.bkit/core/engine/commands/install/upgrade.ts +32 -15
  88. package/.bkit/core/engine/commands/land.ts +126 -11
  89. package/.bkit/core/engine/commands/lib.ts +303 -6
  90. package/.bkit/core/engine/commands/registry.ts +6 -2
  91. package/.bkit/core/engine/commands/setup/setup.ts +1 -0
  92. package/.bkit/core/engine/commands/stats.ts +91 -35
  93. package/.bkit/core/engine/commands/workflow/branches.ts +1477 -117
  94. package/.bkit/core/engine/commands/workflow/challenge.ts +114 -39
  95. package/.bkit/core/engine/commands/workflow/completeness.ts +109 -0
  96. package/.bkit/core/engine/commands/workflow/context.ts +433 -55
  97. package/.bkit/core/engine/commands/workflow/counters.ts +244 -39
  98. package/.bkit/core/engine/commands/workflow/decisions.ts +61 -17
  99. package/.bkit/core/engine/commands/workflow/disk.ts +237 -55
  100. package/.bkit/core/engine/commands/workflow/fids.ts +19 -1
  101. package/.bkit/core/engine/commands/workflow/issues.ts +6 -0
  102. package/.bkit/core/engine/commands/workflow/ledgers.ts +458 -18
  103. package/.bkit/core/engine/commands/workflow/locks.ts +2 -0
  104. package/.bkit/core/engine/commands/workflow/plan-blocks.ts +124 -15
  105. package/.bkit/core/engine/commands/workflow/plans.ts +257 -0
  106. package/.bkit/core/engine/commands/workflow/prs.ts +12 -3
  107. package/.bkit/core/engine/commands/workflow/repo.ts +8 -0
  108. package/.bkit/core/engine/commands/workflow/roadmap.ts +56 -15
  109. package/.bkit/core/engine/commands/workflow/run-facts.ts +22 -31
  110. package/.bkit/core/engine/commands/workflow/runs.ts +652 -34
  111. package/.bkit/core/engine/commands/workflow/runtime.ts +3 -0
  112. package/.bkit/core/engine/commands/workflow/skills.ts +1 -0
  113. package/.bkit/core/engine/commands/workflow/status.ts +200 -17
  114. package/.bkit/core/engine/commands/workflow/step-table.ts +75 -33
  115. package/.bkit/core/engine/commands/workflow/steps.ts +635 -24
  116. package/.bkit/core/engine/commands/workflow/summary-findings.ts +177 -0
  117. package/.bkit/core/engine/commands/workflow/summary.ts +192 -46
  118. package/.bkit/core/engine/commands/workflow/tasks.ts +409 -0
  119. package/.bkit/core/engine/commands/workflow/test-blocks.ts +254 -0
  120. package/.bkit/core/engine/commands/workflow/tests-changed.ts +201 -0
  121. package/.bkit/core/engine/commands/workflow/tests.ts +1285 -356
  122. package/.bkit/core/engine/commands/workflow/workflows.ts +228 -43
  123. package/.bkit/core/engine/commands/workflow/worktrees.ts +389 -47
  124. package/.bkit/core/engine/install/cloud-env.ts +251 -121
  125. package/.bkit/core/engine/install/context-ci-workflow.ts +102 -0
  126. package/.bkit/core/engine/install/manifest.ts +60 -12
  127. package/.bkit/core/engine/install/modules/antigravity.ts +3 -2
  128. package/.bkit/core/engine/install/modules/cloud.ts +3 -3
  129. package/.bkit/core/engine/install/modules/codex.ts +15 -2
  130. package/.bkit/core/engine/install/modules/core.ts +956 -52
  131. package/.bkit/core/engine/install/modules/cursor.ts +6 -6
  132. package/.bkit/core/engine/install/modules/opencode.ts +16 -4
  133. package/.bkit/core/engine/install/template-notes.ts +130 -0
  134. package/.bkit/core/engine/install/version-file.ts +3 -2
  135. package/.bkit/core/engine/install/write.ts +5 -0
  136. package/.bkit/core/engine/ledgers/compact.ts +124 -0
  137. package/.bkit/core/engine/ledgers/journal.ts +291 -0
  138. package/.bkit/core/engine/ledgers/status.ts +160 -9
  139. package/.bkit/core/engine/ledgers/telemetry.ts +158 -21
  140. package/.bkit/core/engine/render/hosts.ts +114 -14
  141. package/.bkit/core/engine/shared/bkit-latest.ts +26 -4
  142. package/.bkit/core/engine/shared/dep-updater.ts +60 -0
  143. package/.bkit/core/engine/shared/egress.ts +1 -1
  144. package/.bkit/core/engine/shared/package-manager.ts +9 -0
  145. package/.bkit/core/engine/shared/settings.ts +92 -17
  146. package/.bkit/core/engine/shared/timeouts.ts +2 -0
  147. package/.bkit/core/engine/tools/cli-doc.ts +111 -0
  148. package/.bkit/core/engine/tools/grammar-density.ts +1 -1
  149. package/.bkit/core/engine/tools/instructions-sources.ts +15 -17
  150. package/.bkit/core/engine/tools/instructions.ts +94 -43
  151. package/.bkit/core/hooks/antigravity-hook.js +25 -10
  152. package/.bkit/core/hooks/gateguard-engine.js +53 -29
  153. package/.bkit/core/hooks/guardrails-shell.js +4 -4
  154. package/.bkit/core/hooks/guardrails-tiers.js +3 -3
  155. package/.bkit/core/hooks/preflight-linear.sh +9 -9
  156. package/.bkit/core/hooks/preflight-rules.sh +8 -0
  157. package/.bkit/core/hooks/readguard-engine.js +29 -10
  158. package/.bkit/core/hooks/session-rules-advisory.js +61 -0
  159. package/.bkit/core/prompts/bkit-audit-generate.md +187 -116
  160. package/.bkit/core/prompts/bkit-build-challenge-1.md +56 -37
  161. package/.bkit/core/prompts/bkit-build-challenge-2.md +65 -45
  162. package/.bkit/core/prompts/bkit-build-install-skills.md +38 -29
  163. package/.bkit/core/prompts/bkit-build-plan-convert.md +43 -32
  164. package/.bkit/core/prompts/bkit-build-plan-current.md +49 -39
  165. package/.bkit/core/prompts/bkit-build-plan-gaps-remediate.md +79 -55
  166. package/.bkit/core/prompts/bkit-build-plan-tasks.md +149 -0
  167. package/.bkit/core/prompts/bkit-build-plan-tests.md +120 -0
  168. package/.bkit/core/prompts/bkit-build-plan-verify.md +87 -50
  169. package/.bkit/core/prompts/bkit-debug-abort-handover.md +36 -35
  170. package/.bkit/core/prompts/bkit-debug-failure-diagnose.md +96 -64
  171. package/.bkit/core/prompts/bkit-debug-failure-remediate.md +54 -45
  172. package/.bkit/core/prompts/bkit-debug-failure-reproduce.md +42 -33
  173. package/.bkit/core/prompts/bkit-debug-failure-soak.md +53 -37
  174. package/.bkit/core/prompts/bkit-design-brainstorm-ideate-1.md +35 -30
  175. package/.bkit/core/prompts/bkit-design-brainstorm-ideate-2.md +34 -29
  176. package/.bkit/core/prompts/bkit-design-brainstorm-ideate-3.md +32 -28
  177. package/.bkit/core/prompts/bkit-design-generate.md +68 -52
  178. package/.bkit/core/prompts/bkit-design-organise.md +73 -35
  179. package/.bkit/core/prompts/bkit-design-review-1.md +58 -54
  180. package/.bkit/core/prompts/bkit-design-review-2.md +54 -50
  181. package/.bkit/core/prompts/bkit-design-spike.md +54 -47
  182. package/.bkit/core/prompts/bkit-design-update.md +42 -31
  183. package/.bkit/core/prompts/bkit-plan-generate.md +76 -58
  184. package/.bkit/core/prompts/bkit-plan-review-1.md +63 -49
  185. package/.bkit/core/prompts/bkit-plan-review-2.md +60 -48
  186. package/.bkit/core/prompts/bkit-plan-scope-check.md +53 -46
  187. package/.bkit/core/prompts/bkit-plan-update.md +70 -52
  188. package/.bkit/core/prompts/bkit-ship-conflict-resolve.md +82 -50
  189. package/.bkit/core/prompts/bkit-ship-deferred-sweep.md +80 -45
  190. package/.bkit/core/prompts/bkit-ship-update-docs.md +35 -29
  191. package/.bkit/core/prompts/bkit-utility-compress-markdown.md +55 -49
  192. package/.bkit/core/prompts/bkit-utility-update-decisions.md +76 -49
  193. package/.bkit/core/prompts/bkit-utility-update-deferrals.md +70 -41
  194. package/.bkit/core/prompts/bkit-utility-update-documentation.md +33 -30
  195. package/.bkit/core/prompts/bkit-utility-update-failures.md +73 -43
  196. package/.bkit/core/prompts/bkit-utility-update-knowledge.md +77 -50
  197. package/.bkit/core/prompts/bkit-utility-update-roadmap.md +77 -45
  198. package/.bkit/core/prompts/bkit-utility-update-tracker.md +144 -68
  199. package/.bkit/core/workflows/bkit-auto.md +53 -30
  200. package/.bkit/core/workflows/bkit-build.md +635 -304
  201. package/.bkit/core/workflows/bkit-debug.md +301 -148
  202. package/.bkit/core/workflows/bkit-design.md +167 -95
  203. package/.bkit/core/workflows/bkit-plan.md +172 -84
  204. package/.bkit/core/workflows/bkit-ship.md +299 -152
  205. package/.bkit/shared/.agents/plugins/bkit/hooks.json +10 -0
  206. package/.bkit/shared/.claude/bkit-cloud.md +12 -10
  207. package/.bkit/shared/.claude/settings.json +3 -0
  208. package/.bkit/shared/.codex/bkit-cloud.md +98 -0
  209. package/.bkit/shared/.codex/hooks.json +20 -0
  210. package/.bkit/shared/.cursor/bkit-cloud.md +3 -3
  211. package/.bkit/shared/.opencode/opencode.json +1 -1
  212. package/.bkit/shared/CLAUDE.md +5 -1
  213. package/.bkit/shared/GEMINI.md +4 -1
  214. package/.bkit/shared/docs/architecture.md +4 -7
  215. package/.bkit/shared/docs/data-schema.md +4 -7
  216. package/.bkit/shared/docs/deployments.md +239 -166
  217. package/.bkit/shared/docs/design.md +11 -12
  218. package/.bkit/shared/docs/noise.md +8 -7
  219. package/.bkit/shared/docs/observability.md +5 -8
  220. package/.bkit/shared/docs/security.md +35 -17
  221. package/.bkit/shared/docs/setup.md +29 -18
  222. package/.bkit/shared/docs/technology.md +3 -6
  223. package/.bkit/shared/docs/testing.md +282 -176
  224. package/.bkit/shared/gitignore +6 -2
  225. package/.bkit/templates/.claude/hooks/bkit-cloud-bootstrap.sh +15 -16
  226. package/.bkit/templates/.cursor/Dockerfile +12 -8
  227. package/.bkit/templates/.cursor/environment.json +1 -1
  228. package/.bkit/templates/.github/ISSUE_TEMPLATE/bkit-bug.yml +10 -8
  229. package/.bkit/templates/.github/ISSUE_TEMPLATE/bkit-change.yml +24 -12
  230. package/.bkit/templates/.github/ISSUE_TEMPLATE/bkit-idea.yml +3 -3
  231. package/.bkit/templates/.github/renovate.json5 +34 -6
  232. package/.bkit/templates/.github/workflows/bkit-ci.yml +53 -50
  233. package/.bkit/templates/.github/workflows/bkit-cloud.yml +13 -14
  234. package/.bkit/templates/.github/workflows/bkit-health.yml +97 -0
  235. package/.bkit/templates/.github/workflows/bkit-renovate.yml +5 -4
  236. package/.bkit/templates/.github/workflows/bkit-trivy.yml +5 -4
  237. package/.bkit/templates/.husky/pre-commit +2 -2
  238. package/.bkit/templates/.husky/pre-push +95 -35
  239. package/.bkit/templates/.prettierignore +6 -7
  240. package/.bkit/templates/.vale.ini +27 -27
  241. package/.bkit/templates/context/bkit-cloudrun.md +23 -15
  242. package/.bkit/templates/context/bkit-expo.md +70 -52
  243. package/.bkit/templates/context/bkit-github.md +93 -56
  244. package/.bkit/templates/context/bkit-inngest.md +21 -15
  245. package/.bkit/templates/context/bkit-maestro.md +22 -16
  246. package/.bkit/templates/context/bkit-playwright.md +23 -17
  247. package/.bkit/templates/context/bkit-resend.md +12 -10
  248. package/.bkit/templates/context/bkit-sentry.md +30 -20
  249. package/.bkit/templates/context/bkit-serena.md +8 -7
  250. package/.bkit/templates/context/bkit-stripe.md +14 -13
  251. package/.bkit/templates/context/bkit-supabase.md +16 -13
  252. package/.bkit/templates/context/bkit-tavily.md +14 -11
  253. package/.bkit/templates/context/bkit-vercel.md +27 -18
  254. package/.bkit/templates/docs/capabilities.md +15 -14
  255. package/.bkit/templates/scripts/ci/{check-accepted-divergences.mjs → bkit-check-accepted-divergences.mjs} +6 -3
  256. package/.bkit/templates/scripts/ci/{check-accepted-divergences.test.mjs → bkit-check-accepted-divergences.test.mjs} +3 -3
  257. package/.bkit/templates/scripts/ci/{check-capstone.mjs → bkit-check-capstone.mjs} +2 -2
  258. package/.bkit/templates/scripts/ci/{check-capstone.test.mjs → bkit-check-capstone.test.mjs} +4 -4
  259. package/.bkit/templates/scripts/ci/{check-dependency-audit.mjs → bkit-check-dependency-audit.mjs} +103 -18
  260. package/.bkit/templates/scripts/ci/{check-dependency-audit.test.mjs → bkit-check-dependency-audit.test.mjs} +31 -3
  261. package/.bkit/templates/scripts/ci/bkit-machine-lock.sh +387 -0
  262. package/.bkit/templates/scripts/ci/bkit-test-awake.mjs +75 -0
  263. package/.bkit/templates/scripts/ci/bkit-test-awake.test.mjs +160 -0
  264. package/.bkit/templates/scripts/ci/lanes/{resolve-push-base.mjs → bkit-resolve-push-base.mjs} +3 -3
  265. package/.bkit/templates/scripts/ci/lanes/{resolve-push-base.test.mjs → bkit-resolve-push-base.test.mjs} +4 -4
  266. package/.bkit/templates/scripts/cleanup/bkit-disk-prune.mjs +9 -1
  267. package/.bkit/templates/scripts/graphify/bkit-graph-drift.py +1 -1
  268. package/.bkit/templates/scripts/graphify/bkit-graph-eager.py +3 -3
  269. package/.bkit/templates/scripts/graphify/bkit-graph-embed.py +63 -0
  270. package/.bkit/templates/scripts/graphify/bkit-graph-imports.py +2 -2
  271. package/.bkit/templates/scripts/graphify/bkit-graph-pre-push.sh +69 -18
  272. package/.bkit/templates/scripts/graphify/bkit-graph-repair.py +3 -3
  273. package/.bkit/templates/scripts/graphify/bkit-graph-surface.py +1 -1
  274. package/.bkit/templates/scripts/graphify/bkit-graphify-graphml.py +1 -1
  275. package/.bkit/templates/scripts/graphify/bkit-graphify-rollup.py +197 -126
  276. package/.bkit/templates/scripts/graphify/bkit-graphify.sh +64 -41
  277. package/.bkit/templates/scripts/slop/bkit-slop-type-suppression.mjs +23 -7
  278. package/.bkit/templates/slop-scan.config.json +9 -2
  279. package/CHANGELOG.md +119 -0
  280. package/README.md +250 -76
  281. package/dist/checks/after/auth.js +36 -33
  282. package/dist/checks/after/ci-yml.js +52 -2
  283. package/dist/checks/after/index.js +12 -4
  284. package/dist/checks/after/tools.js +73 -33
  285. package/dist/checks/before/context-fetch.js +218 -33
  286. package/dist/checks/before/env.js +1 -1
  287. package/dist/checks/before/index.js +6 -2
  288. package/dist/checks/before/repo.js +35 -1
  289. package/dist/checks/status-holes.js +739 -114
  290. package/dist/checks/tips/catalogue.js +59 -17
  291. package/dist/checks/tips/detect.js +30 -0
  292. package/dist/checks/tips/index.js +48 -6
  293. package/dist/cli.js +222 -84
  294. package/dist/commands/analysis.js +77 -53
  295. package/dist/commands/ci/ci.js +302 -25
  296. package/dist/commands/ci/pins.js +142 -0
  297. package/dist/commands/ci/push-gate.js +194 -0
  298. package/dist/commands/install/uninstall.js +23 -27
  299. package/dist/commands/install/upgrade.js +21 -11
  300. package/dist/commands/land.js +126 -10
  301. package/dist/commands/lib.js +244 -5
  302. package/dist/commands/registry.js +6 -2
  303. package/dist/commands/setup/setup.js +1 -0
  304. package/dist/commands/stats.js +69 -30
  305. package/dist/commands/workflow/branches.js +1232 -111
  306. package/dist/commands/workflow/challenge.js +90 -37
  307. package/dist/commands/workflow/completeness.js +97 -0
  308. package/dist/commands/workflow/context.js +371 -51
  309. package/dist/commands/workflow/counters.js +206 -40
  310. package/dist/commands/workflow/decisions.js +60 -17
  311. package/dist/commands/workflow/disk.js +213 -55
  312. package/dist/commands/workflow/fids.js +18 -1
  313. package/dist/commands/workflow/issues.js +6 -0
  314. package/dist/commands/workflow/ledgers.js +372 -21
  315. package/dist/commands/workflow/locks.js +2 -0
  316. package/dist/commands/workflow/plan-blocks.js +78 -14
  317. package/dist/commands/workflow/plans.js +205 -0
  318. package/dist/commands/workflow/prs.js +12 -3
  319. package/dist/commands/workflow/repo.js +6 -0
  320. package/dist/commands/workflow/roadmap.js +50 -17
  321. package/dist/commands/workflow/run-facts.js +23 -28
  322. package/dist/commands/workflow/runs.js +530 -33
  323. package/dist/commands/workflow/runtime.js +3 -0
  324. package/dist/commands/workflow/skills.js +1 -0
  325. package/dist/commands/workflow/status.js +166 -19
  326. package/dist/commands/workflow/step-table.js +61 -29
  327. package/dist/commands/workflow/steps.js +542 -26
  328. package/dist/commands/workflow/summary-findings.js +117 -0
  329. package/dist/commands/workflow/summary.js +154 -41
  330. package/dist/commands/workflow/tasks.js +378 -0
  331. package/dist/commands/workflow/test-blocks.js +231 -0
  332. package/dist/commands/workflow/tests-changed.js +172 -0
  333. package/dist/commands/workflow/tests.js +1013 -321
  334. package/dist/commands/workflow/workflows.js +191 -38
  335. package/dist/commands/workflow/worktrees.js +310 -42
  336. package/dist/install/cloud-env.js +233 -99
  337. package/dist/install/context-ci-workflow.js +85 -0
  338. package/dist/install/manifest.js +57 -12
  339. package/dist/install/modules/antigravity.js +3 -2
  340. package/dist/install/modules/cloud.js +3 -3
  341. package/dist/install/modules/codex.js +12 -2
  342. package/dist/install/modules/core.js +851 -53
  343. package/dist/install/modules/cursor.js +6 -6
  344. package/dist/install/modules/opencode.js +11 -5
  345. package/dist/install/template-notes.js +116 -0
  346. package/dist/install/version-file.js +3 -2
  347. package/dist/ledgers/compact.js +87 -0
  348. package/dist/ledgers/journal.js +233 -0
  349. package/dist/ledgers/status.js +115 -5
  350. package/dist/ledgers/telemetry.js +121 -17
  351. package/dist/render/hosts.js +100 -14
  352. package/dist/shared/bkit-latest.js +26 -4
  353. package/dist/shared/dep-updater.js +49 -0
  354. package/dist/shared/egress.js +1 -1
  355. package/dist/shared/package-manager.js +6 -0
  356. package/dist/shared/settings.js +59 -10
  357. package/dist/shared/timeouts.js +2 -0
  358. package/dist/tools/cli-doc.js +97 -0
  359. package/dist/tools/grammar-density.js +1 -1
  360. package/dist/tools/instructions-sources.js +15 -16
  361. package/dist/tools/instructions.js +83 -39
  362. package/package.json +58 -42
  363. package/.bkit/core/.bkit/lite.md +0 -73
  364. package/.bkit/core/engine/commands/workflow/workstreams.ts +0 -172
  365. package/.bkit/core/prompts/bkit-build-plan-execute.md +0 -124
  366. package/.bkit/templates/scripts/ci/bkit-local-stack-lock.sh +0 -194
  367. package/dist/commands/workflow/workstreams.js +0 -149
  368. /package/.bkit/templates/.vale/styles/{House → Bkit}/Filler.yml +0 -0
  369. /package/.bkit/templates/.vale/styles/{House → Bkit}/Hedging.yml +0 -0
  370. /package/.bkit/templates/.vale/styles/{House → Bkit}/LLMSlop.yml +0 -0
  371. /package/.bkit/templates/.vale/styles/{House → Bkit}/Verbose.yml +0 -0
  372. /package/.bkit/templates/scripts/ci/{accepted-advisories.json → bkit-accepted-advisories.json} +0 -0
  373. /package/.bkit/templates/scripts/ci/{accepted-divergences.json → bkit-accepted-divergences.json} +0 -0
  374. /package/.bkit/templates/scripts/launchd/{launchd.env.example → bkit-launchd.env.example} +0 -0
  375. /package/.bkit/templates/scripts/launchd/{ai.bkit.launchd.plist → bkit-launchd.plist} +0 -0
@@ -565,93 +565,245 @@ export function parseArgs(argv: string[]): ParsedArgs {
565
565
  };
566
566
  }
567
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
+
568
801
  export function printUsage(): void {
569
802
  console.log(
570
803
  `bkit — agent-stack consolidation CLI
571
804
 
572
805
  Usage:
573
- bkit install <module-flags> Install (or re-sync) the named modules + the implicit
574
- core foundation. At least one module flag is REQUIRED —
575
- a bare \`bkit install\` errors (name the modules below).
576
- Hosts compose: --claude --cursor --codex --antigravity
577
- --opencode=<provider>.
578
- bkit check Dry-run — drift-check everything already installed (no
579
- module flags). Exits 1 when a managed file needs
580
- re-rendering. Copies under .bkit/templates/ are refreshed by
581
- install/upgrade and checked for staleness — adopt one by
582
- copying it elsewhere; that copy is yours. The CI gate.
583
- Changes no managed file; rewrites .bkit/advisories.md.
584
- bkit upgrade [--to=<version>|--latest] [--auto-apply] [--dry-run]
585
- Upgrade everything installed (no module flags). Diffs old
586
- vs new templates; conflict list emitted to stderr. Use
587
- --auto-apply for CI (apply non-conflicting; exit non-zero
588
- on any conflict). Only a whole file you edited since bkit
589
- wrote it conflicts; rendered files (agents, commands,
590
- skills, .bkit/*.md) are always re-rendered — bkit check
591
- flags an edit to one.
592
- --to=<version> / --latest atomically BUMP @cbartens/bkit
593
- (pnpm add), then re-render + re-pin in one step — so a
594
- version bump can never drift from its rendered mirrors.
595
- This is the supported way to move bkit versions; a bare
596
- \`pnpm add @cbartens/bkit\` alone leaves mirrors stale.
597
- bkit uninstall [module-flags] Remove bkit-managed files + strip managed blocks.
598
- No flags = full removal — ALL modules incl. opt-in add-ons
599
- (cloud/opencode) + core. Consumer-owned updater configs
600
- (renovate.json5, dependabot.yml, bkit-renovate.yml) are left in place. Consumer-modified
601
- files, your own files under docs/, and generated artefacts
602
- (.bkit/advisories.md, .bkit/friction.jsonl) are preserved (use
603
- --nuke to force-remove manifest-listed files). Target with the
604
- same module flags as install (e.g. uninstall --claude); a
605
- targeted uninstall leaves core untouched.
606
- bkit doctor Preflight + post-install advisory replay (changes no
607
- managed file; rewrites .bkit/advisories.md). Diagnose
608
- token surfaces and config drift. Exits 0.
609
- bkit tips [--workflow=<name>] [--all]
610
- Setup tips: what this repo has not set up yet, most useful
611
- first, each with a sentence to ask your agent. Top three
612
- by default; --workflow=design|plan|build|debug|ship puts
613
- the tips that matter there first and prints one (each
614
- workflow runs this at its close; audit and utility do the
615
- same for audits and the ledger / roadmap updaters);
616
- --all lists every one. Ends with a star line ("bkit-star"
617
- in bkit.advisories.ignore silences it), except under
618
- --workflow=audit|utility. Local checks only. Exits 0.
619
- bkit status Read-only host/provider status. Reports current host+provider
620
- (sampled from .claude/, .cursor/, package.json, and the
621
- opencode agent model pins in .opencode/agents/).
622
- Writes nothing. Exits 0.
623
- bkit cursor Launch Cursor with .bkit/.env loaded into its environment.
624
- macOS GUI apps launched from the Dock/Finder do not inherit
625
- the login shell env (direnv stays shell-only), so MCP token
626
- placeholders resolve empty. This verb execs the app binary
627
- directly with the per-repo .bkit/.env merged in. Quit Cursor
628
- before running — a running instance ignores the new env.
629
- Override binary path via BKIT_CURSOR_BIN=<path>.
630
- bkit opencode Same as \`bkit cursor\` but for the opencode desktop app.
631
- Override binary path via BKIT_OPENCODE_BIN=<path>.
632
- bkit comply --phase=<phase> Run the compliance grader advisory step.
633
- Checks the diff since parentSha for violations
634
- (no-mirror-edit, skip-ci-not-head). Advisory only —
635
- never gates a workflow. Appends kind:"compliance"
636
- rows to .bkit/stats.jsonl. Fail-open: always exits 0.
637
- Valid phases: design, plan, build, debug, ship.
638
- bkit telemetry summary [--phase=<workflow>]
639
- Per-workflow telemetry report: THIS run's metrics
640
- (duration, size, friction/deferrals/failures added,
641
- compliance) against med·5 — the median of the previous 5
642
- same-workflow runs. The close step of every /bkit-*
643
- workflow calls this and posts it to the tracker comment.
644
- --phase=<workflow>: the workflow to report
645
- (design|plan|build|debug|ship). Without it, prints the
646
- ledger-health line only. Read-only: exits 0.
647
- bkit stats This repo's stats report: counts, durations, change-size vs
648
- outcome, counterSource trust, per-rule and per-version
649
- compliance, and the unjustified-deferral rate per
650
- (subagent, model). Reads .bkit/stats.jsonl,
651
- .bkit/friction.jsonl and docs/deferrals.jsonl of THIS repo
652
- only; writes .bkit/stats.md and prints it.
653
- Advisory + inform-only: exits 0.
654
- bkit help Print this message.
806
+ ${classicUsage()}
655
807
 
656
808
  Core (implicit — no flag; installed/upgraded on every install):
657
809
  AGENTS.md (cross-host dispatch router), .agents/rules.md + .agents/context.md +
@@ -659,7 +811,7 @@ Core (implicit — no flag; installed/upgraded on every install):
659
811
  .gitattributes managed blocks, docs/, .bkit/*.md, .bkit/version, the template copies in
660
812
  .bkit/templates/, and the bkit:gate:* / bkit:deps:* package.json scripts every workflow
661
813
  runs (added when missing, never overwritten, left by uninstall). The tool scripts those
662
- 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
663
815
  yours to add: see .bkit/templates.md.
664
816
 
665
817
  Module flags (composable; symmetric install ↔ uninstall):
@@ -695,6 +847,8 @@ Dependency updaters (copy an example and own it):
695
847
  .bkit/templates/.github/renovate.json5
696
848
  .bkit/templates/.github/workflows/bkit-renovate.yml (self-hosted runner, optional)
697
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.
698
852
  All templates and install steps: .bkit/templates.md
699
853
 
700
854
  --auto=<claude|cursor|opencode>
@@ -795,7 +949,7 @@ export function validateModuleFlagsForVerb(
795
949
  if (verb === "install" && moduleFlags.size === 0 && tracker === null) {
796
950
  return (
797
951
  "[bkit] `bkit install` requires at least one module flag. Name what to install: " +
798
- "--claude, --cursor, --codex, --antigravity, --opencode=<provider> (plus opt-in " +
952
+ "--claude, --codex, --antigravity, --cursor, --opencode=<provider> (plus opt-in " +
799
953
  `--auto=<${CLOUD_VARIANTS.join("|")}>), or --tracker=<name> alone to switch the ` +
800
954
  "tracker on what is installed. Run `bkit help` for usage."
801
955
  );
@@ -13,6 +13,10 @@
13
13
  //
14
14
  // Rows are read folded, so rows written without `schema` arrive in the current shape.
15
15
  //
16
+ // Every figure built from `outcome`, `counter` or `compliance` rows is computed twice: once over
17
+ // the rows workflow closes wrote, once over the rows a direct chat wrote (`by.workflow`
18
+ // `utility`). No figure adds the two together.
19
+ //
16
20
  // All computation is advisory + inform-only; never gates any workflow.
17
21
  // See DE-34 for the shared-entrypoint + crash-isolation contract.
18
22
 
@@ -45,20 +49,33 @@ export type ComplianceRow = TelemetryEnvelope & CompliancePayload;
45
49
  // Counts / rates summary
46
50
  // ---------------------------------------------------------------------------
47
51
 
52
+ /** `by.workflow` of a row a direct chat wrote, outside any workflow run. */
53
+ export const UTILITY_WORKFLOW = "utility";
54
+
55
+ /** Who wrote a row: a workflow (its close, or its orchestrator), or a direct chat. */
56
+ export type RowSource = "workflow" | "utility";
57
+
58
+ export const ROW_SOURCES: readonly RowSource[] = ["workflow", "utility"];
59
+
60
+ export function rowSource(row: Pick<TelemetryEnvelope, "by">): RowSource {
61
+ return row.by?.workflow === UTILITY_WORKFLOW ? "utility" : "workflow";
62
+ }
63
+
48
64
  export interface TelemetryCounts {
49
65
  total: number;
50
- byKind: Record<string, number>;
66
+ /** Rows per kind, workflow rows and direct-chat rows apart. */
67
+ byKind: Record<string, Record<RowSource, number>>;
51
68
  byWorkflow: Record<string, number>;
52
69
  byRepo: Record<string, number>;
53
70
  }
54
71
 
55
72
  export function computeCounts(events: TelemetryEvent[]): TelemetryCounts {
56
- const byKind: Record<string, number> = {};
73
+ const byKind: Record<string, Record<RowSource, number>> = {};
57
74
  const byWorkflow: Record<string, number> = {};
58
75
  const byRepo: Record<string, number> = {};
59
76
 
60
77
  for (const ev of events) {
61
- byKind[ev.kind] = (byKind[ev.kind] ?? 0) + 1;
78
+ (byKind[ev.kind] ??= { workflow: 0, utility: 0 })[rowSource(ev)]++;
62
79
  const workflow = ev.by?.workflow ?? "unknown";
63
80
  byWorkflow[workflow] = (byWorkflow[workflow] ?? 0) + 1;
64
81
  byRepo[ev.repo] = (byRepo[ev.repo] ?? 0) + 1;
@@ -454,108 +471,153 @@ export function computeDeferralDiscipline(rows: DeferralRow[]): DeferralDiscipli
454
471
  }
455
472
 
456
473
  // ---------------------------------------------------------------------------
457
- // Full analysis report
474
+ // Run figures — one set per row source
458
475
  // ---------------------------------------------------------------------------
459
476
 
460
- export interface AnalysisReport {
461
- counts: TelemetryCounts;
477
+ /** Every figure built from one source's `outcome`, `counter` and `compliance` rows. */
478
+ export interface RunFigures {
479
+ outcomes: number;
480
+ compliance: number;
462
481
  elapsed: ElapsedStats;
463
482
  regression: RegressionResult;
464
483
  complianceRates: ComplianceRuleRate[];
465
484
  versionCompliance: VersionComplianceEntry[];
466
- deferralDiscipline: DeferralDisciplineEntry[];
467
485
  challengeGate: ChallengeGateCounts;
468
486
  agentContext: AgentContextReport;
469
- reportLines: string[];
470
487
  }
471
488
 
472
- /** Analyse the folded rows of `paths`, leaving out rows of `skipKinds`. */
473
- export function runAnalysis(
474
- paths: string[],
475
- skipKinds: ReadonlySet<string> = new Set(),
476
- ): AnalysisReport {
477
- const { state, rowCount, malformedLineCount } = foldFrom(paths);
478
- const events = [...state.values()].filter((ev) => !skipKinds.has(ev.kind));
479
-
480
- const outcomeRows: OutcomeRow[] = [];
481
- const counterRows: CounterRow[] = [];
482
- const complianceRows: ComplianceRow[] = [];
483
- const deferralRows: DeferralRow[] = [];
484
-
485
- for (const ev of events) {
486
- if (ev.kind === "outcome") {
487
- outcomeRows.push(ev);
488
- } else if (ev.kind === "counter") {
489
- counterRows.push(ev);
490
- } else if (ev.kind === "compliance") {
491
- complianceRows.push(ev);
492
- } else if (ev.kind === "deferral") {
493
- deferralRows.push(ev);
494
- }
495
- }
496
-
497
- const counts = computeCounts(events);
498
- const elapsed = computeElapsedStats(outcomeRows);
499
- const regression = computeRegression(outcomeRows, counterRows);
500
- const complianceRates = computeComplianceRates(complianceRows);
501
- const versionCompliance = computeVersionCompliance(complianceRows);
502
- const deferralDiscipline = computeDeferralDiscipline(deferralRows);
503
- const challengeGate = computeChallengeGate(outcomeRows);
504
- const agentContext = computeAgentContext(outcomeRows);
489
+ export function computeRunFigures(
490
+ outcomeRows: OutcomeRow[],
491
+ counterRows: CounterRow[],
492
+ complianceRows: ComplianceRow[],
493
+ ): RunFigures {
494
+ return {
495
+ outcomes: outcomeRows.length,
496
+ compliance: complianceRows.length,
497
+ elapsed: computeElapsedStats(outcomeRows),
498
+ regression: computeRegression(outcomeRows, counterRows),
499
+ complianceRates: computeComplianceRates(complianceRows),
500
+ versionCompliance: computeVersionCompliance(complianceRows),
501
+ challengeGate: computeChallengeGate(outcomeRows),
502
+ agentContext: computeAgentContext(outcomeRows),
503
+ };
504
+ }
505
505
 
506
- const reportLines: string[] = [
507
- `[bkit-analysis] Telemetry rows: ${rowCount} | malformed: ${malformedLineCount}`,
508
- `[bkit-analysis] Kinds: ${JSON.stringify(counts.byKind)}`,
509
- `[bkit-analysis] Workflows: ${JSON.stringify(counts.byWorkflow)}`,
510
- `[bkit-analysis] Run outcomes: ${outcomeRows.length} | Compliance rows: ${complianceRows.length}`,
511
- ];
506
+ function runFigureLines(label: string, f: RunFigures): string[] {
507
+ const p = `[bkit-analysis] [${label}]`;
508
+ const lines = [`${p} Run outcomes: ${f.outcomes} | Compliance rows: ${f.compliance}`];
509
+ const { elapsed, regression, challengeGate, complianceRates, versionCompliance } = f;
512
510
 
513
511
  if (elapsed.count > 0) {
514
- reportLines.push(
515
- `[bkit-analysis] Duration (min): mean=${elapsed.meanMinutes.toFixed(1)} | p50=${elapsed.p50Minutes.toFixed(1)} | min=${elapsed.minMinutes} | max=${elapsed.maxMinutes}`,
512
+ lines.push(
513
+ `${p} Duration (min): mean=${elapsed.meanMinutes.toFixed(1)} | p50=${elapsed.p50Minutes.toFixed(1)} | min=${elapsed.minMinutes} | max=${elapsed.maxMinutes}`,
516
514
  );
517
515
  }
518
516
 
519
- // Regression report
520
- reportLines.push(
521
- `[bkit-analysis] #183 Size↔outcome regression (dispatch-size threshold: ${regression.dispatchSizeThreshold} lines added):`,
517
+ lines.push(
518
+ `${p} #183 Size↔outcome regression (dispatch-size threshold: ${regression.dispatchSizeThreshold} lines added):`,
522
519
  );
523
520
  for (const b of regression.buckets) {
524
521
  if (b.count > 0) {
525
- reportLines.push(
522
+ lines.push(
526
523
  ` ${b.label}: ${b.count} runs, ${b.errorCount} errors (${(b.errorRate * 100).toFixed(1)}%)`,
527
524
  );
528
525
  }
529
526
  }
530
- reportLines.push(
531
- `[bkit-analysis] counter.source trust: shell-bus=${regression.shellBusCount} (trusted) | model-self-report=${regression.modelSelfReportCount} (untrusted)`,
527
+ lines.push(
528
+ `${p} counter.source trust: shell-bus=${regression.shellBusCount} (trusted) | model-self-report=${regression.modelSelfReportCount} (untrusted)`,
532
529
  );
533
530
 
534
531
  if (challengeGate.runs > 0) {
535
- reportLines.push(
536
- `[bkit-analysis] Build challenge size: ${challengeGate.small} small (challenge-1 skipped) | ${challengeGate.large} large, of ${challengeGate.runs} runs`,
532
+ lines.push(
533
+ `${p} Build challenge size: ${challengeGate.small} small (challenge-1 skipped) | ${challengeGate.large} large, of ${challengeGate.runs} runs`,
537
534
  );
538
535
  }
539
536
 
540
- // Compliance rates
541
537
  if (complianceRates.length > 0) {
542
- reportLines.push(`[bkit-analysis] Per-rule compliance rates:`);
538
+ lines.push(`${p} Per-rule compliance rates:`);
543
539
  for (const r of complianceRates) {
544
- reportLines.push(
540
+ lines.push(
545
541
  ` ${r.rule}: ${(r.passRate * 100).toFixed(1)}% pass (${r.passCount}/${r.totalCount})`,
546
542
  );
547
543
  }
548
544
  }
549
545
 
550
- // Version compliance
551
546
  if (versionCompliance.length > 0) {
552
- reportLines.push(`[bkit-analysis] Per-bkit.version compliance:`);
547
+ lines.push(`${p} Per-bkit.version compliance:`);
553
548
  for (const v of versionCompliance) {
554
- reportLines.push(
555
- ` v${v.version}: ${(v.passRate * 100).toFixed(1)}% pass (${v.totalRuns} runs)`,
556
- );
549
+ lines.push(` v${v.version}: ${(v.passRate * 100).toFixed(1)}% pass (${v.totalRuns} runs)`);
557
550
  }
558
551
  }
552
+ return lines;
553
+ }
554
+
555
+ // ---------------------------------------------------------------------------
556
+ // Full analysis report
557
+ // ---------------------------------------------------------------------------
558
+
559
+ export interface AnalysisReport {
560
+ counts: TelemetryCounts;
561
+ /** Workflow rows and direct-chat (`utility`) rows, never added together. */
562
+ runs: Record<RowSource, RunFigures>;
563
+ deferralDiscipline: DeferralDisciplineEntry[];
564
+ reportLines: string[];
565
+ }
566
+
567
+ /** Analyse the folded rows of `paths`, leaving out rows of `skipKinds`. */
568
+ export function runAnalysis(
569
+ paths: string[],
570
+ skipKinds: ReadonlySet<string> = new Set(),
571
+ ): AnalysisReport {
572
+ const { state, rowCount, malformedLineCount } = foldFrom(paths);
573
+ const events = [...state.values()].filter((ev) => !skipKinds.has(ev.kind));
574
+
575
+ const grouped = () => ({
576
+ outcome: [] as OutcomeRow[],
577
+ counter: [] as CounterRow[],
578
+ compliance: [] as ComplianceRow[],
579
+ });
580
+ const bySource: Record<RowSource, ReturnType<typeof grouped>> = {
581
+ workflow: grouped(),
582
+ utility: grouped(),
583
+ };
584
+ const deferralRows: DeferralRow[] = [];
585
+
586
+ for (const ev of events) {
587
+ const g = bySource[rowSource(ev)];
588
+ if (ev.kind === "outcome") {
589
+ g.outcome.push(ev);
590
+ } else if (ev.kind === "counter") {
591
+ g.counter.push(ev);
592
+ } else if (ev.kind === "compliance") {
593
+ g.compliance.push(ev);
594
+ } else if (ev.kind === "deferral") {
595
+ deferralRows.push(ev);
596
+ }
597
+ }
598
+
599
+ const counts = computeCounts(events);
600
+ const runs: Record<RowSource, RunFigures> = {
601
+ workflow: computeRunFigures(
602
+ bySource.workflow.outcome,
603
+ bySource.workflow.counter,
604
+ bySource.workflow.compliance,
605
+ ),
606
+ utility: computeRunFigures(
607
+ bySource.utility.outcome,
608
+ bySource.utility.counter,
609
+ bySource.utility.compliance,
610
+ ),
611
+ };
612
+ const deferralDiscipline = computeDeferralDiscipline(deferralRows);
613
+
614
+ const reportLines: string[] = [
615
+ `[bkit-analysis] Telemetry rows: ${rowCount} | malformed: ${malformedLineCount}`,
616
+ `[bkit-analysis] Kinds: ${JSON.stringify(counts.byKind)}`,
617
+ `[bkit-analysis] Workflows: ${JSON.stringify(counts.byWorkflow)}`,
618
+ ...runFigureLines("workflow", runs.workflow),
619
+ ...runFigureLines(UTILITY_WORKFLOW, runs.utility),
620
+ ];
559
621
 
560
622
  // Deferral discipline — who defers work they should have finished.
561
623
  if (deferralDiscipline.length > 0) {
@@ -577,15 +639,5 @@ export function runAnalysis(
577
639
  }
578
640
  }
579
641
 
580
- return {
581
- counts,
582
- elapsed,
583
- regression,
584
- complianceRates,
585
- versionCompliance,
586
- deferralDiscipline,
587
- challengeGate,
588
- agentContext,
589
- reportLines,
590
- };
642
+ return { counts, runs, deferralDiscipline, reportLines };
591
643
  }