@cbartens/bkit 0.0.0-stage → 5.0.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.bkit/README.md +421 -0
- package/.bkit/core/.agents/context.md +95 -0
- package/.bkit/core/.agents/docs.md +62 -0
- package/.bkit/core/.agents/rules.md +147 -0
- package/.bkit/core/.agents/skills.md +43 -0
- package/.bkit/core/.bkit/LICENSE.md +151 -0
- package/.bkit/core/.bkit/README.md +421 -0
- package/.bkit/core/.bkit/cloud.md +502 -0
- package/.bkit/core/.bkit/comparison.md +318 -0
- package/.bkit/core/.bkit/install.md +496 -0
- package/.bkit/core/.bkit/jsonl.md +497 -0
- package/.bkit/core/.bkit/prompts.md +474 -0
- package/.bkit/core/.bkit/providers.md +598 -0
- package/.bkit/core/.bkit/templates.md +471 -0
- package/.bkit/core/.bkit/trackers.md +95 -0
- package/.bkit/core/.bkit/workflows.md +1546 -0
- package/.bkit/core/.claude/hooks/bkit-gateguard.cjs +82 -0
- package/.bkit/core/.claude/hooks/bkit-guardrails.cjs +93 -0
- package/.bkit/core/.claude/hooks/bkit-preflight.sh +74 -0
- package/.bkit/core/.codex/hooks/bkit-gateguard.cjs +115 -0
- package/.bkit/core/.codex/hooks/bkit-guardrails.cjs +135 -0
- package/.bkit/core/.cursor/hooks/bkit-gateguard.cjs +111 -0
- package/.bkit/core/.cursor/hooks/bkit-guardrails.cjs +169 -0
- package/.bkit/core/.cursor/hooks/bkit-preflight.sh +63 -0
- package/.bkit/core/.opencode/plugin/bkit-gateguard.js +225 -0
- package/.bkit/core/AGENTS.md +77 -0
- package/.bkit/core/LICENSE.md +149 -0
- package/.bkit/core/docs/templates/bkit-audit-accessibility.md +272 -0
- package/.bkit/core/docs/templates/bkit-audit-adoption.md +223 -0
- package/.bkit/core/docs/templates/bkit-audit-agents.md +230 -0
- package/.bkit/core/docs/templates/bkit-audit-aio-seo.md +227 -0
- package/.bkit/core/docs/templates/bkit-audit-analytics.md +266 -0
- package/.bkit/core/docs/templates/bkit-audit-annotations.md +230 -0
- package/.bkit/core/docs/templates/bkit-audit-app-performance.md +270 -0
- package/.bkit/core/docs/templates/bkit-audit-app-store.md +254 -0
- package/.bkit/core/docs/templates/bkit-audit-architecture.md +221 -0
- package/.bkit/core/docs/templates/bkit-audit-ci-performance.md +241 -0
- package/.bkit/core/docs/templates/bkit-audit-config.md +230 -0
- package/.bkit/core/docs/templates/bkit-audit-cost.md +218 -0
- package/.bkit/core/docs/templates/bkit-audit-coverage.md +221 -0
- package/.bkit/core/docs/templates/bkit-audit-database.md +229 -0
- package/.bkit/core/docs/templates/bkit-audit-dead-code.md +251 -0
- package/.bkit/core/docs/templates/bkit-audit-deferrals.md +283 -0
- package/.bkit/core/docs/templates/bkit-audit-dependencies.md +268 -0
- package/.bkit/core/docs/templates/bkit-audit-documentation.md +280 -0
- package/.bkit/core/docs/templates/bkit-audit-duplication.md +253 -0
- package/.bkit/core/docs/templates/bkit-audit-failures.md +259 -0
- package/.bkit/core/docs/templates/bkit-audit-flakes.md +237 -0
- package/.bkit/core/docs/templates/bkit-audit-gates.md +250 -0
- package/.bkit/core/docs/templates/bkit-audit-issues.md +273 -0
- package/.bkit/core/docs/templates/bkit-audit-llm.md +239 -0
- package/.bkit/core/docs/templates/bkit-audit-logs.md +266 -0
- package/.bkit/core/docs/templates/bkit-audit-models.md +210 -0
- package/.bkit/core/docs/templates/bkit-audit-privacy.md +211 -0
- package/.bkit/core/docs/templates/bkit-audit-prompts.md +216 -0
- package/.bkit/core/docs/templates/bkit-audit-red-team.md +220 -0
- package/.bkit/core/docs/templates/bkit-audit-reliability.md +222 -0
- package/.bkit/core/docs/templates/bkit-audit-repo.md +224 -0
- package/.bkit/core/docs/templates/bkit-audit-security.md +274 -0
- package/.bkit/core/docs/templates/bkit-audit-slop.md +200 -0
- package/.bkit/core/docs/templates/bkit-audit-testing.md +270 -0
- package/.bkit/core/docs/templates/bkit-audit-usability.md +237 -0
- package/.bkit/core/docs/templates/bkit-plan.md +476 -0
- package/.bkit/core/engine/checks/after/auth.ts +247 -0
- package/.bkit/core/engine/checks/after/ci-yml.ts +739 -0
- package/.bkit/core/engine/checks/after/github.ts +424 -0
- package/.bkit/core/engine/checks/after/index.ts +556 -0
- package/.bkit/core/engine/checks/after/managed.ts +217 -0
- package/.bkit/core/engine/checks/after/tools.ts +427 -0
- package/.bkit/core/engine/checks/after/vercel.ts +101 -0
- package/.bkit/core/engine/checks/before/context-fetch.ts +429 -0
- package/.bkit/core/engine/checks/before/env.ts +201 -0
- package/.bkit/core/engine/checks/before/files.ts +202 -0
- package/.bkit/core/engine/checks/before/index.ts +206 -0
- package/.bkit/core/engine/checks/before/mcp.ts +127 -0
- package/.bkit/core/engine/checks/before/repo.ts +77 -0
- package/.bkit/core/engine/checks/before/version.ts +67 -0
- package/.bkit/core/engine/checks/status-holes.ts +479 -0
- package/.bkit/core/engine/cli.ts +871 -0
- package/.bkit/core/engine/commands/analysis.ts +550 -0
- package/.bkit/core/engine/commands/ci/ci.ts +483 -0
- package/.bkit/core/engine/commands/comply.ts +415 -0
- package/.bkit/core/engine/commands/harvest.ts +459 -0
- package/.bkit/core/engine/commands/install/check.ts +70 -0
- package/.bkit/core/engine/commands/install/doctor.ts +247 -0
- package/.bkit/core/engine/commands/install/install.ts +528 -0
- package/.bkit/core/engine/commands/install/uninstall.ts +972 -0
- package/.bkit/core/engine/commands/install/upgrade.ts +1026 -0
- package/.bkit/core/engine/commands/launch.ts +139 -0
- package/.bkit/core/engine/commands/lib.ts +494 -0
- package/.bkit/core/engine/commands/registry.ts +53 -0
- package/.bkit/core/engine/commands/setup/setup.ts +184 -0
- package/.bkit/core/engine/commands/telemetry.ts +32 -0
- package/.bkit/core/engine/commands/workflow/branches.ts +1514 -0
- package/.bkit/core/engine/commands/workflow/context.ts +961 -0
- package/.bkit/core/engine/commands/workflow/counters.ts +268 -0
- package/.bkit/core/engine/commands/workflow/fids.ts +243 -0
- package/.bkit/core/engine/commands/workflow/issues.ts +675 -0
- package/.bkit/core/engine/commands/workflow/ledgers.ts +575 -0
- package/.bkit/core/engine/commands/workflow/locks.ts +478 -0
- package/.bkit/core/engine/commands/workflow/prs.ts +1087 -0
- package/.bkit/core/engine/commands/workflow/repo.ts +220 -0
- package/.bkit/core/engine/commands/workflow/roadmap.ts +576 -0
- package/.bkit/core/engine/commands/workflow/runs.ts +2140 -0
- package/.bkit/core/engine/commands/workflow/runtime.ts +300 -0
- package/.bkit/core/engine/commands/workflow/skills.ts +118 -0
- package/.bkit/core/engine/commands/workflow/status.ts +455 -0
- package/.bkit/core/engine/commands/workflow/steps.ts +1300 -0
- package/.bkit/core/engine/commands/workflow/tests.ts +161 -0
- package/.bkit/core/engine/commands/workflow/workflows.ts +1573 -0
- package/.bkit/core/engine/commands/workflow/workstreams.ts +164 -0
- package/.bkit/core/engine/commands/workflow/worktrees.ts +534 -0
- package/.bkit/core/engine/install/cloud-env.ts +925 -0
- package/.bkit/core/engine/install/managed-block.ts +212 -0
- package/.bkit/core/engine/install/manifest.ts +448 -0
- package/.bkit/core/engine/install/modules/claude.ts +362 -0
- package/.bkit/core/engine/install/modules/cloud.ts +174 -0
- package/.bkit/core/engine/install/modules/codex.ts +219 -0
- package/.bkit/core/engine/install/modules/core.ts +600 -0
- package/.bkit/core/engine/install/modules/cursor.ts +231 -0
- package/.bkit/core/engine/install/modules/index.ts +242 -0
- package/.bkit/core/engine/install/modules/opencode.ts +573 -0
- package/.bkit/core/engine/install/placeholders.ts +108 -0
- package/.bkit/core/engine/install/template-copies.ts +119 -0
- package/.bkit/core/engine/install/version-file.ts +284 -0
- package/.bkit/core/engine/install/write.ts +467 -0
- package/.bkit/core/engine/ledgers/clamp-log.ts +32 -0
- package/.bkit/core/engine/ledgers/status.ts +213 -0
- package/.bkit/core/engine/ledgers/telemetry.ts +1143 -0
- package/.bkit/core/engine/render/hosts.ts +372 -0
- package/.bkit/core/engine/render/models.ts +323 -0
- package/.bkit/core/engine/render/parts.ts +38 -0
- package/.bkit/core/engine/render/trackers.ts +170 -0
- package/.bkit/core/engine/shared/egress.ts +345 -0
- package/.bkit/core/engine/shared/json.ts +16 -0
- package/.bkit/core/engine/shared/log-prefix.ts +9 -0
- package/.bkit/core/engine/shared/package-json.ts +29 -0
- package/.bkit/core/engine/shared/package-manager.ts +38 -0
- package/.bkit/core/engine/shared/package-roots.ts +163 -0
- package/.bkit/core/engine/shared/protected-paths.ts +164 -0
- package/.bkit/core/engine/shared/settings.ts +72 -0
- package/.bkit/core/engine/shared/timeouts.ts +20 -0
- package/.bkit/core/engine/tools/wording.ts +748 -0
- package/.bkit/core/hooks/gateguard-edit-payload.js +18 -0
- package/.bkit/core/hooks/gateguard-engine.js +193 -0
- package/.bkit/core/hooks/guardrails-shell.js +154 -0
- package/.bkit/core/hooks/guardrails-tiers.js +68 -0
- package/.bkit/core/hooks/preflight-linear.sh +73 -0
- package/.bkit/core/prompts/bkit-audit-generate.md +66 -0
- package/.bkit/core/prompts/bkit-build-challenge-1.md +79 -0
- package/.bkit/core/prompts/bkit-build-challenge-2.md +81 -0
- package/.bkit/core/prompts/bkit-build-challenge-reconcile.md +68 -0
- package/.bkit/core/prompts/bkit-build-challenge-remediate.md +70 -0
- package/.bkit/core/prompts/bkit-build-challenge-tests.md +73 -0
- package/.bkit/core/prompts/bkit-build-install-skills.md +67 -0
- package/.bkit/core/prompts/bkit-build-plan-current.md +75 -0
- package/.bkit/core/prompts/bkit-build-plan-execute.md +72 -0
- package/.bkit/core/prompts/bkit-build-plan-gaps-remediate.md +73 -0
- package/.bkit/core/prompts/bkit-build-plan-verify.md +88 -0
- package/.bkit/core/prompts/bkit-build-summary.md +93 -0
- package/.bkit/core/prompts/bkit-debug-abort-handover.md +90 -0
- package/.bkit/core/prompts/bkit-debug-failure-diagnose.md +151 -0
- package/.bkit/core/prompts/bkit-debug-failure-remediate.md +78 -0
- package/.bkit/core/prompts/bkit-debug-failure-soak.md +73 -0
- package/.bkit/core/prompts/bkit-debug-summary.md +95 -0
- package/.bkit/core/prompts/bkit-design-brainstorm-ideate-1.md +72 -0
- package/.bkit/core/prompts/bkit-design-brainstorm-ideate-2.md +72 -0
- package/.bkit/core/prompts/bkit-design-brainstorm-ideate-3.md +75 -0
- package/.bkit/core/prompts/bkit-design-generate.md +110 -0
- package/.bkit/core/prompts/bkit-design-organise.md +85 -0
- package/.bkit/core/prompts/bkit-design-review-1.md +121 -0
- package/.bkit/core/prompts/bkit-design-review-2.md +111 -0
- package/.bkit/core/prompts/bkit-design-spike.md +97 -0
- package/.bkit/core/prompts/bkit-design-summary.md +106 -0
- package/.bkit/core/prompts/bkit-design-update.md +66 -0
- package/.bkit/core/prompts/bkit-plan-complexity-check.md +66 -0
- package/.bkit/core/prompts/bkit-plan-complexity-split.md +87 -0
- package/.bkit/core/prompts/bkit-plan-generate.md +74 -0
- package/.bkit/core/prompts/bkit-plan-review-1.md +90 -0
- package/.bkit/core/prompts/bkit-plan-review-2.md +80 -0
- package/.bkit/core/prompts/bkit-plan-review-3.md +92 -0
- package/.bkit/core/prompts/bkit-plan-scope-check-1.md +84 -0
- package/.bkit/core/prompts/bkit-plan-scope-check-2.md +84 -0
- package/.bkit/core/prompts/bkit-plan-summary.md +106 -0
- package/.bkit/core/prompts/bkit-plan-update.md +68 -0
- package/.bkit/core/prompts/bkit-ship-conflict-resolve.md +90 -0
- package/.bkit/core/prompts/bkit-ship-deferred-sweep.md +94 -0
- package/.bkit/core/prompts/bkit-ship-summary.md +77 -0
- package/.bkit/core/prompts/bkit-ship-update-docs.md +71 -0
- package/.bkit/core/prompts/bkit-utility-compress-markdown.md +91 -0
- package/.bkit/core/prompts/bkit-utility-update-decisions.md +75 -0
- package/.bkit/core/prompts/bkit-utility-update-deferrals.md +76 -0
- package/.bkit/core/prompts/bkit-utility-update-documentation.md +61 -0
- package/.bkit/core/prompts/bkit-utility-update-failures.md +76 -0
- package/.bkit/core/prompts/bkit-utility-update-knowledge.md +75 -0
- package/.bkit/core/prompts/bkit-utility-update-roadmap.md +82 -0
- package/.bkit/core/workflows/bkit-auto.md +121 -0
- package/.bkit/core/workflows/bkit-build.md +802 -0
- package/.bkit/core/workflows/bkit-debug.md +642 -0
- package/.bkit/core/workflows/bkit-design.md +495 -0
- package/.bkit/core/workflows/bkit-plan.md +510 -0
- package/.bkit/core/workflows/bkit-ship.md +650 -0
- package/.bkit/shared/.bkit/.env.example +108 -0
- package/.bkit/shared/.claude/bkit-cloud.md +117 -0
- package/.bkit/shared/.claude/settings.json +88 -0
- package/.bkit/shared/.codex/hooks.json +26 -0
- package/.bkit/shared/.cursor/bkit-cloud.md +84 -0
- package/.bkit/shared/.cursor/hooks.json +26 -0
- package/.bkit/shared/.cursor/mcp.json +15 -0
- package/.bkit/shared/.cursor/rules/bkit-rules.mdc +12 -0
- package/.bkit/shared/.gitattributes +37 -0
- package/.bkit/shared/.mcp.json +16 -0
- package/.bkit/shared/.opencode/opencode.json +62 -0
- package/.bkit/shared/CLAUDE.md +11 -0
- package/.bkit/shared/LICENSE.md +22 -0
- package/.bkit/shared/docs/architecture.md +19 -0
- package/.bkit/shared/docs/data-schema.md +19 -0
- package/.bkit/shared/docs/deployments.md +438 -0
- package/.bkit/shared/docs/design.md +39 -0
- package/.bkit/shared/docs/noise.md +19 -0
- package/.bkit/shared/docs/observability.md +25 -0
- package/.bkit/shared/docs/security.md +42 -0
- package/.bkit/shared/docs/setup.md +30 -0
- package/.bkit/shared/docs/technology.md +18 -0
- package/.bkit/shared/docs/testing.md +413 -0
- package/.bkit/shared/gitignore +92 -0
- package/.bkit/templates/.claude/hooks/bkit-cloud-bootstrap.sh +192 -0
- package/.bkit/templates/.cursor/Dockerfile +68 -0
- package/.bkit/templates/.cursor/environment.json +6 -0
- package/.bkit/templates/.cursor/settings.json +11 -0
- package/.bkit/templates/.envrc +7 -0
- package/.bkit/templates/.github/dependabot.yml +52 -0
- package/.bkit/templates/.github/renovate.json5 +239 -0
- package/.bkit/templates/.github/workflows/bkit-ci.yml +1082 -0
- package/.bkit/templates/.github/workflows/bkit-cloud.yml +566 -0
- package/.bkit/templates/.github/workflows/bkit-renovate.yml +107 -0
- package/.bkit/templates/.graphifyignore +108 -0
- package/.bkit/templates/.husky/pre-commit +16 -0
- package/.bkit/templates/.husky/pre-push +91 -0
- package/.bkit/templates/.lintstagedrc.json +3 -0
- package/.bkit/templates/.prettierignore +41 -0
- package/.bkit/templates/.serena/project.yml +243 -0
- package/.bkit/templates/.vale/styles/House/Filler.yml +11 -0
- package/.bkit/templates/.vale/styles/House/Hedging.yml +12 -0
- package/.bkit/templates/.vale/styles/House/LLMSlop.yml +13 -0
- package/.bkit/templates/.vale/styles/House/Verbose.yml +12 -0
- package/.bkit/templates/.vale.ini +67 -0
- package/.bkit/templates/LICENSE.md +22 -0
- package/.bkit/templates/context/bkit-cloudrun.md +84 -0
- package/.bkit/templates/context/bkit-expo.md +186 -0
- package/.bkit/templates/context/bkit-github.md +79 -0
- package/.bkit/templates/context/bkit-inngest.md +45 -0
- package/.bkit/templates/context/bkit-maestro.md +76 -0
- package/.bkit/templates/context/bkit-playwright.md +62 -0
- package/.bkit/templates/context/bkit-resend.md +36 -0
- package/.bkit/templates/context/bkit-sentry.md +65 -0
- package/.bkit/templates/context/bkit-serena.md +33 -0
- package/.bkit/templates/context/bkit-stripe.md +36 -0
- package/.bkit/templates/context/bkit-supabase.md +59 -0
- package/.bkit/templates/context/bkit-tavily.md +49 -0
- package/.bkit/templates/context/bkit-vercel.md +64 -0
- package/.bkit/templates/docs/capabilities.md +72 -0
- package/.bkit/templates/scripts/ci/accepted-divergences.json +21 -0
- package/.bkit/templates/scripts/ci/check-accepted-divergences.mjs +152 -0
- package/.bkit/templates/scripts/ci/check-accepted-divergences.test.mjs +130 -0
- package/.bkit/templates/scripts/ci/lanes/resolve-push-base.mjs +98 -0
- package/.bkit/templates/scripts/ci/lanes/resolve-push-base.test.mjs +86 -0
- package/.bkit/templates/scripts/graphify/bkit-graph-drift-rules.json +23 -0
- package/.bkit/templates/scripts/graphify/bkit-graph-drift.py +208 -0
- package/.bkit/templates/scripts/graphify/bkit-graph-eager-rules.json +35 -0
- package/.bkit/templates/scripts/graphify/bkit-graph-eager.py +236 -0
- package/.bkit/templates/scripts/graphify/bkit-graph-external-rules.json +17 -0
- package/.bkit/templates/scripts/graphify/bkit-graph-imports.py +290 -0
- package/.bkit/templates/scripts/graphify/bkit-graph-pre-push.sh +19 -0
- package/.bkit/templates/scripts/graphify/bkit-graph-repair.py +120 -0
- package/.bkit/templates/scripts/graphify/bkit-graph-surface.py +232 -0
- package/.bkit/templates/scripts/graphify/bkit-graphify-graphml.py +36 -0
- package/.bkit/templates/scripts/graphify/bkit-graphify-rollup.py +927 -0
- package/.bkit/templates/scripts/graphify/bkit-graphify.sh +351 -0
- package/.bkit/templates/scripts/launchd/ai.bkit.launchd.plist +26 -0
- package/.bkit/templates/scripts/launchd/bkit-launchd-env.sh +53 -0
- package/.bkit/templates/scripts/launchd/launchd.env.example +13 -0
- package/.bkit/templates/scripts/prettier/bkit-insert-ignore.mjs +275 -0
- package/.bkit/templates/scripts/secrets/bkit-secrets.config.mjs +66 -0
- package/.bkit/templates/scripts/secrets/bkit-secrets.mjs +785 -0
- package/.bkit/templates/scripts/serena/bkit-serena-mcp.sh +30 -0
- package/.bkit/templates/scripts/serena/bkit-serena.mcp.json +9 -0
- package/.bkit/templates/scripts/slop/bkit-slop-type-suppression.mjs +286 -0
- package/.bkit/templates/slop-scan.config.json +120 -0
- package/CHANGELOG.md +1486 -0
- package/LICENSE.md +161 -0
- package/README.md +185 -2
- package/dist/checks/after/auth.js +232 -0
- package/dist/checks/after/ci-yml.js +718 -0
- package/dist/checks/after/github.js +400 -0
- package/dist/checks/after/index.js +447 -0
- package/dist/checks/after/managed.js +187 -0
- package/dist/checks/after/tools.js +351 -0
- package/dist/checks/after/vercel.js +102 -0
- package/dist/checks/before/context-fetch.js +426 -0
- package/dist/checks/before/env.js +173 -0
- package/dist/checks/before/files.js +185 -0
- package/dist/checks/before/index.js +162 -0
- package/dist/checks/before/mcp.js +111 -0
- package/dist/checks/before/repo.js +71 -0
- package/dist/checks/before/version.js +60 -0
- package/dist/checks/status-holes.js +393 -0
- package/dist/cli.js +692 -0
- package/dist/commands/analysis.js +325 -0
- package/dist/commands/ci/ci.js +438 -0
- package/dist/commands/comply.js +310 -0
- package/dist/commands/harvest.js +354 -0
- package/dist/commands/install/check.js +61 -0
- package/dist/commands/install/doctor.js +207 -0
- package/dist/commands/install/install.js +461 -0
- package/dist/commands/install/uninstall.js +815 -0
- package/dist/commands/install/upgrade.js +771 -0
- package/dist/commands/launch.js +118 -0
- package/dist/commands/lib.js +362 -0
- package/dist/commands/registry.js +50 -0
- package/dist/commands/setup/setup.js +158 -0
- package/dist/commands/telemetry.js +29 -0
- package/dist/commands/workflow/branches.js +1265 -0
- package/dist/commands/workflow/context.js +846 -0
- package/dist/commands/workflow/counters.js +227 -0
- package/dist/commands/workflow/fids.js +224 -0
- package/dist/commands/workflow/issues.js +585 -0
- package/dist/commands/workflow/ledgers.js +472 -0
- package/dist/commands/workflow/locks.js +364 -0
- package/dist/commands/workflow/prs.js +904 -0
- package/dist/commands/workflow/repo.js +199 -0
- package/dist/commands/workflow/roadmap.js +495 -0
- package/dist/commands/workflow/runs.js +1717 -0
- package/dist/commands/workflow/runtime.js +257 -0
- package/dist/commands/workflow/skills.js +110 -0
- package/dist/commands/workflow/status.js +392 -0
- package/dist/commands/workflow/steps.js +1093 -0
- package/dist/commands/workflow/tests.js +144 -0
- package/dist/commands/workflow/workflows.js +1342 -0
- package/dist/commands/workflow/workstreams.js +141 -0
- package/dist/commands/workflow/worktrees.js +473 -0
- package/dist/install/cloud-env.js +819 -0
- package/dist/install/managed-block.js +182 -0
- package/dist/install/manifest.js +376 -0
- package/dist/install/modules/claude.js +288 -0
- package/dist/install/modules/cloud.js +152 -0
- package/dist/install/modules/codex.js +193 -0
- package/dist/install/modules/core.js +511 -0
- package/dist/install/modules/cursor.js +186 -0
- package/dist/install/modules/index.js +152 -0
- package/dist/install/modules/opencode.js +504 -0
- package/dist/install/placeholders.js +87 -0
- package/dist/install/template-copies.js +106 -0
- package/dist/install/version-file.js +204 -0
- package/dist/install/write.js +342 -0
- package/dist/ledgers/clamp-log.js +27 -0
- package/dist/ledgers/status.js +156 -0
- package/dist/ledgers/telemetry.js +637 -0
- package/dist/render/hosts.js +339 -0
- package/dist/render/models.js +288 -0
- package/dist/render/parts.js +33 -0
- package/dist/render/trackers.js +135 -0
- package/dist/shared/egress.js +299 -0
- package/dist/shared/json.js +16 -0
- package/dist/shared/log-prefix.js +7 -0
- package/dist/shared/package-json.js +22 -0
- package/dist/shared/package-manager.js +32 -0
- package/dist/shared/package-roots.js +145 -0
- package/dist/shared/protected-paths.js +153 -0
- package/dist/shared/settings.js +44 -0
- package/dist/shared/timeouts.js +19 -0
- package/dist/tools/wording.js +680 -0
- package/package.json +101 -4
|
@@ -0,0 +1,119 @@
|
|
|
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
|
+
|
|
4
|
+
import * as fs from "node:fs";
|
|
5
|
+
import * as path from "node:path";
|
|
6
|
+
import {
|
|
7
|
+
NPM_STRIP_REMAP,
|
|
8
|
+
getPkgRoot,
|
|
9
|
+
getTemplatesRoot,
|
|
10
|
+
TEMPLATE_COPIES_DIR,
|
|
11
|
+
} from "../shared/package-roots.js";
|
|
12
|
+
import type { WriteSet } from "./write.js";
|
|
13
|
+
|
|
14
|
+
export function listFilesRecursive(dir: string): string[] {
|
|
15
|
+
if (!fs.existsSync(dir)) return [];
|
|
16
|
+
const out: string[] = [];
|
|
17
|
+
for (const ent of fs.readdirSync(dir, { withFileTypes: true })) {
|
|
18
|
+
const p = path.join(dir, ent.name);
|
|
19
|
+
if (ent.isDirectory()) out.push(...listFilesRecursive(p));
|
|
20
|
+
else if (ent.isFile()) out.push(p);
|
|
21
|
+
}
|
|
22
|
+
return out;
|
|
23
|
+
}
|
|
24
|
+
|
|
25
|
+
// The dotfile remap: the one table lives in shared/package-roots.ts (NPM_STRIP_REMAP); the
|
|
26
|
+
// module install pass (install/modules/index.ts) and the `bkit upgrade` template walk both
|
|
27
|
+
// call this, so they never disagree about how a payload basename maps to its dest.
|
|
28
|
+
export function remapTemplateDest(rel: string): string {
|
|
29
|
+
const dir = path.dirname(rel);
|
|
30
|
+
const base = path.basename(rel);
|
|
31
|
+
const mapped = NPM_STRIP_REMAP[base];
|
|
32
|
+
if (mapped === undefined) return rel;
|
|
33
|
+
return dir === "." ? mapped : path.join(dir, mapped);
|
|
34
|
+
}
|
|
35
|
+
|
|
36
|
+
/** Template paths (relative to `.bkit/templates/`) a sync changed, added or removed. */
|
|
37
|
+
export interface TemplateCopyChanges {
|
|
38
|
+
changed: string[];
|
|
39
|
+
added: string[];
|
|
40
|
+
removed: string[];
|
|
41
|
+
}
|
|
42
|
+
|
|
43
|
+
// Copy the whole templates root from the package into the consumer's
|
|
44
|
+
// `.bkit/templates/`, raw: no token substitution, so the copy is the package bytes and
|
|
45
|
+
// `git diff .bkit/templates` on an upgrade commit is the template changelog. Byte-compares
|
|
46
|
+
// first, keeps the source mode (hooks and scripts are executable), and prunes copies that
|
|
47
|
+
// left the set. Every change pushes a ws write in dry-run and live alike, so `bkit check`
|
|
48
|
+
// flags a stale copy. No-op in dogfood: there the folder IS the package's template source.
|
|
49
|
+
export function syncTemplateCopies(
|
|
50
|
+
cwd: string,
|
|
51
|
+
opts: { dryRun: boolean; ws: WriteSet },
|
|
52
|
+
): TemplateCopyChanges {
|
|
53
|
+
const changes: TemplateCopyChanges = { changed: [], added: [], removed: [] };
|
|
54
|
+
if (path.resolve(cwd) === getPkgRoot()) return changes;
|
|
55
|
+
const srcRoot = getTemplatesRoot();
|
|
56
|
+
const dstRoot = path.join(cwd, TEMPLATE_COPIES_DIR);
|
|
57
|
+
|
|
58
|
+
const shipped = new Set<string>();
|
|
59
|
+
for (const srcPath of listFilesRecursive(srcRoot)) {
|
|
60
|
+
const rel = path.relative(srcRoot, srcPath);
|
|
61
|
+
shipped.add(rel);
|
|
62
|
+
const dstPath = path.join(dstRoot, rel);
|
|
63
|
+
const exists = fs.existsSync(dstPath);
|
|
64
|
+
if (exists && fs.readFileSync(srcPath).equals(fs.readFileSync(dstPath))) continue;
|
|
65
|
+
(exists ? changes.changed : changes.added).push(rel);
|
|
66
|
+
if (!opts.dryRun) {
|
|
67
|
+
fs.mkdirSync(path.dirname(dstPath), { recursive: true });
|
|
68
|
+
fs.copyFileSync(srcPath, dstPath);
|
|
69
|
+
fs.chmodSync(dstPath, fs.statSync(srcPath).mode);
|
|
70
|
+
}
|
|
71
|
+
opts.ws.writes.push({
|
|
72
|
+
path: path.join(TEMPLATE_COPIES_DIR, rel),
|
|
73
|
+
action: exists ? "update" : "write",
|
|
74
|
+
});
|
|
75
|
+
}
|
|
76
|
+
|
|
77
|
+
for (const dstPath of listFilesRecursive(dstRoot)) {
|
|
78
|
+
const rel = path.relative(dstRoot, dstPath);
|
|
79
|
+
if (shipped.has(rel)) continue;
|
|
80
|
+
changes.removed.push(rel);
|
|
81
|
+
if (!opts.dryRun) fs.rmSync(dstPath);
|
|
82
|
+
opts.ws.writes.push({ path: path.join(TEMPLATE_COPIES_DIR, rel), action: "update" });
|
|
83
|
+
}
|
|
84
|
+
if (!opts.dryRun) pruneEmptyDirs(dstRoot);
|
|
85
|
+
return changes;
|
|
86
|
+
}
|
|
87
|
+
|
|
88
|
+
// Remove empty folders under `root`, deepest first. `root` itself stays.
|
|
89
|
+
function pruneEmptyDirs(root: string): void {
|
|
90
|
+
if (!fs.existsSync(root)) return;
|
|
91
|
+
for (const ent of fs.readdirSync(root, { withFileTypes: true })) {
|
|
92
|
+
if (!ent.isDirectory()) continue;
|
|
93
|
+
const dir = path.join(root, ent.name);
|
|
94
|
+
pruneEmptyDirs(dir);
|
|
95
|
+
if (fs.readdirSync(dir).length === 0) fs.rmdirSync(dir);
|
|
96
|
+
}
|
|
97
|
+
}
|
|
98
|
+
|
|
99
|
+
/** One-line pointer to the template docs, shared by the install and upgrade messages. */
|
|
100
|
+
export const TEMPLATES_POINTER =
|
|
101
|
+
"Templates: see .bkit/templates.md; copies live in .bkit/templates/ (if your own gates scan the repo, ignore .bkit/templates/).";
|
|
102
|
+
|
|
103
|
+
/**
|
|
104
|
+
* The upgrade report for a template sync: one line per changed, added or removed
|
|
105
|
+
* template, then where to read about adopting them. Empty when nothing changed.
|
|
106
|
+
*/
|
|
107
|
+
export function formatTemplateChanges(changes: TemplateCopyChanges): string {
|
|
108
|
+
const lines = [
|
|
109
|
+
...changes.changed.map((p) => ` changed: ${path.join(TEMPLATE_COPIES_DIR, p)}`),
|
|
110
|
+
...changes.added.map((p) => ` added: ${path.join(TEMPLATE_COPIES_DIR, p)}`),
|
|
111
|
+
...changes.removed.map((p) => ` removed: ${path.join(TEMPLATE_COPIES_DIR, p)}`),
|
|
112
|
+
];
|
|
113
|
+
if (lines.length === 0) return "";
|
|
114
|
+
return [
|
|
115
|
+
`Templates updated (${lines.length}). bkit never applies these; diff them against your own copies and adopt what you want:`,
|
|
116
|
+
...lines,
|
|
117
|
+
TEMPLATES_POINTER,
|
|
118
|
+
].join("\n");
|
|
119
|
+
}
|
|
@@ -0,0 +1,284 @@
|
|
|
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
|
+
|
|
14
|
+
import * as fs from "node:fs";
|
|
15
|
+
import * as path from "node:path";
|
|
16
|
+
import * as crypto from "node:crypto";
|
|
17
|
+
import { parseJson } from "../shared/json.js";
|
|
18
|
+
import { getTemplatesRoot, templateRelPath } from "../shared/package-roots.js";
|
|
19
|
+
|
|
20
|
+
// ---------------------------------------------------------------------------
|
|
21
|
+
// Schema types
|
|
22
|
+
// ---------------------------------------------------------------------------
|
|
23
|
+
|
|
24
|
+
export interface BkitVersion {
|
|
25
|
+
/** Semver string of the installed bkit version, e.g. "0.7.0". */
|
|
26
|
+
pinnedVersion: string;
|
|
27
|
+
/**
|
|
28
|
+
* sha256 hex digests of ALL bkit-canonical managed files at install time.
|
|
29
|
+
*
|
|
30
|
+
* Key: consumer-relative path (e.g. ".claude/agents/bkit-foo.md")
|
|
31
|
+
* Value: sha256 hex of the bkit-written file content at install time.
|
|
32
|
+
*
|
|
33
|
+
* Used by `bkit upgrade` diff engine: if the current on-disk hash for a
|
|
34
|
+
* path differs from its canonicalHash, the consumer modified the file since
|
|
35
|
+
* install → do NOT silently overwrite during upgrade.
|
|
36
|
+
*
|
|
37
|
+
* Absent means "unknown": parses to {}, and every file reads as
|
|
38
|
+
* "consumer-modified" to the upgrade engine (no silent overwrites).
|
|
39
|
+
*/
|
|
40
|
+
canonicalHashes: Record<string, string>;
|
|
41
|
+
/**
|
|
42
|
+
* The `permissions.allow` rows bkit itself derived and wrote into
|
|
43
|
+
* `.claude/settings.json` at install time (`WebFetch(domain:…)` from
|
|
44
|
+
* `allowed-domains`, `mcp__…` from `mcp-servers`) — the provenance record that lets
|
|
45
|
+
* a later run prune a row it added without touching one the consumer added by hand.
|
|
46
|
+
*
|
|
47
|
+
* Absent means "unknown" → defaults to `[]`, i.e. bkit claims authorship of nothing
|
|
48
|
+
* and prunes nothing. That is the conservative direction: the cost is a stale row
|
|
49
|
+
* surviving, never a consumer's own row being deleted.
|
|
50
|
+
*/
|
|
51
|
+
claudeAllowDerived: string[];
|
|
52
|
+
}
|
|
53
|
+
|
|
54
|
+
// ---------------------------------------------------------------------------
|
|
55
|
+
// Parse
|
|
56
|
+
// ---------------------------------------------------------------------------
|
|
57
|
+
|
|
58
|
+
/**
|
|
59
|
+
* Parse `.bkit/version` content into a BkitVersion object. Returns null when the
|
|
60
|
+
* content is empty or is not a JSON object (treat as absent). A missing
|
|
61
|
+
* `canonicalHashes` reads as {} (every file "unknown" → no silent overwrites) and a
|
|
62
|
+
* missing `claudeAllowDerived` as [] (bkit prunes nothing).
|
|
63
|
+
*/
|
|
64
|
+
export function parseBkitVersion(content: string): BkitVersion | null {
|
|
65
|
+
const trimmed = content.trim();
|
|
66
|
+
if (!trimmed.startsWith("{")) return null;
|
|
67
|
+
const json = parseJson(trimmed);
|
|
68
|
+
if (!json.ok || typeof json.value !== "object" || json.value === null) return null;
|
|
69
|
+
const parsed = json.value as Partial<BkitVersion>;
|
|
70
|
+
const pinnedVersion = typeof parsed.pinnedVersion === "string" ? parsed.pinnedVersion : "";
|
|
71
|
+
const hashes = parsed.canonicalHashes;
|
|
72
|
+
const canonicalHashes =
|
|
73
|
+
hashes && typeof hashes === "object" && !Array.isArray(hashes) ? { ...hashes } : {};
|
|
74
|
+
const claudeAllowDerived = Array.isArray(parsed.claudeAllowDerived)
|
|
75
|
+
? parsed.claudeAllowDerived
|
|
76
|
+
: [];
|
|
77
|
+
return { pinnedVersion, canonicalHashes, claudeAllowDerived };
|
|
78
|
+
}
|
|
79
|
+
|
|
80
|
+
/**
|
|
81
|
+
* Read and parse `.bkit/version` from an absolute path.
|
|
82
|
+
* Returns null if the file is absent or content is empty.
|
|
83
|
+
*/
|
|
84
|
+
export function readBkitVersion(versionFilePath: string): BkitVersion | null {
|
|
85
|
+
if (!fs.existsSync(versionFilePath)) return null;
|
|
86
|
+
const content = fs.readFileSync(versionFilePath, "utf-8");
|
|
87
|
+
return parseBkitVersion(content);
|
|
88
|
+
}
|
|
89
|
+
|
|
90
|
+
// ---------------------------------------------------------------------------
|
|
91
|
+
// Write — serialize to JSON
|
|
92
|
+
// ---------------------------------------------------------------------------
|
|
93
|
+
|
|
94
|
+
/**
|
|
95
|
+
* Serialize a BkitVersion to JSON for writing to `.bkit/version`.
|
|
96
|
+
* Always writes pretty-printed JSON with a trailing newline, schema fields only.
|
|
97
|
+
*/
|
|
98
|
+
export function serializeBkitVersion(v: BkitVersion): string {
|
|
99
|
+
const { pinnedVersion, canonicalHashes, claudeAllowDerived } = v;
|
|
100
|
+
return JSON.stringify({ pinnedVersion, canonicalHashes, claudeAllowDerived }, null, 2) + "\n";
|
|
101
|
+
}
|
|
102
|
+
|
|
103
|
+
/**
|
|
104
|
+
* Write a BkitVersion to disk at `versionFilePath`.
|
|
105
|
+
*/
|
|
106
|
+
export function writeBkitVersion(versionFilePath: string, v: BkitVersion): void {
|
|
107
|
+
fs.mkdirSync(path.dirname(versionFilePath), { recursive: true });
|
|
108
|
+
fs.writeFileSync(versionFilePath, serializeBkitVersion(v), "utf-8");
|
|
109
|
+
}
|
|
110
|
+
|
|
111
|
+
// ---------------------------------------------------------------------------
|
|
112
|
+
// canonicalHashes helpers (P4.T4)
|
|
113
|
+
// ---------------------------------------------------------------------------
|
|
114
|
+
|
|
115
|
+
/**
|
|
116
|
+
* Decide whether a managed file has been modified by the consumer since install.
|
|
117
|
+
*
|
|
118
|
+
* Returns true (treat as consumer-modified — block silent overwrite) when:
|
|
119
|
+
* - `canonicalHashes` has a recorded hash for `relPath` and the current on-disk
|
|
120
|
+
* content hash differs from it (true drift), OR
|
|
121
|
+
* - `canonicalHashes` has no entry for `relPath` (unknown hash state); upgrade then
|
|
122
|
+
* surfaces a conflict for the consumer to resolve.
|
|
123
|
+
*
|
|
124
|
+
* Returns false (no drift — safe to upgrade) only when:
|
|
125
|
+
* - The current on-disk content matches the recorded canonical hash, OR
|
|
126
|
+
* - The file is absent (nothing to compare).
|
|
127
|
+
*
|
|
128
|
+
* `relPath`: consumer-relative path (e.g. ".claude/agents/bkit-foo.md")
|
|
129
|
+
* `absolutePath`: absolute path to the file on disk
|
|
130
|
+
* `canonicalHashes`: the hashes map from the BkitVersion record
|
|
131
|
+
*/
|
|
132
|
+
export function isConsumerModified(
|
|
133
|
+
relPath: string,
|
|
134
|
+
absolutePath: string,
|
|
135
|
+
canonicalHashes: Record<string, string>,
|
|
136
|
+
): boolean {
|
|
137
|
+
const current = hashFile(absolutePath);
|
|
138
|
+
if (!current) return false; // absent → nothing to compare
|
|
139
|
+
|
|
140
|
+
const recorded = canonicalHashes[relPath];
|
|
141
|
+
if (!recorded) return true; // unknown → treat as modified to prevent silent overwrites
|
|
142
|
+
|
|
143
|
+
return current !== recorded;
|
|
144
|
+
}
|
|
145
|
+
|
|
146
|
+
/**
|
|
147
|
+
* The merge both writers share (install's postDispatch and
|
|
148
|
+
* `updateCanonicalHashesAfterUpgrade`): fresh entries overwrite, and entries whose
|
|
149
|
+
* path is no longer on disk — or that belong to the copy-and-own template set —
|
|
150
|
+
* are dropped.
|
|
151
|
+
*
|
|
152
|
+
* A recorded hash is only ever consulted for a file that exists — drift detection
|
|
153
|
+
* reads the file, uninstall deletes it — so an entry for an absent path is dead
|
|
154
|
+
* bookkeeping, and a file recreated at that path later would be misclassified as
|
|
155
|
+
* bkit-owned. A template-set path is never a file bkit owns: install copies it
|
|
156
|
+
* byte-for-byte into `.bkit/templates/` and never writes the consumer's own copy,
|
|
157
|
+
* so it must carry no ownership hash. Retired and renamed managed files leave such
|
|
158
|
+
* entries behind, and a pure merge would preserve them forever (the
|
|
159
|
+
* `.bkit/scripts/…` entry a #507 move left and the `scripts/graphify/**` +
|
|
160
|
+
* `scripts/serena/bkit-serena-mcp.sh` entries a #489 move left are the observed
|
|
161
|
+
* cases; the latter survive the absent-path prune because the adopted copy stays on
|
|
162
|
+
* disk).
|
|
163
|
+
*
|
|
164
|
+
* `pruned` counts the dropped entries so callers can treat a prune-only merge as a
|
|
165
|
+
* change that is still worth writing.
|
|
166
|
+
*/
|
|
167
|
+
export function mergeCanonicalHashes(
|
|
168
|
+
cwd: string,
|
|
169
|
+
existing: Record<string, string>,
|
|
170
|
+
fresh: Record<string, string>,
|
|
171
|
+
): { canonicalHashes: Record<string, string>; pruned: number } {
|
|
172
|
+
const canonicalHashes: Record<string, string> = {};
|
|
173
|
+
let pruned = 0;
|
|
174
|
+
for (const [relPath, hash] of Object.entries(existing)) {
|
|
175
|
+
if (!fs.existsSync(path.join(cwd, relPath)) || isTemplateSetPath(relPath)) {
|
|
176
|
+
pruned++;
|
|
177
|
+
continue;
|
|
178
|
+
}
|
|
179
|
+
canonicalHashes[relPath] = hash;
|
|
180
|
+
}
|
|
181
|
+
return { canonicalHashes: { ...canonicalHashes, ...fresh }, pruned };
|
|
182
|
+
}
|
|
183
|
+
|
|
184
|
+
/** True when `dest` is a member of the package's copy-and-own template set. */
|
|
185
|
+
function isTemplateSetPath(dest: string): boolean {
|
|
186
|
+
return fs.existsSync(path.join(getTemplatesRoot(), templateRelPath(dest)));
|
|
187
|
+
}
|
|
188
|
+
|
|
189
|
+
// ---------------------------------------------------------------------------
|
|
190
|
+
// sha256 — content hashing for canonicalHashes
|
|
191
|
+
// ---------------------------------------------------------------------------
|
|
192
|
+
|
|
193
|
+
/**
|
|
194
|
+
* Compute the sha256 hex digest of a string or Buffer.
|
|
195
|
+
* Used to record the content of the files bkit writes.
|
|
196
|
+
*/
|
|
197
|
+
export function sha256(content: string | Buffer): string {
|
|
198
|
+
return crypto.createHash("sha256").update(content).digest("hex");
|
|
199
|
+
}
|
|
200
|
+
|
|
201
|
+
/**
|
|
202
|
+
* Read a file and return its sha256 hex digest. Returns null if absent.
|
|
203
|
+
*/
|
|
204
|
+
export function hashFile(filePath: string): string | null {
|
|
205
|
+
if (!fs.existsSync(filePath)) return null;
|
|
206
|
+
const content = fs.readFileSync(filePath);
|
|
207
|
+
return sha256(content);
|
|
208
|
+
}
|
|
209
|
+
|
|
210
|
+
// ---------------------------------------------------------------------------
|
|
211
|
+
// Managed-version marker — single source of truth for the marker every file bkit
|
|
212
|
+
// writes or refreshes carries (JSON files excepted: JSON has no comments).
|
|
213
|
+
//
|
|
214
|
+
// One marker text, wrapped in the file's comment syntax:
|
|
215
|
+
// html `<!-- bkit:managed vX.Y.Z — … -->` markdown, `.mdc`
|
|
216
|
+
// hash `# <!-- bkit:managed vX.Y.Z — … -->` shell, `.gitignore`, `.env.example`, TOML
|
|
217
|
+
// slash `// bkit:managed vX.Y.Z — …` JS (`.cjs` / `.js` / `.mjs`)
|
|
218
|
+
//
|
|
219
|
+
// The marker names the licence the bkit-written files are under (PolyForm Noncommercial
|
|
220
|
+
// or Small Business, the pair `.bkit/LICENSE.md` carries in full) and the licences-index
|
|
221
|
+
// URL, so a copy passed on in a public repo carries the terms URL with it (PolyForm's
|
|
222
|
+
// Notices section). `.bkit/LICENSE.md` is written by runBkitDocs (install/modules/core.ts).
|
|
223
|
+
//
|
|
224
|
+
// Rendered agents / commands / skills are stamped at render (stampManagedVersion);
|
|
225
|
+
// every other file carries the `{{BKIT_MANAGED_MARKER}}` token in its source, which
|
|
226
|
+
// applyTokens (install/placeholders.ts) resolves to the form its comment prefix selects. The
|
|
227
|
+
// `bkit check` gate (detectManagedStale, checks/after/index.ts) reads the stamp back
|
|
228
|
+
// with readManagedVersion.
|
|
229
|
+
// ---------------------------------------------------------------------------
|
|
230
|
+
|
|
231
|
+
/** Comment syntax a managed-version marker is written in. */
|
|
232
|
+
export type ManagedMarkerForm = "html" | "hash" | "slash";
|
|
233
|
+
|
|
234
|
+
// Matches a stamped marker line in any form (anchored at a line start) including its
|
|
235
|
+
// trailing newline, so re-stamping replaces rather than appends (idempotent). Inline
|
|
236
|
+
// prose that quotes the marker never starts a line with it, so it never matches.
|
|
237
|
+
export const MANAGED_MARKER_LINE_RE = /^(?:<!-- |# <!-- |\/\/ )bkit:managed v[^\n]*\n?/m;
|
|
238
|
+
// Extracts the stamped version. `\S+` stops at the space before the em-dash.
|
|
239
|
+
export const MANAGED_MARKER_VERSION_RE = /bkit:managed v(\S+)/;
|
|
240
|
+
|
|
241
|
+
/** Build the managed-version marker for a given version, in the given comment syntax. */
|
|
242
|
+
export function managedVersionMarker(version: string, form: ManagedMarkerForm = "html"): string {
|
|
243
|
+
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`;
|
|
244
|
+
if (form === "slash") return `// ${text}`;
|
|
245
|
+
return form === "hash" ? `# <!-- ${text} -->` : `<!-- ${text} -->`;
|
|
246
|
+
}
|
|
247
|
+
|
|
248
|
+
/** Version of the first full-line managed-version marker in `content`, or null when none. */
|
|
249
|
+
export function readManagedVersion(content: string): string | null {
|
|
250
|
+
const line = content.match(MANAGED_MARKER_LINE_RE)?.[0];
|
|
251
|
+
return line?.match(MANAGED_MARKER_VERSION_RE)?.[1] ?? null;
|
|
252
|
+
}
|
|
253
|
+
|
|
254
|
+
/**
|
|
255
|
+
* Insert (or replace) the managed-version marker immediately after the rendered
|
|
256
|
+
* file's frontmatter fence, always followed by exactly one blank line. Idempotent:
|
|
257
|
+
* any existing marker is stripped first and leading body blanks are collapsed, so
|
|
258
|
+
* stamping the same content twice yields identical bytes. With no frontmatter (e.g.
|
|
259
|
+
* cursor/opencode commands whose transforms strip the frontmatter), the marker sinks
|
|
260
|
+
* below the content's first Markdown heading instead, so it never becomes the
|
|
261
|
+
* IDE-visible first line; falls back to a top prepend only when there is no heading
|
|
262
|
+
* either, also followed by a blank line.
|
|
263
|
+
*/
|
|
264
|
+
export function stampManagedVersion(content: string, version: string): string {
|
|
265
|
+
const stripped = content.replace(MANAGED_MARKER_LINE_RE, "");
|
|
266
|
+
const marker = managedVersionMarker(version);
|
|
267
|
+
const fm = stripped.match(/^---\n[\s\S]*?\n---\n/);
|
|
268
|
+
if (fm) {
|
|
269
|
+
const cut = fm[0].length;
|
|
270
|
+
const body = stripped.slice(cut).replace(/^\n+/, "");
|
|
271
|
+
return stripped.slice(0, cut) + marker + "\n\n" + body;
|
|
272
|
+
}
|
|
273
|
+
// No frontmatter — the cursor/opencode command transforms remove it (applyT1 /
|
|
274
|
+
// applyOpencodeCommand). A marker on line 1 would be the IDE-visible command
|
|
275
|
+
// description, so it sinks below the first heading when there is one.
|
|
276
|
+
const heading = stripped.match(/^#{1,6} .*$/m);
|
|
277
|
+
if (heading?.index !== undefined) {
|
|
278
|
+
const cut = heading.index + heading[0].length;
|
|
279
|
+
const head = stripped.slice(0, cut);
|
|
280
|
+
const rest = stripped.slice(cut).replace(/^\n+/, "");
|
|
281
|
+
return rest ? `${head}\n\n${marker}\n\n${rest}` : `${head}\n\n${marker}\n`;
|
|
282
|
+
}
|
|
283
|
+
return marker + "\n\n" + stripped.replace(/^\n+/, "");
|
|
284
|
+
}
|