@cbartens/bkit 5.5.1 → 6.1.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.bkit/README.md +167 -154
- package/.bkit/core/.agents/context.md +95 -29
- package/.bkit/core/.agents/docs.md +18 -15
- package/.bkit/core/.agents/plugins/bkit/hooks/bkit-gateguard.cjs +1 -0
- package/.bkit/core/.agents/plugins/bkit/hooks/bkit-guardrails.cjs +6 -5
- package/.bkit/core/.agents/plugins/bkit/hooks/bkit-readguard.cjs +1 -0
- package/.bkit/core/.agents/plugins/bkit/hooks/bkit-rules.cjs +65 -0
- package/.bkit/core/.agents/rules.md +112 -102
- package/.bkit/core/.agents/skills.md +63 -15
- package/.bkit/core/.bkit/README.md +167 -154
- package/.bkit/core/.bkit/authoring.md +747 -0
- package/.bkit/core/.bkit/cli.md +407 -0
- package/.bkit/core/.bkit/cloud.md +283 -195
- package/.bkit/core/.bkit/comparison.md +45 -43
- package/.bkit/core/.bkit/install.md +166 -95
- package/.bkit/core/.bkit/jsonl.md +339 -196
- package/.bkit/core/.bkit/pipeline.md +142 -145
- package/.bkit/core/.bkit/prompts.md +295 -264
- package/.bkit/core/.bkit/providers.md +460 -277
- package/.bkit/core/.bkit/router.md +69 -0
- package/.bkit/core/.bkit/templates.md +530 -256
- package/.bkit/core/.bkit/trackers.md +116 -65
- package/.bkit/core/.bkit/workflows.md +742 -618
- package/.bkit/core/.claude/hooks/bkit-gateguard.cjs +2 -2
- package/.bkit/core/.claude/hooks/bkit-guardrails.cjs +3 -3
- package/.bkit/core/.claude/hooks/bkit-preflight.sh +45 -14
- package/.bkit/core/.codex/hooks/bkit-guardrails.cjs +3 -3
- package/.bkit/core/.codex/hooks/bkit-rules.cjs +57 -0
- package/.bkit/core/.cursor/hooks/bkit-guardrails.cjs +7 -7
- package/.bkit/core/.cursor/hooks/bkit-preflight.sh +47 -12
- package/.bkit/core/.opencode/plugin/bkit-rules.js +89 -0
- package/.bkit/core/AGENTS.md +6 -80
- package/.bkit/core/docs/templates/bkit-audit-accessibility.md +128 -130
- package/.bkit/core/docs/templates/bkit-audit-adoption.md +104 -94
- package/.bkit/core/docs/templates/bkit-audit-agents.md +96 -98
- package/.bkit/core/docs/templates/bkit-audit-aio-seo.md +100 -103
- package/.bkit/core/docs/templates/bkit-audit-analytics.md +141 -107
- package/.bkit/core/docs/templates/bkit-audit-annotations.md +99 -97
- package/.bkit/core/docs/templates/bkit-audit-app-performance.md +122 -121
- package/.bkit/core/docs/templates/bkit-audit-app-store.md +158 -101
- package/.bkit/core/docs/templates/bkit-audit-architecture.md +114 -96
- package/.bkit/core/docs/templates/bkit-audit-ci-performance.md +76 -97
- package/.bkit/core/docs/templates/bkit-audit-config.md +123 -101
- package/.bkit/core/docs/templates/bkit-audit-cost.md +86 -99
- package/.bkit/core/docs/templates/bkit-audit-coverage.md +76 -93
- package/.bkit/core/docs/templates/bkit-audit-database.md +102 -95
- package/.bkit/core/docs/templates/bkit-audit-dead-code.md +165 -108
- package/.bkit/core/docs/templates/bkit-audit-deferrals.md +115 -109
- package/.bkit/core/docs/templates/bkit-audit-dependencies.md +265 -113
- package/.bkit/core/docs/templates/bkit-audit-documentation.md +119 -118
- package/.bkit/core/docs/templates/bkit-audit-duplication.md +140 -111
- package/.bkit/core/docs/templates/bkit-audit-failures.md +111 -106
- package/.bkit/core/docs/templates/bkit-audit-flakes.md +100 -99
- package/.bkit/core/docs/templates/bkit-audit-gates.md +107 -103
- package/.bkit/core/docs/templates/bkit-audit-issues.md +105 -105
- package/.bkit/core/docs/templates/bkit-audit-llm.md +134 -85
- package/.bkit/core/docs/templates/bkit-audit-logs.md +124 -125
- package/.bkit/core/docs/templates/bkit-audit-models.md +99 -78
- package/.bkit/core/docs/templates/bkit-audit-privacy.md +56 -76
- package/.bkit/core/docs/templates/bkit-audit-prompts.md +63 -78
- package/.bkit/core/docs/templates/bkit-audit-red-team.md +125 -93
- package/.bkit/core/docs/templates/bkit-audit-reliability.md +97 -96
- package/.bkit/core/docs/templates/bkit-audit-repo.md +170 -98
- package/.bkit/core/docs/templates/bkit-audit-security.md +207 -121
- package/.bkit/core/docs/templates/bkit-audit-slop.md +78 -95
- package/.bkit/core/docs/templates/bkit-audit-testing.md +163 -139
- package/.bkit/core/docs/templates/bkit-audit-usability.md +114 -96
- package/.bkit/core/docs/templates/bkit-plan.md +158 -281
- package/.bkit/core/engine/checks/after/auth.ts +40 -37
- package/.bkit/core/engine/checks/after/ci-yml.ts +104 -31
- package/.bkit/core/engine/checks/after/github.ts +95 -17
- package/.bkit/core/engine/checks/after/index.ts +21 -8
- package/.bkit/core/engine/checks/after/suppression.ts +8 -5
- package/.bkit/core/engine/checks/after/tools.ts +125 -123
- package/.bkit/core/engine/checks/before/context-fetch.ts +227 -33
- package/.bkit/core/engine/checks/before/env.ts +3 -3
- package/.bkit/core/engine/checks/before/files.ts +5 -4
- package/.bkit/core/engine/checks/before/index.ts +25 -1
- package/.bkit/core/engine/checks/before/repo.ts +208 -2
- package/.bkit/core/engine/checks/status-holes.ts +916 -123
- package/.bkit/core/engine/checks/tips/catalogue.ts +82 -20
- package/.bkit/core/engine/checks/tips/detect.ts +66 -0
- package/.bkit/core/engine/checks/tips/index.ts +52 -11
- package/.bkit/core/engine/cli.ts +251 -130
- package/.bkit/core/engine/commands/analysis.ts +282 -199
- package/.bkit/core/engine/commands/ci/ci.ts +363 -29
- package/.bkit/core/engine/commands/ci/pins.ts +172 -0
- package/.bkit/core/engine/commands/ci/push-gate.ts +223 -0
- package/.bkit/core/engine/commands/comply.ts +77 -103
- package/.bkit/core/engine/commands/install/doctor.ts +2 -2
- package/.bkit/core/engine/commands/install/install.ts +57 -18
- package/.bkit/core/engine/commands/install/uninstall.ts +86 -55
- package/.bkit/core/engine/commands/install/upgrade.ts +32 -15
- package/.bkit/core/engine/commands/land.ts +139 -18
- package/.bkit/core/engine/commands/lib.ts +381 -22
- package/.bkit/core/engine/commands/registry.ts +10 -2
- package/.bkit/core/engine/commands/setup/setup.ts +8 -7
- package/.bkit/core/engine/commands/stats.ts +260 -0
- package/.bkit/core/engine/commands/tips.ts +10 -5
- package/.bkit/core/engine/commands/workflow/branches.ts +2215 -176
- package/.bkit/core/engine/commands/workflow/challenge.ts +748 -0
- package/.bkit/core/engine/commands/workflow/completeness.ts +109 -0
- package/.bkit/core/engine/commands/workflow/context.ts +1249 -47
- package/.bkit/core/engine/commands/workflow/counters.ts +483 -95
- package/.bkit/core/engine/commands/workflow/decisions.ts +585 -0
- package/.bkit/core/engine/commands/workflow/disk.ts +238 -56
- package/.bkit/core/engine/commands/workflow/fids.ts +811 -33
- package/.bkit/core/engine/commands/workflow/issues.ts +413 -64
- package/.bkit/core/engine/commands/workflow/ledgers.ts +1333 -36
- package/.bkit/core/engine/commands/workflow/locks.ts +28 -2
- package/.bkit/core/engine/commands/workflow/plan-blocks.ts +691 -0
- package/.bkit/core/engine/commands/workflow/plan-versions.ts +21 -0
- package/.bkit/core/engine/commands/workflow/plans.ts +257 -0
- package/.bkit/core/engine/commands/workflow/prs.ts +178 -33
- package/.bkit/core/engine/commands/workflow/repo.ts +66 -8
- package/.bkit/core/engine/commands/workflow/roadmap.ts +72 -22
- package/.bkit/core/engine/commands/workflow/run-facts.ts +492 -0
- package/.bkit/core/engine/commands/workflow/runs.ts +827 -79
- package/.bkit/core/engine/commands/workflow/runtime.ts +25 -1
- package/.bkit/core/engine/commands/workflow/skills.ts +1 -0
- package/.bkit/core/engine/commands/workflow/status.ts +329 -33
- package/.bkit/core/engine/commands/workflow/step-table.ts +381 -0
- package/.bkit/core/engine/commands/workflow/steps.ts +841 -105
- package/.bkit/core/engine/commands/workflow/summary-findings.ts +177 -0
- package/.bkit/core/engine/commands/workflow/summary.ts +544 -0
- package/.bkit/core/engine/commands/workflow/tasks.ts +409 -0
- package/.bkit/core/engine/commands/workflow/test-blocks.ts +254 -0
- package/.bkit/core/engine/commands/workflow/tests-changed.ts +201 -0
- package/.bkit/core/engine/commands/workflow/tests.ts +2124 -330
- package/.bkit/core/engine/commands/workflow/tracker.ts +1195 -0
- package/.bkit/core/engine/commands/workflow/workflows.ts +1197 -235
- package/.bkit/core/engine/commands/workflow/worktrees.ts +543 -24
- package/.bkit/core/engine/install/cloud-env.ts +251 -121
- package/.bkit/core/engine/install/context-ci-workflow.ts +102 -0
- package/.bkit/core/engine/install/manifest.ts +67 -17
- package/.bkit/core/engine/install/modules/antigravity.ts +3 -2
- package/.bkit/core/engine/install/modules/cloud.ts +24 -16
- package/.bkit/core/engine/install/modules/codex.ts +15 -2
- package/.bkit/core/engine/install/modules/core.ts +1196 -45
- package/.bkit/core/engine/install/modules/cursor.ts +6 -6
- package/.bkit/core/engine/install/modules/opencode.ts +18 -6
- package/.bkit/core/engine/install/template-notes.ts +130 -0
- package/.bkit/core/engine/install/version-file.ts +9 -4
- package/.bkit/core/engine/install/write.ts +5 -0
- package/.bkit/core/engine/ledgers/compact.ts +124 -0
- package/.bkit/core/engine/ledgers/journal.ts +291 -0
- package/.bkit/core/engine/ledgers/migrate.ts +92 -0
- package/.bkit/core/engine/ledgers/status.ts +249 -21
- package/.bkit/core/engine/ledgers/telemetry.ts +1397 -253
- package/.bkit/core/engine/render/hosts.ts +118 -14
- package/.bkit/core/engine/render/models.ts +12 -0
- package/.bkit/core/engine/shared/bkit-latest.ts +26 -4
- package/.bkit/core/engine/shared/branches.ts +4 -1
- package/.bkit/core/engine/shared/dep-updater.ts +60 -0
- package/.bkit/core/engine/shared/egress.ts +8 -1
- package/.bkit/core/engine/shared/json.ts +25 -7
- package/.bkit/core/engine/shared/package-manager.ts +9 -0
- package/.bkit/core/engine/shared/settings.ts +243 -31
- package/.bkit/core/engine/shared/text.ts +361 -0
- package/.bkit/core/engine/shared/timeouts.ts +2 -0
- package/.bkit/core/engine/tools/cli-doc.ts +111 -0
- package/.bkit/core/engine/tools/grammar-density.ts +215 -0
- package/.bkit/core/engine/tools/instructions-sources.ts +832 -0
- package/.bkit/core/engine/tools/instructions.ts +1802 -0
- package/.bkit/core/hooks/antigravity-hook.js +25 -10
- package/.bkit/core/hooks/gateguard-engine.js +54 -29
- package/.bkit/core/hooks/guardrails-shell.js +4 -5
- package/.bkit/core/hooks/guardrails-tiers.js +10 -4
- package/.bkit/core/hooks/preflight-linear.sh +9 -9
- package/.bkit/core/hooks/preflight-rules.sh +8 -0
- package/.bkit/core/hooks/readguard-engine.js +29 -10
- package/.bkit/core/hooks/session-rules-advisory.js +61 -0
- package/.bkit/core/prompts/bkit-audit-generate.md +202 -94
- package/.bkit/core/prompts/bkit-build-challenge-1.md +76 -34
- package/.bkit/core/prompts/bkit-build-challenge-2.md +85 -38
- package/.bkit/core/prompts/bkit-build-install-skills.md +50 -28
- package/.bkit/core/prompts/bkit-build-plan-convert.md +85 -0
- package/.bkit/core/prompts/bkit-build-plan-current.md +59 -36
- package/.bkit/core/prompts/bkit-build-plan-gaps-remediate.md +101 -36
- package/.bkit/core/prompts/bkit-build-plan-tasks.md +149 -0
- package/.bkit/core/prompts/bkit-build-plan-tests.md +120 -0
- package/.bkit/core/prompts/bkit-build-plan-verify.md +104 -43
- package/.bkit/core/prompts/bkit-debug-abort-handover.md +47 -32
- package/.bkit/core/prompts/bkit-debug-failure-diagnose.md +109 -57
- package/.bkit/core/prompts/bkit-debug-failure-remediate.md +65 -39
- package/.bkit/core/prompts/bkit-debug-failure-reproduce.md +53 -31
- package/.bkit/core/prompts/bkit-debug-failure-soak.md +65 -34
- package/.bkit/core/prompts/bkit-design-brainstorm-ideate-1.md +46 -31
- package/.bkit/core/prompts/bkit-design-brainstorm-ideate-2.md +45 -31
- package/.bkit/core/prompts/bkit-design-brainstorm-ideate-3.md +43 -30
- package/.bkit/core/prompts/bkit-design-generate.md +80 -46
- package/.bkit/core/prompts/bkit-design-organise.md +83 -32
- package/.bkit/core/prompts/bkit-design-review-1.md +70 -50
- package/.bkit/core/prompts/bkit-design-review-2.md +65 -46
- package/.bkit/core/prompts/bkit-design-spike.md +64 -40
- package/.bkit/core/prompts/bkit-design-update.md +53 -28
- package/.bkit/core/prompts/bkit-plan-generate.md +101 -29
- package/.bkit/core/prompts/bkit-plan-review-1.md +78 -41
- package/.bkit/core/prompts/bkit-plan-review-2.md +78 -35
- package/.bkit/core/prompts/bkit-plan-scope-check.md +116 -0
- package/.bkit/core/prompts/bkit-plan-update.md +86 -31
- package/.bkit/core/prompts/bkit-ship-conflict-resolve.md +94 -50
- package/.bkit/core/prompts/bkit-ship-deferred-sweep.md +91 -41
- package/.bkit/core/prompts/bkit-ship-update-docs.md +45 -24
- package/.bkit/core/prompts/bkit-utility-compress-markdown.md +65 -49
- package/.bkit/core/prompts/bkit-utility-update-decisions.md +87 -42
- package/.bkit/core/prompts/bkit-utility-update-deferrals.md +81 -37
- package/.bkit/core/prompts/bkit-utility-update-documentation.md +43 -25
- package/.bkit/core/prompts/bkit-utility-update-failures.md +84 -37
- package/.bkit/core/prompts/bkit-utility-update-knowledge.md +88 -42
- package/.bkit/core/prompts/bkit-utility-update-roadmap.md +92 -39
- package/.bkit/core/prompts/bkit-utility-update-tracker.md +159 -60
- package/.bkit/core/workflows/bkit-auto.md +89 -58
- package/.bkit/core/workflows/bkit-build.md +967 -517
- package/.bkit/core/workflows/bkit-debug.md +555 -387
- package/.bkit/core/workflows/bkit-design.md +319 -283
- package/.bkit/core/workflows/bkit-plan.md +319 -342
- package/.bkit/core/workflows/bkit-ship.md +525 -328
- package/.bkit/shared/.agents/plugins/bkit/hooks.json +10 -0
- package/.bkit/shared/.bkit/.env.example +2 -2
- package/.bkit/shared/.claude/bkit-cloud.md +12 -10
- package/.bkit/shared/.claude/settings.json +14 -0
- package/.bkit/shared/.codex/bkit-cloud.md +98 -0
- package/.bkit/shared/.codex/hooks.json +20 -0
- package/.bkit/shared/.cursor/bkit-cloud.md +3 -3
- package/.bkit/shared/.cursor/mcp.json +1 -1
- package/.bkit/shared/.cursor/rules/bkit-rules.mdc +1 -1
- package/.bkit/shared/.gitattributes +1 -1
- package/.bkit/shared/.mcp.json +1 -1
- package/.bkit/shared/.opencode/opencode.json +12 -1
- package/.bkit/shared/CLAUDE.md +6 -2
- package/.bkit/shared/GEMINI.md +5 -2
- package/.bkit/shared/docs/architecture.md +4 -7
- package/.bkit/shared/docs/data-schema.md +4 -7
- package/.bkit/shared/docs/deployments.md +241 -168
- package/.bkit/shared/docs/design.md +11 -12
- package/.bkit/shared/docs/noise.md +8 -7
- package/.bkit/shared/docs/observability.md +5 -8
- package/.bkit/shared/docs/security.md +35 -17
- package/.bkit/shared/docs/setup.md +29 -18
- package/.bkit/shared/docs/technology.md +3 -6
- package/.bkit/shared/docs/testing.md +289 -174
- package/.bkit/shared/gitignore +6 -2
- package/.bkit/templates/.claude/hooks/bkit-cloud-bootstrap.sh +15 -16
- package/.bkit/templates/.cursor/Dockerfile +12 -8
- package/.bkit/templates/.cursor/environment.json +1 -1
- package/.bkit/templates/.github/ISSUE_TEMPLATE/bkit-bug.yml +10 -8
- package/.bkit/templates/.github/ISSUE_TEMPLATE/bkit-change.yml +45 -12
- package/.bkit/templates/.github/ISSUE_TEMPLATE/bkit-idea.yml +3 -3
- package/.bkit/templates/.github/renovate.json5 +34 -6
- package/.bkit/templates/.github/workflows/bkit-ci.yml +54 -51
- package/.bkit/templates/.github/workflows/bkit-cloud.yml +34 -33
- package/.bkit/templates/.github/workflows/bkit-health.yml +97 -0
- package/.bkit/templates/.github/workflows/bkit-renovate.yml +5 -4
- package/.bkit/templates/.github/workflows/bkit-trivy.yml +5 -4
- package/.bkit/templates/.husky/pre-commit +2 -2
- package/.bkit/templates/.husky/pre-push +96 -36
- package/.bkit/templates/.prettierignore +6 -0
- package/.bkit/templates/.vale.ini +27 -27
- package/.bkit/templates/context/bkit-cloudrun.md +23 -15
- package/.bkit/templates/context/bkit-expo.md +70 -52
- package/.bkit/templates/context/bkit-github.md +93 -56
- package/.bkit/templates/context/bkit-inngest.md +21 -15
- package/.bkit/templates/context/bkit-maestro.md +22 -16
- package/.bkit/templates/context/bkit-playwright.md +23 -17
- package/.bkit/templates/context/bkit-resend.md +12 -10
- package/.bkit/templates/context/bkit-sentry.md +30 -20
- package/.bkit/templates/context/bkit-serena.md +8 -7
- package/.bkit/templates/context/bkit-stripe.md +14 -13
- package/.bkit/templates/context/bkit-supabase.md +16 -13
- package/.bkit/templates/context/bkit-tavily.md +14 -11
- package/.bkit/templates/context/bkit-vercel.md +27 -18
- package/.bkit/templates/docs/capabilities.md +15 -14
- package/.bkit/templates/scripts/ci/{check-accepted-divergences.mjs → bkit-check-accepted-divergences.mjs} +6 -3
- package/.bkit/templates/scripts/ci/{check-accepted-divergences.test.mjs → bkit-check-accepted-divergences.test.mjs} +3 -3
- package/.bkit/templates/scripts/ci/{check-capstone.mjs → bkit-check-capstone.mjs} +2 -2
- package/.bkit/templates/scripts/ci/{check-capstone.test.mjs → bkit-check-capstone.test.mjs} +4 -4
- package/.bkit/templates/scripts/ci/{check-dependency-audit.mjs → bkit-check-dependency-audit.mjs} +103 -18
- package/.bkit/templates/scripts/ci/{check-dependency-audit.test.mjs → bkit-check-dependency-audit.test.mjs} +31 -3
- package/.bkit/templates/scripts/ci/bkit-machine-lock.sh +387 -0
- package/.bkit/templates/scripts/ci/bkit-test-awake.mjs +75 -0
- package/.bkit/templates/scripts/ci/bkit-test-awake.test.mjs +160 -0
- package/.bkit/templates/scripts/ci/lanes/{resolve-push-base.mjs → bkit-resolve-push-base.mjs} +3 -3
- package/.bkit/templates/scripts/ci/lanes/{resolve-push-base.test.mjs → bkit-resolve-push-base.test.mjs} +4 -4
- package/.bkit/templates/scripts/cleanup/bkit-disk-prune.mjs +10 -2
- package/.bkit/templates/scripts/graphify/bkit-graph-drift.py +1 -1
- package/.bkit/templates/scripts/graphify/bkit-graph-eager.py +3 -3
- package/.bkit/templates/scripts/graphify/bkit-graph-embed.py +63 -0
- package/.bkit/templates/scripts/graphify/bkit-graph-imports.py +2 -2
- package/.bkit/templates/scripts/graphify/bkit-graph-pre-push.sh +69 -18
- package/.bkit/templates/scripts/graphify/bkit-graph-repair.py +3 -3
- package/.bkit/templates/scripts/graphify/bkit-graph-surface.py +1 -1
- package/.bkit/templates/scripts/graphify/bkit-graphify-graphml.py +1 -1
- package/.bkit/templates/scripts/graphify/bkit-graphify-rollup.py +197 -126
- package/.bkit/templates/scripts/graphify/bkit-graphify.sh +64 -41
- package/.bkit/templates/scripts/slop/bkit-slop-type-suppression.mjs +23 -7
- package/.bkit/templates/slop-scan.config.json +9 -2
- package/CHANGELOG.md +231 -0
- package/README.md +278 -89
- package/dist/checks/after/auth.js +36 -33
- package/dist/checks/after/ci-yml.js +91 -30
- package/dist/checks/after/github.js +91 -17
- package/dist/checks/after/index.js +22 -11
- package/dist/checks/after/suppression.js +8 -5
- package/dist/checks/after/tools.js +111 -114
- package/dist/checks/before/context-fetch.js +218 -33
- package/dist/checks/before/env.js +3 -3
- package/dist/checks/before/files.js +5 -3
- package/dist/checks/before/index.js +20 -3
- package/dist/checks/before/repo.js +197 -2
- package/dist/checks/status-holes.js +739 -114
- package/dist/checks/tips/catalogue.js +70 -19
- package/dist/checks/tips/detect.js +62 -0
- package/dist/checks/tips/index.js +51 -9
- package/dist/cli.js +234 -124
- package/dist/commands/analysis.js +174 -141
- package/dist/commands/ci/ci.js +302 -25
- package/dist/commands/ci/pins.js +142 -0
- package/dist/commands/ci/push-gate.js +194 -0
- package/dist/commands/comply.js +54 -91
- package/dist/commands/install/doctor.js +2 -2
- package/dist/commands/install/install.js +50 -19
- package/dist/commands/install/uninstall.js +82 -55
- package/dist/commands/install/upgrade.js +21 -11
- package/dist/commands/land.js +137 -17
- package/dist/commands/lib.js +295 -21
- package/dist/commands/registry.js +10 -2
- package/dist/commands/setup/setup.js +8 -7
- package/dist/commands/stats.js +175 -0
- package/dist/commands/tips.js +7 -3
- package/dist/commands/workflow/branches.js +1873 -152
- package/dist/commands/workflow/challenge.js +609 -0
- package/dist/commands/workflow/completeness.js +97 -0
- package/dist/commands/workflow/context.js +1045 -46
- package/dist/commands/workflow/counters.js +385 -86
- package/dist/commands/workflow/decisions.js +484 -0
- package/dist/commands/workflow/disk.js +214 -56
- package/dist/commands/workflow/fids.js +706 -33
- package/dist/commands/workflow/issues.js +349 -59
- package/dist/commands/workflow/ledgers.js +1123 -37
- package/dist/commands/workflow/locks.js +26 -2
- package/dist/commands/workflow/plan-blocks.js +501 -0
- package/dist/commands/workflow/plan-versions.js +22 -0
- package/dist/commands/workflow/plans.js +205 -0
- package/dist/commands/workflow/prs.js +154 -35
- package/dist/commands/workflow/repo.js +58 -8
- package/dist/commands/workflow/roadmap.js +58 -23
- package/dist/commands/workflow/run-facts.js +421 -0
- package/dist/commands/workflow/runs.js +670 -72
- package/dist/commands/workflow/runtime.js +15 -1
- package/dist/commands/workflow/skills.js +1 -0
- package/dist/commands/workflow/status.js +282 -34
- package/dist/commands/workflow/step-table.js +308 -0
- package/dist/commands/workflow/steps.js +703 -96
- package/dist/commands/workflow/summary-findings.js +117 -0
- package/dist/commands/workflow/summary.js +388 -0
- package/dist/commands/workflow/tasks.js +378 -0
- package/dist/commands/workflow/test-blocks.js +231 -0
- package/dist/commands/workflow/tests-changed.js +172 -0
- package/dist/commands/workflow/tests.js +1695 -305
- package/dist/commands/workflow/tracker.js +983 -0
- package/dist/commands/workflow/workflows.js +1014 -222
- package/dist/commands/workflow/worktrees.js +432 -26
- package/dist/install/cloud-env.js +233 -99
- package/dist/install/context-ci-workflow.js +85 -0
- package/dist/install/manifest.js +64 -17
- package/dist/install/modules/antigravity.js +3 -2
- package/dist/install/modules/cloud.js +25 -16
- package/dist/install/modules/codex.js +12 -2
- package/dist/install/modules/core.js +1090 -48
- package/dist/install/modules/cursor.js +6 -6
- package/dist/install/modules/opencode.js +13 -7
- package/dist/install/template-notes.js +116 -0
- package/dist/install/version-file.js +9 -4
- package/dist/ledgers/compact.js +87 -0
- package/dist/ledgers/journal.js +233 -0
- package/dist/ledgers/migrate.js +81 -0
- package/dist/ledgers/status.js +176 -13
- package/dist/ledgers/telemetry.js +1010 -125
- package/dist/render/hosts.js +104 -14
- package/dist/render/models.js +12 -0
- package/dist/shared/bkit-latest.js +26 -4
- package/dist/shared/branches.js +3 -1
- package/dist/shared/dep-updater.js +49 -0
- package/dist/shared/egress.js +8 -1
- package/dist/shared/json.js +20 -7
- package/dist/shared/package-manager.js +6 -0
- package/dist/shared/settings.js +181 -24
- package/dist/shared/text.js +333 -0
- package/dist/shared/timeouts.js +2 -0
- package/dist/tools/cli-doc.js +97 -0
- package/dist/tools/grammar-density.js +183 -0
- package/dist/tools/instructions-sources.js +720 -0
- package/dist/tools/instructions.js +1623 -0
- package/package.json +156 -51
- package/.bkit/core/.bkit/lite.md +0 -73
- package/.bkit/core/engine/commands/harvest.ts +0 -459
- package/.bkit/core/engine/commands/workflow/workstreams.ts +0 -166
- package/.bkit/core/engine/tools/wording.ts +0 -748
- package/.bkit/core/prompts/bkit-build-challenge-reconcile.md +0 -69
- package/.bkit/core/prompts/bkit-build-challenge-remediate.md +0 -71
- package/.bkit/core/prompts/bkit-build-challenge-tests.md +0 -74
- package/.bkit/core/prompts/bkit-build-plan-execute.md +0 -76
- package/.bkit/core/prompts/bkit-build-summary.md +0 -94
- package/.bkit/core/prompts/bkit-debug-summary.md +0 -96
- package/.bkit/core/prompts/bkit-design-summary.md +0 -107
- package/.bkit/core/prompts/bkit-plan-complexity-check.md +0 -67
- package/.bkit/core/prompts/bkit-plan-complexity-split.md +0 -88
- package/.bkit/core/prompts/bkit-plan-review-3.md +0 -93
- package/.bkit/core/prompts/bkit-plan-scope-check-1.md +0 -85
- package/.bkit/core/prompts/bkit-plan-scope-check-2.md +0 -85
- package/.bkit/core/prompts/bkit-plan-summary.md +0 -107
- package/.bkit/core/prompts/bkit-ship-summary.md +0 -78
- package/.bkit/templates/scripts/ci/bkit-local-stack-lock.sh +0 -194
- package/dist/commands/harvest.js +0 -353
- package/dist/commands/workflow/workstreams.js +0 -143
- package/dist/tools/wording.js +0 -680
- /package/.bkit/templates/.vale/styles/{House → Bkit}/Filler.yml +0 -0
- /package/.bkit/templates/.vale/styles/{House → Bkit}/Hedging.yml +0 -0
- /package/.bkit/templates/.vale/styles/{House → Bkit}/LLMSlop.yml +0 -0
- /package/.bkit/templates/.vale/styles/{House → Bkit}/Verbose.yml +0 -0
- /package/.bkit/templates/scripts/ci/{accepted-advisories.json → bkit-accepted-advisories.json} +0 -0
- /package/.bkit/templates/scripts/ci/{accepted-divergences.json → bkit-accepted-divergences.json} +0 -0
- /package/.bkit/templates/scripts/launchd/{launchd.env.example → bkit-launchd.env.example} +0 -0
- /package/.bkit/templates/scripts/launchd/{ai.bkit.launchd.plist → bkit-launchd.plist} +0 -0
|
@@ -1,158 +1,215 @@
|
|
|
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
|
# Dead Code Audit
|
|
8
8
|
|
|
9
9
|
> [!CAUTION]
|
|
10
|
-
> **Purpose:**
|
|
10
|
+
> **Purpose:** The reachability of code, config, routes, events, schema and assets: what looks live and never runs.
|
|
11
11
|
>
|
|
12
12
|
> **Rules:**
|
|
13
13
|
>
|
|
14
|
-
> -
|
|
15
|
-
> -
|
|
16
|
-
> -
|
|
17
|
-
> - Any tools mentioned in `Universal Instructions` are examples only; swap for actual tools in final output; drop inapplicable.
|
|
18
|
-
> - Use dense token-efficient phrasing; no filler / hedging / restating; tables > prose, bullets > paragraphs.
|
|
19
|
-
> - Read `.agents/docs.md` → load docs for workflow / step / task; skip missing; cite docs inline where required.
|
|
20
|
-
> - Every claim cites this run's evidence (`file:line`, or command / query and its output) and tool behind it; a previous report's figure, list, or status is a lead, not evidence.
|
|
21
|
-
> - Read this document once at session start; do not trust session memory; do not re-read on every loop iteration.
|
|
22
|
-
> - NEVER delete code, files, routes, schema objects, or dependencies. The report names the destination; applying it is the next step.
|
|
23
|
-
> - A detector proves use, never absence. Dead only when every method that would have found a use found none, and the file was opened. never write a finding from tool output alone.
|
|
14
|
+
> - NEVER delete code, files, routes, schema objects or dependencies. Name the destination in the report, and leave applying it to the next step.
|
|
15
|
+
> - A detector proves use, never absence. Call a candidate dead only when every method that would have found a use found none, and the file was opened.
|
|
16
|
+
> - Never write a finding from tool output alone.
|
|
24
17
|
|
|
25
18
|
## Universal Instructions
|
|
26
19
|
|
|
27
20
|
### Context & Goals
|
|
28
21
|
|
|
29
|
-
Dead code
|
|
22
|
+
Dead code is a control that looks live and is not. Examples: a limiter on an env var that is never set, an E2E assertion on a test id that no component renders, or a config key that calls an API the pinned dependency removed. The failure this audit targets is a control that reads as live in review and never executes.
|
|
30
23
|
|
|
31
|
-
**Applies when:** application source, config
|
|
24
|
+
**Applies when:** the project has application source, config or a package manifest. **If** it has none → write one `N/A` row with its evidence, and never report the surface as "clean".
|
|
32
25
|
|
|
33
|
-
**Cadence:**
|
|
26
|
+
**Cadence:** Run once a quarter. Run an extra pass when a cycle deletes a feature or moves a package.
|
|
34
27
|
|
|
35
|
-
**Anchor Standards:**
|
|
28
|
+
**Anchor Standards:**
|
|
36
29
|
|
|
37
|
-
- Reachability scanner, version run, including production mode, workspaces, and issue types (e.g
|
|
38
|
-
- Compiler unused and unreachable options (e.g
|
|
39
|
-
- Always-true / always-false condition lint (e.g
|
|
40
|
-
- Unused-index advisor (e.g
|
|
41
|
-
- Database inspection CLI (e.g
|
|
42
|
-
- Feature-flag cleanup (e.g
|
|
43
|
-
- Runtime-usage dead-code removal (e.g
|
|
44
|
-
- i18n key checkers (e.g
|
|
30
|
+
- Reachability scanner, version run, including production mode, workspaces, and issue types (e.g., knip, ts-prune, vulture).
|
|
31
|
+
- Compiler unused and unreachable options (e.g., TypeScript `noUnusedLocals`, `noUnusedParameters`, `allowUnreachableCode`; Ruff `F401`, `F841`).
|
|
32
|
+
- Always-true / always-false condition lint (e.g., typescript-eslint `no-unnecessary-condition`).
|
|
33
|
+
- Unused-index advisor (e.g., Supabase Splinter `0005_unused_index`, engine index stats).
|
|
34
|
+
- Database inspection CLI (e.g., `supabase inspect db`); record the version.
|
|
35
|
+
- Feature-flag cleanup (e.g., Uber Piranha).
|
|
36
|
+
- Runtime-usage dead-code removal (e.g., Meta SCARF).
|
|
37
|
+
- i18n key checkers (e.g., `i18n-check`).
|
|
45
38
|
|
|
46
39
|
### Scope
|
|
47
40
|
|
|
48
|
-
-
|
|
49
|
-
-
|
|
50
|
-
-
|
|
51
|
-
-
|
|
52
|
-
-
|
|
53
|
-
-
|
|
54
|
-
-
|
|
55
|
-
-
|
|
56
|
-
- i18n keys, static assets
|
|
57
|
-
-
|
|
41
|
+
- Find in-function unused locals and parameters, unreachable code, and always-true or always-false conditions.
|
|
42
|
+
- Check module reachability (files, exports, types and duplicates), with the default run beside a production-mode run.
|
|
43
|
+
- Check dependency reachability in its own pass: unused, unlisted and unresolved dependencies, binaries, and version-catalog entries.
|
|
44
|
+
- Check env-var reachability: referenced vars against declared ones, and the vars that gate a control.
|
|
45
|
+
- Find feature flags, config keys that nothing reads, and values that are always overridden.
|
|
46
|
+
- Check the assertion surface (test ids), the route surface (forwarders, stale pointers), and client fetches with no route.
|
|
47
|
+
- Find schema objects that nothing reaches.
|
|
48
|
+
- Check both ends of events, background functions and crons.
|
|
49
|
+
- Check i18n keys, static assets and scripts.
|
|
50
|
+
- Measure runtime executions separately from static references.
|
|
58
51
|
|
|
59
52
|
### Out of Scope
|
|
60
53
|
|
|
61
54
|
<!-- prettier-ignore -->
|
|
62
55
|
| Excluded item | Why | Where it belongs |
|
|
63
56
|
| --- | --- | --- |
|
|
64
|
-
| Module-graph shape |
|
|
65
|
-
| Git state, working-tree leftovers, layout |
|
|
66
|
-
| Config that is read but disagrees across environments or with its dashboard |
|
|
67
|
-
| Unused indexes as capacity |
|
|
68
|
-
| An unlisted dependency, or one with an advisory, beyond naming it |
|
|
69
|
-
| An i18n key read but missing from the catalogue, as copy |
|
|
70
|
-
| A detector switched off, as a gate change |
|
|
71
|
-
| Wiring a reachability scanner into CI |
|
|
72
|
-
| Deleting code, files, routes, schema, or dependencies |
|
|
57
|
+
| Module-graph shape | The architecture sweep covers it | `bkit-audit-architecture` |
|
|
58
|
+
| Git state, working-tree leftovers, layout | The repo sweep covers it | `bkit-audit-repo` |
|
|
59
|
+
| Config that is read but disagrees across environments or with its dashboard | The config sweep covers it | `bkit-audit-config` |
|
|
60
|
+
| Unused indexes as capacity | The database sweep covers it | `bkit-audit-database` |
|
|
61
|
+
| An unlisted dependency, or one with an advisory, beyond naming it | The dependency sweep covers it | `bkit-audit-dependencies` |
|
|
62
|
+
| An i18n key read but missing from the catalogue, as copy | The usability sweep covers it | `bkit-audit-usability` |
|
|
63
|
+
| A detector switched off, as a gate change | The gates sweep covers it | `bkit-audit-gates` |
|
|
64
|
+
| Wiring a reachability scanner into CI | It is a gate change | `bkit-audit-gates` |
|
|
65
|
+
| Deleting code, files, routes, schema, or dependencies | The audit only reports | A plan made from this report |
|
|
73
66
|
|
|
74
67
|
### Pre-Flight / Dependencies
|
|
75
68
|
|
|
76
|
-
**Checkpoint:** Check off all core items. Check conditional items only when applicable. Each item: available → tool and version; missing → fallback, gap in `Not Checked`, fix in `Process Improvements`. Unnamed gap reads as passed. never abort for a missing capability.
|
|
77
|
-
|
|
78
|
-
**Credentials:** probe direnv before marking a token / env var missing: `direnv exec . sh -c '[ -n "${VAR}" ] && echo set || echo unset'`; `unset` = missing. Run credentialed CLIs as `direnv exec . <cmd>`. No direnv (cloud session) → plain env check. Report names, never values.
|
|
79
|
-
|
|
80
69
|
#### Core
|
|
81
70
|
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
- [ ] **
|
|
85
|
-
- [ ] **
|
|
86
|
-
- [ ] **
|
|
87
|
-
- [ ] **Reachability Scanner:** Steps 3–4 — ad hoc, not committed dependency (e.g. `pnpm dlx knip`, vulture). Fallback: language-server refs + text search; scanner categories `Not Checked`.
|
|
88
|
-
- [ ] **Web:** Step 16 — fetch anchor standards. Fallback: versions unread.
|
|
71
|
+
- [ ] **Permissions:** every blocked call is recorded.
|
|
72
|
+
- [ ] **Clean Tree:** Steps 2-17 — a clean `git status` at the recorded commit, with one checkout for every step. Fallback: use a detached worktree off the integration branch, and treat candidates on dirty paths as hypotheses.
|
|
73
|
+
- [ ] **Text Search:** Steps 5-14 — repo search (`git grep`, ripgrep). Fallback: none. Mark those steps `Not Checked`.
|
|
74
|
+
- [ ] **Reachability Scanner:** Steps 3-4 — an ad hoc scanner, not a committed dependency (e.g., `pnpm dlx knip`, vulture). Fallback: use language-server references and text search, and mark the scanner categories `Not Checked`.
|
|
75
|
+
- [ ] **Web:** Step 16 — fetch the anchor standards. Fallback: record the versions as unread.
|
|
89
76
|
|
|
90
77
|
#### Conditional
|
|
91
78
|
|
|
92
|
-
|
|
93
|
-
|
|
94
|
-
- [ ] **
|
|
95
|
-
- [ ] **
|
|
96
|
-
- [ ] **
|
|
97
|
-
- [ ] **
|
|
98
|
-
- [ ] **Hosted DB:** SQL migrations or hosted DB → Step 10 — inspection CLI + unused-index advisor (e.g. `supabase inspect db`, Splinter `0005_unused_index`). Fallback: static grep only; runtime zero-use `Not Checked`.
|
|
99
|
-
- [ ] **Runtime Counts:** Production request/job/query stats → Step 15 — e.g. host per-route counts, job-runner runs, `pg_stat_statements`. Fallback: static only; "zero executions" `Not Checked`.
|
|
79
|
+
- [ ] **Compiler Unused Checks:** **If** the language is compiled → Step 2 — the resolved compiler and linter config, not the base file. Fallback: mark `Detectors` `Not Checked`.
|
|
80
|
+
- [ ] **Language Server:** **If** the language is typed → Steps 13-14 — references (Serena, `tsserver`, pyright). Fallback: text search only. Name it, and re-run every empty result before recording a candidate as dead.
|
|
81
|
+
- [ ] **Git History:** **If** the run needs flag ages or introduction dates → Step 6 — `git log -S`. Fallback: mark flag ages `Not Checked`.
|
|
82
|
+
- [ ] **E2E Locators:** **If** E2E tests assert test ids → Step 7. Fallback: skip the step with evidence, and set `Assertions` to `N/A`.
|
|
83
|
+
- [ ] **Hosted DB:** **If** the project has SQL migrations or a hosted DB → Step 10 — the inspection CLI and the unused-index advisor (e.g., `supabase inspect db`, Splinter `0005_unused_index`). Fallback: static grep only. Mark runtime zero-use `Not Checked`.
|
|
84
|
+
- [ ] **Runtime Counts:** **If** production request, job or query stats exist → Step 15 — e.g., host per-route counts, job-runner runs, `pg_stat_statements`. Fallback: static checks only. Mark "zero executions" `Not Checked`.
|
|
100
85
|
|
|
101
86
|
### 🔒 Gate 1: Prerequisites Check
|
|
102
87
|
|
|
103
|
-
|
|
104
|
-
|
|
105
|
-
- [ ] **Gaps named:** every missing item names its fallback and `Not Checked` entry.
|
|
106
|
-
- [ ] **Gate 1 - Verified:** All Core items checked. All applicable Conditional items checked.
|
|
88
|
+
- [ ] **Gaps named:** every missing item names its fallback and its `Not Checked` entry.
|
|
89
|
+
- [ ] **Gate 1 — Verified:** every item above, every Core item and every applicable Conditional item is checked.
|
|
107
90
|
|
|
108
91
|
### Probe Steps
|
|
109
92
|
|
|
110
|
-
- [ ] **Step 1 — Previous Run:**
|
|
111
|
-
- [ ] **Step 2 — Detectors:**
|
|
112
|
-
- [ ] **Step 3 — Reachability:**
|
|
113
|
-
-
|
|
114
|
-
-
|
|
115
|
-
-
|
|
116
|
-
-
|
|
117
|
-
-
|
|
118
|
-
-
|
|
119
|
-
-
|
|
120
|
-
-
|
|
121
|
-
-
|
|
122
|
-
|
|
123
|
-
|
|
124
|
-
|
|
125
|
-
- [ ] **Step
|
|
126
|
-
- [ ] **Step
|
|
93
|
+
- [ ] **Step 1 — Previous Run:** **Done when:** `Previous Run` holds the closure rate, or the run is marked baseline.
|
|
94
|
+
- [ ] **Step 2 — Detectors:** **If** the language is compiled → the scanner sees module exports only, so a dead branch or parameter inside a live function needs the compiler and the linter. Read the resolved config of each workspace, not the base file: the compiler's unused-local, unused-parameter and no-unreachable-code options, and the linter's unused-vars, unreachable and always-true / always-false rules (e.g., `@typescript-eslint/no-unnecessary-condition`). A workspace override or a file-level disable switches one off silently. **If** a detector is off → record a finding, and name it for `bkit-audit-gates` as a gate candidate. Read every unused-import hit in shipped source, because a module that is imported but never registered shows up only there. **If** the linter cannot run on the project's compiler version (e.g., its peer dependency range excludes that version) → record the same detector-off finding, and mark its rules `Not Checked`. **Done when:** `Detectors` lists each config and its resolved value.
|
|
95
|
+
- [ ] **Step 3 — Reachability:** Run the scanner ad hoc, at the same resolved version for both runs, and record the version.
|
|
96
|
+
- Do not add it as a dependency, and do not wire a CI gate this run.
|
|
97
|
+
- Report how ready a baseline config is. The first readiness check is that the scanner ignores exports used inside their own file (e.g., knip `ignoreExportsUsedInFile`). Without that setting the export signal is noise, so run with it and without it, and report both counts. A gate wired before the `False Positives` exclusions are encoded fails on structural noise, and gets disabled.
|
|
98
|
+
- Do not encode test-only code as ignore entries or negated project patterns: plugins add test files as entries, and production mode separates them.
|
|
99
|
+
- Check the scanner's stderr before trusting its output, because a plugin that fails to load drops a whole class of entries and produces false unused files. The signal is files, exports, types and duplicates. Dependency categories go to the `Dependencies` pass, not mixed in here.
|
|
100
|
+
- Run the same version in production mode (or strict mode, which implies production mode and has each workspace use only its own dependencies).
|
|
101
|
+
- **If** an export is used in the default run **and** unused in the production run → it belongs to the test-only or config-only class.
|
|
102
|
+
- Report both runs side by side.
|
|
103
|
+
- Open every duplicate-export alias with zero readers, and run once with entry exports included (e.g., knip `--include-entry-exports`).
|
|
104
|
+
- **If** the scanner has no class-member check (e.g., knip 6 has no `classMembers` issue type) **and** the project has classes → record the gap in `Not Checked`, and fall back to language-server references for each public member.
|
|
105
|
+
|
|
106
|
+
**Done when:** `Reachability` holds the version, both runs, the counts with and without in-file use, and the plugin-load errors.
|
|
107
|
+
|
|
108
|
+
- [ ] **Step 4 — Dependencies:** Run the scanner's dependency mode for each workspace, in the categories the scanner offers (e.g., knip: unused, unlisted, unresolved, unlisted binaries, unreferenced catalog entries). Before giving an unused verdict, search for the name across manifest scripts, config and CI. Config-only consumers are the usual false hits (e.g., linter, formatter, CSS presets, bundler plugins, `@types/*`). An unused dependency is install and supply-chain surface. An unlisted one is hoisted from another workspace. **If** a dependency is unlisted **or** has an advisory → name it for `bkit-audit-dependencies`. **Done when:** `Dependencies` holds one row per candidate: name · class · config-or-CI reader · verdict.
|
|
109
|
+
- [ ] **Step 5 — Env Vars:** Use text search only, because env names are string literals that a language server cannot see. Compare every referenced env var with the declared ones (examples, task runner, typed env schema; the sources are in `Project Instructions`). A var that is referenced and never declared is a control that cannot switch on. Triage each one: a platform-injected var is fine, and an optional var with a safe default is fine (read the default). A var that gates a control, whose absence disables a limiter, auth or a feature, is a finding. The third group is a path that never executes in any environment. Then compare each declared var that gates a control with the secret names set in every runtime environment that runs it (e.g., the host's env list, the secret-sync map), by name only, NEVER the value. A gating var missing from one of those environments is a finding. **If** the run's token cannot read an environment's list → mark that environment `Not Checked` with the permission it needs, never clean. **If** a declaration source was omitted → record the gap in `Process Improvements`. **If** a var gates a control → route it to `docs/failures.jsonl` through `@bkit-utility-update-failures`, and to `bkit-audit-duplication`. **Done when:** `Env Vars` holds one row per referenced-but-undeclared var: group · effect of its absence · verdict, and one row per gating var missing from a runtime environment.
|
|
110
|
+
- [ ] **Step 6 — Config:** Look for the deadness that no scanner reports. (a) Feature flags stuck on or off: a flag that is hardcoded, or the same in every environment, leaves a branch that never runs. For each flag, record every read and its value in each environment. **If** the values are all the same → the other branch is dead, and that is a finding. Age each flag with `git log -S`. **If** a flag is older than 90 days **and** its rollout is complete → record a finding even when the environments differ. (b) Config keys with no reader, or whose name points at a removed object: search for the key, because a language server reads typed source only. (c) A default that a later layer replaces in every environment makes the docs lie. Route a dead control to `docs/failures.jsonl` as in `Env Vars`, not as tidiness. **Done when:** `Config` holds one row per flag or unread key: value per environment · age · verdict.
|
|
111
|
+
- [ ] **Step 7 — Assertions:** **If** E2E tests assert test ids → an unmatched locator passes, so a test id that no component renders makes a vacuous spec with green CI. Extract the test ids the E2E tests assert and the ids that components render (both are string literals), and compare them. **Done when:** `Assertions` lists the asserted-but-unrendered ids, or `none`.
|
|
112
|
+
- [ ] **Step 8 — Routes:** Run two checks; the second is where the defects are.
|
|
113
|
+
- (a) Forwarders. A route whose page only redirects renders nothing: it has no content, adds a round trip, and reads in every route list as a page.
|
|
114
|
+
- Use the project's derived route list rather than eyeballing the tree.
|
|
115
|
+
- The usual justification is that old bookmarked or emailed links must keep working, so check that claim against the deployment doc before accepting it.
|
|
116
|
+
- (b) What still points at a forwarder, or at a path that moved.
|
|
117
|
+
- Grep for the old path, not the new one.
|
|
118
|
+
- A stale cache-invalidation call (e.g., Next.js `revalidatePath` / `revalidateTag`) refreshes the stub, so the page a user reads is never invalidated.
|
|
119
|
+
- Stale end-to-end helpers drive every spec through the redirect.
|
|
120
|
+
- A middleware allowlist arm that can no longer match reads as a live carve-out.
|
|
121
|
+
- A deep-link or email builder whose redirect drops a query param loses the token or id silently.
|
|
122
|
+
- A doc comment naming the old directory is free to fix, and it makes the next reader mistrust every other comment in the file.
|
|
123
|
+
- Relative imports hide the dependency: a repo-wide grep for the path string misses `./old/page`.
|
|
124
|
+
- After a route delete, run the typecheck before believing a grep was complete.
|
|
125
|
+
- Stale generated route types are build output: remove them and re-run, rather than reading them as source errors.
|
|
126
|
+
- A test that pins the call argument (`toHaveBeenCalledWith` the path) cannot tell a live pointer from a dead one, so "a test covers it" is no evidence in this step.
|
|
127
|
+
|
|
128
|
+
**Done when:** `Routes` holds one row per forwarder and per stale pointer: kind · `file:line` · verdict.
|
|
129
|
+
|
|
130
|
+
- [ ] **Step 9 — Fetches:** **If** clients call API paths with raw fetch → run the mirror of `Routes`.
|
|
131
|
+
- The route side asks whether a route has a caller, and this step asks whether a call has a route. Neither finds the other's class.
|
|
132
|
+
- Compiler-checked RPC clients are out of scope, because a missing route fails the typecheck.
|
|
133
|
+
- Include URL pointers outside code (e.g., env-derived webhook URLs, sync configs, fixtures).
|
|
134
|
+
- Raw fetch is the whole exposure: the URL sits inside a template literal, so lint, typecheck and the reachability scanner all pass on a path that returns 404.
|
|
135
|
+
- **If** the stack has two routing layers → model both.
|
|
136
|
+
- The outer framework decides whether a handler runs (a static directory, or a catch-all that forwards a subtree), and the inner router then routes within what was forwarded.
|
|
137
|
+
- A route correctly mounted on the inner router and unreachable from the outer layer is its own class (`stranded`). Checking either layer alone says the route is fine.
|
|
138
|
+
- Read each finding as two questions: the path has no handler, and why nobody noticed. The answer is at the call site: `if (res.ok)` skips the block, and `if (!res.ok) return success` fails open. A 404 is a successful HTTP response, so nothing throws.
|
|
139
|
+
- Name the guard and the route in the report.
|
|
140
|
+
- Before writing a finding up, confirm it against the deployment: the status code of the path beside a known-live path.
|
|
141
|
+
- Do not reintroduce two false positives: a path in a doc comment is not a call, and a prefix test (`startsWith`) is not a request.
|
|
142
|
+
- When you change the extraction, the fetched-path count must go up, not only the findings list get shorter. The dangerous failure is silent: an extractor that stops at `?` never reports the URL, so nobody sees it.
|
|
143
|
+
- **If** the project has no script for this → extract the literals and match routes by hand, and record the gap in `Process Improvements`.
|
|
144
|
+
|
|
145
|
+
**Done when:** `Fetches` holds one row per unreachable call and per stranded route: path · call-site guard · deployment status · verdict.
|
|
146
|
+
|
|
147
|
+
- [ ] **Step 10 — Schema:** This step is the only one here for SQL migrations or a hosted DB. An unused column or an orphan SQL function still costs migrations and access review. From the schema source (migrations, schema file or generated types), take each table, column, view, SQL function and access policy (e.g., RLS), and search for it in code (table calls, columns, RPC), in other SQL (triggers, policies, functions) and in deployed serverless functions (e.g., edge functions). An object with zero references in all three is a candidate. At runtime on the deployed DB, check for tables with no scans or writes since the stats reset (record the reset time), read the inspection CLI's table and index stats, and run the unused-index advisor. Name unused indexes for `bkit-audit-database` as well, without duplicating its capacity finding. **If** traffic is thin **or** the app is pre-launch → zero use marks a static candidate, never proof on its own. **Done when:** `Schema` holds one row per candidate: object · static refs · runtime counts · reset time · verdict.
|
|
148
|
+
- [ ] **Step 11 — Events:** Jobs, crons and the event bus are the mirror of `Fetches` for background work. Event names are string literals, so the scanner and the language server are blind to them. List every send, every registered function with its trigger or cron, and every cron with its target. Check that each sent event reaches a registered function, that each registered trigger has a sender or a cron, and that each cron has an existing target. A function with no trigger is dead. An event with no function is a control that cannot fire, so route it as in `Env Vars`. **Done when:** `Events` holds one row per name: sender · function · cron target · verdict.
|
|
149
|
+
- [ ] **Step 12 — Strings:** (a) Message catalogue: diff the keys against the reads in each app and in shared UI, both ways (`i18n-check` or a search script). A key with no reader is dead. A read key missing from the catalogue renders the key name. A language server is often blind here, so search. Name each key missing from the catalogue for `bkit-audit-usability`. (b) Static assets: list the shipped assets (email templates included), and search for each basename in code, config and CSS. The scanner skips assets, and a native bundle ships unused ones. (c) Scripts: for each manifest script and each file in the scripts tree, search for its name in CI, hooks, the task runner, docs and other scripts. Also search for its stem and check every process-spawn site (e.g., `spawn`, `exec`, a directory listing filtered by extension), because a path built at runtime escapes a name search. A script with no invoker is a candidate. A script invoked only from docs is a candidate, with the reader to update. **Done when:** `Strings` holds one row per unused key, missing key, unread asset and uninvoked script.
|
|
150
|
+
- [ ] **Step 13 — False Positives:** Filter these classes before reading anything as a finding. They are structural and recur on every run.
|
|
151
|
+
- Ambient module augmentation has zero importers by design and applies through the compiler include, so it is never dead.
|
|
152
|
+
- Platform file splits (e.g., RN `.ios` / `.android` / `.web`): one specifier resolves to a per-platform file the scanner cannot follow, so unresolved entries are noise.
|
|
153
|
+
- The filter hides the opposite case, so check once per run that, for each platform pair, the platform that would load that variant imports the parent.
|
|
154
|
+
- A single-platform component carrying the other platform's file is dead and invisible, because both resolve through the same specifier.
|
|
155
|
+
- Files referenced from config, not code: check the referencing config before believing a file unused (app config, CI, test-runner project dependencies, agent hooks, deployed functions, an explicit worker registry).
|
|
156
|
+
- Test-only exports: an export whose only importer is a test is a seam, not dead code.
|
|
157
|
+
- Report them apart from unreferenced code, and never delete them.
|
|
158
|
+
- A drift test is not a reader: a generated artefact referenced only by its generator and a drift test (no runtime reader) is a finding, not a seam.
|
|
159
|
+
- A default export that a preview server requires while code imports the named one.
|
|
160
|
+
- Mock-factory keys: no scanner and no language server sees them, so a key inside a mock factory is a real use.
|
|
161
|
+
|
|
162
|
+
**Done when:** `Candidates` names each class and what it removed.
|
|
163
|
+
|
|
164
|
+
- [ ] **Step 14 — Eliminate:** Use the language server before opening files. One reference found means the candidate is not dead, and that verdict is sound even though the converse is not.
|
|
165
|
+
- For each surviving unused-export candidate, find the symbol, then find its references. Any hit ends the candidate.
|
|
166
|
+
- **If** the result is empty → fall through to text search, and re-run the empty language-server query once more before recording it.
|
|
167
|
+
- Record both measurements.
|
|
168
|
+
- Pace the reference queries: back-to-back calls collapse to zero, and a partial answer looks exactly like a dead symbol. An empty result is inconclusive, not proof of absence.
|
|
169
|
+
- Text search over-reports (comments, same-named symbols in other modules), and the language server under-reports, so agreement between them is the signal.
|
|
170
|
+
- Run the search in addition to the language server, never instead of it:
|
|
171
|
+
- An unused export needs zero matches repo-wide other than its own definition: search, subtract the defining file, and ignore prose comments.
|
|
172
|
+
- An unused file is not reached from JSON, YAML or other config that no typed tool reads.
|
|
173
|
+
- An env-var finding is a control, not an optional setting with a working default.
|
|
174
|
+
- A test id asserted in end-to-end tests exists on a component.
|
|
175
|
+
- Write no finding without opening the file, and cite `file:line` and the method.
|
|
176
|
+
- Non-typed surfaces (markdown, ledgers, YAML, SQL, shell, string literals) take search, not the language server.
|
|
177
|
+
|
|
178
|
+
**Done when:** every survivor in `Candidates` has its `file:line`, its method and the zero-reference re-run.
|
|
179
|
+
|
|
180
|
+
- [ ] **Step 15 — Runtime:** **If** production request, job or query stats exist → compare them with the static results: static analysis says what is unreferenced, and production says what ran. Rank the survivors by a recent window of per-route counts or logs, job runs and SQL function query stats. "Zero executions" is not "zero static references". **If** traffic is thin **or** the app is pre-launch → the counts are a signal, never proof, and an uncalled route is not dead. **Done when:** `Runtime` holds the window, the source and the zero-execution rows, or the skip.
|
|
181
|
+
- [ ] **Step 16 — 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 anchor and per scanner issue type, each marked checked (naming the step), not applicable (saying why) or 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.
|
|
182
|
+
- [ ] **Step 17 — Anything Else:** (a) Give a one-line verdict on each change since the previous report's commit that touches reachability: features or packages deleted or moved, exports and files, dependencies, env vars and flags, routes and fetch URLs, events, functions and crons, migrations, i18n, assets, and manifest scripts. (b) In a bounded pass of about 30 minutes, note what a senior code-health reviewer would flag that no step asks about. Read what happened since the previous run (incidents, new `docs/failures.jsonl` rows, `bkit-audit-logs` reports, 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`.
|
|
127
183
|
|
|
128
184
|
### 🔒 Gate 2: Probes Check
|
|
129
185
|
|
|
130
|
-
**
|
|
131
|
-
|
|
132
|
-
- [ ] **
|
|
133
|
-
- [ ] **
|
|
134
|
-
- [ ] **
|
|
135
|
-
- [ ] **
|
|
136
|
-
- [ ] **
|
|
186
|
+
- [ ] **Steps complete:** every step is `[x]`, or skipped with evidence that its surface is absent.
|
|
187
|
+
- [ ] **Evidence:** every finding cites evidence someone can check again, and the tool that produced it.
|
|
188
|
+
- [ ] **Candidates eliminated:** every survivor's file was opened.
|
|
189
|
+
- [ ] **Use ends a candidate:** every candidate for which a method found a use was ended.
|
|
190
|
+
- [ ] **Re-runs:** every zero-reference result was re-run.
|
|
191
|
+
- [ ] **Re-runs recorded:** both measurements of every re-run are recorded.
|
|
192
|
+
- [ ] **Tree untouched:** no code, config, schema or dependency changed.
|
|
193
|
+
- [ ] **Gate 2 — Verified:** every item above holds.
|
|
137
194
|
|
|
138
195
|
## Findings
|
|
139
196
|
|
|
140
197
|
<!-- prettier-ignore -->
|
|
141
198
|
| Severity | Use |
|
|
142
199
|
| --- | --- |
|
|
143
|
-
| `CRITICAL` |
|
|
144
|
-
| `HIGH` |
|
|
145
|
-
| `MEDIUM` |
|
|
146
|
-
| `LOW` |
|
|
200
|
+
| `CRITICAL` | A dead control on auth, a limiter or validation (the path never executes). A client fetch whose error path treats failure as success, so the missing route never surfaces |
|
|
201
|
+
| `HIGH` | A user-facing or background path with no handler, or a handler nothing can reach. An end-to-end assertion that passes because its target does not exist. An event or cron with one end missing |
|
|
202
|
+
| `MEDIUM` | A file or export with zero references after elimination. A feature flag older than 90 days whose rollout is complete. An unused or unlisted dependency. An i18n key with no reader, or a reader whose key is missing from the catalogue |
|
|
203
|
+
| `LOW` | A doc comment naming a moved path. A test-only export (its own class, never a delete). A preview-only default export |
|
|
147
204
|
|
|
148
|
-
|
|
205
|
+
Within a severity, list dead controls first.
|
|
149
206
|
|
|
150
207
|
<!-- prettier-ignore -->
|
|
151
208
|
| ID | Severity | Location | Evidence | Expected |
|
|
152
209
|
| --- | --- | --- | --- | --- |
|
|
153
210
|
| PENDING | PENDING | PENDING | PENDING | PENDING |
|
|
154
211
|
|
|
155
|
-
|
|
212
|
+
**If** the run finds nothing → write one row: `None`.
|
|
156
213
|
|
|
157
214
|
## Report
|
|
158
215
|
|
|
@@ -245,17 +302,17 @@ PENDING
|
|
|
245
302
|
|
|
246
303
|
### 🔒 Gate 3: Report Check
|
|
247
304
|
|
|
248
|
-
**
|
|
249
|
-
|
|
250
|
-
- [ ] **
|
|
251
|
-
- [ ] **
|
|
252
|
-
- [ ] **Series:** `Reachability` counts and `Runtime` zeroes beside previous report's numbers, or
|
|
253
|
-
- [ ] **Writes:** only this report
|
|
254
|
-
- [ ] **
|
|
255
|
-
- [ ] **
|
|
256
|
-
- [ ] **
|
|
257
|
-
|
|
258
|
-
|
|
305
|
+
- [ ] **No placeholders:** no `PENDING` is left.
|
|
306
|
+
- [ ] **Summary:** `Summary` gives the count per severity.
|
|
307
|
+
- [ ] **Candidates:** `Summary` gives the candidate count.
|
|
308
|
+
- [ ] **Survivors:** `Summary` gives the surviving count.
|
|
309
|
+
- [ ] **Series:** the report shows `Reachability` counts and `Runtime` zeroes beside the previous report's numbers, or marks the run as baseline.
|
|
310
|
+
- [ ] **Writes:** this run changed only this report, the template's `Project Instructions` and its own `docs/failures.jsonl` rows.
|
|
311
|
+
- [ ] **Throwaways removed:** every throwaway worktree or remote target is removed.
|
|
312
|
+
- [ ] **Process Improvements:** `Universal` and `Project` are both filled.
|
|
313
|
+
- [ ] **Suggested Issues:** every `MEDIUM`+ finding ID is in exactly one `Suggested Issues` row.
|
|
314
|
+
- [ ] **Next Step:** every `Suggested Issues` row has a `Next Step`.
|
|
315
|
+
- [ ] **Gate 3 — Verified:** every item above holds.
|
|
259
316
|
|
|
260
317
|
<!-- bkit:end -->
|
|
261
318
|
|