@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,479 @@
|
|
|
1
|
+
// checks/status-holes.ts — Tier-3 advisory status-hole detector.
|
|
2
|
+
//
|
|
3
|
+
// A fail-open advisory that compares the set of ship steps RECORDED in a
|
|
4
|
+
// status.jsonl against the set of steps the workflow PROSE says should be
|
|
5
|
+
// there. It derives its expected set from .bkit/workflows/bkit-ship.md at
|
|
6
|
+
// runtime (headings + step:"ship-*" literals) — NEVER a hand-maintained table
|
|
7
|
+
// (decision 384-tier3-promotion).
|
|
8
|
+
//
|
|
9
|
+
// ADVISORY / FAIL-OPEN: the CLI exits 0 unconditionally — even when holes are
|
|
10
|
+
// found (decision 384-tier3-promotion).
|
|
11
|
+
//
|
|
12
|
+
// Path-conditional expectations:
|
|
13
|
+
// - Path A (dev is ancestor): skips ship-conflict-resolve.
|
|
14
|
+
// - Path B (dev moved): includes ship-conflict-resolve.
|
|
15
|
+
// - MERGED-on-entry (Step 2 detects state=MERGED → Step 13): skips the entire
|
|
16
|
+
// middle (base check, integrate, deferred-sweep, the pre-merge docs /
|
|
17
|
+
// summary / prune / bookkeeping-push steps, merge-pr).
|
|
18
|
+
// - Aborted (workflow-failed row present): no post-abort holes expected.
|
|
19
|
+
// - ship-failure-diagnose / ship-failure-remediate are NEVER mandatory — they
|
|
20
|
+
// appear only in the merge-retry loop.
|
|
21
|
+
//
|
|
22
|
+
// Usage (advisory CI step or manual):
|
|
23
|
+
// npx tsx .bkit/core/engine/checks/status-holes.ts <status.jsonl> [--ship-md <path>]
|
|
24
|
+
// # exits 0 always; prints advisory report to stdout
|
|
25
|
+
|
|
26
|
+
import * as fs from "node:fs";
|
|
27
|
+
import * as path from "node:path";
|
|
28
|
+
import { fileURLToPath } from "node:url";
|
|
29
|
+
|
|
30
|
+
import { getWorkflowsRoot } from "../shared/package-roots.js";
|
|
31
|
+
|
|
32
|
+
// ---------------------------------------------------------------------------
|
|
33
|
+
// Canonical ship step order (mirrors audits/workflows/ship-invariants.test.ts
|
|
34
|
+
// CANONICAL_SHIP_STEP_KEYS — the frozen schema). The detector cross-checks its
|
|
35
|
+
// source-derived set against this. Renaming a key resets attempt counters across
|
|
36
|
+
// three repos and orphans the detector corpus.
|
|
37
|
+
// ---------------------------------------------------------------------------
|
|
38
|
+
|
|
39
|
+
export const SHIP_STEP_ORDER = [
|
|
40
|
+
"ship-start-workflow",
|
|
41
|
+
"ship-worktree-setup",
|
|
42
|
+
"ship-regression-guard",
|
|
43
|
+
"ship-conflict-resolve",
|
|
44
|
+
"ship-deferred-sweep",
|
|
45
|
+
"ship-update-docs",
|
|
46
|
+
"ship-summary",
|
|
47
|
+
"ship-prune-skills",
|
|
48
|
+
"ship-bookkeeping-push",
|
|
49
|
+
"ship-merge-pr",
|
|
50
|
+
"ship-failure-diagnose",
|
|
51
|
+
"ship-failure-remediate",
|
|
52
|
+
"ship-switch-to-dev",
|
|
53
|
+
"ship-worktree-cleanup",
|
|
54
|
+
"ship-close-workflow",
|
|
55
|
+
] as const;
|
|
56
|
+
|
|
57
|
+
/** Steps that appear only in the merge-retry loop — never mandatory, never holes. */
|
|
58
|
+
const RETRY_LOOP_STEPS = new Set<string>(["ship-failure-diagnose", "ship-failure-remediate"]);
|
|
59
|
+
|
|
60
|
+
/** The step that Path A skips (dev is ancestor → no integration needed). */
|
|
61
|
+
const PATH_B_ONLY_STEPS = new Set<string>(["ship-conflict-resolve"]);
|
|
62
|
+
|
|
63
|
+
/**
|
|
64
|
+
* The steps a MERGED-on-entry resume skips entirely.
|
|
65
|
+
*
|
|
66
|
+
* bkit-ship.md Step 2 routes to Step 13 at sub-step 5 (`state` = MERGED), which
|
|
67
|
+
* is BEFORE sub-step 8 writes `ship-worktree-setup` + `ship-regression-guard` —
|
|
68
|
+
* so those two are absent too, not just the middle. The pre-merge docs,
|
|
69
|
+
* summary, prune and bookkeeping-push steps (6-8) ride the PR, so a PR that is
|
|
70
|
+
* already merged skips them too.
|
|
71
|
+
*/
|
|
72
|
+
const MERGED_ON_ENTRY_SKIP = new Set<string>([
|
|
73
|
+
"ship-worktree-setup",
|
|
74
|
+
"ship-regression-guard",
|
|
75
|
+
"ship-conflict-resolve",
|
|
76
|
+
"ship-deferred-sweep",
|
|
77
|
+
"ship-update-docs",
|
|
78
|
+
"ship-summary",
|
|
79
|
+
"ship-prune-skills",
|
|
80
|
+
"ship-bookkeeping-push",
|
|
81
|
+
"ship-merge-pr",
|
|
82
|
+
// failure-diagnose/remediate are already in RETRY_LOOP_STEPS (never expected)
|
|
83
|
+
]);
|
|
84
|
+
|
|
85
|
+
// ---------------------------------------------------------------------------
|
|
86
|
+
// Types
|
|
87
|
+
// ---------------------------------------------------------------------------
|
|
88
|
+
|
|
89
|
+
export type RunPath = "PATH_A" | "PATH_B" | "MERGED_ON_ENTRY" | "ABORTED" | "IN_PROGRESS";
|
|
90
|
+
|
|
91
|
+
export interface StatusRow {
|
|
92
|
+
type: string;
|
|
93
|
+
workflow?: string;
|
|
94
|
+
step?: string;
|
|
95
|
+
status?: string;
|
|
96
|
+
parentSha?: string;
|
|
97
|
+
[key: string]: unknown;
|
|
98
|
+
}
|
|
99
|
+
|
|
100
|
+
export interface HoleReport {
|
|
101
|
+
/** Steps the prose says should be present but were not recorded. */
|
|
102
|
+
missing: string[];
|
|
103
|
+
/** Steps recorded but NOT in the source-derived universe (invented names). */
|
|
104
|
+
unexpected: string[];
|
|
105
|
+
/** Which path the run was classified as. */
|
|
106
|
+
path: RunPath;
|
|
107
|
+
/** All ship steps observed in this run's status rows. */
|
|
108
|
+
observed: string[];
|
|
109
|
+
/** All steps the source says exist (from headings + literals). */
|
|
110
|
+
sourceUniverse: string[];
|
|
111
|
+
/** True if the source-derived set disagrees with the frozen canonical set. */
|
|
112
|
+
sourceCanonicalDrift: string[];
|
|
113
|
+
/** Steps the source records but never numbers under a `## … Step N` heading. */
|
|
114
|
+
orphanSteps: string[];
|
|
115
|
+
}
|
|
116
|
+
|
|
117
|
+
// ---------------------------------------------------------------------------
|
|
118
|
+
// Source derivation — parse bkit-ship.md to find the expected step universe.
|
|
119
|
+
// ---------------------------------------------------------------------------
|
|
120
|
+
|
|
121
|
+
/**
|
|
122
|
+
* Derive the universe of ship step keys from the workflow markdown.
|
|
123
|
+
*
|
|
124
|
+
* Strategy:
|
|
125
|
+
* 1. Extract every `step:"ship-..."` literal from fenced code blocks.
|
|
126
|
+
* 2. Extract every `## … Step N — Name` heading and map the heading's section
|
|
127
|
+
* to the step key(s) found within it.
|
|
128
|
+
* 3. Return the union of all unique step keys.
|
|
129
|
+
*
|
|
130
|
+
* The two passes scan the SAME `step:"ship-*"` regex and the heading pass only
|
|
131
|
+
* narrows the line range, so `headingSteps` is always a subset of `literalSteps`.
|
|
132
|
+
* The detector reports `orphanSteps`: a status write that appears in the file but NOT
|
|
133
|
+
* inside any `## … Step N` section.
|
|
134
|
+
*/
|
|
135
|
+
export function deriveExpectedStepSetFromSource(shipMd: string): {
|
|
136
|
+
steps: string[];
|
|
137
|
+
headingSteps: string[];
|
|
138
|
+
literalSteps: string[];
|
|
139
|
+
orphanSteps: string[];
|
|
140
|
+
} {
|
|
141
|
+
const lines = shipMd.split("\n");
|
|
142
|
+
|
|
143
|
+
// 1. Collect every `step:"ship-..."` / `--step=ship-...` literal (anywhere — fenced or prose).
|
|
144
|
+
const literalSet = new Set<string>();
|
|
145
|
+
const literalRe = /(?:step:"|--step=)(ship-[a-z-]+)/g;
|
|
146
|
+
for (const line of lines) {
|
|
147
|
+
let m: RegExpExecArray | null;
|
|
148
|
+
while ((m = literalRe.exec(line)) !== null) {
|
|
149
|
+
literalSet.add(m[1]);
|
|
150
|
+
}
|
|
151
|
+
literalRe.lastIndex = 0; // reset per-line
|
|
152
|
+
}
|
|
153
|
+
|
|
154
|
+
// 2. Collect heading-derived steps. A `## … Step N` heading opens a section;
|
|
155
|
+
// the step key(s) within that section's body (until the next `## ` heading)
|
|
156
|
+
// belong to that step.
|
|
157
|
+
const headingSet = new Set<string>();
|
|
158
|
+
let inStep = false;
|
|
159
|
+
for (const line of lines) {
|
|
160
|
+
if (/^##\s+.*Step\s+\d+/i.test(line)) {
|
|
161
|
+
inStep = true;
|
|
162
|
+
continue;
|
|
163
|
+
}
|
|
164
|
+
if (/^##\s+/m.test(line) && !/Step\s+\d+/i.test(line)) {
|
|
165
|
+
inStep = false;
|
|
166
|
+
continue;
|
|
167
|
+
}
|
|
168
|
+
if (inStep) {
|
|
169
|
+
let m: RegExpExecArray | null;
|
|
170
|
+
const re = /(?:step:"|--step=)(ship-[a-z-]+)/g;
|
|
171
|
+
while ((m = re.exec(line)) !== null) {
|
|
172
|
+
headingSet.add(m[1]);
|
|
173
|
+
}
|
|
174
|
+
re.lastIndex = 0;
|
|
175
|
+
}
|
|
176
|
+
}
|
|
177
|
+
|
|
178
|
+
// 3. Union + the one asymmetry that carries signal (see the docstring).
|
|
179
|
+
const all = new Set<string>([...literalSet, ...headingSet]);
|
|
180
|
+
const orphanSteps = [...literalSet].filter((s) => !headingSet.has(s)).sort();
|
|
181
|
+
return {
|
|
182
|
+
steps: [...all].sort(),
|
|
183
|
+
headingSteps: [...headingSet].sort(),
|
|
184
|
+
literalSteps: [...literalSet].sort(),
|
|
185
|
+
orphanSteps,
|
|
186
|
+
};
|
|
187
|
+
}
|
|
188
|
+
|
|
189
|
+
/**
|
|
190
|
+
* Cross-check the source-derived set against the frozen canonical set.
|
|
191
|
+
* Returns the keys that disagree (present in one but not the other).
|
|
192
|
+
*/
|
|
193
|
+
export function checkSourceCanonicalDrift(sourceSteps: string[]): string[] {
|
|
194
|
+
const sourceSet = new Set(sourceSteps);
|
|
195
|
+
const canonicalSet = new Set<string>(SHIP_STEP_ORDER);
|
|
196
|
+
const drift: string[] = [];
|
|
197
|
+
for (const k of canonicalSet) if (!sourceSet.has(k)) drift.push(`canonical-but-not-source:${k}`);
|
|
198
|
+
for (const k of sourceSet) if (!canonicalSet.has(k)) drift.push(`source-but-not-canonical:${k}`);
|
|
199
|
+
return drift;
|
|
200
|
+
}
|
|
201
|
+
|
|
202
|
+
// ---------------------------------------------------------------------------
|
|
203
|
+
// Run classification + path-conditional expected sets
|
|
204
|
+
// ---------------------------------------------------------------------------
|
|
205
|
+
|
|
206
|
+
/**
|
|
207
|
+
* Classify a run based on the observed step set and whether a workflow-failed
|
|
208
|
+
* row was emitted. Classification logic mirrors bkit-ship.md's routing:
|
|
209
|
+
*
|
|
210
|
+
* - close-workflow present → completed (sub-classify by the Step 2 marker)
|
|
211
|
+
* - no regression-guard → MERGED_ON_ENTRY (Step 2 jumped to 13)
|
|
212
|
+
* - conflict-resolve present → PATH_B
|
|
213
|
+
* - else → PATH_A
|
|
214
|
+
* - workflow-failed present (and no close-workflow) → ABORTED
|
|
215
|
+
* - else → IN_PROGRESS
|
|
216
|
+
*
|
|
217
|
+
* MERGED_ON_ENTRY is decided by the explicit `ship-merged-on-entry` row that
|
|
218
|
+
* bkit-ship.md Step 2 sub-step 5 writes on the `state` = MERGED route. It does NOT
|
|
219
|
+
* key on the absence of `ship-merge-pr` / `ship-deferred-sweep`.
|
|
220
|
+
*
|
|
221
|
+
* For corpus rows without the marker, it falls back to requiring BOTH
|
|
222
|
+
* `ship-worktree-setup` and `ship-regression-guard` to be absent (Step 2 writes those
|
|
223
|
+
* two in a single fenced block); a run that dropped only one stays Path A/B.
|
|
224
|
+
*/
|
|
225
|
+
export function classifyRun(
|
|
226
|
+
observedSteps: Set<string>,
|
|
227
|
+
hasWorkflowFailed: boolean,
|
|
228
|
+
hasMergedOnEntryMarker = false,
|
|
229
|
+
): RunPath {
|
|
230
|
+
if (observedSteps.has("ship-close-workflow")) {
|
|
231
|
+
if (hasMergedOnEntryMarker) return "MERGED_ON_ENTRY";
|
|
232
|
+
if (!observedSteps.has("ship-worktree-setup") && !observedSteps.has("ship-regression-guard")) {
|
|
233
|
+
return "MERGED_ON_ENTRY";
|
|
234
|
+
}
|
|
235
|
+
if (observedSteps.has("ship-conflict-resolve")) {
|
|
236
|
+
return "PATH_B";
|
|
237
|
+
}
|
|
238
|
+
return "PATH_A";
|
|
239
|
+
}
|
|
240
|
+
if (hasWorkflowFailed) return "ABORTED";
|
|
241
|
+
return "IN_PROGRESS";
|
|
242
|
+
}
|
|
243
|
+
|
|
244
|
+
/**
|
|
245
|
+
* Compute the set of MANDATORY steps for a given path. Steps NOT in this set
|
|
246
|
+
* are optional and their absence is never a hole.
|
|
247
|
+
*/
|
|
248
|
+
export function computeMandatoryForPath(path: RunPath, sourceUniverse: string[]): Set<string> {
|
|
249
|
+
const universe = new Set(sourceUniverse);
|
|
250
|
+
|
|
251
|
+
switch (path) {
|
|
252
|
+
case "PATH_A":
|
|
253
|
+
// Skip conflict-resolve + retry-loop steps
|
|
254
|
+
return new Set(
|
|
255
|
+
[...universe].filter((s) => !PATH_B_ONLY_STEPS.has(s) && !RETRY_LOOP_STEPS.has(s)),
|
|
256
|
+
);
|
|
257
|
+
|
|
258
|
+
case "PATH_B":
|
|
259
|
+
// Include conflict-resolve, skip retry-loop steps
|
|
260
|
+
return new Set([...universe].filter((s) => !RETRY_LOOP_STEPS.has(s)));
|
|
261
|
+
|
|
262
|
+
case "MERGED_ON_ENTRY":
|
|
263
|
+
// Skip the entire middle + retry-loop steps
|
|
264
|
+
return new Set(
|
|
265
|
+
[...universe].filter((s) => !MERGED_ON_ENTRY_SKIP.has(s) && !RETRY_LOOP_STEPS.has(s)),
|
|
266
|
+
);
|
|
267
|
+
|
|
268
|
+
case "ABORTED":
|
|
269
|
+
// No mandatory steps — the run terminated; post-abort absences are expected
|
|
270
|
+
return new Set();
|
|
271
|
+
|
|
272
|
+
case "IN_PROGRESS":
|
|
273
|
+
// Run not done — can't determine holes
|
|
274
|
+
return new Set();
|
|
275
|
+
}
|
|
276
|
+
}
|
|
277
|
+
|
|
278
|
+
// ---------------------------------------------------------------------------
|
|
279
|
+
// Hole detection
|
|
280
|
+
// ---------------------------------------------------------------------------
|
|
281
|
+
|
|
282
|
+
/**
|
|
283
|
+
* Detect holes: missing mandatory steps + unexpected (invented) steps.
|
|
284
|
+
*
|
|
285
|
+
* For ABORTED runs, the expected set is every step at or before the last
|
|
286
|
+
* observed step in canonical order (minus path-conditional skips). This catches
|
|
287
|
+
* holes BEFORE the abort point (e.g. a run that aborted at merge-pr but skipped
|
|
288
|
+
* regression-guard earlier).
|
|
289
|
+
*/
|
|
290
|
+
export function detectHoles(
|
|
291
|
+
observed: Set<string>,
|
|
292
|
+
sourceUniverse: string[],
|
|
293
|
+
path: RunPath,
|
|
294
|
+
): { missing: string[]; unexpected: string[] } {
|
|
295
|
+
const universeSet = new Set(sourceUniverse);
|
|
296
|
+
|
|
297
|
+
// Unexpected = observed but not in the source universe
|
|
298
|
+
const unexpected = [...observed].filter((s) => !universeSet.has(s)).sort();
|
|
299
|
+
|
|
300
|
+
// Missing = mandatory but not observed
|
|
301
|
+
if (path === "ABORTED") {
|
|
302
|
+
// Determine the last observed step in canonical order
|
|
303
|
+
const lastObservedIdx = SHIP_STEP_ORDER.reduce((lastIdx, key, idx) => {
|
|
304
|
+
if (observed.has(key)) return idx;
|
|
305
|
+
return lastIdx;
|
|
306
|
+
}, -1);
|
|
307
|
+
|
|
308
|
+
if (lastObservedIdx < 0) return { missing: [], unexpected };
|
|
309
|
+
|
|
310
|
+
// For aborted runs, expected = everything before the last step, minus
|
|
311
|
+
// retry-loop steps and minus conflict-resolve (unless it was observed)
|
|
312
|
+
const skipSet = new Set<string>([...RETRY_LOOP_STEPS]);
|
|
313
|
+
if (!observed.has("ship-conflict-resolve")) skipSet.add("ship-conflict-resolve");
|
|
314
|
+
|
|
315
|
+
const missing: string[] = [];
|
|
316
|
+
for (let i = 0; i <= lastObservedIdx; i++) {
|
|
317
|
+
const key = SHIP_STEP_ORDER[i];
|
|
318
|
+
if (skipSet.has(key)) continue;
|
|
319
|
+
if (!observed.has(key)) missing.push(key);
|
|
320
|
+
}
|
|
321
|
+
return { missing, unexpected };
|
|
322
|
+
}
|
|
323
|
+
|
|
324
|
+
if (path === "IN_PROGRESS") {
|
|
325
|
+
return { missing: [], unexpected };
|
|
326
|
+
}
|
|
327
|
+
|
|
328
|
+
const mandatory = computeMandatoryForPath(path, sourceUniverse);
|
|
329
|
+
const missing = [...mandatory].filter((s) => !observed.has(s)).sort();
|
|
330
|
+
return { missing, unexpected };
|
|
331
|
+
}
|
|
332
|
+
|
|
333
|
+
// ---------------------------------------------------------------------------
|
|
334
|
+
// Full audit — parse status.jsonl + ship md, classify, detect, report
|
|
335
|
+
// ---------------------------------------------------------------------------
|
|
336
|
+
|
|
337
|
+
export function auditStatusJsonl(statusJsonl: string, shipMd: string): HoleReport {
|
|
338
|
+
// Derive expected set from source
|
|
339
|
+
const { steps: sourceUniverse, orphanSteps } = deriveExpectedStepSetFromSource(shipMd);
|
|
340
|
+
const sourceCanonicalDrift = checkSourceCanonicalDrift(sourceUniverse);
|
|
341
|
+
|
|
342
|
+
// Parse status rows
|
|
343
|
+
const rows: StatusRow[] = [];
|
|
344
|
+
for (const line of statusJsonl.split("\n")) {
|
|
345
|
+
const trimmed = line.trim();
|
|
346
|
+
if (!trimmed) continue;
|
|
347
|
+
try {
|
|
348
|
+
rows.push(JSON.parse(trimmed) as StatusRow);
|
|
349
|
+
} catch (_e) {
|
|
350
|
+
void _e; // skip unparseable lines (advisory — never throw)
|
|
351
|
+
}
|
|
352
|
+
}
|
|
353
|
+
|
|
354
|
+
// Filter to ship step-done rows + workflow-failed rows
|
|
355
|
+
const shipStepRows = rows.filter(
|
|
356
|
+
(r) => r.type === "step-done" && r.workflow === "ship" && typeof r.step === "string",
|
|
357
|
+
);
|
|
358
|
+
const hasWorkflowFailed = rows.some((r) => r.type === "workflow-failed" && r.workflow === "ship");
|
|
359
|
+
const hasMergedOnEntryMarker = rows.some(
|
|
360
|
+
(r) => r.type === "ship-merged-on-entry" && r.workflow === "ship",
|
|
361
|
+
);
|
|
362
|
+
|
|
363
|
+
// Collect observed steps
|
|
364
|
+
const observed = new Set<string>();
|
|
365
|
+
for (const r of shipStepRows) {
|
|
366
|
+
if (r.step) observed.add(r.step);
|
|
367
|
+
}
|
|
368
|
+
|
|
369
|
+
// Classify + detect
|
|
370
|
+
const runPath = classifyRun(observed, hasWorkflowFailed, hasMergedOnEntryMarker);
|
|
371
|
+
const { missing, unexpected } = detectHoles(observed, sourceUniverse, runPath);
|
|
372
|
+
|
|
373
|
+
return {
|
|
374
|
+
missing,
|
|
375
|
+
unexpected,
|
|
376
|
+
path: runPath,
|
|
377
|
+
observed: [...observed].sort(),
|
|
378
|
+
sourceUniverse: [...sourceUniverse].sort(),
|
|
379
|
+
sourceCanonicalDrift,
|
|
380
|
+
orphanSteps,
|
|
381
|
+
};
|
|
382
|
+
}
|
|
383
|
+
|
|
384
|
+
// ---------------------------------------------------------------------------
|
|
385
|
+
// Advisory report formatter
|
|
386
|
+
// ---------------------------------------------------------------------------
|
|
387
|
+
|
|
388
|
+
export function formatAdvisoryReport(report: HoleReport): string {
|
|
389
|
+
const lines: string[] = [];
|
|
390
|
+
lines.push("[bkit-status-holes] ADVISORY — fail-open (exit 0 regardless)");
|
|
391
|
+
lines.push(` path: ${report.path}`);
|
|
392
|
+
lines.push(` observed: ${report.observed.length} step(s)`);
|
|
393
|
+
|
|
394
|
+
if (report.sourceCanonicalDrift.length > 0) {
|
|
395
|
+
lines.push(` ⚠ source/canonical drift: ${report.sourceCanonicalDrift.join(", ")}`);
|
|
396
|
+
}
|
|
397
|
+
|
|
398
|
+
if (report.orphanSteps.length > 0) {
|
|
399
|
+
lines.push(` ⚠ recorded outside any numbered step: ${report.orphanSteps.join(", ")}`);
|
|
400
|
+
}
|
|
401
|
+
|
|
402
|
+
if (report.missing.length > 0) {
|
|
403
|
+
lines.push(` missing (mandatory for ${report.path}): ${report.missing.join(", ")}`);
|
|
404
|
+
} else {
|
|
405
|
+
lines.push(` missing: none`);
|
|
406
|
+
}
|
|
407
|
+
|
|
408
|
+
if (report.unexpected.length > 0) {
|
|
409
|
+
lines.push(` unexpected (invented names): ${report.unexpected.join(", ")}`);
|
|
410
|
+
} else {
|
|
411
|
+
lines.push(` unexpected: none`);
|
|
412
|
+
}
|
|
413
|
+
|
|
414
|
+
return lines.join("\n");
|
|
415
|
+
}
|
|
416
|
+
|
|
417
|
+
// ---------------------------------------------------------------------------
|
|
418
|
+
// CLI entry — always exits 0 (advisory / fail-open)
|
|
419
|
+
// ---------------------------------------------------------------------------
|
|
420
|
+
|
|
421
|
+
export function main(argv: string[]): void {
|
|
422
|
+
const args = argv.slice(2);
|
|
423
|
+
|
|
424
|
+
// Resolve the ship-md override FIRST so its VALUE is never mistaken for a
|
|
425
|
+
// positional. `args.find(a => !a.startsWith("--"))` alone picks up the value
|
|
426
|
+
// of `--ship-md` when the flag is passed before the status path.
|
|
427
|
+
const mdFlagIdx = args.indexOf("--ship-md");
|
|
428
|
+
const shipMdOverride = mdFlagIdx >= 0 ? args[mdFlagIdx + 1] : undefined;
|
|
429
|
+
const consumed = new Set<number>();
|
|
430
|
+
if (mdFlagIdx >= 0) {
|
|
431
|
+
consumed.add(mdFlagIdx);
|
|
432
|
+
if (shipMdOverride) consumed.add(mdFlagIdx + 1);
|
|
433
|
+
}
|
|
434
|
+
|
|
435
|
+
// Every remaining positional is a status.jsonl to audit — one report each, so
|
|
436
|
+
// a whole corpus can be swept in one advisory CI step.
|
|
437
|
+
const statusPaths = args.filter((a, i) => !consumed.has(i) && !a.startsWith("--"));
|
|
438
|
+
if (statusPaths.length === 0) {
|
|
439
|
+
process.stdout.write("[bkit-status-holes] no status.jsonl path given — skipping (advisory)\n");
|
|
440
|
+
return; // exit 0
|
|
441
|
+
}
|
|
442
|
+
|
|
443
|
+
const shipMdPath = shipMdOverride || path.join(getWorkflowsRoot(), "bkit-ship.md");
|
|
444
|
+
|
|
445
|
+
let shipMd = "";
|
|
446
|
+
try {
|
|
447
|
+
shipMd = fs.readFileSync(shipMdPath, "utf-8");
|
|
448
|
+
} catch {
|
|
449
|
+
process.stdout.write(`[bkit-status-holes] ${shipMdPath} not found — skipping (advisory)\n`);
|
|
450
|
+
return; // exit 0
|
|
451
|
+
}
|
|
452
|
+
|
|
453
|
+
for (const statusPath of statusPaths) {
|
|
454
|
+
// Read inputs (advisory — missing files = skip, never fail)
|
|
455
|
+
let statusJsonl = "";
|
|
456
|
+
try {
|
|
457
|
+
statusJsonl = fs.readFileSync(statusPath, "utf-8");
|
|
458
|
+
} catch {
|
|
459
|
+
process.stdout.write(`[bkit-status-holes] ${statusPath} not found — skipping (advisory)\n`);
|
|
460
|
+
continue; // exit 0
|
|
461
|
+
}
|
|
462
|
+
|
|
463
|
+
const report = auditStatusJsonl(statusJsonl, shipMd);
|
|
464
|
+
process.stdout.write(`\n${statusPath}\n`);
|
|
465
|
+
process.stdout.write(formatAdvisoryReport(report) + "\n");
|
|
466
|
+
}
|
|
467
|
+
// ALWAYS exit 0 — this is advisory / fail-open
|
|
468
|
+
}
|
|
469
|
+
|
|
470
|
+
// Run if invoked directly (ESM-compatible main-module detection)
|
|
471
|
+
if (process.argv[1]) {
|
|
472
|
+
try {
|
|
473
|
+
if (fs.realpathSync(fileURLToPath(import.meta.url)) === fs.realpathSync(process.argv[1])) {
|
|
474
|
+
main(process.argv);
|
|
475
|
+
}
|
|
476
|
+
} catch (_e) {
|
|
477
|
+
void _e; // realpathSync can fail on symlinks — skip (advisory, never crash)
|
|
478
|
+
}
|
|
479
|
+
}
|