@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
|
@@ -133,6 +133,17 @@ export const SEVERITY_KINDS = new Set(["friction", "deferral", "failure"]);
|
|
|
133
133
|
export const TRIAGE_STATUSES = new Set(["OPEN", "TRIAGED", "CLOSED"]);
|
|
134
134
|
/** The `ACTIVE` / `SUPERSEDED` lifecycle shared by `decision` and `knowledge`. */
|
|
135
135
|
export const DECISION_STATUSES = new Set(["ACTIVE", "SUPERSEDED"]);
|
|
136
|
+
/**
|
|
137
|
+
* The kinds whose rows carry `firstTs` + `updates` (`.bkit/jsonl.md` § Compaction):
|
|
138
|
+
* the keyed kinds of the ledgers `bkit ledgers compact` rewrites to their fold winners.
|
|
139
|
+
*/
|
|
140
|
+
export const AGED_KINDS = new Set([
|
|
141
|
+
"deferral",
|
|
142
|
+
"failure",
|
|
143
|
+
"knowledge",
|
|
144
|
+
"decision",
|
|
145
|
+
"feature",
|
|
146
|
+
]);
|
|
136
147
|
export const FEATURE_STATUSES = new Set([
|
|
137
148
|
"DESIGNED",
|
|
138
149
|
"PLANNED",
|
|
@@ -164,7 +175,7 @@ export const UNJUSTIFIED_REASON = "unjustified";
|
|
|
164
175
|
* § Ledgers & Writers). EXHAUSTIVE: a subagent absent from this set does not
|
|
165
176
|
* write the kind at all.
|
|
166
177
|
*
|
|
167
|
-
* `@bkit-build-plan-
|
|
178
|
+
* `@bkit-build-plan-tasks` and `@bkit-build-plan-gaps-remediate` are not in it: a
|
|
168
179
|
* blocked plan task's record is its `BLOCKED` log line, which the next verify pass reads.
|
|
169
180
|
*
|
|
170
181
|
* Orchestrator-written rows carry no `subagent` and are outside this check.
|
|
@@ -194,6 +205,11 @@ export const APPEND_LEDGERS = {
|
|
|
194
205
|
};
|
|
195
206
|
/** The workflows whose close writes `.bkit/stats.jsonl` rows (`bkit workflows close`, `bkit comply`). */
|
|
196
207
|
const CLOSING_WORKFLOWS = new Set(["design", "plan", "build", "debug", "ship"]);
|
|
208
|
+
/**
|
|
209
|
+
* The stats writers: the closing workflows, plus `utility`, a direct chat outside any
|
|
210
|
+
* workflow (`by.step` `manual`), the owner deciding in it.
|
|
211
|
+
*/
|
|
212
|
+
const STATS_WRITERS = new Set([...CLOSING_WORKFLOWS, "utility"]);
|
|
197
213
|
/**
|
|
198
214
|
* `.bkit/jsonl.md` § Ledgers & Writers as code, for the kinds in
|
|
199
215
|
* {@link APPEND_LEDGERS}. EXHAUSTIVE: a name absent from a set does not write the
|
|
@@ -207,31 +223,37 @@ export const KIND_WRITERS = {
|
|
|
207
223
|
"bkit-plan-update",
|
|
208
224
|
"bkit-utility-update-decisions",
|
|
209
225
|
]),
|
|
210
|
-
// Build: Decision Pause accept; plan: an open question answered after close;
|
|
211
|
-
//
|
|
212
|
-
//
|
|
213
|
-
|
|
226
|
+
// Build: Decision Pause accept; plan: an open question answered after close; design: an
|
|
227
|
+
// open question answered by the owner at close (the human decides, the orchestrator
|
|
228
|
+
// records); ship: an assumed accept the owner confirms (`bkit decisions apply --by=owner`);
|
|
229
|
+
// utility: a direct chat outside any workflow (`by.step` `manual`), the owner deciding in it.
|
|
230
|
+
// All ONLY after explicit human approval.
|
|
231
|
+
orchestrators: new Set(["design", "build", "plan", "ship", "utility"]),
|
|
214
232
|
},
|
|
215
233
|
// Build: `bkit challenge merge` writes each LOW challenge finding (`low-severity`). Ship:
|
|
216
234
|
// `bkit decisions pending --defer` writes each assumed accept nobody confirmed (`needs-decision`).
|
|
217
|
-
|
|
235
|
+
// Utility: a direct chat outside any workflow (`by.step` `manual`), the owner deciding in it.
|
|
236
|
+
deferral: { subagents: DEFERRAL_WRITERS, orchestrators: new Set(["build", "ship", "utility"]) },
|
|
218
237
|
failure: { subagents: ANY_WRITER, orchestrators: ANY_WRITER },
|
|
219
238
|
knowledge: {
|
|
220
239
|
subagents: new Set([
|
|
221
|
-
"bkit-build-plan-
|
|
240
|
+
"bkit-build-plan-tests",
|
|
241
|
+
"bkit-build-plan-tasks",
|
|
222
242
|
"bkit-build-plan-gaps-remediate",
|
|
223
243
|
"bkit-debug-failure-remediate",
|
|
224
244
|
"bkit-utility-update-knowledge",
|
|
225
245
|
]),
|
|
226
|
-
|
|
246
|
+
// Utility: a direct chat outside any workflow (`by.step` `manual`), the owner deciding in it.
|
|
247
|
+
orchestrators: new Set(["utility"]),
|
|
227
248
|
},
|
|
228
249
|
friction: {
|
|
229
250
|
subagents: new Set(),
|
|
230
|
-
|
|
251
|
+
// Utility: a direct chat outside any workflow (`by.step` `manual`) that meets friction.
|
|
252
|
+
orchestrators: new Set(["design", "plan", "build", "debug", "ship", "auto", "utility"]),
|
|
231
253
|
},
|
|
232
|
-
compliance: { subagents: new Set(), orchestrators:
|
|
233
|
-
counter: { subagents: new Set(), orchestrators:
|
|
234
|
-
outcome: { subagents: new Set(), orchestrators:
|
|
254
|
+
compliance: { subagents: new Set(), orchestrators: STATS_WRITERS },
|
|
255
|
+
counter: { subagents: new Set(), orchestrators: STATS_WRITERS },
|
|
256
|
+
outcome: { subagents: new Set(), orchestrators: STATS_WRITERS },
|
|
235
257
|
};
|
|
236
258
|
const writerList = (w) => w === ANY_WRITER ? "any" : w.size === 0 ? "none" : [...w].join(", ");
|
|
237
259
|
/** A row's `by` block, or an empty one when it has none. */
|
|
@@ -285,13 +307,14 @@ export function mintTs(after) {
|
|
|
285
307
|
* tokens" per build group). Rows store peaks only; readers judge them against this.
|
|
286
308
|
*/
|
|
287
309
|
export const AGENT_CONTEXT_CAP = 160_000;
|
|
288
|
-
export const OUTCOME_ENDINGS = new Set(["done", "close-failed"]);
|
|
310
|
+
export const OUTCOME_ENDINGS = new Set(["done", "close-failed", "held"]);
|
|
289
311
|
export const RUN_ENDINGS = new Set([
|
|
290
312
|
"done",
|
|
291
313
|
"close-failed",
|
|
292
314
|
"failed",
|
|
293
315
|
"decision-pause",
|
|
294
316
|
"stopped",
|
|
317
|
+
"held",
|
|
295
318
|
]);
|
|
296
319
|
// ---------------------------------------------------------------------------
|
|
297
320
|
// Identity — per-kind composite tuple for dedup (NOT bare ts)
|
|
@@ -776,7 +799,7 @@ export function totalsProblem(row) {
|
|
|
776
799
|
checks.push(() => eq("build.challenge.findings.total", findings["total"], sumOf(["CRITICAL", "HIGH", "MEDIUM", "LOW"].map((s) => findings[s]))));
|
|
777
800
|
}
|
|
778
801
|
if (typeof build["redTests"] === "number" && isObj(field(steps, "byStep"))) {
|
|
779
|
-
checks.push(() => eq("build.redTests", build["redTests"], Number(field(steps, "byStep", "build-
|
|
802
|
+
checks.push(() => eq("build.redTests", build["redTests"], Number(field(steps, "byStep", "build-tests-red", "n") ?? 0)));
|
|
780
803
|
}
|
|
781
804
|
}
|
|
782
805
|
const usage = row["usage"];
|
|
@@ -984,6 +1007,23 @@ export function validate(event) {
|
|
|
984
1007
|
else if (e["reason"] !== undefined) {
|
|
985
1008
|
return { ok: false, reason: `${kind} rows do not carry reason` };
|
|
986
1009
|
}
|
|
1010
|
+
// firstTs / updates — the entry's age and row count, set by the writer (withLineage).
|
|
1011
|
+
if (AGED_KINDS.has(kind)) {
|
|
1012
|
+
const first = e["firstTs"];
|
|
1013
|
+
if (first !== undefined && (typeof first !== "number" || !(first <= e["ts"]))) {
|
|
1014
|
+
return { ok: false, reason: "firstTs must be a number no later than ts" };
|
|
1015
|
+
}
|
|
1016
|
+
const updates = e["updates"];
|
|
1017
|
+
if (updates !== undefined && (!Number.isInteger(updates) || updates < 1)) {
|
|
1018
|
+
return { ok: false, reason: "updates must be a positive integer" };
|
|
1019
|
+
}
|
|
1020
|
+
}
|
|
1021
|
+
else {
|
|
1022
|
+
for (const f of ["firstTs", "updates"]) {
|
|
1023
|
+
if (e[f] !== undefined)
|
|
1024
|
+
return { ok: false, reason: `${kind} rows do not carry ${f}` };
|
|
1025
|
+
}
|
|
1026
|
+
}
|
|
987
1027
|
const run = isObj(e["run"]) ? e["run"] : undefined;
|
|
988
1028
|
if (kind === "compliance" || kind === "counter") {
|
|
989
1029
|
if (typeof run?.["parentSha"] !== "string" || run["parentSha"] === "") {
|
|
@@ -1035,7 +1075,13 @@ export function validate(event) {
|
|
|
1035
1075
|
if (!OUTCOME_ENDINGS.has(e["ending"])) {
|
|
1036
1076
|
return {
|
|
1037
1077
|
ok: false,
|
|
1038
|
-
reason: `outcome ending must be
|
|
1078
|
+
reason: `outcome ending must be ${[...OUTCOME_ENDINGS].join("|")} (got: ${String(e["ending"])})`,
|
|
1079
|
+
};
|
|
1080
|
+
}
|
|
1081
|
+
if (e["publish"] !== undefined && typeof e["publish"] !== "boolean") {
|
|
1082
|
+
return {
|
|
1083
|
+
ok: false,
|
|
1084
|
+
reason: `outcome publish must be a boolean (got: ${String(e["publish"])})`,
|
|
1039
1085
|
};
|
|
1040
1086
|
}
|
|
1041
1087
|
const ledgers = e["ledgers"];
|
|
@@ -1218,6 +1264,64 @@ export function fold(events) {
|
|
|
1218
1264
|
}
|
|
1219
1265
|
return state;
|
|
1220
1266
|
}
|
|
1267
|
+
const positiveInt = (v) => Number.isInteger(v) && v > 0 ? v : undefined;
|
|
1268
|
+
/**
|
|
1269
|
+
* `firstTs` + `updates` of one entry from all of its rows, in any order. A row
|
|
1270
|
+
* carrying `updates` stands for that many rows, so the count survives compaction;
|
|
1271
|
+
* each later row adds one. Rows sharing a numeric `ts` are one write: a compacted
|
|
1272
|
+
* winner beside the pre-compaction copy a union merge brought back.
|
|
1273
|
+
*/
|
|
1274
|
+
export function lineage(rows) {
|
|
1275
|
+
let firstTs;
|
|
1276
|
+
let updates = 0;
|
|
1277
|
+
let prev;
|
|
1278
|
+
for (const r of [...rows].sort((a, b) => compareTs({ ts: a.ts }, { ts: b.ts }))) {
|
|
1279
|
+
for (const t of [r.firstTs, r.ts]) {
|
|
1280
|
+
if (typeof t === "number" && Number.isFinite(t) && (firstTs === undefined || t < firstTs)) {
|
|
1281
|
+
firstTs = t;
|
|
1282
|
+
}
|
|
1283
|
+
}
|
|
1284
|
+
const own = positiveInt(r.updates);
|
|
1285
|
+
const at = tsOrder(r.ts);
|
|
1286
|
+
updates =
|
|
1287
|
+
at === prev && Number.isFinite(at)
|
|
1288
|
+
? Math.max(updates, own ?? updates)
|
|
1289
|
+
: Math.max(own ?? 0, updates + 1);
|
|
1290
|
+
prev = at;
|
|
1291
|
+
}
|
|
1292
|
+
return firstTs === undefined ? { updates } : { firstTs, updates };
|
|
1293
|
+
}
|
|
1294
|
+
/** `row` with `firstTs` + `updates` set to `l`, placed right after `ts` (at the end when it has none). */
|
|
1295
|
+
export function placeLineage(row, l) {
|
|
1296
|
+
const fields = l.firstTs === undefined ? {} : { firstTs: l.firstTs };
|
|
1297
|
+
fields["updates"] = l.updates;
|
|
1298
|
+
const out = {};
|
|
1299
|
+
for (const [k, v] of Object.entries(row)) {
|
|
1300
|
+
if (k === "firstTs" || k === "updates")
|
|
1301
|
+
continue;
|
|
1302
|
+
out[k] = v;
|
|
1303
|
+
if (k === "ts")
|
|
1304
|
+
Object.assign(out, fields);
|
|
1305
|
+
}
|
|
1306
|
+
return "ts" in row ? out : { ...out, ...fields };
|
|
1307
|
+
}
|
|
1308
|
+
/** True for a row `bkit ledgers compact` folds: an {@link AGED_KINDS} kind with a non-empty string `key`. */
|
|
1309
|
+
export const isAgedRow = (row) => AGED_KINDS.has(String(row["kind"])) && typeof row["key"] === "string" && row["key"] !== "";
|
|
1310
|
+
/**
|
|
1311
|
+
* `row` about to be appended, with `firstTs` + `updates` carried forward from
|
|
1312
|
+
* `prior` (rows already in its ledger) and any supplied values replaced. A row
|
|
1313
|
+
* {@link isAgedRow} rejects is returned unchanged.
|
|
1314
|
+
*/
|
|
1315
|
+
export function withLineage(prior, row) {
|
|
1316
|
+
if (!isAgedRow(row))
|
|
1317
|
+
return row;
|
|
1318
|
+
const id = identity(normalizeEvent(row));
|
|
1319
|
+
const same = prior
|
|
1320
|
+
.map(normalizeEvent)
|
|
1321
|
+
.filter((p) => isAgedRow(p) && identity(p) === id);
|
|
1322
|
+
const { firstTs: _first, updates: _updates, ...fresh } = row;
|
|
1323
|
+
return placeLineage(row, lineage([...same, fresh]));
|
|
1324
|
+
}
|
|
1221
1325
|
/** Reads every existing file in `paths` and folds all events together. */
|
|
1222
1326
|
export function foldFrom(paths) {
|
|
1223
1327
|
let allEvents = [];
|
|
@@ -1377,8 +1481,8 @@ export function workflowTelemetry(result, workflow) {
|
|
|
1377
1481
|
show("lines.total.files", (r) => r.lines?.total?.files);
|
|
1378
1482
|
}
|
|
1379
1483
|
show("plan.total.tasks", (r) => r.plan?.total?.tasks);
|
|
1380
|
-
if (cur.ending === "close-failed")
|
|
1381
|
-
row("ending",
|
|
1484
|
+
if (cur.ending === "close-failed" || cur.ending === "held")
|
|
1485
|
+
row("ending", cur.ending, "—");
|
|
1382
1486
|
// Instinct-loop deltas — friction is the featured signal (shown even at 0).
|
|
1383
1487
|
show("ledgers.friction.added", (r) => r.ledgers?.friction?.added);
|
|
1384
1488
|
show("ledgers.deferrals.added", (r) => r.ledgers?.deferrals?.added);
|
package/dist/render/hosts.js
CHANGED
|
@@ -89,18 +89,100 @@ export function antigravityToolsBlock(toolsBlock) {
|
|
|
89
89
|
}
|
|
90
90
|
return out;
|
|
91
91
|
}
|
|
92
|
+
/**
|
|
93
|
+
* Thinking-effort values each model exposes on each variant-carrying opencode gateway
|
|
94
|
+
* (`reasoning_options` effort values in models.dev, read 2026-10-28; models.dev provider
|
|
95
|
+
* `opencode` = bkit key `opencode-zen`). One model can differ per gateway — `deepseek-v4.1-flash`
|
|
96
|
+
* has `none` on OpenRouter only — and OpenCode hard-errors on a `variant:` the model does not
|
|
97
|
+
* expose there. An empty list = `toggle`-only or no reasoning options: no effort variant at all.
|
|
98
|
+
* ollama has no entry: it carries no variant on any model (applyOpencodeAgent skips it). An
|
|
99
|
+
* unlisted gateway or model passes the mapped value through unchanged.
|
|
100
|
+
*/
|
|
101
|
+
const OPENCODE_VARIANT_LEVELS = {
|
|
102
|
+
openrouter: {
|
|
103
|
+
"deepseek-v4.1-flash": ["none", "low", "high", "max"],
|
|
104
|
+
"minimax-m3.1-flash": ["low", "medium", "high", "xhigh", "max"],
|
|
105
|
+
"glm-5.3-flash": ["low", "high", "max"],
|
|
106
|
+
"gemini-4-argon": ["low", "medium", "high"],
|
|
107
|
+
"gpt-6.1-sol": ["low", "medium", "high", "xhigh", "max"],
|
|
108
|
+
"mimo-v2.6-pro": [],
|
|
109
|
+
"kimi-k3": ["none", "low", "high", "max"],
|
|
110
|
+
},
|
|
111
|
+
"opencode-zen": {
|
|
112
|
+
"deepseek-v4.1-flash": ["low", "high", "max"],
|
|
113
|
+
"minimax-m3.1-flash": ["low", "medium", "high", "xhigh", "max"],
|
|
114
|
+
"glm-5.3-flash": ["low", "high", "max"],
|
|
115
|
+
"gemini-4-argon": ["low", "medium", "high"],
|
|
116
|
+
"gpt-6.1-sol": ["low", "medium", "high", "xhigh", "max"],
|
|
117
|
+
"kimi-k3": ["low", "high", "max"],
|
|
118
|
+
},
|
|
119
|
+
"opencode-go": {
|
|
120
|
+
"deepseek-v4.1-flash": ["low", "high", "max"],
|
|
121
|
+
"minimax-m3.1-flash": ["low", "medium", "high", "xhigh", "max"],
|
|
122
|
+
"glm-5.3-flash": ["low", "high", "max"],
|
|
123
|
+
"gemini-4-argon": ["low", "medium", "high"],
|
|
124
|
+
"mimo-v2.6-pro": [],
|
|
125
|
+
"kimi-k3": ["max"],
|
|
126
|
+
},
|
|
127
|
+
};
|
|
128
|
+
const VARIANT_RANK = ["none", "low", "medium", "high", "xhigh", "max"];
|
|
129
|
+
/**
|
|
130
|
+
* Models at or above the sonnet bar on the LiveBench 2.0 board (`providers.md` § LiveBench 2.0
|
|
131
|
+
* board). They keep the agent's own Claude effort on opencode; every other model takes the
|
|
132
|
+
* "OpenCode" ladder, which raises it to the top rung to close the gap to the bar.
|
|
133
|
+
*/
|
|
134
|
+
const OPENCODE_AT_BAR_MODELS = [
|
|
135
|
+
"claude-fable-5.1",
|
|
136
|
+
"gpt-6-astra",
|
|
137
|
+
"claude-opus-5.5",
|
|
138
|
+
"gpt-6.1-sol",
|
|
139
|
+
"claude-sonnet-5.5",
|
|
140
|
+
];
|
|
141
|
+
/** The effort ladder for `model` on opencode: the agent's own for an at-bar model, else "opencode". */
|
|
142
|
+
function opencodeEffortProgram(model) {
|
|
143
|
+
const slug = model.split("/").pop() ?? model;
|
|
144
|
+
return OPENCODE_AT_BAR_MODELS.includes(slug) ? "claude" : "opencode";
|
|
145
|
+
}
|
|
146
|
+
/**
|
|
147
|
+
* The variant to emit for `model` on gateway `provider` at mapped `variant`: the value itself
|
|
148
|
+
* when the model exposes it there, else the highest level it does expose at or under it, else
|
|
149
|
+
* its lowest. A model with no effort control gets null, so no `variant:` line is written.
|
|
150
|
+
*/
|
|
151
|
+
export function clampOpencodeVariant(provider, model, variant) {
|
|
152
|
+
if (!variant)
|
|
153
|
+
return null;
|
|
154
|
+
const gatewayLevels = Object.entries(OPENCODE_VARIANT_LEVELS).find(([gateway]) => gateway === provider)?.[1];
|
|
155
|
+
if (!gatewayLevels)
|
|
156
|
+
return variant;
|
|
157
|
+
const slug = Object.keys(gatewayLevels)
|
|
158
|
+
.sort((a, b) => b.length - a.length)
|
|
159
|
+
.find((key) => model.split("/").pop()?.includes(key) || model.includes(key));
|
|
160
|
+
if (!slug)
|
|
161
|
+
return variant;
|
|
162
|
+
const levels = gatewayLevels[slug];
|
|
163
|
+
if (levels.length === 0)
|
|
164
|
+
return null;
|
|
165
|
+
if (levels.includes(variant))
|
|
166
|
+
return variant;
|
|
167
|
+
const wanted = VARIANT_RANK.indexOf(variant);
|
|
168
|
+
const atOrUnder = levels
|
|
169
|
+
.filter((l) => VARIANT_RANK.indexOf(l) <= wanted)
|
|
170
|
+
.sort((a, b) => VARIANT_RANK.indexOf(b) - VARIANT_RANK.indexOf(a));
|
|
171
|
+
return atOrUnder[0] ?? levels[0];
|
|
172
|
+
}
|
|
92
173
|
/**
|
|
93
174
|
* OC1: opencode agent frontmatter rewrite.
|
|
94
175
|
* Emits: mode, name, description, model, tools (Claude array → opencode object map),
|
|
95
|
-
* variant (the effort table's value for this agent
|
|
96
|
-
*
|
|
97
|
-
*
|
|
98
|
-
*
|
|
99
|
-
*
|
|
100
|
-
*
|
|
101
|
-
*
|
|
102
|
-
*
|
|
103
|
-
*
|
|
176
|
+
* variant (the effort table's value for this agent from the one shared "OpenCode" ladder, or
|
|
177
|
+
* the agent's own Claude effort on an at-bar model, clamped by clampOpencodeVariant to what
|
|
178
|
+
* the pinned model exposes on this gateway). The
|
|
179
|
+
* variant is a SEPARATE field, not a `#`-suffix on the model: 1.x reads `variant:` natively,
|
|
180
|
+
* 2.0 joins `model` + `variant` internally, and a variant joined to the model string with `#`
|
|
181
|
+
* breaks 1.x (its model id lookup keeps the suffix). The ollama gateway is exempt from
|
|
182
|
+
* `variant:` — its provider builds model entries with no variants, so any variant there is a
|
|
183
|
+
* hard 2.0 error; omit it and let opencode use its own default. Drops: Claude-only fields
|
|
184
|
+
* (permissionMode, maxTurns, is_background, readonly) and the original effort field.
|
|
185
|
+
* Hard-fails with non-zero exit if model lookup missing for name.
|
|
104
186
|
*/
|
|
105
187
|
export function applyOpencodeAgent(content, opencodeModelLookup, effortMap, provider) {
|
|
106
188
|
const subagent = requireSubagentModel(content, opencodeModelLookup, "opencode");
|
|
@@ -121,13 +203,14 @@ export function applyOpencodeAgent(content, opencodeModelLookup, effortMap, prov
|
|
|
121
203
|
else {
|
|
122
204
|
newFm += `description: ${description}\n`;
|
|
123
205
|
}
|
|
124
|
-
// Thinking effort is a model variant in its own `variant:` field.
|
|
125
|
-
//
|
|
126
|
-
//
|
|
206
|
+
// Thinking effort is a model variant in its own `variant:` field. Every opencode gateway
|
|
207
|
+
// shares the one "OpenCode" ladder, except that an at-bar model keeps the agent's own
|
|
208
|
+
// effort; the gateway decides only which rungs the pinned model exposes, and ollama
|
|
209
|
+
// carries no variant at all (see the function docstring).
|
|
127
210
|
const modelPin = formatModelPin("opencode", provider ?? "", opencodeModel);
|
|
128
211
|
newFm += `model: ${modelPin}\n`;
|
|
129
212
|
const variant = provider !== "ollama" && effort && effortMap
|
|
130
|
-
? lookupEffort(effortMap,
|
|
213
|
+
? clampOpencodeVariant(provider ?? "", opencodeModel, lookupEffort(effortMap, opencodeEffortProgram(opencodeModel), effort))
|
|
131
214
|
: null;
|
|
132
215
|
if (variant)
|
|
133
216
|
newFm += `variant: ${variant}\n`;
|
|
@@ -436,7 +519,10 @@ export function applyAntigravityPrompt(content, modelLookup, effortMap) {
|
|
|
436
519
|
}
|
|
437
520
|
newFm += `model: ${formatModelPin("antigravity", "google", model)}\n`;
|
|
438
521
|
if (effort && effortMap) {
|
|
439
|
-
|
|
522
|
+
// Same per-model ceiling as opencode's variant: gemini-4-argon stops at `high`, so an
|
|
523
|
+
// xhigh/max agent must not ask Antigravity for a rung the model does not expose.
|
|
524
|
+
const mapped = lookupEffort(effortMap, "antigravity", effort);
|
|
525
|
+
newFm += `effort: ${mapped === "max" && model.includes("gemini-4-argon") ? "high" : mapped}\n`;
|
|
440
526
|
}
|
|
441
527
|
newFm += antigravityToolsBlock(toolsBlock);
|
|
442
528
|
newFm += "---\n";
|
|
@@ -83,8 +83,8 @@ export function lookupLatestPublished(cwd, timeoutS = TIMEOUTS.BKIT_LATEST_LOOKU
|
|
|
83
83
|
const version = (res.stdout ?? "").trim().replace(/^v/, "");
|
|
84
84
|
return SEMVER_RE.test(version) ? version : null;
|
|
85
85
|
}
|
|
86
|
-
/** The
|
|
87
|
-
function
|
|
86
|
+
/** The cache file's registry answer and when it was asked, however old; undefined when unreadable. */
|
|
87
|
+
function readCacheEntry(file) {
|
|
88
88
|
if (!fs.existsSync(file))
|
|
89
89
|
return undefined;
|
|
90
90
|
const parsed = parseJson(fs.readFileSync(file, "utf-8"));
|
|
@@ -94,8 +94,30 @@ function readCache(file, now) {
|
|
|
94
94
|
if (typeof checkedAt !== "number")
|
|
95
95
|
return undefined;
|
|
96
96
|
const value = typeof latest === "string" && SEMVER_RE.test(latest) ? latest : null;
|
|
97
|
-
|
|
98
|
-
|
|
97
|
+
return { latest: value, checkedAt };
|
|
98
|
+
}
|
|
99
|
+
/** The cached registry answer when still fresh: a version, or null for a remembered failure. */
|
|
100
|
+
function readCache(file, now) {
|
|
101
|
+
const entry = readCacheEntry(file);
|
|
102
|
+
if (entry === undefined)
|
|
103
|
+
return undefined;
|
|
104
|
+
const { latest, checkedAt } = entry;
|
|
105
|
+
const ttl = latest === null ? TIMEOUTS.BKIT_LATEST_RETRY_S : TIMEOUTS.BKIT_LATEST_CACHE_S;
|
|
106
|
+
return now - checkedAt < ttl * 1000 && now >= checkedAt ? { latest } : undefined;
|
|
107
|
+
}
|
|
108
|
+
/**
|
|
109
|
+
* True when the release last cached in `gitCommonDir` is newer than this repo's bkit,
|
|
110
|
+
* however old that answer is: a release once seen stays newer until the repo upgrades.
|
|
111
|
+
* Never asks the registry, so local callers (setup tips) can use it, and ignores
|
|
112
|
+
* `NO_UPDATE_CHECK_ENV`: that skips the lookup, while a release already seen stays
|
|
113
|
+
* true. False when the cache or the pin leave nothing to compare.
|
|
114
|
+
*/
|
|
115
|
+
export function cachedBkitOutdated(root, gitCommonDir) {
|
|
116
|
+
const version = readBkitVersion(path.join(root, ".bkit", "version"))?.pinnedVersion || null;
|
|
117
|
+
if (version === null)
|
|
118
|
+
return false;
|
|
119
|
+
const latest = readCacheEntry(path.join(gitCommonDir, BKIT_LATEST_CACHE))?.latest ?? null;
|
|
120
|
+
return latest !== null && compareSemver(version, latest) === -1;
|
|
99
121
|
}
|
|
100
122
|
/** Remember the registry answer; a cache that cannot be written only costs a lookup next run. */
|
|
101
123
|
function writeCache(file, latest, now) {
|
|
@@ -0,0 +1,49 @@
|
|
|
1
|
+
// shared/dep-updater.ts — which dependency updater a repo runs, read from the config files the
|
|
2
|
+
// updater itself reads.
|
|
3
|
+
import * as fs from "node:fs";
|
|
4
|
+
import * as path from "node:path";
|
|
5
|
+
import { readPackageJson } from "./package-json.js";
|
|
6
|
+
export const DEP_UPDATERS = ["renovate", "dependabot"];
|
|
7
|
+
export const DEP_UPDATER_NAMES = {
|
|
8
|
+
renovate: "Renovate",
|
|
9
|
+
dependabot: "Dependabot",
|
|
10
|
+
};
|
|
11
|
+
// Renovate's repository config locations, in its lookup order (docs.renovatebot.com
|
|
12
|
+
// § Configuration options); a `renovate` block in package.json comes last.
|
|
13
|
+
const RENOVATE_FILES = [
|
|
14
|
+
"renovate.json",
|
|
15
|
+
"renovate.jsonc",
|
|
16
|
+
"renovate.json5",
|
|
17
|
+
".github/renovate.json",
|
|
18
|
+
".github/renovate.jsonc",
|
|
19
|
+
".github/renovate.json5",
|
|
20
|
+
".gitlab/renovate.json",
|
|
21
|
+
".gitlab/renovate.jsonc",
|
|
22
|
+
".gitlab/renovate.json5",
|
|
23
|
+
".renovaterc",
|
|
24
|
+
".renovaterc.json",
|
|
25
|
+
".renovaterc.jsonc",
|
|
26
|
+
".renovaterc.json5",
|
|
27
|
+
];
|
|
28
|
+
const DEPENDABOT_FILES = [".github/dependabot.yml", ".github/dependabot.yaml"];
|
|
29
|
+
const firstExisting = (cwd, files) => files.find((f) => fs.existsSync(path.join(cwd, f))) ?? null;
|
|
30
|
+
export function findDepUpdaterConfigs(cwd) {
|
|
31
|
+
let renovate = firstExisting(cwd, RENOVATE_FILES);
|
|
32
|
+
if (!renovate) {
|
|
33
|
+
const read = readPackageJson(cwd);
|
|
34
|
+
const block = read.ok ? read.pkg.renovate : undefined;
|
|
35
|
+
if (block !== null && typeof block === "object" && !Array.isArray(block)) {
|
|
36
|
+
renovate = "package.json";
|
|
37
|
+
}
|
|
38
|
+
}
|
|
39
|
+
return { renovate, dependabot: firstExisting(cwd, DEPENDABOT_FILES) };
|
|
40
|
+
}
|
|
41
|
+
/** The one updater whose config is present; null when there is none, or both. */
|
|
42
|
+
export function detectDepUpdater(cwd) {
|
|
43
|
+
const { renovate, dependabot } = findDepUpdaterConfigs(cwd);
|
|
44
|
+
if (renovate && !dependabot)
|
|
45
|
+
return "renovate";
|
|
46
|
+
if (dependabot && !renovate)
|
|
47
|
+
return "dependabot";
|
|
48
|
+
return null;
|
|
49
|
+
}
|
package/dist/shared/egress.js
CHANGED
|
@@ -10,7 +10,7 @@ export const OPENCODE_PROVIDERS = [
|
|
|
10
10
|
"ollama",
|
|
11
11
|
// opencode-native gateways — two DISTINCT models.dev providers with separate catalogs.
|
|
12
12
|
// CLI: opencode-zen / opencode-go. Agent model pins: opencode/<id> (Zen built-in id) and
|
|
13
|
-
// opencode-go/<id>. Both auth via BKIT_OPENCODE_API_KEY. See providers.md §
|
|
13
|
+
// opencode-go/<id>. Both auth via BKIT_OPENCODE_API_KEY. See providers.md § Provider models.
|
|
14
14
|
"opencode-zen",
|
|
15
15
|
"opencode-go",
|
|
16
16
|
];
|
|
@@ -3,6 +3,12 @@
|
|
|
3
3
|
// bkit installs and upgrades itself with pnpm, so a consumer repo is a pnpm repo.
|
|
4
4
|
// Every command that runs a package script or an install builds the command here,
|
|
5
5
|
// so changing that decision is a change to this file only.
|
|
6
|
+
import * as path from "node:path";
|
|
7
|
+
import { getTemplatesRoot } from "./package-roots.js";
|
|
8
|
+
/** Protect local macOS tests; other platforms keep their original command. */
|
|
9
|
+
export const testCommand = (argv, platform = process.platform) => platform === "darwin"
|
|
10
|
+
? [process.execPath, path.join(getTemplatesRoot(), "scripts/ci/bkit-test-awake.mjs"), ...argv]
|
|
11
|
+
: argv;
|
|
6
12
|
/** The package manager that runs `package.json` scripts and installs. */
|
|
7
13
|
export const PACKAGE_RUNNER = "pnpm";
|
|
8
14
|
/** argv for running one `package.json` script, e.g. `bkit:gate:static-unit`. */
|
package/dist/shared/settings.js
CHANGED
|
@@ -4,6 +4,7 @@
|
|
|
4
4
|
// a check name, or an app folder.
|
|
5
5
|
import { DEFAULT_CLOUD_AGENTS, DEFAULT_ISSUE_TRACKER, parseCloudAgents, parseIssueTracker, } from "../install/manifest.js";
|
|
6
6
|
import { isOpencodeProvider } from "../render/models.js";
|
|
7
|
+
import { DEP_UPDATERS } from "./dep-updater.js";
|
|
7
8
|
import { readPackageJson } from "./package-json.js";
|
|
8
9
|
const BOARD_URL = /^https:\/\/github\.com\/(orgs|users)\/([^/?#\s]+)\/projects\/([1-9][0-9]*)(?:[/?#].*)?$/;
|
|
9
10
|
/** The board a `https://github.com/{orgs|users}/<login>/projects/<n>[/views/…]` URL names; null otherwise. */
|
|
@@ -25,6 +26,19 @@ export const ASK_POINTS = [
|
|
|
25
26
|
];
|
|
26
27
|
/** The limit key a point's block holds. */
|
|
27
28
|
export const limitKey = (point) => point === "design.grill" ? "maxTurns" : "maxAttempts";
|
|
29
|
+
/**
|
|
30
|
+
* The `{job}/{step}` CI steps of bkit's `bkit-ci.yml` template whose failure a
|
|
31
|
+
* `bkit:generate` fixes: the capability register and the mirror drift check. Always
|
|
32
|
+
* counted; `bkit.testing.ciGenerated` adds to it and cannot remove it.
|
|
33
|
+
*/
|
|
34
|
+
export const CI_GENERATED_FLOOR = [
|
|
35
|
+
"bkit-tests-static/Check Capability Register",
|
|
36
|
+
"bkit-tests-static/Run bkit Check",
|
|
37
|
+
];
|
|
38
|
+
/** The CI steps ship regenerates for: the floor plus the repo's `bkit.testing.ciGenerated`. */
|
|
39
|
+
export const ciGeneratedSteps = (cfg) => [
|
|
40
|
+
...new Set([...CI_GENERATED_FLOOR, ...cfg.ciGenerated]),
|
|
41
|
+
];
|
|
28
42
|
export const CONFIG_DEFAULTS = {
|
|
29
43
|
ciWorkflow: "bkit-ci.yml",
|
|
30
44
|
capstoneJob: "bkit-tests-check",
|
|
@@ -37,10 +51,12 @@ export const CONFIG_DEFAULTS = {
|
|
|
37
51
|
// `started` is a state type every Linear team has; In Review is a name a default team lacks.
|
|
38
52
|
linear: { team: null, project: null, progress: "started", review: "In Review" },
|
|
39
53
|
jira: { site: null, project: null, progress: "In Progress", review: "In Review" },
|
|
40
|
-
|
|
41
|
-
//
|
|
42
|
-
//
|
|
43
|
-
minPushPaths: [
|
|
54
|
+
ciRequired: [],
|
|
55
|
+
// Nothing beyond what bkit writes. Never seed `docs/**`: a project doc can be a test's
|
|
56
|
+
// input, so a docs edit can red a test; a repo that knows its tests opts in.
|
|
57
|
+
minPushPaths: [],
|
|
58
|
+
ciSkipPaths: [],
|
|
59
|
+
ciGenerated: [],
|
|
44
60
|
opencodeProvider: null,
|
|
45
61
|
opencodeProviders: [],
|
|
46
62
|
cloudAgents: DEFAULT_CLOUD_AGENTS,
|
|
@@ -55,8 +71,9 @@ export const CONFIG_DEFAULTS = {
|
|
|
55
71
|
"ship.merge": { ask: true, max: 2 },
|
|
56
72
|
},
|
|
57
73
|
// Plan caps, `.bkit/workflows.md` § Test-first.
|
|
58
|
-
tasks: { maxPerGroup:
|
|
59
|
-
|
|
74
|
+
tasks: { maxPerGroup: 5, maxTestsPerGroup: 25, maxTestsPerTask: 10, maxTestFilesPerTask: 3 },
|
|
75
|
+
buildPublish: { remote: true, local: true },
|
|
76
|
+
depUpdater: null,
|
|
60
77
|
issueTrackerExplicit: false,
|
|
61
78
|
cloudAgentsExplicit: false,
|
|
62
79
|
};
|
|
@@ -70,6 +87,7 @@ function trackerStates(raw, defaults) {
|
|
|
70
87
|
review: nonEmptyString(raw.review) ? raw.review.trim() : defaults.review,
|
|
71
88
|
};
|
|
72
89
|
}
|
|
90
|
+
const parseDepUpdater = (v) => v === "none" || DEP_UPDATERS.includes(v) ? v : null;
|
|
73
91
|
const TASK_CAP_KEYS = Object.keys(CONFIG_DEFAULTS.tasks);
|
|
74
92
|
const validCap = (v) => Number.isInteger(v) && v >= 1;
|
|
75
93
|
/**
|
|
@@ -84,6 +102,33 @@ export function invalidTaskCaps(raw) {
|
|
|
84
102
|
const set = raw;
|
|
85
103
|
return TASK_CAP_KEYS.filter((k) => set[k] !== undefined && !validCap(set[k]));
|
|
86
104
|
}
|
|
105
|
+
/**
|
|
106
|
+
* The dotted keys of a `bkit.workflows.build` value that fall back to their default:
|
|
107
|
+
* `build` when set but not an object, `build.publish` when set but not an object,
|
|
108
|
+
* `build.publish.local` when set but not a boolean. `remote` is never listed: the
|
|
109
|
+
* preflight advisory `bkit-build-publish-remote` owns it.
|
|
110
|
+
*/
|
|
111
|
+
export function invalidBuildPublish(raw) {
|
|
112
|
+
if (raw === undefined)
|
|
113
|
+
return [];
|
|
114
|
+
if (raw === null || typeof raw !== "object" || Array.isArray(raw))
|
|
115
|
+
return ["build"];
|
|
116
|
+
const publish = raw.publish;
|
|
117
|
+
if (publish === undefined)
|
|
118
|
+
return [];
|
|
119
|
+
if (publish === null || typeof publish !== "object" || Array.isArray(publish))
|
|
120
|
+
return ["build.publish"];
|
|
121
|
+
const local = publish.local;
|
|
122
|
+
return local !== undefined && typeof local !== "boolean" ? ["build.publish.local"] : [];
|
|
123
|
+
}
|
|
124
|
+
/** `bkit.workflows.build.publish`; `remote` always resolves `true`. */
|
|
125
|
+
function buildPublish(raw) {
|
|
126
|
+
const { local } = record(raw);
|
|
127
|
+
return {
|
|
128
|
+
remote: true,
|
|
129
|
+
local: typeof local === "boolean" ? local : CONFIG_DEFAULTS.buildPublish.local,
|
|
130
|
+
};
|
|
131
|
+
}
|
|
87
132
|
/** `bkit.workflows.tasks` read key by key; a missing or invalid key takes its default. */
|
|
88
133
|
function taskCaps(raw) {
|
|
89
134
|
const set = record(raw);
|
|
@@ -153,9 +198,11 @@ export function readBkitConfig(root) {
|
|
|
153
198
|
const testing = record(bkit.testing);
|
|
154
199
|
const workflows = record(bkit.workflows);
|
|
155
200
|
const worktree = record(workflows.worktree);
|
|
201
|
+
const ciSkip = testing.ciSkipPaths;
|
|
202
|
+
const generated = testing.ciGenerated;
|
|
156
203
|
const copy = worktree.copy;
|
|
157
204
|
const minFreeGb = workflows.minFreeGb;
|
|
158
|
-
const lanes = testing.
|
|
205
|
+
const lanes = testing.ciRequired;
|
|
159
206
|
const book = testing.minPushPaths;
|
|
160
207
|
const provider = opencode.default;
|
|
161
208
|
const providers = opencode.installed;
|
|
@@ -193,11 +240,12 @@ export function readBkitConfig(root) {
|
|
|
193
240
|
project: optionalString(jira.project),
|
|
194
241
|
...trackerStates(jira, CONFIG_DEFAULTS.jira),
|
|
195
242
|
},
|
|
196
|
-
|
|
197
|
-
// An explicit [] is kept: it switches the min push off.
|
|
243
|
+
ciRequired: Array.isArray(lanes) ? lanes.filter(nonEmptyString) : [],
|
|
198
244
|
minPushPaths: Array.isArray(book)
|
|
199
245
|
? book.filter(nonEmptyString)
|
|
200
246
|
: [...CONFIG_DEFAULTS.minPushPaths],
|
|
247
|
+
ciSkipPaths: Array.isArray(ciSkip) ? ciSkip.filter(nonEmptyString) : [],
|
|
248
|
+
ciGenerated: Array.isArray(generated) ? generated.filter(nonEmptyString) : [],
|
|
201
249
|
opencodeProvider: typeof provider === "string" && isOpencodeProvider(provider) ? provider : null,
|
|
202
250
|
opencodeProviders: Array.isArray(providers)
|
|
203
251
|
? providers.filter((v) => typeof v === "string" && isOpencodeProvider(v))
|
|
@@ -205,7 +253,8 @@ export function readBkitConfig(root) {
|
|
|
205
253
|
cloudAgents: parseCloudAgents(cloud.agent) ?? CONFIG_DEFAULTS.cloudAgents,
|
|
206
254
|
asks: askSettings(workflows),
|
|
207
255
|
tasks: taskCaps(workflows.tasks),
|
|
208
|
-
|
|
256
|
+
buildPublish: buildPublish(record(workflows.build).publish),
|
|
257
|
+
depUpdater: parseDepUpdater(record(bkit.dependencies).updater),
|
|
209
258
|
issueTrackerExplicit: tracker.default !== undefined && tracker.default !== "",
|
|
210
259
|
cloudAgentsExplicit: cloud.agent !== undefined && cloud.agent !== "",
|
|
211
260
|
};
|
package/dist/shared/timeouts.js
CHANGED
|
@@ -23,4 +23,6 @@ export const TIMEOUTS = {
|
|
|
23
23
|
BKIT_LATEST_RETRY_S: 3600,
|
|
24
24
|
/** Seconds the registry lookup may take before it counts as failed. */
|
|
25
25
|
BKIT_LATEST_LOOKUP_TIMEOUT_S: 5,
|
|
26
|
+
/** Seconds `worktrees setup` waits for a running disk sweep before refusing; under one agent shell call. */
|
|
27
|
+
DISK_SETUP_SWEEP_WAIT_S: 60,
|
|
26
28
|
};
|