@cbartens/bkit 5.5.1 → 6.1.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.bkit/README.md +167 -154
- package/.bkit/core/.agents/context.md +95 -29
- package/.bkit/core/.agents/docs.md +18 -15
- package/.bkit/core/.agents/plugins/bkit/hooks/bkit-gateguard.cjs +1 -0
- package/.bkit/core/.agents/plugins/bkit/hooks/bkit-guardrails.cjs +6 -5
- package/.bkit/core/.agents/plugins/bkit/hooks/bkit-readguard.cjs +1 -0
- package/.bkit/core/.agents/plugins/bkit/hooks/bkit-rules.cjs +65 -0
- package/.bkit/core/.agents/rules.md +112 -102
- package/.bkit/core/.agents/skills.md +63 -15
- package/.bkit/core/.bkit/README.md +167 -154
- package/.bkit/core/.bkit/authoring.md +747 -0
- package/.bkit/core/.bkit/cli.md +407 -0
- package/.bkit/core/.bkit/cloud.md +283 -195
- package/.bkit/core/.bkit/comparison.md +45 -43
- package/.bkit/core/.bkit/install.md +166 -95
- package/.bkit/core/.bkit/jsonl.md +339 -196
- package/.bkit/core/.bkit/pipeline.md +142 -145
- package/.bkit/core/.bkit/prompts.md +295 -264
- package/.bkit/core/.bkit/providers.md +460 -277
- package/.bkit/core/.bkit/router.md +69 -0
- package/.bkit/core/.bkit/templates.md +530 -256
- package/.bkit/core/.bkit/trackers.md +116 -65
- package/.bkit/core/.bkit/workflows.md +742 -618
- package/.bkit/core/.claude/hooks/bkit-gateguard.cjs +2 -2
- package/.bkit/core/.claude/hooks/bkit-guardrails.cjs +3 -3
- package/.bkit/core/.claude/hooks/bkit-preflight.sh +45 -14
- package/.bkit/core/.codex/hooks/bkit-guardrails.cjs +3 -3
- package/.bkit/core/.codex/hooks/bkit-rules.cjs +57 -0
- package/.bkit/core/.cursor/hooks/bkit-guardrails.cjs +7 -7
- package/.bkit/core/.cursor/hooks/bkit-preflight.sh +47 -12
- package/.bkit/core/.opencode/plugin/bkit-rules.js +89 -0
- package/.bkit/core/AGENTS.md +6 -80
- package/.bkit/core/docs/templates/bkit-audit-accessibility.md +128 -130
- package/.bkit/core/docs/templates/bkit-audit-adoption.md +104 -94
- package/.bkit/core/docs/templates/bkit-audit-agents.md +96 -98
- package/.bkit/core/docs/templates/bkit-audit-aio-seo.md +100 -103
- package/.bkit/core/docs/templates/bkit-audit-analytics.md +141 -107
- package/.bkit/core/docs/templates/bkit-audit-annotations.md +99 -97
- package/.bkit/core/docs/templates/bkit-audit-app-performance.md +122 -121
- package/.bkit/core/docs/templates/bkit-audit-app-store.md +158 -101
- package/.bkit/core/docs/templates/bkit-audit-architecture.md +114 -96
- package/.bkit/core/docs/templates/bkit-audit-ci-performance.md +76 -97
- package/.bkit/core/docs/templates/bkit-audit-config.md +123 -101
- package/.bkit/core/docs/templates/bkit-audit-cost.md +86 -99
- package/.bkit/core/docs/templates/bkit-audit-coverage.md +76 -93
- package/.bkit/core/docs/templates/bkit-audit-database.md +102 -95
- package/.bkit/core/docs/templates/bkit-audit-dead-code.md +165 -108
- package/.bkit/core/docs/templates/bkit-audit-deferrals.md +115 -109
- package/.bkit/core/docs/templates/bkit-audit-dependencies.md +265 -113
- package/.bkit/core/docs/templates/bkit-audit-documentation.md +119 -118
- package/.bkit/core/docs/templates/bkit-audit-duplication.md +140 -111
- package/.bkit/core/docs/templates/bkit-audit-failures.md +111 -106
- package/.bkit/core/docs/templates/bkit-audit-flakes.md +100 -99
- package/.bkit/core/docs/templates/bkit-audit-gates.md +107 -103
- package/.bkit/core/docs/templates/bkit-audit-issues.md +105 -105
- package/.bkit/core/docs/templates/bkit-audit-llm.md +134 -85
- package/.bkit/core/docs/templates/bkit-audit-logs.md +124 -125
- package/.bkit/core/docs/templates/bkit-audit-models.md +99 -78
- package/.bkit/core/docs/templates/bkit-audit-privacy.md +56 -76
- package/.bkit/core/docs/templates/bkit-audit-prompts.md +63 -78
- package/.bkit/core/docs/templates/bkit-audit-red-team.md +125 -93
- package/.bkit/core/docs/templates/bkit-audit-reliability.md +97 -96
- package/.bkit/core/docs/templates/bkit-audit-repo.md +170 -98
- package/.bkit/core/docs/templates/bkit-audit-security.md +207 -121
- package/.bkit/core/docs/templates/bkit-audit-slop.md +78 -95
- package/.bkit/core/docs/templates/bkit-audit-testing.md +163 -139
- package/.bkit/core/docs/templates/bkit-audit-usability.md +114 -96
- package/.bkit/core/docs/templates/bkit-plan.md +158 -281
- package/.bkit/core/engine/checks/after/auth.ts +40 -37
- package/.bkit/core/engine/checks/after/ci-yml.ts +104 -31
- package/.bkit/core/engine/checks/after/github.ts +95 -17
- package/.bkit/core/engine/checks/after/index.ts +21 -8
- package/.bkit/core/engine/checks/after/suppression.ts +8 -5
- package/.bkit/core/engine/checks/after/tools.ts +125 -123
- package/.bkit/core/engine/checks/before/context-fetch.ts +227 -33
- package/.bkit/core/engine/checks/before/env.ts +3 -3
- package/.bkit/core/engine/checks/before/files.ts +5 -4
- package/.bkit/core/engine/checks/before/index.ts +25 -1
- package/.bkit/core/engine/checks/before/repo.ts +208 -2
- package/.bkit/core/engine/checks/status-holes.ts +916 -123
- package/.bkit/core/engine/checks/tips/catalogue.ts +82 -20
- package/.bkit/core/engine/checks/tips/detect.ts +66 -0
- package/.bkit/core/engine/checks/tips/index.ts +52 -11
- package/.bkit/core/engine/cli.ts +251 -130
- package/.bkit/core/engine/commands/analysis.ts +282 -199
- package/.bkit/core/engine/commands/ci/ci.ts +363 -29
- package/.bkit/core/engine/commands/ci/pins.ts +172 -0
- package/.bkit/core/engine/commands/ci/push-gate.ts +223 -0
- package/.bkit/core/engine/commands/comply.ts +77 -103
- package/.bkit/core/engine/commands/install/doctor.ts +2 -2
- package/.bkit/core/engine/commands/install/install.ts +57 -18
- package/.bkit/core/engine/commands/install/uninstall.ts +86 -55
- package/.bkit/core/engine/commands/install/upgrade.ts +32 -15
- package/.bkit/core/engine/commands/land.ts +139 -18
- package/.bkit/core/engine/commands/lib.ts +381 -22
- package/.bkit/core/engine/commands/registry.ts +10 -2
- package/.bkit/core/engine/commands/setup/setup.ts +8 -7
- package/.bkit/core/engine/commands/stats.ts +260 -0
- package/.bkit/core/engine/commands/tips.ts +10 -5
- package/.bkit/core/engine/commands/workflow/branches.ts +2215 -176
- package/.bkit/core/engine/commands/workflow/challenge.ts +748 -0
- package/.bkit/core/engine/commands/workflow/completeness.ts +109 -0
- package/.bkit/core/engine/commands/workflow/context.ts +1249 -47
- package/.bkit/core/engine/commands/workflow/counters.ts +483 -95
- package/.bkit/core/engine/commands/workflow/decisions.ts +585 -0
- package/.bkit/core/engine/commands/workflow/disk.ts +238 -56
- package/.bkit/core/engine/commands/workflow/fids.ts +811 -33
- package/.bkit/core/engine/commands/workflow/issues.ts +413 -64
- package/.bkit/core/engine/commands/workflow/ledgers.ts +1333 -36
- package/.bkit/core/engine/commands/workflow/locks.ts +28 -2
- package/.bkit/core/engine/commands/workflow/plan-blocks.ts +691 -0
- package/.bkit/core/engine/commands/workflow/plan-versions.ts +21 -0
- package/.bkit/core/engine/commands/workflow/plans.ts +257 -0
- package/.bkit/core/engine/commands/workflow/prs.ts +178 -33
- package/.bkit/core/engine/commands/workflow/repo.ts +66 -8
- package/.bkit/core/engine/commands/workflow/roadmap.ts +72 -22
- package/.bkit/core/engine/commands/workflow/run-facts.ts +492 -0
- package/.bkit/core/engine/commands/workflow/runs.ts +827 -79
- package/.bkit/core/engine/commands/workflow/runtime.ts +25 -1
- package/.bkit/core/engine/commands/workflow/skills.ts +1 -0
- package/.bkit/core/engine/commands/workflow/status.ts +329 -33
- package/.bkit/core/engine/commands/workflow/step-table.ts +381 -0
- package/.bkit/core/engine/commands/workflow/steps.ts +841 -105
- package/.bkit/core/engine/commands/workflow/summary-findings.ts +177 -0
- package/.bkit/core/engine/commands/workflow/summary.ts +544 -0
- package/.bkit/core/engine/commands/workflow/tasks.ts +409 -0
- package/.bkit/core/engine/commands/workflow/test-blocks.ts +254 -0
- package/.bkit/core/engine/commands/workflow/tests-changed.ts +201 -0
- package/.bkit/core/engine/commands/workflow/tests.ts +2124 -330
- package/.bkit/core/engine/commands/workflow/tracker.ts +1195 -0
- package/.bkit/core/engine/commands/workflow/workflows.ts +1197 -235
- package/.bkit/core/engine/commands/workflow/worktrees.ts +543 -24
- package/.bkit/core/engine/install/cloud-env.ts +251 -121
- package/.bkit/core/engine/install/context-ci-workflow.ts +102 -0
- package/.bkit/core/engine/install/manifest.ts +67 -17
- package/.bkit/core/engine/install/modules/antigravity.ts +3 -2
- package/.bkit/core/engine/install/modules/cloud.ts +24 -16
- package/.bkit/core/engine/install/modules/codex.ts +15 -2
- package/.bkit/core/engine/install/modules/core.ts +1196 -45
- package/.bkit/core/engine/install/modules/cursor.ts +6 -6
- package/.bkit/core/engine/install/modules/opencode.ts +18 -6
- package/.bkit/core/engine/install/template-notes.ts +130 -0
- package/.bkit/core/engine/install/version-file.ts +9 -4
- package/.bkit/core/engine/install/write.ts +5 -0
- package/.bkit/core/engine/ledgers/compact.ts +124 -0
- package/.bkit/core/engine/ledgers/journal.ts +291 -0
- package/.bkit/core/engine/ledgers/migrate.ts +92 -0
- package/.bkit/core/engine/ledgers/status.ts +249 -21
- package/.bkit/core/engine/ledgers/telemetry.ts +1397 -253
- package/.bkit/core/engine/render/hosts.ts +118 -14
- package/.bkit/core/engine/render/models.ts +12 -0
- package/.bkit/core/engine/shared/bkit-latest.ts +26 -4
- package/.bkit/core/engine/shared/branches.ts +4 -1
- package/.bkit/core/engine/shared/dep-updater.ts +60 -0
- package/.bkit/core/engine/shared/egress.ts +8 -1
- package/.bkit/core/engine/shared/json.ts +25 -7
- package/.bkit/core/engine/shared/package-manager.ts +9 -0
- package/.bkit/core/engine/shared/settings.ts +243 -31
- package/.bkit/core/engine/shared/text.ts +361 -0
- package/.bkit/core/engine/shared/timeouts.ts +2 -0
- package/.bkit/core/engine/tools/cli-doc.ts +111 -0
- package/.bkit/core/engine/tools/grammar-density.ts +215 -0
- package/.bkit/core/engine/tools/instructions-sources.ts +832 -0
- package/.bkit/core/engine/tools/instructions.ts +1802 -0
- package/.bkit/core/hooks/antigravity-hook.js +25 -10
- package/.bkit/core/hooks/gateguard-engine.js +54 -29
- package/.bkit/core/hooks/guardrails-shell.js +4 -5
- package/.bkit/core/hooks/guardrails-tiers.js +10 -4
- package/.bkit/core/hooks/preflight-linear.sh +9 -9
- package/.bkit/core/hooks/preflight-rules.sh +8 -0
- package/.bkit/core/hooks/readguard-engine.js +29 -10
- package/.bkit/core/hooks/session-rules-advisory.js +61 -0
- package/.bkit/core/prompts/bkit-audit-generate.md +202 -94
- package/.bkit/core/prompts/bkit-build-challenge-1.md +76 -34
- package/.bkit/core/prompts/bkit-build-challenge-2.md +85 -38
- package/.bkit/core/prompts/bkit-build-install-skills.md +50 -28
- package/.bkit/core/prompts/bkit-build-plan-convert.md +85 -0
- package/.bkit/core/prompts/bkit-build-plan-current.md +59 -36
- package/.bkit/core/prompts/bkit-build-plan-gaps-remediate.md +101 -36
- package/.bkit/core/prompts/bkit-build-plan-tasks.md +149 -0
- package/.bkit/core/prompts/bkit-build-plan-tests.md +120 -0
- package/.bkit/core/prompts/bkit-build-plan-verify.md +104 -43
- package/.bkit/core/prompts/bkit-debug-abort-handover.md +47 -32
- package/.bkit/core/prompts/bkit-debug-failure-diagnose.md +109 -57
- package/.bkit/core/prompts/bkit-debug-failure-remediate.md +65 -39
- package/.bkit/core/prompts/bkit-debug-failure-reproduce.md +53 -31
- package/.bkit/core/prompts/bkit-debug-failure-soak.md +65 -34
- package/.bkit/core/prompts/bkit-design-brainstorm-ideate-1.md +46 -31
- package/.bkit/core/prompts/bkit-design-brainstorm-ideate-2.md +45 -31
- package/.bkit/core/prompts/bkit-design-brainstorm-ideate-3.md +43 -30
- package/.bkit/core/prompts/bkit-design-generate.md +80 -46
- package/.bkit/core/prompts/bkit-design-organise.md +83 -32
- package/.bkit/core/prompts/bkit-design-review-1.md +70 -50
- package/.bkit/core/prompts/bkit-design-review-2.md +65 -46
- package/.bkit/core/prompts/bkit-design-spike.md +64 -40
- package/.bkit/core/prompts/bkit-design-update.md +53 -28
- package/.bkit/core/prompts/bkit-plan-generate.md +101 -29
- package/.bkit/core/prompts/bkit-plan-review-1.md +78 -41
- package/.bkit/core/prompts/bkit-plan-review-2.md +78 -35
- package/.bkit/core/prompts/bkit-plan-scope-check.md +116 -0
- package/.bkit/core/prompts/bkit-plan-update.md +86 -31
- package/.bkit/core/prompts/bkit-ship-conflict-resolve.md +94 -50
- package/.bkit/core/prompts/bkit-ship-deferred-sweep.md +91 -41
- package/.bkit/core/prompts/bkit-ship-update-docs.md +45 -24
- package/.bkit/core/prompts/bkit-utility-compress-markdown.md +65 -49
- package/.bkit/core/prompts/bkit-utility-update-decisions.md +87 -42
- package/.bkit/core/prompts/bkit-utility-update-deferrals.md +81 -37
- package/.bkit/core/prompts/bkit-utility-update-documentation.md +43 -25
- package/.bkit/core/prompts/bkit-utility-update-failures.md +84 -37
- package/.bkit/core/prompts/bkit-utility-update-knowledge.md +88 -42
- package/.bkit/core/prompts/bkit-utility-update-roadmap.md +92 -39
- package/.bkit/core/prompts/bkit-utility-update-tracker.md +159 -60
- package/.bkit/core/workflows/bkit-auto.md +89 -58
- package/.bkit/core/workflows/bkit-build.md +967 -517
- package/.bkit/core/workflows/bkit-debug.md +555 -387
- package/.bkit/core/workflows/bkit-design.md +319 -283
- package/.bkit/core/workflows/bkit-plan.md +319 -342
- package/.bkit/core/workflows/bkit-ship.md +525 -328
- package/.bkit/shared/.agents/plugins/bkit/hooks.json +10 -0
- package/.bkit/shared/.bkit/.env.example +2 -2
- package/.bkit/shared/.claude/bkit-cloud.md +12 -10
- package/.bkit/shared/.claude/settings.json +14 -0
- package/.bkit/shared/.codex/bkit-cloud.md +98 -0
- package/.bkit/shared/.codex/hooks.json +20 -0
- package/.bkit/shared/.cursor/bkit-cloud.md +3 -3
- package/.bkit/shared/.cursor/mcp.json +1 -1
- package/.bkit/shared/.cursor/rules/bkit-rules.mdc +1 -1
- package/.bkit/shared/.gitattributes +1 -1
- package/.bkit/shared/.mcp.json +1 -1
- package/.bkit/shared/.opencode/opencode.json +12 -1
- package/.bkit/shared/CLAUDE.md +6 -2
- package/.bkit/shared/GEMINI.md +5 -2
- package/.bkit/shared/docs/architecture.md +4 -7
- package/.bkit/shared/docs/data-schema.md +4 -7
- package/.bkit/shared/docs/deployments.md +241 -168
- package/.bkit/shared/docs/design.md +11 -12
- package/.bkit/shared/docs/noise.md +8 -7
- package/.bkit/shared/docs/observability.md +5 -8
- package/.bkit/shared/docs/security.md +35 -17
- package/.bkit/shared/docs/setup.md +29 -18
- package/.bkit/shared/docs/technology.md +3 -6
- package/.bkit/shared/docs/testing.md +289 -174
- package/.bkit/shared/gitignore +6 -2
- package/.bkit/templates/.claude/hooks/bkit-cloud-bootstrap.sh +15 -16
- package/.bkit/templates/.cursor/Dockerfile +12 -8
- package/.bkit/templates/.cursor/environment.json +1 -1
- package/.bkit/templates/.github/ISSUE_TEMPLATE/bkit-bug.yml +10 -8
- package/.bkit/templates/.github/ISSUE_TEMPLATE/bkit-change.yml +45 -12
- package/.bkit/templates/.github/ISSUE_TEMPLATE/bkit-idea.yml +3 -3
- package/.bkit/templates/.github/renovate.json5 +34 -6
- package/.bkit/templates/.github/workflows/bkit-ci.yml +54 -51
- package/.bkit/templates/.github/workflows/bkit-cloud.yml +34 -33
- package/.bkit/templates/.github/workflows/bkit-health.yml +97 -0
- package/.bkit/templates/.github/workflows/bkit-renovate.yml +5 -4
- package/.bkit/templates/.github/workflows/bkit-trivy.yml +5 -4
- package/.bkit/templates/.husky/pre-commit +2 -2
- package/.bkit/templates/.husky/pre-push +96 -36
- package/.bkit/templates/.prettierignore +6 -0
- package/.bkit/templates/.vale.ini +27 -27
- package/.bkit/templates/context/bkit-cloudrun.md +23 -15
- package/.bkit/templates/context/bkit-expo.md +70 -52
- package/.bkit/templates/context/bkit-github.md +93 -56
- package/.bkit/templates/context/bkit-inngest.md +21 -15
- package/.bkit/templates/context/bkit-maestro.md +22 -16
- package/.bkit/templates/context/bkit-playwright.md +23 -17
- package/.bkit/templates/context/bkit-resend.md +12 -10
- package/.bkit/templates/context/bkit-sentry.md +30 -20
- package/.bkit/templates/context/bkit-serena.md +8 -7
- package/.bkit/templates/context/bkit-stripe.md +14 -13
- package/.bkit/templates/context/bkit-supabase.md +16 -13
- package/.bkit/templates/context/bkit-tavily.md +14 -11
- package/.bkit/templates/context/bkit-vercel.md +27 -18
- package/.bkit/templates/docs/capabilities.md +15 -14
- package/.bkit/templates/scripts/ci/{check-accepted-divergences.mjs → bkit-check-accepted-divergences.mjs} +6 -3
- package/.bkit/templates/scripts/ci/{check-accepted-divergences.test.mjs → bkit-check-accepted-divergences.test.mjs} +3 -3
- package/.bkit/templates/scripts/ci/{check-capstone.mjs → bkit-check-capstone.mjs} +2 -2
- package/.bkit/templates/scripts/ci/{check-capstone.test.mjs → bkit-check-capstone.test.mjs} +4 -4
- package/.bkit/templates/scripts/ci/{check-dependency-audit.mjs → bkit-check-dependency-audit.mjs} +103 -18
- package/.bkit/templates/scripts/ci/{check-dependency-audit.test.mjs → bkit-check-dependency-audit.test.mjs} +31 -3
- package/.bkit/templates/scripts/ci/bkit-machine-lock.sh +387 -0
- package/.bkit/templates/scripts/ci/bkit-test-awake.mjs +75 -0
- package/.bkit/templates/scripts/ci/bkit-test-awake.test.mjs +160 -0
- package/.bkit/templates/scripts/ci/lanes/{resolve-push-base.mjs → bkit-resolve-push-base.mjs} +3 -3
- package/.bkit/templates/scripts/ci/lanes/{resolve-push-base.test.mjs → bkit-resolve-push-base.test.mjs} +4 -4
- package/.bkit/templates/scripts/cleanup/bkit-disk-prune.mjs +10 -2
- package/.bkit/templates/scripts/graphify/bkit-graph-drift.py +1 -1
- package/.bkit/templates/scripts/graphify/bkit-graph-eager.py +3 -3
- package/.bkit/templates/scripts/graphify/bkit-graph-embed.py +63 -0
- package/.bkit/templates/scripts/graphify/bkit-graph-imports.py +2 -2
- package/.bkit/templates/scripts/graphify/bkit-graph-pre-push.sh +69 -18
- package/.bkit/templates/scripts/graphify/bkit-graph-repair.py +3 -3
- package/.bkit/templates/scripts/graphify/bkit-graph-surface.py +1 -1
- package/.bkit/templates/scripts/graphify/bkit-graphify-graphml.py +1 -1
- package/.bkit/templates/scripts/graphify/bkit-graphify-rollup.py +197 -126
- package/.bkit/templates/scripts/graphify/bkit-graphify.sh +64 -41
- package/.bkit/templates/scripts/slop/bkit-slop-type-suppression.mjs +23 -7
- package/.bkit/templates/slop-scan.config.json +9 -2
- package/CHANGELOG.md +231 -0
- package/README.md +278 -89
- package/dist/checks/after/auth.js +36 -33
- package/dist/checks/after/ci-yml.js +91 -30
- package/dist/checks/after/github.js +91 -17
- package/dist/checks/after/index.js +22 -11
- package/dist/checks/after/suppression.js +8 -5
- package/dist/checks/after/tools.js +111 -114
- package/dist/checks/before/context-fetch.js +218 -33
- package/dist/checks/before/env.js +3 -3
- package/dist/checks/before/files.js +5 -3
- package/dist/checks/before/index.js +20 -3
- package/dist/checks/before/repo.js +197 -2
- package/dist/checks/status-holes.js +739 -114
- package/dist/checks/tips/catalogue.js +70 -19
- package/dist/checks/tips/detect.js +62 -0
- package/dist/checks/tips/index.js +51 -9
- package/dist/cli.js +234 -124
- package/dist/commands/analysis.js +174 -141
- package/dist/commands/ci/ci.js +302 -25
- package/dist/commands/ci/pins.js +142 -0
- package/dist/commands/ci/push-gate.js +194 -0
- package/dist/commands/comply.js +54 -91
- package/dist/commands/install/doctor.js +2 -2
- package/dist/commands/install/install.js +50 -19
- package/dist/commands/install/uninstall.js +82 -55
- package/dist/commands/install/upgrade.js +21 -11
- package/dist/commands/land.js +137 -17
- package/dist/commands/lib.js +295 -21
- package/dist/commands/registry.js +10 -2
- package/dist/commands/setup/setup.js +8 -7
- package/dist/commands/stats.js +175 -0
- package/dist/commands/tips.js +7 -3
- package/dist/commands/workflow/branches.js +1873 -152
- package/dist/commands/workflow/challenge.js +609 -0
- package/dist/commands/workflow/completeness.js +97 -0
- package/dist/commands/workflow/context.js +1045 -46
- package/dist/commands/workflow/counters.js +385 -86
- package/dist/commands/workflow/decisions.js +484 -0
- package/dist/commands/workflow/disk.js +214 -56
- package/dist/commands/workflow/fids.js +706 -33
- package/dist/commands/workflow/issues.js +349 -59
- package/dist/commands/workflow/ledgers.js +1123 -37
- package/dist/commands/workflow/locks.js +26 -2
- package/dist/commands/workflow/plan-blocks.js +501 -0
- package/dist/commands/workflow/plan-versions.js +22 -0
- package/dist/commands/workflow/plans.js +205 -0
- package/dist/commands/workflow/prs.js +154 -35
- package/dist/commands/workflow/repo.js +58 -8
- package/dist/commands/workflow/roadmap.js +58 -23
- package/dist/commands/workflow/run-facts.js +421 -0
- package/dist/commands/workflow/runs.js +670 -72
- package/dist/commands/workflow/runtime.js +15 -1
- package/dist/commands/workflow/skills.js +1 -0
- package/dist/commands/workflow/status.js +282 -34
- package/dist/commands/workflow/step-table.js +308 -0
- package/dist/commands/workflow/steps.js +703 -96
- package/dist/commands/workflow/summary-findings.js +117 -0
- package/dist/commands/workflow/summary.js +388 -0
- package/dist/commands/workflow/tasks.js +378 -0
- package/dist/commands/workflow/test-blocks.js +231 -0
- package/dist/commands/workflow/tests-changed.js +172 -0
- package/dist/commands/workflow/tests.js +1695 -305
- package/dist/commands/workflow/tracker.js +983 -0
- package/dist/commands/workflow/workflows.js +1014 -222
- package/dist/commands/workflow/worktrees.js +432 -26
- package/dist/install/cloud-env.js +233 -99
- package/dist/install/context-ci-workflow.js +85 -0
- package/dist/install/manifest.js +64 -17
- package/dist/install/modules/antigravity.js +3 -2
- package/dist/install/modules/cloud.js +25 -16
- package/dist/install/modules/codex.js +12 -2
- package/dist/install/modules/core.js +1090 -48
- package/dist/install/modules/cursor.js +6 -6
- package/dist/install/modules/opencode.js +13 -7
- package/dist/install/template-notes.js +116 -0
- package/dist/install/version-file.js +9 -4
- package/dist/ledgers/compact.js +87 -0
- package/dist/ledgers/journal.js +233 -0
- package/dist/ledgers/migrate.js +81 -0
- package/dist/ledgers/status.js +176 -13
- package/dist/ledgers/telemetry.js +1010 -125
- package/dist/render/hosts.js +104 -14
- package/dist/render/models.js +12 -0
- package/dist/shared/bkit-latest.js +26 -4
- package/dist/shared/branches.js +3 -1
- package/dist/shared/dep-updater.js +49 -0
- package/dist/shared/egress.js +8 -1
- package/dist/shared/json.js +20 -7
- package/dist/shared/package-manager.js +6 -0
- package/dist/shared/settings.js +181 -24
- package/dist/shared/text.js +333 -0
- package/dist/shared/timeouts.js +2 -0
- package/dist/tools/cli-doc.js +97 -0
- package/dist/tools/grammar-density.js +183 -0
- package/dist/tools/instructions-sources.js +720 -0
- package/dist/tools/instructions.js +1623 -0
- package/package.json +156 -51
- package/.bkit/core/.bkit/lite.md +0 -73
- package/.bkit/core/engine/commands/harvest.ts +0 -459
- package/.bkit/core/engine/commands/workflow/workstreams.ts +0 -166
- package/.bkit/core/engine/tools/wording.ts +0 -748
- package/.bkit/core/prompts/bkit-build-challenge-reconcile.md +0 -69
- package/.bkit/core/prompts/bkit-build-challenge-remediate.md +0 -71
- package/.bkit/core/prompts/bkit-build-challenge-tests.md +0 -74
- package/.bkit/core/prompts/bkit-build-plan-execute.md +0 -76
- package/.bkit/core/prompts/bkit-build-summary.md +0 -94
- package/.bkit/core/prompts/bkit-debug-summary.md +0 -96
- package/.bkit/core/prompts/bkit-design-summary.md +0 -107
- package/.bkit/core/prompts/bkit-plan-complexity-check.md +0 -67
- package/.bkit/core/prompts/bkit-plan-complexity-split.md +0 -88
- package/.bkit/core/prompts/bkit-plan-review-3.md +0 -93
- package/.bkit/core/prompts/bkit-plan-scope-check-1.md +0 -85
- package/.bkit/core/prompts/bkit-plan-scope-check-2.md +0 -85
- package/.bkit/core/prompts/bkit-plan-summary.md +0 -107
- package/.bkit/core/prompts/bkit-ship-summary.md +0 -78
- package/.bkit/templates/scripts/ci/bkit-local-stack-lock.sh +0 -194
- package/dist/commands/harvest.js +0 -353
- package/dist/commands/workflow/workstreams.js +0 -143
- package/dist/tools/wording.js +0 -680
- /package/.bkit/templates/.vale/styles/{House → Bkit}/Filler.yml +0 -0
- /package/.bkit/templates/.vale/styles/{House → Bkit}/Hedging.yml +0 -0
- /package/.bkit/templates/.vale/styles/{House → Bkit}/LLMSlop.yml +0 -0
- /package/.bkit/templates/.vale/styles/{House → Bkit}/Verbose.yml +0 -0
- /package/.bkit/templates/scripts/ci/{accepted-advisories.json → bkit-accepted-advisories.json} +0 -0
- /package/.bkit/templates/scripts/ci/{accepted-divergences.json → bkit-accepted-divergences.json} +0 -0
- /package/.bkit/templates/scripts/launchd/{launchd.env.example → bkit-launchd.env.example} +0 -0
- /package/.bkit/templates/scripts/launchd/{ai.bkit.launchd.plist → bkit-launchd.plist} +0 -0
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");
|
|
@@ -110,6 +192,7 @@ export function applyOpencodeAgent(content, opencodeModelLookup, effortMap, prov
|
|
|
110
192
|
const description = parsed.get("description") ?? "";
|
|
111
193
|
const effort = parsed.get("effort");
|
|
112
194
|
const toolsBlock = extractFrontmatterField(fmBlock, "tools");
|
|
195
|
+
// autoCompactWindow dropped: no per-agent setting, see providers.md § Context compaction.
|
|
113
196
|
let newFm = "---\n";
|
|
114
197
|
newFm += `mode: subagent\n`;
|
|
115
198
|
newFm += `name: ${name}\n`;
|
|
@@ -120,13 +203,14 @@ export function applyOpencodeAgent(content, opencodeModelLookup, effortMap, prov
|
|
|
120
203
|
else {
|
|
121
204
|
newFm += `description: ${description}\n`;
|
|
122
205
|
}
|
|
123
|
-
// Thinking effort is a model variant in its own `variant:` field.
|
|
124
|
-
//
|
|
125
|
-
//
|
|
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).
|
|
126
210
|
const modelPin = formatModelPin("opencode", provider ?? "", opencodeModel);
|
|
127
211
|
newFm += `model: ${modelPin}\n`;
|
|
128
212
|
const variant = provider !== "ollama" && effort && effortMap
|
|
129
|
-
? lookupEffort(effortMap,
|
|
213
|
+
? clampOpencodeVariant(provider ?? "", opencodeModel, lookupEffort(effortMap, opencodeEffortProgram(opencodeModel), effort))
|
|
130
214
|
: null;
|
|
131
215
|
if (variant)
|
|
132
216
|
newFm += `variant: ${variant}\n`;
|
|
@@ -195,6 +279,7 @@ export function applyCodexAgent(content, codexModelLookup, effortMap) {
|
|
|
195
279
|
const { afterFm, parsed, name, model } = subagent;
|
|
196
280
|
const body = afterFm.trim();
|
|
197
281
|
const effort = parsed.get("effort");
|
|
282
|
+
// autoCompactWindow dropped: a role file's model_auto_compact_token_limit is discarded (openai/codex core/src/agent/role.rs:37-48).
|
|
198
283
|
let out = "";
|
|
199
284
|
out += tomlString("name", name);
|
|
200
285
|
out += tomlString("description", parsed.get("description") ?? "");
|
|
@@ -358,6 +443,7 @@ export function applyT3(content, modelLookup, effortMap) {
|
|
|
358
443
|
const description = parsed.get("description") ?? "";
|
|
359
444
|
const effort = parsed.get("effort");
|
|
360
445
|
const toolsBlock = extractFrontmatterField(fmBlock, "tools");
|
|
446
|
+
// autoCompactWindow dropped: no per-agent setting, see providers.md § Context compaction.
|
|
361
447
|
let newFm = "---\n";
|
|
362
448
|
newFm += `name: ${name}\n`;
|
|
363
449
|
if (description.includes("\n")) {
|
|
@@ -421,6 +507,7 @@ export function applyAntigravityPrompt(content, modelLookup, effortMap) {
|
|
|
421
507
|
const description = parsed.get("description") ?? "";
|
|
422
508
|
const effort = parsed.get("effort");
|
|
423
509
|
const toolsBlock = extractFrontmatterField(fmBlock, "tools");
|
|
510
|
+
// autoCompactWindow dropped: no per-agent setting, see providers.md § Context compaction.
|
|
424
511
|
let newFm = "---\n";
|
|
425
512
|
newFm += `name: ${name}\n`;
|
|
426
513
|
if (description.includes("\n")) {
|
|
@@ -432,7 +519,10 @@ export function applyAntigravityPrompt(content, modelLookup, effortMap) {
|
|
|
432
519
|
}
|
|
433
520
|
newFm += `model: ${formatModelPin("antigravity", "google", model)}\n`;
|
|
434
521
|
if (effort && effortMap) {
|
|
435
|
-
|
|
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`;
|
|
436
526
|
}
|
|
437
527
|
newFm += antigravityToolsBlock(toolsBlock);
|
|
438
528
|
newFm += "---\n";
|
package/dist/render/models.js
CHANGED
|
@@ -189,6 +189,18 @@ export function applyModelOverrides(lookup, providerKey, overridesPath) {
|
|
|
189
189
|
}
|
|
190
190
|
}
|
|
191
191
|
}
|
|
192
|
+
/**
|
|
193
|
+
* Override rows (from `overridesPath`) naming no agent in `known`, deduplicated in file
|
|
194
|
+
* order. `applyModelOverrides` skips such rows, so they are reported, not applied.
|
|
195
|
+
*/
|
|
196
|
+
export function unknownModelOverrides(overridesPath, known) {
|
|
197
|
+
const out = [];
|
|
198
|
+
for (const o of parseModelOverrides(overridesPath)) {
|
|
199
|
+
if (!known.has(o.prompt) && !out.includes(o.prompt))
|
|
200
|
+
out.push(o.prompt);
|
|
201
|
+
}
|
|
202
|
+
return out;
|
|
203
|
+
}
|
|
192
204
|
// column → (sourceEffort → target)
|
|
193
205
|
/**
|
|
194
206
|
* Program → prompts.md effort-table column header.
|
|
@@ -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) {
|
package/dist/shared/branches.js
CHANGED
|
@@ -5,7 +5,9 @@
|
|
|
5
5
|
// this one rule.
|
|
6
6
|
/** The integration branch feature work lands on. */
|
|
7
7
|
export const DEV = "dev";
|
|
8
|
+
/** The release branch: bkit never opens a PR into it or merges into it. */
|
|
9
|
+
export const MAIN = "main";
|
|
8
10
|
/** True for `dev` and `main`: no feature work happens on them, no force-push touches them. */
|
|
9
11
|
export function isSharedBranch(branch) {
|
|
10
|
-
return branch === DEV || branch ===
|
|
12
|
+
return branch === DEV || branch === MAIN;
|
|
11
13
|
}
|
|
@@ -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
|
];
|
|
@@ -103,6 +103,13 @@ export const BKIT_EGRESS_SOURCES = [
|
|
|
103
103
|
hosts: ["api.githubcopilot.com"],
|
|
104
104
|
bases: ["githubcopilot.com"],
|
|
105
105
|
},
|
|
106
|
+
// The engine's own tracker calls (`gh api` REST and GraphQL), beside the MCP server.
|
|
107
|
+
{
|
|
108
|
+
id: "tracker-github-api",
|
|
109
|
+
kind: "tracker-mcp",
|
|
110
|
+
hosts: ["api.github.com"],
|
|
111
|
+
bases: ["github.com"],
|
|
112
|
+
},
|
|
106
113
|
{
|
|
107
114
|
id: "mcp-linear",
|
|
108
115
|
kind: "tracker-mcp",
|
package/dist/shared/json.js
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
// shared/json.ts — `JSON.parse` without the throw, for consumer-authored input.
|
|
1
|
+
// shared/json.ts — `JSON.parse` and file reads without the throw, for consumer-authored input.
|
|
2
2
|
//
|
|
3
3
|
// Every read of a file bkit does not own (package.json, .mcp.json, settings JSON,
|
|
4
4
|
// .bkit/version) must fail open into a result the caller reports in its own terms,
|
|
@@ -16,15 +16,28 @@ export function parseJson(raw) {
|
|
|
16
16
|
return { ok: false };
|
|
17
17
|
}
|
|
18
18
|
}
|
|
19
|
-
/**
|
|
20
|
-
export function
|
|
21
|
-
let raw;
|
|
19
|
+
/** The file at `file` as UTF-8 text, or `{ ok: false }` when it cannot be read. */
|
|
20
|
+
export function readTextFile(file) {
|
|
22
21
|
try {
|
|
23
|
-
|
|
22
|
+
return { ok: true, text: fs.readFileSync(file, "utf-8") };
|
|
24
23
|
}
|
|
25
24
|
catch {
|
|
26
|
-
// Missing, unreadable or a directory: the result says so,
|
|
25
|
+
// Missing, unreadable or a directory: the result says so, and the caller reports it.
|
|
27
26
|
return { ok: false };
|
|
28
27
|
}
|
|
29
|
-
|
|
28
|
+
}
|
|
29
|
+
/** The entry names of the directory `dir`, or `{ ok: false }` when it cannot be read. */
|
|
30
|
+
export function readDirNames(dir) {
|
|
31
|
+
try {
|
|
32
|
+
return { ok: true, names: fs.readdirSync(dir) };
|
|
33
|
+
}
|
|
34
|
+
catch {
|
|
35
|
+
// Missing, unreadable or not a directory: the result says so, and the caller reports it.
|
|
36
|
+
return { ok: false };
|
|
37
|
+
}
|
|
38
|
+
}
|
|
39
|
+
/** `parseJson` over the file at `file`; `{ ok: false }` also when the file cannot be read. */
|
|
40
|
+
export function readJsonFile(file) {
|
|
41
|
+
const read = readTextFile(file);
|
|
42
|
+
return read.ok ? parseJson(read.text) : { ok: false };
|
|
30
43
|
}
|
|
@@ -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. */
|
|
@@ -13,6 +14,31 @@ export function parseGithubBoardUrl(url) {
|
|
|
13
14
|
return null;
|
|
14
15
|
return { ownerType: m[1] === "orgs" ? "org" : "user", owner: m[2], number: Number(m[3]) };
|
|
15
16
|
}
|
|
17
|
+
/** Every point a workflow can stop and ask the owner at, as `<workflow>.<point>`. */
|
|
18
|
+
export const ASK_POINTS = [
|
|
19
|
+
"design.grill",
|
|
20
|
+
"build.verify",
|
|
21
|
+
"build.challenge",
|
|
22
|
+
"build.tests",
|
|
23
|
+
"debug.fix",
|
|
24
|
+
"debug.soak",
|
|
25
|
+
"ship.merge",
|
|
26
|
+
];
|
|
27
|
+
/** The limit key a point's block holds. */
|
|
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
|
+
];
|
|
16
42
|
export const CONFIG_DEFAULTS = {
|
|
17
43
|
ciWorkflow: "bkit-ci.yml",
|
|
18
44
|
capstoneJob: "bkit-tests-check",
|
|
@@ -25,14 +51,29 @@ export const CONFIG_DEFAULTS = {
|
|
|
25
51
|
// `started` is a state type every Linear team has; In Review is a name a default team lacks.
|
|
26
52
|
linear: { team: null, project: null, progress: "started", review: "In Review" },
|
|
27
53
|
jira: { site: null, project: null, progress: "In Progress", review: "In Review" },
|
|
28
|
-
|
|
29
|
-
//
|
|
30
|
-
//
|
|
31
|
-
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: [],
|
|
32
60
|
opencodeProvider: null,
|
|
33
61
|
opencodeProviders: [],
|
|
34
62
|
cloudAgents: DEFAULT_CLOUD_AGENTS,
|
|
35
|
-
|
|
63
|
+
// `.bkit/workflows.md` § Ask points.
|
|
64
|
+
asks: {
|
|
65
|
+
"design.grill": { ask: true, max: 6 },
|
|
66
|
+
"build.verify": { ask: true, max: 2 },
|
|
67
|
+
"build.challenge": { ask: true, max: 2 },
|
|
68
|
+
"build.tests": { ask: true, max: 2 },
|
|
69
|
+
"debug.fix": { ask: true, max: 2 },
|
|
70
|
+
"debug.soak": { ask: true, max: 2 },
|
|
71
|
+
"ship.merge": { ask: true, max: 2 },
|
|
72
|
+
},
|
|
73
|
+
// Plan caps, `.bkit/workflows.md` § Test-first.
|
|
74
|
+
tasks: { maxPerGroup: 5, maxTestsPerGroup: 25, maxTestsPerTask: 10, maxTestFilesPerTask: 3 },
|
|
75
|
+
buildPublish: { remote: true, local: true },
|
|
76
|
+
depUpdater: null,
|
|
36
77
|
issueTrackerExplicit: false,
|
|
37
78
|
cloudAgentsExplicit: false,
|
|
38
79
|
};
|
|
@@ -46,6 +87,103 @@ function trackerStates(raw, defaults) {
|
|
|
46
87
|
review: nonEmptyString(raw.review) ? raw.review.trim() : defaults.review,
|
|
47
88
|
};
|
|
48
89
|
}
|
|
90
|
+
const parseDepUpdater = (v) => v === "none" || DEP_UPDATERS.includes(v) ? v : null;
|
|
91
|
+
const TASK_CAP_KEYS = Object.keys(CONFIG_DEFAULTS.tasks);
|
|
92
|
+
const validCap = (v) => Number.isInteger(v) && v >= 1;
|
|
93
|
+
/**
|
|
94
|
+
* The keys of a `bkit.workflows.tasks` value that fall back to their default: each set key
|
|
95
|
+
* that is not an integer >= 1, or `["tasks"]` when the value is set but not an object.
|
|
96
|
+
*/
|
|
97
|
+
export function invalidTaskCaps(raw) {
|
|
98
|
+
if (raw === undefined)
|
|
99
|
+
return [];
|
|
100
|
+
if (raw === null || typeof raw !== "object" || Array.isArray(raw))
|
|
101
|
+
return ["tasks"];
|
|
102
|
+
const set = raw;
|
|
103
|
+
return TASK_CAP_KEYS.filter((k) => set[k] !== undefined && !validCap(set[k]));
|
|
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
|
+
}
|
|
132
|
+
/** `bkit.workflows.tasks` read key by key; a missing or invalid key takes its default. */
|
|
133
|
+
function taskCaps(raw) {
|
|
134
|
+
const set = record(raw);
|
|
135
|
+
const caps = { ...CONFIG_DEFAULTS.tasks };
|
|
136
|
+
for (const k of TASK_CAP_KEYS)
|
|
137
|
+
if (validCap(set[k]))
|
|
138
|
+
caps[k] = set[k];
|
|
139
|
+
return caps;
|
|
140
|
+
}
|
|
141
|
+
/** The `bkit.workflows.<workflow>.<point>` block `workflows` holds for `point`. */
|
|
142
|
+
const askBlock = (workflows, point) => {
|
|
143
|
+
const [workflow, name] = point.split(".");
|
|
144
|
+
const block = workflows[workflow];
|
|
145
|
+
return block !== null && typeof block === "object" && !Array.isArray(block)
|
|
146
|
+
? block[name]
|
|
147
|
+
: undefined;
|
|
148
|
+
};
|
|
149
|
+
/**
|
|
150
|
+
* The dotted keys under `bkit.workflows` that fall back to their default: each set `ask`
|
|
151
|
+
* that is not a boolean, each set limit that is not an integer >= 1, or the point itself
|
|
152
|
+
* when it is set but not an object.
|
|
153
|
+
*/
|
|
154
|
+
export function invalidAskSettings(workflows) {
|
|
155
|
+
const set = record(workflows);
|
|
156
|
+
const bad = [];
|
|
157
|
+
for (const point of ASK_POINTS) {
|
|
158
|
+
const raw = askBlock(set, point);
|
|
159
|
+
if (raw === undefined)
|
|
160
|
+
continue;
|
|
161
|
+
if (raw === null || typeof raw !== "object" || Array.isArray(raw)) {
|
|
162
|
+
bad.push(point);
|
|
163
|
+
continue;
|
|
164
|
+
}
|
|
165
|
+
const block = raw;
|
|
166
|
+
if (block.ask !== undefined && typeof block.ask !== "boolean")
|
|
167
|
+
bad.push(`${point}.ask`);
|
|
168
|
+
const key = limitKey(point);
|
|
169
|
+
if (block[key] !== undefined && !validCap(block[key]))
|
|
170
|
+
bad.push(`${point}.${key}`);
|
|
171
|
+
}
|
|
172
|
+
return bad;
|
|
173
|
+
}
|
|
174
|
+
/** Every ask point read from `bkit.workflows`; a missing or invalid key takes its default. */
|
|
175
|
+
function askSettings(workflows) {
|
|
176
|
+
const out = {};
|
|
177
|
+
for (const point of ASK_POINTS) {
|
|
178
|
+
const block = record(askBlock(workflows, point));
|
|
179
|
+
const limit = block[limitKey(point)];
|
|
180
|
+
out[point] = {
|
|
181
|
+
ask: typeof block.ask === "boolean" ? block.ask : CONFIG_DEFAULTS.asks[point].ask,
|
|
182
|
+
max: validCap(limit) ? limit : CONFIG_DEFAULTS.asks[point].max,
|
|
183
|
+
};
|
|
184
|
+
}
|
|
185
|
+
return out;
|
|
186
|
+
}
|
|
49
187
|
/**
|
|
50
188
|
* Read `package.json` `bkit` from `root` (the main checkout). A missing file,
|
|
51
189
|
* missing key, or wrongly typed value falls back to the default for that key.
|
|
@@ -53,21 +191,32 @@ function trackerStates(raw, defaults) {
|
|
|
53
191
|
export function readBkitConfig(root) {
|
|
54
192
|
// A missing or unparseable package.json takes every default; `bkit check` reports the file.
|
|
55
193
|
const read = readPackageJson(root);
|
|
56
|
-
const bkit = (
|
|
57
|
-
const
|
|
194
|
+
const bkit = record(read.ok ? read.pkg.bkit : undefined);
|
|
195
|
+
const tracker = record(bkit.tracker);
|
|
196
|
+
const cloud = record(bkit.cloud);
|
|
197
|
+
const opencode = record(record(bkit.providers).opencode);
|
|
198
|
+
const testing = record(bkit.testing);
|
|
199
|
+
const workflows = record(bkit.workflows);
|
|
200
|
+
const worktree = record(workflows.worktree);
|
|
201
|
+
const ciSkip = testing.ciSkipPaths;
|
|
202
|
+
const generated = testing.ciGenerated;
|
|
58
203
|
const copy = worktree.copy;
|
|
59
|
-
const minFreeGb =
|
|
60
|
-
const lanes =
|
|
61
|
-
const book =
|
|
62
|
-
const provider =
|
|
63
|
-
const providers =
|
|
64
|
-
const github = record(
|
|
65
|
-
const linear = record(
|
|
66
|
-
const jira = record(
|
|
204
|
+
const minFreeGb = workflows.minFreeGb;
|
|
205
|
+
const lanes = testing.ciRequired;
|
|
206
|
+
const book = testing.minPushPaths;
|
|
207
|
+
const provider = opencode.default;
|
|
208
|
+
const providers = opencode.installed;
|
|
209
|
+
const github = record(tracker.github);
|
|
210
|
+
const linear = record(tracker.linear);
|
|
211
|
+
const jira = record(tracker.jira);
|
|
67
212
|
const projectUrl = optionalString(github.project);
|
|
68
213
|
return {
|
|
69
|
-
ciWorkflow: nonEmptyString(
|
|
70
|
-
|
|
214
|
+
ciWorkflow: nonEmptyString(testing.ciWorkflow)
|
|
215
|
+
? testing.ciWorkflow
|
|
216
|
+
: CONFIG_DEFAULTS.ciWorkflow,
|
|
217
|
+
capstoneJob: nonEmptyString(testing.ciCapstone)
|
|
218
|
+
? testing.ciCapstone
|
|
219
|
+
: CONFIG_DEFAULTS.capstoneJob,
|
|
71
220
|
worktreeCopy: Array.isArray(copy) && copy.every(nonEmptyString)
|
|
72
221
|
? [...copy]
|
|
73
222
|
: [...CONFIG_DEFAULTS.worktreeCopy],
|
|
@@ -75,7 +224,7 @@ export function readBkitConfig(root) {
|
|
|
75
224
|
diskMinFreeGb: typeof minFreeGb === "number" && Number.isFinite(minFreeGb) && minFreeGb >= 0
|
|
76
225
|
? minFreeGb
|
|
77
226
|
: CONFIG_DEFAULTS.diskMinFreeGb,
|
|
78
|
-
issueTracker: parseIssueTracker(
|
|
227
|
+
issueTracker: parseIssueTracker(tracker.default) ?? CONFIG_DEFAULTS.issueTracker,
|
|
79
228
|
github: {
|
|
80
229
|
project: github.project === false ? false : projectUrl ? parseGithubBoardUrl(projectUrl) : null,
|
|
81
230
|
projectUrl,
|
|
@@ -91,21 +240,29 @@ export function readBkitConfig(root) {
|
|
|
91
240
|
project: optionalString(jira.project),
|
|
92
241
|
...trackerStates(jira, CONFIG_DEFAULTS.jira),
|
|
93
242
|
},
|
|
94
|
-
|
|
95
|
-
// An explicit [] is kept: it switches the min push off.
|
|
243
|
+
ciRequired: Array.isArray(lanes) ? lanes.filter(nonEmptyString) : [],
|
|
96
244
|
minPushPaths: Array.isArray(book)
|
|
97
245
|
? book.filter(nonEmptyString)
|
|
98
246
|
: [...CONFIG_DEFAULTS.minPushPaths],
|
|
247
|
+
ciSkipPaths: Array.isArray(ciSkip) ? ciSkip.filter(nonEmptyString) : [],
|
|
248
|
+
ciGenerated: Array.isArray(generated) ? generated.filter(nonEmptyString) : [],
|
|
99
249
|
opencodeProvider: typeof provider === "string" && isOpencodeProvider(provider) ? provider : null,
|
|
100
250
|
opencodeProviders: Array.isArray(providers)
|
|
101
251
|
? providers.filter((v) => typeof v === "string" && isOpencodeProvider(v))
|
|
102
252
|
: [],
|
|
103
|
-
cloudAgents: parseCloudAgents(
|
|
104
|
-
|
|
105
|
-
|
|
106
|
-
|
|
253
|
+
cloudAgents: parseCloudAgents(cloud.agent) ?? CONFIG_DEFAULTS.cloudAgents,
|
|
254
|
+
asks: askSettings(workflows),
|
|
255
|
+
tasks: taskCaps(workflows.tasks),
|
|
256
|
+
buildPublish: buildPublish(record(workflows.build).publish),
|
|
257
|
+
depUpdater: parseDepUpdater(record(bkit.dependencies).updater),
|
|
258
|
+
issueTrackerExplicit: tracker.default !== undefined && tracker.default !== "",
|
|
259
|
+
cloudAgentsExplicit: cloud.agent !== undefined && cloud.agent !== "",
|
|
107
260
|
};
|
|
108
261
|
}
|
|
262
|
+
/** The CI workflow file `bkit.testing.ciWorkflow` names, as `.github/workflows/<file>` relative to `root`. */
|
|
263
|
+
export function ciWorkflowPath(root) {
|
|
264
|
+
return `.github/workflows/${readBkitConfig(root).ciWorkflow}`;
|
|
265
|
+
}
|
|
109
266
|
export function trackerScope(cfg) {
|
|
110
267
|
const none = { trackerTeam: null, trackerProject: null, trackerSite: null, trackerBoard: null };
|
|
111
268
|
if (cfg.issueTracker === "github")
|