@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,447 @@
|
|
|
1
|
+
// checks/after/index.ts — Phase 3: re-detect AFTER writes; produce the unified output.
|
|
2
|
+
// runPostInstallCheck calls the detectors in this folder (one file per group of findings);
|
|
3
|
+
// this file also formats the checklist and writes `.bkit/advisories.md`.
|
|
4
|
+
import * as fs from "node:fs";
|
|
5
|
+
import * as path from "node:path";
|
|
6
|
+
import { dedupeById } from "../before/index.js";
|
|
7
|
+
import { detectMissingDotenv, detectBlankDotenvKeys, detectDirenvMissing, detectDirenvNotAllowed, } from "../before/env.js";
|
|
8
|
+
import { getPkgRoot } from "../../shared/package-roots.js";
|
|
9
|
+
import { detectOpencodeYmlProviderDrift } from "../../install/modules/opencode.js";
|
|
10
|
+
import { TEMPLATES_POINTER } from "../../install/template-copies.js";
|
|
11
|
+
import { detectManagedStale } from "./managed.js";
|
|
12
|
+
import { AGENT_INLINE_SOURCE_GUIDANCE, BKIT_GH_TOKEN_INSTALL_MISSING_ACTION, BKIT_GH_TOKEN_INSTALL_UNKNOWN_ACTION, buildCloudDashboardsAdvisory, detectCiRouterSecrets, detectGhSecret, detectNpmrcAuth, detectNpmrcAuthTokenLine, detectShellGhMcpToken, detectShellToken, hasGithubMcpServer, } from "./auth.js";
|
|
13
|
+
import { VERCEL_MISSING_ACTION, detectVercelEnv, detectVercelInstallCommandMissingAuth, detectVercelProject, } from "./vercel.js";
|
|
14
|
+
import { buildCloudSetupAdvisory, buildGithubProjectAdvisory, buildTrackerSetupAdvisory, detectActionsWritePermissions, detectGithubProjectFieldIdFormat, detectMainBranchProtection, readConsumerIssueTracker, } from "./github.js";
|
|
15
|
+
import { buildDepUpdaterSetupAdvisory, detectBkitStubs, detectValePackageNotSynced, detectWorkflowLintToolsMissing, } from "./tools.js";
|
|
16
|
+
import { detectBkitCloudYmlAlwaysTrueGate, detectCiYmlCapstoneContractDrift, detectCiYmlMissingActionlint, detectCiYmlMissingTokenEnv, detectCiYmlRunInjection, detectGhaFloatingTags, detectRunLevelsNotComposed, detectTaggedTestsWithoutCiHome, detectTestIntegrationEnv, detectTurboIntegrationInputs, } from "./ci-yml.js";
|
|
17
|
+
// ---------------------------------------------------------------------------
|
|
18
|
+
// formatChecklist — pure renderer
|
|
19
|
+
// ---------------------------------------------------------------------------
|
|
20
|
+
/**
|
|
21
|
+
* Format a list of findings into the post-install checklist banner.
|
|
22
|
+
* Returns `""` when findings is empty — callers can `if (banner)` to stay silent.
|
|
23
|
+
* No console.log inside — caller logs.
|
|
24
|
+
*
|
|
25
|
+
* Format per finding:
|
|
26
|
+
* --- i/N [severity] id ---
|
|
27
|
+
* DETECT: ...
|
|
28
|
+
* ACTION: ...
|
|
29
|
+
*/
|
|
30
|
+
export function formatChecklist(findings) {
|
|
31
|
+
if (findings.length === 0)
|
|
32
|
+
return "";
|
|
33
|
+
const banner = "=".repeat(58);
|
|
34
|
+
const total = findings.length;
|
|
35
|
+
const lines = [];
|
|
36
|
+
lines.push(`\n${banner}`);
|
|
37
|
+
lines.push(`[bkit] Post-install checklist (${total} item${total === 1 ? "" : "s"})`);
|
|
38
|
+
lines.push(banner);
|
|
39
|
+
lines.push("\nINSTRUCTIONS FOR AN AI AGENT — copy this entire block into a\n" +
|
|
40
|
+
"coding assistant to apply each item. Each ACTION is self-contained.\n" +
|
|
41
|
+
`\n${TEMPLATES_POINTER}\n`);
|
|
42
|
+
for (let i = 0; i < findings.length; i++) {
|
|
43
|
+
const f = findings[i];
|
|
44
|
+
lines.push(`\n--- ${i + 1}/${total} [${f.severity}] ${f.id} ---`);
|
|
45
|
+
lines.push(`DETECT: ${f.detect}`);
|
|
46
|
+
lines.push(`ACTION: ${f.action}`);
|
|
47
|
+
}
|
|
48
|
+
lines.push(`\n${banner}\n`);
|
|
49
|
+
return lines.join("\n");
|
|
50
|
+
}
|
|
51
|
+
/**
|
|
52
|
+
* Render findings as a markdown artifact suitable for `.bkit/advisories.md`.
|
|
53
|
+
* Mirrors `formatChecklist` content but in markdown form so the file can be
|
|
54
|
+
* referenced and revisited between installs. Overwritten on every run.
|
|
55
|
+
*/
|
|
56
|
+
export function renderAdvisoriesMarkdown(findings, opts) {
|
|
57
|
+
const lines = [];
|
|
58
|
+
// This is a generated, gitignored artifact — not authored prose. Advisory
|
|
59
|
+
// strings (and reproduced config snippets like `.vale.ini`'s `write-good.So =
|
|
60
|
+
// NO`) legitimately contain sentence-initial "So" and slop tokens. The shipped
|
|
61
|
+
// `lint:prose` globs on-disk `.agents/*.md`, so without this whole-file Vale
|
|
62
|
+
// skip the husky hooks fail on a file the consumer cannot edit.
|
|
63
|
+
lines.push("<!-- vale off -->");
|
|
64
|
+
lines.push("");
|
|
65
|
+
lines.push("# bkit advisories");
|
|
66
|
+
lines.push("");
|
|
67
|
+
lines.push(`_bkit: ${opts.version}_ `);
|
|
68
|
+
lines.push(`_Mode: ${opts.mode}_`);
|
|
69
|
+
lines.push("");
|
|
70
|
+
lines.push("> Auto-generated by `bkit install` / `bkit check` / `bkit doctor`. Overwritten on each run.");
|
|
71
|
+
lines.push("");
|
|
72
|
+
if (findings.length === 0) {
|
|
73
|
+
lines.push("**No advisories.** Last run was clean.");
|
|
74
|
+
lines.push("");
|
|
75
|
+
return lines.join("\n");
|
|
76
|
+
}
|
|
77
|
+
const blockerCount = findings.filter((f) => f.severity === "blocker").length;
|
|
78
|
+
const advisoryCount = findings.filter((f) => f.severity === "advisory").length;
|
|
79
|
+
lines.push(`${findings.length} finding(s) — ${blockerCount} blocker, ${advisoryCount} advisory.`);
|
|
80
|
+
lines.push("");
|
|
81
|
+
lines.push("> INSTRUCTIONS FOR AN AI AGENT — copy this file (or specific items) into a coding assistant to apply each item. Each ACTION is self-contained.");
|
|
82
|
+
lines.push("");
|
|
83
|
+
lines.push(`> ${TEMPLATES_POINTER}`);
|
|
84
|
+
lines.push("");
|
|
85
|
+
const total = findings.length;
|
|
86
|
+
for (let i = 0; i < total; i++) {
|
|
87
|
+
const f = findings[i];
|
|
88
|
+
lines.push(`## ${i + 1}/${total} [${f.severity}] ${f.id}`);
|
|
89
|
+
lines.push("");
|
|
90
|
+
lines.push(`**Detect:** ${f.detect}`);
|
|
91
|
+
lines.push("");
|
|
92
|
+
lines.push(`**Action:** ${f.action}`);
|
|
93
|
+
lines.push("");
|
|
94
|
+
}
|
|
95
|
+
return lines.join("\n");
|
|
96
|
+
}
|
|
97
|
+
/**
|
|
98
|
+
* Write `.bkit/advisories.md` in the consumer's cwd. Best-effort:
|
|
99
|
+
* mkdir -p `.agents/`, write the rendered markdown, log a one-line status.
|
|
100
|
+
* Any I/O failure is logged but does not throw — the artifact is informational.
|
|
101
|
+
*/
|
|
102
|
+
export function writeAdvisoriesArtifact(findings, opts) {
|
|
103
|
+
const dir = path.join(opts.cwd, ".bkit");
|
|
104
|
+
const filePath = path.join(dir, "advisories.md");
|
|
105
|
+
try {
|
|
106
|
+
fs.mkdirSync(dir, { recursive: true });
|
|
107
|
+
const content = renderAdvisoriesMarkdown(findings, {
|
|
108
|
+
mode: opts.mode,
|
|
109
|
+
version: opts.version,
|
|
110
|
+
});
|
|
111
|
+
fs.writeFileSync(filePath, content);
|
|
112
|
+
const n = findings.length;
|
|
113
|
+
console.log(`${opts.logPrefix} Wrote .bkit/advisories.md (${n} item${n === 1 ? "" : "s"}).`);
|
|
114
|
+
}
|
|
115
|
+
catch (err) {
|
|
116
|
+
console.error(`${opts.logPrefix} Failed to write .bkit/advisories.md: ${err.message}`);
|
|
117
|
+
}
|
|
118
|
+
}
|
|
119
|
+
// ---------------------------------------------------------------------------
|
|
120
|
+
// Changelog version-delta header (A7)
|
|
121
|
+
// ---------------------------------------------------------------------------
|
|
122
|
+
/**
|
|
123
|
+
* Read the bkit CHANGELOG.md (from the package root) and extract the section
|
|
124
|
+
* header for `version`. Returns a formatted version-delta string for display
|
|
125
|
+
* in post-install output, or null if CHANGELOG.md is absent or version not found.
|
|
126
|
+
*
|
|
127
|
+
* Version header format in CHANGELOG.md: `## [X.Y.Z] — YYYY-MM-DD`
|
|
128
|
+
*/
|
|
129
|
+
export function readChangelogVersionDelta(version) {
|
|
130
|
+
try {
|
|
131
|
+
const changelogPath = path.join(getPkgRoot(), "CHANGELOG.md");
|
|
132
|
+
if (!fs.existsSync(changelogPath))
|
|
133
|
+
return null;
|
|
134
|
+
const content = fs.readFileSync(changelogPath, "utf-8");
|
|
135
|
+
// Find the header for this version
|
|
136
|
+
const versionEscaped = version.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
|
|
137
|
+
const headerRe = new RegExp(`^## \\[${versionEscaped}\\][^\n]*`, "m");
|
|
138
|
+
const match = content.match(headerRe);
|
|
139
|
+
if (!match)
|
|
140
|
+
return null;
|
|
141
|
+
return `[bkit] What's new in v${version}: ${match[0].replace(/^## /, "")}`;
|
|
142
|
+
}
|
|
143
|
+
catch {
|
|
144
|
+
return null;
|
|
145
|
+
}
|
|
146
|
+
}
|
|
147
|
+
// ---------------------------------------------------------------------------
|
|
148
|
+
// runPostInstallCheck — main Phase 3 entry point
|
|
149
|
+
// ---------------------------------------------------------------------------
|
|
150
|
+
/**
|
|
151
|
+
* Re-run token-surface + bkit-ci.yml + vale-sync detectors after writes.
|
|
152
|
+
*
|
|
153
|
+
* - Intra-phase dedup: Phase 3 findings are deduped by id (first occurrence wins).
|
|
154
|
+
* - Cross-phase dedup: Phase 3 wins on id conflict (re-detection is more accurate).
|
|
155
|
+
*
|
|
156
|
+
* Runs unconditionally for both `bkit install` and `bkit check` — detectors are
|
|
157
|
+
* read-only (env probes, gh/vale CLI version checks, file reads) and produce the
|
|
158
|
+
* same advisory set against the same filesystem state regardless of caller.
|
|
159
|
+
*
|
|
160
|
+
* cwd defaults to process.cwd().
|
|
161
|
+
*/
|
|
162
|
+
export function runPostInstallCheck(preflightAdvisories, cwd = process.cwd()) {
|
|
163
|
+
const phase3 = [];
|
|
164
|
+
// Managed-version marker gate — in `bkit check`, a blocker on main/dev (or a PR into
|
|
165
|
+
// them) and a non-blocking advisory on feature branches when any stamped file's marker
|
|
166
|
+
// drifts from the installed version. No-op in real install/upgrade (re-stamped Phase 2).
|
|
167
|
+
const managedStale = detectManagedStale(cwd);
|
|
168
|
+
if (managedStale)
|
|
169
|
+
phase3.push(managedStale);
|
|
170
|
+
// Shell token
|
|
171
|
+
const shellStatus = detectShellToken();
|
|
172
|
+
if (shellStatus === "missing") {
|
|
173
|
+
phase3.push({
|
|
174
|
+
id: "gh-bkit-token-unset-shell",
|
|
175
|
+
severity: "advisory",
|
|
176
|
+
detect: "BKIT_GH_TOKEN_INSTALL is not set in the shell environment (undefined).",
|
|
177
|
+
action: "Set BKIT_GH_TOKEN_INSTALL in .bkit/.env (canonical local-secrets file, gitignored), then have direnv auto-load it on cd:\n\n cp .bkit/.env.example .bkit/.env # if not already done\n # edit .bkit/.env — set BKIT_GH_TOKEN_INSTALL=<classic PAT, read:packages scope>\n direnv allow # one-time per repo; requires `brew install direnv` + shell hook\n\nThen restart your editor (Claude Code / Cursor) so the new env reaches MCP servers. Generate the PAT at: https://github.com/settings/tokens (Tokens (classic)). Fine-grained PATs are rejected by GitHub Packages with HTTP 403 — must be classic.\n\nFallback (if direnv unavailable): export BKIT_GH_TOKEN_INSTALL=<your-pat> in ~/.zshrc / ~/.bashrc.\n\n" +
|
|
178
|
+
AGENT_INLINE_SOURCE_GUIDANCE,
|
|
179
|
+
});
|
|
180
|
+
}
|
|
181
|
+
else if (shellStatus === "empty") {
|
|
182
|
+
phase3.push({
|
|
183
|
+
id: "gh-bkit-token-empty-shell",
|
|
184
|
+
severity: "advisory",
|
|
185
|
+
detect: 'BKIT_GH_TOKEN_INSTALL is set to an empty string (BKIT_GH_TOKEN_INSTALL=""). `pnpm config set` will write an empty auth token, producing a 401 on the next install.',
|
|
186
|
+
action: 'Set a non-empty BKIT_GH_TOKEN_INSTALL in .bkit/.env (canonical local-secrets file), then `direnv allow` and restart your shell so the new value loads. An empty string is distinct from unset, but both make `pnpm config set "//npm.pkg.github.com/:_authToken=$BKIT_GH_TOKEN_INSTALL"` store an empty token, so pnpm sends no auth header and the GH Packages registry returns 401 on download. Safest fix: set a real token in .bkit/.env, then re-run the `pnpm config set` line.\n\n' +
|
|
187
|
+
AGENT_INLINE_SOURCE_GUIDANCE,
|
|
188
|
+
});
|
|
189
|
+
}
|
|
190
|
+
// BKIT_GH_TOKEN shell env — authenticates the GitHub MCP server
|
|
191
|
+
// (`Authorization: Bearer ${BKIT_GH_TOKEN}` in .mcp.json), which powers the entire
|
|
192
|
+
// tracker + PR + Projects MCP surface. Only flags when a github MCP server is
|
|
193
|
+
// configured, and never in CI.
|
|
194
|
+
if (hasGithubMcpServer(cwd) && !process.env.CI) {
|
|
195
|
+
const ghMcpTokenStatus = detectShellGhMcpToken();
|
|
196
|
+
if (ghMcpTokenStatus === "missing") {
|
|
197
|
+
phase3.push({
|
|
198
|
+
id: "gh-mcp-token-unset-shell",
|
|
199
|
+
severity: "advisory",
|
|
200
|
+
detect: "BKIT_GH_TOKEN is not set in the shell environment (undefined). The GitHub MCP server authenticates with `Authorization: Bearer ${BKIT_GH_TOKEN}` — without it, every tracker, PR, and board MCP call fails to connect.",
|
|
201
|
+
action: "Set BKIT_GH_TOKEN in .bkit/.env (canonical local-secrets file, gitignored), then `direnv allow` and restart your editor so MCP servers pick it up:\n\n cp .bkit/.env.example .bkit/.env # if not already done\n # edit .bkit/.env — set BKIT_GH_TOKEN=<fine-grained PAT>\n direnv allow\n\nThe PAT needs Contents, Pull requests, Issues, and Actions read & write (plus organization-scoped Projects read & write if you use board sync). Generate at: https://github.com/settings/tokens. In cloud sessions (Claude Code web / Cursor Background Agents) set BKIT_GH_TOKEN in the dashboard env vars instead — repo files are not read for secrets there.",
|
|
202
|
+
});
|
|
203
|
+
}
|
|
204
|
+
else if (ghMcpTokenStatus === "empty") {
|
|
205
|
+
phase3.push({
|
|
206
|
+
id: "gh-mcp-token-empty-shell",
|
|
207
|
+
severity: "advisory",
|
|
208
|
+
detect: 'BKIT_GH_TOKEN is set to an empty string (BKIT_GH_TOKEN=""). The GitHub MCP server sends an empty bearer token and fails to authenticate — distinct from unset, same effect.',
|
|
209
|
+
action: "Set a non-empty BKIT_GH_TOKEN in .bkit/.env (fine-grained PAT with Contents / Pull requests / Issues / Actions read & write), then `direnv allow` and restart your editor so MCP servers reload.",
|
|
210
|
+
});
|
|
211
|
+
}
|
|
212
|
+
}
|
|
213
|
+
// .npmrc auth
|
|
214
|
+
const npmrcStatus = detectNpmrcAuth(cwd);
|
|
215
|
+
if (npmrcStatus === "missing") {
|
|
216
|
+
phase3.push({
|
|
217
|
+
id: "npmrc-missing-gh-packages",
|
|
218
|
+
severity: "advisory",
|
|
219
|
+
detect: ".npmrc exists but is missing the required @cbartens registry mapping.",
|
|
220
|
+
action: "Add this line to .npmrc at the repo root (the auth token is NOT stored here):\n\n" +
|
|
221
|
+
" @cbartens:registry=https://npm.pkg.github.com\n\n" +
|
|
222
|
+
"The token lives in pnpm's user-level config — write it once with:\n\n" +
|
|
223
|
+
' pnpm config set "//npm.pkg.github.com/:_authToken=$BKIT_GH_TOKEN_INSTALL"\n\n' +
|
|
224
|
+
"pnpm >=10.34.3 does not authenticate a project-.npmrc ${BKIT_GH_TOKEN_INSTALL} env-substitution (it 401s on download), which is why the token must NOT go in .npmrc.",
|
|
225
|
+
});
|
|
226
|
+
}
|
|
227
|
+
// "unknown" (absent) → silent skip per spec
|
|
228
|
+
// .npmrc auth-token line. The committed project .npmrc must NOT carry
|
|
229
|
+
// `//npm.pkg.github.com/:_authToken=…`: pnpm >=10.34.3 401s on it AND it shadows the
|
|
230
|
+
// user-level token written by `pnpm config set` (project config wins).
|
|
231
|
+
if (detectNpmrcAuthTokenLine(cwd)) {
|
|
232
|
+
phase3.push({
|
|
233
|
+
id: "npmrc-authtoken-line",
|
|
234
|
+
severity: "advisory",
|
|
235
|
+
detect: ".npmrc carries a `//npm.pkg.github.com/:_authToken=…` line. pnpm >=10.34.3 401s on a project-.npmrc auth token (ERR_PNPM_FETCH_401), and via config precedence (project > user) it shadows the token written by `pnpm config set`.",
|
|
236
|
+
action: "Remove the `//npm.pkg.github.com/:_authToken=…` line from .npmrc — keep ONLY the registry mapping:\n\n" +
|
|
237
|
+
" @cbartens:registry=https://npm.pkg.github.com\n\n" +
|
|
238
|
+
"Then write the token into pnpm's user-level config instead (CI does this in its install step):\n\n" +
|
|
239
|
+
' pnpm config set "//npm.pkg.github.com/:_authToken=$BKIT_GH_TOKEN_INSTALL"\n\n' +
|
|
240
|
+
"`pnpm config set` stores the shell-expanded literal token in pnpm's user-level config — version-proof across pnpm 10.x and 11.x.",
|
|
241
|
+
});
|
|
242
|
+
}
|
|
243
|
+
// GH secret
|
|
244
|
+
const ghSecretStatus = detectGhSecret();
|
|
245
|
+
if (ghSecretStatus === "missing") {
|
|
246
|
+
phase3.push({
|
|
247
|
+
id: "gh-bkit-token-secret-missing",
|
|
248
|
+
severity: "advisory",
|
|
249
|
+
detect: "gh secret list confirms BKIT_GH_TOKEN_INSTALL secret is NOT set on this GitHub repo.",
|
|
250
|
+
action: BKIT_GH_TOKEN_INSTALL_MISSING_ACTION,
|
|
251
|
+
});
|
|
252
|
+
}
|
|
253
|
+
else if (ghSecretStatus === "unknown") {
|
|
254
|
+
phase3.push({
|
|
255
|
+
id: "gh-bkit-token-secret-unknown",
|
|
256
|
+
severity: "advisory",
|
|
257
|
+
detect: "Could not verify BKIT_GH_TOKEN_INSTALL secret (gh CLI unavailable, unauthenticated, or not a GitHub repo).",
|
|
258
|
+
action: BKIT_GH_TOKEN_INSTALL_UNKNOWN_ACTION,
|
|
259
|
+
});
|
|
260
|
+
}
|
|
261
|
+
// Vercel env (only if a Vercel project is detected)
|
|
262
|
+
if (detectVercelProject(cwd)) {
|
|
263
|
+
const previewStatus = detectVercelEnv("preview", cwd);
|
|
264
|
+
if (previewStatus === "missing") {
|
|
265
|
+
phase3.push({
|
|
266
|
+
id: "vercel-env-missing-preview",
|
|
267
|
+
severity: "advisory",
|
|
268
|
+
detect: "vercel.json detected but BKIT_GH_TOKEN_INSTALL is absent from Vercel preview environment.",
|
|
269
|
+
action: VERCEL_MISSING_ACTION,
|
|
270
|
+
});
|
|
271
|
+
}
|
|
272
|
+
const productionStatus = detectVercelEnv("production", cwd);
|
|
273
|
+
if (productionStatus === "missing") {
|
|
274
|
+
phase3.push({
|
|
275
|
+
id: "vercel-env-missing-production",
|
|
276
|
+
severity: "advisory",
|
|
277
|
+
detect: "vercel.json detected but BKIT_GH_TOKEN_INSTALL is absent from Vercel production environment.",
|
|
278
|
+
action: VERCEL_MISSING_ACTION,
|
|
279
|
+
});
|
|
280
|
+
}
|
|
281
|
+
// "unknown" → silent skip (CLI absent / unauthed)
|
|
282
|
+
// Vercel installCommand auth. The env var alone is not enough: a registry-only .npmrc
|
|
283
|
+
// carries no token on pnpm
|
|
284
|
+
// >=10.34.3 and Vercel cannot run a pre-install shell step, so each vercel.json must
|
|
285
|
+
// authenticate via its installCommand or the @cbartens/bkit download 401s.
|
|
286
|
+
const vercelNoAuth = detectVercelInstallCommandMissingAuth(cwd);
|
|
287
|
+
if (vercelNoAuth.length > 0) {
|
|
288
|
+
phase3.push({
|
|
289
|
+
id: "vercel-installcommand-missing-auth",
|
|
290
|
+
severity: "advisory",
|
|
291
|
+
detect: `${vercelNoAuth.join(", ")} ${vercelNoAuth.length === 1 ? "has" : "have"} no installCommand that authenticates to the GitHub Packages registry. Vercel runs pnpm install with no pre-install shell step, so the @cbartens/bkit download 401s on pnpm >=10.34.3 even when BKIT_GH_TOKEN_INSTALL is set in the Vercel env.`,
|
|
292
|
+
action: VERCEL_MISSING_ACTION,
|
|
293
|
+
});
|
|
294
|
+
}
|
|
295
|
+
}
|
|
296
|
+
// Main branch protection — bkit's PR-base gates (build Step 17, ship Step 2)
|
|
297
|
+
// assert feat/* PRs target dev. Enforcing it at the GitHub layer needs branch
|
|
298
|
+
// protection on main restricting merges to PRs from dev.
|
|
299
|
+
const protectionStatus = detectMainBranchProtection();
|
|
300
|
+
const scriptHint = "\n\nQuick path: run `bkit setup protect-main --dry-run` to preview the policy, then drop `--dry-run` to apply. It requires the CI capstone job named by `package.json` `bkit.capstoneJob` (default `bkit-tests-check`, so the required check means 'validated', not just 'tests job did not fail') and pre-flights that the job exists in the `bkit.ciWorkflow` file before requiring it.";
|
|
301
|
+
if (protectionStatus === "missing") {
|
|
302
|
+
phase3.push({
|
|
303
|
+
id: "main-branch-protection-missing",
|
|
304
|
+
severity: "advisory",
|
|
305
|
+
detect: "main has no branch protection rule.",
|
|
306
|
+
action: "main only ever moves via a release PR (release/* -> main); bkit's build/ship workflows keep all feat/* PRs on dev. Gate main at the GitHub layer:\n\n" +
|
|
307
|
+
" Settings → Branches → Add rule → Branch name pattern: main\n" +
|
|
308
|
+
" - Require a pull request before merging\n" +
|
|
309
|
+
" - Require status checks: bkit-tests-check (the always-on capstone — required-check green then means 'the planned tiers ran', not just 'nothing failed'; do NOT require bkit-tests-scope, it is always green)\n" +
|
|
310
|
+
" - Do not allow bypassing the above settings (enforce for admins)\n" +
|
|
311
|
+
" - Require linear history; block force-pushes and deletions\n\n" +
|
|
312
|
+
"enforce-for-admins is load-bearing: agents act with the owner's admin token, so an admin-bypass exemption means the agent is the bypass. Covering admins is the only way protection actually constrains agents. dev is intentionally left unprotected — operators choose direct-push or feat/PR and own that tests ran." +
|
|
313
|
+
scriptHint,
|
|
314
|
+
});
|
|
315
|
+
}
|
|
316
|
+
// Optional post-install decisions (opt-in add-ons):
|
|
317
|
+
// 1. Issue tracker — branch on bkit.issueTracker.
|
|
318
|
+
// 2. Dependency updater — read-only. Suggests an example template. Never writes config.
|
|
319
|
+
// 3. Cloud agents — branch on bkit-cloud.yml presence.
|
|
320
|
+
const trackerSetup = buildTrackerSetupAdvisory(cwd);
|
|
321
|
+
if (trackerSetup)
|
|
322
|
+
phase3.push(trackerSetup);
|
|
323
|
+
// GitHub Projects v2 board-sync prerequisites (config + toolset + PAT scope) —
|
|
324
|
+
// absent any prerequisite, sync silently no-ops.
|
|
325
|
+
const githubProjectSetup = buildGithubProjectAdvisory(cwd);
|
|
326
|
+
if (githubProjectSetup)
|
|
327
|
+
phase3.push(githubProjectSetup);
|
|
328
|
+
// A configured board can still silently no-op if statusFieldId holds the GraphQL
|
|
329
|
+
// node id instead of the numeric field id projects_write requires.
|
|
330
|
+
const githubProjectFieldId = detectGithubProjectFieldIdFormat(cwd);
|
|
331
|
+
if (githubProjectFieldId)
|
|
332
|
+
phase3.push(githubProjectFieldId);
|
|
333
|
+
const depUpdaterSetup = buildDepUpdaterSetupAdvisory(cwd);
|
|
334
|
+
if (depUpdaterSetup)
|
|
335
|
+
phase3.push(depUpdaterSetup);
|
|
336
|
+
const cloudSetup = buildCloudSetupAdvisory(cwd);
|
|
337
|
+
if (cloudSetup)
|
|
338
|
+
phase3.push(cloudSetup);
|
|
339
|
+
// bkit-cloud.yml needs the ANTHROPIC_API_KEY repo secret.
|
|
340
|
+
for (const f of detectCiRouterSecrets(cwd))
|
|
341
|
+
phase3.push(f);
|
|
342
|
+
// bkit-cloud.yml also needs repo Actions write permissions + PR-creation
|
|
343
|
+
// allowance, else `actions/checkout` and `gh pr create` 403. Detectable at the
|
|
344
|
+
// repo level via the Actions API; org-level policy can still override.
|
|
345
|
+
if (fs.existsSync(path.join(cwd, ".github", "workflows", "bkit-cloud.yml"))) {
|
|
346
|
+
if (detectActionsWritePermissions() === "missing") {
|
|
347
|
+
phase3.push({
|
|
348
|
+
id: "actions-write-permissions-missing",
|
|
349
|
+
severity: "advisory",
|
|
350
|
+
detect: "GitHub Actions default workflow permissions on this repo are read-only and/or PR creation by Actions is disabled. `.github/workflows/bkit-cloud.yml` cannot push status commits or open/merge PRs — `actions/checkout` and `gh pr create` will 403.",
|
|
351
|
+
action: "Grant Actions write access at BOTH org and repo level:\n\n Settings -> Actions -> General -> Workflow permissions\n - Read and write permissions\n - Allow GitHub Actions to create and approve pull requests\n\nOr via CLI (repo level):\n\n gh api -X PUT repos/{owner}/{repo}/actions/permissions/workflow -f default_workflow_permissions=write -F can_approve_pull_request_reviews=true\n\nThe org-level toggle is not readable with a repo-scoped token — if the repo setting looks correct but workflows still 403, check the organization Actions policy (it can override the repo).",
|
|
352
|
+
});
|
|
353
|
+
}
|
|
354
|
+
// "unknown" -> silent skip (gh CLI unavailable / unauthenticated).
|
|
355
|
+
}
|
|
356
|
+
// Cloud / IDE-online dashboards — Cursor Background Agents + Claude Code on the web
|
|
357
|
+
// read env vars from their respective online dashboards, NOT from repo files.
|
|
358
|
+
// The same three secrets that GitHub Actions needs must be mirrored there.
|
|
359
|
+
const cloudDashboardsAdvisory = buildCloudDashboardsAdvisory(cwd);
|
|
360
|
+
if (cloudDashboardsAdvisory)
|
|
361
|
+
phase3.push(cloudDashboardsAdvisory);
|
|
362
|
+
// bkit-ci.yml missing token env
|
|
363
|
+
const ciYml = detectCiYmlMissingTokenEnv(cwd);
|
|
364
|
+
if (ciYml)
|
|
365
|
+
phase3.push(ciYml);
|
|
366
|
+
// GHA action SHA pinning (KN-3). Updater configs are consumer-owned examples.
|
|
367
|
+
const gha = detectGhaFloatingTags(cwd);
|
|
368
|
+
if (gha)
|
|
369
|
+
phase3.push(gha);
|
|
370
|
+
// bkit-cloud.yml always-true auto-route gate (block scalar wrapping ${{ }}).
|
|
371
|
+
const cloudGate = detectBkitCloudYmlAlwaysTrueGate(cwd);
|
|
372
|
+
if (cloudGate)
|
|
373
|
+
phase3.push(cloudGate);
|
|
374
|
+
// Self-installed opencode.yml (/oc handler) drifted from the installed opencode provider —
|
|
375
|
+
// it hardcodes a model + secret that `bkit install --opencode=` does not rewrite. Not for
|
|
376
|
+
// claude.yml (its @claude handler is provider-fixed). bkit-cloud.yml self-syncs, so exempt.
|
|
377
|
+
const opencodeYmlDrift = detectOpencodeYmlProviderDrift(cwd);
|
|
378
|
+
if (opencodeYmlDrift)
|
|
379
|
+
phase3.push(opencodeYmlDrift);
|
|
380
|
+
// bkit-ci.yml missing actionlint (GHA-aware lint; yaml.safe_load is not sufficient).
|
|
381
|
+
const ciActionlint = detectCiYmlMissingActionlint(cwd);
|
|
382
|
+
if (ciActionlint)
|
|
383
|
+
phase3.push(ciActionlint);
|
|
384
|
+
// bkit-ci.yml untrusted input inlined into a run: body (GHA script-injection sink). Nothing
|
|
385
|
+
// back-fills the template's env-indirection fix onto a copy adopted before it.
|
|
386
|
+
const ciRunInjection = detectCiYmlRunInjection(cwd);
|
|
387
|
+
if (ciRunInjection)
|
|
388
|
+
phase3.push(ciRunInjection);
|
|
389
|
+
// bkit-ci.yml capstone drifted from canonical contract (warning-only presence checks).
|
|
390
|
+
const capstoneDrift = detectCiYmlCapstoneContractDrift(cwd);
|
|
391
|
+
if (capstoneDrift)
|
|
392
|
+
phase3.push(capstoneDrift);
|
|
393
|
+
// @live/@smoke-tagged tests whose owning package declares no test:live/test:smoke
|
|
394
|
+
// script — "no CI home".
|
|
395
|
+
const taggedNoHome = detectTaggedTestsWithoutCiHome(cwd);
|
|
396
|
+
if (taggedNoHome)
|
|
397
|
+
phase3.push(taggedNoHome);
|
|
398
|
+
// bkit-stub sentinels in shipped templates — one advisory per still-commented stub.
|
|
399
|
+
for (const stub of detectBkitStubs(cwd))
|
|
400
|
+
phase3.push(stub);
|
|
401
|
+
// turbo.json inputs for cache-replay safety (KN-24).
|
|
402
|
+
for (const f of detectTurboIntegrationInputs(cwd))
|
|
403
|
+
phase3.push(f);
|
|
404
|
+
// test:integration runtime env (KN-23 false-confidence loop).
|
|
405
|
+
const integrationEnv = detectTestIntegrationEnv(cwd);
|
|
406
|
+
if (integrationEnv)
|
|
407
|
+
phase3.push(integrationEnv);
|
|
408
|
+
// Consumer composed run-levels on bkit primitives (else docs/deployments.md matrix is doc-only).
|
|
409
|
+
const runLevels = detectRunLevelsNotComposed(cwd);
|
|
410
|
+
if (runLevels)
|
|
411
|
+
phase3.push(runLevels);
|
|
412
|
+
// vale not synced
|
|
413
|
+
const vale = detectValePackageNotSynced(cwd);
|
|
414
|
+
if (vale)
|
|
415
|
+
phase3.push(vale);
|
|
416
|
+
// actionlint + shellcheck for local pre-push workflow linting (CI has both)
|
|
417
|
+
const wfLintTools = detectWorkflowLintToolsMissing(cwd);
|
|
418
|
+
if (wfLintTools)
|
|
419
|
+
phase3.push(wfLintTools);
|
|
420
|
+
// [mcp-env] direnv + .bkit/.env advisories.
|
|
421
|
+
// Wired here in Phase 3 — the .bkit/.env.example scaffold only exists after
|
|
422
|
+
// writes, so Phase 1 cannot see it on first install.
|
|
423
|
+
// Pass the consumer's tracker so the mcp-env prose omits BKIT_LINEAR_API_KEY on github/none
|
|
424
|
+
// repos.
|
|
425
|
+
const mcpEnvTracker = readConsumerIssueTracker(cwd);
|
|
426
|
+
const missingDotenv = detectMissingDotenv(cwd, mcpEnvTracker);
|
|
427
|
+
if (missingDotenv)
|
|
428
|
+
phase3.push(missingDotenv);
|
|
429
|
+
phase3.push(...detectBlankDotenvKeys(cwd, mcpEnvTracker));
|
|
430
|
+
const direnvMissing = detectDirenvMissing(cwd, mcpEnvTracker);
|
|
431
|
+
if (direnvMissing)
|
|
432
|
+
phase3.push(direnvMissing);
|
|
433
|
+
const direnvNotAllowed = detectDirenvNotAllowed(cwd, mcpEnvTracker);
|
|
434
|
+
if (direnvNotAllowed)
|
|
435
|
+
phase3.push(direnvNotAllowed);
|
|
436
|
+
// Intra-phase dedup (first occurrence wins)
|
|
437
|
+
const deduped = dedupeById(phase3);
|
|
438
|
+
// Dedupe the incoming preflightAdvisories (ctx.advisories may contain module-emitted
|
|
439
|
+
// duplicates in addition to runPreflight's already-deduped output).
|
|
440
|
+
const dedupedPreflight = dedupeById(preflightAdvisories);
|
|
441
|
+
// Cross-phase dedup: Phase 3 wins on conflict (remove preflight entries whose id
|
|
442
|
+
// appears in Phase 3, then merge Phase 3 at the front for the winning position).
|
|
443
|
+
const phase3Ids = new Set(deduped.map((f) => f.id));
|
|
444
|
+
const filteredPreflight = dedupedPreflight.filter((f) => !phase3Ids.has(f.id));
|
|
445
|
+
// Final order: preflight advisories (that weren't superseded) first, then Phase 3
|
|
446
|
+
return [...filteredPreflight, ...deduped];
|
|
447
|
+
}
|
|
@@ -0,0 +1,187 @@
|
|
|
1
|
+
// checks/after/managed.ts — bkit-managed files: stale managed-version markers and missing
|
|
2
|
+
// owned hook files.
|
|
3
|
+
import * as fs from "node:fs";
|
|
4
|
+
import * as path from "node:path";
|
|
5
|
+
import { spawnSync } from "node:child_process";
|
|
6
|
+
import { getModuleManifest } from "../../install/manifest.js";
|
|
7
|
+
import { readManagedVersion } from "../../install/version-file.js";
|
|
8
|
+
import { getPkgRoot } from "../../shared/package-roots.js";
|
|
9
|
+
import { detectMarkerStyle, findLineAnchoredMarkers, selectMarkers, } from "../../install/managed-block.js";
|
|
10
|
+
import { listStampedFiles } from "../../install/modules/index.js";
|
|
11
|
+
// ---------------------------------------------------------------------------
|
|
12
|
+
// detectManagedStale — managed-version marker gate over every stamped file
|
|
13
|
+
// ---------------------------------------------------------------------------
|
|
14
|
+
/**
|
|
15
|
+
* Best-effort read of the installing bkit version from the package root.
|
|
16
|
+
* Mirrors getInstallingVersion (commands/install/install.ts) / readInstallingVersion
|
|
17
|
+
* (install/modules/index.ts); kept local to avoid a postinstall → install/modules import.
|
|
18
|
+
*/
|
|
19
|
+
function readPkgVersion() {
|
|
20
|
+
try {
|
|
21
|
+
const pkg = JSON.parse(fs.readFileSync(path.join(getPkgRoot(), "package.json"), "utf-8"));
|
|
22
|
+
return pkg.version ?? "0.0.0";
|
|
23
|
+
}
|
|
24
|
+
catch {
|
|
25
|
+
return "0.0.0";
|
|
26
|
+
}
|
|
27
|
+
}
|
|
28
|
+
// ---------------------------------------------------------------------------
|
|
29
|
+
// Branch-scoped severity for the stale gates
|
|
30
|
+
//
|
|
31
|
+
// The gate is a hard BLOCKER on the integration + release branches (`main`/`dev`)
|
|
32
|
+
// and a non-blocking ADVISORY everywhere else (still shown in the checklist). A PR
|
|
33
|
+
// INTO main/dev re-asserts the blocker (via GITHUB_BASE_REF).
|
|
34
|
+
// ---------------------------------------------------------------------------
|
|
35
|
+
/** Branches where a stale managed-version marker is a hard blocker, not a warning. */
|
|
36
|
+
const PROTECTED_BRANCHES = new Set(["main", "dev"]);
|
|
37
|
+
/**
|
|
38
|
+
* Resolve the branch the check is effectively gating, preferring the CI signal:
|
|
39
|
+
* 1. `GITHUB_BASE_REF` — set on `pull_request` events to the MERGE TARGET. A PR
|
|
40
|
+
* into main/dev must hard-block, so the target wins over the source branch.
|
|
41
|
+
* 2. `GITHUB_REF_NAME` — set on `push` events to the pushed branch.
|
|
42
|
+
* 3. Local `git rev-parse --abbrev-ref HEAD` — the checked-out branch.
|
|
43
|
+
* Returns null when undeterminable (detached HEAD, no git, no CI env).
|
|
44
|
+
*/
|
|
45
|
+
function currentBranch(cwd) {
|
|
46
|
+
const base = process.env.GITHUB_BASE_REF?.trim();
|
|
47
|
+
if (base)
|
|
48
|
+
return base;
|
|
49
|
+
const refName = process.env.GITHUB_REF_NAME?.trim();
|
|
50
|
+
if (refName)
|
|
51
|
+
return refName;
|
|
52
|
+
// spawnSync (not execFileSync) so a missing git / non-repo is a non-zero status,
|
|
53
|
+
// not a thrown error needing a swallowing catch — null then means "undeterminable".
|
|
54
|
+
const r = spawnSync("git", ["rev-parse", "--abbrev-ref", "HEAD"], {
|
|
55
|
+
cwd,
|
|
56
|
+
encoding: "utf-8",
|
|
57
|
+
stdio: ["ignore", "pipe", "ignore"],
|
|
58
|
+
});
|
|
59
|
+
const b = r.status === 0 && r.stdout ? r.stdout.trim() : "";
|
|
60
|
+
return b && b !== "HEAD" ? b : null;
|
|
61
|
+
}
|
|
62
|
+
/**
|
|
63
|
+
* True when the stale gates should hard-block here (on `main`/`dev`, or a PR
|
|
64
|
+
* targeting them). Fail-safe: an undeterminable branch is treated as protected.
|
|
65
|
+
* Exported for deterministic unit testing.
|
|
66
|
+
*/
|
|
67
|
+
export function isOnProtectedBranch(cwd = process.cwd()) {
|
|
68
|
+
const b = currentBranch(cwd);
|
|
69
|
+
if (b === null)
|
|
70
|
+
return true; // undeterminable → fail safe to blocker
|
|
71
|
+
return PROTECTED_BRANCHES.has(b);
|
|
72
|
+
}
|
|
73
|
+
/**
|
|
74
|
+
* Version of the managed-version marker inside a file's first `bkit:start`…`bkit:end`
|
|
75
|
+
* block, in whichever marker style the file uses (`<!-- -->`, `# <!-- -->`, `//`).
|
|
76
|
+
* Markers count only on their own line, so prose quoting them is skipped; only a
|
|
77
|
+
* full-line marker counts, so an inline example (`vX.Y.Z` in architecture.md) is never
|
|
78
|
+
* read as the stamp. `undefined` when the file has no block, null when the block has no
|
|
79
|
+
* marker.
|
|
80
|
+
*/
|
|
81
|
+
export function readManagedBlockVersion(content) {
|
|
82
|
+
const style = detectMarkerStyle(content);
|
|
83
|
+
if (style === null)
|
|
84
|
+
return undefined;
|
|
85
|
+
const [startMarker, endMarker] = selectMarkers(style);
|
|
86
|
+
const startIdx = findLineAnchoredMarkers(content, startMarker)[0];
|
|
87
|
+
const endIdx = findLineAnchoredMarkers(content, endMarker).find((i) => i > startIdx);
|
|
88
|
+
const region = endIdx === undefined
|
|
89
|
+
? content.slice(startIdx)
|
|
90
|
+
: content.slice(startIdx, endIdx + endMarker.length);
|
|
91
|
+
return readManagedVersion(region);
|
|
92
|
+
}
|
|
93
|
+
/**
|
|
94
|
+
* Stale managed-version marker on any file bkit writes (listStampedFiles): the rendered
|
|
95
|
+
* agents / commands / skills, the managed blocks (AGENTS.md, CLAUDE.md, `.agents/*.md`,
|
|
96
|
+
* `docs/*.md`, `.gitignore`, the hooks, …) and the whole files bkit owns (`.bkit/*.md`,
|
|
97
|
+
* `.bkit/.env.example`). A marker that differs from the installing
|
|
98
|
+
* bkit version means the consumer bumped the package without re-rendering, or hand-edited
|
|
99
|
+
* a managed region and dropped the marker.
|
|
100
|
+
*
|
|
101
|
+
* Runs in Phase 3:
|
|
102
|
+
* - `bkit check` (dry-run) writes nothing, so on-disk markers keep their stale value →
|
|
103
|
+
* this fires → check exits 1 on main/dev.
|
|
104
|
+
* - real `install` / `upgrade` re-stamp in Phase 2, before this runs → no finding.
|
|
105
|
+
* - `bkit doctor` replays Phase 3 read-only → surfaces it without exiting.
|
|
106
|
+
*
|
|
107
|
+
* A block-scoped file without a bkit block is the consumer's (they dropped the block, or
|
|
108
|
+
* never had bkit's) and is skipped; a whole file without a marker is stale. Files absent
|
|
109
|
+
* on disk are skipped. A dev tree without a readable package version (`0.0.0` / empty)
|
|
110
|
+
* yields null, as does a repo with nothing stamped.
|
|
111
|
+
*
|
|
112
|
+
* Severity is branch-scoped (see PROTECTED_BRANCHES): a `blocker` on main/dev (or a PR
|
|
113
|
+
* into them), an `advisory` on feature branches. `installingVersion` and
|
|
114
|
+
* `onProtectedBranch` are injected for testability.
|
|
115
|
+
*/
|
|
116
|
+
export function detectManagedStale(cwd, installingVersion = readPkgVersion(), onProtectedBranch = isOnProtectedBranch(cwd)) {
|
|
117
|
+
if (!installingVersion || installingVersion === "0.0.0")
|
|
118
|
+
return null;
|
|
119
|
+
const stale = [];
|
|
120
|
+
let scanned = 0;
|
|
121
|
+
for (const { path: rel, scope } of listStampedFiles(cwd)) {
|
|
122
|
+
const abs = path.join(cwd, rel);
|
|
123
|
+
if (!fs.existsSync(abs))
|
|
124
|
+
continue;
|
|
125
|
+
const content = fs.readFileSync(abs, "utf-8");
|
|
126
|
+
const found = scope === "block" ? readManagedBlockVersion(content) : readManagedVersion(content);
|
|
127
|
+
if (found === undefined)
|
|
128
|
+
continue;
|
|
129
|
+
scanned++;
|
|
130
|
+
if (found !== installingVersion)
|
|
131
|
+
stale.push(`${rel}${found ? ` (v${found})` : " (no marker)"}`);
|
|
132
|
+
}
|
|
133
|
+
if (scanned === 0 || stale.length === 0)
|
|
134
|
+
return null;
|
|
135
|
+
const examples = stale.slice(0, 5).join(", ");
|
|
136
|
+
const more = stale.length > 5 ? ` (+${stale.length - 5} more)` : "";
|
|
137
|
+
const branchNote = onProtectedBranch
|
|
138
|
+
? ""
|
|
139
|
+
: " (non-blocking on this feature branch — it WILL hard-fail `bkit check` on main/dev, so re-render before merging.)";
|
|
140
|
+
return {
|
|
141
|
+
id: "bkit-managed-stale",
|
|
142
|
+
severity: onProtectedBranch ? "blocker" : "advisory",
|
|
143
|
+
detect: `${stale.length} of ${scanned} bkit-managed file(s) carry a bkit version marker that differs from the installed bkit version (${installingVersion}): ${examples}${more}.${branchNote}`,
|
|
144
|
+
action: "Re-render every bkit-managed file at the installed version, then commit the result: run `pnpm bkit upgrade` (resyncs every host, doc and hook) or re-run `pnpm bkit install` with your host flags. To MOVE to a newer bkit, use `pnpm bkit upgrade --latest` (or `--to=<version>`) — it bumps @cbartens/bkit AND re-renders in one step; `pnpm add @cbartens/bkit` alone does NOT re-render. Never hand-edit a rendered agent/command or the content between `bkit:start` and `bkit:end`: put your own content outside the block, where install and upgrade never write.",
|
|
145
|
+
};
|
|
146
|
+
}
|
|
147
|
+
/** Host modules whose manifest hook files a host config runs, and the flag that installs each. */
|
|
148
|
+
const HOOK_HOST_FLAGS = [
|
|
149
|
+
["claude", "--claude"],
|
|
150
|
+
["cursor", "--cursor"],
|
|
151
|
+
["codex", "--codex"],
|
|
152
|
+
["opencode", "--opencode=<provider>"],
|
|
153
|
+
];
|
|
154
|
+
/** Manifest paths a host runs as a hook: `.<host>/hooks/<file>` and `.opencode/plugin/<file>`. */
|
|
155
|
+
const HOOK_FILE_RE = /\/(hooks|plugin)\/[^/]+$/;
|
|
156
|
+
/**
|
|
157
|
+
* Owned hook files that are missing for what this repo has installed: the hook files in the
|
|
158
|
+
* manifest of each installed host module. The claude and codex hook commands skip a missing
|
|
159
|
+
* file (`test -f <file> && … || true`); `bkit check` fails on it.
|
|
160
|
+
*/
|
|
161
|
+
export function findMissingOwnedHooks(cwd, modules) {
|
|
162
|
+
const required = [];
|
|
163
|
+
for (const [host, restoreFlag] of HOOK_HOST_FLAGS) {
|
|
164
|
+
if (!modules.has(host))
|
|
165
|
+
continue;
|
|
166
|
+
for (const entry of getModuleManifest(host)) {
|
|
167
|
+
if (HOOK_FILE_RE.test(entry.path))
|
|
168
|
+
required.push({ path: entry.path, restoreFlag });
|
|
169
|
+
}
|
|
170
|
+
}
|
|
171
|
+
return required.filter((hook) => !fs.existsSync(path.join(cwd, hook.path)));
|
|
172
|
+
}
|
|
173
|
+
/** One-line description of a missing hook file, shared by the checklist and the check exit. */
|
|
174
|
+
export function describeMissingOwnedHook(hook) {
|
|
175
|
+
return `${hook.path} is missing, so the hook that runs it is off — restore it with \`pnpm bkit install ${hook.restoreFlag}\`.`;
|
|
176
|
+
}
|
|
177
|
+
/** The checklist blocker for `findMissingOwnedHooks` output, or null when nothing is missing. */
|
|
178
|
+
export function detectOwnedHookMissing(missing) {
|
|
179
|
+
if (missing.length === 0)
|
|
180
|
+
return null;
|
|
181
|
+
return {
|
|
182
|
+
id: "owned-hook-missing",
|
|
183
|
+
severity: "blocker",
|
|
184
|
+
detect: `${missing.length} bkit-owned hook file(s) missing: ${missing.map((h) => h.path).join(", ")}. The host still has each hook wired, but the file it runs is gone, so the guard or setup step it holds does not run.`,
|
|
185
|
+
action: missing.map(describeMissingOwnedHook).join("\n"),
|
|
186
|
+
};
|
|
187
|
+
}
|