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