@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,126 +1,130 @@
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
  # Failures Triage
8
8
 
9
9
  > [!CAUTION]
10
- > **Purpose:** Verdict on every open failure — reachable, already fixed, mis-framed, unconfirmed, or a repeat of a known defect.
10
+ > **Purpose:** A verdict on every open failure: reachable, already fixed, mis-framed, unconfirmed, or a repeat of a known defect.
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 append or edit a ledger line. Close, regression, triage, and knowledge rows live in `Expected` only. `ts` is minted at append (`.bkit/jsonl.md` § Write Idiom), never written in this report.
23
- > - A security row (`category: "security"`, or an auth, secrets, or data-exposure hole) carries key, verdict, and severity only. `file:line` stays in the ledger row. A public repo uses a draft repository security advisory, not this report.
14
+ > - NEVER append or edit a ledger line.
15
+ > - Write close, correction, regression, triage and knowledge rows in `Expected` only.
16
+ > - Never write `ts` in this report, because it is minted at append (`.bkit/jsonl.md` § Write Idiom).
17
+ > - Give a security row (`category: "security"`, or an auth, secrets or data-exposure hole) its key, verdict and severity only.
18
+ > - Keep a security row's `file:line` in the ledger row.
19
+ > - **If** the repo is public → report a security row through a draft repository security advisory, not this report.
24
20
 
25
21
  ## Universal Instructions
26
22
 
27
23
  ### Context & Goals
28
24
 
29
- `docs/failures.jsonl` logs discovered bugs (`.bkit/jsonl.md` § Ledgers & Writers). Rows append at discovery; never re-validated. Four drifts:
25
+ `docs/failures.jsonl` logs discovered bugs (`.bkit/jsonl.md` § Ledgers & Writers). Rows are appended at discovery and never re-validated. They drift in four ways:
30
26
 
31
- - Silently fixed — bug fixed, row not `CLOSED`
32
- - Mis-framed — not reachable, or path moved
33
- - Understated — one instance of a systemic defect
34
- - Untracked — reachable, no issue carries it
27
+ - Silently fixed: the bug is fixed, and the row is not `CLOSED`.
28
+ - Mis-framed: the bug is not reachable, or its path moved.
29
+ - Understated: the row is one instance of a systemic defect.
30
+ - Untracked: the bug is reachable, and no issue carries it.
35
31
 
36
- Row text that says found by reading and must be confirmed later = hypothesis, not established bug. Nothing forces confirmation. Target failure: **an open row for a bug the code has already fixed, or a live bug the row understates or never confirmed.**
32
+ Row text that says the bug was found by reading and must be confirmed later is a hypothesis, not an established bug, and nothing forces the confirmation. The failure this audit targets is an open row for a bug the code has already fixed, or a live bug the row understates or never confirmed.
37
33
 
38
- **Applies when:** `docs/failures.jsonl` exists, or agents append `kind: "failure"`. None → one `N/A` row with evidence, never "clean".
34
+ **Applies when:** `docs/failures.jsonl` exists, **or** agents append `kind: "failure"`. **If** neither holds → write one `N/A` row with its evidence, and never report the surface as "clean".
39
35
 
40
- **Cadence:** once per ship cycle, and at least monthly when no cycle ships. Extra pass when new `CRITICAL` row lands (age target 7 days), or after incident on production or preview.
36
+ **Cadence:** Run once per ship cycle, and at least once a month when no cycle ships. Run an extra pass when a new `CRITICAL` row lands (its age target is 7 days), or after an incident on production or preview.
41
37
 
42
- **Anchor Standards:** record version and date read. Newer version → `Standards` step reads what changed.
38
+ **Anchor Standards:**
43
39
 
44
- - Problem management and the known-error database (e.g. ITIL 4; record the edition). The deferred and known-error review it describes (e.g. ITIL-aligned known-error monitoring).
45
- - Postmortem action items (e.g. Google SRE Workbook, Postmortem Culture).
46
- - Bug triage and resolution states, including an incomplete state for an unanswered reproduction request (e.g. Mozilla defect severity guide, Bugzilla triage).
47
- - Age targets, set by this procedure: 7 days for `CRITICAL`, 30 days for `HIGH`, from the row's first `ts`. No published standard.
40
+ - Problem management and the known-error database (e.g., ITIL 4; record the edition). The deferred and known-error review it describes (e.g., ITIL-aligned known-error monitoring).
41
+ - Postmortem action items (e.g., Google SRE Workbook, Postmortem Culture).
42
+ - Bug triage and resolution states, including an incomplete state for an unanswered reproduction request (e.g., Mozilla defect severity guide, Bugzilla triage).
43
+ - Age targets, set by this procedure: 7 days for `CRITICAL`, 30 days for `HIGH`, from the winning row's `firstTs` (`ts` when absent). No published standard.
48
44
 
49
45
  ### Scope
50
46
 
51
- - Fold `docs/failures.jsonl` last-row-wins. Open = winning `status != "CLOSED"`.
52
- - Age against target. Whether CI gate on open `CRITICAL` failures is installed, and whether it reads this ledger.
53
- - Verify every open row against source, including hypotheses, mis-framing, and understatement.
54
- - Incident follow-ups, and whether each incident has a postmortem with a preventing action.
55
- - Recurrences and regressions.
56
- - Known-error workaround on record. Root-cause classes, and the top class as a gate candidate.
57
- - Security rows routed without exploit detail.
47
+ - Fold `docs/failures.jsonl` last-row-wins. A row is open when its winning row has `status != "CLOSED"`.
48
+ - Measure each row's age against its target.
49
+ - Check whether a CI gate on open `CRITICAL` failures is installed, and whether it reads this ledger.
50
+ - Verify every open row against source, including hypotheses, mis-framing and understatement.
51
+ - Check incident follow-ups, and whether each incident has a postmortem with a preventing action.
52
+ - Find recurrences and regressions.
53
+ - Check that each known error has a workaround on record.
54
+ - Count root-cause classes, and name the top class as a gate candidate.
55
+ - Route security rows without exploit detail.
58
56
 
59
57
  ### Out of Scope
60
58
 
61
59
  <!-- prettier-ignore -->
62
60
  | Excluded item | Why | Where it belongs |
63
61
  | --- | --- | --- |
64
- | Deliberate deferred work | Deferral register | `bkit-audit-deferrals` |
65
- | Exploit reproduction; auth and exposure as an attack sweep | Security sweep reads the ledger row | `bkit-audit-security` |
66
- | Flake diagnosis in depth | Flake sweep | `bkit-audit-flakes` |
67
- | Log volume, alert rules, drain coverage | Log sweep | `bkit-audit-logs` |
68
- | Closing rows the code already finished; locator fixes; `TRIAGED` when an issue already exists | Ledger writes. For `category: "testing"`, the utility closes only on a landed deterministic fix, never a recent green run | `@bkit-utility-update-failures` |
69
- | Opening issues; writing the failing test or the postmortem | Audit reports only | Plan from this report |
62
+ | Deliberate deferred work | It is in the deferral register | `bkit-audit-deferrals` |
63
+ | Exploit reproduction; auth and exposure as an attack sweep | The security sweep reads the ledger row | `bkit-audit-security` |
64
+ | Flake diagnosis in depth | The flake sweep covers it | `bkit-audit-flakes` |
65
+ | Log volume, alert rules, drain coverage | The log sweep covers it | `bkit-audit-logs` |
66
+ | Closing rows the code already finished; locator fixes; `TRIAGED` when an issue already exists | These are ledger writes. For `category: "testing"`, the utility closes a row only on a landed deterministic fix, never on a recent green run | `@bkit-utility-update-failures` |
67
+ | Opening issues; writing the failing test or the postmortem | The audit only reports | A plan made from this report |
70
68
 
71
69
  ### Verdicts
72
70
 
73
- One per verified row.
71
+ Give each verified row one verdict.
74
72
 
75
- - **CONFIRMED:** real and reachable. Reproduced, or path read end to end with cited `file:line` (citation out of report when row is security). Record reach: flow, roles that hit it, live event counts when error tracker available. No issue → `Expected` names issue to open. Bug not reproducible is not fixed from row alone. Failing test = next step in `Expected`, not written here.
76
- - **FIXED:** already resolved. `Expected` = `CLOSED` same-`key` row, with `references` that closed it, and test that would fail if bug returned. Fix with no such test is not FIXED: `Expected` = `TRIAGED` row whose follow-up is missing test.
77
- - **MIS-FRAMED:** row wrong. Bug not reachable, component/path moved, or one instance of systemic defect. `Expected` = corrected row, or `CLOSED` row with close reason.
78
- - **TRACKED:** real; open issue covers it. `Expected` = issue to point row at.
79
- - **UNCONFIRMED:** hypothesis; not yet reproduced or read end to end. `Expected` = probe or failing test to settle it. Still unsettled on third run → `CLOSED` as not reproducible, and say so.
80
- - **DUPLICATE:** same defect as another row under different `key`. `Expected` = canonical key, and `CLOSED` row for this one.
81
- - **OTHER:** fits none. Say what it is, why, and where it goes. Same `OTHER` on 2 runs → propose new verdict in `Process Improvements`.
73
+ - **CONFIRMED:** the bug is real and reachable. It was reproduced, or its path was read end to end with a cited `file:line`. **If** the row is a security row → keep the citation out of the report. Record the reach: the flow, the roles that hit it, and live event counts when an error tracker is available. **If** no issue carries it → `Expected` names the issue to open. A bug that cannot be reproduced is not fixed on the row's word alone. The failing test is the next step, named in `Expected`, not written here.
74
+ - **FIXED:** the bug is already resolved. `Expected` = the `CLOSED` row with the same `key`, with the `references` that closed it, and the test that would fail if the bug returned. A fix with no such test is not FIXED: `Expected` = a `TRIAGED` row whose follow-up is the missing test.
75
+ - **MIS-FRAMED:** the row is wrong. The bug is not reachable, its component or path moved, or it is one instance of a systemic defect. `Expected` = the corrected row, or the `CLOSED` row with the close reason.
76
+ - **TRACKED:** the bug is real, and an open issue covers it. `Expected` = the issue to point the row at.
77
+ - **UNCONFIRMED:** the row is a hypothesis, not yet reproduced or read end to end. `Expected` = the probe or failing test that settles it. **If** it is still unsettled on its third run → `CLOSED` as not reproducible, and say so.
78
+ - **DUPLICATE:** the row is the same defect as another row under a different `key`. `Expected` = the canonical key, and the `CLOSED` row for this one.
79
+ - **OTHER:** it fits no other verdict. Say what it is, why, and where it goes. **If** the same `OTHER` shows up on 2 runs → propose a new verdict in `Process Improvements`.
82
80
 
83
- **FIXED and MIS-FRAMED are the verdicts most likely to hide a live bug.** Language server under-reporting biases that way. Either verdict needs positive reason — fix commit, deleted file, or changed guard. Empty query is not absence. Error-tracker events on matching issue after fix commit → bug not fixed.
81
+ **Close evidence:** FIXED and MIS-FRAMED are the verdicts most likely to hide a live bug, and language-server under-reporting biases the run toward them. Either verdict needs a positive reason: a fix commit, a deleted file or a changed guard. An empty query does not prove absence. **If** the error tracker shows events on the matching issue after the fix commit → the bug is not fixed.
84
82
 
85
- Row text awaiting confirmation = UNCONFIRMED until reproduced or read end to end.
83
+ Row text awaiting confirmation is UNCONFIRMED until the bug is reproduced or read end to end.
86
84
 
87
85
  ### Pre-Flight / Dependencies
88
86
 
89
- **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.
90
-
91
- **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.
92
-
93
87
  #### Core
94
88
 
95
- Always verify.
96
-
97
- - [ ] **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.
98
- - [ ] **Ledger:** Steps 3–7 — `docs/failures.jsonl` and `.bkit/jsonl.md`. Fallback: file absent → one `N/A` row after Step 3 and STOP.
99
- - [ ] **Git History:** Steps 2, 5 — commits since the previous report, fix commits. Fallback: closures and regression-by-commit `Not Checked`.
100
- - [ ] **Web:** Step 8 — fetch anchor standards. Fallback: versions recorded as unread.
89
+ - [ ] **Permissions:** every blocked call is recorded.
90
+ - [ ] **Ledger:** Steps 3-7 — `docs/failures.jsonl` and `.bkit/jsonl.md`. Fallback: **If** the file is absent → write one `N/A` row after Step 3, then **STOP**.
91
+ - [ ] **Git History:** Steps 2, 5 — commits since the previous report, and fix commits. Fallback: mark closures and regression-by-commit `Not Checked`.
92
+ - [ ] **Web:** Step 8 — fetch the anchor standards. Fallback: record the versions as unread.
101
93
 
102
94
  #### Conditional
103
95
 
104
- Verify only when applicable.
105
-
106
- - [ ] **Language Server:** Typed language → Step 4 — symbol at current path, caller chain, diagnostics for one file without full typecheck, e.g. Serena, `tsserver`. Fallback: text search. Reach and close needing callers stay hypotheses until corroborated.
107
- - [ ] **Error Tracker:** Production or preview events exist → Steps 4, 5 — event counts and flows after fix commit, e.g. Sentry, platform logs. Log access: `.agents/context.md` `context-fetch` blocks below `bkit:end` are ready-made read-only readers (`bkit context list-blocks` → each block's `context` and `body`); set a body's `# Customise:` knobs to the audit window; run it via `direnv exec . bash`. Fallback: code only. Event counts `Not Checked`.
108
- - [ ] **Tracker:** Issues wired → Steps 4, 7 — issue carrying bug, postmortem tracking issue. Fallback: issue pointers `Not Checked`.
109
- - [ ] **CI Config:** Workflow can fail build → Step 3 — gate on open `CRITICAL` failures. Fallback: gate check `Not Checked`.
96
+ - [ ] **Language Server:** **If** the language is typed → Step 4 — the symbol at its current path, the caller chain, and diagnostics for one file without a full typecheck (e.g., Serena, `tsserver`). Fallback: text search. Reach and closes that need callers stay hypotheses until corroborated.
97
+ - [ ] **Error Tracker:** **If** production or preview events exist → Steps 4, 5 — event counts and flows after the fix commit (e.g., Sentry, platform logs). Log access: the `context-fetch` blocks below `bkit:end` in `.agents/context.md` are ready-made read-only readers. `bkit context list-blocks` prints each block's `context` and `body`. Set a body's `# Customise:` knobs to the audit window, and run it with `direnv exec . bash`. Fallback: code only. Mark event counts `Not Checked`.
98
+ - [ ] **Tracker:** **If** issues are wired → Steps 4, 7 — the issue carrying the bug, and the postmortem tracking issue. Fallback: mark issue pointers `Not Checked`.
99
+ - [ ] **CI Config:** **If** a workflow can fail the build → Step 3 — the gate on open `CRITICAL` failures. Fallback: mark the gate check `Not Checked`.
110
100
 
111
101
  ### 🔒 Gate 1: Prerequisites Check
112
102
 
113
- **Checkpoint.** Verify and check `[x]` all applicable boxes above, then continue to `Probe Steps` without asking.
114
-
115
- - [ ] **Gaps named:** every missing item names its fallback and `Not Checked` entry.
116
- - [ ] **Gate 1 - Verified:** All Core items checked. All applicable Conditional items checked.
103
+ - [ ] **Gaps named:** every missing item names its fallback and its `Not Checked` entry.
104
+ - [ ] **Gate 1 — Verified:** every item above, every Core item and every applicable Conditional item is checked.
117
105
 
118
106
  ### Probe Steps
119
107
 
120
- - [ ] **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.
121
- - [ ] **Step 2 — Closures:** Re-verify every FIXED and MIS-FRAMED row from previous report at `HEAD`. Each no longer holding = finding, with what changed. **Done when:** `Closures` holds every row, each failure, and failure rate, or run marked baseline.
122
- - [ ] **Step 3 — Fold:** Last-row-wins per `key`, not per line. Append-only file (`.gitattributes` `merge=union`); editing a line keeps stale copy beside replacement. Highest numeric `ts` wins (`.bkit/jsonl.md` § Updating a Row). `key` whose `ts` is not a number → last line in file is latest. Open = every winning row with `status != "CLOSED"`, including `TRIAGED` (diagnosed is not fixed), `RESOLVED`, `FIXED`, `SUPERSEDED`, and rows with no `status`. Word that looks finished is not done. `RESOLVED` or `FIXED` row really done → `CLOSED` row in `Expected`, with `references` that closed it. Not skipped because word looks finished. Order: `CRITICAL`, then `HIGH`, then oldest `ts`. Compare `severity` case-insensitively. No `severity` → assign with verdict. Age from row's first `ts`: list every `CRITICAL` older than 7 days and every `HIGH` older than 30 days. Where CI check goes red while any `CRITICAL` row has `status != "CLOSED"`, report whether installed. Green check beside such row = finding (gate not reading ledger). Absent → record in `Checked`. Large open set may be partial pass → record rows verified / rows open. Winning future `ts` that would outrank close → name `key`. No later `ts` invented. **Done when:** `Trend` holds open counts, age-target breaches, gate result, and verified / open, or `N/A` and STOP.
123
- - [ ] **Step 4 — Source:** No verdict before this step. Under-reporting biases toward closing live bug.
108
+ - [ ] **Step 1 — Previous Run:** **Done when:** `Previous Run` holds the closure rate, or the run is marked baseline.
109
+ - [ ] **Step 2 — Closures:** Re-verify at `HEAD` every FIXED and MIS-FRAMED row from the previous report. Each one that no longer holds is a finding, with what changed. **Done when:** `Closures` holds every row, each failure and the failure rate, or the run is marked baseline.
110
+ - [ ] **Step 3 — Fold:** Fold the ledger last-row-wins per `key`, not per line. The ledger is append-only (`.gitattributes` `merge=union`), so editing a line leaves the stale copy beside its replacement. The highest numeric `ts` wins (`.bkit/jsonl.md` § Updating a Row).
111
+ - **If** a `key`'s `ts` is not a number → the last line in the file is the latest.
112
+ - Open means every winning row with `status != "CLOSED"`, including `TRIAGED` (diagnosed is not fixed), `RESOLVED`, `FIXED`, `SUPERSEDED`, and rows with no `status`. A word that looks finished does not make a row done.
113
+ - **If** a `RESOLVED` or `FIXED` row is really done → put a `CLOSED` row in `Expected`, with the `references` that closed it.
114
+ - Do not skip a row because its word looks finished.
115
+ - Order the rows `CRITICAL`, then `HIGH`, then oldest `ts`.
116
+ - Compare `severity` case-insensitively.
117
+ - **If** a row has no `severity` → assign one with its verdict.
118
+ - Measure age from the row's first `ts`, and list every `CRITICAL` older than 7 days and every `HIGH` older than 30 days.
119
+ - Report whether a CI check is installed that goes red while any `CRITICAL` row has `status != "CLOSED"`. A green check beside such a row is a finding, because the gate is not reading the ledger.
120
+ - **If** the check is absent → record that in `Checked`.
121
+ - A large open set may get a partial pass, so record rows verified / rows open.
122
+ - **If** a winning row has a future `ts` that would outrank a close → name its `key`.
123
+ - Do not invent a later `ts`.
124
+
125
+ **Done when:** `Trend` holds the open counts, the age-target breaches, the gate result, and verified / open, or holds `N/A`, then **STOP**.
126
+
127
+ - [ ] **Step 4 — Source:** Give no verdict before this step. Under-reporting biases the run toward closing a live bug.
124
128
 
125
129
  <!-- prettier-ignore -->
126
130
  | Row claims | Check with |
@@ -132,15 +136,15 @@ Verify only when applicable.
132
136
  | A ledger, migration, workflow, SQL, config, or string literal | Text search. A language server reads one language |
133
137
  | FIXED, or the reach of CONFIRMED | Error tracker and platform logs. Events after the fix commit mean not fixed. Counts and flows are the reach |
134
138
 
135
- Pace reference queries. Re-run empty or surprisingly low result before close verdict. Partial answer indistinguishable from real one. Empty inconclusive, not absence. Packages/files outside project graph, mock-factory keys invisible → text search.
139
+ Pace the reference queries. Re-run an empty or surprisingly low result before giving a close verdict, because a partial answer looks the same as a real one. An empty result is inconclusive, not proof of absence. Packages and files outside the project graph, and mock-factory keys, are invisible to the language server, so use text search for them.
136
140
 
137
- Incident rows (seen on production or preview, not in review) need follow-ups checked. Remediation usually names more than code fix: regression test, monitor, alert, doc change. Check each landed. Fix landed, test or monitor did not → not FIXED. `Expected` names each missing follow-up and issue to open.
141
+ Incident rows (seen on production or preview, not in review) need their follow-ups checked. The remediation usually names more than the code fix: a regression test, a monitor, an alert or a doc change. Check that each one landed. **If** the fix landed **and** the test or monitor did not → the row is not FIXED. `Expected` names each missing follow-up and the issue to open.
138
142
 
139
- Each incident: written postmortem; ≥1 action preventing or detecting repeat, with owner and tracking issue at top priority. User-affecting outage needs ≥1 top-priority bug. Missing postmortem, or postmortem with only mitigation items = finding. `Expected` = issue to open. **Done when:** every row verified this pass has evidence and tool on finding. `Incidents` lists follow-ups and postmortem gaps, or `none`. Unverified rows stay counted in `Trend`; not passed.
143
+ Each incident needs a written postmortem, with at least one action that prevents or detects a repeat, an owner, and a tracking issue at top priority. A user-affecting outage needs at least one top-priority bug. A missing postmortem, or a postmortem with only mitigation items, is a finding, and `Expected` = the issue to open. **Done when:** every row verified this pass has its evidence and the tool on its finding. `Incidents` lists the follow-ups and postmortem gaps, or says `none`. Unverified rows stay counted in `Trend`, and are not passed.
140
144
 
141
- - [ ] **Step 5 — Recurrences:** Same-`key` append recording defect seen again = recurrence (`.bkit/jsonl.md` § Updating a Row). Omit appends that only change `status`. For `category: "testing"`, flake count = `key`'s row count under that rule. Rank open rows by count. Then regressions: each row `CLOSED` since previous report → look for later row same `key`, new row same defect under another `key`, or error-tracker events on matching issue after close. Each → `Expected` = `OPEN` row to append. **Done when:** `Recurrences` ranks open rows and lists regressions, or `none`.
142
- - [ ] **Step 6 — Classes:** (a) Known errors carry workaround. For every `TRIAGED` or CONFIRMED row agents keep hitting (≥2 recurrences in Step 5, or parked row whose blocker not in winning row), check `docs/knowledge.jsonl` has `ACTIVE` row with workaround. Missing → finding. `Expected` = knowledge row to append. (b) Count open and recently closed rows by `category`, package, root-cause class. Top recurring class this run = gate candidate → name for `bkit-audit-gates`. **Done when:** `Classes` holds workaround gaps, counts, gate candidate, or `none`.
143
- - [ ] **Step 7 — Classify:** Every row, as Step 4 left it, gets one verdict. This run does not append or open issues. Security row → `bkit-audit-security`: key, verdict, severity only in this report. Flaky test diagnosis → `bkit-audit-flakes`. Older flake diagnoses may sit on tracker issues predating that audit. Search those too.
145
+ - [ ] **Step 5 — Recurrences:** A same-`key` append that records the defect being seen again is a recurrence (`.bkit/jsonl.md` § Updating a Row). Leave out appends that only change `status`. For `category: "testing"`, the flake count is the winning row's `updates`, status-only appends included. Rank the open rows by count. Then find regressions. For each row `CLOSED` since the previous report, look for a later row with the same `key`, a new row for the same defect under another `key`, or error-tracker events on the matching issue after the close. Each one gets `Expected` = the `OPEN` row to append. **Done when:** `Recurrences` ranks the open rows and lists the regressions, or says `none`.
146
+ - [ ] **Step 6 — Classes:** (a) Known errors carry a workaround. For every `TRIAGED` or CONFIRMED row that agents keep hitting (2 or more recurrences in Step 5, or a parked row whose blocker is not in the winning row), check that `docs/knowledge.jsonl` has an `ACTIVE` row with the workaround. A missing one is a finding, and `Expected` = the knowledge row to append. (b) Count the open and recently closed rows by `category`, package and root-cause class. The top recurring class this run is a gate candidate; name it for `bkit-audit-gates`. **Done when:** `Classes` holds the workaround gaps, the counts and the gate candidate, or says `none`.
147
+ - [ ] **Step 7 — Classify:** Give every row, as Step 4 left it, one verdict. This run does not append rows or open issues. A security row goes to `bkit-audit-security`, with only its key, verdict and severity in this report. A flaky test's diagnosis goes to `bkit-audit-flakes`. Older flake diagnoses may sit on tracker issues that predate that audit, so search those too.
144
148
 
145
149
  <!-- prettier-ignore -->
146
150
  | Finding | Expected |
@@ -160,39 +164,40 @@ Each incident: written postmortem; ≥1 action preventing or detecting repeat, w
160
164
  | Flaky test's diagnosis | `bkit-audit-flakes` |
161
165
  | OTHER | Where it goes |
162
166
 
163
- **Done when:** every verified row has one verdict. Security rows in Findings carry no `file:line` and no exploit detail.
167
+ **Done when:** every verified row has one verdict, and the security rows in Findings carry no `file:line` and no exploit detail.
164
168
 
165
- - [ ] **Step 8 — Standards:** Confirm current version per anchor standard; read changes since previous report's version. `Standards Coverage`: one row per practice (known-error records, proactive problem review, postmortem action items, triage resolution states, age targets) → checked (name step) / not applicable (why) / finding. Unapplied recommended practice → adopt (propose step) / reject (why) / not applicable. **Done when:** no empty row.
166
- - [ ] **Step 9 — Anything Else:** (a) Everything changed since previous report's commit touching failures (schema and writers in `.bkit/jsonl.md`, steps and agents that append rows, CI gate on open `CRITICAL` failures, flake register `bkit-audit-flakes`, error-tracker projects and alert rules) → one-line verdict each. (b) Bounded ~30 min pass: what senior problem manager flags that no step asks; read since previous run (incidents, `bkit-audit-logs` sweeps, vendor status incidents) — 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`.
169
+ - [ ] **Step 8 — Standards:** Confirm the current version of each anchor standard, and read what changed since the previous report's version. In `Standards Coverage`, give one row per practice (known-error records, proactive problem review, postmortem action items, triage resolution states, age targets), marked checked (with 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.
170
+ - [ ] **Step 9 — Anything Else:** (a) List everything changed since the previous report's commit that touches failures (the schema and writers in `.bkit/jsonl.md`, the steps and agents that append rows, the CI gate on open `CRITICAL` failures, the flake register `bkit-audit-flakes`, and error-tracker projects and alert rules), with a one-line verdict each. (b) In a bounded pass of about 30 minutes, note what a senior problem manager would flag that no step asks about. Read what happened since the previous run (incidents, `bkit-audit-logs` sweeps, vendor status incidents), and note 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`.
167
171
 
168
172
  ### 🔒 Gate 2: Probes Check
169
173
 
170
- **Checkpoint.** Verify and check `[x]` all boxes below, then continue to `Findings` without asking.
171
-
172
- - [ ] **Steps complete:** every step `[x]`, or explicit skip with evidence the surface is absent.
173
- - [ ] **Evidence:** every finding cites re-checkable evidence and the tool behind it.
174
- - [ ] **Read-only:** no ledger line, code, or config changed. Every close, regression, and knowledge row is `Expected` only.
175
- - [ ] **Security:** security rows carry key, verdict, and severity only. No exploit detail, no `file:line`.
176
- - [ ] **Gate 2 - Verified:** Every checkbox above independently verified and checked off.
174
+ - [ ] **Steps complete:** every step is `[x]`, or skipped with evidence that its surface is absent.
175
+ - [ ] **Evidence:** every finding cites evidence someone can check again, and the tool that produced it.
176
+ - [ ] **Read-only:** no ledger line, code or config changed.
177
+ - [ ] **Rows proposed only:** every close, correction, regression, triage and knowledge row is in `Expected` only.
178
+ - [ ] **Security:** security rows carry key, verdict and severity only.
179
+ - [ ] **No exploit detail:** no security row carries exploit detail.
180
+ - [ ] **No location:** no security row carries a `file:line`.
181
+ - [ ] **Gate 2 — Verified:** every item above holds.
177
182
 
178
183
  ## Findings
179
184
 
180
185
  <!-- prettier-ignore -->
181
186
  | Severity | Use |
182
187
  | --- | --- |
183
- | `CRITICAL` | Data loss, a security hole, or a broken workflow with no workaround. Still open, including a row whose word looks finished |
184
- | `HIGH` | Real damage or a blocked path, with a workaround. Fix landed and no regression test. Incident whose test or monitor did not land. User-affecting outage with no preventing action |
185
- | `MEDIUM` | Mis-framed or understated. Recurrence or regression. Known error with no workaround on record. Age target breached. Hypothesis still open |
186
- | `LOW` | Duplicate key. Path drift that does not change reach. Missing `severity` |
188
+ | `CRITICAL` | A row records data loss, a security hole, or a broken workflow with no workaround, and is still open. That includes a row whose word looks finished. |
189
+ | `HIGH` | A row records real damage or a blocked path, with a workaround. A fix landed with no regression test. An incident's test or monitor did not land. A user-affecting outage has no preventing action. |
190
+ | `MEDIUM` | A row is mis-framed or understated. A defect recurred or regressed. A known error has no workaround on record. An age target is breached. A hypothesis is still open. |
191
+ | `LOW` | A key is duplicated. A path drifted without changing the reach. A row is missing `severity`. |
187
192
 
188
- Scale per `.bkit/jsonl.md` § Severity. Within a severity: oldest `ts` first. Finding keeps severity when it becomes ledger row or issue. Row's bucket = ledger severity, or verdict assigns.
193
+ Within a severity, list the oldest `firstTs` first, using `ts` where `firstTs` is absent. A finding keeps its severity when it becomes a ledger row or an issue. A row's severity is its ledger `severity`, or the one its verdict assigned.
189
194
 
190
195
  <!-- prettier-ignore -->
191
196
  | ID | Severity | Verdict | Location | Evidence | Expected |
192
197
  | --- | --- | --- | --- | --- | --- |
193
198
  | PENDING | PENDING | PENDING | PENDING | PENDING | PENDING |
194
199
 
195
- Empty and clean → one row `None`.
200
+ **If** the run finds nothing → write one row: `None`.
196
201
 
197
202
  ## Report
198
203
 
@@ -253,17 +258,17 @@ PENDING
253
258
 
254
259
  ### 🔒 Gate 3: Report Check
255
260
 
256
- **Checkpoint.** Verify and check `[x]` all boxes below, then stop.
257
-
258
- - [ ] **No placeholders:** Findings table and every `Report` section have no `PENDING`.
259
- - [ ] **Summary:** names count per severity, age-target breach count, and rows verified / rows open.
260
- - [ ] **Series:** open count and the recurrence ranking beside previous report's numbers, or marked baseline.
261
- - [ ] **Writes:** only this report and template `Project Instructions` changed; throwaway worktrees / remote targets removed.
262
- - [ ] **Process Improvements:** `Universal` = proposed step changes, template untouched; `Project` = edits applied below `bkit:end`; each `none` if empty.
263
- - [ ] **Suggested Issues:** every `MEDIUM`+ finding ID in exactly one row; every row has a `Next Step`.
264
- - [ ] **Gate 3 - Verified:** Every checkbox above independently verified and checked off.
265
-
266
- > `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.
261
+ - [ ] **No placeholders:** no `PENDING` is left.
262
+ - [ ] **Summary:** `Summary` gives the count per severity.
263
+ - [ ] **Age breaches:** `Summary` gives the age-target breach count.
264
+ - [ ] **Coverage:** `Summary` gives rows verified / rows open.
265
+ - [ ] **Series:** the report shows open count and the recurrence ranking beside the previous report's numbers, or marks the run as baseline.
266
+ - [ ] **Writes:** this run changed only this report and the template's `Project Instructions`.
267
+ - [ ] **Throwaways removed:** every throwaway worktree or remote target is removed.
268
+ - [ ] **Process Improvements:** `Universal` and `Project` are both filled.
269
+ - [ ] **Suggested Issues:** every `MEDIUM`+ finding ID is in exactly one `Suggested Issues` row.
270
+ - [ ] **Next Step:** every `Suggested Issues` row has a `Next Step`.
271
+ - [ ] **Gate 3 — Verified:** every item above holds.
267
272
 
268
273
  <!-- bkit:end -->
269
274