@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,9 +1,9 @@
|
|
|
1
|
-
<!-- Note: Reports live at `docs/audits/{YYYYMM}/{slug}.md`. `{YYYYMM}` = UTC month of this run. `{slug}` = template basename without `bkit-audit-` and `.md`. **If** that month already has `{slug}.md` or `{slug}-{TIMESTAMP}.md` → write `{slug}-{TIMESTAMP}.md` (`{TIMESTAMP}` = `date -u +%Y%m%dT%H%M%SZ`). Never overwrite. The report is stamped with a `bkit:anchor` block recording the audited commit (`baseSha`) and branch (`baseRef`); never hand-author or edit it. `@bkit-audit-generate` fills this template. -->
|
|
2
|
-
|
|
3
1
|
<!-- bkit:start -->
|
|
4
2
|
|
|
5
3
|
{{BKIT_MANAGED_MARKER}}
|
|
6
4
|
|
|
5
|
+
<!-- Note: @bkit-audit-generate fills this template. The report lives at `docs/audits/{YYYYMM}/{slug}.md`, where `{YYYYMM}` is the UTC month of the run and `{slug}` is this file's name without `bkit-audit-` and `.md`. **If** that month already has `{slug}.md` or `{slug}-{TIMESTAMP}.md` → write `{slug}-{TIMESTAMP}.md`, where `{TIMESTAMP}` is the output of `date -u +%Y%m%dT%H%M%SZ`. NEVER overwrite an earlier report. The report is stamped with a `bkit:anchor` block that records the audited commit (`baseSha`) and branch (`baseRef`). NEVER write or edit that block by hand. -->
|
|
6
|
+
|
|
7
7
|
# Slop Audit
|
|
8
8
|
|
|
9
9
|
> [!CAUTION]
|
|
@@ -11,125 +11,129 @@
|
|
|
11
11
|
>
|
|
12
12
|
> **Rules:**
|
|
13
13
|
>
|
|
14
|
-
> -
|
|
14
|
+
> - Never recommend adding a suppression.
|
|
15
|
+
> - Keep the scanner config byte-identical to the committed one.
|
|
15
16
|
|
|
16
17
|
## Universal Instructions
|
|
17
18
|
|
|
18
19
|
### Context & Goals
|
|
19
20
|
|
|
20
|
-
Each suppression made sense in
|
|
21
|
+
Each suppression made sense in the PR that added it, and nothing reads them again. A glob that hides one deliberate pattern keeps hiding whatever lands under it, and an unexamined suppression looks the same as an examined one. This audit reads every suppression list end to end.
|
|
21
22
|
|
|
22
|
-
**Applies when:** source under linter, type checker, scanner
|
|
23
|
+
**Applies when:** the source is under a linter, type checker, scanner or test runner. **If** none of these exists, **or** there is no scanner and no in-code suppression → write one `N/A` row with its evidence, and never report the surface as "clean".
|
|
23
24
|
|
|
24
|
-
**Cadence:**
|
|
25
|
+
**Cadence:** Run once a quarter. Run an extra pass when the override count exceeds the previous report's, or when the pinned scanner version changes.
|
|
25
26
|
|
|
26
27
|
**Anchor Standards:**
|
|
27
28
|
|
|
28
|
-
- Slop scanner at pinned version (e.g
|
|
29
|
-
- Strictest preset of type-aware linter (e.g
|
|
30
|
-
- Type-coverage tool (e.g
|
|
31
|
-
- Disable-comment rules (e.g
|
|
32
|
-
- Cognitive Complexity (SonarSource white paper; e.g
|
|
33
|
-
- Mutation testing (e.g
|
|
29
|
+
- Slop scanner at pinned version (e.g., `slop-scan`).
|
|
30
|
+
- Strictest preset of type-aware linter (e.g., typescript-eslint `strict-type-checked`, mypy `--strict`; rule list changes in minors).
|
|
31
|
+
- Type-coverage tool (e.g., `type-coverage --strict`).
|
|
32
|
+
- Disable-comment rules (e.g., ESLint `reportUnusedDisableDirectives`, `eslint-comments/require-description`, Ruff `RUF100`).
|
|
33
|
+
- Cognitive Complexity (SonarSource white paper; e.g., `eslint-plugin-sonarjs`).
|
|
34
|
+
- Mutation testing (e.g., Stryker, mutmut).
|
|
34
35
|
|
|
35
36
|
### Scope
|
|
36
37
|
|
|
37
|
-
-
|
|
38
|
-
-
|
|
39
|
-
-
|
|
40
|
-
-
|
|
41
|
-
-
|
|
38
|
+
- List the scanner config's overrides and ignores.
|
|
39
|
+
- Find in-code suppressions: disable comments (e.g., `eslint-disable`, `# noqa`, `//nolint`), type-checker ignores (e.g., `@ts-expect-error`, `# type: ignore`), casts, escape-hatch types (e.g., `any`, `Any`), non-null assertions on boundary values, and test-weakening markers (skip / only / fail / soft / retry overrides).
|
|
40
|
+
- List config suppressions in the linter, type checker, coverage, formatter and prose linter.
|
|
41
|
+
- Measure inferred suppressions: implicit escape-hatch types, unawaited async work and defensive noise.
|
|
42
|
+
- Find complexity hotspots.
|
|
43
|
+
- Measure surviving mutants.
|
|
42
44
|
|
|
43
45
|
### Out of Scope
|
|
44
46
|
|
|
45
47
|
<!-- prettier-ignore -->
|
|
46
48
|
| Excluded item | Why | Where it belongs |
|
|
47
49
|
| --- | --- | --- |
|
|
48
|
-
| Adding a suppression |
|
|
49
|
-
| Fixing / deleting findings |
|
|
50
|
-
| Dead files beyond reference check |
|
|
51
|
-
| Test quality beyond mutants / mock-only assertions |
|
|
50
|
+
| Adding a suppression | It is never recommended | — |
|
|
51
|
+
| Fixing / deleting findings | The audit only reports | A plan made from this report |
|
|
52
|
+
| Dead files beyond reference check | The dead-code sweep owns them | `bkit-audit-dead-code` |
|
|
53
|
+
| Test quality beyond mutants / mock-only assertions | The testing sweep owns it | `bkit-audit-testing` |
|
|
52
54
|
|
|
53
55
|
### Verdicts
|
|
54
56
|
|
|
55
|
-
- **FIX:** hides real failure. Name change and override
|
|
56
|
-
- **DELETE:** file dead, scratch
|
|
57
|
-
- **
|
|
58
|
-
- **
|
|
57
|
+
- **FIX:** it hides a real failure. Name the change, and the override or comment it removes.
|
|
58
|
+
- **DELETE:** the file is dead, scratch or a finished one-off. For a config entry, use it only when the entry hides whole files. Name the file after the reference check.
|
|
59
|
+
- **PRUNE:** the suppression entry hides 0 findings. Name the entry to remove.
|
|
60
|
+
- **KEEP:** it is intentional. Record the reason beside the suppression, because a `KEEP` with no reason counts as unexamined on the next run.
|
|
61
|
+
- **OTHER:** it fits no other verdict. Say why. **If** the same `OTHER` shows up on 2 runs → propose a new verdict in `Process Improvements`.
|
|
59
62
|
|
|
60
|
-
**Rule of thumb:**
|
|
63
|
+
**Rule of thumb:** **If** you can name the concrete bug a suppression hides → it is real debt. **Else** → `KEEP`. These are almost always `KEEP`, because fixing them degrades the code: fail-open middleware, fire-and-forget or best-effort telemetry, tolerant parsing fallbacks, framework-required shapes, thin named data-access or predicate helpers, config-per-file directories, intentional barrels, deliberate duplicate signatures, and duplicated test mock setup.
|
|
61
64
|
|
|
62
65
|
**Always `FIX`:**
|
|
63
66
|
|
|
64
|
-
-
|
|
65
|
-
-
|
|
67
|
+
- A cast or escape-hatch type where data crosses a boundary (SDK call, webhook payload, API response, DB client result). It hides drift that boundary tests catch.
|
|
68
|
+
- A disabled hook-dependency rule (e.g., `react-hooks/exhaustive-deps`) whose effect reads an unlisted value. Read the effect, not the comment.
|
|
66
69
|
|
|
67
70
|
### Pre-Flight / Dependencies
|
|
68
71
|
|
|
69
72
|
#### Core
|
|
70
73
|
|
|
71
|
-
- [ ] **Permissions:** blocked
|
|
72
|
-
- [ ] **Scanner:** Steps 2-4 — pinned in manifest
|
|
73
|
-
- [ ] **Worktree:** Steps 2-8 — detached worktree off default branch. Fallback: Steps 5-7 read-only in main checkout
|
|
74
|
-
- [ ] **Git History:** Steps 5, 8 — full history for blame and churn. Fallback: ages and churn `Not Checked`.
|
|
75
|
-
- [ ] **Web:** Step 9 — fetch anchor standards. Fallback: versions
|
|
74
|
+
- [ ] **Permissions:** every blocked call is recorded.
|
|
75
|
+
- [ ] **Scanner:** Steps 2-4 — the scanner pinned in the manifest (e.g., `slop-scan`). Fallback: skip the scanner steps, and run the code and config steps.
|
|
76
|
+
- [ ] **Worktree:** Steps 2-8 — a detached worktree off the default branch. Fallback: run Steps 5-7 read-only in the main checkout, and mark Steps 3 and 8 `Not Checked`.
|
|
77
|
+
- [ ] **Git History:** Steps 5, 8 — full history, for blame and churn. Fallback: mark ages and churn `Not Checked`.
|
|
78
|
+
- [ ] **Web:** Step 9 — fetch the anchor standards. Fallback: record the versions as unread.
|
|
76
79
|
|
|
77
80
|
#### Conditional
|
|
78
81
|
|
|
79
|
-
- [ ] **Language Server:**
|
|
80
|
-
- [ ] **Typed Lint and Type Coverage:**
|
|
81
|
-
- [ ] **Complexity and Mutation Tools:**
|
|
82
|
+
- [ ] **Language Server:** **If** the language is typed → Step 4 — references (e.g., Serena, `tsserver`). Fallback: text search only, and name it on each `DELETE`.
|
|
83
|
+
- [ ] **Typed Lint and Type Coverage:** **If** the language is typed → Step 7 — typed lint rules and type coverage (e.g., typescript-eslint typed rules, `type-coverage`, mypy). Fallback: count escape-hatch types with text search.
|
|
84
|
+
- [ ] **Complexity and Mutation Tools:** **If** tools exist for the language → Step 8 — complexity and mutation runs (e.g., `eslint-plugin-sonarjs`, Stryker, mutmut). Install them in the worktree only. Fallback: `Not Checked`.
|
|
82
85
|
|
|
83
86
|
### 🔒 Gate 1: Prerequisites Check
|
|
84
87
|
|
|
85
|
-
- [ ] **Gaps named:** every missing item names its fallback and `Not Checked` entry.
|
|
86
|
-
- [ ] **Gate 1 — Verified:**
|
|
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.
|
|
87
90
|
|
|
88
91
|
### Probe Steps
|
|
89
92
|
|
|
90
|
-
- [ ] **Step 1 — Previous Run:** **Done when:**
|
|
91
|
-
- [ ] **Step 2 — Isolate:** Find scanner
|
|
92
|
-
- [ ] **Step 3 — Hidden Findings:**
|
|
93
|
-
- [ ] **Step 4 — Verdicts:** Read each suppressed site, not rule name
|
|
94
|
-
- [ ] **Step 5 — Code Suppressions:** Search source for disable comments, type-checker ignores, escape-hatch types, double casts, single casts
|
|
95
|
-
-
|
|
96
|
-
- Commented-out code
|
|
97
|
-
- `TODO`
|
|
98
|
-
-
|
|
93
|
+
- [ ] **Step 1 — Previous Run:** **Done when:** `Previous Run` holds the closure rate, or the run is marked baseline.
|
|
94
|
+
- [ ] **Step 2 — Isolate:** Find how the scanner runs (package scripts). Create a detached worktree off the default branch, with no new branch. Check that `git status` is clean before you start, and remove the worktree before the report finishes. **Done when:** `Checked` holds the worktree path and its clean status, or the absent scanner is recorded.
|
|
95
|
+
- [ ] **Step 3 — Hidden Findings:** Run the pinned scanner with the committed config, and save the result as a JSON baseline. Under a restore guard, scan with a stripped config (build-artifact ignores only, no overrides, all rules on), then restore the config and `diff` it to confirm it is byte-identical. A suppressed finding is one in the stripped run but not in the baseline. Print a hide count per suppression entry (override block, ignore path, inline disable), so an entry that hides nothing shows up. The stripped count is not a fix list. Count the override blocks. **If** the restore fails → **STOP**, restore the committed config, and record a finding. **Done when:** `Counts` holds the baseline, stripped, suppressed and override-block counts and the hide count per entry, and the config diff is empty.
|
|
96
|
+
- [ ] **Step 4 — Verdicts:** Read each suppressed site, not only its rule name, and give it a verdict. `DELETE` needs a reference check: language-server references where available, plus a text search for the basename (for script and config references the language server lacks). Text search over-reports and the language server under-reports, so agreement between them is the signal. Re-run every empty result once before `DELETE`. Give each suppression entry with a hide count of 0 the verdict `PRUNE`. **Done when:** every suppressed finding and every `PRUNE` entry has a verdict and evidence.
|
|
97
|
+
- [ ] **Step 5 — Code Suppressions:** Search the source for disable comments, type-checker ignores, escape-hatch types, double casts, single casts and non-null assertions on boundary values, test-weakening markers, stray debug output, and `TODO` / `FIXME` / `HACK`. Split product code from test code. In type-level tests, an expected-error directive is an assertion, not a suppression. Drop comment-only hits and import renames. Then:
|
|
98
|
+
- **If** a disable names a rule the resolved config lacks → it suppresses nothing, so it is `FIX`.
|
|
99
|
+
- Commented-out code is `FIX`, unless a comment says why it stays.
|
|
100
|
+
- A `TODO` that cites a closed tracker item is `FIX`.
|
|
101
|
+
- For each suppression, record the introducing commit, date and PR (`git blame`), and whether an agent wrote it (agent branch prefix or `Co-authored-by`).
|
|
99
102
|
|
|
100
|
-
**Done when:** every hit has verdict
|
|
103
|
+
**Done when:** every hit has a verdict, and `Counts` holds the counts per kind, the age distribution and the agent share.
|
|
101
104
|
|
|
102
|
-
- [ ] **Step 6 — Config Suppressions:** List per config: linter rules off
|
|
103
|
-
- [ ] **Step 7 — Inferred Types:** Most escape-hatch typing implicit (e.g
|
|
104
|
-
- [ ] **Step 8 — Hotspots:**
|
|
105
|
-
- [ ] **Step 9 — Standards:** Confirm current version
|
|
106
|
-
- [ ] **Step 10 — Anything Else:** (a)
|
|
105
|
+
- [ ] **Step 6 — Config Suppressions:** List, per config: linter rules turned off or set to warn for globs, and ignore entries; the resolved type-checker config per workspace (not per file), with any relaxed strictness or excludes (strictness is expected to be identical across workspaces); coverage excludes and ignore comments; formatter ignores; and prose-linter ignores and off-switches. **Done when:** every entry is `FIX` or `KEEP`, and `Counts` holds the count per kind.
|
|
106
|
+
- [ ] **Step 7 — Inferred Types:** Most escape-hatch typing is implicit (e.g., `res.json()`, `JSON.parse`, `json.loads`, an untyped SDK return, `catch (e)`). For each package, measure type coverage and any-typed boundary identifiers; unsafe-any lint counts; unawaited or misused async (e.g., floating promises) in request handlers and background jobs, plus a text search for `void <call>(` there, because floating-promise rules ignore `void` by default; and defensive-noise density (unnecessary conditions and assertions, useless catches). On serverless, work after the response is not guaranteed unless it uses a platform API (e.g., Next.js `after()` / `waitUntil`). Run the typed rules from the CLI, and leave the config untouched. **If** there is no typed linting → record that. **Done when:** `Counts` holds the measurements, and each handler violation is a `FIX` row.
|
|
107
|
+
- [ ] **Step 8 — Hotspots:** Rank the top 20 functions by cognitive complexity (threshold 15) times 90-day churn. Mutation-test the 1-2 packages with the most suppressions or casts, and record the surviving-mutant rate. Mock-only assertions are a disguised suppression. **If** a tool is missing → install it in the worktree only. Check that `git status` is clean at the end. **Done when:** `Counts` holds the hotspot table and the mutant rate, or the missing tool is recorded.
|
|
108
|
+
- [ ] **Step 9 — 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 standard, and one per strict-preset rule the resolved config leaves off, 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.
|
|
109
|
+
- [ ] **Step 10 — Anything Else:** (a) Give a one-line verdict on each change since the previous report's commit that touches suppressions: scanner, linter, type-checker, coverage and prose configs; new disables, casts, escape-hatch types and skips; and lint scripts. (b) In a bounded pass of about 30 minutes, note what a senior reviewer of this language would flag that no step asks about. Read what happened since the previous run (incidents, new `docs/failures.jsonl` rows), and ask what no step would catch. **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`.
|
|
107
110
|
|
|
108
111
|
### 🔒 Gate 2: Probes Check
|
|
109
112
|
|
|
110
|
-
- [ ] **Steps complete:** every step `[x]`, or
|
|
111
|
-
- [ ] **Evidence:** every finding cites
|
|
112
|
-
- [ ] **
|
|
113
|
-
- [ ] **
|
|
113
|
+
- [ ] **Steps complete:** every step is `[x]`, or skipped with evidence that its surface is absent.
|
|
114
|
+
- [ ] **Evidence:** every finding cites evidence someone can check again, and the tool that produced it.
|
|
115
|
+
- [ ] **Scanner config unchanged:** the scanner config is byte-identical to the committed one.
|
|
116
|
+
- [ ] **Worktree clean:** the worktree's `git status` is clean.
|
|
117
|
+
- [ ] **Gate 2 — Verified:** every item above holds.
|
|
114
118
|
|
|
115
119
|
## Findings
|
|
116
120
|
|
|
117
121
|
<!-- prettier-ignore -->
|
|
118
122
|
| Severity | Use |
|
|
119
123
|
| --- | --- |
|
|
120
|
-
| `CRITICAL` |
|
|
121
|
-
| `HIGH` |
|
|
122
|
-
| `MEDIUM` |
|
|
123
|
-
| `LOW` | `KEEP`
|
|
124
|
+
| `CRITICAL` | A suppression hides a security, auth or data-loss failure |
|
|
125
|
+
| `HIGH` | A boundary cast or escape-hatch type on untrusted input. A promise that can drop handler work. A skipped or focused test. A blanket disable that names no rule |
|
|
126
|
+
| `MEDIUM` | A reason that no longer matches the code. A disable for a rule the config lacks. A `TODO` that cites a closed item. Relaxed strictness in one workspace |
|
|
127
|
+
| `LOW` | A `KEEP` with no written reason. Commented-out code |
|
|
124
128
|
|
|
125
|
-
Within a severity
|
|
129
|
+
Within a severity, list security and data findings first.
|
|
126
130
|
|
|
127
131
|
<!-- prettier-ignore -->
|
|
128
132
|
| ID | Severity | Verdict | Location | Evidence | Expected |
|
|
129
133
|
| --- | --- | --- | --- | --- | --- |
|
|
130
134
|
| PENDING | PENDING | PENDING | PENDING | PENDING | PENDING |
|
|
131
135
|
|
|
132
|
-
|
|
136
|
+
**If** the run finds nothing → write one row: `None`.
|
|
133
137
|
|
|
134
138
|
## Report
|
|
135
139
|
|
|
@@ -174,13 +178,16 @@ PENDING
|
|
|
174
178
|
|
|
175
179
|
### 🔒 Gate 3: Report Check
|
|
176
180
|
|
|
177
|
-
- [ ] **No placeholders:** no `PENDING` left
|
|
178
|
-
- [ ] **Summary:**
|
|
179
|
-
- [ ] **
|
|
180
|
-
- [ ] **
|
|
181
|
-
- [ ] **
|
|
182
|
-
- [ ] **
|
|
183
|
-
- [ ] **
|
|
181
|
+
- [ ] **No placeholders:** no `PENDING` is left.
|
|
182
|
+
- [ ] **Summary:** `Summary` gives the count per severity.
|
|
183
|
+
- [ ] **Strip counts:** `Summary` gives the baseline, stripped and suppressed counts.
|
|
184
|
+
- [ ] **Series:** the report shows `Counts` beside the previous report's numbers, or marks the run as baseline.
|
|
185
|
+
- [ ] **Writes:** this run changed only this report, the template's `Project Instructions` and its own `docs/failures.jsonl` rows.
|
|
186
|
+
- [ ] **Throwaways removed:** every throwaway worktree or remote target is removed.
|
|
187
|
+
- [ ] **Process Improvements:** `Universal` and `Project` are both filled.
|
|
188
|
+
- [ ] **Suggested Issues:** every `MEDIUM`+ finding ID is in exactly one `Suggested Issues` row.
|
|
189
|
+
- [ ] **Next Step:** every `Suggested Issues` row has a `Next Step`.
|
|
190
|
+
- [ ] **Gate 3 — Verified:** every item above holds.
|
|
184
191
|
|
|
185
192
|
<!-- bkit:end -->
|
|
186
193
|
|