@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
@@ -0,0 +1,492 @@
1
+ // The measured blocks of a workflow run's `outcome` row (`.bkit/core/.bkit/jsonl.md`
2
+ // § Shared blocks): lines, steps, ci, plan and build, from git, the run's
3
+ // `status.jsonl` rows and its log folder. bkit's unshipped harvest script
4
+ // (`scripts/harvest/bkit-harvest.mjs`) computes the same blocks for its `run` rows, with the same rules.
5
+
6
+ import { createHash } from "node:crypto";
7
+ import * as fs from "node:fs";
8
+ import * as path from "node:path";
9
+
10
+ import type { StatusEvent } from "../../ledgers/status.js";
11
+ import {
12
+ foldFrom,
13
+ type BuildBlock,
14
+ CiDispatch,
15
+ type ContextBlock,
16
+ LineCounts,
17
+ LinesBlock,
18
+ PlanBlock,
19
+ PlanTask,
20
+ StepsBlock,
21
+ type TelemetryEvent,
22
+ type TimeBlock,
23
+ } from "../../ledgers/telemetry.js";
24
+ import { parseJson, readDirNames, readJsonFile, readTextFile } from "../../shared/json.js";
25
+ import { git } from "../lib.js";
26
+ import { appendLedgerRows } from "./ledgers.js";
27
+ import { readStatusEvents } from "./status.js";
28
+ import { parsePlanBlocks } from "./plan-blocks.js";
29
+ import { readTestFirst } from "./tests.js";
30
+
31
+ type Row = StatusEvent & Record<string, unknown>;
32
+
33
+ const msOf = (iso: unknown) => (typeof iso === "string" ? Date.parse(iso) : NaN);
34
+ /** Minutes to one decimal. */
35
+ export const minutesOf = (ms: number) => Math.round(ms / 6000) / 10;
36
+
37
+ /** `start` to `end`, unix ms. */
38
+ export function timeBlock(start: number, end: number): TimeBlock {
39
+ return { start, end, totalMinutes: minutesOf(end - start) };
40
+ }
41
+
42
+ /** Left out of a run's line counts: plans and run logs, and the ledgers. */
43
+ const LINES_EXCLUDE = [
44
+ ":(exclude)docs/plans/**",
45
+ ":(exclude,glob)docs/*.jsonl",
46
+ ":(exclude,glob).bkit/*.jsonl",
47
+ ];
48
+ const TEST_PATH =
49
+ /(^|\/)(__tests__|tests?|spec|e2e)\/|[._-](test|spec)\.[^/]+$|_test\.[^/]+$|(^|\/)test_[^/]+\.py$/i;
50
+ const DOCS_PATH = /\.mdx?$|(^|\/)docs\//i;
51
+
52
+ /** `code`, `tests` or `docs`, from a changed file's path. */
53
+ export const lineClass = (file: string): "code" | "tests" | "docs" =>
54
+ TEST_PATH.test(file) ? "tests" : DOCS_PATH.test(file) ? "docs" : "code";
55
+
56
+ /**
57
+ * Lines changed from `first` to `last`, cut at each merge on the first-parent
58
+ * chain (a dev sync) so merged-in work is not counted, each stretch diffed on its
59
+ * own. Null when git lacks either commit or `first` is not an ancestor of `last`.
60
+ */
61
+ export function runLines(cwd: string, first: string, last: string): LinesBlock | null {
62
+ if (!first || !last) return null;
63
+ if (git(cwd, ["merge-base", "--is-ancestor", first, last]) === null) return null;
64
+ const chain = git(cwd, [
65
+ "rev-list",
66
+ "--first-parent",
67
+ "--reverse",
68
+ "--parents",
69
+ `${first}..${last}`,
70
+ ]);
71
+ if (chain === null) return null;
72
+ const stretches: Array<[string, string]> = [];
73
+ let from = first;
74
+ for (const line of chain.split("\n").filter(Boolean)) {
75
+ const [sha, parent, ...merged] = line.split(" ");
76
+ if (merged.length === 0) continue;
77
+ stretches.push([from, parent!]);
78
+ from = sha!;
79
+ }
80
+ stretches.push([from, last]);
81
+ const blank = (): LineCounts => ({ added: 0, deleted: 0, files: 0 });
82
+ const parts = { code: blank(), tests: blank(), docs: blank() };
83
+ for (const [a, b] of stretches) {
84
+ if (a === b) continue;
85
+ const stat = git(cwd, ["diff", "--numstat", a, b, "--", ".", ...LINES_EXCLUDE]);
86
+ if (stat === null) return null;
87
+ for (const line of stat.split("\n").filter(Boolean)) {
88
+ const [added, deleted, file] = line.split("\t");
89
+ const c = parts[lineClass(file ?? "")];
90
+ c.files++;
91
+ // Binary files: `-` for both counts.
92
+ if (added !== "-") {
93
+ c.added += Number(added);
94
+ c.deleted += Number(deleted);
95
+ }
96
+ }
97
+ }
98
+ const sum = (k: keyof LineCounts) => parts.code[k] + parts.tests[k] + parts.docs[k];
99
+ const added = sum("added");
100
+ const deleted = sum("deleted");
101
+ return {
102
+ total: { added, deleted, changed: added + deleted, files: sum("files") },
103
+ ...parts,
104
+ merges: stretches.length - 1,
105
+ };
106
+ }
107
+
108
+ /** The run's status rows of `workflow` from its start row on, in `at` order. */
109
+ export function runStatusRows(events: StatusEvent[], workflow: string, startAt: string): Row[] {
110
+ return (events as Row[])
111
+ .filter((e) => e.workflow === workflow && typeof e.at === "string" && e.at >= startAt)
112
+ .sort((a, b) => msOf(a.at) - msOf(b.at));
113
+ }
114
+
115
+ /** Per step: its step-done rows and the minutes since the row before each, `MARK_ROWS` skipped. */
116
+ export function stepsBlock(all: Row[]): StepsBlock {
117
+ const rows = all.filter((r) => !MARK_ROWS.has(r.type));
118
+ const ms: Record<string, { n: number; ms: number }> = {};
119
+ for (let i = 1; i < rows.length; i++) {
120
+ const r = rows[i]!;
121
+ if (r.type !== "step-done" || typeof r.step !== "string") continue;
122
+ const s = (ms[r.step] ??= { n: 0, ms: 0 });
123
+ s.n++;
124
+ s.ms += Math.max(0, msOf(r.at) - msOf(rows[i - 1]!.at));
125
+ }
126
+ const byStep = Object.fromEntries(
127
+ Object.entries(ms).map(([k, v]) => [k, { n: v.n, totalMinutes: minutesOf(v.ms) }]),
128
+ );
129
+ const parts = Object.values(byStep);
130
+ return {
131
+ total: {
132
+ n: parts.reduce((a, p) => a + p.n, 0),
133
+ totalMinutes: Math.round(parts.reduce((a, p) => a + p.totalMinutes, 0) * 10) / 10,
134
+ },
135
+ byStep,
136
+ };
137
+ }
138
+
139
+ /** Every close step's CI dispatch, in order. */
140
+ export function ciList(rows: Row[]): CiDispatch[] {
141
+ return rows
142
+ .filter((r) => r.type === "step-done" && /-close-workflow$/.test(String(r.step ?? "")))
143
+ .map((r) => r.ciDispatch as Record<string, unknown> | undefined)
144
+ .filter((d) => d !== undefined && d !== null)
145
+ .map((d) => ciEntry(d!));
146
+ }
147
+
148
+ /** One `ciDispatch` value as a `ci` entry. */
149
+ export function ciEntry(d: Record<string, unknown>): CiDispatch {
150
+ return {
151
+ status: typeof d.outcome === "string" ? d.outcome : null,
152
+ reason: typeof d.reason === "string" ? d.reason : null,
153
+ attempts: typeof d.attempts === "number" ? d.attempts : null,
154
+ };
155
+ }
156
+
157
+ const kbOf = (file: string) => Math.round(fs.statSync(file).size / 1024);
158
+
159
+ /**
160
+ * Per task group, per task: its TEST FIRST tests and distinct test files; null when the
161
+ * task has no such field.
162
+ */
163
+ export function planTasks(text: string): PlanTask[][] {
164
+ return parsePlanBlocks(text).groups.map((g) =>
165
+ readTestFirst(text, g.group).map((s) =>
166
+ s.kind === "test"
167
+ ? { tests: s.tests.length, testFiles: new Set(s.tests.map((t) => t.test)).size }
168
+ : s.kind === "missing"
169
+ ? { tests: null, testFiles: null }
170
+ : { tests: 0, testFiles: 0 },
171
+ ),
172
+ );
173
+ }
174
+
175
+ /** The plan file the run worked from, absolute: `[{FID}-plan.md]`, [] when it does not exist. */
176
+ export function planFiles(tree: string, month: string, fid: string): string[] {
177
+ const file = path.join(tree, "docs", "plans", month, `${fid}-plan.md`);
178
+ return fs.existsSync(file) ? [file] : [];
179
+ }
180
+
181
+ /**
182
+ * The plan the run worked from: `{FID}-plan.md`, its tasks per group. `source` is
183
+ * `converted` when the FID's status rows hold a `build-plan-convert` step row, else
184
+ * `file`. Undefined when no plan file exists.
185
+ */
186
+ export function planBlock(
187
+ tree: string,
188
+ month: string,
189
+ fid: string,
190
+ events: StatusEvent[],
191
+ ): PlanBlock | undefined {
192
+ const [file] = planFiles(tree, month, fid);
193
+ if (file === undefined) return undefined;
194
+ const groups = planTasks(fs.readFileSync(file, "utf-8")).map((tasks) => ({ tasks }));
195
+ const converted = events.some(
196
+ (e) => e.type === "step-done" && e.workflow === "build" && e.step === "build-plan-convert",
197
+ );
198
+ return {
199
+ source: converted ? "converted" : "file",
200
+ total: { tasks: groups.reduce((a, g) => a + g.tasks.length, 0), kb: kbOf(file) },
201
+ groups,
202
+ };
203
+ }
204
+
205
+ /** A task `bkit challenge merge` appended: its severity field. Planned tasks carry none. */
206
+ const APPENDED_SEVERITY = /\*\*Severity:\*\*\s*(CRITICAL|HIGH|MEDIUM|LOW)\b/;
207
+
208
+ const field = (r: Row, k: string) => (r[k] === undefined ? null : r[k]);
209
+ const num = (v: unknown) => (typeof v === "number" ? v : null);
210
+ const str = (v: unknown) => (typeof v === "string" ? v : null);
211
+
212
+ /**
213
+ * Build-only facts from the run's step rows and its log folder: every verify and
214
+ * gaps-remediate round, the holistic verify, the challenge and the groups' red runs.
215
+ * Challenge findings are counted once a `build-challenge` row
216
+ * exists: CRITICAL / HIGH / MEDIUM from the tasks `challenge merge` appended to
217
+ * `plans`, LOW from its `build-challenge` rows among `deferrals` (the run's rows). The
218
+ * challenge block carries the latest `challenge-gate` row's size as `gate`, when one exists.
219
+ */
220
+ export function buildBlock(
221
+ rows: Row[],
222
+ plans: string[],
223
+ deferrals: Array<Record<string, unknown>>,
224
+ ): BuildBlock {
225
+ const steps = rows.filter((r) => r.type === "step-done");
226
+ const verify = steps
227
+ .filter((r) => r.step === "build-plan-verify")
228
+ .map((r) => ({
229
+ group: field(r, "group"),
230
+ attempt: field(r, "attempt"),
231
+ verdict: field(r, "verdict"),
232
+ failures: field(r, "failures"),
233
+ }));
234
+ const gapsRemediate = steps
235
+ .filter((r) => r.step === "build-plan-gaps-remediate")
236
+ .map((r) => ({
237
+ group: field(r, "group"),
238
+ attempt: field(r, "attempt"),
239
+ verdict: field(r, "verdict"),
240
+ strategy: field(r, "strategy"),
241
+ }));
242
+ const lastOf = (step: string) => steps.filter((r) => r.step === step).at(-1);
243
+ const hol = lastOf("build-plan-verify-holistic");
244
+ const ch = lastOf("build-challenge");
245
+ // `challenge-gate` rows are not fold events: read them as plain status rows.
246
+ const gate = (rows as Array<Record<string, unknown>>)
247
+ .filter((r) => r.type === "challenge-gate")
248
+ .at(-1);
249
+ let findings: NonNullable<NonNullable<BuildBlock["challenge"]>["findings"]> | null = null;
250
+ if (ch !== undefined) {
251
+ const f = { CRITICAL: 0, HIGH: 0, MEDIUM: 0, LOW: 0 };
252
+ for (const file of plans.filter((p) => fs.existsSync(p)))
253
+ for (const t of parsePlanBlocks(fs.readFileSync(file, "utf-8")).tasks) {
254
+ const sev = APPENDED_SEVERITY.exec(t.text)?.[1] as keyof typeof f | undefined;
255
+ if (sev !== undefined && sev !== "LOW") f[sev]++;
256
+ }
257
+ f.LOW = new Set(
258
+ deferrals
259
+ .filter(
260
+ (r) =>
261
+ r.kind === "deferral" &&
262
+ r.severity === "LOW" &&
263
+ (r.by as Record<string, unknown> | undefined)?.step === "build-challenge",
264
+ )
265
+ .map((r) => String(r.key)),
266
+ ).size;
267
+ findings = { total: f.CRITICAL + f.HIGH + f.MEDIUM + f.LOW, ...f };
268
+ }
269
+ return {
270
+ verify,
271
+ gapsRemediate,
272
+ holistic: hol ? { verdict: str(hol.verdict), failures: num(hol.failures) } : null,
273
+ challenge: ch
274
+ ? {
275
+ verdict: str(ch.verdict),
276
+ findings,
277
+ ...(gate === undefined
278
+ ? {}
279
+ : {
280
+ gate: {
281
+ size: str(gate.size),
282
+ linesChanged: num(gate.linesChanged),
283
+ filesChanged: num(gate.filesChanged),
284
+ skipped: gate.skipped === true,
285
+ },
286
+ }),
287
+ }
288
+ : null,
289
+ redTests: steps.filter((r) => r.step === "build-tests-red").length,
290
+ };
291
+ }
292
+
293
+ /** Where Claude Code keeps the transcripts of the chats that ran a workflow. */
294
+ export interface ClaudeTranscripts {
295
+ /** The running chat's id; undefined outside Claude Code. */
296
+ sessionId: string | undefined;
297
+ /** Claude Code's config dir: `CLAUDE_CONFIG_DIR`, else `~/.claude`. */
298
+ claudeDir: string;
299
+ }
300
+
301
+ /**
302
+ * Claude Code sets `CLAUDE_CODE_SESSION_ID` in the environment of every shell command its
303
+ * session runs, so `bkit workflows close` (run by the workflow's own session) knows whose
304
+ * transcripts hold the run's subagents.
305
+ */
306
+ export function claudeTranscripts(env: NodeJS.ProcessEnv, home: string): ClaudeTranscripts {
307
+ return {
308
+ sessionId: env.CLAUDE_CODE_SESSION_ID,
309
+ claudeDir: env.CLAUDE_CONFIG_DIR || path.join(home, ".claude"),
310
+ };
311
+ }
312
+
313
+ const SESSION_ID = /^[0-9A-Za-z][0-9A-Za-z_-]*$/;
314
+
315
+ /**
316
+ * The chat a host runs this command in, or undefined when the host names none. Claude Code
317
+ * only: it sets `CLAUDE_CODE_SESSION_ID`; nothing in this repo confirms a variable naming the
318
+ * chat on Codex, opencode, Cursor or Antigravity.
319
+ */
320
+ export function hostChat(
321
+ env: NodeJS.ProcessEnv,
322
+ ): { platform: "claude-code"; id: string } | undefined {
323
+ const id = env.CLAUDE_CODE_SESSION_ID;
324
+ return id !== undefined && SESSION_ID.test(id) ? { platform: "claude-code", id } : undefined;
325
+ }
326
+
327
+ /**
328
+ * A chat's fingerprint on `session` status rows: `fp:` + the first 12 hex of
329
+ * sha256(`<platform>:<chat id>`), the same as the harvest's fingerprint of its `chat` row key.
330
+ */
331
+ export const chatFingerprint = (platform: string, id: string) =>
332
+ `fp:${createHash("sha256").update(`${platform}:${id}`).digest("hex").slice(0, 12)}`;
333
+
334
+ /**
335
+ * Status rows that mark a moment rather than the end of a piece of work: step minutes skip
336
+ * them. A `test-run` row lands just before its step's own row, so the run counts toward it.
337
+ */
338
+ export const MARK_ROWS: ReadonlySet<string> = new Set([
339
+ "session",
340
+ "owner-pause",
341
+ "owner-answer",
342
+ "test-run",
343
+ "engine-call",
344
+ "completeness",
345
+ ]);
346
+
347
+ /** The `session` fingerprints on the run's status rows, in row order, each once. */
348
+ export function runChats(rows: Row[]): string[] {
349
+ const out: string[] = [];
350
+ for (const r of rows as Array<Record<string, unknown>>)
351
+ if (r.type === "session" && typeof r.session === "string" && !out.includes(r.session))
352
+ out.push(r.session);
353
+ return out;
354
+ }
355
+
356
+ /** One Claude Code subagent transcript's model calls: `[ms, context]` each, or null when unreadable. */
357
+ function subagentCalls(file: string): Array<[number, number]> | null {
358
+ const read = readTextFile(file);
359
+ if (!read.ok) return null;
360
+ const calls: Array<[number, number]> = [];
361
+ for (const line of read.text.split("\n")) {
362
+ const parsed = line.trim() === "" ? null : parseJson(line);
363
+ if (parsed === null || !parsed.ok) continue;
364
+ const d = parsed.value as Record<string, unknown> | null;
365
+ if (d === null || typeof d !== "object") continue;
366
+ const m = d.message as Record<string, unknown> | undefined;
367
+ // `<synthetic>`: a message Claude Code wrote itself (an API error notice), not a model call.
368
+ if (d.type !== "assistant" || typeof m !== "object" || m === null) continue;
369
+ if (m.model === "<synthetic>") continue;
370
+ const at = msOf(d.timestamp);
371
+ if (!Number.isFinite(at)) continue;
372
+ const u = (m.usage ?? {}) as Record<string, unknown>;
373
+ const n = (k: string) => (typeof u[k] === "number" ? (u[k] as number) : 0);
374
+ calls.push([
375
+ at,
376
+ n("input_tokens") + n("cache_creation_input_tokens") + n("cache_read_input_tokens"),
377
+ ]);
378
+ }
379
+ return calls;
380
+ }
381
+
382
+ /**
383
+ * The run's subagents' context peaks per agent type, from every Claude Code chat that ran
384
+ * it: the chat running the close, and each chat whose fingerprint `chats` holds (the run's
385
+ * `session` rows). Transcripts: `<claudeDir>/projects/<project>/<session>/subagents/agent-*.jsonl`,
386
+ * each with its `agent-*.meta.json` naming the agent type (`unknown` without one). Each model
387
+ * call goes by its own timestamp: a subagent counts in `runs` when one of its calls falls in
388
+ * [startMs, endMs], and `peak` is the largest of those calls. Context of one model call =
389
+ * input + cache write + cache read tokens, the same sum the harvest's `contextPeak` takes.
390
+ * Undefined when no chat is known, no transcript is found or no subagent called the model
391
+ * in the run. Never throws: a folder or transcript that cannot be read counts as absent.
392
+ *
393
+ * Claude Code only. The other hosts bkit renders for record nothing here:
394
+ * - Cursor keeps no token counts in its local chats (the harvest reads them and finds none).
395
+ * - Codex (`~/.codex/sessions/.../rollout-*.jsonl`, `token_count` events) and opencode
396
+ * (`~/.local/share/opencode/opencode.db`) keep token counts, but nothing in this repo
397
+ * confirms an environment variable naming the running session, so a close cannot tell its
398
+ * own run's transcripts from another chat's.
399
+ * - Antigravity keeps protobuf in SQLite whose token fields nothing in this repo documents.
400
+ */
401
+ export function agentContextBlock(
402
+ startMs: number,
403
+ endMs: number,
404
+ src: ClaudeTranscripts,
405
+ chats: readonly string[] = [],
406
+ ): ContextBlock | undefined {
407
+ const sid = src.sessionId !== undefined && SESSION_ID.test(src.sessionId) ? src.sessionId : null;
408
+ const wanted = new Set(chats);
409
+ if (sid === null && wanted.size === 0) return undefined;
410
+ const projects = path.join(src.claudeDir, "projects");
411
+ const top = readDirNames(projects);
412
+ if (!top.ok) return undefined;
413
+ const files: string[] = [];
414
+ for (const p of top.names.sort()) {
415
+ const names = readDirNames(path.join(projects, p));
416
+ for (const name of names.ok ? names.names.sort() : []) {
417
+ if (!SESSION_ID.test(name)) continue;
418
+ if (name !== sid && !wanted.has(chatFingerprint("claude-code", name))) continue;
419
+ const dir = path.join(projects, p, name, "subagents");
420
+ const subs = readDirNames(dir);
421
+ for (const f of subs.ok ? subs.names.sort() : [])
422
+ if (f.endsWith(".jsonl")) files.push(path.join(dir, f));
423
+ }
424
+ }
425
+ const byAgent: ContextBlock["byAgent"] = {};
426
+ for (const file of files) {
427
+ const inRun = (subagentCalls(file) ?? []).filter(([at]) => at >= startMs && at <= endMs);
428
+ if (inRun.length === 0) continue;
429
+ const meta = readJsonFile(file.slice(0, -".jsonl".length) + ".meta.json");
430
+ const type = meta.ok ? (meta.value as Record<string, unknown> | null)?.agentType : undefined;
431
+ const a = (byAgent[typeof type === "string" && type !== "" ? type : "unknown"] ??= {
432
+ peak: 0,
433
+ runs: 0,
434
+ });
435
+ a.runs++;
436
+ a.peak = Math.max(a.peak, ...inRun.map(([, c]) => c));
437
+ }
438
+ return Object.keys(byAgent).length === 0 ? undefined : { host: "claude-code", byAgent };
439
+ }
440
+
441
+ /**
442
+ * After the close's CI dispatch: append the run's `outcome` row again with the
443
+ * dispatch added to `ci`, and `ending` `close-failed` when CI never started
444
+ * (`unresolved`). The run is the last `workflow-done` row of `workflow` in
445
+ * `status`; its `parentSha` names the outcome row. The newer row supersedes the
446
+ * close's under fold. Best-effort: a missing row or a refused append is logged.
447
+ */
448
+ export function restateOutcome(
449
+ tree: string,
450
+ status: string,
451
+ workflow: string,
452
+ dispatch: Record<string, unknown>,
453
+ log: (m: string) => void,
454
+ ): boolean {
455
+ const done = readStatusEvents(status)
456
+ .filter((e) => e.type === "workflow-done" && e.workflow === workflow)
457
+ .sort((a, b) => (a.at < b.at ? -1 : a.at > b.at ? 1 : 0))
458
+ .at(-1) as Record<string, unknown> | undefined;
459
+ const sha = done?.parentSha;
460
+ if (typeof sha !== "string") {
461
+ log(`[bkit-telemetry] no ${workflow} workflow-done row with parentSha — outcome not restated`);
462
+ return false;
463
+ }
464
+ const stats = path.join(tree, ".bkit", "stats.jsonl");
465
+ const outcome = fs.existsSync(stats)
466
+ ? [...foldFrom([stats]).state.values()]
467
+ .filter(
468
+ (e): e is Extract<TelemetryEvent, { kind: "outcome" }> =>
469
+ e.kind === "outcome" && e.by?.workflow === workflow && e.run?.parentSha === sha,
470
+ )
471
+ .at(-1)
472
+ : undefined;
473
+ if (outcome === undefined) {
474
+ log(
475
+ `[bkit-telemetry] no ${workflow} outcome row for ${sha.slice(0, 12)} — outcome not restated`,
476
+ );
477
+ return false;
478
+ }
479
+ const { schema: _s, ts: _t, bkit: _b, ...draft } = outcome;
480
+ const entry = ciEntry(dispatch);
481
+ const ci = [...(draft.ci ?? []), entry];
482
+ try {
483
+ appendLedgerRows(tree, "stats", [
484
+ { ...draft, ending: entry.status === "unresolved" ? "close-failed" : "done", ci },
485
+ ]);
486
+ return true;
487
+ } catch (err) {
488
+ // Telemetry never gates a dispatch: report the refused append and carry on.
489
+ log(`[bkit-telemetry] outcome not restated: ${(err as Error).message}`);
490
+ return false;
491
+ }
492
+ }