@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,342 @@
|
|
|
1
|
+
import * as fs from "node:fs";
|
|
2
|
+
import * as path from "node:path";
|
|
3
|
+
import { updateManagedBlock, extractFullManagedBlock, extractManagedBlock, findLineAnchoredMarkers, selectMarkers, } from "./managed-block.js";
|
|
4
|
+
import { readTemplate } from "../render/parts.js";
|
|
5
|
+
import { applyTokens } from "./placeholders.js";
|
|
6
|
+
export function deepContains(template, consumer, pathPrefix = "") {
|
|
7
|
+
const missing = [];
|
|
8
|
+
const mismatched = [];
|
|
9
|
+
// null template: owns nothing → ok
|
|
10
|
+
if (template === null) {
|
|
11
|
+
return { ok: true, missing, mismatched };
|
|
12
|
+
}
|
|
13
|
+
// non-null template, null consumer → missing
|
|
14
|
+
if (consumer === null) {
|
|
15
|
+
missing.push(pathPrefix || "<root>");
|
|
16
|
+
return { ok: false, missing, mismatched };
|
|
17
|
+
}
|
|
18
|
+
// Both are arrays
|
|
19
|
+
if (Array.isArray(template) && Array.isArray(consumer)) {
|
|
20
|
+
_deepContainsArray(template, consumer, pathPrefix, missing);
|
|
21
|
+
return { ok: missing.length === 0 && mismatched.length === 0, missing, mismatched };
|
|
22
|
+
}
|
|
23
|
+
// Type mismatch (one is array, other is not, or different primitive types)
|
|
24
|
+
if (Array.isArray(template) !== Array.isArray(consumer)) {
|
|
25
|
+
mismatched.push(pathPrefix || "<root>");
|
|
26
|
+
return { ok: false, missing, mismatched };
|
|
27
|
+
}
|
|
28
|
+
// Both are plain objects
|
|
29
|
+
if (typeof template === "object" && typeof consumer === "object") {
|
|
30
|
+
const tObj = template;
|
|
31
|
+
const cObj = consumer;
|
|
32
|
+
for (const key of Object.keys(tObj)) {
|
|
33
|
+
const childPath = pathPrefix ? `${pathPrefix}.${key}` : key;
|
|
34
|
+
const tVal = tObj[key];
|
|
35
|
+
const cVal = cObj[key];
|
|
36
|
+
if (cVal === undefined) {
|
|
37
|
+
// If template has null for this key, still ok
|
|
38
|
+
if (tVal === null)
|
|
39
|
+
continue;
|
|
40
|
+
missing.push(childPath);
|
|
41
|
+
}
|
|
42
|
+
else {
|
|
43
|
+
const sub = deepContains(tVal, cVal, childPath);
|
|
44
|
+
missing.push(...sub.missing);
|
|
45
|
+
mismatched.push(...sub.mismatched);
|
|
46
|
+
}
|
|
47
|
+
}
|
|
48
|
+
return { ok: missing.length === 0 && mismatched.length === 0, missing, mismatched };
|
|
49
|
+
}
|
|
50
|
+
// Both are primitives — exact equality
|
|
51
|
+
if (template !== consumer) {
|
|
52
|
+
mismatched.push(pathPrefix || "<root>");
|
|
53
|
+
return { ok: false, missing, mismatched };
|
|
54
|
+
}
|
|
55
|
+
return { ok: true, missing, mismatched };
|
|
56
|
+
}
|
|
57
|
+
function _deepContainsArray(template, consumer, pathPrefix, missing) {
|
|
58
|
+
// Classify template elements as primitive or object
|
|
59
|
+
for (let i = 0; i < template.length; i++) {
|
|
60
|
+
const tEl = template[i];
|
|
61
|
+
const elPath = pathPrefix ? `${pathPrefix}[${i}]` : `[${i}]`;
|
|
62
|
+
if (tEl === null || typeof tEl !== "object") {
|
|
63
|
+
// Primitive — subset: consumer must contain this value
|
|
64
|
+
if (!consumer.includes(tEl)) {
|
|
65
|
+
missing.push(elPath);
|
|
66
|
+
}
|
|
67
|
+
}
|
|
68
|
+
else if (Array.isArray(tEl)) {
|
|
69
|
+
// Nested array element — must find an equal consumer element
|
|
70
|
+
const found = consumer.some((cEl) => Array.isArray(cEl) && deepContains(tEl, cEl, "").ok);
|
|
71
|
+
if (!found) {
|
|
72
|
+
missing.push(elPath);
|
|
73
|
+
}
|
|
74
|
+
}
|
|
75
|
+
else {
|
|
76
|
+
// Object element — order-insensitive deep-equal containment
|
|
77
|
+
const found = consumer.some((cEl) => cEl !== null &&
|
|
78
|
+
typeof cEl === "object" &&
|
|
79
|
+
!Array.isArray(cEl) &&
|
|
80
|
+
deepContains(tEl, cEl, "").ok);
|
|
81
|
+
if (!found) {
|
|
82
|
+
missing.push(elPath);
|
|
83
|
+
}
|
|
84
|
+
}
|
|
85
|
+
}
|
|
86
|
+
}
|
|
87
|
+
// ---------------------------------------------------------------------------
|
|
88
|
+
// deepMergeJson — recursive JSON merge primitive (P3.T1)
|
|
89
|
+
//
|
|
90
|
+
// Semantics (from DE-8 contract spec):
|
|
91
|
+
// - Objects: merge recursively (override keys win; base keys retained if absent from override)
|
|
92
|
+
// - Arrays: override replaces base (no concat — arrays are treated as atomic values)
|
|
93
|
+
// - Primitives / null: override replaces base
|
|
94
|
+
// ---------------------------------------------------------------------------
|
|
95
|
+
export function deepMergeJson(base, override) {
|
|
96
|
+
if (override === null || typeof override !== "object" || Array.isArray(override)) {
|
|
97
|
+
return override;
|
|
98
|
+
}
|
|
99
|
+
if (base === null || typeof base !== "object" || Array.isArray(base)) {
|
|
100
|
+
// base is not a plain object — override wins wholesale
|
|
101
|
+
return override;
|
|
102
|
+
}
|
|
103
|
+
// Both are plain objects — recursive merge.
|
|
104
|
+
//
|
|
105
|
+
// Key ORDER follows `override` (the bkit template) for keys it defines, then appends
|
|
106
|
+
// base-only (consumer) keys. Order-significant maps like opencode's last-match-wins
|
|
107
|
+
// `permission.bash` keep the template's order (`git push --force-with-lease*: allow`
|
|
108
|
+
// stays after `git push --force*: deny`).
|
|
109
|
+
const baseObj = base;
|
|
110
|
+
const overrideObj = override;
|
|
111
|
+
const result = {};
|
|
112
|
+
// 1. Template keys first, in template order (recurse where both sides are plain objects).
|
|
113
|
+
for (const [key, val] of Object.entries(overrideObj)) {
|
|
114
|
+
const baseVal = baseObj[key];
|
|
115
|
+
if (key in baseObj &&
|
|
116
|
+
baseVal !== null &&
|
|
117
|
+
typeof baseVal === "object" &&
|
|
118
|
+
!Array.isArray(baseVal) &&
|
|
119
|
+
val !== null &&
|
|
120
|
+
typeof val === "object" &&
|
|
121
|
+
!Array.isArray(val)) {
|
|
122
|
+
result[key] = deepMergeJson(baseVal, val);
|
|
123
|
+
}
|
|
124
|
+
else {
|
|
125
|
+
result[key] = val;
|
|
126
|
+
}
|
|
127
|
+
}
|
|
128
|
+
// 2. Consumer-only keys preserved, appended after the template's keys.
|
|
129
|
+
for (const [key, val] of Object.entries(baseObj)) {
|
|
130
|
+
if (!(key in result)) {
|
|
131
|
+
result[key] = val;
|
|
132
|
+
}
|
|
133
|
+
}
|
|
134
|
+
return result;
|
|
135
|
+
}
|
|
136
|
+
// ---------------------------------------------------------------------------
|
|
137
|
+
// writeTier2JsonContained — deep-containment JSON helper (BAR-167 Phase 1)
|
|
138
|
+
//
|
|
139
|
+
// Contract:
|
|
140
|
+
// - dest absent → write template as-is (first install)
|
|
141
|
+
// - dest present, valid JSON, template contained → no-op (idempotent)
|
|
142
|
+
// - dest present, valid JSON, containment fails → deepMergeJson(existing, template)
|
|
143
|
+
// (template wins on key collisions; consumer-only keys outside template tree preserved)
|
|
144
|
+
// - dest present, malformed JSON → overwrite with template
|
|
145
|
+
// - schemaFlipped: true when a path value changed type during deep-merge
|
|
146
|
+
// ---------------------------------------------------------------------------
|
|
147
|
+
export function writeTier2JsonContained(srcPath, dstPath, dryRun, ws) {
|
|
148
|
+
const srcRaw = fs.readFileSync(srcPath, "utf-8");
|
|
149
|
+
let template;
|
|
150
|
+
try {
|
|
151
|
+
template = JSON.parse(srcRaw);
|
|
152
|
+
}
|
|
153
|
+
catch {
|
|
154
|
+
throw new Error(`writeTier2JsonContained: template at ${srcPath} is not valid JSON`);
|
|
155
|
+
}
|
|
156
|
+
if (!fs.existsSync(dstPath)) {
|
|
157
|
+
// First install — write template as-is
|
|
158
|
+
ensureDir(path.dirname(dstPath));
|
|
159
|
+
if (!dryRun) {
|
|
160
|
+
fs.writeFileSync(dstPath, JSON.stringify(template, null, 2) + "\n", "utf-8");
|
|
161
|
+
const srcMode = fs.statSync(srcPath).mode;
|
|
162
|
+
fs.chmodSync(dstPath, srcMode);
|
|
163
|
+
}
|
|
164
|
+
ws.writes.push({ path: dstPath, action: "write" });
|
|
165
|
+
return;
|
|
166
|
+
}
|
|
167
|
+
// dest exists — read and check containment
|
|
168
|
+
const dstRaw = fs.readFileSync(dstPath, "utf-8");
|
|
169
|
+
let existing;
|
|
170
|
+
try {
|
|
171
|
+
existing = JSON.parse(dstRaw);
|
|
172
|
+
}
|
|
173
|
+
catch {
|
|
174
|
+
// Malformed destination — refuse to overwrite; require manual fix (matches malformed-package-json blocker discipline)
|
|
175
|
+
throw new Error(`[bkit] ${dstPath} is malformed JSON — fix manually before running bkit install`);
|
|
176
|
+
}
|
|
177
|
+
// Check if existing already contains the template
|
|
178
|
+
const containsResult = deepContains(template, existing);
|
|
179
|
+
if (containsResult.ok) {
|
|
180
|
+
return; // idempotent — no change needed
|
|
181
|
+
}
|
|
182
|
+
// Deep-merge: existing base, template override (template wins on conflicts)
|
|
183
|
+
const merged = deepMergeJson(existing, template);
|
|
184
|
+
const mergedStr = JSON.stringify(merged, null, 2) + "\n";
|
|
185
|
+
if (mergedStr === dstRaw)
|
|
186
|
+
return; // idempotent guard
|
|
187
|
+
if (!dryRun) {
|
|
188
|
+
fs.writeFileSync(dstPath, mergedStr, "utf-8");
|
|
189
|
+
}
|
|
190
|
+
ws.writes.push({ path: dstPath, action: "update" });
|
|
191
|
+
}
|
|
192
|
+
// ---------------------------------------------------------------------------
|
|
193
|
+
// Internal helpers
|
|
194
|
+
// ---------------------------------------------------------------------------
|
|
195
|
+
export function ensureDir(dir) {
|
|
196
|
+
fs.mkdirSync(dir, { recursive: true });
|
|
197
|
+
}
|
|
198
|
+
// ---------------------------------------------------------------------------
|
|
199
|
+
// fully-managed format — idempotent rewrite of whole file after token substitution
|
|
200
|
+
//
|
|
201
|
+
// Semantics: always writes the src content (with tokens applied) to dst.
|
|
202
|
+
// If dst exists with identical content, no-op (no double-count in WriteSet).
|
|
203
|
+
// ---------------------------------------------------------------------------
|
|
204
|
+
export function writeTier1(srcPath, dstPath, tokens, dryRun, ws) {
|
|
205
|
+
const srcRaw = readTemplate(srcPath);
|
|
206
|
+
const srcContent = applyTokens(srcRaw, tokens);
|
|
207
|
+
if (fs.existsSync(dstPath)) {
|
|
208
|
+
const existing = fs.readFileSync(dstPath, "utf-8");
|
|
209
|
+
if (existing === srcContent)
|
|
210
|
+
return; // identical — no-op
|
|
211
|
+
}
|
|
212
|
+
ensureDir(path.dirname(dstPath));
|
|
213
|
+
if (!dryRun) {
|
|
214
|
+
fs.writeFileSync(dstPath, srcContent, "utf-8");
|
|
215
|
+
// Preserve executable bit from src
|
|
216
|
+
const srcMode = fs.statSync(srcPath).mode;
|
|
217
|
+
fs.chmodSync(dstPath, srcMode);
|
|
218
|
+
}
|
|
219
|
+
ws.writes.push({ path: dstPath, action: "write" });
|
|
220
|
+
}
|
|
221
|
+
// ---------------------------------------------------------------------------
|
|
222
|
+
// markered-text format — managed-block (bkit owns content between markers; consumer owns rest)
|
|
223
|
+
//
|
|
224
|
+
// Semantics:
|
|
225
|
+
// - dest absent → write whole file (with token substitution)
|
|
226
|
+
// - dest has markers → update only the bkit block (tokens applied to new block content)
|
|
227
|
+
// - dest present, no marks → append full block at EOF; preserve consumer content above
|
|
228
|
+
//
|
|
229
|
+
// markerStyle: "html-comment" for markdown, shell and `.gitignore` (`# ` prefix allowed);
|
|
230
|
+
// "slash-comment" for JS.
|
|
231
|
+
// ---------------------------------------------------------------------------
|
|
232
|
+
export function writeTier2(srcPath, dstPath, tokens, markerStyle, dryRun, ws) {
|
|
233
|
+
const srcRaw = readTemplate(srcPath);
|
|
234
|
+
if (!fs.existsSync(dstPath)) {
|
|
235
|
+
// dest missing → write whole template (with tokens applied)
|
|
236
|
+
const content = applyTokens(srcRaw, tokens);
|
|
237
|
+
ensureDir(path.dirname(dstPath));
|
|
238
|
+
if (!dryRun) {
|
|
239
|
+
fs.writeFileSync(dstPath, content, "utf-8");
|
|
240
|
+
const srcMode = fs.statSync(srcPath).mode;
|
|
241
|
+
fs.chmodSync(dstPath, srcMode);
|
|
242
|
+
}
|
|
243
|
+
ws.writes.push({ path: dstPath, action: "write" });
|
|
244
|
+
return;
|
|
245
|
+
}
|
|
246
|
+
const destContent = fs.readFileSync(dstPath, "utf-8");
|
|
247
|
+
const fullBlock = extractFullManagedBlock(srcRaw, markerStyle);
|
|
248
|
+
if (fullBlock === null) {
|
|
249
|
+
// Template has no block for this marker style — nothing to manage
|
|
250
|
+
return;
|
|
251
|
+
}
|
|
252
|
+
// Check if dest already has markers
|
|
253
|
+
const blockContent = extractManagedBlock(destContent, markerStyle);
|
|
254
|
+
if (blockContent === null) {
|
|
255
|
+
// extractManagedBlock returns null for BOTH "no markers" and "ambiguous markers"
|
|
256
|
+
// (duplicates / inverted). Only the former should append — appending on the latter
|
|
257
|
+
// compounds corruption (dogfood docs grew a second stamped block every install).
|
|
258
|
+
const [startMarker, endMarker] = selectMarkers(markerStyle);
|
|
259
|
+
const starts = findLineAnchoredMarkers(destContent, startMarker);
|
|
260
|
+
const ends = findLineAnchoredMarkers(destContent, endMarker);
|
|
261
|
+
if (starts.length > 0 || ends.length > 0) {
|
|
262
|
+
console.warn(`[bkit] Managed block markers present but unparseable in ${dstPath} — skipping (expected exactly one start/end)`);
|
|
263
|
+
return;
|
|
264
|
+
}
|
|
265
|
+
// dest has no markers → append full block at EOF (with tokens applied)
|
|
266
|
+
const appliedBlock = applyTokens(fullBlock, tokens);
|
|
267
|
+
const sep = destContent.length === 0
|
|
268
|
+
? ""
|
|
269
|
+
: destContent.endsWith("\n\n")
|
|
270
|
+
? ""
|
|
271
|
+
: destContent.endsWith("\n")
|
|
272
|
+
? "\n"
|
|
273
|
+
: "\n\n";
|
|
274
|
+
const tail = appliedBlock.endsWith("\n") ? "" : "\n";
|
|
275
|
+
if (!dryRun) {
|
|
276
|
+
fs.writeFileSync(dstPath, destContent + sep + appliedBlock + tail, "utf-8");
|
|
277
|
+
}
|
|
278
|
+
ws.writes.push({ path: dstPath, action: "append" });
|
|
279
|
+
return;
|
|
280
|
+
}
|
|
281
|
+
// dest has markers → update managed block with new content (tokens applied)
|
|
282
|
+
const newBlockContent = extractManagedBlock(srcRaw, markerStyle);
|
|
283
|
+
if (newBlockContent === null)
|
|
284
|
+
return;
|
|
285
|
+
const appliedNewContent = applyTokens(newBlockContent, tokens);
|
|
286
|
+
if (updateManagedBlock(dstPath, appliedNewContent, dryRun, markerStyle)) {
|
|
287
|
+
ws.writes.push({ path: dstPath, action: "update" });
|
|
288
|
+
}
|
|
289
|
+
}
|
|
290
|
+
// ---------------------------------------------------------------------------
|
|
291
|
+
// Managed package.json scripts — add-if-missing with consumer ownership
|
|
292
|
+
//
|
|
293
|
+
// Semantics:
|
|
294
|
+
// - File absent → no-op, returns missingPkg: true
|
|
295
|
+
// - File malformed JSON → no-op, returns malformed: true
|
|
296
|
+
// - script key absent → add with default value (recorded as one update)
|
|
297
|
+
// - script key exists → preserve consumer value (never overwrite)
|
|
298
|
+
//
|
|
299
|
+
// One WriteSet entry per call when any script was added. Drift
|
|
300
|
+
// surfaces in `bkit check` because `dryRun=true` still pushes to ws.writes.
|
|
301
|
+
// ---------------------------------------------------------------------------
|
|
302
|
+
export function ensurePackageJsonScripts(scripts, dryRun, ws) {
|
|
303
|
+
const pkgPath = "package.json";
|
|
304
|
+
if (!fs.existsSync(pkgPath)) {
|
|
305
|
+
return { added: [], preserved: [], missingPkg: true, malformed: false };
|
|
306
|
+
}
|
|
307
|
+
const raw = fs.readFileSync(pkgPath, "utf-8");
|
|
308
|
+
let pkg;
|
|
309
|
+
try {
|
|
310
|
+
pkg = JSON.parse(raw);
|
|
311
|
+
}
|
|
312
|
+
catch {
|
|
313
|
+
return { added: [], preserved: [], missingPkg: false, malformed: true };
|
|
314
|
+
}
|
|
315
|
+
let pkgScripts = pkg.scripts ?? undefined;
|
|
316
|
+
const added = [];
|
|
317
|
+
const preserved = [];
|
|
318
|
+
for (const [name, value] of Object.entries(scripts)) {
|
|
319
|
+
if (pkgScripts && Object.prototype.hasOwnProperty.call(pkgScripts, name)) {
|
|
320
|
+
preserved.push(name);
|
|
321
|
+
}
|
|
322
|
+
else {
|
|
323
|
+
if (!pkgScripts) {
|
|
324
|
+
pkgScripts = {};
|
|
325
|
+
pkg.scripts = pkgScripts;
|
|
326
|
+
}
|
|
327
|
+
pkgScripts[name] = value;
|
|
328
|
+
added.push(name);
|
|
329
|
+
}
|
|
330
|
+
}
|
|
331
|
+
if (added.length > 0) {
|
|
332
|
+
ws.writes.push({ path: pkgPath, action: "update" });
|
|
333
|
+
if (!dryRun) {
|
|
334
|
+
// Preserve indent style and trailing newline of the original file.
|
|
335
|
+
const indentMatch = raw.match(/\n([ \t]+)"/);
|
|
336
|
+
const indent = indentMatch ? indentMatch[1] : " ";
|
|
337
|
+
const trailingNewline = raw.endsWith("\n") ? "\n" : "";
|
|
338
|
+
fs.writeFileSync(pkgPath, JSON.stringify(pkg, null, indent) + trailingNewline, "utf-8");
|
|
339
|
+
}
|
|
340
|
+
}
|
|
341
|
+
return { added, preserved, missingPkg: false, malformed: false };
|
|
342
|
+
}
|
|
@@ -0,0 +1,27 @@
|
|
|
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
|
+
import * as fs from "node:fs";
|
|
6
|
+
import * as path from "node:path";
|
|
7
|
+
import { git, parseJson } from "../commands/lib.js";
|
|
8
|
+
/** `tmp/bkit-clamp-{fid}-{step}[-{attempt}].jsonl` in the checkout `cwd` sits in. */
|
|
9
|
+
export function clampLogPath(cwd, fid, step, attempt) {
|
|
10
|
+
const top = git(cwd, ["rev-parse", "--show-toplevel"]) ?? cwd;
|
|
11
|
+
return path.join(top, "tmp", `bkit-clamp-${fid}-${step}${attempt ? `-${attempt}` : ""}.jsonl`);
|
|
12
|
+
}
|
|
13
|
+
/** Every record in the log; reading never drains it, so a retried status block sees the same array. */
|
|
14
|
+
export function readRecords(log, onBad = () => undefined) {
|
|
15
|
+
if (!fs.existsSync(log))
|
|
16
|
+
return [];
|
|
17
|
+
return fs
|
|
18
|
+
.readFileSync(log, "utf-8")
|
|
19
|
+
.split("\n")
|
|
20
|
+
.filter((l) => l.trim() !== "")
|
|
21
|
+
.flatMap((l) => {
|
|
22
|
+
const parsed = parseJson(l);
|
|
23
|
+
if (!parsed.ok)
|
|
24
|
+
onBad(l);
|
|
25
|
+
return parsed.ok ? [parsed.value] : [];
|
|
26
|
+
});
|
|
27
|
+
}
|
|
@@ -0,0 +1,156 @@
|
|
|
1
|
+
// Contract + reducer for the bkit workflow status log.
|
|
2
|
+
//
|
|
3
|
+
// State is an append-only NDJSON event log (`status.jsonl`): one JSON event per
|
|
4
|
+
// line, prior lines NEVER mutated. `merge=union` (see `.gitattributes`) lets git
|
|
5
|
+
// auto-concatenate both branches' appended lines server-side, so a per-FID status
|
|
6
|
+
// log can never block a PR merge. Union may interleave or duplicate lines, so the
|
|
7
|
+
// reader (`fold`) de-dupes by identity and orders by `at` before reconstructing
|
|
8
|
+
// the run array.
|
|
9
|
+
//
|
|
10
|
+
// This module is the CANONICAL reference reducer. The bkit workflows execute an
|
|
11
|
+
// inline jq filter that mirrors `fold` exactly; this TS is the unit-tested source
|
|
12
|
+
// of truth for the fold semantics.
|
|
13
|
+
//
|
|
14
|
+
// `parentSha` is captured at step START via `git rev-parse HEAD`, BEFORE the
|
|
15
|
+
// step's own commit (if any). Forensic only — points to the commit that preceded
|
|
16
|
+
// this step's work, not the commit that resulted from it.
|
|
17
|
+
// Identity for de-dup under union merge. `step-done` is unique per
|
|
18
|
+
// (workflow, step, parentSha, at); workflow-level events per (type, workflow, at).
|
|
19
|
+
function identity(e) {
|
|
20
|
+
if (e.type === "step-done")
|
|
21
|
+
return `S\u0000${e.workflow}\u0000${e.step}\u0000${e.parentSha}\u0000${e.at}`;
|
|
22
|
+
return `W\u0000${e.type}\u0000${e.workflow}\u0000${e.at}`;
|
|
23
|
+
}
|
|
24
|
+
// Index of the most-recent run matching `workflow`, or -1.
|
|
25
|
+
function lastIndexOfWorkflow(runs, workflow) {
|
|
26
|
+
for (let i = runs.length - 1; i >= 0; i--)
|
|
27
|
+
if (runs[i].workflow === workflow)
|
|
28
|
+
return i;
|
|
29
|
+
return -1;
|
|
30
|
+
}
|
|
31
|
+
// Strip routing fields to recover the bare `Step`.
|
|
32
|
+
function toStep(e) {
|
|
33
|
+
const { type: _t, workflow: _w, ...step } = e;
|
|
34
|
+
return step;
|
|
35
|
+
}
|
|
36
|
+
// Fold the event log into the run array. De-dupes
|
|
37
|
+
// (keeping first occurrence), then orders by `at` (stable), then reduces.
|
|
38
|
+
export function fold(events) {
|
|
39
|
+
const seen = new Set();
|
|
40
|
+
const deduped = events.filter((e) => {
|
|
41
|
+
const k = identity(e);
|
|
42
|
+
if (seen.has(k))
|
|
43
|
+
return false;
|
|
44
|
+
seen.add(k);
|
|
45
|
+
return true;
|
|
46
|
+
});
|
|
47
|
+
// Stable sort by `at` (Array.prototype.sort is stable in modern engines).
|
|
48
|
+
const ordered = deduped
|
|
49
|
+
.map((e, i) => ({ e, i }))
|
|
50
|
+
.sort((a, b) => (a.e.at < b.e.at ? -1 : a.e.at > b.e.at ? 1 : a.i - b.i))
|
|
51
|
+
.map((x) => x.e);
|
|
52
|
+
const runs = [];
|
|
53
|
+
for (const e of ordered) {
|
|
54
|
+
if (e.type === "workflow-started") {
|
|
55
|
+
runs.push({ workflow: e.workflow, startedAt: e.at, status: "IN_PROGRESS", steps: [] });
|
|
56
|
+
}
|
|
57
|
+
else if (e.type === "step-done") {
|
|
58
|
+
const i = lastIndexOfWorkflow(runs, e.workflow);
|
|
59
|
+
if (i < 0) {
|
|
60
|
+
runs.push({
|
|
61
|
+
workflow: e.workflow,
|
|
62
|
+
startedAt: e.at,
|
|
63
|
+
status: "IN_PROGRESS",
|
|
64
|
+
steps: [toStep(e)],
|
|
65
|
+
});
|
|
66
|
+
}
|
|
67
|
+
else {
|
|
68
|
+
runs[i].steps.push(toStep(e));
|
|
69
|
+
}
|
|
70
|
+
}
|
|
71
|
+
else if (e.type === "workflow-meta") {
|
|
72
|
+
const i = lastIndexOfWorkflow(runs, e.workflow);
|
|
73
|
+
if (i >= 0) {
|
|
74
|
+
const { type: _t, workflow: _w, at: _a, ...meta } = e;
|
|
75
|
+
Object.assign(runs[i], meta);
|
|
76
|
+
}
|
|
77
|
+
}
|
|
78
|
+
else if (e.type === "workflow-done" || e.type === "workflow-failed") {
|
|
79
|
+
const i = lastIndexOfWorkflow(runs, e.workflow);
|
|
80
|
+
if (i >= 0)
|
|
81
|
+
runs[i].status = e.type === "workflow-done" ? "DONE" : "FAILED";
|
|
82
|
+
}
|
|
83
|
+
}
|
|
84
|
+
return runs;
|
|
85
|
+
}
|
|
86
|
+
// Serialize one event to the NDJSON line appended to `status.jsonl`, newline included.
|
|
87
|
+
export function appendLine(event) {
|
|
88
|
+
return `${JSON.stringify(event)}\n`;
|
|
89
|
+
}
|
|
90
|
+
// ---------------------------------------------------------------------------
|
|
91
|
+
// Queries — the reads routing and counters make. Two opposite scopings: attempt
|
|
92
|
+
// counts and verdict/failures/mode reads look at the ACTIVE
|
|
93
|
+
// run only, so a resumed run never inherits a finished run's spent budget;
|
|
94
|
+
// strategy reads ALL runs, so a resumed run keeps its place on the
|
|
95
|
+
// STANDARD -> PIVOT -> FINAL ladder instead of restarting it.
|
|
96
|
+
// ---------------------------------------------------------------------------
|
|
97
|
+
/** `status.jsonl` timestamp: UTC, whole seconds (`date -u +%FT%TZ`). */
|
|
98
|
+
export const statusTimestamp = (now = new Date()) => now.toISOString().replace(/\.\d{3}Z$/, "Z");
|
|
99
|
+
/** The latest run of `workflow` — the active one. */
|
|
100
|
+
export function lastRun(runs, workflow) {
|
|
101
|
+
const i = lastIndexOfWorkflow(runs, workflow);
|
|
102
|
+
return i < 0 ? undefined : runs[i];
|
|
103
|
+
}
|
|
104
|
+
const matches = (s, f) => s.step === f.step && s.status === "DONE" && (f.subPlan === undefined || s.subPlan === f.subPlan);
|
|
105
|
+
/**
|
|
106
|
+
* DONE rows for the step in the active run of `workflow`. `since` names a run
|
|
107
|
+
* field holding a timestamp (SOAK's `soakEntryAt`): only rows after it count.
|
|
108
|
+
*/
|
|
109
|
+
export function activeDoneSteps(runs, workflow, f, since) {
|
|
110
|
+
const run = lastRun(runs, workflow);
|
|
111
|
+
if (!run)
|
|
112
|
+
return [];
|
|
113
|
+
const floor = since === undefined ? undefined : String(run[since] ?? "");
|
|
114
|
+
return run.steps.filter((s) => matches(s, f) && (floor === undefined || s.at > floor));
|
|
115
|
+
}
|
|
116
|
+
/** The last DONE row for the step across ALL runs of `workflow`. */
|
|
117
|
+
export function lastDoneStepAllRuns(runs, workflow, f) {
|
|
118
|
+
return runs
|
|
119
|
+
.filter((r) => r.workflow === workflow)
|
|
120
|
+
.flatMap((r) => r.steps)
|
|
121
|
+
.filter((s) => matches(s, f))
|
|
122
|
+
.at(-1);
|
|
123
|
+
}
|
|
124
|
+
/**
|
|
125
|
+
* Which run of `workflow` this invocation is (1-based): the count of its runs,
|
|
126
|
+
* plus one unless the latest run overall is one of them still IN_PROGRESS — a
|
|
127
|
+
* resume. Same answer before and after the run's `workflow-started` row lands.
|
|
128
|
+
*/
|
|
129
|
+
export function runNumber(runs, workflow) {
|
|
130
|
+
const n = runs.filter((r) => r.workflow === workflow).length;
|
|
131
|
+
const latest = runs.at(-1);
|
|
132
|
+
return latest?.workflow === workflow && latest.status === "IN_PROGRESS" ? n : n + 1;
|
|
133
|
+
}
|
|
134
|
+
/**
|
|
135
|
+
* A run-level field of the active run (merged from `workflow-meta`) when set,
|
|
136
|
+
* else the last step that carries it. "" when neither does.
|
|
137
|
+
*/
|
|
138
|
+
export function runOrStepField(runs, workflow, field) {
|
|
139
|
+
const run = lastRun(runs, workflow);
|
|
140
|
+
if (!run)
|
|
141
|
+
return "";
|
|
142
|
+
const own = run[field];
|
|
143
|
+
if (typeof own === "string" && own !== "")
|
|
144
|
+
return own;
|
|
145
|
+
const fromStep = run.steps
|
|
146
|
+
.map((s) => s[field])
|
|
147
|
+
.filter((v) => v !== undefined && v !== null && v !== "")
|
|
148
|
+
.at(-1);
|
|
149
|
+
return fromStep === undefined ? "" : String(fromStep);
|
|
150
|
+
}
|
|
151
|
+
/** Next rung: none -> STANDARD -> PIVOT -> FINAL, and FINAL stays FINAL. */
|
|
152
|
+
export function nextStrategy(prior) {
|
|
153
|
+
if (prior === undefined)
|
|
154
|
+
return "STANDARD";
|
|
155
|
+
return prior === "STANDARD" ? "PIVOT" : "FINAL";
|
|
156
|
+
}
|