@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
|
@@ -180,7 +180,7 @@ export async function runDoctor(
|
|
|
180
180
|
id: "opencode-provider-missing",
|
|
181
181
|
severity: "blocker",
|
|
182
182
|
detect:
|
|
183
|
-
"`.opencode/` is present but no provider is recorded — neither package.json `bkit.
|
|
183
|
+
"`.opencode/` is present but no provider is recorded — neither package.json `bkit.providers.opencode.default` nor an `opencode.json` provider block.",
|
|
184
184
|
action: `Re-run \`bkit install --opencode=<provider>\` (${OPENCODE_PROVIDERS.join(", ")}). Until then \`bkit check\` and \`bkit upgrade\` exit 1 rather than render every agent pin against a substitute provider.`,
|
|
185
185
|
});
|
|
186
186
|
}
|
|
@@ -222,7 +222,7 @@ export async function runDoctor(
|
|
|
222
222
|
let detectedProvider: string | null = detectOpencodeProvider(process.cwd());
|
|
223
223
|
if (opencodeProvider) detectedProvider = opencodeProvider;
|
|
224
224
|
|
|
225
|
-
// Multi-provider: all installed providers. bkit.
|
|
225
|
+
// Multi-provider: all installed providers. bkit.providers.opencode.installed when populated,
|
|
226
226
|
// else the single detected provider.
|
|
227
227
|
const allProviders = detectOpencodeProviders(process.cwd());
|
|
228
228
|
const activeProvider = detectedProvider ?? allProviders[0] ?? null;
|
|
@@ -32,11 +32,17 @@ import {
|
|
|
32
32
|
type EffortMap,
|
|
33
33
|
parseModelLookup,
|
|
34
34
|
applyModelOverrides,
|
|
35
|
+
unknownModelOverrides,
|
|
35
36
|
buildOpencodeModelLookup,
|
|
36
37
|
buildAntigravityModelLookup,
|
|
37
38
|
parseEffortMap,
|
|
38
39
|
} from "../../render/models.js";
|
|
39
40
|
import { getBkitDocsRoot } from "../../shared/package-roots.js";
|
|
41
|
+
import {
|
|
42
|
+
migrateBkitLayout,
|
|
43
|
+
migrateGithubProjectKey,
|
|
44
|
+
migrateLinearTeamKey,
|
|
45
|
+
} from "../../install/modules/core.js";
|
|
40
46
|
import type { WriteSet } from "../../install/write.js";
|
|
41
47
|
import { type UninstallContext, removeUnusedTrackerMcpEntries, runUninstall } from "./uninstall.js";
|
|
42
48
|
|
|
@@ -68,7 +74,7 @@ export function discardAllStaging(cwd = process.cwd()): void {
|
|
|
68
74
|
* The installed opencode provider, or exit(1) with the fix.
|
|
69
75
|
*
|
|
70
76
|
* `bkit check` / `bkit upgrade` take no `--opencode=` flag, so they read the provider the
|
|
71
|
-
* consumer actually installed (package.json `bkit.
|
|
77
|
+
* consumer actually installed (package.json `bkit.providers.opencode.default`, else the opencode.json
|
|
72
78
|
* provider block). There is no default: a repo carrying `.opencode/` with no recorded
|
|
73
79
|
* provider is a broken install.
|
|
74
80
|
*
|
|
@@ -79,7 +85,7 @@ export function requireOpencodeProvider(cwd: string, context: string): string {
|
|
|
79
85
|
if (!detected) {
|
|
80
86
|
console.error(
|
|
81
87
|
`${LOG_PREFIX} ${context}: the opencode host is installed but no provider is recorded ` +
|
|
82
|
-
`(package.json \`bkit.
|
|
88
|
+
`(package.json \`bkit.providers.opencode.default\` and .opencode/opencode.json are both silent). ` +
|
|
83
89
|
`Re-run \`bkit install --opencode=<provider>\` — one of ${OPENCODE_PROVIDERS.join(", ")}.`,
|
|
84
90
|
);
|
|
85
91
|
process.exit(1);
|
|
@@ -131,11 +137,20 @@ export function validateCloudTrackerMatch(
|
|
|
131
137
|
);
|
|
132
138
|
}
|
|
133
139
|
|
|
140
|
+
/** `parent[key]` as an object, set to a fresh `{}` first when it is absent or not an object. */
|
|
141
|
+
function section(parent: Record<string, unknown>, key: string): Record<string, unknown> {
|
|
142
|
+
const v = parent[key];
|
|
143
|
+
if (v !== null && typeof v === "object" && !Array.isArray(v)) return v as Record<string, unknown>;
|
|
144
|
+
const fresh: Record<string, unknown> = {};
|
|
145
|
+
parent[key] = fresh;
|
|
146
|
+
return fresh;
|
|
147
|
+
}
|
|
148
|
+
|
|
134
149
|
/**
|
|
135
150
|
* Detect the bkit opencode provider key a consumer installed.
|
|
136
151
|
*
|
|
137
152
|
* Resolution order:
|
|
138
|
-
* 1. `package.json` `bkit.
|
|
153
|
+
* 1. `package.json` `bkit.providers.opencode.default` — the authoritative record written on install.
|
|
139
154
|
* This is the ONLY signal for managed-auth gateways (opencode) whose opencode.json carries no
|
|
140
155
|
* custom provider block.
|
|
141
156
|
* 2. `.opencode/opencode.json` first provider key — for installs without the manifest field
|
|
@@ -165,7 +180,7 @@ export function detectOpencodeProvider(cwd: string): string | null {
|
|
|
165
180
|
|
|
166
181
|
/**
|
|
167
182
|
* Returns all bkit-installed opencode providers from the consumer package.json
|
|
168
|
-
* `bkit.
|
|
183
|
+
* `bkit.providers.opencode.installed` array, filtered to valid OPENCODE_PROVIDERS entries; [] when
|
|
169
184
|
* the field is absent.
|
|
170
185
|
*/
|
|
171
186
|
export function detectOpencodeProviders(cwd: string): string[] {
|
|
@@ -227,6 +242,18 @@ export async function runInstall(
|
|
|
227
242
|
if (upgradeReport) console.log(`${LOG_PREFIX} Checking advisories (read-only)`);
|
|
228
243
|
else if (dryRun) console.log(`${LOG_PREFIX} Running in check (dry-run) mode`);
|
|
229
244
|
|
|
245
|
+
// The package.json key moves run before anything below reads `bkit` settings: the tracker,
|
|
246
|
+
// the opencode provider and the cloud agent are read from the new paths only, so a 5.x
|
|
247
|
+
// layout read first renders every host as if no tracker were set. The core module runs
|
|
248
|
+
// the same moves again; each is a no-op once applied. Check moves nothing and reports
|
|
249
|
+
// the old keys as drift.
|
|
250
|
+
const ws: WriteSet = { writes: [] };
|
|
251
|
+
if (!dryRun) {
|
|
252
|
+
migrateLinearTeamKey(false, ws, LOG_PREFIX);
|
|
253
|
+
migrateGithubProjectKey(false, ws, LOG_PREFIX);
|
|
254
|
+
migrateBkitLayout(false, ws, LOG_PREFIX);
|
|
255
|
+
}
|
|
256
|
+
|
|
230
257
|
// `bkit check` scopes drift detection to what is INSTALLED (detected by sentinel files),
|
|
231
258
|
// not to a fixed full set. `install` keeps its explicit resolved set, plus every installed
|
|
232
259
|
// host when `--tracker=` is given: each host renders tracker-specific commands, agents and
|
|
@@ -240,14 +267,14 @@ export async function runInstall(
|
|
|
240
267
|
|
|
241
268
|
// RENDER-input provider resolution. `bkit check` takes no `--opencode=` flag, so the parsed
|
|
242
269
|
// `opencodeProvider` is null on the check path; it falls back to the INSTALLED provider
|
|
243
|
-
// (package.json `bkit.
|
|
270
|
+
// (package.json `bkit.providers.opencode.default`, else the opencode.json provider block). On install
|
|
244
271
|
// `?? detect` fires only when opencode joins as an installed host under `--tracker=`; with
|
|
245
272
|
// `--opencode=<provider>` the flag wins. The PARSED `opencodeProvider` alone drives the persist-to-package.json logic
|
|
246
273
|
// below (gated on `!dryRun` + a real flag). The tracker is resolved from package.json below,
|
|
247
274
|
// so the tracker-dependent opencode mcp block renders the same way on check.
|
|
248
275
|
const renderOpencodeProvider = opencodeProvider ?? detectOpencodeProvider(process.cwd());
|
|
249
276
|
|
|
250
|
-
// Resolve issueTracker: --tracker= flag overrides; else read bkit.
|
|
277
|
+
// Resolve issueTracker: --tracker= flag overrides; else read bkit.tracker.default from consumer
|
|
251
278
|
// package.json; else default to "none".
|
|
252
279
|
// A `--tracker=` value always applies, whether first-set or a re-set of an
|
|
253
280
|
// already-recorded tracker.
|
|
@@ -344,8 +371,20 @@ export async function runInstall(
|
|
|
344
371
|
|
|
345
372
|
// Seed preflight advisories into ctx so modules can accumulate into the same list.
|
|
346
373
|
const advisories: PreflightFinding[] = [...preflightAdvisories];
|
|
374
|
+
const deadOverrides =
|
|
375
|
+
modelLookup.size > 0
|
|
376
|
+
? unknownModelOverrides(consumerPromptsMdPath, new Set(modelLookup.keys()))
|
|
377
|
+
: [];
|
|
378
|
+
if (deadOverrides.length > 0) {
|
|
379
|
+
advisories.push({
|
|
380
|
+
id: "model-override-unknown-agent",
|
|
381
|
+
severity: "advisory",
|
|
382
|
+
detect: `.bkit/prompts.md § Model Overrides names agents bkit no longer ships: ${deadOverrides.join(", ")}. Those rows are not applied.`,
|
|
383
|
+
action:
|
|
384
|
+
"Delete the rows, or move each pin to the agent that now does that work (see .bkit/prompts.md § Models).",
|
|
385
|
+
});
|
|
386
|
+
}
|
|
347
387
|
|
|
348
|
-
const ws: WriteSet = { writes: [] };
|
|
349
388
|
const postDispatch: Array<() => void> = [];
|
|
350
389
|
|
|
351
390
|
// Symmetric cloud/tracker constraint (FINAL SCOPE decision 3/4) — see
|
|
@@ -375,8 +414,8 @@ export async function runInstall(
|
|
|
375
414
|
|
|
376
415
|
// Persist bkit manifest fields to consumer package.json AFTER all hard-error gates pass.
|
|
377
416
|
// This preserves the "no files written on mismatch" invariant. Two fields are recorded:
|
|
378
|
-
// -
|
|
379
|
-
// -
|
|
417
|
+
// - tracker.default: when a `--tracker=` value was given this run.
|
|
418
|
+
// - providers.opencode.default: when an `--opencode=<provider>` value was given this run. This is
|
|
380
419
|
// the authoritative provider record detectOpencodeProvider reads on upgrade — REQUIRED
|
|
381
420
|
// for managed-auth gateways (opencode), whose opencode.json carries no provider block to
|
|
382
421
|
// detect from. Both are merged in one read-modify-write to avoid double-writing.
|
|
@@ -391,20 +430,20 @@ export async function runInstall(
|
|
|
391
430
|
const parsed = parseJson(raw);
|
|
392
431
|
if (parsed.ok) {
|
|
393
432
|
const pkg = parsed.value as Record<string, unknown>;
|
|
394
|
-
const bkit = (pkg
|
|
395
|
-
if (persistTracker) bkit.
|
|
433
|
+
const bkit = section(pkg, "bkit");
|
|
434
|
+
if (persistTracker) section(bkit, "tracker").default = tracker;
|
|
396
435
|
if (persistProvider) {
|
|
397
|
-
|
|
436
|
+
const opencode = section(section(bkit, "providers"), "opencode");
|
|
437
|
+
opencode.default = opencodeProvider; // active (drives agent frontmatter)
|
|
398
438
|
// Update providers array (deduped).
|
|
399
|
-
const existingArr: string[] = Array.isArray(
|
|
400
|
-
? [...(
|
|
439
|
+
const existingArr: string[] = Array.isArray(opencode.installed)
|
|
440
|
+
? [...(opencode.installed as string[])]
|
|
401
441
|
: [];
|
|
402
442
|
if (!existingArr.includes(opencodeProvider!)) {
|
|
403
443
|
existingArr.push(opencodeProvider!);
|
|
404
444
|
}
|
|
405
|
-
|
|
445
|
+
opencode.installed = existingArr;
|
|
406
446
|
}
|
|
407
|
-
pkg.bkit = bkit;
|
|
408
447
|
const indentMatch = raw.match(/\n([ \t]+)"/);
|
|
409
448
|
const indent = indentMatch ? indentMatch[1] : " ";
|
|
410
449
|
const trailingNewline = raw.endsWith("\n") ? "\n" : "";
|
|
@@ -414,11 +453,11 @@ export async function runInstall(
|
|
|
414
453
|
"utf-8",
|
|
415
454
|
);
|
|
416
455
|
if (persistTracker) {
|
|
417
|
-
console.log(`${LOG_PREFIX} Set bkit.
|
|
456
|
+
console.log(`${LOG_PREFIX} Set bkit.tracker.default = "${tracker}" in package.json`);
|
|
418
457
|
}
|
|
419
458
|
if (persistProvider) {
|
|
420
459
|
console.log(
|
|
421
|
-
`${LOG_PREFIX} Set bkit.
|
|
460
|
+
`${LOG_PREFIX} Set bkit.providers.opencode.default = "${opencodeProvider}" and updated bkit.providers.opencode.installed in package.json`,
|
|
422
461
|
);
|
|
423
462
|
}
|
|
424
463
|
}
|
|
@@ -61,8 +61,10 @@ import {
|
|
|
61
61
|
} from "../../render/models.js";
|
|
62
62
|
import { readInstallingVersion } from "../../shared/package-json.js";
|
|
63
63
|
import { readBkitConfig } from "../../shared/settings.js";
|
|
64
|
+
import { SEEDED_BKIT_DEFAULTS } from "../../install/modules/core.js";
|
|
64
65
|
import {
|
|
65
66
|
CLAUDE_CLOUD_RELPATH,
|
|
67
|
+
CODEX_CLOUD_RELPATH,
|
|
66
68
|
CURSOR_CLOUD_RELPATH,
|
|
67
69
|
resolveClaudeDerivedAllows,
|
|
68
70
|
} from "../../install/cloud-env.js";
|
|
@@ -377,8 +379,10 @@ const CORE_TEMPLATE_DOCTRINE: ManifestEntry[] = [
|
|
|
377
379
|
{ path: ".agents/docs.md", format: "markered-text", module: "core" },
|
|
378
380
|
{ path: ".agents/rules.md", format: "markered-text", module: "core" },
|
|
379
381
|
{ path: ".agents/skills.md", format: "markered-text", module: "core" },
|
|
380
|
-
// Retired
|
|
382
|
+
// Retired `.agents/shortcuts.md` (5.1.0 – 5.2.4), for an install never upgraded since.
|
|
381
383
|
{ path: ".agents/shortcuts.md", format: "markered-text", module: "core" },
|
|
384
|
+
// Retired `.bkit/lite.md` (5.2.5 – 6.0.0), for an install never upgraded since.
|
|
385
|
+
{ path: ".bkit/lite.md", format: "markered-text", module: "core" },
|
|
382
386
|
];
|
|
383
387
|
|
|
384
388
|
/**
|
|
@@ -818,7 +822,7 @@ export async function runUninstall(
|
|
|
818
822
|
}
|
|
819
823
|
|
|
820
824
|
// Full/core uninstall: strip the `bkit` install-state object from package.json
|
|
821
|
-
// (
|
|
825
|
+
// (tracker / providers / cloud and every other section), whatever keys it holds. Scripts
|
|
822
826
|
// and devDeps are the consumer's and stay. No try/catch — malformed package.json is a hard failure on full
|
|
823
827
|
// teardown (same as a missing dest would be).
|
|
824
828
|
if (moduleList.includes("core") && !ctx.dryRun) {
|
|
@@ -834,8 +838,8 @@ export async function runUninstall(
|
|
|
834
838
|
}
|
|
835
839
|
}
|
|
836
840
|
|
|
837
|
-
// Targeted uninstall:
|
|
838
|
-
// stop firing. Core keeps every other key.
|
|
841
|
+
// Targeted uninstall: reset the `bkit.*` keys the removed module records to unset, so its
|
|
842
|
+
// advisories stop firing. Core keeps every other key.
|
|
839
843
|
if (!moduleList.includes("core")) {
|
|
840
844
|
stripModuleBkitKeys(moduleList, ctx, result);
|
|
841
845
|
}
|
|
@@ -909,32 +913,23 @@ export async function runUninstall(
|
|
|
909
913
|
}
|
|
910
914
|
}
|
|
911
915
|
|
|
912
|
-
// Remove
|
|
913
|
-
// secrets).
|
|
914
|
-
//
|
|
915
|
-
//
|
|
916
|
-
|
|
917
|
-
|
|
918
|
-
|
|
919
|
-
|
|
920
|
-
|
|
921
|
-
|
|
922
|
-
|
|
923
|
-
|
|
924
|
-
|
|
925
|
-
|
|
926
|
-
|
|
927
|
-
|
|
928
|
-
|
|
929
|
-
// uninstalled so a live-secrets file is never left behind.
|
|
930
|
-
if (moduleList.includes("cursor")) {
|
|
931
|
-
const cloudAbs = path.join(ctx.cwd, CURSOR_CLOUD_RELPATH);
|
|
932
|
-
if (fs.existsSync(cloudAbs)) {
|
|
933
|
-
result.deleted.push(CURSOR_CLOUD_RELPATH);
|
|
934
|
-
if (!ctx.dryRun) {
|
|
935
|
-
fs.rmSync(cloudAbs, { force: true });
|
|
936
|
-
console.log(`${ctx.logPrefix} delete: ${CURSOR_CLOUD_RELPATH} (generated cloud setup doc)`);
|
|
937
|
-
}
|
|
916
|
+
// Remove each uninstalled host's generated `<host>/bkit-cloud.md` (untracked,
|
|
917
|
+
// gitignored — holds resolved secrets). Not in the manifest, so the table-driven pass
|
|
918
|
+
// never sees them; delete explicitly so a live-secrets file is never left behind.
|
|
919
|
+
// Pushed to result.deleted so a dry-run reports them too.
|
|
920
|
+
const cloudDocs: ReadonlyArray<readonly [ModuleFlag, string]> = [
|
|
921
|
+
["claude", CLAUDE_CLOUD_RELPATH],
|
|
922
|
+
["cursor", CURSOR_CLOUD_RELPATH],
|
|
923
|
+
["codex", CODEX_CLOUD_RELPATH],
|
|
924
|
+
];
|
|
925
|
+
for (const [host, relPath] of cloudDocs) {
|
|
926
|
+
if (!moduleList.includes(host)) continue;
|
|
927
|
+
const cloudAbs = path.join(ctx.cwd, relPath);
|
|
928
|
+
if (!fs.existsSync(cloudAbs)) continue;
|
|
929
|
+
result.deleted.push(relPath);
|
|
930
|
+
if (!ctx.dryRun) {
|
|
931
|
+
fs.rmSync(cloudAbs, { force: true });
|
|
932
|
+
console.log(`${ctx.logPrefix} delete: ${relPath} (generated cloud setup doc)`);
|
|
938
933
|
}
|
|
939
934
|
}
|
|
940
935
|
|
|
@@ -1035,16 +1030,38 @@ export async function runUninstall(
|
|
|
1035
1030
|
return result;
|
|
1036
1031
|
}
|
|
1037
1032
|
|
|
1038
|
-
/** `package.json` `bkit.*` keys each module records on install. */
|
|
1033
|
+
/** `package.json` `bkit.*` keys (dotted paths) each module records on install. */
|
|
1039
1034
|
const MODULE_BKIT_KEYS: Partial<Record<ModuleName, readonly string[]>> = {
|
|
1040
|
-
cloud: ["
|
|
1041
|
-
opencode: ["
|
|
1035
|
+
cloud: ["cloud.agent"],
|
|
1036
|
+
opencode: ["providers.opencode.default", "providers.opencode.installed"],
|
|
1042
1037
|
};
|
|
1043
1038
|
|
|
1039
|
+
/** The object at dotted `keys` under `root`; null when a step is absent or not an object. */
|
|
1040
|
+
function objectAt(
|
|
1041
|
+
root: Record<string, unknown>,
|
|
1042
|
+
keys: readonly string[],
|
|
1043
|
+
): Record<string, unknown> | null {
|
|
1044
|
+
let node: Record<string, unknown> = root;
|
|
1045
|
+
for (const k of keys) {
|
|
1046
|
+
const next = node[k];
|
|
1047
|
+
if (!isJsonObject(next as JsonValue)) return null;
|
|
1048
|
+
node = next as Record<string, unknown>;
|
|
1049
|
+
}
|
|
1050
|
+
return node;
|
|
1051
|
+
}
|
|
1052
|
+
|
|
1053
|
+
/** The seeded value at dotted `key` in SEEDED_BKIT_DEFAULTS, copied. */
|
|
1054
|
+
function seededValue(key: string): unknown {
|
|
1055
|
+
const segs = key.split(".");
|
|
1056
|
+
const parent = objectAt(SEEDED_BKIT_DEFAULTS as Record<string, unknown>, segs.slice(0, -1));
|
|
1057
|
+
return structuredClone(parent?.[segs[segs.length - 1]!]);
|
|
1058
|
+
}
|
|
1059
|
+
|
|
1044
1060
|
/**
|
|
1045
|
-
*
|
|
1046
|
-
*
|
|
1047
|
-
*
|
|
1061
|
+
* Reset the `bkit.*` keys recorded by the modules in `moduleList` to the value install
|
|
1062
|
+
* seeds (`""` / `[]`, read as unset), keeping the package.json indent. Deleting them
|
|
1063
|
+
* would leave `bkit check` reporting the seeded key as missing. Lists each reset key in
|
|
1064
|
+
* `result.stripped`; a dry run lists without writing.
|
|
1048
1065
|
*/
|
|
1049
1066
|
function stripModuleBkitKeys(
|
|
1050
1067
|
moduleList: ModuleName[],
|
|
@@ -1060,14 +1077,24 @@ function stripModuleBkitKeys(
|
|
|
1060
1077
|
const pkg = parsed.ok ? (parsed.value as Record<string, unknown> | null) : null;
|
|
1061
1078
|
if (pkg === null || !isJsonObject(pkg.bkit as JsonValue)) return;
|
|
1062
1079
|
const bkit = pkg.bkit as Record<string, unknown>;
|
|
1063
|
-
const
|
|
1064
|
-
|
|
1065
|
-
|
|
1066
|
-
|
|
1080
|
+
const reset = keys.filter((k) => {
|
|
1081
|
+
const segs = k.split(".");
|
|
1082
|
+
const parent = objectAt(bkit, segs.slice(0, -1));
|
|
1083
|
+
const key = segs[segs.length - 1]!;
|
|
1084
|
+
return (
|
|
1085
|
+
parent !== null &&
|
|
1086
|
+
key in parent &&
|
|
1087
|
+
JSON.stringify(parent[key]) !== JSON.stringify(seededValue(k))
|
|
1088
|
+
);
|
|
1089
|
+
});
|
|
1090
|
+
if (reset.length === 0) return;
|
|
1091
|
+
for (const k of reset) {
|
|
1092
|
+
const segs = k.split(".");
|
|
1093
|
+
objectAt(bkit, segs.slice(0, -1))![segs[segs.length - 1]!] = seededValue(k);
|
|
1067
1094
|
result.stripped.push(`package.json#bkit.${k}`);
|
|
1068
1095
|
}
|
|
1069
1096
|
console.log(
|
|
1070
|
-
`${ctx.logPrefix}${ctx.dryRun ? " [dry-run]" : ""} package.json:
|
|
1097
|
+
`${ctx.logPrefix}${ctx.dryRun ? " [dry-run]" : ""} package.json: reset bkit.${reset.join(", bkit.")} to unset`,
|
|
1071
1098
|
);
|
|
1072
1099
|
if (ctx.dryRun) return;
|
|
1073
1100
|
const indentMatch = raw.match(/\n([ \t]+)"/);
|
|
@@ -1084,8 +1111,8 @@ function stripModuleBkitKeys(
|
|
|
1084
1111
|
*
|
|
1085
1112
|
* Distinct from bare `bkit uninstall --opencode` (full host teardown):
|
|
1086
1113
|
* - Removes the provider block from `.opencode/opencode.json`
|
|
1087
|
-
* - Updates `bkit.
|
|
1088
|
-
* - If the removed provider was the active one, re-points `bkit.
|
|
1114
|
+
* - Updates `bkit.providers.opencode.installed` in `package.json`
|
|
1115
|
+
* - If the removed provider was the active one, re-points `bkit.providers.opencode.default`
|
|
1089
1116
|
* to the first remaining provider and emits a re-render advisory
|
|
1090
1117
|
* - If no providers remain, falls through to full host teardown via `runUninstall`
|
|
1091
1118
|
*/
|
|
@@ -1105,7 +1132,7 @@ export async function runSurgicalOpencodeUninstall(
|
|
|
1105
1132
|
console.log(`${LOG_PREFIX}${tag} removed provider block "${providerKey}" from opencode.json`);
|
|
1106
1133
|
}
|
|
1107
1134
|
|
|
1108
|
-
// 2. Update bkit.
|
|
1135
|
+
// 2. Update bkit.providers.opencode.installed in package.json (read inline — no detectOpencodeProviders import)
|
|
1109
1136
|
const pkgPath = path.join(cwd, "package.json");
|
|
1110
1137
|
let remainingProviders: string[] = [];
|
|
1111
1138
|
let wasActive = false;
|
|
@@ -1119,32 +1146,36 @@ export async function runSurgicalOpencodeUninstall(
|
|
|
1119
1146
|
console.warn(`${LOG_PREFIX} package.json is malformed — skipping bkit section update`);
|
|
1120
1147
|
return;
|
|
1121
1148
|
}
|
|
1122
|
-
const
|
|
1123
|
-
const arr = Array.isArray(
|
|
1124
|
-
? [...(bkit.opencodeProviders as string[])]
|
|
1125
|
-
: [];
|
|
1149
|
+
const opencode = objectAt(pkg, ["bkit", "providers", "opencode"]) ?? {};
|
|
1150
|
+
const arr = Array.isArray(opencode.installed) ? [...(opencode.installed as string[])] : [];
|
|
1126
1151
|
remainingProviders = arr.filter((p) => p !== providerKey);
|
|
1127
|
-
wasActive =
|
|
1152
|
+
wasActive = opencode.default === providerKey;
|
|
1128
1153
|
if (wasActive && remainingProviders.length > 0) {
|
|
1129
1154
|
newActive = remainingProviders[0]!;
|
|
1130
1155
|
}
|
|
1131
1156
|
|
|
1132
1157
|
if (!dryRun) {
|
|
1133
|
-
|
|
1158
|
+
opencode.installed = remainingProviders;
|
|
1134
1159
|
if (wasActive) {
|
|
1135
1160
|
if (newActive !== null) {
|
|
1136
|
-
|
|
1161
|
+
opencode.default = newActive;
|
|
1137
1162
|
} else {
|
|
1138
|
-
delete
|
|
1163
|
+
delete opencode.default;
|
|
1139
1164
|
}
|
|
1140
1165
|
}
|
|
1141
|
-
pkg
|
|
1166
|
+
if (objectAt(pkg, ["bkit", "providers", "opencode"]) === null) {
|
|
1167
|
+
const bkit = objectAt(pkg, ["bkit"]) ?? {};
|
|
1168
|
+
const providers = objectAt(bkit, ["providers"]) ?? {};
|
|
1169
|
+
providers.opencode = opencode;
|
|
1170
|
+
bkit.providers = providers;
|
|
1171
|
+
pkg.bkit = bkit;
|
|
1172
|
+
}
|
|
1142
1173
|
const indentMatch = raw.match(/\n([ \t]+)"/);
|
|
1143
1174
|
const indent = indentMatch ? indentMatch[1] : " ";
|
|
1144
1175
|
fs.writeFileSync(pkgPath, JSON.stringify(pkg, null, indent) + "\n", "utf-8");
|
|
1145
1176
|
console.log(
|
|
1146
|
-
`${LOG_PREFIX} updated package.json:
|
|
1147
|
-
(wasActive ? `
|
|
1177
|
+
`${LOG_PREFIX} updated package.json: bkit.providers.opencode.installed=[${remainingProviders.join(", ")}]` +
|
|
1178
|
+
(wasActive ? ` bkit.providers.opencode.default=${newActive ?? "(removed)"}` : ""),
|
|
1148
1179
|
);
|
|
1149
1180
|
}
|
|
1150
1181
|
}
|
|
@@ -63,8 +63,10 @@ import { detectInstalledModules } from "./check.js";
|
|
|
63
63
|
import { remapTemplateDest } from "../../install/template-copies.js";
|
|
64
64
|
import {
|
|
65
65
|
CLAUDE_CLOUD_RELPATH,
|
|
66
|
+
CODEX_CLOUD_RELPATH,
|
|
66
67
|
CURSOR_CLOUD_RELPATH,
|
|
67
68
|
writeClaudeCloudDoc,
|
|
69
|
+
writeCodexCloudDoc,
|
|
68
70
|
writeCursorCloudDoc,
|
|
69
71
|
writeCursorCliPermissionsArtifact,
|
|
70
72
|
} from "../../install/cloud-env.js";
|
|
@@ -736,13 +738,19 @@ export async function runUpgradeCommand(upgradeFlags: UpgradeFlags): Promise<voi
|
|
|
736
738
|
} else if (ent.isFile()) {
|
|
737
739
|
// Single shared dotfile remap (gitignore → .gitignore, npmignore → .npmignore).
|
|
738
740
|
const relPath = remapTemplateDest(entRel);
|
|
739
|
-
// `.claude
|
|
740
|
-
// (writeClaudeCloudDoc / writeCursorCloudDoc), not payload
|
|
741
|
-
// install/upgrade regenerate them with resolved secret values,
|
|
742
|
-
// source is never a byte-match and the walk must never drift-flag or
|
|
741
|
+
// `.claude/` + `.cursor/` + `.codex/bkit-cloud.md` are GENERATED output files
|
|
742
|
+
// (writeClaudeCloudDoc / writeCursorCloudDoc / writeCodexCloudDoc), not payload
|
|
743
|
+
// files to reconcile: install/upgrade regenerate them with resolved secret values,
|
|
744
|
+
// so the raw source is never a byte-match and the walk must never drift-flag or
|
|
743
745
|
// overwrite them. Regenerated explicitly in the runUpgrade block below
|
|
744
746
|
// (host-gated, non-dry-run).
|
|
745
|
-
if (
|
|
747
|
+
if (
|
|
748
|
+
relPath === CLAUDE_CLOUD_RELPATH ||
|
|
749
|
+
relPath === CURSOR_CLOUD_RELPATH ||
|
|
750
|
+
relPath === CODEX_CLOUD_RELPATH
|
|
751
|
+
) {
|
|
752
|
+
continue;
|
|
753
|
+
}
|
|
746
754
|
if (relPath === MCP_ROOT_RELPATH || relPath === CURSOR_MCP_RELPATH) continue;
|
|
747
755
|
const entry = entryByPath.get(relPath);
|
|
748
756
|
const ownerModule = entry?.module;
|
|
@@ -961,16 +969,23 @@ export async function runUpgradeCommand(upgradeFlags: UpgradeFlags): Promise<voi
|
|
|
961
969
|
}
|
|
962
970
|
}
|
|
963
971
|
|
|
964
|
-
// Same for `.cursor/bkit-cloud.md` —
|
|
965
|
-
//
|
|
966
|
-
//
|
|
972
|
+
// Same for `.cursor/bkit-cloud.md` and `.codex/bkit-cloud.md` — host-gated twins (see
|
|
973
|
+
// writeCursorCloudDoc / writeCodexCloudDoc); excluded from the payload walk above for
|
|
974
|
+
// the same reason as the Claude doc.
|
|
967
975
|
if (!upgradeFlags.dryRun && renderModules.has("cursor") && tokens) {
|
|
968
|
-
if (writeCursorCloudDoc(process.cwd(), tokens
|
|
976
|
+
if (writeCursorCloudDoc(process.cwd(), tokens)) {
|
|
969
977
|
console.log(
|
|
970
978
|
`${LOG_PREFIX} upgrade: .cursor/bkit-cloud.md (regenerated — gitignored, holds resolved secrets)`,
|
|
971
979
|
);
|
|
972
980
|
}
|
|
973
981
|
}
|
|
982
|
+
if (!upgradeFlags.dryRun && renderModules.has("codex") && tokens) {
|
|
983
|
+
if (writeCodexCloudDoc(process.cwd(), tokens)) {
|
|
984
|
+
console.log(
|
|
985
|
+
`${LOG_PREFIX} upgrade: .codex/bkit-cloud.md (regenerated — gitignored, holds resolved secrets)`,
|
|
986
|
+
);
|
|
987
|
+
}
|
|
988
|
+
}
|
|
974
989
|
|
|
975
990
|
// Network allowlist + MCP allows — OpenCode from renderOpencodeJson; Claude enrich
|
|
976
991
|
// below; `.bkit/allowlist.json` in renderManagedOutputs above; Cursor
|
|
@@ -1010,12 +1025,14 @@ export async function runUpgradeCommand(upgradeFlags: UpgradeFlags): Promise<voi
|
|
|
1010
1025
|
// exit), so feed those writes into canonicalHashes — keeping install/upgrade `.bkit/version`
|
|
1011
1026
|
// parity.
|
|
1012
1027
|
if (!upgradeFlags.dryRun) {
|
|
1013
|
-
const renderedDocPaths = renderWs.writes
|
|
1014
|
-
|
|
1015
|
-
|
|
1016
|
-
path.
|
|
1017
|
-
|
|
1018
|
-
|
|
1028
|
+
const renderedDocPaths = renderWs.writes
|
|
1029
|
+
.filter((w) => !w.unhashed)
|
|
1030
|
+
.map((w) =>
|
|
1031
|
+
path.relative(
|
|
1032
|
+
process.cwd(),
|
|
1033
|
+
path.isAbsolute(w.path) ? w.path : path.resolve(process.cwd(), w.path),
|
|
1034
|
+
),
|
|
1035
|
+
);
|
|
1019
1036
|
updateCanonicalHashesAfterUpgrade(
|
|
1020
1037
|
{
|
|
1021
1038
|
updated: [
|