@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,173 +1,174 @@
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
  # App Performance Audit
8
8
 
9
9
  > [!CAUTION]
10
- > **Purpose:** Reproducible field, lab, and source baseline of web, native, and server performance, judged against published thresholds and budgets.
10
+ > **Purpose:** Reproducible field, lab and source baseline of web, native and server performance, judged against published thresholds and budgets.
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 change sampling rates, dashboards, or project settings to take a measurement; a gap = finding.
23
- > - Every figure names environment, window, percentile, and `n`.
14
+ > - Do not change sampling rates, dashboards or project settings to take a measurement.
15
+ > - Record a measurement gap as a finding.
16
+ > - Name the environment, window, percentile and `n` for every figure.
24
17
 
25
18
  ## Universal Instructions
26
19
 
27
20
  ### Context & Goals
28
21
 
29
- Performance numbers only matter beside the prior number, same method; unfixed method → worthless delta. Target failure: **baseline measures instrument or harness, not app** — e.g. field data all CI / preview (cold functions, no warm cache, no CDN, robot browser: waterfall shape transfers, absolute times do not); preview overlay adding seconds per pageload; vital never collected reading fine. Fix measurement before measuring; instrument findings outrank app findings.
22
+ A performance number only matters beside the previous number, taken the same way. **If** the method is not fixed → the delta is worthless. The failure this audit targets is a baseline that measures the instrument or the harness instead of the app. Examples: field data that comes only from CI or previews (cold functions, no warm cache, no CDN, a robot browser), where the waterfall shape transfers but the absolute times do not; a preview overlay that adds seconds to each page load; or a vital that was never collected and so reads as fine. Fix the measurement before measuring. Findings about the instrument outrank findings about the app.
30
23
 
31
- **Applies when:** web app, native app, or server answering user requests. None → one `N/A` row with evidence, never "clean".
24
+ **Applies when:** there is a web app, a native app or a server answering user requests. **If** there is none → write one `N/A` row with its evidence, and never report the surface as "clean".
32
25
 
33
- **Cadence:** quarterly. Extra pass when production first gets real traffic, after instrument fixes (`Re-baseline`), or network-shape change (region pin, prefetch policy, server-data seeding). Changed sampling, dashboards, window, or percentile → new baseline; run one then.
26
+ **Cadence:** Run once a quarter. Run an extra pass when production first gets real traffic, after instrument fixes (`Re-baseline`), and after a change to the network shape (region pin, prefetch policy, server-data seeding). A change to sampling, dashboards, the window or the percentile starts a new baseline, so run one then.
34
27
 
35
- **Anchor Standards:** record version and date read. Newer version → `Standards` step reads what changed.
28
+ **Anchor Standards:**
36
29
 
37
- - Core Web Vitals (LCP, INP, CLS at p75, mobile, and desktop apart) and supporting FCP, TTFB (e.g. web.dev); check its changelog.
38
- - Field dataset (e.g. Chrome UX Report, PageSpeed Insights).
39
- - Lab method (e.g. Lighthouse, WebPageTest); record tool version.
30
+ - Core Web Vitals (LCP, INP, CLS at p75, mobile, and desktop apart) and supporting FCP, TTFB (e.g., web.dev). Check its changelog.
31
+ - Field dataset (e.g., Chrome UX Report, PageSpeed Insights).
32
+ - Lab method (e.g., Lighthouse, WebPageTest). Record the tool version.
40
33
  - Long Animation Frames API.
41
- - Soft Navigations API; record browser version shipping it by default.
42
- - Framework production checklist, edition = version the app runs (e.g. Next.js, Nuxt).
43
- - Platform native vitals (e.g. Android vitals, Xcode Organizer metrics).
44
- - Monitoring vendor's mobile vitals docs (e.g. Sentry Mobile Vitals, Datadog RUM mobile).
34
+ - Soft Navigations API. Record the browser version that ships it by default.
35
+ - Framework production checklist, in the edition for the version the app runs (e.g., Next.js, Nuxt).
36
+ - Platform native vitals (e.g., Android vitals, Xcode Organizer metrics).
37
+ - Monitoring vendor's mobile vitals docs (e.g., Sentry Mobile Vitals, Datadog RUM mobile).
45
38
 
46
39
  ### Scope
47
40
 
48
- - Instrument health: collected metrics, sample sizes, environment split, pollution.
49
- - Field and lab baselines per web route, native screen, and client-side navigation; production field data.
50
- - Store and device native vitals; budgets.
51
- - Waterfalls and static causes: bundle, media, render-blocking, start-up, rendering / caching, third parties, back/forward cache, prefetch, native size.
52
- - Slow interactions; async user-facing pipelines; server, DB, background-job, and LLM latency; long sessions.
53
- - Follow-ups closed since previous report.
41
+ - Check instrument health: which metrics are collected, sample sizes, the environment split and pollution.
42
+ - Take field and lab baselines per web route, native screen and client-side navigation, and read production field data.
43
+ - Read store and device native vitals.
44
+ - Compare results with budgets.
45
+ - Read waterfalls, and find static causes: bundle, media, render-blocking, start-up, rendering and caching, third parties, back/forward cache, prefetch and native size.
46
+ - Find slow interactions.
47
+ - Measure async user-facing pipelines.
48
+ - Measure server, DB, background-job and LLM latency.
49
+ - Check long sessions.
50
+ - Sort the follow-ups closed since the previous report.
54
51
 
55
52
  ### Out of Scope
56
53
 
57
54
  <!-- prettier-ignore -->
58
55
  | Excluded item | Why | Where it belongs |
59
56
  | --- | --- | --- |
60
- | Crawling, metadata, structured data | Search sweep; page speed stays here | `bkit-audit-aio-seo` |
61
- | Query plans, indexes, vacuum, pool sizing | Database sweep | `bkit-audit-database` |
62
- | Prompt quality | Prompt sweep; latency stays here | `bkit-audit-prompts` |
63
- | Model choice | Model sweep; latency stays here | `bkit-audit-models` |
64
- | LLM spend | Cost sweep; latency stays here | `bkit-audit-cost` |
65
- | Third-party tag payloads, consent | Tracking sweep; main-thread cost stays here | `bkit-audit-analytics` |
66
- | Module structure, coupling | Architecture sweep; method reused here | `bkit-audit-architecture` |
67
- | CI pipeline duration | CI sweep | `bkit-audit-ci-performance` |
68
- | Applying fixes / changing sampling or dashboards | Audit reports only | Plan from this report |
57
+ | Crawling, metadata, structured data | The search sweep owns them; page speed stays here | `bkit-audit-aio-seo` |
58
+ | Query plans, indexes, vacuum, pool sizing | The database sweep owns them | `bkit-audit-database` |
59
+ | Prompt quality | The prompt sweep owns it; latency stays here | `bkit-audit-prompts` |
60
+ | Model choice | The model sweep owns it; latency stays here | `bkit-audit-models` |
61
+ | LLM spend | The cost sweep owns it; latency stays here | `bkit-audit-cost` |
62
+ | Third-party tag payloads, consent | The tracking sweep owns them; main-thread cost stays here | `bkit-audit-analytics` |
63
+ | Module structure, coupling | The architecture sweep owns them; its method is reused here | `bkit-audit-architecture` |
64
+ | CI pipeline duration | The CI sweep owns it | `bkit-audit-ci-performance` |
65
+ | Applying fixes; changing sampling or dashboards | The audit only reports | A plan made from this report |
69
66
 
70
67
  ### Pre-Flight / Dependencies
71
68
 
72
- **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.
73
-
74
- **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.
75
-
76
69
  #### Core
77
70
 
78
- Always verify.
79
-
80
- - [ ] **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.
81
- - [ ] **Monitoring:** Steps 2–4, 6, 9, 11–13, 15 — field traces, vitals, spans per environment, e.g. Sentry, Datadog RUM, New Relic. Fallback: lab and static only; field rows `Not Checked`.
82
- - [ ] **Build Output:** Steps 8, 10 — production build with per-route size and render mode, e.g. `next build`, `vite build` with bundle analyser. Fallback: source read only; sizes `Not Checked`.
83
- - [ ] **Web:** Steps 4, 17 — fetch anchor standards and published thresholds. Fallback: versions and thresholds recorded as unread.
71
+ - [ ] **Permissions:** every blocked call is recorded.
72
+ - [ ] **Monitoring:** Steps 2-4, 6, 9, 11-13, 15 — field traces, vitals and spans per environment (e.g., Sentry, Datadog RUM, New Relic). Fallback: lab and static only, with field rows `Not Checked`.
73
+ - [ ] **Build Output:** Steps 8, 10 — a production build with per-route size and render mode (e.g., `next build`, `vite build` with a bundle analyser). Fallback: read the source only, and mark sizes `Not Checked`.
74
+ - [ ] **Web:** Steps 4, 17 — fetch the anchor standards and published thresholds. Fallback: record the versions and thresholds as unread.
84
75
 
85
76
  #### Conditional
86
77
 
87
- Verify only when applicable.
88
-
89
- - [ ] **Lab Runner:** Deployed web app → Steps 5, 10 — e.g. Lighthouse CI, WebPageTest; record version and profile. Fallback: none; `Lab Baseline` `Not Checked`.
90
- - [ ] **Browser DevTools:** Web app → Steps 10, 11, 14 — back/forward cache, Long Animation Frames, heap snapshots, e.g. Chrome DevTools, Playwright over CDP. Fallback: those rows `Not Checked`.
91
- - [ ] **Field Dataset:** Production origin with traffic → Step 6 — e.g. CrUX via PageSpeed Insights, search console Core Web Vitals report. Fallback: monitoring production rows only.
92
- - [ ] **Store Consoles:** Published native app → Step 7 — e.g. Play Console Android vitals, Xcode Organizer, App Store Connect sizes. Fallback: `not published`, or `Not Checked`.
93
- - [ ] **Low-End Device:** Native app → Step 7 — physical low-end device per platform shipped (e.g. budget Android, oldest supported iPhone). Fallback: none; device rows `Not Checked`.
94
- - [ ] **Language Server:** Typed language → Step 9 — references, e.g. Serena, `tsserver`, `pyright`. Fallback: text search only; name it per finding.
95
- - [ ] **Code Graph:** Structural questions → Steps 9, 10 — module fan-out and cold-start graph, method per `bkit-audit-architecture`. Fallback: language server and text search; local-only tool missing in cloud → say so.
96
- - [ ] **Platform Settings:** Hosted platform → Steps 3, 10 — preview overlays, region, CDN cache hit ratio, e.g. Vercel, Netlify, Cloudflare dashboard / API. Fallback: response headers only; settings `Not Checked`.
97
- - [ ] **DB Statistics:** Hosted DB → Step 13 — e.g. `pg_stat_statements`, platform performance advisor. Fallback: monitoring spans only.
98
- - [ ] **Job Runner:** Background jobs → Steps 12, 13 — run timings and queue lag, e.g. Inngest, Temporal, Sidekiq. Fallback: monitoring spans only.
99
- - [ ] **Tracker:** Follow-ups from previous reports → Step 16 — via tracker MCP, e.g. GitHub MCP, Linear MCP, Jira MCP; `gh` only as fallback. Fallback: `Closed Follow-Ups` `Not Checked`.
78
+ - [ ] **Lab Runner:** **If** a web app is deployed → Steps 5, 10 (e.g., Lighthouse CI, WebPageTest). Record its version and profile. Fallback: none. Mark `Lab Baseline` `Not Checked`.
79
+ - [ ] **Browser DevTools:** **If** there is a web app → Steps 10, 11, 14 — back/forward cache, Long Animation Frames and heap snapshots (e.g., Chrome DevTools, Playwright over CDP). Fallback: mark those rows `Not Checked`.
80
+ - [ ] **Field Dataset:** **If** a production origin has traffic → Step 6 (e.g., CrUX via PageSpeed Insights, the search console Core Web Vitals report). Fallback: use the monitoring production rows only.
81
+ - [ ] **Store Consoles:** **If** a native app is published → Step 7 (e.g., Play Console Android vitals, Xcode Organizer, App Store Connect sizes). Fallback: `not published`, or `Not Checked`.
82
+ - [ ] **Low-End Device:** **If** there is a native app → Step 7 — a physical low-end device for each platform shipped (e.g., a budget Android, the oldest supported iPhone). Fallback: none. Mark the device rows `Not Checked`.
83
+ - [ ] **Language Server:** **If** the language is typed → Step 9 — references (e.g., Serena, `tsserver`, `pyright`). Fallback: text search only, named on each finding.
84
+ - [ ] **Code Graph:** **If** there are structural questions → Steps 9, 10 — module fan-out and the cold-start graph, using `bkit-audit-architecture`'s method. Fallback: language server and text search. **If** a local-only tool is missing in the cloud → say so.
85
+ - [ ] **Platform Settings:** **If** the app runs on a hosted platform → Steps 3, 10 — preview overlays, region and CDN cache hit ratio (e.g., Vercel, Netlify, Cloudflare dashboard or API). Fallback: read response headers only, and mark settings `Not Checked`.
86
+ - [ ] **DB Statistics:** **If** the DB is hosted → Step 13 (e.g., `pg_stat_statements`, the platform's performance advisor). Fallback: monitoring spans only.
87
+ - [ ] **Job Runner:** **If** there are background jobs → Steps 12, 13 — run timings and queue lag (e.g., Inngest, Temporal, Sidekiq). Fallback: monitoring spans only.
88
+ - [ ] **Tracker:** **If** previous reports raised follow-ups → Step 16 — read them through the tracker MCP (e.g., GitHub MCP, Linear MCP, Jira MCP), with `gh` only as a fallback. Fallback: mark `Closed Follow-Ups` `Not Checked`.
100
89
 
101
90
  ### 🔒 Gate 1: Prerequisites Check
102
91
 
103
- **Checkpoint.** Verify and check `[x]` all applicable boxes above, then continue to `Probe Steps` without asking.
104
-
105
- - [ ] **Gaps named:** every missing item names its fallback and `Not Checked` entry.
106
- - [ ] **Gate 1 - Verified:** All Core items checked. All applicable Conditional items checked.
92
+ - [ ] **Gaps named:** every missing item names its fallback and its `Not Checked` entry.
93
+ - [ ] **Gate 1 — Verified:** every item above, every Core item and every applicable Conditional item is checked.
107
94
 
108
95
  ### Probe Steps
109
96
 
110
- - [ ] **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.
111
- - [ ] **Step 2 — Measurement Basis:** Record dashboards (IDs, owned vs vendor-prebuilt — prebuilt = not editable), exact query per table; window, percentile, `n` per row; environment split plain, production count even when 0; one linked reference trace. Window or percentile ≠ previous report → new baseline, not comparison. **Done when:** all in `Measurement Basis`.
112
- - [ ] **Step 3 — Instrument:** Confirm before trusting; state each result — missing metric reads fine otherwise. Preview deploys (if any) with injected overlays (e.g. toolbars, comment widgets) → off at project level, else pageloads carry their requests. Every vital collected (INP `null` every route = gap). Native screen transactions and frame tracking; warm start slower than cold = untrustworthy dataset. `n` per row large enough (few hundred events on one transaction ≠ baseline). Client-side navigations measured: navigation transactions, LCP / INP after soft navigation. Fallback / degraded-path rate measured, or named blind spot. Field data CI / preview only → shape transfers, absolute times do not; say so. Each failure = finding, outranks app — until instrument honest, no fix provable. **Done when:** `Instrument` line per check.
113
- - [ ] **Step 4 — Field Baseline:** One table per surface, p75, ordered by load count. Web per route: LCP, INP, CLS, FCP, TTFB. Native per screen: cold / warm start, time to initial / full display, slow / frozen frames. Uncollected → `not collected`, never blank. Verdict per p75 good / needs improvement / poor vs source thresholds; mobile and desktop split; read thresholds each run, never memory; write in table header. Plus navigation table: navigation transactions per route; LCP / INP after soft navigation where reported. **Done when:** every row has verdict or `not collected` in `Field Baseline`.
114
- - [ ] **Step 5 — Lab Baseline:** Field data CI / preview → lab = reproducible number. Lab runner on production, never preview, on `Field Baseline` web routes: fixed throttling (mid-tier mobile, slow 4G), 5 runs per route, median. Record tool version and profile; change to either → new series. Lab cannot measure INP → Total Blocking Time stand-in. Keep third-party summary for `Static`. **Done when:** series per route in `Lab Baseline`.
115
- - [ ] **Step 6 — Production:** Production users → their numbers count. Production sampling ~1,000 events per route per window; record production `n` per route. Field dataset (e.g. CrUX via PageSpeed Insights) for production origin once qualified; search console Core Web Vitals report (shared with `bkit-audit-aio-seo`). No production traffic → `no production traffic`, never omit. **Done when:** `Production` holds `n` per route and field-dataset rows, or `no production traffic`.
116
- - [ ] **Step 7 — Native Vitals:** Native app → read beyond monitoring SDK. Android store vitals: slow cold / warm starts, slow / frozen frames, ANR rate, excessive partial wake locks (store visibility). iOS organizer: launch time, hang rate, energy. Low-end device: memory over primary flow; OTA update layer on cold start, if shipped (e.g. `expo-updates`, CodePush). Not in stores → `not published` for store rows. **Done when:** `Native Vitals` row per metric, or `not published`.
117
- - [ ] **Step 8 — Budgets:** Delta vs previous says moved, not good enough → report delta vs budget: per-route shipped client code (e.g. first-load JS, gzipped), LCP and INP targets per route, native bundle / binary size, bundle size cap. Unset budget → propose from this run; owner decides. **Done when:** `Budgets` row per budget: target · actual · delta, or proposed target.
118
- - [ ] **Step 9 — Waterfall:** Table says slow route; trace says why. Per worst route open reference trace; count: round trips, sequential vs concurrent (concurrent in codebase = model to copy); pageload requests for data one interaction needs; duplicate work (e.g. two nav components each prefetching every route); fixed floor under every call (primary-key lookup same cost as token validation = network toll, not slow query). Resolve where DB and functions run before query rewrite — region pin beats every rewrite. Several findings, one toll → one finding (six sequential calls, one toll ≠ six fixes). Language-server references on hook / fetcher → one call site or many; on shared client / helper → what else pays toll. Pace queries — back-to-back collapse to partial results, under-count shrinks blast radius; re-run small caller sets; config / JSON wiring = text search. Structural questions (hub module, cold-start graph) → code graph. Each finding carries explanation or links the one that has it. **Done when:** `Waterfall` row per worst route: round trips · shape · tolls · call sites · merged findings.
119
- - [ ] **Step 10 — Static:** Baseline covers routes with traffic and collected metrics; source shows causes before run. Each item only where its surface (web, server, native) exists and the stack has the mechanism; else `N/A` with evidence:
120
- - Client bundle: size per route from build output; heavy deps in client-side code (e.g. React client components); barrel imports dragging whole package. Record as series.
121
- - Media: missing width / height (CLS), no lazy below fold, no responsive sizes.
97
+ - [ ] **Step 1 — Previous Run:** **Done when:** `Previous Run` holds the closure rate, or the run is marked baseline.
98
+ - [ ] **Step 2 — Measurement Basis:** Record the dashboards (their IDs, and whether each is owned or vendor-prebuilt; a prebuilt one cannot be edited) and the exact query behind each table. Record the window, percentile and `n` for each row. Split environments plainly, and give the production count even when it is 0. Link one reference trace. **If** the window or percentile differs from the previous report → this is a new baseline, not a comparison. **Done when:** `Measurement Basis` holds all of these.
99
+ - [ ] **Step 3 — Instrument:** Confirm each of these before trusting the numbers, and state each result, because a missing metric otherwise reads as fine. **If** preview deploys exist with injected overlays (e.g., toolbars, comment widgets) → check that they are off at the project level, or page loads carry their requests. Check that every vital is collected (INP `null` on every route is a gap). Check native screen transactions and frame tracking. **If** warm start is slower than cold start → the dataset cannot be trusted. Check that `n` per row is large enough (a few hundred events on one transaction is not a baseline). Check that client-side navigations are measured: navigation transactions, and LCP and INP after a soft navigation. Check that the fallback or degraded-path rate is measured, or name it as a blind spot. **If** field data comes only from CI or previews → say that the shape transfers, and the absolute times do not. Each failure here is a finding, and outranks app findings, because no fix can be proven until the instrument is honest. **Done when:** `Instrument` holds one line per check.
100
+ - [ ] **Step 4 — Field Baseline:** Build one table per surface, at p75, ordered by load count. For web, per route: LCP, INP, CLS, FCP and TTFB. For native, per screen: cold and warm start, time to initial and full display, and slow and frozen frames. Write `not collected` for an uncollected metric, never a blank. Give each p75 a verdict of good / needs improvement / poor against the source's thresholds, with mobile and desktop split. Read the thresholds on each run, never from memory, and write them in the table header. Add a navigation table: navigation transactions per route, and LCP and INP after soft navigation where reported. **Done when:** every row in `Field Baseline` has a verdict or `not collected`.
101
+ - [ ] **Step 5 — Lab Baseline:** **If** field data comes from CI or previews → the lab gives the reproducible number. Run the lab runner on production, never a preview, on the `Field Baseline` web routes, with fixed throttling (mid-tier mobile, slow 4G), 5 runs per route, and take the median. Record the tool version and profile. A change to either starts a new series. The lab cannot measure INP, so use Total Blocking Time as the stand-in. Keep the third-party summary for `Static`. **Done when:** `Lab Baseline` holds a series per route.
102
+ - [ ] **Step 6 — Production:** **If** there are production users → their numbers are the ones that count. Check that production sampling gives about 1,000 events per route per window, and record the production `n` per route. Read the field dataset (e.g., CrUX via PageSpeed Insights) for the production origin once it qualifies, and the search console Core Web Vitals report (shared with `bkit-audit-aio-seo`). **If** there is no production traffic → write `no production traffic`, and never omit the section. **Done when:** `Production` holds `n` per route and the field-dataset rows, or `no production traffic`.
103
+ - [ ] **Step 7 — Native Vitals:** Run this step only when the project has a native app, and read beyond the monitoring SDK. Android store vitals: slow cold and warm starts, slow and frozen frames, ANR rate and excessive partial wake locks (which affect store visibility). iOS Organizer: launch time, hang rate and energy. On a low-end device, read memory across the primary flow. **If** an over-the-air update layer ships (e.g., `expo-updates`, CodePush) → measure its cost on cold start on the same low-end device. **If** the app is not in the stores → write `not published` for the store rows. **Done when:** `Native Vitals` holds one row per metric, or `not published`.
104
+ - [ ] **Step 8 — Budgets:** A delta against the previous run says the number moved, not that it is good enough, so report each delta against a budget: shipped client code per route (e.g., first-load JS, gzipped), LCP and INP targets per route, native bundle or binary size, and a bundle size cap. **If** a budget is not set → propose one from this run, and let the owner decide. **Done when:** `Budgets` holds one row per budget: target · actual · delta, or a proposed target.
105
+ - [ ] **Step 9 — Waterfall:** The table says which route is slow; the trace says why.
106
+ - For each worst route, open its reference trace and count:
107
+ - round trips
108
+ - sequential vs concurrent calls (concurrent code already in the codebase is the model to copy)
109
+ - page-load requests for data that only one interaction needs
110
+ - duplicate work (e.g., two navigation components each prefetching every route)
111
+ - a fixed floor under every call (a primary-key lookup costing the same as token validation is a network toll, not a slow query)
112
+ - Find where the DB and the functions run before rewriting any query, because a region pin beats every rewrite.
113
+ - **If** several findings share one toll → merge them into one finding (six sequential calls paying one toll is one fix, not six).
114
+ - Use language-server references on the hook or fetcher to see whether there is one call site or many, and on the shared client or helper to see what else pays the toll.
115
+ - Pace the queries: back-to-back queries collapse to partial results, and the under-count shrinks the blast radius, so re-run small caller sets.
116
+ - Use text search for config and JSON wiring.
117
+ - Use the code graph for structural questions (hub module, cold-start graph).
118
+ - Each finding carries its explanation, or links the finding that has it.
119
+
120
+ **Done when:** `Waterfall` holds one row per worst route: round trips · shape · tolls · call sites · merged findings.
121
+
122
+ - [ ] **Step 10 — Static:** The baseline covers routes with traffic and collected metrics; the source shows causes before they run. **If** an item's surface is absent **or** the stack lacks its mechanism → write `N/A` for that item, with evidence. Check each item below where its surface (web, server, native) exists and the stack has the mechanism:
123
+ - Client bundle: size per route from the build output; heavy dependencies in client-side code (e.g., React client components); barrel imports that drag in a whole package. Record it as a series.
124
+ - Media: missing width and height (CLS), no lazy loading below the fold, no responsive sizes.
122
125
  - Render-blocking: synchronous third-party scripts; font loading.
123
- - Server start-up: heavy top-level imports in route handlers / workers where lazy import keeps cold start off; intended cold-start splits not undone; code-graph fan-out finds candidates.
124
- - Request-path blocking: synchronous file / crypto work; sequential awaits that could run concurrently.
125
- - Native entry: top-level imports every cold start pays.
126
- - Rendering / caching per route: rendering mode from build output, where the framework has one (e.g. Next.js static / dynamic / partially prerendered); unexpected dynamic (e.g. cookies / headers in layout); `Cache-Control`; CDN cache hit ratio; server-rendered payload on heaviest routes (e.g. React server-component payload).
127
- - Third-party scripts: main-thread time and transfer per third party from `Lab Baseline` summary; each loads after interactive or later (e.g. `next/script` `afterInteractive`, Nuxt Scripts).
128
- - Back/forward cache: main routes eligible (DevTools); `Cache-Control: no-store` on HTML, `unload` handlers, or open connections → full reload on back / forward.
129
- - Prefetch: what each route prefetches (link prefetch, Speculation Rules) and usage.
130
- - Native size: bytecode bundle (e.g. Hermes), store download / install size, long lists virtualised.
131
-
132
- Risk signals, not measurements; confirm fixes with `Re-baseline`, not re-reading code. **Done when:** `Static` row per item; bundle series recorded.
133
-
134
- - [ ] **Step 11 — Interactions:** Per route with INP: slowest interactions — Long Animation Frames attribution to script source, forced layout, hydration. Name worst (drag, popover open, picker, form submit). **Done when:** `Interactions` row per route: interaction · duration · attributed cause.
135
- - [ ] **Step 12 — Async Paths:** Async user-facing pipelines → slowest path often absent from web vitals (e.g. inbound message → parsed → model extraction → visible → reply sent). Measure end to end, p50 / p95 per stage, from job-runner timings and monitoring spans; name longest stage. **Done when:** `Async Paths` stage table per pipeline, or none recorded.
136
- - [ ] **Step 13 — Server Latency:** `Waterfall` only traced routes → read app-wide: p75 / p95 per server endpoint (e.g. server action, route handler, controller action, DB RPC) from spans; slow queries from DB statistics and platform advisor; background-job step durations and queue lag; LLM calls per model and call site — time to first token, total duration, timeouts, retries, user-facing calls stream or not. **Done when:** `Server Latency` tables per source.
137
- - [ ] **Step 14 — Long Sessions:** Screens open hours (calendar, dashboard) → open each 30 min, heap snapshots; record memory growth, realtime subscription count, polling intervals. **Done when:** `Long Sessions` row per screen.
138
- - [ ] **Step 15 — Re-baseline:** Instrument fixes since previous report → pre-fix baseline not reference; re-take `Field Baseline` and `Lab Baseline`; mark figures moved by instrument change, not app. **Done when:** moves marked in `Field Baseline`, or no instrument fix since previous report recorded.
139
- - [ ] **Step 16 — Closed Follow-Ups:** Follow-ups from previous reports close with decisions only in threads. Read each closed since previous report; sort: A = not done, blocked on owner → named action and blocker; B = deliberately dropped, reasoning holds → recorded so nobody reopens; C = real work nobody owns → new tracker item or named home in scheduled work. Neither tracker nor scheduled work → `docs/deferrals.jsonl` row named. Comment on closed item ≠ register. **Done when:** `Closed Follow-Ups` row per item: group · destination.
140
- - [ ] **Step 17 — Standards:** Confirm current version per anchor standard; read changes since previous report's version. `Standards Coverage`: one row per Core Web Vital and supporting web metric (LCP, INP, CLS, FCP, TTFB), Android vital, iOS organizer metric, framework production-checklist item → checked (name step) / not applicable (why) / finding. Unapplied recommended practice → adopt (propose step) / reject (why) / not applicable. **Done when:** no empty row.
141
- - [ ] **Step 18 — Anything Else:** (a) Everything changed since previous report's commit touching performance (routes and layouts, client-side code and dependencies, third-party scripts, server endpoints, DB queries and RPCs, background jobs, LLM call sites, region, and caching config, monitoring sampling, native app entry) → one-line verdict each. (b) Bounded ~30 min pass: what a senior performance 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`.
126
+ - Server start-up: heavy top-level imports in route handlers or workers, where a lazy import would keep them off the cold start; intended cold-start splits that were undone. Code-graph fan-out finds candidates.
127
+ - Request-path blocking: synchronous file or crypto work; sequential awaits that could run concurrently.
128
+ - Native entry: top-level imports that every cold start pays for.
129
+ - Rendering and caching per route: the rendering mode from the build output, where the framework has one (e.g., Next.js static / dynamic / partially prerendered); unexpected dynamic rendering (e.g., cookies or headers read in a layout); `Cache-Control`; the CDN cache hit ratio; the server-rendered payload on the heaviest routes (e.g., the React server-component payload).
130
+ - Third-party scripts: main-thread time and transfer per third party, from the `Lab Baseline` summary. Check that each loads after the page is interactive or later (e.g., `next/script` `afterInteractive`, Nuxt Scripts).
131
+ - Back/forward cache: check that the main routes are eligible (DevTools). `Cache-Control: no-store` on HTML, `unload` handlers or open connections force a full reload on back and forward.
132
+ - Prefetch: what each route prefetches (link prefetch, Speculation Rules), and whether it is used.
133
+ - Native size: the bytecode bundle (e.g., Hermes), the store download and install size, and whether long lists are virtualised.
134
+
135
+ These are risk signals, not measurements. Confirm fixes with `Re-baseline`, not by re-reading code. **Done when:** `Static` holds one row per item, and the bundle series is recorded.
136
+
137
+ - [ ] **Step 11 — Interactions:** For each route with INP, find the slowest interactions, and attribute them with Long Animation Frames to a script source, forced layout or hydration. Name the worst ones (drag, popover open, picker, form submit). **Done when:** `Interactions` holds one row per route: interaction · duration · attributed cause.
138
+ - [ ] **Step 12 — Async Paths:** **If** there are async user-facing pipelines → the slowest path is often absent from web vitals (e.g., an inbound message is parsed, goes through model extraction, becomes visible, and a reply is sent). Measure it end to end, at p50 and p95 per stage, from job-runner timings and monitoring spans, and name the longest stage. **Done when:** `Async Paths` holds a stage table per pipeline, or records none.
139
+ - [ ] **Step 13 — Server Latency:** `Waterfall` covers only the traced routes, so read latency app-wide: p75 and p95 per server endpoint (e.g., server action, route handler, controller action, DB RPC) from spans; slow queries from DB statistics and the platform advisor; background-job step durations and queue lag; and LLM calls per model and call site — time to first token, total duration, timeouts, retries, and whether user-facing calls stream. **Done when:** `Server Latency` holds a table per source.
140
+ - [ ] **Step 14 — Long Sessions:** **If** some screens stay open for hours (calendar, dashboard) → keep each open for 30 minutes, take heap snapshots, and record memory growth, the realtime subscription count and polling intervals. **Done when:** `Long Sessions` holds one row per screen.
141
+ - [ ] **Step 15 — Re-baseline:** **If** the instrument was fixed since the previous report → the pre-fix baseline is no longer the reference. Re-take `Field Baseline` and `Lab Baseline`, and mark the figures that moved because of the instrument change, not the app. **Done when:** `Field Baseline` marks the moves, or the report records that there was no instrument fix since the previous report.
142
+ - [ ] **Step 16 — Closed Follow-Ups:** Follow-ups from previous reports often close with their decisions recorded only in threads. Read each one closed since the previous report, and sort it: A = not done, blocked on an owner → a named action and blocker; B = deliberately dropped, and the reasoning holds → record it so nobody reopens it; C = real work nobody owns → a new tracker item, or a named home in scheduled work. **If** there is neither a tracker nor scheduled work → name a `docs/deferrals.jsonl` row. A comment on a closed item is not a register. **Done when:** `Closed Follow-Ups` holds one row per item: group · destination.
143
+ - [ ] **Step 17 — 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 Core Web Vital and supporting web metric (LCP, INP, CLS, FCP, TTFB), one per Android vital, one per iOS Organizer metric and one per framework production-checklist item, each marked checked (naming the step), not applicable (saying why) or 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.
144
+ - [ ] **Step 18 — Anything Else:** (a) Give a one-line verdict on each change since the previous report's commit that touches performance: routes and layouts, client-side code and dependencies, third-party scripts, server endpoints, DB queries and RPCs, background jobs, LLM call sites, region and caching config, monitoring sampling, or the native app entry. (b) In a bounded pass of about 30 minutes, note what a senior performance 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`.
142
145
 
143
146
  ### 🔒 Gate 2: Probes Check
144
147
 
145
- **Checkpoint.** Verify and check `[x]` all boxes below, then continue to `Findings` without asking.
146
-
147
- - [ ] **Steps complete:** every step `[x]`, or explicit skip with evidence the surface is absent.
148
- - [ ] **Evidence:** every finding cites re-checkable evidence and the tool behind it.
149
- - [ ] **Environments:** every figure names environment, window, percentile, and `n`.
150
- - [ ] **Settings untouched:** no sampling rate, dashboard, or project setting changed.
151
- - [ ] **Gate 2 - Verified:** Every checkbox above independently verified and checked off.
148
+ - [ ] **Steps complete:** every step is `[x]`, or skipped with evidence that its surface is absent.
149
+ - [ ] **Evidence:** every finding cites evidence someone can check again, and the tool that produced it.
150
+ - [ ] **Environments:** every figure names its environment, window, percentile and `n`.
151
+ - [ ] **Settings untouched:** no sampling rate, dashboard or project setting changed.
152
+ - [ ] **Gate 2 — Verified:** every item above holds.
152
153
 
153
154
  ## Findings
154
155
 
155
156
  <!-- prettier-ignore -->
156
157
  | Severity | Use |
157
158
  | --- | --- |
158
- | `CRITICAL` | User-facing path that times out or never completes; crash, ANR, or hang blocking a primary flow; long-session memory growth to crash |
159
- | `HIGH` | Instrument gap or pollution invalidating the baseline; core vital `poor` on a primary route; budget exceeded; store-enforced vital over threshold; fixed network toll on every call; sequential waterfall on a primary route |
160
- | `MEDIUM` | Vital `needs improvement`; duplicate or wasted prefetch; unexpected dynamic rendering; main route not back/forward-cache eligible; third party loading before interactive; slow query, job step, or LLM call off the primary path; unvirtualised long list |
161
- | `LOW` | Static risk signal without measured impact; size drift within budget; series gap |
159
+ | `CRITICAL` | A user-facing path times out or never completes. A crash, ANR or hang blocks a primary flow. Memory grows over a long session until it crashes |
160
+ | `HIGH` | An instrument gap or pollution invalidates the baseline. A core vital is `poor` on a primary route. A budget is exceeded. A store-enforced vital is over its threshold. A fixed network toll on every call. A sequential waterfall on a primary route |
161
+ | `MEDIUM` | A vital at `needs improvement`. A duplicate or wasted prefetch. Unexpected dynamic rendering. A main route that is not back/forward-cache eligible. A third party that loads before the page is interactive. A slow query, job step or LLM call off the primary path. A long list that is not virtualised |
162
+ | `LOW` | A static risk signal with no measured impact. Size drift within budget. A gap in a series |
162
163
 
163
- Scale per `.bkit/jsonl.md` § Severity. Within a severity: what unblocks the next measurement first — instrument / pollution, one-line config (region, project settings), contained client trims, decisions, or packages shared with native, needs local repro. Needs diagnosis before sizing → `Expected` says so.
164
+ Within a severity, list first what unblocks the next measurement, in this order: instrument and pollution fixes; one-line config changes (region, project settings); contained client trims; decisions; and packages shared with native that need a local repro. **If** a finding needs diagnosis before it can be sized → its `Expected` says so.
164
165
 
165
166
  <!-- prettier-ignore -->
166
167
  | ID | Severity | Location | Evidence | Expected |
167
168
  | --- | --- | --- | --- | --- |
168
169
  | PENDING | PENDING | PENDING | PENDING | PENDING |
169
170
 
170
- Empty and clean → one row `None`.
171
+ **If** the run finds nothing → write one row: `None`.
171
172
 
172
173
  ## Report
173
174
 
@@ -264,17 +265,17 @@ PENDING
264
265
 
265
266
  ### 🔒 Gate 3: Report Check
266
267
 
267
- **Checkpoint.** Verify and check `[x]` all boxes below, then stop.
268
-
269
- - [ ] **No placeholders:** Findings table and every `Report` section have no `PENDING`.
270
- - [ ] **Summary:** names count per severity, environments measured, and production `n`.
271
- - [ ] **Series:** every series beside previous report's numbers, or marked baseline.
272
- - [ ] **Writes:** only this report and template `Project Instructions` changed; throwaway worktrees / remote targets removed.
273
- - [ ] **Process Improvements:** `Universal` = proposed step changes, template untouched; `Project` = edits applied below `bkit:end`; each `none` if empty.
274
- - [ ] **Suggested Issues:** every `MEDIUM`+ finding ID in exactly one row; every row has a `Next Step`.
275
- - [ ] **Gate 3 - Verified:** Every checkbox above independently verified and checked off.
276
-
277
- > `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.
268
+ - [ ] **No placeholders:** no `PENDING` is left.
269
+ - [ ] **Summary:** `Summary` gives the count per severity.
270
+ - [ ] **Environments measured:** `Summary` names the environments measured.
271
+ - [ ] **Production n:** `Summary` gives the production `n`.
272
+ - [ ] **Series:** the report shows every series beside the previous report's numbers, or marks the run as baseline.
273
+ - [ ] **Writes:** this run changed only this report, the template's `Project Instructions` and its own `docs/failures.jsonl` rows.
274
+ - [ ] **Throwaways removed:** every throwaway worktree or remote target is removed.
275
+ - [ ] **Process Improvements:** `Universal` and `Project` are both filled.
276
+ - [ ] **Suggested Issues:** every `MEDIUM`+ finding ID is in exactly one `Suggested Issues` row.
277
+ - [ ] **Next Step:** every `Suggested Issues` row has a `Next Step`.
278
+ - [ ] **Gate 3 — Verified:** every item above holds.
278
279
 
279
280
  <!-- bkit:end -->
280
281