@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,129 +1,118 @@
|
|
|
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
|
# Gate Candidates
|
|
8
8
|
|
|
9
9
|
> [!CAUTION]
|
|
10
|
-
> **Purpose:**
|
|
10
|
+
> **Purpose:** A ranking of which detective audit sweeps can become preventive gates, in what order, and which must stay audits.
|
|
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 build, wire, or land a gate; never edit workflows, hooks, allowlists, or gate scripts.
|
|
23
|
-
> - NEVER weaken an existing gate — no skip, rule downgrade, lowered floor, or broader ignore — so a candidate looks adoptable.
|
|
14
|
+
> - NEVER build, wire or land a gate.
|
|
15
|
+
> - NEVER edit workflows, hooks, allowlists or gate scripts.
|
|
16
|
+
> - NEVER weaken an existing gate so a candidate looks adoptable: no skip, rule downgrade, lowered floor or broader ignore.
|
|
24
17
|
|
|
25
18
|
## Universal Instructions
|
|
26
19
|
|
|
27
20
|
### Context & Goals
|
|
28
21
|
|
|
29
|
-
Maintenance sweeps find breakage
|
|
22
|
+
Maintenance sweeps find breakage, and none of them prevents the next one. Sibling audits keep saying "make it a gate", but an unscheduled sweep is not a control, even when the sweep is the stated prevention. Converting a check into a gate has costs. A gate that is red on day one from unencoded noise gets disabled. A gate at the wrong altitude, such as one rule where the class needs a guard per case, gets reverted. This pass ranks candidates and does not build gates. Staying an audit is a valid verdict.
|
|
30
23
|
|
|
31
|
-
**Applies when:** at least one detective audit exists, and a CI job, hook
|
|
24
|
+
**Applies when:** at least one detective audit exists, **and** a CI job, hook or test could block a class before merge. **If** not → 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 sibling audit's `Process Improvements` proposes a new gate, or when `bkit-audit-failures` names a recurring root-cause class as a gate candidate.
|
|
34
27
|
|
|
35
|
-
**Anchor Standards:**
|
|
28
|
+
**Anchor Standards:**
|
|
36
29
|
|
|
37
|
-
- Fitness functions (e.g
|
|
38
|
-
- Static-analysis review bar (e.g
|
|
39
|
-
- Quality gates on new code (e.g
|
|
40
|
-
- Ratchet and baseline tools (e.g
|
|
41
|
-
- Policy as code (e.g
|
|
42
|
-
- Required status checks and a merge queue (e.g
|
|
30
|
+
- Fitness functions (e.g., Ford, Parsons, Kua, and Sadalage, _Building Evolutionary Architectures_, 2nd ed.).
|
|
31
|
+
- Static-analysis review bar (e.g., Tricorder: under 10% effective false positives, and an actionable message; Sadowski et al., Communications of the ACM, 2018).
|
|
32
|
+
- Quality gates on new code (e.g., SonarQube Clean as You Code).
|
|
33
|
+
- Ratchet and baseline tools (e.g., Betterer; reviewdog `filter_mode: added`).
|
|
34
|
+
- Policy as code (e.g., Conftest / OPA; JSON Schema).
|
|
35
|
+
- Required status checks and a merge queue (e.g., GitHub rulesets).
|
|
43
36
|
- OpenSSF Scorecard checks, at the Scorecard version read.
|
|
44
37
|
- DORA continuous integration capability.
|
|
45
|
-
- bkit block of `docs/testing.md` (bkit version from `.bkit/version`): § CI test tiers (the bkit scaffold); § Accepted divergences; § Step names say whether a red is real; § Composite actions: two rules that fail silently
|
|
38
|
+
- bkit block of `docs/testing.md` (bkit version from `.bkit/version`): § CI test tiers (the bkit scaffold); § Accepted divergences; § Step names say whether a red is real; § Composite actions: two rules that fail silently; § JUnit reports for bkit
|
|
46
39
|
- bkit block of `docs/deployments.md` (bkit version from `.bkit/version`): § Commit-message force tags; § Workflow-file limits GitHub does not enforce visibly; § Ship gate + bookkeeping
|
|
47
40
|
- bkit block of `docs/design.md` (bkit version from `.bkit/version`): § Machine-checked reference
|
|
48
41
|
|
|
49
42
|
### Scope
|
|
50
43
|
|
|
51
|
-
-
|
|
52
|
-
- Score,
|
|
53
|
-
-
|
|
54
|
-
-
|
|
55
|
-
- Re-review
|
|
44
|
+
- Collect candidates from sibling audits, repeat defects, and standard gates nobody proposed.
|
|
45
|
+
- Score each candidate, check its disqualifiers, and set its tier, moment, enforcement point, positive control and report-only bar.
|
|
46
|
+
- Check the health of gates that already landed.
|
|
47
|
+
- Check allowlist and ratchet-baseline expiry.
|
|
48
|
+
- Re-review gates that were reverted or rejected.
|
|
56
49
|
|
|
57
50
|
### Out of Scope
|
|
58
51
|
|
|
59
52
|
<!-- prettier-ignore -->
|
|
60
53
|
| Excluded item | Why | Where it belongs |
|
|
61
54
|
| --- | --- | --- |
|
|
62
|
-
| Running a sibling sweep, or clearing what it found | That audit | source `bkit-audit-*` |
|
|
63
|
-
| Building, wiring, or landing a gate, including workflow and allowlist edits |
|
|
55
|
+
| Running a sibling sweep, or clearing what it found | That audit covers it | source `bkit-audit-*` |
|
|
56
|
+
| Building, wiring, or landing a gate, including workflow and allowlist edits | The audit only reports | A plan made from this report |
|
|
64
57
|
|
|
65
58
|
### Verdicts
|
|
66
59
|
|
|
67
|
-
|
|
60
|
+
Give each candidate one verdict.
|
|
68
61
|
|
|
69
|
-
- **ADOPT:** passes every `Score` axis and no `Disqualify` item holds. Its rank sets its place in the order. The report names the tracker issue to open and the `docs/decisions.jsonl` row to append. Opening and appending are the next step.
|
|
70
|
-
- **REJECT:** fails a `Score` axis, or a `Disqualify` item holds. It stays an audit. Record why, so a later run can see when the reason stops holding.
|
|
71
|
-
- **OTHER:** fits
|
|
62
|
+
- **ADOPT:** the candidate passes every `Score` axis, and no `Disqualify` item holds. Its rank sets its place in the order. The report names the tracker issue to open and the `docs/decisions.jsonl` row to append. Opening and appending are the next step.
|
|
63
|
+
- **REJECT:** the candidate fails a `Score` axis, or a `Disqualify` item holds. It stays an audit. Record why, so a later run can see when the reason stops holding.
|
|
64
|
+
- **OTHER:** it fits no other verdict, because it waits on a decision or a tool. Say why, and what would settle it. The next run resolves it to ADOPT or REJECT. **If** the same `OTHER` shows up on 2 runs → propose a new verdict in `Process Improvements`.
|
|
72
65
|
|
|
73
66
|
### Pre-Flight / Dependencies
|
|
74
67
|
|
|
75
|
-
**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.
|
|
76
|
-
|
|
77
|
-
**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.
|
|
78
|
-
|
|
79
68
|
#### Core
|
|
80
69
|
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
- [ ] **
|
|
84
|
-
- [ ] **
|
|
85
|
-
- [ ] **
|
|
86
|
-
- [ ] **Repo Gates:** Steps 7, 9, 12, 13, 15 — workflows, hook directory, gate scripts, allowlist files, e.g. `.github/workflows`, `.husky`, `.gitlab-ci.yml`, every `bkit:gate:*` script in `package.json`. Fallback: none; those items `Not Checked`.
|
|
87
|
-
- [ ] **Web:** Step 14 — fetch anchor standards. Fallback: versions recorded as unread.
|
|
70
|
+
- [ ] **Permissions:** every blocked call is recorded.
|
|
71
|
+
- [ ] **Sibling Reports:** Steps 2, 3 — the newest report for each other `bkit-audit-*` slug under `docs/audits/`, or else that template's `Process Improvements`. Fallback: the templates only. A missing report marks that audit `Not Checked`.
|
|
72
|
+
- [ ] **Ledgers:** Steps 3, 10, 11 — `docs/failures.jsonl`, `docs/decisions.jsonl`, `docs/deferrals.jsonl`. Fallback: mark incident evidence and prior rejections `Not Checked`.
|
|
73
|
+
- [ ] **Repo Gates:** Steps 7, 9, 12, 13, 15 — workflows, the hook directory, gate scripts and allowlist files (e.g., `.github/workflows`, `.husky`, `.gitlab-ci.yml`, and every `bkit:gate:*` script in `package.json`). Fallback: none. Mark those items `Not Checked`.
|
|
74
|
+
- [ ] **Web:** Step 14 — fetch the anchor standards. Fallback: record the versions as unread.
|
|
88
75
|
|
|
89
76
|
#### Conditional
|
|
90
77
|
|
|
91
|
-
|
|
92
|
-
|
|
93
|
-
- [ ] **
|
|
94
|
-
- [ ] **Run History:** A gate has already landed → Step 12 — how often it fired, e.g. `gh run list`, CI analytics. Fallback: code reading only; fire rate `Not Checked`.
|
|
95
|
-
- [ ] **Scorecard:** Repo is public, or a token is present → Steps 3, 14 — e.g. `scorecard`. Fallback: read the check list; live score `Not Checked`.
|
|
78
|
+
- [ ] **Ruleset Read:** **If** the host exposes branch rules → Step 7 — required checks and bypass actors (e.g., `gh api` rulesets, GitLab protected branches). Fallback: the workflow and hook files only, and mark bypass actors `Not Checked`.
|
|
79
|
+
- [ ] **Run History:** **If** a gate has already landed → Step 12 — how often it fired (e.g., `gh run list`, CI analytics). Fallback: code reading only, and mark the fire rate `Not Checked`.
|
|
80
|
+
- [ ] **Scorecard:** **If** the repo is public **or** a token is present → Steps 3, 14 — e.g., `scorecard`. Fallback: read the check list, and mark the live score `Not Checked`.
|
|
96
81
|
|
|
97
82
|
### 🔒 Gate 1: Prerequisites Check
|
|
98
83
|
|
|
99
|
-
|
|
100
|
-
|
|
101
|
-
- [ ] **Gaps named:** every missing item names its fallback and `Not Checked` entry.
|
|
102
|
-
- [ ] **Gate 1 - Verified:** All Core items checked. All applicable Conditional items checked.
|
|
84
|
+
- [ ] **Gaps named:** every missing item names its fallback and its `Not Checked` entry.
|
|
85
|
+
- [ ] **Gate 1 — Verified:** every item above, every Core item and every applicable Conditional item is checked.
|
|
103
86
|
|
|
104
87
|
### Probe Steps
|
|
105
88
|
|
|
106
|
-
- [ ] **Step 1 — Previous Run:**
|
|
107
|
-
- [ ] **Step 2 — Inventory:** Collect gate candidates from each other `bkit-audit-*` report's `Process Improvements
|
|
108
|
-
-
|
|
109
|
-
-
|
|
89
|
+
- [ ] **Step 1 — Previous Run:** **Done when:** `Previous Run` holds the closure rate, or the run is marked baseline.
|
|
90
|
+
- [ ] **Step 2 — Inventory:** Collect the gate candidates from each other `bkit-audit-*` report's `Process Improvements`, without re-deriving them.
|
|
91
|
+
- **If** an audit has no report yet → read that template's `Process Improvements` instead.
|
|
92
|
+
- Record the source slug.
|
|
93
|
+
- Merge duplicates: two audits proposing one guard make one candidate with both sources, not two work items. A re-grep of a swept class and an owner-allowlist over the same literals are one guard.
|
|
94
|
+
|
|
95
|
+
**Done when:** `Inventory` has a row per candidate: source slug · one-line guard.
|
|
96
|
+
|
|
97
|
+
- [ ] **Step 3 — Widen:** The sibling sections are one source. Also add the following, recording the source of each. (a) Every defect class on 2 or more rows in `docs/failures.jsonl`, whether or not a sibling proposed a gate. (b) Standard gates nobody proposed, each checked against the tree: secret-scanning push protection, code scanning (e.g., CodeQL), a dependency-review check, workflow linters (e.g., `actionlint`, `zizmor`), lockfile lint, the test runner's forbid-only flag (e.g., Playwright `--forbid-only`), typechecking of test files, the OpenSSF Scorecard checks, and a check on the outcome of every scheduled control. For each scheduled job, read the outcome of each run (status code or exit code), not only that it ran: a rejected run can log at info level. A job that did not write its owned rows in its window is a finding, even when it exited 0. **If** there are no scheduled jobs → record the skip with evidence of absence. (c) Policy as code for config with no type system (e.g., JSON Schema, Conftest): bot config, job-runner triggers and concurrency, hosting config, mobile build config, and workflow YAML. Class (c) is what `bkit-audit-testing` flags. **If** a gate is already enforced → it goes in `Health`, not in a second candidate. **Done when:** every added row is in `Inventory` with its source.
|
|
98
|
+
- [ ] **Step 4 — Score:** Score each candidate on six axes. It fails an axis when that axis's fail condition holds.
|
|
110
99
|
- **Determinism.** Can a machine decide pass/fail with no judgement? Fails if the verdict needs someone to read intent.
|
|
111
100
|
- **False-positive class.** Empty, a fixed allowlist, or structural? Fails if structural and unencoded.
|
|
112
101
|
- **Incident evidence.** Has this class shipped a defect here? Fails if purely theoretical.
|
|
113
102
|
- **Home lane.** Does a lane already exist to run it? Fails if it needs new infrastructure or an unavailable tool.
|
|
114
|
-
- **Cost.** Runtime per change
|
|
115
|
-
- **Actionability.** Does failure say what to change and where (`file:line` plus fix)? Fails if developer must investigate.
|
|
103
|
+
- **Cost.** Runtime per change, plus developer wait and upkeep (baseline maintenance, version bumps). Fails if it costs more than the value it returns.
|
|
104
|
+
- **Actionability.** Does a failure say what to change and where (`file:line` plus the fix)? Fails if the developer must investigate. A deterministic but cryptic gate is bypassed as fast as a noisy one.
|
|
116
105
|
|
|
117
|
-
Rank by incident evidence
|
|
106
|
+
Rank by incident evidence x determinism ÷ effort. Prefer a candidate with a real incident over one that is merely tidy. **Done when:** `Scores` holds the six answers, the rank and the failed axes.
|
|
118
107
|
|
|
119
|
-
- [ ] **Step 5 — Disqualify:**
|
|
120
|
-
1. **Judgement is the task.** Examples: log line
|
|
121
|
-
2. **The false-positive class is structural and unencoded.** Gate only after exclusions committed as config.
|
|
122
|
-
3. **The tool cannot run in CI.**
|
|
108
|
+
- [ ] **Step 5 — Disqualify:** A candidate stays an audit when any of these holds:
|
|
109
|
+
1. **Judgement is the task.** Examples: whether a log line is a bug or a handled outcome; whether a deferral may still be live (`bkit-audit-deferrals`); whether code is duplication or two deliberately different decisions (`bkit-audit-duplication`). No gate decides these.
|
|
110
|
+
2. **The false-positive class is structural and unencoded.** Gate it only after the exclusions are committed as config. The default sequence, as in `bkit-audit-dead-code`, is to clear the findings, commit the baseline, then wire the lane. **If** clearing takes more than one PR → a ratchet (`Sequence`) may wire the lane first: a committed baseline holds the existing findings, and the gate enforces on new ones.
|
|
111
|
+
3. **The tool cannot run in CI.** A local-only graph tool with no CI provisioning (e.g., graphify) blocks a graph-derived gate until that changes, or until the check is reimplemented without it.
|
|
123
112
|
|
|
124
|
-
**Done when:** each
|
|
113
|
+
**Done when:** `Scores` names each disqualifier that holds.
|
|
125
114
|
|
|
126
|
-
- [ ] **Step 6 — Tier:**
|
|
115
|
+
- [ ] **Step 6 — Tier:** Pick the lowest tier that can see the defect. Pushing a check down a tier makes it faster, earlier and less flaky, so a rule that can be a unit test should never be an end-to-end spec. A ratchet (`Sequence`) works at any tier, because it changes what the gate compares against, not where it runs.
|
|
127
116
|
- **Unit / contract test.** Rule computable from source constants. Example: contrast over a palette.
|
|
128
117
|
- **Static.** Signature is a literal. Example: env reachability, swept-class re-grep, migration hygiene.
|
|
129
118
|
- **Migration lane.** Truth in database catalogue. Example: row-level coverage, definer-rights grants.
|
|
@@ -131,46 +120,62 @@ Verify only when applicable.
|
|
|
131
120
|
- **End-to-end.** Needs rendered page. Example: contrast and target size in situ.
|
|
132
121
|
- **Scheduled.** Depends on external service. Example: model-id resolution against live catalogue.
|
|
133
122
|
|
|
134
|
-
Then moment,
|
|
135
|
-
|
|
136
|
-
- [ ] **Step 7 — Enforcement:**
|
|
137
|
-
- [ ] **Step 8 — Positive Control:**
|
|
138
|
-
- [ ] **Step 9 — Sequence:** Each candidate
|
|
139
|
-
-
|
|
140
|
-
-
|
|
141
|
-
-
|
|
142
|
-
-
|
|
143
|
-
-
|
|
144
|
-
-
|
|
123
|
+
Then pick the moment, separately from the tier: the editor or language server, pre-commit, pre-push, pull request, merge queue, post-merge, or scheduled. Run a cheap deterministic check as early as it can run. Put a slow or flaky one in the merge queue or on a schedule. **Done when:** `Tiers` holds the tier and the moment per candidate.
|
|
124
|
+
|
|
125
|
+
- [ ] **Step 7 — Enforcement:** **If** the integration branch accepts direct pushes → a CI check on that branch goes red after the code has landed, so it is detective, not preventive. For each candidate, record whether it is a required status check on the integration and release branches, who can bypass it, and whether the only preventive point is a pre-push hook that a verify-skip flag skips. **If** the only preventive point can be bypassed → the ranking says so. **Done when:** `Enforcement` has a row per candidate: branch · required? · bypass · preventive point.
|
|
126
|
+
- [ ] **Step 8 — Positive Control:** A gate that passes because it measures nothing is worse than no gate, because it stops anyone looking. The control every new gate must meet is to put the defect back and watch the gate go red. This run does not build the gate, so the report states that control. A gate with no proven-red demonstration is not finished. Related cheap checks: an unmatched browser-test locator can sit in a passing assertion, and a row-level denial can give silent zero rows that look like an empty table (`bkit-audit-database`). A skip is a hollow pass. A required job skipped by a job-level condition reports success. A workflow skipped by a path filter, a branch filter or a skip-CI marker leaves the required check pending. For each candidate, record the skip behaviour, and how a skip is kept from standing in for a pass. **If** proven-red is a convention for gate changes but not a merge requirement → propose making it one in `Process Improvements`. **Done when:** `Controls` states the positive control and the skip behaviour per candidate.
|
|
127
|
+
- [ ] **Step 9 — Sequence:** Each candidate runs report-only for at least one full cycle, then enforcing.
|
|
128
|
+
- This run does not land the gate. The landing reads the current tree, fixes or allowlists the findings, then flips the gate to enforcing.
|
|
129
|
+
- Name the candidates that would go red if enforced cold.
|
|
130
|
+
- Report-only ends when the gate meets its stated bar, not just when a cycle has passed. For each candidate, the bar is:
|
|
131
|
+
- a minimum number of runs
|
|
132
|
+
- an effective false-positive rate under 10% (findings judged not a real problem ÷ all findings)
|
|
133
|
+
- no unexplained reds
|
|
134
|
+
- no flakes of its own
|
|
135
|
+
- added p90 runtime under a stated budget
|
|
136
|
+
- Each report-only gate prints its finding count on every run, so `Health` can compute the false-positive rate.
|
|
137
|
+
- Name one enforcement tier. **Clear-then-gate** is the default: fix or allowlist every existing finding, then enforce on everything.
|
|
138
|
+
- Use a **Ratchet** (new violations only) when clearing the existing findings takes more than one PR. The gate then fails only on findings not in a committed baseline: the guard's baseline file, or the tool's own (e.g., the Betterer results file, or reviewdog's added-only mode).
|
|
139
|
+
- The baseline may only shrink, and each entry names an owner.
|
|
140
|
+
- An allowlist is per offender and keyed to its identity, never a rule downgrade or a route exclusion. Every entry cites an owner, because an entry with no owner and no date is a permanent exemption.
|
|
141
|
+
- A ratchet baseline has the same contract, and never grows.
|
|
142
|
+
|
|
143
|
+
**Done when:** `Sequence` names the bar and the tier per candidate.
|
|
144
|
+
|
|
145
|
+
- [ ] **Step 10 — Decision:** Any workflow change needs explicit human confirmation, so propose, and NEVER edit. The rule against weakening a gate applies to a new one too: the bar for adding a gate is that what it catches will be fixed. Record ADOPT, REJECT or OTHER, including the `docs/decisions.jsonl` row to append for ADOPT and REJECT. Appending is the next step. A rejection whose reason later stops holding must stay findable. **Done when:** every candidate in `Scores` has a verdict and row text, or OTHER with what settles it, and `Scores` holds the verdict counts (proposed, ADOPT, REJECT, OTHER, reverted).
|
|
146
|
+
- [ ] **Step 11 — Re-Review:** A gate that was built and reverted is not settled. Re-read each rejection in `docs/decisions.jsonl` and in prior reports, and check whether its reasoning still holds. Also search git history for gate steps that were removed or weakened (e.g., `git log -S` on the gate script or workflow step). A removed or weakened step with no `docs/decisions.jsonl` row is a finding. Two decisions on one guard with neither retired mean the criterion cannot be judged, which is a finding. **If** the reasoning no longer holds → score the candidate again in `Scores`, with the `docs/decisions.jsonl` row that would retire the old decision. **Done when:** `Rejections` has a row per reverted or rejected gate: still holds?
|
|
147
|
+
- [ ] **Step 12 — Health:** For each landed gate since the previous report, record the fire rate, the true-positive rate, overrides and bypasses, its own flakes, and its runtime. A gate that never fired is either perfectly preventive or hollow, and the two look the same from outside. A fresh positive control (`Positive Control`) tells them apart. **If** a gate never fired **or** is hollow → name that control as the next step. Every `bkit:gate:*` script in `package.json` is a landed gate, and workflows, agents and pre-push run only these. Expand each one, following every nested `pnpm <script>` to its body, and list each command. A hollow gate is `CRITICAL`: the script is missing or empty, or runs nothing that can fail (e.g., `echo`, `true`, `|| exit 0`, a trailing `; :` or `|| :`, `continue-on-error: true` on a test step, or a skip guard on a file that may be deleted, such as `if: hashFiles(...)`). A command that exits 0 when its tool is absent (e.g., `command -v … || echo skipping`) makes that check hollow; name the tool and its install step. For each test lane, compare the failure count in the runner's report with the step's conclusion: a `success` conclusion with failures is `CRITICAL`, because the lane goes green while tests fail. **If** a lane has no machine-readable runner report → record it in `Not Checked`, never as clean. **Done when:** `Health` has a row per landed gate, or says none landed, and each `bkit:gate:*` row lists every command and which ones can skip.
|
|
148
|
+
- [ ] **Step 13 — Allowlists:** Check every allowlist entry (known-offender maps, ratchet baselines, dead-code ignores) for a date that has passed or a cited issue that is closed. Each lapsed entry is a finding: renew it with a reason, or fix the offender. For each ratchet baseline, compare the entry count with the previous report. A baseline that grew, or an entry with no owner, is a finding. **Done when:** `Allowlists` lists every lapsed, grown or ownerless entry, or says `none`.
|
|
149
|
+
- [ ] **Step 14 — Standards:** Confirm the current version of each anchor standard, and read what changed since the previous report's version. In `Standards Coverage`, give one row per anchor practice (fitness functions, the static-analysis false-positive bar, new-code gating, ratchets, policy as code, rulesets and merge queue, the DORA CI capability) and per OpenSSF Scorecard check, marked checked (with the step), not applicable (saying why) or finding. Give each bkit anchor (a doc section, rule or issue shape) one row, marked followed (with the step or evidence), not applicable (saying why) or finding. A departure with no recorded reason (e.g., a `docs/decisions.jsonl` row or an accepted-divergence entry) is a finding. Mark each recommended practice the project does not apply as adopt (with a proposed step), reject (saying why) or not applicable. **Done when:** no row is empty.
|
|
150
|
+
- [ ] **Step 15 — Anything Else:** (a) List everything changed since the previous report's commit that touches gating (guards and contract tests, the hook directory, gate scripts, workflow jobs, rulesets and branch protection, allowlists), with a one-line verdict each. (b) In a bounded pass of about 30 minutes, note what a senior build and developer-productivity engineer would flag that no step asks about. Read what happened since the previous run (incidents, `bkit-audit-logs` reports, new `docs/failures.jsonl` rows, vendor status incidents), and note 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`.
|
|
145
151
|
|
|
146
152
|
### 🔒 Gate 2: Probes Check
|
|
147
153
|
|
|
148
|
-
**
|
|
149
|
-
|
|
150
|
-
- [ ] **
|
|
151
|
-
- [ ] **
|
|
152
|
-
- [ ] **
|
|
153
|
-
- [ ] **
|
|
154
|
-
- [ ] **Gate 2 - Verified:** Every checkbox above independently verified and checked off.
|
|
154
|
+
- [ ] **Steps complete:** every step is `[x]`, or skipped with evidence that its surface is absent.
|
|
155
|
+
- [ ] **Evidence:** every finding cites evidence someone can check again, and the tool that produced it.
|
|
156
|
+
- [ ] **Sources read:** every candidate cites the section it came from.
|
|
157
|
+
- [ ] **No summary-only scores:** no score rests on a sibling summary alone.
|
|
158
|
+
- [ ] **No gate landed:** no workflow, hook, allowlist or gate script changed.
|
|
159
|
+
- [ ] **Gate 2 — Verified:** every item above holds.
|
|
155
160
|
|
|
156
161
|
## Findings
|
|
157
162
|
|
|
158
163
|
<!-- prettier-ignore -->
|
|
159
164
|
| Severity | Use |
|
|
160
165
|
| --- | --- |
|
|
161
|
-
| `CRITICAL` |
|
|
162
|
-
| `HIGH` |
|
|
163
|
-
| `MEDIUM` |
|
|
164
|
-
| `LOW` |
|
|
166
|
+
| `CRITICAL` | An ungated class is data loss, a security hole, or a broken workflow with no workaround. A required check reports success when skipped, or when it measured nothing. |
|
|
167
|
+
| `HIGH` | A class has shipped real damage and still has a workaround. A landed gate has never fired and has no positive control. Structural false positives have no committed baseline. |
|
|
168
|
+
| `MEDIUM` | A repeat defect class has a home lane and no gate. A report-only candidate is past its bar with no enforce-or-stay decision. An allowlist entry is past its date or has no owner. |
|
|
169
|
+
| `LOW` | A candidate has no incident. An OTHER waits on a tool or a decision. Gate-message wording changes no pass/fail. |
|
|
165
170
|
|
|
166
|
-
|
|
171
|
+
A candidate takes the severity of the class its gate would catch. Within a severity, list the higher `Score` first.
|
|
167
172
|
|
|
168
173
|
<!-- prettier-ignore -->
|
|
169
174
|
| ID | Severity | Verdict | Location | Evidence | Expected |
|
|
170
175
|
| --- | --- | --- | --- | --- | --- |
|
|
171
176
|
| PENDING | PENDING | PENDING | PENDING | PENDING | PENDING |
|
|
172
177
|
|
|
173
|
-
|
|
178
|
+
**If** the run finds nothing → write one row: `None`.
|
|
174
179
|
|
|
175
180
|
## Report
|
|
176
181
|
|
|
@@ -247,17 +252,16 @@ PENDING
|
|
|
247
252
|
|
|
248
253
|
### 🔒 Gate 3: Report Check
|
|
249
254
|
|
|
250
|
-
**
|
|
251
|
-
|
|
252
|
-
- [ ] **
|
|
253
|
-
- [ ] **
|
|
254
|
-
- [ ] **
|
|
255
|
-
- [ ] **
|
|
256
|
-
- [ ] **Process Improvements:** `Universal`
|
|
257
|
-
- [ ] **Suggested Issues:** every `MEDIUM`+ finding ID in exactly one
|
|
258
|
-
- [ ] **
|
|
259
|
-
|
|
260
|
-
> `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.
|
|
255
|
+
- [ ] **No placeholders:** no `PENDING` is left.
|
|
256
|
+
- [ ] **Summary:** `Summary` gives the count per severity.
|
|
257
|
+
- [ ] **Verdict counts:** `Summary` gives the count per verdict (ADOPT / REJECT / OTHER).
|
|
258
|
+
- [ ] **Series:** the report shows verdict counts, `Health`, and allowlist sizes beside the previous report's numbers, or marks the run as baseline.
|
|
259
|
+
- [ ] **Writes:** this run changed only this report, the template's `Project Instructions` and its own `docs/failures.jsonl` rows.
|
|
260
|
+
- [ ] **Throwaways removed:** every throwaway worktree or remote target is removed.
|
|
261
|
+
- [ ] **Process Improvements:** `Universal` and `Project` are both filled.
|
|
262
|
+
- [ ] **Suggested Issues:** every `MEDIUM`+ finding ID is in exactly one `Suggested Issues` row.
|
|
263
|
+
- [ ] **Next Step:** every `Suggested Issues` row has a `Next Step`.
|
|
264
|
+
- [ ] **Gate 3 — Verified:** every item above holds.
|
|
261
265
|
|
|
262
266
|
<!-- bkit:end -->
|
|
263
267
|
|