@cbartens/bkit 5.5.1 → 6.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (425) hide show
  1. package/.bkit/README.md +167 -154
  2. package/.bkit/core/.agents/context.md +95 -29
  3. package/.bkit/core/.agents/docs.md +18 -15
  4. package/.bkit/core/.agents/plugins/bkit/hooks/bkit-gateguard.cjs +1 -0
  5. package/.bkit/core/.agents/plugins/bkit/hooks/bkit-guardrails.cjs +6 -5
  6. package/.bkit/core/.agents/plugins/bkit/hooks/bkit-readguard.cjs +1 -0
  7. package/.bkit/core/.agents/plugins/bkit/hooks/bkit-rules.cjs +65 -0
  8. package/.bkit/core/.agents/rules.md +112 -102
  9. package/.bkit/core/.agents/skills.md +63 -15
  10. package/.bkit/core/.bkit/README.md +167 -154
  11. package/.bkit/core/.bkit/authoring.md +747 -0
  12. package/.bkit/core/.bkit/cli.md +407 -0
  13. package/.bkit/core/.bkit/cloud.md +283 -195
  14. package/.bkit/core/.bkit/comparison.md +45 -43
  15. package/.bkit/core/.bkit/install.md +166 -95
  16. package/.bkit/core/.bkit/jsonl.md +339 -196
  17. package/.bkit/core/.bkit/pipeline.md +142 -145
  18. package/.bkit/core/.bkit/prompts.md +295 -264
  19. package/.bkit/core/.bkit/providers.md +460 -277
  20. package/.bkit/core/.bkit/router.md +69 -0
  21. package/.bkit/core/.bkit/templates.md +530 -256
  22. package/.bkit/core/.bkit/trackers.md +116 -65
  23. package/.bkit/core/.bkit/workflows.md +742 -618
  24. package/.bkit/core/.claude/hooks/bkit-gateguard.cjs +2 -2
  25. package/.bkit/core/.claude/hooks/bkit-guardrails.cjs +3 -3
  26. package/.bkit/core/.claude/hooks/bkit-preflight.sh +45 -14
  27. package/.bkit/core/.codex/hooks/bkit-guardrails.cjs +3 -3
  28. package/.bkit/core/.codex/hooks/bkit-rules.cjs +57 -0
  29. package/.bkit/core/.cursor/hooks/bkit-guardrails.cjs +7 -7
  30. package/.bkit/core/.cursor/hooks/bkit-preflight.sh +47 -12
  31. package/.bkit/core/.opencode/plugin/bkit-rules.js +89 -0
  32. package/.bkit/core/AGENTS.md +6 -80
  33. package/.bkit/core/docs/templates/bkit-audit-accessibility.md +128 -130
  34. package/.bkit/core/docs/templates/bkit-audit-adoption.md +104 -94
  35. package/.bkit/core/docs/templates/bkit-audit-agents.md +96 -98
  36. package/.bkit/core/docs/templates/bkit-audit-aio-seo.md +100 -103
  37. package/.bkit/core/docs/templates/bkit-audit-analytics.md +141 -107
  38. package/.bkit/core/docs/templates/bkit-audit-annotations.md +99 -97
  39. package/.bkit/core/docs/templates/bkit-audit-app-performance.md +122 -121
  40. package/.bkit/core/docs/templates/bkit-audit-app-store.md +158 -101
  41. package/.bkit/core/docs/templates/bkit-audit-architecture.md +114 -96
  42. package/.bkit/core/docs/templates/bkit-audit-ci-performance.md +76 -97
  43. package/.bkit/core/docs/templates/bkit-audit-config.md +123 -101
  44. package/.bkit/core/docs/templates/bkit-audit-cost.md +86 -99
  45. package/.bkit/core/docs/templates/bkit-audit-coverage.md +76 -93
  46. package/.bkit/core/docs/templates/bkit-audit-database.md +102 -95
  47. package/.bkit/core/docs/templates/bkit-audit-dead-code.md +165 -108
  48. package/.bkit/core/docs/templates/bkit-audit-deferrals.md +115 -109
  49. package/.bkit/core/docs/templates/bkit-audit-dependencies.md +265 -113
  50. package/.bkit/core/docs/templates/bkit-audit-documentation.md +119 -118
  51. package/.bkit/core/docs/templates/bkit-audit-duplication.md +140 -111
  52. package/.bkit/core/docs/templates/bkit-audit-failures.md +111 -106
  53. package/.bkit/core/docs/templates/bkit-audit-flakes.md +100 -99
  54. package/.bkit/core/docs/templates/bkit-audit-gates.md +107 -103
  55. package/.bkit/core/docs/templates/bkit-audit-issues.md +105 -105
  56. package/.bkit/core/docs/templates/bkit-audit-llm.md +134 -85
  57. package/.bkit/core/docs/templates/bkit-audit-logs.md +124 -125
  58. package/.bkit/core/docs/templates/bkit-audit-models.md +99 -78
  59. package/.bkit/core/docs/templates/bkit-audit-privacy.md +56 -76
  60. package/.bkit/core/docs/templates/bkit-audit-prompts.md +63 -78
  61. package/.bkit/core/docs/templates/bkit-audit-red-team.md +125 -93
  62. package/.bkit/core/docs/templates/bkit-audit-reliability.md +97 -96
  63. package/.bkit/core/docs/templates/bkit-audit-repo.md +170 -98
  64. package/.bkit/core/docs/templates/bkit-audit-security.md +207 -121
  65. package/.bkit/core/docs/templates/bkit-audit-slop.md +78 -95
  66. package/.bkit/core/docs/templates/bkit-audit-testing.md +163 -139
  67. package/.bkit/core/docs/templates/bkit-audit-usability.md +114 -96
  68. package/.bkit/core/docs/templates/bkit-plan.md +158 -281
  69. package/.bkit/core/engine/checks/after/auth.ts +40 -37
  70. package/.bkit/core/engine/checks/after/ci-yml.ts +104 -31
  71. package/.bkit/core/engine/checks/after/github.ts +95 -17
  72. package/.bkit/core/engine/checks/after/index.ts +21 -8
  73. package/.bkit/core/engine/checks/after/suppression.ts +8 -5
  74. package/.bkit/core/engine/checks/after/tools.ts +125 -123
  75. package/.bkit/core/engine/checks/before/context-fetch.ts +227 -33
  76. package/.bkit/core/engine/checks/before/env.ts +3 -3
  77. package/.bkit/core/engine/checks/before/files.ts +5 -4
  78. package/.bkit/core/engine/checks/before/index.ts +25 -1
  79. package/.bkit/core/engine/checks/before/repo.ts +208 -2
  80. package/.bkit/core/engine/checks/status-holes.ts +916 -123
  81. package/.bkit/core/engine/checks/tips/catalogue.ts +82 -20
  82. package/.bkit/core/engine/checks/tips/detect.ts +66 -0
  83. package/.bkit/core/engine/checks/tips/index.ts +52 -11
  84. package/.bkit/core/engine/cli.ts +251 -130
  85. package/.bkit/core/engine/commands/analysis.ts +282 -199
  86. package/.bkit/core/engine/commands/ci/ci.ts +363 -29
  87. package/.bkit/core/engine/commands/ci/pins.ts +172 -0
  88. package/.bkit/core/engine/commands/ci/push-gate.ts +223 -0
  89. package/.bkit/core/engine/commands/comply.ts +77 -103
  90. package/.bkit/core/engine/commands/install/doctor.ts +2 -2
  91. package/.bkit/core/engine/commands/install/install.ts +57 -18
  92. package/.bkit/core/engine/commands/install/uninstall.ts +86 -55
  93. package/.bkit/core/engine/commands/install/upgrade.ts +32 -15
  94. package/.bkit/core/engine/commands/land.ts +139 -18
  95. package/.bkit/core/engine/commands/lib.ts +381 -22
  96. package/.bkit/core/engine/commands/registry.ts +10 -2
  97. package/.bkit/core/engine/commands/setup/setup.ts +8 -7
  98. package/.bkit/core/engine/commands/stats.ts +260 -0
  99. package/.bkit/core/engine/commands/tips.ts +10 -5
  100. package/.bkit/core/engine/commands/workflow/branches.ts +2215 -176
  101. package/.bkit/core/engine/commands/workflow/challenge.ts +748 -0
  102. package/.bkit/core/engine/commands/workflow/completeness.ts +109 -0
  103. package/.bkit/core/engine/commands/workflow/context.ts +1249 -47
  104. package/.bkit/core/engine/commands/workflow/counters.ts +483 -95
  105. package/.bkit/core/engine/commands/workflow/decisions.ts +585 -0
  106. package/.bkit/core/engine/commands/workflow/disk.ts +238 -56
  107. package/.bkit/core/engine/commands/workflow/fids.ts +811 -33
  108. package/.bkit/core/engine/commands/workflow/issues.ts +413 -64
  109. package/.bkit/core/engine/commands/workflow/ledgers.ts +1333 -36
  110. package/.bkit/core/engine/commands/workflow/locks.ts +28 -2
  111. package/.bkit/core/engine/commands/workflow/plan-blocks.ts +691 -0
  112. package/.bkit/core/engine/commands/workflow/plan-versions.ts +21 -0
  113. package/.bkit/core/engine/commands/workflow/plans.ts +257 -0
  114. package/.bkit/core/engine/commands/workflow/prs.ts +178 -33
  115. package/.bkit/core/engine/commands/workflow/repo.ts +66 -8
  116. package/.bkit/core/engine/commands/workflow/roadmap.ts +72 -22
  117. package/.bkit/core/engine/commands/workflow/run-facts.ts +492 -0
  118. package/.bkit/core/engine/commands/workflow/runs.ts +827 -79
  119. package/.bkit/core/engine/commands/workflow/runtime.ts +25 -1
  120. package/.bkit/core/engine/commands/workflow/skills.ts +1 -0
  121. package/.bkit/core/engine/commands/workflow/status.ts +329 -33
  122. package/.bkit/core/engine/commands/workflow/step-table.ts +381 -0
  123. package/.bkit/core/engine/commands/workflow/steps.ts +841 -105
  124. package/.bkit/core/engine/commands/workflow/summary-findings.ts +177 -0
  125. package/.bkit/core/engine/commands/workflow/summary.ts +544 -0
  126. package/.bkit/core/engine/commands/workflow/tasks.ts +409 -0
  127. package/.bkit/core/engine/commands/workflow/test-blocks.ts +254 -0
  128. package/.bkit/core/engine/commands/workflow/tests-changed.ts +201 -0
  129. package/.bkit/core/engine/commands/workflow/tests.ts +2124 -330
  130. package/.bkit/core/engine/commands/workflow/tracker.ts +1195 -0
  131. package/.bkit/core/engine/commands/workflow/workflows.ts +1197 -235
  132. package/.bkit/core/engine/commands/workflow/worktrees.ts +543 -24
  133. package/.bkit/core/engine/install/cloud-env.ts +251 -121
  134. package/.bkit/core/engine/install/context-ci-workflow.ts +102 -0
  135. package/.bkit/core/engine/install/manifest.ts +67 -17
  136. package/.bkit/core/engine/install/modules/antigravity.ts +3 -2
  137. package/.bkit/core/engine/install/modules/cloud.ts +24 -16
  138. package/.bkit/core/engine/install/modules/codex.ts +15 -2
  139. package/.bkit/core/engine/install/modules/core.ts +1196 -45
  140. package/.bkit/core/engine/install/modules/cursor.ts +6 -6
  141. package/.bkit/core/engine/install/modules/opencode.ts +18 -6
  142. package/.bkit/core/engine/install/template-notes.ts +130 -0
  143. package/.bkit/core/engine/install/version-file.ts +9 -4
  144. package/.bkit/core/engine/install/write.ts +5 -0
  145. package/.bkit/core/engine/ledgers/compact.ts +124 -0
  146. package/.bkit/core/engine/ledgers/journal.ts +291 -0
  147. package/.bkit/core/engine/ledgers/migrate.ts +92 -0
  148. package/.bkit/core/engine/ledgers/status.ts +249 -21
  149. package/.bkit/core/engine/ledgers/telemetry.ts +1397 -253
  150. package/.bkit/core/engine/render/hosts.ts +118 -14
  151. package/.bkit/core/engine/render/models.ts +12 -0
  152. package/.bkit/core/engine/shared/bkit-latest.ts +26 -4
  153. package/.bkit/core/engine/shared/branches.ts +4 -1
  154. package/.bkit/core/engine/shared/dep-updater.ts +60 -0
  155. package/.bkit/core/engine/shared/egress.ts +8 -1
  156. package/.bkit/core/engine/shared/json.ts +25 -7
  157. package/.bkit/core/engine/shared/package-manager.ts +9 -0
  158. package/.bkit/core/engine/shared/settings.ts +243 -31
  159. package/.bkit/core/engine/shared/text.ts +361 -0
  160. package/.bkit/core/engine/shared/timeouts.ts +2 -0
  161. package/.bkit/core/engine/tools/cli-doc.ts +111 -0
  162. package/.bkit/core/engine/tools/grammar-density.ts +215 -0
  163. package/.bkit/core/engine/tools/instructions-sources.ts +832 -0
  164. package/.bkit/core/engine/tools/instructions.ts +1802 -0
  165. package/.bkit/core/hooks/antigravity-hook.js +25 -10
  166. package/.bkit/core/hooks/gateguard-engine.js +54 -29
  167. package/.bkit/core/hooks/guardrails-shell.js +4 -5
  168. package/.bkit/core/hooks/guardrails-tiers.js +10 -4
  169. package/.bkit/core/hooks/preflight-linear.sh +9 -9
  170. package/.bkit/core/hooks/preflight-rules.sh +8 -0
  171. package/.bkit/core/hooks/readguard-engine.js +29 -10
  172. package/.bkit/core/hooks/session-rules-advisory.js +61 -0
  173. package/.bkit/core/prompts/bkit-audit-generate.md +202 -94
  174. package/.bkit/core/prompts/bkit-build-challenge-1.md +76 -34
  175. package/.bkit/core/prompts/bkit-build-challenge-2.md +85 -38
  176. package/.bkit/core/prompts/bkit-build-install-skills.md +50 -28
  177. package/.bkit/core/prompts/bkit-build-plan-convert.md +85 -0
  178. package/.bkit/core/prompts/bkit-build-plan-current.md +59 -36
  179. package/.bkit/core/prompts/bkit-build-plan-gaps-remediate.md +101 -36
  180. package/.bkit/core/prompts/bkit-build-plan-tasks.md +149 -0
  181. package/.bkit/core/prompts/bkit-build-plan-tests.md +120 -0
  182. package/.bkit/core/prompts/bkit-build-plan-verify.md +104 -43
  183. package/.bkit/core/prompts/bkit-debug-abort-handover.md +47 -32
  184. package/.bkit/core/prompts/bkit-debug-failure-diagnose.md +109 -57
  185. package/.bkit/core/prompts/bkit-debug-failure-remediate.md +65 -39
  186. package/.bkit/core/prompts/bkit-debug-failure-reproduce.md +53 -31
  187. package/.bkit/core/prompts/bkit-debug-failure-soak.md +65 -34
  188. package/.bkit/core/prompts/bkit-design-brainstorm-ideate-1.md +46 -31
  189. package/.bkit/core/prompts/bkit-design-brainstorm-ideate-2.md +45 -31
  190. package/.bkit/core/prompts/bkit-design-brainstorm-ideate-3.md +43 -30
  191. package/.bkit/core/prompts/bkit-design-generate.md +80 -46
  192. package/.bkit/core/prompts/bkit-design-organise.md +83 -32
  193. package/.bkit/core/prompts/bkit-design-review-1.md +70 -50
  194. package/.bkit/core/prompts/bkit-design-review-2.md +65 -46
  195. package/.bkit/core/prompts/bkit-design-spike.md +64 -40
  196. package/.bkit/core/prompts/bkit-design-update.md +53 -28
  197. package/.bkit/core/prompts/bkit-plan-generate.md +101 -29
  198. package/.bkit/core/prompts/bkit-plan-review-1.md +78 -41
  199. package/.bkit/core/prompts/bkit-plan-review-2.md +78 -35
  200. package/.bkit/core/prompts/bkit-plan-scope-check.md +116 -0
  201. package/.bkit/core/prompts/bkit-plan-update.md +86 -31
  202. package/.bkit/core/prompts/bkit-ship-conflict-resolve.md +94 -50
  203. package/.bkit/core/prompts/bkit-ship-deferred-sweep.md +91 -41
  204. package/.bkit/core/prompts/bkit-ship-update-docs.md +45 -24
  205. package/.bkit/core/prompts/bkit-utility-compress-markdown.md +65 -49
  206. package/.bkit/core/prompts/bkit-utility-update-decisions.md +87 -42
  207. package/.bkit/core/prompts/bkit-utility-update-deferrals.md +81 -37
  208. package/.bkit/core/prompts/bkit-utility-update-documentation.md +43 -25
  209. package/.bkit/core/prompts/bkit-utility-update-failures.md +84 -37
  210. package/.bkit/core/prompts/bkit-utility-update-knowledge.md +88 -42
  211. package/.bkit/core/prompts/bkit-utility-update-roadmap.md +92 -39
  212. package/.bkit/core/prompts/bkit-utility-update-tracker.md +159 -60
  213. package/.bkit/core/workflows/bkit-auto.md +89 -58
  214. package/.bkit/core/workflows/bkit-build.md +967 -517
  215. package/.bkit/core/workflows/bkit-debug.md +555 -387
  216. package/.bkit/core/workflows/bkit-design.md +319 -283
  217. package/.bkit/core/workflows/bkit-plan.md +319 -342
  218. package/.bkit/core/workflows/bkit-ship.md +525 -328
  219. package/.bkit/shared/.agents/plugins/bkit/hooks.json +10 -0
  220. package/.bkit/shared/.bkit/.env.example +2 -2
  221. package/.bkit/shared/.claude/bkit-cloud.md +12 -10
  222. package/.bkit/shared/.claude/settings.json +14 -0
  223. package/.bkit/shared/.codex/bkit-cloud.md +98 -0
  224. package/.bkit/shared/.codex/hooks.json +20 -0
  225. package/.bkit/shared/.cursor/bkit-cloud.md +3 -3
  226. package/.bkit/shared/.cursor/mcp.json +1 -1
  227. package/.bkit/shared/.cursor/rules/bkit-rules.mdc +1 -1
  228. package/.bkit/shared/.gitattributes +1 -1
  229. package/.bkit/shared/.mcp.json +1 -1
  230. package/.bkit/shared/.opencode/opencode.json +12 -1
  231. package/.bkit/shared/CLAUDE.md +6 -2
  232. package/.bkit/shared/GEMINI.md +5 -2
  233. package/.bkit/shared/docs/architecture.md +4 -7
  234. package/.bkit/shared/docs/data-schema.md +4 -7
  235. package/.bkit/shared/docs/deployments.md +241 -168
  236. package/.bkit/shared/docs/design.md +11 -12
  237. package/.bkit/shared/docs/noise.md +8 -7
  238. package/.bkit/shared/docs/observability.md +5 -8
  239. package/.bkit/shared/docs/security.md +35 -17
  240. package/.bkit/shared/docs/setup.md +29 -18
  241. package/.bkit/shared/docs/technology.md +3 -6
  242. package/.bkit/shared/docs/testing.md +289 -174
  243. package/.bkit/shared/gitignore +6 -2
  244. package/.bkit/templates/.claude/hooks/bkit-cloud-bootstrap.sh +15 -16
  245. package/.bkit/templates/.cursor/Dockerfile +12 -8
  246. package/.bkit/templates/.cursor/environment.json +1 -1
  247. package/.bkit/templates/.github/ISSUE_TEMPLATE/bkit-bug.yml +10 -8
  248. package/.bkit/templates/.github/ISSUE_TEMPLATE/bkit-change.yml +45 -12
  249. package/.bkit/templates/.github/ISSUE_TEMPLATE/bkit-idea.yml +3 -3
  250. package/.bkit/templates/.github/renovate.json5 +34 -6
  251. package/.bkit/templates/.github/workflows/bkit-ci.yml +54 -51
  252. package/.bkit/templates/.github/workflows/bkit-cloud.yml +34 -33
  253. package/.bkit/templates/.github/workflows/bkit-health.yml +97 -0
  254. package/.bkit/templates/.github/workflows/bkit-renovate.yml +5 -4
  255. package/.bkit/templates/.github/workflows/bkit-trivy.yml +5 -4
  256. package/.bkit/templates/.husky/pre-commit +2 -2
  257. package/.bkit/templates/.husky/pre-push +96 -36
  258. package/.bkit/templates/.prettierignore +6 -0
  259. package/.bkit/templates/.vale.ini +27 -27
  260. package/.bkit/templates/context/bkit-cloudrun.md +23 -15
  261. package/.bkit/templates/context/bkit-expo.md +70 -52
  262. package/.bkit/templates/context/bkit-github.md +93 -56
  263. package/.bkit/templates/context/bkit-inngest.md +21 -15
  264. package/.bkit/templates/context/bkit-maestro.md +22 -16
  265. package/.bkit/templates/context/bkit-playwright.md +23 -17
  266. package/.bkit/templates/context/bkit-resend.md +12 -10
  267. package/.bkit/templates/context/bkit-sentry.md +30 -20
  268. package/.bkit/templates/context/bkit-serena.md +8 -7
  269. package/.bkit/templates/context/bkit-stripe.md +14 -13
  270. package/.bkit/templates/context/bkit-supabase.md +16 -13
  271. package/.bkit/templates/context/bkit-tavily.md +14 -11
  272. package/.bkit/templates/context/bkit-vercel.md +27 -18
  273. package/.bkit/templates/docs/capabilities.md +15 -14
  274. package/.bkit/templates/scripts/ci/{check-accepted-divergences.mjs → bkit-check-accepted-divergences.mjs} +6 -3
  275. package/.bkit/templates/scripts/ci/{check-accepted-divergences.test.mjs → bkit-check-accepted-divergences.test.mjs} +3 -3
  276. package/.bkit/templates/scripts/ci/{check-capstone.mjs → bkit-check-capstone.mjs} +2 -2
  277. package/.bkit/templates/scripts/ci/{check-capstone.test.mjs → bkit-check-capstone.test.mjs} +4 -4
  278. package/.bkit/templates/scripts/ci/{check-dependency-audit.mjs → bkit-check-dependency-audit.mjs} +103 -18
  279. package/.bkit/templates/scripts/ci/{check-dependency-audit.test.mjs → bkit-check-dependency-audit.test.mjs} +31 -3
  280. package/.bkit/templates/scripts/ci/bkit-machine-lock.sh +387 -0
  281. package/.bkit/templates/scripts/ci/bkit-test-awake.mjs +75 -0
  282. package/.bkit/templates/scripts/ci/bkit-test-awake.test.mjs +160 -0
  283. package/.bkit/templates/scripts/ci/lanes/{resolve-push-base.mjs → bkit-resolve-push-base.mjs} +3 -3
  284. package/.bkit/templates/scripts/ci/lanes/{resolve-push-base.test.mjs → bkit-resolve-push-base.test.mjs} +4 -4
  285. package/.bkit/templates/scripts/cleanup/bkit-disk-prune.mjs +10 -2
  286. package/.bkit/templates/scripts/graphify/bkit-graph-drift.py +1 -1
  287. package/.bkit/templates/scripts/graphify/bkit-graph-eager.py +3 -3
  288. package/.bkit/templates/scripts/graphify/bkit-graph-embed.py +63 -0
  289. package/.bkit/templates/scripts/graphify/bkit-graph-imports.py +2 -2
  290. package/.bkit/templates/scripts/graphify/bkit-graph-pre-push.sh +69 -18
  291. package/.bkit/templates/scripts/graphify/bkit-graph-repair.py +3 -3
  292. package/.bkit/templates/scripts/graphify/bkit-graph-surface.py +1 -1
  293. package/.bkit/templates/scripts/graphify/bkit-graphify-graphml.py +1 -1
  294. package/.bkit/templates/scripts/graphify/bkit-graphify-rollup.py +197 -126
  295. package/.bkit/templates/scripts/graphify/bkit-graphify.sh +64 -41
  296. package/.bkit/templates/scripts/slop/bkit-slop-type-suppression.mjs +23 -7
  297. package/.bkit/templates/slop-scan.config.json +9 -2
  298. package/CHANGELOG.md +231 -0
  299. package/README.md +278 -89
  300. package/dist/checks/after/auth.js +36 -33
  301. package/dist/checks/after/ci-yml.js +91 -30
  302. package/dist/checks/after/github.js +91 -17
  303. package/dist/checks/after/index.js +22 -11
  304. package/dist/checks/after/suppression.js +8 -5
  305. package/dist/checks/after/tools.js +111 -114
  306. package/dist/checks/before/context-fetch.js +218 -33
  307. package/dist/checks/before/env.js +3 -3
  308. package/dist/checks/before/files.js +5 -3
  309. package/dist/checks/before/index.js +20 -3
  310. package/dist/checks/before/repo.js +197 -2
  311. package/dist/checks/status-holes.js +739 -114
  312. package/dist/checks/tips/catalogue.js +70 -19
  313. package/dist/checks/tips/detect.js +62 -0
  314. package/dist/checks/tips/index.js +51 -9
  315. package/dist/cli.js +234 -124
  316. package/dist/commands/analysis.js +174 -141
  317. package/dist/commands/ci/ci.js +302 -25
  318. package/dist/commands/ci/pins.js +142 -0
  319. package/dist/commands/ci/push-gate.js +194 -0
  320. package/dist/commands/comply.js +54 -91
  321. package/dist/commands/install/doctor.js +2 -2
  322. package/dist/commands/install/install.js +50 -19
  323. package/dist/commands/install/uninstall.js +82 -55
  324. package/dist/commands/install/upgrade.js +21 -11
  325. package/dist/commands/land.js +137 -17
  326. package/dist/commands/lib.js +295 -21
  327. package/dist/commands/registry.js +10 -2
  328. package/dist/commands/setup/setup.js +8 -7
  329. package/dist/commands/stats.js +175 -0
  330. package/dist/commands/tips.js +7 -3
  331. package/dist/commands/workflow/branches.js +1873 -152
  332. package/dist/commands/workflow/challenge.js +609 -0
  333. package/dist/commands/workflow/completeness.js +97 -0
  334. package/dist/commands/workflow/context.js +1045 -46
  335. package/dist/commands/workflow/counters.js +385 -86
  336. package/dist/commands/workflow/decisions.js +484 -0
  337. package/dist/commands/workflow/disk.js +214 -56
  338. package/dist/commands/workflow/fids.js +706 -33
  339. package/dist/commands/workflow/issues.js +349 -59
  340. package/dist/commands/workflow/ledgers.js +1123 -37
  341. package/dist/commands/workflow/locks.js +26 -2
  342. package/dist/commands/workflow/plan-blocks.js +501 -0
  343. package/dist/commands/workflow/plan-versions.js +22 -0
  344. package/dist/commands/workflow/plans.js +205 -0
  345. package/dist/commands/workflow/prs.js +154 -35
  346. package/dist/commands/workflow/repo.js +58 -8
  347. package/dist/commands/workflow/roadmap.js +58 -23
  348. package/dist/commands/workflow/run-facts.js +421 -0
  349. package/dist/commands/workflow/runs.js +670 -72
  350. package/dist/commands/workflow/runtime.js +15 -1
  351. package/dist/commands/workflow/skills.js +1 -0
  352. package/dist/commands/workflow/status.js +282 -34
  353. package/dist/commands/workflow/step-table.js +308 -0
  354. package/dist/commands/workflow/steps.js +703 -96
  355. package/dist/commands/workflow/summary-findings.js +117 -0
  356. package/dist/commands/workflow/summary.js +388 -0
  357. package/dist/commands/workflow/tasks.js +378 -0
  358. package/dist/commands/workflow/test-blocks.js +231 -0
  359. package/dist/commands/workflow/tests-changed.js +172 -0
  360. package/dist/commands/workflow/tests.js +1695 -305
  361. package/dist/commands/workflow/tracker.js +983 -0
  362. package/dist/commands/workflow/workflows.js +1014 -222
  363. package/dist/commands/workflow/worktrees.js +432 -26
  364. package/dist/install/cloud-env.js +233 -99
  365. package/dist/install/context-ci-workflow.js +85 -0
  366. package/dist/install/manifest.js +64 -17
  367. package/dist/install/modules/antigravity.js +3 -2
  368. package/dist/install/modules/cloud.js +25 -16
  369. package/dist/install/modules/codex.js +12 -2
  370. package/dist/install/modules/core.js +1090 -48
  371. package/dist/install/modules/cursor.js +6 -6
  372. package/dist/install/modules/opencode.js +13 -7
  373. package/dist/install/template-notes.js +116 -0
  374. package/dist/install/version-file.js +9 -4
  375. package/dist/ledgers/compact.js +87 -0
  376. package/dist/ledgers/journal.js +233 -0
  377. package/dist/ledgers/migrate.js +81 -0
  378. package/dist/ledgers/status.js +176 -13
  379. package/dist/ledgers/telemetry.js +1010 -125
  380. package/dist/render/hosts.js +104 -14
  381. package/dist/render/models.js +12 -0
  382. package/dist/shared/bkit-latest.js +26 -4
  383. package/dist/shared/branches.js +3 -1
  384. package/dist/shared/dep-updater.js +49 -0
  385. package/dist/shared/egress.js +8 -1
  386. package/dist/shared/json.js +20 -7
  387. package/dist/shared/package-manager.js +6 -0
  388. package/dist/shared/settings.js +181 -24
  389. package/dist/shared/text.js +333 -0
  390. package/dist/shared/timeouts.js +2 -0
  391. package/dist/tools/cli-doc.js +97 -0
  392. package/dist/tools/grammar-density.js +183 -0
  393. package/dist/tools/instructions-sources.js +720 -0
  394. package/dist/tools/instructions.js +1623 -0
  395. package/package.json +156 -51
  396. package/.bkit/core/.bkit/lite.md +0 -73
  397. package/.bkit/core/engine/commands/harvest.ts +0 -459
  398. package/.bkit/core/engine/commands/workflow/workstreams.ts +0 -166
  399. package/.bkit/core/engine/tools/wording.ts +0 -748
  400. package/.bkit/core/prompts/bkit-build-challenge-reconcile.md +0 -69
  401. package/.bkit/core/prompts/bkit-build-challenge-remediate.md +0 -71
  402. package/.bkit/core/prompts/bkit-build-challenge-tests.md +0 -74
  403. package/.bkit/core/prompts/bkit-build-plan-execute.md +0 -76
  404. package/.bkit/core/prompts/bkit-build-summary.md +0 -94
  405. package/.bkit/core/prompts/bkit-debug-summary.md +0 -96
  406. package/.bkit/core/prompts/bkit-design-summary.md +0 -107
  407. package/.bkit/core/prompts/bkit-plan-complexity-check.md +0 -67
  408. package/.bkit/core/prompts/bkit-plan-complexity-split.md +0 -88
  409. package/.bkit/core/prompts/bkit-plan-review-3.md +0 -93
  410. package/.bkit/core/prompts/bkit-plan-scope-check-1.md +0 -85
  411. package/.bkit/core/prompts/bkit-plan-scope-check-2.md +0 -85
  412. package/.bkit/core/prompts/bkit-plan-summary.md +0 -107
  413. package/.bkit/core/prompts/bkit-ship-summary.md +0 -78
  414. package/.bkit/templates/scripts/ci/bkit-local-stack-lock.sh +0 -194
  415. package/dist/commands/harvest.js +0 -353
  416. package/dist/commands/workflow/workstreams.js +0 -143
  417. package/dist/tools/wording.js +0 -680
  418. /package/.bkit/templates/.vale/styles/{House → Bkit}/Filler.yml +0 -0
  419. /package/.bkit/templates/.vale/styles/{House → Bkit}/Hedging.yml +0 -0
  420. /package/.bkit/templates/.vale/styles/{House → Bkit}/LLMSlop.yml +0 -0
  421. /package/.bkit/templates/.vale/styles/{House → Bkit}/Verbose.yml +0 -0
  422. /package/.bkit/templates/scripts/ci/{accepted-advisories.json → bkit-accepted-advisories.json} +0 -0
  423. /package/.bkit/templates/scripts/ci/{accepted-divergences.json → bkit-accepted-divergences.json} +0 -0
  424. /package/.bkit/templates/scripts/launchd/{launchd.env.example → bkit-launchd.env.example} +0 -0
  425. /package/.bkit/templates/scripts/launchd/{ai.bkit.launchd.plist → bkit-launchd.plist} +0 -0
@@ -1,57 +1,109 @@
1
- // commands/analysis.ts — Analysis CLI for bkit telemetry.
1
+ // commands/analysis.ts — the computations behind `bkit stats` (commands/stats.ts) and the
2
+ // cross-repo section of the harvest report (scripts/harvest/, bkit's checkout only).
2
3
  //
3
4
  // Provides:
4
5
  // 1. Counts/rates/elapsed-time over telemetry rows.
5
- // 2. Size↔outcome regression (logistic approximation: error ~ log(linesAdded)
6
- // + filesChanged) over `kind:"outcome"` rows.
7
- // 3. Dispatch-size threshold computation for plan-complexity-check / plan-split.
8
- // 4. `counterSource` trust labelling: each outcome row is joined to its `counter` row
9
- // (model-self-report pre-P3, shell-bus post-P3).
6
+ // 2. Size↔outcome regression (error rate per `lines.total.added` bucket) over
7
+ // `kind:"outcome"` rows.
8
+ // 3. Dispatch-size threshold computation, printed by `bkit stats` and the harvest report.
9
+ // 4. `counter.source` trust labelling: each outcome row is joined to its `counter` row
10
+ // (model-self-report or shell-bus).
10
11
  // 5. Per-rule compliance rate over `kind:"compliance"` rows.
11
- // 6. Per-`bkitVersion`→CHANGELOG release-attributed regression.
12
+ // 6. Per-`bkit.version` release-attributed regression.
12
13
  //
13
- // Backfill scope (DE-37): GitHub-API backfill limited to the repo where bkit is
14
- // installed; PRs closed >= `--since` date; fields: additions, deletions, changedFiles,
15
- // commits count (for correctiveCommits proxy). Model-self-report counterSource.
14
+ // Rows are read folded, so rows written without `schema` arrive in the current shape.
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.
16
19
  //
17
20
  // All computation is advisory + inform-only; never gates any workflow.
18
21
  // See DE-34 for the shared-entrypoint + crash-isolation contract.
19
- import * as fs from "node:fs";
20
- import * as path from "node:path";
21
- import { UNJUSTIFIED_REASON, foldFrom, } from "../ledgers/telemetry.js";
22
- import { HARVEST_DEST_DIR } from "./harvest.js";
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
+ }
23
32
  export function computeCounts(events) {
24
33
  const byKind = {};
25
34
  const byWorkflow = {};
26
35
  const byRepo = {};
27
36
  for (const ev of events) {
28
- byKind[ev.kind] = (byKind[ev.kind] ?? 0) + 1;
29
- byWorkflow[ev.workflow] = (byWorkflow[ev.workflow] ?? 0) + 1;
37
+ (byKind[ev.kind] ??= { workflow: 0, utility: 0 })[rowSource(ev)]++;
38
+ const workflow = ev.by?.workflow ?? "unknown";
39
+ byWorkflow[workflow] = (byWorkflow[workflow] ?? 0) + 1;
30
40
  byRepo[ev.repo] = (byRepo[ev.repo] ?? 0) + 1;
31
41
  }
32
42
  return { total: events.length, byKind, byWorkflow, byRepo };
33
43
  }
44
+ /** Over the rows that carry `time.totalMinutes`. */
34
45
  export function computeElapsedStats(rows) {
35
- if (rows.length === 0) {
46
+ const durations = rows
47
+ .map((r) => r.time?.totalMinutes)
48
+ .filter((m) => typeof m === "number")
49
+ .sort((a, b) => a - b);
50
+ if (durations.length === 0) {
36
51
  return {
37
52
  count: 0,
38
- totalSeconds: 0,
39
- meanSeconds: 0,
40
- minSeconds: 0,
41
- maxSeconds: 0,
42
- p50Seconds: 0,
53
+ totalMinutes: 0,
54
+ meanMinutes: 0,
55
+ minMinutes: 0,
56
+ maxMinutes: 0,
57
+ p50Minutes: 0,
43
58
  };
44
59
  }
45
- const durations = rows.map((r) => r.durationSeconds).sort((a, b) => a - b);
46
60
  const total = durations.reduce((s, v) => s + v, 0);
47
- const p50 = durations[Math.floor(durations.length / 2)] ?? 0;
48
61
  return {
49
- count: rows.length,
50
- totalSeconds: total,
51
- meanSeconds: total / rows.length,
52
- minSeconds: durations[0] ?? 0,
53
- maxSeconds: durations[durations.length - 1] ?? 0,
54
- p50Seconds: p50,
62
+ count: durations.length,
63
+ totalMinutes: total,
64
+ meanMinutes: total / durations.length,
65
+ minMinutes: durations[0] ?? 0,
66
+ maxMinutes: durations[durations.length - 1] ?? 0,
67
+ p50Minutes: durations[Math.floor(durations.length / 2)] ?? 0,
68
+ };
69
+ }
70
+ /** Over the outcome rows whose `build.challenge.gate` is set. */
71
+ export function computeChallengeGate(rows) {
72
+ const out = { runs: 0, small: 0, large: 0 };
73
+ for (const r of rows) {
74
+ const gate = r.build?.challenge?.gate;
75
+ if (gate === undefined)
76
+ continue;
77
+ out.runs++;
78
+ if (gate.skipped)
79
+ out.small++;
80
+ else
81
+ out.large++;
82
+ }
83
+ return out;
84
+ }
85
+ /** Each agent type's context peak over the outcome rows' `context` blocks, against `cap`. */
86
+ export function computeAgentContext(rows, cap = AGENT_CONTEXT_CAP) {
87
+ const by = {};
88
+ let recorded = 0;
89
+ for (const r of rows) {
90
+ if (r.context === undefined)
91
+ continue;
92
+ recorded++;
93
+ for (const [agent, a] of Object.entries(r.context.byAgent)) {
94
+ const e = (by[agent] ??= { agent, subagents: 0, runs: 0, peak: 0, overCap: 0 });
95
+ e.subagents += a.runs;
96
+ e.runs++;
97
+ e.peak = Math.max(e.peak, a.peak);
98
+ if (a.peak > cap)
99
+ e.overCap++;
100
+ }
101
+ }
102
+ return {
103
+ cap,
104
+ outcomes: rows.length,
105
+ recorded,
106
+ byAgent: Object.values(by).sort((a, b) => b.peak - a.peak || a.agent.localeCompare(b.agent)),
55
107
  };
56
108
  }
57
109
  const SIZE_BUCKETS = [
@@ -64,7 +116,7 @@ const SIZE_BUCKETS = [
64
116
  /**
65
117
  * Per-run NEW failures = this row's cumulative total minus the previous row's.
66
118
  *
67
- * `outcome.failures` is the repo's CUMULATIVE distinct-failure count at ship time.
119
+ * `ledgers.failures.repo` is the repo's CUMULATIVE distinct-failure count at close.
68
120
  *
69
121
  * Previous = the newest outcome row for the SAME repo strictly before this one; the
70
122
  * first row for a repo has no predecessor, so its total IS its delta.
@@ -75,25 +127,22 @@ export function newFailuresThisRun(row, allRows) {
75
127
  const previous = allRows
76
128
  .filter((r) => r.repo === row.repo && r.ts < row.ts)
77
129
  .sort((a, b) => b.ts - a.ts)[0];
130
+ const failures = (r) => r.ledgers?.failures?.repo ?? 0;
78
131
  if (!previous)
79
- return row.failures;
80
- return Math.max(0, row.failures - previous.failures);
81
- }
82
- function isErrorRun(row, allRows) {
83
- return ((row.ciTrySuccess !== undefined && row.ciTrySuccess > 1) ||
84
- (row.correctiveCommits !== undefined && row.correctiveCommits > 0) ||
85
- (row.reviewIterations !== undefined && row.reviewIterations > 1) ||
86
- newFailuresThisRun(row, allRows) > 0);
132
+ return failures(row);
133
+ return Math.max(0, failures(row) - failures(previous));
87
134
  }
135
+ const isErrorRun = (row, allRows) => newFailuresThisRun(row, allRows) > 0;
88
136
  /** Identity of one workflow run: the key the close writes on both its counter and outcome rows. */
89
137
  function runKey(row) {
90
- return row.parentSha ? JSON.stringify([row.repo, row.workflow, row.parentSha]) : undefined;
138
+ const sha = row.run?.parentSha;
139
+ return sha ? JSON.stringify([row.repo, row.by?.workflow, sha]) : undefined;
91
140
  }
92
141
  export function computeRegression(rows, counterRows) {
93
142
  const shellBusRuns = new Set();
94
143
  for (const c of counterRows) {
95
144
  const key = runKey(c);
96
- if (c.counterSource === "shell-bus" && key !== undefined)
145
+ if (c.counter?.source === "shell-bus" && key !== undefined)
97
146
  shellBusRuns.add(key);
98
147
  }
99
148
  const buckets = SIZE_BUCKETS.map((b) => ({
@@ -115,8 +164,8 @@ export function computeRegression(rows, counterRows) {
115
164
  else {
116
165
  modelSelfReportCount++;
117
166
  }
118
- // Bucket by linesAdded
119
- const lines = row.linesAdded;
167
+ // Bucket by lines added
168
+ const lines = row.lines?.total?.added ?? 0;
120
169
  for (const bucket of buckets) {
121
170
  if (lines >= bucket.minLines && lines <= bucket.maxLines) {
122
171
  bucket.count++;
@@ -150,14 +199,15 @@ export function computeRegression(rows, counterRows) {
150
199
  export function computeComplianceRates(rows) {
151
200
  const byRule = {};
152
201
  for (const row of rows) {
153
- if (!byRule[row.rule]) {
154
- byRule[row.rule] = { passCount: 0, failCount: 0, naCount: 0, totalCount: 0 };
202
+ const id = row.rule?.id ?? "unknown";
203
+ if (!byRule[id]) {
204
+ byRule[id] = { passCount: 0, failCount: 0, naCount: 0, totalCount: 0 };
155
205
  }
156
- const r = byRule[row.rule];
206
+ const r = byRule[id];
157
207
  r.totalCount++;
158
- if (row.result === "pass")
208
+ if (row.rule?.verdict === "pass")
159
209
  r.passCount++;
160
- else if (row.result === "fail")
210
+ else if (row.rule?.verdict === "fail")
161
211
  r.failCount++;
162
212
  else
163
213
  r.naCount++;
@@ -171,20 +221,21 @@ export function computeComplianceRates(rows) {
171
221
  export function computeVersionCompliance(rows) {
172
222
  const byVersion = {};
173
223
  for (const row of rows) {
174
- if (!byVersion[row.bkitVersion])
175
- byVersion[row.bkitVersion] = { pass: 0, total: 0 };
176
- const v = byVersion[row.bkitVersion];
224
+ const version = row.bkit?.version ?? "unknown";
225
+ if (!byVersion[version])
226
+ byVersion[version] = { pass: 0, total: 0 };
227
+ const v = byVersion[version];
177
228
  v.total++;
178
- if (row.result === "pass")
229
+ if (row.rule?.verdict === "pass")
179
230
  v.pass++;
180
231
  }
181
232
  return Object.entries(byVersion)
182
- .map(([bkitVersion, { pass, total }]) => ({
183
- bkitVersion,
233
+ .map(([version, { pass, total }]) => ({
234
+ version,
184
235
  passRate: total > 0 ? pass / total : 0,
185
236
  totalRuns: total,
186
237
  }))
187
- .sort((a, b) => a.bkitVersion.localeCompare(b.bkitVersion, undefined, { numeric: true }));
238
+ .sort((a, b) => a.version.localeCompare(b.version, undefined, { numeric: true }));
188
239
  }
189
240
  /**
190
241
  * Unjustified-rate per `(subagent, model)`.
@@ -196,8 +247,8 @@ export function computeVersionCompliance(rows) {
196
247
  export function computeDeferralDiscipline(rows) {
197
248
  const byWriter = {};
198
249
  for (const row of rows) {
199
- const writer = row.subagent ?? (row.workflow ? `${row.workflow} (orchestrator)` : "unattributed");
200
- const model = row.model ?? "unknown";
250
+ const writer = row.by?.subagent ?? (row.by?.workflow ? `${row.by.workflow} (orchestrator)` : "unattributed");
251
+ const model = row.by?.model ?? "unknown";
201
252
  const id = `${writer}\u0000${model}`;
202
253
  if (!byWriter[id])
203
254
  byWriter[id] = { writer, model, total: 0, unjustifiedCount: 0, byReason: {} };
@@ -222,64 +273,91 @@ export function computeDeferralDiscipline(rows) {
222
273
  b.total - a.total ||
223
274
  a.writer.localeCompare(b.writer));
224
275
  }
225
- export function runAnalysis(paths) {
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
+ }
319
+ /** Analyse the folded rows of `paths`, leaving out rows of `skipKinds`. */
320
+ export function runAnalysis(paths, skipKinds = new Set()) {
226
321
  const { state, rowCount, malformedLineCount } = foldFrom(paths);
227
- const events = [...state.values()];
228
- const outcomeRows = [];
229
- const counterRows = [];
230
- const complianceRows = [];
322
+ const events = [...state.values()].filter((ev) => !skipKinds.has(ev.kind));
323
+ const grouped = () => ({
324
+ outcome: [],
325
+ counter: [],
326
+ compliance: [],
327
+ });
328
+ const bySource = {
329
+ workflow: grouped(),
330
+ utility: grouped(),
331
+ };
231
332
  const deferralRows = [];
232
333
  for (const ev of events) {
334
+ const g = bySource[rowSource(ev)];
233
335
  if (ev.kind === "outcome") {
234
- outcomeRows.push(ev);
336
+ g.outcome.push(ev);
235
337
  }
236
338
  else if (ev.kind === "counter") {
237
- counterRows.push(ev);
339
+ g.counter.push(ev);
238
340
  }
239
341
  else if (ev.kind === "compliance") {
240
- complianceRows.push(ev);
342
+ g.compliance.push(ev);
241
343
  }
242
344
  else if (ev.kind === "deferral") {
243
345
  deferralRows.push(ev);
244
346
  }
245
347
  }
246
348
  const counts = computeCounts(events);
247
- const elapsed = computeElapsedStats(outcomeRows);
248
- const regression = computeRegression(outcomeRows, counterRows);
249
- const complianceRates = computeComplianceRates(complianceRows);
250
- 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
+ };
251
353
  const deferralDiscipline = computeDeferralDiscipline(deferralRows);
252
354
  const reportLines = [
253
355
  `[bkit-analysis] Telemetry rows: ${rowCount} | malformed: ${malformedLineCount}`,
254
356
  `[bkit-analysis] Kinds: ${JSON.stringify(counts.byKind)}`,
255
357
  `[bkit-analysis] Workflows: ${JSON.stringify(counts.byWorkflow)}`,
256
- `[bkit-analysis] Run outcomes: ${outcomeRows.length} | Compliance rows: ${complianceRows.length}`,
358
+ ...runFigureLines("workflow", runs.workflow),
359
+ ...runFigureLines(UTILITY_WORKFLOW, runs.utility),
257
360
  ];
258
- if (elapsed.count > 0) {
259
- reportLines.push(`[bkit-analysis] Duration (s): mean=${elapsed.meanSeconds.toFixed(0)} | p50=${elapsed.p50Seconds.toFixed(0)} | min=${elapsed.minSeconds} | max=${elapsed.maxSeconds}`);
260
- }
261
- // Regression report
262
- reportLines.push(`[bkit-analysis] #183 Size↔outcome regression (dispatch-size threshold: ${regression.dispatchSizeThreshold} linesAdded):`);
263
- for (const b of regression.buckets) {
264
- if (b.count > 0) {
265
- reportLines.push(` ${b.label}: ${b.count} runs, ${b.errorCount} errors (${(b.errorRate * 100).toFixed(1)}%)`);
266
- }
267
- }
268
- reportLines.push(`[bkit-analysis] counterSource trust: shell-bus=${regression.shellBusCount} (trusted) | model-self-report=${regression.modelSelfReportCount} (untrusted, pre-P3)`);
269
- // Compliance rates
270
- if (complianceRates.length > 0) {
271
- reportLines.push(`[bkit-analysis] Per-rule compliance rates:`);
272
- for (const r of complianceRates) {
273
- reportLines.push(` ${r.rule}: ${(r.passRate * 100).toFixed(1)}% pass (${r.passCount}/${r.totalCount})`);
274
- }
275
- }
276
- // Version compliance
277
- if (versionCompliance.length > 0) {
278
- reportLines.push(`[bkit-analysis] Per-bkitVersion compliance:`);
279
- for (const v of versionCompliance) {
280
- reportLines.push(` v${v.bkitVersion}: ${(v.passRate * 100).toFixed(1)}% pass (${v.totalRuns} runs)`);
281
- }
282
- }
283
361
  // Deferral discipline — who defers work they should have finished.
284
362
  if (deferralDiscipline.length > 0) {
285
363
  const totals = deferralDiscipline.reduce((acc, d) => ({ total: acc.total + d.total, unjust: acc.unjust + d.unjustifiedCount }), { total: 0, unjust: 0 });
@@ -292,50 +370,5 @@ export function runAnalysis(paths) {
292
370
  reportLines.push(` ${d.writer} [${d.model}]: ${d.unjustifiedCount}/${d.total} unjustified (${(d.unjustifiedRate * 100).toFixed(1)}%) | ${reasons}`);
293
371
  }
294
372
  }
295
- return {
296
- counts,
297
- elapsed,
298
- regression,
299
- complianceRates,
300
- versionCompliance,
301
- deferralDiscipline,
302
- reportLines,
303
- };
304
- }
305
- // analysis — cross-repo analysis CLI.
306
- // Reports counts/rates/elapsed-time, size↔outcome regression, per-rule compliance
307
- // rate, dispatch-size threshold, counterSource trust labelling. Advisory + inform-only.
308
- // See DE-34 for the shared-entrypoint + crash-isolation contract.
309
- export function runAnalysisCommand() {
310
- try {
311
- const cwd = process.cwd();
312
- // Analyse: bkit's own stats.jsonl + harvested consumer rows.
313
- // Harvest dest is sourced from the constant, NOT re-spelled here.
314
- const statsPath = path.join(cwd, ".bkit", "stats.jsonl");
315
- const harvestStatsPath = path.join(cwd, HARVEST_DEST_DIR, "stats.jsonl");
316
- const harvestFrictionPath = path.join(cwd, HARVEST_DEST_DIR, "friction.jsonl");
317
- const frictionPath = path.join(cwd, ".bkit", "friction.jsonl");
318
- // deferrals is LOCAL-only: harvest takes it count-only (prose never leaves the
319
- // consumer), so the discipline rate is this repo's own writers, not a fleet view.
320
- const deferralsPath = path.join(cwd, "docs", "deferrals.jsonl");
321
- const paths = [
322
- statsPath,
323
- harvestStatsPath,
324
- harvestFrictionPath,
325
- frictionPath,
326
- deferralsPath,
327
- ].filter((p) => fs.existsSync(p));
328
- if (paths.length === 0) {
329
- console.log("[bkit-analysis] No telemetry files found. Run `bkit harvest` first, or accumulate telemetry via bkit workflows.");
330
- return;
331
- }
332
- const report = runAnalysis(paths);
333
- for (const line of report.reportLines) {
334
- console.log(line);
335
- }
336
- }
337
- catch (err) {
338
- const msg = err instanceof Error ? err.message : String(err);
339
- console.error(`[bkit-analysis] analysis error (fail-open): ${msg}`);
340
- }
373
+ return { counts, runs, deferralDiscipline, reportLines };
341
374
  }