@cbartens/bkit 5.5.1 → 6.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (425) hide show
  1. package/.bkit/README.md +167 -154
  2. package/.bkit/core/.agents/context.md +95 -29
  3. package/.bkit/core/.agents/docs.md +18 -15
  4. package/.bkit/core/.agents/plugins/bkit/hooks/bkit-gateguard.cjs +1 -0
  5. package/.bkit/core/.agents/plugins/bkit/hooks/bkit-guardrails.cjs +6 -5
  6. package/.bkit/core/.agents/plugins/bkit/hooks/bkit-readguard.cjs +1 -0
  7. package/.bkit/core/.agents/plugins/bkit/hooks/bkit-rules.cjs +65 -0
  8. package/.bkit/core/.agents/rules.md +112 -102
  9. package/.bkit/core/.agents/skills.md +63 -15
  10. package/.bkit/core/.bkit/README.md +167 -154
  11. package/.bkit/core/.bkit/authoring.md +747 -0
  12. package/.bkit/core/.bkit/cli.md +407 -0
  13. package/.bkit/core/.bkit/cloud.md +283 -195
  14. package/.bkit/core/.bkit/comparison.md +45 -43
  15. package/.bkit/core/.bkit/install.md +166 -95
  16. package/.bkit/core/.bkit/jsonl.md +339 -196
  17. package/.bkit/core/.bkit/pipeline.md +142 -145
  18. package/.bkit/core/.bkit/prompts.md +295 -264
  19. package/.bkit/core/.bkit/providers.md +460 -277
  20. package/.bkit/core/.bkit/router.md +69 -0
  21. package/.bkit/core/.bkit/templates.md +530 -256
  22. package/.bkit/core/.bkit/trackers.md +116 -65
  23. package/.bkit/core/.bkit/workflows.md +742 -618
  24. package/.bkit/core/.claude/hooks/bkit-gateguard.cjs +2 -2
  25. package/.bkit/core/.claude/hooks/bkit-guardrails.cjs +3 -3
  26. package/.bkit/core/.claude/hooks/bkit-preflight.sh +45 -14
  27. package/.bkit/core/.codex/hooks/bkit-guardrails.cjs +3 -3
  28. package/.bkit/core/.codex/hooks/bkit-rules.cjs +57 -0
  29. package/.bkit/core/.cursor/hooks/bkit-guardrails.cjs +7 -7
  30. package/.bkit/core/.cursor/hooks/bkit-preflight.sh +47 -12
  31. package/.bkit/core/.opencode/plugin/bkit-rules.js +89 -0
  32. package/.bkit/core/AGENTS.md +6 -80
  33. package/.bkit/core/docs/templates/bkit-audit-accessibility.md +128 -130
  34. package/.bkit/core/docs/templates/bkit-audit-adoption.md +104 -94
  35. package/.bkit/core/docs/templates/bkit-audit-agents.md +96 -98
  36. package/.bkit/core/docs/templates/bkit-audit-aio-seo.md +100 -103
  37. package/.bkit/core/docs/templates/bkit-audit-analytics.md +141 -107
  38. package/.bkit/core/docs/templates/bkit-audit-annotations.md +99 -97
  39. package/.bkit/core/docs/templates/bkit-audit-app-performance.md +122 -121
  40. package/.bkit/core/docs/templates/bkit-audit-app-store.md +158 -101
  41. package/.bkit/core/docs/templates/bkit-audit-architecture.md +114 -96
  42. package/.bkit/core/docs/templates/bkit-audit-ci-performance.md +76 -97
  43. package/.bkit/core/docs/templates/bkit-audit-config.md +123 -101
  44. package/.bkit/core/docs/templates/bkit-audit-cost.md +86 -99
  45. package/.bkit/core/docs/templates/bkit-audit-coverage.md +76 -93
  46. package/.bkit/core/docs/templates/bkit-audit-database.md +102 -95
  47. package/.bkit/core/docs/templates/bkit-audit-dead-code.md +165 -108
  48. package/.bkit/core/docs/templates/bkit-audit-deferrals.md +115 -109
  49. package/.bkit/core/docs/templates/bkit-audit-dependencies.md +265 -113
  50. package/.bkit/core/docs/templates/bkit-audit-documentation.md +119 -118
  51. package/.bkit/core/docs/templates/bkit-audit-duplication.md +140 -111
  52. package/.bkit/core/docs/templates/bkit-audit-failures.md +111 -106
  53. package/.bkit/core/docs/templates/bkit-audit-flakes.md +100 -99
  54. package/.bkit/core/docs/templates/bkit-audit-gates.md +107 -103
  55. package/.bkit/core/docs/templates/bkit-audit-issues.md +105 -105
  56. package/.bkit/core/docs/templates/bkit-audit-llm.md +134 -85
  57. package/.bkit/core/docs/templates/bkit-audit-logs.md +124 -125
  58. package/.bkit/core/docs/templates/bkit-audit-models.md +99 -78
  59. package/.bkit/core/docs/templates/bkit-audit-privacy.md +56 -76
  60. package/.bkit/core/docs/templates/bkit-audit-prompts.md +63 -78
  61. package/.bkit/core/docs/templates/bkit-audit-red-team.md +125 -93
  62. package/.bkit/core/docs/templates/bkit-audit-reliability.md +97 -96
  63. package/.bkit/core/docs/templates/bkit-audit-repo.md +170 -98
  64. package/.bkit/core/docs/templates/bkit-audit-security.md +207 -121
  65. package/.bkit/core/docs/templates/bkit-audit-slop.md +78 -95
  66. package/.bkit/core/docs/templates/bkit-audit-testing.md +163 -139
  67. package/.bkit/core/docs/templates/bkit-audit-usability.md +114 -96
  68. package/.bkit/core/docs/templates/bkit-plan.md +158 -281
  69. package/.bkit/core/engine/checks/after/auth.ts +40 -37
  70. package/.bkit/core/engine/checks/after/ci-yml.ts +104 -31
  71. package/.bkit/core/engine/checks/after/github.ts +95 -17
  72. package/.bkit/core/engine/checks/after/index.ts +21 -8
  73. package/.bkit/core/engine/checks/after/suppression.ts +8 -5
  74. package/.bkit/core/engine/checks/after/tools.ts +125 -123
  75. package/.bkit/core/engine/checks/before/context-fetch.ts +227 -33
  76. package/.bkit/core/engine/checks/before/env.ts +3 -3
  77. package/.bkit/core/engine/checks/before/files.ts +5 -4
  78. package/.bkit/core/engine/checks/before/index.ts +25 -1
  79. package/.bkit/core/engine/checks/before/repo.ts +208 -2
  80. package/.bkit/core/engine/checks/status-holes.ts +916 -123
  81. package/.bkit/core/engine/checks/tips/catalogue.ts +82 -20
  82. package/.bkit/core/engine/checks/tips/detect.ts +66 -0
  83. package/.bkit/core/engine/checks/tips/index.ts +52 -11
  84. package/.bkit/core/engine/cli.ts +251 -130
  85. package/.bkit/core/engine/commands/analysis.ts +282 -199
  86. package/.bkit/core/engine/commands/ci/ci.ts +363 -29
  87. package/.bkit/core/engine/commands/ci/pins.ts +172 -0
  88. package/.bkit/core/engine/commands/ci/push-gate.ts +223 -0
  89. package/.bkit/core/engine/commands/comply.ts +77 -103
  90. package/.bkit/core/engine/commands/install/doctor.ts +2 -2
  91. package/.bkit/core/engine/commands/install/install.ts +57 -18
  92. package/.bkit/core/engine/commands/install/uninstall.ts +86 -55
  93. package/.bkit/core/engine/commands/install/upgrade.ts +32 -15
  94. package/.bkit/core/engine/commands/land.ts +139 -18
  95. package/.bkit/core/engine/commands/lib.ts +381 -22
  96. package/.bkit/core/engine/commands/registry.ts +10 -2
  97. package/.bkit/core/engine/commands/setup/setup.ts +8 -7
  98. package/.bkit/core/engine/commands/stats.ts +260 -0
  99. package/.bkit/core/engine/commands/tips.ts +10 -5
  100. package/.bkit/core/engine/commands/workflow/branches.ts +2215 -176
  101. package/.bkit/core/engine/commands/workflow/challenge.ts +748 -0
  102. package/.bkit/core/engine/commands/workflow/completeness.ts +109 -0
  103. package/.bkit/core/engine/commands/workflow/context.ts +1249 -47
  104. package/.bkit/core/engine/commands/workflow/counters.ts +483 -95
  105. package/.bkit/core/engine/commands/workflow/decisions.ts +585 -0
  106. package/.bkit/core/engine/commands/workflow/disk.ts +238 -56
  107. package/.bkit/core/engine/commands/workflow/fids.ts +811 -33
  108. package/.bkit/core/engine/commands/workflow/issues.ts +413 -64
  109. package/.bkit/core/engine/commands/workflow/ledgers.ts +1333 -36
  110. package/.bkit/core/engine/commands/workflow/locks.ts +28 -2
  111. package/.bkit/core/engine/commands/workflow/plan-blocks.ts +691 -0
  112. package/.bkit/core/engine/commands/workflow/plan-versions.ts +21 -0
  113. package/.bkit/core/engine/commands/workflow/plans.ts +257 -0
  114. package/.bkit/core/engine/commands/workflow/prs.ts +178 -33
  115. package/.bkit/core/engine/commands/workflow/repo.ts +66 -8
  116. package/.bkit/core/engine/commands/workflow/roadmap.ts +72 -22
  117. package/.bkit/core/engine/commands/workflow/run-facts.ts +492 -0
  118. package/.bkit/core/engine/commands/workflow/runs.ts +827 -79
  119. package/.bkit/core/engine/commands/workflow/runtime.ts +25 -1
  120. package/.bkit/core/engine/commands/workflow/skills.ts +1 -0
  121. package/.bkit/core/engine/commands/workflow/status.ts +329 -33
  122. package/.bkit/core/engine/commands/workflow/step-table.ts +381 -0
  123. package/.bkit/core/engine/commands/workflow/steps.ts +841 -105
  124. package/.bkit/core/engine/commands/workflow/summary-findings.ts +177 -0
  125. package/.bkit/core/engine/commands/workflow/summary.ts +544 -0
  126. package/.bkit/core/engine/commands/workflow/tasks.ts +409 -0
  127. package/.bkit/core/engine/commands/workflow/test-blocks.ts +254 -0
  128. package/.bkit/core/engine/commands/workflow/tests-changed.ts +201 -0
  129. package/.bkit/core/engine/commands/workflow/tests.ts +2124 -330
  130. package/.bkit/core/engine/commands/workflow/tracker.ts +1195 -0
  131. package/.bkit/core/engine/commands/workflow/workflows.ts +1197 -235
  132. package/.bkit/core/engine/commands/workflow/worktrees.ts +543 -24
  133. package/.bkit/core/engine/install/cloud-env.ts +251 -121
  134. package/.bkit/core/engine/install/context-ci-workflow.ts +102 -0
  135. package/.bkit/core/engine/install/manifest.ts +67 -17
  136. package/.bkit/core/engine/install/modules/antigravity.ts +3 -2
  137. package/.bkit/core/engine/install/modules/cloud.ts +24 -16
  138. package/.bkit/core/engine/install/modules/codex.ts +15 -2
  139. package/.bkit/core/engine/install/modules/core.ts +1196 -45
  140. package/.bkit/core/engine/install/modules/cursor.ts +6 -6
  141. package/.bkit/core/engine/install/modules/opencode.ts +18 -6
  142. package/.bkit/core/engine/install/template-notes.ts +130 -0
  143. package/.bkit/core/engine/install/version-file.ts +9 -4
  144. package/.bkit/core/engine/install/write.ts +5 -0
  145. package/.bkit/core/engine/ledgers/compact.ts +124 -0
  146. package/.bkit/core/engine/ledgers/journal.ts +291 -0
  147. package/.bkit/core/engine/ledgers/migrate.ts +92 -0
  148. package/.bkit/core/engine/ledgers/status.ts +249 -21
  149. package/.bkit/core/engine/ledgers/telemetry.ts +1397 -253
  150. package/.bkit/core/engine/render/hosts.ts +118 -14
  151. package/.bkit/core/engine/render/models.ts +12 -0
  152. package/.bkit/core/engine/shared/bkit-latest.ts +26 -4
  153. package/.bkit/core/engine/shared/branches.ts +4 -1
  154. package/.bkit/core/engine/shared/dep-updater.ts +60 -0
  155. package/.bkit/core/engine/shared/egress.ts +8 -1
  156. package/.bkit/core/engine/shared/json.ts +25 -7
  157. package/.bkit/core/engine/shared/package-manager.ts +9 -0
  158. package/.bkit/core/engine/shared/settings.ts +243 -31
  159. package/.bkit/core/engine/shared/text.ts +361 -0
  160. package/.bkit/core/engine/shared/timeouts.ts +2 -0
  161. package/.bkit/core/engine/tools/cli-doc.ts +111 -0
  162. package/.bkit/core/engine/tools/grammar-density.ts +215 -0
  163. package/.bkit/core/engine/tools/instructions-sources.ts +832 -0
  164. package/.bkit/core/engine/tools/instructions.ts +1802 -0
  165. package/.bkit/core/hooks/antigravity-hook.js +25 -10
  166. package/.bkit/core/hooks/gateguard-engine.js +54 -29
  167. package/.bkit/core/hooks/guardrails-shell.js +4 -5
  168. package/.bkit/core/hooks/guardrails-tiers.js +10 -4
  169. package/.bkit/core/hooks/preflight-linear.sh +9 -9
  170. package/.bkit/core/hooks/preflight-rules.sh +8 -0
  171. package/.bkit/core/hooks/readguard-engine.js +29 -10
  172. package/.bkit/core/hooks/session-rules-advisory.js +61 -0
  173. package/.bkit/core/prompts/bkit-audit-generate.md +202 -94
  174. package/.bkit/core/prompts/bkit-build-challenge-1.md +76 -34
  175. package/.bkit/core/prompts/bkit-build-challenge-2.md +85 -38
  176. package/.bkit/core/prompts/bkit-build-install-skills.md +50 -28
  177. package/.bkit/core/prompts/bkit-build-plan-convert.md +85 -0
  178. package/.bkit/core/prompts/bkit-build-plan-current.md +59 -36
  179. package/.bkit/core/prompts/bkit-build-plan-gaps-remediate.md +101 -36
  180. package/.bkit/core/prompts/bkit-build-plan-tasks.md +149 -0
  181. package/.bkit/core/prompts/bkit-build-plan-tests.md +120 -0
  182. package/.bkit/core/prompts/bkit-build-plan-verify.md +104 -43
  183. package/.bkit/core/prompts/bkit-debug-abort-handover.md +47 -32
  184. package/.bkit/core/prompts/bkit-debug-failure-diagnose.md +109 -57
  185. package/.bkit/core/prompts/bkit-debug-failure-remediate.md +65 -39
  186. package/.bkit/core/prompts/bkit-debug-failure-reproduce.md +53 -31
  187. package/.bkit/core/prompts/bkit-debug-failure-soak.md +65 -34
  188. package/.bkit/core/prompts/bkit-design-brainstorm-ideate-1.md +46 -31
  189. package/.bkit/core/prompts/bkit-design-brainstorm-ideate-2.md +45 -31
  190. package/.bkit/core/prompts/bkit-design-brainstorm-ideate-3.md +43 -30
  191. package/.bkit/core/prompts/bkit-design-generate.md +80 -46
  192. package/.bkit/core/prompts/bkit-design-organise.md +83 -32
  193. package/.bkit/core/prompts/bkit-design-review-1.md +70 -50
  194. package/.bkit/core/prompts/bkit-design-review-2.md +65 -46
  195. package/.bkit/core/prompts/bkit-design-spike.md +64 -40
  196. package/.bkit/core/prompts/bkit-design-update.md +53 -28
  197. package/.bkit/core/prompts/bkit-plan-generate.md +101 -29
  198. package/.bkit/core/prompts/bkit-plan-review-1.md +78 -41
  199. package/.bkit/core/prompts/bkit-plan-review-2.md +78 -35
  200. package/.bkit/core/prompts/bkit-plan-scope-check.md +116 -0
  201. package/.bkit/core/prompts/bkit-plan-update.md +86 -31
  202. package/.bkit/core/prompts/bkit-ship-conflict-resolve.md +94 -50
  203. package/.bkit/core/prompts/bkit-ship-deferred-sweep.md +91 -41
  204. package/.bkit/core/prompts/bkit-ship-update-docs.md +45 -24
  205. package/.bkit/core/prompts/bkit-utility-compress-markdown.md +65 -49
  206. package/.bkit/core/prompts/bkit-utility-update-decisions.md +87 -42
  207. package/.bkit/core/prompts/bkit-utility-update-deferrals.md +81 -37
  208. package/.bkit/core/prompts/bkit-utility-update-documentation.md +43 -25
  209. package/.bkit/core/prompts/bkit-utility-update-failures.md +84 -37
  210. package/.bkit/core/prompts/bkit-utility-update-knowledge.md +88 -42
  211. package/.bkit/core/prompts/bkit-utility-update-roadmap.md +92 -39
  212. package/.bkit/core/prompts/bkit-utility-update-tracker.md +159 -60
  213. package/.bkit/core/workflows/bkit-auto.md +89 -58
  214. package/.bkit/core/workflows/bkit-build.md +967 -517
  215. package/.bkit/core/workflows/bkit-debug.md +555 -387
  216. package/.bkit/core/workflows/bkit-design.md +319 -283
  217. package/.bkit/core/workflows/bkit-plan.md +319 -342
  218. package/.bkit/core/workflows/bkit-ship.md +525 -328
  219. package/.bkit/shared/.agents/plugins/bkit/hooks.json +10 -0
  220. package/.bkit/shared/.bkit/.env.example +2 -2
  221. package/.bkit/shared/.claude/bkit-cloud.md +12 -10
  222. package/.bkit/shared/.claude/settings.json +14 -0
  223. package/.bkit/shared/.codex/bkit-cloud.md +98 -0
  224. package/.bkit/shared/.codex/hooks.json +20 -0
  225. package/.bkit/shared/.cursor/bkit-cloud.md +3 -3
  226. package/.bkit/shared/.cursor/mcp.json +1 -1
  227. package/.bkit/shared/.cursor/rules/bkit-rules.mdc +1 -1
  228. package/.bkit/shared/.gitattributes +1 -1
  229. package/.bkit/shared/.mcp.json +1 -1
  230. package/.bkit/shared/.opencode/opencode.json +12 -1
  231. package/.bkit/shared/CLAUDE.md +6 -2
  232. package/.bkit/shared/GEMINI.md +5 -2
  233. package/.bkit/shared/docs/architecture.md +4 -7
  234. package/.bkit/shared/docs/data-schema.md +4 -7
  235. package/.bkit/shared/docs/deployments.md +241 -168
  236. package/.bkit/shared/docs/design.md +11 -12
  237. package/.bkit/shared/docs/noise.md +8 -7
  238. package/.bkit/shared/docs/observability.md +5 -8
  239. package/.bkit/shared/docs/security.md +35 -17
  240. package/.bkit/shared/docs/setup.md +29 -18
  241. package/.bkit/shared/docs/technology.md +3 -6
  242. package/.bkit/shared/docs/testing.md +289 -174
  243. package/.bkit/shared/gitignore +6 -2
  244. package/.bkit/templates/.claude/hooks/bkit-cloud-bootstrap.sh +15 -16
  245. package/.bkit/templates/.cursor/Dockerfile +12 -8
  246. package/.bkit/templates/.cursor/environment.json +1 -1
  247. package/.bkit/templates/.github/ISSUE_TEMPLATE/bkit-bug.yml +10 -8
  248. package/.bkit/templates/.github/ISSUE_TEMPLATE/bkit-change.yml +45 -12
  249. package/.bkit/templates/.github/ISSUE_TEMPLATE/bkit-idea.yml +3 -3
  250. package/.bkit/templates/.github/renovate.json5 +34 -6
  251. package/.bkit/templates/.github/workflows/bkit-ci.yml +54 -51
  252. package/.bkit/templates/.github/workflows/bkit-cloud.yml +34 -33
  253. package/.bkit/templates/.github/workflows/bkit-health.yml +97 -0
  254. package/.bkit/templates/.github/workflows/bkit-renovate.yml +5 -4
  255. package/.bkit/templates/.github/workflows/bkit-trivy.yml +5 -4
  256. package/.bkit/templates/.husky/pre-commit +2 -2
  257. package/.bkit/templates/.husky/pre-push +96 -36
  258. package/.bkit/templates/.prettierignore +6 -0
  259. package/.bkit/templates/.vale.ini +27 -27
  260. package/.bkit/templates/context/bkit-cloudrun.md +23 -15
  261. package/.bkit/templates/context/bkit-expo.md +70 -52
  262. package/.bkit/templates/context/bkit-github.md +93 -56
  263. package/.bkit/templates/context/bkit-inngest.md +21 -15
  264. package/.bkit/templates/context/bkit-maestro.md +22 -16
  265. package/.bkit/templates/context/bkit-playwright.md +23 -17
  266. package/.bkit/templates/context/bkit-resend.md +12 -10
  267. package/.bkit/templates/context/bkit-sentry.md +30 -20
  268. package/.bkit/templates/context/bkit-serena.md +8 -7
  269. package/.bkit/templates/context/bkit-stripe.md +14 -13
  270. package/.bkit/templates/context/bkit-supabase.md +16 -13
  271. package/.bkit/templates/context/bkit-tavily.md +14 -11
  272. package/.bkit/templates/context/bkit-vercel.md +27 -18
  273. package/.bkit/templates/docs/capabilities.md +15 -14
  274. package/.bkit/templates/scripts/ci/{check-accepted-divergences.mjs → bkit-check-accepted-divergences.mjs} +6 -3
  275. package/.bkit/templates/scripts/ci/{check-accepted-divergences.test.mjs → bkit-check-accepted-divergences.test.mjs} +3 -3
  276. package/.bkit/templates/scripts/ci/{check-capstone.mjs → bkit-check-capstone.mjs} +2 -2
  277. package/.bkit/templates/scripts/ci/{check-capstone.test.mjs → bkit-check-capstone.test.mjs} +4 -4
  278. package/.bkit/templates/scripts/ci/{check-dependency-audit.mjs → bkit-check-dependency-audit.mjs} +103 -18
  279. package/.bkit/templates/scripts/ci/{check-dependency-audit.test.mjs → bkit-check-dependency-audit.test.mjs} +31 -3
  280. package/.bkit/templates/scripts/ci/bkit-machine-lock.sh +387 -0
  281. package/.bkit/templates/scripts/ci/bkit-test-awake.mjs +75 -0
  282. package/.bkit/templates/scripts/ci/bkit-test-awake.test.mjs +160 -0
  283. package/.bkit/templates/scripts/ci/lanes/{resolve-push-base.mjs → bkit-resolve-push-base.mjs} +3 -3
  284. package/.bkit/templates/scripts/ci/lanes/{resolve-push-base.test.mjs → bkit-resolve-push-base.test.mjs} +4 -4
  285. package/.bkit/templates/scripts/cleanup/bkit-disk-prune.mjs +10 -2
  286. package/.bkit/templates/scripts/graphify/bkit-graph-drift.py +1 -1
  287. package/.bkit/templates/scripts/graphify/bkit-graph-eager.py +3 -3
  288. package/.bkit/templates/scripts/graphify/bkit-graph-embed.py +63 -0
  289. package/.bkit/templates/scripts/graphify/bkit-graph-imports.py +2 -2
  290. package/.bkit/templates/scripts/graphify/bkit-graph-pre-push.sh +69 -18
  291. package/.bkit/templates/scripts/graphify/bkit-graph-repair.py +3 -3
  292. package/.bkit/templates/scripts/graphify/bkit-graph-surface.py +1 -1
  293. package/.bkit/templates/scripts/graphify/bkit-graphify-graphml.py +1 -1
  294. package/.bkit/templates/scripts/graphify/bkit-graphify-rollup.py +197 -126
  295. package/.bkit/templates/scripts/graphify/bkit-graphify.sh +64 -41
  296. package/.bkit/templates/scripts/slop/bkit-slop-type-suppression.mjs +23 -7
  297. package/.bkit/templates/slop-scan.config.json +9 -2
  298. package/CHANGELOG.md +231 -0
  299. package/README.md +278 -89
  300. package/dist/checks/after/auth.js +36 -33
  301. package/dist/checks/after/ci-yml.js +91 -30
  302. package/dist/checks/after/github.js +91 -17
  303. package/dist/checks/after/index.js +22 -11
  304. package/dist/checks/after/suppression.js +8 -5
  305. package/dist/checks/after/tools.js +111 -114
  306. package/dist/checks/before/context-fetch.js +218 -33
  307. package/dist/checks/before/env.js +3 -3
  308. package/dist/checks/before/files.js +5 -3
  309. package/dist/checks/before/index.js +20 -3
  310. package/dist/checks/before/repo.js +197 -2
  311. package/dist/checks/status-holes.js +739 -114
  312. package/dist/checks/tips/catalogue.js +70 -19
  313. package/dist/checks/tips/detect.js +62 -0
  314. package/dist/checks/tips/index.js +51 -9
  315. package/dist/cli.js +234 -124
  316. package/dist/commands/analysis.js +174 -141
  317. package/dist/commands/ci/ci.js +302 -25
  318. package/dist/commands/ci/pins.js +142 -0
  319. package/dist/commands/ci/push-gate.js +194 -0
  320. package/dist/commands/comply.js +54 -91
  321. package/dist/commands/install/doctor.js +2 -2
  322. package/dist/commands/install/install.js +50 -19
  323. package/dist/commands/install/uninstall.js +82 -55
  324. package/dist/commands/install/upgrade.js +21 -11
  325. package/dist/commands/land.js +137 -17
  326. package/dist/commands/lib.js +295 -21
  327. package/dist/commands/registry.js +10 -2
  328. package/dist/commands/setup/setup.js +8 -7
  329. package/dist/commands/stats.js +175 -0
  330. package/dist/commands/tips.js +7 -3
  331. package/dist/commands/workflow/branches.js +1873 -152
  332. package/dist/commands/workflow/challenge.js +609 -0
  333. package/dist/commands/workflow/completeness.js +97 -0
  334. package/dist/commands/workflow/context.js +1045 -46
  335. package/dist/commands/workflow/counters.js +385 -86
  336. package/dist/commands/workflow/decisions.js +484 -0
  337. package/dist/commands/workflow/disk.js +214 -56
  338. package/dist/commands/workflow/fids.js +706 -33
  339. package/dist/commands/workflow/issues.js +349 -59
  340. package/dist/commands/workflow/ledgers.js +1123 -37
  341. package/dist/commands/workflow/locks.js +26 -2
  342. package/dist/commands/workflow/plan-blocks.js +501 -0
  343. package/dist/commands/workflow/plan-versions.js +22 -0
  344. package/dist/commands/workflow/plans.js +205 -0
  345. package/dist/commands/workflow/prs.js +154 -35
  346. package/dist/commands/workflow/repo.js +58 -8
  347. package/dist/commands/workflow/roadmap.js +58 -23
  348. package/dist/commands/workflow/run-facts.js +421 -0
  349. package/dist/commands/workflow/runs.js +670 -72
  350. package/dist/commands/workflow/runtime.js +15 -1
  351. package/dist/commands/workflow/skills.js +1 -0
  352. package/dist/commands/workflow/status.js +282 -34
  353. package/dist/commands/workflow/step-table.js +308 -0
  354. package/dist/commands/workflow/steps.js +703 -96
  355. package/dist/commands/workflow/summary-findings.js +117 -0
  356. package/dist/commands/workflow/summary.js +388 -0
  357. package/dist/commands/workflow/tasks.js +378 -0
  358. package/dist/commands/workflow/test-blocks.js +231 -0
  359. package/dist/commands/workflow/tests-changed.js +172 -0
  360. package/dist/commands/workflow/tests.js +1695 -305
  361. package/dist/commands/workflow/tracker.js +983 -0
  362. package/dist/commands/workflow/workflows.js +1014 -222
  363. package/dist/commands/workflow/worktrees.js +432 -26
  364. package/dist/install/cloud-env.js +233 -99
  365. package/dist/install/context-ci-workflow.js +85 -0
  366. package/dist/install/manifest.js +64 -17
  367. package/dist/install/modules/antigravity.js +3 -2
  368. package/dist/install/modules/cloud.js +25 -16
  369. package/dist/install/modules/codex.js +12 -2
  370. package/dist/install/modules/core.js +1090 -48
  371. package/dist/install/modules/cursor.js +6 -6
  372. package/dist/install/modules/opencode.js +13 -7
  373. package/dist/install/template-notes.js +116 -0
  374. package/dist/install/version-file.js +9 -4
  375. package/dist/ledgers/compact.js +87 -0
  376. package/dist/ledgers/journal.js +233 -0
  377. package/dist/ledgers/migrate.js +81 -0
  378. package/dist/ledgers/status.js +176 -13
  379. package/dist/ledgers/telemetry.js +1010 -125
  380. package/dist/render/hosts.js +104 -14
  381. package/dist/render/models.js +12 -0
  382. package/dist/shared/bkit-latest.js +26 -4
  383. package/dist/shared/branches.js +3 -1
  384. package/dist/shared/dep-updater.js +49 -0
  385. package/dist/shared/egress.js +8 -1
  386. package/dist/shared/json.js +20 -7
  387. package/dist/shared/package-manager.js +6 -0
  388. package/dist/shared/settings.js +181 -24
  389. package/dist/shared/text.js +333 -0
  390. package/dist/shared/timeouts.js +2 -0
  391. package/dist/tools/cli-doc.js +97 -0
  392. package/dist/tools/grammar-density.js +183 -0
  393. package/dist/tools/instructions-sources.js +720 -0
  394. package/dist/tools/instructions.js +1623 -0
  395. package/package.json +156 -51
  396. package/.bkit/core/.bkit/lite.md +0 -73
  397. package/.bkit/core/engine/commands/harvest.ts +0 -459
  398. package/.bkit/core/engine/commands/workflow/workstreams.ts +0 -166
  399. package/.bkit/core/engine/tools/wording.ts +0 -748
  400. package/.bkit/core/prompts/bkit-build-challenge-reconcile.md +0 -69
  401. package/.bkit/core/prompts/bkit-build-challenge-remediate.md +0 -71
  402. package/.bkit/core/prompts/bkit-build-challenge-tests.md +0 -74
  403. package/.bkit/core/prompts/bkit-build-plan-execute.md +0 -76
  404. package/.bkit/core/prompts/bkit-build-summary.md +0 -94
  405. package/.bkit/core/prompts/bkit-debug-summary.md +0 -96
  406. package/.bkit/core/prompts/bkit-design-summary.md +0 -107
  407. package/.bkit/core/prompts/bkit-plan-complexity-check.md +0 -67
  408. package/.bkit/core/prompts/bkit-plan-complexity-split.md +0 -88
  409. package/.bkit/core/prompts/bkit-plan-review-3.md +0 -93
  410. package/.bkit/core/prompts/bkit-plan-scope-check-1.md +0 -85
  411. package/.bkit/core/prompts/bkit-plan-scope-check-2.md +0 -85
  412. package/.bkit/core/prompts/bkit-plan-summary.md +0 -107
  413. package/.bkit/core/prompts/bkit-ship-summary.md +0 -78
  414. package/.bkit/templates/scripts/ci/bkit-local-stack-lock.sh +0 -194
  415. package/dist/commands/harvest.js +0 -353
  416. package/dist/commands/workflow/workstreams.js +0 -143
  417. package/dist/tools/wording.js +0 -680
  418. /package/.bkit/templates/.vale/styles/{House → Bkit}/Filler.yml +0 -0
  419. /package/.bkit/templates/.vale/styles/{House → Bkit}/Hedging.yml +0 -0
  420. /package/.bkit/templates/.vale/styles/{House → Bkit}/LLMSlop.yml +0 -0
  421. /package/.bkit/templates/.vale/styles/{House → Bkit}/Verbose.yml +0 -0
  422. /package/.bkit/templates/scripts/ci/{accepted-advisories.json → bkit-accepted-advisories.json} +0 -0
  423. /package/.bkit/templates/scripts/ci/{accepted-divergences.json → bkit-accepted-divergences.json} +0 -0
  424. /package/.bkit/templates/scripts/launchd/{launchd.env.example → bkit-launchd.env.example} +0 -0
  425. /package/.bkit/templates/scripts/launchd/{ai.bkit.launchd.plist → bkit-launchd.plist} +0 -0
@@ -1,9 +1,9 @@
1
- <!-- Note: Reports live at `docs/audits/{YYYYMM}/{slug}.md`. `{YYYYMM}` = UTC month of this run. `{slug}` = template basename without `bkit-audit-` and `.md`. **If** that month already has `{slug}.md` or `{slug}-{TIMESTAMP}.md` → write `{slug}-{TIMESTAMP}.md` (`{TIMESTAMP}` = `date -u +%Y%m%dT%H%M%SZ`). Never overwrite. The report is stamped with a `bkit:anchor` block recording the audited commit (`baseSha`) and branch (`baseRef`); never hand-author or edit it. `@bkit-audit-generate` fills this template. -->
2
-
3
1
  <!-- bkit:start -->
4
2
 
5
3
  {{BKIT_MANAGED_MARKER}}
6
4
 
5
+ <!-- Note: @bkit-audit-generate fills this template. The report lives at `docs/audits/{YYYYMM}/{slug}.md`, where `{YYYYMM}` is the UTC month of the run and `{slug}` is this file's name without `bkit-audit-` and `.md`. **If** that month already has `{slug}.md` or `{slug}-{TIMESTAMP}.md` → write `{slug}-{TIMESTAMP}.md`, where `{TIMESTAMP}` is the output of `date -u +%Y%m%dT%H%M%SZ`. NEVER overwrite an earlier report. The report is stamped with a `bkit:anchor` block that records the audited commit (`baseSha`) and branch (`baseRef`). NEVER write or edit that block by hand. -->
6
+
7
7
  # Slop Audit
8
8
 
9
9
  > [!CAUTION]
@@ -11,145 +11,129 @@
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 recommend adding suppression; scanner config stays byte-identical to committed one.
14
+ > - Never recommend adding a suppression.
15
+ > - Keep the scanner config byte-identical to the committed one.
23
16
 
24
17
  ## Universal Instructions
25
18
 
26
19
  ### Context & Goals
27
20
 
28
- Each suppression made sense in one PR; nothing re-reads them. Glob hiding one deliberate pattern keeps hiding whatever lands under it; unexamined looks like examined. Audit reads every suppression list end to end.
21
+ Each suppression made sense in the PR that added it, and nothing reads them again. A glob that hides one deliberate pattern keeps hiding whatever lands under it, and an unexamined suppression looks the same as an examined one. This audit reads every suppression list end to end.
29
22
 
30
- **Applies when:** source under linter, type checker, scanner, or test runner. None, or no scanner and no in-code suppression → one `N/A` row with evidence, never "clean".
23
+ **Applies when:** the source is under a linter, type checker, scanner or test runner. **If** none of these exists, **or** there is no scanner and no in-code suppression → write one `N/A` row with its evidence, and never report the surface as "clean".
31
24
 
32
- **Cadence:** quarterly; extra when override count exceeds previous report's or pinned scanner version changes.
25
+ **Cadence:** Run once a quarter. Run an extra pass when the override count exceeds the previous report's, or when the pinned scanner version changes.
33
26
 
34
- **Anchor Standards:** record version and date read. Newer version → `Standards` step reads what changed.
27
+ **Anchor Standards:**
35
28
 
36
- - Slop scanner at pinned version (e.g. `slop-scan`).
37
- - Strictest preset of type-aware linter (e.g. typescript-eslint `strict-type-checked`, mypy `--strict`; rule list changes in minors).
38
- - Type-coverage tool (e.g. `type-coverage --strict`).
39
- - Disable-comment rules (e.g. ESLint `reportUnusedDisableDirectives`, `eslint-comments/require-description`, Ruff `RUF100`).
40
- - Cognitive Complexity (SonarSource white paper; e.g. `eslint-plugin-sonarjs`).
41
- - Mutation testing (e.g. Stryker, mutmut).
29
+ - Slop scanner at pinned version (e.g., `slop-scan`).
30
+ - Strictest preset of type-aware linter (e.g., typescript-eslint `strict-type-checked`, mypy `--strict`; rule list changes in minors).
31
+ - Type-coverage tool (e.g., `type-coverage --strict`).
32
+ - Disable-comment rules (e.g., ESLint `reportUnusedDisableDirectives`, `eslint-comments/require-description`, Ruff `RUF100`).
33
+ - Cognitive Complexity (SonarSource white paper; e.g., `eslint-plugin-sonarjs`).
34
+ - Mutation testing (e.g., Stryker, mutmut).
42
35
 
43
36
  ### Scope
44
37
 
45
- - Scanner config: overrides, ignores.
46
- - In-code: disable comments (e.g. `eslint-disable`, `# noqa`, `//nolint`), type-checker ignores (e.g. `@ts-expect-error`, `# type: ignore`), casts, escape-hatch types (e.g. `any`, `Any`), non-null assertions on boundary values, test-weakening markers (skip / only / fail / soft / retry overrides).
47
- - Config: linter, type checker, coverage, formatter, prose linter.
48
- - Inferred: implicit escape-hatch types, unawaited async work, defensive noise.
49
- - Complexity hotspots; surviving mutants.
38
+ - List the scanner config's overrides and ignores.
39
+ - Find in-code suppressions: disable comments (e.g., `eslint-disable`, `# noqa`, `//nolint`), type-checker ignores (e.g., `@ts-expect-error`, `# type: ignore`), casts, escape-hatch types (e.g., `any`, `Any`), non-null assertions on boundary values, and test-weakening markers (skip / only / fail / soft / retry overrides).
40
+ - List config suppressions in the linter, type checker, coverage, formatter and prose linter.
41
+ - Measure inferred suppressions: implicit escape-hatch types, unawaited async work and defensive noise.
42
+ - Find complexity hotspots.
43
+ - Measure surviving mutants.
50
44
 
51
45
  ### Out of Scope
52
46
 
53
47
  <!-- prettier-ignore -->
54
48
  | Excluded item | Why | Where it belongs |
55
49
  | --- | --- | --- |
56
- | Adding a suppression | Never recommended | — |
57
- | Fixing / deleting findings | Audit reports only | Plan from this report |
58
- | Dead files beyond reference check | Dead-code sweep | `bkit-audit-dead-code` |
59
- | Test quality beyond mutants / mock-only assertions | Testing sweep | `bkit-audit-testing` |
50
+ | Adding a suppression | It is never recommended | — |
51
+ | Fixing / deleting findings | The audit only reports | A plan made from this report |
52
+ | Dead files beyond reference check | The dead-code sweep owns them | `bkit-audit-dead-code` |
53
+ | Test quality beyond mutants / mock-only assertions | The testing sweep owns it | `bkit-audit-testing` |
60
54
 
61
55
  ### Verdicts
62
56
 
63
- - **FIX:** hides real failure. Name change and override / comment it removes.
64
- - **DELETE:** file dead, scratch, or finished one-off. Config entries hiding whole files only. Name file after reference check.
65
- - **KEEP:** intentional. Record reason beside suppression — reasonless `KEEP` = unexamined next run.
66
- - **OTHER:** fits none; say why. Same `OTHER` on 2 runs → propose new verdict in `Process Improvements`.
57
+ - **FIX:** it hides a real failure. Name the change, and the override or comment it removes.
58
+ - **DELETE:** the file is dead, scratch or a finished one-off. For a config entry, use it only when the entry hides whole files. Name the file after the reference check.
59
+ - **PRUNE:** the suppression entry hides 0 findings. Name the entry to remove.
60
+ - **KEEP:** it is intentional. Record the reason beside the suppression, because a `KEEP` with no reason counts as unexamined on the next run.
61
+ - **OTHER:** it fits no other verdict. Say why. **If** the same `OTHER` shows up on 2 runs → propose a new verdict in `Process Improvements`.
67
62
 
68
- **Rule of thumb:** real debt only if you can name concrete bug hidden; else `KEEP`. Almost always `KEEP` (fixing degrades code): fail-open middleware, fire-and-forget / best-effort telemetry, tolerant parsing fallbacks, framework-required shapes, thin named data-access / predicate helpers, config-per-file dirs, intentional barrels, deliberate duplicate signatures, duplicated test mock setup.
63
+ **Rule of thumb:** **If** you can name the concrete bug a suppression hides → it is real debt. **Else** → `KEEP`. These are almost always `KEEP`, because fixing them degrades the code: fail-open middleware, fire-and-forget or best-effort telemetry, tolerant parsing fallbacks, framework-required shapes, thin named data-access or predicate helpers, config-per-file directories, intentional barrels, deliberate duplicate signatures, and duplicated test mock setup.
69
64
 
70
65
  **Always `FIX`:**
71
66
 
72
- - Cast or escape-hatch type where data crosses boundary (SDK call, webhook payload, API response, DB client result) — hides drift boundary tests catch.
73
- - Disabled hook-dependency rule (e.g. `react-hooks/exhaustive-deps`) whose effect reads unlisted value. Read effect, not comment.
67
+ - A cast or escape-hatch type where data crosses a boundary (SDK call, webhook payload, API response, DB client result). It hides drift that boundary tests catch.
68
+ - A disabled hook-dependency rule (e.g., `react-hooks/exhaustive-deps`) whose effect reads an unlisted value. Read the effect, not the comment.
74
69
 
75
70
  ### Pre-Flight / Dependencies
76
71
 
77
- **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.
78
-
79
- **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.
80
-
81
72
  #### Core
82
73
 
83
- Always verify.
84
-
85
- - [ ] **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.
86
- - [ ] **Scanner:** Steps 2–4 — pinned in manifest, e.g. `slop-scan`. Fallback: skip scanner steps; run code / config steps.
87
- - [ ] **Worktree:** Steps 2–8 — detached worktree off default branch. Fallback: Steps 5–7 read-only in main checkout; Steps 3, 8 `Not Checked`.
88
- - [ ] **Git History:** Steps 5, 8 — full history for blame and churn. Fallback: ages and churn `Not Checked`.
89
- - [ ] **Web:** Step 9 — fetch anchor standards. Fallback: versions recorded as unread.
74
+ - [ ] **Permissions:** every blocked call is recorded.
75
+ - [ ] **Scanner:** Steps 2-4 — the scanner pinned in the manifest (e.g., `slop-scan`). Fallback: skip the scanner steps, and run the code and config steps.
76
+ - [ ] **Worktree:** Steps 2-8 — a detached worktree off the default branch. Fallback: run Steps 5-7 read-only in the main checkout, and mark Steps 3 and 8 `Not Checked`.
77
+ - [ ] **Git History:** Steps 5, 8 — full history, for blame and churn. Fallback: mark ages and churn `Not Checked`.
78
+ - [ ] **Web:** Step 9 — fetch the anchor standards. Fallback: record the versions as unread.
90
79
 
91
80
  #### Conditional
92
81
 
93
- Verify only when applicable.
94
-
95
- - [ ] **Language Server:** Typed language → Step 4 — references, e.g. Serena, `tsserver`. Fallback: text search only; name it per `DELETE`.
96
- - [ ] **Typed Lint and Type Coverage:** Typed language → Step 7 — e.g. typescript-eslint typed rules, `type-coverage`, mypy. Fallback: text-search escape-hatch counts.
97
- - [ ] **Complexity and Mutation Tools:** Tools exist for language → Step 8 — e.g. `eslint-plugin-sonarjs`, Stryker, mutmut; install in worktree only. Fallback: `Not Checked`.
82
+ - [ ] **Language Server:** **If** the language is typed → Step 4 — references (e.g., Serena, `tsserver`). Fallback: text search only, and name it on each `DELETE`.
83
+ - [ ] **Typed Lint and Type Coverage:** **If** the language is typed → Step 7 — typed lint rules and type coverage (e.g., typescript-eslint typed rules, `type-coverage`, mypy). Fallback: count escape-hatch types with text search.
84
+ - [ ] **Complexity and Mutation Tools:** **If** tools exist for the language → Step 8 — complexity and mutation runs (e.g., `eslint-plugin-sonarjs`, Stryker, mutmut). Install them in the worktree only. Fallback: `Not Checked`.
98
85
 
99
86
  ### 🔒 Gate 1: Prerequisites Check
100
87
 
101
- **Checkpoint.** Verify and check `[x]` all applicable boxes above, then continue to `Probe Steps` without asking.
102
-
103
- - [ ] **Gaps named:** every missing item names its fallback and `Not Checked` entry.
104
- - [ ] **Gate 1 - Verified:** All Core items checked. All applicable Conditional items checked.
88
+ - [ ] **Gaps named:** every missing item names its fallback and its `Not Checked` entry.
89
+ - [ ] **Gate 1 — Verified:** every item above, every Core item and every applicable Conditional item is checked.
105
90
 
106
91
  ### Probe Steps
107
92
 
108
- - [ ] **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.
109
- - [ ] **Step 2 — Isolate:** Find scanner run (package scripts). Detached worktree off default branch (no new branch); clean `git status` before start; removed before report finishes. **Done when:** worktree path and clean status in `Checked`, or absent scanner recorded.
110
- - [ ] **Step 3 — Hidden Findings:** Pinned scanner, committed config → JSON baseline. Stripped config (build-artifact ignores only, no overrides, all rules on) under restore guard → scan → restore → `diff` byte-identical. Suppressed = in stripped, not baseline; stripped count not fix-list. Count override blocks. Restore fails → STOP; restore committed config; record finding. **Done when:** baseline / stripped / suppressed / override-block counts in `Counts`; config diff empty.
111
- - [ ] **Step 4 — Verdicts:** Read each suppressed site, not rule name → verdict. `DELETE` needs reference check: language-server references where available + text search basename (script / config refs language server lacks). Text search over-reports, language server under-reports → agreement = signal. Re-run every empty result once before `DELETE`. **Done when:** every suppressed finding has verdict and evidence.
112
- - [ ] **Step 5 — Code Suppressions:** Search source for disable comments, type-checker ignores, escape-hatch types, double casts, single casts / non-null assertions on boundary values, test-weakening markers, stray debug output, `TODO` / `FIXME` / `HACK`. Split product vs test code. Type-level tests: expected-error directive = assertion, not suppression. Drop comment-only hits and import renames. Then:
113
- - Disable naming a rule the resolved config lacks → suppresses nothing → `FIX`.
114
- - Commented-out code → `FIX` unless comment says why it stays.
115
- - `TODO` citing closed tracker item → `FIX`.
116
- - Each suppression: introducing commit, date, PR (`git blame`); agent-authored (agent branch prefix / `Co-authored-by`)?
93
+ - [ ] **Step 1 — Previous Run:** **Done when:** `Previous Run` holds the closure rate, or the run is marked baseline.
94
+ - [ ] **Step 2 — Isolate:** Find how the scanner runs (package scripts). Create a detached worktree off the default branch, with no new branch. Check that `git status` is clean before you start, and remove the worktree before the report finishes. **Done when:** `Checked` holds the worktree path and its clean status, or the absent scanner is recorded.
95
+ - [ ] **Step 3 — Hidden Findings:** Run the pinned scanner with the committed config, and save the result as a JSON baseline. Under a restore guard, scan with a stripped config (build-artifact ignores only, no overrides, all rules on), then restore the config and `diff` it to confirm it is byte-identical. A suppressed finding is one in the stripped run but not in the baseline. Print a hide count per suppression entry (override block, ignore path, inline disable), so an entry that hides nothing shows up. The stripped count is not a fix list. Count the override blocks. **If** the restore fails → **STOP**, restore the committed config, and record a finding. **Done when:** `Counts` holds the baseline, stripped, suppressed and override-block counts and the hide count per entry, and the config diff is empty.
96
+ - [ ] **Step 4 — Verdicts:** Read each suppressed site, not only its rule name, and give it a verdict. `DELETE` needs a reference check: language-server references where available, plus a text search for the basename (for script and config references the language server lacks). Text search over-reports and the language server under-reports, so agreement between them is the signal. Re-run every empty result once before `DELETE`. Give each suppression entry with a hide count of 0 the verdict `PRUNE`. **Done when:** every suppressed finding and every `PRUNE` entry has a verdict and evidence.
97
+ - [ ] **Step 5 — Code Suppressions:** Search the source for disable comments, type-checker ignores, escape-hatch types, double casts, single casts and non-null assertions on boundary values, test-weakening markers, stray debug output, and `TODO` / `FIXME` / `HACK`. Split product code from test code. In type-level tests, an expected-error directive is an assertion, not a suppression. Drop comment-only hits and import renames. Then:
98
+ - **If** a disable names a rule the resolved config lacks → it suppresses nothing, so it is `FIX`.
99
+ - Commented-out code is `FIX`, unless a comment says why it stays.
100
+ - A `TODO` that cites a closed tracker item is `FIX`.
101
+ - For each suppression, record the introducing commit, date and PR (`git blame`), and whether an agent wrote it (agent branch prefix or `Co-authored-by`).
117
102
 
118
- **Done when:** every hit has verdict; counts per kind, age distribution, agent share in `Counts`.
103
+ **Done when:** every hit has a verdict, and `Counts` holds the counts per kind, the age distribution and the agent share.
119
104
 
120
- - [ ] **Step 6 — Config Suppressions:** List per config: linter rules off / warn for globs and ignore entries; resolved type-checker config per workspace (not file) — relaxed strictness / excludes (strictness identical across workspaces); coverage excludes and ignore comments; formatter ignores; prose-linter ignores / off-switches. **Done when:** every entry `FIX` / `KEEP`; count per kind in `Counts`.
121
- - [ ] **Step 7 — Inferred Types:** Most escape-hatch typing implicit (e.g. `res.json()`, `JSON.parse`, `json.loads`, untyped SDK return, `catch (e)`) → per package: type coverage and any-typed boundary identifiers; unsafe-any lint counts; unawaited / misused async (e.g. floating promises) in request handlers and background jobs (serverless: post-response work not guaranteed unless platform API, e.g. Next.js `after()` / `waitUntil`); defensive-noise density (unnecessary conditions / assertions, useless catches). Typed rules from CLI, config untouched; no typed linting → record. **Done when:** measurements in `Counts`; each handler violation = `FIX` row.
122
- - [ ] **Step 8 — Hotspots:** Top 20 functions by cognitive complexity (threshold 15) × 90-day churn. Mutation-test 1–2 packages with most suppressions / casts → surviving-mutant rate. Mock-only assertions = disguised suppression. Missing tools → install in worktree only; clean `git status` at end. **Done when:** hotspot table and mutant rate in `Counts`, or missing tool recorded.
123
- - [ ] **Step 9 — Standards:** Confirm current version per anchor standard; read changes since previous report's version. `Standards Coverage`: one row per standard and per strict-preset rule resolved config leaves off → checked (name step) / not applicable (why) / finding. Unapplied recommended practice → adopt (propose step) / reject (why) / not applicable. **Done when:** no empty row.
124
- - [ ] **Step 10 — Anything Else:** (a) Everything changed since previous report's commit touching suppressions (scanner / linter / type-checker / coverage / prose configs, new disables / casts / escape-hatch types / skips, lint scripts) → one-line verdict each. (b) Bounded ~30 min pass: what senior reviewer of this language flags that no step asks; read since previous run (incidents, new `docs/failures.jsonl` rows) — what would no step catch? **Done when:** `Beyond the Steps` holds both passes, or `none`. Class seen on 2 runs → propose step in `Process Improvements`.
105
+ - [ ] **Step 6 — Config Suppressions:** List, per config: linter rules turned off or set to warn for globs, and ignore entries; the resolved type-checker config per workspace (not per file), with any relaxed strictness or excludes (strictness is expected to be identical across workspaces); coverage excludes and ignore comments; formatter ignores; and prose-linter ignores and off-switches. **Done when:** every entry is `FIX` or `KEEP`, and `Counts` holds the count per kind.
106
+ - [ ] **Step 7 — Inferred Types:** Most escape-hatch typing is implicit (e.g., `res.json()`, `JSON.parse`, `json.loads`, an untyped SDK return, `catch (e)`). For each package, measure type coverage and any-typed boundary identifiers; unsafe-any lint counts; unawaited or misused async (e.g., floating promises) in request handlers and background jobs, plus a text search for `void <call>(` there, because floating-promise rules ignore `void` by default; and defensive-noise density (unnecessary conditions and assertions, useless catches). On serverless, work after the response is not guaranteed unless it uses a platform API (e.g., Next.js `after()` / `waitUntil`). Run the typed rules from the CLI, and leave the config untouched. **If** there is no typed linting → record that. **Done when:** `Counts` holds the measurements, and each handler violation is a `FIX` row.
107
+ - [ ] **Step 8 — Hotspots:** Rank the top 20 functions by cognitive complexity (threshold 15) times 90-day churn. Mutation-test the 1-2 packages with the most suppressions or casts, and record the surviving-mutant rate. Mock-only assertions are a disguised suppression. **If** a tool is missing → install it in the worktree only. Check that `git status` is clean at the end. **Done when:** `Counts` holds the hotspot table and the mutant rate, or the missing tool is recorded.
108
+ - [ ] **Step 9 — 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 standard, and one per strict-preset rule the resolved config leaves off, 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.
109
+ - [ ] **Step 10 — Anything Else:** (a) Give a one-line verdict on each change since the previous report's commit that touches suppressions: scanner, linter, type-checker, coverage and prose configs; new disables, casts, escape-hatch types and skips; and lint scripts. (b) In a bounded pass of about 30 minutes, note what a senior reviewer of this language would flag that no step asks about. Read what happened since the previous run (incidents, new `docs/failures.jsonl` rows), and ask what no step would catch. **Done when:** `Beyond the Steps` holds both passes, or says `none`. **If** one class of issue is seen on 2 runs → propose a step for it in `Process Improvements`.
125
110
 
126
111
  ### 🔒 Gate 2: Probes Check
127
112
 
128
- **Checkpoint.** Verify and check `[x]` all boxes below, then continue to `Findings` without asking.
129
-
130
- - [ ] **Steps complete:** every step `[x]`, or explicit skip with evidence the surface is absent.
131
- - [ ] **Evidence:** every finding cites re-checkable evidence and the tool behind it.
132
- - [ ] **Tree clean:** scanner config byte-identical to committed; worktree `git status` clean.
133
- - [ ] **Gate 2 - Verified:** Every checkbox above independently verified and checked off.
113
+ - [ ] **Steps complete:** every step is `[x]`, or skipped with evidence that its surface is absent.
114
+ - [ ] **Evidence:** every finding cites evidence someone can check again, and the tool that produced it.
115
+ - [ ] **Scanner config unchanged:** the scanner config is byte-identical to the committed one.
116
+ - [ ] **Worktree clean:** the worktree's `git status` is clean.
117
+ - [ ] **Gate 2 — Verified:** every item above holds.
134
118
 
135
119
  ## Findings
136
120
 
137
121
  <!-- prettier-ignore -->
138
122
  | Severity | Use |
139
123
  | --- | --- |
140
- | `CRITICAL` | Suppression hides a security, auth, or data-loss failure |
141
- | `HIGH` | Boundary cast / escape-hatch type on untrusted input; promise that can drop handler work; skipped / focused test; blanket disable naming no rule |
142
- | `MEDIUM` | Reason no longer matches code; disable for a rule the config lacks; `TODO` citing closed item; relaxed strictness in one workspace |
143
- | `LOW` | `KEEP` without written reason; commented-out code |
124
+ | `CRITICAL` | A suppression hides a security, auth or data-loss failure |
125
+ | `HIGH` | A boundary cast or escape-hatch type on untrusted input. A promise that can drop handler work. A skipped or focused test. A blanket disable that names no rule |
126
+ | `MEDIUM` | A reason that no longer matches the code. A disable for a rule the config lacks. A `TODO` that cites a closed item. Relaxed strictness in one workspace |
127
+ | `LOW` | A `KEEP` with no written reason. Commented-out code |
144
128
 
145
- Scale per `.bkit/jsonl.md` § Severity. Within a severity: security / data first.
129
+ Within a severity, list security and data findings first.
146
130
 
147
131
  <!-- prettier-ignore -->
148
132
  | ID | Severity | Verdict | Location | Evidence | Expected |
149
133
  | --- | --- | --- | --- | --- | --- |
150
134
  | PENDING | PENDING | PENDING | PENDING | PENDING | PENDING |
151
135
 
152
- Empty and clean → one row `None`.
136
+ **If** the run finds nothing → write one row: `None`.
153
137
 
154
138
  ## Report
155
139
 
@@ -194,17 +178,16 @@ PENDING
194
178
 
195
179
  ### 🔒 Gate 3: Report Check
196
180
 
197
- **Checkpoint.** Verify and check `[x]` all boxes below, then stop.
198
-
199
- - [ ] **No placeholders:** Findings table and every `Report` section have no `PENDING`.
200
- - [ ] **Summary:** names count per severity and baseline / stripped / suppressed counts.
201
- - [ ] **Series:** `Counts` beside previous report's counts, or marked baseline.
202
- - [ ] **Writes:** only this report and template `Project Instructions` changed; throwaway worktrees / remote targets removed.
203
- - [ ] **Process Improvements:** `Universal` = proposed step changes, template untouched; `Project` = edits applied below `bkit:end`; each `none` if empty.
204
- - [ ] **Suggested Issues:** every `MEDIUM`+ finding ID in exactly one row; every row has a `Next Step`.
205
- - [ ] **Gate 3 - Verified:** Every checkbox above independently verified and checked off.
206
-
207
- > `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.
181
+ - [ ] **No placeholders:** no `PENDING` is left.
182
+ - [ ] **Summary:** `Summary` gives the count per severity.
183
+ - [ ] **Strip counts:** `Summary` gives the baseline, stripped and suppressed counts.
184
+ - [ ] **Series:** the report shows `Counts` beside the previous report's numbers, or marks the run as baseline.
185
+ - [ ] **Writes:** this run changed only this report, the template's `Project Instructions` and its own `docs/failures.jsonl` rows.
186
+ - [ ] **Throwaways removed:** every throwaway worktree or remote target is removed.
187
+ - [ ] **Process Improvements:** `Universal` and `Project` are both filled.
188
+ - [ ] **Suggested Issues:** every `MEDIUM`+ finding ID is in exactly one `Suggested Issues` row.
189
+ - [ ] **Next Step:** every `Suggested Issues` row has a `Next Step`.
190
+ - [ ] **Gate 3 — Verified:** every item above holds.
208
191
 
209
192
  <!-- bkit:end -->
210
193