@cbartens/bkit 6.0.0 → 6.1.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.bkit/README.md +154 -151
- package/.bkit/core/.agents/context.md +95 -29
- package/.bkit/core/.agents/docs.md +17 -15
- package/.bkit/core/.agents/plugins/bkit/hooks/bkit-gateguard.cjs +1 -0
- package/.bkit/core/.agents/plugins/bkit/hooks/bkit-guardrails.cjs +6 -5
- package/.bkit/core/.agents/plugins/bkit/hooks/bkit-readguard.cjs +1 -0
- package/.bkit/core/.agents/plugins/bkit/hooks/bkit-rules.cjs +65 -0
- package/.bkit/core/.agents/rules.md +108 -107
- package/.bkit/core/.agents/skills.md +63 -15
- package/.bkit/core/.bkit/README.md +154 -151
- package/.bkit/core/.bkit/authoring.md +714 -84
- package/.bkit/core/.bkit/cli.md +407 -0
- package/.bkit/core/.bkit/cloud.md +281 -193
- package/.bkit/core/.bkit/comparison.md +43 -41
- package/.bkit/core/.bkit/install.md +154 -84
- package/.bkit/core/.bkit/jsonl.md +193 -130
- package/.bkit/core/.bkit/pipeline.md +114 -114
- package/.bkit/core/.bkit/prompts.md +272 -165
- package/.bkit/core/.bkit/providers.md +457 -271
- package/.bkit/core/.bkit/router.md +69 -0
- package/.bkit/core/.bkit/templates.md +529 -256
- package/.bkit/core/.bkit/trackers.md +80 -52
- package/.bkit/core/.bkit/workflows.md +589 -504
- package/.bkit/core/.claude/hooks/bkit-gateguard.cjs +2 -2
- package/.bkit/core/.claude/hooks/bkit-guardrails.cjs +3 -3
- package/.bkit/core/.claude/hooks/bkit-preflight.sh +45 -14
- package/.bkit/core/.codex/hooks/bkit-guardrails.cjs +3 -3
- package/.bkit/core/.codex/hooks/bkit-rules.cjs +57 -0
- package/.bkit/core/.cursor/hooks/bkit-guardrails.cjs +7 -7
- package/.bkit/core/.cursor/hooks/bkit-preflight.sh +47 -12
- package/.bkit/core/.opencode/plugin/bkit-rules.js +89 -0
- package/.bkit/core/AGENTS.md +5 -73
- package/.bkit/core/docs/templates/bkit-audit-accessibility.md +127 -105
- package/.bkit/core/docs/templates/bkit-audit-adoption.md +104 -70
- package/.bkit/core/docs/templates/bkit-audit-agents.md +94 -72
- package/.bkit/core/docs/templates/bkit-audit-aio-seo.md +99 -78
- package/.bkit/core/docs/templates/bkit-audit-analytics.md +140 -82
- package/.bkit/core/docs/templates/bkit-audit-annotations.md +98 -72
- package/.bkit/core/docs/templates/bkit-audit-app-performance.md +121 -96
- package/.bkit/core/docs/templates/bkit-audit-app-store.md +157 -76
- package/.bkit/core/docs/templates/bkit-audit-architecture.md +113 -71
- package/.bkit/core/docs/templates/bkit-audit-ci-performance.md +75 -72
- package/.bkit/core/docs/templates/bkit-audit-config.md +122 -76
- package/.bkit/core/docs/templates/bkit-audit-cost.md +85 -74
- package/.bkit/core/docs/templates/bkit-audit-coverage.md +75 -68
- package/.bkit/core/docs/templates/bkit-audit-database.md +101 -70
- package/.bkit/core/docs/templates/bkit-audit-dead-code.md +164 -83
- package/.bkit/core/docs/templates/bkit-audit-deferrals.md +115 -86
- package/.bkit/core/docs/templates/bkit-audit-dependencies.md +264 -88
- package/.bkit/core/docs/templates/bkit-audit-documentation.md +118 -93
- package/.bkit/core/docs/templates/bkit-audit-duplication.md +139 -86
- package/.bkit/core/docs/templates/bkit-audit-failures.md +110 -81
- package/.bkit/core/docs/templates/bkit-audit-flakes.md +99 -74
- package/.bkit/core/docs/templates/bkit-audit-gates.md +105 -77
- package/.bkit/core/docs/templates/bkit-audit-issues.md +104 -80
- package/.bkit/core/docs/templates/bkit-audit-llm.md +131 -58
- package/.bkit/core/docs/templates/bkit-audit-logs.md +123 -100
- package/.bkit/core/docs/templates/bkit-audit-models.md +98 -53
- package/.bkit/core/docs/templates/bkit-audit-privacy.md +56 -52
- package/.bkit/core/docs/templates/bkit-audit-prompts.md +63 -54
- package/.bkit/core/docs/templates/bkit-audit-red-team.md +124 -68
- package/.bkit/core/docs/templates/bkit-audit-reliability.md +95 -70
- package/.bkit/core/docs/templates/bkit-audit-repo.md +169 -73
- package/.bkit/core/docs/templates/bkit-audit-security.md +206 -96
- package/.bkit/core/docs/templates/bkit-audit-slop.md +77 -70
- package/.bkit/core/docs/templates/bkit-audit-testing.md +162 -114
- package/.bkit/core/docs/templates/bkit-audit-usability.md +113 -71
- package/.bkit/core/docs/templates/bkit-plan.md +138 -132
- package/.bkit/core/engine/checks/after/auth.ts +40 -37
- package/.bkit/core/engine/checks/after/ci-yml.ts +65 -2
- package/.bkit/core/engine/checks/after/index.ts +12 -2
- package/.bkit/core/engine/checks/after/tools.ts +80 -33
- package/.bkit/core/engine/checks/before/context-fetch.ts +227 -33
- package/.bkit/core/engine/checks/before/env.ts +1 -1
- package/.bkit/core/engine/checks/before/index.ts +7 -0
- package/.bkit/core/engine/checks/before/repo.ts +40 -0
- package/.bkit/core/engine/checks/status-holes.ts +916 -123
- package/.bkit/core/engine/checks/tips/catalogue.ts +68 -17
- package/.bkit/core/engine/checks/tips/detect.ts +32 -0
- package/.bkit/core/engine/checks/tips/index.ts +47 -6
- package/.bkit/core/engine/cli.ts +238 -84
- package/.bkit/core/engine/commands/analysis.ts +128 -76
- package/.bkit/core/engine/commands/ci/ci.ts +363 -29
- package/.bkit/core/engine/commands/ci/pins.ts +172 -0
- package/.bkit/core/engine/commands/ci/push-gate.ts +223 -0
- package/.bkit/core/engine/commands/install/uninstall.ts +21 -27
- package/.bkit/core/engine/commands/install/upgrade.ts +32 -15
- package/.bkit/core/engine/commands/land.ts +126 -11
- package/.bkit/core/engine/commands/lib.ts +303 -6
- package/.bkit/core/engine/commands/registry.ts +6 -2
- package/.bkit/core/engine/commands/setup/setup.ts +1 -0
- package/.bkit/core/engine/commands/stats.ts +91 -35
- package/.bkit/core/engine/commands/workflow/branches.ts +1477 -117
- package/.bkit/core/engine/commands/workflow/challenge.ts +114 -39
- package/.bkit/core/engine/commands/workflow/completeness.ts +109 -0
- package/.bkit/core/engine/commands/workflow/context.ts +433 -55
- package/.bkit/core/engine/commands/workflow/counters.ts +244 -39
- package/.bkit/core/engine/commands/workflow/decisions.ts +61 -17
- package/.bkit/core/engine/commands/workflow/disk.ts +237 -55
- package/.bkit/core/engine/commands/workflow/fids.ts +19 -1
- package/.bkit/core/engine/commands/workflow/issues.ts +6 -0
- package/.bkit/core/engine/commands/workflow/ledgers.ts +458 -18
- package/.bkit/core/engine/commands/workflow/locks.ts +2 -0
- package/.bkit/core/engine/commands/workflow/plan-blocks.ts +124 -15
- package/.bkit/core/engine/commands/workflow/plans.ts +257 -0
- package/.bkit/core/engine/commands/workflow/prs.ts +12 -3
- package/.bkit/core/engine/commands/workflow/repo.ts +8 -0
- package/.bkit/core/engine/commands/workflow/roadmap.ts +56 -15
- package/.bkit/core/engine/commands/workflow/run-facts.ts +22 -31
- package/.bkit/core/engine/commands/workflow/runs.ts +652 -34
- package/.bkit/core/engine/commands/workflow/runtime.ts +3 -0
- package/.bkit/core/engine/commands/workflow/skills.ts +1 -0
- package/.bkit/core/engine/commands/workflow/status.ts +200 -17
- package/.bkit/core/engine/commands/workflow/step-table.ts +75 -33
- package/.bkit/core/engine/commands/workflow/steps.ts +635 -24
- package/.bkit/core/engine/commands/workflow/summary-findings.ts +177 -0
- package/.bkit/core/engine/commands/workflow/summary.ts +192 -46
- package/.bkit/core/engine/commands/workflow/tasks.ts +409 -0
- package/.bkit/core/engine/commands/workflow/test-blocks.ts +254 -0
- package/.bkit/core/engine/commands/workflow/tests-changed.ts +201 -0
- package/.bkit/core/engine/commands/workflow/tests.ts +1285 -356
- package/.bkit/core/engine/commands/workflow/workflows.ts +228 -43
- package/.bkit/core/engine/commands/workflow/worktrees.ts +389 -47
- package/.bkit/core/engine/install/cloud-env.ts +251 -121
- package/.bkit/core/engine/install/context-ci-workflow.ts +102 -0
- package/.bkit/core/engine/install/manifest.ts +60 -12
- package/.bkit/core/engine/install/modules/antigravity.ts +3 -2
- package/.bkit/core/engine/install/modules/cloud.ts +3 -3
- package/.bkit/core/engine/install/modules/codex.ts +15 -2
- package/.bkit/core/engine/install/modules/core.ts +956 -52
- package/.bkit/core/engine/install/modules/cursor.ts +6 -6
- package/.bkit/core/engine/install/modules/opencode.ts +16 -4
- package/.bkit/core/engine/install/template-notes.ts +130 -0
- package/.bkit/core/engine/install/version-file.ts +3 -2
- package/.bkit/core/engine/install/write.ts +5 -0
- package/.bkit/core/engine/ledgers/compact.ts +124 -0
- package/.bkit/core/engine/ledgers/journal.ts +291 -0
- package/.bkit/core/engine/ledgers/status.ts +160 -9
- package/.bkit/core/engine/ledgers/telemetry.ts +158 -21
- package/.bkit/core/engine/render/hosts.ts +114 -14
- package/.bkit/core/engine/shared/bkit-latest.ts +26 -4
- package/.bkit/core/engine/shared/dep-updater.ts +60 -0
- package/.bkit/core/engine/shared/egress.ts +1 -1
- package/.bkit/core/engine/shared/package-manager.ts +9 -0
- package/.bkit/core/engine/shared/settings.ts +92 -17
- package/.bkit/core/engine/shared/timeouts.ts +2 -0
- package/.bkit/core/engine/tools/cli-doc.ts +111 -0
- package/.bkit/core/engine/tools/grammar-density.ts +1 -1
- package/.bkit/core/engine/tools/instructions-sources.ts +15 -17
- package/.bkit/core/engine/tools/instructions.ts +94 -43
- package/.bkit/core/hooks/antigravity-hook.js +25 -10
- package/.bkit/core/hooks/gateguard-engine.js +53 -29
- package/.bkit/core/hooks/guardrails-shell.js +4 -4
- package/.bkit/core/hooks/guardrails-tiers.js +3 -3
- package/.bkit/core/hooks/preflight-linear.sh +9 -9
- package/.bkit/core/hooks/preflight-rules.sh +8 -0
- package/.bkit/core/hooks/readguard-engine.js +29 -10
- package/.bkit/core/hooks/session-rules-advisory.js +61 -0
- package/.bkit/core/prompts/bkit-audit-generate.md +187 -116
- package/.bkit/core/prompts/bkit-build-challenge-1.md +56 -37
- package/.bkit/core/prompts/bkit-build-challenge-2.md +65 -45
- package/.bkit/core/prompts/bkit-build-install-skills.md +38 -29
- package/.bkit/core/prompts/bkit-build-plan-convert.md +43 -32
- package/.bkit/core/prompts/bkit-build-plan-current.md +49 -39
- package/.bkit/core/prompts/bkit-build-plan-gaps-remediate.md +79 -55
- package/.bkit/core/prompts/bkit-build-plan-tasks.md +149 -0
- package/.bkit/core/prompts/bkit-build-plan-tests.md +120 -0
- package/.bkit/core/prompts/bkit-build-plan-verify.md +87 -50
- package/.bkit/core/prompts/bkit-debug-abort-handover.md +36 -35
- package/.bkit/core/prompts/bkit-debug-failure-diagnose.md +96 -64
- package/.bkit/core/prompts/bkit-debug-failure-remediate.md +54 -45
- package/.bkit/core/prompts/bkit-debug-failure-reproduce.md +42 -33
- package/.bkit/core/prompts/bkit-debug-failure-soak.md +53 -37
- package/.bkit/core/prompts/bkit-design-brainstorm-ideate-1.md +35 -30
- package/.bkit/core/prompts/bkit-design-brainstorm-ideate-2.md +34 -29
- package/.bkit/core/prompts/bkit-design-brainstorm-ideate-3.md +32 -28
- package/.bkit/core/prompts/bkit-design-generate.md +68 -52
- package/.bkit/core/prompts/bkit-design-organise.md +73 -35
- package/.bkit/core/prompts/bkit-design-review-1.md +58 -54
- package/.bkit/core/prompts/bkit-design-review-2.md +54 -50
- package/.bkit/core/prompts/bkit-design-spike.md +54 -47
- package/.bkit/core/prompts/bkit-design-update.md +42 -31
- package/.bkit/core/prompts/bkit-plan-generate.md +76 -58
- package/.bkit/core/prompts/bkit-plan-review-1.md +63 -49
- package/.bkit/core/prompts/bkit-plan-review-2.md +60 -48
- package/.bkit/core/prompts/bkit-plan-scope-check.md +53 -46
- package/.bkit/core/prompts/bkit-plan-update.md +70 -52
- package/.bkit/core/prompts/bkit-ship-conflict-resolve.md +82 -50
- package/.bkit/core/prompts/bkit-ship-deferred-sweep.md +80 -45
- package/.bkit/core/prompts/bkit-ship-update-docs.md +35 -29
- package/.bkit/core/prompts/bkit-utility-compress-markdown.md +55 -49
- package/.bkit/core/prompts/bkit-utility-update-decisions.md +76 -49
- package/.bkit/core/prompts/bkit-utility-update-deferrals.md +70 -41
- package/.bkit/core/prompts/bkit-utility-update-documentation.md +33 -30
- package/.bkit/core/prompts/bkit-utility-update-failures.md +73 -43
- package/.bkit/core/prompts/bkit-utility-update-knowledge.md +77 -50
- package/.bkit/core/prompts/bkit-utility-update-roadmap.md +77 -45
- package/.bkit/core/prompts/bkit-utility-update-tracker.md +144 -68
- package/.bkit/core/workflows/bkit-auto.md +53 -30
- package/.bkit/core/workflows/bkit-build.md +635 -304
- package/.bkit/core/workflows/bkit-debug.md +301 -148
- package/.bkit/core/workflows/bkit-design.md +167 -95
- package/.bkit/core/workflows/bkit-plan.md +172 -84
- package/.bkit/core/workflows/bkit-ship.md +299 -152
- package/.bkit/shared/.agents/plugins/bkit/hooks.json +10 -0
- package/.bkit/shared/.claude/bkit-cloud.md +12 -10
- package/.bkit/shared/.claude/settings.json +3 -0
- package/.bkit/shared/.codex/bkit-cloud.md +98 -0
- package/.bkit/shared/.codex/hooks.json +20 -0
- package/.bkit/shared/.cursor/bkit-cloud.md +3 -3
- package/.bkit/shared/.opencode/opencode.json +1 -1
- package/.bkit/shared/CLAUDE.md +5 -1
- package/.bkit/shared/GEMINI.md +4 -1
- package/.bkit/shared/docs/architecture.md +4 -7
- package/.bkit/shared/docs/data-schema.md +4 -7
- package/.bkit/shared/docs/deployments.md +239 -166
- package/.bkit/shared/docs/design.md +11 -12
- package/.bkit/shared/docs/noise.md +8 -7
- package/.bkit/shared/docs/observability.md +5 -8
- package/.bkit/shared/docs/security.md +35 -17
- package/.bkit/shared/docs/setup.md +29 -18
- package/.bkit/shared/docs/technology.md +3 -6
- package/.bkit/shared/docs/testing.md +282 -176
- package/.bkit/shared/gitignore +6 -2
- package/.bkit/templates/.claude/hooks/bkit-cloud-bootstrap.sh +15 -16
- package/.bkit/templates/.cursor/Dockerfile +12 -8
- package/.bkit/templates/.cursor/environment.json +1 -1
- package/.bkit/templates/.github/ISSUE_TEMPLATE/bkit-bug.yml +10 -8
- package/.bkit/templates/.github/ISSUE_TEMPLATE/bkit-change.yml +24 -12
- package/.bkit/templates/.github/ISSUE_TEMPLATE/bkit-idea.yml +3 -3
- package/.bkit/templates/.github/renovate.json5 +34 -6
- package/.bkit/templates/.github/workflows/bkit-ci.yml +53 -50
- package/.bkit/templates/.github/workflows/bkit-cloud.yml +13 -14
- package/.bkit/templates/.github/workflows/bkit-health.yml +97 -0
- package/.bkit/templates/.github/workflows/bkit-renovate.yml +5 -4
- package/.bkit/templates/.github/workflows/bkit-trivy.yml +5 -4
- package/.bkit/templates/.husky/pre-commit +2 -2
- package/.bkit/templates/.husky/pre-push +95 -35
- package/.bkit/templates/.prettierignore +6 -7
- package/.bkit/templates/.vale.ini +27 -27
- package/.bkit/templates/context/bkit-cloudrun.md +23 -15
- package/.bkit/templates/context/bkit-expo.md +70 -52
- package/.bkit/templates/context/bkit-github.md +93 -56
- package/.bkit/templates/context/bkit-inngest.md +21 -15
- package/.bkit/templates/context/bkit-maestro.md +22 -16
- package/.bkit/templates/context/bkit-playwright.md +23 -17
- package/.bkit/templates/context/bkit-resend.md +12 -10
- package/.bkit/templates/context/bkit-sentry.md +30 -20
- package/.bkit/templates/context/bkit-serena.md +8 -7
- package/.bkit/templates/context/bkit-stripe.md +14 -13
- package/.bkit/templates/context/bkit-supabase.md +16 -13
- package/.bkit/templates/context/bkit-tavily.md +14 -11
- package/.bkit/templates/context/bkit-vercel.md +27 -18
- package/.bkit/templates/docs/capabilities.md +15 -14
- package/.bkit/templates/scripts/ci/{check-accepted-divergences.mjs → bkit-check-accepted-divergences.mjs} +6 -3
- package/.bkit/templates/scripts/ci/{check-accepted-divergences.test.mjs → bkit-check-accepted-divergences.test.mjs} +3 -3
- package/.bkit/templates/scripts/ci/{check-capstone.mjs → bkit-check-capstone.mjs} +2 -2
- package/.bkit/templates/scripts/ci/{check-capstone.test.mjs → bkit-check-capstone.test.mjs} +4 -4
- package/.bkit/templates/scripts/ci/{check-dependency-audit.mjs → bkit-check-dependency-audit.mjs} +103 -18
- package/.bkit/templates/scripts/ci/{check-dependency-audit.test.mjs → bkit-check-dependency-audit.test.mjs} +31 -3
- package/.bkit/templates/scripts/ci/bkit-machine-lock.sh +387 -0
- package/.bkit/templates/scripts/ci/bkit-test-awake.mjs +75 -0
- package/.bkit/templates/scripts/ci/bkit-test-awake.test.mjs +160 -0
- package/.bkit/templates/scripts/ci/lanes/{resolve-push-base.mjs → bkit-resolve-push-base.mjs} +3 -3
- package/.bkit/templates/scripts/ci/lanes/{resolve-push-base.test.mjs → bkit-resolve-push-base.test.mjs} +4 -4
- package/.bkit/templates/scripts/cleanup/bkit-disk-prune.mjs +9 -1
- package/.bkit/templates/scripts/graphify/bkit-graph-drift.py +1 -1
- package/.bkit/templates/scripts/graphify/bkit-graph-eager.py +3 -3
- package/.bkit/templates/scripts/graphify/bkit-graph-embed.py +63 -0
- package/.bkit/templates/scripts/graphify/bkit-graph-imports.py +2 -2
- package/.bkit/templates/scripts/graphify/bkit-graph-pre-push.sh +69 -18
- package/.bkit/templates/scripts/graphify/bkit-graph-repair.py +3 -3
- package/.bkit/templates/scripts/graphify/bkit-graph-surface.py +1 -1
- package/.bkit/templates/scripts/graphify/bkit-graphify-graphml.py +1 -1
- package/.bkit/templates/scripts/graphify/bkit-graphify-rollup.py +197 -126
- package/.bkit/templates/scripts/graphify/bkit-graphify.sh +64 -41
- package/.bkit/templates/scripts/slop/bkit-slop-type-suppression.mjs +23 -7
- package/.bkit/templates/slop-scan.config.json +9 -2
- package/CHANGELOG.md +119 -0
- package/README.md +250 -76
- package/dist/checks/after/auth.js +36 -33
- package/dist/checks/after/ci-yml.js +52 -2
- package/dist/checks/after/index.js +12 -4
- package/dist/checks/after/tools.js +73 -33
- package/dist/checks/before/context-fetch.js +218 -33
- package/dist/checks/before/env.js +1 -1
- package/dist/checks/before/index.js +6 -2
- package/dist/checks/before/repo.js +35 -1
- package/dist/checks/status-holes.js +739 -114
- package/dist/checks/tips/catalogue.js +59 -17
- package/dist/checks/tips/detect.js +30 -0
- package/dist/checks/tips/index.js +48 -6
- package/dist/cli.js +222 -84
- package/dist/commands/analysis.js +77 -53
- package/dist/commands/ci/ci.js +302 -25
- package/dist/commands/ci/pins.js +142 -0
- package/dist/commands/ci/push-gate.js +194 -0
- package/dist/commands/install/uninstall.js +23 -27
- package/dist/commands/install/upgrade.js +21 -11
- package/dist/commands/land.js +126 -10
- package/dist/commands/lib.js +244 -5
- package/dist/commands/registry.js +6 -2
- package/dist/commands/setup/setup.js +1 -0
- package/dist/commands/stats.js +69 -30
- package/dist/commands/workflow/branches.js +1232 -111
- package/dist/commands/workflow/challenge.js +90 -37
- package/dist/commands/workflow/completeness.js +97 -0
- package/dist/commands/workflow/context.js +371 -51
- package/dist/commands/workflow/counters.js +206 -40
- package/dist/commands/workflow/decisions.js +60 -17
- package/dist/commands/workflow/disk.js +213 -55
- package/dist/commands/workflow/fids.js +18 -1
- package/dist/commands/workflow/issues.js +6 -0
- package/dist/commands/workflow/ledgers.js +372 -21
- package/dist/commands/workflow/locks.js +2 -0
- package/dist/commands/workflow/plan-blocks.js +78 -14
- package/dist/commands/workflow/plans.js +205 -0
- package/dist/commands/workflow/prs.js +12 -3
- package/dist/commands/workflow/repo.js +6 -0
- package/dist/commands/workflow/roadmap.js +50 -17
- package/dist/commands/workflow/run-facts.js +23 -28
- package/dist/commands/workflow/runs.js +530 -33
- package/dist/commands/workflow/runtime.js +3 -0
- package/dist/commands/workflow/skills.js +1 -0
- package/dist/commands/workflow/status.js +166 -19
- package/dist/commands/workflow/step-table.js +61 -29
- package/dist/commands/workflow/steps.js +542 -26
- package/dist/commands/workflow/summary-findings.js +117 -0
- package/dist/commands/workflow/summary.js +154 -41
- package/dist/commands/workflow/tasks.js +378 -0
- package/dist/commands/workflow/test-blocks.js +231 -0
- package/dist/commands/workflow/tests-changed.js +172 -0
- package/dist/commands/workflow/tests.js +1013 -321
- package/dist/commands/workflow/workflows.js +191 -38
- package/dist/commands/workflow/worktrees.js +310 -42
- package/dist/install/cloud-env.js +233 -99
- package/dist/install/context-ci-workflow.js +85 -0
- package/dist/install/manifest.js +57 -12
- package/dist/install/modules/antigravity.js +3 -2
- package/dist/install/modules/cloud.js +3 -3
- package/dist/install/modules/codex.js +12 -2
- package/dist/install/modules/core.js +851 -53
- package/dist/install/modules/cursor.js +6 -6
- package/dist/install/modules/opencode.js +11 -5
- package/dist/install/template-notes.js +116 -0
- package/dist/install/version-file.js +3 -2
- package/dist/ledgers/compact.js +87 -0
- package/dist/ledgers/journal.js +233 -0
- package/dist/ledgers/status.js +115 -5
- package/dist/ledgers/telemetry.js +121 -17
- package/dist/render/hosts.js +100 -14
- package/dist/shared/bkit-latest.js +26 -4
- package/dist/shared/dep-updater.js +49 -0
- package/dist/shared/egress.js +1 -1
- package/dist/shared/package-manager.js +6 -0
- package/dist/shared/settings.js +59 -10
- package/dist/shared/timeouts.js +2 -0
- package/dist/tools/cli-doc.js +97 -0
- package/dist/tools/grammar-density.js +1 -1
- package/dist/tools/instructions-sources.js +15 -16
- package/dist/tools/instructions.js +83 -39
- package/package.json +58 -42
- package/.bkit/core/.bkit/lite.md +0 -73
- package/.bkit/core/engine/commands/workflow/workstreams.ts +0 -172
- package/.bkit/core/prompts/bkit-build-plan-execute.md +0 -124
- package/.bkit/templates/scripts/ci/bkit-local-stack-lock.sh +0 -194
- package/dist/commands/workflow/workstreams.js +0 -149
- /package/.bkit/templates/.vale/styles/{House → Bkit}/Filler.yml +0 -0
- /package/.bkit/templates/.vale/styles/{House → Bkit}/Hedging.yml +0 -0
- /package/.bkit/templates/.vale/styles/{House → Bkit}/LLMSlop.yml +0 -0
- /package/.bkit/templates/.vale/styles/{House → Bkit}/Verbose.yml +0 -0
- /package/.bkit/templates/scripts/ci/{accepted-advisories.json → bkit-accepted-advisories.json} +0 -0
- /package/.bkit/templates/scripts/ci/{accepted-divergences.json → bkit-accepted-divergences.json} +0 -0
- /package/.bkit/templates/scripts/launchd/{launchd.env.example → bkit-launchd.env.example} +0 -0
- /package/.bkit/templates/scripts/launchd/{ai.bkit.launchd.plist → bkit-launchd.plist} +0 -0
|
@@ -35,7 +35,7 @@ REPORTS="$OUT/reports"
|
|
|
35
35
|
# Report filenames — RENAME HERE AND NOWHERE ELSE. Each is referenced once
|
|
36
36
|
# below, so a new name takes effect on the next run with no other edit. These
|
|
37
37
|
# are all derived artifacts: renaming one never invalidates the graph, and the
|
|
38
|
-
# old file is not cleaned up automatically — delete it or run `pnpm graph:clean`.
|
|
38
|
+
# old file is not cleaned up automatically — delete it or run `pnpm bkit:graph:clean`.
|
|
39
39
|
R_REPORT="graph-report.md" # cluster-only's own report, moved here
|
|
40
40
|
R_TREE="graph-tree.html" # collapsible folder tree
|
|
41
41
|
R_FULL_GRAPHML="graph.graphml" # whole graph for Gephi
|
|
@@ -82,39 +82,48 @@ R_EAGER="graph-eager.json"
|
|
|
82
82
|
# register carries its findings.
|
|
83
83
|
REACH_MJS="scripts/ci/guards/assert-routes-reachable.mjs"
|
|
84
84
|
R_REACH="graph-reachability.json"
|
|
85
|
+
# Docs that carry a copy of the register's packages diagram between the
|
|
86
|
+
# graph:packages markers, space-separated; empty = none. rollup, register and
|
|
87
|
+
# refresh rewrite each copy, and check fails on a stale one. Runs on system python.
|
|
88
|
+
EMBED_PY="scripts/graphify/bkit-graph-embed.py"
|
|
89
|
+
GRAPH_EMBED_DOCS=""
|
|
85
90
|
|
|
86
91
|
usage() {
|
|
87
92
|
cat <<'EOF'
|
|
88
|
-
Usage: pnpm graph[:clean|:update|:rollup|:refresh|:check|:graphml|:tree|:scoped]
|
|
93
|
+
Usage: pnpm bkit:graph[:clean|:update|:rollup|:refresh|:check|:graphml|:tree|:scoped]
|
|
89
94
|
|
|
90
|
-
graph
|
|
91
|
-
graph:clean
|
|
95
|
+
bkit:graph Full repo: extract + cluster. ~2 min, 0 tokens.
|
|
96
|
+
bkit:graph:clean Same, but deletes the output dir first. REQUIRED after any
|
|
92
97
|
tsconfig `paths` change — `--force` re-reads source files but
|
|
93
98
|
NOT the module-resolution cache, so a graph built after an
|
|
94
99
|
alias edit will silently keep the old, unresolved edges.
|
|
95
|
-
graph:update
|
|
96
|
-
graph:check
|
|
97
|
-
docs/capabilities.md differs from the rebuild
|
|
98
|
-
|
|
99
|
-
|
|
100
|
-
|
|
100
|
+
bkit:graph:update Re-extract changed files only, then recluster.
|
|
101
|
+
bkit:graph:check Rebuild from THIS tree; fail if the tracked register
|
|
102
|
+
docs/capabilities.md differs from the rebuild, or a
|
|
103
|
+
GRAPH_EMBED_DOCS copy of its packages diagram differs from
|
|
104
|
+
the register. Writes nothing tracked. Reads uncommitted
|
|
105
|
+
edits — `check-at` does not.
|
|
106
|
+
bkit:graph:refresh Rebuild the register in a clean checkout of the STAGED
|
|
107
|
+
files (the index), copy it over docs/capabilities.md, and
|
|
108
|
+
rewrite the GRAPH_EMBED_DOCS copies. Stage your change
|
|
109
|
+
first. Fixes a red gate; commit it.
|
|
101
110
|
check-at <rev> `check` in a throwaway checkout of <rev>. Pre-push runs it
|
|
102
|
-
for every push to dev; CI runs
|
|
111
|
+
for every push to dev; CI runs it for every push and pull request.
|
|
103
112
|
spec Print the pinned graphify release (pip spec).
|
|
104
|
-
graph:rollup
|
|
113
|
+
bkit:graph:rollup Collapse the symbol graph into a package view (~24 nodes, the
|
|
105
114
|
architecture) and a module view (~133 nodes, the subsystems),
|
|
106
115
|
as interactive HTML. Edge weight is the number of underlying
|
|
107
116
|
symbol edges. Open these INSTEAD of the full graph; 9.8K nodes
|
|
108
117
|
is a database, not a picture.
|
|
109
|
-
graph:graphml
|
|
118
|
+
bkit:graph:graphml OPT-IN, for Gephi / yEd only — nothing else produces GraphML.
|
|
110
119
|
Writes all three views: the whole graph plus the two rollups.
|
|
111
120
|
The CLI has no --graphml flag (it exists only on the /graphify
|
|
112
121
|
skill, which this repo does not install), so the whole-graph
|
|
113
122
|
export calls graphify's own to_graphml() through its bundled
|
|
114
123
|
interpreter.
|
|
115
|
-
graph:tree
|
|
124
|
+
bkit:graph:tree Collapsible folder tree with search and an outbound-edge
|
|
116
125
|
inspector.
|
|
117
|
-
graph:scoped
|
|
126
|
+
bkit:graph:scoped One subtree with a browsable graph.html.
|
|
118
127
|
Path defaults to apps/web/src; pass another as $2.
|
|
119
128
|
|
|
120
129
|
Two directories, both gitignored and both rebuilt from source:
|
|
@@ -122,7 +131,7 @@ Two directories, both gitignored and both rebuilt from source:
|
|
|
122
131
|
<out>/ RAW graph data — graph.json, manifest.json, cache/. graphify
|
|
123
132
|
owns this layout; the read commands (affected, god-nodes,
|
|
124
133
|
explain, path, query) all resolve <out>/graph.json.
|
|
125
|
-
<out>/reports/ Every DERIVED view. Safe to delete wholesale; `pnpm graph`
|
|
134
|
+
<out>/reports/ Every DERIVED view. Safe to delete wholesale; `pnpm bkit:graph`
|
|
126
135
|
plus the view command that made it rebuilds any of it.
|
|
127
136
|
|
|
128
137
|
A whole-repo graph.html is never kept — 8.3 MB rendering ~9.8k nodes as a
|
|
@@ -164,14 +173,14 @@ graphify_python() {
|
|
|
164
173
|
}
|
|
165
174
|
|
|
166
175
|
require_graph() {
|
|
167
|
-
[ -f "$OUT/graph.json" ] || { echo "[graph] no $OUT/graph.json — run 'pnpm graph' first" >&2; exit 1; }
|
|
176
|
+
[ -f "$OUT/graph.json" ] || { echo "[graph] no $OUT/graph.json — run 'pnpm bkit:graph' first" >&2; exit 1; }
|
|
168
177
|
}
|
|
169
178
|
|
|
170
179
|
# The ONE graphify release that builds and judges the register — here, in the pre-push gate
|
|
171
180
|
# and in CI (installs `$(bash scripts/graphify/bkit-graphify.sh spec)`). Another release draws
|
|
172
181
|
# different edges → drift no one else can reproduce. PyPI `graphifyy`, CLI `graphify`.
|
|
173
182
|
# renovate: datasource=pypi depName=graphifyy
|
|
174
|
-
GRAPHIFY_SPEC="graphifyy[sql]==0.9.
|
|
183
|
+
GRAPHIFY_SPEC="graphifyy[sql]==0.9.93"
|
|
175
184
|
if [ "${1:-}" = "spec" ]; then
|
|
176
185
|
printf '%s\n' "$GRAPHIFY_SPEC"
|
|
177
186
|
exit 0
|
|
@@ -199,7 +208,7 @@ esac
|
|
|
199
208
|
# The whole-repo graph.html is DELETED, never kept. --no-viz below stops
|
|
200
209
|
# cluster-only writing one, but `graphify update` regenerates it on its own
|
|
201
210
|
# ("regenerated missing or stale graph.html") before this function reclusters, so
|
|
202
|
-
# the rm removes it. Use graph:rollup for something clickable, or Gephi on the
|
|
211
|
+
# the rm removes it. Use bkit:graph:rollup for something clickable, or Gephi on the
|
|
203
212
|
# GraphML for metrics.
|
|
204
213
|
cluster() {
|
|
205
214
|
run_local cluster-only . --no-label --no-viz
|
|
@@ -267,28 +276,31 @@ capabilities() {
|
|
|
267
276
|
--min-weight "$MMD_MIN_WEIGHT" --overlay "$REPORTS/$R_OVERLAY"
|
|
268
277
|
}
|
|
269
278
|
|
|
270
|
-
#
|
|
271
|
-
#
|
|
272
|
-
|
|
273
|
-
|
|
274
|
-
|
|
275
|
-
|
|
276
|
-
|
|
279
|
+
# Rewrite every GRAPH_EMBED_DOCS copy of the packages diagram from the tracked
|
|
280
|
+
# register; pass --check to fail on a stale copy instead.
|
|
281
|
+
embed() {
|
|
282
|
+
[ -n "$GRAPH_EMBED_DOCS" ] || return 0
|
|
283
|
+
local docs
|
|
284
|
+
read -r -a docs <<< "$GRAPH_EMBED_DOCS"
|
|
285
|
+
python3 "$EMBED_PY" "$CAPABILITIES_DOC" "${docs[@]}" "$@"
|
|
277
286
|
}
|
|
278
287
|
|
|
279
288
|
# Run this script's subcommands in a throwaway checkout of ONE commit: graphify reads the
|
|
280
289
|
# working tree, so the build belongs to that commit, not to uncommitted edits here. Root
|
|
281
|
-
# node_modules is linked in for the route scan. $1 = commit;
|
|
282
|
-
#
|
|
290
|
+
# node_modules is linked in for the route scan. $1 = commit; an optional `--tree=<tree>`
|
|
291
|
+
# next replaces the checkout's files with that tree, deletions included, while HEAD stays
|
|
292
|
+
# the commit; rest = subcommands, in order. $AT_DIR = the checkout.
|
|
283
293
|
at_commit() {
|
|
284
|
-
local rev="$1" sha tmp sub
|
|
294
|
+
local rev="$1" tree="" sha tmp sub
|
|
285
295
|
shift
|
|
296
|
+
case "${1:-}" in --tree=*) tree="${1#--tree=}"; shift ;; esac
|
|
286
297
|
sha=$(git rev-parse --verify --quiet "$rev^{commit}") || { echo "[graph] not a commit: $rev" >&2; exit 2; }
|
|
287
298
|
tmp=$(mktemp -d "${TMPDIR:-/tmp}/graph-at-XXXXXX")
|
|
288
299
|
AT_DIR="$tmp/checkout"
|
|
289
300
|
# shellcheck disable=SC2064 # expand now: $tmp is local and gone by the time EXIT fires
|
|
290
301
|
trap "git worktree remove --force '$AT_DIR' >/dev/null 2>&1; rm -rf '$tmp'" EXIT
|
|
291
302
|
git -c core.hooksPath=/dev/null worktree add --detach --quiet "$AT_DIR" "$sha"
|
|
303
|
+
if [ -n "$tree" ]; then git -C "$AT_DIR" read-tree -u --reset "$tree"; fi
|
|
292
304
|
ln -s "$(git rev-parse --show-toplevel)/node_modules" "$AT_DIR/node_modules"
|
|
293
305
|
for sub in "$@"; do
|
|
294
306
|
(cd "$AT_DIR" && env -u GIT_DIR -u GIT_WORK_TREE -u GIT_INDEX_FILE \
|
|
@@ -301,6 +313,7 @@ case "${1:-build}" in
|
|
|
301
313
|
clean) rm -rf "$OUT" && run_local extract . --code-only && repair && cluster ;;
|
|
302
314
|
rollup)
|
|
303
315
|
capabilities "$CAPABILITIES_DOC"
|
|
316
|
+
embed
|
|
304
317
|
for lvl in packages modules; do
|
|
305
318
|
run_scratch cluster-only "$REPORTS/.build/$lvl" --no-label >/dev/null 2>&1 || true
|
|
306
319
|
done
|
|
@@ -319,7 +332,7 @@ case "${1:-build}" in
|
|
|
319
332
|
echo "[graph] mermaid (paste into mermaid.live, or render per docs/setup.md):"
|
|
320
333
|
echo " $REPORTS/$R_PACKAGES_MMD"
|
|
321
334
|
echo " $REPORTS/$R_MODULES_MMD"
|
|
322
|
-
echo "[graph] GraphML for Gephi is opt-in: pnpm graph:graphml"
|
|
335
|
+
echo "[graph] GraphML for Gephi is opt-in: pnpm bkit:graph:graphml"
|
|
323
336
|
;;
|
|
324
337
|
tree)
|
|
325
338
|
require_graph
|
|
@@ -340,15 +353,17 @@ case "${1:-build}" in
|
|
|
340
353
|
;;
|
|
341
354
|
update) run_local update . && repair && cluster ;;
|
|
342
355
|
check)
|
|
343
|
-
# Gate on every push to dev: pre-push runs it via
|
|
344
|
-
# checkout of the pushed commit; CI runs
|
|
356
|
+
# Gate on every push to dev and every pull request: pre-push runs it via
|
|
357
|
+
# `check-at` in a clean checkout of the pushed commit; CI runs `check-at HEAD` on
|
|
358
|
+
# the checked-out commit: the pushed commit (push) or GitHub's test merge of the PR
|
|
359
|
+
# into its base (pull_request), the tree a squash merge lands.
|
|
345
360
|
# Rebuild graph from this tree → regenerate register into a throwaway copy
|
|
346
361
|
# → fail if it differs from the tracked file. Writes nothing tracked; fix a
|
|
347
|
-
# red with `pnpm graph:refresh` plus a commit.
|
|
362
|
+
# red with `pnpm bkit:graph:refresh` plus a commit.
|
|
348
363
|
#
|
|
349
364
|
# By hand it reads the working tree, not the commit: uncommitted edits show
|
|
350
365
|
# as drift nobody else can reproduce. After a tsconfig `paths` change run
|
|
351
|
-
# `pnpm graph:clean` first: `update` keeps the stale module-resolution
|
|
366
|
+
# `pnpm bkit:graph:clean` first: `update` keeps the stale module-resolution
|
|
352
367
|
# cache, and the drift reported would be the cache, not the register.
|
|
353
368
|
if [ -n "$(git status --porcelain -- '*.ts' '*.tsx' 2>/dev/null)" ]; then
|
|
354
369
|
echo "[graph] WARNING: uncommitted .ts/.tsx edits — graphify reads the WORKING TREE," >&2
|
|
@@ -363,12 +378,16 @@ case "${1:-build}" in
|
|
|
363
378
|
cp "$CAPABILITIES_DOC" "$fresh"
|
|
364
379
|
capabilities "$fresh" >/dev/null
|
|
365
380
|
rm -rf "$REPORTS/.build"
|
|
366
|
-
if diff -u
|
|
381
|
+
if diff -u "$CAPABILITIES_DOC" "$fresh" \
|
|
367
382
|
--label "$CAPABILITIES_DOC (committed)" --label "rebuilt from $(git rev-parse --short HEAD)"; then
|
|
368
383
|
echo "[graph] $CAPABILITIES_DOC matches a rebuild at $(git rev-parse --short HEAD)."
|
|
369
384
|
else
|
|
370
385
|
echo "[graph] DRIFT: $CAPABILITIES_DOC is not what this tree produces (diff above)." >&2
|
|
371
|
-
echo "[graph] Fix: pnpm graph:refresh && git add $CAPABILITIES_DOC && git commit" >&2
|
|
386
|
+
echo "[graph] Fix: pnpm bkit:graph:refresh && git add $CAPABILITIES_DOC $GRAPH_EMBED_DOCS && git commit" >&2
|
|
387
|
+
exit 1
|
|
388
|
+
fi
|
|
389
|
+
if ! embed --check; then
|
|
390
|
+
echo "[graph] Fix: pnpm bkit:graph:refresh && git add $GRAPH_EMBED_DOCS && git commit" >&2
|
|
372
391
|
exit 1
|
|
373
392
|
fi
|
|
374
393
|
;;
|
|
@@ -376,6 +395,7 @@ case "${1:-build}" in
|
|
|
376
395
|
# Tracked register only: `rollup` minus its HTML views (minutes of rendering `refresh`
|
|
377
396
|
# does not need). Needs a built graph.
|
|
378
397
|
capabilities "$CAPABILITIES_DOC"
|
|
398
|
+
embed
|
|
379
399
|
;;
|
|
380
400
|
check-at)
|
|
381
401
|
# `check` in a clean checkout of one commit (default HEAD); pre-push runs it for every
|
|
@@ -383,12 +403,15 @@ case "${1:-build}" in
|
|
|
383
403
|
at_commit "${2:-HEAD}" check
|
|
384
404
|
;;
|
|
385
405
|
refresh)
|
|
386
|
-
# Rebuild the register in a clean checkout of
|
|
387
|
-
#
|
|
388
|
-
# `graph:update && graph:rollup`
|
|
389
|
-
|
|
406
|
+
# Rebuild the register in a clean checkout of the staged files → copy over the tracked
|
|
407
|
+
# file here. Staged = the commit about to be made, so running it before that commit
|
|
408
|
+
# rebuilds the new state; unstaged edits stay out, as `bkit:graph:update && bkit:graph:rollup`
|
|
409
|
+
# would not. Fixes a `check` / `check-at` red. Commit the result.
|
|
410
|
+
staged=$(git write-tree) || { echo "[graph] the index has unmerged paths — resolve them first" >&2; exit 1; }
|
|
411
|
+
at_commit HEAD --tree="$staged" build register
|
|
390
412
|
cp "$AT_DIR/$CAPABILITIES_DOC" "$CAPABILITIES_DOC"
|
|
391
|
-
|
|
413
|
+
embed
|
|
414
|
+
echo "[graph] $CAPABILITIES_DOC rebuilt from the staged files on $(git rev-parse --short HEAD) — commit it"
|
|
392
415
|
;;
|
|
393
416
|
scoped)
|
|
394
417
|
target="${2:-apps/web/src}"
|
|
@@ -11,9 +11,10 @@
|
|
|
11
11
|
// Enforces docs/testing.md § "Validated means executed".
|
|
12
12
|
//
|
|
13
13
|
// Design notes:
|
|
14
|
-
// - Zero imports.
|
|
15
|
-
// meta.apiVersion
|
|
16
|
-
//
|
|
14
|
+
// - Zero imports. Uses slop-scan's file.text / file.ast facts and finding shape.
|
|
15
|
+
// meta.apiVersion is hard-pinned (not imported); an engine API bump fails at load.
|
|
16
|
+
// - Test markers must start on an AST identifier, so literal fixtures are inert.
|
|
17
|
+
// Missing or invalid ASTs retain the conservative text/comment scan.
|
|
17
18
|
// - `delta` is omitted: slop-scan then matches per location, so a pure line-shift
|
|
18
19
|
// of a pre-existing hit nets to zero and only new hits register as added.
|
|
19
20
|
// - Cast patterns use `\s+` (never a literal single space), and the directive
|
|
@@ -113,6 +114,18 @@ function collectMatches(text, regex, classify) {
|
|
|
113
114
|
return out;
|
|
114
115
|
}
|
|
115
116
|
|
|
117
|
+
/** Identifier locations exclude literal text while retaining executable template interpolations. */
|
|
118
|
+
function identifierStarts(sourceFile) {
|
|
119
|
+
if (!sourceFile || sourceFile.parseDiagnostics?.length) return null;
|
|
120
|
+
const starts = new Set();
|
|
121
|
+
const visit = (node) => {
|
|
122
|
+
if (typeof node.escapedText === "string") starts.add(node.getStart(sourceFile));
|
|
123
|
+
node.forEachChild(visit);
|
|
124
|
+
};
|
|
125
|
+
visit(sourceFile);
|
|
126
|
+
return starts;
|
|
127
|
+
}
|
|
128
|
+
|
|
116
129
|
export default {
|
|
117
130
|
meta: {
|
|
118
131
|
name: "slop-scan-plugin-boundary",
|
|
@@ -209,7 +222,7 @@ export default {
|
|
|
209
222
|
family: "boundary",
|
|
210
223
|
severity: "medium",
|
|
211
224
|
scope: "file",
|
|
212
|
-
requires: ["file.text"],
|
|
225
|
+
requires: ["file.text", "file.ast"],
|
|
213
226
|
supports(context) {
|
|
214
227
|
return context.scope === "file" && Boolean(context.file);
|
|
215
228
|
},
|
|
@@ -220,13 +233,16 @@ export default {
|
|
|
220
233
|
return [];
|
|
221
234
|
}
|
|
222
235
|
|
|
223
|
-
//
|
|
236
|
+
// Match executable identifiers; missing or invalid ASTs retain the conservative text scan.
|
|
237
|
+
const identifiers = identifierStarts(
|
|
238
|
+
context.runtime.store.getFileFact(file.path, "file.ast"),
|
|
239
|
+
);
|
|
224
240
|
const testMatches = [
|
|
225
241
|
...collectMatches(text, TEST_SUFFIX, (_t, _end, m) => `test-${m[1]}`),
|
|
226
242
|
...collectMatches(text, TEST_GLOBAL, (_t, _end, m) =>
|
|
227
243
|
m[1] === "f" ? "test-only" : "test-skip",
|
|
228
244
|
),
|
|
229
|
-
];
|
|
245
|
+
].filter((match) => identifiers === null || identifiers.has(match.index));
|
|
230
246
|
// Blanket linter disables — NOT comment-skipped (they ARE comments).
|
|
231
247
|
const lintMatches = collectMatches(text, BLANKET_LINT, () => "lint-blanket");
|
|
232
248
|
|
|
@@ -246,7 +262,7 @@ export default {
|
|
|
246
262
|
};
|
|
247
263
|
|
|
248
264
|
const hits = [
|
|
249
|
-
...testMatches.map((m) => toHit(m,
|
|
265
|
+
...testMatches.map((m) => toHit(m, identifiers === null)),
|
|
250
266
|
...lintMatches.map((m) => toHit(m, false)),
|
|
251
267
|
].filter(Boolean);
|
|
252
268
|
if (hits.length === 0) {
|
|
@@ -81,7 +81,11 @@
|
|
|
81
81
|
}
|
|
82
82
|
},
|
|
83
83
|
{
|
|
84
|
-
"files": [
|
|
84
|
+
"files": [
|
|
85
|
+
".opencode/plugin/bkit-gateguard.js",
|
|
86
|
+
".opencode/plugin/bkit-readguard.js",
|
|
87
|
+
".opencode/plugin/bkit-rules.js"
|
|
88
|
+
],
|
|
85
89
|
"rules": {
|
|
86
90
|
"defensive.empty-catch": {
|
|
87
91
|
"enabled": false
|
|
@@ -99,7 +103,10 @@
|
|
|
99
103
|
"**/.cursor/hooks/bkit-readguard.cjs",
|
|
100
104
|
"**/.codex/hooks/bkit-readguard.cjs",
|
|
101
105
|
"**/.agents/plugins/bkit/hooks/bkit-readguard.cjs",
|
|
102
|
-
"**/.opencode/plugin/bkit-readguard.js"
|
|
106
|
+
"**/.opencode/plugin/bkit-readguard.js",
|
|
107
|
+
"**/.opencode/plugin/bkit-rules.js",
|
|
108
|
+
"**/.codex/hooks/bkit-rules.cjs",
|
|
109
|
+
"**/.agents/plugins/bkit/hooks/bkit-rules.cjs"
|
|
103
110
|
],
|
|
104
111
|
"rules": {
|
|
105
112
|
"structure.duplicate-function-signatures": {
|
package/CHANGELOG.md
CHANGED
|
@@ -6,6 +6,125 @@ Format: `## [version] — YYYY-MM-DD`
|
|
|
6
6
|
|
|
7
7
|
---
|
|
8
8
|
|
|
9
|
+
## [6.1.0] — 2026-11-04
|
|
10
|
+
|
|
11
|
+
### Breaking Changes
|
|
12
|
+
|
|
13
|
+
- **BREAKING — Every name a consumer types or sees now carries the bkit brand.** Package scripts: `lint:prose` → `bkit:lint:prose`, `slop:delta` → `bkit:slop:delta`, `graph*` → `bkit:graph*`. Files: `scripts/launchd/ai.bkit.launchd.plist` → `bkit-launchd.plist`, `launchd.env.example` → `bkit-launchd.env.example`, and the CI scripts under `scripts/ci/` (`check-capstone`, `check-dependency-audit`, `check-accepted-divergences`, `lanes/resolve-push-base`, `accepted-advisories.json`) gain `bkit-`. Check names: every workflow `name:` and job display name in the shipped workflows starts with `bkit-` (`bkit-renovate`, `bkit-trivy` and the cloud jobs included). Vale style: `House` → `Bkit`, so `.vale.ini` names `Bkit.*`. `bkit upgrade` migrates all of it: it renames the keys in `package.json`, the tokens in `.husky/pre-commit`, `.husky/pre-push` and the `bkit.testing.ciWorkflow` file, moves unedited CI script copies and Vale rules that still match the shipped text, rewrites shipped workflow names, and leaves anything you edited alone; a second run changes nothing. Branch protection: a required status check that names an old job (for example `Renovate` or `Trivy`) no longer matches; update the required checks in the repo settings to the `bkit-*` names after upgrading. Generic stack scripts (`typecheck`, `lint`, `format:check`, `test`, `build`, `lint:slop`, `prepare`) keep their names. #748
|
|
14
|
+
|
|
15
|
+
### Added
|
|
16
|
+
|
|
17
|
+
- **Local tests and gates keep a Mac awake while they run.** Engine test commands hold a `caffeinate -is` assertion, and the copy-and-own `scripts/ci/bkit-test-awake.mjs` wrapper covers direct runner commands and complete gate chains. Cancellation reaches the test process and releases the assertion. Other platforms run the original command, and test timeouts stay unchanged. See `.bkit/templates.md` § Local test sleep prevention.
|
|
18
|
+
- **Workflow steps show an engine-derived progress line.** Each numbered completion returns an exact ten-cell bar, percentage and step title for the agent to show as plain text. Build lines reflect current task groups, retries show the saved attempt allowance, and resuming recomputes the same position from the run's status and plan. Explicit gate-only completions use the same format without adding status rows. `bkit upgrade` installs the narration on every supported host.
|
|
19
|
+
- **`bkit branches push` hands pre-push tests-lock waits back to the agent.** It passes the host's lock wait budget and its run name to Git, and exits 81 with `lockHolder` when the hook's gate gives up waiting. Build, debug and ship re-run their push blocks on 81.
|
|
20
|
+
|
|
21
|
+
- **`bkit tests changed` recognizes the same tests-lock outcomes as `tests run`.** It accepts `--lock-wait-s`, passes the budget and its run name to the selected gate, and exits 81 with `lockHolder` when that gate gives up on the tests lock. Both commands keep a wait separate from a failing test run; `tests run --file` appends no `test-run` status row for a wait. The caller prompts re-run the command on exit 81.
|
|
22
|
+
- **`bkit tests run` hands tests-lock waits back to the agent.** It passes `--lock-wait-s` and its run name to a wrapped gate, and exits 81 with `lockHolder` when that gate gives up on the tests lock. A refusal exits 4; gate failures keep their normal verdict. The wait defaults to `BKIT_LOCK_WAIT_S`, else 60 seconds; Claude Code ships a 1200-second budget. Light test-first runs stay unwrapped.
|
|
23
|
+
- **The machine lock queues test gates across repositories.** The template is renamed `bkit-machine-lock.sh` and adds named machine-wide locks, configurable test slots, worker limits and enforced lock order. `run` exits 73 when a lock cannot be taken and 75 when its wait gives up; without a TTY, the default wait is 60 seconds. Adopted stack-lock copies keep working. To adopt the tests lock, copy `.bkit/templates/scripts/ci/bkit-machine-lock.sh` to `scripts/ci/` and wrap each test-running `bkit:gate:*` script with `bash scripts/ci/bkit-machine-lock.sh run --lock tests -- <gate command>`. Put chained commands in one `sh -c` string. See `.bkit/templates.md` § Machine lock.
|
|
24
|
+
- **A setup tip tells you when a newer bkit is out.** `bkit tips` shows `bkit-upgrade` first, ahead of every other tip in every workflow, while the newest release `bkit repo info` last saw (cached once a day in git's common dir) is newer than `.bkit/version`. The tip only reads that cache and never asks the registry itself, so it stays quiet until a workflow has run once. It cannot be silenced: `bkit.advisories.ignore` skips it, a workflow's silence line never names it, and `BKIT_NO_UPDATE_CHECK=1` stops only the lookup, not a release already seen. Its ask points the agent at `.bkit/install.md` § Upgrade — already installed.
|
|
25
|
+
- **A setup tip offers to send your bkit friction and stats to bkit's makers as one issue.** `bkit tips` shows `share-friction` while `.bkit/friction.jsonl` holds an `OPEN` entry that is not `consumer` scope. Its paste block, `.bkit/README.md` § Share friction with bkit, has the agent refresh `.bkit/stats.md`, strip each entry to the fields bkit needs, remove anything that names the project, show you the exact issue before posting, and then mark each entry `TRIAGED` with the issue link, so the tip returns only when new friction arrives. It never fires in bkit's own repo.
|
|
26
|
+
- **`bkit ci bookkeeping-push` tells the pre-push hook when a `[skip ci]` push to an open PR is safe.** Ship's Step 8 pushes its docs, logs, ledgers and skill removals as one `[skip ci]` commit onto the PR, and the merge gate then checks CI at the last tested head (validated-head carry-forward). The hook's CI-suppressor guard blocked exactly that push, so every ship run stopped at Step 8. The hook now hands the head the remote holds to `bkit ci bookkeeping-push --from=<sha>`, which exits 0 when every file changed since that head is on ship's `--scope=pr` allow-list, and lets the push through with a line saying why; a rewritten head, a code file, or no remote head still blocks. Both hook copies carry the change. Your `.husky/pre-push` is your own copy and `bkit upgrade` never touches it: paste the `CI-suppressor HEAD guard` block and the `PUSH_BRANCH_REMOTE_SHA` lines of the ref loop from `.bkit/templates/.husky/pre-push`. #699
|
|
27
|
+
- **`bkit.testing.ciSkipPaths` names the project docs ship's `[skip ci]` bookkeeping commit may carry.** Ship's `--scope=pr` allow-list reaches top-level `docs/*.md` and nothing else outside the frozen list; a repo that keeps project docs elsewhere lists them in `package.json` under `bkit.testing.ciSkipPaths` (globs as in `minPushPaths`: `*` one folder, `**` any depth; install seeds `[]`). bkit's own `package.json` lists `CHANGELOG.md` and `README.md`, the two ship-phase reads in `.agents/docs.md`; the engine hardcodes no file name. One list feeds the Step 8 commit, `bkit ledgers only-bookkeeping`, the merge gate's carry-forward and the hook's exception, so a changelog edit the docs sync makes no longer stays behind uncommitted in the worktree. #699
|
|
28
|
+
- **A separate subagent writes each task group's tests before another writes its code.** `/bkit-build` Step 7 now runs two subagents per group: `@bkit-build-plan-tests` writes the group's planned `TEST FIRST` tests and may touch nothing else (`bkit steps finish --step=build-plan-tests --plan` refuses a diff that changes any other file, exit 15), the orchestrator records every test failing with one `bkit tests red --group` run, and only then does `@bkit-build-plan-tasks` write the code. The code steps may not change a planned test: `steps finish` on execute and gaps-remediate exits 11 when a planned test file differs from the blob its red row recorded. `bkit context brief --tests-only` writes the tests writer's brief (`build-brief-tests-{GROUP}-{n}.md`), and with `--file` leaves out the tests the group's red rows already proved, so a handover or a task added at a Decision Pause briefs only what is left; `tests red` skips those tests too while their file is unchanged. Three in-flight builds had written code before any red with one agent doing both, however the prompt ordered it; separating the writers makes the order a property of the workflow, not of the agent. Plan caps rise with it: `bkit.workflows.tasks.maxPerGroup` defaults to 5 (was 3) and `maxTestsPerGroup` to 25 (was 15), so the number of subagents per plan stays about the same; a value you set is never touched, and `bkit check` names the number to change in `.github/ISSUE_TEMPLATE/bkit-change.yml`. `bkit upgrade` installs the new agent and workflow. #796
|
|
29
|
+
- **The pre-push hook writes `tmp/pre-push.log`.** `.bkit/templates/.husky/pre-push` now runs itself once more with everything it prints copied to `tmp/pre-push.log`, rewritten each push, and prints that path as its first and last line with the exit code. An agent whose command output was cut short, or that pushed in the background, can read the whole run there; a second terminal can `tail -f` it while the push runs. The exit code and the ref list git passes the hook are unchanged. `git push --no-verify`, and a checkout without husky installed, run no hook and write no log. Your `.husky/pre-push` is your own copy and `bkit upgrade` never touches it: to adopt this, paste the `# Log:` block from `.bkit/templates/.husky/pre-push` right after `set -e`. #742
|
|
30
|
+
- **`bkit ledgers compact` shrinks the five keyed ledgers to one row per entry, without losing an entry's age or how often it changed.** `docs/knowledge.jsonl`, `docs/decisions.jsonl`, `docs/deferrals.jsonl`, `docs/failures.jsonl` and `.bkit/issues.jsonl` keep growing because every update is a new row. The verb drops each row a newer row of the same entry replaces, and leaves the surviving row where it was. That row gains `firstTs` (when the entry was first written) and `updates` (how many rows it has had), so age reports and flake counts still work. Every reader sees the same entries as before. Lines it cannot read, and rows of other kinds, are left exactly as they are. Running it twice changes nothing, and if a merge brings dropped rows back, the next run drops them again. `--ledger=<name>` limits it to one ledger, and `--dry-run` only counts. `bkit ledgers append` and `bkit roadmap feature` now fill `firstTs` / `updates` on every new row of those ledgers. Each of the five ledger updaters (`@bkit-utility-update-knowledge`, `-decisions`, `-deferrals`, `-failures`, `-roadmap`) ends by compacting its own ledger. No upgrade step is needed: rows without the two fields read as entries with one row.
|
|
31
|
+
- **`.bkit/cli.md` lists every `bkit` command in one place.** The commands you run (`bkit install`, `bkit upgrade`, `bkit check` and the rest) and every `bkit <noun> <verb>` command the workflows run, one row per verb with its flags and whether it is safe to run by hand or only as a workflow step. The command contract (output format, flag names, shared exit codes, `{BKIT}` invocation, step endings, `{OUTBOX}`) moves there from `.bkit/workflows.md` § Workflow commands, which now points at it. The tables are generated from the same specs `--help` prints, so they cannot drift from the code. `bkit upgrade` adds the file. #741
|
|
32
|
+
- **A ledger or lockfile conflict no longer aborts ship's integration when another conflict needs judgement.** `bkit branches sync --merge` (ship Step 4) resolves the append-only ledgers and the lockfile, leaves the other paths conflicted with the merge still in progress, lists them under `pending`, and exits 24 with outcome `pending`. Run it again once those paths are staged by hand, and it commits the merge. `@bkit-ship-conflict-resolve` re-runs the merge block after its hand resolution, so a merge is no longer aborted when its only other conflict is one the agent may resolve by hand. `bkit upgrade` picks it up. #747
|
|
33
|
+
- **`bkit completeness check` tells you which steps and bkit commands a workflow run skipped.** It reads a run's `status.jsonl` and the workflow markdown it ran (design, plan, build, debug or ship), and reports the steps the markdown requires that have no row, plus the `bkit` commands a step names that the run never made. The expected set comes from the markdown at run time, so there is no table to keep in step. It is advisory: it always exits 0 and never blocks a run. To make the commands visible, every `bkit` command now appends one `engine-call` row (noun, verb, flag names) to the active run's `status.jsonl`, and a command that exits non-zero for a reason the workflow does not route on appends one `tool-failure` friction row to `.bkit/friction.jsonl`. `BKIT_ENGINE_JOURNAL=off` turns both off. `bkit workflows close` writes the verdict as a `completeness` row, and `bkit workflows start` / `resume` prints a warning when the FID's previous run closed incomplete. The CI static lane's `pnpm bkit:audit:status` sweep now judges every run in `docs/plans/*/logs/*/status.jsonl` this way and still never fails the lane on a hole. A workflow step a run may skip is marked with a column-0 `**Run only if**` or `**Skip if**` line, and every other step writes a row on every route (`.bkit/authoring.md`); `/bkit-build` Step 4 (Plan Convert) now writes a skip row when the plan is already in task-block form. `bkit upgrade` picks it up. #699
|
|
34
|
+
- **Answers to a design's or plan's open questions reach the document, the issue and the ledger.** After `/bkit-design` or `/bkit-plan` closes, the orchestrator records every round of answers the owner gives to the summary's `## Open Questions`, whether through the one-by-one pass or in free chat. Each round appends a `docs/decisions.jsonl` row for every answer that settles an architecture or technology decision (as before), writes the questions and answers verbatim to `docs/plans/{YYYYMM}/logs/{FID}/design-answers-{RUN}.md` (plan: `plan-answers-{RUN}.md`), has `@bkit-design-update` / `@bkit-plan-update` edit the canonical `{FID}-design.md` / `{FID}-plan.md` in place (the answered question leaves the open questions, the decision is written down, and statements the answer overrides follow it; a plan is re-checked with `bkit tests plan-check`), commits those files on `dev` without pushing, and, with a tracker connected, posts the round as one `Owner Answers` comment on the issue. Before this, only the decision row was written, so the next workflow read the question as still open unless the owner edited the document by hand. `bkit upgrade` picks it up. #798
|
|
35
|
+
|
|
36
|
+
### Changed
|
|
37
|
+
|
|
38
|
+
- **Permanent skills are checked for each configured host, and activate for the task that needs them.** The registry checks the skill file, installer lock and host discovery together. A skill's demand to activate in every session does not override the owner's request, the repository's workflow or its test rules. Missing installations are repaired through the skills CLI, while owner approvals and existing work are preserved.
|
|
39
|
+
- **Bookkeeping increments can reuse a successful local full gate.** The pre-push hook sends every outgoing old/new commit pair to `bkit ci min-push`. It selects `bkit:gate:min` when the changes after a locally checked ancestor contain only allowed bookkeeping files and the recorded script definitions still match. Missing or invalid evidence, a failed full check, rewritten history or new code keeps the full gate. This does not let code skip CI.
|
|
40
|
+
- **Workflow steps have no universal runtime deadline.** Attempt limits, subagent turn caps, command wait budgets and host execution limits still apply.
|
|
41
|
+
- **Prompts and workflows name a section by its bare title, and keep the `#` marks only for a line the agent writes or matches.** `.bkit/authoring.md` § All Agent-Read Files adds the **Section names** rule: "the design's `Acceptance Scenario`" names a section to read, "append `## Project Instructions`" names a line to write, and a fixed line the agent recognises a file by (the `## Owner answers` heading) or a program prints or parses (`## bkit Tips`, `###### bkit:blocked-by`) keeps its marks. The challenge, plan-convert and plan prompts, the build, design and plan workflows, and the shared prompt and workflow docs now follow it.
|
|
42
|
+
- **`bkit.testing.shipGate` is `bkit.testing.ciRequired`, and `bkit upgrade` renames it for you.** The list of CI lanes whose `skipped` conclusion refuses a ship merge now sits with the other CI keys as `ciRequired`, in the order `minPushPaths`, `ciWorkflow`, `ciCapstone`, `ciRequired`, `ciSkipPaths`. A `testing.shipGate` in `package.json` moves to `testing.ciRequired` on the next install or upgrade; a `ciRequired` already set wins. `bkit runs gate` reads only the new key. #699
|
|
43
|
+
- **A min push is what bkit writes plus what `bkit.testing.minPushPaths` adds, so the setting no longer restates bkit's own files.** `bkit ci min-push` now starts from ship's `--scope=pr` bookkeeping allow-list (ledgers, logs, `docs/*.md`, skill removals, the repo's `bkit.testing.ciSkipPaths`) plus `docs/plans/**`, the same list the ship gate and the pre-push `[skip ci]` guard accept untested, and `minPushPaths` only adds to it; `[]` means that floor alone, not off. Installs seed `[]` instead of `docs/plans/**`, `docs/*.jsonl`, `.bkit/*.jsonl`, and `bkit upgrade` drops those three and anything already in `ciSkipPaths` from a repo's list. #699
|
|
44
|
+
- **BREAKING — The subagent that builds a group's tasks is `@bkit-build-plan-tasks`.** `.bkit/core/prompts/bkit-build-plan-tasks.md` replaces `bkit-build-plan-execute.md`, and every host mirror, workflow line, doc and instruction entry names it; `bkit upgrade` writes the new agent to each host and deletes the old mirror files. The status step is `build-plan-tasks` too (`steps finish --step=build-plan-tasks`, `build-plan-tasks-{GROUP}-log.md`, verdict `TASKS_VERDICT`); Step 7 keeps its title. `bkit upgrade` renames a consumer's `## Model Overrides` row for `bkit-build-plan-execute` to the new agent, provider and model kept. A build in flight across the rename resumes: a `status.jsonl` row or group log under the old step name is read as the new one. Ledger rows and logs written before the rename keep the old name. #796
|
|
45
|
+
- **A build locks each planned test case, not its file, and asks about unproven tests once, at the end.** `bkit tests red` records each planned test's own lines (`block`, a hash found by the test's name and indentation), and `bkit steps finish` refuses a code step (exit 11) only when one of those tests changed, naming each in `tests`; other tests, helpers and new tests in the same file are the code step's to change, and every refusal appends an `agent-rework` friction row. An existing test the tests step updated and that passes is recorded `updated`, and the verifier reads its diff: it may add expectations, never remove or loosen one. A planned test with no proven red is no longer a `no-red` gap that stops the run mid-way: `bkit tests green` lists it under `unproven`, and `/bkit-build` Step 15 asks the owner once about all of them, Accept writing a `TEST EXCEPTION`. `bkit tests plan-check` reports planned test names already in use (`existing`). Rows written by an older bkit lock by the whole file as before. #801
|
|
46
|
+
- **A used-up fix loop asks the owner instead of failing the run.** With `ask` true and not headless, a used-up `build.verify`, `build.tests`, `debug.soak` or `ship.merge` limit goes to a question; a go-on answer runs the new `bkit counters grant`, which writes an `allowance-granted` row giving that loop alone (that group alone for verify) one more full allowance of `maxAttempts`. `counters route` and `counters max` print `grants` and `allowance`, and `challenge merge --round` accepts the larger limit. With `ask` false or headless, a used-up limit still goes to the Failure Path. #801
|
|
47
|
+
- **BREAKING — Test-first is judged per group from one red row.** `bkit tests red` takes `--group` and `--plan` and runs every planned test file of the group's open tasks once, writing one `build-tests-red` row with a state per test (`red`, `red-not-loaded`, `passed-accepted`, `vacuous`, `missing`, `no-report`, `lint`); the per-test flags `--task`, `--test` and `--name`, the `build-task-red` and `build-task-red-passed` rows, the `.snapshot` copies and the per-test logs are gone. A test file that fails to load counts as red: the tests step writes no source, so an import of unwritten code is the expected shape. `bkit tests green` reads the group's red rows, merged per test, and no longer judges test order or test edits: the `late-red`, `red-mismatch`, `red-evidence-missing` and `test-changed` gaps are gone, because the code step cannot change a planned test (its finish refuses the step) and the red row is written before it runs. `build-tests-red-*.md` replaces `build-task-red-*.md` in `.prettierignore`; builds in flight on the old rows finish on the old bkit. #796
|
|
48
|
+
- **BREAKING — `bkit.dependencies.updater` records the updater you run, and `bkit check` holds it to the repo.** The value is `"renovate"`, `"dependabot"` or `"none"`. `bkit install` / `bkit upgrade` fill an empty value from the one updater config present. `bkit check` now blocks on `dep-updater-unset` (a config is present but the value does not name it) and `dep-updater-mismatch` (the value names the other updater, or `none`, while a config is present; or names an updater with no config). Renovate config is found at every location Renovate reads, not only `.github/renovate.json5` / `.json`: root `renovate.json*`, `.gitlab/renovate.json*`, `.renovaterc*` and a `package.json` `renovate` block. Run `bkit upgrade` to have the value set; a repo running both updaters, or a value set by hand that disagrees with its config, needs a hand fix.
|
|
49
|
+
- **opencode columns measure every pick against Claude, and the four key gates run `gpt-6.1-sol`.** On OpenRouter, Ollama, OpenCode Zen and OpenCode Go each agent now gets the cheapest model that comes closest to the Claude model it runs on, and any vendor may be picked; the weekly cost cap, not a vendor list, keeps the dearest models off. Four checks where a miss reaches the merge unnoticed — `bkit-build-plan-verify`, `bkit-ship-deferred-sweep`, `bkit-debug-failure-diagnose` and `bkit-build-challenge-2` — move to `gpt-6.1-sol` on OpenRouter and Zen (68.7 on LiveBench 2.0 Long Agentic) and `gemini-4-argon` on Go, which serves no Sol; every other agent, and every Ollama agent, runs DeepSeek V4.1 Flash. `mimo-v2.6-pro`, `minimax-m3.1-flash` and `glm-5.3-flash` leave the judge cells. A two-day OpenRouter overrun on the default comes to about A$74 against the A$70 weekly cap; Option 2 in § Model Presets puts five more judges on Sol for about A$137. Effort follows the same yardstick: DeepSeek thinks at its maximum everywhere, while `gpt-6.1-sol` (and any Claude or `gpt-6-astra` override) keeps the agent's own Claude effort instead of being raised to the top rung. `bkit upgrade` picks it up. #205 #714
|
|
50
|
+
- **The opencode OpenRouter and Ollama columns pin the dated DeepSeek V4.1 Flash `1017` snapshot.** The undated `deepseek/deepseek-v4.1-flash` slug OpenRouter serves is frozen on the 2026-09-10 snapshot and does not float, so the two columns move to the October 17 refresh: `deepseek/deepseek-v4.1-flash-1017` (35 endpoints) on OpenRouter and `deepseek-v4.1-flash:1017` on Ollama. DeepSeek's model card puts 1017 ahead of the previous snapshot across its agentic benchmarks (Terminal-Bench 4.0 31.2 → 42.3, Apex Bench v1.1 64.6 → 72.1) with shorter outputs and faster task completion, and reports no API price change; the OpenCode Zen and Go gateways carry no dated snapshot yet and stay on the undated slug. `bkit upgrade` picks it up. #205
|
|
51
|
+
- **A `/bkit-build` run's step comments carry their own numbers, and build has 16 steps.** Plan Convert is its own Step 4, posting `### Step 4 — Plan Convert` instead of sharing Branch Sync's number and heading; Branch Sync keeps Step 3 with `bkit branches sync --merge-docs` alone. Plan Current moves to Step 5 and posts on both routes — `Status: skipped (no plan anchor)` when `bkit branches anchor-read` exits 12, the agent's comment otherwise — so a converted plan no longer leaves the step silent. Every later step shifts by one, through Summary 15 and Close Workflow & Create PR 16, and `WORKFLOW_STEPS` with its resume targets moves with them. A plan already valid with no newer comments writes no Plan Convert row and posts no comment. A run that started on the old numbering finishes on the bkit version it started on. #705
|
|
52
|
+
- **The opening note of every doc template now sits inside the managed block, so `bkit upgrade` keeps it current.** The `<!-- Note: … -->` line used to sit above `<!-- bkit:start -->`, where upgrade never looks, so an installed `docs/templates/bkit-*.md` kept whatever note it was first installed with. It now opens the block, right after the managed marker. `bkit upgrade` removes the old copy above the block when it matches a note wording bkit shipped there, along with the blank line after it. A note you edited is kept, and upgrade prints a line naming the file when the note still names a bkit report or plan path or a `@bkit-` agent. Every other line above the block stays, including your own `<!-- Note: … -->` comments, with no warning. A file with CRLF line endings throughout is left as it is. `bkit check` fails until upgrade has run. #747
|
|
53
|
+
- **A direct chat can write every ledger, not just `docs/decisions.jsonl`.** `bkit ledgers append` now accepts `utility` rows of every kind: decision, deferral, failure, knowledge, friction, compliance, counter and outcome. A fix made in a chat session can record its gotcha or close its deferral in the same change. Rows written this way carry `utility`, which keeps them apart from workflow runs in per-workflow reports; the overall totals still count them, which #766 fixes. #747
|
|
54
|
+
- **The three design ideate agents say which lens each one takes.** `bkit-design-brainstorm-ideate-1`, `-2` and `-3` shared one description and Role line, so an agent picker could not tell them apart. Each now names its lens: pragmatic, long-term or risk-tested.
|
|
55
|
+
- **The `Debug on demand` rule says when it applies.** In `.agents/rules.md` it now reads as the last step after `Local tests first` and `Existing evidence first`: re-run a failing E2E / `@live` test against the deployed system only once both have left it unexplained. What it asks for is unchanged.
|
|
56
|
+
- **Agents may dig deeper inside a step.** The `No improv` line every workflow and agent carries now reads "Skip no step, and add no step of your own; how deeply you investigate within a step is your call." It used to read as a ban on any extra investigation.
|
|
57
|
+
- **`Finish over deferrals` and `Scope discipline` no longer pull against each other.** `Finish over deferrals` now says what "when in doubt" covers: work the request needs before it is complete is in scope, and unrelated improvements are not.
|
|
58
|
+
- **`Research / investigate first` drops its fixed search queries.** It now asks you to check whether the framework or runtime already provides what you are about to build, and what current practice is, instead of prescribing two web searches for every change.
|
|
59
|
+
- **`Investigation layers` left `.agents/rules.md`.** It was coaching for one agent, loaded into every session. It now sits in `bkit-design-brainstorm-ideate-2`, the only agent that used it.
|
|
60
|
+
- **`Secrets sync`, `CI on PR to dev / main` and `CI on push to dev / main` apply only where the repo adopted the template they describe.** A repo without the secrets sync or CI workflow template no longer gets rules it cannot follow.
|
|
61
|
+
- **The logs, database and gates audits check that each scheduled job succeeded, not just that it ran.** A job that finishes fast with a rejected status used to pass all three. `bkit-audit-logs` Step 12 — Alarms, `bkit-audit-database` Step 12 — Derived Data and `bkit-audit-gates` Step 3 — Widen now share one sentence: read the outcome of every run (status code or exit code), and treat a job that did not write its owned rows in its window as a finding, even when it exited 0. The gates audit also lists a check on scheduled controls among the standard gates nobody proposed. #770
|
|
62
|
+
- **The gates and testing audits catch a test lane that goes green while its tests fail.** `bkit-audit-gates` Step 12 — Health compares each lane's runner-report failure count with the step's conclusion and rates `success` with failures `CRITICAL`; a lane with no machine-readable report goes to `Not Checked`. Its hollow-gate shapes add a trailing `; :` or `|| :`, `continue-on-error: true` on a test step, and a skip guard on a file that may be deleted (e.g., `if: hashFiles(...)`). `bkit-audit-testing` Step 7 — Shapes adds an exit status swallowed by a wrapper, and Step 9 — Runs counts test files the runner does not collect (e.g., `*.test.sh`). #771
|
|
63
|
+
- **The gates audit searches history for weakened gates and asks report-only gates for a count.** Step 11 — Re-Review also searches git history (e.g., `git log -S`) for gate steps that were removed or weakened, and a change with no `docs/decisions.jsonl` row is a finding. Step 9 — Sequence asks each report-only gate to print its finding count on every run, so Step 12 can compute the false-positive rate. #780
|
|
64
|
+
- **The testing audit can run hand mutants without editing the shared checkout, and knows two more timing shapes.** When in-place edits are blocked, the `Mutation Tool` fallback and Step 6 run the hand mutants in a throwaway worktree. Step 7 — Shapes adds absence asserted before it could appear (no wait after the trigger) and a listener attached after the event it observes. #784
|
|
65
|
+
- **The dependencies audit checks when the bot really runs, what the batch really resolves to, and checksum-paired pins.** Step 6 compares the bot's actual run start times with its configured window, because a window no run lands in means routine PRs never open. Step 8 records the resolved version of each changed package per workspace after the batch install, and checks each package-manager override against the direct pin it shadows. A batch that permissions stopped from assembling gets the new batch verdict `UNVERIFIED` instead of FAIL. Step 7 adds class **C, checksum** for a pin paired with a checksum, checked even when the PR is green. Step 10 re-runs a timeout under heavy load (e.g., exit 143) alone before blaming the batch. The anchor standards read package-manager defaults from the pinned major's release notes, and Step 13 judges licences by what ships, not by graph membership. #772
|
|
66
|
+
- **The dead-code and security audits catch a guard whose env var is never set where the guard runs.** `bkit-audit-dead-code` Step 5 — Env Vars now also compares each declared var that gates a control with the secret names set in every runtime environment (the host's env list, the secret-sync map), by name only; a gating var missing from one is a finding, and an environment the token cannot read is `Not Checked`. `bkit-audit-security` Step 14 — Secrets checks that every var a guard reads is in the sync map for each environment that runs it. Dead-code Step 2 reads every unused-import hit in shipped source, Step 3 opens duplicate-export aliases with zero readers and runs once with entry exports included, and Step 9 includes URL pointers outside code. Security Step 6 treats a limiter keyed on a client-chosen field as no limiter, and Step 9 limits a public read of versioned content to published content. #773
|
|
67
|
+
- **The prompts audit checks prompts against `.bkit/authoring.md`.** `bkit-audit-prompts` lists bkit's authoring rules among its anchor standards, read at the installed bkit version, and Step 5 — Structure gives each prompt one row per principle. An install without `.bkit/authoring.md` marks those rows `Not Checked`, never a pass. #774
|
|
68
|
+
- **The architecture audit counts runtime imports only, names dynamic imports as a blind spot, and reads regions.** Step 6 computes client reach over runtime edges, because a type-only import is erased at compile time. Step 7 adds non-literal dynamic import specifiers to the blind spots. Step 9 lists data ownership per script or CLI directory too. Step 10 annotates the Container view with each compute and data region, and a request that crosses regions on every call is a finding. #775
|
|
69
|
+
- **The coverage audit has a fallback when CI keeps no per-file artifact, and samples the integration branch when the default branch has no full runs.** #776
|
|
70
|
+
- **The database audit diffs a schema fingerprint across environments.** Step 5 compares counts and hashes of columns, indexes, functions, policies and grants, because a change made by hand outside migrations leaves both migration lists equal. With one readable environment, the diff is `Not Checked`. #777
|
|
71
|
+
- **The documentation audit catches more broken references.** Step 2 adds a column for cited paths that no longer resolve, Step 4 resolves every `*.md` name (backticked or not) and confirms the prose-lint and format globs cover every live doc, Step 5 flags ledger rows whose `references` is null, and Step 10 runs the path resolver over memory files. #778
|
|
72
|
+
- **The duplication audit searches generic calls and renamed imports, and leaves generated files out of the clone %.** #779
|
|
73
|
+
- **The LLM audit counts effective retries.** Step 11 multiplies wrapper retries, the SDK's default retries and tool-loop steps, because the layers stack, and uses that figure in the worst-case call count. #781
|
|
74
|
+
- **The logs audit stops undercounting the error board and overcounting retries.** Step 3 takes the unresolved count from a per-id lookup and compares the tracker's event retention with the window first. Step 11 names CI as a runtime-log source when CI writes to production resources, and joins retry log lines to the request's final outcome before counting failures. #782
|
|
75
|
+
- **The slop audit flags suppression entries that hide nothing, and searches `void` fire-and-forget calls.** Step 3 prints a hide count per suppression entry, and an entry that hides 0 findings gets the new verdict `PRUNE`. Step 7 searches `void <call>(` in handlers and jobs, because floating-promise rules ignore `void` by default. #783
|
|
76
|
+
|
|
77
|
+
### Fixed
|
|
78
|
+
|
|
79
|
+
- **Workflow summaries judge the findings that remain unresolved.** Later passing work clears only the findings its contract covers; accepted limitations remain concerns, and missing evidence stays unresolved. The original verdicts remain in the assessment history, while current action items reflect the latest result for each task or remediation step.
|
|
80
|
+
- **The slop check ignores skip and focus markers inside literal test data.** Strings, template text and regular expressions containing examples such as `it.skip` no longer count as disabled tests when a valid syntax tree is available; executable markers still count, and an unavailable or invalid syntax tree keeps the conservative text scan. `bkit upgrade` automatically refreshes `scripts/slop/bkit-slop-type-suppression.mjs` only when it is byte-identical to the copy shipped in v6.0.0. Customized copies and symlinked paths stay unchanged, with a visible warning to merge `.bkit/templates/scripts/slop/bkit-slop-type-suppression.mjs` by hand. Dry run reports the update without writing, and a second upgrade changes nothing. See `docs/migrations.md` § Migrations.
|
|
81
|
+
- **Ship reviews removed assertions against their actual surviving coverage.** `bkit branches scan-diff --disabled-tests` recognizes moved assertions once per added occurrence, requires unchanged test context for moves across files, pairs rewrites only within the same file and test, and attributes removals to their original test. Unrelated additions cannot hide a removal. The deferred-work sweep requires concrete evidence of enabled equivalent coverage or an owner-approved retirement that leaves no requirement uncovered; missing or inconclusive coverage stays blocking.
|
|
82
|
+
|
|
83
|
+
- **`/bkit-ship` fixes a CI red that only `bkit:generate` output caused, and pre-push catches a stale register before a PR's CI does** ([#800](https://github.com/cbartens/bkit/issues/800)). When `dev` had not moved, ship skipped the merge and with it `bkit:generate`, so a branch carrying a stale `docs/capabilities.md` reached the merge gate red, and the gate sent every red to the Failure Path. When `dev` has not moved, ship still runs no `bkit:generate` up front and lets CI find a stale generated file. On a red run, `bkit runs gate` (exit 12) now lists each failed step as `{job}/{step}` and reports `regenerable` when every one is a step that `bkit:generate` output fails. Step 10 then runs one regenerate round per merge attempt, without asking, and lets CI re-check. The capability register no longer writes the commit it was built from into `docs/capabilities.md` and the docs that embed its diagrams, because every commit moved that id, so a rebuild changed the file even when nothing else had. The pre-push note on a branch with no open PR now counts source files changed since the last commit that changed the register. Every place that commits `bkit:generate` output (the merge in ship Step 4 and build Step 3, and the regenerate round) now commits only the paths it changed, so another agent's uncommitted work no longer stops the merge from regenerating. The list is a fixed floor (`bkit-tests-static/Check Capability Register`, `bkit-tests-static/Run bkit Check`) plus the new `bkit.testing.ciGenerated` key, where a repo adds its own steps, such as bkit's `bkit-tests-static/Assert Dist Freshness`. Pre-push now runs the register check on a push of a branch with an open PR into `dev`, not only on a push to `dev`, and warns when `gh` is missing or its `pr list` call fails, because it then cannot tell whether a PR is open and never reads that as "no PR". **Re-copy** `scripts/graphify/bkit-graph-pre-push.sh`, `bkit-graphify.sh` and `bkit-graphify-rollup.py` from `.bkit/templates/`, and the stdin loop and `Capability register` call from `.bkit/templates/.husky/pre-push`, because bkit never overwrites your copies. An older hook copy still works, checking the checked-out branch at `HEAD`.
|
|
84
|
+
- **`/bkit-ship` can integrate `dev` into a PR whose branch fell behind** ([#799](https://github.com/cbartens/bkit/issues/799)). Step 4 used to ask GitHub whether the PR was mergeable and then either refresh the head on the server or rebase the branch. Both failed on a normal run: GitHub ignores `merge=union`, so a PR whose ledgers both sides appended showed as CONFLICTING while a local merge was clean, and the rebase was refused because the run's own `status.jsonl` was still uncommitted. Step 4 now runs `bkit branches sync --merge`, which commits the run's uncommitted work, merges `origin/dev` into the branch locally, unions the ledgers, takes a conflicted lockfile from `dev` and regenerates it, runs a declared `bkit:generate`, and leaves only a conflict that needs judgement for `@bkit-ship-conflict-resolve`, which hand-resolves it and re-runs the block. Both merge modes of `bkit branches sync` (`--merge-docs` for build, a `--require-ci` push and land's PR retry; `--merge` for ship) run one driver that differs only in which conflicts it may settle, so a docs merge is committed as `chore({FID}): merge dev` instead of the default merge subject. `bkit branches rebase --hand-resolve` is gone: nothing called it once ship stopped rebasing. The merged branch is pushed plain, so ship never force-pushes, never reads GitHub's `mergeable`, and never requests a server-side update-branch. Step 9 re-validates CI at the merged head as before. `bkit workflows fail` aborts a merge left in progress as it does a rebase.
|
|
85
|
+
- **BREAKING — `bkit ci prose` fails when Vale or its styles are missing, instead of passing without checking anything** ([#765](https://github.com/cbartens/bkit/issues/765)). With no `vale` on `PATH`, or with `.vale/styles/write-good` absent and impossible to restore, the prose gate used to exit 0 with `passed: true` while linting nothing, so CI could go green without checking prose. Both cases now exit nonzero with `passed: false`, and `skipped` still names the cause (`vale-missing` / `write-good-missing`). Linting with no matching files still passes. Every pre-push gate that runs `lint:prose` now fails on a machine without Vale: install it (`brew install vale`, then `vale sync`). The CI and cloud templates install it already. `bkit check` raises the new `vale-not-installed` advisory when `lint:prose` runs `bkit ci prose` and Vale is not on `PATH`.
|
|
86
|
+
- **A table row in `.bkit/workflows.md` no longer loses its end on GitHub.** The debug Step 6 row had a bare `|` in its text, which GitHub reads as a column break, so the end of the row was dropped. The tables in `.bkit/workflows.md`, `.bkit/templates.md`, `.bkit/pipeline.md` and `.bkit/comparison.md` now escape every pipe inside a cell. #741
|
|
87
|
+
- **The test-first audit stops raising test changes and missing reds that are not real.** `bkit tests green` now finds each planned test by name in its file and flags only changes to that test's own lines or to code it runs (a helper it calls, a hook in its `describe`, an import it uses); an edit to another test in the same file is reported as `outside the test only` and is no gap. When the test is not declared exactly once, the whole file counts as before. `bkit tests red` runs a new optional `bkit:lint:file` script on the test before running it and records no red while lint fails, so a lint rewrite never lands after the red; install, `bkit check` and `bkit upgrade` advise `lint-file-script-missing` when `bkit:test:file` is declared without it. A red refused because the test already passes is now written down with HEAD and the uncommitted files; when another task's committed code, sharing a `CREATE` / `UPDATE` file, already made the test pass, `tests green` lists it under `Already landed` instead of raising `no-red`. Plan review and the build challenge reviewers now check by reading that each new test can fail on the code it targets. #723
|
|
88
|
+
|
|
89
|
+
- **GateGuard, ReadGuard and Antigravity's one-time block work for every user on a shared machine.** Their state folders in the system temp folder now carry the user id (`bkit-gateguard-<uid>`, `bkit-readguard-<uid>`, `bkit-antigravity-retry-<uid>`), as the rules-read advisory's does. A second user on a shared Linux `/tmp` no longer finds the folder owned by someone else and silently loses every checklist, repeat-read note and Antigravity advisory. When state still cannot be written, GateGuard gives its checklist as advice only (never a block that no retry can get past), opencode remembers warnings and reads in memory, and Antigravity lets the call through instead of denying it with no way to retry. #700
|
|
90
|
+
- **Tests run by the example pre-push hook can no longer write into your repo's git config.** Pushing from a linked worktree, git hands the hook `GIT_DIR`, which beats a child's cwd and `-C`, so a test's `git -C "$tmp" init` or `git config user.email` landed in the real `.git/config` (`core.bare=true`, a fixture's author identity on every later commit). The example `.husky/pre-push` now clears `GIT_DIR` / `GIT_WORK_TREE` / `GIT_INDEX_FILE` first. Your own copy of the hook is yours: add the same `unset` line after `set -e` to get this. #551
|
|
91
|
+
- **A lettered answer to a bkit question reaches the option it names.** Answering `B` (or `B) Reject`, `B — too risky`) to ship's confirm question for an item the build accepted without the owner no longer records it as "accepted by owner" in `docs/decisions.jsonl`: ship runs `--confirm` only on `Confirm` and `--reject` only on `Reject`, and asks again on anything else. A lettered `Try again` / `Stop` in the debug, build and ship loop questions routes like the option name instead of stalling for another round, and a `Decision: A) Accept …` line counts as accepted, so the next challenge round does not raise the finding again and the build summary counts it. #703
|
|
92
|
+
- **A copy entry outside the checkout no longer breaks every bkit commit.** A `bkit.workflows.worktree.copy` entry such as `../shared/.env`, which setup already skips, was also named in the exclude list of every bkit `git add -A`. Git refused that (exit 128) and nothing was staged, so step commits exited 8, the close commit failed and the resume carry commit could not be made. Such entries are now left out of the exclude list as well, and an abort commit logs a failed add. #662
|
|
93
|
+
- **A file only the main checkout's copy list names is never committed.** Setup copies entries by the main checkout's `package.json`, but bkit commits left out only the entries in the worktree's own list. Commits now leave out the entries of both lists and `.bkit/.env`. #662
|
|
94
|
+
- **A tracked `.env` in the copy list no longer stops every resume with exit 9.** A committed placeholder `.env` that setup copies over shows as modified and is never committed, so the resume rebase refused to start over it. The rebase now sets such entries aside and puts them back (`--autostash`) once the carry commit has left nothing else; a refused carry commit still stops it with exit 9. A worktree holding only copied-in entries also no longer logs a failed carry commit. #662
|
|
95
|
+
- **A resume never deletes a log that differs from `dev`'s copy.** An untracked log of the FID that `dev` already holds is still dropped so `dev`'s copy wins; if its content differs, it is first moved to the feature's outbox folder (`bkit-outbox/{FID}/dropped-logs/`), and the log names where. #662
|
|
96
|
+
- **A design / plan close removes its worktree when the only leftover is the copied `.env`.** `bkit branches land` ignores the `bkit.workflows.worktree.copy` entries and `.bkit/.env` when deciding whether the worktree holds uncommitted work; every repo that does not gitignore `.env` kept `.worktrees/{FID}` and `feat/{FID}` after the close. #662
|
|
97
|
+
- **A `.bkit/.env` copy made where symlinks are refused follows a token rotation.** Setup records the copy it makes and replaces it on the next run, so a rotated token reaches the worktree; only a hand-edited file is left as `differs`. A copy that cannot be written is reported as `bkitEnv: failed` with a log line instead of crashing setup. #702
|
|
98
|
+
- **Setup tips work when the main repo is bare.** With a bare repo plus linked worktrees, tips read the bare repo's parent folder and showed nothing or read an unrelated `package.json`; they now read the worktree's own checkout in that layout. #543
|
|
99
|
+
- **The `bkit-env` setup tip no longer tells you to copy the main checkout's `.bkit/.env` from a worktree.** The tip only fires when that file is missing or blank, so the advice pointed at a file that could not help. #543
|
|
100
|
+
- **Two closes landing at once no longer stop "nothing landed" because they fetched dev at the same moment.** When a second landing in the same clone updated `origin/dev` during this landing's fetch, git failed the fetch with `cannot lock ref 'refs/remotes/origin/dev'` and the close stopped. `pushToDev` now waits and fetches again within `LAND_ATTEMPTS`, as it already does when dev moves. #639
|
|
101
|
+
- **Landing and syncing work in a clone whose fetch refspec does not cover `dev`.** Every dev fetch in the landing, sync and ship-close paths uses `+refs/heads/dev:refs/remotes/origin/dev`, so a single-branch clone no longer builds on a stale `origin/dev` and burns every push attempt. #639
|
|
102
|
+
- **A close no longer tells you to publish a commit that is already on `origin/dev`.** When a later close fast-forwarded local dev past this one, `fastForwardDev` reports `localDev: current` instead of `skipped` with `git pull --rebase && git push` advice; the not-fast-forwarded list names only commits `origin/dev` lacks. #639
|
|
103
|
+
- **Ship's close removes the feature worktree before it releases the workflow lock,** so a new run of the same FID cannot take the lock and resume into a worktree that is about to be deleted. #639
|
|
104
|
+
- **A failed `bkit steps done` / `steps finish` commit leaves the index and `status.jsonl` exactly as it found them, and never reports "nothing written" while its row is still on disk.** The rollback restores the index byte-for-byte: an already-staged `status.jsonl` no longer keeps the refused row, a partly staged file keeps its partial staging, and a bracketed new path such as `src/[id].tsx` no longer unstages your `src/i.tsx`. It removes only the attempt's own row, keeping a row another writer appended during the commit. When the attempt's row cannot come off because another row follows it, the command says the row stays and exits 82 (needs a human) instead of 8, so a re-run cannot write it twice. A hook that deletes `status.jsonl` no longer crashes the command with `ENOENT`. #700
|
|
105
|
+
- **The rules-read advisory on opencode, Codex and Antigravity reaches each session once, even when another user owns the shared temp folder.** The state folder is per user (`bkit-rules-advisory-<uid>`); when state still cannot be written, the opencode plugin remembers the advisory for the life of the process instead of repeating it on every tool call. #700
|
|
106
|
+
- **`context-fetch-unbounded` no longer counts a timeout, a log verbosity or a buffer size as an output bound.** A block such as `curl -sS --max-time 30 "$API/events"` that dumps a whole response read as bounded, because `--max-time`, `curl -m`, `--log-level=` and `--buffer-size=` matched the bound list. These now count for nothing; `grep -m` / `rg -m`, the other `--max-*` caps and every shipped context block still read as bounded. A heredoc holding an apostrophe no longer hides the block's `# Customise:` comment from the check either. #697
|
|
107
|
+
- **Ignoring `context-fetch-missing` no longer hides `context-fetch-unbounded`.** The context-fetch setup tip listed both advisory ids, so one `bkit.advisories.ignore` entry silenced both; the tip now owns only `context-fetch-missing`. #697
|
|
108
|
+
- **Every context-fetch artifact keeps its `===== TRUNCATED: … =====` line through the clamp.** Only `runtime` artifacts kept it; in a large `ci` or `e2e` artifact a block's page-cap notice could be trimmed away and a partial read looked complete. #697
|
|
109
|
+
- **A table-rendered fetch reports the bytes its block printed as fetched.** `clampSummary` counted the markdown table as both fetched and kept, so the saving from rendering never showed. #697
|
|
110
|
+
- **The opencode `variant:` clamp reads each model's thinking levels per gateway, not per model.** The same model exposes different levels on different gateways: `deepseek-v4.1-flash` offers `none` on OpenRouter only, and `kimi-k3` is `max`-only on OpenCode Go. A `low`-effort agent on OpenCode Zen or Go renders `variant: low` instead of the `none` OpenCode 2.0 rejects there, and stays `none` on OpenRouter. Levels come from models.dev `reasoning_options` per provider. #205
|
|
111
|
+
- **`bkit install --opencode` names the models the Ollama and OpenCode Go columns actually pin.** The paid-plan note listed `kimi-k3`, which neither column installs, and left out the models they do; it now reads the pins from the shipped `prompts.md` § Models. #205
|
|
112
|
+
- **The Codex session model for `/bkit-build` and `/bkit-ship` is `gpt-6.1-sol`.** The orchestrator table still named `gpt-5.6-terra`, which no Codex agent pins. #205
|
|
113
|
+
- **README no longer credits the OpenCode Zen and Go DeepSeek pin with the 1017 snapshot's 40.9.** Those gateways serve the undated 2026-09-10 snapshot, which LiveBench 2.0 has not measured. #205
|
|
114
|
+
- **§ Model Presets shows what OpenRouter installs and what Option 2 overrides to.** The summary row and per-agent table named `gemini-4-argon` for Option 2 and `kimi-k3` as shipped; they now match § Models and the copy-paste override block (`gpt-6.1-sol`). The OpenRouter IDs line gives bare IDs: pasting the old `openrouter/xiaomi/…` into an override cell rendered `openrouter/openrouter/…`. #714
|
|
115
|
+
- **The capability-register gate runs on pull requests, not only dev pushes, and judges the tree that lands.** `Check Capability Register` runs on every event as `check-at HEAD`: on a pull request that is GitHub's test merge of the PR into its base, the tree a squash merge puts on dev. A register that drifts in a PR — including a PR behind dev whose register and dev's merge into a file no rebuild produces — reds the PR lane and the capstone instead of the post-merge push run, which the ship gate pins to the squash commit and cannot retro-green. A red on a PR names the base: merge it into the branch, run `pnpm graph:refresh`, commit and push. The graphify release installed and the script that judges now come from the same tree, so a `GRAPHIFY_SPEC` bump on dev no longer reds every PR behind it. Copy the `Check Capability Register` step from `.bkit/templates/.github/workflows/bkit-ci.yml` into your adopted `bkit-ci.yml`. #444
|
|
116
|
+
- **A design / plan worktree is cut from `origin/dev` whatever local `dev` holds, and a design / plan branch already carrying unpushed `dev` commits is refused at Step 2 with the one action that unblocks it.** `bkit worktrees setup` cut every new feature branch from local `dev` when it was a fast-forward of `origin/dev`; a design / plan close lands docs and ledgers on `origin/dev` and nothing else, so a branch carrying another session's unpushed code could not land — `bkit branches land` stopped with exit 17 and a list of paths the run never made. `worktreeBase` now pins design / plan to `origin/dev` (`build`, `debug` and `ship` keep local `dev`, still narrated with the unpushed count), a resumed design / plan branch that carries such commits is refused (exit 7) instead of failing after the whole phase, and both the step-2 refusal and the land refusal name the cause — the unpushed `dev` count, its tip, and `git push origin dev` as the fix — rather than only the paths. #639
|
|
117
|
+
- **A `bkit.workflows.worktree.copy` entry that is also gitignored no longer fails every commit in a worktree.** `addAllButCopied` named each copied entry in a `:(exclude)` pathspec; git refuses an `add` whose pathspec names an ignored file, so `bkit steps finish` — and `workflows handover --push`, `workflows close` and the resume cleanup — exited 8 at Step 2 whenever setup had copied a gitignored entry such as `.bkit/.env`. The helper now leaves an ignored copied entry out of the exclude list (`git add -A` skips it anyway). `bkit branches push --commit` stages through the same helper, so its marker commit no longer commits a copied-in secret; `bkit ledgers commit --path` and `commitOwnSet` name a gitignored path in the error instead of leaking git's ignored-paths guard. #700
|
|
118
|
+
- **Each workflow routes on every verdict its step can give.** Design's apply-review and organise steps and plan's apply-review step went to the Failure Path only on `FAIL`, so any other verdict, such as a `PENDING` left by an agent that stopped early, carried on; they now continue only on `PASS` or `CONCERNS`. Ship integrates `origin/dev` with a local merge and resolves any remaining conflicts before the merge gate. Ship's deferred sweep now gets the FID it is told to read. When the owner answers a debug or ship loop question with something other than an option, the step now answers, asks again and records the wait with a `bkit status row` command. A `FAIL` summary is shown once, as the final message at the STOP step, instead of being shown and then routed to the Failure Path; ship reads its summary before the flush removes the worktree. `bkit upgrade` picks it up. #747
|
|
119
|
+
- **The build summary counts a gaps fix that a later verify passed as answered.** A `FAIL` from `@bkit-build-plan-gaps-remediate` that the group's next verify passed counted as an open failure. Build never routes on the gaps fix's own verdict; the verify after it judges the fixes. #747
|
|
120
|
+
- **Agent verdict rules no longer overlap or leave cases out.** Each prompt's `PASS` / `CONCERNS` / `FAIL` (and `HANDOVER`) rules now cover every outcome exactly once, and `CONCERNS` means "no `FAIL` condition holds" throughout. For example, `@bkit-build-plan-tasks` gives `HANDOVER` over `FAIL`; `@bkit-build-plan-gaps-remediate` and `@bkit-debug-failure-remediate` give `FAIL` and change nothing when Context names no `Strategy`; and `@bkit-ship-conflict-resolve` gives `FAIL` when no merge of `origin/dev` is in progress. `bkit upgrade` picks it up. #747
|
|
121
|
+
- **No audit template contradicts itself any more, and each gate box checks one fact.** The deferrals and failures audits no longer allow ledger rows that their rules forbid. The documentation and duplication audits name the copy to delete or the register row to change, and leave that to the next step, as their other steps say. The annotations audit and seven others say this run writes its own `docs/failures.jsonl` rows. The app-store audit covers a build that is in review. The `Tree clean` gates, which a run could never pass because it writes its own report, are replaced by gates it can pass. The shared `Writes`, `Suggested Issues` and `Summary` gates are split into one fact per box, and long steps into one instruction per line. `bkit upgrade` refreshes `docs/templates/`. #747
|
|
122
|
+
- **The plan template's Gate 1 covers its own items and cites each owner section by its full heading.** Its examples no longer name a vendor, and `Manual Verification` no longer carries the owner mark, since it has no owner confirmation box. `bkit upgrade` refreshes `docs/templates/bkit-plan.md`. #747
|
|
123
|
+
- **The shipped docs match the code.** For example: `providers.md` names `GATEWAY_COLUMN` and `render/hosts.ts`, and says Cursor gets `effort` but does not enforce `tools:`; `prompts.md` says each opencode cell holds the bare model ID and install adds the provider prefix; `cloud.md` says `bkit install` re-stamps the cache-bust line and how the pnpm version is chosen; `install.md` says design, plan and build run in the cloud only by dispatch; `testing.md` and `deployments.md` call the merged-PR push run `partial`. Text true only of the bkit repo, and the outdated v1 model board, are gone from the shipped docs. `bkit upgrade` picks it up. #747
|
|
124
|
+
- **The copy-and-own templates name the files that exist.** The context briefs and `.bkit/templates.md` cite `bkit-maestro.md`, `bkit-expo.md` and the rest by their real names; the capabilities rollup accepts the `hide_nodes_why` key its seed asks for; the bug form says what `[soak]` does without `[repro]`. Re-copy a template you adopted to pick it up. #747
|
|
125
|
+
- **An audit run no longer lowers the severity of an open `docs/failures.jsonl` row.** Step 11 of `@bkit-audit-generate` used to treat any finding at the same `file:line` as the same problem, and a `LOW` finding then rewrote the matched row to `LOW`, so a real high-severity bug that a minor finding only mentioned dropped down every ranking. A finding now matches an open row only when it is the same defect, a matched `MEDIUM`+ finding takes the higher of the two severities, a matched `LOW` finding keeps the row's severity, and no audit run lowers a row's severity. #767
|
|
126
|
+
- **The audit agent follows the `Host shell`, `Shallow history` and `New worktree` rules again.** `@bkit-audit-generate` reads only the project part of `.agents/rules.md`, and gets bkit's own rules through its copied `Rules` block, which had lost these three. They are back, word for word. `Empty is inconclusive` now also says that a capped or windowed read is partial and must be paged to its end, and names two more false empties: `rg` printing only "binary file matches" on history output (use `-a`), and a wildcard `git grep` pathspec that matches the folder but not the files under it (end it with `/**`). `Host shell` now names zsh's `"$var:x"` modifier and its lower-case `pipestatus`, and that a `grep` alias or function can reject options. #768
|
|
127
|
+
|
|
9
128
|
## [6.0.0] — 2026-10-25
|
|
10
129
|
|
|
11
130
|
### Breaking Changes
|