@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,134 +1,176 @@
|
|
|
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
|
# Config Audit
|
|
8
8
|
|
|
9
9
|
> [!CAUTION]
|
|
10
|
-
> **Purpose:** Whether settings outside the code agree across environments, dashboards, repository
|
|
10
|
+
> **Purpose:** Whether the settings outside the code agree across environments, dashboards, the repository and the docs: variables, platform and repository settings, DNS, and anything that expires on a date.
|
|
11
11
|
>
|
|
12
12
|
> **Rules:**
|
|
13
13
|
>
|
|
14
|
-
> - NEVER print or copy a secret value
|
|
15
|
-
> -
|
|
16
|
-
> -
|
|
14
|
+
> - NEVER print or copy a secret value.
|
|
15
|
+
> - Record a secret by its name, presence, dates and truncated SHA-256 fingerprint only.
|
|
16
|
+
> - Use dashboards, CLIs and APIs read-only.
|
|
17
|
+
> - NEVER change a setting, secret or DNS record.
|
|
18
|
+
> - Name the environment, and where each side was read, in every drift claim.
|
|
17
19
|
|
|
18
20
|
## Universal Instructions
|
|
19
21
|
|
|
20
22
|
### Context & Goals
|
|
21
23
|
|
|
22
|
-
Code is reviewed
|
|
24
|
+
Code is reviewed, but dashboards are not. A dashboard change (hosting, database, payments, error tracker) leaves no diff, review or history, so the next environment built from the docs differs. The failure this audit targets is drift that nobody sees until it fails. Examples: a variable in production that is missing in preview, so preview passes on a fallback that production never takes, or the reverse; a required check waiting on a renamed job; or a domain, membership or secret lapsing on a date with no deploy. Each one is a short outage that is cheap to prevent and slow to diagnose, because nothing changed.
|
|
23
25
|
|
|
24
|
-
**Applies when:** project deploys to >=1 hosted environment, or holds settings outside the repo (variables, dashboards, repository settings, DNS).
|
|
26
|
+
**Applies when:** the project deploys to >=1 hosted environment, or holds settings outside the repo (variables, dashboards, repository settings, DNS). **If** neither holds → write one `N/A` row with its evidence, and never report the surface as "clean".
|
|
25
27
|
|
|
26
|
-
**Cadence:**
|
|
28
|
+
**Cadence:** Run once a month. Run an extra pass before any release, and after any change made in a dashboard.
|
|
27
29
|
|
|
28
30
|
**Anchor Standards:**
|
|
29
31
|
|
|
30
32
|
- The Twelve-Factor App: III. Config and X. Dev/prod parity.
|
|
31
|
-
- Source-host CI security and ruleset docs (e.g
|
|
32
|
-
- Platform production checklist (e.g
|
|
33
|
-
- TLS certificate validity schedule (e.g
|
|
33
|
+
- Source-host CI security and ruleset docs (e.g., GitHub Actions secure-use reference, GitHub rulesets REST API).
|
|
34
|
+
- Platform production checklist (e.g., Supabase Production Checklist).
|
|
35
|
+
- TLS certificate validity schedule (e.g., CA/Browser Forum Baseline Requirements, Ballot SC-081v3).
|
|
34
36
|
- DNS CAA (RFC 8659); MTA-STS (RFC 8461) and TLS reporting (RFC 8460).
|
|
35
|
-
- Mailbox-provider sender requirements (e.g
|
|
37
|
+
- Mailbox-provider sender requirements (e.g., Gmail, Yahoo) and one-click unsubscribe (RFC 8058).
|
|
36
38
|
- bkit block of `docs/deployments.md` (bkit version from `.bkit/version`): § Autonomous phase-close prerequisites; § Post-merge dev CI auto-routing; § Promotion-lag warning (`Check Default Branch Lags Dev`)
|
|
37
39
|
|
|
38
40
|
### Scope
|
|
39
41
|
|
|
40
|
-
-
|
|
41
|
-
-
|
|
42
|
-
-
|
|
43
|
-
-
|
|
44
|
-
-
|
|
45
|
-
-
|
|
46
|
-
-
|
|
47
|
-
-
|
|
48
|
-
-
|
|
49
|
-
-
|
|
42
|
+
- Check the variables across every environment and secret store.
|
|
43
|
+
- Check that secret values match across stores.
|
|
44
|
+
- Check that each secret has one declared source.
|
|
45
|
+
- Compare the platform dashboard settings with the repo and docs.
|
|
46
|
+
- Check the runtime versions.
|
|
47
|
+
- Check the scheduled jobs, wherever they are defined.
|
|
48
|
+
- Read the dashboard change history since the previous run.
|
|
49
|
+
- Take a secret-free settings snapshot.
|
|
50
|
+
- Check the repository rulesets, required checks and security settings.
|
|
51
|
+
- Check DNS, domains, the registrar and inbound mail transport.
|
|
52
|
+
- Check deep and invite links and the `.well-known` files.
|
|
53
|
+
- Check email deliverability.
|
|
54
|
+
- Build the expiry calendar: credentials, certificates, accounts and plans.
|
|
50
55
|
|
|
51
56
|
### Out of Scope
|
|
52
57
|
|
|
53
58
|
<!-- prettier-ignore -->
|
|
54
59
|
| Excluded item | Why | Where it belongs |
|
|
55
60
|
| --- | --- | --- |
|
|
56
|
-
| Config nothing reads; flags set the same everywhere |
|
|
57
|
-
| Secret rotation, mail-authentication policy, who holds keys, workflow contents |
|
|
58
|
-
| Store signing credentials, developer memberships, store accounts |
|
|
59
|
-
| Rewriting docs that describe a setting wrongly |
|
|
60
|
-
| Error-stream and platform-log triage |
|
|
61
|
-
| Coding-agent settings, permissions, hooks, tool servers |
|
|
62
|
-
| bkit install state; templates adopted and wired |
|
|
63
|
-
| Changing settings, secrets, or records |
|
|
61
|
+
| Config nothing reads; flags set the same everywhere | It is dead config | `bkit-audit-dead-code` |
|
|
62
|
+
| Secret rotation, mail-authentication policy, who holds keys, workflow contents | The security audit owns them | `bkit-audit-security` |
|
|
63
|
+
| Store signing credentials, developer memberships, store accounts | The app-store audit owns them | `bkit-audit-app-store` |
|
|
64
|
+
| Rewriting docs that describe a setting wrongly | The documentation audit owns it | `bkit-audit-documentation` |
|
|
65
|
+
| Error-stream and platform-log triage | The logs audit owns it | `bkit-audit-logs` |
|
|
66
|
+
| Coding-agent settings, permissions, hooks, tool servers | The agents audit owns agent config | `bkit-audit-agents` |
|
|
67
|
+
| bkit install state; templates adopted and wired | The adoption audit owns it | `bkit-audit-adoption` |
|
|
68
|
+
| Changing settings, secrets, or records | The audit only reports | A plan made from this report |
|
|
64
69
|
|
|
65
70
|
### Pre-Flight / Dependencies
|
|
66
71
|
|
|
67
72
|
#### Core
|
|
68
73
|
|
|
69
|
-
- [ ] **Permissions:** blocked
|
|
70
|
-
- [ ] **Variable Listing:** Steps 2, 3 — names per environment from every host, CI
|
|
71
|
-
- [ ] **Platform Read:** Steps 4-6 — read-only dashboard
|
|
72
|
-
- [ ] **Audit Logs:** Step 6 —
|
|
73
|
-
- [ ] **Repository API:** Step 7 — rulesets, protection
|
|
74
|
-
- [ ] **DNS and TLS:** Steps 8, 11 — e.g
|
|
75
|
-
- [ ] **Web:** Step 12 — fetch anchor standards. Fallback: versions
|
|
74
|
+
- [ ] **Permissions:** every blocked call is recorded.
|
|
75
|
+
- [ ] **Variable Listing:** Steps 2, 3 — the names per environment from every host, CI and secret store (e.g., `vercel env ls`, `gh secret list` / `gh variable list`, `gcloud secrets list`, `eas env:list`). Fallback: use the repo-declared names only, and mark environments `Not Checked`.
|
|
76
|
+
- [ ] **Platform Read:** Steps 4-6 — a read-only dashboard, CLI or management API per platform (e.g., Vercel API, Supabase Management API, Stripe CLI, Sentry API). Fallback: use the repo and docs only, and mark the platform side `Not Checked`.
|
|
77
|
+
- [ ] **Audit Logs:** Step 6 — each platform's settings-change history (e.g., Vercel team activity, the Supabase org audit log, the GitHub org or repo audit log). Fallback: use the snapshot diff only, and mark set-and-reverted changes `Not Checked`.
|
|
78
|
+
- [ ] **Repository API:** Step 7 — rulesets, protection and security settings (e.g., `gh api`, GitLab API). Fallback: none. Mark those items `Not Checked`.
|
|
79
|
+
- [ ] **DNS and TLS:** Steps 8, 11 — DNS, registration and certificate reads (e.g., `dig`, RDAP / `whois`, `openssl s_client`). Fallback: use an online checker, and name it.
|
|
80
|
+
- [ ] **Web:** Step 12 — fetch the anchor standards. Fallback: record the versions as unread.
|
|
76
81
|
|
|
77
82
|
#### Conditional
|
|
78
83
|
|
|
79
|
-
- [ ] **Built Bundle:**
|
|
80
|
-
- [ ] **Secret Fingerprints:**
|
|
81
|
-
- [ ] **Registrar Account:**
|
|
82
|
-
- [ ] **Test Devices:**
|
|
83
|
-
- [ ] **Mailbox-Provider Tools:**
|
|
84
|
+
- [ ] **Built Bundle:** **If** the app has build-time public variables → Step 3 — the preview build's client bundle, to search. Fallback: search the source only, and mark the bundle `Not Checked`.
|
|
85
|
+
- [ ] **Secret Fingerprints:** **If** a secret is held in >=2 stores → Step 3 — a read-only value comparison by SHA-256 (e.g., the repo sync tooling's drift mode `node scripts/secrets/bkit-secrets.mjs drift` from the bkit package template `.bkit/templates/scripts/secrets/`, or a hash of the value read in-process). Fallback: compare names and `updated_at` only, and mark values `Not Checked`.
|
|
86
|
+
- [ ] **Registrar Account:** **If** the project owns domains → Steps 8, 11 — renewal, auto-renew, lock, MFA and contact (e.g., the registrar dashboard or API). Fallback: use RDAP for lock and expiry, and mark the rest `Not Checked`.
|
|
87
|
+
- [ ] **Test Devices:** **If** a native app has deep or invite links → Step 9 — a device or emulator with the app, and one without it. Fallback: validate the `.well-known` files only, and mark link opening `Not Checked`.
|
|
88
|
+
- [ ] **Mailbox-Provider Tools:** **If** the app sends email → Step 10 — sender data (e.g., Google Postmaster Tools, the email-provider dashboard or API). Fallback: read the headers of one sent message, and mark rates `Not Checked`.
|
|
84
89
|
|
|
85
90
|
### 🔒 Gate 1: Prerequisites Check
|
|
86
91
|
|
|
87
|
-
- [ ] **Gaps named:** every missing item names its fallback and `Not Checked` entry.
|
|
88
|
-
- [ ] **Gate 1 — Verified:**
|
|
92
|
+
- [ ] **Gaps named:** every missing item names its fallback and its `Not Checked` entry.
|
|
93
|
+
- [ ] **Gate 1 — Verified:** every item above, every Core item and every applicable Conditional item is checked.
|
|
89
94
|
|
|
90
95
|
### Probe Steps
|
|
91
96
|
|
|
92
|
-
- [ ] **Step 1 — Previous Run:** **Done when:**
|
|
93
|
-
- [ ] **Step 2 — Variables:**
|
|
94
|
-
- [ ] **Step 3 — Variable Handling:**
|
|
95
|
-
-
|
|
96
|
-
-
|
|
97
|
-
-
|
|
98
|
-
-
|
|
99
|
-
-
|
|
100
|
-
-
|
|
101
|
-
-
|
|
102
|
-
-
|
|
103
|
-
-
|
|
104
|
-
-
|
|
97
|
+
- [ ] **Step 1 — Previous Run:** **Done when:** `Previous Run` holds the closure rate, or the run is marked baseline.
|
|
98
|
+
- [ ] **Step 2 — Variables:** For every variable declared (in the env schema or loader, where one exists) or read in code (e.g., `process.env.X`, `os.environ[...]`), record where it is set: example env files, each hosting environment (e.g., development / preview / production), CI secrets and variables, the secret manager, and the mobile build service, where one is used. Build one matrix, names only. A variable missing from an environment that runs code reading it is a finding, unless a doc says why. A variable set where nothing declares it goes to `bkit-audit-dead-code`. **Done when:** `Variables` holds the matrix of variable x environment, names only.
|
|
99
|
+
- [ ] **Step 3 — Variable Handling:** For each matrix variable, answer (a)-(f).
|
|
100
|
+
- (a) A build-time public prefix (e.g., `NEXT_PUBLIC_*`, `EXPO_PUBLIC_*`, `VITE_*`) is inlined into the shipped bundle, so it must never hold a secret value, and changing it needs a rebuild, not an env change.
|
|
101
|
+
- Search the preview build's client bundle for server-only names and secret-key prefixes (e.g., `sk_live_`), and record presence only.
|
|
102
|
+
- (b) Check that each secret is held as the host's secret type (unreadable back from the dashboard or CLI). A preview environment holding a production secret (e.g., a DB service-role key, a live payments key) is a finding.
|
|
103
|
+
- (c) Check that a missing or malformed value is rejected at startup (e.g., by an env schema loader) in every environment, not at first use. A silent default that differs between environments is a finding.
|
|
104
|
+
- (d) Feature flags: record the owner, the date added and the value per environment.
|
|
105
|
+
- **If** preview != production **and** no doc says why → it is drift.
|
|
106
|
+
- **If** a flag is the same everywhere → it goes to `bkit-audit-dead-code`.
|
|
107
|
+
- (e) Value parity:
|
|
108
|
+
- **If** a secret is held in >=2 stores for one environment (env file, hosting, CI, secret manager, mobile build service, function secrets) → it has the same value everywhere. A name present everywhere proves nothing, because the secret may be rotated in one store and stale in the rest.
|
|
109
|
+
- Compare SHA-256 fingerprints, never values.
|
|
110
|
+
- **If** the store is readable → hash the live value in-process.
|
|
111
|
+
- **If** the store is write-only (e.g., GitHub Actions secrets) → compare the fingerprint at the last recorded push with the source, and compare `updated_at` with that push (a later date means it changed outside the sync).
|
|
112
|
+
- A store holding a name the deployed code no longer reads (renamed, stale) is a finding.
|
|
113
|
+
- **If** parity cannot be proven → mark it `Not Checked`, never pass.
|
|
114
|
+
- (f) Source: every secret has one declared source that every store is compared against (e.g., a sync config with one row per secret naming every store).
|
|
115
|
+
- **If** a copy sits where no API reaches (pasted into a provider dashboard, e.g., a webhook signing secret) → check that it is listed in a copy inventory with how to update it.
|
|
116
|
+
- A secret with no declared source, or a hand-set copy that is not listed, is a finding.
|
|
117
|
+
- **If** there is no sync tooling → `Process Improvements` proposes one (e.g., the bkit package template `.bkit/templates/scripts/secrets/`).
|
|
118
|
+
- A push path that bypasses the sync goes to `bkit-audit-security`.
|
|
119
|
+
|
|
120
|
+
**Done when:** every matrix variable answers (a)-(f) in `Variables`.
|
|
121
|
+
|
|
122
|
+
- [ ] **Step 4 — Platform Settings:** For each platform in use (e.g., hosting: Vercel, Netlify; DB and auth: Supabase, RDS, Auth0; mobile build: EAS), check only the settings that platform has.
|
|
123
|
+
- **If** there are none → `N/A`.
|
|
124
|
+
- Compare the dashboard with the repo and docs:
|
|
125
|
+
- Hosting: the build command, function regions and durations, deployment protection and deployment checks.
|
|
126
|
+
- DB and auth: the config file, where one exists, against each hosted project (e.g., auth settings, redirect URLs, email templates, rate limits, extensions, and scheduled DB jobs against docs).
|
|
127
|
+
- Background jobs: those registered per environment against the code registry.
|
|
128
|
+
- Webhooks (payments, email): endpoints, subscribed events and inbound routes against docs.
|
|
129
|
+
- Error tracker: alert rules and monitors against docs.
|
|
130
|
+
- Mobile: build profiles and environments against the build config.
|
|
131
|
+
- Auth (config file, dev, production), where offered: the site URL, the redirect allow-list (no wildcard preview URLs in production), token and OTP expiry, leaked-password protection, the SMTP sender and auth rate limits.
|
|
132
|
+
- Mobile config against builds: the runtime version, the OTA-update channel per branch where OTA updates ship (e.g., EAS Update), and bundle ids. A mismatch breaks OTA silently.
|
|
133
|
+
- Classify each setting as in code, documented, or recorded nowhere. A setting recorded nowhere is a finding even when its value is right, because the next environment will not get it.
|
|
134
|
+
|
|
135
|
+
**Done when:** `Platform Settings` holds one row per setting, with platform, environment, where recorded and verdict.
|
|
136
|
+
|
|
137
|
+
- [ ] **Step 5 — Runtimes and Crons:** Compare the runtime version (e.g., `.nvmrc`, `engines`, `.python-version`) with the hosting, CI and mobile build images. Compare the DB major version (e.g., in the platform config file) with each hosted environment. Check that the platform CLI version is pinned. For every scheduled job, wherever it is defined (hosting crons, job-runner cron triggers, the DB scheduler, scheduled CI workflows), record the timezone it runs in. A job defined in two places runs twice, which is a finding. **Done when:** `Platform Settings` holds one row per runtime and per schedule.
|
|
138
|
+
- [ ] **Step 6 — Dashboard Changes:** Today's diff misses a setting that was changed and changed back, so read each platform's audit log since the previous report. List each settings change: who made it, what it was, and whether it is recorded in the repo or a doc. Snapshot the dashboard config as secret-free JSON (e.g., the hosting project API; the DB management API: auth config, network restrictions, SSL enforcement, pooler; the source-host API: rulesets). Confirm that the snapshot holds no secret value. Diff it against the previous report's `Snapshot`, or against the committed project copy, where one exists. **If** there is no previous snapshot → the run is the baseline. **Done when:** `Dashboard Changes` lists every settings change, and `Snapshot` holds the JSON and the diff, or is marked baseline.
|
|
139
|
+
- [ ] **Step 7 — Repository:** Check the rulesets or branch protection on the default and release branches. Compare the required status checks with today's CI job names. A renamed job is a trap: the branch waits on a check that never reports, or merges without it once the old name is removed. Check the merge methods, delete-branch-on-merge, the default CI token permissions, and CI secrets and variables against docs. Ruleset detail: bypass actors and mode (e.g., GitHub `pull_request` is narrower than `always`, and `exempt` skips rules and leaves no bypass entry in the audit log); stale reviews dismissed on push; code-owner review enforced; a tag ruleset for release tags; and protection rules for each deployment environment that holds secrets. Security: secret scanning and push protection, dependency alerts and security updates, code scanning, a SHA-pinned-actions policy, and approval before fork PR workflows run. Check settings only. Workflow contents go to `bkit-audit-security`. **Done when:** `Repository` holds one row per setting, with expected, actual and verdict.
|
|
140
|
+
- [ ] **Step 8 — DNS:** For every domain and subdomain, record the registrar, the renewal date and auto-renew, and compare each record with where its provider says it should point (e.g., hosting, email). A record for a service no longer used is a finding, because a dangling subdomain allows takeover. Mail-authentication policy goes to `bkit-audit-security`, so for mail-authentication records check only drift and expiry here. **If** CAA is present → check that it authorises every CA the hosts issue from (e.g., `letsencrypt.org`), because otherwise renewal fails silently. Shrinking certificate lifetimes make this bite sooner. Registrar hardening: the transfer lock (`clientTransferProhibited`), account MFA, a registrant email that is deliverable and off-domain, and DNSSEC on, or off with a written reason. Inbound mail: MX points to the intended provider; MTA-STS and TLS reporting are set (testing mode, then enforce); and the DMARC `rua` mailbox exists and is read. **Done when:** `DNS` holds one row per domain and record, with its verdict.
|
|
141
|
+
- [ ] **Step 9 — Links:** **If** a native app has deep or invite links → check that the web serves `/.well-known/apple-app-site-association` and `/.well-known/assetlinks.json`, and that each one is valid and names the bundle id and signing identity of the current build (`Platform Settings`). Open an invite link on a device with the app (it opens the app) and on one without it (it reaches a working web page). A broken file breaks every link silently. **Done when:** `Links` holds one row per file and per device case.
|
|
142
|
+
- [ ] **Step 10 — Deliverability:** **If** the app sends email → compare the sending domains with the mailbox-provider sender requirements, and record the page's thresholds. Compare the spam rate (e.g., Google Postmaster Tools) with the bulk-sender limit. Check for one-click unsubscribe (the RFC 8058 `List-Unsubscribe-Post` header and a visible link) on every non-transactional message. Transactional mail (sign-in links, receipts) is exempt. Check that bounces, complaints and unsubscribes are suppressed, and that nothing re-adds them. Check that transactional mail is separate from marketing (by subdomain or stream), so a marketing complaint cannot sink sign-in mail. **Done when:** `Deliverability` holds one row per requirement, with threshold, measurement and verdict.
|
|
143
|
+
- [ ] **Step 11 — Expiry:** List every credential or account with a date: domains, non-auto-renewing certificates, OAuth client secrets, expiring API keys, source-host tokens, build-service tokens and annual paid plans. List store signing credentials and developer memberships by reference to `bkit-audit-app-store`. For each row, record the date, the owner and what breaks. A date due in <=60 days is a finding, and so is an unknown date. For each non-auto-renewing certificate, measure the issuer and the days left live (e.g., `openssl s_client`, a TLS checker), not from a dashboard. Cover custom DB domains, inbound mail hosts and API hosts off the main host. A hand-renewed certificate is a finding whatever its date, so propose automation. **Done when:** `Expiry Calendar` is sorted by date, and every row has a date or an unknown-date finding.
|
|
144
|
+
- [ ] **Step 12 — 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 Twelve-Factor III and X requirement, per CI secure-use recommendation and per platform checklist item, 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.
|
|
145
|
+
- [ ] **Step 13 — Anything Else:** (a) Give a one-line verdict on each change since the previous report's commit that touches config: declared variables and example env files, hosting, DB and mobile config files, workflows and rulesets, scheduled jobs, DNS records, and every `Dashboard Changes` entry. A dashboard setting that changed and that no step lists is a finding, so propose adding it to `Platform Settings`. (b) In a bounded pass of about 30 minutes, note what a senior platform engineer would flag that no step asks about. Read what happened since the previous run (incidents, `bkit-audit-logs` reports, 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`.
|
|
105
146
|
|
|
106
147
|
### 🔒 Gate 2: Probes Check
|
|
107
148
|
|
|
108
|
-
- [ ] **Steps complete:** every step `[x]`, or
|
|
109
|
-
- [ ] **Evidence:** every finding cites
|
|
110
|
-
- [ ] **No secrets:** no secret value anywhere in the report,
|
|
111
|
-
- [ ] **
|
|
112
|
-
- [ ] **
|
|
149
|
+
- [ ] **Steps complete:** every step is `[x]`, or skipped with evidence that its surface is absent.
|
|
150
|
+
- [ ] **Evidence:** every finding cites evidence someone can check again, and the tool that produced it.
|
|
151
|
+
- [ ] **No secrets:** no secret value appears anywhere in the report, including `Snapshot`.
|
|
152
|
+
- [ ] **Fingerprints only:** every fingerprint in the report is a truncated SHA-256.
|
|
153
|
+
- [ ] **Remote untouched:** no dashboard setting, secret or DNS record changed.
|
|
154
|
+
- [ ] **Gate 2 — Verified:** every item above holds.
|
|
113
155
|
|
|
114
156
|
## Findings
|
|
115
157
|
|
|
116
158
|
<!-- prettier-ignore -->
|
|
117
159
|
| Severity | Use |
|
|
118
160
|
| --- | --- |
|
|
119
|
-
| `CRITICAL` |
|
|
120
|
-
| `HIGH` |
|
|
121
|
-
| `MEDIUM` |
|
|
122
|
-
| `LOW` |
|
|
161
|
+
| `CRITICAL` | A secret in a public build-time variable or the client bundle. A production secret reachable from preview. A dangling record on a live domain. An expired domain, certificate or credential still in use |
|
|
162
|
+
| `HIGH` | A required check that no longer reports. Anything expiring in <=30 days. A variable missing from an environment that runs code reading it. A secret value that differs between stores of one environment, or code reading a name no store holds. A wildcard redirect in production auth. A job scheduled in two places. A bypass wider than needed, or a repository security setting turned off. CAA blocking the issuing CA. A broken `.well-known` file or invite link |
|
|
163
|
+
| `MEDIUM` | A setting recorded nowhere. A secret with no declared source. A hand-set secret copy missing from the inventory. A silent default that differs between environments. Flag drift with no doc. An expiry in 31-60 days, or an unknown one. A hand-renewed certificate. A secret not held as a secret type. Runtime version drift. A registrar hardening gap. A deliverability rule not met |
|
|
164
|
+
| `LOW` | A doc that describes a setting wrongly while the value is right. Naming drift that changes no behaviour |
|
|
123
165
|
|
|
124
|
-
Within a severity
|
|
166
|
+
Within a severity, list secrets and production findings first.
|
|
125
167
|
|
|
126
168
|
<!-- prettier-ignore -->
|
|
127
169
|
| ID | Severity | Location | Evidence | Expected |
|
|
128
170
|
| --- | --- | --- | --- | --- |
|
|
129
171
|
| PENDING | PENDING | PENDING | PENDING | PENDING |
|
|
130
172
|
|
|
131
|
-
|
|
173
|
+
**If** the run finds nothing → write one row: `None`.
|
|
132
174
|
|
|
133
175
|
## Report
|
|
134
176
|
|
|
@@ -205,13 +247,17 @@ PENDING
|
|
|
205
247
|
|
|
206
248
|
### 🔒 Gate 3: Report Check
|
|
207
249
|
|
|
208
|
-
- [ ] **No placeholders:** no `PENDING` left
|
|
209
|
-
- [ ] **Summary:**
|
|
210
|
-
- [ ] **
|
|
211
|
-
- [ ] **
|
|
212
|
-
- [ ] **
|
|
213
|
-
- [ ] **
|
|
214
|
-
- [ ] **
|
|
250
|
+
- [ ] **No placeholders:** no `PENDING` is left.
|
|
251
|
+
- [ ] **Summary:** `Summary` gives the count per severity.
|
|
252
|
+
- [ ] **Environments:** `Summary` names the environments.
|
|
253
|
+
- [ ] **Dashboards read:** `Summary` names the dashboards read.
|
|
254
|
+
- [ ] **Series:** `Snapshot` is diffed against the previous report's, or the run is marked baseline.
|
|
255
|
+
- [ ] **Writes:** this run changed only this report, the template's `Project Instructions` and its own `docs/failures.jsonl` rows.
|
|
256
|
+
- [ ] **Throwaways removed:** every throwaway worktree or remote target is removed.
|
|
257
|
+
- [ ] **Process Improvements:** `Universal` and `Project` are both filled.
|
|
258
|
+
- [ ] **Suggested Issues:** every `MEDIUM`+ finding ID is in exactly one `Suggested Issues` row.
|
|
259
|
+
- [ ] **Next Step:** every `Suggested Issues` row has a `Next Step`.
|
|
260
|
+
- [ ] **Gate 3 — Verified:** every item above holds.
|
|
215
261
|
|
|
216
262
|
<!-- bkit:end -->
|
|
217
263
|
|