@cbartens/bkit 0.0.0-stage → 5.0.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 +421 -0
- package/.bkit/core/.agents/context.md +95 -0
- package/.bkit/core/.agents/docs.md +62 -0
- package/.bkit/core/.agents/rules.md +147 -0
- package/.bkit/core/.agents/skills.md +43 -0
- package/.bkit/core/.bkit/LICENSE.md +151 -0
- package/.bkit/core/.bkit/README.md +421 -0
- package/.bkit/core/.bkit/cloud.md +502 -0
- package/.bkit/core/.bkit/comparison.md +318 -0
- package/.bkit/core/.bkit/install.md +496 -0
- package/.bkit/core/.bkit/jsonl.md +497 -0
- package/.bkit/core/.bkit/prompts.md +474 -0
- package/.bkit/core/.bkit/providers.md +598 -0
- package/.bkit/core/.bkit/templates.md +471 -0
- package/.bkit/core/.bkit/trackers.md +95 -0
- package/.bkit/core/.bkit/workflows.md +1546 -0
- package/.bkit/core/.claude/hooks/bkit-gateguard.cjs +82 -0
- package/.bkit/core/.claude/hooks/bkit-guardrails.cjs +93 -0
- package/.bkit/core/.claude/hooks/bkit-preflight.sh +74 -0
- package/.bkit/core/.codex/hooks/bkit-gateguard.cjs +115 -0
- package/.bkit/core/.codex/hooks/bkit-guardrails.cjs +135 -0
- package/.bkit/core/.cursor/hooks/bkit-gateguard.cjs +111 -0
- package/.bkit/core/.cursor/hooks/bkit-guardrails.cjs +169 -0
- package/.bkit/core/.cursor/hooks/bkit-preflight.sh +63 -0
- package/.bkit/core/.opencode/plugin/bkit-gateguard.js +225 -0
- package/.bkit/core/AGENTS.md +77 -0
- package/.bkit/core/LICENSE.md +149 -0
- package/.bkit/core/docs/templates/bkit-audit-accessibility.md +272 -0
- package/.bkit/core/docs/templates/bkit-audit-adoption.md +223 -0
- package/.bkit/core/docs/templates/bkit-audit-agents.md +230 -0
- package/.bkit/core/docs/templates/bkit-audit-aio-seo.md +227 -0
- package/.bkit/core/docs/templates/bkit-audit-analytics.md +266 -0
- package/.bkit/core/docs/templates/bkit-audit-annotations.md +230 -0
- package/.bkit/core/docs/templates/bkit-audit-app-performance.md +270 -0
- package/.bkit/core/docs/templates/bkit-audit-app-store.md +254 -0
- package/.bkit/core/docs/templates/bkit-audit-architecture.md +221 -0
- package/.bkit/core/docs/templates/bkit-audit-ci-performance.md +241 -0
- package/.bkit/core/docs/templates/bkit-audit-config.md +230 -0
- package/.bkit/core/docs/templates/bkit-audit-cost.md +218 -0
- package/.bkit/core/docs/templates/bkit-audit-coverage.md +221 -0
- package/.bkit/core/docs/templates/bkit-audit-database.md +229 -0
- package/.bkit/core/docs/templates/bkit-audit-dead-code.md +251 -0
- package/.bkit/core/docs/templates/bkit-audit-deferrals.md +283 -0
- package/.bkit/core/docs/templates/bkit-audit-dependencies.md +268 -0
- package/.bkit/core/docs/templates/bkit-audit-documentation.md +280 -0
- package/.bkit/core/docs/templates/bkit-audit-duplication.md +253 -0
- package/.bkit/core/docs/templates/bkit-audit-failures.md +259 -0
- package/.bkit/core/docs/templates/bkit-audit-flakes.md +237 -0
- package/.bkit/core/docs/templates/bkit-audit-gates.md +250 -0
- package/.bkit/core/docs/templates/bkit-audit-issues.md +273 -0
- package/.bkit/core/docs/templates/bkit-audit-llm.md +239 -0
- package/.bkit/core/docs/templates/bkit-audit-logs.md +266 -0
- package/.bkit/core/docs/templates/bkit-audit-models.md +210 -0
- package/.bkit/core/docs/templates/bkit-audit-privacy.md +211 -0
- package/.bkit/core/docs/templates/bkit-audit-prompts.md +216 -0
- package/.bkit/core/docs/templates/bkit-audit-red-team.md +220 -0
- package/.bkit/core/docs/templates/bkit-audit-reliability.md +222 -0
- package/.bkit/core/docs/templates/bkit-audit-repo.md +224 -0
- package/.bkit/core/docs/templates/bkit-audit-security.md +274 -0
- package/.bkit/core/docs/templates/bkit-audit-slop.md +200 -0
- package/.bkit/core/docs/templates/bkit-audit-testing.md +270 -0
- package/.bkit/core/docs/templates/bkit-audit-usability.md +237 -0
- package/.bkit/core/docs/templates/bkit-plan.md +476 -0
- package/.bkit/core/engine/checks/after/auth.ts +247 -0
- package/.bkit/core/engine/checks/after/ci-yml.ts +739 -0
- package/.bkit/core/engine/checks/after/github.ts +424 -0
- package/.bkit/core/engine/checks/after/index.ts +556 -0
- package/.bkit/core/engine/checks/after/managed.ts +217 -0
- package/.bkit/core/engine/checks/after/tools.ts +427 -0
- package/.bkit/core/engine/checks/after/vercel.ts +101 -0
- package/.bkit/core/engine/checks/before/context-fetch.ts +429 -0
- package/.bkit/core/engine/checks/before/env.ts +201 -0
- package/.bkit/core/engine/checks/before/files.ts +202 -0
- package/.bkit/core/engine/checks/before/index.ts +206 -0
- package/.bkit/core/engine/checks/before/mcp.ts +127 -0
- package/.bkit/core/engine/checks/before/repo.ts +77 -0
- package/.bkit/core/engine/checks/before/version.ts +67 -0
- package/.bkit/core/engine/checks/status-holes.ts +479 -0
- package/.bkit/core/engine/cli.ts +871 -0
- package/.bkit/core/engine/commands/analysis.ts +550 -0
- package/.bkit/core/engine/commands/ci/ci.ts +483 -0
- package/.bkit/core/engine/commands/comply.ts +415 -0
- package/.bkit/core/engine/commands/harvest.ts +459 -0
- package/.bkit/core/engine/commands/install/check.ts +70 -0
- package/.bkit/core/engine/commands/install/doctor.ts +247 -0
- package/.bkit/core/engine/commands/install/install.ts +528 -0
- package/.bkit/core/engine/commands/install/uninstall.ts +972 -0
- package/.bkit/core/engine/commands/install/upgrade.ts +1026 -0
- package/.bkit/core/engine/commands/launch.ts +139 -0
- package/.bkit/core/engine/commands/lib.ts +494 -0
- package/.bkit/core/engine/commands/registry.ts +53 -0
- package/.bkit/core/engine/commands/setup/setup.ts +184 -0
- package/.bkit/core/engine/commands/telemetry.ts +32 -0
- package/.bkit/core/engine/commands/workflow/branches.ts +1514 -0
- package/.bkit/core/engine/commands/workflow/context.ts +961 -0
- package/.bkit/core/engine/commands/workflow/counters.ts +268 -0
- package/.bkit/core/engine/commands/workflow/fids.ts +243 -0
- package/.bkit/core/engine/commands/workflow/issues.ts +675 -0
- package/.bkit/core/engine/commands/workflow/ledgers.ts +575 -0
- package/.bkit/core/engine/commands/workflow/locks.ts +478 -0
- package/.bkit/core/engine/commands/workflow/prs.ts +1087 -0
- package/.bkit/core/engine/commands/workflow/repo.ts +220 -0
- package/.bkit/core/engine/commands/workflow/roadmap.ts +576 -0
- package/.bkit/core/engine/commands/workflow/runs.ts +2140 -0
- package/.bkit/core/engine/commands/workflow/runtime.ts +300 -0
- package/.bkit/core/engine/commands/workflow/skills.ts +118 -0
- package/.bkit/core/engine/commands/workflow/status.ts +455 -0
- package/.bkit/core/engine/commands/workflow/steps.ts +1300 -0
- package/.bkit/core/engine/commands/workflow/tests.ts +161 -0
- package/.bkit/core/engine/commands/workflow/workflows.ts +1573 -0
- package/.bkit/core/engine/commands/workflow/workstreams.ts +164 -0
- package/.bkit/core/engine/commands/workflow/worktrees.ts +534 -0
- package/.bkit/core/engine/install/cloud-env.ts +925 -0
- package/.bkit/core/engine/install/managed-block.ts +212 -0
- package/.bkit/core/engine/install/manifest.ts +448 -0
- package/.bkit/core/engine/install/modules/claude.ts +362 -0
- package/.bkit/core/engine/install/modules/cloud.ts +174 -0
- package/.bkit/core/engine/install/modules/codex.ts +219 -0
- package/.bkit/core/engine/install/modules/core.ts +600 -0
- package/.bkit/core/engine/install/modules/cursor.ts +231 -0
- package/.bkit/core/engine/install/modules/index.ts +242 -0
- package/.bkit/core/engine/install/modules/opencode.ts +573 -0
- package/.bkit/core/engine/install/placeholders.ts +108 -0
- package/.bkit/core/engine/install/template-copies.ts +119 -0
- package/.bkit/core/engine/install/version-file.ts +284 -0
- package/.bkit/core/engine/install/write.ts +467 -0
- package/.bkit/core/engine/ledgers/clamp-log.ts +32 -0
- package/.bkit/core/engine/ledgers/status.ts +213 -0
- package/.bkit/core/engine/ledgers/telemetry.ts +1143 -0
- package/.bkit/core/engine/render/hosts.ts +372 -0
- package/.bkit/core/engine/render/models.ts +323 -0
- package/.bkit/core/engine/render/parts.ts +38 -0
- package/.bkit/core/engine/render/trackers.ts +170 -0
- package/.bkit/core/engine/shared/egress.ts +345 -0
- package/.bkit/core/engine/shared/json.ts +16 -0
- package/.bkit/core/engine/shared/log-prefix.ts +9 -0
- package/.bkit/core/engine/shared/package-json.ts +29 -0
- package/.bkit/core/engine/shared/package-manager.ts +38 -0
- package/.bkit/core/engine/shared/package-roots.ts +163 -0
- package/.bkit/core/engine/shared/protected-paths.ts +164 -0
- package/.bkit/core/engine/shared/settings.ts +72 -0
- package/.bkit/core/engine/shared/timeouts.ts +20 -0
- package/.bkit/core/engine/tools/wording.ts +748 -0
- package/.bkit/core/hooks/gateguard-edit-payload.js +18 -0
- package/.bkit/core/hooks/gateguard-engine.js +193 -0
- package/.bkit/core/hooks/guardrails-shell.js +154 -0
- package/.bkit/core/hooks/guardrails-tiers.js +68 -0
- package/.bkit/core/hooks/preflight-linear.sh +73 -0
- package/.bkit/core/prompts/bkit-audit-generate.md +66 -0
- package/.bkit/core/prompts/bkit-build-challenge-1.md +79 -0
- package/.bkit/core/prompts/bkit-build-challenge-2.md +81 -0
- package/.bkit/core/prompts/bkit-build-challenge-reconcile.md +68 -0
- package/.bkit/core/prompts/bkit-build-challenge-remediate.md +70 -0
- package/.bkit/core/prompts/bkit-build-challenge-tests.md +73 -0
- package/.bkit/core/prompts/bkit-build-install-skills.md +67 -0
- package/.bkit/core/prompts/bkit-build-plan-current.md +75 -0
- package/.bkit/core/prompts/bkit-build-plan-execute.md +72 -0
- package/.bkit/core/prompts/bkit-build-plan-gaps-remediate.md +73 -0
- package/.bkit/core/prompts/bkit-build-plan-verify.md +88 -0
- package/.bkit/core/prompts/bkit-build-summary.md +93 -0
- package/.bkit/core/prompts/bkit-debug-abort-handover.md +90 -0
- package/.bkit/core/prompts/bkit-debug-failure-diagnose.md +151 -0
- package/.bkit/core/prompts/bkit-debug-failure-remediate.md +78 -0
- package/.bkit/core/prompts/bkit-debug-failure-soak.md +73 -0
- package/.bkit/core/prompts/bkit-debug-summary.md +95 -0
- package/.bkit/core/prompts/bkit-design-brainstorm-ideate-1.md +72 -0
- package/.bkit/core/prompts/bkit-design-brainstorm-ideate-2.md +72 -0
- package/.bkit/core/prompts/bkit-design-brainstorm-ideate-3.md +75 -0
- package/.bkit/core/prompts/bkit-design-generate.md +110 -0
- package/.bkit/core/prompts/bkit-design-organise.md +85 -0
- package/.bkit/core/prompts/bkit-design-review-1.md +121 -0
- package/.bkit/core/prompts/bkit-design-review-2.md +111 -0
- package/.bkit/core/prompts/bkit-design-spike.md +97 -0
- package/.bkit/core/prompts/bkit-design-summary.md +106 -0
- package/.bkit/core/prompts/bkit-design-update.md +66 -0
- package/.bkit/core/prompts/bkit-plan-complexity-check.md +66 -0
- package/.bkit/core/prompts/bkit-plan-complexity-split.md +87 -0
- package/.bkit/core/prompts/bkit-plan-generate.md +74 -0
- package/.bkit/core/prompts/bkit-plan-review-1.md +90 -0
- package/.bkit/core/prompts/bkit-plan-review-2.md +80 -0
- package/.bkit/core/prompts/bkit-plan-review-3.md +92 -0
- package/.bkit/core/prompts/bkit-plan-scope-check-1.md +84 -0
- package/.bkit/core/prompts/bkit-plan-scope-check-2.md +84 -0
- package/.bkit/core/prompts/bkit-plan-summary.md +106 -0
- package/.bkit/core/prompts/bkit-plan-update.md +68 -0
- package/.bkit/core/prompts/bkit-ship-conflict-resolve.md +90 -0
- package/.bkit/core/prompts/bkit-ship-deferred-sweep.md +94 -0
- package/.bkit/core/prompts/bkit-ship-summary.md +77 -0
- package/.bkit/core/prompts/bkit-ship-update-docs.md +71 -0
- package/.bkit/core/prompts/bkit-utility-compress-markdown.md +91 -0
- package/.bkit/core/prompts/bkit-utility-update-decisions.md +75 -0
- package/.bkit/core/prompts/bkit-utility-update-deferrals.md +76 -0
- package/.bkit/core/prompts/bkit-utility-update-documentation.md +61 -0
- package/.bkit/core/prompts/bkit-utility-update-failures.md +76 -0
- package/.bkit/core/prompts/bkit-utility-update-knowledge.md +75 -0
- package/.bkit/core/prompts/bkit-utility-update-roadmap.md +82 -0
- package/.bkit/core/workflows/bkit-auto.md +121 -0
- package/.bkit/core/workflows/bkit-build.md +802 -0
- package/.bkit/core/workflows/bkit-debug.md +642 -0
- package/.bkit/core/workflows/bkit-design.md +495 -0
- package/.bkit/core/workflows/bkit-plan.md +510 -0
- package/.bkit/core/workflows/bkit-ship.md +650 -0
- package/.bkit/shared/.bkit/.env.example +108 -0
- package/.bkit/shared/.claude/bkit-cloud.md +117 -0
- package/.bkit/shared/.claude/settings.json +88 -0
- package/.bkit/shared/.codex/hooks.json +26 -0
- package/.bkit/shared/.cursor/bkit-cloud.md +84 -0
- package/.bkit/shared/.cursor/hooks.json +26 -0
- package/.bkit/shared/.cursor/mcp.json +15 -0
- package/.bkit/shared/.cursor/rules/bkit-rules.mdc +12 -0
- package/.bkit/shared/.gitattributes +37 -0
- package/.bkit/shared/.mcp.json +16 -0
- package/.bkit/shared/.opencode/opencode.json +62 -0
- package/.bkit/shared/CLAUDE.md +11 -0
- package/.bkit/shared/LICENSE.md +22 -0
- package/.bkit/shared/docs/architecture.md +19 -0
- package/.bkit/shared/docs/data-schema.md +19 -0
- package/.bkit/shared/docs/deployments.md +438 -0
- package/.bkit/shared/docs/design.md +39 -0
- package/.bkit/shared/docs/noise.md +19 -0
- package/.bkit/shared/docs/observability.md +25 -0
- package/.bkit/shared/docs/security.md +42 -0
- package/.bkit/shared/docs/setup.md +30 -0
- package/.bkit/shared/docs/technology.md +18 -0
- package/.bkit/shared/docs/testing.md +413 -0
- package/.bkit/shared/gitignore +92 -0
- package/.bkit/templates/.claude/hooks/bkit-cloud-bootstrap.sh +192 -0
- package/.bkit/templates/.cursor/Dockerfile +68 -0
- package/.bkit/templates/.cursor/environment.json +6 -0
- package/.bkit/templates/.cursor/settings.json +11 -0
- package/.bkit/templates/.envrc +7 -0
- package/.bkit/templates/.github/dependabot.yml +52 -0
- package/.bkit/templates/.github/renovate.json5 +239 -0
- package/.bkit/templates/.github/workflows/bkit-ci.yml +1082 -0
- package/.bkit/templates/.github/workflows/bkit-cloud.yml +566 -0
- package/.bkit/templates/.github/workflows/bkit-renovate.yml +107 -0
- package/.bkit/templates/.graphifyignore +108 -0
- package/.bkit/templates/.husky/pre-commit +16 -0
- package/.bkit/templates/.husky/pre-push +91 -0
- package/.bkit/templates/.lintstagedrc.json +3 -0
- package/.bkit/templates/.prettierignore +41 -0
- package/.bkit/templates/.serena/project.yml +243 -0
- package/.bkit/templates/.vale/styles/House/Filler.yml +11 -0
- package/.bkit/templates/.vale/styles/House/Hedging.yml +12 -0
- package/.bkit/templates/.vale/styles/House/LLMSlop.yml +13 -0
- package/.bkit/templates/.vale/styles/House/Verbose.yml +12 -0
- package/.bkit/templates/.vale.ini +67 -0
- package/.bkit/templates/LICENSE.md +22 -0
- package/.bkit/templates/context/bkit-cloudrun.md +84 -0
- package/.bkit/templates/context/bkit-expo.md +186 -0
- package/.bkit/templates/context/bkit-github.md +79 -0
- package/.bkit/templates/context/bkit-inngest.md +45 -0
- package/.bkit/templates/context/bkit-maestro.md +76 -0
- package/.bkit/templates/context/bkit-playwright.md +62 -0
- package/.bkit/templates/context/bkit-resend.md +36 -0
- package/.bkit/templates/context/bkit-sentry.md +65 -0
- package/.bkit/templates/context/bkit-serena.md +33 -0
- package/.bkit/templates/context/bkit-stripe.md +36 -0
- package/.bkit/templates/context/bkit-supabase.md +59 -0
- package/.bkit/templates/context/bkit-tavily.md +49 -0
- package/.bkit/templates/context/bkit-vercel.md +64 -0
- package/.bkit/templates/docs/capabilities.md +72 -0
- package/.bkit/templates/scripts/ci/accepted-divergences.json +21 -0
- package/.bkit/templates/scripts/ci/check-accepted-divergences.mjs +152 -0
- package/.bkit/templates/scripts/ci/check-accepted-divergences.test.mjs +130 -0
- package/.bkit/templates/scripts/ci/lanes/resolve-push-base.mjs +98 -0
- package/.bkit/templates/scripts/ci/lanes/resolve-push-base.test.mjs +86 -0
- package/.bkit/templates/scripts/graphify/bkit-graph-drift-rules.json +23 -0
- package/.bkit/templates/scripts/graphify/bkit-graph-drift.py +208 -0
- package/.bkit/templates/scripts/graphify/bkit-graph-eager-rules.json +35 -0
- package/.bkit/templates/scripts/graphify/bkit-graph-eager.py +236 -0
- package/.bkit/templates/scripts/graphify/bkit-graph-external-rules.json +17 -0
- package/.bkit/templates/scripts/graphify/bkit-graph-imports.py +290 -0
- package/.bkit/templates/scripts/graphify/bkit-graph-pre-push.sh +19 -0
- package/.bkit/templates/scripts/graphify/bkit-graph-repair.py +120 -0
- package/.bkit/templates/scripts/graphify/bkit-graph-surface.py +232 -0
- package/.bkit/templates/scripts/graphify/bkit-graphify-graphml.py +36 -0
- package/.bkit/templates/scripts/graphify/bkit-graphify-rollup.py +927 -0
- package/.bkit/templates/scripts/graphify/bkit-graphify.sh +351 -0
- package/.bkit/templates/scripts/launchd/ai.bkit.launchd.plist +26 -0
- package/.bkit/templates/scripts/launchd/bkit-launchd-env.sh +53 -0
- package/.bkit/templates/scripts/launchd/launchd.env.example +13 -0
- package/.bkit/templates/scripts/prettier/bkit-insert-ignore.mjs +275 -0
- package/.bkit/templates/scripts/secrets/bkit-secrets.config.mjs +66 -0
- package/.bkit/templates/scripts/secrets/bkit-secrets.mjs +785 -0
- package/.bkit/templates/scripts/serena/bkit-serena-mcp.sh +30 -0
- package/.bkit/templates/scripts/serena/bkit-serena.mcp.json +9 -0
- package/.bkit/templates/scripts/slop/bkit-slop-type-suppression.mjs +286 -0
- package/.bkit/templates/slop-scan.config.json +120 -0
- package/CHANGELOG.md +1486 -0
- package/LICENSE.md +161 -0
- package/README.md +185 -2
- package/dist/checks/after/auth.js +232 -0
- package/dist/checks/after/ci-yml.js +718 -0
- package/dist/checks/after/github.js +400 -0
- package/dist/checks/after/index.js +447 -0
- package/dist/checks/after/managed.js +187 -0
- package/dist/checks/after/tools.js +351 -0
- package/dist/checks/after/vercel.js +102 -0
- package/dist/checks/before/context-fetch.js +426 -0
- package/dist/checks/before/env.js +173 -0
- package/dist/checks/before/files.js +185 -0
- package/dist/checks/before/index.js +162 -0
- package/dist/checks/before/mcp.js +111 -0
- package/dist/checks/before/repo.js +71 -0
- package/dist/checks/before/version.js +60 -0
- package/dist/checks/status-holes.js +393 -0
- package/dist/cli.js +692 -0
- package/dist/commands/analysis.js +325 -0
- package/dist/commands/ci/ci.js +438 -0
- package/dist/commands/comply.js +310 -0
- package/dist/commands/harvest.js +354 -0
- package/dist/commands/install/check.js +61 -0
- package/dist/commands/install/doctor.js +207 -0
- package/dist/commands/install/install.js +461 -0
- package/dist/commands/install/uninstall.js +815 -0
- package/dist/commands/install/upgrade.js +771 -0
- package/dist/commands/launch.js +118 -0
- package/dist/commands/lib.js +362 -0
- package/dist/commands/registry.js +50 -0
- package/dist/commands/setup/setup.js +158 -0
- package/dist/commands/telemetry.js +29 -0
- package/dist/commands/workflow/branches.js +1265 -0
- package/dist/commands/workflow/context.js +846 -0
- package/dist/commands/workflow/counters.js +227 -0
- package/dist/commands/workflow/fids.js +224 -0
- package/dist/commands/workflow/issues.js +585 -0
- package/dist/commands/workflow/ledgers.js +472 -0
- package/dist/commands/workflow/locks.js +364 -0
- package/dist/commands/workflow/prs.js +904 -0
- package/dist/commands/workflow/repo.js +199 -0
- package/dist/commands/workflow/roadmap.js +495 -0
- package/dist/commands/workflow/runs.js +1717 -0
- package/dist/commands/workflow/runtime.js +257 -0
- package/dist/commands/workflow/skills.js +110 -0
- package/dist/commands/workflow/status.js +392 -0
- package/dist/commands/workflow/steps.js +1093 -0
- package/dist/commands/workflow/tests.js +144 -0
- package/dist/commands/workflow/workflows.js +1342 -0
- package/dist/commands/workflow/workstreams.js +141 -0
- package/dist/commands/workflow/worktrees.js +473 -0
- package/dist/install/cloud-env.js +819 -0
- package/dist/install/managed-block.js +182 -0
- package/dist/install/manifest.js +376 -0
- package/dist/install/modules/claude.js +288 -0
- package/dist/install/modules/cloud.js +152 -0
- package/dist/install/modules/codex.js +193 -0
- package/dist/install/modules/core.js +511 -0
- package/dist/install/modules/cursor.js +186 -0
- package/dist/install/modules/index.js +152 -0
- package/dist/install/modules/opencode.js +504 -0
- package/dist/install/placeholders.js +87 -0
- package/dist/install/template-copies.js +106 -0
- package/dist/install/version-file.js +204 -0
- package/dist/install/write.js +342 -0
- package/dist/ledgers/clamp-log.js +27 -0
- package/dist/ledgers/status.js +156 -0
- package/dist/ledgers/telemetry.js +637 -0
- package/dist/render/hosts.js +339 -0
- package/dist/render/models.js +288 -0
- package/dist/render/parts.js +33 -0
- package/dist/render/trackers.js +135 -0
- package/dist/shared/egress.js +299 -0
- package/dist/shared/json.js +16 -0
- package/dist/shared/log-prefix.js +7 -0
- package/dist/shared/package-json.js +22 -0
- package/dist/shared/package-manager.js +32 -0
- package/dist/shared/package-roots.js +145 -0
- package/dist/shared/protected-paths.js +153 -0
- package/dist/shared/settings.js +44 -0
- package/dist/shared/timeouts.js +19 -0
- package/dist/tools/wording.js +680 -0
- package/package.json +101 -4
|
@@ -0,0 +1,461 @@
|
|
|
1
|
+
// commands/install/install.ts — `bkit install` and `bkit check`: preflight, module dispatch,
|
|
2
|
+
// post-install checks. Check runs the same pipeline in dry-run mode.
|
|
3
|
+
import * as fs from "node:fs";
|
|
4
|
+
import * as path from "node:path";
|
|
5
|
+
import { OPENCODE_PROVIDERS } from "../../shared/egress.js";
|
|
6
|
+
import { getPkgRoot } from "../../shared/package-roots.js";
|
|
7
|
+
import { dispatchModules } from "../../install/modules/index.js";
|
|
8
|
+
import { DEFAULT_ISSUE_TRACKER, parseIssueTracker, } from "../../install/manifest.js";
|
|
9
|
+
import { LOG_PREFIX, setLogPrefix } from "../../shared/log-prefix.js";
|
|
10
|
+
import { detectInstalledModules, reportCheckDrift } from "./check.js";
|
|
11
|
+
import { runPreflight } from "../../checks/before/index.js";
|
|
12
|
+
import { formatChecklist, readChangelogVersionDelta, runPostInstallCheck, writeAdvisoriesArtifact, } from "../../checks/after/index.js";
|
|
13
|
+
import { findMissingOwnedHooks, detectOwnedHookMissing } from "../../checks/after/managed.js";
|
|
14
|
+
import { resolveTokens } from "../../install/placeholders.js";
|
|
15
|
+
import { parseModelLookup, applyModelOverrides, buildOpencodeModelLookup, parseEffortMap, } from "../../render/models.js";
|
|
16
|
+
import { getBkitDocsRoot } from "../../shared/package-roots.js";
|
|
17
|
+
import { runUninstall } from "./uninstall.js";
|
|
18
|
+
// ---------------------------------------------------------------------------
|
|
19
|
+
// Staging scratch area
|
|
20
|
+
//
|
|
21
|
+
// `.bkit-staging/` is a per-run SCRATCH area: modules render derived files there
|
|
22
|
+
// (e.g. opencode.json) before comparing/merging into the consumer destination.
|
|
23
|
+
// runInstall Phase 2 cleans it up after every dispatch — success or failure —
|
|
24
|
+
// via `finally { discardAllStaging() }`. Dispatch writes module files directly to
|
|
25
|
+
// their destinations and is NOT atomic across modules; `bkit install` is idempotent,
|
|
26
|
+
// so re-running completes a partial install.
|
|
27
|
+
// ---------------------------------------------------------------------------
|
|
28
|
+
/** Staging root dir (relative to cwd). */
|
|
29
|
+
export const STAGING_ROOT = ".bkit-staging";
|
|
30
|
+
/**
|
|
31
|
+
* Discard ALL staging dirs under STAGING_ROOT (cleanup on mid-install failure).
|
|
32
|
+
*/
|
|
33
|
+
export function discardAllStaging(cwd = process.cwd()) {
|
|
34
|
+
const stagingRoot = path.join(cwd, STAGING_ROOT);
|
|
35
|
+
if (fs.existsSync(stagingRoot)) {
|
|
36
|
+
fs.rmSync(stagingRoot, { recursive: true, force: true });
|
|
37
|
+
}
|
|
38
|
+
}
|
|
39
|
+
/**
|
|
40
|
+
* The installed opencode provider, or exit(1) with the fix.
|
|
41
|
+
*
|
|
42
|
+
* `bkit check` / `bkit upgrade` take no `--opencode=` flag, so they read the provider the
|
|
43
|
+
* consumer actually installed (package.json `bkit.opencodeProvider`, else the opencode.json
|
|
44
|
+
* provider block). There is no default: a repo carrying `.opencode/` with no recorded
|
|
45
|
+
* provider is a broken install.
|
|
46
|
+
*
|
|
47
|
+
* Call ONLY on a path already known to need the opencode host, never speculatively.
|
|
48
|
+
*/
|
|
49
|
+
export function requireOpencodeProvider(cwd, context) {
|
|
50
|
+
const detected = detectOpencodeProvider(cwd);
|
|
51
|
+
if (!detected) {
|
|
52
|
+
console.error(`${LOG_PREFIX} ${context}: the opencode host is installed but no provider is recorded ` +
|
|
53
|
+
`(package.json \`bkit.opencodeProvider\` and .opencode/opencode.json are both silent). ` +
|
|
54
|
+
`Re-run \`bkit install --opencode=<provider>\` — one of ${OPENCODE_PROVIDERS.join(", ")}.`);
|
|
55
|
+
process.exit(1);
|
|
56
|
+
}
|
|
57
|
+
return detected;
|
|
58
|
+
}
|
|
59
|
+
/**
|
|
60
|
+
* Read the installing bkit version from the package root's package.json.
|
|
61
|
+
* Returns "0.0.0" when unreadable (e.g. dev tree without a package.json at the
|
|
62
|
+
* resolved root) — keeps the advisories artifact informational, not fatal.
|
|
63
|
+
*/
|
|
64
|
+
export function getInstallingVersion() {
|
|
65
|
+
try {
|
|
66
|
+
const pkgJsonPath = path.join(getPkgRoot(), "package.json");
|
|
67
|
+
if (fs.existsSync(pkgJsonPath)) {
|
|
68
|
+
const pkg = JSON.parse(fs.readFileSync(pkgJsonPath, "utf-8"));
|
|
69
|
+
return pkg.version ?? "0.0.0";
|
|
70
|
+
}
|
|
71
|
+
}
|
|
72
|
+
catch {
|
|
73
|
+
return "0.0.0"; // best-effort: unreadable/garbled package.json
|
|
74
|
+
}
|
|
75
|
+
return "0.0.0";
|
|
76
|
+
}
|
|
77
|
+
/**
|
|
78
|
+
* Render a resolved module set back into valid CLI flags for
|
|
79
|
+
* recovery-hint text. Skips core (implicit) and spells opt-ins with their value flags.
|
|
80
|
+
*/
|
|
81
|
+
export function modulesToCliFlags(mods, opencodeProvider, cloudVariant) {
|
|
82
|
+
const out = [];
|
|
83
|
+
if (mods.has("claude"))
|
|
84
|
+
out.push("--claude");
|
|
85
|
+
if (mods.has("cursor"))
|
|
86
|
+
out.push("--cursor");
|
|
87
|
+
if (mods.has("opencode"))
|
|
88
|
+
out.push(`--opencode=${opencodeProvider ?? "<provider>"}`);
|
|
89
|
+
if (mods.has("codex"))
|
|
90
|
+
out.push("--codex");
|
|
91
|
+
if (mods.has("cloud"))
|
|
92
|
+
out.push(`--auto=${cloudVariant ?? "<variant>"}`);
|
|
93
|
+
return out.join(" ");
|
|
94
|
+
}
|
|
95
|
+
/**
|
|
96
|
+
* Symmetric cloud/tracker constraint (FINAL SCOPE decision 3/4): cloud=claude and
|
|
97
|
+
* cloud=opencode both require tracker=github (both use the bkit-cloud.yml template);
|
|
98
|
+
* cloud=cursor requires tracker=linear. Mismatch is a hard error — checked BEFORE
|
|
99
|
+
* any package.json write so no state is recorded on mismatch ("no files written
|
|
100
|
+
* on hard error" invariant). Returns the error message to print, or `null` when
|
|
101
|
+
* the tracker matches (or no cloud module/variant is in play).
|
|
102
|
+
*/
|
|
103
|
+
export function validateCloudTrackerMatch(cloudVariant, hasCloudModule, issueTracker) {
|
|
104
|
+
if (cloudVariant === null || !hasCloudModule)
|
|
105
|
+
return null;
|
|
106
|
+
const requiredTracker = cloudVariant === "cursor" ? "linear" : "github";
|
|
107
|
+
if (issueTracker === requiredTracker)
|
|
108
|
+
return null;
|
|
109
|
+
return (`[bkit] --auto=${cloudVariant} requires tracker=${requiredTracker}, ` +
|
|
110
|
+
`but the resolved tracker is "${issueTracker}". ` +
|
|
111
|
+
(issueTracker === DEFAULT_ISSUE_TRACKER || issueTracker === "none"
|
|
112
|
+
? `Set the tracker first: bkit install --tracker=${requiredTracker} --auto=${cloudVariant}`
|
|
113
|
+
: `Re-run with the matching tracker: bkit install --tracker=${requiredTracker} --auto=${cloudVariant} (tracker switching is free).`));
|
|
114
|
+
}
|
|
115
|
+
/**
|
|
116
|
+
* Detect the bkit opencode provider key a consumer installed.
|
|
117
|
+
*
|
|
118
|
+
* Resolution order:
|
|
119
|
+
* 1. `package.json` `bkit.opencodeProvider` — the authoritative record written on install.
|
|
120
|
+
* This is the ONLY signal for managed-auth gateways (opencode) whose opencode.json carries no
|
|
121
|
+
* custom provider block.
|
|
122
|
+
* 2. `.opencode/opencode.json` first provider key — for installs without the manifest field
|
|
123
|
+
* (the block is keyed by provider id, matching renderOpencodeJson).
|
|
124
|
+
* 3. null — caller falls back to the install default so the model lookup still resolves.
|
|
125
|
+
*
|
|
126
|
+
* The manifest value is validated against the allowlist so a hand-edited package.json cannot
|
|
127
|
+
* smuggle an unsupported provider into the render path.
|
|
128
|
+
*/
|
|
129
|
+
export function detectOpencodeProvider(cwd) {
|
|
130
|
+
const pkgPath = path.join(cwd, "package.json");
|
|
131
|
+
if (fs.existsSync(pkgPath)) {
|
|
132
|
+
try {
|
|
133
|
+
const pkg = JSON.parse(fs.readFileSync(pkgPath, "utf-8"));
|
|
134
|
+
const stored = pkg.bkit?.opencodeProvider;
|
|
135
|
+
if (typeof stored === "string" &&
|
|
136
|
+
OPENCODE_PROVIDERS.includes(stored)) {
|
|
137
|
+
return stored;
|
|
138
|
+
}
|
|
139
|
+
}
|
|
140
|
+
catch {
|
|
141
|
+
// unparseable package.json — fall through to opencode.json detection
|
|
142
|
+
}
|
|
143
|
+
}
|
|
144
|
+
const jsonPath = path.join(cwd, ".opencode", "opencode.json");
|
|
145
|
+
if (!fs.existsSync(jsonPath))
|
|
146
|
+
return null;
|
|
147
|
+
try {
|
|
148
|
+
const cfg = JSON.parse(fs.readFileSync(jsonPath, "utf-8"));
|
|
149
|
+
if (cfg.provider && typeof cfg.provider === "object") {
|
|
150
|
+
const first = Object.keys(cfg.provider)[0];
|
|
151
|
+
if (!first)
|
|
152
|
+
return null;
|
|
153
|
+
// Zen's opencode.json block is keyed by the built-in id `opencode`, not the CLI key.
|
|
154
|
+
return first === "opencode" ? "opencode-zen" : first;
|
|
155
|
+
}
|
|
156
|
+
}
|
|
157
|
+
catch {
|
|
158
|
+
return null; // unparseable opencode.json — fall back to the default provider
|
|
159
|
+
}
|
|
160
|
+
return null;
|
|
161
|
+
}
|
|
162
|
+
/**
|
|
163
|
+
* Returns all bkit-installed opencode providers from the consumer package.json
|
|
164
|
+
* `bkit.opencodeProviders` array, filtered to valid OPENCODE_PROVIDERS entries; [] when
|
|
165
|
+
* the field is absent.
|
|
166
|
+
*/
|
|
167
|
+
export function detectOpencodeProviders(cwd) {
|
|
168
|
+
const pkgPath = path.join(cwd, "package.json");
|
|
169
|
+
if (!fs.existsSync(pkgPath))
|
|
170
|
+
return [];
|
|
171
|
+
try {
|
|
172
|
+
const pkg = JSON.parse(fs.readFileSync(pkgPath, "utf-8"));
|
|
173
|
+
const arr = pkg.bkit?.opencodeProviders;
|
|
174
|
+
if (Array.isArray(arr)) {
|
|
175
|
+
return arr.filter((v) => typeof v === "string" && OPENCODE_PROVIDERS.includes(v));
|
|
176
|
+
}
|
|
177
|
+
}
|
|
178
|
+
catch {
|
|
179
|
+
// unparseable — return empty
|
|
180
|
+
}
|
|
181
|
+
return [];
|
|
182
|
+
}
|
|
183
|
+
/** `bkit install`, and `bkit check` (the same pipeline, dry-run). */
|
|
184
|
+
export async function runInstall(args) {
|
|
185
|
+
const { verb, modules, tracker, cloudVariant, opencodeProvider, uninstallFlags } = args;
|
|
186
|
+
const dryRun = verb === "check";
|
|
187
|
+
if (dryRun)
|
|
188
|
+
setLogPrefix("[bkit-check]");
|
|
189
|
+
if (dryRun)
|
|
190
|
+
console.log(`${LOG_PREFIX} Running in check (dry-run) mode`);
|
|
191
|
+
// `bkit check` scopes drift detection to what is INSTALLED (detected by sentinel files),
|
|
192
|
+
// not to a fixed full set. `install` keeps its explicit resolved set.
|
|
193
|
+
const effectiveModules = verb === "check" ? detectInstalledModules(process.cwd()) : modules;
|
|
194
|
+
// RENDER-input provider resolution. `bkit check` takes no `--opencode=` flag, so the parsed
|
|
195
|
+
// `opencodeProvider` is null on the check path; it falls back to the INSTALLED provider
|
|
196
|
+
// (package.json `bkit.opencodeProvider`, else the opencode.json provider block). On install
|
|
197
|
+
// `?? detect` never fires: opencode joins the module set only when `--opencode=<provider>`
|
|
198
|
+
// was given. The PARSED `opencodeProvider` alone drives the persist-to-package.json logic
|
|
199
|
+
// below (gated on `!dryRun` + a real flag). The tracker is resolved from package.json below,
|
|
200
|
+
// so the tracker-dependent opencode mcp block renders the same way on check.
|
|
201
|
+
const renderOpencodeProvider = opencodeProvider ?? detectOpencodeProvider(process.cwd());
|
|
202
|
+
// Resolve issueTracker: --tracker= flag overrides; else read bkit.issueTracker from consumer
|
|
203
|
+
// package.json; else default to "none".
|
|
204
|
+
// A `--tracker=` value always applies, whether first-set or a re-set of an
|
|
205
|
+
// already-recorded tracker.
|
|
206
|
+
// Resolved BEFORE preflight: preflight's tracker-dependent detectors grade the tracker
|
|
207
|
+
// this run INSTALLS, not the one on disk from the previous run. Read-only — no writes here.
|
|
208
|
+
let issueTracker = DEFAULT_ISSUE_TRACKER;
|
|
209
|
+
{
|
|
210
|
+
const consumerPkgPath = path.join(process.cwd(), "package.json");
|
|
211
|
+
if (fs.existsSync(consumerPkgPath)) {
|
|
212
|
+
try {
|
|
213
|
+
const pkg = JSON.parse(fs.readFileSync(consumerPkgPath, "utf-8"));
|
|
214
|
+
const bkitField = pkg.bkit;
|
|
215
|
+
const stored = parseIssueTracker(bkitField?.issueTracker);
|
|
216
|
+
if (stored !== null)
|
|
217
|
+
issueTracker = stored;
|
|
218
|
+
}
|
|
219
|
+
catch {
|
|
220
|
+
// non-fatal — keep default
|
|
221
|
+
}
|
|
222
|
+
}
|
|
223
|
+
if (tracker !== null)
|
|
224
|
+
issueTracker = tracker;
|
|
225
|
+
}
|
|
226
|
+
// --- Phase 1: Preflight (read-only, before any writes) ---
|
|
227
|
+
// Must run BEFORE resolveTokens to short-circuit cleanly on blockers.
|
|
228
|
+
const { blockers, advisories: preflightAdvisories } = runPreflight(effectiveModules, process.cwd(), undefined, issueTracker);
|
|
229
|
+
if (blockers.length > 0) {
|
|
230
|
+
console.log(`${LOG_PREFIX} Preflight blockers detected — aborting.`);
|
|
231
|
+
const blockerBanner = formatChecklist(blockers);
|
|
232
|
+
if (blockerBanner)
|
|
233
|
+
console.log(blockerBanner);
|
|
234
|
+
process.exit(1);
|
|
235
|
+
}
|
|
236
|
+
// Resolve tokens once for the whole install
|
|
237
|
+
const tokens = await resolveTokens(process.cwd()).catch((err) => {
|
|
238
|
+
console.error(`${LOG_PREFIX} Token resolution failed: ${err.message}`);
|
|
239
|
+
process.exit(1);
|
|
240
|
+
});
|
|
241
|
+
// Parse model lookup (needed for cursor transforms).
|
|
242
|
+
// DEFAULTS come from the PACKAGE's .bkit/prompts.md § Models (authoritative, matches the
|
|
243
|
+
// prompt files about to be installed).
|
|
244
|
+
// OVERRIDES come from the CONSUMER's installed .bkit/prompts.md `## Model Overrides`
|
|
245
|
+
// section (below `bkit:end`) — per-agent, per-provider, preserved across upgrades.
|
|
246
|
+
let modelLookup = new Map();
|
|
247
|
+
let opencodeModelLookup = new Map();
|
|
248
|
+
let codexModelLookup = new Map();
|
|
249
|
+
let effortMap = new Map();
|
|
250
|
+
const promptsMdPath = path.join(getBkitDocsRoot(), "prompts.md");
|
|
251
|
+
const consumerPromptsMdPath = path.join(process.cwd(), ".bkit", "prompts.md");
|
|
252
|
+
if (fs.existsSync(promptsMdPath)) {
|
|
253
|
+
try {
|
|
254
|
+
modelLookup = parseModelLookup(promptsMdPath);
|
|
255
|
+
}
|
|
256
|
+
catch {
|
|
257
|
+
// Not fatal — cursor module will fail per-file if a model is missing
|
|
258
|
+
}
|
|
259
|
+
// Consumer overrides merge after the base parse — parseModelOverrides is internally
|
|
260
|
+
// guarded (returns [] when the file/section is absent), so it needs no catch here.
|
|
261
|
+
applyModelOverrides(modelLookup, "cursor", consumerPromptsMdPath);
|
|
262
|
+
if (effectiveModules.has("opencode")) {
|
|
263
|
+
// On install `--opencode=<provider>` already set this; on check it comes from what the
|
|
264
|
+
// consumer installed. Either way the opencode host cannot render without a real one.
|
|
265
|
+
const provider = renderOpencodeProvider ?? requireOpencodeProvider(process.cwd(), "opencode render");
|
|
266
|
+
try {
|
|
267
|
+
opencodeModelLookup = buildOpencodeModelLookup(promptsMdPath, provider);
|
|
268
|
+
}
|
|
269
|
+
catch {
|
|
270
|
+
// Not fatal — opencode module will fail per-file if a model is missing
|
|
271
|
+
}
|
|
272
|
+
applyModelOverrides(opencodeModelLookup, provider, consumerPromptsMdPath);
|
|
273
|
+
}
|
|
274
|
+
if (effectiveModules.has("codex")) {
|
|
275
|
+
// Codex is nullary — one gateway (`openai`), so there is nothing to detect.
|
|
276
|
+
try {
|
|
277
|
+
codexModelLookup = buildOpencodeModelLookup(promptsMdPath, "openai");
|
|
278
|
+
}
|
|
279
|
+
catch {
|
|
280
|
+
// Not fatal — codex module will fail per-file if a model is missing
|
|
281
|
+
}
|
|
282
|
+
applyModelOverrides(codexModelLookup, "openai", consumerPromptsMdPath);
|
|
283
|
+
}
|
|
284
|
+
effortMap = parseEffortMap(promptsMdPath);
|
|
285
|
+
}
|
|
286
|
+
// Seed preflight advisories into ctx so modules can accumulate into the same list.
|
|
287
|
+
const advisories = [
|
|
288
|
+
...preflightAdvisories,
|
|
289
|
+
];
|
|
290
|
+
const ws = { writes: [] };
|
|
291
|
+
const postDispatch = [];
|
|
292
|
+
// Symmetric cloud/tracker constraint (FINAL SCOPE decision 3/4) — see
|
|
293
|
+
// validateCloudTrackerMatch for the full rationale. Checked BEFORE any
|
|
294
|
+
// package.json write so no state is recorded on mismatch.
|
|
295
|
+
const cloudTrackerError = validateCloudTrackerMatch(cloudVariant, modules.has("cloud"), issueTracker);
|
|
296
|
+
if (cloudTrackerError) {
|
|
297
|
+
console.error(cloudTrackerError);
|
|
298
|
+
process.exit(1);
|
|
299
|
+
}
|
|
300
|
+
if (cloudVariant !== null && modules.has("cloud")) {
|
|
301
|
+
// auto=opencode additionally requires the local opencode host to be installed first
|
|
302
|
+
// (the cloud job runs against the committed .opencode/ — no model is hard-coded in YAML).
|
|
303
|
+
if (cloudVariant === "opencode" && !fs.existsSync(path.join(process.cwd(), ".opencode"))) {
|
|
304
|
+
console.error(`[bkit] --auto=opencode requires the local opencode host to be installed first.\n` +
|
|
305
|
+
`Run: bkit install --opencode=<provider> (e.g. --opencode=opencode-zen)\n` +
|
|
306
|
+
`The cloud opencode job runs against the committed .opencode/ config — without it there is nothing to run.`);
|
|
307
|
+
process.exit(1);
|
|
308
|
+
}
|
|
309
|
+
}
|
|
310
|
+
// Persist bkit manifest fields to consumer package.json AFTER all hard-error gates pass.
|
|
311
|
+
// This preserves the "no files written on mismatch" invariant. Two fields are recorded:
|
|
312
|
+
// - issueTracker: when a `--tracker=` value was given this run.
|
|
313
|
+
// - opencodeProvider: when an `--opencode=<provider>` value was given this run. This is
|
|
314
|
+
// the authoritative provider record detectOpencodeProvider reads on upgrade — REQUIRED
|
|
315
|
+
// for managed-auth gateways (opencode), whose opencode.json carries no provider block to
|
|
316
|
+
// detect from. Both are merged in one read-modify-write to avoid double-writing.
|
|
317
|
+
const persistTracker = tracker !== null;
|
|
318
|
+
const persistProvider = opencodeProvider !== null && effectiveModules.has("opencode");
|
|
319
|
+
if ((persistTracker || persistProvider) && !dryRun) {
|
|
320
|
+
const consumerPkgPath2 = path.join(process.cwd(), "package.json");
|
|
321
|
+
if (fs.existsSync(consumerPkgPath2)) {
|
|
322
|
+
try {
|
|
323
|
+
const raw = fs.readFileSync(consumerPkgPath2, "utf-8");
|
|
324
|
+
const pkg = JSON.parse(raw);
|
|
325
|
+
const bkit = (pkg.bkit ?? {});
|
|
326
|
+
if (persistTracker)
|
|
327
|
+
bkit.issueTracker = tracker;
|
|
328
|
+
if (persistProvider) {
|
|
329
|
+
bkit.opencodeProvider = opencodeProvider; // active (drives agent frontmatter)
|
|
330
|
+
// Update providers array (deduped).
|
|
331
|
+
const existingArr = Array.isArray(bkit.opencodeProviders)
|
|
332
|
+
? [...bkit.opencodeProviders]
|
|
333
|
+
: [];
|
|
334
|
+
if (!existingArr.includes(opencodeProvider)) {
|
|
335
|
+
existingArr.push(opencodeProvider);
|
|
336
|
+
}
|
|
337
|
+
bkit.opencodeProviders = existingArr;
|
|
338
|
+
}
|
|
339
|
+
pkg.bkit = bkit;
|
|
340
|
+
const indentMatch = raw.match(/\n([ \t]+)"/);
|
|
341
|
+
const indent = indentMatch ? indentMatch[1] : " ";
|
|
342
|
+
const trailingNewline = raw.endsWith("\n") ? "\n" : "";
|
|
343
|
+
fs.writeFileSync(consumerPkgPath2, JSON.stringify(pkg, null, indent) + trailingNewline, "utf-8");
|
|
344
|
+
if (persistTracker) {
|
|
345
|
+
console.log(`${LOG_PREFIX} Set bkit.issueTracker = "${tracker}" in package.json`);
|
|
346
|
+
}
|
|
347
|
+
if (persistProvider) {
|
|
348
|
+
console.log(`${LOG_PREFIX} Set bkit.opencodeProvider = "${opencodeProvider}" and updated bkit.opencodeProviders in package.json`);
|
|
349
|
+
}
|
|
350
|
+
}
|
|
351
|
+
catch {
|
|
352
|
+
// non-fatal
|
|
353
|
+
}
|
|
354
|
+
}
|
|
355
|
+
}
|
|
356
|
+
const ctx = {
|
|
357
|
+
dryRun,
|
|
358
|
+
tokens,
|
|
359
|
+
modelLookup,
|
|
360
|
+
opencodeModelLookup,
|
|
361
|
+
codexModelLookup,
|
|
362
|
+
effortMap,
|
|
363
|
+
opencodeProvider: renderOpencodeProvider,
|
|
364
|
+
advisories,
|
|
365
|
+
ws,
|
|
366
|
+
logPrefix: LOG_PREFIX,
|
|
367
|
+
postDispatch,
|
|
368
|
+
issueTracker,
|
|
369
|
+
cloudVariant,
|
|
370
|
+
// Stamped into every rendered agent + command as the managed-version marker.
|
|
371
|
+
version: getInstallingVersion(),
|
|
372
|
+
};
|
|
373
|
+
// --- Phase 2: Install (current behaviour — dispatch modules) ---
|
|
374
|
+
// check dispatches the detected installed set; install dispatches the resolved set.
|
|
375
|
+
//
|
|
376
|
+
// `.bkit-staging/` is a per-run scratch area for rendered files (e.g. opencode.json) — NOT a
|
|
377
|
+
// cross-module commit/rollback transaction. Module fns write directly to their consumer
|
|
378
|
+
// destinations, so a mid-dispatch failure can leave files already written (postDispatch — the
|
|
379
|
+
// `.bkit/version` pin — does not run). The error is surfaced, never swallowed, and the scratch
|
|
380
|
+
// dir is always cleaned up. `bkit install` is idempotent, so re-running completes a partial
|
|
381
|
+
// install. See README § Install staging directory.
|
|
382
|
+
try {
|
|
383
|
+
dispatchModules(effectiveModules, ctx);
|
|
384
|
+
}
|
|
385
|
+
finally {
|
|
386
|
+
discardAllStaging();
|
|
387
|
+
}
|
|
388
|
+
const totalWrites = ws.writes.length;
|
|
389
|
+
// Done banner first so the line count is easy to find above the checklist.
|
|
390
|
+
// For check, "would occur" makes intent explicit; for install, writes already happened.
|
|
391
|
+
if (dryRun) {
|
|
392
|
+
console.log(`${LOG_PREFIX} ${totalWrites} write(s) would occur.`);
|
|
393
|
+
}
|
|
394
|
+
else {
|
|
395
|
+
console.log(`${LOG_PREFIX} Done. ${totalWrites} write(s).`);
|
|
396
|
+
}
|
|
397
|
+
// --- Phase 3: Post-install checks (re-detect + unified output) ---
|
|
398
|
+
// Runs for both install AND check — detectors are read-only, so check produces
|
|
399
|
+
// the same advisory set as install would emit against the same filesystem state.
|
|
400
|
+
// Changelog version-delta header (A7): surface what changed in the installed version.
|
|
401
|
+
try {
|
|
402
|
+
const pkgJsonPath = path.join(getPkgRoot(), "package.json");
|
|
403
|
+
if (fs.existsSync(pkgJsonPath)) {
|
|
404
|
+
const pkg = JSON.parse(fs.readFileSync(pkgJsonPath, "utf-8"));
|
|
405
|
+
const deltaHeader = readChangelogVersionDelta(pkg.version ?? "");
|
|
406
|
+
if (deltaHeader)
|
|
407
|
+
console.log(deltaHeader);
|
|
408
|
+
}
|
|
409
|
+
}
|
|
410
|
+
catch (err) {
|
|
411
|
+
void err; // Non-fatal — changelog header is informational
|
|
412
|
+
}
|
|
413
|
+
const postFindings = runPostInstallCheck(ctx.advisories, process.cwd());
|
|
414
|
+
// check only: install has just written every hook file of the modules it dispatched, and a
|
|
415
|
+
// missing bkit-cloud-bootstrap.sh after `install --claude` is not that run's fault.
|
|
416
|
+
const missingHooks = dryRun ? findMissingOwnedHooks(process.cwd(), effectiveModules) : [];
|
|
417
|
+
const missingHooksFinding = detectOwnedHookMissing(missingHooks);
|
|
418
|
+
if (missingHooksFinding)
|
|
419
|
+
postFindings.push(missingHooksFinding);
|
|
420
|
+
const banner = formatChecklist(postFindings);
|
|
421
|
+
if (banner)
|
|
422
|
+
console.log(banner);
|
|
423
|
+
writeAdvisoriesArtifact(postFindings, {
|
|
424
|
+
cwd: process.cwd(),
|
|
425
|
+
mode: dryRun ? "check" : "install",
|
|
426
|
+
version: getInstallingVersion(),
|
|
427
|
+
logPrefix: LOG_PREFIX,
|
|
428
|
+
});
|
|
429
|
+
// Check mode: exit 1 on drift (see reportCheckDrift).
|
|
430
|
+
if (dryRun) {
|
|
431
|
+
reportCheckDrift(postFindings, totalWrites, missingHooks);
|
|
432
|
+
return;
|
|
433
|
+
}
|
|
434
|
+
// P2.T9: exit-1 on Phase 3 blockers + recovery action text.
|
|
435
|
+
// Blockers in Phase 3 are actionable hard-fails (e.g. gh-bkit-token gap in CI).
|
|
436
|
+
// Advisory findings are informational only and do NOT exit-1.
|
|
437
|
+
const phase3Blockers = postFindings.filter((f) => f.severity === "blocker");
|
|
438
|
+
if (phase3Blockers.length > 0) {
|
|
439
|
+
const recoveryFlags = modulesToCliFlags(effectiveModules, opencodeProvider, cloudVariant);
|
|
440
|
+
const recoveryLine = `pnpm bkit uninstall ${recoveryFlags} && <fix the issue> && pnpm bkit install ${recoveryFlags}`;
|
|
441
|
+
console.error(`${LOG_PREFIX} ${phase3Blockers.length} Phase 3 blocker(s) detected. Recovery:\n ${recoveryLine}`);
|
|
442
|
+
// P2.T10: --auto-revert: run uninstall in-process before exit-1
|
|
443
|
+
if (uninstallFlags.autoRevert) {
|
|
444
|
+
console.log(`${LOG_PREFIX} --auto-revert: reverting install...`);
|
|
445
|
+
const uninstallCtx = {
|
|
446
|
+
cwd: process.cwd(),
|
|
447
|
+
dryRun: false,
|
|
448
|
+
// force: true — auto-revert must delete byte-equal-text files (e.g. .bkit/version)
|
|
449
|
+
// that were just written in this install run. Without force, the hash guard keeps
|
|
450
|
+
// any of them whose hash `.bkit/version` does not record.
|
|
451
|
+
force: true,
|
|
452
|
+
nuke: false,
|
|
453
|
+
yes: true,
|
|
454
|
+
logPrefix: "[bkit-uninstall]",
|
|
455
|
+
};
|
|
456
|
+
await runUninstall([...effectiveModules], uninstallCtx);
|
|
457
|
+
console.log(`${LOG_PREFIX} --auto-revert: uninstall complete. Exiting 1.`);
|
|
458
|
+
}
|
|
459
|
+
process.exit(1);
|
|
460
|
+
}
|
|
461
|
+
}
|