@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,4 +1,4 @@
|
|
|
1
|
-
// bkit counters derive|run|route|max — attempt counters derived from status.jsonl.
|
|
1
|
+
// bkit counters derive|run|route|grant|max — attempt counters derived from status.jsonl.
|
|
2
2
|
//
|
|
3
3
|
// No counter is stored. Each is counted from the log when needed, at one of three
|
|
4
4
|
// positions — read this before picking `--position`:
|
|
@@ -8,8 +8,9 @@
|
|
|
8
8
|
// be 0 there, so 0 is refused (it means the row was dropped).
|
|
9
9
|
// count routing on a DIFFERENT step, prior or not yet run: the bare count, and
|
|
10
10
|
// 0 is a legal answer (that step simply has not run).
|
|
11
|
+
import * as fs from "node:fs";
|
|
11
12
|
import * as path from "node:path";
|
|
12
|
-
import { activeDoneSteps, allRunsDoneSteps, lastDoneStepAllRuns, nextStrategy, runNumber, } from "../../ledgers/status.js";
|
|
13
|
+
import { activeDoneSteps, allRunsDoneSteps, appendLine, lastDoneStepAllRuns, nextStrategy, runNumber, statusTimestamp, } from "../../ledgers/status.js";
|
|
13
14
|
import { ASK_POINTS, readBkitConfig, } from "../../shared/settings.js";
|
|
14
15
|
import { headlessRun } from "./runtime.js";
|
|
15
16
|
import { CommandError, EXIT, git, runGit, } from "../lib.js";
|
|
@@ -70,6 +71,28 @@ const ALL_RUNS_FLAG = {
|
|
|
70
71
|
type: "boolean",
|
|
71
72
|
help: "count every run of the workflow in --file, not only the active one",
|
|
72
73
|
};
|
|
74
|
+
/** The `workflow-started` row that opened `workflow`'s active run; undefined with no file or no run. */
|
|
75
|
+
export function activeRunStart(file, workflow) {
|
|
76
|
+
if (!fs.existsSync(file))
|
|
77
|
+
return undefined;
|
|
78
|
+
return readStatusRows(file)
|
|
79
|
+
.filter((r) => r.type === "workflow-started" && r.workflow === workflow)
|
|
80
|
+
.sort((a, b) => String(a.at).localeCompare(String(b.at)))
|
|
81
|
+
.at(-1);
|
|
82
|
+
}
|
|
83
|
+
/** The point's limit as the active run froze it in its `workflow-started` row's `limits`. */
|
|
84
|
+
function frozenAskSetting(file, workflow, point) {
|
|
85
|
+
const limits = activeRunStart(file, workflow)?.limits;
|
|
86
|
+
const frozen = limits !== null && typeof limits === "object"
|
|
87
|
+
? limits[point]
|
|
88
|
+
: undefined;
|
|
89
|
+
if (frozen === null || typeof frozen !== "object")
|
|
90
|
+
return undefined;
|
|
91
|
+
const { ask, max } = frozen;
|
|
92
|
+
return typeof ask === "boolean" && Number.isInteger(max) && max >= 0
|
|
93
|
+
? { ask, max: max }
|
|
94
|
+
: undefined;
|
|
95
|
+
}
|
|
73
96
|
/** Rows of `type` in `workflow`'s active run (since its last workflow-started row). */
|
|
74
97
|
function typedRowCount(file, workflow, type) {
|
|
75
98
|
const rows = readStatusRows(file);
|
|
@@ -82,6 +105,36 @@ function typedRowCount(file, workflow, type) {
|
|
|
82
105
|
.slice(start + 1)
|
|
83
106
|
.filter((r) => r.type === type && (r.workflow === undefined || r.workflow === workflow)).length;
|
|
84
107
|
}
|
|
108
|
+
/** The row `counters grant` writes: the owner gave one loop one more full allowance. */
|
|
109
|
+
export const ALLOWANCE_ROW = "allowance-granted";
|
|
110
|
+
/**
|
|
111
|
+
* Allowances granted to `point` (and `group`, when given) in `workflow`'s active run, or
|
|
112
|
+
* across every run of the file with `allRuns`.
|
|
113
|
+
*/
|
|
114
|
+
export function grantCount(file, workflow, point, group, allRuns) {
|
|
115
|
+
if (!fs.existsSync(file))
|
|
116
|
+
return 0;
|
|
117
|
+
const rows = readStatusRows(file);
|
|
118
|
+
let start = -1;
|
|
119
|
+
if (!allRuns)
|
|
120
|
+
rows.forEach((r, i) => {
|
|
121
|
+
if (r.type === "workflow-started" && r.workflow === workflow)
|
|
122
|
+
start = i;
|
|
123
|
+
});
|
|
124
|
+
return rows
|
|
125
|
+
.slice(start + 1)
|
|
126
|
+
.filter((r) => r.type === ALLOWANCE_ROW &&
|
|
127
|
+
r.workflow === workflow &&
|
|
128
|
+
r.point === point &&
|
|
129
|
+
(group === undefined || r.group === group)).length;
|
|
130
|
+
}
|
|
131
|
+
/** A loop's frozen allowance, including the owner's saved grants; absent for legacy runs. */
|
|
132
|
+
export function savedPointLimit(file, workflow, point, group, allRuns = false) {
|
|
133
|
+
const setting = frozenAskSetting(file, workflow, point);
|
|
134
|
+
return setting === undefined
|
|
135
|
+
? undefined
|
|
136
|
+
: setting.max * (1 + grantCount(file, workflow, point, group, allRuns));
|
|
137
|
+
}
|
|
85
138
|
/** `route --rows=<type>:count`: rows of that type in the active run. */
|
|
86
139
|
function derivedRows(ctx) {
|
|
87
140
|
const [type, position] = String(ctx.flags.rows).split(":");
|
|
@@ -158,12 +211,76 @@ export function loopProgress(file, cwd, workflow, check, fix, group) {
|
|
|
158
211
|
recommend: trend === "first-round" ? null : trend === "closing" ? "try-again" : "stop",
|
|
159
212
|
};
|
|
160
213
|
}
|
|
214
|
+
/**
|
|
215
|
+
* `--point`'s limit for route and grant: the run's frozen setting (else package.json's), its
|
|
216
|
+
* max raised by one full allowance per `allowance-granted` row when `--file` and
|
|
217
|
+
* `--workflow` name the run; undefined without `--point`.
|
|
218
|
+
*/
|
|
219
|
+
function pointLimit(ctx) {
|
|
220
|
+
if (ctx.flags.point === undefined)
|
|
221
|
+
return undefined;
|
|
222
|
+
const point = askPoint(String(ctx.flags.point));
|
|
223
|
+
const inRun = ctx.flags.file !== undefined && ctx.flags.workflow !== undefined;
|
|
224
|
+
const frozen = inRun
|
|
225
|
+
? frozenAskSetting(statusFile(ctx), String(ctx.flags.workflow), point)
|
|
226
|
+
: undefined;
|
|
227
|
+
const setting = frozen ?? askSetting(ctx.cwd, point);
|
|
228
|
+
const grants = inRun
|
|
229
|
+
? grantCount(statusFile(ctx), String(ctx.flags.workflow), point, positiveInt(ctx.flags.group, "group"), ctx.flags.allRuns === true)
|
|
230
|
+
: 0;
|
|
231
|
+
return {
|
|
232
|
+
point,
|
|
233
|
+
max: setting.max * (1 + grants),
|
|
234
|
+
ask: setting.ask && !headlessRun(ctx.cwd),
|
|
235
|
+
out: {
|
|
236
|
+
limitsFrom: frozen ? "run" : "package.json",
|
|
237
|
+
...(inRun ? { grants, allowance: setting.max } : {}),
|
|
238
|
+
},
|
|
239
|
+
};
|
|
240
|
+
}
|
|
241
|
+
/** The flags route and grant share: the counter's value, and the limit it is compared to. */
|
|
242
|
+
const VALUE_FLAGS = [
|
|
243
|
+
{ name: "name", type: "string", required: true, help: "counter name, for the log line" },
|
|
244
|
+
{
|
|
245
|
+
name: "value",
|
|
246
|
+
type: "string",
|
|
247
|
+
help: "counter value (non-negative integer), or derive it with --of / --rows",
|
|
248
|
+
},
|
|
249
|
+
{
|
|
250
|
+
name: "of",
|
|
251
|
+
type: "string",
|
|
252
|
+
help: "<step>:<next|current|count> — derive the value from --file (active run); <step>,<step>...:count sums the listed steps",
|
|
253
|
+
},
|
|
254
|
+
{
|
|
255
|
+
name: "rows",
|
|
256
|
+
type: "string",
|
|
257
|
+
help: "<row type>:count — rows of that type in --file's active run; with --of, added to it",
|
|
258
|
+
},
|
|
259
|
+
{ ...FILE_FLAG, required: false, help: "status.jsonl, with --of or --rows" },
|
|
260
|
+
{ ...WORKFLOW_FLAG, required: false, help: "workflow, with --of or --rows" },
|
|
261
|
+
{ ...GROUP_FLAG, help: "with --of: only rows for this task group; with --point: its grants" },
|
|
262
|
+
{
|
|
263
|
+
...ALL_RUNS_FLAG,
|
|
264
|
+
help: "with --of: count every run of the workflow in --file; with --point: grants of every run",
|
|
265
|
+
},
|
|
266
|
+
];
|
|
267
|
+
/** The counter's value: `--value`, or derived with `--of` and/or `--rows`. */
|
|
268
|
+
function counterValue(ctx) {
|
|
269
|
+
const derived = ctx.flags.of !== undefined || ctx.flags.rows !== undefined;
|
|
270
|
+
if (derived === (ctx.flags.value !== undefined))
|
|
271
|
+
throw new CommandError(EXIT.USAGE, "give --value, or --of and/or --rows");
|
|
272
|
+
return derived
|
|
273
|
+
? (ctx.flags.of !== undefined ? derivedOf(ctx) : 0) +
|
|
274
|
+
(ctx.flags.rows !== undefined ? derivedRows(ctx) : 0)
|
|
275
|
+
: nonNegativeInt(ctx.flags.value, "value");
|
|
276
|
+
}
|
|
161
277
|
export const countersCommand = {
|
|
162
278
|
noun: "counters",
|
|
163
279
|
summary: "Attempt counters derived from status.jsonl, and the ask points' limits.",
|
|
164
280
|
verbs: {
|
|
165
281
|
derive: {
|
|
166
282
|
summary: "Count a step's DONE rows in the active run, at one of three positions.",
|
|
283
|
+
use: "workflow",
|
|
167
284
|
flags: [
|
|
168
285
|
FILE_FLAG,
|
|
169
286
|
WORKFLOW_FLAG,
|
|
@@ -198,6 +315,7 @@ export const countersCommand = {
|
|
|
198
315
|
},
|
|
199
316
|
run: {
|
|
200
317
|
summary: "Which run of the workflow this invocation is (1-based; a resume keeps its number).",
|
|
318
|
+
use: "workflow",
|
|
201
319
|
flags: [FILE_FLAG, WORKFLOW_FLAG],
|
|
202
320
|
output: { run: "run number" },
|
|
203
321
|
exitCodes: { [EXIT_NO_STATUS]: "status.jsonl missing, unreadable, or not valid NDJSON" },
|
|
@@ -208,32 +326,14 @@ export const countersCommand = {
|
|
|
208
326
|
},
|
|
209
327
|
route: {
|
|
210
328
|
summary: "Compare a counter to its max: exit 0 continue, exit 1 exceeded; with --point, also whether to ask.",
|
|
329
|
+
use: "workflow",
|
|
211
330
|
flags: [
|
|
212
|
-
|
|
213
|
-
{
|
|
214
|
-
name: "value",
|
|
215
|
-
type: "string",
|
|
216
|
-
help: "counter value (non-negative integer), or derive it with --of / --rows",
|
|
217
|
-
},
|
|
218
|
-
{
|
|
219
|
-
name: "of",
|
|
220
|
-
type: "string",
|
|
221
|
-
help: "<step>:<next|current|count> — derive the value from --file (active run); <step>,<step>...:count sums the listed steps",
|
|
222
|
-
},
|
|
223
|
-
{
|
|
224
|
-
name: "rows",
|
|
225
|
-
type: "string",
|
|
226
|
-
help: "<row type>:count — rows of that type in --file's active run; with --of, added to it",
|
|
227
|
-
},
|
|
228
|
-
{ ...FILE_FLAG, required: false, help: "status.jsonl, with --of or --rows" },
|
|
229
|
-
{ ...WORKFLOW_FLAG, required: false, help: "workflow, with --of or --rows" },
|
|
230
|
-
{ ...GROUP_FLAG, help: "with --of: only rows for this plan group" },
|
|
231
|
-
{ ...ALL_RUNS_FLAG, help: "with --of: count every run of the workflow in --file" },
|
|
331
|
+
...VALUE_FLAGS,
|
|
232
332
|
{ name: "max", type: "string", help: "max as a number (or use --point)" },
|
|
233
333
|
{
|
|
234
334
|
name: "point",
|
|
235
335
|
type: "string",
|
|
236
|
-
help: `ask point whose limit is the max: ${ASK_POINTS.join(" | ")}`,
|
|
336
|
+
help: `ask point whose limit is the max: ${ASK_POINTS.join(" | ")}; with --file and --workflow, as the active run's workflow-started row froze it, else live from package.json`,
|
|
237
337
|
},
|
|
238
338
|
{ name: "continue", type: "string", help: "step to go to when value <= max" },
|
|
239
339
|
{ name: "exceeded", type: "string", help: "step to go to when value > max" },
|
|
@@ -244,6 +344,9 @@ export const countersCommand = {
|
|
|
244
344
|
next: "--continue or --exceeded step, whichever applies (null when not given)",
|
|
245
345
|
max: "the max compared against",
|
|
246
346
|
ask: "with --point: the point's ask setting, false when headless (GITHUB_ACTION); else false",
|
|
347
|
+
limitsFrom: "with --point: run (the active run's workflow-started row froze the limit) | package.json (read live: no --file / --workflow, or no frozen limit)",
|
|
348
|
+
grants: "with --point, --file and --workflow: allowance-granted rows for the point (and --group); max = allowance x (1 + grants)",
|
|
349
|
+
allowance: "with --point, --file and --workflow: one full allowance, the point's maxAttempts",
|
|
247
350
|
},
|
|
248
351
|
exitCodes: {
|
|
249
352
|
[EXIT_NO_STATUS]: "--of / --rows: status.jsonl missing, unreadable, or not valid NDJSON",
|
|
@@ -251,19 +354,12 @@ export const countersCommand = {
|
|
|
251
354
|
},
|
|
252
355
|
run: (ctx) => {
|
|
253
356
|
const name = String(ctx.flags.name);
|
|
254
|
-
const
|
|
255
|
-
if (derived === (ctx.flags.value !== undefined))
|
|
256
|
-
throw new CommandError(EXIT.USAGE, "give --value, or --of and/or --rows");
|
|
257
|
-
const value = derived
|
|
258
|
-
? (ctx.flags.of !== undefined ? derivedOf(ctx) : 0) +
|
|
259
|
-
(ctx.flags.rows !== undefined ? derivedRows(ctx) : 0)
|
|
260
|
-
: nonNegativeInt(ctx.flags.value, "value");
|
|
357
|
+
const value = counterValue(ctx);
|
|
261
358
|
if ((ctx.flags.max === undefined) === (ctx.flags.point === undefined)) {
|
|
262
359
|
throw new CommandError(EXIT.USAGE, "give exactly one of --max or --point");
|
|
263
360
|
}
|
|
264
|
-
const
|
|
265
|
-
const
|
|
266
|
-
const max = setting === undefined ? nonNegativeInt(ctx.flags.max, "max") : setting.max;
|
|
361
|
+
const limit = pointLimit(ctx);
|
|
362
|
+
const max = limit === undefined ? nonNegativeInt(ctx.flags.max, "max") : limit.max;
|
|
267
363
|
const exceeded = value > max;
|
|
268
364
|
if (exceeded)
|
|
269
365
|
ctx.log(`counter ${name} exceeded max=${max} (value=${value})`);
|
|
@@ -272,17 +368,88 @@ export const countersCommand = {
|
|
|
272
368
|
exceeded,
|
|
273
369
|
next: (exceeded ? str(ctx.flags.exceeded) : str(ctx.flags.continue)) ?? null,
|
|
274
370
|
max,
|
|
275
|
-
ask:
|
|
371
|
+
ask: limit?.ask ?? false,
|
|
372
|
+
...(limit === undefined ? {} : limit.out),
|
|
276
373
|
});
|
|
277
374
|
return exceeded ? EXIT.NO : EXIT.OK;
|
|
278
375
|
},
|
|
279
376
|
},
|
|
377
|
+
grant: {
|
|
378
|
+
summary: "Give one loop one more full allowance after the owner chose to continue at its used-up limit: exit 0 granted, exit 1 not (below the limit, ask off or headless).",
|
|
379
|
+
use: "workflow",
|
|
380
|
+
flags: [
|
|
381
|
+
...VALUE_FLAGS,
|
|
382
|
+
{
|
|
383
|
+
name: "point",
|
|
384
|
+
type: "string",
|
|
385
|
+
required: true,
|
|
386
|
+
help: `the loop's ask point: ${ASK_POINTS.join(" | ")}`,
|
|
387
|
+
},
|
|
388
|
+
],
|
|
389
|
+
output: {
|
|
390
|
+
granted: "true when an allowance-granted row was appended",
|
|
391
|
+
reason: "why nothing was granted: below-limit | ask-off (ask = false, or headless); null when granted",
|
|
392
|
+
value: "the counter compared",
|
|
393
|
+
max: "the limit after the grant",
|
|
394
|
+
grants: "allowance-granted rows for the point (and --group) after the grant",
|
|
395
|
+
},
|
|
396
|
+
exitCodes: {
|
|
397
|
+
[EXIT_NO_STATUS]: "status.jsonl missing, unreadable, or not valid NDJSON",
|
|
398
|
+
[EXIT_NO_OWN_ROW]: "--of=<step>:current counted 0: the step's own row is missing",
|
|
399
|
+
},
|
|
400
|
+
run: (ctx) => {
|
|
401
|
+
if (ctx.flags.file === undefined || ctx.flags.workflow === undefined)
|
|
402
|
+
throw new CommandError(EXIT.USAGE, "grant needs --file and --workflow");
|
|
403
|
+
const file = statusFile(ctx);
|
|
404
|
+
if (!fs.existsSync(file))
|
|
405
|
+
throw new CommandError(EXIT_NO_STATUS, `${file} does not exist`);
|
|
406
|
+
const value = counterValue(ctx);
|
|
407
|
+
const limit = pointLimit(ctx);
|
|
408
|
+
const grants = Number(limit.out.grants);
|
|
409
|
+
const refuse = (reason) => {
|
|
410
|
+
ctx.log(`counter ${String(ctx.flags.name)}: no allowance granted (${reason})`);
|
|
411
|
+
ctx.emit({ granted: false, reason, value, max: limit.max, grants });
|
|
412
|
+
return EXIT.NO;
|
|
413
|
+
};
|
|
414
|
+
if (!limit.ask)
|
|
415
|
+
return refuse("ask-off");
|
|
416
|
+
if (value < limit.max)
|
|
417
|
+
return refuse("below-limit");
|
|
418
|
+
const group = positiveInt(ctx.flags.group, "group");
|
|
419
|
+
const row = {
|
|
420
|
+
type: ALLOWANCE_ROW,
|
|
421
|
+
workflow: String(ctx.flags.workflow),
|
|
422
|
+
at: statusTimestamp(),
|
|
423
|
+
point: limit.point,
|
|
424
|
+
...(group === undefined ? {} : { group }),
|
|
425
|
+
value,
|
|
426
|
+
};
|
|
427
|
+
fs.appendFileSync(file, appendLine(row));
|
|
428
|
+
const max = limit.max + Number(limit.out.allowance);
|
|
429
|
+
ctx.log(`counter ${String(ctx.flags.name)}: one more allowance for ${limit.point}, max=${max}`);
|
|
430
|
+
ctx.emit({ granted: true, reason: null, value, max, grants: grants + 1 });
|
|
431
|
+
return EXIT.OK;
|
|
432
|
+
},
|
|
433
|
+
},
|
|
280
434
|
max: {
|
|
281
435
|
summary: "The ask points' limits and ask settings: one by --point, or all.",
|
|
282
|
-
|
|
436
|
+
use: "workflow",
|
|
437
|
+
flags: [
|
|
438
|
+
{ name: "point", type: "string", help: "ask point, e.g. debug.fix" },
|
|
439
|
+
{
|
|
440
|
+
...FILE_FLAG,
|
|
441
|
+
required: false,
|
|
442
|
+
help: "status.jsonl: with --point and --workflow, the limit as the active run's workflow-started row froze it",
|
|
443
|
+
},
|
|
444
|
+
{ ...WORKFLOW_FLAG, required: false, help: "workflow, with --file" },
|
|
445
|
+
GROUP_FLAG,
|
|
446
|
+
],
|
|
283
447
|
output: {
|
|
284
448
|
value: "the point's limit (with --point)",
|
|
285
449
|
ask: "the point's ask setting, false when headless (with --point)",
|
|
450
|
+
limitsFrom: "run (the active run's workflow-started row froze the limit) | package.json (with --point)",
|
|
451
|
+
grants: "with --point, --file and --workflow: allowance-granted rows for the point; value = allowance x (1 + grants)",
|
|
452
|
+
allowance: "with --point, --file and --workflow: one full allowance, the point's maxAttempts",
|
|
286
453
|
points: "every point's {ask, max} as set (without --point)",
|
|
287
454
|
},
|
|
288
455
|
run: (ctx) => {
|
|
@@ -291,16 +458,14 @@ export const countersCommand = {
|
|
|
291
458
|
ctx.emit({ points: readBkitConfig(checkoutRoot(ctx.cwd)).asks });
|
|
292
459
|
return EXIT.OK;
|
|
293
460
|
}
|
|
294
|
-
const
|
|
295
|
-
ctx.emit({
|
|
296
|
-
value: setting.max,
|
|
297
|
-
ask: setting.ask && !headlessRun(ctx.cwd),
|
|
298
|
-
});
|
|
461
|
+
const limit = pointLimit(ctx);
|
|
462
|
+
ctx.emit({ value: limit.max, ask: limit.ask, ...limit.out });
|
|
299
463
|
return EXIT.OK;
|
|
300
464
|
},
|
|
301
465
|
},
|
|
302
466
|
progress: {
|
|
303
467
|
summary: "Progress report for a fix loop in the active run: counts per round, code change, strategy, trend.",
|
|
468
|
+
use: "workflow",
|
|
304
469
|
flags: [
|
|
305
470
|
FILE_FLAG,
|
|
306
471
|
WORKFLOW_FLAG,
|
|
@@ -339,6 +504,7 @@ export const countersCommand = {
|
|
|
339
504
|
},
|
|
340
505
|
rows: {
|
|
341
506
|
summary: "Count rows of one audit type in the active run (since its workflow-started row).",
|
|
507
|
+
use: "workflow",
|
|
342
508
|
flags: [
|
|
343
509
|
FILE_FLAG,
|
|
344
510
|
WORKFLOW_FLAG,
|
|
@@ -4,8 +4,8 @@
|
|
|
4
4
|
// lines, an optional progress block, then one item per question:
|
|
5
5
|
//
|
|
6
6
|
// **Q{n} — {title}:** {question}
|
|
7
|
-
// Options: {A} / {B}
|
|
8
|
-
// Recommended: {A} — {reason}
|
|
7
|
+
// Options: A) {A} / B) {B}
|
|
8
|
+
// Recommended: A) {A} — {reason} (a hard blocker: `No recommendation — {why}`)
|
|
9
9
|
// Decision: {answer} — {words} (once decided)
|
|
10
10
|
//
|
|
11
11
|
// `apply --by=headless` takes each recommendation when nobody can or should be asked: an
|
|
@@ -26,6 +26,38 @@ import { positiveInt, str } from "./status.js";
|
|
|
26
26
|
export const EXIT_HARD_BLOCKERS = 4;
|
|
27
27
|
const ITEM_SPLIT = /^(?=\*\*Q\d+ — )/m;
|
|
28
28
|
const lineOf = (text, key) => new RegExp(`^${key}:[ \\t]*(.+?)[ \\t]*$`, "m").exec(text)?.[1] ?? null;
|
|
29
|
+
/** Options one item may hold: one per letter, `A` to `Z`. */
|
|
30
|
+
const MAX_OPTIONS = 26;
|
|
31
|
+
/** `A`, `B`, … for option index `i`. */
|
|
32
|
+
const letterAt = (i) => String.fromCharCode(65 + i);
|
|
33
|
+
/** An option entry's leading letter (`A) `) dropped, so a parsed name stays bare. */
|
|
34
|
+
const bareName = (s) => s.replace(/^[A-Z]\)[ \t]*/, "");
|
|
35
|
+
/** A reply opening on an option letter: `B`, `B)`, `B — …`, `B) {option} …`, `B {option} …`. */
|
|
36
|
+
const LETTER_REPLY = /^([A-Za-z])(?:\)|(?=[ \t—:,.-]|$))[ \t]*(?:[—:,.-][ \t]*)?/;
|
|
37
|
+
/**
|
|
38
|
+
* An answer read as the option it names. A leading letter of `options` (either case, with or
|
|
39
|
+
* without `)`) becomes the option it labels: `B`, `B) Reject` and `B — too risky` read as
|
|
40
|
+
* `Reject`, `Reject` and `Reject — too risky`. Any other answer is returned unchanged; with
|
|
41
|
+
* no options known, only a leading `A) ` is dropped.
|
|
42
|
+
*/
|
|
43
|
+
export function optionAnswer(answer, options) {
|
|
44
|
+
if (options.length === 0)
|
|
45
|
+
return bareName(answer);
|
|
46
|
+
const m = LETTER_REPLY.exec(answer);
|
|
47
|
+
const name = m === null ? undefined : options[m[1].toUpperCase().charCodeAt(0) - 65];
|
|
48
|
+
if (m === null || name === undefined)
|
|
49
|
+
return answer;
|
|
50
|
+
const rest = answer.slice(m[0].length);
|
|
51
|
+
if (rest.toLowerCase().startsWith(name.toLowerCase()))
|
|
52
|
+
return name + rest.slice(name.length);
|
|
53
|
+
if (rest === "")
|
|
54
|
+
return name;
|
|
55
|
+
return /[)—:,.-]/.test(m[0]) ? `${name} — ${rest}` : answer;
|
|
56
|
+
}
|
|
57
|
+
/** The option list as it is written: `A) {A} / B) {B}`. */
|
|
58
|
+
const letteredOptions = (options) => options.map((o, i) => `${letterAt(i)}) ${o}`).join(" / ");
|
|
59
|
+
/** The letter `name` holds in `options`, or null when it is not one of them. */
|
|
60
|
+
const letterOf = (options, name) => options.includes(name) ? letterAt(options.indexOf(name)) : null;
|
|
29
61
|
/** The items of a decision file's text, in file order. */
|
|
30
62
|
export function parseDecisionItems(text) {
|
|
31
63
|
return text
|
|
@@ -36,16 +68,18 @@ export function parseDecisionItems(text) {
|
|
|
36
68
|
const rec = lineOf(part, "Recommended");
|
|
37
69
|
const none = /^No recommendation\b/m.test(part);
|
|
38
70
|
const [option, ...why] = (rec ?? "").split(" — ");
|
|
39
|
-
const
|
|
71
|
+
const options = (lineOf(part, "Options") ?? "")
|
|
72
|
+
.split(" / ")
|
|
73
|
+
.map((o) => bareName(o.trim()))
|
|
74
|
+
.filter(Boolean);
|
|
75
|
+
const answer = lineOf(part, "Decision");
|
|
76
|
+
const decision = answer === null ? null : optionAnswer(answer, options);
|
|
40
77
|
return {
|
|
41
78
|
n: Number(head?.[1] ?? 0),
|
|
42
79
|
title: head?.[2] ?? "",
|
|
43
80
|
text: part.trimEnd(),
|
|
44
|
-
options
|
|
45
|
-
|
|
46
|
-
.map((o) => o.trim())
|
|
47
|
-
.filter(Boolean),
|
|
48
|
-
recommended: none || rec === null ? null : (option ?? "").trim(),
|
|
81
|
+
options,
|
|
82
|
+
recommended: none || rec === null ? null : bareName((option ?? "").trim()),
|
|
49
83
|
reason: why.join(" — ").trim(),
|
|
50
84
|
decision,
|
|
51
85
|
assumed: decision !== null && /^Accept \(assumed\)/.test(decision),
|
|
@@ -116,6 +150,8 @@ function composeItems(raw) {
|
|
|
116
150
|
const options = Array.isArray(o.options) ? o.options.filter((x) => typeof x === "string") : [];
|
|
117
151
|
if (s("title") === "" || s("question") === "" || options.length === 0)
|
|
118
152
|
throw new CommandError(EXIT.USAGE, `item ${i + 1}: needs title, question and options`);
|
|
153
|
+
if (options.length > MAX_OPTIONS)
|
|
154
|
+
throw new CommandError(EXIT.USAGE, `item ${i + 1}: at most ${MAX_OPTIONS} options (A-Z)`);
|
|
119
155
|
if (s("noRecommendation") === "" && !options.includes(s("recommended")))
|
|
120
156
|
throw new CommandError(EXIT.USAGE, `item ${i + 1}: recommended must be one of its options, or set noRecommendation`);
|
|
121
157
|
return {
|
|
@@ -128,13 +164,17 @@ function composeItems(raw) {
|
|
|
128
164
|
};
|
|
129
165
|
});
|
|
130
166
|
}
|
|
131
|
-
const itemLines = (n, it) =>
|
|
132
|
-
|
|
133
|
-
|
|
134
|
-
|
|
135
|
-
|
|
136
|
-
|
|
137
|
-
|
|
167
|
+
const itemLines = (n, it) => {
|
|
168
|
+
const rec = it.recommended ?? "";
|
|
169
|
+
const letter = letterOf(it.options, rec);
|
|
170
|
+
return [
|
|
171
|
+
`**Q${n} — ${it.title}:** ${it.question}`,
|
|
172
|
+
`Options: ${letteredOptions(it.options)}`,
|
|
173
|
+
it.noRecommendation
|
|
174
|
+
? `No recommendation — ${it.noRecommendation}`
|
|
175
|
+
: `Recommended: ${letter === null ? rec : `${letter}) ${rec}`} — ${it.reason || "the orchestrator's call"}`,
|
|
176
|
+
];
|
|
177
|
+
};
|
|
138
178
|
// ---------------------------------------------------------------------------
|
|
139
179
|
// apply
|
|
140
180
|
// ---------------------------------------------------------------------------
|
|
@@ -192,7 +232,7 @@ function deferralRow(file, it) {
|
|
|
192
232
|
severity,
|
|
193
233
|
reason: "needs-decision",
|
|
194
234
|
summary: `${fid}: ${it.title} accepted without the owner (${ref})`,
|
|
195
|
-
description: `Decision needed: accept or fix "${it.title}". Options: ${it.options
|
|
235
|
+
description: `Decision needed: accept or fix "${it.title}". Options: ${letteredOptions(it.options)}. ${it.rejected ? "The owner rejected the assumed accept at ship." : "Nobody confirmed the assumed accept before the merge."} Item: ${it.text.split("\n")[0]}`,
|
|
196
236
|
status: "OPEN",
|
|
197
237
|
};
|
|
198
238
|
}
|
|
@@ -216,6 +256,7 @@ export const decisionsCommand = {
|
|
|
216
256
|
verbs: {
|
|
217
257
|
compose: {
|
|
218
258
|
summary: "Write a decision file in the one question layout, with loop progress when asked.",
|
|
259
|
+
use: "workflow",
|
|
219
260
|
flags: [
|
|
220
261
|
{ name: "out", type: "string", required: true, help: "the decision file to write" },
|
|
221
262
|
{
|
|
@@ -235,7 +276,7 @@ export const decisionsCommand = {
|
|
|
235
276
|
help: "verify | tests: add the progress block and the loop question as Q1",
|
|
236
277
|
},
|
|
237
278
|
{ name: "file", type: "string", help: "status.jsonl, with --loop" },
|
|
238
|
-
{ name: "group", type: "string", help: "with --loop=verify: the
|
|
279
|
+
{ name: "group", type: "string", help: "with --loop=verify: the task group" },
|
|
239
280
|
{ name: "attempt", type: "string", help: "with --loop: the attempt just failed" },
|
|
240
281
|
{ name: "max", type: "string", help: "with --loop: the point's maxAttempts" },
|
|
241
282
|
],
|
|
@@ -308,6 +349,7 @@ export const decisionsCommand = {
|
|
|
308
349
|
},
|
|
309
350
|
apply: {
|
|
310
351
|
summary: "Settle a decision file's items: --by=headless takes each recommendation; --by=owner confirms or rejects one assumed item.",
|
|
352
|
+
use: "workflow",
|
|
311
353
|
flags: [
|
|
312
354
|
{ name: "file", type: "string", required: true, help: "the decision file" },
|
|
313
355
|
{ name: "by", type: "string", required: true, help: "headless | owner" },
|
|
@@ -382,6 +424,7 @@ export const decisionsCommand = {
|
|
|
382
424
|
},
|
|
383
425
|
pending: {
|
|
384
426
|
summary: "List the feature's assumed Accepts nobody confirmed; --defer writes one needs-decision deferral per item.",
|
|
427
|
+
use: "workflow",
|
|
385
428
|
flags: [
|
|
386
429
|
{ name: "fid", type: "string", required: true, help: "feature id" },
|
|
387
430
|
{ name: "month", type: "string", required: true, help: "YYYYMM of the feature's logs" },
|