@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,217 @@
|
|
|
1
|
+
// checks/after/managed.ts — bkit-managed files: stale managed-version markers and missing
|
|
2
|
+
// owned hook files.
|
|
3
|
+
|
|
4
|
+
import * as fs from "node:fs";
|
|
5
|
+
import * as path from "node:path";
|
|
6
|
+
import { spawnSync } from "node:child_process";
|
|
7
|
+
import type { PreflightFinding } from "../before/index.js";
|
|
8
|
+
import type { ModuleFlag } from "../../cli.js";
|
|
9
|
+
import { getModuleManifest } from "../../install/manifest.js";
|
|
10
|
+
import { readManagedVersion } from "../../install/version-file.js";
|
|
11
|
+
import { getPkgRoot } from "../../shared/package-roots.js";
|
|
12
|
+
import {
|
|
13
|
+
detectMarkerStyle,
|
|
14
|
+
findLineAnchoredMarkers,
|
|
15
|
+
selectMarkers,
|
|
16
|
+
} from "../../install/managed-block.js";
|
|
17
|
+
import { listStampedFiles } from "../../install/modules/index.js";
|
|
18
|
+
|
|
19
|
+
// ---------------------------------------------------------------------------
|
|
20
|
+
// detectManagedStale — managed-version marker gate over every stamped file
|
|
21
|
+
// ---------------------------------------------------------------------------
|
|
22
|
+
|
|
23
|
+
/**
|
|
24
|
+
* Best-effort read of the installing bkit version from the package root.
|
|
25
|
+
* Mirrors getInstallingVersion (commands/install/install.ts) / readInstallingVersion
|
|
26
|
+
* (install/modules/index.ts); kept local to avoid a postinstall → install/modules import.
|
|
27
|
+
*/
|
|
28
|
+
function readPkgVersion(): string {
|
|
29
|
+
try {
|
|
30
|
+
const pkg = JSON.parse(fs.readFileSync(path.join(getPkgRoot(), "package.json"), "utf-8")) as {
|
|
31
|
+
version?: string;
|
|
32
|
+
};
|
|
33
|
+
return pkg.version ?? "0.0.0";
|
|
34
|
+
} catch {
|
|
35
|
+
return "0.0.0";
|
|
36
|
+
}
|
|
37
|
+
}
|
|
38
|
+
|
|
39
|
+
// ---------------------------------------------------------------------------
|
|
40
|
+
// Branch-scoped severity for the stale gates
|
|
41
|
+
//
|
|
42
|
+
// The gate is a hard BLOCKER on the integration + release branches (`main`/`dev`)
|
|
43
|
+
// and a non-blocking ADVISORY everywhere else (still shown in the checklist). A PR
|
|
44
|
+
// INTO main/dev re-asserts the blocker (via GITHUB_BASE_REF).
|
|
45
|
+
// ---------------------------------------------------------------------------
|
|
46
|
+
|
|
47
|
+
/** Branches where a stale managed-version marker is a hard blocker, not a warning. */
|
|
48
|
+
const PROTECTED_BRANCHES = new Set(["main", "dev"]);
|
|
49
|
+
|
|
50
|
+
/**
|
|
51
|
+
* Resolve the branch the check is effectively gating, preferring the CI signal:
|
|
52
|
+
* 1. `GITHUB_BASE_REF` — set on `pull_request` events to the MERGE TARGET. A PR
|
|
53
|
+
* into main/dev must hard-block, so the target wins over the source branch.
|
|
54
|
+
* 2. `GITHUB_REF_NAME` — set on `push` events to the pushed branch.
|
|
55
|
+
* 3. Local `git rev-parse --abbrev-ref HEAD` — the checked-out branch.
|
|
56
|
+
* Returns null when undeterminable (detached HEAD, no git, no CI env).
|
|
57
|
+
*/
|
|
58
|
+
function currentBranch(cwd: string): string | null {
|
|
59
|
+
const base = process.env.GITHUB_BASE_REF?.trim();
|
|
60
|
+
if (base) return base;
|
|
61
|
+
const refName = process.env.GITHUB_REF_NAME?.trim();
|
|
62
|
+
if (refName) return refName;
|
|
63
|
+
// spawnSync (not execFileSync) so a missing git / non-repo is a non-zero status,
|
|
64
|
+
// not a thrown error needing a swallowing catch — null then means "undeterminable".
|
|
65
|
+
const r = spawnSync("git", ["rev-parse", "--abbrev-ref", "HEAD"], {
|
|
66
|
+
cwd,
|
|
67
|
+
encoding: "utf-8",
|
|
68
|
+
stdio: ["ignore", "pipe", "ignore"],
|
|
69
|
+
});
|
|
70
|
+
const b = r.status === 0 && r.stdout ? r.stdout.trim() : "";
|
|
71
|
+
return b && b !== "HEAD" ? b : null;
|
|
72
|
+
}
|
|
73
|
+
|
|
74
|
+
/**
|
|
75
|
+
* True when the stale gates should hard-block here (on `main`/`dev`, or a PR
|
|
76
|
+
* targeting them). Fail-safe: an undeterminable branch is treated as protected.
|
|
77
|
+
* Exported for deterministic unit testing.
|
|
78
|
+
*/
|
|
79
|
+
export function isOnProtectedBranch(cwd: string = process.cwd()): boolean {
|
|
80
|
+
const b = currentBranch(cwd);
|
|
81
|
+
if (b === null) return true; // undeterminable → fail safe to blocker
|
|
82
|
+
return PROTECTED_BRANCHES.has(b);
|
|
83
|
+
}
|
|
84
|
+
|
|
85
|
+
/**
|
|
86
|
+
* Version of the managed-version marker inside a file's first `bkit:start`…`bkit:end`
|
|
87
|
+
* block, in whichever marker style the file uses (`<!-- -->`, `# <!-- -->`, `//`).
|
|
88
|
+
* Markers count only on their own line, so prose quoting them is skipped; only a
|
|
89
|
+
* full-line marker counts, so an inline example (`vX.Y.Z` in architecture.md) is never
|
|
90
|
+
* read as the stamp. `undefined` when the file has no block, null when the block has no
|
|
91
|
+
* marker.
|
|
92
|
+
*/
|
|
93
|
+
export function readManagedBlockVersion(content: string): string | null | undefined {
|
|
94
|
+
const style = detectMarkerStyle(content);
|
|
95
|
+
if (style === null) return undefined;
|
|
96
|
+
const [startMarker, endMarker] = selectMarkers(style);
|
|
97
|
+
const startIdx = findLineAnchoredMarkers(content, startMarker)[0]!;
|
|
98
|
+
const endIdx = findLineAnchoredMarkers(content, endMarker).find((i) => i > startIdx);
|
|
99
|
+
const region =
|
|
100
|
+
endIdx === undefined
|
|
101
|
+
? content.slice(startIdx)
|
|
102
|
+
: content.slice(startIdx, endIdx + endMarker.length);
|
|
103
|
+
return readManagedVersion(region);
|
|
104
|
+
}
|
|
105
|
+
|
|
106
|
+
/**
|
|
107
|
+
* Stale managed-version marker on any file bkit writes (listStampedFiles): the rendered
|
|
108
|
+
* agents / commands / skills, the managed blocks (AGENTS.md, CLAUDE.md, `.agents/*.md`,
|
|
109
|
+
* `docs/*.md`, `.gitignore`, the hooks, …) and the whole files bkit owns (`.bkit/*.md`,
|
|
110
|
+
* `.bkit/.env.example`). A marker that differs from the installing
|
|
111
|
+
* bkit version means the consumer bumped the package without re-rendering, or hand-edited
|
|
112
|
+
* a managed region and dropped the marker.
|
|
113
|
+
*
|
|
114
|
+
* Runs in Phase 3:
|
|
115
|
+
* - `bkit check` (dry-run) writes nothing, so on-disk markers keep their stale value →
|
|
116
|
+
* this fires → check exits 1 on main/dev.
|
|
117
|
+
* - real `install` / `upgrade` re-stamp in Phase 2, before this runs → no finding.
|
|
118
|
+
* - `bkit doctor` replays Phase 3 read-only → surfaces it without exiting.
|
|
119
|
+
*
|
|
120
|
+
* A block-scoped file without a bkit block is the consumer's (they dropped the block, or
|
|
121
|
+
* never had bkit's) and is skipped; a whole file without a marker is stale. Files absent
|
|
122
|
+
* on disk are skipped. A dev tree without a readable package version (`0.0.0` / empty)
|
|
123
|
+
* yields null, as does a repo with nothing stamped.
|
|
124
|
+
*
|
|
125
|
+
* Severity is branch-scoped (see PROTECTED_BRANCHES): a `blocker` on main/dev (or a PR
|
|
126
|
+
* into them), an `advisory` on feature branches. `installingVersion` and
|
|
127
|
+
* `onProtectedBranch` are injected for testability.
|
|
128
|
+
*/
|
|
129
|
+
export function detectManagedStale(
|
|
130
|
+
cwd: string,
|
|
131
|
+
installingVersion: string = readPkgVersion(),
|
|
132
|
+
onProtectedBranch: boolean = isOnProtectedBranch(cwd),
|
|
133
|
+
): PreflightFinding | null {
|
|
134
|
+
if (!installingVersion || installingVersion === "0.0.0") return null;
|
|
135
|
+
|
|
136
|
+
const stale: string[] = [];
|
|
137
|
+
let scanned = 0;
|
|
138
|
+
for (const { path: rel, scope } of listStampedFiles(cwd)) {
|
|
139
|
+
const abs = path.join(cwd, rel);
|
|
140
|
+
if (!fs.existsSync(abs)) continue;
|
|
141
|
+
const content = fs.readFileSync(abs, "utf-8");
|
|
142
|
+
const found =
|
|
143
|
+
scope === "block" ? readManagedBlockVersion(content) : readManagedVersion(content);
|
|
144
|
+
if (found === undefined) continue;
|
|
145
|
+
scanned++;
|
|
146
|
+
if (found !== installingVersion) stale.push(`${rel}${found ? ` (v${found})` : " (no marker)"}`);
|
|
147
|
+
}
|
|
148
|
+
|
|
149
|
+
if (scanned === 0 || stale.length === 0) return null;
|
|
150
|
+
|
|
151
|
+
const examples = stale.slice(0, 5).join(", ");
|
|
152
|
+
const more = stale.length > 5 ? ` (+${stale.length - 5} more)` : "";
|
|
153
|
+
const branchNote = onProtectedBranch
|
|
154
|
+
? ""
|
|
155
|
+
: " (non-blocking on this feature branch — it WILL hard-fail `bkit check` on main/dev, so re-render before merging.)";
|
|
156
|
+
return {
|
|
157
|
+
id: "bkit-managed-stale",
|
|
158
|
+
severity: onProtectedBranch ? "blocker" : "advisory",
|
|
159
|
+
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}`,
|
|
160
|
+
action:
|
|
161
|
+
"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.",
|
|
162
|
+
};
|
|
163
|
+
}
|
|
164
|
+
|
|
165
|
+
// ---------------------------------------------------------------------------
|
|
166
|
+
// Owned hook files — `bkit check` fails when one is missing
|
|
167
|
+
// ---------------------------------------------------------------------------
|
|
168
|
+
|
|
169
|
+
/** A bkit-owned hook file the consumer's install needs but is absent on disk. */
|
|
170
|
+
export interface MissingOwnedHook {
|
|
171
|
+
path: string;
|
|
172
|
+
/** The `bkit install` flag that writes it back. */
|
|
173
|
+
restoreFlag: string;
|
|
174
|
+
}
|
|
175
|
+
|
|
176
|
+
/** Host modules whose manifest hook files a host config runs, and the flag that installs each. */
|
|
177
|
+
const HOOK_HOST_FLAGS: ReadonlyArray<["claude" | "cursor" | "codex" | "opencode", string]> = [
|
|
178
|
+
["claude", "--claude"],
|
|
179
|
+
["cursor", "--cursor"],
|
|
180
|
+
["codex", "--codex"],
|
|
181
|
+
["opencode", "--opencode=<provider>"],
|
|
182
|
+
];
|
|
183
|
+
|
|
184
|
+
/** Manifest paths a host runs as a hook: `.<host>/hooks/<file>` and `.opencode/plugin/<file>`. */
|
|
185
|
+
const HOOK_FILE_RE = /\/(hooks|plugin)\/[^/]+$/;
|
|
186
|
+
|
|
187
|
+
/**
|
|
188
|
+
* Owned hook files that are missing for what this repo has installed: the hook files in the
|
|
189
|
+
* manifest of each installed host module. The claude and codex hook commands skip a missing
|
|
190
|
+
* file (`test -f <file> && … || true`); `bkit check` fails on it.
|
|
191
|
+
*/
|
|
192
|
+
export function findMissingOwnedHooks(cwd: string, modules: Set<ModuleFlag>): MissingOwnedHook[] {
|
|
193
|
+
const required: MissingOwnedHook[] = [];
|
|
194
|
+
for (const [host, restoreFlag] of HOOK_HOST_FLAGS) {
|
|
195
|
+
if (!modules.has(host)) continue;
|
|
196
|
+
for (const entry of getModuleManifest(host)) {
|
|
197
|
+
if (HOOK_FILE_RE.test(entry.path)) required.push({ path: entry.path, restoreFlag });
|
|
198
|
+
}
|
|
199
|
+
}
|
|
200
|
+
return required.filter((hook) => !fs.existsSync(path.join(cwd, hook.path)));
|
|
201
|
+
}
|
|
202
|
+
|
|
203
|
+
/** One-line description of a missing hook file, shared by the checklist and the check exit. */
|
|
204
|
+
export function describeMissingOwnedHook(hook: MissingOwnedHook): string {
|
|
205
|
+
return `${hook.path} is missing, so the hook that runs it is off — restore it with \`pnpm bkit install ${hook.restoreFlag}\`.`;
|
|
206
|
+
}
|
|
207
|
+
|
|
208
|
+
/** The checklist blocker for `findMissingOwnedHooks` output, or null when nothing is missing. */
|
|
209
|
+
export function detectOwnedHookMissing(missing: MissingOwnedHook[]): PreflightFinding | null {
|
|
210
|
+
if (missing.length === 0) return null;
|
|
211
|
+
return {
|
|
212
|
+
id: "owned-hook-missing",
|
|
213
|
+
severity: "blocker",
|
|
214
|
+
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.`,
|
|
215
|
+
action: missing.map(describeMissingOwnedHook).join("\n"),
|
|
216
|
+
};
|
|
217
|
+
}
|
|
@@ -0,0 +1,53 @@
|
|
|
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
|
+
|
|
14
|
+
import { readPackageJson } from "../../shared/package-json.js";
|
|
15
|
+
|
|
16
|
+
/** One advisory a package opted out of. */
|
|
17
|
+
export interface SuppressionNote {
|
|
18
|
+
/** Advisory id the package opted out of. */
|
|
19
|
+
id: string;
|
|
20
|
+
/** Repo-relative package directory the opt-out was read from (`"."` = repo root). */
|
|
21
|
+
scope: string;
|
|
22
|
+
}
|
|
23
|
+
|
|
24
|
+
/** Sink a detector calls once per suppressed finding. */
|
|
25
|
+
export type SuppressionReporter = (note: SuppressionNote) => void;
|
|
26
|
+
|
|
27
|
+
/**
|
|
28
|
+
* Advisory ids `dir/package.json` opts out of. A missing manifest, a `bkit` key that is
|
|
29
|
+
* absent or not an object, and an `ignoreAdvisories` that is absent or not an array all
|
|
30
|
+
* yield no ids — never a throw.
|
|
31
|
+
*/
|
|
32
|
+
export function ignoredAdvisoryIds(dir: string): Set<string> {
|
|
33
|
+
const read = readPackageJson(dir);
|
|
34
|
+
if (!read.ok) return new Set();
|
|
35
|
+
const bkit = read.pkg.bkit;
|
|
36
|
+
if (typeof bkit !== "object" || bkit === null || Array.isArray(bkit)) return new Set();
|
|
37
|
+
const list = (bkit as { ignoreAdvisories?: unknown }).ignoreAdvisories;
|
|
38
|
+
if (!Array.isArray(list)) return new Set();
|
|
39
|
+
return new Set(list.filter((id): id is string => typeof id === "string"));
|
|
40
|
+
}
|
|
41
|
+
|
|
42
|
+
/**
|
|
43
|
+
* True when `dir/package.json` opts out of `id` AND the finding resolved to advisory
|
|
44
|
+
* severity. `blocker` returns false unconditionally — a blocker is not suppressible.
|
|
45
|
+
*/
|
|
46
|
+
export function isAdvisorySuppressed(
|
|
47
|
+
dir: string,
|
|
48
|
+
id: string,
|
|
49
|
+
severity: "blocker" | "advisory",
|
|
50
|
+
): boolean {
|
|
51
|
+
if (severity !== "advisory") return false;
|
|
52
|
+
return ignoredAdvisoryIds(dir).has(id);
|
|
53
|
+
}
|