@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,172 +1,201 @@
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
  # Duplication Audit
8
8
 
9
9
  > [!CAUTION]
10
- > **Purpose:** Verdict on every behaviour with more than one implementation — inline rules, competing capability mechanisms, restated types, paired decisions, and merges that should not have happened.
10
+ > **Purpose:** A verdict on every behaviour with more than one implementation: inline rules, competing capability mechanisms, restated types, paired decisions, and merges that should not have happened.
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
- > - Generated registers / graphs → verify-only mode or throwaway copy; never regenerate a tracked file.
14
+ > - Run generated registers and graphs in verify-only mode, or on a throwaway copy.
15
+ > - Never regenerate a tracked file.
23
16
 
24
17
  ## Universal Instructions
25
18
 
26
19
  ### Context & Goals
27
20
 
28
- Identical-signature gates catch identical copies; divergent duplication hurts — one behaviour, N implementations drifted apart, each locally correct, review and tests pass. Three shapes, invisible to others' detectors: **rule** (one expression inlined at N sites then edited — expression is not a symbol → text / structural search, not language server), **capability** (one operation, N modules or mechanisms — register, reference search, literal-mechanism search), **paired decision** (two files must change together, each owning its half, nothing tying them — co-change history). Shared home existing ≠ every site calls it; documented convention does not stop drift. Until guard covers both altitudes, this sweep = prevention. Target failure: **copies of one piece of knowledge that silently disagree** — e.g. security control left `null` at call site remediation missed.
21
+ Identical-signature gates catch identical copies. The duplication that hurts is divergent: one behaviour with N implementations that have drifted apart, each locally correct, so review and tests pass. It comes in three shapes that other detectors cannot see. A rule is one expression inlined at N sites and then edited. The expression is not a symbol, so it needs text or structural search, not the language server. A capability is one operation done by N modules or mechanisms. It needs the register, reference search and literal-mechanism search. A paired decision is two files that must change together, each owning its half, with nothing tying them. It needs co-change history. A shared home that exists does not mean every site calls it, and a documented convention does not stop drift. Until a guard covers both altitudes, this sweep is the prevention. The failure this audit targets is copies of one piece of knowledge that silently disagree, e.g., a security control left `null` at a call site the remediation missed.
29
22
 
30
- **Applies when:** source code spanning more than one module, package, or platform. None → one `N/A` row with evidence, never "clean".
23
+ **Applies when:** the source code spans more than one module, package or platform. **If** it does not → write one `N/A` row with its evidence, and never report the surface as "clean".
31
24
 
32
- **Cadence:** monthly. Extra pass when consolidation lands (re-check register row and call sites), new owner module or shared package lands, or production failure traces to divergent copies.
25
+ **Cadence:** Run once a month. Run an extra pass when a consolidation lands (re-check its register row and call sites), when a new owner module or shared package lands, or when a production failure traces to divergent copies.
33
26
 
34
- **Anchor Standards:** record version and date read. Newer version → `Standards` step reads what changed.
27
+ **Anchor Standards:**
35
28
 
36
- - Clone taxonomy Type-1 to Type-4 and clone detector at version run (e.g. jscpd clone-types guide, PMD CPD).
37
- - Structural search at version run (e.g. ast-grep, Semgrep).
29
+ - Clone taxonomy Type-1 to Type-4 and clone detector at version run (e.g., jscpd clone-types guide, PMD CPD).
30
+ - Structural search at version run (e.g., ast-grep, Semgrep).
38
31
  - DRY as knowledge, not text (_The Pragmatic Programmer_, edition read).
39
32
  - Rule of three and "The Wrong Abstraction" (Sandi Metz).
40
- - Change coupling (e.g. code-maat).
41
- - Package-manager dedupe at version run (e.g. `pnpm dedupe --check`, `npm dedupe`).
42
- - AI-assisted code-quality research, latest year (e.g. GitClear duplicated-block prevalence).
33
+ - Change coupling (e.g., code-maat).
34
+ - Package-manager dedupe at version run (e.g., `pnpm dedupe --check`, `npm dedupe`).
35
+ - AI-assisted code-quality research, latest year (e.g., GitClear duplicated-block prevalence).
43
36
 
44
37
  ### Scope
45
38
 
46
- - Rule altitude: one business rule inlined at N sites — fallback chains, null vs falsy, formatting, predicates, defaults.
47
- - Capability altitude: one operation with N implementations or mechanisms; capability register.
48
- - Paired decisions: files that must change together with nothing tying them.
49
- - Token and syntax-tree clones (Type-1 to Type-3), incl. cross-platform counterparts.
50
- - Types and schemas restated by hand vs generated / source schema.
51
- - Two libraries for one job; one package resolved at several versions.
52
- - Non-code copies: SQL, shared config, i18n strings.
53
- - Wrong abstractions: landed merges serving different knowledge.
54
- - Prevention: next step = guard or sweep.
39
+ - Check the rule altitude: one business rule inlined at N sites, such as fallback chains, null against falsy, formatting, predicates and defaults.
40
+ - Check the capability altitude: one operation with N implementations or mechanisms, and the capability register.
41
+ - Find paired decisions: files that must change together with nothing tying them.
42
+ - Find token and syntax-tree clones (Type-1 to Type-3), including cross-platform counterparts.
43
+ - Find types and schemas restated by hand instead of derived from the generated or source schema.
44
+ - Find two libraries for one job, and one package resolved at several versions.
45
+ - Find copies outside code: SQL, shared config and i18n strings.
46
+ - Find wrong abstractions: merges that landed and serve different knowledge.
47
+ - Decide whether the next step for prevention is a guard or a sweep.
55
48
 
56
49
  ### Out of Scope
57
50
 
58
51
  <!-- prettier-ignore -->
59
52
  | Excluded item | Why | Where it belongs |
60
53
  | --- | --- | --- |
61
- | Single-call-site helpers | Not duplication | — |
62
- | Capability with one implementation that is wrong | Gap, not duplication | Plan / `docs/failures.jsonl` |
63
- | Unreachable modules beyond reference check | Dead-code sweep | `bkit-audit-dead-code` |
64
- | One-off structural problems; module-graph shape | Architecture sweep | `bkit-audit-architecture` |
65
- | Upgrading / removing dependencies | Dependency sweep | `bkit-audit-dependencies` |
66
- | Mobile OS divergence (e.g. iOS vs Android) | Test-lane blind spot | `bkit-audit-testing` |
67
- | Building the guard; CI wiring | Gate change | `bkit-audit-gates` |
68
- | Consolidating copies | Audit reports only | Plan from this report |
54
+ | Single-call-site helpers | They are not duplication | — |
55
+ | Capability with one implementation that is wrong | It is a gap, not duplication | Plan / `docs/failures.jsonl` |
56
+ | Unreachable modules beyond reference check | The dead-code sweep covers it | `bkit-audit-dead-code` |
57
+ | One-off structural problems; module-graph shape | The architecture sweep covers it | `bkit-audit-architecture` |
58
+ | Upgrading / removing dependencies | The dependency sweep covers it | `bkit-audit-dependencies` |
59
+ | Mobile OS divergence (e.g., iOS vs Android) | It is a test-lane blind spot | `bkit-audit-testing` |
60
+ | Building the guard; CI wiring | It is a gate change | `bkit-audit-gates` |
61
+ | Consolidating copies | The audit only reports | A plan made from this report |
69
62
 
70
63
  ### Verdicts
71
64
 
72
- - **DUPLICATE:** one piece of knowledge; copies change for the same reason. Name the consolidation and its home.
73
- - **COINCIDENTAL:** looks alike; changes for different reasons. Leave; record why.
74
- - **RULE-OF-THREE-PENDING:** two copies of one piece of knowledge. Record and watch; consolidate at the third.
75
- - **OTHER:** fits none; say why. Same `OTHER` on 2 runs → propose new verdict in `Process Improvements`.
65
+ - **DUPLICATE:** the copies are one piece of knowledge, and change for the same reason. Name the consolidation and its home.
66
+ - **COINCIDENTAL:** the copies look alike, but change for different reasons. Leave them, and record why.
67
+ - **RULE-OF-THREE-PENDING:** there are two copies of one piece of knowledge. Record them and watch; consolidate at the third.
68
+ - **OTHER:** it fits no other verdict. Say why. **If** the same `OTHER` shows up on 2 runs → propose a new verdict in `Process Improvements`.
76
69
 
77
- **Test:** same knowledge, same reason to change. A paired decision = one decision in two places → `DUPLICATE`; home = paired-owner check or gate.
70
+ **Test:** the copies hold the same knowledge, with the same reason to change. A paired decision is one decision in two places, so it is `DUPLICATE`, and its home is a paired-owner check or a gate.
78
71
 
79
72
  **Confirm before `DUPLICATE`:**
80
73
 
81
- - Duplicated name ≠ deliberate platform split (e.g. `.native.tsx` / `.web.tsx`) or local UI handler.
82
- - Bypass is gratuitous, not a surface the owner cannot serve (e.g. framework-specific request context).
83
- - Similar defaults are one decision — a least-privilege read default and a signup write default are not; forcing one value breaks a flow.
84
- - "Dead" / "unwired" copy has no config-only or deployed consumer (explicit worker registries, deployed functions).
85
- - Co-change history (`Coupling`) says one decision, or already diverged.
74
+ - A duplicated name is not a deliberate platform split (e.g., `.native.tsx` / `.web.tsx`) or a local UI handler.
75
+ - The bypass is gratuitous, not a surface the owner cannot serve (e.g., a framework-specific request context).
76
+ - Similar defaults are one decision. A least-privilege read default and a signup write default are not, and forcing one value breaks a flow.
77
+ - A "dead" or "unwired" copy has no config-only or deployed consumer: an explicit worker registry or a deployed function.
78
+ - Co-change history (`Coupling`) says it is one decision, or that the copies have already diverged.
86
79
 
87
- Carry `COINCIDENTAL` and `RULE-OF-THREE-PENDING` forward in `Carried Forward` — a two-site finding is neither consolidated early nor rediscovered every run.
80
+ Carry `COINCIDENTAL` and `RULE-OF-THREE-PENDING` forward in `Carried Forward`, so a two-site finding is neither consolidated early nor rediscovered on every run.
88
81
 
89
82
  ### Pre-Flight / Dependencies
90
83
 
91
- **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.
92
-
93
- **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.
94
-
95
84
  #### Core
96
85
 
97
- Always verify.
98
-
99
- - [ ] **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.
100
- - [ ] **Clean Tree:** Steps 2–13 — clean `git status` at recorded commit; findings only mean something against a known tree. Fallback: detached worktree off default branch.
101
- - [ ] **Text Search:** Steps 3, 5, 7–10 — inline expressions, literals, env names, non-code files, e.g. ripgrep, `git grep`. Fallback: `grep -rn`.
102
- - [ ] **Structural Search:** Steps 3, 12 — syntax patterns that skip comments / strings and catch reordered copies, e.g. ast-grep, Semgrep; ad hoc run, record resolved version. Fallback: text search; reformatted copies `Not Checked`.
103
- - [ ] **Clone Detector:** Steps 4, 8 — Type-1 to Type-3 clones, e.g. jscpd, PMD CPD; ad hoc run, record resolved version. Fallback: `Clones` `Not Checked`.
104
- - [ ] **Git History:** Steps 4, 10 — full history for clone baseline, blame, and co-change. Fallback: growth and coupling `Not Checked`.
105
- - [ ] **Web:** Step 14 — fetch anchor standards. Fallback: versions recorded as unread.
86
+ - [ ] **Permissions:** every blocked call is recorded.
87
+ - [ ] **Clean Tree:** Steps 2-13 — a clean `git status` at the recorded commit, because findings only mean something against a known tree. Fallback: use a detached worktree off the default branch.
88
+ - [ ] **Text Search:** Steps 3, 5, 7-10 — inline expressions, literals, env names and non-code files (e.g., ripgrep, `git grep`). Fallback: `grep -rn`.
89
+ - [ ] **Structural Search:** Steps 3, 12 — syntax patterns that skip comments and strings and catch reordered copies (e.g., ast-grep, Semgrep). Run it ad hoc, and record the resolved version. Fallback: text search, and mark reformatted copies `Not Checked`.
90
+ - [ ] **Clone Detector:** Steps 4, 8 — Type-1 to Type-3 clones (e.g., jscpd, PMD CPD). Run it ad hoc, and record the resolved version. Fallback: mark `Clones` `Not Checked`.
91
+ - [ ] **Git History:** Steps 4, 10 — the full history, for the clone baseline, blame and co-change. Fallback: mark growth and coupling `Not Checked`.
92
+ - [ ] **Web:** Step 14 — fetch the anchor standards. Fallback: record the versions as unread.
106
93
 
107
94
  #### Conditional
108
95
 
109
- Verify only when applicable.
110
-
111
- - [ ] **Language Server:** Typed language → Steps 3, 5, 13 — references on helpers and owners, e.g. Serena, `tsserver`, pyright. Fallback: text search only; caller sets = hypotheses; `one` vs `bypassed` unproven.
112
- - [ ] **Module Graph:** Steps 5, 10 — duplicate symbol names, god nodes, import edges, e.g. graphify, dependency-cruiser, madge. Fallback: module-graph cross-check `Not Checked`.
113
- - [ ] **Capability Register:** Register exists → Step 5 — capability → owner → status, verify-only mode. Fallback: rows derived in `Capabilities` only; no register = finding.
114
- - [ ] **Cross-Platform Compare:** 2+ platforms / apps sharing behaviour → Step 4 — counterpart listing, e.g. jscpd `--compare`. Fallback: text search for counterparts.
115
- - [ ] **Package Manager:** Lockfile → Step 7 — dedupe check and resolution reason, e.g. `pnpm dedupe --check` / `pnpm why`, `npm ls --all`. Fallback: read lockfile.
96
+ - [ ] **Language Server:** **If** the language is typed → Steps 3, 5, 13 — references on helpers and owners (e.g., Serena, `tsserver`, pyright). Fallback: text search only. Treat caller sets as hypotheses, and `one` against `bypassed` as unproven.
97
+ - [ ] **Module Graph:** Steps 5, 10 — duplicate symbol names, god nodes and import edges (e.g., graphify, dependency-cruiser, madge). Fallback: mark the module-graph cross-check `Not Checked`.
98
+ - [ ] **Capability Register:** **If** a register exists → Step 5 — capability, owner and status, in verify-only mode. Fallback: derive the rows in `Capabilities` only. No register is a finding.
99
+ - [ ] **Cross-Platform Compare:** **If** 2 or more platforms or apps share behaviour → Step 4 — a counterpart listing (e.g., jscpd `--compare`). Fallback: text search for counterparts.
100
+ - [ ] **Package Manager:** **If** the project has a lockfile → Step 7 — the dedupe check and the resolution reason (e.g., `pnpm dedupe --check` / `pnpm why`, `npm ls --all`). Fallback: read the lockfile.
116
101
 
117
102
  ### 🔒 Gate 1: Prerequisites Check
118
103
 
119
- **Checkpoint.** Verify and check `[x]` all applicable boxes above, then continue to `Probe Steps` without asking.
120
-
121
- - [ ] **Gaps named:** every missing item names its fallback and `Not Checked` entry.
122
- - [ ] **Gate 1 - Verified:** All Core items checked. All applicable Conditional items checked.
104
+ - [ ] **Gaps named:** every missing item names its fallback and its `Not Checked` entry.
105
+ - [ ] **Gate 1 — Verified:** every item above, every Core item and every applicable Conditional item is checked.
123
106
 
124
107
  ### Probe Steps
125
108
 
126
- - [ ] **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.
127
- - [ ] **Step 2 — Detect:** List apps, packages, platforms; shared homes (utility / owner modules); capability register; duplication gates enforced and what each catches (e.g. identical-signature gate → identical copies only). **Done when:** surface map and existing gates in `Checked`, or `N/A` and STOP.
128
- - [ ] **Step 3 — Rule Altitude:** Hunt one conceptual operation inlined at N sites instead of called from one function, copies differing on load-bearing details: fallback chains (e.g. JS `a ?? b ?? c`, divergent terminal fallback or order); null vs falsy (e.g. JS `??` vs `||`, with / without trim, optional-chain guards); formatting (date / time / timezone, currency, name / initials, address); predicates ("is active / deleted / owner?" filters); defaults (same enum / config default hardcoded in several readers). Structural rules where possible, text search where not; keep rules under `tmp/`, paste each into report for next run. Subtraction per shared helper: references on helper (routed set) minus sites matching inline pattern (inline set) → inline-not-routed = unmigrated site. Counts before reference-graph change (e.g. project references added) = stale → re-take, never carry forward. **Done when:** `Inline Rules` row per rule: helper · routed · inline · unmigrated · verdict, with its search rule.
129
- - [ ] **Step 4 — Clones:** Clone detector over source roots, machine-readable output, three passes: Type-1 exact; Type-2 renamed (ignore identifiers / literals); Type-3 near-miss (e.g. similarity 0.85, syntax-tree mode). Duplication % per package as series vs previous report. Every hit = candidate for `Verify`, not finding. Multiple platforms → counterpart listing (functions with / without counterpart per side). Growth: exact pass baselined at previous report's commit → clones new since vs consolidated since, blame naming introducer; arrival faster than consolidation = finding. **Done when:** per-package %, growth, counterpart list in `Clones`.
130
- - [ ] **Step 5 — Capability Altitude:** Above file graph: capabilities, not files. Per capability: owner, callers, status, note. Status: `one` = one implementation, every caller routes through it; `bypassed` = owner exists, some callers skip it; `split` = 2+ competing implementations, no owner; `gap` = designed, not built. Three detectors — different findings: (a) literal-mechanism search for second mechanism (e.g. second SDK client constructor, rate limiter, email-send call, duplicated validation regex) — primary; symbol graph cannot see duplicated regex; (b) language-server references on each owner → caller set, `one` vs `bypassed`; (c) module-graph duplicate-symbol-name check — group callable nodes by name across distinct non-test source files, 3+ definitions = candidate; god-node list flags owner gone load-bearing. Register status ≠ measured status = finding; register is not edited. **Done when:** `Capabilities` row per capability: owner · callers · measured status · register status · verdict.
131
- - [ ] **Step 6 — Restated Types:** Typed language with schema source (generated DB types, migrations, IDL) → per core table: hand-written types, validation schemas, route validators restating columns, enums, constraints. Not derived from source = finding. Diff vs source: column added, renamed, or nullable on one side only = live defect. **Done when:** `Types` row per restated type: source · derived? · drift · verdict, or skip with evidence.
132
- - [ ] **Step 7 — Libraries:** Literal search finds second client, not second library. List dependencies across every manifest doing one job: two date libraries, two validation libraries or two majors side by side, two HTTP clients, two markdown parsers. Dedupe check and resolution reason for every package at more than one version. Each = capability row with library as mechanism. **Done when:** `Libraries` lists every same-job pair and multi-version package with reason.
133
- - [ ] **Step 8 — Outside Code:** SQL: access-policy bodies and helper functions redefined across migrations vs one function. Shared config: type-checker, linter, styling presets copied between apps vs extending shared package. i18n: same string under several keys. List formats clone detector supports; run over migrations and config; text search the rest. **Done when:** every hit = candidate for `Verify`; absent surface in `Checked`.
134
- - [ ] **Step 9 — Wrong Abstractions:** Opposite failure: merge that landed and should not have. Shared helpers with boolean / mode parameters or per-caller branches (e.g. `if (caller === …)`, >2 option flags) and <3 callers. Callers serve different knowledge → recommend inlining back. `Verify` guards new merges; this reviews old ones. **Done when:** `Wrong Abstractions` row per helper: params · callers · knowledge · verdict.
135
- - [ ] **Step 10 — Coupling:** Per candidate set: co-change history (e.g. `git log --name-only`, code-maat). Always changed together → true duplicate, consolidate; changed separately → already diverged, decide which behaviour is right first. Reverse detector: file pairs in different packages, or one per platform, co-changing in >50% of commits with no import edge → paired-decision candidate. Comments tying two files by prose (e.g. `keep in sync`, `must match`, `mirrors`). Pair → straight to `Prevention`. **Done when:** `Coupling` row per candidate and pair: co-change share · import edge · verdict.
136
- - [ ] **Step 11 — Confidence:** Name tool behind every count. Grade claim types: second implementation exists = high (every site read, not matched); exact call-site counts = medium; "no production consumer" = medium, needs in-code corroboration; "does not exist" = high only when absent from schema and all source. Language server under-reports → false `one`: pace queries; re-run surprising low / empty count before recording; empty = inconclusive, corroborate with text search; mocked-module factory keys and packages outside project graph invisible. Module graph: confirms presence, never absence; misses callers in anonymous callbacks and module-level initialisers; manifest-driven or type-only edges can fake cross-package edges and cycles; stale resolution cache after path-alias change. Language server and text search agreeing on count = strongest evidence; disagreement names file to open. Count corrected mid-run → record which, from what, by what tool. **Done when:** `Method` grades every claim type and names tool per count, incl. corrections.
137
- - [ ] **Step 12 — Prevention:** Does a guard fail on re-implementation at both altitudes — inline rule expression outside its helper, and mechanism (constructor, send call, env name) outside its owner? Per-rule bespoke guard = one guard per consolidated field, forever; structural rule per pattern (owner-file ignores, rules checked in, seeded from Step 3 rules) plus literal search with owner allowlist (env names) covers both altitudes without language server. Record whether recorded decisions favour guard or sweep, and whether evidence since contradicts them. Do not build. **Done when:** `Prevention` states next step = guard or sweep, with evidence and the rules it would start from.
138
- - [ ] **Step 13 — Verify:** Open every candidate file; cite `file:line` for every survivor. Apply `Verdicts` checks; re-check previous `Carried Forward` rows (third copy → `DUPLICATE`). Rank survivors by blast radius × divergence × user-visibility. Per survivor name consolidation and home: rule → one function in correct shared package, inline copies removed; capability → one owner module with call contract, register row updated; wrong abstraction → inlined back; paired decision → paired-owner check or gate; drifted type or live defect → `docs/failures.jsonl` row, fix ahead of refactor; second library / version → `bkit-audit-dependencies`; deliberate bypass blocked on other work → register row naming blocker (unrecorded bypass reads `one` next run = false clean); one-off structural problem or missing module-graph evidence → `bkit-audit-architecture`. Consolidation changing shared signature → `Expected` names reference check first. **Done when:** every candidate has verdict, evidence, rank, and home.
139
- - [ ] **Step 14 — Standards:** Confirm current version per anchor standard; read changes since previous report's version. `Standards Coverage`: one row per standard, per clone type (Type-1 to Type-4), and per shape (rule, capability, paired decision) → checked (name step) / not applicable (why) / finding. Unapplied recommended practice → adopt (propose step) / reject (why) / not applicable. **Done when:** no empty row.
140
- - [ ] **Step 15 — Anything Else:** (a) Everything changed since previous report's commit touching duplication (new shared helpers / owner modules, shared packages, cross-platform counterparts of screen or hook, validation schemas and route validators, migrations adding tables / enums / policies, new dependencies, config presets, i18n keys) → one-line verdict each. (b) Bounded ~30 min pass: what senior engineer owning shared packages 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`.
109
+ - [ ] **Step 1 — Previous Run:** **Done when:** `Previous Run` holds the closure rate, or the run is marked baseline.
110
+ - [ ] **Step 2 — Detect:** List the apps, packages and platforms; the shared homes (utility and owner modules); the capability register; and the duplication gates enforced, with what each one catches (e.g., an identical-signature gate catches identical copies only). **Done when:** `Checked` holds surface map and existing gates, or `N/A` is recorded → **STOP**.
111
+ - [ ] **Step 3 — Rule Altitude:** Hunt for one conceptual operation inlined at N sites instead of called from one function, where the copies differ on load-bearing details. Look at fallback chains (e.g., JS `a ?? b ?? c`, with a different terminal fallback or order); null against falsy (e.g., JS `??` against `||`, with or without trim, optional-chain guards); formatting (date, time and timezone, currency, name and initials, address); predicates ("is active / deleted / owner?" filters); and defaults (the same enum or config default hardcoded in several readers). Use structural rules where possible, and text search where not. A structural census searches both `fn($$$)` and the generic-call form `fn<$T>($$$)`, plus renamed imports, because a rule for the plain call misses the other two. Keep the rules under `tmp/`, and paste each one into the report for the next run. For each shared helper, subtract: the references on the helper are the routed set, the sites matching the inline pattern are the inline set, and inline-but-not-routed sites are unmigrated. Counts taken before a reference-graph change (e.g., project references added) are stale, so take them again; never carry them forward. **Done when:** `Inline Rules` has a row per rule: helper · routed · inline · unmigrated · verdict, with its search rule.
112
+ - [ ] **Step 4 — Clones:** Run the clone detector over the source roots, with machine-readable output, in three passes: Type-1 exact; Type-2 renamed (ignoring identifiers and literals); and Type-3 near-miss (e.g., similarity 0.85, syntax-tree mode). Exclude generated files (e.g., migration snapshots, generated types, import maps) before quoting a duplication %. Record the duplication % per package as a series against the previous report. Every hit is a candidate for `Verify`, not a finding. **If** there are multiple platforms → list the counterparts: the functions with and without a counterpart on each side. Growth: baseline the exact pass at the previous report's commit, then count the clones new since then against the ones consolidated since then, with blame naming who introduced each. Clones arriving faster than they are consolidated is a finding. **Done when:** `Clones` holds the per-package %, the growth and the counterpart list.
113
+ - [ ] **Step 5 — Capability Altitude:** Work above the file graph, on capabilities rather than files. For each capability, record the owner, the callers, the status and a note.
114
+ - Give each capability one status:
115
+ - `one` = there is one implementation, and every caller routes through it.
116
+ - `bypassed` = an owner exists, and some callers skip it.
117
+ - `split` = 2 or more implementations compete, with no owner.
118
+ - `gap` = it is designed but not built.
119
+ - Run all three detectors, because each one finds something the others miss:
120
+ - (a) Literal-mechanism search for a second mechanism (e.g., a second SDK client constructor, rate limiter, email-send call or duplicated validation regex). It is the primary detector, because the symbol graph cannot see a duplicated regex.
121
+ - (b) Language-server references on each owner. They give the caller set, and decide `one` against `bypassed`.
122
+ - (c) The module graph's duplicate-symbol-name check. It groups callable nodes by name across distinct non-test source files, and 3 or more definitions make a candidate. Its god-node list flags an owner that has become load-bearing.
123
+ - A register status that differs from the measured status is a finding.
124
+ - This run does not edit the register. Put each register correction in `Expected`.
125
+
126
+ **Done when:** `Capabilities` has a row per capability: owner · callers · measured status · register status · verdict.
127
+
128
+ - [ ] **Step 6 — Restated Types:** **If** the language is typed **and** there is a schema source (generated DB types, migrations, IDL) → for each core table, find the hand-written types, validation schemas and route validators that restate its columns, enums and constraints. A restatement not derived from the source is a finding. Diff it against the source: a column added, renamed or made nullable on one side only is a live defect. **Done when:** `Types` has a row per restated type: source · derived? · drift · verdict, or the skip is recorded with evidence.
129
+ - [ ] **Step 7 — Libraries:** Literal search finds a second client, not a second library. List the dependencies across every manifest that do one job: two date libraries, two validation libraries or two majors side by side, two HTTP clients, or two markdown parsers. Run the dedupe check, and give the resolution reason for every package at more than one version. Each one is a capability row, with the library as the mechanism. **Done when:** `Libraries` lists every same-job pair, and every multi-version package with its reason.
130
+ - [ ] **Step 8 — Outside Code:** SQL: access-policy bodies and helper functions redefined across migrations instead of one function. Shared config: type-checker, linter and styling presets copied between apps instead of extending a shared package. i18n: the same string under several keys. List the formats the clone detector supports, run it over migrations and config, and text search the rest. **Done when:** every hit is a candidate for `Verify`, and an absent surface is in `Checked`.
131
+ - [ ] **Step 9 — Wrong Abstractions:** This is the opposite failure: a merge that landed and should not have. Find shared helpers with boolean or mode parameters, or per-caller branches (e.g., `if (caller === …)`, more than 2 option flags), and fewer than 3 callers. **If** the callers serve different knowledge → recommend inlining it back. `Verify` guards new merges, and this step reviews old ones. **Done when:** `Wrong Abstractions` has a row per helper: params · callers · knowledge · verdict.
132
+ - [ ] **Step 10 — Coupling:** For each candidate set, read the co-change history (e.g., `git log --name-only`, code-maat). **If** the files always changed together → it is a true duplicate; consolidate it. **If** they changed separately → they have already diverged, so decide which behaviour is right first. Run the reverse detector: file pairs in different packages, or one per platform, that co-change in more than 50% of commits with no import edge are paired-decision candidates. Also find comments that tie two files together in prose (e.g., `keep in sync`, `must match`, `mirrors`). A pair goes straight to `Prevention`. **Done when:** `Coupling` has a row per candidate and pair: co-change share · import edge · verdict.
133
+ - [ ] **Step 11 — Confidence:** Name the tool behind every count.
134
+ - Grade each claim type:
135
+ - "A second implementation exists" = high, because every site was read rather than matched.
136
+ - Exact call-site counts = medium.
137
+ - "No production consumer" = medium, and needs corroboration in the code.
138
+ - "Does not exist" = high only when it is absent from the schema and from all source.
139
+ - Pace the language-server queries. The language server under-reports, which gives a false `one`.
140
+ - Re-run a surprisingly low or empty count before recording it.
141
+ - Corroborate an empty result with text search, because an empty result is inconclusive.
142
+ - Use text search for mocked-module factory keys and packages outside the project graph, because the language server cannot see them.
143
+ - Treat the module graph as proof of presence, never of absence. It misses callers in anonymous callbacks and module-level initialisers. Manifest-driven or type-only edges can fake cross-package edges and cycles, and the resolution cache goes stale after a path-alias change.
144
+ - Treat a count on which the language server and text search agree as the strongest evidence.
145
+ - **If** the language server and text search disagree on a count → name the file to open.
146
+ - **If** a count is corrected mid-run → record which count, from what, and by what tool.
147
+
148
+ **Done when:** `Method` grades every claim type and names the tool for each count, including the corrections.
149
+
150
+ - [ ] **Step 12 — Prevention:** Check whether a guard fails on re-implementation at both altitudes: an inline rule expression outside its helper, and a mechanism (a constructor, a send call, an env name) outside its owner. A bespoke guard per rule means one guard per consolidated field, forever. A structural rule per pattern (with owner-file ignores, the rules checked in, seeded from the Step 3 rules, each covering the plain call, the generic-call form and renamed imports), plus a literal search with an owner allowlist for env names, covers both altitudes without the language server. Record whether the recorded decisions favour a guard or a sweep, and whether evidence since then contradicts them. Do not build anything. **Done when:** `Prevention` states whether the next step is a guard or a sweep, with the evidence and the rules it would start from.
151
+ - [ ] **Step 13 — Verify:** Open every candidate file.
152
+ - Cite `file:line` for every survivor.
153
+ - Apply the `Verdicts` checks.
154
+ - Re-check the previous `Carried Forward` rows. A third copy makes one `DUPLICATE`.
155
+ - Rank the survivors by blast radius x divergence x user visibility.
156
+ - Name each survivor's consolidation and its home in `Expected`, for the next step to apply:
157
+ - A rule → one function in the correct shared package, with the inline copies removed.
158
+ - A capability → one owner module with a call contract, and the register row to update.
159
+ - A wrong abstraction → inline it back.
160
+ - A paired decision → a paired-owner check or a gate.
161
+ - A drifted type or a live defect → its finding, which becomes a `docs/failures.jsonl` row, fixed ahead of any refactor.
162
+ - A second library or version → `bkit-audit-dependencies`.
163
+ - A deliberate bypass blocked on other work → the register row to add, naming the blocker. An unrecorded bypass reads as `one` on the next run, which is a false clean.
164
+ - A one-off structural problem, or missing module-graph evidence → `bkit-audit-architecture`.
165
+ - **If** a consolidation changes a shared signature → `Expected` names the reference check to run first.
166
+
167
+ **Done when:** every candidate has a verdict, evidence, a rank and a home.
168
+
169
+ - [ ] **Step 14 — Standards:** Confirm the current version of each anchor standard, and read what changed since the previous report's version. In `Standards Coverage`, give one row per standard, per clone type (Type-1 to Type-4), and per shape (rule, capability, paired decision), marked checked (with the step), not applicable (saying why) or finding. Mark each recommended practice the project does not apply as adopt (with a proposed step), reject (saying why) or not applicable. **Done when:** no row is empty.
170
+ - [ ] **Step 15 — Anything Else:** (a) List everything changed since the previous report's commit that touches duplication (new shared helpers and owner modules, shared packages, cross-platform counterparts of a screen or hook, validation schemas and route validators, migrations adding tables, enums or policies, new dependencies, config presets and i18n keys), with a one-line verdict each. (b) In a bounded pass of about 30 minutes, note what a senior engineer owning shared packages would flag that no step asks about. Read what happened since the previous run (incidents, new `docs/failures.jsonl` rows), and note what no step would catch. **Done when:** `Beyond the Steps` holds both passes, or says `none`. **If** one class of issue is seen on 2 runs → propose a step for it in `Process Improvements`.
141
171
 
142
172
  ### 🔒 Gate 2: Probes Check
143
173
 
144
- **Checkpoint.** Verify and check `[x]` all boxes below, then continue to `Findings` without asking.
145
-
146
- - [ ] **Steps complete:** every step `[x]`, or explicit skip with evidence the surface is absent.
147
- - [ ] **Evidence:** every finding cites re-checkable evidence and the tool behind it.
174
+ - [ ] **Steps complete:** every step is `[x]`, or skipped with evidence that its surface is absent.
175
+ - [ ] **Evidence:** every finding cites evidence someone can check again, and the tool that produced it.
148
176
  - [ ] **Sites read:** every `DUPLICATE` cites `file:line` from an opened file, not a match.
149
- - [ ] **Tree clean:** no tracked file changed by this run (other writers' paths named); tracked registers / graphs unchanged.
150
- - [ ] **Gate 2 - Verified:** Every checkbox above independently verified and checked off.
177
+ - [ ] **Other writers:** `Not Checked` names every changed path that this run did not write.
178
+ - [ ] **Registers unchanged:** the tracked registers and graphs are unchanged.
179
+ - [ ] **Gate 2 — Verified:** every item above holds.
151
180
 
152
181
  ## Findings
153
182
 
154
183
  <!-- prettier-ignore -->
155
184
  | Severity | Use |
156
185
  | --- | --- |
157
- | `CRITICAL` | Divergent copy disables a security / access control (e.g. rate limiter, auth, or tenancy check) or loses data; broken workflow with no workaround |
158
- | `HIGH` | User-visible divergence between copies of one rule; hand-written type drifted from schema; paired decision out of step; `split` capability on a request path |
159
- | `MEDIUM` | Copies consistent today (drift risk, no live bug); `bypassed` owner; register status ≠ measured; wrong abstraction; two libraries / versions for one job; SQL / config / i18n copies; clone growth outpacing consolidation |
160
- | `LOW` | Cosmetic copies; test-only clones; stale register note changing no status |
186
+ | `CRITICAL` | A divergent copy disables a security or access control (e.g., a rate limiter, auth or a tenancy check), or loses data. A workflow is broken with no workaround. |
187
+ | `HIGH` | Copies of one rule diverge in a way users can see. A hand-written type has drifted from the schema. A paired decision is out of step. A `split` capability sits on a request path. |
188
+ | `MEDIUM` | Copies are consistent today, with drift risk and no live bug. An owner is `bypassed`. The register status differs from the measured one. An abstraction is wrong. Two libraries or versions do one job. SQL, config or i18n is copied. Clone growth outpaces consolidation. |
189
+ | `LOW` | Copies are cosmetic. Clones are test-only. A stale register note changes no status. |
161
190
 
162
- Scale per `.bkit/jsonl.md` § Severity. Within a severity: higher blast radius × divergence × user-visibility first.
191
+ Within a severity, list higher blast radius x divergence x user visibility first.
163
192
 
164
193
  <!-- prettier-ignore -->
165
194
  | ID | Severity | Verdict | Location | Evidence | Expected |
166
195
  | --- | --- | --- | --- | --- | --- |
167
196
  | PENDING | PENDING | PENDING | PENDING | PENDING | PENDING |
168
197
 
169
- Empty and clean → one row `None`.
198
+ **If** the run finds nothing → write one row: `None`.
170
199
 
171
200
  ## Report
172
201
 
@@ -247,17 +276,17 @@ PENDING
247
276
 
248
277
  ### 🔒 Gate 3: Report Check
249
278
 
250
- **Checkpoint.** Verify and check `[x]` all boxes below, then stop.
251
-
252
- - [ ] **No placeholders:** Findings table and every `Report` section have no `PENDING`.
253
- - [ ] **Summary:** names count per severity, count per verdict, and the guard-or-sweep call.
254
- - [ ] **Series:** per-package duplication % and clone growth beside previous report's numbers, or marked baseline.
255
- - [ ] **Writes:** only this report and template `Project Instructions` changed; throwaway worktrees / remote targets removed.
256
- - [ ] **Process Improvements:** `Universal` = proposed step changes, template untouched; `Project` = edits applied below `bkit:end`; each `none` if empty.
257
- - [ ] **Suggested Issues:** every `MEDIUM`+ finding ID in exactly one row; every row has a `Next Step`.
258
- - [ ] **Gate 3 - Verified:** Every checkbox above independently verified and checked off.
259
-
260
- > `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.
279
+ - [ ] **No placeholders:** no `PENDING` is left.
280
+ - [ ] **Summary:** `Summary` gives the count per severity.
281
+ - [ ] **Verdict counts:** `Summary` gives the count per verdict.
282
+ - [ ] **Guard or sweep:** `Summary` states the guard-or-sweep call.
283
+ - [ ] **Series:** the report shows per-package duplication % and clone growth beside the previous report's numbers, or marks the run as baseline.
284
+ - [ ] **Writes:** this run changed only this report, the template's `Project Instructions` and its own `docs/failures.jsonl` rows.
285
+ - [ ] **Throwaways removed:** every throwaway worktree or remote target is removed.
286
+ - [ ] **Process Improvements:** `Universal` and `Project` are both filled.
287
+ - [ ] **Suggested Issues:** every `MEDIUM`+ finding ID is in exactly one `Suggested Issues` row.
288
+ - [ ] **Next Step:** every `Suggested Issues` row has a `Next Step`.
289
+ - [ ] **Gate 3 — Verified:** every item above holds.
261
290
 
262
291
  <!-- bkit:end -->
263
292