@cbartens/bkit 5.5.1 → 6.1.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.bkit/README.md +167 -154
- package/.bkit/core/.agents/context.md +95 -29
- package/.bkit/core/.agents/docs.md +18 -15
- package/.bkit/core/.agents/plugins/bkit/hooks/bkit-gateguard.cjs +1 -0
- package/.bkit/core/.agents/plugins/bkit/hooks/bkit-guardrails.cjs +6 -5
- package/.bkit/core/.agents/plugins/bkit/hooks/bkit-readguard.cjs +1 -0
- package/.bkit/core/.agents/plugins/bkit/hooks/bkit-rules.cjs +65 -0
- package/.bkit/core/.agents/rules.md +112 -102
- package/.bkit/core/.agents/skills.md +63 -15
- package/.bkit/core/.bkit/README.md +167 -154
- package/.bkit/core/.bkit/authoring.md +747 -0
- package/.bkit/core/.bkit/cli.md +407 -0
- package/.bkit/core/.bkit/cloud.md +283 -195
- package/.bkit/core/.bkit/comparison.md +45 -43
- package/.bkit/core/.bkit/install.md +166 -95
- package/.bkit/core/.bkit/jsonl.md +339 -196
- package/.bkit/core/.bkit/pipeline.md +142 -145
- package/.bkit/core/.bkit/prompts.md +295 -264
- package/.bkit/core/.bkit/providers.md +460 -277
- package/.bkit/core/.bkit/router.md +69 -0
- package/.bkit/core/.bkit/templates.md +530 -256
- package/.bkit/core/.bkit/trackers.md +116 -65
- package/.bkit/core/.bkit/workflows.md +742 -618
- package/.bkit/core/.claude/hooks/bkit-gateguard.cjs +2 -2
- package/.bkit/core/.claude/hooks/bkit-guardrails.cjs +3 -3
- package/.bkit/core/.claude/hooks/bkit-preflight.sh +45 -14
- package/.bkit/core/.codex/hooks/bkit-guardrails.cjs +3 -3
- package/.bkit/core/.codex/hooks/bkit-rules.cjs +57 -0
- package/.bkit/core/.cursor/hooks/bkit-guardrails.cjs +7 -7
- package/.bkit/core/.cursor/hooks/bkit-preflight.sh +47 -12
- package/.bkit/core/.opencode/plugin/bkit-rules.js +89 -0
- package/.bkit/core/AGENTS.md +6 -80
- package/.bkit/core/docs/templates/bkit-audit-accessibility.md +128 -130
- package/.bkit/core/docs/templates/bkit-audit-adoption.md +104 -94
- package/.bkit/core/docs/templates/bkit-audit-agents.md +96 -98
- package/.bkit/core/docs/templates/bkit-audit-aio-seo.md +100 -103
- package/.bkit/core/docs/templates/bkit-audit-analytics.md +141 -107
- package/.bkit/core/docs/templates/bkit-audit-annotations.md +99 -97
- package/.bkit/core/docs/templates/bkit-audit-app-performance.md +122 -121
- package/.bkit/core/docs/templates/bkit-audit-app-store.md +158 -101
- package/.bkit/core/docs/templates/bkit-audit-architecture.md +114 -96
- package/.bkit/core/docs/templates/bkit-audit-ci-performance.md +76 -97
- package/.bkit/core/docs/templates/bkit-audit-config.md +123 -101
- package/.bkit/core/docs/templates/bkit-audit-cost.md +86 -99
- package/.bkit/core/docs/templates/bkit-audit-coverage.md +76 -93
- package/.bkit/core/docs/templates/bkit-audit-database.md +102 -95
- package/.bkit/core/docs/templates/bkit-audit-dead-code.md +165 -108
- package/.bkit/core/docs/templates/bkit-audit-deferrals.md +115 -109
- package/.bkit/core/docs/templates/bkit-audit-dependencies.md +265 -113
- package/.bkit/core/docs/templates/bkit-audit-documentation.md +119 -118
- package/.bkit/core/docs/templates/bkit-audit-duplication.md +140 -111
- package/.bkit/core/docs/templates/bkit-audit-failures.md +111 -106
- package/.bkit/core/docs/templates/bkit-audit-flakes.md +100 -99
- package/.bkit/core/docs/templates/bkit-audit-gates.md +107 -103
- package/.bkit/core/docs/templates/bkit-audit-issues.md +105 -105
- package/.bkit/core/docs/templates/bkit-audit-llm.md +134 -85
- package/.bkit/core/docs/templates/bkit-audit-logs.md +124 -125
- package/.bkit/core/docs/templates/bkit-audit-models.md +99 -78
- package/.bkit/core/docs/templates/bkit-audit-privacy.md +56 -76
- package/.bkit/core/docs/templates/bkit-audit-prompts.md +63 -78
- package/.bkit/core/docs/templates/bkit-audit-red-team.md +125 -93
- package/.bkit/core/docs/templates/bkit-audit-reliability.md +97 -96
- package/.bkit/core/docs/templates/bkit-audit-repo.md +170 -98
- package/.bkit/core/docs/templates/bkit-audit-security.md +207 -121
- package/.bkit/core/docs/templates/bkit-audit-slop.md +78 -95
- package/.bkit/core/docs/templates/bkit-audit-testing.md +163 -139
- package/.bkit/core/docs/templates/bkit-audit-usability.md +114 -96
- package/.bkit/core/docs/templates/bkit-plan.md +158 -281
- package/.bkit/core/engine/checks/after/auth.ts +40 -37
- package/.bkit/core/engine/checks/after/ci-yml.ts +104 -31
- package/.bkit/core/engine/checks/after/github.ts +95 -17
- package/.bkit/core/engine/checks/after/index.ts +21 -8
- package/.bkit/core/engine/checks/after/suppression.ts +8 -5
- package/.bkit/core/engine/checks/after/tools.ts +125 -123
- package/.bkit/core/engine/checks/before/context-fetch.ts +227 -33
- package/.bkit/core/engine/checks/before/env.ts +3 -3
- package/.bkit/core/engine/checks/before/files.ts +5 -4
- package/.bkit/core/engine/checks/before/index.ts +25 -1
- package/.bkit/core/engine/checks/before/repo.ts +208 -2
- package/.bkit/core/engine/checks/status-holes.ts +916 -123
- package/.bkit/core/engine/checks/tips/catalogue.ts +82 -20
- package/.bkit/core/engine/checks/tips/detect.ts +66 -0
- package/.bkit/core/engine/checks/tips/index.ts +52 -11
- package/.bkit/core/engine/cli.ts +251 -130
- package/.bkit/core/engine/commands/analysis.ts +282 -199
- package/.bkit/core/engine/commands/ci/ci.ts +363 -29
- package/.bkit/core/engine/commands/ci/pins.ts +172 -0
- package/.bkit/core/engine/commands/ci/push-gate.ts +223 -0
- package/.bkit/core/engine/commands/comply.ts +77 -103
- package/.bkit/core/engine/commands/install/doctor.ts +2 -2
- package/.bkit/core/engine/commands/install/install.ts +57 -18
- package/.bkit/core/engine/commands/install/uninstall.ts +86 -55
- package/.bkit/core/engine/commands/install/upgrade.ts +32 -15
- package/.bkit/core/engine/commands/land.ts +139 -18
- package/.bkit/core/engine/commands/lib.ts +381 -22
- package/.bkit/core/engine/commands/registry.ts +10 -2
- package/.bkit/core/engine/commands/setup/setup.ts +8 -7
- package/.bkit/core/engine/commands/stats.ts +260 -0
- package/.bkit/core/engine/commands/tips.ts +10 -5
- package/.bkit/core/engine/commands/workflow/branches.ts +2215 -176
- package/.bkit/core/engine/commands/workflow/challenge.ts +748 -0
- package/.bkit/core/engine/commands/workflow/completeness.ts +109 -0
- package/.bkit/core/engine/commands/workflow/context.ts +1249 -47
- package/.bkit/core/engine/commands/workflow/counters.ts +483 -95
- package/.bkit/core/engine/commands/workflow/decisions.ts +585 -0
- package/.bkit/core/engine/commands/workflow/disk.ts +238 -56
- package/.bkit/core/engine/commands/workflow/fids.ts +811 -33
- package/.bkit/core/engine/commands/workflow/issues.ts +413 -64
- package/.bkit/core/engine/commands/workflow/ledgers.ts +1333 -36
- package/.bkit/core/engine/commands/workflow/locks.ts +28 -2
- package/.bkit/core/engine/commands/workflow/plan-blocks.ts +691 -0
- package/.bkit/core/engine/commands/workflow/plan-versions.ts +21 -0
- package/.bkit/core/engine/commands/workflow/plans.ts +257 -0
- package/.bkit/core/engine/commands/workflow/prs.ts +178 -33
- package/.bkit/core/engine/commands/workflow/repo.ts +66 -8
- package/.bkit/core/engine/commands/workflow/roadmap.ts +72 -22
- package/.bkit/core/engine/commands/workflow/run-facts.ts +492 -0
- package/.bkit/core/engine/commands/workflow/runs.ts +827 -79
- package/.bkit/core/engine/commands/workflow/runtime.ts +25 -1
- package/.bkit/core/engine/commands/workflow/skills.ts +1 -0
- package/.bkit/core/engine/commands/workflow/status.ts +329 -33
- package/.bkit/core/engine/commands/workflow/step-table.ts +381 -0
- package/.bkit/core/engine/commands/workflow/steps.ts +841 -105
- package/.bkit/core/engine/commands/workflow/summary-findings.ts +177 -0
- package/.bkit/core/engine/commands/workflow/summary.ts +544 -0
- package/.bkit/core/engine/commands/workflow/tasks.ts +409 -0
- package/.bkit/core/engine/commands/workflow/test-blocks.ts +254 -0
- package/.bkit/core/engine/commands/workflow/tests-changed.ts +201 -0
- package/.bkit/core/engine/commands/workflow/tests.ts +2124 -330
- package/.bkit/core/engine/commands/workflow/tracker.ts +1195 -0
- package/.bkit/core/engine/commands/workflow/workflows.ts +1197 -235
- package/.bkit/core/engine/commands/workflow/worktrees.ts +543 -24
- package/.bkit/core/engine/install/cloud-env.ts +251 -121
- package/.bkit/core/engine/install/context-ci-workflow.ts +102 -0
- package/.bkit/core/engine/install/manifest.ts +67 -17
- package/.bkit/core/engine/install/modules/antigravity.ts +3 -2
- package/.bkit/core/engine/install/modules/cloud.ts +24 -16
- package/.bkit/core/engine/install/modules/codex.ts +15 -2
- package/.bkit/core/engine/install/modules/core.ts +1196 -45
- package/.bkit/core/engine/install/modules/cursor.ts +6 -6
- package/.bkit/core/engine/install/modules/opencode.ts +18 -6
- package/.bkit/core/engine/install/template-notes.ts +130 -0
- package/.bkit/core/engine/install/version-file.ts +9 -4
- package/.bkit/core/engine/install/write.ts +5 -0
- package/.bkit/core/engine/ledgers/compact.ts +124 -0
- package/.bkit/core/engine/ledgers/journal.ts +291 -0
- package/.bkit/core/engine/ledgers/migrate.ts +92 -0
- package/.bkit/core/engine/ledgers/status.ts +249 -21
- package/.bkit/core/engine/ledgers/telemetry.ts +1397 -253
- package/.bkit/core/engine/render/hosts.ts +118 -14
- package/.bkit/core/engine/render/models.ts +12 -0
- package/.bkit/core/engine/shared/bkit-latest.ts +26 -4
- package/.bkit/core/engine/shared/branches.ts +4 -1
- package/.bkit/core/engine/shared/dep-updater.ts +60 -0
- package/.bkit/core/engine/shared/egress.ts +8 -1
- package/.bkit/core/engine/shared/json.ts +25 -7
- package/.bkit/core/engine/shared/package-manager.ts +9 -0
- package/.bkit/core/engine/shared/settings.ts +243 -31
- package/.bkit/core/engine/shared/text.ts +361 -0
- package/.bkit/core/engine/shared/timeouts.ts +2 -0
- package/.bkit/core/engine/tools/cli-doc.ts +111 -0
- package/.bkit/core/engine/tools/grammar-density.ts +215 -0
- package/.bkit/core/engine/tools/instructions-sources.ts +832 -0
- package/.bkit/core/engine/tools/instructions.ts +1802 -0
- package/.bkit/core/hooks/antigravity-hook.js +25 -10
- package/.bkit/core/hooks/gateguard-engine.js +54 -29
- package/.bkit/core/hooks/guardrails-shell.js +4 -5
- package/.bkit/core/hooks/guardrails-tiers.js +10 -4
- package/.bkit/core/hooks/preflight-linear.sh +9 -9
- package/.bkit/core/hooks/preflight-rules.sh +8 -0
- package/.bkit/core/hooks/readguard-engine.js +29 -10
- package/.bkit/core/hooks/session-rules-advisory.js +61 -0
- package/.bkit/core/prompts/bkit-audit-generate.md +202 -94
- package/.bkit/core/prompts/bkit-build-challenge-1.md +76 -34
- package/.bkit/core/prompts/bkit-build-challenge-2.md +85 -38
- package/.bkit/core/prompts/bkit-build-install-skills.md +50 -28
- package/.bkit/core/prompts/bkit-build-plan-convert.md +85 -0
- package/.bkit/core/prompts/bkit-build-plan-current.md +59 -36
- package/.bkit/core/prompts/bkit-build-plan-gaps-remediate.md +101 -36
- package/.bkit/core/prompts/bkit-build-plan-tasks.md +149 -0
- package/.bkit/core/prompts/bkit-build-plan-tests.md +120 -0
- package/.bkit/core/prompts/bkit-build-plan-verify.md +104 -43
- package/.bkit/core/prompts/bkit-debug-abort-handover.md +47 -32
- package/.bkit/core/prompts/bkit-debug-failure-diagnose.md +109 -57
- package/.bkit/core/prompts/bkit-debug-failure-remediate.md +65 -39
- package/.bkit/core/prompts/bkit-debug-failure-reproduce.md +53 -31
- package/.bkit/core/prompts/bkit-debug-failure-soak.md +65 -34
- package/.bkit/core/prompts/bkit-design-brainstorm-ideate-1.md +46 -31
- package/.bkit/core/prompts/bkit-design-brainstorm-ideate-2.md +45 -31
- package/.bkit/core/prompts/bkit-design-brainstorm-ideate-3.md +43 -30
- package/.bkit/core/prompts/bkit-design-generate.md +80 -46
- package/.bkit/core/prompts/bkit-design-organise.md +83 -32
- package/.bkit/core/prompts/bkit-design-review-1.md +70 -50
- package/.bkit/core/prompts/bkit-design-review-2.md +65 -46
- package/.bkit/core/prompts/bkit-design-spike.md +64 -40
- package/.bkit/core/prompts/bkit-design-update.md +53 -28
- package/.bkit/core/prompts/bkit-plan-generate.md +101 -29
- package/.bkit/core/prompts/bkit-plan-review-1.md +78 -41
- package/.bkit/core/prompts/bkit-plan-review-2.md +78 -35
- package/.bkit/core/prompts/bkit-plan-scope-check.md +116 -0
- package/.bkit/core/prompts/bkit-plan-update.md +86 -31
- package/.bkit/core/prompts/bkit-ship-conflict-resolve.md +94 -50
- package/.bkit/core/prompts/bkit-ship-deferred-sweep.md +91 -41
- package/.bkit/core/prompts/bkit-ship-update-docs.md +45 -24
- package/.bkit/core/prompts/bkit-utility-compress-markdown.md +65 -49
- package/.bkit/core/prompts/bkit-utility-update-decisions.md +87 -42
- package/.bkit/core/prompts/bkit-utility-update-deferrals.md +81 -37
- package/.bkit/core/prompts/bkit-utility-update-documentation.md +43 -25
- package/.bkit/core/prompts/bkit-utility-update-failures.md +84 -37
- package/.bkit/core/prompts/bkit-utility-update-knowledge.md +88 -42
- package/.bkit/core/prompts/bkit-utility-update-roadmap.md +92 -39
- package/.bkit/core/prompts/bkit-utility-update-tracker.md +159 -60
- package/.bkit/core/workflows/bkit-auto.md +89 -58
- package/.bkit/core/workflows/bkit-build.md +967 -517
- package/.bkit/core/workflows/bkit-debug.md +555 -387
- package/.bkit/core/workflows/bkit-design.md +319 -283
- package/.bkit/core/workflows/bkit-plan.md +319 -342
- package/.bkit/core/workflows/bkit-ship.md +525 -328
- package/.bkit/shared/.agents/plugins/bkit/hooks.json +10 -0
- package/.bkit/shared/.bkit/.env.example +2 -2
- package/.bkit/shared/.claude/bkit-cloud.md +12 -10
- package/.bkit/shared/.claude/settings.json +14 -0
- package/.bkit/shared/.codex/bkit-cloud.md +98 -0
- package/.bkit/shared/.codex/hooks.json +20 -0
- package/.bkit/shared/.cursor/bkit-cloud.md +3 -3
- package/.bkit/shared/.cursor/mcp.json +1 -1
- package/.bkit/shared/.cursor/rules/bkit-rules.mdc +1 -1
- package/.bkit/shared/.gitattributes +1 -1
- package/.bkit/shared/.mcp.json +1 -1
- package/.bkit/shared/.opencode/opencode.json +12 -1
- package/.bkit/shared/CLAUDE.md +6 -2
- package/.bkit/shared/GEMINI.md +5 -2
- package/.bkit/shared/docs/architecture.md +4 -7
- package/.bkit/shared/docs/data-schema.md +4 -7
- package/.bkit/shared/docs/deployments.md +241 -168
- package/.bkit/shared/docs/design.md +11 -12
- package/.bkit/shared/docs/noise.md +8 -7
- package/.bkit/shared/docs/observability.md +5 -8
- package/.bkit/shared/docs/security.md +35 -17
- package/.bkit/shared/docs/setup.md +29 -18
- package/.bkit/shared/docs/technology.md +3 -6
- package/.bkit/shared/docs/testing.md +289 -174
- package/.bkit/shared/gitignore +6 -2
- package/.bkit/templates/.claude/hooks/bkit-cloud-bootstrap.sh +15 -16
- package/.bkit/templates/.cursor/Dockerfile +12 -8
- package/.bkit/templates/.cursor/environment.json +1 -1
- package/.bkit/templates/.github/ISSUE_TEMPLATE/bkit-bug.yml +10 -8
- package/.bkit/templates/.github/ISSUE_TEMPLATE/bkit-change.yml +45 -12
- package/.bkit/templates/.github/ISSUE_TEMPLATE/bkit-idea.yml +3 -3
- package/.bkit/templates/.github/renovate.json5 +34 -6
- package/.bkit/templates/.github/workflows/bkit-ci.yml +54 -51
- package/.bkit/templates/.github/workflows/bkit-cloud.yml +34 -33
- package/.bkit/templates/.github/workflows/bkit-health.yml +97 -0
- package/.bkit/templates/.github/workflows/bkit-renovate.yml +5 -4
- package/.bkit/templates/.github/workflows/bkit-trivy.yml +5 -4
- package/.bkit/templates/.husky/pre-commit +2 -2
- package/.bkit/templates/.husky/pre-push +96 -36
- package/.bkit/templates/.prettierignore +6 -0
- package/.bkit/templates/.vale.ini +27 -27
- package/.bkit/templates/context/bkit-cloudrun.md +23 -15
- package/.bkit/templates/context/bkit-expo.md +70 -52
- package/.bkit/templates/context/bkit-github.md +93 -56
- package/.bkit/templates/context/bkit-inngest.md +21 -15
- package/.bkit/templates/context/bkit-maestro.md +22 -16
- package/.bkit/templates/context/bkit-playwright.md +23 -17
- package/.bkit/templates/context/bkit-resend.md +12 -10
- package/.bkit/templates/context/bkit-sentry.md +30 -20
- package/.bkit/templates/context/bkit-serena.md +8 -7
- package/.bkit/templates/context/bkit-stripe.md +14 -13
- package/.bkit/templates/context/bkit-supabase.md +16 -13
- package/.bkit/templates/context/bkit-tavily.md +14 -11
- package/.bkit/templates/context/bkit-vercel.md +27 -18
- package/.bkit/templates/docs/capabilities.md +15 -14
- package/.bkit/templates/scripts/ci/{check-accepted-divergences.mjs → bkit-check-accepted-divergences.mjs} +6 -3
- package/.bkit/templates/scripts/ci/{check-accepted-divergences.test.mjs → bkit-check-accepted-divergences.test.mjs} +3 -3
- package/.bkit/templates/scripts/ci/{check-capstone.mjs → bkit-check-capstone.mjs} +2 -2
- package/.bkit/templates/scripts/ci/{check-capstone.test.mjs → bkit-check-capstone.test.mjs} +4 -4
- package/.bkit/templates/scripts/ci/{check-dependency-audit.mjs → bkit-check-dependency-audit.mjs} +103 -18
- package/.bkit/templates/scripts/ci/{check-dependency-audit.test.mjs → bkit-check-dependency-audit.test.mjs} +31 -3
- package/.bkit/templates/scripts/ci/bkit-machine-lock.sh +387 -0
- package/.bkit/templates/scripts/ci/bkit-test-awake.mjs +75 -0
- package/.bkit/templates/scripts/ci/bkit-test-awake.test.mjs +160 -0
- package/.bkit/templates/scripts/ci/lanes/{resolve-push-base.mjs → bkit-resolve-push-base.mjs} +3 -3
- package/.bkit/templates/scripts/ci/lanes/{resolve-push-base.test.mjs → bkit-resolve-push-base.test.mjs} +4 -4
- package/.bkit/templates/scripts/cleanup/bkit-disk-prune.mjs +10 -2
- package/.bkit/templates/scripts/graphify/bkit-graph-drift.py +1 -1
- package/.bkit/templates/scripts/graphify/bkit-graph-eager.py +3 -3
- package/.bkit/templates/scripts/graphify/bkit-graph-embed.py +63 -0
- package/.bkit/templates/scripts/graphify/bkit-graph-imports.py +2 -2
- package/.bkit/templates/scripts/graphify/bkit-graph-pre-push.sh +69 -18
- package/.bkit/templates/scripts/graphify/bkit-graph-repair.py +3 -3
- package/.bkit/templates/scripts/graphify/bkit-graph-surface.py +1 -1
- package/.bkit/templates/scripts/graphify/bkit-graphify-graphml.py +1 -1
- package/.bkit/templates/scripts/graphify/bkit-graphify-rollup.py +197 -126
- package/.bkit/templates/scripts/graphify/bkit-graphify.sh +64 -41
- package/.bkit/templates/scripts/slop/bkit-slop-type-suppression.mjs +23 -7
- package/.bkit/templates/slop-scan.config.json +9 -2
- package/CHANGELOG.md +231 -0
- package/README.md +278 -89
- package/dist/checks/after/auth.js +36 -33
- package/dist/checks/after/ci-yml.js +91 -30
- package/dist/checks/after/github.js +91 -17
- package/dist/checks/after/index.js +22 -11
- package/dist/checks/after/suppression.js +8 -5
- package/dist/checks/after/tools.js +111 -114
- package/dist/checks/before/context-fetch.js +218 -33
- package/dist/checks/before/env.js +3 -3
- package/dist/checks/before/files.js +5 -3
- package/dist/checks/before/index.js +20 -3
- package/dist/checks/before/repo.js +197 -2
- package/dist/checks/status-holes.js +739 -114
- package/dist/checks/tips/catalogue.js +70 -19
- package/dist/checks/tips/detect.js +62 -0
- package/dist/checks/tips/index.js +51 -9
- package/dist/cli.js +234 -124
- package/dist/commands/analysis.js +174 -141
- package/dist/commands/ci/ci.js +302 -25
- package/dist/commands/ci/pins.js +142 -0
- package/dist/commands/ci/push-gate.js +194 -0
- package/dist/commands/comply.js +54 -91
- package/dist/commands/install/doctor.js +2 -2
- package/dist/commands/install/install.js +50 -19
- package/dist/commands/install/uninstall.js +82 -55
- package/dist/commands/install/upgrade.js +21 -11
- package/dist/commands/land.js +137 -17
- package/dist/commands/lib.js +295 -21
- package/dist/commands/registry.js +10 -2
- package/dist/commands/setup/setup.js +8 -7
- package/dist/commands/stats.js +175 -0
- package/dist/commands/tips.js +7 -3
- package/dist/commands/workflow/branches.js +1873 -152
- package/dist/commands/workflow/challenge.js +609 -0
- package/dist/commands/workflow/completeness.js +97 -0
- package/dist/commands/workflow/context.js +1045 -46
- package/dist/commands/workflow/counters.js +385 -86
- package/dist/commands/workflow/decisions.js +484 -0
- package/dist/commands/workflow/disk.js +214 -56
- package/dist/commands/workflow/fids.js +706 -33
- package/dist/commands/workflow/issues.js +349 -59
- package/dist/commands/workflow/ledgers.js +1123 -37
- package/dist/commands/workflow/locks.js +26 -2
- package/dist/commands/workflow/plan-blocks.js +501 -0
- package/dist/commands/workflow/plan-versions.js +22 -0
- package/dist/commands/workflow/plans.js +205 -0
- package/dist/commands/workflow/prs.js +154 -35
- package/dist/commands/workflow/repo.js +58 -8
- package/dist/commands/workflow/roadmap.js +58 -23
- package/dist/commands/workflow/run-facts.js +421 -0
- package/dist/commands/workflow/runs.js +670 -72
- package/dist/commands/workflow/runtime.js +15 -1
- package/dist/commands/workflow/skills.js +1 -0
- package/dist/commands/workflow/status.js +282 -34
- package/dist/commands/workflow/step-table.js +308 -0
- package/dist/commands/workflow/steps.js +703 -96
- package/dist/commands/workflow/summary-findings.js +117 -0
- package/dist/commands/workflow/summary.js +388 -0
- package/dist/commands/workflow/tasks.js +378 -0
- package/dist/commands/workflow/test-blocks.js +231 -0
- package/dist/commands/workflow/tests-changed.js +172 -0
- package/dist/commands/workflow/tests.js +1695 -305
- package/dist/commands/workflow/tracker.js +983 -0
- package/dist/commands/workflow/workflows.js +1014 -222
- package/dist/commands/workflow/worktrees.js +432 -26
- package/dist/install/cloud-env.js +233 -99
- package/dist/install/context-ci-workflow.js +85 -0
- package/dist/install/manifest.js +64 -17
- package/dist/install/modules/antigravity.js +3 -2
- package/dist/install/modules/cloud.js +25 -16
- package/dist/install/modules/codex.js +12 -2
- package/dist/install/modules/core.js +1090 -48
- package/dist/install/modules/cursor.js +6 -6
- package/dist/install/modules/opencode.js +13 -7
- package/dist/install/template-notes.js +116 -0
- package/dist/install/version-file.js +9 -4
- package/dist/ledgers/compact.js +87 -0
- package/dist/ledgers/journal.js +233 -0
- package/dist/ledgers/migrate.js +81 -0
- package/dist/ledgers/status.js +176 -13
- package/dist/ledgers/telemetry.js +1010 -125
- package/dist/render/hosts.js +104 -14
- package/dist/render/models.js +12 -0
- package/dist/shared/bkit-latest.js +26 -4
- package/dist/shared/branches.js +3 -1
- package/dist/shared/dep-updater.js +49 -0
- package/dist/shared/egress.js +8 -1
- package/dist/shared/json.js +20 -7
- package/dist/shared/package-manager.js +6 -0
- package/dist/shared/settings.js +181 -24
- package/dist/shared/text.js +333 -0
- package/dist/shared/timeouts.js +2 -0
- package/dist/tools/cli-doc.js +97 -0
- package/dist/tools/grammar-density.js +183 -0
- package/dist/tools/instructions-sources.js +720 -0
- package/dist/tools/instructions.js +1623 -0
- package/package.json +156 -51
- package/.bkit/core/.bkit/lite.md +0 -73
- package/.bkit/core/engine/commands/harvest.ts +0 -459
- package/.bkit/core/engine/commands/workflow/workstreams.ts +0 -166
- package/.bkit/core/engine/tools/wording.ts +0 -748
- package/.bkit/core/prompts/bkit-build-challenge-reconcile.md +0 -69
- package/.bkit/core/prompts/bkit-build-challenge-remediate.md +0 -71
- package/.bkit/core/prompts/bkit-build-challenge-tests.md +0 -74
- package/.bkit/core/prompts/bkit-build-plan-execute.md +0 -76
- package/.bkit/core/prompts/bkit-build-summary.md +0 -94
- package/.bkit/core/prompts/bkit-debug-summary.md +0 -96
- package/.bkit/core/prompts/bkit-design-summary.md +0 -107
- package/.bkit/core/prompts/bkit-plan-complexity-check.md +0 -67
- package/.bkit/core/prompts/bkit-plan-complexity-split.md +0 -88
- package/.bkit/core/prompts/bkit-plan-review-3.md +0 -93
- package/.bkit/core/prompts/bkit-plan-scope-check-1.md +0 -85
- package/.bkit/core/prompts/bkit-plan-scope-check-2.md +0 -85
- package/.bkit/core/prompts/bkit-plan-summary.md +0 -107
- package/.bkit/core/prompts/bkit-ship-summary.md +0 -78
- package/.bkit/templates/scripts/ci/bkit-local-stack-lock.sh +0 -194
- package/dist/commands/harvest.js +0 -353
- package/dist/commands/workflow/workstreams.js +0 -143
- package/dist/tools/wording.js +0 -680
- /package/.bkit/templates/.vale/styles/{House → Bkit}/Filler.yml +0 -0
- /package/.bkit/templates/.vale/styles/{House → Bkit}/Hedging.yml +0 -0
- /package/.bkit/templates/.vale/styles/{House → Bkit}/LLMSlop.yml +0 -0
- /package/.bkit/templates/.vale/styles/{House → Bkit}/Verbose.yml +0 -0
- /package/.bkit/templates/scripts/ci/{accepted-advisories.json → bkit-accepted-advisories.json} +0 -0
- /package/.bkit/templates/scripts/ci/{accepted-divergences.json → bkit-accepted-divergences.json} +0 -0
- /package/.bkit/templates/scripts/launchd/{launchd.env.example → bkit-launchd.env.example} +0 -0
- /package/.bkit/templates/scripts/launchd/{ai.bkit.launchd.plist → bkit-launchd.plist} +0 -0
|
@@ -1,9 +1,9 @@
|
|
|
1
|
-
<!-- Note: Reports live at `docs/audits/{YYYYMM}/{slug}.md`. `{YYYYMM}` = UTC month of this run. `{slug}` = template basename without `bkit-audit-` and `.md`. **If** that month already has `{slug}.md` or `{slug}-{TIMESTAMP}.md` → write `{slug}-{TIMESTAMP}.md` (`{TIMESTAMP}` = `date -u +%Y%m%dT%H%M%SZ`). Never overwrite. The report is stamped with a `bkit:anchor` block recording the audited commit (`baseSha`) and branch (`baseRef`); never hand-author or edit it. `@bkit-audit-generate` fills this template. -->
|
|
2
|
-
|
|
3
1
|
<!-- bkit:start -->
|
|
4
2
|
|
|
5
3
|
{{BKIT_MANAGED_MARKER}}
|
|
6
4
|
|
|
5
|
+
<!-- Note: @bkit-audit-generate fills this template. The report lives at `docs/audits/{YYYYMM}/{slug}.md`, where `{YYYYMM}` is the UTC month of the run and `{slug}` is this file's name without `bkit-audit-` and `.md`. **If** that month already has `{slug}.md` or `{slug}-{TIMESTAMP}.md` → write `{slug}-{TIMESTAMP}.md`, where `{TIMESTAMP}` is the output of `date -u +%Y%m%dT%H%M%SZ`. NEVER overwrite an earlier report. The report is stamped with a `bkit:anchor` block that records the audited commit (`baseSha`) and branch (`baseRef`). NEVER write or edit that block by hand. -->
|
|
6
|
+
|
|
7
7
|
# Slop Audit
|
|
8
8
|
|
|
9
9
|
> [!CAUTION]
|
|
@@ -11,145 +11,129 @@
|
|
|
11
11
|
>
|
|
12
12
|
> **Rules:**
|
|
13
13
|
>
|
|
14
|
-
> -
|
|
15
|
-
> -
|
|
16
|
-
> - Local audit instructions / overrides → `Project Instructions` below the bkit-managed block; universal instructions stay in-block.
|
|
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 recommend adding suppression; scanner config stays byte-identical to committed one.
|
|
14
|
+
> - Never recommend adding a suppression.
|
|
15
|
+
> - Keep the scanner config byte-identical to the committed one.
|
|
23
16
|
|
|
24
17
|
## Universal Instructions
|
|
25
18
|
|
|
26
19
|
### Context & Goals
|
|
27
20
|
|
|
28
|
-
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.
|
|
29
22
|
|
|
30
|
-
**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".
|
|
31
24
|
|
|
32
|
-
**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.
|
|
33
26
|
|
|
34
|
-
**Anchor Standards:**
|
|
27
|
+
**Anchor Standards:**
|
|
35
28
|
|
|
36
|
-
- Slop scanner at pinned version (e.g
|
|
37
|
-
- Strictest preset of type-aware linter (e.g
|
|
38
|
-
- Type-coverage tool (e.g
|
|
39
|
-
- Disable-comment rules (e.g
|
|
40
|
-
- Cognitive Complexity (SonarSource white paper; e.g
|
|
41
|
-
- 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).
|
|
42
35
|
|
|
43
36
|
### Scope
|
|
44
37
|
|
|
45
|
-
-
|
|
46
|
-
-
|
|
47
|
-
-
|
|
48
|
-
-
|
|
49
|
-
-
|
|
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.
|
|
50
44
|
|
|
51
45
|
### Out of Scope
|
|
52
46
|
|
|
53
47
|
<!-- prettier-ignore -->
|
|
54
48
|
| Excluded item | Why | Where it belongs |
|
|
55
49
|
| --- | --- | --- |
|
|
56
|
-
| Adding a suppression |
|
|
57
|
-
| Fixing / deleting findings |
|
|
58
|
-
| Dead files beyond reference check |
|
|
59
|
-
| 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` |
|
|
60
54
|
|
|
61
55
|
### Verdicts
|
|
62
56
|
|
|
63
|
-
- **FIX:** hides real failure. Name change and override
|
|
64
|
-
- **DELETE:** file dead, scratch
|
|
65
|
-
- **
|
|
66
|
-
- **
|
|
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`.
|
|
67
62
|
|
|
68
|
-
**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.
|
|
69
64
|
|
|
70
65
|
**Always `FIX`:**
|
|
71
66
|
|
|
72
|
-
-
|
|
73
|
-
-
|
|
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.
|
|
74
69
|
|
|
75
70
|
### Pre-Flight / Dependencies
|
|
76
71
|
|
|
77
|
-
**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.
|
|
78
|
-
|
|
79
|
-
**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.
|
|
80
|
-
|
|
81
72
|
#### Core
|
|
82
73
|
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
- [ ] **
|
|
86
|
-
- [ ] **
|
|
87
|
-
- [ ] **
|
|
88
|
-
- [ ] **Git History:** Steps 5, 8 — full history for blame and churn. Fallback: ages and churn `Not Checked`.
|
|
89
|
-
- [ ] **Web:** Step 9 — fetch anchor standards. Fallback: versions recorded as unread.
|
|
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.
|
|
90
79
|
|
|
91
80
|
#### Conditional
|
|
92
81
|
|
|
93
|
-
|
|
94
|
-
|
|
95
|
-
- [ ] **
|
|
96
|
-
- [ ] **Typed Lint and Type Coverage:** Typed language → Step 7 — e.g. typescript-eslint typed rules, `type-coverage`, mypy. Fallback: text-search escape-hatch counts.
|
|
97
|
-
- [ ] **Complexity and Mutation Tools:** Tools exist for language → Step 8 — e.g. `eslint-plugin-sonarjs`, Stryker, mutmut; install in worktree only. Fallback: `Not Checked`.
|
|
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`.
|
|
98
85
|
|
|
99
86
|
### 🔒 Gate 1: Prerequisites Check
|
|
100
87
|
|
|
101
|
-
|
|
102
|
-
|
|
103
|
-
- [ ] **Gaps named:** every missing item names its fallback and `Not Checked` entry.
|
|
104
|
-
- [ ] **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.
|
|
105
90
|
|
|
106
91
|
### Probe Steps
|
|
107
92
|
|
|
108
|
-
- [ ] **Step 1 — Previous Run:**
|
|
109
|
-
- [ ] **Step 2 — Isolate:** Find scanner
|
|
110
|
-
- [ ] **Step 3 — Hidden Findings:**
|
|
111
|
-
- [ ] **Step 4 — Verdicts:** Read each suppressed site, not rule name
|
|
112
|
-
- [ ] **Step 5 — Code Suppressions:** Search source for disable comments, type-checker ignores, escape-hatch types, double casts, single casts
|
|
113
|
-
-
|
|
114
|
-
- Commented-out code
|
|
115
|
-
- `TODO`
|
|
116
|
-
-
|
|
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`).
|
|
117
102
|
|
|
118
|
-
**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.
|
|
119
104
|
|
|
120
|
-
- [ ] **Step 6 — Config Suppressions:** List per config: linter rules off
|
|
121
|
-
- [ ] **Step 7 — Inferred Types:** Most escape-hatch typing implicit (e.g
|
|
122
|
-
- [ ] **Step 8 — Hotspots:**
|
|
123
|
-
- [ ] **Step 9 — Standards:** Confirm current version
|
|
124
|
-
- [ ] **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`.
|
|
125
110
|
|
|
126
111
|
### 🔒 Gate 2: Probes Check
|
|
127
112
|
|
|
128
|
-
**
|
|
129
|
-
|
|
130
|
-
- [ ] **
|
|
131
|
-
- [ ] **
|
|
132
|
-
- [ ] **
|
|
133
|
-
- [ ] **Gate 2 - Verified:** Every checkbox above independently verified and checked off.
|
|
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.
|
|
134
118
|
|
|
135
119
|
## Findings
|
|
136
120
|
|
|
137
121
|
<!-- prettier-ignore -->
|
|
138
122
|
| Severity | Use |
|
|
139
123
|
| --- | --- |
|
|
140
|
-
| `CRITICAL` |
|
|
141
|
-
| `HIGH` |
|
|
142
|
-
| `MEDIUM` |
|
|
143
|
-
| `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 |
|
|
144
128
|
|
|
145
|
-
|
|
129
|
+
Within a severity, list security and data findings first.
|
|
146
130
|
|
|
147
131
|
<!-- prettier-ignore -->
|
|
148
132
|
| ID | Severity | Verdict | Location | Evidence | Expected |
|
|
149
133
|
| --- | --- | --- | --- | --- | --- |
|
|
150
134
|
| PENDING | PENDING | PENDING | PENDING | PENDING | PENDING |
|
|
151
135
|
|
|
152
|
-
|
|
136
|
+
**If** the run finds nothing → write one row: `None`.
|
|
153
137
|
|
|
154
138
|
## Report
|
|
155
139
|
|
|
@@ -194,17 +178,16 @@ PENDING
|
|
|
194
178
|
|
|
195
179
|
### 🔒 Gate 3: Report Check
|
|
196
180
|
|
|
197
|
-
**
|
|
198
|
-
|
|
199
|
-
- [ ] **
|
|
200
|
-
- [ ] **
|
|
201
|
-
- [ ] **
|
|
202
|
-
- [ ] **
|
|
203
|
-
- [ ] **Process Improvements:** `Universal`
|
|
204
|
-
- [ ] **Suggested Issues:** every `MEDIUM`+ finding ID in exactly one
|
|
205
|
-
- [ ] **
|
|
206
|
-
|
|
207
|
-
> `Project Instructions` below `bkit:end` are consumer-owned — `bkit install` never overwrites them, `bkit check` drift stays clean. Add project-specific tools, paths, commands, and checks there, keyed by section or step title; never results.
|
|
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.
|
|
208
191
|
|
|
209
192
|
<!-- bkit:end -->
|
|
210
193
|
|