@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,144 +1,128 @@
|
|
|
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
|
# Coverage Floor
|
|
8
8
|
|
|
9
9
|
> [!CAUTION]
|
|
10
|
-
> **Purpose:**
|
|
10
|
+
> **Purpose:** The ratchet of a CI coverage-floor gate: whether each committed floor still sits under the measured branch coverage, and the next floor each gated surface should move to.
|
|
11
11
|
>
|
|
12
12
|
> **Rules:**
|
|
13
13
|
>
|
|
14
|
-
> -
|
|
15
|
-
> -
|
|
16
|
-
> -
|
|
17
|
-
> -
|
|
18
|
-
> -
|
|
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 edit workflows, floor files, coverage config, or the gate script; the report states the edit.
|
|
23
|
-
> - never lower a floor, add an exclusion, or add an ignore hint.
|
|
24
|
-
> - NEVER run a tool that rewrites source to measure mutants or coverage. Read artifacts already produced.
|
|
14
|
+
> - Never edit workflows, floor files, coverage config or the gate script.
|
|
15
|
+
> - State each edit in the report instead.
|
|
16
|
+
> - Never lower a floor, add an exclusion or add an ignore hint.
|
|
17
|
+
> - NEVER run a tool that rewrites source to measure mutants or coverage.
|
|
18
|
+
> - Read the artifacts already produced.
|
|
25
19
|
|
|
26
20
|
## Universal Instructions
|
|
27
21
|
|
|
28
22
|
### Context & Goals
|
|
29
23
|
|
|
30
|
-
|
|
24
|
+
A static floor fails one way: coverage climbs, the gate stays far below it, and a large drop still passes green. Tightening off one run fails another way: branch coverage on identical code moves between runs, so the gate flakes, and a flaky gate gets disabled. The failure this audit targets is a floor left far under measured coverage, or a floor ratcheted onto noise.
|
|
31
25
|
|
|
32
|
-
**Applies when:** coverage floor gate exists.
|
|
26
|
+
**Applies when:** a coverage floor gate exists. **If** none exists → write one `N/A` row with its evidence, and never report the surface as "clean".
|
|
33
27
|
|
|
34
|
-
**Cadence:**
|
|
28
|
+
**Cadence:** Run once a month. Run an extra pass after a coverage lift, a runner or provider version change, an include, exclude or measured-glob change, or a new package or app under a gated glob.
|
|
35
29
|
|
|
36
|
-
**Anchor Standards:**
|
|
30
|
+
**Anchor Standards:**
|
|
37
31
|
|
|
38
|
-
- Coverage practice for a gate (e.g
|
|
39
|
-
- Coverage guide for pinned runner and provider (e.g
|
|
40
|
-
- Patch (diff) coverage (e.g
|
|
41
|
-
- Ratchet tooling (e.g
|
|
32
|
+
- Coverage practice for a gate (e.g., Google, "Code Coverage Best Practices"; Ivanković et al., "Code Coverage at Google").
|
|
33
|
+
- Coverage guide for pinned runner and provider (e.g., Vitest coverage, including `coverage.include` and AST-aware remapping; Jest coverage; Istanbul). Record major pinned.
|
|
34
|
+
- Patch (diff) coverage (e.g., Codecov patch status; PR coverage-comment changed-file mode). Record action version.
|
|
35
|
+
- Ratchet tooling (e.g., Betterer). Record version read.
|
|
42
36
|
- Goodhart's law: coverage is a signal, not a goal.
|
|
43
37
|
|
|
44
38
|
### Scope
|
|
45
39
|
|
|
46
|
-
-
|
|
47
|
-
- Sample
|
|
48
|
-
-
|
|
49
|
-
-
|
|
50
|
-
-
|
|
51
|
-
-
|
|
52
|
-
-
|
|
53
|
-
-
|
|
40
|
+
- Check the floor history: no floor dropped, no new exclusion and no new ignore hint.
|
|
41
|
+
- Sample >=10 full runs per gated surface.
|
|
42
|
+
- Ratchet from the lowest observation, never from one run.
|
|
43
|
+
- Compare the denominator: the files the glob should cover against the files in the summary.
|
|
44
|
+
- Measure the variance on identical code across two runs, and its cause (tests or tooling).
|
|
45
|
+
- Recommend a floor for each gated surface, each surface's floor on its own.
|
|
46
|
+
- List the report-only surfaces, including a named surface that emits no coverage.
|
|
47
|
+
- Report the high-risk modules, as report-only.
|
|
48
|
+
- Check the patch coverage of the changes merged since the previous report.
|
|
54
49
|
|
|
55
50
|
### Out of Scope
|
|
56
51
|
|
|
57
52
|
<!-- prettier-ignore -->
|
|
58
53
|
| Excluded item | Why | Where it belongs |
|
|
59
54
|
| --- | --- | --- |
|
|
60
|
-
| Whether tests check the right behaviour, can fail, or run |
|
|
61
|
-
| Conditional or timing-dependent tests behind a spread |
|
|
62
|
-
| Patch coverage as a new required check |
|
|
63
|
-
| Changing floors, exclusions, ignore hints, or workflows |
|
|
55
|
+
| Whether tests check the right behaviour, can fail, or run | The testing audit owns test quality | `bkit-audit-testing` |
|
|
56
|
+
| Conditional or timing-dependent tests behind a spread | The flakes audit owns them | `bkit-audit-flakes` |
|
|
57
|
+
| Patch coverage as a new required check | The gates audit owns gate ranking | `bkit-audit-gates` |
|
|
58
|
+
| Changing floors, exclusions, ignore hints, or workflows | The audit only reports | A plan made from this report |
|
|
64
59
|
|
|
65
60
|
### Pre-Flight / Dependencies
|
|
66
61
|
|
|
67
|
-
**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.
|
|
68
|
-
|
|
69
|
-
**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.
|
|
70
|
-
|
|
71
62
|
#### Core
|
|
72
63
|
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
- [ ] **
|
|
76
|
-
- [ ] **
|
|
77
|
-
- [ ] **
|
|
78
|
-
- [ ] **Git History:** Steps 3, 9, 15 — `git log -L` / `git log -p` on floor values and coverage config. Fallback: current tree only; history `Not Checked`.
|
|
79
|
-
- [ ] **Web:** Step 14 — fetch anchor standards. Fallback: versions recorded as unread.
|
|
64
|
+
- [ ] **Permissions:** every blocked call is recorded.
|
|
65
|
+
- [ ] **CI History:** Steps 4, 5, 7, 10 — branch coverage from full CI runs (e.g., `gh run list` / `gh run download`, GitLab pipelines, Codecov). Fallback: fill the gap with local re-runs, and mark every local observation.
|
|
66
|
+
- [ ] **Coverage Artifacts:** Steps 6, 7, 11, 12 — summary and per-file coverage (e.g., `coverage-summary.json`, `coverage-final.json`, lcov). Fallback: use percentages only, and mark file-level claims `Not Checked`.
|
|
67
|
+
- [ ] **Git History:** Steps 3, 9, 15 — `git log -L` / `git log -p` on the floor values and coverage config. Fallback: use the current tree only, and mark history `Not Checked`.
|
|
68
|
+
- [ ] **Web:** Step 14 — fetch the anchor standards. Fallback: record the versions as unread.
|
|
80
69
|
|
|
81
70
|
#### Conditional
|
|
82
71
|
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
- [ ] **
|
|
86
|
-
- [ ] **Mutation Score:** Mutation report or `bkit-audit-testing` report exists → Step 9 — latest score beside each gated surface. Fallback: movement without mutation comparison; record in `Not Checked`. Do not start a run that rewrites source.
|
|
87
|
-
- [ ] **Patch Source:** Changed-file coverage reported → Step 12 — e.g. PR coverage comment changed-file table, Codecov patch status. Fallback: diff plus per-file coverage; if neither, `Not Checked`.
|
|
72
|
+
- [ ] **Local Runner:** **If** a gated surface has fewer than ten CI observations, **or** CI keeps no per-file coverage artifact → Steps 4, 7 — re-run that surface's coverage command in a detached worktree, removed before the report finishes. Fallback: do not tighten that surface, and record the shortfall in `Not Checked`.
|
|
73
|
+
- [ ] **Mutation Score:** **If** a mutation report or a `bkit-audit-testing` report exists → Step 9 — the latest score beside each gated surface. Fallback: report movement without a mutation comparison, and record that in `Not Checked`. Do not start a run that rewrites source.
|
|
74
|
+
- [ ] **Patch Source:** **If** changed-file coverage is reported → Step 12 — the changed-file coverage (e.g., the PR coverage comment's changed-file table, Codecov patch status). Fallback: use the diff plus per-file coverage. **If** neither exists → mark it `Not Checked`.
|
|
88
75
|
|
|
89
76
|
### 🔒 Gate 1: Prerequisites Check
|
|
90
77
|
|
|
91
|
-
|
|
92
|
-
|
|
93
|
-
- [ ] **Gaps named:** every missing item names its fallback and `Not Checked` entry.
|
|
94
|
-
- [ ] **Gate 1 - Verified:** All Core items checked. All applicable Conditional items checked.
|
|
78
|
+
- [ ] **Gaps named:** every missing item names its fallback and its `Not Checked` entry.
|
|
79
|
+
- [ ] **Gate 1 — Verified:** every item above, every Core item and every applicable Conditional item is checked.
|
|
95
80
|
|
|
96
81
|
### Probe Steps
|
|
97
82
|
|
|
98
|
-
- [ ] **Step 1 — Previous Run:**
|
|
99
|
-
- [ ] **Step 2 — Detect:** Find coverage floor gate (CI job, script
|
|
100
|
-
- [ ] **Step 3 — History:** Since previous report's commit
|
|
101
|
-
- [ ] **Step 4 — Sample:**
|
|
102
|
-
- [ ] **Step 5 — Lowest:**
|
|
103
|
-
- [ ] **Step 6 — Denominator:**
|
|
104
|
-
- [ ] **Step 7 — Variance:**
|
|
105
|
-
- [ ] **Step 8 — Floor:**
|
|
106
|
-
- [ ] **Step 9 — Movement:** Name tests that caused lift
|
|
107
|
-
- [ ] **Step 10 — Report-Only:** List report-only surfaces and numbers. Not gating is part of record:
|
|
108
|
-
- [ ] **Step 11 — Modules:**
|
|
109
|
-
- [ ] **Step 12 — Patch:**
|
|
110
|
-
- [ ] **Step 13 — Recommend:**
|
|
111
|
-
- [ ] **Step 14 — Standards:** Confirm current version
|
|
112
|
-
- [ ] **Step 15 — Anything Else:** (a)
|
|
83
|
+
- [ ] **Step 1 — Previous Run:** **Done when:** `Previous Run` holds the closure rate, or the run is marked baseline.
|
|
84
|
+
- [ ] **Step 2 — Detect:** Find the coverage floor gate (a CI job, script or threshold that fails below a committed number) and where the number is stored. List the hard-gated and the report-only surfaces. The metric is branch coverage, unless a recorded decision names another. Line, statement and function percentages are not floors. **If** there is no gate → write `N/A` and **STOP**. **Done when:** `Checked` holds gate path, metric, surface list, or `N/A` is recorded → **STOP**.
|
|
85
|
+
- [ ] **Step 3 — History:** Since the previous report's commit, check that no floor dropped (`git log -L` on each floor value and on the coverage include and exclude). A floor never moves down: a drop is fixed, not accommodated. Diff the exclusions. Count the ignore hints under each gated glob, then and now (e.g., `v8 ignore`, `istanbul ignore`, `c8 ignore`, `# pragma: no cover`). Each new exclusion and each new ignore hint is a finding, with its commit. **Done when:** `History` lists every floor change, new exclusion and new ignore hint, or `none`.
|
|
86
|
+
- [ ] **Step 4 — Sample:** For each gated surface, take >=10 full runs: on the same commit, or the most recent full CI runs on the default branch, else on the integration branch. Record which source each run came from. Use CI history first, and re-run locally only to fill a gap. Mark the local observations. Record every run id. Include no partial lane. Never ratchet off a single run. **Done when:** `Sample` holds >=10 observations per gated surface, or names the shortfall and leaves that floor untightened.
|
|
87
|
+
- [ ] **Step 5 — Lowest:** For each gated surface, record every observation, and ratchet from the lowest, not the latest. Write covered/total beside each percentage. Spread = max − min. A spread above two points is a finding (non-deterministic coverage). `Variance` finds the cause, and `Floor` does not tighten until the spread is fixed. **Done when:** `Sample` holds one row per surface, with the observations, covered/total, the lowest and the spread.
|
|
88
|
+
- [ ] **Step 6 — Denominator:** **If** the runner omits a file that no test imports unless the include list names it (e.g., Vitest >=4) → compare the summary's file count with `git ls-files` for the glob the surface should cover, and list the source files missing from the report. A missing file inflates the percentage, which is a finding. **If** the project uses another runner → check its equivalent omission, or skip with evidence. **Done when:** `Denominator` holds the missing files, or the skip is recorded.
|
|
89
|
+
- [ ] **Step 7 — Variance:** Coverage on identical code should match. Take two runs on the same commit, diff the per-file coverage (e.g., `coverage-final.json`), and list the files whose covered branches differ. Conditional or timing-dependent tests go to `bkit-audit-flakes`. **Done when:** `Variance` holds the file list, or records that the runs are identical.
|
|
90
|
+
- [ ] **Step 8 — Floor:** The recommended floor = the lowest observation, rounded down, minus one point. **If** the spread is above two points → keep the current floor. **If** the recommended floor is below the current floor → leave the floor as it is, and record the drop as a finding. Surfaces ratchet separately, so do not nudge a surface whose tests did not change. **Done when:** `Recommendation` holds the current, lowest and recommended floor, and whether to move, for each gated surface.
|
|
91
|
+
- [ ] **Step 9 — Movement:** Name the tests that caused a lift, and whether they are durable (run on every tier invocation) or in a conditional lane. A ratchet with no named cause is a finding. Before crediting tests, record the runner, the coverage-provider package and the provider for each run in `Sample`, and diff the lockfile between the oldest and newest runs. **If** the provider changed (e.g., AST-aware remapping) → branch counts move with no test change, so do not credit the tests with that movement. Put the latest mutation score beside each gated surface. Coverage up with mutation flat is a finding, because the tests cover code but check nothing, and it goes to `bkit-audit-testing`. **Done when:** `Movement` names the cause for each surface, or the tooling change that explains it.
|
|
92
|
+
- [ ] **Step 10 — Report-Only:** List the report-only surfaces and their numbers. Not gating is part of the record: each surface stays report-only (saying why) or has a date to decide. A surface reported across runs with no decision is a finding. A project-named surface with no coverage is a finding, not an omission. Record any E2E-collected coverage, or server and route code that no unit test reaches (e.g., V8/Istanbul through a browser runner and merger). **If** there is none → say so. **Done when:** `Report-Only` holds one row per surface, with the number, the decision and whether coverage is collected.
|
|
93
|
+
- [ ] **Step 11 — Modules:** For each project-named high-risk area, record the branch coverage and the absolute number of uncovered branches. Name the files, so the next run measures the same set. This is report-only and does not move the floor. **Done when:** `Modules` holds one row per area, with its files, branch % and uncovered branches.
|
|
94
|
+
- [ ] **Step 12 — Patch:** List every change merged since the previous report whose changed lines had branch coverage below a stated bar, and state the bar (default 90% per commit, unless the project states another). Patch coverage names the change that dropped coverage, which the aggregate gate does not. A change below the bar is a finding, and a gate candidate for `bkit-audit-gates`. **Done when:** `Patch` lists every below-bar change, or `none`, and states the bar.
|
|
95
|
+
- [ ] **Step 13 — Recommend:** For each surface, state old floor → new floor and the edit (file and value). Do not apply it. A workflow change in the edit needs explicit human confirmation. Note whether the previous report's recommended floor matches the tree. For each surface, write one line on what red means: often an untested file under the glob, not removed coverage. **If** CI does not print the recommended next floor (the lowest of the sample, rounded down, minus one point) beside the current one → propose that in `Process Improvements`. **Done when:** `Recommendation` holds the edit text and the red-means line, and the tree is unchanged.
|
|
96
|
+
- [ ] **Step 14 — Standards:** Confirm the current version of each anchor standard, and read what changed since the previous report's version. Give `Standards Coverage` one row per anchor practice for a coverage gate (e.g., the per-commit bar, include-list guidance, patch coverage, ratchet tooling), 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.
|
|
97
|
+
- [ ] **Step 15 — Anything Else:** (a) Give a one-line verdict on each change since the previous report's commit that touches coverage measurement: runner and provider versions, include and exclude, ignore hints, measured globs, floor files, the gate script, the merge script, the floor step, and new packages and apps. (b) In a bounded pass of about 30 minutes, note what a senior test engineer owning CI quality gates 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), 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`.
|
|
113
98
|
|
|
114
99
|
### 🔒 Gate 2: Probes Check
|
|
115
100
|
|
|
116
|
-
**
|
|
117
|
-
|
|
118
|
-
- [ ] **
|
|
119
|
-
- [ ] **
|
|
120
|
-
- [ ] **
|
|
121
|
-
- [ ] **
|
|
122
|
-
- [ ] **Gate 2 - Verified:** Every checkbox above independently verified and checked off.
|
|
101
|
+
- [ ] **Steps complete:** every step is `[x]`, or skipped with evidence that its surface is absent.
|
|
102
|
+
- [ ] **Evidence:** every finding cites evidence someone can check again, and the tool that produced it.
|
|
103
|
+
- [ ] **Floors untouched:** no workflow, floor file, coverage config or gate script changed.
|
|
104
|
+
- [ ] **Sample:** every gated surface has >=10 full-run observations, or a named shortfall with its floor not tightened.
|
|
105
|
+
- [ ] **Full runs only:** the sample holds no partial lane.
|
|
106
|
+
- [ ] **Gate 2 — Verified:** every item above holds.
|
|
123
107
|
|
|
124
108
|
## Findings
|
|
125
109
|
|
|
126
110
|
<!-- prettier-ignore -->
|
|
127
111
|
| Severity | Use |
|
|
128
112
|
| --- | --- |
|
|
129
|
-
| `CRITICAL` |
|
|
130
|
-
| `HIGH` |
|
|
131
|
-
| `MEDIUM` |
|
|
132
|
-
| `LOW` |
|
|
113
|
+
| `CRITICAL` | The floor gate was removed, or a gated surface was dropped from it with no replacement. The gate passes when the coverage summary is missing |
|
|
114
|
+
| `HIGH` | A floor was lowered. A new exclusion or ignore hint under a gated glob. A spread above two points. Source files in the glob missing from the summary |
|
|
115
|
+
| `MEDIUM` | The recommended floor is below the current one and the drop is left in place. Coverage up while the mutation score stays flat. A report-only surface with no stay-or-gate decision. A high-risk module with uncovered branches. A change merged below the patch bar. Movement with no named cause |
|
|
116
|
+
| `LOW` | A comment or prose in a floor file that does not change the number. Report-only drift inside a recorded stay-report-only decision |
|
|
133
117
|
|
|
134
|
-
|
|
118
|
+
Within a severity, list gated surfaces first, then exclusions.
|
|
135
119
|
|
|
136
120
|
<!-- prettier-ignore -->
|
|
137
121
|
| ID | Severity | Location | Evidence | Expected |
|
|
138
122
|
| --- | --- | --- | --- | --- |
|
|
139
123
|
| PENDING | PENDING | PENDING | PENDING | PENDING |
|
|
140
124
|
|
|
141
|
-
|
|
125
|
+
**If** the run finds nothing → write one row: `None`.
|
|
142
126
|
|
|
143
127
|
## Report
|
|
144
128
|
|
|
@@ -215,17 +199,16 @@ PENDING
|
|
|
215
199
|
|
|
216
200
|
### 🔒 Gate 3: Report Check
|
|
217
201
|
|
|
218
|
-
**
|
|
219
|
-
|
|
220
|
-
- [ ] **
|
|
221
|
-
- [ ] **
|
|
222
|
-
- [ ] **
|
|
223
|
-
- [ ] **
|
|
224
|
-
- [ ] **Process Improvements:** `Universal`
|
|
225
|
-
- [ ] **Suggested Issues:** every `MEDIUM`+ finding ID in exactly one
|
|
226
|
-
- [ ] **
|
|
227
|
-
|
|
228
|
-
> `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.
|
|
202
|
+
- [ ] **No placeholders:** no `PENDING` is left.
|
|
203
|
+
- [ ] **Summary:** `Summary` gives the count per severity.
|
|
204
|
+
- [ ] **Floors:** `Summary` gives old floor → recommended floor for each gated surface.
|
|
205
|
+
- [ ] **Series:** the report shows `Sample` spreads and the floor series beside the previous report's numbers, or marks the run as baseline.
|
|
206
|
+
- [ ] **Writes:** this run changed only this report, the template's `Project Instructions` and its own `docs/failures.jsonl` rows.
|
|
207
|
+
- [ ] **Throwaways removed:** every throwaway worktree or remote target is removed.
|
|
208
|
+
- [ ] **Process Improvements:** `Universal` and `Project` are both filled.
|
|
209
|
+
- [ ] **Suggested Issues:** every `MEDIUM`+ finding ID is in exactly one `Suggested Issues` row.
|
|
210
|
+
- [ ] **Next Step:** every `Suggested Issues` row has a `Next Step`.
|
|
211
|
+
- [ ] **Gate 3 — Verified:** every item above holds.
|
|
229
212
|
|
|
230
213
|
<!-- bkit:end -->
|
|
231
214
|
|