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