@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,467 @@
|
|
|
1
|
+
import * as fs from "node:fs";
|
|
2
|
+
import * as path from "node:path";
|
|
3
|
+
import {
|
|
4
|
+
updateManagedBlock,
|
|
5
|
+
extractFullManagedBlock,
|
|
6
|
+
extractManagedBlock,
|
|
7
|
+
findLineAnchoredMarkers,
|
|
8
|
+
selectMarkers,
|
|
9
|
+
type MarkerStyle,
|
|
10
|
+
} from "./managed-block.js";
|
|
11
|
+
import { readTemplate } from "../render/parts.js";
|
|
12
|
+
import { applyTokens, type TokenMap } from "./placeholders.js";
|
|
13
|
+
|
|
14
|
+
// ---------------------------------------------------------------------------
|
|
15
|
+
// JsonValue — generic JSON type used throughout Tier-2 JSON helpers
|
|
16
|
+
// ---------------------------------------------------------------------------
|
|
17
|
+
|
|
18
|
+
export type JsonValue = string | number | boolean | null | JsonValue[] | { [k: string]: JsonValue };
|
|
19
|
+
|
|
20
|
+
// ---------------------------------------------------------------------------
|
|
21
|
+
// deepContains — deep-containment check (BAR-167 Phase 1)
|
|
22
|
+
//
|
|
23
|
+
// Returns { ok, missing, mismatched } where:
|
|
24
|
+
// ok — true if every path in `template` is present and equal in `consumer`
|
|
25
|
+
// missing — paths present in template but absent from consumer
|
|
26
|
+
// mismatched — paths present in both but with incompatible values
|
|
27
|
+
//
|
|
28
|
+
// Semantics:
|
|
29
|
+
// - Objects: for each key in template, consumer must have the same key with a
|
|
30
|
+
// deep-containing value. Consumer may have extra keys (superset is ok).
|
|
31
|
+
// - Arrays of primitives: template elements must all appear in consumer (subset semantics).
|
|
32
|
+
// - Arrays of objects: for each template element, at least one consumer element must
|
|
33
|
+
// deep-equal it (order-insensitive, asymmetric-size ok: consumer may have more).
|
|
34
|
+
// - Mixed arrays: element-wise containment by type.
|
|
35
|
+
// - Leaf primitives / null: exact equality required.
|
|
36
|
+
// - null template at any path → ok (template owns "nothing").
|
|
37
|
+
// - non-null template, null consumer → missing path.
|
|
38
|
+
// ---------------------------------------------------------------------------
|
|
39
|
+
|
|
40
|
+
export interface DeepContainsResult {
|
|
41
|
+
ok: boolean;
|
|
42
|
+
missing: string[];
|
|
43
|
+
mismatched: string[];
|
|
44
|
+
}
|
|
45
|
+
|
|
46
|
+
export function deepContains(
|
|
47
|
+
template: JsonValue,
|
|
48
|
+
consumer: JsonValue,
|
|
49
|
+
pathPrefix = "",
|
|
50
|
+
): DeepContainsResult {
|
|
51
|
+
const missing: string[] = [];
|
|
52
|
+
const mismatched: string[] = [];
|
|
53
|
+
|
|
54
|
+
// null template: owns nothing → ok
|
|
55
|
+
if (template === null) {
|
|
56
|
+
return { ok: true, missing, mismatched };
|
|
57
|
+
}
|
|
58
|
+
|
|
59
|
+
// non-null template, null consumer → missing
|
|
60
|
+
if (consumer === null) {
|
|
61
|
+
missing.push(pathPrefix || "<root>");
|
|
62
|
+
return { ok: false, missing, mismatched };
|
|
63
|
+
}
|
|
64
|
+
|
|
65
|
+
// Both are arrays
|
|
66
|
+
if (Array.isArray(template) && Array.isArray(consumer)) {
|
|
67
|
+
_deepContainsArray(template, consumer, pathPrefix, missing);
|
|
68
|
+
return { ok: missing.length === 0 && mismatched.length === 0, missing, mismatched };
|
|
69
|
+
}
|
|
70
|
+
|
|
71
|
+
// Type mismatch (one is array, other is not, or different primitive types)
|
|
72
|
+
if (Array.isArray(template) !== Array.isArray(consumer)) {
|
|
73
|
+
mismatched.push(pathPrefix || "<root>");
|
|
74
|
+
return { ok: false, missing, mismatched };
|
|
75
|
+
}
|
|
76
|
+
|
|
77
|
+
// Both are plain objects
|
|
78
|
+
if (typeof template === "object" && typeof consumer === "object") {
|
|
79
|
+
const tObj = template as Record<string, JsonValue>;
|
|
80
|
+
const cObj = consumer as Record<string, JsonValue>;
|
|
81
|
+
for (const key of Object.keys(tObj)) {
|
|
82
|
+
const childPath = pathPrefix ? `${pathPrefix}.${key}` : key;
|
|
83
|
+
const tVal = tObj[key]!;
|
|
84
|
+
const cVal = cObj[key];
|
|
85
|
+
if (cVal === undefined) {
|
|
86
|
+
// If template has null for this key, still ok
|
|
87
|
+
if (tVal === null) continue;
|
|
88
|
+
missing.push(childPath);
|
|
89
|
+
} else {
|
|
90
|
+
const sub = deepContains(tVal, cVal, childPath);
|
|
91
|
+
missing.push(...sub.missing);
|
|
92
|
+
mismatched.push(...sub.mismatched);
|
|
93
|
+
}
|
|
94
|
+
}
|
|
95
|
+
return { ok: missing.length === 0 && mismatched.length === 0, missing, mismatched };
|
|
96
|
+
}
|
|
97
|
+
|
|
98
|
+
// Both are primitives — exact equality
|
|
99
|
+
if (template !== consumer) {
|
|
100
|
+
mismatched.push(pathPrefix || "<root>");
|
|
101
|
+
return { ok: false, missing, mismatched };
|
|
102
|
+
}
|
|
103
|
+
|
|
104
|
+
return { ok: true, missing, mismatched };
|
|
105
|
+
}
|
|
106
|
+
|
|
107
|
+
function _deepContainsArray(
|
|
108
|
+
template: JsonValue[],
|
|
109
|
+
consumer: JsonValue[],
|
|
110
|
+
pathPrefix: string,
|
|
111
|
+
missing: string[],
|
|
112
|
+
): void {
|
|
113
|
+
// Classify template elements as primitive or object
|
|
114
|
+
for (let i = 0; i < template.length; i++) {
|
|
115
|
+
const tEl = template[i]!;
|
|
116
|
+
const elPath = pathPrefix ? `${pathPrefix}[${i}]` : `[${i}]`;
|
|
117
|
+
|
|
118
|
+
if (tEl === null || typeof tEl !== "object") {
|
|
119
|
+
// Primitive — subset: consumer must contain this value
|
|
120
|
+
if (!consumer.includes(tEl)) {
|
|
121
|
+
missing.push(elPath);
|
|
122
|
+
}
|
|
123
|
+
} else if (Array.isArray(tEl)) {
|
|
124
|
+
// Nested array element — must find an equal consumer element
|
|
125
|
+
const found = consumer.some((cEl) => Array.isArray(cEl) && deepContains(tEl, cEl, "").ok);
|
|
126
|
+
if (!found) {
|
|
127
|
+
missing.push(elPath);
|
|
128
|
+
}
|
|
129
|
+
} else {
|
|
130
|
+
// Object element — order-insensitive deep-equal containment
|
|
131
|
+
const found = consumer.some(
|
|
132
|
+
(cEl) =>
|
|
133
|
+
cEl !== null &&
|
|
134
|
+
typeof cEl === "object" &&
|
|
135
|
+
!Array.isArray(cEl) &&
|
|
136
|
+
deepContains(tEl, cEl, "").ok,
|
|
137
|
+
);
|
|
138
|
+
if (!found) {
|
|
139
|
+
missing.push(elPath);
|
|
140
|
+
}
|
|
141
|
+
}
|
|
142
|
+
}
|
|
143
|
+
}
|
|
144
|
+
|
|
145
|
+
// ---------------------------------------------------------------------------
|
|
146
|
+
// deepMergeJson — recursive JSON merge primitive (P3.T1)
|
|
147
|
+
//
|
|
148
|
+
// Semantics (from DE-8 contract spec):
|
|
149
|
+
// - Objects: merge recursively (override keys win; base keys retained if absent from override)
|
|
150
|
+
// - Arrays: override replaces base (no concat — arrays are treated as atomic values)
|
|
151
|
+
// - Primitives / null: override replaces base
|
|
152
|
+
// ---------------------------------------------------------------------------
|
|
153
|
+
|
|
154
|
+
export function deepMergeJson(base: JsonValue, override: JsonValue): JsonValue {
|
|
155
|
+
if (override === null || typeof override !== "object" || Array.isArray(override)) {
|
|
156
|
+
return override;
|
|
157
|
+
}
|
|
158
|
+
if (base === null || typeof base !== "object" || Array.isArray(base)) {
|
|
159
|
+
// base is not a plain object — override wins wholesale
|
|
160
|
+
return override;
|
|
161
|
+
}
|
|
162
|
+
// Both are plain objects — recursive merge.
|
|
163
|
+
//
|
|
164
|
+
// Key ORDER follows `override` (the bkit template) for keys it defines, then appends
|
|
165
|
+
// base-only (consumer) keys. Order-significant maps like opencode's last-match-wins
|
|
166
|
+
// `permission.bash` keep the template's order (`git push --force-with-lease*: allow`
|
|
167
|
+
// stays after `git push --force*: deny`).
|
|
168
|
+
const baseObj = base as { [k: string]: JsonValue };
|
|
169
|
+
const overrideObj = override as { [k: string]: JsonValue };
|
|
170
|
+
const result: { [k: string]: JsonValue } = {};
|
|
171
|
+
// 1. Template keys first, in template order (recurse where both sides are plain objects).
|
|
172
|
+
for (const [key, val] of Object.entries(overrideObj)) {
|
|
173
|
+
const baseVal = baseObj[key];
|
|
174
|
+
if (
|
|
175
|
+
key in baseObj &&
|
|
176
|
+
baseVal !== null &&
|
|
177
|
+
typeof baseVal === "object" &&
|
|
178
|
+
!Array.isArray(baseVal) &&
|
|
179
|
+
val !== null &&
|
|
180
|
+
typeof val === "object" &&
|
|
181
|
+
!Array.isArray(val)
|
|
182
|
+
) {
|
|
183
|
+
result[key] = deepMergeJson(baseVal, val);
|
|
184
|
+
} else {
|
|
185
|
+
result[key] = val;
|
|
186
|
+
}
|
|
187
|
+
}
|
|
188
|
+
// 2. Consumer-only keys preserved, appended after the template's keys.
|
|
189
|
+
for (const [key, val] of Object.entries(baseObj)) {
|
|
190
|
+
if (!(key in result)) {
|
|
191
|
+
result[key] = val;
|
|
192
|
+
}
|
|
193
|
+
}
|
|
194
|
+
return result;
|
|
195
|
+
}
|
|
196
|
+
|
|
197
|
+
// ---------------------------------------------------------------------------
|
|
198
|
+
// writeTier2JsonContained — deep-containment JSON helper (BAR-167 Phase 1)
|
|
199
|
+
//
|
|
200
|
+
// Contract:
|
|
201
|
+
// - dest absent → write template as-is (first install)
|
|
202
|
+
// - dest present, valid JSON, template contained → no-op (idempotent)
|
|
203
|
+
// - dest present, valid JSON, containment fails → deepMergeJson(existing, template)
|
|
204
|
+
// (template wins on key collisions; consumer-only keys outside template tree preserved)
|
|
205
|
+
// - dest present, malformed JSON → overwrite with template
|
|
206
|
+
// - schemaFlipped: true when a path value changed type during deep-merge
|
|
207
|
+
// ---------------------------------------------------------------------------
|
|
208
|
+
|
|
209
|
+
export function writeTier2JsonContained(
|
|
210
|
+
srcPath: string,
|
|
211
|
+
dstPath: string,
|
|
212
|
+
dryRun: boolean,
|
|
213
|
+
ws: WriteSet,
|
|
214
|
+
): void {
|
|
215
|
+
const srcRaw = fs.readFileSync(srcPath, "utf-8");
|
|
216
|
+
let template: Record<string, JsonValue>;
|
|
217
|
+
try {
|
|
218
|
+
template = JSON.parse(srcRaw) as Record<string, JsonValue>;
|
|
219
|
+
} catch {
|
|
220
|
+
throw new Error(`writeTier2JsonContained: template at ${srcPath} is not valid JSON`);
|
|
221
|
+
}
|
|
222
|
+
|
|
223
|
+
if (!fs.existsSync(dstPath)) {
|
|
224
|
+
// First install — write template as-is
|
|
225
|
+
ensureDir(path.dirname(dstPath));
|
|
226
|
+
if (!dryRun) {
|
|
227
|
+
fs.writeFileSync(dstPath, JSON.stringify(template, null, 2) + "\n", "utf-8");
|
|
228
|
+
const srcMode = fs.statSync(srcPath).mode;
|
|
229
|
+
fs.chmodSync(dstPath, srcMode);
|
|
230
|
+
}
|
|
231
|
+
ws.writes.push({ path: dstPath, action: "write" });
|
|
232
|
+
return;
|
|
233
|
+
}
|
|
234
|
+
|
|
235
|
+
// dest exists — read and check containment
|
|
236
|
+
const dstRaw = fs.readFileSync(dstPath, "utf-8");
|
|
237
|
+
let existing: Record<string, JsonValue>;
|
|
238
|
+
try {
|
|
239
|
+
existing = JSON.parse(dstRaw) as Record<string, JsonValue>;
|
|
240
|
+
} catch {
|
|
241
|
+
// Malformed destination — refuse to overwrite; require manual fix (matches malformed-package-json blocker discipline)
|
|
242
|
+
throw new Error(
|
|
243
|
+
`[bkit] ${dstPath} is malformed JSON — fix manually before running bkit install`,
|
|
244
|
+
);
|
|
245
|
+
}
|
|
246
|
+
|
|
247
|
+
// Check if existing already contains the template
|
|
248
|
+
const containsResult = deepContains(template as JsonValue, existing as JsonValue);
|
|
249
|
+
if (containsResult.ok) {
|
|
250
|
+
return; // idempotent — no change needed
|
|
251
|
+
}
|
|
252
|
+
|
|
253
|
+
// Deep-merge: existing base, template override (template wins on conflicts)
|
|
254
|
+
const merged = deepMergeJson(existing as JsonValue, template as JsonValue);
|
|
255
|
+
const mergedStr = JSON.stringify(merged, null, 2) + "\n";
|
|
256
|
+
if (mergedStr === dstRaw) return; // idempotent guard
|
|
257
|
+
|
|
258
|
+
if (!dryRun) {
|
|
259
|
+
fs.writeFileSync(dstPath, mergedStr, "utf-8");
|
|
260
|
+
}
|
|
261
|
+
ws.writes.push({ path: dstPath, action: "update" });
|
|
262
|
+
}
|
|
263
|
+
|
|
264
|
+
// ---------------------------------------------------------------------------
|
|
265
|
+
// Internal helpers
|
|
266
|
+
// ---------------------------------------------------------------------------
|
|
267
|
+
|
|
268
|
+
export function ensureDir(dir: string): void {
|
|
269
|
+
fs.mkdirSync(dir, { recursive: true });
|
|
270
|
+
}
|
|
271
|
+
|
|
272
|
+
// ---------------------------------------------------------------------------
|
|
273
|
+
// fully-managed format — idempotent rewrite of whole file after token substitution
|
|
274
|
+
//
|
|
275
|
+
// Semantics: always writes the src content (with tokens applied) to dst.
|
|
276
|
+
// If dst exists with identical content, no-op (no double-count in WriteSet).
|
|
277
|
+
// ---------------------------------------------------------------------------
|
|
278
|
+
|
|
279
|
+
export function writeTier1(
|
|
280
|
+
srcPath: string,
|
|
281
|
+
dstPath: string,
|
|
282
|
+
tokens: TokenMap,
|
|
283
|
+
dryRun: boolean,
|
|
284
|
+
ws: WriteSet,
|
|
285
|
+
): void {
|
|
286
|
+
const srcRaw = readTemplate(srcPath);
|
|
287
|
+
const srcContent = applyTokens(srcRaw, tokens);
|
|
288
|
+
|
|
289
|
+
if (fs.existsSync(dstPath)) {
|
|
290
|
+
const existing = fs.readFileSync(dstPath, "utf-8");
|
|
291
|
+
if (existing === srcContent) return; // identical — no-op
|
|
292
|
+
}
|
|
293
|
+
|
|
294
|
+
ensureDir(path.dirname(dstPath));
|
|
295
|
+
if (!dryRun) {
|
|
296
|
+
fs.writeFileSync(dstPath, srcContent, "utf-8");
|
|
297
|
+
// Preserve executable bit from src
|
|
298
|
+
const srcMode = fs.statSync(srcPath).mode;
|
|
299
|
+
fs.chmodSync(dstPath, srcMode);
|
|
300
|
+
}
|
|
301
|
+
|
|
302
|
+
ws.writes.push({ path: dstPath, action: "write" });
|
|
303
|
+
}
|
|
304
|
+
|
|
305
|
+
// ---------------------------------------------------------------------------
|
|
306
|
+
// markered-text format — managed-block (bkit owns content between markers; consumer owns rest)
|
|
307
|
+
//
|
|
308
|
+
// Semantics:
|
|
309
|
+
// - dest absent → write whole file (with token substitution)
|
|
310
|
+
// - dest has markers → update only the bkit block (tokens applied to new block content)
|
|
311
|
+
// - dest present, no marks → append full block at EOF; preserve consumer content above
|
|
312
|
+
//
|
|
313
|
+
// markerStyle: "html-comment" for markdown, shell and `.gitignore` (`# ` prefix allowed);
|
|
314
|
+
// "slash-comment" for JS.
|
|
315
|
+
// ---------------------------------------------------------------------------
|
|
316
|
+
|
|
317
|
+
export function writeTier2(
|
|
318
|
+
srcPath: string,
|
|
319
|
+
dstPath: string,
|
|
320
|
+
tokens: TokenMap,
|
|
321
|
+
markerStyle: MarkerStyle,
|
|
322
|
+
dryRun: boolean,
|
|
323
|
+
ws: WriteSet,
|
|
324
|
+
): void {
|
|
325
|
+
const srcRaw = readTemplate(srcPath);
|
|
326
|
+
|
|
327
|
+
if (!fs.existsSync(dstPath)) {
|
|
328
|
+
// dest missing → write whole template (with tokens applied)
|
|
329
|
+
const content = applyTokens(srcRaw, tokens);
|
|
330
|
+
ensureDir(path.dirname(dstPath));
|
|
331
|
+
if (!dryRun) {
|
|
332
|
+
fs.writeFileSync(dstPath, content, "utf-8");
|
|
333
|
+
const srcMode = fs.statSync(srcPath).mode;
|
|
334
|
+
fs.chmodSync(dstPath, srcMode);
|
|
335
|
+
}
|
|
336
|
+
ws.writes.push({ path: dstPath, action: "write" });
|
|
337
|
+
return;
|
|
338
|
+
}
|
|
339
|
+
|
|
340
|
+
const destContent = fs.readFileSync(dstPath, "utf-8");
|
|
341
|
+
const fullBlock = extractFullManagedBlock(srcRaw, markerStyle);
|
|
342
|
+
|
|
343
|
+
if (fullBlock === null) {
|
|
344
|
+
// Template has no block for this marker style — nothing to manage
|
|
345
|
+
return;
|
|
346
|
+
}
|
|
347
|
+
|
|
348
|
+
// Check if dest already has markers
|
|
349
|
+
const blockContent = extractManagedBlock(destContent, markerStyle);
|
|
350
|
+
|
|
351
|
+
if (blockContent === null) {
|
|
352
|
+
// extractManagedBlock returns null for BOTH "no markers" and "ambiguous markers"
|
|
353
|
+
// (duplicates / inverted). Only the former should append — appending on the latter
|
|
354
|
+
// compounds corruption (dogfood docs grew a second stamped block every install).
|
|
355
|
+
const [startMarker, endMarker] = selectMarkers(markerStyle);
|
|
356
|
+
const starts = findLineAnchoredMarkers(destContent, startMarker);
|
|
357
|
+
const ends = findLineAnchoredMarkers(destContent, endMarker);
|
|
358
|
+
if (starts.length > 0 || ends.length > 0) {
|
|
359
|
+
console.warn(
|
|
360
|
+
`[bkit] Managed block markers present but unparseable in ${dstPath} — skipping (expected exactly one start/end)`,
|
|
361
|
+
);
|
|
362
|
+
return;
|
|
363
|
+
}
|
|
364
|
+
|
|
365
|
+
// dest has no markers → append full block at EOF (with tokens applied)
|
|
366
|
+
const appliedBlock = applyTokens(fullBlock, tokens);
|
|
367
|
+
const sep =
|
|
368
|
+
destContent.length === 0
|
|
369
|
+
? ""
|
|
370
|
+
: destContent.endsWith("\n\n")
|
|
371
|
+
? ""
|
|
372
|
+
: destContent.endsWith("\n")
|
|
373
|
+
? "\n"
|
|
374
|
+
: "\n\n";
|
|
375
|
+
const tail = appliedBlock.endsWith("\n") ? "" : "\n";
|
|
376
|
+
if (!dryRun) {
|
|
377
|
+
fs.writeFileSync(dstPath, destContent + sep + appliedBlock + tail, "utf-8");
|
|
378
|
+
}
|
|
379
|
+
ws.writes.push({ path: dstPath, action: "append" });
|
|
380
|
+
return;
|
|
381
|
+
}
|
|
382
|
+
|
|
383
|
+
// dest has markers → update managed block with new content (tokens applied)
|
|
384
|
+
const newBlockContent = extractManagedBlock(srcRaw, markerStyle);
|
|
385
|
+
if (newBlockContent === null) return;
|
|
386
|
+
|
|
387
|
+
const appliedNewContent = applyTokens(newBlockContent, tokens);
|
|
388
|
+
if (updateManagedBlock(dstPath, appliedNewContent, dryRun, markerStyle)) {
|
|
389
|
+
ws.writes.push({ path: dstPath, action: "update" });
|
|
390
|
+
}
|
|
391
|
+
}
|
|
392
|
+
|
|
393
|
+
// ---------------------------------------------------------------------------
|
|
394
|
+
// Managed package.json scripts — add-if-missing with consumer ownership
|
|
395
|
+
//
|
|
396
|
+
// Semantics:
|
|
397
|
+
// - File absent → no-op, returns missingPkg: true
|
|
398
|
+
// - File malformed JSON → no-op, returns malformed: true
|
|
399
|
+
// - script key absent → add with default value (recorded as one update)
|
|
400
|
+
// - script key exists → preserve consumer value (never overwrite)
|
|
401
|
+
//
|
|
402
|
+
// One WriteSet entry per call when any script was added. Drift
|
|
403
|
+
// surfaces in `bkit check` because `dryRun=true` still pushes to ws.writes.
|
|
404
|
+
// ---------------------------------------------------------------------------
|
|
405
|
+
|
|
406
|
+
export function ensurePackageJsonScripts(
|
|
407
|
+
scripts: Record<string, string>,
|
|
408
|
+
dryRun: boolean,
|
|
409
|
+
ws: WriteSet,
|
|
410
|
+
): {
|
|
411
|
+
added: string[];
|
|
412
|
+
preserved: string[];
|
|
413
|
+
missingPkg: boolean;
|
|
414
|
+
malformed: boolean;
|
|
415
|
+
} {
|
|
416
|
+
const pkgPath = "package.json";
|
|
417
|
+
if (!fs.existsSync(pkgPath)) {
|
|
418
|
+
return { added: [], preserved: [], missingPkg: true, malformed: false };
|
|
419
|
+
}
|
|
420
|
+
const raw = fs.readFileSync(pkgPath, "utf-8");
|
|
421
|
+
let pkg: Record<string, unknown>;
|
|
422
|
+
try {
|
|
423
|
+
pkg = JSON.parse(raw) as Record<string, unknown>;
|
|
424
|
+
} catch {
|
|
425
|
+
return { added: [], preserved: [], missingPkg: false, malformed: true };
|
|
426
|
+
}
|
|
427
|
+
|
|
428
|
+
let pkgScripts = (pkg.scripts as Record<string, string> | undefined) ?? undefined;
|
|
429
|
+
const added: string[] = [];
|
|
430
|
+
const preserved: string[] = [];
|
|
431
|
+
|
|
432
|
+
for (const [name, value] of Object.entries(scripts)) {
|
|
433
|
+
if (pkgScripts && Object.prototype.hasOwnProperty.call(pkgScripts, name)) {
|
|
434
|
+
preserved.push(name);
|
|
435
|
+
} else {
|
|
436
|
+
if (!pkgScripts) {
|
|
437
|
+
pkgScripts = {};
|
|
438
|
+
pkg.scripts = pkgScripts;
|
|
439
|
+
}
|
|
440
|
+
pkgScripts[name] = value;
|
|
441
|
+
added.push(name);
|
|
442
|
+
}
|
|
443
|
+
}
|
|
444
|
+
|
|
445
|
+
if (added.length > 0) {
|
|
446
|
+
ws.writes.push({ path: pkgPath, action: "update" });
|
|
447
|
+
if (!dryRun) {
|
|
448
|
+
// Preserve indent style and trailing newline of the original file.
|
|
449
|
+
const indentMatch = raw.match(/\n([ \t]+)"/);
|
|
450
|
+
const indent = indentMatch ? indentMatch[1] : " ";
|
|
451
|
+
const trailingNewline = raw.endsWith("\n") ? "\n" : "";
|
|
452
|
+
fs.writeFileSync(pkgPath, JSON.stringify(pkg, null, indent) + trailingNewline, "utf-8");
|
|
453
|
+
}
|
|
454
|
+
}
|
|
455
|
+
return { added, preserved, missingPkg: false, malformed: false };
|
|
456
|
+
}
|
|
457
|
+
|
|
458
|
+
// Shared WriteSet accumulator — both check and install paths populate this identically,
|
|
459
|
+
// ensuring parity by construction (eliminates future dry-run divergence).
|
|
460
|
+
export interface WriteEntry {
|
|
461
|
+
path: string;
|
|
462
|
+
action: "write" | "update" | "append";
|
|
463
|
+
}
|
|
464
|
+
|
|
465
|
+
export interface WriteSet {
|
|
466
|
+
writes: WriteEntry[];
|
|
467
|
+
}
|
|
@@ -0,0 +1,32 @@
|
|
|
1
|
+
// The clamp record log: one JSON line per artifact `bkit context clamp` trimmed,
|
|
2
|
+
// read back into the step's status row (`clamped`) by `bkit context finalise` and
|
|
3
|
+
// `bkit steps finish --clamp-log`. Lives outside commands/workflow so both read it
|
|
4
|
+
// without importing each other.
|
|
5
|
+
|
|
6
|
+
import * as fs from "node:fs";
|
|
7
|
+
import * as path from "node:path";
|
|
8
|
+
|
|
9
|
+
import { git, parseJson } from "../commands/lib.js";
|
|
10
|
+
|
|
11
|
+
/** `tmp/bkit-clamp-{fid}-{step}[-{attempt}].jsonl` in the checkout `cwd` sits in. */
|
|
12
|
+
export function clampLogPath(cwd: string, fid: string, step: string, attempt?: number): string {
|
|
13
|
+
const top = git(cwd, ["rev-parse", "--show-toplevel"]) ?? cwd;
|
|
14
|
+
return path.join(top, "tmp", `bkit-clamp-${fid}-${step}${attempt ? `-${attempt}` : ""}.jsonl`);
|
|
15
|
+
}
|
|
16
|
+
|
|
17
|
+
/** Every record in the log; reading never drains it, so a retried status block sees the same array. */
|
|
18
|
+
export function readRecords(
|
|
19
|
+
log: string,
|
|
20
|
+
onBad: (line: string) => void = () => undefined,
|
|
21
|
+
): unknown[] {
|
|
22
|
+
if (!fs.existsSync(log)) return [];
|
|
23
|
+
return fs
|
|
24
|
+
.readFileSync(log, "utf-8")
|
|
25
|
+
.split("\n")
|
|
26
|
+
.filter((l) => l.trim() !== "")
|
|
27
|
+
.flatMap((l) => {
|
|
28
|
+
const parsed = parseJson(l);
|
|
29
|
+
if (!parsed.ok) onBad(l);
|
|
30
|
+
return parsed.ok ? [parsed.value] : [];
|
|
31
|
+
});
|
|
32
|
+
}
|