@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.
- package/.bkit/README.md +167 -154
- package/.bkit/core/.agents/context.md +95 -29
- package/.bkit/core/.agents/docs.md +18 -15
- package/.bkit/core/.agents/plugins/bkit/hooks/bkit-gateguard.cjs +1 -0
- package/.bkit/core/.agents/plugins/bkit/hooks/bkit-guardrails.cjs +6 -5
- package/.bkit/core/.agents/plugins/bkit/hooks/bkit-readguard.cjs +1 -0
- package/.bkit/core/.agents/plugins/bkit/hooks/bkit-rules.cjs +65 -0
- package/.bkit/core/.agents/rules.md +112 -102
- package/.bkit/core/.agents/skills.md +63 -15
- package/.bkit/core/.bkit/README.md +167 -154
- package/.bkit/core/.bkit/authoring.md +747 -0
- package/.bkit/core/.bkit/cli.md +407 -0
- package/.bkit/core/.bkit/cloud.md +283 -195
- package/.bkit/core/.bkit/comparison.md +45 -43
- package/.bkit/core/.bkit/install.md +166 -95
- package/.bkit/core/.bkit/jsonl.md +339 -196
- package/.bkit/core/.bkit/pipeline.md +142 -145
- package/.bkit/core/.bkit/prompts.md +295 -264
- package/.bkit/core/.bkit/providers.md +460 -277
- package/.bkit/core/.bkit/router.md +69 -0
- package/.bkit/core/.bkit/templates.md +530 -256
- package/.bkit/core/.bkit/trackers.md +116 -65
- package/.bkit/core/.bkit/workflows.md +742 -618
- package/.bkit/core/.claude/hooks/bkit-gateguard.cjs +2 -2
- package/.bkit/core/.claude/hooks/bkit-guardrails.cjs +3 -3
- package/.bkit/core/.claude/hooks/bkit-preflight.sh +45 -14
- package/.bkit/core/.codex/hooks/bkit-guardrails.cjs +3 -3
- package/.bkit/core/.codex/hooks/bkit-rules.cjs +57 -0
- package/.bkit/core/.cursor/hooks/bkit-guardrails.cjs +7 -7
- package/.bkit/core/.cursor/hooks/bkit-preflight.sh +47 -12
- package/.bkit/core/.opencode/plugin/bkit-rules.js +89 -0
- package/.bkit/core/AGENTS.md +6 -80
- package/.bkit/core/docs/templates/bkit-audit-accessibility.md +128 -130
- package/.bkit/core/docs/templates/bkit-audit-adoption.md +104 -94
- package/.bkit/core/docs/templates/bkit-audit-agents.md +96 -98
- package/.bkit/core/docs/templates/bkit-audit-aio-seo.md +100 -103
- package/.bkit/core/docs/templates/bkit-audit-analytics.md +141 -107
- package/.bkit/core/docs/templates/bkit-audit-annotations.md +99 -97
- package/.bkit/core/docs/templates/bkit-audit-app-performance.md +122 -121
- package/.bkit/core/docs/templates/bkit-audit-app-store.md +158 -101
- package/.bkit/core/docs/templates/bkit-audit-architecture.md +114 -96
- package/.bkit/core/docs/templates/bkit-audit-ci-performance.md +76 -97
- package/.bkit/core/docs/templates/bkit-audit-config.md +123 -101
- package/.bkit/core/docs/templates/bkit-audit-cost.md +86 -99
- package/.bkit/core/docs/templates/bkit-audit-coverage.md +76 -93
- package/.bkit/core/docs/templates/bkit-audit-database.md +102 -95
- package/.bkit/core/docs/templates/bkit-audit-dead-code.md +165 -108
- package/.bkit/core/docs/templates/bkit-audit-deferrals.md +115 -109
- package/.bkit/core/docs/templates/bkit-audit-dependencies.md +265 -113
- package/.bkit/core/docs/templates/bkit-audit-documentation.md +119 -118
- package/.bkit/core/docs/templates/bkit-audit-duplication.md +140 -111
- package/.bkit/core/docs/templates/bkit-audit-failures.md +111 -106
- package/.bkit/core/docs/templates/bkit-audit-flakes.md +100 -99
- package/.bkit/core/docs/templates/bkit-audit-gates.md +107 -103
- package/.bkit/core/docs/templates/bkit-audit-issues.md +105 -105
- package/.bkit/core/docs/templates/bkit-audit-llm.md +134 -85
- package/.bkit/core/docs/templates/bkit-audit-logs.md +124 -125
- package/.bkit/core/docs/templates/bkit-audit-models.md +99 -78
- package/.bkit/core/docs/templates/bkit-audit-privacy.md +56 -76
- package/.bkit/core/docs/templates/bkit-audit-prompts.md +63 -78
- package/.bkit/core/docs/templates/bkit-audit-red-team.md +125 -93
- package/.bkit/core/docs/templates/bkit-audit-reliability.md +97 -96
- package/.bkit/core/docs/templates/bkit-audit-repo.md +170 -98
- package/.bkit/core/docs/templates/bkit-audit-security.md +207 -121
- package/.bkit/core/docs/templates/bkit-audit-slop.md +78 -95
- package/.bkit/core/docs/templates/bkit-audit-testing.md +163 -139
- package/.bkit/core/docs/templates/bkit-audit-usability.md +114 -96
- package/.bkit/core/docs/templates/bkit-plan.md +158 -281
- package/.bkit/core/engine/checks/after/auth.ts +40 -37
- package/.bkit/core/engine/checks/after/ci-yml.ts +104 -31
- package/.bkit/core/engine/checks/after/github.ts +95 -17
- package/.bkit/core/engine/checks/after/index.ts +21 -8
- package/.bkit/core/engine/checks/after/suppression.ts +8 -5
- package/.bkit/core/engine/checks/after/tools.ts +125 -123
- package/.bkit/core/engine/checks/before/context-fetch.ts +227 -33
- package/.bkit/core/engine/checks/before/env.ts +3 -3
- package/.bkit/core/engine/checks/before/files.ts +5 -4
- package/.bkit/core/engine/checks/before/index.ts +25 -1
- package/.bkit/core/engine/checks/before/repo.ts +208 -2
- package/.bkit/core/engine/checks/status-holes.ts +916 -123
- package/.bkit/core/engine/checks/tips/catalogue.ts +82 -20
- package/.bkit/core/engine/checks/tips/detect.ts +66 -0
- package/.bkit/core/engine/checks/tips/index.ts +52 -11
- package/.bkit/core/engine/cli.ts +251 -130
- package/.bkit/core/engine/commands/analysis.ts +282 -199
- package/.bkit/core/engine/commands/ci/ci.ts +363 -29
- package/.bkit/core/engine/commands/ci/pins.ts +172 -0
- package/.bkit/core/engine/commands/ci/push-gate.ts +223 -0
- package/.bkit/core/engine/commands/comply.ts +77 -103
- package/.bkit/core/engine/commands/install/doctor.ts +2 -2
- package/.bkit/core/engine/commands/install/install.ts +57 -18
- package/.bkit/core/engine/commands/install/uninstall.ts +86 -55
- package/.bkit/core/engine/commands/install/upgrade.ts +32 -15
- package/.bkit/core/engine/commands/land.ts +139 -18
- package/.bkit/core/engine/commands/lib.ts +381 -22
- package/.bkit/core/engine/commands/registry.ts +10 -2
- package/.bkit/core/engine/commands/setup/setup.ts +8 -7
- package/.bkit/core/engine/commands/stats.ts +260 -0
- package/.bkit/core/engine/commands/tips.ts +10 -5
- package/.bkit/core/engine/commands/workflow/branches.ts +2215 -176
- package/.bkit/core/engine/commands/workflow/challenge.ts +748 -0
- package/.bkit/core/engine/commands/workflow/completeness.ts +109 -0
- package/.bkit/core/engine/commands/workflow/context.ts +1249 -47
- package/.bkit/core/engine/commands/workflow/counters.ts +483 -95
- package/.bkit/core/engine/commands/workflow/decisions.ts +585 -0
- package/.bkit/core/engine/commands/workflow/disk.ts +238 -56
- package/.bkit/core/engine/commands/workflow/fids.ts +811 -33
- package/.bkit/core/engine/commands/workflow/issues.ts +413 -64
- package/.bkit/core/engine/commands/workflow/ledgers.ts +1333 -36
- package/.bkit/core/engine/commands/workflow/locks.ts +28 -2
- package/.bkit/core/engine/commands/workflow/plan-blocks.ts +691 -0
- package/.bkit/core/engine/commands/workflow/plan-versions.ts +21 -0
- package/.bkit/core/engine/commands/workflow/plans.ts +257 -0
- package/.bkit/core/engine/commands/workflow/prs.ts +178 -33
- package/.bkit/core/engine/commands/workflow/repo.ts +66 -8
- package/.bkit/core/engine/commands/workflow/roadmap.ts +72 -22
- package/.bkit/core/engine/commands/workflow/run-facts.ts +492 -0
- package/.bkit/core/engine/commands/workflow/runs.ts +827 -79
- package/.bkit/core/engine/commands/workflow/runtime.ts +25 -1
- package/.bkit/core/engine/commands/workflow/skills.ts +1 -0
- package/.bkit/core/engine/commands/workflow/status.ts +329 -33
- package/.bkit/core/engine/commands/workflow/step-table.ts +381 -0
- package/.bkit/core/engine/commands/workflow/steps.ts +841 -105
- package/.bkit/core/engine/commands/workflow/summary-findings.ts +177 -0
- package/.bkit/core/engine/commands/workflow/summary.ts +544 -0
- package/.bkit/core/engine/commands/workflow/tasks.ts +409 -0
- package/.bkit/core/engine/commands/workflow/test-blocks.ts +254 -0
- package/.bkit/core/engine/commands/workflow/tests-changed.ts +201 -0
- package/.bkit/core/engine/commands/workflow/tests.ts +2124 -330
- package/.bkit/core/engine/commands/workflow/tracker.ts +1195 -0
- package/.bkit/core/engine/commands/workflow/workflows.ts +1197 -235
- package/.bkit/core/engine/commands/workflow/worktrees.ts +543 -24
- package/.bkit/core/engine/install/cloud-env.ts +251 -121
- package/.bkit/core/engine/install/context-ci-workflow.ts +102 -0
- package/.bkit/core/engine/install/manifest.ts +67 -17
- package/.bkit/core/engine/install/modules/antigravity.ts +3 -2
- package/.bkit/core/engine/install/modules/cloud.ts +24 -16
- package/.bkit/core/engine/install/modules/codex.ts +15 -2
- package/.bkit/core/engine/install/modules/core.ts +1196 -45
- package/.bkit/core/engine/install/modules/cursor.ts +6 -6
- package/.bkit/core/engine/install/modules/opencode.ts +18 -6
- package/.bkit/core/engine/install/template-notes.ts +130 -0
- package/.bkit/core/engine/install/version-file.ts +9 -4
- package/.bkit/core/engine/install/write.ts +5 -0
- package/.bkit/core/engine/ledgers/compact.ts +124 -0
- package/.bkit/core/engine/ledgers/journal.ts +291 -0
- package/.bkit/core/engine/ledgers/migrate.ts +92 -0
- package/.bkit/core/engine/ledgers/status.ts +249 -21
- package/.bkit/core/engine/ledgers/telemetry.ts +1397 -253
- package/.bkit/core/engine/render/hosts.ts +118 -14
- package/.bkit/core/engine/render/models.ts +12 -0
- package/.bkit/core/engine/shared/bkit-latest.ts +26 -4
- package/.bkit/core/engine/shared/branches.ts +4 -1
- package/.bkit/core/engine/shared/dep-updater.ts +60 -0
- package/.bkit/core/engine/shared/egress.ts +8 -1
- package/.bkit/core/engine/shared/json.ts +25 -7
- package/.bkit/core/engine/shared/package-manager.ts +9 -0
- package/.bkit/core/engine/shared/settings.ts +243 -31
- package/.bkit/core/engine/shared/text.ts +361 -0
- package/.bkit/core/engine/shared/timeouts.ts +2 -0
- package/.bkit/core/engine/tools/cli-doc.ts +111 -0
- package/.bkit/core/engine/tools/grammar-density.ts +215 -0
- package/.bkit/core/engine/tools/instructions-sources.ts +832 -0
- package/.bkit/core/engine/tools/instructions.ts +1802 -0
- package/.bkit/core/hooks/antigravity-hook.js +25 -10
- package/.bkit/core/hooks/gateguard-engine.js +54 -29
- package/.bkit/core/hooks/guardrails-shell.js +4 -5
- package/.bkit/core/hooks/guardrails-tiers.js +10 -4
- package/.bkit/core/hooks/preflight-linear.sh +9 -9
- package/.bkit/core/hooks/preflight-rules.sh +8 -0
- package/.bkit/core/hooks/readguard-engine.js +29 -10
- package/.bkit/core/hooks/session-rules-advisory.js +61 -0
- package/.bkit/core/prompts/bkit-audit-generate.md +202 -94
- package/.bkit/core/prompts/bkit-build-challenge-1.md +76 -34
- package/.bkit/core/prompts/bkit-build-challenge-2.md +85 -38
- package/.bkit/core/prompts/bkit-build-install-skills.md +50 -28
- package/.bkit/core/prompts/bkit-build-plan-convert.md +85 -0
- package/.bkit/core/prompts/bkit-build-plan-current.md +59 -36
- package/.bkit/core/prompts/bkit-build-plan-gaps-remediate.md +101 -36
- package/.bkit/core/prompts/bkit-build-plan-tasks.md +149 -0
- package/.bkit/core/prompts/bkit-build-plan-tests.md +120 -0
- package/.bkit/core/prompts/bkit-build-plan-verify.md +104 -43
- package/.bkit/core/prompts/bkit-debug-abort-handover.md +47 -32
- package/.bkit/core/prompts/bkit-debug-failure-diagnose.md +109 -57
- package/.bkit/core/prompts/bkit-debug-failure-remediate.md +65 -39
- package/.bkit/core/prompts/bkit-debug-failure-reproduce.md +53 -31
- package/.bkit/core/prompts/bkit-debug-failure-soak.md +65 -34
- package/.bkit/core/prompts/bkit-design-brainstorm-ideate-1.md +46 -31
- package/.bkit/core/prompts/bkit-design-brainstorm-ideate-2.md +45 -31
- package/.bkit/core/prompts/bkit-design-brainstorm-ideate-3.md +43 -30
- package/.bkit/core/prompts/bkit-design-generate.md +80 -46
- package/.bkit/core/prompts/bkit-design-organise.md +83 -32
- package/.bkit/core/prompts/bkit-design-review-1.md +70 -50
- package/.bkit/core/prompts/bkit-design-review-2.md +65 -46
- package/.bkit/core/prompts/bkit-design-spike.md +64 -40
- package/.bkit/core/prompts/bkit-design-update.md +53 -28
- package/.bkit/core/prompts/bkit-plan-generate.md +101 -29
- package/.bkit/core/prompts/bkit-plan-review-1.md +78 -41
- package/.bkit/core/prompts/bkit-plan-review-2.md +78 -35
- package/.bkit/core/prompts/bkit-plan-scope-check.md +116 -0
- package/.bkit/core/prompts/bkit-plan-update.md +86 -31
- package/.bkit/core/prompts/bkit-ship-conflict-resolve.md +94 -50
- package/.bkit/core/prompts/bkit-ship-deferred-sweep.md +91 -41
- package/.bkit/core/prompts/bkit-ship-update-docs.md +45 -24
- package/.bkit/core/prompts/bkit-utility-compress-markdown.md +65 -49
- package/.bkit/core/prompts/bkit-utility-update-decisions.md +87 -42
- package/.bkit/core/prompts/bkit-utility-update-deferrals.md +81 -37
- package/.bkit/core/prompts/bkit-utility-update-documentation.md +43 -25
- package/.bkit/core/prompts/bkit-utility-update-failures.md +84 -37
- package/.bkit/core/prompts/bkit-utility-update-knowledge.md +88 -42
- package/.bkit/core/prompts/bkit-utility-update-roadmap.md +92 -39
- package/.bkit/core/prompts/bkit-utility-update-tracker.md +159 -60
- package/.bkit/core/workflows/bkit-auto.md +89 -58
- package/.bkit/core/workflows/bkit-build.md +967 -517
- package/.bkit/core/workflows/bkit-debug.md +555 -387
- package/.bkit/core/workflows/bkit-design.md +319 -283
- package/.bkit/core/workflows/bkit-plan.md +319 -342
- package/.bkit/core/workflows/bkit-ship.md +525 -328
- package/.bkit/shared/.agents/plugins/bkit/hooks.json +10 -0
- package/.bkit/shared/.bkit/.env.example +2 -2
- package/.bkit/shared/.claude/bkit-cloud.md +12 -10
- package/.bkit/shared/.claude/settings.json +14 -0
- package/.bkit/shared/.codex/bkit-cloud.md +98 -0
- package/.bkit/shared/.codex/hooks.json +20 -0
- package/.bkit/shared/.cursor/bkit-cloud.md +3 -3
- package/.bkit/shared/.cursor/mcp.json +1 -1
- package/.bkit/shared/.cursor/rules/bkit-rules.mdc +1 -1
- package/.bkit/shared/.gitattributes +1 -1
- package/.bkit/shared/.mcp.json +1 -1
- package/.bkit/shared/.opencode/opencode.json +12 -1
- package/.bkit/shared/CLAUDE.md +6 -2
- package/.bkit/shared/GEMINI.md +5 -2
- package/.bkit/shared/docs/architecture.md +4 -7
- package/.bkit/shared/docs/data-schema.md +4 -7
- package/.bkit/shared/docs/deployments.md +241 -168
- package/.bkit/shared/docs/design.md +11 -12
- package/.bkit/shared/docs/noise.md +8 -7
- package/.bkit/shared/docs/observability.md +5 -8
- package/.bkit/shared/docs/security.md +35 -17
- package/.bkit/shared/docs/setup.md +29 -18
- package/.bkit/shared/docs/technology.md +3 -6
- package/.bkit/shared/docs/testing.md +289 -174
- package/.bkit/shared/gitignore +6 -2
- package/.bkit/templates/.claude/hooks/bkit-cloud-bootstrap.sh +15 -16
- package/.bkit/templates/.cursor/Dockerfile +12 -8
- package/.bkit/templates/.cursor/environment.json +1 -1
- package/.bkit/templates/.github/ISSUE_TEMPLATE/bkit-bug.yml +10 -8
- package/.bkit/templates/.github/ISSUE_TEMPLATE/bkit-change.yml +45 -12
- package/.bkit/templates/.github/ISSUE_TEMPLATE/bkit-idea.yml +3 -3
- package/.bkit/templates/.github/renovate.json5 +34 -6
- package/.bkit/templates/.github/workflows/bkit-ci.yml +54 -51
- package/.bkit/templates/.github/workflows/bkit-cloud.yml +34 -33
- package/.bkit/templates/.github/workflows/bkit-health.yml +97 -0
- package/.bkit/templates/.github/workflows/bkit-renovate.yml +5 -4
- package/.bkit/templates/.github/workflows/bkit-trivy.yml +5 -4
- package/.bkit/templates/.husky/pre-commit +2 -2
- package/.bkit/templates/.husky/pre-push +96 -36
- package/.bkit/templates/.prettierignore +6 -0
- package/.bkit/templates/.vale.ini +27 -27
- package/.bkit/templates/context/bkit-cloudrun.md +23 -15
- package/.bkit/templates/context/bkit-expo.md +70 -52
- package/.bkit/templates/context/bkit-github.md +93 -56
- package/.bkit/templates/context/bkit-inngest.md +21 -15
- package/.bkit/templates/context/bkit-maestro.md +22 -16
- package/.bkit/templates/context/bkit-playwright.md +23 -17
- package/.bkit/templates/context/bkit-resend.md +12 -10
- package/.bkit/templates/context/bkit-sentry.md +30 -20
- package/.bkit/templates/context/bkit-serena.md +8 -7
- package/.bkit/templates/context/bkit-stripe.md +14 -13
- package/.bkit/templates/context/bkit-supabase.md +16 -13
- package/.bkit/templates/context/bkit-tavily.md +14 -11
- package/.bkit/templates/context/bkit-vercel.md +27 -18
- package/.bkit/templates/docs/capabilities.md +15 -14
- package/.bkit/templates/scripts/ci/{check-accepted-divergences.mjs → bkit-check-accepted-divergences.mjs} +6 -3
- package/.bkit/templates/scripts/ci/{check-accepted-divergences.test.mjs → bkit-check-accepted-divergences.test.mjs} +3 -3
- package/.bkit/templates/scripts/ci/{check-capstone.mjs → bkit-check-capstone.mjs} +2 -2
- package/.bkit/templates/scripts/ci/{check-capstone.test.mjs → bkit-check-capstone.test.mjs} +4 -4
- package/.bkit/templates/scripts/ci/{check-dependency-audit.mjs → bkit-check-dependency-audit.mjs} +103 -18
- package/.bkit/templates/scripts/ci/{check-dependency-audit.test.mjs → bkit-check-dependency-audit.test.mjs} +31 -3
- package/.bkit/templates/scripts/ci/bkit-machine-lock.sh +387 -0
- package/.bkit/templates/scripts/ci/bkit-test-awake.mjs +75 -0
- package/.bkit/templates/scripts/ci/bkit-test-awake.test.mjs +160 -0
- package/.bkit/templates/scripts/ci/lanes/{resolve-push-base.mjs → bkit-resolve-push-base.mjs} +3 -3
- package/.bkit/templates/scripts/ci/lanes/{resolve-push-base.test.mjs → bkit-resolve-push-base.test.mjs} +4 -4
- package/.bkit/templates/scripts/cleanup/bkit-disk-prune.mjs +10 -2
- package/.bkit/templates/scripts/graphify/bkit-graph-drift.py +1 -1
- package/.bkit/templates/scripts/graphify/bkit-graph-eager.py +3 -3
- package/.bkit/templates/scripts/graphify/bkit-graph-embed.py +63 -0
- package/.bkit/templates/scripts/graphify/bkit-graph-imports.py +2 -2
- package/.bkit/templates/scripts/graphify/bkit-graph-pre-push.sh +69 -18
- package/.bkit/templates/scripts/graphify/bkit-graph-repair.py +3 -3
- package/.bkit/templates/scripts/graphify/bkit-graph-surface.py +1 -1
- package/.bkit/templates/scripts/graphify/bkit-graphify-graphml.py +1 -1
- package/.bkit/templates/scripts/graphify/bkit-graphify-rollup.py +197 -126
- package/.bkit/templates/scripts/graphify/bkit-graphify.sh +64 -41
- package/.bkit/templates/scripts/slop/bkit-slop-type-suppression.mjs +23 -7
- package/.bkit/templates/slop-scan.config.json +9 -2
- package/CHANGELOG.md +231 -0
- package/README.md +278 -89
- package/dist/checks/after/auth.js +36 -33
- package/dist/checks/after/ci-yml.js +91 -30
- package/dist/checks/after/github.js +91 -17
- package/dist/checks/after/index.js +22 -11
- package/dist/checks/after/suppression.js +8 -5
- package/dist/checks/after/tools.js +111 -114
- package/dist/checks/before/context-fetch.js +218 -33
- package/dist/checks/before/env.js +3 -3
- package/dist/checks/before/files.js +5 -3
- package/dist/checks/before/index.js +20 -3
- package/dist/checks/before/repo.js +197 -2
- package/dist/checks/status-holes.js +739 -114
- package/dist/checks/tips/catalogue.js +70 -19
- package/dist/checks/tips/detect.js +62 -0
- package/dist/checks/tips/index.js +51 -9
- package/dist/cli.js +234 -124
- package/dist/commands/analysis.js +174 -141
- package/dist/commands/ci/ci.js +302 -25
- package/dist/commands/ci/pins.js +142 -0
- package/dist/commands/ci/push-gate.js +194 -0
- package/dist/commands/comply.js +54 -91
- package/dist/commands/install/doctor.js +2 -2
- package/dist/commands/install/install.js +50 -19
- package/dist/commands/install/uninstall.js +82 -55
- package/dist/commands/install/upgrade.js +21 -11
- package/dist/commands/land.js +137 -17
- package/dist/commands/lib.js +295 -21
- package/dist/commands/registry.js +10 -2
- package/dist/commands/setup/setup.js +8 -7
- package/dist/commands/stats.js +175 -0
- package/dist/commands/tips.js +7 -3
- package/dist/commands/workflow/branches.js +1873 -152
- package/dist/commands/workflow/challenge.js +609 -0
- package/dist/commands/workflow/completeness.js +97 -0
- package/dist/commands/workflow/context.js +1045 -46
- package/dist/commands/workflow/counters.js +385 -86
- package/dist/commands/workflow/decisions.js +484 -0
- package/dist/commands/workflow/disk.js +214 -56
- package/dist/commands/workflow/fids.js +706 -33
- package/dist/commands/workflow/issues.js +349 -59
- package/dist/commands/workflow/ledgers.js +1123 -37
- package/dist/commands/workflow/locks.js +26 -2
- package/dist/commands/workflow/plan-blocks.js +501 -0
- package/dist/commands/workflow/plan-versions.js +22 -0
- package/dist/commands/workflow/plans.js +205 -0
- package/dist/commands/workflow/prs.js +154 -35
- package/dist/commands/workflow/repo.js +58 -8
- package/dist/commands/workflow/roadmap.js +58 -23
- package/dist/commands/workflow/run-facts.js +421 -0
- package/dist/commands/workflow/runs.js +670 -72
- package/dist/commands/workflow/runtime.js +15 -1
- package/dist/commands/workflow/skills.js +1 -0
- package/dist/commands/workflow/status.js +282 -34
- package/dist/commands/workflow/step-table.js +308 -0
- package/dist/commands/workflow/steps.js +703 -96
- package/dist/commands/workflow/summary-findings.js +117 -0
- package/dist/commands/workflow/summary.js +388 -0
- package/dist/commands/workflow/tasks.js +378 -0
- package/dist/commands/workflow/test-blocks.js +231 -0
- package/dist/commands/workflow/tests-changed.js +172 -0
- package/dist/commands/workflow/tests.js +1695 -305
- package/dist/commands/workflow/tracker.js +983 -0
- package/dist/commands/workflow/workflows.js +1014 -222
- package/dist/commands/workflow/worktrees.js +432 -26
- package/dist/install/cloud-env.js +233 -99
- package/dist/install/context-ci-workflow.js +85 -0
- package/dist/install/manifest.js +64 -17
- package/dist/install/modules/antigravity.js +3 -2
- package/dist/install/modules/cloud.js +25 -16
- package/dist/install/modules/codex.js +12 -2
- package/dist/install/modules/core.js +1090 -48
- package/dist/install/modules/cursor.js +6 -6
- package/dist/install/modules/opencode.js +13 -7
- package/dist/install/template-notes.js +116 -0
- package/dist/install/version-file.js +9 -4
- package/dist/ledgers/compact.js +87 -0
- package/dist/ledgers/journal.js +233 -0
- package/dist/ledgers/migrate.js +81 -0
- package/dist/ledgers/status.js +176 -13
- package/dist/ledgers/telemetry.js +1010 -125
- package/dist/render/hosts.js +104 -14
- package/dist/render/models.js +12 -0
- package/dist/shared/bkit-latest.js +26 -4
- package/dist/shared/branches.js +3 -1
- package/dist/shared/dep-updater.js +49 -0
- package/dist/shared/egress.js +8 -1
- package/dist/shared/json.js +20 -7
- package/dist/shared/package-manager.js +6 -0
- package/dist/shared/settings.js +181 -24
- package/dist/shared/text.js +333 -0
- package/dist/shared/timeouts.js +2 -0
- package/dist/tools/cli-doc.js +97 -0
- package/dist/tools/grammar-density.js +183 -0
- package/dist/tools/instructions-sources.js +720 -0
- package/dist/tools/instructions.js +1623 -0
- package/package.json +156 -51
- package/.bkit/core/.bkit/lite.md +0 -73
- package/.bkit/core/engine/commands/harvest.ts +0 -459
- package/.bkit/core/engine/commands/workflow/workstreams.ts +0 -166
- package/.bkit/core/engine/tools/wording.ts +0 -748
- package/.bkit/core/prompts/bkit-build-challenge-reconcile.md +0 -69
- package/.bkit/core/prompts/bkit-build-challenge-remediate.md +0 -71
- package/.bkit/core/prompts/bkit-build-challenge-tests.md +0 -74
- package/.bkit/core/prompts/bkit-build-plan-execute.md +0 -76
- package/.bkit/core/prompts/bkit-build-summary.md +0 -94
- package/.bkit/core/prompts/bkit-debug-summary.md +0 -96
- package/.bkit/core/prompts/bkit-design-summary.md +0 -107
- package/.bkit/core/prompts/bkit-plan-complexity-check.md +0 -67
- package/.bkit/core/prompts/bkit-plan-complexity-split.md +0 -88
- package/.bkit/core/prompts/bkit-plan-review-3.md +0 -93
- package/.bkit/core/prompts/bkit-plan-scope-check-1.md +0 -85
- package/.bkit/core/prompts/bkit-plan-scope-check-2.md +0 -85
- package/.bkit/core/prompts/bkit-plan-summary.md +0 -107
- package/.bkit/core/prompts/bkit-ship-summary.md +0 -78
- package/.bkit/templates/scripts/ci/bkit-local-stack-lock.sh +0 -194
- package/dist/commands/harvest.js +0 -353
- package/dist/commands/workflow/workstreams.js +0 -143
- package/dist/tools/wording.js +0 -680
- /package/.bkit/templates/.vale/styles/{House → Bkit}/Filler.yml +0 -0
- /package/.bkit/templates/.vale/styles/{House → Bkit}/Hedging.yml +0 -0
- /package/.bkit/templates/.vale/styles/{House → Bkit}/LLMSlop.yml +0 -0
- /package/.bkit/templates/.vale/styles/{House → Bkit}/Verbose.yml +0 -0
- /package/.bkit/templates/scripts/ci/{accepted-advisories.json → bkit-accepted-advisories.json} +0 -0
- /package/.bkit/templates/scripts/ci/{accepted-divergences.json → bkit-accepted-divergences.json} +0 -0
- /package/.bkit/templates/scripts/launchd/{launchd.env.example → bkit-launchd.env.example} +0 -0
- /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
|
-
> -
|
|
15
|
-
> -
|
|
16
|
-
> -
|
|
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
|
|
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
|
|
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:**
|
|
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:**
|
|
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
|
|
40
|
-
- Background-job flow-control docs (e.g
|
|
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
|
-
-
|
|
46
|
-
-
|
|
47
|
-
-
|
|
48
|
-
-
|
|
49
|
-
-
|
|
50
|
-
-
|
|
51
|
-
-
|
|
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
|
|
59
|
-
| Grants, catalogue integrity, restore drill |
|
|
60
|
-
| Query plans and database-side limits |
|
|
61
|
-
| Live fault injection |
|
|
62
|
-
| Prompt bounds, call limits, evals | LLM sweep | `bkit-audit-llm` |
|
|
63
|
-
| Which model is called, deprecation, registry |
|
|
64
|
-
| Copied wrappers as duplication |
|
|
65
|
-
| Adding a lint or test gate |
|
|
66
|
-
| Rewriting a doc that omits a surface |
|
|
67
|
-
| Store-side version settings |
|
|
68
|
-
| Whether an outside caller is allowed to trigger a replay |
|
|
69
|
-
| Changing code, alerts, or monitors |
|
|
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
|
-
|
|
80
|
-
|
|
81
|
-
- [ ] **
|
|
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
|
-
|
|
88
|
-
|
|
89
|
-
- [ ] **
|
|
90
|
-
- [ ] **
|
|
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
|
-
|
|
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:**
|
|
104
|
-
- [ ] **Step 2 — Surfaces:**
|
|
105
|
-
- [ ] **Step 3 — Journeys:**
|
|
106
|
-
- [ ] **Step 4 — Dropped Errors:**
|
|
107
|
-
- [ ] **Step 5 — Timeouts:**
|
|
108
|
-
-
|
|
109
|
-
-
|
|
110
|
-
-
|
|
111
|
-
-
|
|
112
|
-
-
|
|
113
|
-
-
|
|
114
|
-
-
|
|
115
|
-
-
|
|
116
|
-
-
|
|
117
|
-
-
|
|
118
|
-
|
|
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
|
-
**
|
|
123
|
-
|
|
124
|
-
- [ ] **
|
|
125
|
-
- [ ] **
|
|
126
|
-
- [ ] **
|
|
127
|
-
- [ ] **Gate 2
|
|
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` |
|
|
135
|
-
| `HIGH` |
|
|
136
|
-
| `MEDIUM` |
|
|
137
|
-
| `LOW` |
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
**
|
|
220
|
-
|
|
221
|
-
- [ ] **
|
|
222
|
-
- [ ] **
|
|
223
|
-
- [ ] **Series:** every series beside previous report's numbers, or
|
|
224
|
-
- [ ] **Game Day:** states the date
|
|
225
|
-
- [ ] **
|
|
226
|
-
- [ ] **
|
|
227
|
-
- [ ] **
|
|
228
|
-
- [ ] **
|
|
229
|
-
|
|
230
|
-
|
|
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
|
|