@cbartens/bkit 6.0.0 → 6.1.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 +154 -151
- package/.bkit/core/.agents/context.md +95 -29
- package/.bkit/core/.agents/docs.md +17 -15
- package/.bkit/core/.agents/plugins/bkit/hooks/bkit-gateguard.cjs +1 -0
- package/.bkit/core/.agents/plugins/bkit/hooks/bkit-guardrails.cjs +6 -5
- package/.bkit/core/.agents/plugins/bkit/hooks/bkit-readguard.cjs +1 -0
- package/.bkit/core/.agents/plugins/bkit/hooks/bkit-rules.cjs +65 -0
- package/.bkit/core/.agents/rules.md +108 -107
- package/.bkit/core/.agents/skills.md +63 -15
- package/.bkit/core/.bkit/README.md +154 -151
- package/.bkit/core/.bkit/authoring.md +714 -84
- package/.bkit/core/.bkit/cli.md +407 -0
- package/.bkit/core/.bkit/cloud.md +281 -193
- package/.bkit/core/.bkit/comparison.md +43 -41
- package/.bkit/core/.bkit/install.md +154 -84
- package/.bkit/core/.bkit/jsonl.md +193 -130
- package/.bkit/core/.bkit/pipeline.md +114 -114
- package/.bkit/core/.bkit/prompts.md +272 -165
- package/.bkit/core/.bkit/providers.md +457 -271
- package/.bkit/core/.bkit/router.md +69 -0
- package/.bkit/core/.bkit/templates.md +529 -256
- package/.bkit/core/.bkit/trackers.md +80 -52
- package/.bkit/core/.bkit/workflows.md +589 -504
- package/.bkit/core/.claude/hooks/bkit-gateguard.cjs +2 -2
- package/.bkit/core/.claude/hooks/bkit-guardrails.cjs +3 -3
- package/.bkit/core/.claude/hooks/bkit-preflight.sh +45 -14
- package/.bkit/core/.codex/hooks/bkit-guardrails.cjs +3 -3
- package/.bkit/core/.codex/hooks/bkit-rules.cjs +57 -0
- package/.bkit/core/.cursor/hooks/bkit-guardrails.cjs +7 -7
- package/.bkit/core/.cursor/hooks/bkit-preflight.sh +47 -12
- package/.bkit/core/.opencode/plugin/bkit-rules.js +89 -0
- package/.bkit/core/AGENTS.md +5 -73
- package/.bkit/core/docs/templates/bkit-audit-accessibility.md +127 -105
- package/.bkit/core/docs/templates/bkit-audit-adoption.md +104 -70
- package/.bkit/core/docs/templates/bkit-audit-agents.md +94 -72
- package/.bkit/core/docs/templates/bkit-audit-aio-seo.md +99 -78
- package/.bkit/core/docs/templates/bkit-audit-analytics.md +140 -82
- package/.bkit/core/docs/templates/bkit-audit-annotations.md +98 -72
- package/.bkit/core/docs/templates/bkit-audit-app-performance.md +121 -96
- package/.bkit/core/docs/templates/bkit-audit-app-store.md +157 -76
- package/.bkit/core/docs/templates/bkit-audit-architecture.md +113 -71
- package/.bkit/core/docs/templates/bkit-audit-ci-performance.md +75 -72
- package/.bkit/core/docs/templates/bkit-audit-config.md +122 -76
- package/.bkit/core/docs/templates/bkit-audit-cost.md +85 -74
- package/.bkit/core/docs/templates/bkit-audit-coverage.md +75 -68
- package/.bkit/core/docs/templates/bkit-audit-database.md +101 -70
- package/.bkit/core/docs/templates/bkit-audit-dead-code.md +164 -83
- package/.bkit/core/docs/templates/bkit-audit-deferrals.md +115 -86
- package/.bkit/core/docs/templates/bkit-audit-dependencies.md +264 -88
- package/.bkit/core/docs/templates/bkit-audit-documentation.md +118 -93
- package/.bkit/core/docs/templates/bkit-audit-duplication.md +139 -86
- package/.bkit/core/docs/templates/bkit-audit-failures.md +110 -81
- package/.bkit/core/docs/templates/bkit-audit-flakes.md +99 -74
- package/.bkit/core/docs/templates/bkit-audit-gates.md +105 -77
- package/.bkit/core/docs/templates/bkit-audit-issues.md +104 -80
- package/.bkit/core/docs/templates/bkit-audit-llm.md +131 -58
- package/.bkit/core/docs/templates/bkit-audit-logs.md +123 -100
- package/.bkit/core/docs/templates/bkit-audit-models.md +98 -53
- package/.bkit/core/docs/templates/bkit-audit-privacy.md +56 -52
- package/.bkit/core/docs/templates/bkit-audit-prompts.md +63 -54
- package/.bkit/core/docs/templates/bkit-audit-red-team.md +124 -68
- package/.bkit/core/docs/templates/bkit-audit-reliability.md +95 -70
- package/.bkit/core/docs/templates/bkit-audit-repo.md +169 -73
- package/.bkit/core/docs/templates/bkit-audit-security.md +206 -96
- package/.bkit/core/docs/templates/bkit-audit-slop.md +77 -70
- package/.bkit/core/docs/templates/bkit-audit-testing.md +162 -114
- package/.bkit/core/docs/templates/bkit-audit-usability.md +113 -71
- package/.bkit/core/docs/templates/bkit-plan.md +138 -132
- package/.bkit/core/engine/checks/after/auth.ts +40 -37
- package/.bkit/core/engine/checks/after/ci-yml.ts +65 -2
- package/.bkit/core/engine/checks/after/index.ts +12 -2
- package/.bkit/core/engine/checks/after/tools.ts +80 -33
- package/.bkit/core/engine/checks/before/context-fetch.ts +227 -33
- package/.bkit/core/engine/checks/before/env.ts +1 -1
- package/.bkit/core/engine/checks/before/index.ts +7 -0
- package/.bkit/core/engine/checks/before/repo.ts +40 -0
- package/.bkit/core/engine/checks/status-holes.ts +916 -123
- package/.bkit/core/engine/checks/tips/catalogue.ts +68 -17
- package/.bkit/core/engine/checks/tips/detect.ts +32 -0
- package/.bkit/core/engine/checks/tips/index.ts +47 -6
- package/.bkit/core/engine/cli.ts +238 -84
- package/.bkit/core/engine/commands/analysis.ts +128 -76
- package/.bkit/core/engine/commands/ci/ci.ts +363 -29
- package/.bkit/core/engine/commands/ci/pins.ts +172 -0
- package/.bkit/core/engine/commands/ci/push-gate.ts +223 -0
- package/.bkit/core/engine/commands/install/uninstall.ts +21 -27
- package/.bkit/core/engine/commands/install/upgrade.ts +32 -15
- package/.bkit/core/engine/commands/land.ts +126 -11
- package/.bkit/core/engine/commands/lib.ts +303 -6
- package/.bkit/core/engine/commands/registry.ts +6 -2
- package/.bkit/core/engine/commands/setup/setup.ts +1 -0
- package/.bkit/core/engine/commands/stats.ts +91 -35
- package/.bkit/core/engine/commands/workflow/branches.ts +1477 -117
- package/.bkit/core/engine/commands/workflow/challenge.ts +114 -39
- package/.bkit/core/engine/commands/workflow/completeness.ts +109 -0
- package/.bkit/core/engine/commands/workflow/context.ts +433 -55
- package/.bkit/core/engine/commands/workflow/counters.ts +244 -39
- package/.bkit/core/engine/commands/workflow/decisions.ts +61 -17
- package/.bkit/core/engine/commands/workflow/disk.ts +237 -55
- package/.bkit/core/engine/commands/workflow/fids.ts +19 -1
- package/.bkit/core/engine/commands/workflow/issues.ts +6 -0
- package/.bkit/core/engine/commands/workflow/ledgers.ts +458 -18
- package/.bkit/core/engine/commands/workflow/locks.ts +2 -0
- package/.bkit/core/engine/commands/workflow/plan-blocks.ts +124 -15
- package/.bkit/core/engine/commands/workflow/plans.ts +257 -0
- package/.bkit/core/engine/commands/workflow/prs.ts +12 -3
- package/.bkit/core/engine/commands/workflow/repo.ts +8 -0
- package/.bkit/core/engine/commands/workflow/roadmap.ts +56 -15
- package/.bkit/core/engine/commands/workflow/run-facts.ts +22 -31
- package/.bkit/core/engine/commands/workflow/runs.ts +652 -34
- package/.bkit/core/engine/commands/workflow/runtime.ts +3 -0
- package/.bkit/core/engine/commands/workflow/skills.ts +1 -0
- package/.bkit/core/engine/commands/workflow/status.ts +200 -17
- package/.bkit/core/engine/commands/workflow/step-table.ts +75 -33
- package/.bkit/core/engine/commands/workflow/steps.ts +635 -24
- package/.bkit/core/engine/commands/workflow/summary-findings.ts +177 -0
- package/.bkit/core/engine/commands/workflow/summary.ts +192 -46
- package/.bkit/core/engine/commands/workflow/tasks.ts +409 -0
- package/.bkit/core/engine/commands/workflow/test-blocks.ts +254 -0
- package/.bkit/core/engine/commands/workflow/tests-changed.ts +201 -0
- package/.bkit/core/engine/commands/workflow/tests.ts +1285 -356
- package/.bkit/core/engine/commands/workflow/workflows.ts +228 -43
- package/.bkit/core/engine/commands/workflow/worktrees.ts +389 -47
- package/.bkit/core/engine/install/cloud-env.ts +251 -121
- package/.bkit/core/engine/install/context-ci-workflow.ts +102 -0
- package/.bkit/core/engine/install/manifest.ts +60 -12
- package/.bkit/core/engine/install/modules/antigravity.ts +3 -2
- package/.bkit/core/engine/install/modules/cloud.ts +3 -3
- package/.bkit/core/engine/install/modules/codex.ts +15 -2
- package/.bkit/core/engine/install/modules/core.ts +956 -52
- package/.bkit/core/engine/install/modules/cursor.ts +6 -6
- package/.bkit/core/engine/install/modules/opencode.ts +16 -4
- package/.bkit/core/engine/install/template-notes.ts +130 -0
- package/.bkit/core/engine/install/version-file.ts +3 -2
- package/.bkit/core/engine/install/write.ts +5 -0
- package/.bkit/core/engine/ledgers/compact.ts +124 -0
- package/.bkit/core/engine/ledgers/journal.ts +291 -0
- package/.bkit/core/engine/ledgers/status.ts +160 -9
- package/.bkit/core/engine/ledgers/telemetry.ts +158 -21
- package/.bkit/core/engine/render/hosts.ts +114 -14
- package/.bkit/core/engine/shared/bkit-latest.ts +26 -4
- package/.bkit/core/engine/shared/dep-updater.ts +60 -0
- package/.bkit/core/engine/shared/egress.ts +1 -1
- package/.bkit/core/engine/shared/package-manager.ts +9 -0
- package/.bkit/core/engine/shared/settings.ts +92 -17
- package/.bkit/core/engine/shared/timeouts.ts +2 -0
- package/.bkit/core/engine/tools/cli-doc.ts +111 -0
- package/.bkit/core/engine/tools/grammar-density.ts +1 -1
- package/.bkit/core/engine/tools/instructions-sources.ts +15 -17
- package/.bkit/core/engine/tools/instructions.ts +94 -43
- package/.bkit/core/hooks/antigravity-hook.js +25 -10
- package/.bkit/core/hooks/gateguard-engine.js +53 -29
- package/.bkit/core/hooks/guardrails-shell.js +4 -4
- package/.bkit/core/hooks/guardrails-tiers.js +3 -3
- package/.bkit/core/hooks/preflight-linear.sh +9 -9
- package/.bkit/core/hooks/preflight-rules.sh +8 -0
- package/.bkit/core/hooks/readguard-engine.js +29 -10
- package/.bkit/core/hooks/session-rules-advisory.js +61 -0
- package/.bkit/core/prompts/bkit-audit-generate.md +187 -116
- package/.bkit/core/prompts/bkit-build-challenge-1.md +56 -37
- package/.bkit/core/prompts/bkit-build-challenge-2.md +65 -45
- package/.bkit/core/prompts/bkit-build-install-skills.md +38 -29
- package/.bkit/core/prompts/bkit-build-plan-convert.md +43 -32
- package/.bkit/core/prompts/bkit-build-plan-current.md +49 -39
- package/.bkit/core/prompts/bkit-build-plan-gaps-remediate.md +79 -55
- package/.bkit/core/prompts/bkit-build-plan-tasks.md +149 -0
- package/.bkit/core/prompts/bkit-build-plan-tests.md +120 -0
- package/.bkit/core/prompts/bkit-build-plan-verify.md +87 -50
- package/.bkit/core/prompts/bkit-debug-abort-handover.md +36 -35
- package/.bkit/core/prompts/bkit-debug-failure-diagnose.md +96 -64
- package/.bkit/core/prompts/bkit-debug-failure-remediate.md +54 -45
- package/.bkit/core/prompts/bkit-debug-failure-reproduce.md +42 -33
- package/.bkit/core/prompts/bkit-debug-failure-soak.md +53 -37
- package/.bkit/core/prompts/bkit-design-brainstorm-ideate-1.md +35 -30
- package/.bkit/core/prompts/bkit-design-brainstorm-ideate-2.md +34 -29
- package/.bkit/core/prompts/bkit-design-brainstorm-ideate-3.md +32 -28
- package/.bkit/core/prompts/bkit-design-generate.md +68 -52
- package/.bkit/core/prompts/bkit-design-organise.md +73 -35
- package/.bkit/core/prompts/bkit-design-review-1.md +58 -54
- package/.bkit/core/prompts/bkit-design-review-2.md +54 -50
- package/.bkit/core/prompts/bkit-design-spike.md +54 -47
- package/.bkit/core/prompts/bkit-design-update.md +42 -31
- package/.bkit/core/prompts/bkit-plan-generate.md +76 -58
- package/.bkit/core/prompts/bkit-plan-review-1.md +63 -49
- package/.bkit/core/prompts/bkit-plan-review-2.md +60 -48
- package/.bkit/core/prompts/bkit-plan-scope-check.md +53 -46
- package/.bkit/core/prompts/bkit-plan-update.md +70 -52
- package/.bkit/core/prompts/bkit-ship-conflict-resolve.md +82 -50
- package/.bkit/core/prompts/bkit-ship-deferred-sweep.md +80 -45
- package/.bkit/core/prompts/bkit-ship-update-docs.md +35 -29
- package/.bkit/core/prompts/bkit-utility-compress-markdown.md +55 -49
- package/.bkit/core/prompts/bkit-utility-update-decisions.md +76 -49
- package/.bkit/core/prompts/bkit-utility-update-deferrals.md +70 -41
- package/.bkit/core/prompts/bkit-utility-update-documentation.md +33 -30
- package/.bkit/core/prompts/bkit-utility-update-failures.md +73 -43
- package/.bkit/core/prompts/bkit-utility-update-knowledge.md +77 -50
- package/.bkit/core/prompts/bkit-utility-update-roadmap.md +77 -45
- package/.bkit/core/prompts/bkit-utility-update-tracker.md +144 -68
- package/.bkit/core/workflows/bkit-auto.md +53 -30
- package/.bkit/core/workflows/bkit-build.md +635 -304
- package/.bkit/core/workflows/bkit-debug.md +301 -148
- package/.bkit/core/workflows/bkit-design.md +167 -95
- package/.bkit/core/workflows/bkit-plan.md +172 -84
- package/.bkit/core/workflows/bkit-ship.md +299 -152
- package/.bkit/shared/.agents/plugins/bkit/hooks.json +10 -0
- package/.bkit/shared/.claude/bkit-cloud.md +12 -10
- package/.bkit/shared/.claude/settings.json +3 -0
- package/.bkit/shared/.codex/bkit-cloud.md +98 -0
- package/.bkit/shared/.codex/hooks.json +20 -0
- package/.bkit/shared/.cursor/bkit-cloud.md +3 -3
- package/.bkit/shared/.opencode/opencode.json +1 -1
- package/.bkit/shared/CLAUDE.md +5 -1
- package/.bkit/shared/GEMINI.md +4 -1
- package/.bkit/shared/docs/architecture.md +4 -7
- package/.bkit/shared/docs/data-schema.md +4 -7
- package/.bkit/shared/docs/deployments.md +239 -166
- package/.bkit/shared/docs/design.md +11 -12
- package/.bkit/shared/docs/noise.md +8 -7
- package/.bkit/shared/docs/observability.md +5 -8
- package/.bkit/shared/docs/security.md +35 -17
- package/.bkit/shared/docs/setup.md +29 -18
- package/.bkit/shared/docs/technology.md +3 -6
- package/.bkit/shared/docs/testing.md +282 -176
- package/.bkit/shared/gitignore +6 -2
- package/.bkit/templates/.claude/hooks/bkit-cloud-bootstrap.sh +15 -16
- package/.bkit/templates/.cursor/Dockerfile +12 -8
- package/.bkit/templates/.cursor/environment.json +1 -1
- package/.bkit/templates/.github/ISSUE_TEMPLATE/bkit-bug.yml +10 -8
- package/.bkit/templates/.github/ISSUE_TEMPLATE/bkit-change.yml +24 -12
- package/.bkit/templates/.github/ISSUE_TEMPLATE/bkit-idea.yml +3 -3
- package/.bkit/templates/.github/renovate.json5 +34 -6
- package/.bkit/templates/.github/workflows/bkit-ci.yml +53 -50
- package/.bkit/templates/.github/workflows/bkit-cloud.yml +13 -14
- package/.bkit/templates/.github/workflows/bkit-health.yml +97 -0
- package/.bkit/templates/.github/workflows/bkit-renovate.yml +5 -4
- package/.bkit/templates/.github/workflows/bkit-trivy.yml +5 -4
- package/.bkit/templates/.husky/pre-commit +2 -2
- package/.bkit/templates/.husky/pre-push +95 -35
- package/.bkit/templates/.prettierignore +6 -7
- package/.bkit/templates/.vale.ini +27 -27
- package/.bkit/templates/context/bkit-cloudrun.md +23 -15
- package/.bkit/templates/context/bkit-expo.md +70 -52
- package/.bkit/templates/context/bkit-github.md +93 -56
- package/.bkit/templates/context/bkit-inngest.md +21 -15
- package/.bkit/templates/context/bkit-maestro.md +22 -16
- package/.bkit/templates/context/bkit-playwright.md +23 -17
- package/.bkit/templates/context/bkit-resend.md +12 -10
- package/.bkit/templates/context/bkit-sentry.md +30 -20
- package/.bkit/templates/context/bkit-serena.md +8 -7
- package/.bkit/templates/context/bkit-stripe.md +14 -13
- package/.bkit/templates/context/bkit-supabase.md +16 -13
- package/.bkit/templates/context/bkit-tavily.md +14 -11
- package/.bkit/templates/context/bkit-vercel.md +27 -18
- package/.bkit/templates/docs/capabilities.md +15 -14
- package/.bkit/templates/scripts/ci/{check-accepted-divergences.mjs → bkit-check-accepted-divergences.mjs} +6 -3
- package/.bkit/templates/scripts/ci/{check-accepted-divergences.test.mjs → bkit-check-accepted-divergences.test.mjs} +3 -3
- package/.bkit/templates/scripts/ci/{check-capstone.mjs → bkit-check-capstone.mjs} +2 -2
- package/.bkit/templates/scripts/ci/{check-capstone.test.mjs → bkit-check-capstone.test.mjs} +4 -4
- package/.bkit/templates/scripts/ci/{check-dependency-audit.mjs → bkit-check-dependency-audit.mjs} +103 -18
- package/.bkit/templates/scripts/ci/{check-dependency-audit.test.mjs → bkit-check-dependency-audit.test.mjs} +31 -3
- package/.bkit/templates/scripts/ci/bkit-machine-lock.sh +387 -0
- package/.bkit/templates/scripts/ci/bkit-test-awake.mjs +75 -0
- package/.bkit/templates/scripts/ci/bkit-test-awake.test.mjs +160 -0
- package/.bkit/templates/scripts/ci/lanes/{resolve-push-base.mjs → bkit-resolve-push-base.mjs} +3 -3
- package/.bkit/templates/scripts/ci/lanes/{resolve-push-base.test.mjs → bkit-resolve-push-base.test.mjs} +4 -4
- package/.bkit/templates/scripts/cleanup/bkit-disk-prune.mjs +9 -1
- package/.bkit/templates/scripts/graphify/bkit-graph-drift.py +1 -1
- package/.bkit/templates/scripts/graphify/bkit-graph-eager.py +3 -3
- package/.bkit/templates/scripts/graphify/bkit-graph-embed.py +63 -0
- package/.bkit/templates/scripts/graphify/bkit-graph-imports.py +2 -2
- package/.bkit/templates/scripts/graphify/bkit-graph-pre-push.sh +69 -18
- package/.bkit/templates/scripts/graphify/bkit-graph-repair.py +3 -3
- package/.bkit/templates/scripts/graphify/bkit-graph-surface.py +1 -1
- package/.bkit/templates/scripts/graphify/bkit-graphify-graphml.py +1 -1
- package/.bkit/templates/scripts/graphify/bkit-graphify-rollup.py +197 -126
- package/.bkit/templates/scripts/graphify/bkit-graphify.sh +64 -41
- package/.bkit/templates/scripts/slop/bkit-slop-type-suppression.mjs +23 -7
- package/.bkit/templates/slop-scan.config.json +9 -2
- package/CHANGELOG.md +119 -0
- package/README.md +250 -76
- package/dist/checks/after/auth.js +36 -33
- package/dist/checks/after/ci-yml.js +52 -2
- package/dist/checks/after/index.js +12 -4
- package/dist/checks/after/tools.js +73 -33
- package/dist/checks/before/context-fetch.js +218 -33
- package/dist/checks/before/env.js +1 -1
- package/dist/checks/before/index.js +6 -2
- package/dist/checks/before/repo.js +35 -1
- package/dist/checks/status-holes.js +739 -114
- package/dist/checks/tips/catalogue.js +59 -17
- package/dist/checks/tips/detect.js +30 -0
- package/dist/checks/tips/index.js +48 -6
- package/dist/cli.js +222 -84
- package/dist/commands/analysis.js +77 -53
- package/dist/commands/ci/ci.js +302 -25
- package/dist/commands/ci/pins.js +142 -0
- package/dist/commands/ci/push-gate.js +194 -0
- package/dist/commands/install/uninstall.js +23 -27
- package/dist/commands/install/upgrade.js +21 -11
- package/dist/commands/land.js +126 -10
- package/dist/commands/lib.js +244 -5
- package/dist/commands/registry.js +6 -2
- package/dist/commands/setup/setup.js +1 -0
- package/dist/commands/stats.js +69 -30
- package/dist/commands/workflow/branches.js +1232 -111
- package/dist/commands/workflow/challenge.js +90 -37
- package/dist/commands/workflow/completeness.js +97 -0
- package/dist/commands/workflow/context.js +371 -51
- package/dist/commands/workflow/counters.js +206 -40
- package/dist/commands/workflow/decisions.js +60 -17
- package/dist/commands/workflow/disk.js +213 -55
- package/dist/commands/workflow/fids.js +18 -1
- package/dist/commands/workflow/issues.js +6 -0
- package/dist/commands/workflow/ledgers.js +372 -21
- package/dist/commands/workflow/locks.js +2 -0
- package/dist/commands/workflow/plan-blocks.js +78 -14
- package/dist/commands/workflow/plans.js +205 -0
- package/dist/commands/workflow/prs.js +12 -3
- package/dist/commands/workflow/repo.js +6 -0
- package/dist/commands/workflow/roadmap.js +50 -17
- package/dist/commands/workflow/run-facts.js +23 -28
- package/dist/commands/workflow/runs.js +530 -33
- package/dist/commands/workflow/runtime.js +3 -0
- package/dist/commands/workflow/skills.js +1 -0
- package/dist/commands/workflow/status.js +166 -19
- package/dist/commands/workflow/step-table.js +61 -29
- package/dist/commands/workflow/steps.js +542 -26
- package/dist/commands/workflow/summary-findings.js +117 -0
- package/dist/commands/workflow/summary.js +154 -41
- package/dist/commands/workflow/tasks.js +378 -0
- package/dist/commands/workflow/test-blocks.js +231 -0
- package/dist/commands/workflow/tests-changed.js +172 -0
- package/dist/commands/workflow/tests.js +1013 -321
- package/dist/commands/workflow/workflows.js +191 -38
- package/dist/commands/workflow/worktrees.js +310 -42
- package/dist/install/cloud-env.js +233 -99
- package/dist/install/context-ci-workflow.js +85 -0
- package/dist/install/manifest.js +57 -12
- package/dist/install/modules/antigravity.js +3 -2
- package/dist/install/modules/cloud.js +3 -3
- package/dist/install/modules/codex.js +12 -2
- package/dist/install/modules/core.js +851 -53
- package/dist/install/modules/cursor.js +6 -6
- package/dist/install/modules/opencode.js +11 -5
- package/dist/install/template-notes.js +116 -0
- package/dist/install/version-file.js +3 -2
- package/dist/ledgers/compact.js +87 -0
- package/dist/ledgers/journal.js +233 -0
- package/dist/ledgers/status.js +115 -5
- package/dist/ledgers/telemetry.js +121 -17
- package/dist/render/hosts.js +100 -14
- package/dist/shared/bkit-latest.js +26 -4
- package/dist/shared/dep-updater.js +49 -0
- package/dist/shared/egress.js +1 -1
- package/dist/shared/package-manager.js +6 -0
- package/dist/shared/settings.js +59 -10
- package/dist/shared/timeouts.js +2 -0
- package/dist/tools/cli-doc.js +97 -0
- package/dist/tools/grammar-density.js +1 -1
- package/dist/tools/instructions-sources.js +15 -16
- package/dist/tools/instructions.js +83 -39
- package/package.json +58 -42
- package/.bkit/core/.bkit/lite.md +0 -73
- package/.bkit/core/engine/commands/workflow/workstreams.ts +0 -172
- package/.bkit/core/prompts/bkit-build-plan-execute.md +0 -124
- package/.bkit/templates/scripts/ci/bkit-local-stack-lock.sh +0 -194
- package/dist/commands/workflow/workstreams.js +0 -149
- /package/.bkit/templates/.vale/styles/{House → Bkit}/Filler.yml +0 -0
- /package/.bkit/templates/.vale/styles/{House → Bkit}/Hedging.yml +0 -0
- /package/.bkit/templates/.vale/styles/{House → Bkit}/LLMSlop.yml +0 -0
- /package/.bkit/templates/.vale/styles/{House → Bkit}/Verbose.yml +0 -0
- /package/.bkit/templates/scripts/ci/{accepted-advisories.json → bkit-accepted-advisories.json} +0 -0
- /package/.bkit/templates/scripts/ci/{accepted-divergences.json → bkit-accepted-divergences.json} +0 -0
- /package/.bkit/templates/scripts/launchd/{launchd.env.example → bkit-launchd.env.example} +0 -0
- /package/.bkit/templates/scripts/launchd/{ai.bkit.launchd.plist → bkit-launchd.plist} +0 -0
|
@@ -1,10 +1,10 @@
|
|
|
1
1
|
// checks/status-holes.ts — Tier-3 advisory status-hole detector.
|
|
2
2
|
//
|
|
3
|
-
// A fail-open advisory that compares the
|
|
4
|
-
// status.jsonl against the
|
|
5
|
-
//
|
|
6
|
-
// runtime (headings + step
|
|
7
|
-
// (decision 384-tier3-promotion).
|
|
3
|
+
// A fail-open advisory that compares the steps RECORDED in each run of a
|
|
4
|
+
// status.jsonl against the steps the workflow PROSE says should be there. It
|
|
5
|
+
// derives the expected set from .bkit/core/workflows/bkit-{workflow}.md at
|
|
6
|
+
// runtime (headings + --step= literals) — NEVER a hand-maintained table
|
|
7
|
+
// (decision 384-tier3-promotion). Each run's workflow is inferred from its rows.
|
|
8
8
|
//
|
|
9
9
|
// ADVISORY / FAIL-OPEN: the CLI exits 0 unconditionally — even when holes are
|
|
10
10
|
// found (decision 384-tier3-promotion).
|
|
@@ -20,13 +20,17 @@
|
|
|
20
20
|
// appear only in the merge-retry loop.
|
|
21
21
|
//
|
|
22
22
|
// Usage (advisory CI step or manual):
|
|
23
|
-
// npx tsx .bkit/core/engine/checks/status-holes.ts <status.jsonl
|
|
23
|
+
// npx tsx .bkit/core/engine/checks/status-holes.ts <status.jsonl>...
|
|
24
24
|
// # exits 0 always; prints advisory report to stdout
|
|
25
|
+
import { createHash } from "node:crypto";
|
|
25
26
|
import * as fs from "node:fs";
|
|
26
27
|
import * as path from "node:path";
|
|
27
28
|
import { fileURLToPath } from "node:url";
|
|
29
|
+
import { DECISION_ROUTES, WORKFLOW_STEPS } from "../commands/workflow/step-table.js";
|
|
30
|
+
import { substituteWorkflow } from "../render/trackers.js";
|
|
28
31
|
import { parseJson } from "../shared/json.js";
|
|
29
32
|
import { getWorkflowsRoot } from "../shared/package-roots.js";
|
|
33
|
+
import { ciRoundMatches } from "../ledgers/status.js";
|
|
30
34
|
// ---------------------------------------------------------------------------
|
|
31
35
|
// Canonical ship step order (mirrors audits/workflows/ship-invariants.test.ts
|
|
32
36
|
// CANONICAL_SHIP_STEP_KEYS — the frozen schema). The detector cross-checks its
|
|
@@ -74,83 +78,636 @@ const MERGED_ON_ENTRY_SKIP = new Set([
|
|
|
74
78
|
"ship-merge-pr",
|
|
75
79
|
// failure-diagnose/remediate are already in RETRY_LOOP_STEPS (never expected)
|
|
76
80
|
]);
|
|
77
|
-
// ---------------------------------------------------------------------------
|
|
78
|
-
// Source derivation — parse bkit-ship.md to find the expected step universe.
|
|
79
|
-
// ---------------------------------------------------------------------------
|
|
80
81
|
/**
|
|
81
|
-
*
|
|
82
|
-
*
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
|
|
86
|
-
|
|
87
|
-
|
|
88
|
-
|
|
89
|
-
|
|
90
|
-
*
|
|
91
|
-
*
|
|
92
|
-
*
|
|
82
|
+
* Step rows an engine verb writes itself, keyed by noun + verb: `tests red` writes the
|
|
83
|
+
* `RED_STEP` row of `commands/workflow/tests.ts` inside build Step 7.
|
|
84
|
+
*/
|
|
85
|
+
const VERB_ROWS = {
|
|
86
|
+
"tests red": ["build-tests-red"],
|
|
87
|
+
};
|
|
88
|
+
// A step that reads a verb row (`counters derive --step=build-tests-red`) does not own it.
|
|
89
|
+
const VERB_ROW_KEYS = new Set(Object.values(VERB_ROWS).flat());
|
|
90
|
+
/**
|
|
91
|
+
* Calls the orchestrator may run at any point of a run, active when the workflow's
|
|
92
|
+
* `**Contract:**` block names them as `` `bkit {noun} {verb}` `` (the **Friction** bullet's
|
|
93
|
+
* `bkit ledgers append`). The Contract also names step-bound calls, so it is not read wholesale.
|
|
93
94
|
*/
|
|
94
|
-
|
|
95
|
-
|
|
96
|
-
|
|
97
|
-
|
|
98
|
-
|
|
99
|
-
|
|
100
|
-
|
|
101
|
-
|
|
102
|
-
|
|
95
|
+
const ANYWHERE_CALLS = ["ledgers append"];
|
|
96
|
+
// A key followed by `{` is a templated log label (`build-group-gate-{GROUP}`), not a row key.
|
|
97
|
+
const STEP_KEY_RE = /(?:step:"|--step=)([a-z][a-z0-9-]*)(\{)?/g;
|
|
98
|
+
/** The words of one `"{BKIT}" ...` call: shell-split, quotes kept, stopped at the first unquoted operator. */
|
|
99
|
+
export function callWords(rest) {
|
|
100
|
+
const words = [];
|
|
101
|
+
let word = "";
|
|
102
|
+
let quote = "";
|
|
103
|
+
for (const ch of rest) {
|
|
104
|
+
if (quote) {
|
|
105
|
+
word += ch;
|
|
106
|
+
if (ch === quote)
|
|
107
|
+
quote = "";
|
|
103
108
|
}
|
|
104
|
-
|
|
109
|
+
else if (ch === '"' || ch === "'") {
|
|
110
|
+
word += ch;
|
|
111
|
+
quote = ch;
|
|
112
|
+
}
|
|
113
|
+
else if ("|;&><)`".includes(ch))
|
|
114
|
+
break;
|
|
115
|
+
else if (/\s/.test(ch)) {
|
|
116
|
+
if (word)
|
|
117
|
+
words.push(word);
|
|
118
|
+
word = "";
|
|
119
|
+
}
|
|
120
|
+
else
|
|
121
|
+
word += ch;
|
|
105
122
|
}
|
|
106
|
-
|
|
107
|
-
|
|
108
|
-
|
|
109
|
-
|
|
110
|
-
|
|
111
|
-
|
|
112
|
-
|
|
113
|
-
|
|
114
|
-
|
|
123
|
+
if (word)
|
|
124
|
+
words.push(word);
|
|
125
|
+
return words;
|
|
126
|
+
}
|
|
127
|
+
/** Each `Step N — Title` heading, with the text up to the next step or section heading. */
|
|
128
|
+
export function stepSections(text) {
|
|
129
|
+
const lines = text.split("\n");
|
|
130
|
+
const heading = /^#{2,3} \S+ Step (\d+) — (.+)$/;
|
|
131
|
+
const out = [];
|
|
132
|
+
lines.forEach((l, i) => {
|
|
133
|
+
const m = heading.exec(l);
|
|
134
|
+
if (!m)
|
|
135
|
+
return;
|
|
136
|
+
const end = lines.findIndex((x, j) => j > i && /^#{2,3} /.test(x) && !x.startsWith("### 🔒"));
|
|
137
|
+
out.push({
|
|
138
|
+
number: Number(m[1]),
|
|
139
|
+
title: m[2],
|
|
140
|
+
body: lines.slice(i, end === -1 ? undefined : end).join("\n"),
|
|
141
|
+
});
|
|
142
|
+
});
|
|
143
|
+
return out;
|
|
144
|
+
}
|
|
145
|
+
/** Each `"{BKIT}"` call in `text` as noun / verb / flag names. */
|
|
146
|
+
function requiredCalls(text) {
|
|
147
|
+
const joined = text.replace(/\\\n\s*/g, " ");
|
|
148
|
+
return joined
|
|
149
|
+
.split('"{BKIT}"')
|
|
150
|
+
.slice(1)
|
|
151
|
+
.map((call) => {
|
|
152
|
+
const [noun = "", verb = "", ...rest] = callWords(call.replace(/^ /, ""));
|
|
153
|
+
const flags = rest.flatMap((w) => {
|
|
154
|
+
const f = /^--([a-z][a-z0-9-]*)/.exec(w)?.[1];
|
|
155
|
+
return f ? [f] : [];
|
|
156
|
+
});
|
|
157
|
+
return { noun, verb: verb.startsWith("--") ? "" : verb, flags };
|
|
158
|
+
});
|
|
159
|
+
}
|
|
160
|
+
/** R1: per line of a step section, true when it sits on an `If` / `Else` arm. */
|
|
161
|
+
function branchLines(lines) {
|
|
162
|
+
const branch = lines.map(() => false);
|
|
163
|
+
const targets = new Set();
|
|
164
|
+
const blocks = new Set();
|
|
165
|
+
let ifIndent = null;
|
|
166
|
+
lines.forEach((l, i) => {
|
|
167
|
+
if (l.trim() === "") {
|
|
168
|
+
branch[i] = ifIndent !== null;
|
|
169
|
+
return;
|
|
170
|
+
}
|
|
171
|
+
const indent = l.length - l.trimStart().length;
|
|
172
|
+
if (ifIndent !== null && indent <= ifIndent)
|
|
173
|
+
ifIndent = null;
|
|
174
|
+
if (/^\s*(?:- |\d+\. )\*\*(If|Else)\*\*/.test(l))
|
|
175
|
+
ifIndent = indent;
|
|
176
|
+
branch[i] = ifIndent !== null;
|
|
177
|
+
if (/\*\*(If|Else)\*\*/.test(l)) {
|
|
178
|
+
for (const m of l.matchAll(/sub-step (\d+)/g))
|
|
179
|
+
targets.add(Number(m[1]));
|
|
180
|
+
for (const m of l.matchAll(/→ \*\*([^*]+)\*\*/g))
|
|
181
|
+
blocks.add(m[1]);
|
|
182
|
+
}
|
|
183
|
+
});
|
|
184
|
+
let sub = null;
|
|
185
|
+
let block = false;
|
|
186
|
+
lines.forEach((l, i) => {
|
|
187
|
+
const m = /^(\d+)\. /.exec(l);
|
|
188
|
+
if (m)
|
|
189
|
+
sub = Number(m[1]);
|
|
190
|
+
else if (l.startsWith("#"))
|
|
191
|
+
sub = null;
|
|
192
|
+
if (sub !== null && targets.has(sub))
|
|
193
|
+
branch[i] = true;
|
|
194
|
+
// A `**Name:**` block an `**If**` line routes to runs to the next such block or heading.
|
|
195
|
+
const label = /^\*\*([^*]+):\*\*/.exec(l)?.[1];
|
|
196
|
+
if (label !== undefined && blocks.has(label))
|
|
197
|
+
block = true;
|
|
198
|
+
else if (/^#{2,} /.test(l))
|
|
199
|
+
block = false;
|
|
200
|
+
if (block)
|
|
201
|
+
branch[i] = true;
|
|
202
|
+
});
|
|
203
|
+
return branch;
|
|
204
|
+
}
|
|
205
|
+
/**
|
|
206
|
+
* Per `"{BKIT}"` call in `text`, true when it sits after an inline `**If** … →` / `**Else** →`
|
|
207
|
+
* in the same sentence (`→ add `Group gate`: `"{BKIT}" tests run …``). A call in the fence
|
|
208
|
+
* below such a line stays required: there the condition may only change the call.
|
|
209
|
+
*/
|
|
210
|
+
function inlineArms(text) {
|
|
211
|
+
const parts = text.split('"{BKIT}"');
|
|
212
|
+
return parts.slice(1).map((_, i) => {
|
|
213
|
+
const before = parts.slice(0, i + 1).join('"{BKIT}"');
|
|
214
|
+
const lead = [...before.matchAll(/\*\*(?:If|Else)\*\*/g)].at(-1);
|
|
215
|
+
if (lead?.index === undefined)
|
|
216
|
+
return false;
|
|
217
|
+
const clause = before.slice(lead.index).replace(/`[^`]*`/g, "");
|
|
218
|
+
return clause.includes("→") && !/\.\s/.test(clause);
|
|
219
|
+
});
|
|
220
|
+
}
|
|
221
|
+
/** The `"{BKIT}"` calls of one step section, each tagged with its position (R3) and branch flag (R1). */
|
|
222
|
+
function sectionCalls(body) {
|
|
223
|
+
const lines = body.split("\n");
|
|
224
|
+
const branch = branchLines(lines);
|
|
225
|
+
const logical = [];
|
|
226
|
+
for (let i = 0; i < lines.length; i++) {
|
|
227
|
+
let text = lines[i];
|
|
228
|
+
const start = i;
|
|
229
|
+
while (text.endsWith("\\") && i + 1 < lines.length) {
|
|
230
|
+
i += 1;
|
|
231
|
+
text = `${text.slice(0, -1)} ${lines[i].trimStart()}`;
|
|
232
|
+
}
|
|
233
|
+
logical.push({ text, branch: branch[start] });
|
|
234
|
+
}
|
|
235
|
+
const perLine = logical.map((l) => requiredCalls(l.text));
|
|
236
|
+
const isFinish = (c) => c.noun === "steps" && (c.verb === "finish" || (c.verb === "done" && c.flags.includes("step")));
|
|
237
|
+
// An optional finish below the step's own (a route arm's row) does not move the line.
|
|
238
|
+
const finishes = perLine.flatMap((calls, i) => (calls.some(isFinish) ? [i] : []));
|
|
239
|
+
const plain = finishes.filter((i) => !logical[i].branch);
|
|
240
|
+
const lastFinish = (plain.length > 0 ? plain : finishes).at(-1) ?? -1;
|
|
241
|
+
return perLine.flatMap((calls, i) => {
|
|
242
|
+
const inline = inlineArms(logical[i].text);
|
|
243
|
+
return calls.map((c, j) => ({
|
|
244
|
+
...c,
|
|
245
|
+
position: i > lastFinish && lastFinish !== -1 ? "post" : "pre",
|
|
246
|
+
branch: logical[i].branch || inline[j],
|
|
247
|
+
line: i,
|
|
248
|
+
}));
|
|
249
|
+
});
|
|
250
|
+
}
|
|
251
|
+
/** Row keys a section writes (not merely names in a `steps gate --step=` read). */
|
|
252
|
+
function stepWrites(text) {
|
|
253
|
+
const joined = text.replace(/\\\n\s*/g, " ");
|
|
254
|
+
const found = joined.split("\n").flatMap((line) => {
|
|
255
|
+
const viaCall = /"\{BKIT\}" steps (?:finish|done)\b/.test(line) ? stepKeys(line) : [];
|
|
256
|
+
return [...viaCall, ...[...line.matchAll(/step:"([a-z][a-z0-9-]*)"/g)].map((m) => m[1])];
|
|
257
|
+
});
|
|
258
|
+
return [...new Set(found)];
|
|
259
|
+
}
|
|
260
|
+
const stepKeys = (text) => [
|
|
261
|
+
...new Set([...text.matchAll(STEP_KEY_RE)].filter((m) => !m[2]).map((m) => m[1])),
|
|
262
|
+
];
|
|
263
|
+
/** A step is conditional under a column-0 marker line anywhere in its section, or a `(Path X only)` heading. */
|
|
264
|
+
export function isConditionalSection(body) {
|
|
265
|
+
const lines = body.split("\n");
|
|
266
|
+
return (/\(Path [A-Z] only\)/.test(lines[0] ?? "") ||
|
|
267
|
+
lines.some((l) => /^\*\*(Run only if|Skip if)\*\*/.test(l)));
|
|
268
|
+
}
|
|
269
|
+
/**
|
|
270
|
+
* Derive the contract of one workflow from its markdown: the step sections, the
|
|
271
|
+
* row keys and `"{BKIT}"` calls each holds, and the calls no step owns. The
|
|
272
|
+
* universe is cross-checked against the deduped `WORKFLOW_STEPS[workflow]`; a
|
|
273
|
+
* disagreement is reported as drift, never thrown. With a `tracker`, the markdown is
|
|
274
|
+
* first rendered for it, so a consumer is held to the calls its installed workflow names.
|
|
275
|
+
*/
|
|
276
|
+
export function deriveContract(sourceMd, workflow, tracker) {
|
|
277
|
+
const workflowMd = tracker === undefined ? sourceMd : substituteWorkflow(sourceMd, tracker).output;
|
|
278
|
+
const sections = stepSections(workflowMd);
|
|
279
|
+
// The journal window runs from the first `workflows start` call to the `workflows close`
|
|
280
|
+
// call: a call written above or below it is matched when journaled, never required.
|
|
281
|
+
const lineOf = (offset) => workflowMd.slice(0, offset).split("\n").length - 1;
|
|
282
|
+
const absLine = (s, line) => lineOf(workflowMd.indexOf(s.body)) + line;
|
|
283
|
+
const marks = (noun, verb) => sections.flatMap((s) => sectionCalls(s.body)
|
|
284
|
+
.filter((c) => c.noun === noun && c.verb === verb)
|
|
285
|
+
.map((c) => absLine(s, c.line)));
|
|
286
|
+
const starts = marks("workflows", "start");
|
|
287
|
+
const closes = marks("workflows", "close");
|
|
288
|
+
const windowStart = starts.length > 0 ? Math.min(...starts) : -1;
|
|
289
|
+
const windowEnd = closes.length > 0 ? Math.max(...closes) : Number.POSITIVE_INFINITY;
|
|
290
|
+
const outsideWindow = [];
|
|
291
|
+
const steps = sections.map((s) => {
|
|
292
|
+
const inside = [];
|
|
293
|
+
for (const { line, ...c } of sectionCalls(s.body)) {
|
|
294
|
+
const at = absLine(s, line);
|
|
295
|
+
// `workflows start` itself is outside: a fresh run has no active run to journal it under.
|
|
296
|
+
const isStart = c.noun === "workflows" && c.verb === "start";
|
|
297
|
+
if (isStart || at < windowStart || at > windowEnd)
|
|
298
|
+
outsideWindow.push(c);
|
|
299
|
+
else
|
|
300
|
+
inside.push(c);
|
|
301
|
+
}
|
|
302
|
+
return {
|
|
303
|
+
number: s.number,
|
|
304
|
+
title: s.title,
|
|
305
|
+
keys: stepKeys(s.body).filter((k) => !VERB_ROW_KEYS.has(k)),
|
|
306
|
+
writes: stepWrites(s.body),
|
|
307
|
+
calls: inside,
|
|
308
|
+
conditional: isConditionalSection(s.body),
|
|
309
|
+
};
|
|
310
|
+
});
|
|
311
|
+
const universe = [...new Set(steps.flatMap((s) => s.keys))].sort();
|
|
312
|
+
// Text outside every step section: the md minus each section body.
|
|
313
|
+
let outside = workflowMd;
|
|
314
|
+
for (const s of sections)
|
|
315
|
+
outside = outside.replace(s.body, "");
|
|
316
|
+
const table = WORKFLOW_STEPS[workflow];
|
|
317
|
+
const tableKeys = new Set((table ?? []).flatMap((s) => (s.step ? [s.step] : [])));
|
|
318
|
+
const drift = [];
|
|
319
|
+
if (table) {
|
|
320
|
+
for (const k of tableKeys)
|
|
321
|
+
if (!universe.includes(k))
|
|
322
|
+
drift.push(`table-but-not-source:${k}`);
|
|
323
|
+
for (const k of universe)
|
|
324
|
+
if (!tableKeys.has(k))
|
|
325
|
+
drift.push(`source-but-not-table:${k}`);
|
|
326
|
+
}
|
|
327
|
+
const outsideKeys = stepKeys(outside).filter((k) => k.startsWith(`${workflow}-`) && !universe.includes(k));
|
|
328
|
+
const pause = DECISION_ROUTES[workflow]?.step;
|
|
329
|
+
const pauseRows = pause !== undefined && outsideKeys.includes(pause) ? [pause] : [];
|
|
330
|
+
const named = new Set(sections.flatMap((s) => sectionCalls(s.body)).map(callKey));
|
|
331
|
+
const contractBlock = /^\*\*Contract:\*\*[\s\S]*?(?=^#{1,3} |(?![\s\S]))/m.exec(workflowMd)?.[0] ?? "";
|
|
332
|
+
const anywhereCalls = ANYWHERE_CALLS.filter((call) => contractBlock.includes(`\`bkit ${call}\``)).map((call) => {
|
|
333
|
+
const [noun = "", verb = ""] = call.split(" ");
|
|
334
|
+
return { noun, verb, flags: [] };
|
|
335
|
+
});
|
|
336
|
+
const subRows = Object.entries(VERB_ROWS)
|
|
337
|
+
.filter(([call]) => named.has(call))
|
|
338
|
+
.flatMap(([, keys]) => keys.filter((k) => k.startsWith(`${workflow}-`)));
|
|
339
|
+
return {
|
|
340
|
+
workflow,
|
|
341
|
+
steps,
|
|
342
|
+
universe,
|
|
343
|
+
workflowCalls: [...requiredCalls(outside), ...outsideWindow],
|
|
344
|
+
anywhereCalls,
|
|
345
|
+
sourceSha: createHash("sha256").update(workflowMd).digest("hex"),
|
|
346
|
+
pauseRows,
|
|
347
|
+
subRows,
|
|
348
|
+
orphanSteps: outsideKeys.filter((k) => !pauseRows.includes(k)).sort(),
|
|
349
|
+
drift,
|
|
350
|
+
};
|
|
351
|
+
}
|
|
352
|
+
/** The `completeness` verb journals itself; it is neither expected nor ever unexpected. */
|
|
353
|
+
const SELF_NOUN = "completeness";
|
|
354
|
+
const callKey = (c) => `${c.noun} ${c.verb}`;
|
|
355
|
+
export function contractUnits(contract) {
|
|
356
|
+
const owner = new Map();
|
|
357
|
+
for (const k of contract.universe) {
|
|
358
|
+
const writers = contract.steps.filter((s) => s.writes.includes(k));
|
|
359
|
+
const namers = contract.steps.filter((s) => s.keys.includes(k));
|
|
360
|
+
const first = writers.length > 0 ? writers[0] : namers.at(-1);
|
|
361
|
+
if (first)
|
|
362
|
+
owner.set(k, first);
|
|
363
|
+
}
|
|
364
|
+
const owners = contract.steps.filter((s) => [...owner.values()].includes(s));
|
|
365
|
+
return owners.map((s) => {
|
|
366
|
+
const keys = s.keys.filter((k) => owner.get(k) === s);
|
|
367
|
+
const folded = contract.steps.filter((f) => !owners.includes(f) && f.keys[0] !== undefined && owner.get(f.keys[0]) === s);
|
|
368
|
+
const calls = [
|
|
369
|
+
...folded.filter((f) => f.number < s.number).flatMap((f) => f.calls),
|
|
370
|
+
...s.calls,
|
|
371
|
+
...folded
|
|
372
|
+
.filter((f) => f.number > s.number)
|
|
373
|
+
.flatMap((f) => f.calls.map((c) => ({ ...c, position: "post" }))),
|
|
374
|
+
];
|
|
375
|
+
const shared = s.writes.filter((k) => owner.has(k) && owner.get(k) !== s);
|
|
376
|
+
return { number: s.number, keys, shared, calls, conditional: s.conditional };
|
|
377
|
+
});
|
|
378
|
+
}
|
|
379
|
+
/**
|
|
380
|
+
* Classify one run's rows against its contract. Consecutive rows of one unit form a
|
|
381
|
+
* visit (a repeat of a key starts a new one, so each group-loop repeat owns its own
|
|
382
|
+
* gaps). A visit owns the calls before its first row and between its rows, and the
|
|
383
|
+
* calls after its last row that are one of its `post` calls (R3); the rest belong to
|
|
384
|
+
* the next visit. Matching is on noun + verb (R2). `holey` keys on `evidenceHoles` +
|
|
385
|
+
* `stepHoles` only. Never throws and never filters by age.
|
|
386
|
+
*/
|
|
387
|
+
export function check(rows, contract, options = {}) {
|
|
388
|
+
const workflow = contract.workflow;
|
|
389
|
+
const own = rows.filter((r) => r.workflow === workflow);
|
|
390
|
+
const units = contractUnits(contract).map((u) => ({
|
|
391
|
+
...u,
|
|
392
|
+
calls: u.calls.filter((c) => c.noun !== SELF_NOUN),
|
|
393
|
+
}));
|
|
394
|
+
const unitOf = new Map();
|
|
395
|
+
for (const u of units)
|
|
396
|
+
for (const k of u.keys)
|
|
397
|
+
unitOf.set(k, u);
|
|
398
|
+
const writersOf = new Map();
|
|
399
|
+
for (const u of units)
|
|
400
|
+
for (const k of [...u.keys, ...u.shared])
|
|
401
|
+
writersOf.set(k, [...(writersOf.get(k) ?? []), u]);
|
|
402
|
+
const workflowCalls = contract.workflowCalls.filter((c) => c.noun !== SELF_NOUN);
|
|
403
|
+
const workflowKeys = new Set([...workflowCalls, ...contract.anywhereCalls].map(callKey));
|
|
404
|
+
const subRows = new Set(contract.subRows);
|
|
405
|
+
const pauseRows = new Set(contract.pauseRows);
|
|
406
|
+
// A sub-row sits inside the visit of the step whose call wrote it, so it is no visit boundary.
|
|
407
|
+
// A pause row is a boundary owned by no step, like a row outside the contract.
|
|
408
|
+
const items = own.flatMap((r) => {
|
|
409
|
+
if (r.type === "engine-call" && r["noun"] !== SELF_NOUN) {
|
|
410
|
+
return [{ kind: "call", call: { noun: String(r["noun"]), verb: String(r["verb"]) } }];
|
|
411
|
+
}
|
|
412
|
+
if (r.type === "step-done" && typeof r.step === "string" && !subRows.has(r.step)) {
|
|
413
|
+
return [{ kind: "step", key: r.step, row: r, unit: unitOf.get(r.step) }];
|
|
414
|
+
}
|
|
415
|
+
return [];
|
|
416
|
+
});
|
|
417
|
+
const stepRowCount = own.filter((r) => r.type === "step-done" && typeof r.step === "string").length;
|
|
418
|
+
const callCount = items.filter((i) => i.kind === "call").length;
|
|
419
|
+
const preJournal = callCount === 0;
|
|
420
|
+
// A journal that starts mid-run (an engine upgrade, the kill switch lifted) leaves the
|
|
421
|
+
// visits that finished before its first `engine-call` row with no evidence to judge.
|
|
422
|
+
const firstCall = items.findIndex((i) => i.kind === "call");
|
|
423
|
+
// Visits over the step rows, in order; a row outside the contract closes the current visit.
|
|
424
|
+
const visits = [];
|
|
425
|
+
const visitOfRow = new Map();
|
|
426
|
+
let current;
|
|
427
|
+
const keysInCurrent = new Set();
|
|
428
|
+
// A row two units write joins the open visit of one of them, else the unit that also
|
|
429
|
+
// writes the next row, else its owner.
|
|
430
|
+
const unitOfRow = (key, owner, i) => {
|
|
431
|
+
const writers = writersOf.get(key) ?? [owner];
|
|
432
|
+
if (writers.length === 1)
|
|
433
|
+
return owner;
|
|
434
|
+
if (current && writers.includes(current.unit) && !keysInCurrent.has(key))
|
|
435
|
+
return current.unit;
|
|
436
|
+
const next = items.slice(i + 1).find((x) => x.kind === "step" && x.unit !== undefined);
|
|
437
|
+
const nextWriters = next?.kind === "step" ? (writersOf.get(next.key) ?? []) : [];
|
|
438
|
+
return writers.find((w) => nextWriters.includes(w)) ?? owner;
|
|
439
|
+
};
|
|
440
|
+
items.forEach((item, i) => {
|
|
441
|
+
if (item.kind !== "step")
|
|
442
|
+
return;
|
|
443
|
+
if (!item.unit) {
|
|
444
|
+
current = undefined;
|
|
445
|
+
return;
|
|
446
|
+
}
|
|
447
|
+
const unit = unitOfRow(item.key, item.unit, i);
|
|
448
|
+
const sameUnit = current?.unit === unit && !keysInCurrent.has(item.key);
|
|
449
|
+
if (!sameUnit) {
|
|
450
|
+
current = { unit, rows: [] };
|
|
451
|
+
keysInCurrent.clear();
|
|
452
|
+
visits.push(current);
|
|
453
|
+
}
|
|
454
|
+
current.rows.push(i);
|
|
455
|
+
keysInCurrent.add(item.key);
|
|
456
|
+
visitOfRow.set(i, current);
|
|
457
|
+
});
|
|
458
|
+
const postSlots = new Map();
|
|
459
|
+
const freshSlots = (v) => {
|
|
460
|
+
const slots = { plain: new Map(), arm: new Map() };
|
|
461
|
+
for (const c of v.unit.calls) {
|
|
462
|
+
if (c.position !== "post")
|
|
463
|
+
continue;
|
|
464
|
+
const m = c.branch ? slots.arm : slots.plain;
|
|
465
|
+
m.set(callKey(c), (m.get(callKey(c)) ?? 0) + 1);
|
|
115
466
|
}
|
|
116
|
-
|
|
117
|
-
|
|
467
|
+
postSlots.set(v, slots);
|
|
468
|
+
return slots;
|
|
469
|
+
};
|
|
470
|
+
const take = (m, key) => {
|
|
471
|
+
const n = m.get(key) ?? 0;
|
|
472
|
+
if (n > 0)
|
|
473
|
+
m.set(key, n - 1);
|
|
474
|
+
return n > 0;
|
|
475
|
+
};
|
|
476
|
+
const stepIdx = items.flatMap((it, i) => (it.kind === "step" ? [i] : []));
|
|
477
|
+
const owned = new Map();
|
|
478
|
+
const unexpectedCalls = new Map();
|
|
479
|
+
const unattributable = new Map();
|
|
480
|
+
items.forEach((item, i) => {
|
|
481
|
+
if (item.kind !== "call")
|
|
482
|
+
return;
|
|
483
|
+
const key = callKey(item.call);
|
|
484
|
+
const prevIdx = stepIdx.filter((x) => x < i).at(-1) ?? -1;
|
|
485
|
+
const nextIdx = stepIdx.find((x) => x > i) ?? -1;
|
|
486
|
+
const prevVisit = visitOfRow.get(prevIdx);
|
|
487
|
+
const nextVisit = visitOfRow.get(nextIdx);
|
|
488
|
+
// Each post call of a visit absorbs one journaled call: a noun + verb written both
|
|
489
|
+
// below one step's finish line and above the next step's is charged once to each.
|
|
490
|
+
// A route-arm post call absorbs more only while the next visit names no such call.
|
|
491
|
+
const slots = prevVisit === undefined ? undefined : (postSlots.get(prevVisit) ?? freshSlots(prevVisit));
|
|
492
|
+
const nextNames = (armsToo) => nextVisit?.unit.calls.some((c) => callKey(c) === key && (armsToo || !c.branch)) === true;
|
|
493
|
+
const claimsPost = prevVisit !== undefined &&
|
|
494
|
+
prevVisit.rows.at(-1) === prevIdx &&
|
|
495
|
+
slots !== undefined &&
|
|
496
|
+
(take(slots.plain, key) ||
|
|
497
|
+
(prevVisit.unit.calls.some((c) => c.position === "post" && c.branch && callKey(c) === key) &&
|
|
498
|
+
!nextNames(false) &&
|
|
499
|
+
(take(slots.arm, key) || !nextNames(true))));
|
|
500
|
+
const insideVisit = prevVisit !== undefined && prevVisit === nextVisit ? prevVisit : undefined;
|
|
501
|
+
// A post call journaled between its visit's own rows (above an arm's row) uses its slot.
|
|
502
|
+
if (insideVisit !== undefined && slots !== undefined) {
|
|
503
|
+
if (!take(slots.plain, key))
|
|
504
|
+
take(slots.arm, key);
|
|
505
|
+
}
|
|
506
|
+
const owner = insideVisit ?? (claimsPost ? prevVisit : nextVisit);
|
|
507
|
+
const required = owner?.unit.calls.some((c) => callKey(c) === key) === true;
|
|
508
|
+
if (owner && required) {
|
|
509
|
+
owned.set(owner, (owned.get(owner) ?? new Set()).add(key));
|
|
510
|
+
}
|
|
511
|
+
else if (workflowKeys.has(key)) {
|
|
512
|
+
// R4: a workflow-level call is never charged to a step and never unexpected.
|
|
513
|
+
}
|
|
514
|
+
else if (owner === undefined) {
|
|
515
|
+
unattributable.set(key, item.call);
|
|
516
|
+
}
|
|
517
|
+
else {
|
|
518
|
+
unexpectedCalls.set(key, item.call);
|
|
519
|
+
}
|
|
520
|
+
});
|
|
521
|
+
const evidenceHoles = [];
|
|
522
|
+
if (workflow === "debug") {
|
|
523
|
+
rows.forEach((stepRow, position) => {
|
|
524
|
+
if (stepRow.type === "step-done" &&
|
|
525
|
+
stepRow.workflow === "debug" &&
|
|
526
|
+
stepRow.step === "context-fetch") {
|
|
527
|
+
const prior = rows.slice(0, position);
|
|
528
|
+
const previous = prior
|
|
529
|
+
.map((r, i) => (r.type === "step-done" || r.type === "workflow-started" ? i : -1))
|
|
530
|
+
.filter((i) => i >= 0)
|
|
531
|
+
.at(-1) ?? -1;
|
|
532
|
+
const start = prior
|
|
533
|
+
.map((r, i) => (r.type === "workflow-started" ? i : -1))
|
|
534
|
+
.filter((i) => i >= 0)
|
|
535
|
+
.at(-1) ?? -1;
|
|
536
|
+
const history = prior.slice(start + 1);
|
|
537
|
+
const meta = [...history]
|
|
538
|
+
.reverse()
|
|
539
|
+
.find((r) => r.type === "workflow-meta" && r.workflow === "debug" && r.ciSelection !== undefined);
|
|
540
|
+
const ci = history.some((r) => r.type === "test-run" &&
|
|
541
|
+
r.workflow === "debug" &&
|
|
542
|
+
ciRoundMatches(r, meta?.ciSelection, meta?.ciGeneration));
|
|
543
|
+
if (ci &&
|
|
544
|
+
!prior
|
|
545
|
+
.slice(previous + 1)
|
|
546
|
+
.some((r) => r.type === "engine-call" && r.noun === "context" && r.verb === "fetch"))
|
|
547
|
+
evidenceHoles.push({
|
|
548
|
+
step: "context-fetch",
|
|
549
|
+
number: unitOf.get("context-fetch")?.number ?? 2,
|
|
550
|
+
index: 1,
|
|
551
|
+
missing: [{ noun: "context", verb: "fetch", flags: ["context"] }],
|
|
552
|
+
});
|
|
553
|
+
}
|
|
554
|
+
if (stepRow.type !== "step-done" ||
|
|
555
|
+
stepRow.workflow !== "debug" ||
|
|
556
|
+
stepRow.step !== "debug-run-tests" ||
|
|
557
|
+
stepRow.source !== "ci")
|
|
558
|
+
return;
|
|
559
|
+
const prior = rows.slice(0, position);
|
|
560
|
+
const start = prior
|
|
561
|
+
.map((r, i) => (r.type === "workflow-started" ? i : -1))
|
|
562
|
+
.filter((i) => i >= 0)
|
|
563
|
+
.at(-1) ?? -1;
|
|
564
|
+
const history = prior.slice(start + 1).reverse();
|
|
565
|
+
const meta = history.find((r) => r.type === "workflow-meta" && r.workflow === "debug" && r.ciSelection !== undefined);
|
|
566
|
+
const round = history.find((r) => r.type === "test-run" &&
|
|
567
|
+
r.workflow === "debug" &&
|
|
568
|
+
r.step === "debug-run-tests" &&
|
|
569
|
+
r.attempt === stepRow.attempt);
|
|
570
|
+
if (!round ||
|
|
571
|
+
!ciRoundMatches(round, meta?.ciSelection, meta?.ciGeneration) ||
|
|
572
|
+
stepRow.scope !== round.scope ||
|
|
573
|
+
stepRow.verdict !== "FAIL" ||
|
|
574
|
+
stepRow.ciGeneration !== meta?.ciGeneration ||
|
|
575
|
+
!Array.isArray(stepRow.artifacts) ||
|
|
576
|
+
!stepRow.artifacts.includes(round.artifact))
|
|
577
|
+
evidenceHoles.push({
|
|
578
|
+
step: "debug-run-tests",
|
|
579
|
+
number: unitOf.get("debug-run-tests")?.number ?? 1,
|
|
580
|
+
index: 1,
|
|
581
|
+
missing: [{ noun: "tests", verb: "run", flags: ["ci-run"] }],
|
|
582
|
+
});
|
|
583
|
+
});
|
|
584
|
+
}
|
|
585
|
+
const occurrence = new Map();
|
|
586
|
+
const exercised = new Map();
|
|
587
|
+
for (const v of visits) {
|
|
588
|
+
const index = (occurrence.get(v.unit) ?? 0) + 1;
|
|
589
|
+
occurrence.set(v.unit, index);
|
|
590
|
+
const beforeJournal = firstCall !== -1 && v.rows.every((r) => r < firstCall);
|
|
591
|
+
if (beforeJournal)
|
|
592
|
+
continue;
|
|
593
|
+
const got = owned.get(v) ?? new Set();
|
|
594
|
+
// A visit whose own row-writing call (`steps finish` / `steps done`) left no journaled
|
|
595
|
+
// call is judged on its step row alone: the journal did not see this visit's commands.
|
|
596
|
+
// A writer outside the journal window is never required, so there a visit with no
|
|
597
|
+
// journaled call at all is judged the same way.
|
|
598
|
+
const isWriter = (k) => k === "steps finish" || k === "steps done";
|
|
599
|
+
const writerInWindow = v.unit.calls.some((c) => !c.branch && isWriter(callKey(c)));
|
|
600
|
+
if (writerInWindow ? ![...got].some(isWriter) : got.size === 0)
|
|
601
|
+
continue;
|
|
602
|
+
const pool = exercised.get(v.unit) ?? new Set();
|
|
603
|
+
for (const k of got)
|
|
604
|
+
pool.add(k);
|
|
605
|
+
exercised.set(v.unit, pool);
|
|
606
|
+
const rowsOf = v.rows.map((i) => items[i]).flatMap((x) => (x?.kind === "step" ? [x.row] : []));
|
|
607
|
+
const done = rowsOf.some((r) => r.status === undefined || r.status === "DONE");
|
|
608
|
+
if (preJournal || !done)
|
|
118
609
|
continue;
|
|
610
|
+
const missing = new Map();
|
|
611
|
+
for (const c of v.unit.calls) {
|
|
612
|
+
if (!c.branch && !got.has(callKey(c)) && !missing.has(callKey(c))) {
|
|
613
|
+
missing.set(callKey(c), { noun: c.noun, verb: c.verb, flags: c.flags });
|
|
614
|
+
}
|
|
119
615
|
}
|
|
120
|
-
if (
|
|
121
|
-
|
|
122
|
-
|
|
123
|
-
|
|
124
|
-
|
|
616
|
+
if (missing.size === 0)
|
|
617
|
+
continue;
|
|
618
|
+
const group = rowsOf.map((r) => r["group"]).find((g) => typeof g === "number");
|
|
619
|
+
evidenceHoles.push({
|
|
620
|
+
step: rowsOf[0]?.step ?? v.unit.keys[0] ?? "",
|
|
621
|
+
number: v.unit.number,
|
|
622
|
+
index,
|
|
623
|
+
...(typeof group === "number" ? { group } : {}),
|
|
624
|
+
missing: [...missing.values()],
|
|
625
|
+
});
|
|
626
|
+
}
|
|
627
|
+
const unexercised = [];
|
|
628
|
+
if (!preJournal) {
|
|
629
|
+
for (const u of units) {
|
|
630
|
+
const pool = exercised.get(u);
|
|
631
|
+
if (pool === undefined)
|
|
632
|
+
continue;
|
|
633
|
+
const required = new Set(u.calls.filter((c) => !c.branch).map(callKey));
|
|
634
|
+
const reported = new Set();
|
|
635
|
+
for (const c of u.calls) {
|
|
636
|
+
const k = callKey(c);
|
|
637
|
+
if (c.branch && !required.has(k) && !pool.has(k) && !reported.has(k)) {
|
|
638
|
+
reported.add(k);
|
|
639
|
+
unexercised.push({ step: u.keys[0] ?? "", call: { noun: c.noun, verb: c.verb } });
|
|
640
|
+
}
|
|
125
641
|
}
|
|
126
|
-
re.lastIndex = 0;
|
|
127
642
|
}
|
|
128
643
|
}
|
|
129
|
-
|
|
130
|
-
const
|
|
131
|
-
const
|
|
644
|
+
const observed = new Set(items.flatMap((i) => (i.kind === "step" ? [i.key] : [])));
|
|
645
|
+
const closed = observed.has(`${workflow}-close-workflow`);
|
|
646
|
+
const failed = own.some((r) => r.type === "workflow-failed");
|
|
647
|
+
const lastNumber = Math.max(0, ...visits.map((v) => v.unit.number));
|
|
648
|
+
const stepHoles = units
|
|
649
|
+
.filter((u) => !u.conditional && !u.keys.some((k) => observed.has(k)))
|
|
650
|
+
.filter((u) => closed || (failed && u.number < lastNumber))
|
|
651
|
+
.map((u) => u.keys[0]);
|
|
652
|
+
const unexpected = [
|
|
653
|
+
...[...observed]
|
|
654
|
+
.filter((k) => !unitOf.has(k) && !pauseRows.has(k))
|
|
655
|
+
.sort()
|
|
656
|
+
.map((step) => ({ step })),
|
|
657
|
+
...(preJournal ? [] : unexpectedCalls.values()),
|
|
658
|
+
];
|
|
659
|
+
const holey = evidenceHoles.length > 0 || stepHoles.length > 0;
|
|
132
660
|
return {
|
|
133
|
-
|
|
134
|
-
|
|
135
|
-
|
|
136
|
-
|
|
661
|
+
workflow,
|
|
662
|
+
verdict: holey ? "HOLEY" : "CLEAN",
|
|
663
|
+
holey,
|
|
664
|
+
preJournal,
|
|
665
|
+
journalSuspect: preJournal && options.journalSuspect === true,
|
|
666
|
+
observed: { steps: stepRowCount, calls: callCount },
|
|
667
|
+
evidenceHoles,
|
|
668
|
+
stepHoles,
|
|
669
|
+
unexercised,
|
|
670
|
+
unexpected,
|
|
671
|
+
unattributable: [...unattributable.values()],
|
|
672
|
+
sourceSha: contract.sourceSha,
|
|
673
|
+
workflowCalls: workflowCalls.map((c) => ({ noun: c.noun, verb: c.verb })),
|
|
137
674
|
};
|
|
138
675
|
}
|
|
139
676
|
/**
|
|
140
|
-
*
|
|
141
|
-
*
|
|
677
|
+
* The verdict of a run: its last stored `completeness` row, recomputed when a
|
|
678
|
+
* `step-done` or `engine-call` row follows it (the closing `workflow-done` row and
|
|
679
|
+
* the `completeness` verb's own journal row do not).
|
|
142
680
|
*/
|
|
143
|
-
export function
|
|
144
|
-
const
|
|
145
|
-
const
|
|
146
|
-
const
|
|
147
|
-
|
|
148
|
-
|
|
149
|
-
|
|
150
|
-
|
|
151
|
-
|
|
152
|
-
|
|
153
|
-
|
|
681
|
+
export function readCompleteness(rows, contract, options = {}) {
|
|
682
|
+
const own = rows.filter((r) => r.workflow === contract.workflow);
|
|
683
|
+
const at = own.map((r) => r.type).lastIndexOf("completeness");
|
|
684
|
+
const stored = at === -1 ? undefined : own[at];
|
|
685
|
+
const followed = own
|
|
686
|
+
.slice(at + 1)
|
|
687
|
+
.some((r) => r.type === "step-done" || (r.type === "engine-call" && r["noun"] !== SELF_NOUN));
|
|
688
|
+
if (!stored || followed)
|
|
689
|
+
return { verdict: check(rows, contract, options), source: "computed" };
|
|
690
|
+
const list = (key) => Array.isArray(stored[key]) ? stored[key] : [];
|
|
691
|
+
const holey = stored["verdict"] === "HOLEY";
|
|
692
|
+
const observed = stored["observed"];
|
|
693
|
+
return {
|
|
694
|
+
source: "stored",
|
|
695
|
+
verdict: {
|
|
696
|
+
workflow: contract.workflow,
|
|
697
|
+
verdict: holey ? "HOLEY" : "CLEAN",
|
|
698
|
+
holey,
|
|
699
|
+
preJournal: stored["preJournal"] === true,
|
|
700
|
+
journalSuspect: stored["journalSuspect"] === true,
|
|
701
|
+
observed: observed ?? { steps: 0, calls: 0 },
|
|
702
|
+
evidenceHoles: list("evidenceHoles"),
|
|
703
|
+
stepHoles: list("stepHoles"),
|
|
704
|
+
unexercised: list("unexercised"),
|
|
705
|
+
unexpected: list("unexpected"),
|
|
706
|
+
unattributable: list("unattributable"),
|
|
707
|
+
sourceSha: typeof stored["sourceSha"] === "string" ? stored["sourceSha"] : "",
|
|
708
|
+
workflowCalls: list("workflowCalls"),
|
|
709
|
+
},
|
|
710
|
+
};
|
|
154
711
|
}
|
|
155
712
|
// ---------------------------------------------------------------------------
|
|
156
713
|
// Run classification + path-conditional expected sets
|
|
@@ -206,6 +763,9 @@ export function computeMandatoryForPath(path, sourceUniverse) {
|
|
|
206
763
|
case "MERGED_ON_ENTRY":
|
|
207
764
|
// Skip the entire middle + retry-loop steps
|
|
208
765
|
return new Set([...universe].filter((s) => !MERGED_ON_ENTRY_SKIP.has(s) && !RETRY_LOOP_STEPS.has(s)));
|
|
766
|
+
case "COMPLETED":
|
|
767
|
+
// Non-ship runs derive their mandatory set from the contract (auditRun)
|
|
768
|
+
return new Set(universe);
|
|
209
769
|
case "ABORTED":
|
|
210
770
|
// No mandatory steps — the run terminated; post-abort absences are expected
|
|
211
771
|
return new Set();
|
|
@@ -262,13 +822,9 @@ export function detectHoles(observed, sourceUniverse, path) {
|
|
|
262
822
|
return { missing, unexpected };
|
|
263
823
|
}
|
|
264
824
|
// ---------------------------------------------------------------------------
|
|
265
|
-
// Full audit — parse status.jsonl +
|
|
825
|
+
// Full audit — parse status.jsonl + workflow md, classify, detect, report
|
|
266
826
|
// ---------------------------------------------------------------------------
|
|
267
|
-
export function
|
|
268
|
-
// Derive expected set from source
|
|
269
|
-
const { steps: sourceUniverse, orphanSteps } = deriveExpectedStepSetFromSource(shipMd);
|
|
270
|
-
const sourceCanonicalDrift = checkSourceCanonicalDrift(sourceUniverse);
|
|
271
|
-
// Parse status rows
|
|
827
|
+
export function parseRows(statusJsonl) {
|
|
272
828
|
const rows = [];
|
|
273
829
|
for (const line of statusJsonl.split("\n")) {
|
|
274
830
|
const trimmed = line.trim();
|
|
@@ -279,35 +835,94 @@ export function auditStatusJsonl(statusJsonl, shipMd) {
|
|
|
279
835
|
if (row.ok)
|
|
280
836
|
rows.push(row.value);
|
|
281
837
|
}
|
|
282
|
-
|
|
283
|
-
|
|
284
|
-
|
|
285
|
-
|
|
286
|
-
|
|
838
|
+
return rows;
|
|
839
|
+
}
|
|
840
|
+
/** Audit one run's rows against the contract derived from its workflow markdown. */
|
|
841
|
+
export function auditRun(rows, workflow, workflowMd) {
|
|
842
|
+
const contract = deriveContract(workflowMd, workflow);
|
|
843
|
+
const stepRows = rows.filter((r) => r.type === "step-done" && r.workflow === workflow && typeof r.step === "string");
|
|
844
|
+
const hasWorkflowFailed = rows.some((r) => r.type === "workflow-failed" && r.workflow === workflow);
|
|
287
845
|
const observed = new Set();
|
|
288
|
-
for (const r of
|
|
846
|
+
for (const r of stepRows)
|
|
289
847
|
if (r.step)
|
|
290
848
|
observed.add(r.step);
|
|
849
|
+
const sorted = [...observed].sort();
|
|
850
|
+
const side = new Set([...contract.pauseRows, ...contract.subRows]);
|
|
851
|
+
if (workflow === "ship") {
|
|
852
|
+
const hasMergedOnEntryMarker = rows.some((r) => r.type === "ship-merged-on-entry" && r.workflow === "ship");
|
|
853
|
+
const runPath = classifyRun(observed, hasWorkflowFailed, hasMergedOnEntryMarker);
|
|
854
|
+
const { missing, unexpected } = detectHoles(observed, contract.universe, runPath);
|
|
855
|
+
return {
|
|
856
|
+
workflow,
|
|
857
|
+
missing,
|
|
858
|
+
unexpected: unexpected.filter((k) => !side.has(k)),
|
|
859
|
+
path: runPath,
|
|
860
|
+
observed: sorted,
|
|
861
|
+
sourceUniverse: contract.universe,
|
|
862
|
+
sourceCanonicalDrift: contract.drift,
|
|
863
|
+
orphanSteps: contract.orphanSteps,
|
|
864
|
+
};
|
|
291
865
|
}
|
|
292
|
-
|
|
293
|
-
const runPath =
|
|
294
|
-
|
|
866
|
+
const closeKey = `${workflow}-close-workflow`;
|
|
867
|
+
const runPath = observed.has(closeKey)
|
|
868
|
+
? "COMPLETED"
|
|
869
|
+
: hasWorkflowFailed
|
|
870
|
+
? "ABORTED"
|
|
871
|
+
: "IN_PROGRESS";
|
|
872
|
+
const missing = runPath === "COMPLETED"
|
|
873
|
+
? contract.steps
|
|
874
|
+
.filter((s) => s.keys.length > 0 && !s.conditional && !s.keys.some((k) => observed.has(k)))
|
|
875
|
+
.map((s) => s.keys[0])
|
|
876
|
+
.sort()
|
|
877
|
+
: [];
|
|
295
878
|
return {
|
|
879
|
+
workflow,
|
|
296
880
|
missing,
|
|
297
|
-
unexpected,
|
|
881
|
+
unexpected: sorted.filter((k) => !contract.universe.includes(k) && !side.has(k)),
|
|
298
882
|
path: runPath,
|
|
299
|
-
observed:
|
|
300
|
-
sourceUniverse:
|
|
301
|
-
sourceCanonicalDrift,
|
|
302
|
-
orphanSteps,
|
|
883
|
+
observed: sorted,
|
|
884
|
+
sourceUniverse: contract.universe,
|
|
885
|
+
sourceCanonicalDrift: contract.drift,
|
|
886
|
+
orphanSteps: contract.orphanSteps,
|
|
303
887
|
};
|
|
304
888
|
}
|
|
889
|
+
/** `workflow`'s rows split into runs: each `workflow-started` opens a run that ends at the next one; rows before the first start form their own run. */
|
|
890
|
+
export function runsOf(rows, workflow) {
|
|
891
|
+
const at = (r) => (typeof r["at"] === "string" ? r["at"] : "");
|
|
892
|
+
const own = rows
|
|
893
|
+
.filter((r) => r.workflow === workflow)
|
|
894
|
+
.sort((a, b) => (at(a) < at(b) ? -1 : at(a) > at(b) ? 1 : 0));
|
|
895
|
+
const runs = [];
|
|
896
|
+
for (const row of own) {
|
|
897
|
+
const current = runs.at(-1);
|
|
898
|
+
if (current === undefined || row.type === "workflow-started")
|
|
899
|
+
runs.push([row]);
|
|
900
|
+
else
|
|
901
|
+
current.push(row);
|
|
902
|
+
}
|
|
903
|
+
return runs;
|
|
904
|
+
}
|
|
905
|
+
/** Audit a status.jsonl as a ship run against `shipMd`. */
|
|
906
|
+
export function auditStatusJsonl(statusJsonl, shipMd) {
|
|
907
|
+
return auditRun(parseRows(statusJsonl), "ship", shipMd);
|
|
908
|
+
}
|
|
909
|
+
/** The workflows a status.jsonl holds runs of, inferred from its own rows. */
|
|
910
|
+
export function inferWorkflows(rows) {
|
|
911
|
+
const known = new Set(Object.keys(WORKFLOW_STEPS));
|
|
912
|
+
const found = new Set();
|
|
913
|
+
for (const r of rows)
|
|
914
|
+
if (typeof r.workflow === "string" && known.has(r.workflow))
|
|
915
|
+
found.add(r.workflow);
|
|
916
|
+
return [...found].sort();
|
|
917
|
+
}
|
|
305
918
|
// ---------------------------------------------------------------------------
|
|
306
919
|
// Advisory report formatter
|
|
307
920
|
// ---------------------------------------------------------------------------
|
|
308
921
|
export function formatAdvisoryReport(report) {
|
|
309
922
|
const lines = [];
|
|
310
923
|
lines.push("[bkit-status-holes] ADVISORY — fail-open (exit 0 regardless)");
|
|
924
|
+
if (report.workflow)
|
|
925
|
+
lines.push(` workflow: ${report.workflow}`);
|
|
311
926
|
lines.push(` path: ${report.path}`);
|
|
312
927
|
lines.push(` observed: ${report.observed.length} step(s)`);
|
|
313
928
|
if (report.sourceCanonicalDrift.length > 0) {
|
|
@@ -334,34 +949,26 @@ export function formatAdvisoryReport(report) {
|
|
|
334
949
|
// CLI entry — always exits 0 (advisory / fail-open)
|
|
335
950
|
// ---------------------------------------------------------------------------
|
|
336
951
|
export function main(argv) {
|
|
337
|
-
|
|
338
|
-
//
|
|
339
|
-
|
|
340
|
-
// of `--ship-md` when the flag is passed before the status path.
|
|
341
|
-
const mdFlagIdx = args.indexOf("--ship-md");
|
|
342
|
-
const shipMdOverride = mdFlagIdx >= 0 ? args[mdFlagIdx + 1] : undefined;
|
|
343
|
-
const consumed = new Set();
|
|
344
|
-
if (mdFlagIdx >= 0) {
|
|
345
|
-
consumed.add(mdFlagIdx);
|
|
346
|
-
if (shipMdOverride)
|
|
347
|
-
consumed.add(mdFlagIdx + 1);
|
|
348
|
-
}
|
|
349
|
-
// Every remaining positional is a status.jsonl to audit — one report each, so
|
|
350
|
-
// a whole corpus can be swept in one advisory CI step.
|
|
351
|
-
const statusPaths = args.filter((a, i) => !consumed.has(i) && !a.startsWith("--"));
|
|
952
|
+
// Every positional is a status.jsonl to audit — one report per run of each
|
|
953
|
+
// workflow in each file, so a whole corpus can be swept in one advisory CI step.
|
|
954
|
+
const statusPaths = argv.slice(2).filter((a) => !a.startsWith("--"));
|
|
352
955
|
if (statusPaths.length === 0) {
|
|
353
956
|
process.stdout.write("[bkit-status-holes] no status.jsonl path given — skipping (advisory)\n");
|
|
354
957
|
return; // exit 0
|
|
355
958
|
}
|
|
356
|
-
const
|
|
357
|
-
|
|
358
|
-
|
|
359
|
-
|
|
360
|
-
|
|
361
|
-
|
|
362
|
-
|
|
363
|
-
|
|
364
|
-
|
|
959
|
+
const mdCache = new Map();
|
|
960
|
+
const loadMd = (workflow) => {
|
|
961
|
+
if (!mdCache.has(workflow)) {
|
|
962
|
+
try {
|
|
963
|
+
mdCache.set(workflow, fs.readFileSync(path.join(getWorkflowsRoot(), `bkit-${workflow}.md`), "utf-8"));
|
|
964
|
+
}
|
|
965
|
+
catch {
|
|
966
|
+
mdCache.set(workflow, null);
|
|
967
|
+
}
|
|
968
|
+
}
|
|
969
|
+
return mdCache.get(workflow) ?? null;
|
|
970
|
+
};
|
|
971
|
+
let holeyRuns = 0;
|
|
365
972
|
for (const statusPath of statusPaths) {
|
|
366
973
|
// Read inputs (advisory — missing files = skip, never fail)
|
|
367
974
|
let statusJsonl = "";
|
|
@@ -372,10 +979,28 @@ export function main(argv) {
|
|
|
372
979
|
process.stdout.write(`[bkit-status-holes] ${statusPath} not found — skipping (advisory)\n`);
|
|
373
980
|
continue; // exit 0
|
|
374
981
|
}
|
|
375
|
-
const
|
|
982
|
+
const rows = parseRows(statusJsonl);
|
|
983
|
+
const workflows = inferWorkflows(rows);
|
|
376
984
|
process.stdout.write(`\n${statusPath}\n`);
|
|
377
|
-
|
|
985
|
+
if (workflows.length === 0) {
|
|
986
|
+
process.stdout.write(`[bkit-status-holes] ${statusPath}: no workflow rows — skipping (advisory)\n`);
|
|
987
|
+
continue;
|
|
988
|
+
}
|
|
989
|
+
for (const workflow of workflows) {
|
|
990
|
+
const md = loadMd(workflow);
|
|
991
|
+
if (md === null) {
|
|
992
|
+
process.stdout.write(`[bkit-status-holes] bkit-${workflow}.md not found — skipping ${workflow} run (advisory)\n`);
|
|
993
|
+
continue;
|
|
994
|
+
}
|
|
995
|
+
for (const run of runsOf(rows, workflow)) {
|
|
996
|
+
const report = auditRun(run, workflow, md);
|
|
997
|
+
if (report.missing.length > 0)
|
|
998
|
+
holeyRuns += 1;
|
|
999
|
+
process.stdout.write(formatAdvisoryReport(report) + "\n");
|
|
1000
|
+
}
|
|
1001
|
+
}
|
|
378
1002
|
}
|
|
1003
|
+
process.stdout.write(`[bkit-status-holes] sweep: ${statusPaths.length} file(s), ${holeyRuns} holey\n`);
|
|
379
1004
|
// ALWAYS exit 0 — this is advisory / fail-open
|
|
380
1005
|
}
|
|
381
1006
|
// Run if invoked directly (ESM-compatible main-module detection)
|