@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,153 +1,159 @@
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
  # Deferrals Triage
8
8
 
9
9
  > [!CAUTION]
10
- > **Purpose:** Verdict on every open deferral — already done, superseded, tracked, parked, or in-scope work that should have been finished.
10
+ > **Purpose:** A verdict on every open deferral: already done, superseded, tracked, parked, or in-scope work that should have been finished.
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. Correction and close rows live in `Expected` only. `ts` is minted at append (`.bkit/jsonl.md` § Write Idiom), never written in this report.
23
- > - A winning row whose `ts` is in the future outranks every correction. Name its `key`. Do not invent a later `ts`.
14
+ > - NEVER append or edit a ledger line. Write each correction and close row in `Expected` only.
15
+ > - Leave `ts` out of every row in this report. The writer mints it when it appends the row (`.bkit/jsonl.md` § Write Idiom).
16
+ > - A winning row whose `ts` is in the future outranks every correction. Name its `key` rather than inventing a later `ts`.
24
17
 
25
18
  ## Universal Instructions
26
19
 
27
20
  ### Context & Goals
28
21
 
29
- Deferred work appends rows; nothing re-reads them. Three drifts: silently done (landed, row still not `CLOSED`); superseded (surface rewritten or removed); genuinely deferred and untracked (real work, no tracker issue). Target failure: **an open row the code has already finished, or a real deferral with nothing carrying it** — e.g. `RESOLVED` or `SUPERSEDED` left open because only `CLOSED` is done, or a deferral whose only record is a comment on a closed issue. Deliberate debt only (prudent and deliberate quadrant).
22
+ Deferred work adds rows to `docs/deferrals.jsonl`, and nothing reads them again. Rows drift in three ways: the work is silently done (it landed, but the row is still not `CLOSED`), superseded (its surface was rewritten or removed), or genuinely deferred and untracked (real work with no tracker issue). The failure this audit targets is an open row whose work the code has already finished, or a real deferral that nothing carries. Examples: a row left at `RESOLVED` or `SUPERSEDED` because only `CLOSED` counts as done, or a deferral whose only record is a comment on a closed issue. The register holds deliberate debt only (the prudent and deliberate quadrant).
30
23
 
31
- **Applies when:** `docs/deferrals.jsonl` exists, or a workflow writes `kind: "deferral"`. None → one `N/A` row with evidence, never "clean".
24
+ **Applies when:** `docs/deferrals.jsonl` exists, or a workflow writes `kind: "deferral"`. **If** neither holds → write one `N/A` row with its evidence, and never report the surface as "clean".
32
25
 
33
- **Cadence:** once per ship cycle; at least monthly when no cycle ships. Extra pass after release, or after another audit records deferred items (e.g. `bkit-audit-app-performance`).
26
+ **Cadence:** Run once per ship cycle, and at least once a month when no cycle ships. Run an extra pass after a release, or after another audit records deferred items (e.g., `bkit-audit-app-performance`).
34
27
 
35
- **Anchor Standards:** record version and date read. Newer version → `Standards` step reads what changed.
28
+ **Anchor Standards:**
36
29
 
37
- - Technical debt, principal, and interest, and the Technical Debt Quadrant (e.g. Martin Fowler).
38
- - Hotspot analysis, churn against code health (e.g. CodeScene).
39
- - Review of deferred problem records on a schedule and on release: activate, keep deferred, or close (e.g. ITIL-aligned known-error monitoring).
30
+ - Technical debt, principal, and interest, and the Technical Debt Quadrant (e.g., Martin Fowler).
31
+ - Hotspot analysis, churn against code health (e.g., CodeScene).
32
+ - Review of deferred problem records on a schedule and on release: activate, keep deferred, or close (e.g., ITIL-aligned known-error monitoring).
40
33
  - `.bkit/jsonl.md` § Deferral Reason — `reason` enum and the four `unjustified` tests, at the installed bkit version.
41
34
 
42
35
  ### Scope
43
36
 
44
- - Fold `docs/deferrals.jsonl` last-row-wins. Open = winning `status != "CLOSED"`.
45
- - Data defects on the winning row: `ts`, `status`, `reason`. The row to append goes in `Expected`.
37
+ - Fold `docs/deferrals.jsonl` last-row-wins. A row is open when its winning row has `status != "CLOSED"`.
38
+ - Check the winning row for data defects in `ts`, `status` and `reason`, and put the row to append in `Expected`.
46
39
  - Verify every open row against source before any verdict.
47
40
  - Re-test each `reason`, and each `KEEP` trigger.
48
- - Carrying cost: 90-day churn, related `docs/failures.jsonl` and `.bkit/friction.jsonl` rows.
49
- - Tracker issues rows point at. Deferrals that exist only as comments on closed issues.
50
- - `unjustified` adjudication (four tests). Report the row. Do not append.
51
- - Trend: open count, inflow, outflow, age, missing `severity` or `reason`, rows verified / rows open.
41
+ - Measure the carrying cost: 90-day churn, and the related rows in `docs/failures.jsonl` and `.bkit/friction.jsonl`.
42
+ - Check the tracker issues that rows point at.
43
+ - Find the deferrals that exist only as comments on closed issues.
44
+ - Adjudicate `unjustified` with the four tests, and report the row without appending it.
45
+ - Track the trend: open count, inflow, outflow, age, rows missing `severity` or `reason`, and rows verified / rows open.
52
46
 
53
47
  ### Out of Scope
54
48
 
55
49
  <!-- prettier-ignore -->
56
50
  | Excluded item | Why | Where it belongs |
57
51
  | --- | --- | --- |
58
- | Reckless and inadvertent debt | Not in this register | `bkit-audit-slop`, `bkit-audit-architecture`, `bkit-audit-dead-code` |
59
- | Known bugs | Failure ledger | `bkit-audit-failures` |
60
- | Closing rows the code already finished; locator fixes; `TRIAGED` when an issue already exists | Ledger writes. Utility reads every winning row not `CLOSED` | `@bkit-utility-update-deferrals` |
61
- | Doing the deferred work; opening tracker issues | Audit reports only | Plan from this report |
52
+ | Reckless and inadvertent debt | It is not in this register | `bkit-audit-slop`, `bkit-audit-architecture`, `bkit-audit-dead-code` |
53
+ | Known bugs | They belong in the failure ledger | `bkit-audit-failures` |
54
+ | Closing rows the code already finished; locator fixes; `TRIAGED` when an issue already exists | These are ledger writes. The utility reads every winning row that is not `CLOSED` | `@bkit-utility-update-deferrals` |
55
+ | Doing the deferred work; opening tracker issues | The audit only reports | A plan made from this report |
62
56
 
63
57
  ### Verdicts
64
58
 
65
- One per verified row.
59
+ Give each verified row one verdict.
66
60
 
67
- - **DONE:** already landed. `Expected` = `CLOSED` same-`key` row. Cite `file:line`.
68
- - **SUPERSEDED:** no longer applies (moved, rewritten, removed, or N/A). `Expected` = `CLOSED` row and the reason.
69
- - **TRACKED:** genuinely deferred, an open issue already covers it. `Expected` = the issue to point the row at, or the acceptance criteria to extend.
70
- - **NEEDS ISSUE:** genuinely deferred, real work, untracked. `Expected` = the issue to open.
71
- - **KEEP:** genuinely deferred, correctly parked, not worth an issue yet (tripwire or contingent). `Expected` = no action, and the trigger.
72
- - **SMALL:** small enough for the next cycle. This run does not do it.
73
- - **ACCEPTED:** still true, and deliberately never to be done. `Expected` = who decides, and the `CLOSED` row to append once signed off. Record it. Do not wait.
74
- - **UNJUSTIFIED:** all four tests hold. `Expected` = same-`key` row, `reason: "unjustified"`, the failed test named in `description`, `status: "TRIAGED"`. Later rows carry `reason` verbatim. Work goes back in scope via a plan.
75
- - **OTHER:** fits none. Say what it is, why, and where it goes. Same `OTHER` on 2 runs → propose new verdict in `Process Improvements`.
61
+ - **DONE:** the work already landed. `Expected` = the `CLOSED` row with the same `key`. Cite `file:line`.
62
+ - **SUPERSEDED:** the row no longer applies (its surface moved, was rewritten or removed, or is N/A). `Expected` = the `CLOSED` row and the reason.
63
+ - **TRACKED:** the work is genuinely deferred, and an open issue already covers it. `Expected` = the issue to point the row at, or the acceptance criteria to extend.
64
+ - **NEEDS ISSUE:** the work is genuinely deferred, real and untracked. `Expected` = the issue to open.
65
+ - **KEEP:** the work is genuinely deferred, correctly parked, and not yet worth an issue (a tripwire or a contingent item). `Expected` = no action, and the trigger.
66
+ - **SMALL:** the work is small enough for the next cycle. This run does not do it.
67
+ - **ACCEPTED:** the row is still true, and the work is deliberately never to be done. `Expected` = who decides, and the `CLOSED` row to append once they sign off. Record the verdict without waiting for the sign-off.
68
+ - **UNJUSTIFIED:** all four tests hold. `Expected` = a row with the same `key`, `reason: "unjustified"`, the failed test named in `description`, and `status: "TRIAGED"`. Later rows carry `reason` word for word. The work goes back in scope through a plan.
69
+ - **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`.
76
70
 
77
- **DONE is the verdict most likely to be wrong.** Plausible commit message ≠ evidence. DONE or SUPERSEDED needs positive reason — commit, deleted file, or new owner module. Empty query is not absence.
71
+ **Close evidence:** DONE is the verdict most likely to be wrong, and a plausible commit message is not evidence. Give each DONE or SUPERSEDED a positive reason: a commit, a deleted file or a new owner module. An empty query does not prove absence.
78
72
 
79
- **UNJUSTIFIED** when all four hold (`.bkit/jsonl.md` § Deferral Reason):
73
+ Set UNJUSTIFIED when all four tests hold (`.bkit/jsonl.md` § Deferral Reason):
80
74
 
81
75
  1. `remediation` names specific files and a bounded edit, not a new architecture.
82
76
  2. The surface is inside files the cycle already touched.
83
- 3. No external blocker: no missing decision, credential, upstream fix, or confirmation.
84
- 4. `reason` is `scope-declared`, and the row is the only place it was called out of scope. Test 4 carries the weight.
77
+ 3. No external blocker exists: no missing decision, credential, upstream fix or confirmation.
78
+ 4. `reason` is `scope-declared`, and the row is the only place the work was called out of scope. Test 4 carries the most weight.
85
79
 
86
- Never set `unjustified` while repairing a missing or illegal `reason`. That repair uses one of the first four enum values. This step is the only place `unjustified` is set.
80
+ When you repair a missing or illegal `reason`, use one of the first four enum values, never `unjustified`. Set `unjustified` in Step 9 only.
87
81
 
88
- **KEEP needs a trigger** ("before launch", "when N users", a dependency version). No trigger, or trigger fired → another verdict. Row on third consecutive KEEP → NEEDS ISSUE or ACCEPTED.
82
+ **KEEP needs a trigger:** Each KEEP row names its trigger, such as "before launch", "when N users" or a dependency version.
89
83
 
90
- **Cluster** open rows by package and `category`. 3+ in one group → one `own-cycle` issue in `Expected`, not one per row.
84
+ - **If** the row has no trigger, **or** its trigger has fired → give it another verdict.
85
+ - **If** the row is on its third KEEP in a row → give it NEEDS ISSUE or ACCEPTED.
91
86
 
92
- ### Pre-Flight / Dependencies
87
+ **Cluster:** Group the open rows by package and `category`.
93
88
 
94
- **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.
89
+ - **If** a group holds 3 or more rows → propose one `own-cycle` issue for the group in `Expected`, not one per row.
95
90
 
96
- **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.
91
+ ### Pre-Flight / Dependencies
97
92
 
98
93
  #### Core
99
94
 
100
- Always verify.
101
-
102
- - [ ] **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.
103
- - [ ] **Ledger:** Steps 3–9 — `docs/deferrals.jsonl` and `.bkit/jsonl.md`. Fallback: file absent → one `N/A` row after Step 3 and STOP.
104
- - [ ] **Git History:** Steps 2, 7 — commits since the previous report, 90-day churn. Fallback: closures and churn `Not Checked`.
105
- - [ ] **Web:** Step 10 — fetch anchor standards. Fallback: versions recorded as unread.
95
+ - [ ] **Permissions:** every blocked call is recorded.
96
+ - [ ] **Ledger:** Steps 3-9 — `docs/deferrals.jsonl` and `.bkit/jsonl.md`. Fallback: **If** the file is absent → write one `N/A` row after Step 3, then **STOP**.
97
+ - [ ] **Git History:** Steps 2, 7 — the commits since the previous report, and 90-day churn. Fallback: mark closures and churn `Not Checked`.
98
+ - [ ] **Web:** Step 10 — fetch the anchor standards. Fallback: record the versions as unread.
106
99
 
107
100
  #### Conditional
108
101
 
109
- Verify only when applicable.
110
-
111
- - [ ] **Language Server:** Typed language → Steps 5, 6 — symbol location and callers, e.g. Serena, `tsserver`. Fallback: text search. A close that needs a caller set stays a hypothesis until corroborated.
112
- - [ ] **Tracker:** Issues wired → Steps 6, 8 — open issue, acceptance criteria, comments on issues closed since the previous report. Fallback: tracker pointers `Not Checked`.
113
- - [ ] **Run Stats:** `.bkit/stats.jsonl` has `outcome` rows → Step 3 — sum `deferralsAdded`. Fallback: inflow `Not Checked`.
102
+ - [ ] **Language Server:** **If** the language is typed → Steps 5, 6 — symbol location and callers (e.g., Serena, `tsserver`). Fallback: text search. A close that needs a caller set stays a hypothesis until something corroborates it.
103
+ - [ ] **Tracker:** **If** issues are wired → Steps 6, 8 — open issues, acceptance criteria, and comments on the issues closed since the previous report. Fallback: mark tracker pointers `Not Checked`.
104
+ - [ ] **Run Stats:** **If** `.bkit/stats.jsonl` has `outcome` rows → Step 3 — sum `deferralsAdded`. Fallback: mark inflow `Not Checked`.
114
105
 
115
106
  ### 🔒 Gate 1: Prerequisites Check
116
107
 
117
- **Checkpoint.** Verify and check `[x]` all applicable boxes above, then continue to `Probe Steps` without asking.
118
-
119
- - [ ] **Gaps named:** every missing item names its fallback and `Not Checked` entry.
120
- - [ ] **Gate 1 - Verified:** All Core items checked. All applicable Conditional items checked.
108
+ - [ ] **Gaps named:** every missing item names its fallback and its `Not Checked` entry.
109
+ - [ ] **Gate 1 — Verified:** every item above, every Core item and every applicable Conditional item is checked.
121
110
 
122
111
  ### Probe Steps
123
112
 
124
- - [ ] **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.
125
- - [ ] **Step 2 — Closures:** Re-verify every DONE and SUPERSEDED row from the previous report at `HEAD`. Each that no longer holds = finding, with what changed. **Done when:** `Closures` holds every row, each failure, and the failure rate, or run marked baseline.
126
- - [ ] **Step 3 — Fold:** Last-row-wins per `key`, not per line. Append-only (`.gitattributes` `merge=union`); editing a line keeps stale copy beside replacement. Highest numeric `ts` wins (`.bkit/jsonl.md` § Updating a Row). Non-numeric `ts` on a `key` → last line in file is latest. Open = every winning row with `status != "CLOSED"`, including `TRIAGED`, `RESOLVED`, `BLOCKED`, `SUPERSEDED`, `CANCELLED`, free text after the word, missing `status`, and any value outside the enum. Finished-looking words ≠ done. Order: `CRITICAL`, then `HIGH`, then oldest `ts`. Compare `severity` case-insensitively. No `severity` → assign with verdict. Trend vs previous report: open count; inflow = sum `deferralsAdded` on `outcome` rows in `.bkit/stats.jsonl` since previous run where field exists; outflow = rows that became `CLOSED` since; age histogram by `ts`; share of open rows missing `severity` or `reason`. Large open set may be partial pass → record rows verified / rows open. Invisible to fold: deferral with no `key`, or recorded only in a PR description. **Done when:** `Trend` holds counts, histogram, inflow, outflow, missing-field share, verified / open, and those limits, or `N/A` and STOP.
127
- - [ ] **Step 4 — Defects:** Winning row of each `key`. Do not append. `Expected` = row writer appends: copy latest row, change only defective field, same `key`, `ts` minted at append, never literal and never in the future.
113
+ - [ ] **Step 1 — Previous Run:** **Done when:** `Previous Run` holds the closure rate, or the run is marked baseline.
114
+ - [ ] **Step 2 — Closures:** Re-verify at `HEAD` every DONE and SUPERSEDED row from the previous report. Record each one that no longer holds as a finding, with what changed. **Done when:** `Closures` holds every row, each failure and the failure rate, or the run is marked baseline.
115
+ - [ ] **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.
116
+ - The row with the highest numeric `ts` wins (`.bkit/jsonl.md` § Updating a Row).
117
+ - **If** a `key` has a non-numeric `ts` → the last line in the file is the latest.
118
+ - A row is open when its winning row has `status != "CLOSED"`. That includes `TRIAGED`, `RESOLVED`, `BLOCKED`, `SUPERSEDED`, `CANCELLED`, free text after the word, a missing `status` and any value outside the enum, because a word that looks finished does not mean done.
119
+ - Order the open rows `CRITICAL` first, then `HIGH`, then oldest `ts`.
120
+ - Compare `severity` case-insensitively.
121
+ - **If** a row has no `severity` → assign one with its verdict.
122
+ - Compare each of these figures with the previous report:
123
+ - The open count.
124
+ - Inflow: the sum of `deferralsAdded` on `outcome` rows in `.bkit/stats.jsonl` since the previous run, where the field exists.
125
+ - Outflow: the rows that became `CLOSED` since the previous run.
126
+ - An age histogram by `ts`.
127
+ - The share of open rows missing `severity` or `reason`.
128
+ - Record rows verified / rows open on every run, because a large open set may get only a partial pass.
129
+ - Record the fold's limits: it cannot see a deferral with no `key`, or one recorded only in a PR description.
130
+
131
+ **Done when:** `Trend` holds the counts, the histogram, inflow, outflow, the missing-field share, verified / open and those limits, or `N/A` is recorded → **STOP**.
132
+
133
+ - [ ] **Step 4 — Defects:** Check the winning row of each `key`, without appending. `Expected` = the row the writer appends: a copy of the latest row with only the defective field changed, the same `key`, and a `ts` minted at append, never a literal and never in the future.
128
134
 
129
135
  <!-- prettier-ignore -->
130
136
  | Field | Defect | Expected row |
131
137
  | --- | --- | --- |
132
- | `ts` | Not numeric Unix milliseconds: a string, seconds, or missing. Fold order is then undefined | The same row with a fresh `ts` |
133
- | `status` | Outside `OPEN` / `TRIAGED` / `CLOSED` (`RESOLVED`, `BLOCKED`, `SUPERSEDED`, free text) | `TRIAGED` where the row records analysis, otherwise `OPEN`, old word kept in `description`. `CLOSED` comes only from a verdict |
134
- | `reason` | Missing, or outside `scope-declared` / `hard-blocked` / `needs-decision` / `own-cycle` / `unjustified` | One of the first four the row's text supports, old text kept in `description`. Never `unjustified` |
138
+ | `ts` | Not numeric Unix milliseconds: a string, seconds, or missing. The fold order is then undefined | The same row with a fresh `ts` |
139
+ | `status` | Outside `OPEN` / `TRIAGED` / `CLOSED` (`RESOLVED`, `BLOCKED`, `SUPERSEDED`, free text) | `TRIAGED` where the row records analysis, otherwise `OPEN`, with the old word kept in `description`. `CLOSED` comes only from a verdict |
140
+ | `reason` | Missing, or outside `scope-declared` / `hard-blocked` / `needs-decision` / `own-cycle` / `low-severity` / `unjustified` | One of the first four values that the row's text supports, with the old text kept in `description`. Never `unjustified`, and `low-severity` only on a `LOW` row |
135
141
 
136
- Winning row with future `ts` → finding names `key` for owner. No correction row. **Done when:** count of each defect, and each `Expected` row, in `Defects`, or `none`.
142
+ **If** a winning row has a future `ts` → name its `key` in a finding for the owner, and propose no correction row. **Done when:** `Defects` holds the count of each defect and each `Expected` row, or `none`.
137
143
 
138
- - [ ] **Step 5 — Source:** No verdict before this step. Outstanding-work claims as unreliable as done claims.
144
+ - [ ] **Step 5 — Source:** Give no verdict before this step. Claims of outstanding work are as unreliable as claims of done work.
139
145
 
140
146
  <!-- prettier-ignore -->
141
147
  | Row claims | Check with |
142
148
  | --- | --- |
143
- | "`X` should be extracted, renamed, or consolidated" | Language server, symbol lookup. Exists, and at what path now? A symbol that moved is SUPERSEDED |
144
- | "Every caller of `Y` still does Z" | Language server, references, then read the callers. This is DONE evidence |
149
+ | "`X` should be extracted, renamed, or consolidated" | Language server symbol lookup: does it exist, and at what path now? A symbol that moved is SUPERSEDED |
150
+ | "Every caller of `Y` still does Z" | Language server references, then read the callers. This is DONE evidence |
145
151
  | "The guard is missing at N sites" | Text search for the literal signature. Counting sites is a pattern question |
146
152
  | Migrations, workflows, SQL, docs, or other ledgers | Text search. A language server reads one language |
147
153
 
148
- Pace reference queries. Re-run empty or surprisingly low results before close verdict. Partial answer indistinguishable from real. Empty is inconclusive, not absence. **Done when:** every row verified this pass has evidence and the tool on its finding. Unverified rows stay counted in `Trend` and are not passed.
154
+ 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. **Done when:** every row verified this pass has its evidence and the tool on its finding. Unverified rows stay counted in `Trend`, and are not passed.
149
155
 
150
- - [ ] **Step 6 — Reasons:** `reason` = why deferred. Each value implies a check. Re-test enum value Step 4 assigned the same way. UNJUSTIFIED replaces it only when Step 9's four tests hold.
156
+ - [ ] **Step 6 — Reasons:** `reason` records why the row was deferred, and each value implies a check. Re-test the enum value that Step 4 assigned in the same way. UNJUSTIFIED replaces a value only when Step 9's four tests hold.
151
157
 
152
158
  <!-- prettier-ignore -->
153
159
  | `reason` | Check |
@@ -155,13 +161,14 @@ Pace reference queries. Re-run empty or surprisingly low results before close ve
155
161
  | `hard-blocked` | Is the blocker the row names still there? |
156
162
  | `needs-decision` | Was the decision made since? Search `docs/decisions.jsonl` |
157
163
  | `own-cycle` | Does a plan or an issue for it exist? |
164
+ | `low-severity` | Is it still `LOW`? The four tests never make it `unjustified` |
158
165
  | `scope-declared` | Does the cited doc section exist, and does it predate the row? |
159
166
 
160
- Blocker lifted = highest-yield finding. Flag on verdict. Apply KEEP trigger rule. **Done when:** every verified row's reason, and every KEEP trigger, has a result on the finding.
167
+ A lifted blocker is the highest-yield finding, so flag it on the verdict. Apply the KEEP trigger rule. **Done when:** every verified row's reason and every KEEP trigger has a result on its finding.
161
168
 
162
- - [ ] **Step 7 — Cost:** Severity = gap badness, not carry cost. Each row still open after Step 6: churn = commits touching surface in last 90 days (e.g. `git log --since=90.days --oneline -- <path>`); related rows in `docs/failures.jsonl` and `.bkit/friction.jsonl` on same symbol or path. High churn + related failures → raise severity. Risk already a failure row = live bug: pair failure `key`, raise severity, name `bkit-audit-failures` for bug triage. **Done when:** `Cost` row per surviving open row: churn, related keys, severity change.
163
- - [ ] **Step 8 — Pointers:** (a) TRACKED: open issue acceptance criteria include deferred scope; issue not stale and not `Low` across 3+ `bkit-audit-issues` passes. Either fails → say which: extend criteria, or verdict NEEDS ISSUE. (b) Row pointing at closed issue: read what closed it. DONE if scope landed, NEEDS ISSUE if dropped. (c) Deferrals with no row: each issue closed since previous report → read closing comments for deferred items. No row keyed → `Expected` = row to append. **Done when:** `Pointers` lists issue checks and comment-only deferrals, or `none`.
164
- - [ ] **Step 9 — Classify:** Every row as Step 5 left it gets one verdict. Adjudicate `unjustified` here, and only here. Cluster before naming issues. `needs-decision` and every ACCEPTED row → `Decisions` with who decides. This run does not append, open issues, or do the work.
169
+ - [ ] **Step 7 — Cost:** Severity measures how bad the gap is, not what it costs to carry. For each row still open after Step 6, measure churn: the commits touching its surface in the last 90 days (e.g., `git log --since=90.days --oneline -- <path>`). Find the related rows in `docs/failures.jsonl` and `.bkit/friction.jsonl` on the same symbol or path. **If** churn is high **and** related failures exist → raise the severity. **If** the risk is already a failure row → treat it as a live bug: pair the failure `key`, raise the severity, and name `bkit-audit-failures` for the bug triage. **Done when:** `Cost` holds one row per surviving open row, with its churn, related keys and severity change.
170
+ - [ ] **Step 8 — Pointers:** (a) For each TRACKED row, check that the open issue's acceptance criteria include the deferred scope, and that the issue is not stale and has not been `Low` across 3 or more `bkit-audit-issues` passes. **If** either check fails → say which fix applies: extend the criteria, or give the verdict NEEDS ISSUE. (b) For each row that points at a closed issue, read what closed it. **If** the scope landed → DONE. **If** the scope was dropped → NEEDS ISSUE. (c) For each issue closed since the previous report, read its closing comments for deferred items. **If** a deferred item has no row keyed to it → `Expected` = the row to append. **Done when:** `Pointers` lists the issue checks and the comment-only deferrals, or `none`.
171
+ - [ ] **Step 9 — Classify:** Give every row, as Step 5 left it, one verdict. Adjudicate `unjustified` here, and only here. Cluster the rows before naming issues. Put every `needs-decision` row and every ACCEPTED row in `Decisions`, with who decides. This run does not append rows, open issues or do the work.
165
172
 
166
173
  <!-- prettier-ignore -->
167
174
  | Finding | Expected |
@@ -180,39 +187,38 @@ Blocker lifted = highest-yield finding. Flag on verdict. Apply KEEP trigger rule
180
187
  | Data defect | The correction row, or the future-`ts` key for the owner |
181
188
  | OTHER | Where it goes |
182
189
 
183
- **Done when:** every verified row has one verdict. `Decisions` lists each `needs-decision` and ACCEPTED row with who decides, or `none`.
190
+ **Done when:** every verified row has one verdict, and `Decisions` lists each `needs-decision` and ACCEPTED row with who decides, or `none`.
184
191
 
185
- - [ ] **Step 10 — Standards:** Confirm current version per anchor standard; read changes since previous report's version. `Standards Coverage`: one row per practice (principal and interest, debt quadrant, hotspots, review triggers for deferred records) and per `reason` value → checked (name step) / not applicable (why) / finding. Unapplied recommended practice → adopt (propose step) / reject (why) / not applicable. **Done when:** no empty row.
186
- - [ ] **Step 11 — Anything Else:** (a) Everything changed since previous report's commit touching deferrals (schema and writers in `.bkit/jsonl.md`, design, plan, build, and ship steps that write rows, ship deferral check `@bkit-ship-deferred-sweep`, issues rows point at) → one-line verdict each. (b) Bounded ~30 min pass: what a senior EM owning a technical-debt register flags that no step asks; read since previous run (incidents, `bkit-audit-logs` sweeps, new `docs/failures.jsonl` rows, 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`.
192
+ - [ ] **Step 10 — 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 practice (principal and interest, the debt quadrant, hotspots, review triggers for deferred records) and one per `reason` value, 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.
193
+ - [ ] **Step 11 — Anything Else:** (a) Give a one-line verdict on each change since the previous report's commit that touches deferrals: the schema and writers in `.bkit/jsonl.md`, the design, plan, build and ship steps that write rows, the ship deferral check `@bkit-ship-deferred-sweep`, and the issues that rows point at. (b) In a bounded pass of about 30 minutes, note what a senior EM owning a technical-debt register would flag that no step asks about. Read what happened since the previous run (incidents, `bkit-audit-logs` sweeps, new `docs/failures.jsonl` rows, vendor status incidents), 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`.
187
194
 
188
195
  ### 🔒 Gate 2: Probes Check
189
196
 
190
- **Checkpoint.** Verify and check `[x]` all boxes below, then continue to `Findings` without asking.
191
-
192
- - [ ] **Steps complete:** every step `[x]`, or explicit skip with evidence the surface is absent.
193
- - [ ] **Evidence:** every finding cites re-checkable evidence and the tool behind it.
194
- - [ ] **Read-only:** no ledger line, code, or config changed. Every correction and close row is `Expected` only.
195
- - [ ] **Positive close:** every DONE and SUPERSEDED cites a positive reason, never an empty query.
196
- - [ ] **Gate 2 - Verified:** Every checkbox above independently verified and checked off.
197
+ - [ ] **Steps complete:** every step is `[x]`, or skipped with evidence that its surface is absent.
198
+ - [ ] **Evidence:** every finding cites evidence someone can check again, and the tool that produced it.
199
+ - [ ] **Read-only:** no ledger line, code or config changed.
200
+ - [ ] **Rows proposed only:** every correction and close row is marked `Expected`.
201
+ - [ ] **Positive close:** every `DONE` and `SUPERSEDED` cites a positive reason, never an empty query.
202
+ - [ ] **Gate 2 — Verified:** every item above holds.
197
203
 
198
204
  ## Findings
199
205
 
200
206
  <!-- prettier-ignore -->
201
207
  | Severity | Use |
202
208
  | --- | --- |
203
- | `CRITICAL` | Deferred gap is data loss, a security hole, or a broken workflow with no workaround. Risk already showing as a `CRITICAL` failure |
204
- | `HIGH` | Blocker has lifted on work that still does real damage. Deferral paired with a failure row. Unjustified in-scope work that has a workaround |
205
- | `MEDIUM` | Data defect (`ts`, `status`, `reason`). KEEP whose trigger has fired. Real work with no issue. Reason no longer holds |
206
- | `LOW` | KEEP with no trigger. Missing `severity`. Locator drift. Superseded surface that changes no result |
209
+ | `CRITICAL` | The deferred gap is data loss, a security hole, or a broken workflow with no workaround. The risk already shows as a `CRITICAL` failure |
210
+ | `HIGH` | A blocker has lifted on work that still does real damage. A deferral is paired with a failure row. Unjustified in-scope work has a workaround |
211
+ | `MEDIUM` | A data defect (`ts`, `status`, `reason`). A KEEP whose trigger has fired. Real work with no issue. A reason that no longer holds |
212
+ | `LOW` | A KEEP with no trigger. A missing `severity`. Locator drift. A superseded surface that changes no result |
207
213
 
208
- Scale per `.bkit/jsonl.md` § Severity. Within a severity: oldest `ts` first. Finding keeps severity when it becomes a ledger row or an issue. Row bucket = ledger severity, or verdict-assigned.
214
+ 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.
209
215
 
210
216
  <!-- prettier-ignore -->
211
217
  | ID | Severity | Verdict | Location | Evidence | Expected |
212
218
  | --- | --- | --- | --- | --- | --- |
213
219
  | PENDING | PENDING | PENDING | PENDING | PENDING | PENDING |
214
220
 
215
- Empty and clean → one row `None`.
221
+ **If** the run finds nothing → write one row: `None`.
216
222
 
217
223
  ## Report
218
224
 
@@ -277,17 +283,17 @@ PENDING
277
283
 
278
284
  ### 🔒 Gate 3: Report Check
279
285
 
280
- **Checkpoint.** Verify and check `[x]` all boxes below, then stop.
281
-
282
- - [ ] **No placeholders:** Findings table and every `Report` section have no `PENDING`.
283
- - [ ] **Summary:** names count per severity, count per verdict, and rows verified / rows open.
284
- - [ ] **Series:** `Trend` open count, inflow, and outflow beside previous report's numbers, or marked baseline.
285
- - [ ] **Writes:** only this report and template `Project Instructions` changed; throwaway worktrees / remote targets removed.
286
- - [ ] **Process Improvements:** `Universal` = proposed step changes, template untouched; `Project` = edits applied below `bkit:end`; each `none` if empty.
287
- - [ ] **Suggested Issues:** every `MEDIUM`+ finding ID in exactly one row; every row has a `Next Step`.
288
- - [ ] **Gate 3 - Verified:** Every checkbox above independently verified and checked off.
289
-
290
- > `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.
286
+ - [ ] **No placeholders:** no `PENDING` is left.
287
+ - [ ] **Summary:** `Summary` gives the count per severity.
288
+ - [ ] **Verdict counts:** `Summary` gives the count per verdict.
289
+ - [ ] **Coverage:** `Summary` gives rows verified / rows open.
290
+ - [ ] **Series:** the report shows `Trend` open count, inflow, and outflow beside the previous report's numbers, or marks the run as baseline.
291
+ - [ ] **Writes:** this run changed only this report and the template's `Project Instructions`.
292
+ - [ ] **Throwaways removed:** every throwaway worktree or remote target is removed.
293
+ - [ ] **Process Improvements:** `Universal` and `Project` are both filled.
294
+ - [ ] **Suggested Issues:** every `MEDIUM`+ finding ID is in exactly one `Suggested Issues` row.
295
+ - [ ] **Next Step:** every `Suggested Issues` row has a `Next Step`.
296
+ - [ ] **Gate 3 — Verified:** every item above holds.
291
297
 
292
298
  <!-- bkit:end -->
293
299