@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
|
@@ -3,6 +3,7 @@
|
|
|
3
3
|
|
|
4
4
|
import { type EffortMap, formatModelPin, lookupEffort } from "./models.js";
|
|
5
5
|
import { LOG_PREFIX } from "../shared/log-prefix.js";
|
|
6
|
+
import type { OpencodeProvider } from "../shared/egress.js";
|
|
6
7
|
|
|
7
8
|
/**
|
|
8
9
|
* Convert a Claude `tools:` frontmatter block (a YAML array of capitalized tool names,
|
|
@@ -86,18 +87,109 @@ export function antigravityToolsBlock(toolsBlock: string | null): string {
|
|
|
86
87
|
return out;
|
|
87
88
|
}
|
|
88
89
|
|
|
90
|
+
/**
|
|
91
|
+
* Thinking-effort values each model exposes on each variant-carrying opencode gateway
|
|
92
|
+
* (`reasoning_options` effort values in models.dev, read 2026-10-28; models.dev provider
|
|
93
|
+
* `opencode` = bkit key `opencode-zen`). One model can differ per gateway — `deepseek-v4.1-flash`
|
|
94
|
+
* has `none` on OpenRouter only — and OpenCode hard-errors on a `variant:` the model does not
|
|
95
|
+
* expose there. An empty list = `toggle`-only or no reasoning options: no effort variant at all.
|
|
96
|
+
* ollama has no entry: it carries no variant on any model (applyOpencodeAgent skips it). An
|
|
97
|
+
* unlisted gateway or model passes the mapped value through unchanged.
|
|
98
|
+
*/
|
|
99
|
+
const OPENCODE_VARIANT_LEVELS: Record<
|
|
100
|
+
Exclude<OpencodeProvider, "ollama">,
|
|
101
|
+
Record<string, string[]>
|
|
102
|
+
> = {
|
|
103
|
+
openrouter: {
|
|
104
|
+
"deepseek-v4.1-flash": ["none", "low", "high", "max"],
|
|
105
|
+
"minimax-m3.1-flash": ["low", "medium", "high", "xhigh", "max"],
|
|
106
|
+
"glm-5.3-flash": ["low", "high", "max"],
|
|
107
|
+
"gemini-4-argon": ["low", "medium", "high"],
|
|
108
|
+
"gpt-6.1-sol": ["low", "medium", "high", "xhigh", "max"],
|
|
109
|
+
"mimo-v2.6-pro": [],
|
|
110
|
+
"kimi-k3": ["none", "low", "high", "max"],
|
|
111
|
+
},
|
|
112
|
+
"opencode-zen": {
|
|
113
|
+
"deepseek-v4.1-flash": ["low", "high", "max"],
|
|
114
|
+
"minimax-m3.1-flash": ["low", "medium", "high", "xhigh", "max"],
|
|
115
|
+
"glm-5.3-flash": ["low", "high", "max"],
|
|
116
|
+
"gemini-4-argon": ["low", "medium", "high"],
|
|
117
|
+
"gpt-6.1-sol": ["low", "medium", "high", "xhigh", "max"],
|
|
118
|
+
"kimi-k3": ["low", "high", "max"],
|
|
119
|
+
},
|
|
120
|
+
"opencode-go": {
|
|
121
|
+
"deepseek-v4.1-flash": ["low", "high", "max"],
|
|
122
|
+
"minimax-m3.1-flash": ["low", "medium", "high", "xhigh", "max"],
|
|
123
|
+
"glm-5.3-flash": ["low", "high", "max"],
|
|
124
|
+
"gemini-4-argon": ["low", "medium", "high"],
|
|
125
|
+
"mimo-v2.6-pro": [],
|
|
126
|
+
"kimi-k3": ["max"],
|
|
127
|
+
},
|
|
128
|
+
};
|
|
129
|
+
|
|
130
|
+
const VARIANT_RANK = ["none", "low", "medium", "high", "xhigh", "max"];
|
|
131
|
+
|
|
132
|
+
/**
|
|
133
|
+
* Models at or above the sonnet bar on the LiveBench 2.0 board (`providers.md` § LiveBench 2.0
|
|
134
|
+
* board). They keep the agent's own Claude effort on opencode; every other model takes the
|
|
135
|
+
* "OpenCode" ladder, which raises it to the top rung to close the gap to the bar.
|
|
136
|
+
*/
|
|
137
|
+
const OPENCODE_AT_BAR_MODELS = [
|
|
138
|
+
"claude-fable-5.1",
|
|
139
|
+
"gpt-6-astra",
|
|
140
|
+
"claude-opus-5.5",
|
|
141
|
+
"gpt-6.1-sol",
|
|
142
|
+
"claude-sonnet-5.5",
|
|
143
|
+
];
|
|
144
|
+
|
|
145
|
+
/** The effort ladder for `model` on opencode: the agent's own for an at-bar model, else "opencode". */
|
|
146
|
+
function opencodeEffortProgram(model: string): string {
|
|
147
|
+
const slug = model.split("/").pop() ?? model;
|
|
148
|
+
return OPENCODE_AT_BAR_MODELS.includes(slug) ? "claude" : "opencode";
|
|
149
|
+
}
|
|
150
|
+
|
|
151
|
+
/**
|
|
152
|
+
* The variant to emit for `model` on gateway `provider` at mapped `variant`: the value itself
|
|
153
|
+
* when the model exposes it there, else the highest level it does expose at or under it, else
|
|
154
|
+
* its lowest. A model with no effort control gets null, so no `variant:` line is written.
|
|
155
|
+
*/
|
|
156
|
+
export function clampOpencodeVariant(
|
|
157
|
+
provider: string,
|
|
158
|
+
model: string,
|
|
159
|
+
variant: string | null,
|
|
160
|
+
): string | null {
|
|
161
|
+
if (!variant) return null;
|
|
162
|
+
const gatewayLevels = Object.entries(OPENCODE_VARIANT_LEVELS).find(
|
|
163
|
+
([gateway]) => gateway === provider,
|
|
164
|
+
)?.[1];
|
|
165
|
+
if (!gatewayLevels) return variant;
|
|
166
|
+
const slug = Object.keys(gatewayLevels)
|
|
167
|
+
.sort((a, b) => b.length - a.length)
|
|
168
|
+
.find((key) => model.split("/").pop()?.includes(key) || model.includes(key));
|
|
169
|
+
if (!slug) return variant;
|
|
170
|
+
const levels = gatewayLevels[slug];
|
|
171
|
+
if (levels.length === 0) return null;
|
|
172
|
+
if (levels.includes(variant)) return variant;
|
|
173
|
+
const wanted = VARIANT_RANK.indexOf(variant);
|
|
174
|
+
const atOrUnder = levels
|
|
175
|
+
.filter((l) => VARIANT_RANK.indexOf(l) <= wanted)
|
|
176
|
+
.sort((a, b) => VARIANT_RANK.indexOf(b) - VARIANT_RANK.indexOf(a));
|
|
177
|
+
return atOrUnder[0] ?? levels[0];
|
|
178
|
+
}
|
|
179
|
+
|
|
89
180
|
/**
|
|
90
181
|
* OC1: opencode agent frontmatter rewrite.
|
|
91
182
|
* Emits: mode, name, description, model, tools (Claude array → opencode object map),
|
|
92
|
-
* variant (the effort table's value for this agent
|
|
93
|
-
*
|
|
94
|
-
*
|
|
95
|
-
*
|
|
96
|
-
*
|
|
97
|
-
*
|
|
98
|
-
*
|
|
99
|
-
*
|
|
100
|
-
*
|
|
183
|
+
* variant (the effort table's value for this agent from the one shared "OpenCode" ladder, or
|
|
184
|
+
* the agent's own Claude effort on an at-bar model, clamped by clampOpencodeVariant to what
|
|
185
|
+
* the pinned model exposes on this gateway). The
|
|
186
|
+
* variant is a SEPARATE field, not a `#`-suffix on the model: 1.x reads `variant:` natively,
|
|
187
|
+
* 2.0 joins `model` + `variant` internally, and a variant joined to the model string with `#`
|
|
188
|
+
* breaks 1.x (its model id lookup keeps the suffix). The ollama gateway is exempt from
|
|
189
|
+
* `variant:` — its provider builds model entries with no variants, so any variant there is a
|
|
190
|
+
* hard 2.0 error; omit it and let opencode use its own default. Drops: Claude-only fields
|
|
191
|
+
* (permissionMode, maxTurns, is_background, readonly) and the original effort field.
|
|
192
|
+
* Hard-fails with non-zero exit if model lookup missing for name.
|
|
101
193
|
*/
|
|
102
194
|
export function applyOpencodeAgent(
|
|
103
195
|
content: string,
|
|
@@ -123,14 +215,19 @@ export function applyOpencodeAgent(
|
|
|
123
215
|
} else {
|
|
124
216
|
newFm += `description: ${description}\n`;
|
|
125
217
|
}
|
|
126
|
-
// Thinking effort is a model variant in its own `variant:` field.
|
|
127
|
-
//
|
|
128
|
-
//
|
|
218
|
+
// Thinking effort is a model variant in its own `variant:` field. Every opencode gateway
|
|
219
|
+
// shares the one "OpenCode" ladder, except that an at-bar model keeps the agent's own
|
|
220
|
+
// effort; the gateway decides only which rungs the pinned model exposes, and ollama
|
|
221
|
+
// carries no variant at all (see the function docstring).
|
|
129
222
|
const modelPin = formatModelPin("opencode", provider ?? "", opencodeModel);
|
|
130
223
|
newFm += `model: ${modelPin}\n`;
|
|
131
224
|
const variant =
|
|
132
225
|
provider !== "ollama" && effort && effortMap
|
|
133
|
-
?
|
|
226
|
+
? clampOpencodeVariant(
|
|
227
|
+
provider ?? "",
|
|
228
|
+
opencodeModel,
|
|
229
|
+
lookupEffort(effortMap, opencodeEffortProgram(opencodeModel), effort),
|
|
230
|
+
)
|
|
134
231
|
: null;
|
|
135
232
|
if (variant) newFm += `variant: ${variant}\n`;
|
|
136
233
|
newFm += opencodeToolsBlock(toolsBlock);
|
|
@@ -494,7 +591,10 @@ export function applyAntigravityPrompt(
|
|
|
494
591
|
}
|
|
495
592
|
newFm += `model: ${formatModelPin("antigravity", "google", model)}\n`;
|
|
496
593
|
if (effort && effortMap) {
|
|
497
|
-
|
|
594
|
+
// Same per-model ceiling as opencode's variant: gemini-4-argon stops at `high`, so an
|
|
595
|
+
// xhigh/max agent must not ask Antigravity for a rung the model does not expose.
|
|
596
|
+
const mapped = lookupEffort(effortMap, "antigravity", effort);
|
|
597
|
+
newFm += `effort: ${mapped === "max" && model.includes("gemini-4-argon") ? "high" : mapped}\n`;
|
|
498
598
|
}
|
|
499
599
|
newFm += antigravityToolsBlock(toolsBlock);
|
|
500
600
|
newFm += "---\n";
|
|
@@ -99,16 +99,38 @@ export interface BkitLatestDeps {
|
|
|
99
99
|
lookup?: (cwd: string) => string | null;
|
|
100
100
|
}
|
|
101
101
|
|
|
102
|
-
/** The
|
|
103
|
-
function
|
|
102
|
+
/** The cache file's registry answer and when it was asked, however old; undefined when unreadable. */
|
|
103
|
+
function readCacheEntry(file: string): { latest: string | null; checkedAt: number } | undefined {
|
|
104
104
|
if (!fs.existsSync(file)) return undefined;
|
|
105
105
|
const parsed = parseJson(fs.readFileSync(file, "utf-8"));
|
|
106
106
|
if (!parsed.ok || typeof parsed.value !== "object" || parsed.value === null) return undefined;
|
|
107
107
|
const { latest, checkedAt } = parsed.value as { latest?: unknown; checkedAt?: unknown };
|
|
108
108
|
if (typeof checkedAt !== "number") return undefined;
|
|
109
109
|
const value = typeof latest === "string" && SEMVER_RE.test(latest) ? latest : null;
|
|
110
|
-
|
|
111
|
-
|
|
110
|
+
return { latest: value, checkedAt };
|
|
111
|
+
}
|
|
112
|
+
|
|
113
|
+
/** The cached registry answer when still fresh: a version, or null for a remembered failure. */
|
|
114
|
+
function readCache(file: string, now: number): { latest: string | null } | undefined {
|
|
115
|
+
const entry = readCacheEntry(file);
|
|
116
|
+
if (entry === undefined) return undefined;
|
|
117
|
+
const { latest, checkedAt } = entry;
|
|
118
|
+
const ttl = latest === null ? TIMEOUTS.BKIT_LATEST_RETRY_S : TIMEOUTS.BKIT_LATEST_CACHE_S;
|
|
119
|
+
return now - checkedAt < ttl * 1000 && now >= checkedAt ? { latest } : undefined;
|
|
120
|
+
}
|
|
121
|
+
|
|
122
|
+
/**
|
|
123
|
+
* True when the release last cached in `gitCommonDir` is newer than this repo's bkit,
|
|
124
|
+
* however old that answer is: a release once seen stays newer until the repo upgrades.
|
|
125
|
+
* Never asks the registry, so local callers (setup tips) can use it, and ignores
|
|
126
|
+
* `NO_UPDATE_CHECK_ENV`: that skips the lookup, while a release already seen stays
|
|
127
|
+
* true. False when the cache or the pin leave nothing to compare.
|
|
128
|
+
*/
|
|
129
|
+
export function cachedBkitOutdated(root: string, gitCommonDir: string): boolean {
|
|
130
|
+
const version = readBkitVersion(path.join(root, ".bkit", "version"))?.pinnedVersion || null;
|
|
131
|
+
if (version === null) return false;
|
|
132
|
+
const latest = readCacheEntry(path.join(gitCommonDir, BKIT_LATEST_CACHE))?.latest ?? null;
|
|
133
|
+
return latest !== null && compareSemver(version, latest) === -1;
|
|
112
134
|
}
|
|
113
135
|
|
|
114
136
|
/** Remember the registry answer; a cache that cannot be written only costs a lookup next run. */
|
|
@@ -0,0 +1,60 @@
|
|
|
1
|
+
// shared/dep-updater.ts — which dependency updater a repo runs, read from the config files the
|
|
2
|
+
// updater itself reads.
|
|
3
|
+
|
|
4
|
+
import * as fs from "node:fs";
|
|
5
|
+
import * as path from "node:path";
|
|
6
|
+
import { readPackageJson } from "./package-json.js";
|
|
7
|
+
|
|
8
|
+
export const DEP_UPDATERS = ["renovate", "dependabot"] as const;
|
|
9
|
+
export type DepUpdater = (typeof DEP_UPDATERS)[number];
|
|
10
|
+
|
|
11
|
+
export const DEP_UPDATER_NAMES: Readonly<Record<DepUpdater, string>> = {
|
|
12
|
+
renovate: "Renovate",
|
|
13
|
+
dependabot: "Dependabot",
|
|
14
|
+
};
|
|
15
|
+
|
|
16
|
+
// Renovate's repository config locations, in its lookup order (docs.renovatebot.com
|
|
17
|
+
// § Configuration options); a `renovate` block in package.json comes last.
|
|
18
|
+
const RENOVATE_FILES = [
|
|
19
|
+
"renovate.json",
|
|
20
|
+
"renovate.jsonc",
|
|
21
|
+
"renovate.json5",
|
|
22
|
+
".github/renovate.json",
|
|
23
|
+
".github/renovate.jsonc",
|
|
24
|
+
".github/renovate.json5",
|
|
25
|
+
".gitlab/renovate.json",
|
|
26
|
+
".gitlab/renovate.jsonc",
|
|
27
|
+
".gitlab/renovate.json5",
|
|
28
|
+
".renovaterc",
|
|
29
|
+
".renovaterc.json",
|
|
30
|
+
".renovaterc.jsonc",
|
|
31
|
+
".renovaterc.json5",
|
|
32
|
+
];
|
|
33
|
+
|
|
34
|
+
const DEPENDABOT_FILES = [".github/dependabot.yml", ".github/dependabot.yaml"];
|
|
35
|
+
|
|
36
|
+
/** Each updater's config, as a path relative to `cwd`; null when absent. */
|
|
37
|
+
export type DepUpdaterConfigs = Record<DepUpdater, string | null>;
|
|
38
|
+
|
|
39
|
+
const firstExisting = (cwd: string, files: string[]): string | null =>
|
|
40
|
+
files.find((f) => fs.existsSync(path.join(cwd, f))) ?? null;
|
|
41
|
+
|
|
42
|
+
export function findDepUpdaterConfigs(cwd: string): DepUpdaterConfigs {
|
|
43
|
+
let renovate = firstExisting(cwd, RENOVATE_FILES);
|
|
44
|
+
if (!renovate) {
|
|
45
|
+
const read = readPackageJson(cwd);
|
|
46
|
+
const block = read.ok ? read.pkg.renovate : undefined;
|
|
47
|
+
if (block !== null && typeof block === "object" && !Array.isArray(block)) {
|
|
48
|
+
renovate = "package.json";
|
|
49
|
+
}
|
|
50
|
+
}
|
|
51
|
+
return { renovate, dependabot: firstExisting(cwd, DEPENDABOT_FILES) };
|
|
52
|
+
}
|
|
53
|
+
|
|
54
|
+
/** The one updater whose config is present; null when there is none, or both. */
|
|
55
|
+
export function detectDepUpdater(cwd: string): DepUpdater | null {
|
|
56
|
+
const { renovate, dependabot } = findDepUpdaterConfigs(cwd);
|
|
57
|
+
if (renovate && !dependabot) return "renovate";
|
|
58
|
+
if (dependabot && !renovate) return "dependabot";
|
|
59
|
+
return null;
|
|
60
|
+
}
|
|
@@ -11,7 +11,7 @@ export const OPENCODE_PROVIDERS = [
|
|
|
11
11
|
"ollama",
|
|
12
12
|
// opencode-native gateways — two DISTINCT models.dev providers with separate catalogs.
|
|
13
13
|
// CLI: opencode-zen / opencode-go. Agent model pins: opencode/<id> (Zen built-in id) and
|
|
14
|
-
// opencode-go/<id>. Both auth via BKIT_OPENCODE_API_KEY. See providers.md §
|
|
14
|
+
// opencode-go/<id>. Both auth via BKIT_OPENCODE_API_KEY. See providers.md § Provider models.
|
|
15
15
|
"opencode-zen",
|
|
16
16
|
"opencode-go",
|
|
17
17
|
] as const;
|
|
@@ -4,6 +4,15 @@
|
|
|
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
6
|
|
|
7
|
+
import * as path from "node:path";
|
|
8
|
+
import { getTemplatesRoot } from "./package-roots.js";
|
|
9
|
+
|
|
10
|
+
/** Protect local macOS tests; other platforms keep their original command. */
|
|
11
|
+
export const testCommand = (argv: string[], platform: string = process.platform): string[] =>
|
|
12
|
+
platform === "darwin"
|
|
13
|
+
? [process.execPath, path.join(getTemplatesRoot(), "scripts/ci/bkit-test-awake.mjs"), ...argv]
|
|
14
|
+
: argv;
|
|
15
|
+
|
|
7
16
|
/** The package manager that runs `package.json` scripts and installs. */
|
|
8
17
|
export const PACKAGE_RUNNER = "pnpm";
|
|
9
18
|
|
|
@@ -12,6 +12,7 @@ import {
|
|
|
12
12
|
type IssueTracker,
|
|
13
13
|
} from "../install/manifest.js";
|
|
14
14
|
import { isOpencodeProvider } from "../render/models.js";
|
|
15
|
+
import { DEP_UPDATERS, type DepUpdater } from "./dep-updater.js";
|
|
15
16
|
import type { OpencodeProvider } from "./egress.js";
|
|
16
17
|
import { readPackageJson } from "./package-json.js";
|
|
17
18
|
|
|
@@ -63,11 +64,19 @@ export interface JiraConfig extends TrackerStates {
|
|
|
63
64
|
project: string | null;
|
|
64
65
|
}
|
|
65
66
|
|
|
67
|
+
/** `bkit.workflows.build.publish`: whether a build ends by publishing (push, PR) or holds. */
|
|
68
|
+
export interface BuildPublish {
|
|
69
|
+
/** Always `true`: a non-local runtime always publishes. */
|
|
70
|
+
remote: true;
|
|
71
|
+
/** `false` holds a local build: nothing is pushed, the worktree is kept. */
|
|
72
|
+
local: boolean;
|
|
73
|
+
}
|
|
74
|
+
|
|
66
75
|
/** `bkit.workflows.tasks`: the plan caps `tests plan-check` and `challenge merge` enforce. */
|
|
67
76
|
export interface TaskCaps {
|
|
68
|
-
/** Tasks in one
|
|
77
|
+
/** Tasks in one task group. */
|
|
69
78
|
maxPerGroup: number;
|
|
70
|
-
/** Planned TEST FIRST tests in one
|
|
79
|
+
/** Planned TEST FIRST tests in one task group. */
|
|
71
80
|
maxTestsPerGroup: number;
|
|
72
81
|
/** TEST FIRST tests one task names. */
|
|
73
82
|
maxTestsPerTask: number;
|
|
@@ -119,12 +128,25 @@ export interface BkitConfig {
|
|
|
119
128
|
/** `bkit.jira`. */
|
|
120
129
|
jira: JiraConfig;
|
|
121
130
|
/** CI lanes whose `skipped` conclusion refuses a ship merge; empty = the capstone's green decides. */
|
|
122
|
-
|
|
131
|
+
ciRequired: string[];
|
|
123
132
|
/**
|
|
124
|
-
* Globs (`:(glob)` git pathspecs) for paths a push may carry
|
|
125
|
-
*
|
|
133
|
+
* Globs (`:(glob)` git pathspecs) for paths a push may carry, on top of what bkit's
|
|
134
|
+
* workflows write (ship's bookkeeping allow-list, `docs/plans/**`, `ciSkipPaths`), and
|
|
135
|
+
* still run only `bkit:gate:min` in `.husky/pre-push`; empty = that floor alone.
|
|
126
136
|
*/
|
|
127
137
|
minPushPaths: string[];
|
|
138
|
+
/**
|
|
139
|
+
* Globs (`:(glob)` git pathspecs) for the project docs ship's `[skip ci]` bookkeeping
|
|
140
|
+
* commit may carry onto the PR without a CI run, beyond the frozen allow-list
|
|
141
|
+
* (`bkit.testing.ciSkipPaths`, e.g. `CHANGELOG.md`, `README.md`); empty = none.
|
|
142
|
+
*/
|
|
143
|
+
ciSkipPaths: string[];
|
|
144
|
+
/**
|
|
145
|
+
* `{job}/{step}` CI steps whose failure `bkit:generate` fixes, on top of
|
|
146
|
+
* `CI_GENERATED_FLOOR`: ship regenerates instead of failing when every failed step is
|
|
147
|
+
* on the list (`bkit.testing.ciGenerated`); empty = that floor alone.
|
|
148
|
+
*/
|
|
149
|
+
ciGenerated: string[];
|
|
128
150
|
/** The opencode provider recorded on install; null = absent or not a supported provider. */
|
|
129
151
|
opencodeProvider: OpencodeProvider | null;
|
|
130
152
|
/** Every installed opencode provider, supported ones only; empty = none recorded. */
|
|
@@ -135,14 +157,31 @@ export interface BkitConfig {
|
|
|
135
157
|
asks: Record<AskPoint, AskSetting>;
|
|
136
158
|
/** Plan caps; each key that is not an integer >= 1 takes its default. */
|
|
137
159
|
tasks: TaskCaps;
|
|
138
|
-
/** `
|
|
139
|
-
|
|
160
|
+
/** Build ending; `remote` is always `true`, `local` defaults `true`. */
|
|
161
|
+
buildPublish: BuildPublish;
|
|
162
|
+
/** `bkit.dependencies.updater`: the updater the repo runs, or `none`; null = absent, `""` or unrecognised. */
|
|
163
|
+
depUpdater: DepUpdater | "none" | null;
|
|
140
164
|
/** `bkit.tracker.default` is set, so `none` is a choice; absent or `""` (what install seeds) = undecided. */
|
|
141
165
|
issueTrackerExplicit: boolean;
|
|
142
166
|
/** `bkit.cloud.agent` is set, so `none` is a choice; absent or `""` (what install seeds) = undecided. */
|
|
143
167
|
cloudAgentsExplicit: boolean;
|
|
144
168
|
}
|
|
145
169
|
|
|
170
|
+
/**
|
|
171
|
+
* The `{job}/{step}` CI steps of bkit's `bkit-ci.yml` template whose failure a
|
|
172
|
+
* `bkit:generate` fixes: the capability register and the mirror drift check. Always
|
|
173
|
+
* counted; `bkit.testing.ciGenerated` adds to it and cannot remove it.
|
|
174
|
+
*/
|
|
175
|
+
export const CI_GENERATED_FLOOR: readonly string[] = [
|
|
176
|
+
"bkit-tests-static/Check Capability Register",
|
|
177
|
+
"bkit-tests-static/Run bkit Check",
|
|
178
|
+
];
|
|
179
|
+
|
|
180
|
+
/** The CI steps ship regenerates for: the floor plus the repo's `bkit.testing.ciGenerated`. */
|
|
181
|
+
export const ciGeneratedSteps = (cfg: Pick<BkitConfig, "ciGenerated">): string[] => [
|
|
182
|
+
...new Set([...CI_GENERATED_FLOOR, ...cfg.ciGenerated]),
|
|
183
|
+
];
|
|
184
|
+
|
|
146
185
|
export const CONFIG_DEFAULTS: Readonly<BkitConfig> = {
|
|
147
186
|
ciWorkflow: "bkit-ci.yml",
|
|
148
187
|
capstoneJob: "bkit-tests-check",
|
|
@@ -155,10 +194,12 @@ export const CONFIG_DEFAULTS: Readonly<BkitConfig> = {
|
|
|
155
194
|
// `started` is a state type every Linear team has; In Review is a name a default team lacks.
|
|
156
195
|
linear: { team: null, project: null, progress: "started", review: "In Review" },
|
|
157
196
|
jira: { site: null, project: null, progress: "In Progress", review: "In Review" },
|
|
158
|
-
|
|
159
|
-
//
|
|
160
|
-
//
|
|
161
|
-
minPushPaths: [
|
|
197
|
+
ciRequired: [],
|
|
198
|
+
// Nothing beyond what bkit writes. Never seed `docs/**`: a project doc can be a test's
|
|
199
|
+
// input, so a docs edit can red a test; a repo that knows its tests opts in.
|
|
200
|
+
minPushPaths: [],
|
|
201
|
+
ciSkipPaths: [],
|
|
202
|
+
ciGenerated: [],
|
|
162
203
|
opencodeProvider: null,
|
|
163
204
|
opencodeProviders: [],
|
|
164
205
|
cloudAgents: DEFAULT_CLOUD_AGENTS,
|
|
@@ -173,8 +214,9 @@ export const CONFIG_DEFAULTS: Readonly<BkitConfig> = {
|
|
|
173
214
|
"ship.merge": { ask: true, max: 2 },
|
|
174
215
|
},
|
|
175
216
|
// Plan caps, `.bkit/workflows.md` § Test-first.
|
|
176
|
-
tasks: { maxPerGroup:
|
|
177
|
-
|
|
217
|
+
tasks: { maxPerGroup: 5, maxTestsPerGroup: 25, maxTestsPerTask: 10, maxTestFilesPerTask: 3 },
|
|
218
|
+
buildPublish: { remote: true, local: true },
|
|
219
|
+
depUpdater: null,
|
|
178
220
|
issueTrackerExplicit: false,
|
|
179
221
|
cloudAgentsExplicit: false,
|
|
180
222
|
};
|
|
@@ -194,6 +236,9 @@ function trackerStates(raw: Record<string, unknown>, defaults: TrackerStates): T
|
|
|
194
236
|
};
|
|
195
237
|
}
|
|
196
238
|
|
|
239
|
+
const parseDepUpdater = (v: unknown): DepUpdater | "none" | null =>
|
|
240
|
+
v === "none" || DEP_UPDATERS.includes(v as DepUpdater) ? (v as DepUpdater | "none") : null;
|
|
241
|
+
|
|
197
242
|
const TASK_CAP_KEYS = Object.keys(CONFIG_DEFAULTS.tasks) as (keyof TaskCaps)[];
|
|
198
243
|
|
|
199
244
|
const validCap = (v: unknown): v is number => Number.isInteger(v) && (v as number) >= 1;
|
|
@@ -209,6 +254,32 @@ export function invalidTaskCaps(raw: unknown): string[] {
|
|
|
209
254
|
return TASK_CAP_KEYS.filter((k) => set[k] !== undefined && !validCap(set[k]));
|
|
210
255
|
}
|
|
211
256
|
|
|
257
|
+
/**
|
|
258
|
+
* The dotted keys of a `bkit.workflows.build` value that fall back to their default:
|
|
259
|
+
* `build` when set but not an object, `build.publish` when set but not an object,
|
|
260
|
+
* `build.publish.local` when set but not a boolean. `remote` is never listed: the
|
|
261
|
+
* preflight advisory `bkit-build-publish-remote` owns it.
|
|
262
|
+
*/
|
|
263
|
+
export function invalidBuildPublish(raw: unknown): string[] {
|
|
264
|
+
if (raw === undefined) return [];
|
|
265
|
+
if (raw === null || typeof raw !== "object" || Array.isArray(raw)) return ["build"];
|
|
266
|
+
const publish = (raw as Record<string, unknown>).publish;
|
|
267
|
+
if (publish === undefined) return [];
|
|
268
|
+
if (publish === null || typeof publish !== "object" || Array.isArray(publish))
|
|
269
|
+
return ["build.publish"];
|
|
270
|
+
const local = (publish as Record<string, unknown>).local;
|
|
271
|
+
return local !== undefined && typeof local !== "boolean" ? ["build.publish.local"] : [];
|
|
272
|
+
}
|
|
273
|
+
|
|
274
|
+
/** `bkit.workflows.build.publish`; `remote` always resolves `true`. */
|
|
275
|
+
function buildPublish(raw: unknown): BuildPublish {
|
|
276
|
+
const { local } = record(raw);
|
|
277
|
+
return {
|
|
278
|
+
remote: true,
|
|
279
|
+
local: typeof local === "boolean" ? local : CONFIG_DEFAULTS.buildPublish.local,
|
|
280
|
+
};
|
|
281
|
+
}
|
|
282
|
+
|
|
212
283
|
/** `bkit.workflows.tasks` read key by key; a missing or invalid key takes its default. */
|
|
213
284
|
function taskCaps(raw: unknown): TaskCaps {
|
|
214
285
|
const set = record(raw);
|
|
@@ -277,9 +348,11 @@ export function readBkitConfig(root: string): BkitConfig {
|
|
|
277
348
|
const testing = record(bkit.testing);
|
|
278
349
|
const workflows = record(bkit.workflows);
|
|
279
350
|
const worktree = record(workflows.worktree);
|
|
351
|
+
const ciSkip = testing.ciSkipPaths;
|
|
352
|
+
const generated = testing.ciGenerated;
|
|
280
353
|
const copy = worktree.copy;
|
|
281
354
|
const minFreeGb = workflows.minFreeGb;
|
|
282
|
-
const lanes = testing.
|
|
355
|
+
const lanes = testing.ciRequired;
|
|
283
356
|
const book = testing.minPushPaths;
|
|
284
357
|
const provider = opencode.default;
|
|
285
358
|
const providers = opencode.installed;
|
|
@@ -321,11 +394,12 @@ export function readBkitConfig(root: string): BkitConfig {
|
|
|
321
394
|
project: optionalString(jira.project),
|
|
322
395
|
...trackerStates(jira, CONFIG_DEFAULTS.jira),
|
|
323
396
|
},
|
|
324
|
-
|
|
325
|
-
// An explicit [] is kept: it switches the min push off.
|
|
397
|
+
ciRequired: Array.isArray(lanes) ? lanes.filter(nonEmptyString) : [],
|
|
326
398
|
minPushPaths: Array.isArray(book)
|
|
327
399
|
? book.filter(nonEmptyString)
|
|
328
400
|
: [...CONFIG_DEFAULTS.minPushPaths],
|
|
401
|
+
ciSkipPaths: Array.isArray(ciSkip) ? ciSkip.filter(nonEmptyString) : [],
|
|
402
|
+
ciGenerated: Array.isArray(generated) ? generated.filter(nonEmptyString) : [],
|
|
329
403
|
opencodeProvider:
|
|
330
404
|
typeof provider === "string" && isOpencodeProvider(provider) ? provider : null,
|
|
331
405
|
opencodeProviders: Array.isArray(providers)
|
|
@@ -336,7 +410,8 @@ export function readBkitConfig(root: string): BkitConfig {
|
|
|
336
410
|
cloudAgents: parseCloudAgents(cloud.agent) ?? CONFIG_DEFAULTS.cloudAgents,
|
|
337
411
|
asks: askSettings(workflows),
|
|
338
412
|
tasks: taskCaps(workflows.tasks),
|
|
339
|
-
|
|
413
|
+
buildPublish: buildPublish(record(workflows.build).publish),
|
|
414
|
+
depUpdater: parseDepUpdater(record(bkit.dependencies).updater),
|
|
340
415
|
issueTrackerExplicit: tracker.default !== undefined && tracker.default !== "",
|
|
341
416
|
cloudAgentsExplicit: cloud.agent !== undefined && cloud.agent !== "",
|
|
342
417
|
};
|
|
@@ -24,4 +24,6 @@ export const TIMEOUTS = {
|
|
|
24
24
|
BKIT_LATEST_RETRY_S: 3600,
|
|
25
25
|
/** Seconds the registry lookup may take before it counts as failed. */
|
|
26
26
|
BKIT_LATEST_LOOKUP_TIMEOUT_S: 5,
|
|
27
|
+
/** Seconds `worktrees setup` waits for a running disk sweep before refusing; under one agent shell call. */
|
|
28
|
+
DISK_SETUP_SWEEP_WAIT_S: 60,
|
|
27
29
|
} as const;
|
|
@@ -0,0 +1,111 @@
|
|
|
1
|
+
// tools/cli-doc.ts — check and sync the generated region of `.bkit/cli.md`.
|
|
2
|
+
//
|
|
3
|
+
// The region lists every `bkit <verb>` (`cli.ts` `CLASSIC_VERB_HELP`) and every
|
|
4
|
+
// `bkit <noun> <verb>` (`commands/registry.ts`), rendered from the same specs `--help`
|
|
5
|
+
// prints. Check mode runs in the test suite (`tools/cli-doc.test.ts`); write mode is
|
|
6
|
+
// `pnpm cli:sync`. Text outside the region is hand-written and kept as is.
|
|
7
|
+
|
|
8
|
+
import * as fs from "node:fs";
|
|
9
|
+
import * as path from "node:path";
|
|
10
|
+
import { fileURLToPath } from "node:url";
|
|
11
|
+
|
|
12
|
+
import { CLASSIC_VERB_HELP } from "../cli.js";
|
|
13
|
+
import type { CommandSpec, FlagSpec } from "../commands/lib.js";
|
|
14
|
+
import { COMMANDS } from "../commands/registry.js";
|
|
15
|
+
|
|
16
|
+
export const DOC_PATH = path.join(".bkit", "core", ".bkit", "cli.md");
|
|
17
|
+
export const REGION_START = "<!-- cli:start -->";
|
|
18
|
+
export const REGION_END = "<!-- cli:end -->";
|
|
19
|
+
|
|
20
|
+
export const USE_LABEL = { "by-hand": "by hand", workflow: "workflow" } as const;
|
|
21
|
+
|
|
22
|
+
/** A markdown table cell: pipes escaped, newlines flattened, `—` when empty. */
|
|
23
|
+
const cell = (text: string) => text.replace(/\|/g, "\\|").replace(/\s*\n\s*/g, " ") || "—";
|
|
24
|
+
|
|
25
|
+
const flagCell = (flags: readonly FlagSpec[]) =>
|
|
26
|
+
flags.map((f) => (f.required ? `**\`--${f.name}\`**` : `\`--${f.name}\``)).join(" ");
|
|
27
|
+
|
|
28
|
+
function table(head: string[], rows: string[][]): string[] {
|
|
29
|
+
return [
|
|
30
|
+
"<!-- prettier-ignore -->",
|
|
31
|
+
`| ${head.join(" | ")} |`,
|
|
32
|
+
`| ${head.map(() => "---").join(" | ")} |`,
|
|
33
|
+
...rows.map((r) => `| ${r.join(" | ")} |`),
|
|
34
|
+
];
|
|
35
|
+
}
|
|
36
|
+
|
|
37
|
+
function nounSection(cmd: CommandSpec): string[] {
|
|
38
|
+
const rows = Object.entries(cmd.verbs).map(([verb, spec]) => [
|
|
39
|
+
`\`${verb}\``,
|
|
40
|
+
USE_LABEL[spec.use],
|
|
41
|
+
cell(flagCell(spec.flags)),
|
|
42
|
+
cell(spec.summary),
|
|
43
|
+
]);
|
|
44
|
+
return [
|
|
45
|
+
`### \`${cmd.noun}\``,
|
|
46
|
+
"",
|
|
47
|
+
cell(cmd.summary),
|
|
48
|
+
"",
|
|
49
|
+
...table(["Verb", "Use", "Flags", "What it does"], rows),
|
|
50
|
+
"",
|
|
51
|
+
];
|
|
52
|
+
}
|
|
53
|
+
|
|
54
|
+
/** The generated region, markers included. */
|
|
55
|
+
export function renderRegion(): string {
|
|
56
|
+
const classic = CLASSIC_VERB_HELP.map(({ verb, args, flags, summary }) => [
|
|
57
|
+
`\`${["bkit", verb, ...args.split(" ").filter((w) => /^[a-z]/.test(w))].join(" ")}\``,
|
|
58
|
+
cell(flags.map((f) => `\`${f}\``).join(" ")),
|
|
59
|
+
cell(summary),
|
|
60
|
+
]);
|
|
61
|
+
const nouns = [...COMMANDS].sort((a, b) => a.noun.localeCompare(b.noun));
|
|
62
|
+
return [
|
|
63
|
+
REGION_START,
|
|
64
|
+
"",
|
|
65
|
+
"## Commands you run",
|
|
66
|
+
"",
|
|
67
|
+
...table(["Command", "Flags", "What it does"], classic),
|
|
68
|
+
"",
|
|
69
|
+
"## Workflow commands",
|
|
70
|
+
"",
|
|
71
|
+
"Use: `by hand` = safe and useful outside a workflow run; `workflow` = a workflow step only (writes run state, takes locks, commits, pushes or posts). **Bold** flag = required.",
|
|
72
|
+
"",
|
|
73
|
+
...nouns.flatMap(nounSection),
|
|
74
|
+
REGION_END,
|
|
75
|
+
].join("\n");
|
|
76
|
+
}
|
|
77
|
+
|
|
78
|
+
/** Offset of `marker` standing alone on a line, else -1 (prose may quote the marker inline). */
|
|
79
|
+
function markerLine(text: string, marker: string): number {
|
|
80
|
+
return new RegExp(`^${marker}$`, "m").exec(text)?.index ?? -1;
|
|
81
|
+
}
|
|
82
|
+
|
|
83
|
+
/** `text` with its generated region replaced by `renderRegion()`; throws when the markers are missing. */
|
|
84
|
+
export function syncDoc(text: string): string {
|
|
85
|
+
const start = markerLine(text, REGION_START);
|
|
86
|
+
const end = markerLine(text, REGION_END);
|
|
87
|
+
if (start < 0 || end < start) {
|
|
88
|
+
throw new Error(`${DOC_PATH}: missing ${REGION_START} / ${REGION_END}`);
|
|
89
|
+
}
|
|
90
|
+
return text.slice(0, start) + renderRegion() + text.slice(end + REGION_END.length);
|
|
91
|
+
}
|
|
92
|
+
|
|
93
|
+
function main(argv: string[]): number {
|
|
94
|
+
const file = path.join(process.cwd(), DOC_PATH);
|
|
95
|
+
const text = fs.readFileSync(file, "utf-8");
|
|
96
|
+
const synced = syncDoc(text);
|
|
97
|
+
if (synced === text) return 0;
|
|
98
|
+
if (argv.includes("--write")) {
|
|
99
|
+
fs.writeFileSync(file, synced, "utf-8");
|
|
100
|
+
console.error(`[bkit-cli] rewrote ${DOC_PATH}`);
|
|
101
|
+
return 0;
|
|
102
|
+
}
|
|
103
|
+
console.error(`[bkit-cli] ${DOC_PATH}: generated region stale (run pnpm cli:sync)`);
|
|
104
|
+
return 1;
|
|
105
|
+
}
|
|
106
|
+
|
|
107
|
+
if (process.argv[1] && fs.existsSync(process.argv[1])) {
|
|
108
|
+
if (fs.realpathSync(fileURLToPath(import.meta.url)) === fs.realpathSync(process.argv[1])) {
|
|
109
|
+
process.exitCode = main(process.argv.slice(2));
|
|
110
|
+
}
|
|
111
|
+
}
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
// tools/grammar-density.ts — articles (`a`, `an`, `the`) per 1,000 words of agent text.
|
|
2
2
|
//
|
|
3
|
-
// The measure behind `.bkit/core/.bkit/authoring.md` §
|
|
3
|
+
// The measure behind `.bkit/core/.bkit/authoring.md` § All Agent-Read Files, Plain, complete sentences: clipped text
|
|
4
4
|
// drops articles, plain English keeps them. `pnpm grammar:density` prints one row per
|
|
5
5
|
// group for the working tree, `--rev=<rev>` for a past commit, and `--diff=<base>..<head>`
|
|
6
6
|
// for only the lines `<head>` added. Repo-only tooling, like `tools/instructions.ts`.
|