@cbartens/bkit 5.5.1 → 6.0.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 (288) hide show
  1. package/.bkit/README.md +30 -20
  2. package/.bkit/core/.agents/docs.md +1 -0
  3. package/.bkit/core/.agents/rules.md +35 -26
  4. package/.bkit/core/.bkit/README.md +29 -19
  5. package/.bkit/core/.bkit/authoring.md +117 -0
  6. package/.bkit/core/.bkit/cloud.md +11 -11
  7. package/.bkit/core/.bkit/comparison.md +5 -5
  8. package/.bkit/core/.bkit/install.md +19 -18
  9. package/.bkit/core/.bkit/jsonl.md +202 -122
  10. package/.bkit/core/.bkit/lite.md +1 -1
  11. package/.bkit/core/.bkit/pipeline.md +49 -52
  12. package/.bkit/core/.bkit/prompts.md +91 -167
  13. package/.bkit/core/.bkit/providers.md +29 -32
  14. package/.bkit/core/.bkit/templates.md +12 -11
  15. package/.bkit/core/.bkit/trackers.md +51 -28
  16. package/.bkit/core/.bkit/workflows.md +394 -355
  17. package/.bkit/core/AGENTS.md +16 -22
  18. package/.bkit/core/docs/templates/bkit-audit-accessibility.md +14 -38
  19. package/.bkit/core/docs/templates/bkit-audit-adoption.md +16 -40
  20. package/.bkit/core/docs/templates/bkit-audit-agents.md +19 -43
  21. package/.bkit/core/docs/templates/bkit-audit-aio-seo.md +16 -40
  22. package/.bkit/core/docs/templates/bkit-audit-analytics.md +14 -38
  23. package/.bkit/core/docs/templates/bkit-audit-annotations.md +11 -35
  24. package/.bkit/core/docs/templates/bkit-audit-app-performance.md +15 -39
  25. package/.bkit/core/docs/templates/bkit-audit-app-store.md +12 -36
  26. package/.bkit/core/docs/templates/bkit-audit-architecture.md +16 -40
  27. package/.bkit/core/docs/templates/bkit-audit-ci-performance.md +16 -40
  28. package/.bkit/core/docs/templates/bkit-audit-config.md +18 -42
  29. package/.bkit/core/docs/templates/bkit-audit-cost.md +16 -40
  30. package/.bkit/core/docs/templates/bkit-audit-coverage.md +15 -39
  31. package/.bkit/core/docs/templates/bkit-audit-database.md +16 -40
  32. package/.bkit/core/docs/templates/bkit-audit-dead-code.md +15 -39
  33. package/.bkit/core/docs/templates/bkit-audit-deferrals.md +15 -38
  34. package/.bkit/core/docs/templates/bkit-audit-dependencies.md +16 -40
  35. package/.bkit/core/docs/templates/bkit-audit-documentation.md +11 -35
  36. package/.bkit/core/docs/templates/bkit-audit-duplication.md +18 -42
  37. package/.bkit/core/docs/templates/bkit-audit-failures.md +13 -37
  38. package/.bkit/core/docs/templates/bkit-audit-flakes.md +12 -36
  39. package/.bkit/core/docs/templates/bkit-audit-gates.md +14 -38
  40. package/.bkit/core/docs/templates/bkit-audit-issues.md +15 -39
  41. package/.bkit/core/docs/templates/bkit-audit-llm.md +16 -40
  42. package/.bkit/core/docs/templates/bkit-audit-logs.md +14 -38
  43. package/.bkit/core/docs/templates/bkit-audit-models.md +12 -36
  44. package/.bkit/core/docs/templates/bkit-audit-privacy.md +12 -36
  45. package/.bkit/core/docs/templates/bkit-audit-prompts.md +15 -39
  46. package/.bkit/core/docs/templates/bkit-audit-red-team.md +15 -39
  47. package/.bkit/core/docs/templates/bkit-audit-reliability.md +15 -39
  48. package/.bkit/core/docs/templates/bkit-audit-repo.md +12 -36
  49. package/.bkit/core/docs/templates/bkit-audit-security.md +13 -37
  50. package/.bkit/core/docs/templates/bkit-audit-slop.md +14 -38
  51. package/.bkit/core/docs/templates/bkit-audit-testing.md +12 -36
  52. package/.bkit/core/docs/templates/bkit-audit-usability.md +16 -40
  53. package/.bkit/core/docs/templates/bkit-plan.md +97 -226
  54. package/.bkit/core/engine/checks/after/ci-yml.ts +39 -29
  55. package/.bkit/core/engine/checks/after/github.ts +95 -17
  56. package/.bkit/core/engine/checks/after/index.ts +10 -7
  57. package/.bkit/core/engine/checks/after/suppression.ts +8 -5
  58. package/.bkit/core/engine/checks/after/tools.ts +46 -91
  59. package/.bkit/core/engine/checks/before/env.ts +2 -2
  60. package/.bkit/core/engine/checks/before/files.ts +5 -4
  61. package/.bkit/core/engine/checks/before/index.ts +18 -1
  62. package/.bkit/core/engine/checks/before/repo.ts +168 -2
  63. package/.bkit/core/engine/checks/tips/catalogue.ts +16 -5
  64. package/.bkit/core/engine/checks/tips/detect.ts +34 -0
  65. package/.bkit/core/engine/checks/tips/index.ts +6 -6
  66. package/.bkit/core/engine/cli.ts +20 -53
  67. package/.bkit/core/engine/commands/analysis.ts +171 -140
  68. package/.bkit/core/engine/commands/ci/ci.ts +6 -6
  69. package/.bkit/core/engine/commands/comply.ts +77 -103
  70. package/.bkit/core/engine/commands/install/doctor.ts +2 -2
  71. package/.bkit/core/engine/commands/install/install.ts +57 -18
  72. package/.bkit/core/engine/commands/install/uninstall.ts +65 -28
  73. package/.bkit/core/engine/commands/land.ts +18 -12
  74. package/.bkit/core/engine/commands/lib.ts +79 -17
  75. package/.bkit/core/engine/commands/registry.ts +4 -0
  76. package/.bkit/core/engine/commands/setup/setup.ts +7 -7
  77. package/.bkit/core/engine/commands/stats.ts +204 -0
  78. package/.bkit/core/engine/commands/tips.ts +10 -5
  79. package/.bkit/core/engine/commands/workflow/branches.ts +741 -62
  80. package/.bkit/core/engine/commands/workflow/challenge.ts +673 -0
  81. package/.bkit/core/engine/commands/workflow/context.ts +853 -29
  82. package/.bkit/core/engine/commands/workflow/counters.ts +267 -84
  83. package/.bkit/core/engine/commands/workflow/decisions.ts +541 -0
  84. package/.bkit/core/engine/commands/workflow/disk.ts +2 -2
  85. package/.bkit/core/engine/commands/workflow/fids.ts +793 -33
  86. package/.bkit/core/engine/commands/workflow/issues.ts +407 -64
  87. package/.bkit/core/engine/commands/workflow/ledgers.ts +884 -27
  88. package/.bkit/core/engine/commands/workflow/locks.ts +26 -2
  89. package/.bkit/core/engine/commands/workflow/plan-blocks.ts +582 -0
  90. package/.bkit/core/engine/commands/workflow/plan-versions.ts +21 -0
  91. package/.bkit/core/engine/commands/workflow/prs.ts +166 -30
  92. package/.bkit/core/engine/commands/workflow/repo.ts +58 -8
  93. package/.bkit/core/engine/commands/workflow/roadmap.ts +16 -7
  94. package/.bkit/core/engine/commands/workflow/run-facts.ts +501 -0
  95. package/.bkit/core/engine/commands/workflow/runs.ts +179 -49
  96. package/.bkit/core/engine/commands/workflow/runtime.ts +22 -1
  97. package/.bkit/core/engine/commands/workflow/status.ts +142 -29
  98. package/.bkit/core/engine/commands/workflow/step-table.ts +339 -0
  99. package/.bkit/core/engine/commands/workflow/steps.ts +213 -88
  100. package/.bkit/core/engine/commands/workflow/summary.ts +398 -0
  101. package/.bkit/core/engine/commands/workflow/tests.ts +1013 -148
  102. package/.bkit/core/engine/commands/workflow/tracker.ts +1195 -0
  103. package/.bkit/core/engine/commands/workflow/workflows.ts +984 -207
  104. package/.bkit/core/engine/commands/workflow/workstreams.ts +11 -5
  105. package/.bkit/core/engine/commands/workflow/worktrees.ts +185 -8
  106. package/.bkit/core/engine/install/manifest.ts +11 -9
  107. package/.bkit/core/engine/install/modules/cloud.ts +21 -13
  108. package/.bkit/core/engine/install/modules/core.ts +250 -3
  109. package/.bkit/core/engine/install/modules/opencode.ts +2 -2
  110. package/.bkit/core/engine/install/version-file.ts +6 -2
  111. package/.bkit/core/engine/ledgers/migrate.ts +92 -0
  112. package/.bkit/core/engine/ledgers/status.ts +92 -15
  113. package/.bkit/core/engine/ledgers/telemetry.ts +1261 -254
  114. package/.bkit/core/engine/render/hosts.ts +4 -0
  115. package/.bkit/core/engine/render/models.ts +12 -0
  116. package/.bkit/core/engine/shared/branches.ts +4 -1
  117. package/.bkit/core/engine/shared/egress.ts +7 -0
  118. package/.bkit/core/engine/shared/json.ts +25 -7
  119. package/.bkit/core/engine/shared/settings.ts +157 -20
  120. package/.bkit/core/engine/shared/text.ts +361 -0
  121. package/.bkit/core/engine/tools/grammar-density.ts +215 -0
  122. package/.bkit/core/engine/tools/instructions-sources.ts +834 -0
  123. package/.bkit/core/engine/tools/instructions.ts +1751 -0
  124. package/.bkit/core/hooks/gateguard-engine.js +24 -23
  125. package/.bkit/core/hooks/guardrails-shell.js +2 -3
  126. package/.bkit/core/hooks/guardrails-tiers.js +7 -1
  127. package/.bkit/core/hooks/readguard-engine.js +2 -2
  128. package/.bkit/core/prompts/bkit-audit-generate.md +62 -25
  129. package/.bkit/core/prompts/bkit-build-challenge-1.md +40 -17
  130. package/.bkit/core/prompts/bkit-build-challenge-2.md +44 -17
  131. package/.bkit/core/prompts/bkit-build-install-skills.md +26 -13
  132. package/.bkit/core/prompts/bkit-build-plan-convert.md +74 -0
  133. package/.bkit/core/prompts/bkit-build-plan-current.md +26 -13
  134. package/.bkit/core/prompts/bkit-build-plan-execute.md +74 -26
  135. package/.bkit/core/prompts/bkit-build-plan-gaps-remediate.md +64 -23
  136. package/.bkit/core/prompts/bkit-build-plan-verify.md +57 -33
  137. package/.bkit/core/prompts/bkit-debug-abort-handover.md +29 -15
  138. package/.bkit/core/prompts/bkit-debug-failure-diagnose.md +34 -14
  139. package/.bkit/core/prompts/bkit-debug-failure-remediate.md +34 -17
  140. package/.bkit/core/prompts/bkit-debug-failure-reproduce.md +26 -13
  141. package/.bkit/core/prompts/bkit-debug-failure-soak.md +31 -16
  142. package/.bkit/core/prompts/bkit-design-brainstorm-ideate-1.md +21 -11
  143. package/.bkit/core/prompts/bkit-design-brainstorm-ideate-2.md +20 -11
  144. package/.bkit/core/prompts/bkit-design-brainstorm-ideate-3.md +20 -11
  145. package/.bkit/core/prompts/bkit-design-generate.md +32 -14
  146. package/.bkit/core/prompts/bkit-design-organise.md +25 -12
  147. package/.bkit/core/prompts/bkit-design-review-1.md +31 -15
  148. package/.bkit/core/prompts/bkit-design-review-2.md +28 -13
  149. package/.bkit/core/prompts/bkit-design-spike.md +30 -13
  150. package/.bkit/core/prompts/bkit-design-update.md +33 -19
  151. package/.bkit/core/prompts/bkit-plan-generate.md +72 -18
  152. package/.bkit/core/prompts/bkit-plan-review-1.md +50 -27
  153. package/.bkit/core/prompts/bkit-plan-review-2.md +59 -28
  154. package/.bkit/core/prompts/bkit-plan-scope-check.md +109 -0
  155. package/.bkit/core/prompts/bkit-plan-update.md +61 -24
  156. package/.bkit/core/prompts/bkit-ship-conflict-resolve.md +27 -15
  157. package/.bkit/core/prompts/bkit-ship-deferred-sweep.md +31 -16
  158. package/.bkit/core/prompts/bkit-ship-update-docs.md +29 -14
  159. package/.bkit/core/prompts/bkit-utility-compress-markdown.md +24 -14
  160. package/.bkit/core/prompts/bkit-utility-update-decisions.md +32 -14
  161. package/.bkit/core/prompts/bkit-utility-update-deferrals.md +29 -14
  162. package/.bkit/core/prompts/bkit-utility-update-documentation.md +27 -12
  163. package/.bkit/core/prompts/bkit-utility-update-failures.md +31 -14
  164. package/.bkit/core/prompts/bkit-utility-update-knowledge.md +33 -14
  165. package/.bkit/core/prompts/bkit-utility-update-roadmap.md +38 -17
  166. package/.bkit/core/prompts/bkit-utility-update-tracker.md +41 -18
  167. package/.bkit/core/workflows/bkit-auto.md +54 -46
  168. package/.bkit/core/workflows/bkit-build.md +577 -458
  169. package/.bkit/core/workflows/bkit-debug.md +348 -333
  170. package/.bkit/core/workflows/bkit-design.md +201 -237
  171. package/.bkit/core/workflows/bkit-plan.md +210 -321
  172. package/.bkit/core/workflows/bkit-ship.md +328 -278
  173. package/.bkit/shared/.bkit/.env.example +2 -2
  174. package/.bkit/shared/.claude/settings.json +11 -0
  175. package/.bkit/shared/.cursor/mcp.json +1 -1
  176. package/.bkit/shared/.cursor/rules/bkit-rules.mdc +1 -1
  177. package/.bkit/shared/.gitattributes +1 -1
  178. package/.bkit/shared/.mcp.json +1 -1
  179. package/.bkit/shared/.opencode/opencode.json +11 -0
  180. package/.bkit/shared/CLAUDE.md +2 -2
  181. package/.bkit/shared/GEMINI.md +2 -2
  182. package/.bkit/shared/docs/architecture.md +1 -1
  183. package/.bkit/shared/docs/data-schema.md +1 -1
  184. package/.bkit/shared/docs/deployments.md +11 -11
  185. package/.bkit/shared/docs/design.md +1 -1
  186. package/.bkit/shared/docs/noise.md +1 -1
  187. package/.bkit/shared/docs/observability.md +2 -2
  188. package/.bkit/shared/docs/security.md +1 -1
  189. package/.bkit/shared/docs/setup.md +1 -1
  190. package/.bkit/shared/docs/technology.md +1 -1
  191. package/.bkit/shared/docs/testing.md +16 -7
  192. package/.bkit/templates/.claude/hooks/bkit-cloud-bootstrap.sh +1 -1
  193. package/.bkit/templates/.github/ISSUE_TEMPLATE/bkit-change.yml +26 -5
  194. package/.bkit/templates/.github/workflows/bkit-ci.yml +1 -1
  195. package/.bkit/templates/.github/workflows/bkit-cloud.yml +21 -19
  196. package/.bkit/templates/.husky/pre-push +4 -4
  197. package/.bkit/templates/.prettierignore +7 -0
  198. package/.bkit/templates/scripts/cleanup/bkit-disk-prune.mjs +1 -1
  199. package/CHANGELOG.md +112 -0
  200. package/README.md +50 -35
  201. package/dist/checks/after/ci-yml.js +39 -28
  202. package/dist/checks/after/github.js +91 -17
  203. package/dist/checks/after/index.js +11 -8
  204. package/dist/checks/after/suppression.js +8 -5
  205. package/dist/checks/after/tools.js +39 -82
  206. package/dist/checks/before/env.js +2 -2
  207. package/dist/checks/before/files.js +5 -3
  208. package/dist/checks/before/index.js +15 -2
  209. package/dist/checks/before/repo.js +163 -2
  210. package/dist/checks/tips/catalogue.js +14 -5
  211. package/dist/checks/tips/detect.js +32 -0
  212. package/dist/checks/tips/index.js +4 -4
  213. package/dist/cli.js +19 -47
  214. package/dist/commands/analysis.js +109 -100
  215. package/dist/commands/ci/ci.js +6 -6
  216. package/dist/commands/comply.js +54 -91
  217. package/dist/commands/install/doctor.js +2 -2
  218. package/dist/commands/install/install.js +50 -19
  219. package/dist/commands/install/uninstall.js +59 -28
  220. package/dist/commands/land.js +16 -12
  221. package/dist/commands/lib.js +51 -16
  222. package/dist/commands/registry.js +4 -0
  223. package/dist/commands/setup/setup.js +7 -7
  224. package/dist/commands/stats.js +136 -0
  225. package/dist/commands/tips.js +7 -3
  226. package/dist/commands/workflow/branches.js +656 -56
  227. package/dist/commands/workflow/challenge.js +556 -0
  228. package/dist/commands/workflow/context.js +709 -30
  229. package/dist/commands/workflow/counters.js +208 -75
  230. package/dist/commands/workflow/decisions.js +441 -0
  231. package/dist/commands/workflow/disk.js +2 -2
  232. package/dist/commands/workflow/fids.js +689 -33
  233. package/dist/commands/workflow/issues.js +343 -59
  234. package/dist/commands/workflow/ledgers.js +762 -27
  235. package/dist/commands/workflow/locks.js +24 -2
  236. package/dist/commands/workflow/plan-blocks.js +437 -0
  237. package/dist/commands/workflow/plan-versions.js +22 -0
  238. package/dist/commands/workflow/prs.js +142 -32
  239. package/dist/commands/workflow/repo.js +52 -8
  240. package/dist/commands/workflow/roadmap.js +9 -7
  241. package/dist/commands/workflow/run-facts.js +426 -0
  242. package/dist/commands/workflow/runs.js +144 -43
  243. package/dist/commands/workflow/runtime.js +12 -1
  244. package/dist/commands/workflow/status.js +130 -29
  245. package/dist/commands/workflow/step-table.js +276 -0
  246. package/dist/commands/workflow/steps.js +171 -80
  247. package/dist/commands/workflow/summary.js +275 -0
  248. package/dist/commands/workflow/tests.js +834 -136
  249. package/dist/commands/workflow/tracker.js +983 -0
  250. package/dist/commands/workflow/workflows.js +834 -195
  251. package/dist/commands/workflow/workstreams.js +11 -5
  252. package/dist/commands/workflow/worktrees.js +147 -9
  253. package/dist/install/manifest.js +11 -9
  254. package/dist/install/modules/cloud.js +22 -13
  255. package/dist/install/modules/core.js +247 -3
  256. package/dist/install/modules/opencode.js +2 -2
  257. package/dist/install/version-file.js +6 -2
  258. package/dist/ledgers/migrate.js +81 -0
  259. package/dist/ledgers/status.js +61 -8
  260. package/dist/ledgers/telemetry.js +905 -124
  261. package/dist/render/hosts.js +4 -0
  262. package/dist/render/models.js +12 -0
  263. package/dist/shared/branches.js +3 -1
  264. package/dist/shared/egress.js +7 -0
  265. package/dist/shared/json.js +20 -7
  266. package/dist/shared/settings.js +125 -17
  267. package/dist/shared/text.js +333 -0
  268. package/dist/tools/grammar-density.js +183 -0
  269. package/dist/tools/instructions-sources.js +721 -0
  270. package/dist/tools/instructions.js +1579 -0
  271. package/package.json +113 -24
  272. package/.bkit/core/engine/commands/harvest.ts +0 -459
  273. package/.bkit/core/engine/tools/wording.ts +0 -748
  274. package/.bkit/core/prompts/bkit-build-challenge-reconcile.md +0 -69
  275. package/.bkit/core/prompts/bkit-build-challenge-remediate.md +0 -71
  276. package/.bkit/core/prompts/bkit-build-challenge-tests.md +0 -74
  277. package/.bkit/core/prompts/bkit-build-summary.md +0 -94
  278. package/.bkit/core/prompts/bkit-debug-summary.md +0 -96
  279. package/.bkit/core/prompts/bkit-design-summary.md +0 -107
  280. package/.bkit/core/prompts/bkit-plan-complexity-check.md +0 -67
  281. package/.bkit/core/prompts/bkit-plan-complexity-split.md +0 -88
  282. package/.bkit/core/prompts/bkit-plan-review-3.md +0 -93
  283. package/.bkit/core/prompts/bkit-plan-scope-check-1.md +0 -85
  284. package/.bkit/core/prompts/bkit-plan-scope-check-2.md +0 -85
  285. package/.bkit/core/prompts/bkit-plan-summary.md +0 -107
  286. package/.bkit/core/prompts/bkit-ship-summary.md +0 -78
  287. package/dist/commands/harvest.js +0 -353
  288. package/dist/tools/wording.js +0 -680
@@ -0,0 +1,426 @@
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 plan 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
+ const TEST_ORDER_GAP = /—\s*(no-red|late-red|red-mismatch|red-evidence-missing|test-changed)\s*—\s*not fixable/g;
168
+ /** A task `bkit challenge merge` appended: its severity field. Planned tasks carry none. */
169
+ const APPENDED_SEVERITY = /\*\*Severity:\*\*\s*(CRITICAL|HIGH|MEDIUM|LOW)\b/;
170
+ const field = (r, k) => (r[k] === undefined ? null : r[k]);
171
+ const num = (v) => (typeof v === "number" ? v : null);
172
+ const str = (v) => (typeof v === "string" ? v : null);
173
+ /**
174
+ * Build-only facts from the run's step rows and its log folder: every verify and
175
+ * gaps-remediate round, the holistic verify, the challenge and the red-test runs. A
176
+ * verify report counts its test-order gaps only when its verdict and failure count
177
+ * match the round's row. Challenge findings are counted once a `build-challenge` row
178
+ * exists: CRITICAL / HIGH / MEDIUM from the tasks `challenge merge` appended to
179
+ * `plans`, LOW from its `build-challenge` rows among `deferrals` (the run's rows). The
180
+ * challenge block carries the latest `challenge-gate` row's size as `gate`, when one exists.
181
+ */
182
+ export function buildBlock(rows, logDir, plans, deferrals) {
183
+ const read = (file) => {
184
+ const f = path.join(logDir, file);
185
+ return fs.existsSync(f) ? fs.readFileSync(f, "utf-8") : null;
186
+ };
187
+ const steps = rows.filter((r) => r.type === "step-done");
188
+ const verify = steps
189
+ .filter((r) => r.step === "build-plan-verify")
190
+ .map((r) => {
191
+ const v = {
192
+ group: field(r, "group"),
193
+ attempt: field(r, "attempt"),
194
+ verdict: field(r, "verdict"),
195
+ failures: field(r, "failures"),
196
+ testOrderGaps: null,
197
+ };
198
+ const text = read(`build-plan-verify-${String(v.group)}-${String(v.attempt)}.md`);
199
+ if (text !== null &&
200
+ /^Verdict:\s*(\w+)/m.exec(text)?.[1] === v.verdict &&
201
+ Number(/^Failures:\s*(\d+)/m.exec(text)?.[1]) === v.failures)
202
+ v.testOrderGaps = [...text.matchAll(TEST_ORDER_GAP)].length;
203
+ return v;
204
+ });
205
+ const gapsRemediate = steps
206
+ .filter((r) => r.step === "build-plan-gaps-remediate")
207
+ .map((r) => ({
208
+ group: field(r, "group"),
209
+ attempt: field(r, "attempt"),
210
+ verdict: field(r, "verdict"),
211
+ strategy: field(r, "strategy"),
212
+ }));
213
+ const lastOf = (step) => steps.filter((r) => r.step === step).at(-1);
214
+ const hol = lastOf("build-plan-verify-holistic");
215
+ const ch = lastOf("build-challenge");
216
+ // `challenge-gate` rows are not fold events: read them as plain status rows.
217
+ const gate = rows
218
+ .filter((r) => r.type === "challenge-gate")
219
+ .at(-1);
220
+ let findings = null;
221
+ if (ch !== undefined) {
222
+ const f = { CRITICAL: 0, HIGH: 0, MEDIUM: 0, LOW: 0 };
223
+ for (const file of plans.filter((p) => fs.existsSync(p)))
224
+ for (const t of parsePlanBlocks(fs.readFileSync(file, "utf-8")).tasks) {
225
+ const sev = APPENDED_SEVERITY.exec(t.text)?.[1];
226
+ if (sev !== undefined && sev !== "LOW")
227
+ f[sev]++;
228
+ }
229
+ f.LOW = new Set(deferrals
230
+ .filter((r) => r.kind === "deferral" &&
231
+ r.severity === "LOW" &&
232
+ r.by?.step === "build-challenge")
233
+ .map((r) => String(r.key))).size;
234
+ findings = { total: f.CRITICAL + f.HIGH + f.MEDIUM + f.LOW, ...f };
235
+ }
236
+ return {
237
+ verify,
238
+ gapsRemediate,
239
+ holistic: hol ? { verdict: str(hol.verdict), failures: num(hol.failures) } : null,
240
+ challenge: ch
241
+ ? {
242
+ verdict: str(ch.verdict),
243
+ findings,
244
+ ...(gate === undefined
245
+ ? {}
246
+ : {
247
+ gate: {
248
+ size: str(gate.size),
249
+ linesChanged: num(gate.linesChanged),
250
+ filesChanged: num(gate.filesChanged),
251
+ skipped: gate.skipped === true,
252
+ },
253
+ }),
254
+ }
255
+ : null,
256
+ redTests: steps.filter((r) => r.step === "build-task-red").length,
257
+ };
258
+ }
259
+ /**
260
+ * Claude Code sets `CLAUDE_CODE_SESSION_ID` in the environment of every shell command its
261
+ * session runs, so `bkit workflows close` (run by the workflow's own session) knows whose
262
+ * transcripts hold the run's subagents.
263
+ */
264
+ export function claudeTranscripts(env, home) {
265
+ return {
266
+ sessionId: env.CLAUDE_CODE_SESSION_ID,
267
+ claudeDir: env.CLAUDE_CONFIG_DIR || path.join(home, ".claude"),
268
+ };
269
+ }
270
+ const SESSION_ID = /^[0-9A-Za-z][0-9A-Za-z_-]*$/;
271
+ /**
272
+ * The chat a host runs this command in, or undefined when the host names none. Claude Code
273
+ * only: it sets `CLAUDE_CODE_SESSION_ID`; nothing in this repo confirms a variable naming the
274
+ * chat on Codex, opencode, Cursor or Antigravity.
275
+ */
276
+ export function hostChat(env) {
277
+ const id = env.CLAUDE_CODE_SESSION_ID;
278
+ return id !== undefined && SESSION_ID.test(id) ? { platform: "claude-code", id } : undefined;
279
+ }
280
+ /**
281
+ * A chat's fingerprint on `session` status rows: `fp:` + the first 12 hex of
282
+ * sha256(`<platform>:<chat id>`), the same as the harvest's fingerprint of its `chat` row key.
283
+ */
284
+ export const chatFingerprint = (platform, id) => `fp:${createHash("sha256").update(`${platform}:${id}`).digest("hex").slice(0, 12)}`;
285
+ /** Status rows that mark a moment rather than the end of a piece of work: step minutes skip them. */
286
+ export const MARK_ROWS = new Set(["session", "owner-pause", "owner-answer"]);
287
+ /** The `session` fingerprints on the run's status rows, in row order, each once. */
288
+ export function runChats(rows) {
289
+ const out = [];
290
+ for (const r of rows)
291
+ if (r.type === "session" && typeof r.session === "string" && !out.includes(r.session))
292
+ out.push(r.session);
293
+ return out;
294
+ }
295
+ /** One Claude Code subagent transcript's model calls: `[ms, context]` each, or null when unreadable. */
296
+ function subagentCalls(file) {
297
+ const read = readTextFile(file);
298
+ if (!read.ok)
299
+ return null;
300
+ const calls = [];
301
+ for (const line of read.text.split("\n")) {
302
+ const parsed = line.trim() === "" ? null : parseJson(line);
303
+ if (parsed === null || !parsed.ok)
304
+ continue;
305
+ const d = parsed.value;
306
+ if (d === null || typeof d !== "object")
307
+ continue;
308
+ const m = d.message;
309
+ // `<synthetic>`: a message Claude Code wrote itself (an API error notice), not a model call.
310
+ if (d.type !== "assistant" || typeof m !== "object" || m === null)
311
+ continue;
312
+ if (m.model === "<synthetic>")
313
+ continue;
314
+ const at = msOf(d.timestamp);
315
+ if (!Number.isFinite(at))
316
+ continue;
317
+ const u = (m.usage ?? {});
318
+ const n = (k) => (typeof u[k] === "number" ? u[k] : 0);
319
+ calls.push([
320
+ at,
321
+ n("input_tokens") + n("cache_creation_input_tokens") + n("cache_read_input_tokens"),
322
+ ]);
323
+ }
324
+ return calls;
325
+ }
326
+ /**
327
+ * The run's subagents' context peaks per agent type, from every Claude Code chat that ran
328
+ * it: the chat running the close, and each chat whose fingerprint `chats` holds (the run's
329
+ * `session` rows). Transcripts: `<claudeDir>/projects/<project>/<session>/subagents/agent-*.jsonl`,
330
+ * each with its `agent-*.meta.json` naming the agent type (`unknown` without one). Each model
331
+ * call goes by its own timestamp: a subagent counts in `runs` when one of its calls falls in
332
+ * [startMs, endMs], and `peak` is the largest of those calls. Context of one model call =
333
+ * input + cache write + cache read tokens, the same sum the harvest's `contextPeak` takes.
334
+ * Undefined when no chat is known, no transcript is found or no subagent called the model
335
+ * in the run. Never throws: a folder or transcript that cannot be read counts as absent.
336
+ *
337
+ * Claude Code only. The other hosts bkit renders for record nothing here:
338
+ * - Cursor keeps no token counts in its local chats (the harvest reads them and finds none).
339
+ * - Codex (`~/.codex/sessions/.../rollout-*.jsonl`, `token_count` events) and opencode
340
+ * (`~/.local/share/opencode/opencode.db`) keep token counts, but nothing in this repo
341
+ * confirms an environment variable naming the running session, so a close cannot tell its
342
+ * own run's transcripts from another chat's.
343
+ * - Antigravity keeps protobuf in SQLite whose token fields nothing in this repo documents.
344
+ */
345
+ export function agentContextBlock(startMs, endMs, src, chats = []) {
346
+ const sid = src.sessionId !== undefined && SESSION_ID.test(src.sessionId) ? src.sessionId : null;
347
+ const wanted = new Set(chats);
348
+ if (sid === null && wanted.size === 0)
349
+ return undefined;
350
+ const projects = path.join(src.claudeDir, "projects");
351
+ const top = readDirNames(projects);
352
+ if (!top.ok)
353
+ return undefined;
354
+ const files = [];
355
+ for (const p of top.names.sort()) {
356
+ const names = readDirNames(path.join(projects, p));
357
+ for (const name of names.ok ? names.names.sort() : []) {
358
+ if (!SESSION_ID.test(name))
359
+ continue;
360
+ if (name !== sid && !wanted.has(chatFingerprint("claude-code", name)))
361
+ continue;
362
+ const dir = path.join(projects, p, name, "subagents");
363
+ const subs = readDirNames(dir);
364
+ for (const f of subs.ok ? subs.names.sort() : [])
365
+ if (f.endsWith(".jsonl"))
366
+ files.push(path.join(dir, f));
367
+ }
368
+ }
369
+ const byAgent = {};
370
+ for (const file of files) {
371
+ const inRun = (subagentCalls(file) ?? []).filter(([at]) => at >= startMs && at <= endMs);
372
+ if (inRun.length === 0)
373
+ continue;
374
+ const meta = readJsonFile(file.slice(0, -".jsonl".length) + ".meta.json");
375
+ const type = meta.ok ? meta.value?.agentType : undefined;
376
+ const a = (byAgent[typeof type === "string" && type !== "" ? type : "unknown"] ??= {
377
+ peak: 0,
378
+ runs: 0,
379
+ });
380
+ a.runs++;
381
+ a.peak = Math.max(a.peak, ...inRun.map(([, c]) => c));
382
+ }
383
+ return Object.keys(byAgent).length === 0 ? undefined : { host: "claude-code", byAgent };
384
+ }
385
+ /**
386
+ * After the close's CI dispatch: append the run's `outcome` row again with the
387
+ * dispatch added to `ci`, and `ending` `close-failed` when CI never started
388
+ * (`unresolved`). The run is the last `workflow-done` row of `workflow` in
389
+ * `status`; its `parentSha` names the outcome row. The newer row supersedes the
390
+ * close's under fold. Best-effort: a missing row or a refused append is logged.
391
+ */
392
+ export function restateOutcome(tree, status, workflow, dispatch, log) {
393
+ const done = readStatusEvents(status)
394
+ .filter((e) => e.type === "workflow-done" && e.workflow === workflow)
395
+ .sort((a, b) => (a.at < b.at ? -1 : a.at > b.at ? 1 : 0))
396
+ .at(-1);
397
+ const sha = done?.parentSha;
398
+ if (typeof sha !== "string") {
399
+ log(`[bkit-telemetry] no ${workflow} workflow-done row with parentSha — outcome not restated`);
400
+ return false;
401
+ }
402
+ const stats = path.join(tree, ".bkit", "stats.jsonl");
403
+ const outcome = fs.existsSync(stats)
404
+ ? [...foldFrom([stats]).state.values()]
405
+ .filter((e) => e.kind === "outcome" && e.by?.workflow === workflow && e.run?.parentSha === sha)
406
+ .at(-1)
407
+ : undefined;
408
+ if (outcome === undefined) {
409
+ log(`[bkit-telemetry] no ${workflow} outcome row for ${sha.slice(0, 12)} — outcome not restated`);
410
+ return false;
411
+ }
412
+ const { schema: _s, ts: _t, bkit: _b, ...draft } = outcome;
413
+ const entry = ciEntry(dispatch);
414
+ const ci = [...(draft.ci ?? []), entry];
415
+ try {
416
+ appendLedgerRows(tree, "stats", [
417
+ { ...draft, ending: entry.status === "unresolved" ? "close-failed" : "done", ci },
418
+ ]);
419
+ return true;
420
+ }
421
+ catch (err) {
422
+ // Telemetry never gates a dispatch: report the refused append and carry on.
423
+ log(`[bkit-telemetry] outcome not restated: ${err.message}`);
424
+ return false;
425
+ }
426
+ }