@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,87 @@
|
|
|
1
|
+
import * as fs from "node:fs";
|
|
2
|
+
import * as path from "node:path";
|
|
3
|
+
import { execSync } from "node:child_process";
|
|
4
|
+
import { getPkgRoot } from "../shared/package-roots.js";
|
|
5
|
+
import { managedVersionMarker } from "./version-file.js";
|
|
6
|
+
import { gitEnv, resolveRepoSlug } from "../ledgers/telemetry.js";
|
|
7
|
+
// Read the INSTALLING bkit version from the package root (NOT the consumer's
|
|
8
|
+
// package.json — that is a different version). Mirrors readInstallingVersion
|
|
9
|
+
// (install/modules/index.ts) / readPkgVersion (checks/after/index.ts); kept local to avoid a
|
|
10
|
+
// tokens → modules import cycle. "0.0.0" on any read failure.
|
|
11
|
+
function readInstallingBkitVersion() {
|
|
12
|
+
try {
|
|
13
|
+
const pkg = JSON.parse(fs.readFileSync(path.join(getPkgRoot(), "package.json"), "utf-8"));
|
|
14
|
+
return pkg.version ?? "0.0.0";
|
|
15
|
+
}
|
|
16
|
+
catch {
|
|
17
|
+
return "0.0.0";
|
|
18
|
+
}
|
|
19
|
+
}
|
|
20
|
+
// Resolve DEFAULT_BRANCH: git symbolic-ref refs/remotes/origin/HEAD → "main"
|
|
21
|
+
function resolveDefaultBranch(cwd) {
|
|
22
|
+
try {
|
|
23
|
+
const raw = execSync("git symbolic-ref refs/remotes/origin/HEAD", {
|
|
24
|
+
cwd,
|
|
25
|
+
encoding: "utf-8",
|
|
26
|
+
stdio: ["ignore", "pipe", "ignore"],
|
|
27
|
+
env: gitEnv(),
|
|
28
|
+
}).trim();
|
|
29
|
+
// raw is like "refs/remotes/origin/main"
|
|
30
|
+
const parts = raw.split("/");
|
|
31
|
+
const branch = parts[parts.length - 1];
|
|
32
|
+
if (branch)
|
|
33
|
+
return branch;
|
|
34
|
+
}
|
|
35
|
+
catch {
|
|
36
|
+
// not a git repo or no remote HEAD configured — fall back
|
|
37
|
+
}
|
|
38
|
+
return "main";
|
|
39
|
+
}
|
|
40
|
+
// Read and parse package.json from cwd. Throws if absent.
|
|
41
|
+
function readPackageJson(cwd) {
|
|
42
|
+
const pkgPath = path.join(cwd, "package.json");
|
|
43
|
+
if (!fs.existsSync(pkgPath)) {
|
|
44
|
+
throw new Error(`[bkit-placeholders] package.json not found at ${pkgPath}`);
|
|
45
|
+
}
|
|
46
|
+
const raw = fs.readFileSync(pkgPath, "utf-8");
|
|
47
|
+
return JSON.parse(raw);
|
|
48
|
+
}
|
|
49
|
+
// Resolve all tokens in a single read-once pass at install-start.
|
|
50
|
+
// Hard-fails (throws) if package.json.name is absent.
|
|
51
|
+
export async function resolveTokens(cwd) {
|
|
52
|
+
const pkg = readPackageJson(cwd);
|
|
53
|
+
const name = pkg["name"];
|
|
54
|
+
if (typeof name !== "string" || name.trim() === "") {
|
|
55
|
+
throw new Error(`[bkit-placeholders] package.json.name is required but missing or empty in ${cwd}`);
|
|
56
|
+
}
|
|
57
|
+
return {
|
|
58
|
+
DEFAULT_BRANCH: resolveDefaultBranch(cwd),
|
|
59
|
+
PROJECT_NAME: name.trim(),
|
|
60
|
+
REPO_SLUG: resolveRepoSlug(cwd),
|
|
61
|
+
BKIT_VERSION: readInstallingBkitVersion(),
|
|
62
|
+
};
|
|
63
|
+
}
|
|
64
|
+
// Substitute {{TOKEN}} placeholders in content string.
|
|
65
|
+
// Substitution happens at write-time (caller's responsibility), not at template-read time.
|
|
66
|
+
// Uses function-form replacers to prevent $& / $1 / $$ substitution patterns from leaking
|
|
67
|
+
// through when token values contain dollar signs.
|
|
68
|
+
export function applyTokens(content, tokens) {
|
|
69
|
+
const defaultBranch = tokens.DEFAULT_BRANCH;
|
|
70
|
+
const projectName = tokens.PROJECT_NAME;
|
|
71
|
+
const repoSlug = tokens.REPO_SLUG;
|
|
72
|
+
let out = content
|
|
73
|
+
.replace(/\{\{DEFAULT_BRANCH\}\}/g, () => defaultBranch)
|
|
74
|
+
.replace(/\{\{PROJECT_NAME\}\}/g, () => projectName)
|
|
75
|
+
.replace(/\{\{REPO_SLUG\}\}/g, () => repoSlug);
|
|
76
|
+
// {{BKIT_MANAGED_MARKER}} → the managed-version marker. A token after `// ` at a line
|
|
77
|
+
// start resolves to the slash form (JS); every other occurrence to the HTML comment,
|
|
78
|
+
// so `# {{BKIT_MANAGED_MARKER}}` yields the hash form. The version is read from the
|
|
79
|
+
// package only when the token is present and the TokenMap omits BKIT_VERSION.
|
|
80
|
+
if (out.includes("{{BKIT_MANAGED_MARKER}}")) {
|
|
81
|
+
const version = tokens.BKIT_VERSION ?? readInstallingBkitVersion();
|
|
82
|
+
out = out
|
|
83
|
+
.replace(/^\/\/ \{\{BKIT_MANAGED_MARKER\}\}/gm, () => managedVersionMarker(version, "slash"))
|
|
84
|
+
.replace(/\{\{BKIT_MANAGED_MARKER\}\}/g, () => managedVersionMarker(version));
|
|
85
|
+
}
|
|
86
|
+
return out;
|
|
87
|
+
}
|
|
@@ -0,0 +1,106 @@
|
|
|
1
|
+
// install/template-copies.ts — the consumer's `.bkit/templates/` copies: the sync that
|
|
2
|
+
// refreshes them, and the dotfile remap they share with the install/upgrade walk.
|
|
3
|
+
import * as fs from "node:fs";
|
|
4
|
+
import * as path from "node:path";
|
|
5
|
+
import { NPM_STRIP_REMAP, getPkgRoot, getTemplatesRoot, TEMPLATE_COPIES_DIR, } from "../shared/package-roots.js";
|
|
6
|
+
export function listFilesRecursive(dir) {
|
|
7
|
+
if (!fs.existsSync(dir))
|
|
8
|
+
return [];
|
|
9
|
+
const out = [];
|
|
10
|
+
for (const ent of fs.readdirSync(dir, { withFileTypes: true })) {
|
|
11
|
+
const p = path.join(dir, ent.name);
|
|
12
|
+
if (ent.isDirectory())
|
|
13
|
+
out.push(...listFilesRecursive(p));
|
|
14
|
+
else if (ent.isFile())
|
|
15
|
+
out.push(p);
|
|
16
|
+
}
|
|
17
|
+
return out;
|
|
18
|
+
}
|
|
19
|
+
// The dotfile remap: the one table lives in shared/package-roots.ts (NPM_STRIP_REMAP); the
|
|
20
|
+
// module install pass (install/modules/index.ts) and the `bkit upgrade` template walk both
|
|
21
|
+
// call this, so they never disagree about how a payload basename maps to its dest.
|
|
22
|
+
export function remapTemplateDest(rel) {
|
|
23
|
+
const dir = path.dirname(rel);
|
|
24
|
+
const base = path.basename(rel);
|
|
25
|
+
const mapped = NPM_STRIP_REMAP[base];
|
|
26
|
+
if (mapped === undefined)
|
|
27
|
+
return rel;
|
|
28
|
+
return dir === "." ? mapped : path.join(dir, mapped);
|
|
29
|
+
}
|
|
30
|
+
// Copy the whole templates root from the package into the consumer's
|
|
31
|
+
// `.bkit/templates/`, raw: no token substitution, so the copy is the package bytes and
|
|
32
|
+
// `git diff .bkit/templates` on an upgrade commit is the template changelog. Byte-compares
|
|
33
|
+
// first, keeps the source mode (hooks and scripts are executable), and prunes copies that
|
|
34
|
+
// left the set. Every change pushes a ws write in dry-run and live alike, so `bkit check`
|
|
35
|
+
// flags a stale copy. No-op in dogfood: there the folder IS the package's template source.
|
|
36
|
+
export function syncTemplateCopies(cwd, opts) {
|
|
37
|
+
const changes = { changed: [], added: [], removed: [] };
|
|
38
|
+
if (path.resolve(cwd) === getPkgRoot())
|
|
39
|
+
return changes;
|
|
40
|
+
const srcRoot = getTemplatesRoot();
|
|
41
|
+
const dstRoot = path.join(cwd, TEMPLATE_COPIES_DIR);
|
|
42
|
+
const shipped = new Set();
|
|
43
|
+
for (const srcPath of listFilesRecursive(srcRoot)) {
|
|
44
|
+
const rel = path.relative(srcRoot, srcPath);
|
|
45
|
+
shipped.add(rel);
|
|
46
|
+
const dstPath = path.join(dstRoot, rel);
|
|
47
|
+
const exists = fs.existsSync(dstPath);
|
|
48
|
+
if (exists && fs.readFileSync(srcPath).equals(fs.readFileSync(dstPath)))
|
|
49
|
+
continue;
|
|
50
|
+
(exists ? changes.changed : changes.added).push(rel);
|
|
51
|
+
if (!opts.dryRun) {
|
|
52
|
+
fs.mkdirSync(path.dirname(dstPath), { recursive: true });
|
|
53
|
+
fs.copyFileSync(srcPath, dstPath);
|
|
54
|
+
fs.chmodSync(dstPath, fs.statSync(srcPath).mode);
|
|
55
|
+
}
|
|
56
|
+
opts.ws.writes.push({
|
|
57
|
+
path: path.join(TEMPLATE_COPIES_DIR, rel),
|
|
58
|
+
action: exists ? "update" : "write",
|
|
59
|
+
});
|
|
60
|
+
}
|
|
61
|
+
for (const dstPath of listFilesRecursive(dstRoot)) {
|
|
62
|
+
const rel = path.relative(dstRoot, dstPath);
|
|
63
|
+
if (shipped.has(rel))
|
|
64
|
+
continue;
|
|
65
|
+
changes.removed.push(rel);
|
|
66
|
+
if (!opts.dryRun)
|
|
67
|
+
fs.rmSync(dstPath);
|
|
68
|
+
opts.ws.writes.push({ path: path.join(TEMPLATE_COPIES_DIR, rel), action: "update" });
|
|
69
|
+
}
|
|
70
|
+
if (!opts.dryRun)
|
|
71
|
+
pruneEmptyDirs(dstRoot);
|
|
72
|
+
return changes;
|
|
73
|
+
}
|
|
74
|
+
// Remove empty folders under `root`, deepest first. `root` itself stays.
|
|
75
|
+
function pruneEmptyDirs(root) {
|
|
76
|
+
if (!fs.existsSync(root))
|
|
77
|
+
return;
|
|
78
|
+
for (const ent of fs.readdirSync(root, { withFileTypes: true })) {
|
|
79
|
+
if (!ent.isDirectory())
|
|
80
|
+
continue;
|
|
81
|
+
const dir = path.join(root, ent.name);
|
|
82
|
+
pruneEmptyDirs(dir);
|
|
83
|
+
if (fs.readdirSync(dir).length === 0)
|
|
84
|
+
fs.rmdirSync(dir);
|
|
85
|
+
}
|
|
86
|
+
}
|
|
87
|
+
/** One-line pointer to the template docs, shared by the install and upgrade messages. */
|
|
88
|
+
export const TEMPLATES_POINTER = "Templates (adopt, do not skip): read .bkit/templates.md; bkit never applies templates, so adopt each copy in .bkit/templates/ unless adoption would break existing functionality — state which you did not adopt and why. (If your own gates scan the repo, ignore .bkit/templates/.)";
|
|
89
|
+
/**
|
|
90
|
+
* The upgrade report for a template sync: one line per changed, added or removed
|
|
91
|
+
* template, then where to read about adopting them. Empty when nothing changed.
|
|
92
|
+
*/
|
|
93
|
+
export function formatTemplateChanges(changes) {
|
|
94
|
+
const lines = [
|
|
95
|
+
...changes.changed.map((p) => ` changed: ${path.join(TEMPLATE_COPIES_DIR, p)}`),
|
|
96
|
+
...changes.added.map((p) => ` added: ${path.join(TEMPLATE_COPIES_DIR, p)}`),
|
|
97
|
+
...changes.removed.map((p) => ` removed: ${path.join(TEMPLATE_COPIES_DIR, p)}`),
|
|
98
|
+
];
|
|
99
|
+
if (lines.length === 0)
|
|
100
|
+
return "";
|
|
101
|
+
return [
|
|
102
|
+
`Templates updated (${lines.length}). bkit never applies these; diff them against your own copies and adopt what you want:`,
|
|
103
|
+
...lines,
|
|
104
|
+
TEMPLATES_POINTER,
|
|
105
|
+
].join("\n");
|
|
106
|
+
}
|
|
@@ -0,0 +1,204 @@
|
|
|
1
|
+
// install/version-file.ts — Schema for .bkit/version.
|
|
2
|
+
//
|
|
3
|
+
// Shape: JSON { pinnedVersion, canonicalHashes, claudeAllowDerived }. Content that is
|
|
4
|
+
// empty or not a JSON object reads as absent (null).
|
|
5
|
+
//
|
|
6
|
+
// `canonicalHashes`: map of consumer-relative path → sha256 hex of the file
|
|
7
|
+
// content bkit wrote. Used by `bkit upgrade` to detect consumer drift and by
|
|
8
|
+
// `bkit uninstall` to delete an owned file only when it is unchanged since bkit
|
|
9
|
+
// wrote it. Absent means "unknown" → treat as consumer-modified (preserve).
|
|
10
|
+
//
|
|
11
|
+
// Security note: sha256 used for content identity only, not cryptographic
|
|
12
|
+
// authentication. No secrets are stored here.
|
|
13
|
+
import * as fs from "node:fs";
|
|
14
|
+
import * as path from "node:path";
|
|
15
|
+
import * as crypto from "node:crypto";
|
|
16
|
+
import { parseJson } from "../shared/json.js";
|
|
17
|
+
import { getTemplatesRoot, templateRelPath } from "../shared/package-roots.js";
|
|
18
|
+
// ---------------------------------------------------------------------------
|
|
19
|
+
// Parse
|
|
20
|
+
// ---------------------------------------------------------------------------
|
|
21
|
+
/**
|
|
22
|
+
* Parse `.bkit/version` content into a BkitVersion object. Returns null when the
|
|
23
|
+
* content is empty or is not a JSON object (treat as absent). A missing
|
|
24
|
+
* `canonicalHashes` reads as {} (every file "unknown" → no silent overwrites) and a
|
|
25
|
+
* missing `claudeAllowDerived` as [] (bkit prunes nothing).
|
|
26
|
+
*/
|
|
27
|
+
export function parseBkitVersion(content) {
|
|
28
|
+
const trimmed = content.trim();
|
|
29
|
+
if (!trimmed.startsWith("{"))
|
|
30
|
+
return null;
|
|
31
|
+
const json = parseJson(trimmed);
|
|
32
|
+
if (!json.ok || typeof json.value !== "object" || json.value === null)
|
|
33
|
+
return null;
|
|
34
|
+
const parsed = json.value;
|
|
35
|
+
const pinnedVersion = typeof parsed.pinnedVersion === "string" ? parsed.pinnedVersion : "";
|
|
36
|
+
const hashes = parsed.canonicalHashes;
|
|
37
|
+
const canonicalHashes = hashes && typeof hashes === "object" && !Array.isArray(hashes) ? { ...hashes } : {};
|
|
38
|
+
const claudeAllowDerived = Array.isArray(parsed.claudeAllowDerived)
|
|
39
|
+
? parsed.claudeAllowDerived
|
|
40
|
+
: [];
|
|
41
|
+
return { pinnedVersion, canonicalHashes, claudeAllowDerived };
|
|
42
|
+
}
|
|
43
|
+
/**
|
|
44
|
+
* Read and parse `.bkit/version` from an absolute path.
|
|
45
|
+
* Returns null if the file is absent or content is empty.
|
|
46
|
+
*/
|
|
47
|
+
export function readBkitVersion(versionFilePath) {
|
|
48
|
+
if (!fs.existsSync(versionFilePath))
|
|
49
|
+
return null;
|
|
50
|
+
const content = fs.readFileSync(versionFilePath, "utf-8");
|
|
51
|
+
return parseBkitVersion(content);
|
|
52
|
+
}
|
|
53
|
+
// ---------------------------------------------------------------------------
|
|
54
|
+
// Write — serialize to JSON
|
|
55
|
+
// ---------------------------------------------------------------------------
|
|
56
|
+
/**
|
|
57
|
+
* Serialize a BkitVersion to JSON for writing to `.bkit/version`.
|
|
58
|
+
* Always writes pretty-printed JSON with a trailing newline, schema fields only.
|
|
59
|
+
*/
|
|
60
|
+
export function serializeBkitVersion(v) {
|
|
61
|
+
const { pinnedVersion, canonicalHashes, claudeAllowDerived } = v;
|
|
62
|
+
return JSON.stringify({ pinnedVersion, canonicalHashes, claudeAllowDerived }, null, 2) + "\n";
|
|
63
|
+
}
|
|
64
|
+
/**
|
|
65
|
+
* Write a BkitVersion to disk at `versionFilePath`.
|
|
66
|
+
*/
|
|
67
|
+
export function writeBkitVersion(versionFilePath, v) {
|
|
68
|
+
fs.mkdirSync(path.dirname(versionFilePath), { recursive: true });
|
|
69
|
+
fs.writeFileSync(versionFilePath, serializeBkitVersion(v), "utf-8");
|
|
70
|
+
}
|
|
71
|
+
// ---------------------------------------------------------------------------
|
|
72
|
+
// canonicalHashes helpers (P4.T4)
|
|
73
|
+
// ---------------------------------------------------------------------------
|
|
74
|
+
/**
|
|
75
|
+
* Decide whether a managed file has been modified by the consumer since install.
|
|
76
|
+
*
|
|
77
|
+
* Returns true (treat as consumer-modified — block silent overwrite) when:
|
|
78
|
+
* - `canonicalHashes` has a recorded hash for `relPath` and the current on-disk
|
|
79
|
+
* content hash differs from it (true drift), OR
|
|
80
|
+
* - `canonicalHashes` has no entry for `relPath` (unknown hash state); upgrade then
|
|
81
|
+
* surfaces a conflict for the consumer to resolve.
|
|
82
|
+
*
|
|
83
|
+
* Returns false (no drift — safe to upgrade) only when:
|
|
84
|
+
* - The current on-disk content matches the recorded canonical hash, OR
|
|
85
|
+
* - The file is absent (nothing to compare).
|
|
86
|
+
*
|
|
87
|
+
* `relPath`: consumer-relative path (e.g. ".claude/agents/bkit-foo.md")
|
|
88
|
+
* `absolutePath`: absolute path to the file on disk
|
|
89
|
+
* `canonicalHashes`: the hashes map from the BkitVersion record
|
|
90
|
+
*/
|
|
91
|
+
export function isConsumerModified(relPath, absolutePath, canonicalHashes) {
|
|
92
|
+
const current = hashFile(absolutePath);
|
|
93
|
+
if (!current)
|
|
94
|
+
return false; // absent → nothing to compare
|
|
95
|
+
const recorded = canonicalHashes[relPath];
|
|
96
|
+
if (!recorded)
|
|
97
|
+
return true; // unknown → treat as modified to prevent silent overwrites
|
|
98
|
+
return current !== recorded;
|
|
99
|
+
}
|
|
100
|
+
/**
|
|
101
|
+
* The merge both writers share (install's postDispatch and
|
|
102
|
+
* `updateCanonicalHashesAfterUpgrade`): fresh entries overwrite, and entries whose
|
|
103
|
+
* path is no longer on disk — or that belong to the copy-and-own template set —
|
|
104
|
+
* are dropped.
|
|
105
|
+
*
|
|
106
|
+
* A recorded hash is only ever consulted for a file that exists — drift detection
|
|
107
|
+
* reads the file, uninstall deletes it — so an entry for an absent path is dead
|
|
108
|
+
* bookkeeping, and a file recreated at that path later would be misclassified as
|
|
109
|
+
* bkit-owned. A template-set path is never a file bkit owns: install copies it
|
|
110
|
+
* byte-for-byte into `.bkit/templates/` and never writes the consumer's own copy,
|
|
111
|
+
* so it must carry no ownership hash. Retired and renamed managed files leave such
|
|
112
|
+
* entries behind, and a pure merge would preserve them forever (the
|
|
113
|
+
* `.bkit/scripts/…` entry a #507 move left and the `scripts/graphify/**` +
|
|
114
|
+
* `scripts/serena/bkit-serena-mcp.sh` entries a #489 move left are the observed
|
|
115
|
+
* cases; the latter survive the absent-path prune because the adopted copy stays on
|
|
116
|
+
* disk).
|
|
117
|
+
*
|
|
118
|
+
* `pruned` counts the dropped entries so callers can treat a prune-only merge as a
|
|
119
|
+
* change that is still worth writing.
|
|
120
|
+
*/
|
|
121
|
+
export function mergeCanonicalHashes(cwd, existing, fresh) {
|
|
122
|
+
const canonicalHashes = {};
|
|
123
|
+
let pruned = 0;
|
|
124
|
+
for (const [relPath, hash] of Object.entries(existing)) {
|
|
125
|
+
if (!fs.existsSync(path.join(cwd, relPath)) || isTemplateSetPath(relPath)) {
|
|
126
|
+
pruned++;
|
|
127
|
+
continue;
|
|
128
|
+
}
|
|
129
|
+
canonicalHashes[relPath] = hash;
|
|
130
|
+
}
|
|
131
|
+
return { canonicalHashes: { ...canonicalHashes, ...fresh }, pruned };
|
|
132
|
+
}
|
|
133
|
+
/** True when `dest` is a member of the package's copy-and-own template set. */
|
|
134
|
+
function isTemplateSetPath(dest) {
|
|
135
|
+
return fs.existsSync(path.join(getTemplatesRoot(), templateRelPath(dest)));
|
|
136
|
+
}
|
|
137
|
+
// ---------------------------------------------------------------------------
|
|
138
|
+
// sha256 — content hashing for canonicalHashes
|
|
139
|
+
// ---------------------------------------------------------------------------
|
|
140
|
+
/**
|
|
141
|
+
* Compute the sha256 hex digest of a string or Buffer.
|
|
142
|
+
* Used to record the content of the files bkit writes.
|
|
143
|
+
*/
|
|
144
|
+
export function sha256(content) {
|
|
145
|
+
return crypto.createHash("sha256").update(content).digest("hex");
|
|
146
|
+
}
|
|
147
|
+
/**
|
|
148
|
+
* Read a file and return its sha256 hex digest. Returns null if absent.
|
|
149
|
+
*/
|
|
150
|
+
export function hashFile(filePath) {
|
|
151
|
+
if (!fs.existsSync(filePath))
|
|
152
|
+
return null;
|
|
153
|
+
const content = fs.readFileSync(filePath);
|
|
154
|
+
return sha256(content);
|
|
155
|
+
}
|
|
156
|
+
// Matches a stamped marker line in any form (anchored at a line start) including its
|
|
157
|
+
// trailing newline, so re-stamping replaces rather than appends (idempotent). Inline
|
|
158
|
+
// prose that quotes the marker never starts a line with it, so it never matches.
|
|
159
|
+
export const MANAGED_MARKER_LINE_RE = /^(?:<!-- |# <!-- |\/\/ )bkit:managed v[^\n]*\n?/m;
|
|
160
|
+
// Extracts the stamped version. `\S+` stops at the space before the em-dash.
|
|
161
|
+
export const MANAGED_MARKER_VERSION_RE = /bkit:managed v(\S+)/;
|
|
162
|
+
/** Build the managed-version marker for a given version, in the given comment syntax. */
|
|
163
|
+
export function managedVersionMarker(version, form = "html") {
|
|
164
|
+
const text = `bkit:managed v${version} — PolyForm Noncommercial 1.0.0 / Small Business 1.0.0 (https://polyformproject.org/licenses/) — do not edit; run \`bkit upgrade\` to refresh`;
|
|
165
|
+
if (form === "slash")
|
|
166
|
+
return `// ${text}`;
|
|
167
|
+
return form === "hash" ? `# <!-- ${text} -->` : `<!-- ${text} -->`;
|
|
168
|
+
}
|
|
169
|
+
/** Version of the first full-line managed-version marker in `content`, or null when none. */
|
|
170
|
+
export function readManagedVersion(content) {
|
|
171
|
+
const line = content.match(MANAGED_MARKER_LINE_RE)?.[0];
|
|
172
|
+
return line?.match(MANAGED_MARKER_VERSION_RE)?.[1] ?? null;
|
|
173
|
+
}
|
|
174
|
+
/**
|
|
175
|
+
* Insert (or replace) the managed-version marker immediately after the rendered
|
|
176
|
+
* file's frontmatter fence, always followed by exactly one blank line. Idempotent:
|
|
177
|
+
* any existing marker is stripped first and leading body blanks are collapsed, so
|
|
178
|
+
* stamping the same content twice yields identical bytes. With no frontmatter (e.g.
|
|
179
|
+
* cursor/opencode commands whose transforms strip the frontmatter), the marker sinks
|
|
180
|
+
* below the content's first Markdown heading instead, so it never becomes the
|
|
181
|
+
* IDE-visible first line; falls back to a top prepend only when there is no heading
|
|
182
|
+
* either, also followed by a blank line.
|
|
183
|
+
*/
|
|
184
|
+
export function stampManagedVersion(content, version) {
|
|
185
|
+
const stripped = content.replace(MANAGED_MARKER_LINE_RE, "");
|
|
186
|
+
const marker = managedVersionMarker(version);
|
|
187
|
+
const fm = stripped.match(/^---\n[\s\S]*?\n---\n/);
|
|
188
|
+
if (fm) {
|
|
189
|
+
const cut = fm[0].length;
|
|
190
|
+
const body = stripped.slice(cut).replace(/^\n+/, "");
|
|
191
|
+
return stripped.slice(0, cut) + marker + "\n\n" + body;
|
|
192
|
+
}
|
|
193
|
+
// No frontmatter — the cursor/opencode command transforms remove it (applyT1 /
|
|
194
|
+
// applyOpencodeCommand). A marker on line 1 would be the IDE-visible command
|
|
195
|
+
// description, so it sinks below the first heading when there is one.
|
|
196
|
+
const heading = stripped.match(/^#{1,6} .*$/m);
|
|
197
|
+
if (heading?.index !== undefined) {
|
|
198
|
+
const cut = heading.index + heading[0].length;
|
|
199
|
+
const head = stripped.slice(0, cut);
|
|
200
|
+
const rest = stripped.slice(cut).replace(/^\n+/, "");
|
|
201
|
+
return rest ? `${head}\n\n${marker}\n\n${rest}` : `${head}\n\n${marker}\n`;
|
|
202
|
+
}
|
|
203
|
+
return marker + "\n\n" + stripped.replace(/^\n+/, "");
|
|
204
|
+
}
|