@cbartens/bkit 5.5.1 → 6.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (425) hide show
  1. package/.bkit/README.md +167 -154
  2. package/.bkit/core/.agents/context.md +95 -29
  3. package/.bkit/core/.agents/docs.md +18 -15
  4. package/.bkit/core/.agents/plugins/bkit/hooks/bkit-gateguard.cjs +1 -0
  5. package/.bkit/core/.agents/plugins/bkit/hooks/bkit-guardrails.cjs +6 -5
  6. package/.bkit/core/.agents/plugins/bkit/hooks/bkit-readguard.cjs +1 -0
  7. package/.bkit/core/.agents/plugins/bkit/hooks/bkit-rules.cjs +65 -0
  8. package/.bkit/core/.agents/rules.md +112 -102
  9. package/.bkit/core/.agents/skills.md +63 -15
  10. package/.bkit/core/.bkit/README.md +167 -154
  11. package/.bkit/core/.bkit/authoring.md +747 -0
  12. package/.bkit/core/.bkit/cli.md +407 -0
  13. package/.bkit/core/.bkit/cloud.md +283 -195
  14. package/.bkit/core/.bkit/comparison.md +45 -43
  15. package/.bkit/core/.bkit/install.md +166 -95
  16. package/.bkit/core/.bkit/jsonl.md +339 -196
  17. package/.bkit/core/.bkit/pipeline.md +142 -145
  18. package/.bkit/core/.bkit/prompts.md +295 -264
  19. package/.bkit/core/.bkit/providers.md +460 -277
  20. package/.bkit/core/.bkit/router.md +69 -0
  21. package/.bkit/core/.bkit/templates.md +530 -256
  22. package/.bkit/core/.bkit/trackers.md +116 -65
  23. package/.bkit/core/.bkit/workflows.md +742 -618
  24. package/.bkit/core/.claude/hooks/bkit-gateguard.cjs +2 -2
  25. package/.bkit/core/.claude/hooks/bkit-guardrails.cjs +3 -3
  26. package/.bkit/core/.claude/hooks/bkit-preflight.sh +45 -14
  27. package/.bkit/core/.codex/hooks/bkit-guardrails.cjs +3 -3
  28. package/.bkit/core/.codex/hooks/bkit-rules.cjs +57 -0
  29. package/.bkit/core/.cursor/hooks/bkit-guardrails.cjs +7 -7
  30. package/.bkit/core/.cursor/hooks/bkit-preflight.sh +47 -12
  31. package/.bkit/core/.opencode/plugin/bkit-rules.js +89 -0
  32. package/.bkit/core/AGENTS.md +6 -80
  33. package/.bkit/core/docs/templates/bkit-audit-accessibility.md +128 -130
  34. package/.bkit/core/docs/templates/bkit-audit-adoption.md +104 -94
  35. package/.bkit/core/docs/templates/bkit-audit-agents.md +96 -98
  36. package/.bkit/core/docs/templates/bkit-audit-aio-seo.md +100 -103
  37. package/.bkit/core/docs/templates/bkit-audit-analytics.md +141 -107
  38. package/.bkit/core/docs/templates/bkit-audit-annotations.md +99 -97
  39. package/.bkit/core/docs/templates/bkit-audit-app-performance.md +122 -121
  40. package/.bkit/core/docs/templates/bkit-audit-app-store.md +158 -101
  41. package/.bkit/core/docs/templates/bkit-audit-architecture.md +114 -96
  42. package/.bkit/core/docs/templates/bkit-audit-ci-performance.md +76 -97
  43. package/.bkit/core/docs/templates/bkit-audit-config.md +123 -101
  44. package/.bkit/core/docs/templates/bkit-audit-cost.md +86 -99
  45. package/.bkit/core/docs/templates/bkit-audit-coverage.md +76 -93
  46. package/.bkit/core/docs/templates/bkit-audit-database.md +102 -95
  47. package/.bkit/core/docs/templates/bkit-audit-dead-code.md +165 -108
  48. package/.bkit/core/docs/templates/bkit-audit-deferrals.md +115 -109
  49. package/.bkit/core/docs/templates/bkit-audit-dependencies.md +265 -113
  50. package/.bkit/core/docs/templates/bkit-audit-documentation.md +119 -118
  51. package/.bkit/core/docs/templates/bkit-audit-duplication.md +140 -111
  52. package/.bkit/core/docs/templates/bkit-audit-failures.md +111 -106
  53. package/.bkit/core/docs/templates/bkit-audit-flakes.md +100 -99
  54. package/.bkit/core/docs/templates/bkit-audit-gates.md +107 -103
  55. package/.bkit/core/docs/templates/bkit-audit-issues.md +105 -105
  56. package/.bkit/core/docs/templates/bkit-audit-llm.md +134 -85
  57. package/.bkit/core/docs/templates/bkit-audit-logs.md +124 -125
  58. package/.bkit/core/docs/templates/bkit-audit-models.md +99 -78
  59. package/.bkit/core/docs/templates/bkit-audit-privacy.md +56 -76
  60. package/.bkit/core/docs/templates/bkit-audit-prompts.md +63 -78
  61. package/.bkit/core/docs/templates/bkit-audit-red-team.md +125 -93
  62. package/.bkit/core/docs/templates/bkit-audit-reliability.md +97 -96
  63. package/.bkit/core/docs/templates/bkit-audit-repo.md +170 -98
  64. package/.bkit/core/docs/templates/bkit-audit-security.md +207 -121
  65. package/.bkit/core/docs/templates/bkit-audit-slop.md +78 -95
  66. package/.bkit/core/docs/templates/bkit-audit-testing.md +163 -139
  67. package/.bkit/core/docs/templates/bkit-audit-usability.md +114 -96
  68. package/.bkit/core/docs/templates/bkit-plan.md +158 -281
  69. package/.bkit/core/engine/checks/after/auth.ts +40 -37
  70. package/.bkit/core/engine/checks/after/ci-yml.ts +104 -31
  71. package/.bkit/core/engine/checks/after/github.ts +95 -17
  72. package/.bkit/core/engine/checks/after/index.ts +21 -8
  73. package/.bkit/core/engine/checks/after/suppression.ts +8 -5
  74. package/.bkit/core/engine/checks/after/tools.ts +125 -123
  75. package/.bkit/core/engine/checks/before/context-fetch.ts +227 -33
  76. package/.bkit/core/engine/checks/before/env.ts +3 -3
  77. package/.bkit/core/engine/checks/before/files.ts +5 -4
  78. package/.bkit/core/engine/checks/before/index.ts +25 -1
  79. package/.bkit/core/engine/checks/before/repo.ts +208 -2
  80. package/.bkit/core/engine/checks/status-holes.ts +916 -123
  81. package/.bkit/core/engine/checks/tips/catalogue.ts +82 -20
  82. package/.bkit/core/engine/checks/tips/detect.ts +66 -0
  83. package/.bkit/core/engine/checks/tips/index.ts +52 -11
  84. package/.bkit/core/engine/cli.ts +251 -130
  85. package/.bkit/core/engine/commands/analysis.ts +282 -199
  86. package/.bkit/core/engine/commands/ci/ci.ts +363 -29
  87. package/.bkit/core/engine/commands/ci/pins.ts +172 -0
  88. package/.bkit/core/engine/commands/ci/push-gate.ts +223 -0
  89. package/.bkit/core/engine/commands/comply.ts +77 -103
  90. package/.bkit/core/engine/commands/install/doctor.ts +2 -2
  91. package/.bkit/core/engine/commands/install/install.ts +57 -18
  92. package/.bkit/core/engine/commands/install/uninstall.ts +86 -55
  93. package/.bkit/core/engine/commands/install/upgrade.ts +32 -15
  94. package/.bkit/core/engine/commands/land.ts +139 -18
  95. package/.bkit/core/engine/commands/lib.ts +381 -22
  96. package/.bkit/core/engine/commands/registry.ts +10 -2
  97. package/.bkit/core/engine/commands/setup/setup.ts +8 -7
  98. package/.bkit/core/engine/commands/stats.ts +260 -0
  99. package/.bkit/core/engine/commands/tips.ts +10 -5
  100. package/.bkit/core/engine/commands/workflow/branches.ts +2215 -176
  101. package/.bkit/core/engine/commands/workflow/challenge.ts +748 -0
  102. package/.bkit/core/engine/commands/workflow/completeness.ts +109 -0
  103. package/.bkit/core/engine/commands/workflow/context.ts +1249 -47
  104. package/.bkit/core/engine/commands/workflow/counters.ts +483 -95
  105. package/.bkit/core/engine/commands/workflow/decisions.ts +585 -0
  106. package/.bkit/core/engine/commands/workflow/disk.ts +238 -56
  107. package/.bkit/core/engine/commands/workflow/fids.ts +811 -33
  108. package/.bkit/core/engine/commands/workflow/issues.ts +413 -64
  109. package/.bkit/core/engine/commands/workflow/ledgers.ts +1333 -36
  110. package/.bkit/core/engine/commands/workflow/locks.ts +28 -2
  111. package/.bkit/core/engine/commands/workflow/plan-blocks.ts +691 -0
  112. package/.bkit/core/engine/commands/workflow/plan-versions.ts +21 -0
  113. package/.bkit/core/engine/commands/workflow/plans.ts +257 -0
  114. package/.bkit/core/engine/commands/workflow/prs.ts +178 -33
  115. package/.bkit/core/engine/commands/workflow/repo.ts +66 -8
  116. package/.bkit/core/engine/commands/workflow/roadmap.ts +72 -22
  117. package/.bkit/core/engine/commands/workflow/run-facts.ts +492 -0
  118. package/.bkit/core/engine/commands/workflow/runs.ts +827 -79
  119. package/.bkit/core/engine/commands/workflow/runtime.ts +25 -1
  120. package/.bkit/core/engine/commands/workflow/skills.ts +1 -0
  121. package/.bkit/core/engine/commands/workflow/status.ts +329 -33
  122. package/.bkit/core/engine/commands/workflow/step-table.ts +381 -0
  123. package/.bkit/core/engine/commands/workflow/steps.ts +841 -105
  124. package/.bkit/core/engine/commands/workflow/summary-findings.ts +177 -0
  125. package/.bkit/core/engine/commands/workflow/summary.ts +544 -0
  126. package/.bkit/core/engine/commands/workflow/tasks.ts +409 -0
  127. package/.bkit/core/engine/commands/workflow/test-blocks.ts +254 -0
  128. package/.bkit/core/engine/commands/workflow/tests-changed.ts +201 -0
  129. package/.bkit/core/engine/commands/workflow/tests.ts +2124 -330
  130. package/.bkit/core/engine/commands/workflow/tracker.ts +1195 -0
  131. package/.bkit/core/engine/commands/workflow/workflows.ts +1197 -235
  132. package/.bkit/core/engine/commands/workflow/worktrees.ts +543 -24
  133. package/.bkit/core/engine/install/cloud-env.ts +251 -121
  134. package/.bkit/core/engine/install/context-ci-workflow.ts +102 -0
  135. package/.bkit/core/engine/install/manifest.ts +67 -17
  136. package/.bkit/core/engine/install/modules/antigravity.ts +3 -2
  137. package/.bkit/core/engine/install/modules/cloud.ts +24 -16
  138. package/.bkit/core/engine/install/modules/codex.ts +15 -2
  139. package/.bkit/core/engine/install/modules/core.ts +1196 -45
  140. package/.bkit/core/engine/install/modules/cursor.ts +6 -6
  141. package/.bkit/core/engine/install/modules/opencode.ts +18 -6
  142. package/.bkit/core/engine/install/template-notes.ts +130 -0
  143. package/.bkit/core/engine/install/version-file.ts +9 -4
  144. package/.bkit/core/engine/install/write.ts +5 -0
  145. package/.bkit/core/engine/ledgers/compact.ts +124 -0
  146. package/.bkit/core/engine/ledgers/journal.ts +291 -0
  147. package/.bkit/core/engine/ledgers/migrate.ts +92 -0
  148. package/.bkit/core/engine/ledgers/status.ts +249 -21
  149. package/.bkit/core/engine/ledgers/telemetry.ts +1397 -253
  150. package/.bkit/core/engine/render/hosts.ts +118 -14
  151. package/.bkit/core/engine/render/models.ts +12 -0
  152. package/.bkit/core/engine/shared/bkit-latest.ts +26 -4
  153. package/.bkit/core/engine/shared/branches.ts +4 -1
  154. package/.bkit/core/engine/shared/dep-updater.ts +60 -0
  155. package/.bkit/core/engine/shared/egress.ts +8 -1
  156. package/.bkit/core/engine/shared/json.ts +25 -7
  157. package/.bkit/core/engine/shared/package-manager.ts +9 -0
  158. package/.bkit/core/engine/shared/settings.ts +243 -31
  159. package/.bkit/core/engine/shared/text.ts +361 -0
  160. package/.bkit/core/engine/shared/timeouts.ts +2 -0
  161. package/.bkit/core/engine/tools/cli-doc.ts +111 -0
  162. package/.bkit/core/engine/tools/grammar-density.ts +215 -0
  163. package/.bkit/core/engine/tools/instructions-sources.ts +832 -0
  164. package/.bkit/core/engine/tools/instructions.ts +1802 -0
  165. package/.bkit/core/hooks/antigravity-hook.js +25 -10
  166. package/.bkit/core/hooks/gateguard-engine.js +54 -29
  167. package/.bkit/core/hooks/guardrails-shell.js +4 -5
  168. package/.bkit/core/hooks/guardrails-tiers.js +10 -4
  169. package/.bkit/core/hooks/preflight-linear.sh +9 -9
  170. package/.bkit/core/hooks/preflight-rules.sh +8 -0
  171. package/.bkit/core/hooks/readguard-engine.js +29 -10
  172. package/.bkit/core/hooks/session-rules-advisory.js +61 -0
  173. package/.bkit/core/prompts/bkit-audit-generate.md +202 -94
  174. package/.bkit/core/prompts/bkit-build-challenge-1.md +76 -34
  175. package/.bkit/core/prompts/bkit-build-challenge-2.md +85 -38
  176. package/.bkit/core/prompts/bkit-build-install-skills.md +50 -28
  177. package/.bkit/core/prompts/bkit-build-plan-convert.md +85 -0
  178. package/.bkit/core/prompts/bkit-build-plan-current.md +59 -36
  179. package/.bkit/core/prompts/bkit-build-plan-gaps-remediate.md +101 -36
  180. package/.bkit/core/prompts/bkit-build-plan-tasks.md +149 -0
  181. package/.bkit/core/prompts/bkit-build-plan-tests.md +120 -0
  182. package/.bkit/core/prompts/bkit-build-plan-verify.md +104 -43
  183. package/.bkit/core/prompts/bkit-debug-abort-handover.md +47 -32
  184. package/.bkit/core/prompts/bkit-debug-failure-diagnose.md +109 -57
  185. package/.bkit/core/prompts/bkit-debug-failure-remediate.md +65 -39
  186. package/.bkit/core/prompts/bkit-debug-failure-reproduce.md +53 -31
  187. package/.bkit/core/prompts/bkit-debug-failure-soak.md +65 -34
  188. package/.bkit/core/prompts/bkit-design-brainstorm-ideate-1.md +46 -31
  189. package/.bkit/core/prompts/bkit-design-brainstorm-ideate-2.md +45 -31
  190. package/.bkit/core/prompts/bkit-design-brainstorm-ideate-3.md +43 -30
  191. package/.bkit/core/prompts/bkit-design-generate.md +80 -46
  192. package/.bkit/core/prompts/bkit-design-organise.md +83 -32
  193. package/.bkit/core/prompts/bkit-design-review-1.md +70 -50
  194. package/.bkit/core/prompts/bkit-design-review-2.md +65 -46
  195. package/.bkit/core/prompts/bkit-design-spike.md +64 -40
  196. package/.bkit/core/prompts/bkit-design-update.md +53 -28
  197. package/.bkit/core/prompts/bkit-plan-generate.md +101 -29
  198. package/.bkit/core/prompts/bkit-plan-review-1.md +78 -41
  199. package/.bkit/core/prompts/bkit-plan-review-2.md +78 -35
  200. package/.bkit/core/prompts/bkit-plan-scope-check.md +116 -0
  201. package/.bkit/core/prompts/bkit-plan-update.md +86 -31
  202. package/.bkit/core/prompts/bkit-ship-conflict-resolve.md +94 -50
  203. package/.bkit/core/prompts/bkit-ship-deferred-sweep.md +91 -41
  204. package/.bkit/core/prompts/bkit-ship-update-docs.md +45 -24
  205. package/.bkit/core/prompts/bkit-utility-compress-markdown.md +65 -49
  206. package/.bkit/core/prompts/bkit-utility-update-decisions.md +87 -42
  207. package/.bkit/core/prompts/bkit-utility-update-deferrals.md +81 -37
  208. package/.bkit/core/prompts/bkit-utility-update-documentation.md +43 -25
  209. package/.bkit/core/prompts/bkit-utility-update-failures.md +84 -37
  210. package/.bkit/core/prompts/bkit-utility-update-knowledge.md +88 -42
  211. package/.bkit/core/prompts/bkit-utility-update-roadmap.md +92 -39
  212. package/.bkit/core/prompts/bkit-utility-update-tracker.md +159 -60
  213. package/.bkit/core/workflows/bkit-auto.md +89 -58
  214. package/.bkit/core/workflows/bkit-build.md +967 -517
  215. package/.bkit/core/workflows/bkit-debug.md +555 -387
  216. package/.bkit/core/workflows/bkit-design.md +319 -283
  217. package/.bkit/core/workflows/bkit-plan.md +319 -342
  218. package/.bkit/core/workflows/bkit-ship.md +525 -328
  219. package/.bkit/shared/.agents/plugins/bkit/hooks.json +10 -0
  220. package/.bkit/shared/.bkit/.env.example +2 -2
  221. package/.bkit/shared/.claude/bkit-cloud.md +12 -10
  222. package/.bkit/shared/.claude/settings.json +14 -0
  223. package/.bkit/shared/.codex/bkit-cloud.md +98 -0
  224. package/.bkit/shared/.codex/hooks.json +20 -0
  225. package/.bkit/shared/.cursor/bkit-cloud.md +3 -3
  226. package/.bkit/shared/.cursor/mcp.json +1 -1
  227. package/.bkit/shared/.cursor/rules/bkit-rules.mdc +1 -1
  228. package/.bkit/shared/.gitattributes +1 -1
  229. package/.bkit/shared/.mcp.json +1 -1
  230. package/.bkit/shared/.opencode/opencode.json +12 -1
  231. package/.bkit/shared/CLAUDE.md +6 -2
  232. package/.bkit/shared/GEMINI.md +5 -2
  233. package/.bkit/shared/docs/architecture.md +4 -7
  234. package/.bkit/shared/docs/data-schema.md +4 -7
  235. package/.bkit/shared/docs/deployments.md +241 -168
  236. package/.bkit/shared/docs/design.md +11 -12
  237. package/.bkit/shared/docs/noise.md +8 -7
  238. package/.bkit/shared/docs/observability.md +5 -8
  239. package/.bkit/shared/docs/security.md +35 -17
  240. package/.bkit/shared/docs/setup.md +29 -18
  241. package/.bkit/shared/docs/technology.md +3 -6
  242. package/.bkit/shared/docs/testing.md +289 -174
  243. package/.bkit/shared/gitignore +6 -2
  244. package/.bkit/templates/.claude/hooks/bkit-cloud-bootstrap.sh +15 -16
  245. package/.bkit/templates/.cursor/Dockerfile +12 -8
  246. package/.bkit/templates/.cursor/environment.json +1 -1
  247. package/.bkit/templates/.github/ISSUE_TEMPLATE/bkit-bug.yml +10 -8
  248. package/.bkit/templates/.github/ISSUE_TEMPLATE/bkit-change.yml +45 -12
  249. package/.bkit/templates/.github/ISSUE_TEMPLATE/bkit-idea.yml +3 -3
  250. package/.bkit/templates/.github/renovate.json5 +34 -6
  251. package/.bkit/templates/.github/workflows/bkit-ci.yml +54 -51
  252. package/.bkit/templates/.github/workflows/bkit-cloud.yml +34 -33
  253. package/.bkit/templates/.github/workflows/bkit-health.yml +97 -0
  254. package/.bkit/templates/.github/workflows/bkit-renovate.yml +5 -4
  255. package/.bkit/templates/.github/workflows/bkit-trivy.yml +5 -4
  256. package/.bkit/templates/.husky/pre-commit +2 -2
  257. package/.bkit/templates/.husky/pre-push +96 -36
  258. package/.bkit/templates/.prettierignore +6 -0
  259. package/.bkit/templates/.vale.ini +27 -27
  260. package/.bkit/templates/context/bkit-cloudrun.md +23 -15
  261. package/.bkit/templates/context/bkit-expo.md +70 -52
  262. package/.bkit/templates/context/bkit-github.md +93 -56
  263. package/.bkit/templates/context/bkit-inngest.md +21 -15
  264. package/.bkit/templates/context/bkit-maestro.md +22 -16
  265. package/.bkit/templates/context/bkit-playwright.md +23 -17
  266. package/.bkit/templates/context/bkit-resend.md +12 -10
  267. package/.bkit/templates/context/bkit-sentry.md +30 -20
  268. package/.bkit/templates/context/bkit-serena.md +8 -7
  269. package/.bkit/templates/context/bkit-stripe.md +14 -13
  270. package/.bkit/templates/context/bkit-supabase.md +16 -13
  271. package/.bkit/templates/context/bkit-tavily.md +14 -11
  272. package/.bkit/templates/context/bkit-vercel.md +27 -18
  273. package/.bkit/templates/docs/capabilities.md +15 -14
  274. package/.bkit/templates/scripts/ci/{check-accepted-divergences.mjs → bkit-check-accepted-divergences.mjs} +6 -3
  275. package/.bkit/templates/scripts/ci/{check-accepted-divergences.test.mjs → bkit-check-accepted-divergences.test.mjs} +3 -3
  276. package/.bkit/templates/scripts/ci/{check-capstone.mjs → bkit-check-capstone.mjs} +2 -2
  277. package/.bkit/templates/scripts/ci/{check-capstone.test.mjs → bkit-check-capstone.test.mjs} +4 -4
  278. package/.bkit/templates/scripts/ci/{check-dependency-audit.mjs → bkit-check-dependency-audit.mjs} +103 -18
  279. package/.bkit/templates/scripts/ci/{check-dependency-audit.test.mjs → bkit-check-dependency-audit.test.mjs} +31 -3
  280. package/.bkit/templates/scripts/ci/bkit-machine-lock.sh +387 -0
  281. package/.bkit/templates/scripts/ci/bkit-test-awake.mjs +75 -0
  282. package/.bkit/templates/scripts/ci/bkit-test-awake.test.mjs +160 -0
  283. package/.bkit/templates/scripts/ci/lanes/{resolve-push-base.mjs → bkit-resolve-push-base.mjs} +3 -3
  284. package/.bkit/templates/scripts/ci/lanes/{resolve-push-base.test.mjs → bkit-resolve-push-base.test.mjs} +4 -4
  285. package/.bkit/templates/scripts/cleanup/bkit-disk-prune.mjs +10 -2
  286. package/.bkit/templates/scripts/graphify/bkit-graph-drift.py +1 -1
  287. package/.bkit/templates/scripts/graphify/bkit-graph-eager.py +3 -3
  288. package/.bkit/templates/scripts/graphify/bkit-graph-embed.py +63 -0
  289. package/.bkit/templates/scripts/graphify/bkit-graph-imports.py +2 -2
  290. package/.bkit/templates/scripts/graphify/bkit-graph-pre-push.sh +69 -18
  291. package/.bkit/templates/scripts/graphify/bkit-graph-repair.py +3 -3
  292. package/.bkit/templates/scripts/graphify/bkit-graph-surface.py +1 -1
  293. package/.bkit/templates/scripts/graphify/bkit-graphify-graphml.py +1 -1
  294. package/.bkit/templates/scripts/graphify/bkit-graphify-rollup.py +197 -126
  295. package/.bkit/templates/scripts/graphify/bkit-graphify.sh +64 -41
  296. package/.bkit/templates/scripts/slop/bkit-slop-type-suppression.mjs +23 -7
  297. package/.bkit/templates/slop-scan.config.json +9 -2
  298. package/CHANGELOG.md +231 -0
  299. package/README.md +278 -89
  300. package/dist/checks/after/auth.js +36 -33
  301. package/dist/checks/after/ci-yml.js +91 -30
  302. package/dist/checks/after/github.js +91 -17
  303. package/dist/checks/after/index.js +22 -11
  304. package/dist/checks/after/suppression.js +8 -5
  305. package/dist/checks/after/tools.js +111 -114
  306. package/dist/checks/before/context-fetch.js +218 -33
  307. package/dist/checks/before/env.js +3 -3
  308. package/dist/checks/before/files.js +5 -3
  309. package/dist/checks/before/index.js +20 -3
  310. package/dist/checks/before/repo.js +197 -2
  311. package/dist/checks/status-holes.js +739 -114
  312. package/dist/checks/tips/catalogue.js +70 -19
  313. package/dist/checks/tips/detect.js +62 -0
  314. package/dist/checks/tips/index.js +51 -9
  315. package/dist/cli.js +234 -124
  316. package/dist/commands/analysis.js +174 -141
  317. package/dist/commands/ci/ci.js +302 -25
  318. package/dist/commands/ci/pins.js +142 -0
  319. package/dist/commands/ci/push-gate.js +194 -0
  320. package/dist/commands/comply.js +54 -91
  321. package/dist/commands/install/doctor.js +2 -2
  322. package/dist/commands/install/install.js +50 -19
  323. package/dist/commands/install/uninstall.js +82 -55
  324. package/dist/commands/install/upgrade.js +21 -11
  325. package/dist/commands/land.js +137 -17
  326. package/dist/commands/lib.js +295 -21
  327. package/dist/commands/registry.js +10 -2
  328. package/dist/commands/setup/setup.js +8 -7
  329. package/dist/commands/stats.js +175 -0
  330. package/dist/commands/tips.js +7 -3
  331. package/dist/commands/workflow/branches.js +1873 -152
  332. package/dist/commands/workflow/challenge.js +609 -0
  333. package/dist/commands/workflow/completeness.js +97 -0
  334. package/dist/commands/workflow/context.js +1045 -46
  335. package/dist/commands/workflow/counters.js +385 -86
  336. package/dist/commands/workflow/decisions.js +484 -0
  337. package/dist/commands/workflow/disk.js +214 -56
  338. package/dist/commands/workflow/fids.js +706 -33
  339. package/dist/commands/workflow/issues.js +349 -59
  340. package/dist/commands/workflow/ledgers.js +1123 -37
  341. package/dist/commands/workflow/locks.js +26 -2
  342. package/dist/commands/workflow/plan-blocks.js +501 -0
  343. package/dist/commands/workflow/plan-versions.js +22 -0
  344. package/dist/commands/workflow/plans.js +205 -0
  345. package/dist/commands/workflow/prs.js +154 -35
  346. package/dist/commands/workflow/repo.js +58 -8
  347. package/dist/commands/workflow/roadmap.js +58 -23
  348. package/dist/commands/workflow/run-facts.js +421 -0
  349. package/dist/commands/workflow/runs.js +670 -72
  350. package/dist/commands/workflow/runtime.js +15 -1
  351. package/dist/commands/workflow/skills.js +1 -0
  352. package/dist/commands/workflow/status.js +282 -34
  353. package/dist/commands/workflow/step-table.js +308 -0
  354. package/dist/commands/workflow/steps.js +703 -96
  355. package/dist/commands/workflow/summary-findings.js +117 -0
  356. package/dist/commands/workflow/summary.js +388 -0
  357. package/dist/commands/workflow/tasks.js +378 -0
  358. package/dist/commands/workflow/test-blocks.js +231 -0
  359. package/dist/commands/workflow/tests-changed.js +172 -0
  360. package/dist/commands/workflow/tests.js +1695 -305
  361. package/dist/commands/workflow/tracker.js +983 -0
  362. package/dist/commands/workflow/workflows.js +1014 -222
  363. package/dist/commands/workflow/worktrees.js +432 -26
  364. package/dist/install/cloud-env.js +233 -99
  365. package/dist/install/context-ci-workflow.js +85 -0
  366. package/dist/install/manifest.js +64 -17
  367. package/dist/install/modules/antigravity.js +3 -2
  368. package/dist/install/modules/cloud.js +25 -16
  369. package/dist/install/modules/codex.js +12 -2
  370. package/dist/install/modules/core.js +1090 -48
  371. package/dist/install/modules/cursor.js +6 -6
  372. package/dist/install/modules/opencode.js +13 -7
  373. package/dist/install/template-notes.js +116 -0
  374. package/dist/install/version-file.js +9 -4
  375. package/dist/ledgers/compact.js +87 -0
  376. package/dist/ledgers/journal.js +233 -0
  377. package/dist/ledgers/migrate.js +81 -0
  378. package/dist/ledgers/status.js +176 -13
  379. package/dist/ledgers/telemetry.js +1010 -125
  380. package/dist/render/hosts.js +104 -14
  381. package/dist/render/models.js +12 -0
  382. package/dist/shared/bkit-latest.js +26 -4
  383. package/dist/shared/branches.js +3 -1
  384. package/dist/shared/dep-updater.js +49 -0
  385. package/dist/shared/egress.js +8 -1
  386. package/dist/shared/json.js +20 -7
  387. package/dist/shared/package-manager.js +6 -0
  388. package/dist/shared/settings.js +181 -24
  389. package/dist/shared/text.js +333 -0
  390. package/dist/shared/timeouts.js +2 -0
  391. package/dist/tools/cli-doc.js +97 -0
  392. package/dist/tools/grammar-density.js +183 -0
  393. package/dist/tools/instructions-sources.js +720 -0
  394. package/dist/tools/instructions.js +1623 -0
  395. package/package.json +156 -51
  396. package/.bkit/core/.bkit/lite.md +0 -73
  397. package/.bkit/core/engine/commands/harvest.ts +0 -459
  398. package/.bkit/core/engine/commands/workflow/workstreams.ts +0 -166
  399. package/.bkit/core/engine/tools/wording.ts +0 -748
  400. package/.bkit/core/prompts/bkit-build-challenge-reconcile.md +0 -69
  401. package/.bkit/core/prompts/bkit-build-challenge-remediate.md +0 -71
  402. package/.bkit/core/prompts/bkit-build-challenge-tests.md +0 -74
  403. package/.bkit/core/prompts/bkit-build-plan-execute.md +0 -76
  404. package/.bkit/core/prompts/bkit-build-summary.md +0 -94
  405. package/.bkit/core/prompts/bkit-debug-summary.md +0 -96
  406. package/.bkit/core/prompts/bkit-design-summary.md +0 -107
  407. package/.bkit/core/prompts/bkit-plan-complexity-check.md +0 -67
  408. package/.bkit/core/prompts/bkit-plan-complexity-split.md +0 -88
  409. package/.bkit/core/prompts/bkit-plan-review-3.md +0 -93
  410. package/.bkit/core/prompts/bkit-plan-scope-check-1.md +0 -85
  411. package/.bkit/core/prompts/bkit-plan-scope-check-2.md +0 -85
  412. package/.bkit/core/prompts/bkit-plan-summary.md +0 -107
  413. package/.bkit/core/prompts/bkit-ship-summary.md +0 -78
  414. package/.bkit/templates/scripts/ci/bkit-local-stack-lock.sh +0 -194
  415. package/dist/commands/harvest.js +0 -353
  416. package/dist/commands/workflow/workstreams.js +0 -143
  417. package/dist/tools/wording.js +0 -680
  418. /package/.bkit/templates/.vale/styles/{House → Bkit}/Filler.yml +0 -0
  419. /package/.bkit/templates/.vale/styles/{House → Bkit}/Hedging.yml +0 -0
  420. /package/.bkit/templates/.vale/styles/{House → Bkit}/LLMSlop.yml +0 -0
  421. /package/.bkit/templates/.vale/styles/{House → Bkit}/Verbose.yml +0 -0
  422. /package/.bkit/templates/scripts/ci/{accepted-advisories.json → bkit-accepted-advisories.json} +0 -0
  423. /package/.bkit/templates/scripts/ci/{accepted-divergences.json → bkit-accepted-divergences.json} +0 -0
  424. /package/.bkit/templates/scripts/launchd/{launchd.env.example → bkit-launchd.env.example} +0 -0
  425. /package/.bkit/templates/scripts/launchd/{ai.bkit.launchd.plist → bkit-launchd.plist} +0 -0
@@ -1,9 +1,9 @@
1
- <!-- Note: Reports live at `docs/audits/{YYYYMM}/{slug}.md`. `{YYYYMM}` = UTC month of this run. `{slug}` = template basename without `bkit-audit-` and `.md`. **If** that month already has `{slug}.md` or `{slug}-{TIMESTAMP}.md` → write `{slug}-{TIMESTAMP}.md` (`{TIMESTAMP}` = `date -u +%Y%m%dT%H%M%SZ`). Never overwrite. The report is stamped with a `bkit:anchor` block recording the audited commit (`baseSha`) and branch (`baseRef`); never hand-author or edit it. `@bkit-audit-generate` fills this template. -->
2
-
3
1
  <!-- bkit:start -->
4
2
 
5
3
  {{BKIT_MANAGED_MARKER}}
6
4
 
5
+ <!-- Note: @bkit-audit-generate fills this template. The report lives at `docs/audits/{YYYYMM}/{slug}.md`, where `{YYYYMM}` is the UTC month of the run and `{slug}` is this file's name without `bkit-audit-` and `.md`. **If** that month already has `{slug}.md` or `{slug}-{TIMESTAMP}.md` → write `{slug}-{TIMESTAMP}.md`, where `{TIMESTAMP}` is the output of `date -u +%Y%m%dT%H%M%SZ`. NEVER overwrite an earlier report. The report is stamped with a `bkit:anchor` block that records the audited commit (`baseSha`) and branch (`baseRef`). NEVER write or edit that block by hand. -->
6
+
7
7
  # CI Performance Audit
8
8
 
9
9
  > [!CAUTION]
@@ -11,102 +11,84 @@
11
11
  >
12
12
  > **Rules:**
13
13
  >
14
- > - Read-only audit; never edit code, config, or data.
15
- > - `Universal Instructions` apply to all projects; `Project Instructions` apply only to this project.
16
- > - Local audit instructions / overrides → `Project Instructions` below the bkit-managed block; universal instructions stay in-block.
17
- > - Any tools mentioned in `Universal Instructions` are examples only; swap for actual tools in final output; drop inapplicable.
18
- > - Use dense token-efficient phrasing; no filler / hedging / restating; tables > prose, bullets > paragraphs.
19
- > - Read `.agents/docs.md` → load docs for workflow / step / task; skip missing; cite docs inline where required.
20
- > - Every claim cites this run's evidence (`file:line`, or command / query and its output) and tool behind it; a previous report's figure, list, or status is a lead, not evidence.
21
- > - Read this document once at session start; do not trust session memory; do not re-read on every loop iteration.
22
- > - never dispatch, rerun, or cancel a workflow. A runner-class experiment is named, not run.
23
- > - Billable rates are read this run from the billing pages. never copy a previous report's prices.
14
+ > - Never dispatch, rerun or cancel a workflow.
15
+ > - Name a runner-class experiment, but do not run it.
16
+ > - Read the billable rates from the billing pages during this run.
17
+ > - Never copy a previous report's prices.
24
18
 
25
19
  ## Universal Instructions
26
20
 
27
21
  ### Context & Goals
28
22
 
29
- CI time gets re-argued from impressions. Two mistakes recur:
30
-
31
- - Lane duration alone ≠ wall-clock savings — only finish time relative to the run shows whether trimming it helps.
32
- - Cost and latency are different purchases: state which a change buys, every time.
33
- - Target failure: effort on a lane that does not hold the run open, or a latency change reported as money saved.
23
+ CI time gets re-argued from impressions, and two mistakes recur. First, a lane's duration alone does not equal wall-clock savings: only its finish time relative to the run shows whether trimming it helps. Second, cost and latency are different purchases, so state which one a change buys, every time. The failure this audit targets is effort spent on a lane that does not hold the run open, or a latency change reported as money saved.
34
24
 
35
- **Applies when:** a CI workflow. None → one `N/A` row with evidence, never "clean".
25
+ **Applies when:** the repo has a CI workflow. **If** it has none → write one `N/A` row with its evidence, and never report the surface as "clean".
36
26
 
37
- **Cadence:** quarterly; extra pass when workflow topology changes (new lane, runner class, or cache).
27
+ **Cadence:** Run once a quarter. Run an extra pass when the workflow topology changes (a new lane, runner class or cache).
38
28
 
39
- **Anchor Standards:** record version and date read. Newer version → `Standards` step reads what changed.
29
+ **Anchor Standards:**
40
30
 
41
31
  - DORA software delivery performance: change lead time, deployment frequency, failed-deployment recovery time, change fail rate, and deployment rework rate.
42
- - Host CI metrics (e.g. GitHub Actions usage and performance: job run time, queue time, failure rate). Living docs; record the date read.
43
- - Task-runner remote cache and affected selection (e.g. Turborepo remote caching and `--affected`), at the version in the lockfile.
44
- - Package-manager store cache in CI (e.g. pnpm via `actions/setup-node` `cache: pnpm`), at the pinned setup version.
45
- - Browser-test sharding and report merge (e.g. Playwright sharding and `merge-reports`), at the version in the lockfile.
46
- - Concurrency groups and job timeouts (e.g. GitHub Actions `concurrency` and `timeout-minutes`).
47
- - Runner billing (e.g. GitHub-hosted and larger runners, a remote builder such as Depot, mobile-build credits such as EAS). Record the date read.
32
+ - Host CI metrics (e.g., GitHub Actions usage and performance: job run time, queue time, failure rate). Living docs; record the date read.
33
+ - Task-runner remote cache and affected selection (e.g., Turborepo remote caching and `--affected`), at the version in the lockfile.
34
+ - Package-manager store cache in CI (e.g., pnpm via `actions/setup-node` `cache: pnpm`), at the pinned setup version.
35
+ - Browser-test sharding and report merge (e.g., Playwright sharding and `merge-reports`), at the version in the lockfile.
36
+ - Concurrency groups and job timeouts (e.g., GitHub Actions `concurrency` and `timeout-minutes`).
37
+ - Runner billing (e.g., GitHub-hosted and larger runners, a remote builder such as Depot, mobile-build credits such as EAS). Record the date read.
48
38
  - bkit block of `docs/deployments.md` (bkit version from `.bkit/version`): § Run-level decision matrix; § One run per branch or pull request; § Parallel test lanes (one lane per tier); § turbo `//` over-triggers `web_affected` on docs-only diffs (turbo monorepos); § One CI run per dev commit (release PR mirrors the `dev` push run)
49
39
  - bkit block of `docs/testing.md` (bkit version from `.bkit/version`): § CI verbosity (`[verbose ci]`)
50
40
 
51
41
  ### Scope
52
42
 
53
- - Per-lane duration, queue, finish time, and whether the lane holds the run open.
54
- - Distributions (p50 and p90), not a single run, and job timeouts.
55
- - Change lead time push → green → deployed, split by segment.
56
- - Step timings, cache hit rate, shard balance, per-job setup cost, artifacts — on lanes that matter.
57
- - Every cache: hit or miss, restore time vs cold rebuild, usage vs eviction limit.
58
- - What a change actually runs: path filters and required checks.
59
- - Local gate, timed separately, cache forced off.
60
- - Re-runs, failures that passed later, duplicate runs — as minutes.
61
- - Billable minutes and cost per successful merge; latency or cost on every finding.
43
+ - Measure each lane's duration, queue time and finish time, and whether the lane holds the run open.
44
+ - Report distributions (p50 and p90), not a single run.
45
+ - Check the job timeouts.
46
+ - Measure change lead time from push → green → deployed, split by segment.
47
+ - On the lanes that matter, measure step timings, cache hit rate, shard balance, per-job setup cost and artifacts.
48
+ - Check every cache: hit or miss, restore time against a cold rebuild, and usage against the eviction limit.
49
+ - Check what a change actually runs: path filters and required checks.
50
+ - Time the local gate separately, with the cache forced off.
51
+ - Count re-runs, failures that passed later and duplicate runs, as minutes.
52
+ - Measure billable minutes and the cost per successful merge.
53
+ - State latency or cost on every finding.
62
54
 
63
55
  ### Out of Scope
64
56
 
65
57
  <!-- prettier-ignore -->
66
58
  | Excluded item | Why | Where it belongs |
67
59
  | --- | --- | --- |
68
- | Spend outside CI minutes | Whole bill | `bkit-audit-cost` |
69
- | Which checks should gate | Gate sweep | `bkit-audit-gates` |
70
- | Product request latency | Hot paths | `bkit-audit-app-performance` |
71
- | Why a test flakes, beyond minutes lost | Flake sweep | `bkit-audit-flakes` |
72
- | Changing workflows, runners, or caches | Audit reports only | Plan from this report |
60
+ | Spend outside CI minutes | The cost audit owns the whole bill | `bkit-audit-cost` |
61
+ | Which checks should gate | The gates audit owns it | `bkit-audit-gates` |
62
+ | Product request latency | The performance audit owns hot paths | `bkit-audit-app-performance` |
63
+ | Why a test flakes, beyond minutes lost | The flakes audit owns it | `bkit-audit-flakes` |
64
+ | Changing workflows, runners, or caches | The audit only reports | A plan made from this report |
73
65
 
74
66
  ### Pre-Flight / Dependencies
75
67
 
76
- **Checkpoint:** Check off all core items. Check conditional items only when applicable. Each item: available → tool and version; missing → fallback, gap in `Not Checked`, fix in `Process Improvements`. Unnamed gap reads as passed. never abort for a missing capability.
77
-
78
- **Credentials:** probe direnv before marking a token / env var missing: `direnv exec . sh -c '[ -n "${VAR}" ] && echo set || echo unset'`; `unset` = missing. Run credentialed CLIs as `direnv exec . <cmd>`. No direnv (cloud session) → plain env check. Report names, never values.
79
-
80
68
  #### Core
81
69
 
82
- Always verify.
83
-
84
- - [ ] **Permissions:** Before Step 1 — one cheap read-only call per tool this run uses (every item below, every rule under `Project Instructions` `Permissions`), e.g. `gh run list --limit 1`, one MCP read, one anchor-standard fetch. Blocked / denied (here or in any step) → record call verbatim and narrow allow rule clearing it (e.g. `Bash(gh run list *)`) in `Not Checked`, `Process Improvements`, and `Project Instructions` `Permissions`; run every step the remaining tools allow; work needing blocked call → `Not Checked`. never stop the run for a blocked call; never retry or reword a blocked call to get past it.
85
- - [ ] **CI API:** Steps 2–6, 10–11 — read-only run and job metadata, e.g. `gh run view`, `gh api`. Fallback: workflow files only; timings `Not Checked`.
86
- - [ ] **Workflow Files:** Steps 3, 7–10 — workflows, task graph, cache config readable. Fallback: none; those steps `Not Checked`.
87
- - [ ] **Web:** Step 12 — fetch anchor standards and current runner prices. Fallback: versions and prices unread. never reuse a previous report's prices.
70
+ - [ ] **Permissions:** every blocked call is recorded.
71
+ - [ ] **CI API:** Steps 2-6, 10-11 — read-only run and job metadata (e.g., `gh run view`, `gh api`). Fallback: use the workflow files only, and mark timings `Not Checked`.
72
+ - [ ] **Workflow Files:** Steps 3, 7-10 — readable workflows, task graph and cache config. Fallback: none. Mark those steps `Not Checked`.
73
+ - [ ] **Web:** Step 12 — fetch the anchor standards and the current runner prices. Fallback: record the versions and prices as unread. Never reuse a previous report's prices.
88
74
 
89
75
  #### Conditional
90
76
 
91
- Verify only when applicable.
92
-
93
- - [ ] **Host Metrics:** Host publishes queue time → Step 3 — e.g. Actions performance page. Fallback: queue from timestamps only.
94
- - [ ] **Cache API:** Cache listing exists → Step 7 — e.g. `gh cache list`. Fallback: log lines only; eviction `Not Checked`.
95
- - [ ] **Remote Builders:** Job only waits on external builder → Step 6 — builder API or log, e.g. EAS GraphQL. Fallback: wrapper-job duration only; worker time `Not Checked`.
96
- - [ ] **Local Gate:** Pre-push or local CI command exists → Step 9. Fallback: skip with evidence.
77
+ - [ ] **Host Metrics:** **If** the host publishes queue time → Step 3 — the host's queue figures (e.g., the Actions performance page). Fallback: derive queue time from timestamps only.
78
+ - [ ] **Cache API:** **If** a cache listing exists → Step 7 — the cache list (e.g., `gh cache list`). Fallback: use log lines only, and mark eviction `Not Checked`.
79
+ - [ ] **Remote Builders:** **If** a job only waits on an external builder → Step 6 — the builder API or log (e.g., EAS GraphQL). Fallback: use the wrapper-job duration only, and mark worker time `Not Checked`.
80
+ - [ ] **Local Gate:** **If** a pre-push or local CI command exists → Step 9 — that command. Fallback: skip the step with evidence.
97
81
 
98
82
  ### 🔒 Gate 1: Prerequisites Check
99
83
 
100
- **Checkpoint.** Verify and check `[x]` all applicable boxes above, then continue to `Probe Steps` without asking.
101
-
102
- - [ ] **Gaps named:** every missing item names its fallback and `Not Checked` entry.
103
- - [ ] **Gate 1 - Verified:** All Core items checked. All applicable Conditional items checked.
84
+ - [ ] **Gaps named:** every missing item names its fallback and its `Not Checked` entry.
85
+ - [ ] **Gate 1 — Verified:** every item above, every Core item and every applicable Conditional item is checked.
104
86
 
105
87
  ### Probe Steps
106
88
 
107
- - [ ] **Step 1 — Previous Run:** Audited commit = this report's `bkit:anchor` `baseSha`. Read newest prior report for this slug under `docs/audits/`; its commit = its `bkit:anchor` `baseSha`, else the HEAD its `Previous Run` recorded. Count findings fixed / still open; age of oldest open. Open after 2 runs → re-raise with age. **Done when:** closure rate in `Previous Run`, or run marked baseline.
108
- - [ ] **Step 2 — Reference:** Name reference run ids, event type, date. Push to integration branch vs pull request = different pipelines (some lanes push-only); never compare as one number without saying so. Record green/red per run — red lanes exit early and under-report duration. Runner classes and external queues drift; date matters. **Done when:** `Reference` holds ids, event types, conclusions, date.
109
- - [ ] **Step 3 — Lanes:** Per job: conclusion, duration, start, column for holds-the-run-open (duration alone is not that column). Add queue time — duration start→completion hides runner wait. Queue = run created → job started; with `needs:` subtract upstream finish for runner wait; keep `needs:` wait for Step 5. Cross-check host average queue per job. e.g. GitHub Actions:
89
+ - [ ] **Step 1 — Previous Run:** **Done when:** `Previous Run` holds the closure rate, or the run is marked baseline.
90
+ - [ ] **Step 2 — Reference:** Name the reference run ids, the event type and the date. A push to the integration branch and a pull request are different pipelines (some lanes run on push only), so never compare them as one number without saying so. Record green or red for each run, because red lanes exit early and under-report duration. Runner classes and external queues drift, so the date matters. **Done when:** `Reference` holds the ids, event types, conclusions and date.
91
+ - [ ] **Step 3 — Lanes:** For each job, record the conclusion, duration and start, and a column for whether it holds the run open (duration alone is not that column). Add queue time, because the duration from start to completion hides the runner wait. Queue time = run created → job started. **If** the job has `needs:` → subtract the upstream finish to get the runner wait, and keep the `needs:` wait for Step 5. Cross-check the host's average queue time per job. For example, on GitHub Actions:
110
92
 
111
93
  ```
112
94
  gh run view <id> --json jobs \
@@ -116,47 +98,45 @@ Verify only when applicable.
116
98
  --jq '.jobs[] | "\(.name)\t\(.created_at)\t\(.started_at)"'
117
99
  ```
118
100
 
119
- **Done when:** `Lanes` has duration, queue, finish, holding-the-run-open per job.
101
+ **Done when:** `Lanes` has the duration, queue, finish and holding-the-run-open column for each job.
120
102
 
121
- - [ ] **Step 4 — Distributions:** One run cannot separate regression from noise. Pull ≥20 recent CI workflow runs per event type; keep green and red apart. Report p50 and p90 for total wall clock and critical-path lane finish, per event type. Say how typical Step 2 runs are. Every job timeout ≈1.5× its p99 (in this sample size, slowest run). No timeout → host default (e.g. GitHub Actions 360 minutes) and bills all of it. e.g. `gh api "repos/{owner}/{repo}/actions/workflows/<workflow>/runs?event=push&branch=<branch>&per_page=30"`. **Done when:** p50 and p90 in `Distributions`; each job within timeout rule or finding.
122
- - [ ] **Step 5 — Lead Time:** Lane finish times = one segment. Report DORA change lead time for push to integration branch: push → all lanes green → deployed. Split queue (Step 3), critical-path execution, `needs:` waits, re-run time (Step 10). Name dominating segment — that is the one worth buying down. **Done when:** `Lead Time` names split and dominating segment.
123
- - [ ] **Step 6 — Timings:** Inside lanes that hold the run open or that a proposal would trim: step timings; task-runner cache hit rate (zero cached on a lane that should cache = finding); test counts executed (wall clock per test compares runs better than wall clock alone); remote-builder jobs — record builder queue and build time separately from wrapper; shard balance — slowest/fastest >~1.3× means one shard holds the lane; fixed cost per job (checkout, toolchain setup, install) × parallel jobs (splitting buys wall clock, pays setup again); artifact upload/download time and stored size (large reports every green run cost time and storage). e.g. `gh run view <id> --log --job=<jobId>` and grep cache and executed-count lines. **Done when:** `Timings` holds hit rate, counts, shard ratio or "not sharded", setup cost, artifact size per lane that matters.
124
- - [ ] **Step 7 — Caches:** Every cache, not only task runner. Hit or miss and restore time: package-manager store, framework build cache, browser binaries, native build caches (e.g. Gradle, CocoaPods, hosted mobile builds), image layer caches. Compare restore vs cold install — restore slower than rebuild = finding. Cache usage vs eviction limit — full cache evicts entries that matter. **Done when:** `Caches` row per cache: hit or miss · restore vs cold · over limit, or absent with evidence.
125
- - [ ] **Step 8 — Affected:** Do PR lanes run only what changed (affected graph or path filter)? For docs-only change and one-app-scoped change, read `on:` triggers, `paths` filters, job-level `if:` — which lanes each starts. Where `paths` filter is safe, propose it and say required-check interaction: workflow skipped by path filter leaves required checks pending; job skipped by `if` reports success. **Done when:** `Affected` says what each sample change starts and names any required-check trap.
126
- - [ ] **Step 9 — Local:** Time local gate on whole tree, cache forced off — warm or affected-only numbers are meaningless. Record beside CI critical path. **Done when:** `Local` holds forced whole-tree time, command, whether on critical path.
127
- - [ ] **Step 10 — Reruns:** Red lane costs full re-run. Read concurrency block before counting. If in-progress runs not cancelled on integration branch, fix-and-repush = two complete runs; if cancelled, count cancelled minutes separately from re-runs — neither is zero. Flakiest lane slowest lane compounds wall clock; minutes here, cause → `bkit-audit-flakes`. Over Step 4 window: runs attempt >1; jobs failed then passed same commit, per lane — both → minutes. Also commits under both push and PR; runs completing after newer run started. **Done when:** `Reruns` holds those minutes and what concurrency block does.
128
- - [ ] **Step 11 — Cost:** For Step 4 window: billable minutes per lane × runner class current per-minute price, remote-builder minutes, mobile-build credits — read prices this run. Derive cost per successful merge to integration branch, re-runs included. Spend outside CI minutes → `bkit-audit-cost`. Before recommending runner class change for CPU-bound lane, name one-run experiment on larger/different-architecture runner comparing cost and duration (running it is next step — changes workflow). Every finding states whether it buys latency or cost. **Done when:** `Cost` holds minutes, current prices, cost per merge, experiment name or "none".
129
- - [ ] **Step 12 — Standards:** Confirm current version per anchor standard; read changes since previous report's version. `Standards Coverage`: one row per DORA metric, host performance metric, caching/sharding/concurrency/billing practice in anchor list → checked (name step) / not applicable (why) / finding. Per bkit anchor (doc section, rule, or issue shape): one row → followed (name step or evidence) / not applicable (why) / finding; departure with no recorded reason (e.g. `docs/decisions.jsonl` row, accepted-divergence entry) = finding. Unapplied recommended practice → adopt (propose step) / reject (why) / not applicable. **Done when:** no empty row.
130
- - [ ] **Step 13 — Anything Else:** (a) Everything changed since previous report's commit touching pipeline (workflows and composite actions, jobs and `needs:`, runner classes, task-runner config and cache keys, shard settings, remote-build profiles, local pre-push gate) → one-line verdict each. (b) Bounded ~30 min pass: what senior CI engineer flags that no step asks; read since previous run (incidents, new `docs/failures.jsonl` rows) — what would no step catch? **Done when:** `Beyond the Steps` holds both passes, or `none`. Class seen on 2 runs → propose step in `Process Improvements`.
103
+ - [ ] **Step 4 — Distributions:** One run cannot separate a regression from noise. Pull >=20 recent CI workflow runs per event type, and keep green and red apart. Report p50 and p90 for the total wall clock and for the critical-path lane finish, per event type. Say how typical the Step 2 runs are. Check that every job timeout is about 1.5x its p99 (at this sample size, the slowest run). **If** a job has no timeout → it gets the host default (e.g., GitHub Actions 360 minutes) and bills all of it. For example: `gh api "repos/{owner}/{repo}/actions/workflows/<workflow>/runs?event=push&branch=<branch>&per_page=30"`. **Done when:** `Distributions` holds p50 and p90, and each job meets the timeout rule or is a finding.
104
+ - [ ] **Step 5 — Lead Time:** Lane finish times are one segment. Report DORA change lead time for a push to the integration branch: push → all lanes green → deployed. Split it into queue (Step 3), critical-path execution, `needs:` waits and re-run time (Step 10). Name the dominating segment, because that is the one worth buying down. **Done when:** `Lead Time` names the split and the dominating segment.
105
+ - [ ] **Step 6 — Timings:** Inside the lanes that hold the run open, or that a proposal would trim, record: step timings; the task-runner cache hit rate (zero cached on a lane that should cache is a finding); the test counts executed (wall clock per test compares runs better than wall clock alone); for remote-builder jobs, the builder queue and build time, recorded separately from the wrapper; shard balance (a slowest/fastest ratio above about 1.3x means one shard holds the lane); the fixed cost per job (checkout, toolchain setup, install) x the parallel jobs (splitting buys wall clock, but pays setup again); and artifact upload and download time and stored size (large reports on every green run cost time and storage). For example, run `gh run view <id> --log --job=<jobId>` and grep the cache and executed-count lines. **Done when:** `Timings` holds the hit rate, counts, shard ratio or "not sharded", setup cost and artifact size for each lane that matters.
106
+ - [ ] **Step 7 — Caches:** Check every cache, not only the task runner's. Record hit or miss and the restore time for the package-manager store, the framework build cache, browser binaries, native build caches (e.g., Gradle, CocoaPods, hosted mobile builds) and image layer caches. Compare each restore with a cold install. A restore slower than a rebuild is a finding. Compare cache usage with the eviction limit, because a full cache evicts entries that matter. **Done when:** `Caches` holds one row per cache, with hit or miss, restore against cold, and over limit, or the cache is absent with evidence.
107
+ - [ ] **Step 8 — Affected:** Check whether PR lanes run only what changed (an affected graph or a path filter). For a docs-only change and a change scoped to one app, read the `on:` triggers, `paths` filters and job-level `if:`, and record which lanes each change starts. **If** a `paths` filter is safe → propose it, and state its interaction with required checks: a workflow skipped by a path filter leaves required checks pending, while a job skipped by `if` reports success. **Done when:** `Affected` says what each sample change starts, and names any required-check trap.
108
+ - [ ] **Step 9 — Local:** Time the local gate on the whole tree, with the cache forced off, because warm or affected-only numbers are meaningless. Record it beside the CI critical path. **Done when:** `Local` holds the forced whole-tree time, the command, and whether it is on the critical path.
109
+ - [ ] **Step 10 — Reruns:** A red lane costs a full re-run. Read the concurrency block before counting. **If** in-progress runs are not cancelled on the integration branch → a fix-and-repush costs two complete runs. **If** they are cancelled → count the cancelled minutes separately from re-runs. Neither is zero. **If** the flakiest lane is also the slowest lane → it compounds the wall clock. Count its minutes here, and send the cause to `bkit-audit-flakes`. Over the Step 4 window, count the runs with attempt >1, and the jobs that failed then passed on the same commit, per lane, and record both as minutes. Also count the commits that ran under both push and PR, and the runs that completed after a newer run started. **Done when:** `Reruns` holds those minutes, and what the concurrency block does.
110
+ - [ ] **Step 11 — Cost:** For the Step 4 window, multiply the billable minutes per lane by the runner class's current per-minute price, and record the remote-builder minutes and mobile-build credits. Read the prices during this run. Derive the cost per successful merge to the integration branch, re-runs included. Spend outside CI minutes goes to `bkit-audit-cost`. Before recommending a runner-class change for a CPU-bound lane, name a one-run experiment on a larger or different-architecture runner that compares cost and duration. Name the experiment only, and do not run it in this audit, because running it changes the workflow. Every finding states whether it buys latency or cost. **Done when:** `Cost` holds the minutes, the current prices, the cost per merge, and the experiment name or "none".
111
+ - [ ] **Step 12 — Standards:** Confirm the current version of each anchor standard, and read what changed since the previous report's version. Give `Standards Coverage` one row per DORA metric, per host performance metric, and per caching, sharding, concurrency or billing practice in the anchor list, each marked checked (naming the step), not applicable (saying why) or finding. Give each bkit anchor (a doc section, rule or issue shape) one row, marked followed (with the step or evidence), not applicable (saying why) or finding. A departure with no recorded reason (e.g., a `docs/decisions.jsonl` row or an accepted-divergence entry) is a finding. Mark each recommended practice the project does not apply as adopt (with a proposed step), reject (saying why) or not applicable. **Done when:** no row is empty.
112
+ - [ ] **Step 13 — Anything Else:** (a) Give a one-line verdict on each change since the previous report's commit that touches the pipeline: workflows and composite actions, jobs and `needs:`, runner classes, task-runner config and cache keys, shard settings, remote-build profiles, and the local pre-push gate. (b) In a bounded pass of about 30 minutes, note what a senior CI engineer would flag that no step asks about. Read what happened since the previous run (incidents, new `docs/failures.jsonl` rows), and ask what no step would catch. **Done when:** `Beyond the Steps` holds both passes, or says `none`. **If** one class of issue is seen on 2 runs → propose a step for it in `Process Improvements`.
131
113
 
132
114
  ### 🔒 Gate 2: Probes Check
133
115
 
134
- **Checkpoint.** Verify and check `[x]` all boxes below, then continue to `Findings` without asking.
135
-
136
- - [ ] **Steps complete:** every step `[x]`, or explicit skip with evidence the surface is absent.
137
- - [ ] **Evidence:** every finding cites re-checkable evidence and the tool behind it.
116
+ - [ ] **Steps complete:** every step is `[x]`, or skipped with evidence that its surface is absent.
117
+ - [ ] **Evidence:** every finding cites evidence someone can check again, and the tool that produced it.
138
118
  - [ ] **Event types:** push and pull request are never treated as one pipeline.
139
- - [ ] **Prices current:** every rate was read this run, not copied from a prior report.
140
- - [ ] **Gate 2 - Verified:** Every checkbox above independently verified and checked off.
119
+ - [ ] **Prices current:** every rate was read this run, not copied from a previous report.
120
+ - [ ] **Gate 2 — Verified:** every item above holds.
141
121
 
142
122
  ## Findings
143
123
 
144
124
  <!-- prettier-ignore -->
145
125
  | Severity | Use |
146
126
  | --- | --- |
147
- | `CRITICAL` | No green path through the pipeline; a job with no timeout can bill the host maximum on every run |
148
- | `HIGH` | The dominating segment is the one a proposal would not touch; latency described as cost savings, or the reverse, on that segment |
149
- | `MEDIUM` | Cache miss on a lane that should cache; shard imbalance holding a lane open; setup cost paid again on every split; re-run minutes that rival the critical path |
150
- | `LOW` | A slow lane that does not hold the run open; artifact size that is not on the critical path |
127
+ | `CRITICAL` | There is no green path through the pipeline. A job with no timeout can bill the host maximum on every run |
128
+ | `HIGH` | The dominating segment is the one a proposal would not touch. Latency is described as cost savings, or the reverse, on that segment |
129
+ | `MEDIUM` | A cache miss on a lane that should cache. Shard imbalance that holds a lane open. Setup cost paid again on every split. Re-run minutes that rival the critical path |
130
+ | `LOW` | A slow lane that does not hold the run open. Artifact size that is not on the critical path |
151
131
 
152
- Scale per `.bkit/jsonl.md` § Severity. Within a severity: critical path first. Every finding states whether it buys latency or cost.
132
+ Within a severity, list critical-path findings first. Every finding states whether it buys latency or cost.
153
133
 
154
134
  <!-- prettier-ignore -->
155
135
  | ID | Severity | Location | Evidence | Expected |
156
136
  | --- | --- | --- | --- | --- |
157
137
  | PENDING | PENDING | PENDING | PENDING | PENDING |
158
138
 
159
- Empty and clean → one row `None`.
139
+ **If** the run finds nothing → write one row: `None`.
160
140
 
161
141
  ## Report
162
142
 
@@ -237,17 +217,16 @@ PENDING
237
217
 
238
218
  ### 🔒 Gate 3: Report Check
239
219
 
240
- **Checkpoint.** Verify and check `[x]` all boxes below, then stop.
241
-
242
- - [ ] **No placeholders:** Findings table and every `Report` section have no `PENDING`.
243
- - [ ] **Summary:** names count per severity and the segment that dominates wall clock.
244
- - [ ] **Series:** every series beside previous report's numbers, or marked baseline.
245
- - [ ] **Writes:** only this report and template `Project Instructions` changed; throwaway worktrees / remote targets removed.
246
- - [ ] **Process Improvements:** `Universal` = proposed step changes, template untouched; `Project` = edits applied below `bkit:end`; each `none` if empty.
247
- - [ ] **Suggested Issues:** every `MEDIUM`+ finding ID in exactly one row; every row has a `Next Step`.
248
- - [ ] **Gate 3 - Verified:** Every checkbox above independently verified and checked off.
249
-
250
- > `Project Instructions` below `bkit:end` are consumer-owned — `bkit install` never overwrites them, `bkit check` drift stays clean. Add project-specific tools, paths, commands, and checks there, keyed by section or step title; never results.
220
+ - [ ] **No placeholders:** no `PENDING` is left.
221
+ - [ ] **Summary:** `Summary` gives the count per severity.
222
+ - [ ] **Dominant segment:** `Summary` names the segment that dominates wall clock.
223
+ - [ ] **Series:** the report shows every series beside the previous report's numbers, or marks the run as baseline.
224
+ - [ ] **Writes:** this run changed only this report, the template's `Project Instructions` and its own `docs/failures.jsonl` rows.
225
+ - [ ] **Throwaways removed:** every throwaway worktree or remote target is removed.
226
+ - [ ] **Process Improvements:** `Universal` and `Project` are both filled.
227
+ - [ ] **Suggested Issues:** every `MEDIUM`+ finding ID is in exactly one `Suggested Issues` row.
228
+ - [ ] **Next Step:** every `Suggested Issues` row has a `Next Step`.
229
+ - [ ] **Gate 3 — Verified:** every item above holds.
251
230
 
252
231
  <!-- bkit:end -->
253
232