@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
package/dist/cli.js CHANGED
@@ -413,92 +413,228 @@ export function parseArgs(argv) {
413
413
  tipsWorkflow,
414
414
  };
415
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
+ }
416
633
  export function printUsage() {
417
634
  console.log(`bkit — agent-stack consolidation CLI
418
635
 
419
636
  Usage:
420
- bkit install <module-flags> Install (or re-sync) the named modules + the implicit
421
- core foundation. At least one module flag is REQUIRED —
422
- a bare \`bkit install\` errors (name the modules below).
423
- Hosts compose: --claude --cursor --codex --antigravity
424
- --opencode=<provider>.
425
- bkit check Dry-run — drift-check everything already installed (no
426
- module flags). Exits 1 when a managed file needs
427
- re-rendering. Copies under .bkit/templates/ are refreshed by
428
- install/upgrade and checked for staleness — adopt one by
429
- copying it elsewhere; that copy is yours. The CI gate.
430
- Changes no managed file; rewrites .bkit/advisories.md.
431
- bkit upgrade [--to=<version>|--latest] [--auto-apply] [--dry-run]
432
- Upgrade everything installed (no module flags). Diffs old
433
- vs new templates; conflict list emitted to stderr. Use
434
- --auto-apply for CI (apply non-conflicting; exit non-zero
435
- on any conflict). Only a whole file you edited since bkit
436
- wrote it conflicts; rendered files (agents, commands,
437
- skills, .bkit/*.md) are always re-rendered — bkit check
438
- flags an edit to one.
439
- --to=<version> / --latest atomically BUMP @cbartens/bkit
440
- (pnpm add), then re-render + re-pin in one step — so a
441
- version bump can never drift from its rendered mirrors.
442
- This is the supported way to move bkit versions; a bare
443
- \`pnpm add @cbartens/bkit\` alone leaves mirrors stale.
444
- bkit uninstall [module-flags] Remove bkit-managed files + strip managed blocks.
445
- No flags = full removal — ALL modules incl. opt-in add-ons
446
- (cloud/opencode) + core. Consumer-owned updater configs
447
- (renovate.json5, dependabot.yml, bkit-renovate.yml) are left in place. Consumer-modified
448
- files, your own files under docs/, and generated artefacts
449
- (.bkit/advisories.md, .bkit/friction.jsonl) are preserved (use
450
- --nuke to force-remove manifest-listed files). Target with the
451
- same module flags as install (e.g. uninstall --claude); a
452
- targeted uninstall leaves core untouched.
453
- bkit doctor Preflight + post-install advisory replay (changes no
454
- managed file; rewrites .bkit/advisories.md). Diagnose
455
- token surfaces and config drift. Exits 0.
456
- bkit tips [--workflow=<name>] [--all]
457
- Setup tips: what this repo has not set up yet, most useful
458
- first, each with a sentence to ask your agent. Top three
459
- by default; --workflow=design|plan|build|debug|ship puts
460
- the tips that matter there first and prints one (each
461
- workflow runs this at its close; audit and utility do the
462
- same for audits and the ledger / roadmap updaters);
463
- --all lists every one. Ends with a star line ("bkit-star"
464
- in bkit.advisories.ignore silences it), except under
465
- --workflow=audit|utility. Local checks only. Exits 0.
466
- bkit status Read-only host/provider status. Reports current host+provider
467
- (sampled from .claude/, .cursor/, package.json, and the
468
- opencode agent model pins in .opencode/agents/).
469
- Writes nothing. Exits 0.
470
- bkit cursor Launch Cursor with .bkit/.env loaded into its environment.
471
- macOS GUI apps launched from the Dock/Finder do not inherit
472
- the login shell env (direnv stays shell-only), so MCP token
473
- placeholders resolve empty. This verb execs the app binary
474
- directly with the per-repo .bkit/.env merged in. Quit Cursor
475
- before running — a running instance ignores the new env.
476
- Override binary path via BKIT_CURSOR_BIN=<path>.
477
- bkit opencode Same as \`bkit cursor\` but for the opencode desktop app.
478
- Override binary path via BKIT_OPENCODE_BIN=<path>.
479
- bkit comply --phase=<phase> Run the compliance grader advisory step.
480
- Checks the diff since parentSha for violations
481
- (no-mirror-edit, skip-ci-not-head). Advisory only —
482
- never gates a workflow. Appends kind:"compliance"
483
- rows to .bkit/stats.jsonl. Fail-open: always exits 0.
484
- Valid phases: design, plan, build, debug, ship.
485
- bkit telemetry summary [--phase=<workflow>]
486
- Per-workflow telemetry report: THIS run's metrics
487
- (duration, size, friction/deferrals/failures added,
488
- compliance) against med·5 — the median of the previous 5
489
- same-workflow runs. The close step of every /bkit-*
490
- workflow calls this and posts it to the tracker comment.
491
- --phase=<workflow>: the workflow to report
492
- (design|plan|build|debug|ship). Without it, prints the
493
- ledger-health line only. Read-only: exits 0.
494
- bkit stats This repo's stats report: counts, durations, change-size vs
495
- outcome, counterSource trust, per-rule and per-version
496
- compliance, and the unjustified-deferral rate per
497
- (subagent, model). Reads .bkit/stats.jsonl,
498
- .bkit/friction.jsonl and docs/deferrals.jsonl of THIS repo
499
- only; writes .bkit/stats.md and prints it.
500
- Advisory + inform-only: exits 0.
501
- bkit help Print this message.
637
+ ${classicUsage()}
502
638
 
503
639
  Core (implicit — no flag; installed/upgraded on every install):
504
640
  AGENTS.md (cross-host dispatch router), .agents/rules.md + .agents/context.md +
@@ -506,7 +642,7 @@ Core (implicit — no flag; installed/upgraded on every install):
506
642
  .gitattributes managed blocks, docs/, .bkit/*.md, .bkit/version, the template copies in
507
643
  .bkit/templates/, and the bkit:gate:* / bkit:deps:* package.json scripts every workflow
508
644
  runs (added when missing, never overwritten, left by uninstall). The tool scripts those
509
- 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
510
646
  yours to add: see .bkit/templates.md.
511
647
 
512
648
  Module flags (composable; symmetric install ↔ uninstall):
@@ -542,6 +678,8 @@ Dependency updaters (copy an example and own it):
542
678
  .bkit/templates/.github/renovate.json5
543
679
  .bkit/templates/.github/workflows/bkit-renovate.yml (self-hosted runner, optional)
544
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.
545
683
  All templates and install steps: .bkit/templates.md
546
684
 
547
685
  --auto=<claude|cursor|opencode>
@@ -635,7 +773,7 @@ function commandsUsage() {
635
773
  export function validateModuleFlagsForVerb(verb, moduleFlags, tracker = null) {
636
774
  if (verb === "install" && moduleFlags.size === 0 && tracker === null) {
637
775
  return ("[bkit] `bkit install` requires at least one module flag. Name what to install: " +
638
- "--claude, --cursor, --codex, --antigravity, --opencode=<provider> (plus opt-in " +
776
+ "--claude, --codex, --antigravity, --cursor, --opencode=<provider> (plus opt-in " +
639
777
  `--auto=<${CLOUD_VARIANTS.join("|")}>), or --tracker=<name> alone to switch the ` +
640
778
  "tracker on what is installed. Run `bkit help` for usage.");
641
779
  }
@@ -13,15 +13,28 @@
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
  import { AGENT_CONTEXT_CAP, UNJUSTIFIED_REASON, foldFrom, } from "../ledgers/telemetry.js";
23
+ // ---------------------------------------------------------------------------
24
+ // Counts / rates summary
25
+ // ---------------------------------------------------------------------------
26
+ /** `by.workflow` of a row a direct chat wrote, outside any workflow run. */
27
+ export const UTILITY_WORKFLOW = "utility";
28
+ export const ROW_SOURCES = ["workflow", "utility"];
29
+ export function rowSource(row) {
30
+ return row.by?.workflow === UTILITY_WORKFLOW ? "utility" : "workflow";
31
+ }
19
32
  export function computeCounts(events) {
20
33
  const byKind = {};
21
34
  const byWorkflow = {};
22
35
  const byRepo = {};
23
36
  for (const ev of events) {
24
- byKind[ev.kind] = (byKind[ev.kind] ?? 0) + 1;
37
+ (byKind[ev.kind] ??= { workflow: 0, utility: 0 })[rowSource(ev)]++;
25
38
  const workflow = ev.by?.workflow ?? "unknown";
26
39
  byWorkflow[workflow] = (byWorkflow[workflow] ?? 0) + 1;
27
40
  byRepo[ev.repo] = (byRepo[ev.repo] ?? 0) + 1;
@@ -260,70 +273,91 @@ export function computeDeferralDiscipline(rows) {
260
273
  b.total - a.total ||
261
274
  a.writer.localeCompare(b.writer));
262
275
  }
276
+ export function computeRunFigures(outcomeRows, counterRows, complianceRows) {
277
+ return {
278
+ outcomes: outcomeRows.length,
279
+ compliance: complianceRows.length,
280
+ elapsed: computeElapsedStats(outcomeRows),
281
+ regression: computeRegression(outcomeRows, counterRows),
282
+ complianceRates: computeComplianceRates(complianceRows),
283
+ versionCompliance: computeVersionCompliance(complianceRows),
284
+ challengeGate: computeChallengeGate(outcomeRows),
285
+ agentContext: computeAgentContext(outcomeRows),
286
+ };
287
+ }
288
+ function runFigureLines(label, f) {
289
+ const p = `[bkit-analysis] [${label}]`;
290
+ const lines = [`${p} Run outcomes: ${f.outcomes} | Compliance rows: ${f.compliance}`];
291
+ const { elapsed, regression, challengeGate, complianceRates, versionCompliance } = f;
292
+ if (elapsed.count > 0) {
293
+ lines.push(`${p} Duration (min): mean=${elapsed.meanMinutes.toFixed(1)} | p50=${elapsed.p50Minutes.toFixed(1)} | min=${elapsed.minMinutes} | max=${elapsed.maxMinutes}`);
294
+ }
295
+ lines.push(`${p} #183 Size↔outcome regression (dispatch-size threshold: ${regression.dispatchSizeThreshold} lines added):`);
296
+ for (const b of regression.buckets) {
297
+ if (b.count > 0) {
298
+ lines.push(` ${b.label}: ${b.count} runs, ${b.errorCount} errors (${(b.errorRate * 100).toFixed(1)}%)`);
299
+ }
300
+ }
301
+ lines.push(`${p} counter.source trust: shell-bus=${regression.shellBusCount} (trusted) | model-self-report=${regression.modelSelfReportCount} (untrusted)`);
302
+ if (challengeGate.runs > 0) {
303
+ lines.push(`${p} Build challenge size: ${challengeGate.small} small (challenge-1 skipped) | ${challengeGate.large} large, of ${challengeGate.runs} runs`);
304
+ }
305
+ if (complianceRates.length > 0) {
306
+ lines.push(`${p} Per-rule compliance rates:`);
307
+ for (const r of complianceRates) {
308
+ lines.push(` ${r.rule}: ${(r.passRate * 100).toFixed(1)}% pass (${r.passCount}/${r.totalCount})`);
309
+ }
310
+ }
311
+ if (versionCompliance.length > 0) {
312
+ lines.push(`${p} Per-bkit.version compliance:`);
313
+ for (const v of versionCompliance) {
314
+ lines.push(` v${v.version}: ${(v.passRate * 100).toFixed(1)}% pass (${v.totalRuns} runs)`);
315
+ }
316
+ }
317
+ return lines;
318
+ }
263
319
  /** Analyse the folded rows of `paths`, leaving out rows of `skipKinds`. */
264
320
  export function runAnalysis(paths, skipKinds = new Set()) {
265
321
  const { state, rowCount, malformedLineCount } = foldFrom(paths);
266
322
  const events = [...state.values()].filter((ev) => !skipKinds.has(ev.kind));
267
- const outcomeRows = [];
268
- const counterRows = [];
269
- const complianceRows = [];
323
+ const grouped = () => ({
324
+ outcome: [],
325
+ counter: [],
326
+ compliance: [],
327
+ });
328
+ const bySource = {
329
+ workflow: grouped(),
330
+ utility: grouped(),
331
+ };
270
332
  const deferralRows = [];
271
333
  for (const ev of events) {
334
+ const g = bySource[rowSource(ev)];
272
335
  if (ev.kind === "outcome") {
273
- outcomeRows.push(ev);
336
+ g.outcome.push(ev);
274
337
  }
275
338
  else if (ev.kind === "counter") {
276
- counterRows.push(ev);
339
+ g.counter.push(ev);
277
340
  }
278
341
  else if (ev.kind === "compliance") {
279
- complianceRows.push(ev);
342
+ g.compliance.push(ev);
280
343
  }
281
344
  else if (ev.kind === "deferral") {
282
345
  deferralRows.push(ev);
283
346
  }
284
347
  }
285
348
  const counts = computeCounts(events);
286
- const elapsed = computeElapsedStats(outcomeRows);
287
- const regression = computeRegression(outcomeRows, counterRows);
288
- const complianceRates = computeComplianceRates(complianceRows);
289
- const versionCompliance = computeVersionCompliance(complianceRows);
349
+ const runs = {
350
+ workflow: computeRunFigures(bySource.workflow.outcome, bySource.workflow.counter, bySource.workflow.compliance),
351
+ utility: computeRunFigures(bySource.utility.outcome, bySource.utility.counter, bySource.utility.compliance),
352
+ };
290
353
  const deferralDiscipline = computeDeferralDiscipline(deferralRows);
291
- const challengeGate = computeChallengeGate(outcomeRows);
292
- const agentContext = computeAgentContext(outcomeRows);
293
354
  const reportLines = [
294
355
  `[bkit-analysis] Telemetry rows: ${rowCount} | malformed: ${malformedLineCount}`,
295
356
  `[bkit-analysis] Kinds: ${JSON.stringify(counts.byKind)}`,
296
357
  `[bkit-analysis] Workflows: ${JSON.stringify(counts.byWorkflow)}`,
297
- `[bkit-analysis] Run outcomes: ${outcomeRows.length} | Compliance rows: ${complianceRows.length}`,
358
+ ...runFigureLines("workflow", runs.workflow),
359
+ ...runFigureLines(UTILITY_WORKFLOW, runs.utility),
298
360
  ];
299
- if (elapsed.count > 0) {
300
- reportLines.push(`[bkit-analysis] Duration (min): mean=${elapsed.meanMinutes.toFixed(1)} | p50=${elapsed.p50Minutes.toFixed(1)} | min=${elapsed.minMinutes} | max=${elapsed.maxMinutes}`);
301
- }
302
- // Regression report
303
- reportLines.push(`[bkit-analysis] #183 Size↔outcome regression (dispatch-size threshold: ${regression.dispatchSizeThreshold} lines added):`);
304
- for (const b of regression.buckets) {
305
- if (b.count > 0) {
306
- reportLines.push(` ${b.label}: ${b.count} runs, ${b.errorCount} errors (${(b.errorRate * 100).toFixed(1)}%)`);
307
- }
308
- }
309
- reportLines.push(`[bkit-analysis] counter.source trust: shell-bus=${regression.shellBusCount} (trusted) | model-self-report=${regression.modelSelfReportCount} (untrusted)`);
310
- if (challengeGate.runs > 0) {
311
- reportLines.push(`[bkit-analysis] Build challenge size: ${challengeGate.small} small (challenge-1 skipped) | ${challengeGate.large} large, of ${challengeGate.runs} runs`);
312
- }
313
- // Compliance rates
314
- if (complianceRates.length > 0) {
315
- reportLines.push(`[bkit-analysis] Per-rule compliance rates:`);
316
- for (const r of complianceRates) {
317
- reportLines.push(` ${r.rule}: ${(r.passRate * 100).toFixed(1)}% pass (${r.passCount}/${r.totalCount})`);
318
- }
319
- }
320
- // Version compliance
321
- if (versionCompliance.length > 0) {
322
- reportLines.push(`[bkit-analysis] Per-bkit.version compliance:`);
323
- for (const v of versionCompliance) {
324
- reportLines.push(` v${v.version}: ${(v.passRate * 100).toFixed(1)}% pass (${v.totalRuns} runs)`);
325
- }
326
- }
327
361
  // Deferral discipline — who defers work they should have finished.
328
362
  if (deferralDiscipline.length > 0) {
329
363
  const totals = deferralDiscipline.reduce((acc, d) => ({ total: acc.total + d.total, unjust: acc.unjust + d.unjustifiedCount }), { total: 0, unjust: 0 });
@@ -336,15 +370,5 @@ export function runAnalysis(paths, skipKinds = new Set()) {
336
370
  reportLines.push(` ${d.writer} [${d.model}]: ${d.unjustifiedCount}/${d.total} unjustified (${(d.unjustifiedRate * 100).toFixed(1)}%) | ${reasons}`);
337
371
  }
338
372
  }
339
- return {
340
- counts,
341
- elapsed,
342
- regression,
343
- complianceRates,
344
- versionCompliance,
345
- deferralDiscipline,
346
- challengeGate,
347
- agentContext,
348
- reportLines,
349
- };
373
+ return { counts, runs, deferralDiscipline, reportLines };
350
374
  }