@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`:
|
|
@@ -9,14 +9,17 @@
|
|
|
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
11
|
|
|
12
|
+
import * as fs from "node:fs";
|
|
12
13
|
import * as path from "node:path";
|
|
13
14
|
|
|
14
15
|
import {
|
|
15
16
|
activeDoneSteps,
|
|
16
17
|
allRunsDoneSteps,
|
|
18
|
+
appendLine,
|
|
17
19
|
lastDoneStepAllRuns,
|
|
18
20
|
nextStrategy,
|
|
19
21
|
runNumber,
|
|
22
|
+
statusTimestamp,
|
|
20
23
|
type Step,
|
|
21
24
|
} from "../../ledgers/status.js";
|
|
22
25
|
import {
|
|
@@ -121,6 +124,32 @@ const ALL_RUNS_FLAG = {
|
|
|
121
124
|
help: "count every run of the workflow in --file, not only the active one",
|
|
122
125
|
} as const;
|
|
123
126
|
|
|
127
|
+
/** The `workflow-started` row that opened `workflow`'s active run; undefined with no file or no run. */
|
|
128
|
+
export function activeRunStart(
|
|
129
|
+
file: string,
|
|
130
|
+
workflow: string,
|
|
131
|
+
): Record<string, unknown> | undefined {
|
|
132
|
+
if (!fs.existsSync(file)) return undefined;
|
|
133
|
+
return readStatusRows(file)
|
|
134
|
+
.filter((r) => r.type === "workflow-started" && r.workflow === workflow)
|
|
135
|
+
.sort((a, b) => String(a.at).localeCompare(String(b.at)))
|
|
136
|
+
.at(-1);
|
|
137
|
+
}
|
|
138
|
+
|
|
139
|
+
/** The point's limit as the active run froze it in its `workflow-started` row's `limits`. */
|
|
140
|
+
function frozenAskSetting(file: string, workflow: string, point: AskPoint): AskSetting | undefined {
|
|
141
|
+
const limits = activeRunStart(file, workflow)?.limits;
|
|
142
|
+
const frozen =
|
|
143
|
+
limits !== null && typeof limits === "object"
|
|
144
|
+
? (limits as Record<string, unknown>)[point]
|
|
145
|
+
: undefined;
|
|
146
|
+
if (frozen === null || typeof frozen !== "object") return undefined;
|
|
147
|
+
const { ask, max } = frozen as Record<string, unknown>;
|
|
148
|
+
return typeof ask === "boolean" && Number.isInteger(max) && (max as number) >= 0
|
|
149
|
+
? { ask, max: max as number }
|
|
150
|
+
: undefined;
|
|
151
|
+
}
|
|
152
|
+
|
|
124
153
|
/** Rows of `type` in `workflow`'s active run (since its last workflow-started row). */
|
|
125
154
|
function typedRowCount(file: string, workflow: string, type: string): number {
|
|
126
155
|
const rows = readStatusRows(file);
|
|
@@ -133,6 +162,52 @@ function typedRowCount(file: string, workflow: string, type: string): number {
|
|
|
133
162
|
.filter((r) => r.type === type && (r.workflow === undefined || r.workflow === workflow)).length;
|
|
134
163
|
}
|
|
135
164
|
|
|
165
|
+
/** The row `counters grant` writes: the owner gave one loop one more full allowance. */
|
|
166
|
+
export const ALLOWANCE_ROW = "allowance-granted";
|
|
167
|
+
|
|
168
|
+
/**
|
|
169
|
+
* Allowances granted to `point` (and `group`, when given) in `workflow`'s active run, or
|
|
170
|
+
* across every run of the file with `allRuns`.
|
|
171
|
+
*/
|
|
172
|
+
export function grantCount(
|
|
173
|
+
file: string,
|
|
174
|
+
workflow: string,
|
|
175
|
+
point: AskPoint,
|
|
176
|
+
group: number | undefined,
|
|
177
|
+
allRuns: boolean,
|
|
178
|
+
): number {
|
|
179
|
+
if (!fs.existsSync(file)) return 0;
|
|
180
|
+
const rows = readStatusRows(file);
|
|
181
|
+
let start = -1;
|
|
182
|
+
if (!allRuns)
|
|
183
|
+
rows.forEach((r, i) => {
|
|
184
|
+
if (r.type === "workflow-started" && r.workflow === workflow) start = i;
|
|
185
|
+
});
|
|
186
|
+
return rows
|
|
187
|
+
.slice(start + 1)
|
|
188
|
+
.filter(
|
|
189
|
+
(r) =>
|
|
190
|
+
r.type === ALLOWANCE_ROW &&
|
|
191
|
+
r.workflow === workflow &&
|
|
192
|
+
r.point === point &&
|
|
193
|
+
(group === undefined || r.group === group),
|
|
194
|
+
).length;
|
|
195
|
+
}
|
|
196
|
+
|
|
197
|
+
/** A loop's frozen allowance, including the owner's saved grants; absent for legacy runs. */
|
|
198
|
+
export function savedPointLimit(
|
|
199
|
+
file: string,
|
|
200
|
+
workflow: string,
|
|
201
|
+
point: AskPoint,
|
|
202
|
+
group?: number,
|
|
203
|
+
allRuns = false,
|
|
204
|
+
): number | undefined {
|
|
205
|
+
const setting = frozenAskSetting(file, workflow, point);
|
|
206
|
+
return setting === undefined
|
|
207
|
+
? undefined
|
|
208
|
+
: setting.max * (1 + grantCount(file, workflow, point, group, allRuns));
|
|
209
|
+
}
|
|
210
|
+
|
|
136
211
|
/** `route --rows=<type>:count`: rows of that type in the active run. */
|
|
137
212
|
function derivedRows(ctx: RunContext): number {
|
|
138
213
|
const [type, position] = String(ctx.flags.rows).split(":");
|
|
@@ -229,12 +304,86 @@ export function loopProgress(
|
|
|
229
304
|
};
|
|
230
305
|
}
|
|
231
306
|
|
|
307
|
+
/**
|
|
308
|
+
* `--point`'s limit for route and grant: the run's frozen setting (else package.json's), its
|
|
309
|
+
* max raised by one full allowance per `allowance-granted` row when `--file` and
|
|
310
|
+
* `--workflow` name the run; undefined without `--point`.
|
|
311
|
+
*/
|
|
312
|
+
function pointLimit(
|
|
313
|
+
ctx: RunContext,
|
|
314
|
+
): { point: AskPoint; max: number; ask: boolean; out: Record<string, unknown> } | undefined {
|
|
315
|
+
if (ctx.flags.point === undefined) return undefined;
|
|
316
|
+
const point = askPoint(String(ctx.flags.point));
|
|
317
|
+
const inRun = ctx.flags.file !== undefined && ctx.flags.workflow !== undefined;
|
|
318
|
+
const frozen = inRun
|
|
319
|
+
? frozenAskSetting(statusFile(ctx), String(ctx.flags.workflow), point)
|
|
320
|
+
: undefined;
|
|
321
|
+
const setting = frozen ?? askSetting(ctx.cwd, point);
|
|
322
|
+
const grants = inRun
|
|
323
|
+
? grantCount(
|
|
324
|
+
statusFile(ctx),
|
|
325
|
+
String(ctx.flags.workflow),
|
|
326
|
+
point,
|
|
327
|
+
positiveInt(ctx.flags.group, "group"),
|
|
328
|
+
ctx.flags.allRuns === true,
|
|
329
|
+
)
|
|
330
|
+
: 0;
|
|
331
|
+
return {
|
|
332
|
+
point,
|
|
333
|
+
max: setting.max * (1 + grants),
|
|
334
|
+
ask: setting.ask && !headlessRun(ctx.cwd),
|
|
335
|
+
out: {
|
|
336
|
+
limitsFrom: frozen ? "run" : "package.json",
|
|
337
|
+
...(inRun ? { grants, allowance: setting.max } : {}),
|
|
338
|
+
},
|
|
339
|
+
};
|
|
340
|
+
}
|
|
341
|
+
|
|
342
|
+
/** The flags route and grant share: the counter's value, and the limit it is compared to. */
|
|
343
|
+
const VALUE_FLAGS = [
|
|
344
|
+
{ name: "name", type: "string", required: true, help: "counter name, for the log line" },
|
|
345
|
+
{
|
|
346
|
+
name: "value",
|
|
347
|
+
type: "string",
|
|
348
|
+
help: "counter value (non-negative integer), or derive it with --of / --rows",
|
|
349
|
+
},
|
|
350
|
+
{
|
|
351
|
+
name: "of",
|
|
352
|
+
type: "string",
|
|
353
|
+
help: "<step>:<next|current|count> — derive the value from --file (active run); <step>,<step>...:count sums the listed steps",
|
|
354
|
+
},
|
|
355
|
+
{
|
|
356
|
+
name: "rows",
|
|
357
|
+
type: "string",
|
|
358
|
+
help: "<row type>:count — rows of that type in --file's active run; with --of, added to it",
|
|
359
|
+
},
|
|
360
|
+
{ ...FILE_FLAG, required: false, help: "status.jsonl, with --of or --rows" },
|
|
361
|
+
{ ...WORKFLOW_FLAG, required: false, help: "workflow, with --of or --rows" },
|
|
362
|
+
{ ...GROUP_FLAG, help: "with --of: only rows for this task group; with --point: its grants" },
|
|
363
|
+
{
|
|
364
|
+
...ALL_RUNS_FLAG,
|
|
365
|
+
help: "with --of: count every run of the workflow in --file; with --point: grants of every run",
|
|
366
|
+
},
|
|
367
|
+
] as const;
|
|
368
|
+
|
|
369
|
+
/** The counter's value: `--value`, or derived with `--of` and/or `--rows`. */
|
|
370
|
+
function counterValue(ctx: RunContext): number {
|
|
371
|
+
const derived = ctx.flags.of !== undefined || ctx.flags.rows !== undefined;
|
|
372
|
+
if (derived === (ctx.flags.value !== undefined))
|
|
373
|
+
throw new CommandError(EXIT.USAGE, "give --value, or --of and/or --rows");
|
|
374
|
+
return derived
|
|
375
|
+
? (ctx.flags.of !== undefined ? derivedOf(ctx) : 0) +
|
|
376
|
+
(ctx.flags.rows !== undefined ? derivedRows(ctx) : 0)
|
|
377
|
+
: nonNegativeInt(ctx.flags.value, "value");
|
|
378
|
+
}
|
|
379
|
+
|
|
232
380
|
export const countersCommand: CommandSpec = {
|
|
233
381
|
noun: "counters",
|
|
234
382
|
summary: "Attempt counters derived from status.jsonl, and the ask points' limits.",
|
|
235
383
|
verbs: {
|
|
236
384
|
derive: {
|
|
237
385
|
summary: "Count a step's DONE rows in the active run, at one of three positions.",
|
|
386
|
+
use: "workflow",
|
|
238
387
|
flags: [
|
|
239
388
|
FILE_FLAG,
|
|
240
389
|
WORKFLOW_FLAG,
|
|
@@ -275,6 +424,7 @@ export const countersCommand: CommandSpec = {
|
|
|
275
424
|
},
|
|
276
425
|
run: {
|
|
277
426
|
summary: "Which run of the workflow this invocation is (1-based; a resume keeps its number).",
|
|
427
|
+
use: "workflow",
|
|
278
428
|
flags: [FILE_FLAG, WORKFLOW_FLAG],
|
|
279
429
|
output: { run: "run number" },
|
|
280
430
|
exitCodes: { [EXIT_NO_STATUS]: "status.jsonl missing, unreadable, or not valid NDJSON" },
|
|
@@ -286,32 +436,14 @@ export const countersCommand: CommandSpec = {
|
|
|
286
436
|
route: {
|
|
287
437
|
summary:
|
|
288
438
|
"Compare a counter to its max: exit 0 continue, exit 1 exceeded; with --point, also whether to ask.",
|
|
439
|
+
use: "workflow",
|
|
289
440
|
flags: [
|
|
290
|
-
|
|
291
|
-
{
|
|
292
|
-
name: "value",
|
|
293
|
-
type: "string",
|
|
294
|
-
help: "counter value (non-negative integer), or derive it with --of / --rows",
|
|
295
|
-
},
|
|
296
|
-
{
|
|
297
|
-
name: "of",
|
|
298
|
-
type: "string",
|
|
299
|
-
help: "<step>:<next|current|count> — derive the value from --file (active run); <step>,<step>...:count sums the listed steps",
|
|
300
|
-
},
|
|
301
|
-
{
|
|
302
|
-
name: "rows",
|
|
303
|
-
type: "string",
|
|
304
|
-
help: "<row type>:count — rows of that type in --file's active run; with --of, added to it",
|
|
305
|
-
},
|
|
306
|
-
{ ...FILE_FLAG, required: false, help: "status.jsonl, with --of or --rows" },
|
|
307
|
-
{ ...WORKFLOW_FLAG, required: false, help: "workflow, with --of or --rows" },
|
|
308
|
-
{ ...GROUP_FLAG, help: "with --of: only rows for this plan group" },
|
|
309
|
-
{ ...ALL_RUNS_FLAG, help: "with --of: count every run of the workflow in --file" },
|
|
441
|
+
...VALUE_FLAGS,
|
|
310
442
|
{ name: "max", type: "string", help: "max as a number (or use --point)" },
|
|
311
443
|
{
|
|
312
444
|
name: "point",
|
|
313
445
|
type: "string",
|
|
314
|
-
help: `ask point whose limit is the max: ${ASK_POINTS.join(" | ")}`,
|
|
446
|
+
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`,
|
|
315
447
|
},
|
|
316
448
|
{ name: "continue", type: "string", help: "step to go to when value <= max" },
|
|
317
449
|
{ name: "exceeded", type: "string", help: "step to go to when value > max" },
|
|
@@ -322,6 +454,12 @@ export const countersCommand: CommandSpec = {
|
|
|
322
454
|
next: "--continue or --exceeded step, whichever applies (null when not given)",
|
|
323
455
|
max: "the max compared against",
|
|
324
456
|
ask: "with --point: the point's ask setting, false when headless (GITHUB_ACTION); else false",
|
|
457
|
+
limitsFrom:
|
|
458
|
+
"with --point: run (the active run's workflow-started row froze the limit) | package.json (read live: no --file / --workflow, or no frozen limit)",
|
|
459
|
+
grants:
|
|
460
|
+
"with --point, --file and --workflow: allowance-granted rows for the point (and --group); max = allowance x (1 + grants)",
|
|
461
|
+
allowance:
|
|
462
|
+
"with --point, --file and --workflow: one full allowance, the point's maxAttempts",
|
|
325
463
|
},
|
|
326
464
|
exitCodes: {
|
|
327
465
|
[EXIT_NO_STATUS]: "--of / --rows: status.jsonl missing, unreadable, or not valid NDJSON",
|
|
@@ -329,19 +467,12 @@ export const countersCommand: CommandSpec = {
|
|
|
329
467
|
},
|
|
330
468
|
run: (ctx) => {
|
|
331
469
|
const name = String(ctx.flags.name);
|
|
332
|
-
const
|
|
333
|
-
if (derived === (ctx.flags.value !== undefined))
|
|
334
|
-
throw new CommandError(EXIT.USAGE, "give --value, or --of and/or --rows");
|
|
335
|
-
const value = derived
|
|
336
|
-
? (ctx.flags.of !== undefined ? derivedOf(ctx) : 0) +
|
|
337
|
-
(ctx.flags.rows !== undefined ? derivedRows(ctx) : 0)
|
|
338
|
-
: nonNegativeInt(ctx.flags.value, "value");
|
|
470
|
+
const value = counterValue(ctx);
|
|
339
471
|
if ((ctx.flags.max === undefined) === (ctx.flags.point === undefined)) {
|
|
340
472
|
throw new CommandError(EXIT.USAGE, "give exactly one of --max or --point");
|
|
341
473
|
}
|
|
342
|
-
const
|
|
343
|
-
const
|
|
344
|
-
const max = setting === undefined ? nonNegativeInt(ctx.flags.max, "max") : setting.max;
|
|
474
|
+
const limit = pointLimit(ctx);
|
|
475
|
+
const max = limit === undefined ? nonNegativeInt(ctx.flags.max, "max") : limit.max;
|
|
345
476
|
const exceeded = value > max;
|
|
346
477
|
if (exceeded) ctx.log(`counter ${name} exceeded max=${max} (value=${value})`);
|
|
347
478
|
ctx.emit({
|
|
@@ -349,17 +480,92 @@ export const countersCommand: CommandSpec = {
|
|
|
349
480
|
exceeded,
|
|
350
481
|
next: (exceeded ? str(ctx.flags.exceeded) : str(ctx.flags.continue)) ?? null,
|
|
351
482
|
max,
|
|
352
|
-
ask:
|
|
483
|
+
ask: limit?.ask ?? false,
|
|
484
|
+
...(limit === undefined ? {} : limit.out),
|
|
353
485
|
});
|
|
354
486
|
return exceeded ? EXIT.NO : EXIT.OK;
|
|
355
487
|
},
|
|
356
488
|
},
|
|
489
|
+
grant: {
|
|
490
|
+
summary:
|
|
491
|
+
"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).",
|
|
492
|
+
use: "workflow",
|
|
493
|
+
flags: [
|
|
494
|
+
...VALUE_FLAGS,
|
|
495
|
+
{
|
|
496
|
+
name: "point",
|
|
497
|
+
type: "string",
|
|
498
|
+
required: true,
|
|
499
|
+
help: `the loop's ask point: ${ASK_POINTS.join(" | ")}`,
|
|
500
|
+
},
|
|
501
|
+
],
|
|
502
|
+
output: {
|
|
503
|
+
granted: "true when an allowance-granted row was appended",
|
|
504
|
+
reason:
|
|
505
|
+
"why nothing was granted: below-limit | ask-off (ask = false, or headless); null when granted",
|
|
506
|
+
value: "the counter compared",
|
|
507
|
+
max: "the limit after the grant",
|
|
508
|
+
grants: "allowance-granted rows for the point (and --group) after the grant",
|
|
509
|
+
},
|
|
510
|
+
exitCodes: {
|
|
511
|
+
[EXIT_NO_STATUS]: "status.jsonl missing, unreadable, or not valid NDJSON",
|
|
512
|
+
[EXIT_NO_OWN_ROW]: "--of=<step>:current counted 0: the step's own row is missing",
|
|
513
|
+
},
|
|
514
|
+
run: (ctx) => {
|
|
515
|
+
if (ctx.flags.file === undefined || ctx.flags.workflow === undefined)
|
|
516
|
+
throw new CommandError(EXIT.USAGE, "grant needs --file and --workflow");
|
|
517
|
+
const file = statusFile(ctx);
|
|
518
|
+
if (!fs.existsSync(file)) throw new CommandError(EXIT_NO_STATUS, `${file} does not exist`);
|
|
519
|
+
const value = counterValue(ctx);
|
|
520
|
+
const limit = pointLimit(ctx)!;
|
|
521
|
+
const grants = Number(limit.out.grants);
|
|
522
|
+
const refuse = (reason: string) => {
|
|
523
|
+
ctx.log(`counter ${String(ctx.flags.name)}: no allowance granted (${reason})`);
|
|
524
|
+
ctx.emit({ granted: false, reason, value, max: limit.max, grants });
|
|
525
|
+
return EXIT.NO;
|
|
526
|
+
};
|
|
527
|
+
if (!limit.ask) return refuse("ask-off");
|
|
528
|
+
if (value < limit.max) return refuse("below-limit");
|
|
529
|
+
const group = positiveInt(ctx.flags.group, "group");
|
|
530
|
+
const row = {
|
|
531
|
+
type: ALLOWANCE_ROW,
|
|
532
|
+
workflow: String(ctx.flags.workflow),
|
|
533
|
+
at: statusTimestamp(),
|
|
534
|
+
point: limit.point,
|
|
535
|
+
...(group === undefined ? {} : { group }),
|
|
536
|
+
value,
|
|
537
|
+
};
|
|
538
|
+
fs.appendFileSync(file, appendLine(row));
|
|
539
|
+
const max = limit.max + Number(limit.out.allowance);
|
|
540
|
+
ctx.log(
|
|
541
|
+
`counter ${String(ctx.flags.name)}: one more allowance for ${limit.point}, max=${max}`,
|
|
542
|
+
);
|
|
543
|
+
ctx.emit({ granted: true, reason: null, value, max, grants: grants + 1 });
|
|
544
|
+
return EXIT.OK;
|
|
545
|
+
},
|
|
546
|
+
},
|
|
357
547
|
max: {
|
|
358
548
|
summary: "The ask points' limits and ask settings: one by --point, or all.",
|
|
359
|
-
|
|
549
|
+
use: "workflow",
|
|
550
|
+
flags: [
|
|
551
|
+
{ name: "point", type: "string", help: "ask point, e.g. debug.fix" },
|
|
552
|
+
{
|
|
553
|
+
...FILE_FLAG,
|
|
554
|
+
required: false,
|
|
555
|
+
help: "status.jsonl: with --point and --workflow, the limit as the active run's workflow-started row froze it",
|
|
556
|
+
},
|
|
557
|
+
{ ...WORKFLOW_FLAG, required: false, help: "workflow, with --file" },
|
|
558
|
+
GROUP_FLAG,
|
|
559
|
+
],
|
|
360
560
|
output: {
|
|
361
561
|
value: "the point's limit (with --point)",
|
|
362
562
|
ask: "the point's ask setting, false when headless (with --point)",
|
|
563
|
+
limitsFrom:
|
|
564
|
+
"run (the active run's workflow-started row froze the limit) | package.json (with --point)",
|
|
565
|
+
grants:
|
|
566
|
+
"with --point, --file and --workflow: allowance-granted rows for the point; value = allowance x (1 + grants)",
|
|
567
|
+
allowance:
|
|
568
|
+
"with --point, --file and --workflow: one full allowance, the point's maxAttempts",
|
|
363
569
|
points: "every point's {ask, max} as set (without --point)",
|
|
364
570
|
},
|
|
365
571
|
run: (ctx) => {
|
|
@@ -368,17 +574,15 @@ export const countersCommand: CommandSpec = {
|
|
|
368
574
|
ctx.emit({ points: readBkitConfig(checkoutRoot(ctx.cwd)).asks });
|
|
369
575
|
return EXIT.OK;
|
|
370
576
|
}
|
|
371
|
-
const
|
|
372
|
-
ctx.emit({
|
|
373
|
-
value: setting.max,
|
|
374
|
-
ask: setting.ask && !headlessRun(ctx.cwd),
|
|
375
|
-
});
|
|
577
|
+
const limit = pointLimit(ctx)!;
|
|
578
|
+
ctx.emit({ value: limit.max, ask: limit.ask, ...limit.out });
|
|
376
579
|
return EXIT.OK;
|
|
377
580
|
},
|
|
378
581
|
},
|
|
379
582
|
progress: {
|
|
380
583
|
summary:
|
|
381
584
|
"Progress report for a fix loop in the active run: counts per round, code change, strategy, trend.",
|
|
585
|
+
use: "workflow",
|
|
382
586
|
flags: [
|
|
383
587
|
FILE_FLAG,
|
|
384
588
|
WORKFLOW_FLAG,
|
|
@@ -425,6 +629,7 @@ export const countersCommand: CommandSpec = {
|
|
|
425
629
|
},
|
|
426
630
|
rows: {
|
|
427
631
|
summary: "Count rows of one audit type in the active run (since its workflow-started row).",
|
|
632
|
+
use: "workflow",
|
|
428
633
|
flags: [
|
|
429
634
|
FILE_FLAG,
|
|
430
635
|
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
|
|
@@ -35,6 +35,7 @@ export interface DecisionItem {
|
|
|
35
35
|
/** The recommended option; null for a hard blocker. */
|
|
36
36
|
recommended: string | null;
|
|
37
37
|
reason: string;
|
|
38
|
+
/** The `Decision:` line's text, a lettered answer read as its option (`optionAnswer`). */
|
|
38
39
|
decision: string | null;
|
|
39
40
|
assumed: boolean;
|
|
40
41
|
rejected: boolean;
|
|
@@ -48,6 +49,38 @@ const ITEM_SPLIT = /^(?=\*\*Q\d+ — )/m;
|
|
|
48
49
|
const lineOf = (text: string, key: string): string | null =>
|
|
49
50
|
new RegExp(`^${key}:[ \\t]*(.+?)[ \\t]*$`, "m").exec(text)?.[1] ?? null;
|
|
50
51
|
|
|
52
|
+
/** Options one item may hold: one per letter, `A` to `Z`. */
|
|
53
|
+
const MAX_OPTIONS = 26;
|
|
54
|
+
/** `A`, `B`, … for option index `i`. */
|
|
55
|
+
const letterAt = (i: number): string => String.fromCharCode(65 + i);
|
|
56
|
+
/** An option entry's leading letter (`A) `) dropped, so a parsed name stays bare. */
|
|
57
|
+
const bareName = (s: string): string => s.replace(/^[A-Z]\)[ \t]*/, "");
|
|
58
|
+
/** A reply opening on an option letter: `B`, `B)`, `B — …`, `B) {option} …`, `B {option} …`. */
|
|
59
|
+
const LETTER_REPLY = /^([A-Za-z])(?:\)|(?=[ \t—:,.-]|$))[ \t]*(?:[—:,.-][ \t]*)?/;
|
|
60
|
+
|
|
61
|
+
/**
|
|
62
|
+
* An answer read as the option it names. A leading letter of `options` (either case, with or
|
|
63
|
+
* without `)`) becomes the option it labels: `B`, `B) Reject` and `B — too risky` read as
|
|
64
|
+
* `Reject`, `Reject` and `Reject — too risky`. Any other answer is returned unchanged; with
|
|
65
|
+
* no options known, only a leading `A) ` is dropped.
|
|
66
|
+
*/
|
|
67
|
+
export function optionAnswer(answer: string, options: string[]): string {
|
|
68
|
+
if (options.length === 0) return bareName(answer);
|
|
69
|
+
const m = LETTER_REPLY.exec(answer);
|
|
70
|
+
const name = m === null ? undefined : options[m[1]!.toUpperCase().charCodeAt(0) - 65];
|
|
71
|
+
if (m === null || name === undefined) return answer;
|
|
72
|
+
const rest = answer.slice(m[0].length);
|
|
73
|
+
if (rest.toLowerCase().startsWith(name.toLowerCase())) return name + rest.slice(name.length);
|
|
74
|
+
if (rest === "") return name;
|
|
75
|
+
return /[)—:,.-]/.test(m[0]) ? `${name} — ${rest}` : answer;
|
|
76
|
+
}
|
|
77
|
+
/** The option list as it is written: `A) {A} / B) {B}`. */
|
|
78
|
+
const letteredOptions = (options: string[]): string =>
|
|
79
|
+
options.map((o, i) => `${letterAt(i)}) ${o}`).join(" / ");
|
|
80
|
+
/** The letter `name` holds in `options`, or null when it is not one of them. */
|
|
81
|
+
const letterOf = (options: string[], name: string): string | null =>
|
|
82
|
+
options.includes(name) ? letterAt(options.indexOf(name)) : null;
|
|
83
|
+
|
|
51
84
|
/** The items of a decision file's text, in file order. */
|
|
52
85
|
export function parseDecisionItems(text: string): DecisionItem[] {
|
|
53
86
|
return text
|
|
@@ -58,16 +91,18 @@ export function parseDecisionItems(text: string): DecisionItem[] {
|
|
|
58
91
|
const rec = lineOf(part, "Recommended");
|
|
59
92
|
const none = /^No recommendation\b/m.test(part);
|
|
60
93
|
const [option, ...why] = (rec ?? "").split(" — ");
|
|
61
|
-
const
|
|
94
|
+
const options = (lineOf(part, "Options") ?? "")
|
|
95
|
+
.split(" / ")
|
|
96
|
+
.map((o) => bareName(o.trim()))
|
|
97
|
+
.filter(Boolean);
|
|
98
|
+
const answer = lineOf(part, "Decision");
|
|
99
|
+
const decision = answer === null ? null : optionAnswer(answer, options);
|
|
62
100
|
return {
|
|
63
101
|
n: Number(head?.[1] ?? 0),
|
|
64
102
|
title: head?.[2] ?? "",
|
|
65
103
|
text: part.trimEnd(),
|
|
66
|
-
options
|
|
67
|
-
|
|
68
|
-
.map((o) => o.trim())
|
|
69
|
-
.filter(Boolean),
|
|
70
|
-
recommended: none || rec === null ? null : (option ?? "").trim(),
|
|
104
|
+
options,
|
|
105
|
+
recommended: none || rec === null ? null : bareName((option ?? "").trim()),
|
|
71
106
|
reason: why.join(" — ").trim(),
|
|
72
107
|
decision,
|
|
73
108
|
assumed: decision !== null && /^Accept \(assumed\)/.test(decision),
|
|
@@ -158,6 +193,8 @@ function composeItems(raw: unknown): ComposeItem[] {
|
|
|
158
193
|
const options = Array.isArray(o.options) ? o.options.filter((x) => typeof x === "string") : [];
|
|
159
194
|
if (s("title") === "" || s("question") === "" || options.length === 0)
|
|
160
195
|
throw new CommandError(EXIT.USAGE, `item ${i + 1}: needs title, question and options`);
|
|
196
|
+
if (options.length > MAX_OPTIONS)
|
|
197
|
+
throw new CommandError(EXIT.USAGE, `item ${i + 1}: at most ${MAX_OPTIONS} options (A-Z)`);
|
|
161
198
|
if (s("noRecommendation") === "" && !options.includes(s("recommended")))
|
|
162
199
|
throw new CommandError(
|
|
163
200
|
EXIT.USAGE,
|
|
@@ -174,13 +211,17 @@ function composeItems(raw: unknown): ComposeItem[] {
|
|
|
174
211
|
});
|
|
175
212
|
}
|
|
176
213
|
|
|
177
|
-
const itemLines = (n: number, it: ComposeItem): string[] =>
|
|
178
|
-
|
|
179
|
-
|
|
180
|
-
|
|
181
|
-
|
|
182
|
-
|
|
183
|
-
|
|
214
|
+
const itemLines = (n: number, it: ComposeItem): string[] => {
|
|
215
|
+
const rec = it.recommended ?? "";
|
|
216
|
+
const letter = letterOf(it.options, rec);
|
|
217
|
+
return [
|
|
218
|
+
`**Q${n} — ${it.title}:** ${it.question}`,
|
|
219
|
+
`Options: ${letteredOptions(it.options)}`,
|
|
220
|
+
it.noRecommendation
|
|
221
|
+
? `No recommendation — ${it.noRecommendation}`
|
|
222
|
+
: `Recommended: ${letter === null ? rec : `${letter}) ${rec}`} — ${it.reason || "the orchestrator's call"}`,
|
|
223
|
+
];
|
|
224
|
+
};
|
|
184
225
|
|
|
185
226
|
// ---------------------------------------------------------------------------
|
|
186
227
|
// apply
|
|
@@ -245,7 +286,7 @@ function deferralRow(file: string, it: DecisionItem): Record<string, unknown> {
|
|
|
245
286
|
severity,
|
|
246
287
|
reason: "needs-decision",
|
|
247
288
|
summary: `${fid}: ${it.title} accepted without the owner (${ref})`,
|
|
248
|
-
description: `Decision needed: accept or fix "${it.title}". Options: ${it.options
|
|
289
|
+
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]}`,
|
|
249
290
|
status: "OPEN",
|
|
250
291
|
};
|
|
251
292
|
}
|
|
@@ -277,6 +318,7 @@ export const decisionsCommand: CommandSpec = {
|
|
|
277
318
|
verbs: {
|
|
278
319
|
compose: {
|
|
279
320
|
summary: "Write a decision file in the one question layout, with loop progress when asked.",
|
|
321
|
+
use: "workflow",
|
|
280
322
|
flags: [
|
|
281
323
|
{ name: "out", type: "string", required: true, help: "the decision file to write" },
|
|
282
324
|
{
|
|
@@ -296,7 +338,7 @@ export const decisionsCommand: CommandSpec = {
|
|
|
296
338
|
help: "verify | tests: add the progress block and the loop question as Q1",
|
|
297
339
|
},
|
|
298
340
|
{ name: "file", type: "string", help: "status.jsonl, with --loop" },
|
|
299
|
-
{ name: "group", type: "string", help: "with --loop=verify: the
|
|
341
|
+
{ name: "group", type: "string", help: "with --loop=verify: the task group" },
|
|
300
342
|
{ name: "attempt", type: "string", help: "with --loop: the attempt just failed" },
|
|
301
343
|
{ name: "max", type: "string", help: "with --loop: the point's maxAttempts" },
|
|
302
344
|
],
|
|
@@ -393,6 +435,7 @@ export const decisionsCommand: CommandSpec = {
|
|
|
393
435
|
apply: {
|
|
394
436
|
summary:
|
|
395
437
|
"Settle a decision file's items: --by=headless takes each recommendation; --by=owner confirms or rejects one assumed item.",
|
|
438
|
+
use: "workflow",
|
|
396
439
|
flags: [
|
|
397
440
|
{ name: "file", type: "string", required: true, help: "the decision file" },
|
|
398
441
|
{ name: "by", type: "string", required: true, help: "headless | owner" },
|
|
@@ -484,6 +527,7 @@ export const decisionsCommand: CommandSpec = {
|
|
|
484
527
|
pending: {
|
|
485
528
|
summary:
|
|
486
529
|
"List the feature's assumed Accepts nobody confirmed; --defer writes one needs-decision deferral per item.",
|
|
530
|
+
use: "workflow",
|
|
487
531
|
flags: [
|
|
488
532
|
{ name: "fid", type: "string", required: true, help: "feature id" },
|
|
489
533
|
{ name: "month", type: "string", required: true, help: "YYYYMM of the feature's logs" },
|