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