@cbartens/bkit 6.0.0 → 6.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (375) hide show
  1. package/.bkit/README.md +154 -151
  2. package/.bkit/core/.agents/context.md +95 -29
  3. package/.bkit/core/.agents/docs.md +17 -15
  4. package/.bkit/core/.agents/plugins/bkit/hooks/bkit-gateguard.cjs +1 -0
  5. package/.bkit/core/.agents/plugins/bkit/hooks/bkit-guardrails.cjs +6 -5
  6. package/.bkit/core/.agents/plugins/bkit/hooks/bkit-readguard.cjs +1 -0
  7. package/.bkit/core/.agents/plugins/bkit/hooks/bkit-rules.cjs +65 -0
  8. package/.bkit/core/.agents/rules.md +108 -107
  9. package/.bkit/core/.agents/skills.md +63 -15
  10. package/.bkit/core/.bkit/README.md +154 -151
  11. package/.bkit/core/.bkit/authoring.md +714 -84
  12. package/.bkit/core/.bkit/cli.md +407 -0
  13. package/.bkit/core/.bkit/cloud.md +281 -193
  14. package/.bkit/core/.bkit/comparison.md +43 -41
  15. package/.bkit/core/.bkit/install.md +154 -84
  16. package/.bkit/core/.bkit/jsonl.md +193 -130
  17. package/.bkit/core/.bkit/pipeline.md +114 -114
  18. package/.bkit/core/.bkit/prompts.md +272 -165
  19. package/.bkit/core/.bkit/providers.md +457 -271
  20. package/.bkit/core/.bkit/router.md +69 -0
  21. package/.bkit/core/.bkit/templates.md +529 -256
  22. package/.bkit/core/.bkit/trackers.md +80 -52
  23. package/.bkit/core/.bkit/workflows.md +589 -504
  24. package/.bkit/core/.claude/hooks/bkit-gateguard.cjs +2 -2
  25. package/.bkit/core/.claude/hooks/bkit-guardrails.cjs +3 -3
  26. package/.bkit/core/.claude/hooks/bkit-preflight.sh +45 -14
  27. package/.bkit/core/.codex/hooks/bkit-guardrails.cjs +3 -3
  28. package/.bkit/core/.codex/hooks/bkit-rules.cjs +57 -0
  29. package/.bkit/core/.cursor/hooks/bkit-guardrails.cjs +7 -7
  30. package/.bkit/core/.cursor/hooks/bkit-preflight.sh +47 -12
  31. package/.bkit/core/.opencode/plugin/bkit-rules.js +89 -0
  32. package/.bkit/core/AGENTS.md +5 -73
  33. package/.bkit/core/docs/templates/bkit-audit-accessibility.md +127 -105
  34. package/.bkit/core/docs/templates/bkit-audit-adoption.md +104 -70
  35. package/.bkit/core/docs/templates/bkit-audit-agents.md +94 -72
  36. package/.bkit/core/docs/templates/bkit-audit-aio-seo.md +99 -78
  37. package/.bkit/core/docs/templates/bkit-audit-analytics.md +140 -82
  38. package/.bkit/core/docs/templates/bkit-audit-annotations.md +98 -72
  39. package/.bkit/core/docs/templates/bkit-audit-app-performance.md +121 -96
  40. package/.bkit/core/docs/templates/bkit-audit-app-store.md +157 -76
  41. package/.bkit/core/docs/templates/bkit-audit-architecture.md +113 -71
  42. package/.bkit/core/docs/templates/bkit-audit-ci-performance.md +75 -72
  43. package/.bkit/core/docs/templates/bkit-audit-config.md +122 -76
  44. package/.bkit/core/docs/templates/bkit-audit-cost.md +85 -74
  45. package/.bkit/core/docs/templates/bkit-audit-coverage.md +75 -68
  46. package/.bkit/core/docs/templates/bkit-audit-database.md +101 -70
  47. package/.bkit/core/docs/templates/bkit-audit-dead-code.md +164 -83
  48. package/.bkit/core/docs/templates/bkit-audit-deferrals.md +115 -86
  49. package/.bkit/core/docs/templates/bkit-audit-dependencies.md +264 -88
  50. package/.bkit/core/docs/templates/bkit-audit-documentation.md +118 -93
  51. package/.bkit/core/docs/templates/bkit-audit-duplication.md +139 -86
  52. package/.bkit/core/docs/templates/bkit-audit-failures.md +110 -81
  53. package/.bkit/core/docs/templates/bkit-audit-flakes.md +99 -74
  54. package/.bkit/core/docs/templates/bkit-audit-gates.md +105 -77
  55. package/.bkit/core/docs/templates/bkit-audit-issues.md +104 -80
  56. package/.bkit/core/docs/templates/bkit-audit-llm.md +131 -58
  57. package/.bkit/core/docs/templates/bkit-audit-logs.md +123 -100
  58. package/.bkit/core/docs/templates/bkit-audit-models.md +98 -53
  59. package/.bkit/core/docs/templates/bkit-audit-privacy.md +56 -52
  60. package/.bkit/core/docs/templates/bkit-audit-prompts.md +63 -54
  61. package/.bkit/core/docs/templates/bkit-audit-red-team.md +124 -68
  62. package/.bkit/core/docs/templates/bkit-audit-reliability.md +95 -70
  63. package/.bkit/core/docs/templates/bkit-audit-repo.md +169 -73
  64. package/.bkit/core/docs/templates/bkit-audit-security.md +206 -96
  65. package/.bkit/core/docs/templates/bkit-audit-slop.md +77 -70
  66. package/.bkit/core/docs/templates/bkit-audit-testing.md +162 -114
  67. package/.bkit/core/docs/templates/bkit-audit-usability.md +113 -71
  68. package/.bkit/core/docs/templates/bkit-plan.md +138 -132
  69. package/.bkit/core/engine/checks/after/auth.ts +40 -37
  70. package/.bkit/core/engine/checks/after/ci-yml.ts +65 -2
  71. package/.bkit/core/engine/checks/after/index.ts +12 -2
  72. package/.bkit/core/engine/checks/after/tools.ts +80 -33
  73. package/.bkit/core/engine/checks/before/context-fetch.ts +227 -33
  74. package/.bkit/core/engine/checks/before/env.ts +1 -1
  75. package/.bkit/core/engine/checks/before/index.ts +7 -0
  76. package/.bkit/core/engine/checks/before/repo.ts +40 -0
  77. package/.bkit/core/engine/checks/status-holes.ts +916 -123
  78. package/.bkit/core/engine/checks/tips/catalogue.ts +68 -17
  79. package/.bkit/core/engine/checks/tips/detect.ts +32 -0
  80. package/.bkit/core/engine/checks/tips/index.ts +47 -6
  81. package/.bkit/core/engine/cli.ts +238 -84
  82. package/.bkit/core/engine/commands/analysis.ts +128 -76
  83. package/.bkit/core/engine/commands/ci/ci.ts +363 -29
  84. package/.bkit/core/engine/commands/ci/pins.ts +172 -0
  85. package/.bkit/core/engine/commands/ci/push-gate.ts +223 -0
  86. package/.bkit/core/engine/commands/install/uninstall.ts +21 -27
  87. package/.bkit/core/engine/commands/install/upgrade.ts +32 -15
  88. package/.bkit/core/engine/commands/land.ts +126 -11
  89. package/.bkit/core/engine/commands/lib.ts +303 -6
  90. package/.bkit/core/engine/commands/registry.ts +6 -2
  91. package/.bkit/core/engine/commands/setup/setup.ts +1 -0
  92. package/.bkit/core/engine/commands/stats.ts +91 -35
  93. package/.bkit/core/engine/commands/workflow/branches.ts +1477 -117
  94. package/.bkit/core/engine/commands/workflow/challenge.ts +114 -39
  95. package/.bkit/core/engine/commands/workflow/completeness.ts +109 -0
  96. package/.bkit/core/engine/commands/workflow/context.ts +433 -55
  97. package/.bkit/core/engine/commands/workflow/counters.ts +244 -39
  98. package/.bkit/core/engine/commands/workflow/decisions.ts +61 -17
  99. package/.bkit/core/engine/commands/workflow/disk.ts +237 -55
  100. package/.bkit/core/engine/commands/workflow/fids.ts +19 -1
  101. package/.bkit/core/engine/commands/workflow/issues.ts +6 -0
  102. package/.bkit/core/engine/commands/workflow/ledgers.ts +458 -18
  103. package/.bkit/core/engine/commands/workflow/locks.ts +2 -0
  104. package/.bkit/core/engine/commands/workflow/plan-blocks.ts +124 -15
  105. package/.bkit/core/engine/commands/workflow/plans.ts +257 -0
  106. package/.bkit/core/engine/commands/workflow/prs.ts +12 -3
  107. package/.bkit/core/engine/commands/workflow/repo.ts +8 -0
  108. package/.bkit/core/engine/commands/workflow/roadmap.ts +56 -15
  109. package/.bkit/core/engine/commands/workflow/run-facts.ts +22 -31
  110. package/.bkit/core/engine/commands/workflow/runs.ts +652 -34
  111. package/.bkit/core/engine/commands/workflow/runtime.ts +3 -0
  112. package/.bkit/core/engine/commands/workflow/skills.ts +1 -0
  113. package/.bkit/core/engine/commands/workflow/status.ts +200 -17
  114. package/.bkit/core/engine/commands/workflow/step-table.ts +75 -33
  115. package/.bkit/core/engine/commands/workflow/steps.ts +635 -24
  116. package/.bkit/core/engine/commands/workflow/summary-findings.ts +177 -0
  117. package/.bkit/core/engine/commands/workflow/summary.ts +192 -46
  118. package/.bkit/core/engine/commands/workflow/tasks.ts +409 -0
  119. package/.bkit/core/engine/commands/workflow/test-blocks.ts +254 -0
  120. package/.bkit/core/engine/commands/workflow/tests-changed.ts +201 -0
  121. package/.bkit/core/engine/commands/workflow/tests.ts +1285 -356
  122. package/.bkit/core/engine/commands/workflow/workflows.ts +228 -43
  123. package/.bkit/core/engine/commands/workflow/worktrees.ts +389 -47
  124. package/.bkit/core/engine/install/cloud-env.ts +251 -121
  125. package/.bkit/core/engine/install/context-ci-workflow.ts +102 -0
  126. package/.bkit/core/engine/install/manifest.ts +60 -12
  127. package/.bkit/core/engine/install/modules/antigravity.ts +3 -2
  128. package/.bkit/core/engine/install/modules/cloud.ts +3 -3
  129. package/.bkit/core/engine/install/modules/codex.ts +15 -2
  130. package/.bkit/core/engine/install/modules/core.ts +956 -52
  131. package/.bkit/core/engine/install/modules/cursor.ts +6 -6
  132. package/.bkit/core/engine/install/modules/opencode.ts +16 -4
  133. package/.bkit/core/engine/install/template-notes.ts +130 -0
  134. package/.bkit/core/engine/install/version-file.ts +3 -2
  135. package/.bkit/core/engine/install/write.ts +5 -0
  136. package/.bkit/core/engine/ledgers/compact.ts +124 -0
  137. package/.bkit/core/engine/ledgers/journal.ts +291 -0
  138. package/.bkit/core/engine/ledgers/status.ts +160 -9
  139. package/.bkit/core/engine/ledgers/telemetry.ts +158 -21
  140. package/.bkit/core/engine/render/hosts.ts +114 -14
  141. package/.bkit/core/engine/shared/bkit-latest.ts +26 -4
  142. package/.bkit/core/engine/shared/dep-updater.ts +60 -0
  143. package/.bkit/core/engine/shared/egress.ts +1 -1
  144. package/.bkit/core/engine/shared/package-manager.ts +9 -0
  145. package/.bkit/core/engine/shared/settings.ts +92 -17
  146. package/.bkit/core/engine/shared/timeouts.ts +2 -0
  147. package/.bkit/core/engine/tools/cli-doc.ts +111 -0
  148. package/.bkit/core/engine/tools/grammar-density.ts +1 -1
  149. package/.bkit/core/engine/tools/instructions-sources.ts +15 -17
  150. package/.bkit/core/engine/tools/instructions.ts +94 -43
  151. package/.bkit/core/hooks/antigravity-hook.js +25 -10
  152. package/.bkit/core/hooks/gateguard-engine.js +53 -29
  153. package/.bkit/core/hooks/guardrails-shell.js +4 -4
  154. package/.bkit/core/hooks/guardrails-tiers.js +3 -3
  155. package/.bkit/core/hooks/preflight-linear.sh +9 -9
  156. package/.bkit/core/hooks/preflight-rules.sh +8 -0
  157. package/.bkit/core/hooks/readguard-engine.js +29 -10
  158. package/.bkit/core/hooks/session-rules-advisory.js +61 -0
  159. package/.bkit/core/prompts/bkit-audit-generate.md +187 -116
  160. package/.bkit/core/prompts/bkit-build-challenge-1.md +56 -37
  161. package/.bkit/core/prompts/bkit-build-challenge-2.md +65 -45
  162. package/.bkit/core/prompts/bkit-build-install-skills.md +38 -29
  163. package/.bkit/core/prompts/bkit-build-plan-convert.md +43 -32
  164. package/.bkit/core/prompts/bkit-build-plan-current.md +49 -39
  165. package/.bkit/core/prompts/bkit-build-plan-gaps-remediate.md +79 -55
  166. package/.bkit/core/prompts/bkit-build-plan-tasks.md +149 -0
  167. package/.bkit/core/prompts/bkit-build-plan-tests.md +120 -0
  168. package/.bkit/core/prompts/bkit-build-plan-verify.md +87 -50
  169. package/.bkit/core/prompts/bkit-debug-abort-handover.md +36 -35
  170. package/.bkit/core/prompts/bkit-debug-failure-diagnose.md +96 -64
  171. package/.bkit/core/prompts/bkit-debug-failure-remediate.md +54 -45
  172. package/.bkit/core/prompts/bkit-debug-failure-reproduce.md +42 -33
  173. package/.bkit/core/prompts/bkit-debug-failure-soak.md +53 -37
  174. package/.bkit/core/prompts/bkit-design-brainstorm-ideate-1.md +35 -30
  175. package/.bkit/core/prompts/bkit-design-brainstorm-ideate-2.md +34 -29
  176. package/.bkit/core/prompts/bkit-design-brainstorm-ideate-3.md +32 -28
  177. package/.bkit/core/prompts/bkit-design-generate.md +68 -52
  178. package/.bkit/core/prompts/bkit-design-organise.md +73 -35
  179. package/.bkit/core/prompts/bkit-design-review-1.md +58 -54
  180. package/.bkit/core/prompts/bkit-design-review-2.md +54 -50
  181. package/.bkit/core/prompts/bkit-design-spike.md +54 -47
  182. package/.bkit/core/prompts/bkit-design-update.md +42 -31
  183. package/.bkit/core/prompts/bkit-plan-generate.md +76 -58
  184. package/.bkit/core/prompts/bkit-plan-review-1.md +63 -49
  185. package/.bkit/core/prompts/bkit-plan-review-2.md +60 -48
  186. package/.bkit/core/prompts/bkit-plan-scope-check.md +53 -46
  187. package/.bkit/core/prompts/bkit-plan-update.md +70 -52
  188. package/.bkit/core/prompts/bkit-ship-conflict-resolve.md +82 -50
  189. package/.bkit/core/prompts/bkit-ship-deferred-sweep.md +80 -45
  190. package/.bkit/core/prompts/bkit-ship-update-docs.md +35 -29
  191. package/.bkit/core/prompts/bkit-utility-compress-markdown.md +55 -49
  192. package/.bkit/core/prompts/bkit-utility-update-decisions.md +76 -49
  193. package/.bkit/core/prompts/bkit-utility-update-deferrals.md +70 -41
  194. package/.bkit/core/prompts/bkit-utility-update-documentation.md +33 -30
  195. package/.bkit/core/prompts/bkit-utility-update-failures.md +73 -43
  196. package/.bkit/core/prompts/bkit-utility-update-knowledge.md +77 -50
  197. package/.bkit/core/prompts/bkit-utility-update-roadmap.md +77 -45
  198. package/.bkit/core/prompts/bkit-utility-update-tracker.md +144 -68
  199. package/.bkit/core/workflows/bkit-auto.md +53 -30
  200. package/.bkit/core/workflows/bkit-build.md +635 -304
  201. package/.bkit/core/workflows/bkit-debug.md +301 -148
  202. package/.bkit/core/workflows/bkit-design.md +167 -95
  203. package/.bkit/core/workflows/bkit-plan.md +172 -84
  204. package/.bkit/core/workflows/bkit-ship.md +299 -152
  205. package/.bkit/shared/.agents/plugins/bkit/hooks.json +10 -0
  206. package/.bkit/shared/.claude/bkit-cloud.md +12 -10
  207. package/.bkit/shared/.claude/settings.json +3 -0
  208. package/.bkit/shared/.codex/bkit-cloud.md +98 -0
  209. package/.bkit/shared/.codex/hooks.json +20 -0
  210. package/.bkit/shared/.cursor/bkit-cloud.md +3 -3
  211. package/.bkit/shared/.opencode/opencode.json +1 -1
  212. package/.bkit/shared/CLAUDE.md +5 -1
  213. package/.bkit/shared/GEMINI.md +4 -1
  214. package/.bkit/shared/docs/architecture.md +4 -7
  215. package/.bkit/shared/docs/data-schema.md +4 -7
  216. package/.bkit/shared/docs/deployments.md +239 -166
  217. package/.bkit/shared/docs/design.md +11 -12
  218. package/.bkit/shared/docs/noise.md +8 -7
  219. package/.bkit/shared/docs/observability.md +5 -8
  220. package/.bkit/shared/docs/security.md +35 -17
  221. package/.bkit/shared/docs/setup.md +29 -18
  222. package/.bkit/shared/docs/technology.md +3 -6
  223. package/.bkit/shared/docs/testing.md +282 -176
  224. package/.bkit/shared/gitignore +6 -2
  225. package/.bkit/templates/.claude/hooks/bkit-cloud-bootstrap.sh +15 -16
  226. package/.bkit/templates/.cursor/Dockerfile +12 -8
  227. package/.bkit/templates/.cursor/environment.json +1 -1
  228. package/.bkit/templates/.github/ISSUE_TEMPLATE/bkit-bug.yml +10 -8
  229. package/.bkit/templates/.github/ISSUE_TEMPLATE/bkit-change.yml +24 -12
  230. package/.bkit/templates/.github/ISSUE_TEMPLATE/bkit-idea.yml +3 -3
  231. package/.bkit/templates/.github/renovate.json5 +34 -6
  232. package/.bkit/templates/.github/workflows/bkit-ci.yml +53 -50
  233. package/.bkit/templates/.github/workflows/bkit-cloud.yml +13 -14
  234. package/.bkit/templates/.github/workflows/bkit-health.yml +97 -0
  235. package/.bkit/templates/.github/workflows/bkit-renovate.yml +5 -4
  236. package/.bkit/templates/.github/workflows/bkit-trivy.yml +5 -4
  237. package/.bkit/templates/.husky/pre-commit +2 -2
  238. package/.bkit/templates/.husky/pre-push +95 -35
  239. package/.bkit/templates/.prettierignore +6 -7
  240. package/.bkit/templates/.vale.ini +27 -27
  241. package/.bkit/templates/context/bkit-cloudrun.md +23 -15
  242. package/.bkit/templates/context/bkit-expo.md +70 -52
  243. package/.bkit/templates/context/bkit-github.md +93 -56
  244. package/.bkit/templates/context/bkit-inngest.md +21 -15
  245. package/.bkit/templates/context/bkit-maestro.md +22 -16
  246. package/.bkit/templates/context/bkit-playwright.md +23 -17
  247. package/.bkit/templates/context/bkit-resend.md +12 -10
  248. package/.bkit/templates/context/bkit-sentry.md +30 -20
  249. package/.bkit/templates/context/bkit-serena.md +8 -7
  250. package/.bkit/templates/context/bkit-stripe.md +14 -13
  251. package/.bkit/templates/context/bkit-supabase.md +16 -13
  252. package/.bkit/templates/context/bkit-tavily.md +14 -11
  253. package/.bkit/templates/context/bkit-vercel.md +27 -18
  254. package/.bkit/templates/docs/capabilities.md +15 -14
  255. package/.bkit/templates/scripts/ci/{check-accepted-divergences.mjs → bkit-check-accepted-divergences.mjs} +6 -3
  256. package/.bkit/templates/scripts/ci/{check-accepted-divergences.test.mjs → bkit-check-accepted-divergences.test.mjs} +3 -3
  257. package/.bkit/templates/scripts/ci/{check-capstone.mjs → bkit-check-capstone.mjs} +2 -2
  258. package/.bkit/templates/scripts/ci/{check-capstone.test.mjs → bkit-check-capstone.test.mjs} +4 -4
  259. package/.bkit/templates/scripts/ci/{check-dependency-audit.mjs → bkit-check-dependency-audit.mjs} +103 -18
  260. package/.bkit/templates/scripts/ci/{check-dependency-audit.test.mjs → bkit-check-dependency-audit.test.mjs} +31 -3
  261. package/.bkit/templates/scripts/ci/bkit-machine-lock.sh +387 -0
  262. package/.bkit/templates/scripts/ci/bkit-test-awake.mjs +75 -0
  263. package/.bkit/templates/scripts/ci/bkit-test-awake.test.mjs +160 -0
  264. package/.bkit/templates/scripts/ci/lanes/{resolve-push-base.mjs → bkit-resolve-push-base.mjs} +3 -3
  265. package/.bkit/templates/scripts/ci/lanes/{resolve-push-base.test.mjs → bkit-resolve-push-base.test.mjs} +4 -4
  266. package/.bkit/templates/scripts/cleanup/bkit-disk-prune.mjs +9 -1
  267. package/.bkit/templates/scripts/graphify/bkit-graph-drift.py +1 -1
  268. package/.bkit/templates/scripts/graphify/bkit-graph-eager.py +3 -3
  269. package/.bkit/templates/scripts/graphify/bkit-graph-embed.py +63 -0
  270. package/.bkit/templates/scripts/graphify/bkit-graph-imports.py +2 -2
  271. package/.bkit/templates/scripts/graphify/bkit-graph-pre-push.sh +69 -18
  272. package/.bkit/templates/scripts/graphify/bkit-graph-repair.py +3 -3
  273. package/.bkit/templates/scripts/graphify/bkit-graph-surface.py +1 -1
  274. package/.bkit/templates/scripts/graphify/bkit-graphify-graphml.py +1 -1
  275. package/.bkit/templates/scripts/graphify/bkit-graphify-rollup.py +197 -126
  276. package/.bkit/templates/scripts/graphify/bkit-graphify.sh +64 -41
  277. package/.bkit/templates/scripts/slop/bkit-slop-type-suppression.mjs +23 -7
  278. package/.bkit/templates/slop-scan.config.json +9 -2
  279. package/CHANGELOG.md +119 -0
  280. package/README.md +250 -76
  281. package/dist/checks/after/auth.js +36 -33
  282. package/dist/checks/after/ci-yml.js +52 -2
  283. package/dist/checks/after/index.js +12 -4
  284. package/dist/checks/after/tools.js +73 -33
  285. package/dist/checks/before/context-fetch.js +218 -33
  286. package/dist/checks/before/env.js +1 -1
  287. package/dist/checks/before/index.js +6 -2
  288. package/dist/checks/before/repo.js +35 -1
  289. package/dist/checks/status-holes.js +739 -114
  290. package/dist/checks/tips/catalogue.js +59 -17
  291. package/dist/checks/tips/detect.js +30 -0
  292. package/dist/checks/tips/index.js +48 -6
  293. package/dist/cli.js +222 -84
  294. package/dist/commands/analysis.js +77 -53
  295. package/dist/commands/ci/ci.js +302 -25
  296. package/dist/commands/ci/pins.js +142 -0
  297. package/dist/commands/ci/push-gate.js +194 -0
  298. package/dist/commands/install/uninstall.js +23 -27
  299. package/dist/commands/install/upgrade.js +21 -11
  300. package/dist/commands/land.js +126 -10
  301. package/dist/commands/lib.js +244 -5
  302. package/dist/commands/registry.js +6 -2
  303. package/dist/commands/setup/setup.js +1 -0
  304. package/dist/commands/stats.js +69 -30
  305. package/dist/commands/workflow/branches.js +1232 -111
  306. package/dist/commands/workflow/challenge.js +90 -37
  307. package/dist/commands/workflow/completeness.js +97 -0
  308. package/dist/commands/workflow/context.js +371 -51
  309. package/dist/commands/workflow/counters.js +206 -40
  310. package/dist/commands/workflow/decisions.js +60 -17
  311. package/dist/commands/workflow/disk.js +213 -55
  312. package/dist/commands/workflow/fids.js +18 -1
  313. package/dist/commands/workflow/issues.js +6 -0
  314. package/dist/commands/workflow/ledgers.js +372 -21
  315. package/dist/commands/workflow/locks.js +2 -0
  316. package/dist/commands/workflow/plan-blocks.js +78 -14
  317. package/dist/commands/workflow/plans.js +205 -0
  318. package/dist/commands/workflow/prs.js +12 -3
  319. package/dist/commands/workflow/repo.js +6 -0
  320. package/dist/commands/workflow/roadmap.js +50 -17
  321. package/dist/commands/workflow/run-facts.js +23 -28
  322. package/dist/commands/workflow/runs.js +530 -33
  323. package/dist/commands/workflow/runtime.js +3 -0
  324. package/dist/commands/workflow/skills.js +1 -0
  325. package/dist/commands/workflow/status.js +166 -19
  326. package/dist/commands/workflow/step-table.js +61 -29
  327. package/dist/commands/workflow/steps.js +542 -26
  328. package/dist/commands/workflow/summary-findings.js +117 -0
  329. package/dist/commands/workflow/summary.js +154 -41
  330. package/dist/commands/workflow/tasks.js +378 -0
  331. package/dist/commands/workflow/test-blocks.js +231 -0
  332. package/dist/commands/workflow/tests-changed.js +172 -0
  333. package/dist/commands/workflow/tests.js +1013 -321
  334. package/dist/commands/workflow/workflows.js +191 -38
  335. package/dist/commands/workflow/worktrees.js +310 -42
  336. package/dist/install/cloud-env.js +233 -99
  337. package/dist/install/context-ci-workflow.js +85 -0
  338. package/dist/install/manifest.js +57 -12
  339. package/dist/install/modules/antigravity.js +3 -2
  340. package/dist/install/modules/cloud.js +3 -3
  341. package/dist/install/modules/codex.js +12 -2
  342. package/dist/install/modules/core.js +851 -53
  343. package/dist/install/modules/cursor.js +6 -6
  344. package/dist/install/modules/opencode.js +11 -5
  345. package/dist/install/template-notes.js +116 -0
  346. package/dist/install/version-file.js +3 -2
  347. package/dist/ledgers/compact.js +87 -0
  348. package/dist/ledgers/journal.js +233 -0
  349. package/dist/ledgers/status.js +115 -5
  350. package/dist/ledgers/telemetry.js +121 -17
  351. package/dist/render/hosts.js +100 -14
  352. package/dist/shared/bkit-latest.js +26 -4
  353. package/dist/shared/dep-updater.js +49 -0
  354. package/dist/shared/egress.js +1 -1
  355. package/dist/shared/package-manager.js +6 -0
  356. package/dist/shared/settings.js +59 -10
  357. package/dist/shared/timeouts.js +2 -0
  358. package/dist/tools/cli-doc.js +97 -0
  359. package/dist/tools/grammar-density.js +1 -1
  360. package/dist/tools/instructions-sources.js +15 -16
  361. package/dist/tools/instructions.js +83 -39
  362. package/package.json +58 -42
  363. package/.bkit/core/.bkit/lite.md +0 -73
  364. package/.bkit/core/engine/commands/workflow/workstreams.ts +0 -172
  365. package/.bkit/core/prompts/bkit-build-plan-execute.md +0 -124
  366. package/.bkit/templates/scripts/ci/bkit-local-stack-lock.sh +0 -194
  367. package/dist/commands/workflow/workstreams.js +0 -149
  368. /package/.bkit/templates/.vale/styles/{House → Bkit}/Filler.yml +0 -0
  369. /package/.bkit/templates/.vale/styles/{House → Bkit}/Hedging.yml +0 -0
  370. /package/.bkit/templates/.vale/styles/{House → Bkit}/LLMSlop.yml +0 -0
  371. /package/.bkit/templates/.vale/styles/{House → Bkit}/Verbose.yml +0 -0
  372. /package/.bkit/templates/scripts/ci/{accepted-advisories.json → bkit-accepted-advisories.json} +0 -0
  373. /package/.bkit/templates/scripts/ci/{accepted-divergences.json → bkit-accepted-divergences.json} +0 -0
  374. /package/.bkit/templates/scripts/launchd/{launchd.env.example → bkit-launchd.env.example} +0 -0
  375. /package/.bkit/templates/scripts/launchd/{ai.bkit.launchd.plist → bkit-launchd.plist} +0 -0
@@ -1,9 +1,9 @@
1
- <!-- Note: Reports live at `docs/audits/{YYYYMM}/{slug}.md`. `{YYYYMM}` = UTC month of this run. `{slug}` = template basename without `bkit-audit-` and `.md`. **If** that month already has `{slug}.md` or `{slug}-{TIMESTAMP}.md` → write `{slug}-{TIMESTAMP}.md` (`{TIMESTAMP}` = `date -u +%Y%m%dT%H%M%SZ`). Never overwrite. The report is stamped with a `bkit:anchor` block recording the audited commit (`baseSha`) and branch (`baseRef`); never hand-author or edit it. `@bkit-audit-generate` fills this template. -->
2
-
3
1
  <!-- bkit:start -->
4
2
 
5
3
  {{BKIT_MANAGED_MARKER}}
6
4
 
5
+ <!-- Note: @bkit-audit-generate fills this template. The report lives at `docs/audits/{YYYYMM}/{slug}.md`, where `{YYYYMM}` is the UTC month of the run and `{slug}` is this file's name without `bkit-audit-` and `.md`. **If** that month already has `{slug}.md` or `{slug}-{TIMESTAMP}.md` → write `{slug}-{TIMESTAMP}.md`, where `{TIMESTAMP}` is the output of `date -u +%Y%m%dT%H%M%SZ`. NEVER overwrite an earlier report. The report is stamped with a `bkit:anchor` block that records the audited commit (`baseSha`) and branch (`baseRef`). NEVER write or edit that block by hand. -->
6
+
7
7
  # Reliability Audit
8
8
 
9
9
  > [!CAUTION]
@@ -11,119 +11,138 @@
11
11
  >
12
12
  > **Rules:**
13
13
  >
14
- > - never take a dependency down, inject a fault, or change an alert, monitor, or flag. A game day is a separate exercise; this run only records its date and outcome.
15
- > - never run a replay, retry, send, charge, or restore. Read the procedure only.
14
+ > - Never take a dependency down, inject a fault, or change an alert, monitor or flag.
15
+ > - A game day is a separate exercise. This run only records its date and outcome.
16
+ > - Never run a replay, retry, send, charge or restore. Read the procedure only.
16
17
 
17
18
  ## Universal Instructions
18
19
 
19
20
  ### Context & Goals
20
21
 
21
- Failure paths are least-tested: happy path is tested; vendor outage stays unwalked until it happens. Target failure: **a dependency is slow, down, or delivered twice, and the call site answers with success** — e.g. write whose error is dropped, route returns success, no event fires, no dashboard sees it. Each new call site drifts that answer.
22
+ Failure paths are the least tested. The happy path is tested, while a vendor outage stays unwalked until it happens. The failure this audit targets is a dependency that is slow, down or delivered twice, while the call site answers with success. For example, a write whose error is dropped: the route returns success, no event fires, and no dashboard sees it. Each new call site drifts that answer.
22
23
 
23
- **Applies when:** outbound calls, webhook receivers, background jobs, or write paths. None → one `N/A` row with evidence, never "clean".
24
+ **Applies when:** the product has outbound calls, webhook receivers, background jobs or write paths. **If** it has none → write one `N/A` row with its evidence, and never report the surface as "clean".
24
25
 
25
- **Cadence:** quarterly. Extra pass when a new vendor, webhook, or background job lands. Game day in `Degradation` is separate, also quarterly, on its own date; each run records when it last happened.
26
+ **Cadence:** Run once a quarter. Run an extra pass when a new vendor, webhook or background job lands. The game day in `Degradation` is a separate exercise, also run quarterly, on its own date. Each run records when it last happened.
26
27
 
27
28
  **Anchor Standards:**
28
29
 
29
30
  - Google SRE Workbook (online edition): Implementing SLOs, Alerting on SLOs (multi-window, multi-burn-rate), Example error budget policy.
30
31
  - Google SRE Book (online edition): Postmortem Culture.
31
32
  - AWS Well-Architected Framework, Reliability Pillar: REL05 BP01-BP07 (graceful degradation, throttling, retries, fail fast, client timeouts, stateless, emergency levers), REL11 (static stability), REL13 (disaster recovery). Record the publication date read.
32
- - Background-job flow-control docs (e.g. Inngest concurrency and `createFunction`, Temporal task queues).
33
+ - Background-job flow-control docs (e.g., Inngest concurrency and `createFunction`, Temporal task queues).
33
34
  - bkit block of `docs/deployments.md` (bkit version from `.bkit/version`): § Production rollback runbook; § Dev rollback runbook; § Consumer rollback path; § Smoke trigger plumbing; § Applying migrations at deploy time; § Build-vs-migration race; § Promote before the lanes (`bkit-tests-deploy`)
34
35
 
35
36
  ### Scope
36
37
 
37
- - Outbound calls, webhook receivers, background work, write paths. Hard vs soft, including transitive dependencies.
38
- - Critical journeys, SLOs, error-budget policy.
39
- - Dropped errors, timeouts, retries, idempotency, races, unbounded work.
40
- - User-local time, where the product schedules.
41
- - What the user sees when a dependency is down; every dependency walked on paper; last game day recorded, not run.
42
- - Emergency levers, recovery targets, disaster paths.
43
- - Deploys, old clients, alerts, runbooks, incident response.
38
+ - List the outbound calls, webhook receivers, background work and write paths.
39
+ - Mark each dependency hard or soft, including transitive dependencies.
40
+ - Check the critical journeys, SLOs and the error-budget policy.
41
+ - Check for dropped errors, timeouts, retries, idempotency, races and unbounded work.
42
+ - Check user-local time, where the product schedules.
43
+ - Record what the user sees when a dependency is down.
44
+ - Walk every dependency on paper.
45
+ - Record the last game day, without running one.
46
+ - Check the emergency levers, recovery targets and disaster paths.
47
+ - Check deploys, old clients, alerts, runbooks and incident response.
44
48
 
45
49
  ### Out of Scope
46
50
 
47
51
  <!-- prettier-ignore -->
48
52
  | Excluded item | Why | Where it belongs |
49
53
  | --- | --- | --- |
50
- | Errors that already reached a log | That sweep reads them; this sweep is failures that never reach a log | `bkit-audit-logs` |
51
- | Grants, catalogue integrity, restore drill | Database sweep | `bkit-audit-database` |
52
- | Query plans and database-side limits | Database sweep | `bkit-audit-database` |
53
- | Live fault injection | Separate exercise, under that audit's rules | `bkit-audit-red-team` |
54
- | Prompt bounds, call limits, evals | LLM sweep | `bkit-audit-llm` |
55
- | Which model is called, deprecation, registry | Registry sweep | `bkit-audit-models` |
56
- | Copied wrappers as duplication | Duplication sweep | `bkit-audit-duplication` |
57
- | Adding a lint or test gate | Gates sweep | `bkit-audit-gates` |
58
- | Rewriting a doc that omits a surface | Docs sweep | `bkit-audit-documentation` |
59
- | Store-side version settings | Store sweep | `bkit-audit-app-store` |
60
- | Whether an outside caller is allowed to trigger a replay | Security sweep; this audit still reads idempotency | `bkit-audit-security` |
61
- | Changing code, alerts, or monitors | Audit reports only | Plan from this report |
54
+ | Errors that already reached a log | That sweep reads them. This sweep covers failures that never reach a log | `bkit-audit-logs` |
55
+ | Grants, catalogue integrity, restore drill | The database sweep owns them | `bkit-audit-database` |
56
+ | Query plans and database-side limits | The database sweep owns them | `bkit-audit-database` |
57
+ | Live fault injection | It is a separate exercise, under that audit's rules | `bkit-audit-red-team` |
58
+ | Prompt bounds, call limits, evals | The LLM sweep owns them | `bkit-audit-llm` |
59
+ | Which model is called, deprecation, registry | The registry sweep owns them | `bkit-audit-models` |
60
+ | Copied wrappers as duplication | The duplication sweep owns them | `bkit-audit-duplication` |
61
+ | Adding a lint or test gate | The gates sweep owns it | `bkit-audit-gates` |
62
+ | Rewriting a doc that omits a surface | The docs sweep owns it | `bkit-audit-documentation` |
63
+ | Store-side version settings | The store sweep owns them | `bkit-audit-app-store` |
64
+ | Whether an outside caller is allowed to trigger a replay | The security sweep owns it. This audit still reads idempotency | `bkit-audit-security` |
65
+ | Changing code, alerts, or monitors | The audit only reports | A plan made from this report |
62
66
 
63
67
  ### Pre-Flight / Dependencies
64
68
 
65
69
  #### Core
66
70
 
67
- - [ ] **Permissions:** blocked calls recorded
68
- - [ ] **Code Search:** Steps 2-12, 14, 16 — text search and language server for callers, e.g. ripgrep, Serena, `tsserver`. Language-server hits under-report; empty is inconclusive → corroborate with text search and name the tool. Fallback: text search only; name it per claim.
69
- - [ ] **Web:** Step 15 — fetch anchor standards. Fallback: versions recorded as unread.
71
+ - [ ] **Permissions:** every blocked call is recorded.
72
+ - [ ] **Code Search:** Steps 2-12, 14, 16 — text search, and a language server for callers (e.g., ripgrep, Serena, `tsserver`). Language-server hits under-report, and an empty result is inconclusive, so corroborate with text search and name the tool. Fallback: text search only, and name the tool for each claim.
73
+ - [ ] **Web:** Step 15 — fetch the anchor standards. Fallback: record the versions as unread.
70
74
 
71
75
  #### Conditional
72
76
 
73
- - [ ] **Metrics:** Hosted traces, errors, or health endpoint → Steps 3, 13 — SLO queries and alert config, e.g. Sentry, Datadog, Better Stack. Fallback: repo config only; live measurements `Not Checked`.
74
- - [ ] **Job Platform:** Background jobs → Steps 6, 7 — flow control and replay docs, read-only, e.g. Inngest, Temporal. Log access: `.agents/context.md` `context-fetch` blocks below `bkit:end` are ready-made read-only readers (`bkit context list-blocks` → each block's `context` and `body`); set a body's `# Customise:` knobs to the audit window; run it via `direnv exec . bash`. Fallback: code only; live run history `Not Checked`.
75
- - [ ] **Deploy Platform:** Hosted deploys → Step 12 — skew protection, rollout, rollback history, e.g. Vercel API, Cloud Run. Fallback: repo config only; dashboard settings `Not Checked`.
76
- - [ ] **Vendor Status:** External dependencies → Step 13 — status feeds. Fallback: none; feeds `Not Checked`.
77
+ - [ ] **Metrics:** **If** there are hosted traces, errors or a health endpoint → Steps 3, 13 — SLO queries and alert config (e.g., Sentry, Datadog, Better Stack). Fallback: read the repo config only, and mark live measurements `Not Checked`.
78
+ - [ ] **Job Platform:** **If** there are background jobs → Steps 6, 7 — flow-control and replay docs, read-only (e.g., Inngest, Temporal). Log access: the `context-fetch` blocks below `bkit:end` in `.agents/context.md` are ready-made read-only readers. `bkit context list-blocks` prints each block's `context` and `body`. Set a body's `# Customise:` knobs to the audit window, and run it with `direnv exec . bash`. Fallback: read the code only, and mark live run history `Not Checked`.
79
+ - [ ] **Deploy Platform:** **If** deploys are hosted → Step 12 — skew protection, rollout and rollback history (e.g., Vercel API, Cloud Run). Fallback: read the repo config only, and mark dashboard settings `Not Checked`.
80
+ - [ ] **Vendor Status:** **If** there are external dependencies → Step 13 — status feeds. Fallback: there is none, so mark the feeds `Not Checked`.
77
81
 
78
82
  ### 🔒 Gate 1: Prerequisites Check
79
83
 
80
- - [ ] **Gaps named:** every missing item names its fallback and `Not Checked` entry.
81
- - [ ] **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.
82
86
 
83
87
  ### Probe Steps
84
88
 
85
- - [ ] **Step 1 — Previous Run:** **Done when:** closure rate in `Previous Run`, or run marked baseline.
86
- - [ ] **Step 2 — Surfaces:** One table, kept run to run for diffs. Outbound calls (every SDK client and every `fetch` host); webhook receivers; background work (job functions and scheduled database jobs); write paths (routes and server actions that change data). Per dependency: hard (journey fails without it) or soft (degrades), and what it depends on in turn. Transitive counts (e.g. auth mail via mail vendor → mail outage is sign-in outage). Surface in code, not docs = finding; doc rewrite → `bkit-audit-documentation`. **Done when:** `Surfaces` lists every surface with hard/soft and transitive deps, or `N/A` and STOP.
87
- - [ ] **Step 3 — Journeys:** Every user-reliant journey. Per journey: SLI as good/total ratio, SLO over rolling 28-day window, current measurement with query that produced it. Keep table run to run. No target, or target nobody measures = finding. Error-budget policy: what changes when budget spent (e.g. feature freeze, mandatory postmortem when one incident uses >20% of budget). Record whether policy triggered since previous run and whether obeyed. No policy = finding. **Done when:** `Journeys` row per journey: SLI · SLO · measurement and query · budget triggered · obeyed.
88
- - [ ] **Step 4 — Dropped Errors:** Codebase-wide, not only errors that reached a log (`bkit-audit-logs` owns those). `catch` that neither rethrows, returns error, nor logs at `warn` or above; client calls whose error never read (e.g. Supabase `{ error }`, AWS SDK, Prisma); promises without `await` or `.catch`; broad catches turning every failure into one generic message so caller cannot tell timeout from bug. Dropped, never logged = invisible to user and operators; those first. Deliberate best-effort (telemetry, fire-and-forget notification) OK when code says so. Linter-catchable class (e.g. `@typescript-eslint/no-floating-promises`, unread client `error`) → name rule under `Process Improvements`; do not add it. Adding gate → `bkit-audit-gates`. **Done when:** every hit = finding with `file:line`.
89
- - [ ] **Step 5 — Timeouts:** Per outbound call from `Surfaces`. Timeout (`fetch` none by default; SDK may or may not). No timeout holds function open until platform kills it. Each timeout x attempts + backoff fits inside calling function's duration limit; each inner timeout shorter than outer. Function killed at limit reports nothing; platform timeouts → `bkit-audit-logs`; this step owns budget. Bounded retries with backoff on worth-retrying errors (timeouts, 429, 5xx), never 4xx. Retries only on safe ops: retrying create, charge, or send without idempotency key does it twice. Background-job retry setting (e.g. Inngest `retries`) and re-run behavior per step. Model call has fallback model/provider list or degraded path without model. Models listed → `bkit-audit-models`. Token caps and evals → `bkit-audit-llm`. Credit-limit vs rate-limit responses distinct, not one generic retry: credit limit does not succeed on retry unless `Retry-After`; rate limit backs off (e.g. OpenRouter `402` / `429`). Shared outbound client with default timeout/retry → check bypasses; absent → propose under `Process Improvements`. Same wrapper copied → name for `bkit-audit-duplication`. **Done when:** every call from `Surfaces` has timeout, budget, retry, and safety verdict.
90
- - [ ] **Step 6 — Idempotency:** Webhooks at-least-once; job step re-runs after failure. Per receiver/step, second run harmless: dedupe on provider event id, conditional update, or naturally idempotent. Side effects (email, charge, row insert) outside step run again on every retry. Outside caller repeating create → `bkit-audit-security` and `bkit-audit-red-team`; this step reads code. Run failed for good needs written replay/bulk-retry procedure, tried on preview — read only, do not run. Replay creates new runs → repeats side effects this step did not make safe; reaches back only as far as plan history retention. Terminal failure with no replay path = lost work. **Done when:** every receiver and step has verdict; replay path or replacing finding recorded.
91
- - [ ] **Step 7 — Races:** Read-modify-write with no lock, conditional update, or unique constraint. Partial writes: two+ mutations outside transaction or stored procedure (e.g. client calls outside RPC). Concurrent jobs on same row/tenant with no concurrency key. Per job function: `concurrency` (key and scope), `throttle`, `rateLimit`, `idempotency`, `retries`, `onFailure` (or platform equivalents). Overlapping cron = finding. No failure handler leaving half-done state on terminal fail = finding. Unbounded work: loops over every tenant/row, queries with no limit (database-side limits → `bkit-audit-database`), fan-out with no cap, payloads with no size limit. Vendor ceilings (pooler client limit, job concurrency cap, mail send rate, model rate limit) vs expected peak product is sized for. Load test proposed under `Process Improvements`, not run. **Done when:** every function's flow-control settings and every unbounded site have verdict.
92
- - [ ] **Step 8 — Time:** Product stores/sends user-local times → DST transitions, cron timezone vs user-local send time, recurrence crossing DST, month-end (31st, February). Name test pinning each case; no test = finding. No user-local times → skip with evidence. **Done when:** each case names test, or skip recorded.
93
- - [ ] **Step 9 — Degradation:** Per `Surfaces` dependency: what user sees and whether right. Documented deliberate fallback is model. Each dependency failure labelled with one upstream signal so outage reads as one thing, not many bugs. Offline client: queued or lost write, user told which; reconnect does not double-submit; no infinite spinner. Walk every dependency on paper: take down in reasoning, follow call sites, write what breaks — no fault injection. Live injection = quarterly game day: one dependency down on preview, under `bkit-audit-red-team`, separate exercise, never this run. Record last game day date/outcome; >1 quarter overdue = finding. Name next dependency to fault-inject and alert that must fire when down. **Done when:** per-dependency answer and paper walk in `Degradation`; date, outcome, next dependency in `Game Day`.
94
- - [ ] **Step 10 — Levers:** Per costly/risky subsystem abusable or runaway (paid model calls, inbound automation, scrapers, outbound fan-out): lever off/down without deploy (flag, kill switch, throttle). Record who pulls, how, last pulled/tested. Code change + redeploy is not a lever. No lever = finding; untried lever = finding. **Done when:** `Levers` row per subsystem: lever · who · how · last tested · verdict.
95
- - [ ] **Step 11 — Recovery:** State RPO (data loss) and RTO (time to work again) per data store and per `Journeys` row; compare with setup delivers. Read platform backup docs, do not assume. Restore drill → `bkit-audit-database`; this step owns whether targets written and achievable. DB backups often omit file storage, in-flight jobs, replay history, DNS, developer account access. Per store: recovery path or finding. Per scenario: path and who carries it out — region outage (name region); vendor account suspended or billing lapsed; lost source-host org, deploy team, or sole-account developer; key compromised and revoked. No path = finding. **Done when:** `Recovery` holds RPO, RTO, each scenario path, or replacing finding.
96
- - [ ] **Step 12 — Deploys:** Most outages follow a change. Version skew: client loaded pre-deploy keeps reaching server code it was built against where platform offers that. Framework may not pin custom client-side fetches (e.g. `fetch` from Next.js client components); check newer-server handling. Schema/code order: expand first, contract later so either rolls back alone. Rollback speed: last rollback duration or rollback runbook drill. No drill and no measured rollback = finding. Progressive rollout: staged rollout or what stops bad deploy reaching all users; neither = finding. Old native clients cannot roll back. API tolerates oldest supported version; forced-update/minimum-version gate; update channels map to runtime versions. Record oldest version in production traffic and support window. Store-side settings → `bkit-audit-app-store`. **Done when:** each check met, finding, or not applicable (why).
97
- - [ ] **Step 13 — Alerts:** Map each Step 4-9 failure mode to alert (error-tracker, health endpoint, uptime monitors, canaries, data-freshness, dropped-work). No alert = finding; alert with no runbook = finding. Whether alarms fire → `bkit-audit-logs`; this step checks coverage. `Journeys` SLO alert = burn-rate, long and short windows per Workbook, not raw threshold. Near-zero traffic: one failed request can look like outage — minimum request count or synthetic probe behind alert. Each vendor status feed reaches alert channel. **Done when:** `Alerts` maps every failure mode to alert, runbook, sensitivity verdict.
98
- - [ ] **Step 14 — Incidents:** Severity levels, incident lead per incident, who told at each level and how. User comms: status page or in-app banner for outage plus message template. Drill with date. Never rehearsed = finding. Incidents since previous run: each blameless postmortem with owned actions; record closed actions. Gap = finding with proposal; do not file — report is output. **Done when:** `Incidents` states each requirement met or finding.
99
- - [ ] **Step 15 — Standards:** Confirm current version per anchor standard; read changes since previous report's version. `Standards Coverage`: one row per REL05 BP01-BP07, REL11, REL13, each SLO and error-budget checklist item → checked (name step) / not applicable (why) / finding. Each row pass / partial / fail with evidence. 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.
100
- - [ ] **Step 16 — Anything Else:** (a) Everything changed since previous report's commit touching reliability (outbound calls and hosts, webhook receivers, job functions and flow-control, scheduled jobs, write paths, timeouts and duration limits, alerts and monitors) → one-line verdict each. (b) Bounded ~30 min pass: what senior SRE flags that no step asks; read since previous run (incidents and postmortems, log-audit sweeps, new `docs/failures.jsonl` rows, vendor status incidents) — what would no step catch? **Done when:** `Beyond the Steps` holds both passes, or `none`. Class seen on 2 runs → propose step in `Process Improvements`.
89
+ - [ ] **Step 1 — Previous Run:** **Done when:** `Previous Run` holds the closure rate, or the run is marked baseline.
90
+ - [ ] **Step 2 — Surfaces:** Keep one table, run to run, so runs can be diffed. List the outbound calls (every SDK client and every `fetch` host), webhook receivers, background work (job functions and scheduled database jobs) and write paths (routes and server actions that change data). Mark each dependency hard (the journey fails without it) or soft (the journey degrades), and record what it depends on in turn. Transitive dependencies count: for example, when auth mail goes through a mail vendor, a mail outage is a sign-in outage. A surface that is in the code but not in the docs is a finding. The doc rewrite goes to `bkit-audit-documentation`. **Done when:** `Surfaces` lists every surface with hard/soft and its transitive dependencies, or `N/A` is recorded → **STOP**.
91
+ - [ ] **Step 3 — Journeys:** List every journey users rely on. For each journey, record the SLI as a good/total ratio, the SLO over a rolling 28-day window, and the current measurement with the query that produced it. Keep the table run to run. A journey with no target, or with a target nobody measures, is a finding. Read the error-budget policy: what changes when the budget is spent (e.g., a feature freeze, or a mandatory postmortem when one incident uses more than 20% of the budget). Record whether the policy triggered since the previous run, and whether it was obeyed. No policy is a finding. **Done when:** `Journeys` has one row per journey: SLI · SLO · measurement and query · budget triggered · obeyed.
92
+ - [ ] **Step 4 — Dropped Errors:** Search the whole codebase, not only the errors that reached a log (`bkit-audit-logs` owns those). Look for a `catch` that neither rethrows, returns an error nor logs at `warn` or above; client calls whose error is never read (e.g., Supabase `{ error }`, AWS SDK, Prisma); promises without `await` or `.catch`; and broad catches that turn every failure into one generic message, so the caller cannot tell a timeout from a bug. An error that is dropped and never logged is invisible to users and operators, so list those first. Deliberate best-effort code (telemetry, a fire-and-forget notification) is fine when the code says so. **If** a class is linter-catchable (e.g., `@typescript-eslint/no-floating-promises`, an unread client `error`) → name the rule under `Process Improvements`, and do not add it. Adding a gate goes to `bkit-audit-gates`. **Done when:** every hit is a finding with `file:line`.
93
+ - [ ] **Step 5 — Timeouts:** Check each outbound call in `Surfaces`.
94
+ - Check the timeout: `fetch` has none by default, and an SDK may or may not. A call with no timeout holds the function open until the platform kills it.
95
+ - Check that each timeout times the attempts, plus backoff, fits inside the calling function's duration limit, and that each inner timeout is shorter than the outer one. A function killed at its limit reports nothing. Platform timeouts go to `bkit-audit-logs`, and this step owns the budget.
96
+ - Check that retries are bounded, with backoff, on errors worth retrying (timeouts, 429, 5xx), and never on 4xx.
97
+ - Check that retries run only on safe operations: retrying a create, charge or send without an idempotency key does it twice.
98
+ - Check the background-job retry setting (e.g., Inngest `retries`), and how each step behaves when re-run.
99
+ - Check that a model call has a fallback model or provider list, or a degraded path without a model. Listing models goes to `bkit-audit-models`. Token caps and evals go to `bkit-audit-llm`.
100
+ - Check that credit-limit and rate-limit responses are handled apart, not by one generic retry: a credit limit does not succeed on retry unless there is a `Retry-After`, and a rate limit backs off (e.g., OpenRouter `402` / `429`).
101
+ - **If** a shared outbound client sets a default timeout, a default retry or both → check for calls that bypass it.
102
+ - **Else** → propose one under `Process Improvements`.
103
+ - **If** the same wrapper is copied → name it for `bkit-audit-duplication`.
104
+
105
+ **Done when:** every call in `Surfaces` has a timeout, budget, retry and safety verdict.
106
+
107
+ - [ ] **Step 6 — Idempotency:** Webhooks arrive at least once, and a job step re-runs after a failure. For each receiver and step, check that a second run is harmless: it dedupes on the provider event id, uses a conditional update, or is naturally idempotent. Side effects (email, charge, row insert) outside a step run again on every retry. An outside caller repeating a create goes to `bkit-audit-security` and `bkit-audit-red-team`. This step reads the code. A run that failed for good needs a written replay or bulk-retry procedure, tried on preview. Read it only, and do not run it. A replay creates new runs, so it repeats the side effects this step did not make safe, and it reaches back only as far as the plan's history retention. A terminal failure with no replay path is lost work. **Done when:** every receiver and step has a verdict, and the replay path, or the finding that replaces it, is recorded.
108
+ - [ ] **Step 7 — Races:** Find read-modify-write with no lock, conditional update or unique constraint. Find partial writes: two or more mutations outside a transaction or stored procedure (e.g., client calls outside an RPC). Find concurrent jobs on the same row or tenant with no concurrency key. For each job function, record `concurrency` (key and scope), `throttle`, `rateLimit`, `idempotency`, `retries` and `onFailure`, or the platform's equivalents. An overlapping cron is a finding. A missing failure handler that leaves half-done state on a terminal failure is a finding. Find unbounded work: loops over every tenant or row, queries with no limit (database-side limits go to `bkit-audit-database`), fan-out with no cap, and payloads with no size limit. Compare the vendor ceilings (pooler client limit, job concurrency cap, mail send rate, model rate limit) with the expected peak the product is sized for. Propose a load test under `Process Improvements`, and do not run it. **Done when:** every function's flow-control settings and every unbounded site have a verdict.
109
+ - [ ] **Step 8 — Time:** **If** the product stores or sends user-local times → check DST transitions, the cron timezone against the user-local send time, recurrence that crosses DST, and month-end (the 31st, February). Name the test that pins each case. A case with no test is a finding. **If** there are no user-local times → skip with evidence. **Done when:** each case names its test, or the skip is recorded.
110
+ - [ ] **Step 9 — Degradation:** For each dependency in `Surfaces`, record what the user sees and whether it is right. A documented, deliberate fallback is the model to follow. Check that each dependency failure is labelled with one upstream signal, so an outage reads as one thing, not many bugs. Check an offline client: a write is queued or lost, and the user is told which; reconnecting does not double-submit; and no spinner runs forever. Walk every dependency on paper: take it down in your reasoning, follow its call sites, and write what breaks. Inject no fault. Live injection is the quarterly game day: one dependency taken down on preview, under `bkit-audit-red-team`, as a separate exercise, never in this run. Record the date and outcome of the last game day. A game day more than one quarter overdue is a finding. Name the next dependency to fault-inject, and the alert that must fire when it is down. **Done when:** `Degradation` holds the answer for each dependency and the paper walk, and `Game Day` holds the date, the outcome and the next dependency.
111
+ - [ ] **Step 10 — Levers:** For each costly or risky subsystem that could be abused or run away (paid model calls, inbound automation, scrapers, outbound fan-out), find a lever that turns it off or down without a deploy (a flag, kill switch or throttle). Record who pulls it, how, and when it was last pulled or tested. A code change plus a redeploy is not a lever. No lever is a finding, and an untried lever is a finding. **Done when:** `Levers` has one row per subsystem: lever · who · how · last tested · verdict.
112
+ - [ ] **Step 11 — Recovery:** State the RPO (data loss) and RTO (time until it works again) for each data store and each `Journeys` row, and compare them with what the setup delivers. Read the platform's backup docs, and do not assume. The restore drill goes to `bkit-audit-database`. This step owns whether the targets are written and achievable. Database backups often omit file storage, in-flight jobs, replay history, DNS and developer account access. For each store, record a recovery path or a finding. For each scenario, record the path and who carries it out: a region outage (name the region); a vendor account suspended or its billing lapsed; a lost source-host org, deploy team or sole-account developer; and a key compromised and revoked. No path is a finding. **Done when:** `Recovery` holds the RPO, the RTO and each scenario's path, or the finding that replaces it.
113
+ - [ ] **Step 12 — Deploys:** Most outages follow a change. Check version skew: where the platform offers it, a client loaded before a deploy keeps reaching the server code it was built against. The framework may not pin custom client-side fetches (e.g., `fetch` from Next.js client components), so check how a newer server handles them. Check the schema and code order: expand first and contract later, so either can roll back alone. Check rollback speed: the duration of the last rollback, or a drill of the rollback runbook. No drill and no measured rollback is a finding. Check progressive rollout: a staged rollout, or whatever stops a bad deploy reaching all users. Neither is a finding. Old native clients cannot roll back, so check that the API tolerates the oldest supported version, that a forced-update or minimum-version gate exists, and that update channels map to runtime versions. Record the oldest version in production traffic and the support window. Store-side settings go to `bkit-audit-app-store`. **Done when:** each check is met, a finding, or not applicable (saying why).
114
+ - [ ] **Step 13 — Alerts:** Map each failure mode from Steps 4-9 to an alert (error tracker, health endpoint, uptime monitors, canaries, data freshness, dropped work). No alert is a finding, and an alert with no runbook is a finding. Whether alarms fire goes to `bkit-audit-logs`. This step checks coverage. A `Journeys` SLO alert is a burn-rate alert, with long and short windows as the Workbook describes, not a raw threshold. At near-zero traffic, one failed request can look like an outage, so check that a minimum request count or a synthetic probe sits behind the alert. Check that each vendor status feed reaches the alert channel. **Done when:** `Alerts` maps every failure mode to an alert, a runbook and a sensitivity verdict.
115
+ - [ ] **Step 14 — Incidents:** Check for severity levels, an incident lead per incident, and who is told at each level and how. Check user comms: a status page or in-app banner for an outage, plus a message template. Check for a drill with a date. A process never rehearsed is a finding. For each incident since the previous run, check for a blameless postmortem with owned actions, and record the closed actions. A gap is a finding with a proposal. Do not file it, because the report is the output. **Done when:** `Incidents` states that each requirement is met, or gives its finding.
116
+ - [ ] **Step 15 — 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 REL05 BP01-BP07, REL11, REL13, and each SLO and error-budget checklist item, each marked checked (naming the step), not applicable (saying why) or finding. Mark each row pass, partial or fail, with evidence. 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.
117
+ - [ ] **Step 16 — Anything Else:** (a) Give a one-line verdict on each change since the previous report's commit that touches reliability: outbound calls and hosts, webhook receivers, job functions and flow control, scheduled jobs, write paths, timeouts and duration limits, and alerts and monitors. (b) In a bounded pass of about 30 minutes, note what a senior SRE would flag that no step asks about. Read what happened since the previous run (incidents and postmortems, log-audit sweeps, new `docs/failures.jsonl` rows, vendor status incidents), and ask what no step would catch. **Done when:** `Beyond the Steps` holds both passes, or says `none`. **If** one class of issue is seen on 2 runs → propose a step for it in `Process Improvements`.
101
118
 
102
119
  ### 🔒 Gate 2: Probes Check
103
120
 
104
- - [ ] **Steps complete:** every step `[x]`, or explicit skip with evidence the surface is absent.
105
- - [ ] **Evidence:** every finding cites re-checkable evidence and the tool behind it.
106
- - [ ] **Read-only:** no dependency taken down; no replay, send, charge, or restore executed; no alert or monitor changed.
107
- - [ ] **Gate 2 — Verified:** Every checkbox above independently verified and checked off.
121
+ - [ ] **Steps complete:** every step is `[x]`, or skipped with evidence that its surface is absent.
122
+ - [ ] **Evidence:** every finding cites evidence someone can check again, and the tool that produced it.
123
+ - [ ] **Read-only:** no dependency was taken down.
124
+ - [ ] **No side effects:** no replay, send, charge or restore ran.
125
+ - [ ] **Alerts unchanged:** no alert or monitor changed.
126
+ - [ ] **Gate 2 — Verified:** every item above holds.
108
127
 
109
128
  ## Findings
110
129
 
111
130
  <!-- prettier-ignore -->
112
131
  | Severity | Use |
113
132
  | --- | --- |
114
- | `CRITICAL` | Silent failure that drops or corrupts data with no user signal and no retry; charge or send that can happen twice with no reversal; hard dependency down takes a core journey down with no degraded path |
115
- | `HIGH` | Silent write, or a double effect a person can repair; call with no timeout on a user-facing or job path; core failure mode with no alert; no written recovery target, or a target the setup cannot meet; costly subsystem with no emergency lever |
116
- | `MEDIUM` | Journey with no SLO or no measurement; no error-budget policy; retry on a client error; overlapping scheduled job; unbounded loop or fan-out; alert with no runbook; untested lever; game day more than one quarter overdue; incident process never drilled |
117
- | `LOW` | Soft dependency whose failure is unlabelled but the journey still succeeds; wording drift in an alert title |
133
+ | `CRITICAL` | A silent failure drops or corrupts data with no user signal and no retry. A charge or send can happen twice with no reversal. A hard dependency going down takes a core journey down with no degraded path |
134
+ | `HIGH` | A silent write, or a double effect a person can repair. A call with no timeout on a user-facing or job path. A core failure mode with no alert. No written recovery target, or a target the setup cannot meet. A costly subsystem with no emergency lever |
135
+ | `MEDIUM` | A journey with no SLO or no measurement. No error-budget policy. A retry on a client error. An overlapping scheduled job. An unbounded loop or fan-out. An alert with no runbook. An untested lever. A game day more than one quarter overdue. An incident process never drilled |
136
+ | `LOW` | A soft dependency whose failure is unlabelled, while the journey still succeeds. Wording drift in an alert title |
118
137
 
119
- Within a severity: money and data first, then a broken core action. A silent write, or a charge or send that can happen twice, is at least `HIGH`. Do not lower either because traffic is low.
138
+ Within a severity, list money and data first, then a broken core action. A silent write, or a charge or send that can happen twice, is at least `HIGH`. Do not lower either because traffic is low.
120
139
 
121
140
  <!-- prettier-ignore -->
122
141
  | ID | Severity | Location | Evidence | Expected |
123
142
  | --- | --- | --- | --- | --- |
124
143
  | PENDING | PENDING | PENDING | PENDING | PENDING |
125
144
 
126
- Empty and clean → one row `None`.
145
+ **If** the run finds nothing → write one row: `None`.
127
146
 
128
147
  ## Report
129
148
 
@@ -196,14 +215,20 @@ PENDING
196
215
 
197
216
  ### 🔒 Gate 3: Report Check
198
217
 
199
- - [ ] **No placeholders:** no `PENDING` left
200
- - [ ] **Summary:** names count per severity, journeys measured, and that every dependency was walked on paper.
201
- - [ ] **Series:** every series beside previous report's numbers, or marked baseline.
202
- - [ ] **Game Day:** states the date and outcome of the last game day, or that none is recorded, and names the next dependency.
203
- - [ ] **Writes:** only this report, template `Project Instructions`, and ledger rows changed; throwaway worktrees / remote targets removed.
204
- - [ ] **Process Improvements:** `Universal` and `Project` filled
205
- - [ ] **Suggested Issues:** every `MEDIUM`+ finding ID in exactly one row; every row has a `Next Step`.
206
- - [ ] **Gate 3 — Verified:** Every checkbox above independently verified and checked off.
218
+ - [ ] **No placeholders:** no `PENDING` is left.
219
+ - [ ] **Summary:** `Summary` gives the count per severity.
220
+ - [ ] **Journeys:** `Summary` names the journeys measured.
221
+ - [ ] **Paper walk:** `Summary` states that every dependency was walked on paper.
222
+ - [ ] **Series:** the report shows every series beside the previous report's numbers, or marks the run as baseline.
223
+ - [ ] **Game Day:** `Game Day` states the date of the last game day, or that none is recorded.
224
+ - [ ] **Game Day outcome:** `Game Day` states the outcome of the last recorded game day.
225
+ - [ ] **Next dependency:** `Game Day` names the next dependency.
226
+ - [ ] **Writes:** this run changed only this report, the template's `Project Instructions` and its own `docs/failures.jsonl` rows.
227
+ - [ ] **Throwaways removed:** every throwaway worktree or remote target is removed.
228
+ - [ ] **Process Improvements:** `Universal` and `Project` are both filled.
229
+ - [ ] **Suggested Issues:** every `MEDIUM`+ finding ID is in exactly one `Suggested Issues` row.
230
+ - [ ] **Next Step:** every `Suggested Issues` row has a `Next Step`.
231
+ - [ ] **Gate 3 — Verified:** every item above holds.
207
232
 
208
233
  <!-- bkit:end -->
209
234