@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,556 @@
|
|
|
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
|
+
|
|
5
|
+
import * as fs from "node:fs";
|
|
6
|
+
import * as path from "node:path";
|
|
7
|
+
import { type PreflightFinding, dedupeById } from "../before/index.js";
|
|
8
|
+
import {
|
|
9
|
+
detectMissingDotenv,
|
|
10
|
+
detectBlankDotenvKeys,
|
|
11
|
+
detectDirenvMissing,
|
|
12
|
+
detectDirenvNotAllowed,
|
|
13
|
+
} from "../before/env.js";
|
|
14
|
+
import { getPkgRoot } from "../../shared/package-roots.js";
|
|
15
|
+
import { detectOpencodeYmlProviderDrift } from "../../install/modules/opencode.js";
|
|
16
|
+
import { TEMPLATES_POINTER } from "../../install/template-copies.js";
|
|
17
|
+
import { detectManagedStale } from "./managed.js";
|
|
18
|
+
import {
|
|
19
|
+
AGENT_INLINE_SOURCE_GUIDANCE,
|
|
20
|
+
BKIT_GH_TOKEN_INSTALL_MISSING_ACTION,
|
|
21
|
+
BKIT_GH_TOKEN_INSTALL_UNKNOWN_ACTION,
|
|
22
|
+
buildCloudDashboardsAdvisory,
|
|
23
|
+
detectCiRouterSecrets,
|
|
24
|
+
detectGhSecret,
|
|
25
|
+
detectNpmrcAuth,
|
|
26
|
+
detectNpmrcAuthTokenLine,
|
|
27
|
+
detectShellGhMcpToken,
|
|
28
|
+
detectShellToken,
|
|
29
|
+
hasGithubMcpServer,
|
|
30
|
+
} from "./auth.js";
|
|
31
|
+
import {
|
|
32
|
+
VERCEL_MISSING_ACTION,
|
|
33
|
+
detectVercelEnv,
|
|
34
|
+
detectVercelInstallCommandMissingAuth,
|
|
35
|
+
detectVercelProject,
|
|
36
|
+
} from "./vercel.js";
|
|
37
|
+
import {
|
|
38
|
+
buildCloudSetupAdvisory,
|
|
39
|
+
buildGithubProjectAdvisory,
|
|
40
|
+
buildTrackerSetupAdvisory,
|
|
41
|
+
detectActionsWritePermissions,
|
|
42
|
+
detectGithubProjectFieldIdFormat,
|
|
43
|
+
detectMainBranchProtection,
|
|
44
|
+
readConsumerIssueTracker,
|
|
45
|
+
} from "./github.js";
|
|
46
|
+
import {
|
|
47
|
+
buildDepUpdaterSetupAdvisory,
|
|
48
|
+
detectBkitStubs,
|
|
49
|
+
detectValePackageNotSynced,
|
|
50
|
+
detectWorkflowLintToolsMissing,
|
|
51
|
+
} from "./tools.js";
|
|
52
|
+
import {
|
|
53
|
+
detectBkitCloudYmlAlwaysTrueGate,
|
|
54
|
+
detectCiYmlCapstoneContractDrift,
|
|
55
|
+
detectCiYmlMissingActionlint,
|
|
56
|
+
detectCiYmlMissingTokenEnv,
|
|
57
|
+
detectCiYmlRunInjection,
|
|
58
|
+
detectGhaFloatingTags,
|
|
59
|
+
detectRunLevelsNotComposed,
|
|
60
|
+
detectTaggedTestsWithoutCiHome,
|
|
61
|
+
detectTestIntegrationEnv,
|
|
62
|
+
detectTurboIntegrationInputs,
|
|
63
|
+
} from "./ci-yml.js";
|
|
64
|
+
|
|
65
|
+
// ---------------------------------------------------------------------------
|
|
66
|
+
// formatChecklist — pure renderer
|
|
67
|
+
// ---------------------------------------------------------------------------
|
|
68
|
+
|
|
69
|
+
/**
|
|
70
|
+
* Format a list of findings into the post-install checklist banner.
|
|
71
|
+
* Returns `""` when findings is empty — callers can `if (banner)` to stay silent.
|
|
72
|
+
* No console.log inside — caller logs.
|
|
73
|
+
*
|
|
74
|
+
* Format per finding:
|
|
75
|
+
* --- i/N [severity] id ---
|
|
76
|
+
* DETECT: ...
|
|
77
|
+
* ACTION: ...
|
|
78
|
+
*/
|
|
79
|
+
export function formatChecklist(findings: PreflightFinding[]): string {
|
|
80
|
+
if (findings.length === 0) return "";
|
|
81
|
+
|
|
82
|
+
const banner = "=".repeat(58);
|
|
83
|
+
const total = findings.length;
|
|
84
|
+
const lines: string[] = [];
|
|
85
|
+
|
|
86
|
+
lines.push(`\n${banner}`);
|
|
87
|
+
lines.push(`[bkit] Post-install checklist (${total} item${total === 1 ? "" : "s"})`);
|
|
88
|
+
lines.push(banner);
|
|
89
|
+
lines.push(
|
|
90
|
+
"\nINSTRUCTIONS FOR AN AI AGENT — copy this entire block into a\n" +
|
|
91
|
+
"coding assistant to apply each item. Each ACTION is self-contained.\n" +
|
|
92
|
+
`\n${TEMPLATES_POINTER}\n`,
|
|
93
|
+
);
|
|
94
|
+
|
|
95
|
+
for (let i = 0; i < findings.length; i++) {
|
|
96
|
+
const f = findings[i]!;
|
|
97
|
+
lines.push(`\n--- ${i + 1}/${total} [${f.severity}] ${f.id} ---`);
|
|
98
|
+
lines.push(`DETECT: ${f.detect}`);
|
|
99
|
+
lines.push(`ACTION: ${f.action}`);
|
|
100
|
+
}
|
|
101
|
+
|
|
102
|
+
lines.push(`\n${banner}\n`);
|
|
103
|
+
|
|
104
|
+
return lines.join("\n");
|
|
105
|
+
}
|
|
106
|
+
|
|
107
|
+
// ---------------------------------------------------------------------------
|
|
108
|
+
// Advisories artifact — `.bkit/advisories.md`
|
|
109
|
+
// ---------------------------------------------------------------------------
|
|
110
|
+
|
|
111
|
+
export type AdvisoriesMode = "install" | "check" | "doctor";
|
|
112
|
+
|
|
113
|
+
/**
|
|
114
|
+
* Render findings as a markdown artifact suitable for `.bkit/advisories.md`.
|
|
115
|
+
* Mirrors `formatChecklist` content but in markdown form so the file can be
|
|
116
|
+
* referenced and revisited between installs. Overwritten on every run.
|
|
117
|
+
*/
|
|
118
|
+
export function renderAdvisoriesMarkdown(
|
|
119
|
+
findings: PreflightFinding[],
|
|
120
|
+
opts: { mode: AdvisoriesMode; version: string },
|
|
121
|
+
): string {
|
|
122
|
+
const lines: string[] = [];
|
|
123
|
+
// This is a generated, gitignored artifact — not authored prose. Advisory
|
|
124
|
+
// strings (and reproduced config snippets like `.vale.ini`'s `write-good.So =
|
|
125
|
+
// NO`) legitimately contain sentence-initial "So" and slop tokens. The shipped
|
|
126
|
+
// `lint:prose` globs on-disk `.agents/*.md`, so without this whole-file Vale
|
|
127
|
+
// skip the husky hooks fail on a file the consumer cannot edit.
|
|
128
|
+
lines.push("<!-- vale off -->");
|
|
129
|
+
lines.push("");
|
|
130
|
+
lines.push("# bkit advisories");
|
|
131
|
+
lines.push("");
|
|
132
|
+
lines.push(`_bkit: ${opts.version}_ `);
|
|
133
|
+
lines.push(`_Mode: ${opts.mode}_`);
|
|
134
|
+
lines.push("");
|
|
135
|
+
lines.push(
|
|
136
|
+
"> Auto-generated by `bkit install` / `bkit check` / `bkit doctor`. Overwritten on each run.",
|
|
137
|
+
);
|
|
138
|
+
lines.push("");
|
|
139
|
+
|
|
140
|
+
if (findings.length === 0) {
|
|
141
|
+
lines.push("**No advisories.** Last run was clean.");
|
|
142
|
+
lines.push("");
|
|
143
|
+
return lines.join("\n");
|
|
144
|
+
}
|
|
145
|
+
|
|
146
|
+
const blockerCount = findings.filter((f) => f.severity === "blocker").length;
|
|
147
|
+
const advisoryCount = findings.filter((f) => f.severity === "advisory").length;
|
|
148
|
+
lines.push(`${findings.length} finding(s) — ${blockerCount} blocker, ${advisoryCount} advisory.`);
|
|
149
|
+
lines.push("");
|
|
150
|
+
lines.push(
|
|
151
|
+
"> INSTRUCTIONS FOR AN AI AGENT — copy this file (or specific items) into a coding assistant to apply each item. Each ACTION is self-contained.",
|
|
152
|
+
);
|
|
153
|
+
lines.push("");
|
|
154
|
+
lines.push(`> ${TEMPLATES_POINTER}`);
|
|
155
|
+
lines.push("");
|
|
156
|
+
|
|
157
|
+
const total = findings.length;
|
|
158
|
+
for (let i = 0; i < total; i++) {
|
|
159
|
+
const f = findings[i]!;
|
|
160
|
+
lines.push(`## ${i + 1}/${total} [${f.severity}] ${f.id}`);
|
|
161
|
+
lines.push("");
|
|
162
|
+
lines.push(`**Detect:** ${f.detect}`);
|
|
163
|
+
lines.push("");
|
|
164
|
+
lines.push(`**Action:** ${f.action}`);
|
|
165
|
+
lines.push("");
|
|
166
|
+
}
|
|
167
|
+
|
|
168
|
+
return lines.join("\n");
|
|
169
|
+
}
|
|
170
|
+
|
|
171
|
+
/**
|
|
172
|
+
* Write `.bkit/advisories.md` in the consumer's cwd. Best-effort:
|
|
173
|
+
* mkdir -p `.agents/`, write the rendered markdown, log a one-line status.
|
|
174
|
+
* Any I/O failure is logged but does not throw — the artifact is informational.
|
|
175
|
+
*/
|
|
176
|
+
export function writeAdvisoriesArtifact(
|
|
177
|
+
findings: PreflightFinding[],
|
|
178
|
+
opts: {
|
|
179
|
+
cwd: string;
|
|
180
|
+
mode: AdvisoriesMode;
|
|
181
|
+
version: string;
|
|
182
|
+
logPrefix: string;
|
|
183
|
+
},
|
|
184
|
+
): void {
|
|
185
|
+
const dir = path.join(opts.cwd, ".bkit");
|
|
186
|
+
const filePath = path.join(dir, "advisories.md");
|
|
187
|
+
try {
|
|
188
|
+
fs.mkdirSync(dir, { recursive: true });
|
|
189
|
+
const content = renderAdvisoriesMarkdown(findings, {
|
|
190
|
+
mode: opts.mode,
|
|
191
|
+
version: opts.version,
|
|
192
|
+
});
|
|
193
|
+
fs.writeFileSync(filePath, content);
|
|
194
|
+
const n = findings.length;
|
|
195
|
+
console.log(`${opts.logPrefix} Wrote .bkit/advisories.md (${n} item${n === 1 ? "" : "s"}).`);
|
|
196
|
+
} catch (err) {
|
|
197
|
+
console.error(
|
|
198
|
+
`${opts.logPrefix} Failed to write .bkit/advisories.md: ${(err as Error).message}`,
|
|
199
|
+
);
|
|
200
|
+
}
|
|
201
|
+
}
|
|
202
|
+
|
|
203
|
+
// ---------------------------------------------------------------------------
|
|
204
|
+
// Changelog version-delta header (A7)
|
|
205
|
+
// ---------------------------------------------------------------------------
|
|
206
|
+
|
|
207
|
+
/**
|
|
208
|
+
* Read the bkit CHANGELOG.md (from the package root) and extract the section
|
|
209
|
+
* header for `version`. Returns a formatted version-delta string for display
|
|
210
|
+
* in post-install output, or null if CHANGELOG.md is absent or version not found.
|
|
211
|
+
*
|
|
212
|
+
* Version header format in CHANGELOG.md: `## [X.Y.Z] — YYYY-MM-DD`
|
|
213
|
+
*/
|
|
214
|
+
export function readChangelogVersionDelta(version: string): string | null {
|
|
215
|
+
try {
|
|
216
|
+
const changelogPath = path.join(getPkgRoot(), "CHANGELOG.md");
|
|
217
|
+
if (!fs.existsSync(changelogPath)) return null;
|
|
218
|
+
const content = fs.readFileSync(changelogPath, "utf-8");
|
|
219
|
+
// Find the header for this version
|
|
220
|
+
const versionEscaped = version.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
|
|
221
|
+
const headerRe = new RegExp(`^## \\[${versionEscaped}\\][^\n]*`, "m");
|
|
222
|
+
const match = content.match(headerRe);
|
|
223
|
+
if (!match) return null;
|
|
224
|
+
return `[bkit] What's new in v${version}: ${match[0].replace(/^## /, "")}`;
|
|
225
|
+
} catch {
|
|
226
|
+
return null;
|
|
227
|
+
}
|
|
228
|
+
}
|
|
229
|
+
|
|
230
|
+
// ---------------------------------------------------------------------------
|
|
231
|
+
// runPostInstallCheck — main Phase 3 entry point
|
|
232
|
+
// ---------------------------------------------------------------------------
|
|
233
|
+
|
|
234
|
+
/**
|
|
235
|
+
* Re-run token-surface + bkit-ci.yml + vale-sync detectors after writes.
|
|
236
|
+
*
|
|
237
|
+
* - Intra-phase dedup: Phase 3 findings are deduped by id (first occurrence wins).
|
|
238
|
+
* - Cross-phase dedup: Phase 3 wins on id conflict (re-detection is more accurate).
|
|
239
|
+
*
|
|
240
|
+
* Runs unconditionally for both `bkit install` and `bkit check` — detectors are
|
|
241
|
+
* read-only (env probes, gh/vale CLI version checks, file reads) and produce the
|
|
242
|
+
* same advisory set against the same filesystem state regardless of caller.
|
|
243
|
+
*
|
|
244
|
+
* cwd defaults to process.cwd().
|
|
245
|
+
*/
|
|
246
|
+
export function runPostInstallCheck(
|
|
247
|
+
preflightAdvisories: PreflightFinding[],
|
|
248
|
+
cwd: string = process.cwd(),
|
|
249
|
+
): PreflightFinding[] {
|
|
250
|
+
const phase3: PreflightFinding[] = [];
|
|
251
|
+
|
|
252
|
+
// Managed-version marker gate — in `bkit check`, a blocker on main/dev (or a PR into
|
|
253
|
+
// them) and a non-blocking advisory on feature branches when any stamped file's marker
|
|
254
|
+
// drifts from the installed version. No-op in real install/upgrade (re-stamped Phase 2).
|
|
255
|
+
const managedStale = detectManagedStale(cwd);
|
|
256
|
+
if (managedStale) phase3.push(managedStale);
|
|
257
|
+
|
|
258
|
+
// Shell token
|
|
259
|
+
const shellStatus = detectShellToken();
|
|
260
|
+
if (shellStatus === "missing") {
|
|
261
|
+
phase3.push({
|
|
262
|
+
id: "gh-bkit-token-unset-shell",
|
|
263
|
+
severity: "advisory",
|
|
264
|
+
detect: "BKIT_GH_TOKEN_INSTALL is not set in the shell environment (undefined).",
|
|
265
|
+
action:
|
|
266
|
+
"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" +
|
|
267
|
+
AGENT_INLINE_SOURCE_GUIDANCE,
|
|
268
|
+
});
|
|
269
|
+
} else if (shellStatus === "empty") {
|
|
270
|
+
phase3.push({
|
|
271
|
+
id: "gh-bkit-token-empty-shell",
|
|
272
|
+
severity: "advisory",
|
|
273
|
+
detect:
|
|
274
|
+
'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.',
|
|
275
|
+
action:
|
|
276
|
+
'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' +
|
|
277
|
+
AGENT_INLINE_SOURCE_GUIDANCE,
|
|
278
|
+
});
|
|
279
|
+
}
|
|
280
|
+
|
|
281
|
+
// BKIT_GH_TOKEN shell env — authenticates the GitHub MCP server
|
|
282
|
+
// (`Authorization: Bearer ${BKIT_GH_TOKEN}` in .mcp.json), which powers the entire
|
|
283
|
+
// tracker + PR + Projects MCP surface. Only flags when a github MCP server is
|
|
284
|
+
// configured, and never in CI.
|
|
285
|
+
if (hasGithubMcpServer(cwd) && !process.env.CI) {
|
|
286
|
+
const ghMcpTokenStatus = detectShellGhMcpToken();
|
|
287
|
+
if (ghMcpTokenStatus === "missing") {
|
|
288
|
+
phase3.push({
|
|
289
|
+
id: "gh-mcp-token-unset-shell",
|
|
290
|
+
severity: "advisory",
|
|
291
|
+
detect:
|
|
292
|
+
"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.",
|
|
293
|
+
action:
|
|
294
|
+
"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.",
|
|
295
|
+
});
|
|
296
|
+
} else if (ghMcpTokenStatus === "empty") {
|
|
297
|
+
phase3.push({
|
|
298
|
+
id: "gh-mcp-token-empty-shell",
|
|
299
|
+
severity: "advisory",
|
|
300
|
+
detect:
|
|
301
|
+
'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.',
|
|
302
|
+
action:
|
|
303
|
+
"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.",
|
|
304
|
+
});
|
|
305
|
+
}
|
|
306
|
+
}
|
|
307
|
+
|
|
308
|
+
// .npmrc auth
|
|
309
|
+
const npmrcStatus = detectNpmrcAuth(cwd);
|
|
310
|
+
if (npmrcStatus === "missing") {
|
|
311
|
+
phase3.push({
|
|
312
|
+
id: "npmrc-missing-gh-packages",
|
|
313
|
+
severity: "advisory",
|
|
314
|
+
detect: ".npmrc exists but is missing the required @cbartens registry mapping.",
|
|
315
|
+
action:
|
|
316
|
+
"Add this line to .npmrc at the repo root (the auth token is NOT stored here):\n\n" +
|
|
317
|
+
" @cbartens:registry=https://npm.pkg.github.com\n\n" +
|
|
318
|
+
"The token lives in pnpm's user-level config — write it once with:\n\n" +
|
|
319
|
+
' pnpm config set "//npm.pkg.github.com/:_authToken=$BKIT_GH_TOKEN_INSTALL"\n\n' +
|
|
320
|
+
"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.",
|
|
321
|
+
});
|
|
322
|
+
}
|
|
323
|
+
// "unknown" (absent) → silent skip per spec
|
|
324
|
+
|
|
325
|
+
// .npmrc auth-token line. The committed project .npmrc must NOT carry
|
|
326
|
+
// `//npm.pkg.github.com/:_authToken=…`: pnpm >=10.34.3 401s on it AND it shadows the
|
|
327
|
+
// user-level token written by `pnpm config set` (project config wins).
|
|
328
|
+
if (detectNpmrcAuthTokenLine(cwd)) {
|
|
329
|
+
phase3.push({
|
|
330
|
+
id: "npmrc-authtoken-line",
|
|
331
|
+
severity: "advisory",
|
|
332
|
+
detect:
|
|
333
|
+
".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`.",
|
|
334
|
+
action:
|
|
335
|
+
"Remove the `//npm.pkg.github.com/:_authToken=…` line from .npmrc — keep ONLY the registry mapping:\n\n" +
|
|
336
|
+
" @cbartens:registry=https://npm.pkg.github.com\n\n" +
|
|
337
|
+
"Then write the token into pnpm's user-level config instead (CI does this in its install step):\n\n" +
|
|
338
|
+
' pnpm config set "//npm.pkg.github.com/:_authToken=$BKIT_GH_TOKEN_INSTALL"\n\n' +
|
|
339
|
+
"`pnpm config set` stores the shell-expanded literal token in pnpm's user-level config — version-proof across pnpm 10.x and 11.x.",
|
|
340
|
+
});
|
|
341
|
+
}
|
|
342
|
+
|
|
343
|
+
// GH secret
|
|
344
|
+
const ghSecretStatus = detectGhSecret();
|
|
345
|
+
if (ghSecretStatus === "missing") {
|
|
346
|
+
phase3.push({
|
|
347
|
+
id: "gh-bkit-token-secret-missing",
|
|
348
|
+
severity: "advisory",
|
|
349
|
+
detect:
|
|
350
|
+
"gh secret list confirms BKIT_GH_TOKEN_INSTALL secret is NOT set on this GitHub repo.",
|
|
351
|
+
action: BKIT_GH_TOKEN_INSTALL_MISSING_ACTION,
|
|
352
|
+
});
|
|
353
|
+
} else if (ghSecretStatus === "unknown") {
|
|
354
|
+
phase3.push({
|
|
355
|
+
id: "gh-bkit-token-secret-unknown",
|
|
356
|
+
severity: "advisory",
|
|
357
|
+
detect:
|
|
358
|
+
"Could not verify BKIT_GH_TOKEN_INSTALL secret (gh CLI unavailable, unauthenticated, or not a GitHub repo).",
|
|
359
|
+
action: BKIT_GH_TOKEN_INSTALL_UNKNOWN_ACTION,
|
|
360
|
+
});
|
|
361
|
+
}
|
|
362
|
+
|
|
363
|
+
// Vercel env (only if a Vercel project is detected)
|
|
364
|
+
if (detectVercelProject(cwd)) {
|
|
365
|
+
const previewStatus = detectVercelEnv("preview", cwd);
|
|
366
|
+
if (previewStatus === "missing") {
|
|
367
|
+
phase3.push({
|
|
368
|
+
id: "vercel-env-missing-preview",
|
|
369
|
+
severity: "advisory",
|
|
370
|
+
detect:
|
|
371
|
+
"vercel.json detected but BKIT_GH_TOKEN_INSTALL is absent from Vercel preview environment.",
|
|
372
|
+
action: VERCEL_MISSING_ACTION,
|
|
373
|
+
});
|
|
374
|
+
}
|
|
375
|
+
const productionStatus = detectVercelEnv("production", cwd);
|
|
376
|
+
if (productionStatus === "missing") {
|
|
377
|
+
phase3.push({
|
|
378
|
+
id: "vercel-env-missing-production",
|
|
379
|
+
severity: "advisory",
|
|
380
|
+
detect:
|
|
381
|
+
"vercel.json detected but BKIT_GH_TOKEN_INSTALL is absent from Vercel production environment.",
|
|
382
|
+
action: VERCEL_MISSING_ACTION,
|
|
383
|
+
});
|
|
384
|
+
}
|
|
385
|
+
// "unknown" → silent skip (CLI absent / unauthed)
|
|
386
|
+
|
|
387
|
+
// Vercel installCommand auth. The env var alone is not enough: a registry-only .npmrc
|
|
388
|
+
// carries no token on pnpm
|
|
389
|
+
// >=10.34.3 and Vercel cannot run a pre-install shell step, so each vercel.json must
|
|
390
|
+
// authenticate via its installCommand or the @cbartens/bkit download 401s.
|
|
391
|
+
const vercelNoAuth = detectVercelInstallCommandMissingAuth(cwd);
|
|
392
|
+
if (vercelNoAuth.length > 0) {
|
|
393
|
+
phase3.push({
|
|
394
|
+
id: "vercel-installcommand-missing-auth",
|
|
395
|
+
severity: "advisory",
|
|
396
|
+
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.`,
|
|
397
|
+
action: VERCEL_MISSING_ACTION,
|
|
398
|
+
});
|
|
399
|
+
}
|
|
400
|
+
}
|
|
401
|
+
|
|
402
|
+
// Main branch protection — bkit's PR-base gates (build Step 17, ship Step 2)
|
|
403
|
+
// assert feat/* PRs target dev. Enforcing it at the GitHub layer needs branch
|
|
404
|
+
// protection on main restricting merges to PRs from dev.
|
|
405
|
+
const protectionStatus = detectMainBranchProtection();
|
|
406
|
+
const scriptHint =
|
|
407
|
+
"\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.";
|
|
408
|
+
if (protectionStatus === "missing") {
|
|
409
|
+
phase3.push({
|
|
410
|
+
id: "main-branch-protection-missing",
|
|
411
|
+
severity: "advisory",
|
|
412
|
+
detect: "main has no branch protection rule.",
|
|
413
|
+
action:
|
|
414
|
+
"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" +
|
|
415
|
+
" Settings → Branches → Add rule → Branch name pattern: main\n" +
|
|
416
|
+
" - Require a pull request before merging\n" +
|
|
417
|
+
" - 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" +
|
|
418
|
+
" - Do not allow bypassing the above settings (enforce for admins)\n" +
|
|
419
|
+
" - Require linear history; block force-pushes and deletions\n\n" +
|
|
420
|
+
"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." +
|
|
421
|
+
scriptHint,
|
|
422
|
+
});
|
|
423
|
+
}
|
|
424
|
+
|
|
425
|
+
// Optional post-install decisions (opt-in add-ons):
|
|
426
|
+
// 1. Issue tracker — branch on bkit.issueTracker.
|
|
427
|
+
// 2. Dependency updater — read-only. Suggests an example template. Never writes config.
|
|
428
|
+
// 3. Cloud agents — branch on bkit-cloud.yml presence.
|
|
429
|
+
const trackerSetup = buildTrackerSetupAdvisory(cwd);
|
|
430
|
+
if (trackerSetup) phase3.push(trackerSetup);
|
|
431
|
+
// GitHub Projects v2 board-sync prerequisites (config + toolset + PAT scope) —
|
|
432
|
+
// absent any prerequisite, sync silently no-ops.
|
|
433
|
+
const githubProjectSetup = buildGithubProjectAdvisory(cwd);
|
|
434
|
+
if (githubProjectSetup) phase3.push(githubProjectSetup);
|
|
435
|
+
// A configured board can still silently no-op if statusFieldId holds the GraphQL
|
|
436
|
+
// node id instead of the numeric field id projects_write requires.
|
|
437
|
+
const githubProjectFieldId = detectGithubProjectFieldIdFormat(cwd);
|
|
438
|
+
if (githubProjectFieldId) phase3.push(githubProjectFieldId);
|
|
439
|
+
const depUpdaterSetup = buildDepUpdaterSetupAdvisory(cwd);
|
|
440
|
+
if (depUpdaterSetup) phase3.push(depUpdaterSetup);
|
|
441
|
+
const cloudSetup = buildCloudSetupAdvisory(cwd);
|
|
442
|
+
if (cloudSetup) phase3.push(cloudSetup);
|
|
443
|
+
|
|
444
|
+
// bkit-cloud.yml needs the ANTHROPIC_API_KEY repo secret.
|
|
445
|
+
for (const f of detectCiRouterSecrets(cwd)) phase3.push(f);
|
|
446
|
+
|
|
447
|
+
// bkit-cloud.yml also needs repo Actions write permissions + PR-creation
|
|
448
|
+
// allowance, else `actions/checkout` and `gh pr create` 403. Detectable at the
|
|
449
|
+
// repo level via the Actions API; org-level policy can still override.
|
|
450
|
+
if (fs.existsSync(path.join(cwd, ".github", "workflows", "bkit-cloud.yml"))) {
|
|
451
|
+
if (detectActionsWritePermissions() === "missing") {
|
|
452
|
+
phase3.push({
|
|
453
|
+
id: "actions-write-permissions-missing",
|
|
454
|
+
severity: "advisory",
|
|
455
|
+
detect:
|
|
456
|
+
"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.",
|
|
457
|
+
action:
|
|
458
|
+
"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).",
|
|
459
|
+
});
|
|
460
|
+
}
|
|
461
|
+
// "unknown" -> silent skip (gh CLI unavailable / unauthenticated).
|
|
462
|
+
}
|
|
463
|
+
|
|
464
|
+
// Cloud / IDE-online dashboards — Cursor Background Agents + Claude Code on the web
|
|
465
|
+
// read env vars from their respective online dashboards, NOT from repo files.
|
|
466
|
+
// The same three secrets that GitHub Actions needs must be mirrored there.
|
|
467
|
+
const cloudDashboardsAdvisory = buildCloudDashboardsAdvisory(cwd);
|
|
468
|
+
if (cloudDashboardsAdvisory) phase3.push(cloudDashboardsAdvisory);
|
|
469
|
+
|
|
470
|
+
// bkit-ci.yml missing token env
|
|
471
|
+
const ciYml = detectCiYmlMissingTokenEnv(cwd);
|
|
472
|
+
if (ciYml) phase3.push(ciYml);
|
|
473
|
+
|
|
474
|
+
// GHA action SHA pinning (KN-3). Updater configs are consumer-owned examples.
|
|
475
|
+
const gha = detectGhaFloatingTags(cwd);
|
|
476
|
+
if (gha) phase3.push(gha);
|
|
477
|
+
|
|
478
|
+
// bkit-cloud.yml always-true auto-route gate (block scalar wrapping ${{ }}).
|
|
479
|
+
const cloudGate = detectBkitCloudYmlAlwaysTrueGate(cwd);
|
|
480
|
+
if (cloudGate) phase3.push(cloudGate);
|
|
481
|
+
|
|
482
|
+
// Self-installed opencode.yml (/oc handler) drifted from the installed opencode provider —
|
|
483
|
+
// it hardcodes a model + secret that `bkit install --opencode=` does not rewrite. Not for
|
|
484
|
+
// claude.yml (its @claude handler is provider-fixed). bkit-cloud.yml self-syncs, so exempt.
|
|
485
|
+
const opencodeYmlDrift = detectOpencodeYmlProviderDrift(cwd);
|
|
486
|
+
if (opencodeYmlDrift) phase3.push(opencodeYmlDrift);
|
|
487
|
+
|
|
488
|
+
// bkit-ci.yml missing actionlint (GHA-aware lint; yaml.safe_load is not sufficient).
|
|
489
|
+
const ciActionlint = detectCiYmlMissingActionlint(cwd);
|
|
490
|
+
if (ciActionlint) phase3.push(ciActionlint);
|
|
491
|
+
|
|
492
|
+
// bkit-ci.yml untrusted input inlined into a run: body (GHA script-injection sink). Nothing
|
|
493
|
+
// back-fills the template's env-indirection fix onto a copy adopted before it.
|
|
494
|
+
const ciRunInjection = detectCiYmlRunInjection(cwd);
|
|
495
|
+
if (ciRunInjection) phase3.push(ciRunInjection);
|
|
496
|
+
|
|
497
|
+
// bkit-ci.yml capstone drifted from canonical contract (warning-only presence checks).
|
|
498
|
+
const capstoneDrift = detectCiYmlCapstoneContractDrift(cwd);
|
|
499
|
+
if (capstoneDrift) phase3.push(capstoneDrift);
|
|
500
|
+
|
|
501
|
+
// @live/@smoke-tagged tests whose owning package declares no test:live/test:smoke
|
|
502
|
+
// script — "no CI home".
|
|
503
|
+
const taggedNoHome = detectTaggedTestsWithoutCiHome(cwd);
|
|
504
|
+
if (taggedNoHome) phase3.push(taggedNoHome);
|
|
505
|
+
|
|
506
|
+
// bkit-stub sentinels in shipped templates — one advisory per still-commented stub.
|
|
507
|
+
for (const stub of detectBkitStubs(cwd)) phase3.push(stub);
|
|
508
|
+
|
|
509
|
+
// turbo.json inputs for cache-replay safety (KN-24).
|
|
510
|
+
for (const f of detectTurboIntegrationInputs(cwd)) phase3.push(f);
|
|
511
|
+
|
|
512
|
+
// test:integration runtime env (KN-23 false-confidence loop).
|
|
513
|
+
const integrationEnv = detectTestIntegrationEnv(cwd);
|
|
514
|
+
if (integrationEnv) phase3.push(integrationEnv);
|
|
515
|
+
|
|
516
|
+
// Consumer composed run-levels on bkit primitives (else docs/deployments.md matrix is doc-only).
|
|
517
|
+
const runLevels = detectRunLevelsNotComposed(cwd);
|
|
518
|
+
if (runLevels) phase3.push(runLevels);
|
|
519
|
+
|
|
520
|
+
// vale not synced
|
|
521
|
+
const vale = detectValePackageNotSynced(cwd);
|
|
522
|
+
if (vale) phase3.push(vale);
|
|
523
|
+
|
|
524
|
+
// actionlint + shellcheck for local pre-push workflow linting (CI has both)
|
|
525
|
+
const wfLintTools = detectWorkflowLintToolsMissing(cwd);
|
|
526
|
+
if (wfLintTools) phase3.push(wfLintTools);
|
|
527
|
+
|
|
528
|
+
// [mcp-env] direnv + .bkit/.env advisories.
|
|
529
|
+
// Wired here in Phase 3 — the .bkit/.env.example scaffold only exists after
|
|
530
|
+
// writes, so Phase 1 cannot see it on first install.
|
|
531
|
+
// Pass the consumer's tracker so the mcp-env prose omits BKIT_LINEAR_API_KEY on github/none
|
|
532
|
+
// repos.
|
|
533
|
+
const mcpEnvTracker = readConsumerIssueTracker(cwd);
|
|
534
|
+
const missingDotenv = detectMissingDotenv(cwd, mcpEnvTracker);
|
|
535
|
+
if (missingDotenv) phase3.push(missingDotenv);
|
|
536
|
+
phase3.push(...detectBlankDotenvKeys(cwd, mcpEnvTracker));
|
|
537
|
+
const direnvMissing = detectDirenvMissing(cwd, mcpEnvTracker);
|
|
538
|
+
if (direnvMissing) phase3.push(direnvMissing);
|
|
539
|
+
const direnvNotAllowed = detectDirenvNotAllowed(cwd, mcpEnvTracker);
|
|
540
|
+
if (direnvNotAllowed) phase3.push(direnvNotAllowed);
|
|
541
|
+
|
|
542
|
+
// Intra-phase dedup (first occurrence wins)
|
|
543
|
+
const deduped = dedupeById(phase3);
|
|
544
|
+
|
|
545
|
+
// Dedupe the incoming preflightAdvisories (ctx.advisories may contain module-emitted
|
|
546
|
+
// duplicates in addition to runPreflight's already-deduped output).
|
|
547
|
+
const dedupedPreflight = dedupeById(preflightAdvisories);
|
|
548
|
+
|
|
549
|
+
// Cross-phase dedup: Phase 3 wins on conflict (remove preflight entries whose id
|
|
550
|
+
// appears in Phase 3, then merge Phase 3 at the front for the winning position).
|
|
551
|
+
const phase3Ids = new Set(deduped.map((f) => f.id));
|
|
552
|
+
const filteredPreflight = dedupedPreflight.filter((f) => !phase3Ids.has(f.id));
|
|
553
|
+
|
|
554
|
+
// Final order: preflight advisories (that weren't superseded) first, then Phase 3
|
|
555
|
+
return [...filteredPreflight, ...deduped];
|
|
556
|
+
}
|