@cbartens/bkit 6.0.0 → 6.1.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.bkit/README.md +154 -151
- package/.bkit/core/.agents/context.md +95 -29
- package/.bkit/core/.agents/docs.md +17 -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 +108 -107
- package/.bkit/core/.agents/skills.md +63 -15
- package/.bkit/core/.bkit/README.md +154 -151
- package/.bkit/core/.bkit/authoring.md +714 -84
- package/.bkit/core/.bkit/cli.md +407 -0
- package/.bkit/core/.bkit/cloud.md +281 -193
- package/.bkit/core/.bkit/comparison.md +43 -41
- package/.bkit/core/.bkit/install.md +154 -84
- package/.bkit/core/.bkit/jsonl.md +193 -130
- package/.bkit/core/.bkit/pipeline.md +114 -114
- package/.bkit/core/.bkit/prompts.md +272 -165
- package/.bkit/core/.bkit/providers.md +457 -271
- package/.bkit/core/.bkit/router.md +69 -0
- package/.bkit/core/.bkit/templates.md +529 -256
- package/.bkit/core/.bkit/trackers.md +80 -52
- package/.bkit/core/.bkit/workflows.md +589 -504
- 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 +5 -73
- package/.bkit/core/docs/templates/bkit-audit-accessibility.md +127 -105
- package/.bkit/core/docs/templates/bkit-audit-adoption.md +104 -70
- package/.bkit/core/docs/templates/bkit-audit-agents.md +94 -72
- package/.bkit/core/docs/templates/bkit-audit-aio-seo.md +99 -78
- package/.bkit/core/docs/templates/bkit-audit-analytics.md +140 -82
- package/.bkit/core/docs/templates/bkit-audit-annotations.md +98 -72
- package/.bkit/core/docs/templates/bkit-audit-app-performance.md +121 -96
- package/.bkit/core/docs/templates/bkit-audit-app-store.md +157 -76
- package/.bkit/core/docs/templates/bkit-audit-architecture.md +113 -71
- package/.bkit/core/docs/templates/bkit-audit-ci-performance.md +75 -72
- package/.bkit/core/docs/templates/bkit-audit-config.md +122 -76
- package/.bkit/core/docs/templates/bkit-audit-cost.md +85 -74
- package/.bkit/core/docs/templates/bkit-audit-coverage.md +75 -68
- package/.bkit/core/docs/templates/bkit-audit-database.md +101 -70
- package/.bkit/core/docs/templates/bkit-audit-dead-code.md +164 -83
- package/.bkit/core/docs/templates/bkit-audit-deferrals.md +115 -86
- package/.bkit/core/docs/templates/bkit-audit-dependencies.md +264 -88
- package/.bkit/core/docs/templates/bkit-audit-documentation.md +118 -93
- package/.bkit/core/docs/templates/bkit-audit-duplication.md +139 -86
- package/.bkit/core/docs/templates/bkit-audit-failures.md +110 -81
- package/.bkit/core/docs/templates/bkit-audit-flakes.md +99 -74
- package/.bkit/core/docs/templates/bkit-audit-gates.md +105 -77
- package/.bkit/core/docs/templates/bkit-audit-issues.md +104 -80
- package/.bkit/core/docs/templates/bkit-audit-llm.md +131 -58
- package/.bkit/core/docs/templates/bkit-audit-logs.md +123 -100
- package/.bkit/core/docs/templates/bkit-audit-models.md +98 -53
- package/.bkit/core/docs/templates/bkit-audit-privacy.md +56 -52
- package/.bkit/core/docs/templates/bkit-audit-prompts.md +63 -54
- package/.bkit/core/docs/templates/bkit-audit-red-team.md +124 -68
- package/.bkit/core/docs/templates/bkit-audit-reliability.md +95 -70
- package/.bkit/core/docs/templates/bkit-audit-repo.md +169 -73
- package/.bkit/core/docs/templates/bkit-audit-security.md +206 -96
- package/.bkit/core/docs/templates/bkit-audit-slop.md +77 -70
- package/.bkit/core/docs/templates/bkit-audit-testing.md +162 -114
- package/.bkit/core/docs/templates/bkit-audit-usability.md +113 -71
- package/.bkit/core/docs/templates/bkit-plan.md +138 -132
- package/.bkit/core/engine/checks/after/auth.ts +40 -37
- package/.bkit/core/engine/checks/after/ci-yml.ts +65 -2
- package/.bkit/core/engine/checks/after/index.ts +12 -2
- package/.bkit/core/engine/checks/after/tools.ts +80 -33
- package/.bkit/core/engine/checks/before/context-fetch.ts +227 -33
- package/.bkit/core/engine/checks/before/env.ts +1 -1
- package/.bkit/core/engine/checks/before/index.ts +7 -0
- package/.bkit/core/engine/checks/before/repo.ts +40 -0
- package/.bkit/core/engine/checks/status-holes.ts +916 -123
- package/.bkit/core/engine/checks/tips/catalogue.ts +68 -17
- package/.bkit/core/engine/checks/tips/detect.ts +32 -0
- package/.bkit/core/engine/checks/tips/index.ts +47 -6
- package/.bkit/core/engine/cli.ts +238 -84
- package/.bkit/core/engine/commands/analysis.ts +128 -76
- 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/install/uninstall.ts +21 -27
- package/.bkit/core/engine/commands/install/upgrade.ts +32 -15
- package/.bkit/core/engine/commands/land.ts +126 -11
- package/.bkit/core/engine/commands/lib.ts +303 -6
- package/.bkit/core/engine/commands/registry.ts +6 -2
- package/.bkit/core/engine/commands/setup/setup.ts +1 -0
- package/.bkit/core/engine/commands/stats.ts +91 -35
- package/.bkit/core/engine/commands/workflow/branches.ts +1477 -117
- package/.bkit/core/engine/commands/workflow/challenge.ts +114 -39
- package/.bkit/core/engine/commands/workflow/completeness.ts +109 -0
- package/.bkit/core/engine/commands/workflow/context.ts +433 -55
- package/.bkit/core/engine/commands/workflow/counters.ts +244 -39
- package/.bkit/core/engine/commands/workflow/decisions.ts +61 -17
- package/.bkit/core/engine/commands/workflow/disk.ts +237 -55
- package/.bkit/core/engine/commands/workflow/fids.ts +19 -1
- package/.bkit/core/engine/commands/workflow/issues.ts +6 -0
- package/.bkit/core/engine/commands/workflow/ledgers.ts +458 -18
- package/.bkit/core/engine/commands/workflow/locks.ts +2 -0
- package/.bkit/core/engine/commands/workflow/plan-blocks.ts +124 -15
- package/.bkit/core/engine/commands/workflow/plans.ts +257 -0
- package/.bkit/core/engine/commands/workflow/prs.ts +12 -3
- package/.bkit/core/engine/commands/workflow/repo.ts +8 -0
- package/.bkit/core/engine/commands/workflow/roadmap.ts +56 -15
- package/.bkit/core/engine/commands/workflow/run-facts.ts +22 -31
- package/.bkit/core/engine/commands/workflow/runs.ts +652 -34
- package/.bkit/core/engine/commands/workflow/runtime.ts +3 -0
- package/.bkit/core/engine/commands/workflow/skills.ts +1 -0
- package/.bkit/core/engine/commands/workflow/status.ts +200 -17
- package/.bkit/core/engine/commands/workflow/step-table.ts +75 -33
- package/.bkit/core/engine/commands/workflow/steps.ts +635 -24
- package/.bkit/core/engine/commands/workflow/summary-findings.ts +177 -0
- package/.bkit/core/engine/commands/workflow/summary.ts +192 -46
- 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 +1285 -356
- package/.bkit/core/engine/commands/workflow/workflows.ts +228 -43
- package/.bkit/core/engine/commands/workflow/worktrees.ts +389 -47
- 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 +60 -12
- package/.bkit/core/engine/install/modules/antigravity.ts +3 -2
- package/.bkit/core/engine/install/modules/cloud.ts +3 -3
- package/.bkit/core/engine/install/modules/codex.ts +15 -2
- package/.bkit/core/engine/install/modules/core.ts +956 -52
- package/.bkit/core/engine/install/modules/cursor.ts +6 -6
- package/.bkit/core/engine/install/modules/opencode.ts +16 -4
- package/.bkit/core/engine/install/template-notes.ts +130 -0
- package/.bkit/core/engine/install/version-file.ts +3 -2
- 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/status.ts +160 -9
- package/.bkit/core/engine/ledgers/telemetry.ts +158 -21
- package/.bkit/core/engine/render/hosts.ts +114 -14
- package/.bkit/core/engine/shared/bkit-latest.ts +26 -4
- package/.bkit/core/engine/shared/dep-updater.ts +60 -0
- package/.bkit/core/engine/shared/egress.ts +1 -1
- package/.bkit/core/engine/shared/package-manager.ts +9 -0
- package/.bkit/core/engine/shared/settings.ts +92 -17
- 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 +1 -1
- package/.bkit/core/engine/tools/instructions-sources.ts +15 -17
- package/.bkit/core/engine/tools/instructions.ts +94 -43
- package/.bkit/core/hooks/antigravity-hook.js +25 -10
- package/.bkit/core/hooks/gateguard-engine.js +53 -29
- package/.bkit/core/hooks/guardrails-shell.js +4 -4
- package/.bkit/core/hooks/guardrails-tiers.js +3 -3
- 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 +187 -116
- package/.bkit/core/prompts/bkit-build-challenge-1.md +56 -37
- package/.bkit/core/prompts/bkit-build-challenge-2.md +65 -45
- package/.bkit/core/prompts/bkit-build-install-skills.md +38 -29
- package/.bkit/core/prompts/bkit-build-plan-convert.md +43 -32
- package/.bkit/core/prompts/bkit-build-plan-current.md +49 -39
- package/.bkit/core/prompts/bkit-build-plan-gaps-remediate.md +79 -55
- 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 +87 -50
- package/.bkit/core/prompts/bkit-debug-abort-handover.md +36 -35
- package/.bkit/core/prompts/bkit-debug-failure-diagnose.md +96 -64
- package/.bkit/core/prompts/bkit-debug-failure-remediate.md +54 -45
- package/.bkit/core/prompts/bkit-debug-failure-reproduce.md +42 -33
- package/.bkit/core/prompts/bkit-debug-failure-soak.md +53 -37
- package/.bkit/core/prompts/bkit-design-brainstorm-ideate-1.md +35 -30
- package/.bkit/core/prompts/bkit-design-brainstorm-ideate-2.md +34 -29
- package/.bkit/core/prompts/bkit-design-brainstorm-ideate-3.md +32 -28
- package/.bkit/core/prompts/bkit-design-generate.md +68 -52
- package/.bkit/core/prompts/bkit-design-organise.md +73 -35
- package/.bkit/core/prompts/bkit-design-review-1.md +58 -54
- package/.bkit/core/prompts/bkit-design-review-2.md +54 -50
- package/.bkit/core/prompts/bkit-design-spike.md +54 -47
- package/.bkit/core/prompts/bkit-design-update.md +42 -31
- package/.bkit/core/prompts/bkit-plan-generate.md +76 -58
- package/.bkit/core/prompts/bkit-plan-review-1.md +63 -49
- package/.bkit/core/prompts/bkit-plan-review-2.md +60 -48
- package/.bkit/core/prompts/bkit-plan-scope-check.md +53 -46
- package/.bkit/core/prompts/bkit-plan-update.md +70 -52
- package/.bkit/core/prompts/bkit-ship-conflict-resolve.md +82 -50
- package/.bkit/core/prompts/bkit-ship-deferred-sweep.md +80 -45
- package/.bkit/core/prompts/bkit-ship-update-docs.md +35 -29
- package/.bkit/core/prompts/bkit-utility-compress-markdown.md +55 -49
- package/.bkit/core/prompts/bkit-utility-update-decisions.md +76 -49
- package/.bkit/core/prompts/bkit-utility-update-deferrals.md +70 -41
- package/.bkit/core/prompts/bkit-utility-update-documentation.md +33 -30
- package/.bkit/core/prompts/bkit-utility-update-failures.md +73 -43
- package/.bkit/core/prompts/bkit-utility-update-knowledge.md +77 -50
- package/.bkit/core/prompts/bkit-utility-update-roadmap.md +77 -45
- package/.bkit/core/prompts/bkit-utility-update-tracker.md +144 -68
- package/.bkit/core/workflows/bkit-auto.md +53 -30
- package/.bkit/core/workflows/bkit-build.md +635 -304
- package/.bkit/core/workflows/bkit-debug.md +301 -148
- package/.bkit/core/workflows/bkit-design.md +167 -95
- package/.bkit/core/workflows/bkit-plan.md +172 -84
- package/.bkit/core/workflows/bkit-ship.md +299 -152
- package/.bkit/shared/.agents/plugins/bkit/hooks.json +10 -0
- package/.bkit/shared/.claude/bkit-cloud.md +12 -10
- package/.bkit/shared/.claude/settings.json +3 -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/.opencode/opencode.json +1 -1
- package/.bkit/shared/CLAUDE.md +5 -1
- package/.bkit/shared/GEMINI.md +4 -1
- package/.bkit/shared/docs/architecture.md +4 -7
- package/.bkit/shared/docs/data-schema.md +4 -7
- package/.bkit/shared/docs/deployments.md +239 -166
- 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 +282 -176
- 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 +24 -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 +53 -50
- package/.bkit/templates/.github/workflows/bkit-cloud.yml +13 -14
- 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 +95 -35
- package/.bkit/templates/.prettierignore +6 -7
- 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 +9 -1
- 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 +119 -0
- package/README.md +250 -76
- package/dist/checks/after/auth.js +36 -33
- package/dist/checks/after/ci-yml.js +52 -2
- package/dist/checks/after/index.js +12 -4
- package/dist/checks/after/tools.js +73 -33
- package/dist/checks/before/context-fetch.js +218 -33
- package/dist/checks/before/env.js +1 -1
- package/dist/checks/before/index.js +6 -2
- package/dist/checks/before/repo.js +35 -1
- package/dist/checks/status-holes.js +739 -114
- package/dist/checks/tips/catalogue.js +59 -17
- package/dist/checks/tips/detect.js +30 -0
- package/dist/checks/tips/index.js +48 -6
- package/dist/cli.js +222 -84
- package/dist/commands/analysis.js +77 -53
- 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/install/uninstall.js +23 -27
- package/dist/commands/install/upgrade.js +21 -11
- package/dist/commands/land.js +126 -10
- package/dist/commands/lib.js +244 -5
- package/dist/commands/registry.js +6 -2
- package/dist/commands/setup/setup.js +1 -0
- package/dist/commands/stats.js +69 -30
- package/dist/commands/workflow/branches.js +1232 -111
- package/dist/commands/workflow/challenge.js +90 -37
- package/dist/commands/workflow/completeness.js +97 -0
- package/dist/commands/workflow/context.js +371 -51
- package/dist/commands/workflow/counters.js +206 -40
- package/dist/commands/workflow/decisions.js +60 -17
- package/dist/commands/workflow/disk.js +213 -55
- package/dist/commands/workflow/fids.js +18 -1
- package/dist/commands/workflow/issues.js +6 -0
- package/dist/commands/workflow/ledgers.js +372 -21
- package/dist/commands/workflow/locks.js +2 -0
- package/dist/commands/workflow/plan-blocks.js +78 -14
- package/dist/commands/workflow/plans.js +205 -0
- package/dist/commands/workflow/prs.js +12 -3
- package/dist/commands/workflow/repo.js +6 -0
- package/dist/commands/workflow/roadmap.js +50 -17
- package/dist/commands/workflow/run-facts.js +23 -28
- package/dist/commands/workflow/runs.js +530 -33
- package/dist/commands/workflow/runtime.js +3 -0
- package/dist/commands/workflow/skills.js +1 -0
- package/dist/commands/workflow/status.js +166 -19
- package/dist/commands/workflow/step-table.js +61 -29
- package/dist/commands/workflow/steps.js +542 -26
- package/dist/commands/workflow/summary-findings.js +117 -0
- package/dist/commands/workflow/summary.js +154 -41
- 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 +1013 -321
- package/dist/commands/workflow/workflows.js +191 -38
- package/dist/commands/workflow/worktrees.js +310 -42
- package/dist/install/cloud-env.js +233 -99
- package/dist/install/context-ci-workflow.js +85 -0
- package/dist/install/manifest.js +57 -12
- package/dist/install/modules/antigravity.js +3 -2
- package/dist/install/modules/cloud.js +3 -3
- package/dist/install/modules/codex.js +12 -2
- package/dist/install/modules/core.js +851 -53
- package/dist/install/modules/cursor.js +6 -6
- package/dist/install/modules/opencode.js +11 -5
- package/dist/install/template-notes.js +116 -0
- package/dist/install/version-file.js +3 -2
- package/dist/ledgers/compact.js +87 -0
- package/dist/ledgers/journal.js +233 -0
- package/dist/ledgers/status.js +115 -5
- package/dist/ledgers/telemetry.js +121 -17
- package/dist/render/hosts.js +100 -14
- package/dist/shared/bkit-latest.js +26 -4
- package/dist/shared/dep-updater.js +49 -0
- package/dist/shared/egress.js +1 -1
- package/dist/shared/package-manager.js +6 -0
- package/dist/shared/settings.js +59 -10
- package/dist/shared/timeouts.js +2 -0
- package/dist/tools/cli-doc.js +97 -0
- package/dist/tools/grammar-density.js +1 -1
- package/dist/tools/instructions-sources.js +15 -16
- package/dist/tools/instructions.js +83 -39
- package/package.json +58 -42
- package/.bkit/core/.bkit/lite.md +0 -73
- package/.bkit/core/engine/commands/workflow/workstreams.ts +0 -172
- package/.bkit/core/prompts/bkit-build-plan-execute.md +0 -124
- package/.bkit/templates/scripts/ci/bkit-local-stack-lock.sh +0 -194
- package/dist/commands/workflow/workstreams.js +0 -149
- /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,129 +1,157 @@
|
|
|
1
|
-
<!-- Note: Reports live at `docs/audits/{YYYYMM}/{slug}.md`. `{YYYYMM}` = UTC month of this run. `{slug}` = template basename without `bkit-audit-` and `.md`. **If** that month already has `{slug}.md` or `{slug}-{TIMESTAMP}.md` → write `{slug}-{TIMESTAMP}.md` (`{TIMESTAMP}` = `date -u +%Y%m%dT%H%M%SZ`). Never overwrite. The report is stamped with a `bkit:anchor` block recording the audited commit (`baseSha`) and branch (`baseRef`); never hand-author or edit it. `@bkit-audit-generate` fills this template. -->
|
|
2
|
-
|
|
3
1
|
<!-- bkit:start -->
|
|
4
2
|
|
|
5
3
|
{{BKIT_MANAGED_MARKER}}
|
|
6
4
|
|
|
5
|
+
<!-- Note: @bkit-audit-generate fills this template. The report lives at `docs/audits/{YYYYMM}/{slug}.md`, where `{YYYYMM}` is the UTC month of the run and `{slug}` is this file's name without `bkit-audit-` and `.md`. **If** that month already has `{slug}.md` or `{slug}-{TIMESTAMP}.md` → write `{slug}-{TIMESTAMP}.md`, where `{TIMESTAMP}` is the output of `date -u +%Y%m%dT%H%M%SZ`. NEVER overwrite an earlier report. The report is stamped with a `bkit:anchor` block that records the audited commit (`baseSha`) and branch (`baseRef`). NEVER write or edit that block by hand. -->
|
|
6
|
+
|
|
7
7
|
# Database Audit
|
|
8
8
|
|
|
9
9
|
> [!CAUTION]
|
|
10
|
-
> **Purpose:**
|
|
10
|
+
> **Purpose:** A catalogue-backed check of privileges, access coverage, migrations, integrity, capacity and restore.
|
|
11
11
|
>
|
|
12
12
|
> **Rules:**
|
|
13
13
|
>
|
|
14
|
-
> -
|
|
15
|
-
> -
|
|
16
|
-
> -
|
|
14
|
+
> - Query a remote catalogue ONLY with `SELECT`. For a non-relational store, use ONLY its read-only reads.
|
|
15
|
+
> - Run writes ONLY locally, or inside a transaction you roll back explicitly.
|
|
16
|
+
> - Always check afterwards that the remote is unchanged.
|
|
17
|
+
> - NEVER push schema to a remote by hand.
|
|
18
|
+
> - NEVER hard-delete.
|
|
19
|
+
> - Restore ONLY into a throwaway target, and delete it before the report finishes.
|
|
20
|
+
> - Name the environment each claim ran against.
|
|
17
21
|
|
|
18
22
|
## Universal Instructions
|
|
19
23
|
|
|
20
24
|
### Context & Goals
|
|
21
25
|
|
|
22
|
-
Migrations and integration tests exercise queries
|
|
26
|
+
Migrations and integration tests exercise queries, but neither checks that privileges, policies and constraints match what the code assumes. The failure this audit targets is **a control that reads as enforced in the migration text but is not enforced in the live catalogue**: for example, a `REVOKE` undone by the platform's default privileges, a tenant table with no row-level policy, or a `CHECK` that evaluates to `NULL` (not `FALSE`) for the shape it should reject. Only the catalogue knows, so query it.
|
|
27
|
+
|
|
28
|
+
**Applies when:** migrations, a schema file or a DB client appear in a manifest. **If** none appears → write one `N/A` row with its evidence, and never report the surface as "clean". **If** the DB is relational → run every step. **If** it is a non-relational store (e.g., Firestore, DynamoDB, MongoDB):
|
|
23
29
|
|
|
24
|
-
|
|
30
|
+
- Run Steps 1-4, 6-9, 12-13 and 17-19 against its own mechanism (e.g., Firestore security rules, IAM policies, admin SDK vs client SDK).
|
|
31
|
+
- **If** the store has an equivalent for one of Steps 5, 10-11 and 14-16 → run that step against it.
|
|
32
|
+
- **Else** → write `N/A` for that step, with evidence.
|
|
25
33
|
|
|
26
|
-
**Cadence:**
|
|
34
|
+
**Cadence:** Run once a month. Run an extra pass when a migration adds a privileged function, changes an access policy or adds a tenancy-scoped table.
|
|
27
35
|
|
|
28
36
|
**Anchor Standards:**
|
|
29
37
|
|
|
30
|
-
- Platform production checklist and security guide (e.g
|
|
31
|
-
- Platform advisors and inspection CLI (e.g
|
|
38
|
+
- Platform production checklist and security guide (e.g., Supabase).
|
|
39
|
+
- Platform advisors and inspection CLI (e.g., Supabase Advisors, `supabase inspect db`); record the version.
|
|
32
40
|
- Platform backup / restore docs.
|
|
33
41
|
- Platform serverless connection guidance.
|
|
34
|
-
- DB routine-maintenance docs, edition = hosted major (e.g
|
|
35
|
-
- Safe-migration rule set (e.g
|
|
42
|
+
- DB routine-maintenance docs, edition = hosted major (e.g., PostgreSQL Routine Database Maintenance Tasks).
|
|
43
|
+
- Safe-migration rule set (e.g., Squawk); record version.
|
|
36
44
|
- bkit block of `docs/setup.md` (bkit version from `.bkit/version`): Rules
|
|
37
45
|
|
|
38
46
|
### Scope
|
|
39
47
|
|
|
40
|
-
-
|
|
41
|
-
-
|
|
42
|
-
-
|
|
43
|
-
-
|
|
44
|
-
-
|
|
45
|
-
-
|
|
48
|
+
- Check the catalogue privileges on functions, tables and sequences.
|
|
49
|
+
- Find the role each write in the code actually runs as.
|
|
50
|
+
- Check the row-level access coverage, and the exposure outside the main schema (file storage, change feeds, views, exposed schemas).
|
|
51
|
+
- Check migration hygiene, data integrity, derived data and data removal.
|
|
52
|
+
- Measure capacity, vacuum, connections and timeouts.
|
|
53
|
+
- Prove a restore against the recovery targets.
|
|
46
54
|
|
|
47
55
|
### Out of Scope
|
|
48
56
|
|
|
49
57
|
<!-- prettier-ignore -->
|
|
50
58
|
| Excluded item | Why | Where it belongs |
|
|
51
59
|
| --- | --- | --- |
|
|
52
|
-
| Policy predicate correctness; route reachability |
|
|
53
|
-
| Lawful basis
|
|
54
|
-
| Request latency outside the DB |
|
|
55
|
-
| Applying fixes |
|
|
60
|
+
| Policy predicate correctness; route reachability | The security audit owns correctness | `bkit-audit-security` |
|
|
61
|
+
| Lawful basis and retention periods for personal data | The privacy audit owns the data lifecycle | `bkit-audit-privacy` |
|
|
62
|
+
| Request latency outside the DB | The app-performance audit owns hot paths | `bkit-audit-app-performance` |
|
|
63
|
+
| Applying fixes | The audit only reports | A plan made from this report |
|
|
56
64
|
|
|
57
65
|
### Pre-Flight / Dependencies
|
|
58
66
|
|
|
59
67
|
#### Core
|
|
60
68
|
|
|
61
|
-
- [ ] **Permissions:** blocked
|
|
62
|
-
- [ ] **Catalogue Read:** Steps 3-16 — read-only SQL
|
|
63
|
-
- [ ] **Local DB:** Steps 2, 10, 14 — replayable from migrations. Fallback: rolled-back transactions and
|
|
64
|
-
- [ ] **Web:** Step 18 — fetch anchor standards. Fallback: versions
|
|
69
|
+
- [ ] **Permissions:** every blocked call is recorded.
|
|
70
|
+
- [ ] **Catalogue Read:** Steps 3-16 — read-only SQL, or the store's read-only API, for each environment (e.g., platform MCP `execute_sql`, `psql` as a read-only role). Fallback: use a local DB built from the migrations, and treat remote claims as hypotheses.
|
|
71
|
+
- [ ] **Local DB:** Steps 2, 10, 14 — a DB replayable from the migrations. Fallback: use rolled-back transactions, and re-check the remote afterwards.
|
|
72
|
+
- [ ] **Web:** Step 18 — fetch the anchor standards. Fallback: record the versions as unread.
|
|
65
73
|
|
|
66
74
|
#### Conditional
|
|
67
75
|
|
|
68
|
-
- [ ] **Platform Advisors:**
|
|
69
|
-
- [ ] **Platform Settings:**
|
|
70
|
-
- [ ] **Inspection CLI:**
|
|
71
|
-
- [ ] **Migration Linter:**
|
|
72
|
-
- [ ] **Restore Target:**
|
|
76
|
+
- [ ] **Platform Advisors:** **If** the platform is managed → Step 3 — the platform's advisors (e.g., Supabase MCP `get_advisors`). Fallback: run the equivalent catalogue queries.
|
|
77
|
+
- [ ] **Platform Settings:** **If** the platform is managed → Steps 4, 17 — network, MFA, owners, backups and point-in-time recovery (e.g., dashboard, management API). Fallback: none. Mark those items `Not Checked`.
|
|
78
|
+
- [ ] **Inspection CLI:** **If** the platform has one → Steps 14-16 — the inspection CLI (e.g., `supabase inspect db`). Fallback: read the engine's statistics views (e.g., `pg_stat_*`).
|
|
79
|
+
- [ ] **Migration Linter:** **If** the migrations are SQL → Step 10 — a safe-migration linter (e.g., Squawk). Fallback: apply its rules by reading.
|
|
80
|
+
- [ ] **Restore Target:** **If** the DB is hosted → Step 17 — the permission and tier to create a throwaway project. Fallback: none. A missing restore target is a finding.
|
|
73
81
|
|
|
74
82
|
### 🔒 Gate 1: Prerequisites Check
|
|
75
83
|
|
|
76
|
-
- [ ] **Gaps named:** every missing item names its fallback and `Not Checked` entry.
|
|
77
|
-
- [ ] **Gate 1 — Verified:**
|
|
84
|
+
- [ ] **Gaps named:** every missing item names its fallback and its `Not Checked` entry.
|
|
85
|
+
- [ ] **Gate 1 — Verified:** every item above, every Core item and every applicable Conditional item is checked.
|
|
78
86
|
|
|
79
87
|
### Probe Steps
|
|
80
88
|
|
|
81
|
-
- [ ] **Step 1 — Previous Run:** **Done when:**
|
|
82
|
-
- [ ] **Step 2 — Detect:** Find migrations
|
|
83
|
-
- [ ] **Step 3 — Advisors:** Run platform security and performance advisors
|
|
84
|
-
- [ ] **Step 4 — Checklist:** Walk platform production checklist against production, not memory: transport encryption enforced, network restrictions, org MFA,
|
|
85
|
-
- [ ] **Step 5 — Inventory:** Count tables, migrations
|
|
86
|
-
- [ ] **Step 6 — Grants:**
|
|
87
|
-
- [ ] **Step 7 — Write Roles:** `Grants`
|
|
88
|
-
- [ ] **Step 8 — Coverage:**
|
|
89
|
-
- [ ] **Step 9 — Exposure:** `Coverage` keys on scope columns
|
|
90
|
-
- [ ] **Step 10 — Migrations:**
|
|
91
|
-
-
|
|
92
|
-
-
|
|
93
|
-
-
|
|
94
|
-
-
|
|
95
|
-
-
|
|
96
|
-
-
|
|
97
|
-
|
|
98
|
-
|
|
99
|
-
|
|
89
|
+
- [ ] **Step 1 — Previous Run:** **Done when:** `Previous Run` holds the closure rate, or the run is marked baseline.
|
|
90
|
+
- [ ] **Step 2 — Detect:** Find the migrations, schema file or DB client. Confirm the local DB matches the migrations before trusting any local measurement. **If** migrations exist but the schema doc does not → the missing doc is a finding, and still read the migrations. **Done when:** `Checked` holds evidence, or `N/A` is recorded → **STOP**.
|
|
91
|
+
- [ ] **Step 3 — Advisors:** Run the platform's security and performance advisors. Each advisor row is a candidate, not a finding. Write one line for each lint the platform's advisor runs, even when it is clean (e.g., Supabase: unindexed FKs, duplicate indexes, per-row auth in a policy, multiple permissive policies, mutable function `search_path`, an extension in the public schema, an exposed table without row-level security, an owner-rights view). **If** there is no advisor → run the subset that fits the engine as catalogue queries, and mark the rest `N/A`. Cite the platform's fix pattern for each finding. **Done when:** every row in `Advisors` has a disposition.
|
|
92
|
+
- [ ] **Step 4 — Checklist:** Walk the platform production checklist against production, not memory: transport encryption enforced, network restrictions, org MFA, more than one owner, point-in-time recovery where size or RPO needs it, and compute sized for the `Connections` peak. **Done when:** every item is marked met, not met (a finding) or not applicable (saying why).
|
|
93
|
+
- [ ] **Step 5 — Inventory:** Count the tables, migrations and extensions. Compare the applied migrations with the directory in both directions, because drift invalidates every later step. Diff a schema fingerprint across environments (counts and hashes of columns, indexes, functions, policies and grants), because a change made by hand outside migrations leaves both migration lists equal. **If** only one environment is readable → record its fingerprint, and mark the cross-environment diff `Not Checked`. Check the hosted major version against the platform's support window, and list the extensions that block the next major. **Done when:** the counts, drift, fingerprint diff and version are in `Environment`.
|
|
94
|
+
- [ ] **Step 6 — Grants:** Read grants from the catalogue, never from migration text. For every function, record whether it runs with definer rights and which client roles can execute it (e.g., `pg_proc` and its ACL). A definer-rights function the anonymous role can execute is a finding unless its body checks the caller's identity, so read the body. Every function that became privileged since the previous report is a candidate, whether it was added or changed to definer rights. Check table and sequence grants to the anonymous role the same way. **Done when:** `Grants` lists every privileged function and anonymous grant, with a verdict.
|
|
95
|
+
- [ ] **Step 7 — Write Roles:** `Grants` shows who may write. This step shows who the code writes as. For each table whose writes need a role the request path lacks, find every write site, including SQL functions. Search for the table name, because language servers miss string literals. For each site, record the client used (a user-scoped client runs as the user role; an admin client runs as a privileged role, e.g., the Supabase service role), and compare it with the grant. An ungranted write is a finding. An ungranted write whose error is never read, or is dropped, is `CRITICAL`, because it fails silently on every call. **Done when:** `Write Roles` has one row per site: table · `file:line` · role at site · role granted · error checked · verdict.
|
|
96
|
+
- [ ] **Step 8 — Coverage:** For every tenancy-scoped table, check that tenancy is enforced at one recorded layer: a DB row policy (e.g., Postgres RLS: control on, >=1 policy, deny by default), or one app-layer scope that every query goes through (e.g., a Rails default scope, a Django manager). A table with a scope column and neither layer is a finding. Control on with 0 policies denies everything, which is safe but usually a mistake. Check coverage only; correctness goes to `bkit-audit-security`. The policy or scope test must fail when the policy is removed, because a denial can surface as silent zero rows. **Done when:** `Coverage` has one row per table: layer · policy count or scope · scope column · verdict.
|
|
97
|
+
- [ ] **Step 9 — Exposure:** `Coverage` keys on scope columns, so check the other paths here, for coverage only: file-storage policies and public buckets; change-feed publications and the row-level control on each published table; owner-rights views that bypass the caller's policies (e.g., no `security_invoker`); and API-served schemas that hold internal tables. **Done when:** `Exposure` has one row per surface, with a verdict.
|
|
98
|
+
- [ ] **Step 10 — Migrations:** Check the migrations added since the previous report for:
|
|
99
|
+
- shared timestamps (in the directory and on open branches)
|
|
100
|
+
- guarded DDL (`IF [NOT] EXISTS`) with no trailing catalogue re-query that asserts the result (a typo makes it a silent no-op that still counts as applied)
|
|
101
|
+
- a schema change without regenerated DB types, when the project generates them
|
|
102
|
+
- constraints that cannot fire because they evaluate to `NULL`, not `FALSE`, probed with a rolled-back `INSERT`
|
|
103
|
+
- lock-unsafe DDL (e.g., Postgres: a non-`CONCURRENTLY` index, a constraint without `NOT VALID` and a later `VALIDATE`, a type change, `NOT NULL` on an existing column, no `lock_timeout`), found with a safe-migration linter or by applying its rules, saying which
|
|
104
|
+
- a drop or rename that the previous deployed build or the oldest supported client still reads
|
|
105
|
+
|
|
106
|
+
**Done when:** every hit is a finding with its file.
|
|
107
|
+
|
|
108
|
+
- [ ] **Step 11 — Integrity:** Check for: an FK `ON DELETE` that writes to an immutability-guarded table (the referenced delete fails); a hard delete beside a soft-delete convention, or a cascade that bypasses it; audit or CDC triggers missing where they are meant to be, or a stream not receiving rows (env flags can disable them); orphans in deliberately FK-less tables; and every timestamp without time zone, with its intended zone and whether all writers agree. **Done when:** every hit is a finding with its query.
|
|
109
|
+
- [ ] **Step 12 — Derived Data:** List the stores computed from other data (caches, denormalised columns, counters, materialised views, scheduled rebuilds). For each store, answer three questions: does one shared writer own it (a write anywhere else is a finding); does every source write path call that writer (each source path missing from the writer's callers is a finding); and does something check the copy against the source. **If** the only safety net is the next rebuild → state how long users see wrong data. For each scheduled job, read the outcome of each run (status code or exit code), not only that it ran: a rejected run can log at info level. A job that did not write its owned rows in its window is a finding, even when it exited 0. **If** there are no scheduled jobs → record the skip with evidence of absence. **Done when:** each store has a row with those three answers.
|
|
110
|
+
- [ ] **Step 13 — Removal:** For each personal-data table, record the retention period and the purge job, whether soft-deleted rows are ever hard-deleted and when, and whether account deletion reaches every copy (caches, audit stream, embeddings, file storage, backups). No period, or a period without a job, is a finding. **Done when:** `Retention` has one row per table: data · retention · purge job · erasure covers · verdict.
|
|
111
|
+
- [ ] **Step 14 — Capacity:** Record each series beside the previous report's: table sizes and rows, the largest and unused indexes, sequential scans on large tables, and the inspection suite's outputs (e.g., outliers, calls, index stats, bloat, vacuum stats, table stats, locks, blocking, long-running, replication slots, cache hit). For the top 10 queries by total time and by mean time, take a query plan (e.g., `EXPLAIN (ANALYZE, BUFFERS)`) locally or in a rolled-back transaction, and record plan changes and the stats reset time. Record the size, growth and purge of the housekeeping tables (job history, HTTP logs, audit, auth audit). Flag any 32-bit key or sequence above 50% of its maximum. Compare disk with its limit and IO with the tier caps, and record the cache hit ratios. Measure query time in the DB, not in app traces, because network time dominates app traces. **Done when:** the series is in `Capacity`, and each threshold breach is a finding.
|
|
112
|
+
- [ ] **Step 15 — Vacuum:** **If** the engine vacuums (e.g., Postgres) → record the transaction-ID age per DB and for the largest tables, and the dead-tuple ratio and last autovacuum and autoanalyze for each hot table. A table not vacuumed since the previous report, or a climbing ID age, is a finding. **If** the engine is another kind → check its routine maintenance (e.g., SQLite `VACUUM`, InnoDB purge lag), or skip with evidence. **Done when:** the numbers are in `Capacity`, or the skip is recorded.
|
|
113
|
+
- [ ] **Step 16 — Connections:** Compare the connection limit and the pooler size with the peak, by application and by role. **If** serverless code connects directly → check it uses a transaction-mode pooler, a pool of 1 and prepared statements off (or the platform equivalent). Record the idle-in-transaction count and age. Record the statement timeout and the idle-in-transaction timeout for each client and admin role. A role with neither is a finding. **Done when:** the numbers, and each client constructor read, are in `Capacity`.
|
|
114
|
+
- [ ] **Step 17 — Restore:** Work through the restore in four parts.
|
|
115
|
+
- (a) From source, list every outbound side effect a clone fires (scheduled jobs, triggers or functions that call HTTP, DB webhooks, foreign-data wrappers) and how each one stops: a logical restore strips it first, it fails closed in the clone, or it is unscheduled right after the restore. Unscheduling after the restore counts only when a first run is harmless.
|
|
116
|
+
- **If** a side effect reaches real users or payments and does not fail closed → do no binary restore.
|
|
117
|
+
- **If** there is no plan → write a finding, and do not restore.
|
|
118
|
+
- (b) Restore the latest backup to a throwaway target, check that the schema matches the migrations, record the time taken and the data lost, then delete the target.
|
|
119
|
+
- (c) Record the backup type, retention, point-in-time recovery, RTO and RPO. Missing written targets are a finding. Retention shorter than the time it takes to notice silent corruption is a finding.
|
|
120
|
+
- (d) Record the age of the logical backup kept outside the platform account, and check that the restore notes cover the key material that backups never contain.
|
|
121
|
+
- **If** there is no such backup → write a finding.
|
|
122
|
+
|
|
123
|
+
**Done when:** `Restore` holds the side-effect plan and the result, or the finding that replaces them.
|
|
124
|
+
|
|
125
|
+
- [ ] **Step 18 — Standards:** Confirm the current version of each anchor standard, and read what changed since the previous report's version. Give `Standards Coverage` one row per checklist item, advisor lint and inspection report, each marked checked (naming the step), not applicable (saying why) or finding. Give each bkit anchor (a doc section, rule or issue shape) one row, marked followed (with the step or evidence), not applicable (saying why) or finding. A departure with no recorded reason (e.g., a `docs/decisions.jsonl` row or an accepted-divergence entry) is a finding. Mark each recommended practice the project does not apply as adopt (with a proposed step), reject (saying why) or not applicable. **Done when:** no row is empty.
|
|
126
|
+
- [ ] **Step 19 — Anything Else:** (a) Give a one-line verdict on each change since the previous report's commit that touches the DB: migrations, tables and columns, functions and grants, policies, extensions, scheduled jobs, buckets, publications and new DB clients. (b) In a bounded pass of about 30 minutes, note what a senior DBA would flag that no step asks about. Read what happened since the previous run (incidents, new `docs/failures.jsonl` rows), and ask what no step would catch. Include anything the catalogue, logs or advisors surfaced that no step checked, with the query for the next run. **Done when:** `Beyond the Steps` holds both passes, or says `none`. **If** one class of issue is seen on 2 runs → propose a step for it in `Process Improvements`.
|
|
100
127
|
|
|
101
128
|
### 🔒 Gate 2: Probes Check
|
|
102
129
|
|
|
103
|
-
- [ ] **Steps complete:** every step `[x]`, or
|
|
104
|
-
- [ ] **Evidence:** every finding cites
|
|
130
|
+
- [ ] **Steps complete:** every step is `[x]`, or skipped with evidence that its surface is absent.
|
|
131
|
+
- [ ] **Evidence:** every finding cites evidence someone can check again, and the tool that produced it.
|
|
105
132
|
- [ ] **Environments:** every finding names the environment it ran against.
|
|
106
|
-
- [ ] **Remote untouched:** no remote database changed
|
|
107
|
-
- [ ] **
|
|
133
|
+
- [ ] **Remote untouched:** no remote database changed.
|
|
134
|
+
- [ ] **Restore target deleted:** the throwaway restore target no longer exists.
|
|
135
|
+
- [ ] **Gate 2 — Verified:** every item above holds.
|
|
108
136
|
|
|
109
137
|
## Findings
|
|
110
138
|
|
|
111
139
|
<!-- prettier-ignore -->
|
|
112
140
|
| Severity | Use |
|
|
113
141
|
| --- | --- |
|
|
114
|
-
| `CRITICAL` | Tenant data readable
|
|
115
|
-
| `HIGH` |
|
|
116
|
-
| `MEDIUM` |
|
|
117
|
-
| `LOW` |
|
|
142
|
+
| `CRITICAL` | Tenant data is readable or writable across tenants, or by the anonymous role. An anonymous-executable privileged function has no identity check. A write fails silently on every call. A migration drops data without a backfill |
|
|
143
|
+
| `HIGH` | A tenancy table has no enforcing layer (no row policy and no app-layer scope). A public bucket or an owner-rights view exposes tenant data. A constraint cannot fire. A lock-unsafe migration runs on a live table. There is no proven restore, no recovery target or no off-platform backup. The applied migrations differ from the directory |
|
|
144
|
+
| `MEDIUM` | An index the query shape needs is missing. A housekeeping table has no purge. Vacuum lags. A sequence is above 50%. A role has no timeouts. Derived data has no agreement check. The schema doc differs from the migrations |
|
|
145
|
+
| `LOW` | A deny-all table has no policies. Naming drift changes neither access nor results |
|
|
118
146
|
|
|
119
|
-
Within a severity
|
|
147
|
+
Within a severity, list security and data findings first.
|
|
120
148
|
|
|
121
149
|
<!-- prettier-ignore -->
|
|
122
150
|
| ID | Severity | Location | Evidence | Expected |
|
|
123
151
|
| --- | --- | --- | --- | --- |
|
|
124
152
|
| PENDING | PENDING | PENDING | PENDING | PENDING |
|
|
125
153
|
|
|
126
|
-
|
|
154
|
+
**If** the run finds nothing → write one row: `None`.
|
|
127
155
|
|
|
128
156
|
## Report
|
|
129
157
|
|
|
@@ -204,13 +232,16 @@ PENDING
|
|
|
204
232
|
|
|
205
233
|
### 🔒 Gate 3: Report Check
|
|
206
234
|
|
|
207
|
-
- [ ] **No placeholders:** no `PENDING` left
|
|
208
|
-
- [ ] **Summary:**
|
|
209
|
-
- [ ] **
|
|
210
|
-
- [ ] **
|
|
211
|
-
- [ ] **
|
|
212
|
-
- [ ] **
|
|
213
|
-
- [ ] **
|
|
235
|
+
- [ ] **No placeholders:** no `PENDING` is left.
|
|
236
|
+
- [ ] **Summary:** `Summary` gives the count per severity.
|
|
237
|
+
- [ ] **Environments measured:** `Summary` names the environments measured.
|
|
238
|
+
- [ ] **Series:** the report shows every series beside the previous report's numbers, or marks the run as baseline.
|
|
239
|
+
- [ ] **Writes:** this run changed only this report, the template's `Project Instructions` and its own `docs/failures.jsonl` rows.
|
|
240
|
+
- [ ] **Throwaways removed:** every throwaway worktree or remote target is removed.
|
|
241
|
+
- [ ] **Process Improvements:** `Universal` and `Project` are both filled.
|
|
242
|
+
- [ ] **Suggested Issues:** every `MEDIUM`+ finding ID is in exactly one `Suggested Issues` row.
|
|
243
|
+
- [ ] **Next Step:** every `Suggested Issues` row has a `Next Step`.
|
|
244
|
+
- [ ] **Gate 3 — Verified:** every item above holds.
|
|
214
245
|
|
|
215
246
|
<!-- bkit:end -->
|
|
216
247
|
|