@cbartens/bkit 6.0.0 → 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 (375) hide show
  1. package/.bkit/README.md +154 -151
  2. package/.bkit/core/.agents/context.md +95 -29
  3. package/.bkit/core/.agents/docs.md +17 -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 +108 -107
  9. package/.bkit/core/.agents/skills.md +63 -15
  10. package/.bkit/core/.bkit/README.md +154 -151
  11. package/.bkit/core/.bkit/authoring.md +714 -84
  12. package/.bkit/core/.bkit/cli.md +407 -0
  13. package/.bkit/core/.bkit/cloud.md +281 -193
  14. package/.bkit/core/.bkit/comparison.md +43 -41
  15. package/.bkit/core/.bkit/install.md +154 -84
  16. package/.bkit/core/.bkit/jsonl.md +193 -130
  17. package/.bkit/core/.bkit/pipeline.md +114 -114
  18. package/.bkit/core/.bkit/prompts.md +272 -165
  19. package/.bkit/core/.bkit/providers.md +457 -271
  20. package/.bkit/core/.bkit/router.md +69 -0
  21. package/.bkit/core/.bkit/templates.md +529 -256
  22. package/.bkit/core/.bkit/trackers.md +80 -52
  23. package/.bkit/core/.bkit/workflows.md +589 -504
  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 +5 -73
  33. package/.bkit/core/docs/templates/bkit-audit-accessibility.md +127 -105
  34. package/.bkit/core/docs/templates/bkit-audit-adoption.md +104 -70
  35. package/.bkit/core/docs/templates/bkit-audit-agents.md +94 -72
  36. package/.bkit/core/docs/templates/bkit-audit-aio-seo.md +99 -78
  37. package/.bkit/core/docs/templates/bkit-audit-analytics.md +140 -82
  38. package/.bkit/core/docs/templates/bkit-audit-annotations.md +98 -72
  39. package/.bkit/core/docs/templates/bkit-audit-app-performance.md +121 -96
  40. package/.bkit/core/docs/templates/bkit-audit-app-store.md +157 -76
  41. package/.bkit/core/docs/templates/bkit-audit-architecture.md +113 -71
  42. package/.bkit/core/docs/templates/bkit-audit-ci-performance.md +75 -72
  43. package/.bkit/core/docs/templates/bkit-audit-config.md +122 -76
  44. package/.bkit/core/docs/templates/bkit-audit-cost.md +85 -74
  45. package/.bkit/core/docs/templates/bkit-audit-coverage.md +75 -68
  46. package/.bkit/core/docs/templates/bkit-audit-database.md +101 -70
  47. package/.bkit/core/docs/templates/bkit-audit-dead-code.md +164 -83
  48. package/.bkit/core/docs/templates/bkit-audit-deferrals.md +115 -86
  49. package/.bkit/core/docs/templates/bkit-audit-dependencies.md +264 -88
  50. package/.bkit/core/docs/templates/bkit-audit-documentation.md +118 -93
  51. package/.bkit/core/docs/templates/bkit-audit-duplication.md +139 -86
  52. package/.bkit/core/docs/templates/bkit-audit-failures.md +110 -81
  53. package/.bkit/core/docs/templates/bkit-audit-flakes.md +99 -74
  54. package/.bkit/core/docs/templates/bkit-audit-gates.md +105 -77
  55. package/.bkit/core/docs/templates/bkit-audit-issues.md +104 -80
  56. package/.bkit/core/docs/templates/bkit-audit-llm.md +131 -58
  57. package/.bkit/core/docs/templates/bkit-audit-logs.md +123 -100
  58. package/.bkit/core/docs/templates/bkit-audit-models.md +98 -53
  59. package/.bkit/core/docs/templates/bkit-audit-privacy.md +56 -52
  60. package/.bkit/core/docs/templates/bkit-audit-prompts.md +63 -54
  61. package/.bkit/core/docs/templates/bkit-audit-red-team.md +124 -68
  62. package/.bkit/core/docs/templates/bkit-audit-reliability.md +95 -70
  63. package/.bkit/core/docs/templates/bkit-audit-repo.md +169 -73
  64. package/.bkit/core/docs/templates/bkit-audit-security.md +206 -96
  65. package/.bkit/core/docs/templates/bkit-audit-slop.md +77 -70
  66. package/.bkit/core/docs/templates/bkit-audit-testing.md +162 -114
  67. package/.bkit/core/docs/templates/bkit-audit-usability.md +113 -71
  68. package/.bkit/core/docs/templates/bkit-plan.md +138 -132
  69. package/.bkit/core/engine/checks/after/auth.ts +40 -37
  70. package/.bkit/core/engine/checks/after/ci-yml.ts +65 -2
  71. package/.bkit/core/engine/checks/after/index.ts +12 -2
  72. package/.bkit/core/engine/checks/after/tools.ts +80 -33
  73. package/.bkit/core/engine/checks/before/context-fetch.ts +227 -33
  74. package/.bkit/core/engine/checks/before/env.ts +1 -1
  75. package/.bkit/core/engine/checks/before/index.ts +7 -0
  76. package/.bkit/core/engine/checks/before/repo.ts +40 -0
  77. package/.bkit/core/engine/checks/status-holes.ts +916 -123
  78. package/.bkit/core/engine/checks/tips/catalogue.ts +68 -17
  79. package/.bkit/core/engine/checks/tips/detect.ts +32 -0
  80. package/.bkit/core/engine/checks/tips/index.ts +47 -6
  81. package/.bkit/core/engine/cli.ts +238 -84
  82. package/.bkit/core/engine/commands/analysis.ts +128 -76
  83. package/.bkit/core/engine/commands/ci/ci.ts +363 -29
  84. package/.bkit/core/engine/commands/ci/pins.ts +172 -0
  85. package/.bkit/core/engine/commands/ci/push-gate.ts +223 -0
  86. package/.bkit/core/engine/commands/install/uninstall.ts +21 -27
  87. package/.bkit/core/engine/commands/install/upgrade.ts +32 -15
  88. package/.bkit/core/engine/commands/land.ts +126 -11
  89. package/.bkit/core/engine/commands/lib.ts +303 -6
  90. package/.bkit/core/engine/commands/registry.ts +6 -2
  91. package/.bkit/core/engine/commands/setup/setup.ts +1 -0
  92. package/.bkit/core/engine/commands/stats.ts +91 -35
  93. package/.bkit/core/engine/commands/workflow/branches.ts +1477 -117
  94. package/.bkit/core/engine/commands/workflow/challenge.ts +114 -39
  95. package/.bkit/core/engine/commands/workflow/completeness.ts +109 -0
  96. package/.bkit/core/engine/commands/workflow/context.ts +433 -55
  97. package/.bkit/core/engine/commands/workflow/counters.ts +244 -39
  98. package/.bkit/core/engine/commands/workflow/decisions.ts +61 -17
  99. package/.bkit/core/engine/commands/workflow/disk.ts +237 -55
  100. package/.bkit/core/engine/commands/workflow/fids.ts +19 -1
  101. package/.bkit/core/engine/commands/workflow/issues.ts +6 -0
  102. package/.bkit/core/engine/commands/workflow/ledgers.ts +458 -18
  103. package/.bkit/core/engine/commands/workflow/locks.ts +2 -0
  104. package/.bkit/core/engine/commands/workflow/plan-blocks.ts +124 -15
  105. package/.bkit/core/engine/commands/workflow/plans.ts +257 -0
  106. package/.bkit/core/engine/commands/workflow/prs.ts +12 -3
  107. package/.bkit/core/engine/commands/workflow/repo.ts +8 -0
  108. package/.bkit/core/engine/commands/workflow/roadmap.ts +56 -15
  109. package/.bkit/core/engine/commands/workflow/run-facts.ts +22 -31
  110. package/.bkit/core/engine/commands/workflow/runs.ts +652 -34
  111. package/.bkit/core/engine/commands/workflow/runtime.ts +3 -0
  112. package/.bkit/core/engine/commands/workflow/skills.ts +1 -0
  113. package/.bkit/core/engine/commands/workflow/status.ts +200 -17
  114. package/.bkit/core/engine/commands/workflow/step-table.ts +75 -33
  115. package/.bkit/core/engine/commands/workflow/steps.ts +635 -24
  116. package/.bkit/core/engine/commands/workflow/summary-findings.ts +177 -0
  117. package/.bkit/core/engine/commands/workflow/summary.ts +192 -46
  118. package/.bkit/core/engine/commands/workflow/tasks.ts +409 -0
  119. package/.bkit/core/engine/commands/workflow/test-blocks.ts +254 -0
  120. package/.bkit/core/engine/commands/workflow/tests-changed.ts +201 -0
  121. package/.bkit/core/engine/commands/workflow/tests.ts +1285 -356
  122. package/.bkit/core/engine/commands/workflow/workflows.ts +228 -43
  123. package/.bkit/core/engine/commands/workflow/worktrees.ts +389 -47
  124. package/.bkit/core/engine/install/cloud-env.ts +251 -121
  125. package/.bkit/core/engine/install/context-ci-workflow.ts +102 -0
  126. package/.bkit/core/engine/install/manifest.ts +60 -12
  127. package/.bkit/core/engine/install/modules/antigravity.ts +3 -2
  128. package/.bkit/core/engine/install/modules/cloud.ts +3 -3
  129. package/.bkit/core/engine/install/modules/codex.ts +15 -2
  130. package/.bkit/core/engine/install/modules/core.ts +956 -52
  131. package/.bkit/core/engine/install/modules/cursor.ts +6 -6
  132. package/.bkit/core/engine/install/modules/opencode.ts +16 -4
  133. package/.bkit/core/engine/install/template-notes.ts +130 -0
  134. package/.bkit/core/engine/install/version-file.ts +3 -2
  135. package/.bkit/core/engine/install/write.ts +5 -0
  136. package/.bkit/core/engine/ledgers/compact.ts +124 -0
  137. package/.bkit/core/engine/ledgers/journal.ts +291 -0
  138. package/.bkit/core/engine/ledgers/status.ts +160 -9
  139. package/.bkit/core/engine/ledgers/telemetry.ts +158 -21
  140. package/.bkit/core/engine/render/hosts.ts +114 -14
  141. package/.bkit/core/engine/shared/bkit-latest.ts +26 -4
  142. package/.bkit/core/engine/shared/dep-updater.ts +60 -0
  143. package/.bkit/core/engine/shared/egress.ts +1 -1
  144. package/.bkit/core/engine/shared/package-manager.ts +9 -0
  145. package/.bkit/core/engine/shared/settings.ts +92 -17
  146. package/.bkit/core/engine/shared/timeouts.ts +2 -0
  147. package/.bkit/core/engine/tools/cli-doc.ts +111 -0
  148. package/.bkit/core/engine/tools/grammar-density.ts +1 -1
  149. package/.bkit/core/engine/tools/instructions-sources.ts +15 -17
  150. package/.bkit/core/engine/tools/instructions.ts +94 -43
  151. package/.bkit/core/hooks/antigravity-hook.js +25 -10
  152. package/.bkit/core/hooks/gateguard-engine.js +53 -29
  153. package/.bkit/core/hooks/guardrails-shell.js +4 -4
  154. package/.bkit/core/hooks/guardrails-tiers.js +3 -3
  155. package/.bkit/core/hooks/preflight-linear.sh +9 -9
  156. package/.bkit/core/hooks/preflight-rules.sh +8 -0
  157. package/.bkit/core/hooks/readguard-engine.js +29 -10
  158. package/.bkit/core/hooks/session-rules-advisory.js +61 -0
  159. package/.bkit/core/prompts/bkit-audit-generate.md +187 -116
  160. package/.bkit/core/prompts/bkit-build-challenge-1.md +56 -37
  161. package/.bkit/core/prompts/bkit-build-challenge-2.md +65 -45
  162. package/.bkit/core/prompts/bkit-build-install-skills.md +38 -29
  163. package/.bkit/core/prompts/bkit-build-plan-convert.md +43 -32
  164. package/.bkit/core/prompts/bkit-build-plan-current.md +49 -39
  165. package/.bkit/core/prompts/bkit-build-plan-gaps-remediate.md +79 -55
  166. package/.bkit/core/prompts/bkit-build-plan-tasks.md +149 -0
  167. package/.bkit/core/prompts/bkit-build-plan-tests.md +120 -0
  168. package/.bkit/core/prompts/bkit-build-plan-verify.md +87 -50
  169. package/.bkit/core/prompts/bkit-debug-abort-handover.md +36 -35
  170. package/.bkit/core/prompts/bkit-debug-failure-diagnose.md +96 -64
  171. package/.bkit/core/prompts/bkit-debug-failure-remediate.md +54 -45
  172. package/.bkit/core/prompts/bkit-debug-failure-reproduce.md +42 -33
  173. package/.bkit/core/prompts/bkit-debug-failure-soak.md +53 -37
  174. package/.bkit/core/prompts/bkit-design-brainstorm-ideate-1.md +35 -30
  175. package/.bkit/core/prompts/bkit-design-brainstorm-ideate-2.md +34 -29
  176. package/.bkit/core/prompts/bkit-design-brainstorm-ideate-3.md +32 -28
  177. package/.bkit/core/prompts/bkit-design-generate.md +68 -52
  178. package/.bkit/core/prompts/bkit-design-organise.md +73 -35
  179. package/.bkit/core/prompts/bkit-design-review-1.md +58 -54
  180. package/.bkit/core/prompts/bkit-design-review-2.md +54 -50
  181. package/.bkit/core/prompts/bkit-design-spike.md +54 -47
  182. package/.bkit/core/prompts/bkit-design-update.md +42 -31
  183. package/.bkit/core/prompts/bkit-plan-generate.md +76 -58
  184. package/.bkit/core/prompts/bkit-plan-review-1.md +63 -49
  185. package/.bkit/core/prompts/bkit-plan-review-2.md +60 -48
  186. package/.bkit/core/prompts/bkit-plan-scope-check.md +53 -46
  187. package/.bkit/core/prompts/bkit-plan-update.md +70 -52
  188. package/.bkit/core/prompts/bkit-ship-conflict-resolve.md +82 -50
  189. package/.bkit/core/prompts/bkit-ship-deferred-sweep.md +80 -45
  190. package/.bkit/core/prompts/bkit-ship-update-docs.md +35 -29
  191. package/.bkit/core/prompts/bkit-utility-compress-markdown.md +55 -49
  192. package/.bkit/core/prompts/bkit-utility-update-decisions.md +76 -49
  193. package/.bkit/core/prompts/bkit-utility-update-deferrals.md +70 -41
  194. package/.bkit/core/prompts/bkit-utility-update-documentation.md +33 -30
  195. package/.bkit/core/prompts/bkit-utility-update-failures.md +73 -43
  196. package/.bkit/core/prompts/bkit-utility-update-knowledge.md +77 -50
  197. package/.bkit/core/prompts/bkit-utility-update-roadmap.md +77 -45
  198. package/.bkit/core/prompts/bkit-utility-update-tracker.md +144 -68
  199. package/.bkit/core/workflows/bkit-auto.md +53 -30
  200. package/.bkit/core/workflows/bkit-build.md +635 -304
  201. package/.bkit/core/workflows/bkit-debug.md +301 -148
  202. package/.bkit/core/workflows/bkit-design.md +167 -95
  203. package/.bkit/core/workflows/bkit-plan.md +172 -84
  204. package/.bkit/core/workflows/bkit-ship.md +299 -152
  205. package/.bkit/shared/.agents/plugins/bkit/hooks.json +10 -0
  206. package/.bkit/shared/.claude/bkit-cloud.md +12 -10
  207. package/.bkit/shared/.claude/settings.json +3 -0
  208. package/.bkit/shared/.codex/bkit-cloud.md +98 -0
  209. package/.bkit/shared/.codex/hooks.json +20 -0
  210. package/.bkit/shared/.cursor/bkit-cloud.md +3 -3
  211. package/.bkit/shared/.opencode/opencode.json +1 -1
  212. package/.bkit/shared/CLAUDE.md +5 -1
  213. package/.bkit/shared/GEMINI.md +4 -1
  214. package/.bkit/shared/docs/architecture.md +4 -7
  215. package/.bkit/shared/docs/data-schema.md +4 -7
  216. package/.bkit/shared/docs/deployments.md +239 -166
  217. package/.bkit/shared/docs/design.md +11 -12
  218. package/.bkit/shared/docs/noise.md +8 -7
  219. package/.bkit/shared/docs/observability.md +5 -8
  220. package/.bkit/shared/docs/security.md +35 -17
  221. package/.bkit/shared/docs/setup.md +29 -18
  222. package/.bkit/shared/docs/technology.md +3 -6
  223. package/.bkit/shared/docs/testing.md +282 -176
  224. package/.bkit/shared/gitignore +6 -2
  225. package/.bkit/templates/.claude/hooks/bkit-cloud-bootstrap.sh +15 -16
  226. package/.bkit/templates/.cursor/Dockerfile +12 -8
  227. package/.bkit/templates/.cursor/environment.json +1 -1
  228. package/.bkit/templates/.github/ISSUE_TEMPLATE/bkit-bug.yml +10 -8
  229. package/.bkit/templates/.github/ISSUE_TEMPLATE/bkit-change.yml +24 -12
  230. package/.bkit/templates/.github/ISSUE_TEMPLATE/bkit-idea.yml +3 -3
  231. package/.bkit/templates/.github/renovate.json5 +34 -6
  232. package/.bkit/templates/.github/workflows/bkit-ci.yml +53 -50
  233. package/.bkit/templates/.github/workflows/bkit-cloud.yml +13 -14
  234. package/.bkit/templates/.github/workflows/bkit-health.yml +97 -0
  235. package/.bkit/templates/.github/workflows/bkit-renovate.yml +5 -4
  236. package/.bkit/templates/.github/workflows/bkit-trivy.yml +5 -4
  237. package/.bkit/templates/.husky/pre-commit +2 -2
  238. package/.bkit/templates/.husky/pre-push +95 -35
  239. package/.bkit/templates/.prettierignore +6 -7
  240. package/.bkit/templates/.vale.ini +27 -27
  241. package/.bkit/templates/context/bkit-cloudrun.md +23 -15
  242. package/.bkit/templates/context/bkit-expo.md +70 -52
  243. package/.bkit/templates/context/bkit-github.md +93 -56
  244. package/.bkit/templates/context/bkit-inngest.md +21 -15
  245. package/.bkit/templates/context/bkit-maestro.md +22 -16
  246. package/.bkit/templates/context/bkit-playwright.md +23 -17
  247. package/.bkit/templates/context/bkit-resend.md +12 -10
  248. package/.bkit/templates/context/bkit-sentry.md +30 -20
  249. package/.bkit/templates/context/bkit-serena.md +8 -7
  250. package/.bkit/templates/context/bkit-stripe.md +14 -13
  251. package/.bkit/templates/context/bkit-supabase.md +16 -13
  252. package/.bkit/templates/context/bkit-tavily.md +14 -11
  253. package/.bkit/templates/context/bkit-vercel.md +27 -18
  254. package/.bkit/templates/docs/capabilities.md +15 -14
  255. package/.bkit/templates/scripts/ci/{check-accepted-divergences.mjs → bkit-check-accepted-divergences.mjs} +6 -3
  256. package/.bkit/templates/scripts/ci/{check-accepted-divergences.test.mjs → bkit-check-accepted-divergences.test.mjs} +3 -3
  257. package/.bkit/templates/scripts/ci/{check-capstone.mjs → bkit-check-capstone.mjs} +2 -2
  258. package/.bkit/templates/scripts/ci/{check-capstone.test.mjs → bkit-check-capstone.test.mjs} +4 -4
  259. package/.bkit/templates/scripts/ci/{check-dependency-audit.mjs → bkit-check-dependency-audit.mjs} +103 -18
  260. package/.bkit/templates/scripts/ci/{check-dependency-audit.test.mjs → bkit-check-dependency-audit.test.mjs} +31 -3
  261. package/.bkit/templates/scripts/ci/bkit-machine-lock.sh +387 -0
  262. package/.bkit/templates/scripts/ci/bkit-test-awake.mjs +75 -0
  263. package/.bkit/templates/scripts/ci/bkit-test-awake.test.mjs +160 -0
  264. package/.bkit/templates/scripts/ci/lanes/{resolve-push-base.mjs → bkit-resolve-push-base.mjs} +3 -3
  265. package/.bkit/templates/scripts/ci/lanes/{resolve-push-base.test.mjs → bkit-resolve-push-base.test.mjs} +4 -4
  266. package/.bkit/templates/scripts/cleanup/bkit-disk-prune.mjs +9 -1
  267. package/.bkit/templates/scripts/graphify/bkit-graph-drift.py +1 -1
  268. package/.bkit/templates/scripts/graphify/bkit-graph-eager.py +3 -3
  269. package/.bkit/templates/scripts/graphify/bkit-graph-embed.py +63 -0
  270. package/.bkit/templates/scripts/graphify/bkit-graph-imports.py +2 -2
  271. package/.bkit/templates/scripts/graphify/bkit-graph-pre-push.sh +69 -18
  272. package/.bkit/templates/scripts/graphify/bkit-graph-repair.py +3 -3
  273. package/.bkit/templates/scripts/graphify/bkit-graph-surface.py +1 -1
  274. package/.bkit/templates/scripts/graphify/bkit-graphify-graphml.py +1 -1
  275. package/.bkit/templates/scripts/graphify/bkit-graphify-rollup.py +197 -126
  276. package/.bkit/templates/scripts/graphify/bkit-graphify.sh +64 -41
  277. package/.bkit/templates/scripts/slop/bkit-slop-type-suppression.mjs +23 -7
  278. package/.bkit/templates/slop-scan.config.json +9 -2
  279. package/CHANGELOG.md +119 -0
  280. package/README.md +250 -76
  281. package/dist/checks/after/auth.js +36 -33
  282. package/dist/checks/after/ci-yml.js +52 -2
  283. package/dist/checks/after/index.js +12 -4
  284. package/dist/checks/after/tools.js +73 -33
  285. package/dist/checks/before/context-fetch.js +218 -33
  286. package/dist/checks/before/env.js +1 -1
  287. package/dist/checks/before/index.js +6 -2
  288. package/dist/checks/before/repo.js +35 -1
  289. package/dist/checks/status-holes.js +739 -114
  290. package/dist/checks/tips/catalogue.js +59 -17
  291. package/dist/checks/tips/detect.js +30 -0
  292. package/dist/checks/tips/index.js +48 -6
  293. package/dist/cli.js +222 -84
  294. package/dist/commands/analysis.js +77 -53
  295. package/dist/commands/ci/ci.js +302 -25
  296. package/dist/commands/ci/pins.js +142 -0
  297. package/dist/commands/ci/push-gate.js +194 -0
  298. package/dist/commands/install/uninstall.js +23 -27
  299. package/dist/commands/install/upgrade.js +21 -11
  300. package/dist/commands/land.js +126 -10
  301. package/dist/commands/lib.js +244 -5
  302. package/dist/commands/registry.js +6 -2
  303. package/dist/commands/setup/setup.js +1 -0
  304. package/dist/commands/stats.js +69 -30
  305. package/dist/commands/workflow/branches.js +1232 -111
  306. package/dist/commands/workflow/challenge.js +90 -37
  307. package/dist/commands/workflow/completeness.js +97 -0
  308. package/dist/commands/workflow/context.js +371 -51
  309. package/dist/commands/workflow/counters.js +206 -40
  310. package/dist/commands/workflow/decisions.js +60 -17
  311. package/dist/commands/workflow/disk.js +213 -55
  312. package/dist/commands/workflow/fids.js +18 -1
  313. package/dist/commands/workflow/issues.js +6 -0
  314. package/dist/commands/workflow/ledgers.js +372 -21
  315. package/dist/commands/workflow/locks.js +2 -0
  316. package/dist/commands/workflow/plan-blocks.js +78 -14
  317. package/dist/commands/workflow/plans.js +205 -0
  318. package/dist/commands/workflow/prs.js +12 -3
  319. package/dist/commands/workflow/repo.js +6 -0
  320. package/dist/commands/workflow/roadmap.js +50 -17
  321. package/dist/commands/workflow/run-facts.js +23 -28
  322. package/dist/commands/workflow/runs.js +530 -33
  323. package/dist/commands/workflow/runtime.js +3 -0
  324. package/dist/commands/workflow/skills.js +1 -0
  325. package/dist/commands/workflow/status.js +166 -19
  326. package/dist/commands/workflow/step-table.js +61 -29
  327. package/dist/commands/workflow/steps.js +542 -26
  328. package/dist/commands/workflow/summary-findings.js +117 -0
  329. package/dist/commands/workflow/summary.js +154 -41
  330. package/dist/commands/workflow/tasks.js +378 -0
  331. package/dist/commands/workflow/test-blocks.js +231 -0
  332. package/dist/commands/workflow/tests-changed.js +172 -0
  333. package/dist/commands/workflow/tests.js +1013 -321
  334. package/dist/commands/workflow/workflows.js +191 -38
  335. package/dist/commands/workflow/worktrees.js +310 -42
  336. package/dist/install/cloud-env.js +233 -99
  337. package/dist/install/context-ci-workflow.js +85 -0
  338. package/dist/install/manifest.js +57 -12
  339. package/dist/install/modules/antigravity.js +3 -2
  340. package/dist/install/modules/cloud.js +3 -3
  341. package/dist/install/modules/codex.js +12 -2
  342. package/dist/install/modules/core.js +851 -53
  343. package/dist/install/modules/cursor.js +6 -6
  344. package/dist/install/modules/opencode.js +11 -5
  345. package/dist/install/template-notes.js +116 -0
  346. package/dist/install/version-file.js +3 -2
  347. package/dist/ledgers/compact.js +87 -0
  348. package/dist/ledgers/journal.js +233 -0
  349. package/dist/ledgers/status.js +115 -5
  350. package/dist/ledgers/telemetry.js +121 -17
  351. package/dist/render/hosts.js +100 -14
  352. package/dist/shared/bkit-latest.js +26 -4
  353. package/dist/shared/dep-updater.js +49 -0
  354. package/dist/shared/egress.js +1 -1
  355. package/dist/shared/package-manager.js +6 -0
  356. package/dist/shared/settings.js +59 -10
  357. package/dist/shared/timeouts.js +2 -0
  358. package/dist/tools/cli-doc.js +97 -0
  359. package/dist/tools/grammar-density.js +1 -1
  360. package/dist/tools/instructions-sources.js +15 -16
  361. package/dist/tools/instructions.js +83 -39
  362. package/package.json +58 -42
  363. package/.bkit/core/.bkit/lite.md +0 -73
  364. package/.bkit/core/engine/commands/workflow/workstreams.ts +0 -172
  365. package/.bkit/core/prompts/bkit-build-plan-execute.md +0 -124
  366. package/.bkit/templates/scripts/ci/bkit-local-stack-lock.sh +0 -194
  367. package/dist/commands/workflow/workstreams.js +0 -149
  368. /package/.bkit/templates/.vale/styles/{House → Bkit}/Filler.yml +0 -0
  369. /package/.bkit/templates/.vale/styles/{House → Bkit}/Hedging.yml +0 -0
  370. /package/.bkit/templates/.vale/styles/{House → Bkit}/LLMSlop.yml +0 -0
  371. /package/.bkit/templates/.vale/styles/{House → Bkit}/Verbose.yml +0 -0
  372. /package/.bkit/templates/scripts/ci/{accepted-advisories.json → bkit-accepted-advisories.json} +0 -0
  373. /package/.bkit/templates/scripts/ci/{accepted-divergences.json → bkit-accepted-divergences.json} +0 -0
  374. /package/.bkit/templates/scripts/launchd/{launchd.env.example → bkit-launchd.env.example} +0 -0
  375. /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,125 +11,129 @@
11
11
  >
12
12
  > **Rules:**
13
13
  >
14
- > - 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.
15
16
 
16
17
  ## Universal Instructions
17
18
 
18
19
  ### Context & Goals
19
20
 
20
- 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.
21
22
 
22
- **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".
23
24
 
24
- **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.
25
26
 
26
27
  **Anchor Standards:**
27
28
 
28
- - Slop scanner at pinned version (e.g. `slop-scan`).
29
- - Strictest preset of type-aware linter (e.g. typescript-eslint `strict-type-checked`, mypy `--strict`; rule list changes in minors).
30
- - Type-coverage tool (e.g. `type-coverage --strict`).
31
- - Disable-comment rules (e.g. ESLint `reportUnusedDisableDirectives`, `eslint-comments/require-description`, Ruff `RUF100`).
32
- - Cognitive Complexity (SonarSource white paper; e.g. `eslint-plugin-sonarjs`).
33
- - 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).
34
35
 
35
36
  ### Scope
36
37
 
37
- - Scanner config: overrides, ignores.
38
- - 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).
39
- - Config: linter, type checker, coverage, formatter, prose linter.
40
- - Inferred: implicit escape-hatch types, unawaited async work, defensive noise.
41
- - 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.
42
44
 
43
45
  ### Out of Scope
44
46
 
45
47
  <!-- prettier-ignore -->
46
48
  | Excluded item | Why | Where it belongs |
47
49
  | --- | --- | --- |
48
- | Adding a suppression | Never recommended | — |
49
- | Fixing / deleting findings | Audit reports only | Plan from this report |
50
- | Dead files beyond reference check | Dead-code sweep | `bkit-audit-dead-code` |
51
- | 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` |
52
54
 
53
55
  ### Verdicts
54
56
 
55
- - **FIX:** hides real failure. Name change and override / comment it removes.
56
- - **DELETE:** file dead, scratch, or finished one-off. Config entries hiding whole files only. Name file after reference check.
57
- - **KEEP:** intentional. Record reason beside suppression — reasonless `KEEP` = unexamined next run.
58
- - **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`.
59
62
 
60
- **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.
61
64
 
62
65
  **Always `FIX`:**
63
66
 
64
- - Cast or escape-hatch type where data crosses boundary (SDK call, webhook payload, API response, DB client result) — hides drift boundary tests catch.
65
- - 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.
66
69
 
67
70
  ### Pre-Flight / Dependencies
68
71
 
69
72
  #### Core
70
73
 
71
- - [ ] **Permissions:** blocked calls recorded
72
- - [ ] **Scanner:** Steps 2-4 — pinned in manifest, e.g. `slop-scan`. Fallback: skip scanner steps; run code / config steps.
73
- - [ ] **Worktree:** Steps 2-8 — detached worktree off default branch. Fallback: Steps 5-7 read-only in main checkout; Steps 3, 8 `Not Checked`.
74
- - [ ] **Git History:** Steps 5, 8 — full history for blame and churn. Fallback: ages and churn `Not Checked`.
75
- - [ ] **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.
76
79
 
77
80
  #### Conditional
78
81
 
79
- - [ ] **Language Server:** Typed language → Step 4 — references, e.g. Serena, `tsserver`. Fallback: text search only; name it per `DELETE`.
80
- - [ ] **Typed Lint and Type Coverage:** Typed language → Step 7 — e.g. typescript-eslint typed rules, `type-coverage`, mypy. Fallback: text-search escape-hatch counts.
81
- - [ ] **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`.
82
85
 
83
86
  ### 🔒 Gate 1: Prerequisites Check
84
87
 
85
- - [ ] **Gaps named:** every missing item names its fallback and `Not Checked` entry.
86
- - [ ] **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.
87
90
 
88
91
  ### Probe Steps
89
92
 
90
- - [ ] **Step 1 — Previous Run:** **Done when:** closure rate in `Previous Run`, or run marked baseline.
91
- - [ ] **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.
92
- - [ ] **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.
93
- - [ ] **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.
94
- - [ ] **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:
95
- - Disable naming a rule the resolved config lacks → suppresses nothing → `FIX`.
96
- - Commented-out code → `FIX` unless comment says why it stays.
97
- - `TODO` citing closed tracker item → `FIX`.
98
- - 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`).
99
102
 
100
- **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.
101
104
 
102
- - [ ] **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`.
103
- - [ ] **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.
104
- - [ ] **Step 8 — Hotspots:** Top 20 functions by cognitive complexity (threshold 15) x 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.
105
- - [ ] **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.
106
- - [ ] **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`.
107
110
 
108
111
  ### 🔒 Gate 2: Probes Check
109
112
 
110
- - [ ] **Steps complete:** every step `[x]`, or explicit skip with evidence the surface is absent.
111
- - [ ] **Evidence:** every finding cites re-checkable evidence and the tool behind it.
112
- - [ ] **Tree clean:** scanner config byte-identical to committed; worktree `git status` clean.
113
- - [ ] **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.
114
118
 
115
119
  ## Findings
116
120
 
117
121
  <!-- prettier-ignore -->
118
122
  | Severity | Use |
119
123
  | --- | --- |
120
- | `CRITICAL` | Suppression hides a security, auth, or data-loss failure |
121
- | `HIGH` | Boundary cast / escape-hatch type on untrusted input; promise that can drop handler work; skipped / focused test; blanket disable naming no rule |
122
- | `MEDIUM` | Reason no longer matches code; disable for a rule the config lacks; `TODO` citing closed item; relaxed strictness in one workspace |
123
- | `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 |
124
128
 
125
- Within a severity: security / data first.
129
+ Within a severity, list security and data findings first.
126
130
 
127
131
  <!-- prettier-ignore -->
128
132
  | ID | Severity | Verdict | Location | Evidence | Expected |
129
133
  | --- | --- | --- | --- | --- | --- |
130
134
  | PENDING | PENDING | PENDING | PENDING | PENDING | PENDING |
131
135
 
132
- Empty and clean → one row `None`.
136
+ **If** the run finds nothing → write one row: `None`.
133
137
 
134
138
  ## Report
135
139
 
@@ -174,13 +178,16 @@ PENDING
174
178
 
175
179
  ### 🔒 Gate 3: Report Check
176
180
 
177
- - [ ] **No placeholders:** no `PENDING` left
178
- - [ ] **Summary:** names count per severity and baseline / stripped / suppressed counts.
179
- - [ ] **Series:** `Counts` beside previous report's numbers, or marked baseline.
180
- - [ ] **Writes:** only this report, template `Project Instructions`, and ledger rows changed; throwaway worktrees / remote targets removed.
181
- - [ ] **Process Improvements:** `Universal` and `Project` filled
182
- - [ ] **Suggested Issues:** every `MEDIUM`+ finding ID in exactly one row; every row has a `Next Step`.
183
- - [ ] **Gate 3 — Verified:** Every checkbox above independently verified and checked off.
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.
184
191
 
185
192
  <!-- bkit:end -->
186
193