@cbartens/bkit 5.5.1 → 6.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (425) hide show
  1. package/.bkit/README.md +167 -154
  2. package/.bkit/core/.agents/context.md +95 -29
  3. package/.bkit/core/.agents/docs.md +18 -15
  4. package/.bkit/core/.agents/plugins/bkit/hooks/bkit-gateguard.cjs +1 -0
  5. package/.bkit/core/.agents/plugins/bkit/hooks/bkit-guardrails.cjs +6 -5
  6. package/.bkit/core/.agents/plugins/bkit/hooks/bkit-readguard.cjs +1 -0
  7. package/.bkit/core/.agents/plugins/bkit/hooks/bkit-rules.cjs +65 -0
  8. package/.bkit/core/.agents/rules.md +112 -102
  9. package/.bkit/core/.agents/skills.md +63 -15
  10. package/.bkit/core/.bkit/README.md +167 -154
  11. package/.bkit/core/.bkit/authoring.md +747 -0
  12. package/.bkit/core/.bkit/cli.md +407 -0
  13. package/.bkit/core/.bkit/cloud.md +283 -195
  14. package/.bkit/core/.bkit/comparison.md +45 -43
  15. package/.bkit/core/.bkit/install.md +166 -95
  16. package/.bkit/core/.bkit/jsonl.md +339 -196
  17. package/.bkit/core/.bkit/pipeline.md +142 -145
  18. package/.bkit/core/.bkit/prompts.md +295 -264
  19. package/.bkit/core/.bkit/providers.md +460 -277
  20. package/.bkit/core/.bkit/router.md +69 -0
  21. package/.bkit/core/.bkit/templates.md +530 -256
  22. package/.bkit/core/.bkit/trackers.md +116 -65
  23. package/.bkit/core/.bkit/workflows.md +742 -618
  24. package/.bkit/core/.claude/hooks/bkit-gateguard.cjs +2 -2
  25. package/.bkit/core/.claude/hooks/bkit-guardrails.cjs +3 -3
  26. package/.bkit/core/.claude/hooks/bkit-preflight.sh +45 -14
  27. package/.bkit/core/.codex/hooks/bkit-guardrails.cjs +3 -3
  28. package/.bkit/core/.codex/hooks/bkit-rules.cjs +57 -0
  29. package/.bkit/core/.cursor/hooks/bkit-guardrails.cjs +7 -7
  30. package/.bkit/core/.cursor/hooks/bkit-preflight.sh +47 -12
  31. package/.bkit/core/.opencode/plugin/bkit-rules.js +89 -0
  32. package/.bkit/core/AGENTS.md +6 -80
  33. package/.bkit/core/docs/templates/bkit-audit-accessibility.md +128 -130
  34. package/.bkit/core/docs/templates/bkit-audit-adoption.md +104 -94
  35. package/.bkit/core/docs/templates/bkit-audit-agents.md +96 -98
  36. package/.bkit/core/docs/templates/bkit-audit-aio-seo.md +100 -103
  37. package/.bkit/core/docs/templates/bkit-audit-analytics.md +141 -107
  38. package/.bkit/core/docs/templates/bkit-audit-annotations.md +99 -97
  39. package/.bkit/core/docs/templates/bkit-audit-app-performance.md +122 -121
  40. package/.bkit/core/docs/templates/bkit-audit-app-store.md +158 -101
  41. package/.bkit/core/docs/templates/bkit-audit-architecture.md +114 -96
  42. package/.bkit/core/docs/templates/bkit-audit-ci-performance.md +76 -97
  43. package/.bkit/core/docs/templates/bkit-audit-config.md +123 -101
  44. package/.bkit/core/docs/templates/bkit-audit-cost.md +86 -99
  45. package/.bkit/core/docs/templates/bkit-audit-coverage.md +76 -93
  46. package/.bkit/core/docs/templates/bkit-audit-database.md +102 -95
  47. package/.bkit/core/docs/templates/bkit-audit-dead-code.md +165 -108
  48. package/.bkit/core/docs/templates/bkit-audit-deferrals.md +115 -109
  49. package/.bkit/core/docs/templates/bkit-audit-dependencies.md +265 -113
  50. package/.bkit/core/docs/templates/bkit-audit-documentation.md +119 -118
  51. package/.bkit/core/docs/templates/bkit-audit-duplication.md +140 -111
  52. package/.bkit/core/docs/templates/bkit-audit-failures.md +111 -106
  53. package/.bkit/core/docs/templates/bkit-audit-flakes.md +100 -99
  54. package/.bkit/core/docs/templates/bkit-audit-gates.md +107 -103
  55. package/.bkit/core/docs/templates/bkit-audit-issues.md +105 -105
  56. package/.bkit/core/docs/templates/bkit-audit-llm.md +134 -85
  57. package/.bkit/core/docs/templates/bkit-audit-logs.md +124 -125
  58. package/.bkit/core/docs/templates/bkit-audit-models.md +99 -78
  59. package/.bkit/core/docs/templates/bkit-audit-privacy.md +56 -76
  60. package/.bkit/core/docs/templates/bkit-audit-prompts.md +63 -78
  61. package/.bkit/core/docs/templates/bkit-audit-red-team.md +125 -93
  62. package/.bkit/core/docs/templates/bkit-audit-reliability.md +97 -96
  63. package/.bkit/core/docs/templates/bkit-audit-repo.md +170 -98
  64. package/.bkit/core/docs/templates/bkit-audit-security.md +207 -121
  65. package/.bkit/core/docs/templates/bkit-audit-slop.md +78 -95
  66. package/.bkit/core/docs/templates/bkit-audit-testing.md +163 -139
  67. package/.bkit/core/docs/templates/bkit-audit-usability.md +114 -96
  68. package/.bkit/core/docs/templates/bkit-plan.md +158 -281
  69. package/.bkit/core/engine/checks/after/auth.ts +40 -37
  70. package/.bkit/core/engine/checks/after/ci-yml.ts +104 -31
  71. package/.bkit/core/engine/checks/after/github.ts +95 -17
  72. package/.bkit/core/engine/checks/after/index.ts +21 -8
  73. package/.bkit/core/engine/checks/after/suppression.ts +8 -5
  74. package/.bkit/core/engine/checks/after/tools.ts +125 -123
  75. package/.bkit/core/engine/checks/before/context-fetch.ts +227 -33
  76. package/.bkit/core/engine/checks/before/env.ts +3 -3
  77. package/.bkit/core/engine/checks/before/files.ts +5 -4
  78. package/.bkit/core/engine/checks/before/index.ts +25 -1
  79. package/.bkit/core/engine/checks/before/repo.ts +208 -2
  80. package/.bkit/core/engine/checks/status-holes.ts +916 -123
  81. package/.bkit/core/engine/checks/tips/catalogue.ts +82 -20
  82. package/.bkit/core/engine/checks/tips/detect.ts +66 -0
  83. package/.bkit/core/engine/checks/tips/index.ts +52 -11
  84. package/.bkit/core/engine/cli.ts +251 -130
  85. package/.bkit/core/engine/commands/analysis.ts +282 -199
  86. package/.bkit/core/engine/commands/ci/ci.ts +363 -29
  87. package/.bkit/core/engine/commands/ci/pins.ts +172 -0
  88. package/.bkit/core/engine/commands/ci/push-gate.ts +223 -0
  89. package/.bkit/core/engine/commands/comply.ts +77 -103
  90. package/.bkit/core/engine/commands/install/doctor.ts +2 -2
  91. package/.bkit/core/engine/commands/install/install.ts +57 -18
  92. package/.bkit/core/engine/commands/install/uninstall.ts +86 -55
  93. package/.bkit/core/engine/commands/install/upgrade.ts +32 -15
  94. package/.bkit/core/engine/commands/land.ts +139 -18
  95. package/.bkit/core/engine/commands/lib.ts +381 -22
  96. package/.bkit/core/engine/commands/registry.ts +10 -2
  97. package/.bkit/core/engine/commands/setup/setup.ts +8 -7
  98. package/.bkit/core/engine/commands/stats.ts +260 -0
  99. package/.bkit/core/engine/commands/tips.ts +10 -5
  100. package/.bkit/core/engine/commands/workflow/branches.ts +2215 -176
  101. package/.bkit/core/engine/commands/workflow/challenge.ts +748 -0
  102. package/.bkit/core/engine/commands/workflow/completeness.ts +109 -0
  103. package/.bkit/core/engine/commands/workflow/context.ts +1249 -47
  104. package/.bkit/core/engine/commands/workflow/counters.ts +483 -95
  105. package/.bkit/core/engine/commands/workflow/decisions.ts +585 -0
  106. package/.bkit/core/engine/commands/workflow/disk.ts +238 -56
  107. package/.bkit/core/engine/commands/workflow/fids.ts +811 -33
  108. package/.bkit/core/engine/commands/workflow/issues.ts +413 -64
  109. package/.bkit/core/engine/commands/workflow/ledgers.ts +1333 -36
  110. package/.bkit/core/engine/commands/workflow/locks.ts +28 -2
  111. package/.bkit/core/engine/commands/workflow/plan-blocks.ts +691 -0
  112. package/.bkit/core/engine/commands/workflow/plan-versions.ts +21 -0
  113. package/.bkit/core/engine/commands/workflow/plans.ts +257 -0
  114. package/.bkit/core/engine/commands/workflow/prs.ts +178 -33
  115. package/.bkit/core/engine/commands/workflow/repo.ts +66 -8
  116. package/.bkit/core/engine/commands/workflow/roadmap.ts +72 -22
  117. package/.bkit/core/engine/commands/workflow/run-facts.ts +492 -0
  118. package/.bkit/core/engine/commands/workflow/runs.ts +827 -79
  119. package/.bkit/core/engine/commands/workflow/runtime.ts +25 -1
  120. package/.bkit/core/engine/commands/workflow/skills.ts +1 -0
  121. package/.bkit/core/engine/commands/workflow/status.ts +329 -33
  122. package/.bkit/core/engine/commands/workflow/step-table.ts +381 -0
  123. package/.bkit/core/engine/commands/workflow/steps.ts +841 -105
  124. package/.bkit/core/engine/commands/workflow/summary-findings.ts +177 -0
  125. package/.bkit/core/engine/commands/workflow/summary.ts +544 -0
  126. package/.bkit/core/engine/commands/workflow/tasks.ts +409 -0
  127. package/.bkit/core/engine/commands/workflow/test-blocks.ts +254 -0
  128. package/.bkit/core/engine/commands/workflow/tests-changed.ts +201 -0
  129. package/.bkit/core/engine/commands/workflow/tests.ts +2124 -330
  130. package/.bkit/core/engine/commands/workflow/tracker.ts +1195 -0
  131. package/.bkit/core/engine/commands/workflow/workflows.ts +1197 -235
  132. package/.bkit/core/engine/commands/workflow/worktrees.ts +543 -24
  133. package/.bkit/core/engine/install/cloud-env.ts +251 -121
  134. package/.bkit/core/engine/install/context-ci-workflow.ts +102 -0
  135. package/.bkit/core/engine/install/manifest.ts +67 -17
  136. package/.bkit/core/engine/install/modules/antigravity.ts +3 -2
  137. package/.bkit/core/engine/install/modules/cloud.ts +24 -16
  138. package/.bkit/core/engine/install/modules/codex.ts +15 -2
  139. package/.bkit/core/engine/install/modules/core.ts +1196 -45
  140. package/.bkit/core/engine/install/modules/cursor.ts +6 -6
  141. package/.bkit/core/engine/install/modules/opencode.ts +18 -6
  142. package/.bkit/core/engine/install/template-notes.ts +130 -0
  143. package/.bkit/core/engine/install/version-file.ts +9 -4
  144. package/.bkit/core/engine/install/write.ts +5 -0
  145. package/.bkit/core/engine/ledgers/compact.ts +124 -0
  146. package/.bkit/core/engine/ledgers/journal.ts +291 -0
  147. package/.bkit/core/engine/ledgers/migrate.ts +92 -0
  148. package/.bkit/core/engine/ledgers/status.ts +249 -21
  149. package/.bkit/core/engine/ledgers/telemetry.ts +1397 -253
  150. package/.bkit/core/engine/render/hosts.ts +118 -14
  151. package/.bkit/core/engine/render/models.ts +12 -0
  152. package/.bkit/core/engine/shared/bkit-latest.ts +26 -4
  153. package/.bkit/core/engine/shared/branches.ts +4 -1
  154. package/.bkit/core/engine/shared/dep-updater.ts +60 -0
  155. package/.bkit/core/engine/shared/egress.ts +8 -1
  156. package/.bkit/core/engine/shared/json.ts +25 -7
  157. package/.bkit/core/engine/shared/package-manager.ts +9 -0
  158. package/.bkit/core/engine/shared/settings.ts +243 -31
  159. package/.bkit/core/engine/shared/text.ts +361 -0
  160. package/.bkit/core/engine/shared/timeouts.ts +2 -0
  161. package/.bkit/core/engine/tools/cli-doc.ts +111 -0
  162. package/.bkit/core/engine/tools/grammar-density.ts +215 -0
  163. package/.bkit/core/engine/tools/instructions-sources.ts +832 -0
  164. package/.bkit/core/engine/tools/instructions.ts +1802 -0
  165. package/.bkit/core/hooks/antigravity-hook.js +25 -10
  166. package/.bkit/core/hooks/gateguard-engine.js +54 -29
  167. package/.bkit/core/hooks/guardrails-shell.js +4 -5
  168. package/.bkit/core/hooks/guardrails-tiers.js +10 -4
  169. package/.bkit/core/hooks/preflight-linear.sh +9 -9
  170. package/.bkit/core/hooks/preflight-rules.sh +8 -0
  171. package/.bkit/core/hooks/readguard-engine.js +29 -10
  172. package/.bkit/core/hooks/session-rules-advisory.js +61 -0
  173. package/.bkit/core/prompts/bkit-audit-generate.md +202 -94
  174. package/.bkit/core/prompts/bkit-build-challenge-1.md +76 -34
  175. package/.bkit/core/prompts/bkit-build-challenge-2.md +85 -38
  176. package/.bkit/core/prompts/bkit-build-install-skills.md +50 -28
  177. package/.bkit/core/prompts/bkit-build-plan-convert.md +85 -0
  178. package/.bkit/core/prompts/bkit-build-plan-current.md +59 -36
  179. package/.bkit/core/prompts/bkit-build-plan-gaps-remediate.md +101 -36
  180. package/.bkit/core/prompts/bkit-build-plan-tasks.md +149 -0
  181. package/.bkit/core/prompts/bkit-build-plan-tests.md +120 -0
  182. package/.bkit/core/prompts/bkit-build-plan-verify.md +104 -43
  183. package/.bkit/core/prompts/bkit-debug-abort-handover.md +47 -32
  184. package/.bkit/core/prompts/bkit-debug-failure-diagnose.md +109 -57
  185. package/.bkit/core/prompts/bkit-debug-failure-remediate.md +65 -39
  186. package/.bkit/core/prompts/bkit-debug-failure-reproduce.md +53 -31
  187. package/.bkit/core/prompts/bkit-debug-failure-soak.md +65 -34
  188. package/.bkit/core/prompts/bkit-design-brainstorm-ideate-1.md +46 -31
  189. package/.bkit/core/prompts/bkit-design-brainstorm-ideate-2.md +45 -31
  190. package/.bkit/core/prompts/bkit-design-brainstorm-ideate-3.md +43 -30
  191. package/.bkit/core/prompts/bkit-design-generate.md +80 -46
  192. package/.bkit/core/prompts/bkit-design-organise.md +83 -32
  193. package/.bkit/core/prompts/bkit-design-review-1.md +70 -50
  194. package/.bkit/core/prompts/bkit-design-review-2.md +65 -46
  195. package/.bkit/core/prompts/bkit-design-spike.md +64 -40
  196. package/.bkit/core/prompts/bkit-design-update.md +53 -28
  197. package/.bkit/core/prompts/bkit-plan-generate.md +101 -29
  198. package/.bkit/core/prompts/bkit-plan-review-1.md +78 -41
  199. package/.bkit/core/prompts/bkit-plan-review-2.md +78 -35
  200. package/.bkit/core/prompts/bkit-plan-scope-check.md +116 -0
  201. package/.bkit/core/prompts/bkit-plan-update.md +86 -31
  202. package/.bkit/core/prompts/bkit-ship-conflict-resolve.md +94 -50
  203. package/.bkit/core/prompts/bkit-ship-deferred-sweep.md +91 -41
  204. package/.bkit/core/prompts/bkit-ship-update-docs.md +45 -24
  205. package/.bkit/core/prompts/bkit-utility-compress-markdown.md +65 -49
  206. package/.bkit/core/prompts/bkit-utility-update-decisions.md +87 -42
  207. package/.bkit/core/prompts/bkit-utility-update-deferrals.md +81 -37
  208. package/.bkit/core/prompts/bkit-utility-update-documentation.md +43 -25
  209. package/.bkit/core/prompts/bkit-utility-update-failures.md +84 -37
  210. package/.bkit/core/prompts/bkit-utility-update-knowledge.md +88 -42
  211. package/.bkit/core/prompts/bkit-utility-update-roadmap.md +92 -39
  212. package/.bkit/core/prompts/bkit-utility-update-tracker.md +159 -60
  213. package/.bkit/core/workflows/bkit-auto.md +89 -58
  214. package/.bkit/core/workflows/bkit-build.md +967 -517
  215. package/.bkit/core/workflows/bkit-debug.md +555 -387
  216. package/.bkit/core/workflows/bkit-design.md +319 -283
  217. package/.bkit/core/workflows/bkit-plan.md +319 -342
  218. package/.bkit/core/workflows/bkit-ship.md +525 -328
  219. package/.bkit/shared/.agents/plugins/bkit/hooks.json +10 -0
  220. package/.bkit/shared/.bkit/.env.example +2 -2
  221. package/.bkit/shared/.claude/bkit-cloud.md +12 -10
  222. package/.bkit/shared/.claude/settings.json +14 -0
  223. package/.bkit/shared/.codex/bkit-cloud.md +98 -0
  224. package/.bkit/shared/.codex/hooks.json +20 -0
  225. package/.bkit/shared/.cursor/bkit-cloud.md +3 -3
  226. package/.bkit/shared/.cursor/mcp.json +1 -1
  227. package/.bkit/shared/.cursor/rules/bkit-rules.mdc +1 -1
  228. package/.bkit/shared/.gitattributes +1 -1
  229. package/.bkit/shared/.mcp.json +1 -1
  230. package/.bkit/shared/.opencode/opencode.json +12 -1
  231. package/.bkit/shared/CLAUDE.md +6 -2
  232. package/.bkit/shared/GEMINI.md +5 -2
  233. package/.bkit/shared/docs/architecture.md +4 -7
  234. package/.bkit/shared/docs/data-schema.md +4 -7
  235. package/.bkit/shared/docs/deployments.md +241 -168
  236. package/.bkit/shared/docs/design.md +11 -12
  237. package/.bkit/shared/docs/noise.md +8 -7
  238. package/.bkit/shared/docs/observability.md +5 -8
  239. package/.bkit/shared/docs/security.md +35 -17
  240. package/.bkit/shared/docs/setup.md +29 -18
  241. package/.bkit/shared/docs/technology.md +3 -6
  242. package/.bkit/shared/docs/testing.md +289 -174
  243. package/.bkit/shared/gitignore +6 -2
  244. package/.bkit/templates/.claude/hooks/bkit-cloud-bootstrap.sh +15 -16
  245. package/.bkit/templates/.cursor/Dockerfile +12 -8
  246. package/.bkit/templates/.cursor/environment.json +1 -1
  247. package/.bkit/templates/.github/ISSUE_TEMPLATE/bkit-bug.yml +10 -8
  248. package/.bkit/templates/.github/ISSUE_TEMPLATE/bkit-change.yml +45 -12
  249. package/.bkit/templates/.github/ISSUE_TEMPLATE/bkit-idea.yml +3 -3
  250. package/.bkit/templates/.github/renovate.json5 +34 -6
  251. package/.bkit/templates/.github/workflows/bkit-ci.yml +54 -51
  252. package/.bkit/templates/.github/workflows/bkit-cloud.yml +34 -33
  253. package/.bkit/templates/.github/workflows/bkit-health.yml +97 -0
  254. package/.bkit/templates/.github/workflows/bkit-renovate.yml +5 -4
  255. package/.bkit/templates/.github/workflows/bkit-trivy.yml +5 -4
  256. package/.bkit/templates/.husky/pre-commit +2 -2
  257. package/.bkit/templates/.husky/pre-push +96 -36
  258. package/.bkit/templates/.prettierignore +6 -0
  259. package/.bkit/templates/.vale.ini +27 -27
  260. package/.bkit/templates/context/bkit-cloudrun.md +23 -15
  261. package/.bkit/templates/context/bkit-expo.md +70 -52
  262. package/.bkit/templates/context/bkit-github.md +93 -56
  263. package/.bkit/templates/context/bkit-inngest.md +21 -15
  264. package/.bkit/templates/context/bkit-maestro.md +22 -16
  265. package/.bkit/templates/context/bkit-playwright.md +23 -17
  266. package/.bkit/templates/context/bkit-resend.md +12 -10
  267. package/.bkit/templates/context/bkit-sentry.md +30 -20
  268. package/.bkit/templates/context/bkit-serena.md +8 -7
  269. package/.bkit/templates/context/bkit-stripe.md +14 -13
  270. package/.bkit/templates/context/bkit-supabase.md +16 -13
  271. package/.bkit/templates/context/bkit-tavily.md +14 -11
  272. package/.bkit/templates/context/bkit-vercel.md +27 -18
  273. package/.bkit/templates/docs/capabilities.md +15 -14
  274. package/.bkit/templates/scripts/ci/{check-accepted-divergences.mjs → bkit-check-accepted-divergences.mjs} +6 -3
  275. package/.bkit/templates/scripts/ci/{check-accepted-divergences.test.mjs → bkit-check-accepted-divergences.test.mjs} +3 -3
  276. package/.bkit/templates/scripts/ci/{check-capstone.mjs → bkit-check-capstone.mjs} +2 -2
  277. package/.bkit/templates/scripts/ci/{check-capstone.test.mjs → bkit-check-capstone.test.mjs} +4 -4
  278. package/.bkit/templates/scripts/ci/{check-dependency-audit.mjs → bkit-check-dependency-audit.mjs} +103 -18
  279. package/.bkit/templates/scripts/ci/{check-dependency-audit.test.mjs → bkit-check-dependency-audit.test.mjs} +31 -3
  280. package/.bkit/templates/scripts/ci/bkit-machine-lock.sh +387 -0
  281. package/.bkit/templates/scripts/ci/bkit-test-awake.mjs +75 -0
  282. package/.bkit/templates/scripts/ci/bkit-test-awake.test.mjs +160 -0
  283. package/.bkit/templates/scripts/ci/lanes/{resolve-push-base.mjs → bkit-resolve-push-base.mjs} +3 -3
  284. package/.bkit/templates/scripts/ci/lanes/{resolve-push-base.test.mjs → bkit-resolve-push-base.test.mjs} +4 -4
  285. package/.bkit/templates/scripts/cleanup/bkit-disk-prune.mjs +10 -2
  286. package/.bkit/templates/scripts/graphify/bkit-graph-drift.py +1 -1
  287. package/.bkit/templates/scripts/graphify/bkit-graph-eager.py +3 -3
  288. package/.bkit/templates/scripts/graphify/bkit-graph-embed.py +63 -0
  289. package/.bkit/templates/scripts/graphify/bkit-graph-imports.py +2 -2
  290. package/.bkit/templates/scripts/graphify/bkit-graph-pre-push.sh +69 -18
  291. package/.bkit/templates/scripts/graphify/bkit-graph-repair.py +3 -3
  292. package/.bkit/templates/scripts/graphify/bkit-graph-surface.py +1 -1
  293. package/.bkit/templates/scripts/graphify/bkit-graphify-graphml.py +1 -1
  294. package/.bkit/templates/scripts/graphify/bkit-graphify-rollup.py +197 -126
  295. package/.bkit/templates/scripts/graphify/bkit-graphify.sh +64 -41
  296. package/.bkit/templates/scripts/slop/bkit-slop-type-suppression.mjs +23 -7
  297. package/.bkit/templates/slop-scan.config.json +9 -2
  298. package/CHANGELOG.md +231 -0
  299. package/README.md +278 -89
  300. package/dist/checks/after/auth.js +36 -33
  301. package/dist/checks/after/ci-yml.js +91 -30
  302. package/dist/checks/after/github.js +91 -17
  303. package/dist/checks/after/index.js +22 -11
  304. package/dist/checks/after/suppression.js +8 -5
  305. package/dist/checks/after/tools.js +111 -114
  306. package/dist/checks/before/context-fetch.js +218 -33
  307. package/dist/checks/before/env.js +3 -3
  308. package/dist/checks/before/files.js +5 -3
  309. package/dist/checks/before/index.js +20 -3
  310. package/dist/checks/before/repo.js +197 -2
  311. package/dist/checks/status-holes.js +739 -114
  312. package/dist/checks/tips/catalogue.js +70 -19
  313. package/dist/checks/tips/detect.js +62 -0
  314. package/dist/checks/tips/index.js +51 -9
  315. package/dist/cli.js +234 -124
  316. package/dist/commands/analysis.js +174 -141
  317. package/dist/commands/ci/ci.js +302 -25
  318. package/dist/commands/ci/pins.js +142 -0
  319. package/dist/commands/ci/push-gate.js +194 -0
  320. package/dist/commands/comply.js +54 -91
  321. package/dist/commands/install/doctor.js +2 -2
  322. package/dist/commands/install/install.js +50 -19
  323. package/dist/commands/install/uninstall.js +82 -55
  324. package/dist/commands/install/upgrade.js +21 -11
  325. package/dist/commands/land.js +137 -17
  326. package/dist/commands/lib.js +295 -21
  327. package/dist/commands/registry.js +10 -2
  328. package/dist/commands/setup/setup.js +8 -7
  329. package/dist/commands/stats.js +175 -0
  330. package/dist/commands/tips.js +7 -3
  331. package/dist/commands/workflow/branches.js +1873 -152
  332. package/dist/commands/workflow/challenge.js +609 -0
  333. package/dist/commands/workflow/completeness.js +97 -0
  334. package/dist/commands/workflow/context.js +1045 -46
  335. package/dist/commands/workflow/counters.js +385 -86
  336. package/dist/commands/workflow/decisions.js +484 -0
  337. package/dist/commands/workflow/disk.js +214 -56
  338. package/dist/commands/workflow/fids.js +706 -33
  339. package/dist/commands/workflow/issues.js +349 -59
  340. package/dist/commands/workflow/ledgers.js +1123 -37
  341. package/dist/commands/workflow/locks.js +26 -2
  342. package/dist/commands/workflow/plan-blocks.js +501 -0
  343. package/dist/commands/workflow/plan-versions.js +22 -0
  344. package/dist/commands/workflow/plans.js +205 -0
  345. package/dist/commands/workflow/prs.js +154 -35
  346. package/dist/commands/workflow/repo.js +58 -8
  347. package/dist/commands/workflow/roadmap.js +58 -23
  348. package/dist/commands/workflow/run-facts.js +421 -0
  349. package/dist/commands/workflow/runs.js +670 -72
  350. package/dist/commands/workflow/runtime.js +15 -1
  351. package/dist/commands/workflow/skills.js +1 -0
  352. package/dist/commands/workflow/status.js +282 -34
  353. package/dist/commands/workflow/step-table.js +308 -0
  354. package/dist/commands/workflow/steps.js +703 -96
  355. package/dist/commands/workflow/summary-findings.js +117 -0
  356. package/dist/commands/workflow/summary.js +388 -0
  357. package/dist/commands/workflow/tasks.js +378 -0
  358. package/dist/commands/workflow/test-blocks.js +231 -0
  359. package/dist/commands/workflow/tests-changed.js +172 -0
  360. package/dist/commands/workflow/tests.js +1695 -305
  361. package/dist/commands/workflow/tracker.js +983 -0
  362. package/dist/commands/workflow/workflows.js +1014 -222
  363. package/dist/commands/workflow/worktrees.js +432 -26
  364. package/dist/install/cloud-env.js +233 -99
  365. package/dist/install/context-ci-workflow.js +85 -0
  366. package/dist/install/manifest.js +64 -17
  367. package/dist/install/modules/antigravity.js +3 -2
  368. package/dist/install/modules/cloud.js +25 -16
  369. package/dist/install/modules/codex.js +12 -2
  370. package/dist/install/modules/core.js +1090 -48
  371. package/dist/install/modules/cursor.js +6 -6
  372. package/dist/install/modules/opencode.js +13 -7
  373. package/dist/install/template-notes.js +116 -0
  374. package/dist/install/version-file.js +9 -4
  375. package/dist/ledgers/compact.js +87 -0
  376. package/dist/ledgers/journal.js +233 -0
  377. package/dist/ledgers/migrate.js +81 -0
  378. package/dist/ledgers/status.js +176 -13
  379. package/dist/ledgers/telemetry.js +1010 -125
  380. package/dist/render/hosts.js +104 -14
  381. package/dist/render/models.js +12 -0
  382. package/dist/shared/bkit-latest.js +26 -4
  383. package/dist/shared/branches.js +3 -1
  384. package/dist/shared/dep-updater.js +49 -0
  385. package/dist/shared/egress.js +8 -1
  386. package/dist/shared/json.js +20 -7
  387. package/dist/shared/package-manager.js +6 -0
  388. package/dist/shared/settings.js +181 -24
  389. package/dist/shared/text.js +333 -0
  390. package/dist/shared/timeouts.js +2 -0
  391. package/dist/tools/cli-doc.js +97 -0
  392. package/dist/tools/grammar-density.js +183 -0
  393. package/dist/tools/instructions-sources.js +720 -0
  394. package/dist/tools/instructions.js +1623 -0
  395. package/package.json +156 -51
  396. package/.bkit/core/.bkit/lite.md +0 -73
  397. package/.bkit/core/engine/commands/harvest.ts +0 -459
  398. package/.bkit/core/engine/commands/workflow/workstreams.ts +0 -166
  399. package/.bkit/core/engine/tools/wording.ts +0 -748
  400. package/.bkit/core/prompts/bkit-build-challenge-reconcile.md +0 -69
  401. package/.bkit/core/prompts/bkit-build-challenge-remediate.md +0 -71
  402. package/.bkit/core/prompts/bkit-build-challenge-tests.md +0 -74
  403. package/.bkit/core/prompts/bkit-build-plan-execute.md +0 -76
  404. package/.bkit/core/prompts/bkit-build-summary.md +0 -94
  405. package/.bkit/core/prompts/bkit-debug-summary.md +0 -96
  406. package/.bkit/core/prompts/bkit-design-summary.md +0 -107
  407. package/.bkit/core/prompts/bkit-plan-complexity-check.md +0 -67
  408. package/.bkit/core/prompts/bkit-plan-complexity-split.md +0 -88
  409. package/.bkit/core/prompts/bkit-plan-review-3.md +0 -93
  410. package/.bkit/core/prompts/bkit-plan-scope-check-1.md +0 -85
  411. package/.bkit/core/prompts/bkit-plan-scope-check-2.md +0 -85
  412. package/.bkit/core/prompts/bkit-plan-summary.md +0 -107
  413. package/.bkit/core/prompts/bkit-ship-summary.md +0 -78
  414. package/.bkit/templates/scripts/ci/bkit-local-stack-lock.sh +0 -194
  415. package/dist/commands/harvest.js +0 -353
  416. package/dist/commands/workflow/workstreams.js +0 -143
  417. package/dist/tools/wording.js +0 -680
  418. /package/.bkit/templates/.vale/styles/{House → Bkit}/Filler.yml +0 -0
  419. /package/.bkit/templates/.vale/styles/{House → Bkit}/Hedging.yml +0 -0
  420. /package/.bkit/templates/.vale/styles/{House → Bkit}/LLMSlop.yml +0 -0
  421. /package/.bkit/templates/.vale/styles/{House → Bkit}/Verbose.yml +0 -0
  422. /package/.bkit/templates/scripts/ci/{accepted-advisories.json → bkit-accepted-advisories.json} +0 -0
  423. /package/.bkit/templates/scripts/ci/{accepted-divergences.json → bkit-accepted-divergences.json} +0 -0
  424. /package/.bkit/templates/scripts/launchd/{launchd.env.example → bkit-launchd.env.example} +0 -0
  425. /package/.bkit/templates/scripts/launchd/{ai.bkit.launchd.plist → bkit-launchd.plist} +0 -0
@@ -1,9 +1,9 @@
1
- <!-- Note: Reports live at `docs/audits/{YYYYMM}/{slug}.md`. `{YYYYMM}` = UTC month of this run. `{slug}` = template basename without `bkit-audit-` and `.md`. **If** that month already has `{slug}.md` or `{slug}-{TIMESTAMP}.md` → write `{slug}-{TIMESTAMP}.md` (`{TIMESTAMP}` = `date -u +%Y%m%dT%H%M%SZ`). Never overwrite. The report is stamped with a `bkit:anchor` block recording the audited commit (`baseSha`) and branch (`baseRef`); never hand-author or edit it. `@bkit-audit-generate` fills this template. -->
2
-
3
1
  <!-- bkit:start -->
4
2
 
5
3
  {{BKIT_MANAGED_MARKER}}
6
4
 
5
+ <!-- Note: @bkit-audit-generate fills this template. The report lives at `docs/audits/{YYYYMM}/{slug}.md`, where `{YYYYMM}` is the UTC month of the run and `{slug}` is this file's name without `bkit-audit-` and `.md`. **If** that month already has `{slug}.md` or `{slug}-{TIMESTAMP}.md` → write `{slug}-{TIMESTAMP}.md`, where `{TIMESTAMP}` is the output of `date -u +%Y%m%dT%H%M%SZ`. NEVER overwrite an earlier report. The report is stamped with a `bkit:anchor` block that records the audited commit (`baseSha`) and branch (`baseRef`). NEVER write or edit that block by hand. -->
6
+
7
7
  # Reliability Audit
8
8
 
9
9
  > [!CAUTION]
@@ -11,139 +11,138 @@
11
11
  >
12
12
  > **Rules:**
13
13
  >
14
- > - Read-only audit; never edit code, config, or data.
15
- > - `Universal Instructions` apply to all projects; `Project Instructions` apply only to this project.
16
- > - Local audit instructions / overrides → `Project Instructions` below the bkit-managed block; universal instructions stay in-block.
17
- > - Any tools mentioned in `Universal Instructions` are examples only; swap for actual tools in final output; drop inapplicable.
18
- > - Use dense token-efficient phrasing; no filler / hedging / restating; tables > prose, bullets > paragraphs.
19
- > - Read `.agents/docs.md` → load docs for workflow / step / task; skip missing; cite docs inline where required.
20
- > - Every claim cites this run's evidence (`file:line`, or command / query and its output) and tool behind it; a previous report's figure, list, or status is a lead, not evidence.
21
- > - Read this document once at session start; do not trust session memory; do not re-read on every loop iteration.
22
- > - never 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.
23
- > - 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.
24
17
 
25
18
  ## Universal Instructions
26
19
 
27
20
  ### Context & Goals
28
21
 
29
- 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.
30
23
 
31
- **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".
32
25
 
33
- **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.
34
27
 
35
- **Anchor Standards:** record version and date read. Newer version → `Standards` step reads what changed.
28
+ **Anchor Standards:**
36
29
 
37
30
  - Google SRE Workbook (online edition): Implementing SLOs, Alerting on SLOs (multi-window, multi-burn-rate), Example error budget policy.
38
31
  - Google SRE Book (online edition): Postmortem Culture.
39
- - 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.
40
- - Background-job flow-control docs (e.g. Inngest concurrency and `createFunction`, Temporal task queues).
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.
33
+ - Background-job flow-control docs (e.g., Inngest concurrency and `createFunction`, Temporal task queues).
41
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`)
42
35
 
43
36
  ### Scope
44
37
 
45
- - Outbound calls, webhook receivers, background work, write paths. Hard vs soft, including transitive dependencies.
46
- - Critical journeys, SLOs, error-budget policy.
47
- - Dropped errors, timeouts, retries, idempotency, races, unbounded work.
48
- - User-local time, where the product schedules.
49
- - What the user sees when a dependency is down; every dependency walked on paper; last game day recorded, not run.
50
- - Emergency levers, recovery targets, disaster paths.
51
- - 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.
52
48
 
53
49
  ### Out of Scope
54
50
 
55
51
  <!-- prettier-ignore -->
56
52
  | Excluded item | Why | Where it belongs |
57
53
  | --- | --- | --- |
58
- | Errors that already reached a log | That sweep reads them; this sweep is failures that never reach a log | `bkit-audit-logs` |
59
- | Grants, catalogue integrity, restore drill | Database sweep | `bkit-audit-database` |
60
- | Query plans and database-side limits | Database sweep | `bkit-audit-database` |
61
- | Live fault injection | Separate exercise, under that audit's rules | `bkit-audit-red-team` |
62
- | Prompt bounds, call limits, evals | LLM sweep | `bkit-audit-llm` |
63
- | Which model is called, deprecation, registry | Registry sweep | `bkit-audit-models` |
64
- | Copied wrappers as duplication | Duplication sweep | `bkit-audit-duplication` |
65
- | Adding a lint or test gate | Gates sweep | `bkit-audit-gates` |
66
- | Rewriting a doc that omits a surface | Docs sweep | `bkit-audit-documentation` |
67
- | Store-side version settings | Store sweep | `bkit-audit-app-store` |
68
- | Whether an outside caller is allowed to trigger a replay | Security sweep; this audit still reads idempotency | `bkit-audit-security` |
69
- | 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 |
70
66
 
71
67
  ### Pre-Flight / Dependencies
72
68
 
73
- **Checkpoint:** Check off all core items. Check conditional items only when applicable. Each item: available → tool and version; missing → fallback, gap in `Not Checked`, fix in `Process Improvements`. Unnamed gap reads as passed. never abort for a missing capability.
74
-
75
- **Credentials:** probe direnv before marking a token / env var missing: `direnv exec . sh -c '[ -n "${VAR}" ] && echo set || echo unset'`; `unset` = missing. Run credentialed CLIs as `direnv exec . <cmd>`. No direnv (cloud session) → plain env check. Report names, never values.
76
-
77
69
  #### Core
78
70
 
79
- Always verify.
80
-
81
- - [ ] **Permissions:** Before Step 1 — one cheap read-only call per tool this run uses (every item below, every rule under `Project Instructions` `Permissions`), e.g. `gh run list --limit 1`, one MCP read, one anchor-standard fetch. Blocked / denied (here or in any step) → record call verbatim and narrow allow rule clearing it (e.g. `Bash(gh run list *)`) in `Not Checked`, `Process Improvements`, and `Project Instructions` `Permissions`; run every step the remaining tools allow; work needing blocked call → `Not Checked`. never stop the run for a blocked call; never retry or reword a blocked call to get past it.
82
- - [ ] **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.
83
- - [ ] **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.
84
74
 
85
75
  #### Conditional
86
76
 
87
- Verify only when applicable.
88
-
89
- - [ ] **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`.
90
- - [ ] **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`.
91
- - [ ] **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`.
92
- - [ ] **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`.
93
81
 
94
82
  ### 🔒 Gate 1: Prerequisites Check
95
83
 
96
- **Checkpoint.** Verify and check `[x]` all applicable boxes above, then continue to `Probe Steps` without asking.
97
-
98
- - [ ] **Gaps named:** every missing item names its fallback and `Not Checked` entry.
99
- - [ ] **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.
100
86
 
101
87
  ### Probe Steps
102
88
 
103
- - [ ] **Step 1 — Previous Run:** Audited commit = this report's `bkit:anchor` `baseSha`. Read newest prior report for this slug under `docs/audits/`; its commit = its `bkit:anchor` `baseSha`, else the HEAD its `Previous Run` recorded. Count findings fixed / still open; age of oldest open. Open after 2 runs → re-raise with age. **Done when:** closure rate in `Previous Run`, or run marked baseline.
104
- - [ ] **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.
105
- - [ ] **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.
106
- - [ ] **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`.
107
- - [ ] **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 × 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.
108
- - [ ] **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.
109
- - [ ] **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.
110
- - [ ] **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.
111
- - [ ] **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`.
112
- - [ ] **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.
113
- - [ ] **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.
114
- - [ ] **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).
115
- - [ ] **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.
116
- - [ ] **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.
117
- - [ ] **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.
118
- - [ ] **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`.
119
118
 
120
119
  ### 🔒 Gate 2: Probes Check
121
120
 
122
- **Checkpoint.** Verify and check `[x]` all boxes below, then continue to `Findings` without asking.
123
-
124
- - [ ] **Steps complete:** every step `[x]`, or explicit skip with evidence the surface is absent.
125
- - [ ] **Evidence:** every finding cites re-checkable evidence and the tool behind it.
126
- - [ ] **Read-only:** no dependency taken down; no replay, send, charge, or restore executed; no alert or monitor changed.
127
- - [ ] **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.
128
127
 
129
128
  ## Findings
130
129
 
131
130
  <!-- prettier-ignore -->
132
131
  | Severity | Use |
133
132
  | --- | --- |
134
- | `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 |
135
- | `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 |
136
- | `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 |
137
- | `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 |
138
137
 
139
- Scale per `.bkit/jsonl.md` § Severity. 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.
140
139
 
141
140
  <!-- prettier-ignore -->
142
141
  | ID | Severity | Location | Evidence | Expected |
143
142
  | --- | --- | --- | --- | --- |
144
143
  | PENDING | PENDING | PENDING | PENDING | PENDING |
145
144
 
146
- Empty and clean → one row `None`.
145
+ **If** the run finds nothing → write one row: `None`.
147
146
 
148
147
  ## Report
149
148
 
@@ -216,18 +215,20 @@ PENDING
216
215
 
217
216
  ### 🔒 Gate 3: Report Check
218
217
 
219
- **Checkpoint.** Verify and check `[x]` all boxes below, then stop.
220
-
221
- - [ ] **No placeholders:** Findings table and every `Report` section have no `PENDING`.
222
- - [ ] **Summary:** names count per severity, journeys measured, and that every dependency was walked on paper.
223
- - [ ] **Series:** every series beside previous report's numbers, or marked baseline.
224
- - [ ] **Game Day:** states the date and outcome of the last game day, or that none is recorded, and names the next dependency.
225
- - [ ] **Writes:** only this report and template `Project Instructions` changed; throwaway worktrees / remote targets removed.
226
- - [ ] **Process Improvements:** `Universal` = proposed step changes, template untouched; `Project` = edits applied below `bkit:end`; each `none` if empty.
227
- - [ ] **Suggested Issues:** every `MEDIUM`+ finding ID in exactly one row; every row has a `Next Step`.
228
- - [ ] **Gate 3 - Verified:** Every checkbox above independently verified and checked off.
229
-
230
- > `Project Instructions` below `bkit:end` are consumer-owned — `bkit install` never overwrites them, `bkit check` drift stays clean. Add project-specific tools, paths, commands, and checks there, keyed by section or step title; never results.
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.
231
232
 
232
233
  <!-- bkit:end -->
233
234