@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
|
@@ -9,10 +9,11 @@
|
|
|
9
9
|
// unique. A finding at the location and severity of an earlier task that is still open
|
|
10
10
|
// reruns that task (its Round value gains this round) rather than adding a twin; one whose
|
|
11
11
|
// earlier task is done from an earlier round is a new task. It then names the route:
|
|
12
|
-
// `fix` (run the tasks), `pause` (
|
|
13
|
-
//
|
|
14
|
-
//
|
|
15
|
-
// reports appends
|
|
12
|
+
// `fix` (run the tasks: every one is fixable, in any round), `pause` (a task is not
|
|
13
|
+
// fixable: ask the owner) or `none`. More than `maxChallengeTasks` new tasks in one merge
|
|
14
|
+
// writes nothing and pauses. The plan is checked in memory before it is written, so a
|
|
15
|
+
// refused merge leaves every file as it was. A re-run with the same reports appends
|
|
16
|
+
// nothing.
|
|
16
17
|
//
|
|
17
18
|
// bkit challenge gate — size the run's diff before the reviewers start. A small change
|
|
18
19
|
// (under CHALLENGE_SMALL lines and files, `docs/plans/**` excluded) runs the security
|
|
@@ -26,9 +27,11 @@ import * as path from "node:path";
|
|
|
26
27
|
import { appendLine, statusTimestamp } from "../../ledgers/status.js";
|
|
27
28
|
import { CommandError, DEV, EXIT, git, runGit, type CommandSpec } from "../lib.js";
|
|
28
29
|
import { DIFF_BASE, EXIT_BASE, diffNumstat, type DiffStat } from "./context.js";
|
|
30
|
+
import { parseDecisionItems } from "./decisions.js";
|
|
29
31
|
import { EXIT_ROW_REFUSED, EXIT_STAGE, appendLedgerRows } from "./ledgers.js";
|
|
30
|
-
import { parsePlanBlocks, type PlanTaskBlock } from "./plan-blocks.js";
|
|
32
|
+
import { derivedTestMatrix, parsePlanBlocks, type PlanTaskBlock } from "./plan-blocks.js";
|
|
31
33
|
import { readBkitConfig, type TaskCaps } from "../../shared/settings.js";
|
|
34
|
+
import { grantCount } from "./counters.js";
|
|
32
35
|
import { checkPlanText, planCaps, readTestFirst } from "./tests.js";
|
|
33
36
|
import { ledgerRows } from "./workflows.js";
|
|
34
37
|
|
|
@@ -140,7 +143,7 @@ function findingsLog(text: string): { body: string; line: number } {
|
|
|
140
143
|
}
|
|
141
144
|
|
|
142
145
|
/** The group wrapper a Findings Log gets when the reviewer wrote task blocks only. */
|
|
143
|
-
const WRAP = ["<!-- bkit:group 1 start -->", "### GROUP 1: Findings"];
|
|
146
|
+
const WRAP = ["<!-- bkit:group 1 start -->", "### TASK GROUP 1: Findings"];
|
|
144
147
|
|
|
145
148
|
/**
|
|
146
149
|
* One report's findings: each task block under `## Findings Log` (read through
|
|
@@ -217,7 +220,8 @@ export function mergeFindings(
|
|
|
217
220
|
}
|
|
218
221
|
|
|
219
222
|
/**
|
|
220
|
-
* Locations named in a `Decision: Accept` item of any `build-decision-*.md` in `logDir
|
|
223
|
+
* Locations named in a `Decision: Accept` item of any `build-decision-*.md` in `logDir`, the
|
|
224
|
+
* decision read by `parseDecisionItems` (so `Decision: A) Accept …` counts). An
|
|
221
225
|
* `Accept (assumed)` counts too, so the next round does not raise it again; the build summary
|
|
222
226
|
* and ship report it as assumed.
|
|
223
227
|
*/
|
|
@@ -227,11 +231,11 @@ export function acceptedLocations(logDir: string, cwd: string): Set<string> {
|
|
|
227
231
|
? fs.readdirSync(logDir).filter((f) => /^build-decision-.*\.md$/.test(f))
|
|
228
232
|
: [];
|
|
229
233
|
for (const file of files) {
|
|
230
|
-
const items = fs.readFileSync(path.join(logDir, file), "utf-8")
|
|
231
|
-
for (const item of items
|
|
232
|
-
if (!/^
|
|
234
|
+
const items = parseDecisionItems(fs.readFileSync(path.join(logDir, file), "utf-8"));
|
|
235
|
+
for (const item of items) {
|
|
236
|
+
if (!/^Accept\b/.test(item.decision ?? "")) continue;
|
|
233
237
|
// `path:line`, the path with or without an extension (`src/a.ts:10`, `Makefile:12`).
|
|
234
|
-
for (const m of item.matchAll(/(?<![\w@./-])[\w@./-]*[A-Za-z_][\w@./-]*:\d+/g)) {
|
|
238
|
+
for (const m of item.text.matchAll(/(?<![\w@./-])[\w@./-]*[A-Za-z_][\w@./-]*:\d+/g)) {
|
|
235
239
|
const loc = normalizeLocation(m[0], cwd);
|
|
236
240
|
if (loc !== null) out.add(loc);
|
|
237
241
|
}
|
|
@@ -251,6 +255,36 @@ const taskBlock = (n: number, f: Finding, round: number) => [
|
|
|
251
255
|
`<!-- bkit:task ${n} end -->`,
|
|
252
256
|
];
|
|
253
257
|
|
|
258
|
+
/** The test tier `docs/testing.md` records for a test file's name. */
|
|
259
|
+
const testTier = (file: string) =>
|
|
260
|
+
/\.integration\.test\./.test(file)
|
|
261
|
+
? "Integration"
|
|
262
|
+
: /\.live\.test\./.test(file)
|
|
263
|
+
? "@live (golden)"
|
|
264
|
+
: "Unit";
|
|
265
|
+
|
|
266
|
+
/**
|
|
267
|
+
* One `Derived Test Matrix` row per test a finding task appends: the test's own name and
|
|
268
|
+
* file from its `TEST FIRST` entry, its tier from the file's name, and the task number.
|
|
269
|
+
* A file or name holding a `|` would split the row's cells, so it is refused, not written.
|
|
270
|
+
*/
|
|
271
|
+
function matrixRows(findings: Finding[], firstTask: number): { rows: string[]; refused: string[] } {
|
|
272
|
+
const refused: string[] = [];
|
|
273
|
+
const rows = findings.flatMap((f, i) =>
|
|
274
|
+
f.tests.map((entry) => {
|
|
275
|
+
const spans = [...entry.matchAll(/`([^`]+)`/g)].map((m) => m[1]!.trim());
|
|
276
|
+
const file = spans[0] ?? "";
|
|
277
|
+
const name = spans[1] ?? entry.replace(/[`|]/g, "").trim();
|
|
278
|
+
if (file.includes("|") || name.includes("|"))
|
|
279
|
+
refused.push(
|
|
280
|
+
`TASK ${firstTask + i} (${f.location}): its TEST FIRST test file or name holds a \`|\`, which breaks the Derived Test Matrix row`,
|
|
281
|
+
);
|
|
282
|
+
return `| ${name} | ${testTier(file)} | \`${file}\` | ${firstTask + i} |`;
|
|
283
|
+
}),
|
|
284
|
+
);
|
|
285
|
+
return { rows, refused };
|
|
286
|
+
}
|
|
287
|
+
|
|
254
288
|
/**
|
|
255
289
|
* The findings as groups of task blocks, numbered from `firstTask` and `firstGroup`: a
|
|
256
290
|
* group closes at `caps.maxPerGroup` tasks, or before a task that would take it past
|
|
@@ -285,7 +319,7 @@ function findingGroups(
|
|
|
285
319
|
const lines = chunks.flatMap((chunk, g) => [
|
|
286
320
|
...(g === 0 ? [] : [""]),
|
|
287
321
|
`<!-- bkit:group ${firstGroup + g} start -->`,
|
|
288
|
-
`### GROUP ${firstGroup + g}: Challenge round ${round} findings`,
|
|
322
|
+
`### TASK GROUP ${firstGroup + g}: Challenge round ${round} findings`,
|
|
289
323
|
...chunk.flatMap((f) => taskBlock(next++, f, round)),
|
|
290
324
|
`<!-- bkit:group ${firstGroup + g} end -->`,
|
|
291
325
|
]);
|
|
@@ -296,11 +330,17 @@ function findingGroups(
|
|
|
296
330
|
interface Written {
|
|
297
331
|
from: number;
|
|
298
332
|
to: number;
|
|
333
|
+
/** The `Derived Test Matrix` rows it inserted, when the plan has a matrix. */
|
|
334
|
+
rows?: { from: number; to: number };
|
|
335
|
+
/** Matrix rows refused before writing: a test span that would break the table. */
|
|
336
|
+
refused: string[];
|
|
299
337
|
}
|
|
300
338
|
|
|
301
339
|
/**
|
|
302
340
|
* `plan` with the findings written as new groups after its last group (at the end when
|
|
303
|
-
* it has none), tasks numbered from `firstTask`, grouped within `caps`.
|
|
341
|
+
* it has none), tasks numbered from `firstTask`, grouped within `caps`. A plan that
|
|
342
|
+
* carries a `Derived Test Matrix` gains a row per finding test, so the matrix check holds
|
|
343
|
+
* over the appended tasks too.
|
|
304
344
|
*/
|
|
305
345
|
export function appendTasks(
|
|
306
346
|
plan: string,
|
|
@@ -312,31 +352,56 @@ export function appendTasks(
|
|
|
312
352
|
const blocks = parsePlanBlocks(plan);
|
|
313
353
|
const firstGroup = Math.max(0, ...blocks.groups.map((g) => g.group)) + 1;
|
|
314
354
|
const { lines: block, tasks } = findingGroups(findings, firstTask, firstGroup, round, caps);
|
|
355
|
+
const matrix = derivedTestMatrix(plan);
|
|
356
|
+
const { rows, refused } =
|
|
357
|
+
matrix === null ? { rows: [], refused: [] } : matrixRows(findings, firstTask);
|
|
358
|
+
// The matrix table's last row, or its separator line when it holds none: 0-based index.
|
|
359
|
+
const matrixAt = matrix === null ? -1 : (matrix.rows.at(-1)?.number ?? matrix.line + 1);
|
|
360
|
+
const lines = plan.split("\n");
|
|
361
|
+
if (matrixAt >= 0) lines.splice(matrixAt, 0, ...rows);
|
|
362
|
+
const rowLines =
|
|
363
|
+
matrixAt >= 0 && rows.length > 0
|
|
364
|
+
? { from: matrixAt + 1, to: matrixAt + rows.length }
|
|
365
|
+
: undefined;
|
|
315
366
|
const last = blocks.groups.at(-1);
|
|
316
367
|
if (last === undefined) {
|
|
317
|
-
const body =
|
|
368
|
+
const body = lines.join("\n").replace(/\n*$/, "");
|
|
318
369
|
const from = body.split("\n").length + 2;
|
|
319
370
|
return {
|
|
320
371
|
text: `${body}\n\n${block.join("\n")}\n`,
|
|
321
372
|
tasks,
|
|
322
|
-
written: { from, to: from + block.length - 1 },
|
|
373
|
+
written: { from, to: from + block.length - 1, rows: rowLines, refused },
|
|
323
374
|
};
|
|
324
375
|
}
|
|
325
|
-
const
|
|
326
|
-
lines.splice(last.end, 0, "", ...block);
|
|
327
|
-
const from = last.end + 2;
|
|
328
|
-
|
|
376
|
+
const shift = matrixAt >= 0 && matrixAt <= last.end ? rows.length : 0;
|
|
377
|
+
lines.splice(last.end + shift, 0, "", ...block);
|
|
378
|
+
const from = last.end + shift + 2;
|
|
379
|
+
// Matrix rows below the last group move down by the block and its blank line.
|
|
380
|
+
const moved =
|
|
381
|
+
rowLines !== undefined && shift === 0
|
|
382
|
+
? { from: rowLines.from + block.length + 1, to: rowLines.to + block.length + 1 }
|
|
383
|
+
: rowLines;
|
|
384
|
+
return {
|
|
385
|
+
text: lines.join("\n"),
|
|
386
|
+
tasks,
|
|
387
|
+
written: { from, to: from + block.length - 1, rows: moved, refused },
|
|
388
|
+
};
|
|
329
389
|
}
|
|
330
390
|
|
|
331
391
|
/**
|
|
332
|
-
* Why the merged `text` may not be written: a plan-check problem on
|
|
333
|
-
* wrote (a malformed block, a group or task over its cap
|
|
334
|
-
* TEST FIRST names no test.
|
|
392
|
+
* Why the merged `text` may not be written: a refused matrix row, a plan-check problem on
|
|
393
|
+
* the lines the merge wrote (a malformed block, a group or task over its cap, a broken
|
|
394
|
+
* matrix row), or a written task whose TEST FIRST names no test.
|
|
335
395
|
*/
|
|
336
396
|
function planProblems(text: string, written: Written, added: number[], caps: TaskCaps): string[] {
|
|
337
|
-
const
|
|
338
|
-
|
|
339
|
-
|
|
397
|
+
const at = (line: number, r?: { from: number; to: number }) =>
|
|
398
|
+
r !== undefined && line >= r.from && line <= r.to;
|
|
399
|
+
const problems = [
|
|
400
|
+
...written.refused,
|
|
401
|
+
...checkPlanText(text, caps)
|
|
402
|
+
.problems.filter((p) => at(p.line, written) || at(p.line, written.rows))
|
|
403
|
+
.map((p) => `line ${p.line}: ${p.message}`),
|
|
404
|
+
];
|
|
340
405
|
const kinds = readTestFirst(text);
|
|
341
406
|
for (const n of added) {
|
|
342
407
|
const kind = kinds.find((s) => s.task === n)?.kind ?? "missing";
|
|
@@ -346,13 +411,17 @@ function planProblems(text: string, written: Written, added: number[], caps: Tas
|
|
|
346
411
|
return problems;
|
|
347
412
|
}
|
|
348
413
|
|
|
414
|
+
/** Stable identity shared by the challenge writer and its resolution reader. */
|
|
415
|
+
export const lowDeferralKey = (fid: string, location: string): string =>
|
|
416
|
+
`${fid}-challenge-low-${location.replace(/[^A-Za-z0-9]+/g, "-").replace(/^-|-$/g, "")}`.toLowerCase();
|
|
417
|
+
|
|
349
418
|
/** LOW findings as `docs/deferrals.jsonl` rows, keyed by FID and location. */
|
|
350
419
|
export function lowDeferrals(fid: string, findings: Finding[]): Array<Record<string, unknown>> {
|
|
351
420
|
return findings
|
|
352
421
|
.filter((f) => f.severity === "LOW")
|
|
353
422
|
.map((f) => ({
|
|
354
423
|
kind: "deferral",
|
|
355
|
-
key:
|
|
424
|
+
key: lowDeferralKey(fid, f.location),
|
|
356
425
|
type: "issue",
|
|
357
426
|
category: "correctness",
|
|
358
427
|
severity: "LOW",
|
|
@@ -425,6 +494,7 @@ export const challengeCommand: CommandSpec = {
|
|
|
425
494
|
gate: {
|
|
426
495
|
summary:
|
|
427
496
|
"Size the run's diff ({base}...HEAD, docs/plans/** excluded) and name the reviewers: small runs challenge-2 alone, large runs both. Writes a challenge-gate status row.",
|
|
497
|
+
use: "workflow",
|
|
428
498
|
flags: [
|
|
429
499
|
{
|
|
430
500
|
name: "file",
|
|
@@ -494,6 +564,7 @@ export const challengeCommand: CommandSpec = {
|
|
|
494
564
|
merge: {
|
|
495
565
|
summary:
|
|
496
566
|
"Merge the challenge reports' findings into the plan as tasks (LOW → deferral rows); prints the route: fix | pause | none.",
|
|
567
|
+
use: "workflow",
|
|
497
568
|
flags: [
|
|
498
569
|
{
|
|
499
570
|
name: "report",
|
|
@@ -518,12 +589,12 @@ export const challengeCommand: CommandSpec = {
|
|
|
518
589
|
name: "round",
|
|
519
590
|
type: "string",
|
|
520
591
|
required: true,
|
|
521
|
-
help: "challenge round, 1 up to bkit.workflows.build.challenge.maxAttempts
|
|
592
|
+
help: "challenge round, 1 up to bkit.workflows.build.challenge.maxAttempts, one more full set per allowance-granted row for build.challenge in the log folder's status.jsonl",
|
|
522
593
|
},
|
|
523
594
|
],
|
|
524
595
|
output: {
|
|
525
596
|
route:
|
|
526
|
-
"fix (tasks to run), pause (a task is not fixable,
|
|
597
|
+
"fix (tasks to run, every one fixable), pause (a task is not fixable, or more than 4 x `bkit.workflows.tasks.maxPerGroup` new tasks) or none (nothing to run)",
|
|
527
598
|
fixTasks:
|
|
528
599
|
"comma-separated task numbers in `plan` this round runs: every task reopened, then every task appended; empty when none",
|
|
529
600
|
appended: "how many tasks this run wrote",
|
|
@@ -548,17 +619,25 @@ export const challengeCommand: CommandSpec = {
|
|
|
548
619
|
run: (ctx) => {
|
|
549
620
|
const round = String(ctx.flags.round);
|
|
550
621
|
const top = git(ctx.cwd, ["rev-parse", "--show-toplevel"]) ?? ctx.cwd;
|
|
551
|
-
const
|
|
622
|
+
const abs = (p: string) => path.resolve(ctx.cwd, p);
|
|
623
|
+
const rel = (p: string) => path.relative(ctx.cwd, p).split(path.sep).join("/");
|
|
624
|
+
const planArg = String(ctx.flags.plan);
|
|
625
|
+
const logDir = abs(String(ctx.flags.log));
|
|
626
|
+
// Each allowance the owner granted at the used-up limit adds one full set of rounds.
|
|
627
|
+
const grants = grantCount(
|
|
628
|
+
path.join(logDir, "status.jsonl"),
|
|
629
|
+
"build",
|
|
630
|
+
"build.challenge",
|
|
631
|
+
undefined,
|
|
632
|
+
false,
|
|
633
|
+
);
|
|
634
|
+
const maxRounds = readBkitConfig(top).asks["build.challenge"].max * (1 + grants);
|
|
552
635
|
if (!/^[1-9][0-9]*$/.test(round) || Number(round) > maxRounds)
|
|
553
636
|
throw new CommandError(
|
|
554
637
|
EXIT.USAGE,
|
|
555
|
-
`--round must be 1 to ${maxRounds} (bkit.workflows.build.challenge.maxAttempts), got "${round}"`,
|
|
638
|
+
`--round must be 1 to ${maxRounds} (bkit.workflows.build.challenge.maxAttempts x (1 + ${grants} allowance(s) granted)), got "${round}"`,
|
|
556
639
|
);
|
|
557
640
|
const roundN = Number(round);
|
|
558
|
-
const abs = (p: string) => path.resolve(ctx.cwd, p);
|
|
559
|
-
const rel = (p: string) => path.relative(ctx.cwd, p).split(path.sep).join("/");
|
|
560
|
-
const planArg = String(ctx.flags.plan);
|
|
561
|
-
const logDir = abs(String(ctx.flags.log));
|
|
562
641
|
const fid = path.basename(logDir);
|
|
563
642
|
|
|
564
643
|
const reports = (ctx.flags.report as string[]).map((r) => {
|
|
@@ -648,11 +727,7 @@ export const challengeCommand: CommandSpec = {
|
|
|
648
727
|
|
|
649
728
|
const running = [...fresh, ...open.map((x) => x.f)];
|
|
650
729
|
const route =
|
|
651
|
-
fixTasks.length === 0
|
|
652
|
-
? "none"
|
|
653
|
-
: roundN >= maxRounds || running.some((f) => !f.fixable)
|
|
654
|
-
? "pause"
|
|
655
|
-
: "fix";
|
|
730
|
+
fixTasks.length === 0 ? "none" : running.some((f) => !f.fixable) ? "pause" : "fix";
|
|
656
731
|
ctx.emit({
|
|
657
732
|
route,
|
|
658
733
|
fixTasks: fixTasks.join(","),
|
|
@@ -0,0 +1,109 @@
|
|
|
1
|
+
// bkit completeness check — report whether a run recorded every step and journaled every command its workflow requires.
|
|
2
|
+
|
|
3
|
+
import * as fs from "node:fs";
|
|
4
|
+
import * as path from "node:path";
|
|
5
|
+
|
|
6
|
+
import {
|
|
7
|
+
deriveContract,
|
|
8
|
+
inferWorkflows,
|
|
9
|
+
parseRows,
|
|
10
|
+
readCompleteness,
|
|
11
|
+
runsOf,
|
|
12
|
+
type CompletenessVerdict,
|
|
13
|
+
} from "../../checks/status-holes.js";
|
|
14
|
+
import { getWorkflowsRoot } from "../../shared/package-roots.js";
|
|
15
|
+
import { EXIT, type CommandSpec } from "../lib.js";
|
|
16
|
+
import { readIssueTracker } from "./fids.js";
|
|
17
|
+
import { FILE_FLAG, WORKFLOW_FLAG, statusFile } from "./status.js";
|
|
18
|
+
|
|
19
|
+
const TAG = "[bkit-status-holes]";
|
|
20
|
+
|
|
21
|
+
const readText = (file: string, log: (message: string) => void): string | null => {
|
|
22
|
+
try {
|
|
23
|
+
return fs.readFileSync(file, "utf-8");
|
|
24
|
+
} catch (err) {
|
|
25
|
+
log(`${TAG} ${file} not readable: ${err instanceof Error ? err.message : String(err)}`);
|
|
26
|
+
return null;
|
|
27
|
+
}
|
|
28
|
+
};
|
|
29
|
+
|
|
30
|
+
function reportLines(v: CompletenessVerdict): string[] {
|
|
31
|
+
const calls = (list: Array<{ noun: string; verb: string }>) =>
|
|
32
|
+
list.map((c) => `${c.noun} ${c.verb}`).join(", ");
|
|
33
|
+
const lines = [
|
|
34
|
+
`${TAG} ADVISORY — ${v.workflow}: ${v.verdict} (${v.observed.steps} step(s), ${v.observed.calls} call(s) observed)`,
|
|
35
|
+
];
|
|
36
|
+
if (v.preJournal) lines.push(" pre-journal run: command evidence not available");
|
|
37
|
+
if (v.stepHoles.length > 0) lines.push(` step holes: ${v.stepHoles.join(", ")}`);
|
|
38
|
+
for (const h of v.evidenceHoles)
|
|
39
|
+
lines.push(` evidence hole: ${h.step} lacks ${calls(h.missing)}`);
|
|
40
|
+
if (v.unexercised.length > 0)
|
|
41
|
+
lines.push(` unexercised arms: ${v.unexercised.length} (not holes)`);
|
|
42
|
+
return lines;
|
|
43
|
+
}
|
|
44
|
+
|
|
45
|
+
export const completenessCommand: CommandSpec = {
|
|
46
|
+
noun: "completeness",
|
|
47
|
+
summary: "Check a run for missing steps and missing bkit commands.",
|
|
48
|
+
verbs: {
|
|
49
|
+
check: {
|
|
50
|
+
summary:
|
|
51
|
+
"Report the steps and bkit commands a run is missing, from its status.jsonl and the workflow markdown; advisory, always exits 0.",
|
|
52
|
+
use: "by-hand",
|
|
53
|
+
flags: [
|
|
54
|
+
FILE_FLAG,
|
|
55
|
+
{
|
|
56
|
+
...WORKFLOW_FLAG,
|
|
57
|
+
required: false,
|
|
58
|
+
help: "workflow name: design, plan, build, debug, ship; absent = each workflow the file holds rows of",
|
|
59
|
+
},
|
|
60
|
+
],
|
|
61
|
+
output: {
|
|
62
|
+
report: "the human-readable report",
|
|
63
|
+
holey: "true when any checked run has an evidence hole or a step hole",
|
|
64
|
+
verdicts: "one completeness verdict per checked run; empty when nothing could be read",
|
|
65
|
+
},
|
|
66
|
+
run: (ctx) => {
|
|
67
|
+
const file = statusFile(ctx);
|
|
68
|
+
const text = readText(file, ctx.log);
|
|
69
|
+
if (text === null) {
|
|
70
|
+
ctx.emit({ report: `${TAG} no status.jsonl to check`, holey: false, verdicts: [] });
|
|
71
|
+
return EXIT.OK;
|
|
72
|
+
}
|
|
73
|
+
const rows = parseRows(text);
|
|
74
|
+
const given = typeof ctx.flags.workflow === "string" ? ctx.flags.workflow : undefined;
|
|
75
|
+
const workflows = given === undefined ? inferWorkflows(rows) : [given];
|
|
76
|
+
// The repo holding the file sets the tracker, as on the close and start paths.
|
|
77
|
+
const tracker = readIssueTracker(path.dirname(file));
|
|
78
|
+
const verdicts: CompletenessVerdict[] = [];
|
|
79
|
+
const lines: string[] = [];
|
|
80
|
+
for (const workflow of workflows) {
|
|
81
|
+
const md = readText(path.join(getWorkflowsRoot(), `bkit-${workflow}.md`), ctx.log);
|
|
82
|
+
if (md === null) {
|
|
83
|
+
ctx.log(`${TAG} bkit-${workflow}.md not readable — skipping ${workflow} (advisory)`);
|
|
84
|
+
continue;
|
|
85
|
+
}
|
|
86
|
+
try {
|
|
87
|
+
const contract = deriveContract(md, workflow, tracker);
|
|
88
|
+
for (const run of runsOf(rows, workflow)) {
|
|
89
|
+
const { verdict } = readCompleteness(run, contract);
|
|
90
|
+
verdicts.push(verdict);
|
|
91
|
+
lines.push(...reportLines(verdict));
|
|
92
|
+
}
|
|
93
|
+
} catch (err) {
|
|
94
|
+
ctx.log(
|
|
95
|
+
`${TAG} ${workflow}: ${err instanceof Error ? err.message : String(err)} — no verdict (advisory)`,
|
|
96
|
+
);
|
|
97
|
+
}
|
|
98
|
+
}
|
|
99
|
+
if (lines.length === 0) lines.push(`${TAG} no verdict`);
|
|
100
|
+
ctx.emit({
|
|
101
|
+
report: lines.join("\n"),
|
|
102
|
+
holey: verdicts.some((v) => v.holey),
|
|
103
|
+
verdicts,
|
|
104
|
+
});
|
|
105
|
+
return EXIT.OK;
|
|
106
|
+
},
|
|
107
|
+
},
|
|
108
|
+
},
|
|
109
|
+
};
|