@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,129 +1,157 @@
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
  # Database Audit
8
8
 
9
9
  > [!CAUTION]
10
- > **Purpose:** Catalogue-backed check of privileges, access coverage, migrations, integrity, capacity, and restore.
10
+ > **Purpose:** A catalogue-backed check of privileges, access coverage, migrations, integrity, capacity and restore.
11
11
  >
12
12
  > **Rules:**
13
13
  >
14
- > - Remote catalogue queries ONLY use `SELECT` (non-relational: read-only reads); writes run locally, or in explicitly rolled-back transactions; ALWAYS check remote unchanged.
15
- > - NEVER push schema to remote by hand; NEVER hard-delete; restore target = throwaway, deleted before report finishes.
16
- > - Every claim names the environment it ran against.
14
+ > - Query a remote catalogue ONLY with `SELECT`. For a non-relational store, use ONLY its read-only reads.
15
+ > - Run writes ONLY locally, or inside a transaction you roll back explicitly.
16
+ > - Always check afterwards that the remote is unchanged.
17
+ > - NEVER push schema to a remote by hand.
18
+ > - NEVER hard-delete.
19
+ > - Restore ONLY into a throwaway target, and delete it before the report finishes.
20
+ > - Name the environment each claim ran against.
17
21
 
18
22
  ## Universal Instructions
19
23
 
20
24
  ### Context & Goals
21
25
 
22
- Migrations and integration tests exercise queries; neither verifies privileges, policies, or constraints match code assumptions. Target failure: **a control that reads as enforced in migration text and is not enforced in the live catalogue** — e.g. `REVOKE` undone by platform default privileges, tenant table with no row-level policy, `CHECK` evaluating `NULL` (not `FALSE`) for the shape it should reject. Only the catalogue knows → query it.
26
+ Migrations and integration tests exercise queries, but neither checks that privileges, policies and constraints match what the code assumes. The failure this audit targets is **a control that reads as enforced in the migration text but is not enforced in the live catalogue**: for example, a `REVOKE` undone by the platform's default privileges, a tenant table with no row-level policy, or a `CHECK` that evaluates to `NULL` (not `FALSE`) for the shape it should reject. Only the catalogue knows, so query it.
27
+
28
+ **Applies when:** migrations, a schema file or a DB client appear in a manifest. **If** none appears → write one `N/A` row with its evidence, and never report the surface as "clean". **If** the DB is relational → run every step. **If** it is a non-relational store (e.g., Firestore, DynamoDB, MongoDB):
23
29
 
24
- **Applies when:** migrations, schema file, or DB client in a manifest. None → one `N/A` row with evidence, never "clean". Relational DB → all steps. Non-relational store (e.g. Firestore, DynamoDB, MongoDB) → Steps 1-4, 6-9, 12-13, 17-19 against its own mechanism (e.g. Firestore security rules, IAM policies, admin SDK vs client SDK); Steps 5, 10-11, 14-16 only where it has an equivalent, else `N/A` with evidence.
30
+ - Run Steps 1-4, 6-9, 12-13 and 17-19 against its own mechanism (e.g., Firestore security rules, IAM policies, admin SDK vs client SDK).
31
+ - **If** the store has an equivalent for one of Steps 5, 10-11 and 14-16 → run that step against it.
32
+ - **Else** → write `N/A` for that step, with evidence.
25
33
 
26
- **Cadence:** monthly. Extra pass when a migration adds a privileged function, changes access policy, or adds a tenancy-scoped table.
34
+ **Cadence:** Run once a month. Run an extra pass when a migration adds a privileged function, changes an access policy or adds a tenancy-scoped table.
27
35
 
28
36
  **Anchor Standards:**
29
37
 
30
- - Platform production checklist and security guide (e.g. Supabase).
31
- - Platform advisors and inspection CLI (e.g. Supabase Advisors, `supabase inspect db`); record CLI version.
38
+ - Platform production checklist and security guide (e.g., Supabase).
39
+ - Platform advisors and inspection CLI (e.g., Supabase Advisors, `supabase inspect db`); record the version.
32
40
  - Platform backup / restore docs.
33
41
  - Platform serverless connection guidance.
34
- - DB routine-maintenance docs, edition = hosted major (e.g. PostgreSQL Routine Database Maintenance Tasks).
35
- - Safe-migration rule set (e.g. Squawk); record version.
42
+ - DB routine-maintenance docs, edition = hosted major (e.g., PostgreSQL Routine Database Maintenance Tasks).
43
+ - Safe-migration rule set (e.g., Squawk); record version.
36
44
  - bkit block of `docs/setup.md` (bkit version from `.bkit/version`): Rules
37
45
 
38
46
  ### Scope
39
47
 
40
- - Catalogue privileges: functions, tables, sequences.
41
- - Role each code write actually runs as.
42
- - Row-level access coverage; exposure outside main schema (file storage, change feeds, views, exposed schemas).
43
- - Migration hygiene, data integrity, derived data, data removal.
44
- - Capacity, vacuum, connections, timeouts.
45
- - Restore against recovery targets.
48
+ - Check the catalogue privileges on functions, tables and sequences.
49
+ - Find the role each write in the code actually runs as.
50
+ - Check the row-level access coverage, and the exposure outside the main schema (file storage, change feeds, views, exposed schemas).
51
+ - Check migration hygiene, data integrity, derived data and data removal.
52
+ - Measure capacity, vacuum, connections and timeouts.
53
+ - Prove a restore against the recovery targets.
46
54
 
47
55
  ### Out of Scope
48
56
 
49
57
  <!-- prettier-ignore -->
50
58
  | Excluded item | Why | Where it belongs |
51
59
  | --- | --- | --- |
52
- | Policy predicate correctness; route reachability | Correctness, not coverage | `bkit-audit-security` |
53
- | Lawful basis / retention periods for personal data | Data lifecycle | `bkit-audit-privacy` |
54
- | Request latency outside the DB | Hot paths | `bkit-audit-app-performance` |
55
- | Applying fixes | Audit reports only | Plan from this report |
60
+ | Policy predicate correctness; route reachability | The security audit owns correctness | `bkit-audit-security` |
61
+ | Lawful basis and retention periods for personal data | The privacy audit owns the data lifecycle | `bkit-audit-privacy` |
62
+ | Request latency outside the DB | The app-performance audit owns hot paths | `bkit-audit-app-performance` |
63
+ | Applying fixes | The audit only reports | A plan made from this report |
56
64
 
57
65
  ### Pre-Flight / Dependencies
58
66
 
59
67
  #### Core
60
68
 
61
- - [ ] **Permissions:** blocked calls recorded
62
- - [ ] **Catalogue Read:** Steps 3-16 — read-only SQL (or store's read-only API) per environment, e.g. platform MCP `execute_sql`, `psql` as read-only role. Fallback: local DB from migrations; remote claims = hypotheses.
63
- - [ ] **Local DB:** Steps 2, 10, 14 — replayable from migrations. Fallback: rolled-back transactions and remote re-check.
64
- - [ ] **Web:** Step 18 — fetch anchor standards. Fallback: versions recorded as unread.
69
+ - [ ] **Permissions:** every blocked call is recorded.
70
+ - [ ] **Catalogue Read:** Steps 3-16 — read-only SQL, or the store's read-only API, for each environment (e.g., platform MCP `execute_sql`, `psql` as a read-only role). Fallback: use a local DB built from the migrations, and treat remote claims as hypotheses.
71
+ - [ ] **Local DB:** Steps 2, 10, 14 — a DB replayable from the migrations. Fallback: use rolled-back transactions, and re-check the remote afterwards.
72
+ - [ ] **Web:** Step 18 — fetch the anchor standards. Fallback: record the versions as unread.
65
73
 
66
74
  #### Conditional
67
75
 
68
- - [ ] **Platform Advisors:** Managed platform → Step 3 — e.g. Supabase MCP `get_advisors`. Fallback: equivalent catalogue queries.
69
- - [ ] **Platform Settings:** Managed platform → Steps 4, 17 — network, MFA, owners, backups, point-in-time recovery, e.g. dashboard, management API. Fallback: none; items `Not Checked`.
70
- - [ ] **Inspection CLI:** Platforms with one → Steps 14-16 — e.g. `supabase inspect db`. Fallback: engine statistics views, e.g. `pg_stat_*`.
71
- - [ ] **Migration Linter:** SQL migrations → Step 10 — e.g. Squawk. Fallback: apply its rules by reading.
72
- - [ ] **Restore Target:** Hosted DB → Step 17 — permission and tier to create throwaway project. Fallback: none; absence = finding.
76
+ - [ ] **Platform Advisors:** **If** the platform is managed → Step 3 — the platform's advisors (e.g., Supabase MCP `get_advisors`). Fallback: run the equivalent catalogue queries.
77
+ - [ ] **Platform Settings:** **If** the platform is managed → Steps 4, 17 — network, MFA, owners, backups and point-in-time recovery (e.g., dashboard, management API). Fallback: none. Mark those items `Not Checked`.
78
+ - [ ] **Inspection CLI:** **If** the platform has one → Steps 14-16 — the inspection CLI (e.g., `supabase inspect db`). Fallback: read the engine's statistics views (e.g., `pg_stat_*`).
79
+ - [ ] **Migration Linter:** **If** the migrations are SQL → Step 10 — a safe-migration linter (e.g., Squawk). Fallback: apply its rules by reading.
80
+ - [ ] **Restore Target:** **If** the DB is hosted → Step 17 — the permission and tier to create a throwaway project. Fallback: none. A missing restore target is a finding.
73
81
 
74
82
  ### 🔒 Gate 1: Prerequisites Check
75
83
 
76
- - [ ] **Gaps named:** every missing item names its fallback and `Not Checked` entry.
77
- - [ ] **Gate 1 — Verified:** All Core items checked. All applicable Conditional items checked.
84
+ - [ ] **Gaps named:** every missing item names its fallback and its `Not Checked` entry.
85
+ - [ ] **Gate 1 — Verified:** every item above, every Core item and every applicable Conditional item is checked.
78
86
 
79
87
  ### Probe Steps
80
88
 
81
- - [ ] **Step 1 — Previous Run:** **Done when:** closure rate in `Previous Run`, or run marked baseline.
82
- - [ ] **Step 2 — Detect:** Find migrations / schema file / DB client. Confirm local DB matches migrations before trusting local measurements. Schema doc absent, migrations exist → missing doc = finding; still read migrations. **Done when:** evidence in `Checked`, or `N/A` and **STOP**.
83
- - [ ] **Step 3 — Advisors:** Run platform security and performance advisors; each row = candidate, not finding. One line per lint the platform's advisor runs, even when clean (e.g. Supabase: unindexed FKs, duplicate indexes, per-row auth in policy, multiple permissive policies, mutable function `search_path`, extension in public schema, exposed table without row-level security, owner-rights view). No advisor → engine-appropriate subset by catalogue query; rest `N/A`. Cite platform fix pattern per finding. **Done when:** every row dispositioned in `Advisors`.
84
- - [ ] **Step 4 — Checklist:** Walk platform production checklist against production, not memory: transport encryption enforced, network restrictions, org MFA, >1 owner, point-in-time recovery where size / RPO needs it, compute sized for `Connections` peak. **Done when:** every item met / not met (finding) / not applicable (why).
85
- - [ ] **Step 5 — Inventory:** Count tables, migrations, extensions. Applied vs directory, both directions — drift invalidates downstream. Hosted major vs platform support window; extensions blocking next major. **Done when:** counts, drift, version in `Environment`.
86
- - [ ] **Step 6 — Grants:** Catalogue, never migration text. Every function: definer-rights? executable by which client roles (e.g. `pg_proc` and ACL)? Definer-rights + anonymous-executable = finding unless body checks caller identity — read body. Every privileged function since previous report = candidate. Same for table / sequence grants to anonymous role. **Done when:** `Grants` lists every privileged function and anonymous grant with verdict.
87
- - [ ] **Step 7 — Write Roles:** `Grants` = who may write; this = who code writes as. Per table whose writes need a role the request path lacks: every write site incl. SQL functions (search table name — language servers miss string literals) → client used (user-scoped = user role; admin = privileged role, e.g. Supabase service role) → compare with grant. Ungranted = finding; ungranted with error never read / dropped = `CRITICAL` (silent fail every call). **Done when:** `Write Roles` row per site: table · `file:line` · role at site · role granted · error checked · verdict.
88
- - [ ] **Step 8 — Coverage:** Every tenancy-scoped table: tenancy enforced at one recorded layer — DB row policy (e.g. Postgres RLS: control on, >=1 policy, deny default) or one app-layer scope every query goes through (e.g. Rails default scope, Django manager). Scope column, neither layer = finding. Control on, 0 policies = deny-all (safe, usually mistake). Coverage only; correctness → `bkit-audit-security`. Policy / scope test must fail when removed — denials can surface as silent zero rows. **Done when:** `Coverage` row per table: layer · policy count or scope · scope column · verdict.
89
- - [ ] **Step 9 — Exposure:** `Coverage` keys on scope columns; check other paths (coverage only): file-storage policies and public buckets; change-feed publications and row-level control per published table; owner-rights views bypassing caller policies (e.g. no `security_invoker`); API-served schemas with internal tables. **Done when:** `Exposure` row per surface with verdict.
90
- - [ ] **Step 10 — Migrations:** Since previous report: shared timestamps (directory and open branches); guarded DDL (`IF [NOT] EXISTS`) without trailing catalogue re-query assertion (typo → silent no-op, still applied); schema change without regenerated DB types (where generated); constraints that cannot fire (`NULL` not `FALSE`) → probe with rolled-back `INSERT`; lock-unsafe DDL (e.g. Postgres: non-`CONCURRENTLY` index, constraint without `NOT VALID` + later `VALIDATE`, type change, `NOT NULL` on existing column, no `lock_timeout`) via safe-migration linter or its rules — say which; drop / rename still read by previous deployed build or oldest supported client. **Done when:** every hit = finding with file.
91
- - [ ] **Step 11 — Integrity:** FK `ON DELETE` writing to immutability-guarded table (referenced delete fails); hard-delete beside soft-delete convention, or cascades bypassing it; audit / CDC triggers present where meant and stream receiving rows (env flags can disable); orphans in deliberately FK-less tables; every timestamp without time zone → intended zone and all writers agree. **Done when:** every hit = finding with query.
92
- - [ ] **Step 12 — Derived Data:** List stores computed from others (caches, denormalised columns, counters, materialised views, scheduled rebuilds). Each: one shared writer (writes elsewhere = finding); every source write path calls it (source paths minus writer's callers = finding); something checks copy vs source. Only safety net = next rebuild → state how long users see wrong data. **Done when:** row per store with those three answers.
93
- - [ ] **Step 13 — Removal:** Per personal-data table: retention period and purge job; soft-deleted rows ever hard-deleted, when; account deletion reaches every copy (caches, audit stream, embeddings, file storage, backups). No period, or period without job = finding. **Done when:** `Retention` row per table: data · retention · purge job · erasure covers · verdict.
94
- - [ ] **Step 14 — Capacity:** Series vs previous report: table sizes and rows, largest / unused indexes, seq scans on large tables, inspection-suite outputs (e.g. outliers, calls, index stats, bloat, vacuum stats, table stats, locks, blocking, long-running, replication slots, cache hit). Top 10 by total and mean time → query plan (e.g. `EXPLAIN (ANALYZE, BUFFERS)`) locally or rolled back; plan changes; stats reset time. Housekeeping tables (job history, HTTP logs, audit, auth audit) size, growth, purge. 32-bit key / sequence >50% of max. Disk vs limit, IO vs tier caps, cache hit ratios. Measure query time in DB, not app traces (network dominates). **Done when:** series in `Capacity`; each threshold breach = finding.
95
- - [ ] **Step 15 — Vacuum:** Vacuuming engine (e.g. Postgres) → transaction-ID age per DB and largest tables; dead-tuple ratio, last autovacuum / autoanalyze per hot table. Not vacuumed since previous report, or ID age climbing = finding. Other engine → its routine maintenance (e.g. SQLite `VACUUM`, InnoDB purge lag), or skip with evidence. **Done when:** numbers in `Capacity`, or skip recorded.
96
- - [ ] **Step 16 — Connections:** Connection limit and pooler size vs peak by application and role. Serverless direct connections → transaction-mode pooler, pool of 1, prepared statements off (or platform equivalent). Idle-in-transaction count and age. Statement and idle-in-transaction timeouts per client / admin role; neither = finding. **Done when:** numbers and each client constructor read in `Capacity`.
97
- - [ ] **Step 17 — Restore:** (a) From source, list every outbound side effect a clone fires (scheduled jobs, HTTP-calling triggers / functions, DB webhooks, foreign-data wrappers) and how each stops: logical restore stripping them first / fails closed in clone / unscheduled right after restore (harmless first run only). Reaches real users or payments without failing closed → no binary restore. No plan → finding, do not restore. (b) Restore latest backup to throwaway target; schema matches migrations; time taken and data lost; delete target. (c) Record backup type, retention, point-in-time recovery, RTO, RPO. No written targets = finding. Retention < time to notice silent corruption = finding. (d) Logical backup outside platform account: age; restore notes cover key material backups never contain. None = finding. **Done when:** `Restore` holds side-effect plan and result, or the replacing finding.
98
- - [ ] **Step 18 — Standards:** Confirm current version per anchor standard; read changes since previous report's version. `Standards Coverage`: one row per checklist item, advisor lint, inspection report → checked (name step) / not applicable (why) / finding. Per bkit anchor (doc section, rule, or issue shape): one row → followed (name step or evidence) / not applicable (why) / finding; departure with no recorded reason (e.g. `docs/decisions.jsonl` row, accepted-divergence entry) = finding. Unapplied recommended practice → adopt (propose step) / reject (why) / not applicable. **Done when:** no empty row.
99
- - [ ] **Step 19 — Anything Else:** (a) Everything changed since previous report's commit touching DB (migrations, tables / columns, functions and grants, policies, extensions, scheduled jobs, buckets, publications, new DB clients) → one-line verdict each. (b) Bounded ~30 min pass: what a senior DBA flags that no step asks; read since previous run (incidents, new `docs/failures.jsonl` rows) — what would no step catch? Include anything catalogue / logs / advisors surfaced unchecked, with query for next run. **Done when:** `Beyond the Steps` holds both passes, or `none`. Class seen on 2 runs → propose step in `Process Improvements`.
89
+ - [ ] **Step 1 — Previous Run:** **Done when:** `Previous Run` holds the closure rate, or the run is marked baseline.
90
+ - [ ] **Step 2 — Detect:** Find the migrations, schema file or DB client. Confirm the local DB matches the migrations before trusting any local measurement. **If** migrations exist but the schema doc does not → the missing doc is a finding, and still read the migrations. **Done when:** `Checked` holds evidence, or `N/A` is recorded → **STOP**.
91
+ - [ ] **Step 3 — Advisors:** Run the platform's security and performance advisors. Each advisor row is a candidate, not a finding. Write one line for each lint the platform's advisor runs, even when it is clean (e.g., Supabase: unindexed FKs, duplicate indexes, per-row auth in a policy, multiple permissive policies, mutable function `search_path`, an extension in the public schema, an exposed table without row-level security, an owner-rights view). **If** there is no advisor → run the subset that fits the engine as catalogue queries, and mark the rest `N/A`. Cite the platform's fix pattern for each finding. **Done when:** every row in `Advisors` has a disposition.
92
+ - [ ] **Step 4 — Checklist:** Walk the platform production checklist against production, not memory: transport encryption enforced, network restrictions, org MFA, more than one owner, point-in-time recovery where size or RPO needs it, and compute sized for the `Connections` peak. **Done when:** every item is marked met, not met (a finding) or not applicable (saying why).
93
+ - [ ] **Step 5 — Inventory:** Count the tables, migrations and extensions. Compare the applied migrations with the directory in both directions, because drift invalidates every later step. Diff a schema fingerprint across environments (counts and hashes of columns, indexes, functions, policies and grants), because a change made by hand outside migrations leaves both migration lists equal. **If** only one environment is readable → record its fingerprint, and mark the cross-environment diff `Not Checked`. Check the hosted major version against the platform's support window, and list the extensions that block the next major. **Done when:** the counts, drift, fingerprint diff and version are in `Environment`.
94
+ - [ ] **Step 6 — Grants:** Read grants from the catalogue, never from migration text. For every function, record whether it runs with definer rights and which client roles can execute it (e.g., `pg_proc` and its ACL). A definer-rights function the anonymous role can execute is a finding unless its body checks the caller's identity, so read the body. Every function that became privileged since the previous report is a candidate, whether it was added or changed to definer rights. Check table and sequence grants to the anonymous role the same way. **Done when:** `Grants` lists every privileged function and anonymous grant, with a verdict.
95
+ - [ ] **Step 7 — Write Roles:** `Grants` shows who may write. This step shows who the code writes as. For each table whose writes need a role the request path lacks, find every write site, including SQL functions. Search for the table name, because language servers miss string literals. For each site, record the client used (a user-scoped client runs as the user role; an admin client runs as a privileged role, e.g., the Supabase service role), and compare it with the grant. An ungranted write is a finding. An ungranted write whose error is never read, or is dropped, is `CRITICAL`, because it fails silently on every call. **Done when:** `Write Roles` has one row per site: table · `file:line` · role at site · role granted · error checked · verdict.
96
+ - [ ] **Step 8 — Coverage:** For every tenancy-scoped table, check that tenancy is enforced at one recorded layer: a DB row policy (e.g., Postgres RLS: control on, >=1 policy, deny by default), or one app-layer scope that every query goes through (e.g., a Rails default scope, a Django manager). A table with a scope column and neither layer is a finding. Control on with 0 policies denies everything, which is safe but usually a mistake. Check coverage only; correctness goes to `bkit-audit-security`. The policy or scope test must fail when the policy is removed, because a denial can surface as silent zero rows. **Done when:** `Coverage` has one row per table: layer · policy count or scope · scope column · verdict.
97
+ - [ ] **Step 9 — Exposure:** `Coverage` keys on scope columns, so check the other paths here, for coverage only: file-storage policies and public buckets; change-feed publications and the row-level control on each published table; owner-rights views that bypass the caller's policies (e.g., no `security_invoker`); and API-served schemas that hold internal tables. **Done when:** `Exposure` has one row per surface, with a verdict.
98
+ - [ ] **Step 10 — Migrations:** Check the migrations added since the previous report for:
99
+ - shared timestamps (in the directory and on open branches)
100
+ - guarded DDL (`IF [NOT] EXISTS`) with no trailing catalogue re-query that asserts the result (a typo makes it a silent no-op that still counts as applied)
101
+ - a schema change without regenerated DB types, when the project generates them
102
+ - constraints that cannot fire because they evaluate to `NULL`, not `FALSE`, probed with a rolled-back `INSERT`
103
+ - lock-unsafe DDL (e.g., Postgres: a non-`CONCURRENTLY` index, a constraint without `NOT VALID` and a later `VALIDATE`, a type change, `NOT NULL` on an existing column, no `lock_timeout`), found with a safe-migration linter or by applying its rules, saying which
104
+ - a drop or rename that the previous deployed build or the oldest supported client still reads
105
+
106
+ **Done when:** every hit is a finding with its file.
107
+
108
+ - [ ] **Step 11 — Integrity:** Check for: an FK `ON DELETE` that writes to an immutability-guarded table (the referenced delete fails); a hard delete beside a soft-delete convention, or a cascade that bypasses it; audit or CDC triggers missing where they are meant to be, or a stream not receiving rows (env flags can disable them); orphans in deliberately FK-less tables; and every timestamp without time zone, with its intended zone and whether all writers agree. **Done when:** every hit is a finding with its query.
109
+ - [ ] **Step 12 — Derived Data:** List the stores computed from other data (caches, denormalised columns, counters, materialised views, scheduled rebuilds). For each store, answer three questions: does one shared writer own it (a write anywhere else is a finding); does every source write path call that writer (each source path missing from the writer's callers is a finding); and does something check the copy against the source. **If** the only safety net is the next rebuild → state how long users see wrong data. For each scheduled job, read the outcome of each run (status code or exit code), not only that it ran: a rejected run can log at info level. A job that did not write its owned rows in its window is a finding, even when it exited 0. **If** there are no scheduled jobs → record the skip with evidence of absence. **Done when:** each store has a row with those three answers.
110
+ - [ ] **Step 13 — Removal:** For each personal-data table, record the retention period and the purge job, whether soft-deleted rows are ever hard-deleted and when, and whether account deletion reaches every copy (caches, audit stream, embeddings, file storage, backups). No period, or a period without a job, is a finding. **Done when:** `Retention` has one row per table: data · retention · purge job · erasure covers · verdict.
111
+ - [ ] **Step 14 — Capacity:** Record each series beside the previous report's: table sizes and rows, the largest and unused indexes, sequential scans on large tables, and the inspection suite's outputs (e.g., outliers, calls, index stats, bloat, vacuum stats, table stats, locks, blocking, long-running, replication slots, cache hit). For the top 10 queries by total time and by mean time, take a query plan (e.g., `EXPLAIN (ANALYZE, BUFFERS)`) locally or in a rolled-back transaction, and record plan changes and the stats reset time. Record the size, growth and purge of the housekeeping tables (job history, HTTP logs, audit, auth audit). Flag any 32-bit key or sequence above 50% of its maximum. Compare disk with its limit and IO with the tier caps, and record the cache hit ratios. Measure query time in the DB, not in app traces, because network time dominates app traces. **Done when:** the series is in `Capacity`, and each threshold breach is a finding.
112
+ - [ ] **Step 15 — Vacuum:** **If** the engine vacuums (e.g., Postgres) → record the transaction-ID age per DB and for the largest tables, and the dead-tuple ratio and last autovacuum and autoanalyze for each hot table. A table not vacuumed since the previous report, or a climbing ID age, is a finding. **If** the engine is another kind → check its routine maintenance (e.g., SQLite `VACUUM`, InnoDB purge lag), or skip with evidence. **Done when:** the numbers are in `Capacity`, or the skip is recorded.
113
+ - [ ] **Step 16 — Connections:** Compare the connection limit and the pooler size with the peak, by application and by role. **If** serverless code connects directly → check it uses a transaction-mode pooler, a pool of 1 and prepared statements off (or the platform equivalent). Record the idle-in-transaction count and age. Record the statement timeout and the idle-in-transaction timeout for each client and admin role. A role with neither is a finding. **Done when:** the numbers, and each client constructor read, are in `Capacity`.
114
+ - [ ] **Step 17 — Restore:** Work through the restore in four parts.
115
+ - (a) From source, list every outbound side effect a clone fires (scheduled jobs, triggers or functions that call HTTP, DB webhooks, foreign-data wrappers) and how each one stops: a logical restore strips it first, it fails closed in the clone, or it is unscheduled right after the restore. Unscheduling after the restore counts only when a first run is harmless.
116
+ - **If** a side effect reaches real users or payments and does not fail closed → do no binary restore.
117
+ - **If** there is no plan → write a finding, and do not restore.
118
+ - (b) Restore the latest backup to a throwaway target, check that the schema matches the migrations, record the time taken and the data lost, then delete the target.
119
+ - (c) Record the backup type, retention, point-in-time recovery, RTO and RPO. Missing written targets are a finding. Retention shorter than the time it takes to notice silent corruption is a finding.
120
+ - (d) Record the age of the logical backup kept outside the platform account, and check that the restore notes cover the key material that backups never contain.
121
+ - **If** there is no such backup → write a finding.
122
+
123
+ **Done when:** `Restore` holds the side-effect plan and the result, or the finding that replaces them.
124
+
125
+ - [ ] **Step 18 — 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 checklist item, advisor lint and inspection report, each marked checked (naming the step), not applicable (saying why) or finding. Give each bkit anchor (a doc section, rule or issue shape) one row, marked followed (with the step or evidence), not applicable (saying why) or finding. A departure with no recorded reason (e.g., a `docs/decisions.jsonl` row or an accepted-divergence entry) is a 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.
126
+ - [ ] **Step 19 — Anything Else:** (a) Give a one-line verdict on each change since the previous report's commit that touches the DB: migrations, tables and columns, functions and grants, policies, extensions, scheduled jobs, buckets, publications and new DB clients. (b) In a bounded pass of about 30 minutes, note what a senior DBA 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. Include anything the catalogue, logs or advisors surfaced that no step checked, with the query for the next run. **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`.
100
127
 
101
128
  ### 🔒 Gate 2: Probes Check
102
129
 
103
- - [ ] **Steps complete:** every step `[x]`, or explicit skip with evidence the surface is absent.
104
- - [ ] **Evidence:** every finding cites re-checkable evidence and the tool behind it.
130
+ - [ ] **Steps complete:** every step is `[x]`, or skipped with evidence that its surface is absent.
131
+ - [ ] **Evidence:** every finding cites evidence someone can check again, and the tool that produced it.
105
132
  - [ ] **Environments:** every finding names the environment it ran against.
106
- - [ ] **Remote untouched:** no remote database changed; throwaway restore target deleted.
107
- - [ ] **Gate 2 — Verified:** Every checkbox above independently verified and checked off.
133
+ - [ ] **Remote untouched:** no remote database changed.
134
+ - [ ] **Restore target deleted:** the throwaway restore target no longer exists.
135
+ - [ ] **Gate 2 — Verified:** every item above holds.
108
136
 
109
137
  ## Findings
110
138
 
111
139
  <!-- prettier-ignore -->
112
140
  | Severity | Use |
113
141
  | --- | --- |
114
- | `CRITICAL` | Tenant data readable / writable across tenants or by anonymous role; anonymous-executable privileged function without identity check; write failing silently every call; migration dropping data without backfill |
115
- | `HIGH` | Tenancy table with no enforcing layer (no row policy, no app-layer scope); public bucket / owner-rights view exposing tenant data; constraint that cannot fire; lock-unsafe migration on live table; no proven restore, no recovery targets, or no off-platform backup; applied migrations != directory |
116
- | `MEDIUM` | Missing index the query shape needs; housekeeping table without purge; vacuum lag; sequence >50%; role without timeouts; derived data without agreement check; schema doc != migrations |
117
- | `LOW` | Deny-all table without policies; naming drift changing neither access nor results |
142
+ | `CRITICAL` | Tenant data is readable or writable across tenants, or by the anonymous role. An anonymous-executable privileged function has no identity check. A write fails silently on every call. A migration drops data without a backfill |
143
+ | `HIGH` | A tenancy table has no enforcing layer (no row policy and no app-layer scope). A public bucket or an owner-rights view exposes tenant data. A constraint cannot fire. A lock-unsafe migration runs on a live table. There is no proven restore, no recovery target or no off-platform backup. The applied migrations differ from the directory |
144
+ | `MEDIUM` | An index the query shape needs is missing. A housekeeping table has no purge. Vacuum lags. A sequence is above 50%. A role has no timeouts. Derived data has no agreement check. The schema doc differs from the migrations |
145
+ | `LOW` | A deny-all table has no policies. Naming drift changes neither access nor results |
118
146
 
119
- Within a severity: security / data first.
147
+ Within a severity, list security and data findings first.
120
148
 
121
149
  <!-- prettier-ignore -->
122
150
  | ID | Severity | Location | Evidence | Expected |
123
151
  | --- | --- | --- | --- | --- |
124
152
  | PENDING | PENDING | PENDING | PENDING | PENDING |
125
153
 
126
- Empty and clean → one row `None`.
154
+ **If** the run finds nothing → write one row: `None`.
127
155
 
128
156
  ## Report
129
157
 
@@ -204,13 +232,16 @@ PENDING
204
232
 
205
233
  ### 🔒 Gate 3: Report Check
206
234
 
207
- - [ ] **No placeholders:** no `PENDING` left
208
- - [ ] **Summary:** names count per severity and environments measured.
209
- - [ ] **Series:** every series beside previous report's numbers, or marked baseline.
210
- - [ ] **Writes:** only this report, template `Project Instructions`, and ledger rows changed; throwaway worktrees / remote targets removed.
211
- - [ ] **Process Improvements:** `Universal` and `Project` filled
212
- - [ ] **Suggested Issues:** every `MEDIUM`+ finding ID in exactly one row; every row has a `Next Step`.
213
- - [ ] **Gate 3 — Verified:** Every checkbox above independently verified and checked off.
235
+ - [ ] **No placeholders:** no `PENDING` is left.
236
+ - [ ] **Summary:** `Summary` gives the count per severity.
237
+ - [ ] **Environments measured:** `Summary` names the environments measured.
238
+ - [ ] **Series:** the report shows every series beside the previous report's numbers, or marks the run as baseline.
239
+ - [ ] **Writes:** this run changed only this report, the template's `Project Instructions` and its own `docs/failures.jsonl` rows.
240
+ - [ ] **Throwaways removed:** every throwaway worktree or remote target is removed.
241
+ - [ ] **Process Improvements:** `Universal` and `Project` are both filled.
242
+ - [ ] **Suggested Issues:** every `MEDIUM`+ finding ID is in exactly one `Suggested Issues` row.
243
+ - [ ] **Next Step:** every `Suggested Issues` row has a `Next Step`.
244
+ - [ ] **Gate 3 — Verified:** every item above holds.
214
245
 
215
246
  <!-- bkit:end -->
216
247