@cbartens/bkit 5.5.1 → 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 +167 -154
- package/.bkit/core/.agents/context.md +95 -29
- package/.bkit/core/.agents/docs.md +18 -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 +112 -102
- package/.bkit/core/.agents/skills.md +63 -15
- package/.bkit/core/.bkit/README.md +167 -154
- package/.bkit/core/.bkit/authoring.md +747 -0
- package/.bkit/core/.bkit/cli.md +407 -0
- package/.bkit/core/.bkit/cloud.md +283 -195
- package/.bkit/core/.bkit/comparison.md +45 -43
- package/.bkit/core/.bkit/install.md +166 -95
- package/.bkit/core/.bkit/jsonl.md +339 -196
- package/.bkit/core/.bkit/pipeline.md +142 -145
- package/.bkit/core/.bkit/prompts.md +295 -264
- package/.bkit/core/.bkit/providers.md +460 -277
- package/.bkit/core/.bkit/router.md +69 -0
- package/.bkit/core/.bkit/templates.md +530 -256
- package/.bkit/core/.bkit/trackers.md +116 -65
- package/.bkit/core/.bkit/workflows.md +742 -618
- 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 +6 -80
- package/.bkit/core/docs/templates/bkit-audit-accessibility.md +128 -130
- package/.bkit/core/docs/templates/bkit-audit-adoption.md +104 -94
- package/.bkit/core/docs/templates/bkit-audit-agents.md +96 -98
- package/.bkit/core/docs/templates/bkit-audit-aio-seo.md +100 -103
- package/.bkit/core/docs/templates/bkit-audit-analytics.md +141 -107
- package/.bkit/core/docs/templates/bkit-audit-annotations.md +99 -97
- package/.bkit/core/docs/templates/bkit-audit-app-performance.md +122 -121
- package/.bkit/core/docs/templates/bkit-audit-app-store.md +158 -101
- package/.bkit/core/docs/templates/bkit-audit-architecture.md +114 -96
- package/.bkit/core/docs/templates/bkit-audit-ci-performance.md +76 -97
- package/.bkit/core/docs/templates/bkit-audit-config.md +123 -101
- package/.bkit/core/docs/templates/bkit-audit-cost.md +86 -99
- package/.bkit/core/docs/templates/bkit-audit-coverage.md +76 -93
- package/.bkit/core/docs/templates/bkit-audit-database.md +102 -95
- package/.bkit/core/docs/templates/bkit-audit-dead-code.md +165 -108
- package/.bkit/core/docs/templates/bkit-audit-deferrals.md +115 -109
- package/.bkit/core/docs/templates/bkit-audit-dependencies.md +265 -113
- package/.bkit/core/docs/templates/bkit-audit-documentation.md +119 -118
- package/.bkit/core/docs/templates/bkit-audit-duplication.md +140 -111
- package/.bkit/core/docs/templates/bkit-audit-failures.md +111 -106
- package/.bkit/core/docs/templates/bkit-audit-flakes.md +100 -99
- package/.bkit/core/docs/templates/bkit-audit-gates.md +107 -103
- package/.bkit/core/docs/templates/bkit-audit-issues.md +105 -105
- package/.bkit/core/docs/templates/bkit-audit-llm.md +134 -85
- package/.bkit/core/docs/templates/bkit-audit-logs.md +124 -125
- package/.bkit/core/docs/templates/bkit-audit-models.md +99 -78
- package/.bkit/core/docs/templates/bkit-audit-privacy.md +56 -76
- package/.bkit/core/docs/templates/bkit-audit-prompts.md +63 -78
- package/.bkit/core/docs/templates/bkit-audit-red-team.md +125 -93
- package/.bkit/core/docs/templates/bkit-audit-reliability.md +97 -96
- package/.bkit/core/docs/templates/bkit-audit-repo.md +170 -98
- package/.bkit/core/docs/templates/bkit-audit-security.md +207 -121
- package/.bkit/core/docs/templates/bkit-audit-slop.md +78 -95
- package/.bkit/core/docs/templates/bkit-audit-testing.md +163 -139
- package/.bkit/core/docs/templates/bkit-audit-usability.md +114 -96
- package/.bkit/core/docs/templates/bkit-plan.md +158 -281
- package/.bkit/core/engine/checks/after/auth.ts +40 -37
- package/.bkit/core/engine/checks/after/ci-yml.ts +104 -31
- package/.bkit/core/engine/checks/after/github.ts +95 -17
- package/.bkit/core/engine/checks/after/index.ts +21 -8
- package/.bkit/core/engine/checks/after/suppression.ts +8 -5
- package/.bkit/core/engine/checks/after/tools.ts +125 -123
- package/.bkit/core/engine/checks/before/context-fetch.ts +227 -33
- package/.bkit/core/engine/checks/before/env.ts +3 -3
- package/.bkit/core/engine/checks/before/files.ts +5 -4
- package/.bkit/core/engine/checks/before/index.ts +25 -1
- package/.bkit/core/engine/checks/before/repo.ts +208 -2
- package/.bkit/core/engine/checks/status-holes.ts +916 -123
- package/.bkit/core/engine/checks/tips/catalogue.ts +82 -20
- package/.bkit/core/engine/checks/tips/detect.ts +66 -0
- package/.bkit/core/engine/checks/tips/index.ts +52 -11
- package/.bkit/core/engine/cli.ts +251 -130
- package/.bkit/core/engine/commands/analysis.ts +282 -199
- 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/comply.ts +77 -103
- package/.bkit/core/engine/commands/install/doctor.ts +2 -2
- package/.bkit/core/engine/commands/install/install.ts +57 -18
- package/.bkit/core/engine/commands/install/uninstall.ts +86 -55
- package/.bkit/core/engine/commands/install/upgrade.ts +32 -15
- package/.bkit/core/engine/commands/land.ts +139 -18
- package/.bkit/core/engine/commands/lib.ts +381 -22
- package/.bkit/core/engine/commands/registry.ts +10 -2
- package/.bkit/core/engine/commands/setup/setup.ts +8 -7
- package/.bkit/core/engine/commands/stats.ts +260 -0
- package/.bkit/core/engine/commands/tips.ts +10 -5
- package/.bkit/core/engine/commands/workflow/branches.ts +2215 -176
- package/.bkit/core/engine/commands/workflow/challenge.ts +748 -0
- package/.bkit/core/engine/commands/workflow/completeness.ts +109 -0
- package/.bkit/core/engine/commands/workflow/context.ts +1249 -47
- package/.bkit/core/engine/commands/workflow/counters.ts +483 -95
- package/.bkit/core/engine/commands/workflow/decisions.ts +585 -0
- package/.bkit/core/engine/commands/workflow/disk.ts +238 -56
- package/.bkit/core/engine/commands/workflow/fids.ts +811 -33
- package/.bkit/core/engine/commands/workflow/issues.ts +413 -64
- package/.bkit/core/engine/commands/workflow/ledgers.ts +1333 -36
- package/.bkit/core/engine/commands/workflow/locks.ts +28 -2
- package/.bkit/core/engine/commands/workflow/plan-blocks.ts +691 -0
- package/.bkit/core/engine/commands/workflow/plan-versions.ts +21 -0
- package/.bkit/core/engine/commands/workflow/plans.ts +257 -0
- package/.bkit/core/engine/commands/workflow/prs.ts +178 -33
- package/.bkit/core/engine/commands/workflow/repo.ts +66 -8
- package/.bkit/core/engine/commands/workflow/roadmap.ts +72 -22
- package/.bkit/core/engine/commands/workflow/run-facts.ts +492 -0
- package/.bkit/core/engine/commands/workflow/runs.ts +827 -79
- package/.bkit/core/engine/commands/workflow/runtime.ts +25 -1
- package/.bkit/core/engine/commands/workflow/skills.ts +1 -0
- package/.bkit/core/engine/commands/workflow/status.ts +329 -33
- package/.bkit/core/engine/commands/workflow/step-table.ts +381 -0
- package/.bkit/core/engine/commands/workflow/steps.ts +841 -105
- package/.bkit/core/engine/commands/workflow/summary-findings.ts +177 -0
- package/.bkit/core/engine/commands/workflow/summary.ts +544 -0
- 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 +2124 -330
- package/.bkit/core/engine/commands/workflow/tracker.ts +1195 -0
- package/.bkit/core/engine/commands/workflow/workflows.ts +1197 -235
- package/.bkit/core/engine/commands/workflow/worktrees.ts +543 -24
- 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 +67 -17
- package/.bkit/core/engine/install/modules/antigravity.ts +3 -2
- package/.bkit/core/engine/install/modules/cloud.ts +24 -16
- package/.bkit/core/engine/install/modules/codex.ts +15 -2
- package/.bkit/core/engine/install/modules/core.ts +1196 -45
- package/.bkit/core/engine/install/modules/cursor.ts +6 -6
- package/.bkit/core/engine/install/modules/opencode.ts +18 -6
- package/.bkit/core/engine/install/template-notes.ts +130 -0
- package/.bkit/core/engine/install/version-file.ts +9 -4
- 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/migrate.ts +92 -0
- package/.bkit/core/engine/ledgers/status.ts +249 -21
- package/.bkit/core/engine/ledgers/telemetry.ts +1397 -253
- package/.bkit/core/engine/render/hosts.ts +118 -14
- package/.bkit/core/engine/render/models.ts +12 -0
- package/.bkit/core/engine/shared/bkit-latest.ts +26 -4
- package/.bkit/core/engine/shared/branches.ts +4 -1
- package/.bkit/core/engine/shared/dep-updater.ts +60 -0
- package/.bkit/core/engine/shared/egress.ts +8 -1
- package/.bkit/core/engine/shared/json.ts +25 -7
- package/.bkit/core/engine/shared/package-manager.ts +9 -0
- package/.bkit/core/engine/shared/settings.ts +243 -31
- package/.bkit/core/engine/shared/text.ts +361 -0
- 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 +215 -0
- package/.bkit/core/engine/tools/instructions-sources.ts +832 -0
- package/.bkit/core/engine/tools/instructions.ts +1802 -0
- package/.bkit/core/hooks/antigravity-hook.js +25 -10
- package/.bkit/core/hooks/gateguard-engine.js +54 -29
- package/.bkit/core/hooks/guardrails-shell.js +4 -5
- package/.bkit/core/hooks/guardrails-tiers.js +10 -4
- 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 +202 -94
- package/.bkit/core/prompts/bkit-build-challenge-1.md +76 -34
- package/.bkit/core/prompts/bkit-build-challenge-2.md +85 -38
- package/.bkit/core/prompts/bkit-build-install-skills.md +50 -28
- package/.bkit/core/prompts/bkit-build-plan-convert.md +85 -0
- package/.bkit/core/prompts/bkit-build-plan-current.md +59 -36
- package/.bkit/core/prompts/bkit-build-plan-gaps-remediate.md +101 -36
- 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 +104 -43
- package/.bkit/core/prompts/bkit-debug-abort-handover.md +47 -32
- package/.bkit/core/prompts/bkit-debug-failure-diagnose.md +109 -57
- package/.bkit/core/prompts/bkit-debug-failure-remediate.md +65 -39
- package/.bkit/core/prompts/bkit-debug-failure-reproduce.md +53 -31
- package/.bkit/core/prompts/bkit-debug-failure-soak.md +65 -34
- package/.bkit/core/prompts/bkit-design-brainstorm-ideate-1.md +46 -31
- package/.bkit/core/prompts/bkit-design-brainstorm-ideate-2.md +45 -31
- package/.bkit/core/prompts/bkit-design-brainstorm-ideate-3.md +43 -30
- package/.bkit/core/prompts/bkit-design-generate.md +80 -46
- package/.bkit/core/prompts/bkit-design-organise.md +83 -32
- package/.bkit/core/prompts/bkit-design-review-1.md +70 -50
- package/.bkit/core/prompts/bkit-design-review-2.md +65 -46
- package/.bkit/core/prompts/bkit-design-spike.md +64 -40
- package/.bkit/core/prompts/bkit-design-update.md +53 -28
- package/.bkit/core/prompts/bkit-plan-generate.md +101 -29
- package/.bkit/core/prompts/bkit-plan-review-1.md +78 -41
- package/.bkit/core/prompts/bkit-plan-review-2.md +78 -35
- package/.bkit/core/prompts/bkit-plan-scope-check.md +116 -0
- package/.bkit/core/prompts/bkit-plan-update.md +86 -31
- package/.bkit/core/prompts/bkit-ship-conflict-resolve.md +94 -50
- package/.bkit/core/prompts/bkit-ship-deferred-sweep.md +91 -41
- package/.bkit/core/prompts/bkit-ship-update-docs.md +45 -24
- package/.bkit/core/prompts/bkit-utility-compress-markdown.md +65 -49
- package/.bkit/core/prompts/bkit-utility-update-decisions.md +87 -42
- package/.bkit/core/prompts/bkit-utility-update-deferrals.md +81 -37
- package/.bkit/core/prompts/bkit-utility-update-documentation.md +43 -25
- package/.bkit/core/prompts/bkit-utility-update-failures.md +84 -37
- package/.bkit/core/prompts/bkit-utility-update-knowledge.md +88 -42
- package/.bkit/core/prompts/bkit-utility-update-roadmap.md +92 -39
- package/.bkit/core/prompts/bkit-utility-update-tracker.md +159 -60
- package/.bkit/core/workflows/bkit-auto.md +89 -58
- package/.bkit/core/workflows/bkit-build.md +967 -517
- package/.bkit/core/workflows/bkit-debug.md +555 -387
- package/.bkit/core/workflows/bkit-design.md +319 -283
- package/.bkit/core/workflows/bkit-plan.md +319 -342
- package/.bkit/core/workflows/bkit-ship.md +525 -328
- package/.bkit/shared/.agents/plugins/bkit/hooks.json +10 -0
- package/.bkit/shared/.bkit/.env.example +2 -2
- package/.bkit/shared/.claude/bkit-cloud.md +12 -10
- package/.bkit/shared/.claude/settings.json +14 -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/.cursor/mcp.json +1 -1
- package/.bkit/shared/.cursor/rules/bkit-rules.mdc +1 -1
- package/.bkit/shared/.gitattributes +1 -1
- package/.bkit/shared/.mcp.json +1 -1
- package/.bkit/shared/.opencode/opencode.json +12 -1
- package/.bkit/shared/CLAUDE.md +6 -2
- package/.bkit/shared/GEMINI.md +5 -2
- package/.bkit/shared/docs/architecture.md +4 -7
- package/.bkit/shared/docs/data-schema.md +4 -7
- package/.bkit/shared/docs/deployments.md +241 -168
- 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 +289 -174
- 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 +45 -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 +54 -51
- package/.bkit/templates/.github/workflows/bkit-cloud.yml +34 -33
- 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 +96 -36
- package/.bkit/templates/.prettierignore +6 -0
- 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 +10 -2
- 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 +231 -0
- package/README.md +278 -89
- package/dist/checks/after/auth.js +36 -33
- package/dist/checks/after/ci-yml.js +91 -30
- package/dist/checks/after/github.js +91 -17
- package/dist/checks/after/index.js +22 -11
- package/dist/checks/after/suppression.js +8 -5
- package/dist/checks/after/tools.js +111 -114
- package/dist/checks/before/context-fetch.js +218 -33
- package/dist/checks/before/env.js +3 -3
- package/dist/checks/before/files.js +5 -3
- package/dist/checks/before/index.js +20 -3
- package/dist/checks/before/repo.js +197 -2
- package/dist/checks/status-holes.js +739 -114
- package/dist/checks/tips/catalogue.js +70 -19
- package/dist/checks/tips/detect.js +62 -0
- package/dist/checks/tips/index.js +51 -9
- package/dist/cli.js +234 -124
- package/dist/commands/analysis.js +174 -141
- 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/comply.js +54 -91
- package/dist/commands/install/doctor.js +2 -2
- package/dist/commands/install/install.js +50 -19
- package/dist/commands/install/uninstall.js +82 -55
- package/dist/commands/install/upgrade.js +21 -11
- package/dist/commands/land.js +137 -17
- package/dist/commands/lib.js +295 -21
- package/dist/commands/registry.js +10 -2
- package/dist/commands/setup/setup.js +8 -7
- package/dist/commands/stats.js +175 -0
- package/dist/commands/tips.js +7 -3
- package/dist/commands/workflow/branches.js +1873 -152
- package/dist/commands/workflow/challenge.js +609 -0
- package/dist/commands/workflow/completeness.js +97 -0
- package/dist/commands/workflow/context.js +1045 -46
- package/dist/commands/workflow/counters.js +385 -86
- package/dist/commands/workflow/decisions.js +484 -0
- package/dist/commands/workflow/disk.js +214 -56
- package/dist/commands/workflow/fids.js +706 -33
- package/dist/commands/workflow/issues.js +349 -59
- package/dist/commands/workflow/ledgers.js +1123 -37
- package/dist/commands/workflow/locks.js +26 -2
- package/dist/commands/workflow/plan-blocks.js +501 -0
- package/dist/commands/workflow/plan-versions.js +22 -0
- package/dist/commands/workflow/plans.js +205 -0
- package/dist/commands/workflow/prs.js +154 -35
- package/dist/commands/workflow/repo.js +58 -8
- package/dist/commands/workflow/roadmap.js +58 -23
- package/dist/commands/workflow/run-facts.js +421 -0
- package/dist/commands/workflow/runs.js +670 -72
- package/dist/commands/workflow/runtime.js +15 -1
- package/dist/commands/workflow/skills.js +1 -0
- package/dist/commands/workflow/status.js +282 -34
- package/dist/commands/workflow/step-table.js +308 -0
- package/dist/commands/workflow/steps.js +703 -96
- package/dist/commands/workflow/summary-findings.js +117 -0
- package/dist/commands/workflow/summary.js +388 -0
- 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 +1695 -305
- package/dist/commands/workflow/tracker.js +983 -0
- package/dist/commands/workflow/workflows.js +1014 -222
- package/dist/commands/workflow/worktrees.js +432 -26
- package/dist/install/cloud-env.js +233 -99
- package/dist/install/context-ci-workflow.js +85 -0
- package/dist/install/manifest.js +64 -17
- package/dist/install/modules/antigravity.js +3 -2
- package/dist/install/modules/cloud.js +25 -16
- package/dist/install/modules/codex.js +12 -2
- package/dist/install/modules/core.js +1090 -48
- package/dist/install/modules/cursor.js +6 -6
- package/dist/install/modules/opencode.js +13 -7
- package/dist/install/template-notes.js +116 -0
- package/dist/install/version-file.js +9 -4
- package/dist/ledgers/compact.js +87 -0
- package/dist/ledgers/journal.js +233 -0
- package/dist/ledgers/migrate.js +81 -0
- package/dist/ledgers/status.js +176 -13
- package/dist/ledgers/telemetry.js +1010 -125
- package/dist/render/hosts.js +104 -14
- package/dist/render/models.js +12 -0
- package/dist/shared/bkit-latest.js +26 -4
- package/dist/shared/branches.js +3 -1
- package/dist/shared/dep-updater.js +49 -0
- package/dist/shared/egress.js +8 -1
- package/dist/shared/json.js +20 -7
- package/dist/shared/package-manager.js +6 -0
- package/dist/shared/settings.js +181 -24
- package/dist/shared/text.js +333 -0
- package/dist/shared/timeouts.js +2 -0
- package/dist/tools/cli-doc.js +97 -0
- package/dist/tools/grammar-density.js +183 -0
- package/dist/tools/instructions-sources.js +720 -0
- package/dist/tools/instructions.js +1623 -0
- package/package.json +156 -51
- package/.bkit/core/.bkit/lite.md +0 -73
- package/.bkit/core/engine/commands/harvest.ts +0 -459
- package/.bkit/core/engine/commands/workflow/workstreams.ts +0 -166
- package/.bkit/core/engine/tools/wording.ts +0 -748
- package/.bkit/core/prompts/bkit-build-challenge-reconcile.md +0 -69
- package/.bkit/core/prompts/bkit-build-challenge-remediate.md +0 -71
- package/.bkit/core/prompts/bkit-build-challenge-tests.md +0 -74
- package/.bkit/core/prompts/bkit-build-plan-execute.md +0 -76
- package/.bkit/core/prompts/bkit-build-summary.md +0 -94
- package/.bkit/core/prompts/bkit-debug-summary.md +0 -96
- package/.bkit/core/prompts/bkit-design-summary.md +0 -107
- package/.bkit/core/prompts/bkit-plan-complexity-check.md +0 -67
- package/.bkit/core/prompts/bkit-plan-complexity-split.md +0 -88
- package/.bkit/core/prompts/bkit-plan-review-3.md +0 -93
- package/.bkit/core/prompts/bkit-plan-scope-check-1.md +0 -85
- package/.bkit/core/prompts/bkit-plan-scope-check-2.md +0 -85
- package/.bkit/core/prompts/bkit-plan-summary.md +0 -107
- package/.bkit/core/prompts/bkit-ship-summary.md +0 -78
- package/.bkit/templates/scripts/ci/bkit-local-stack-lock.sh +0 -194
- package/dist/commands/harvest.js +0 -353
- package/dist/commands/workflow/workstreams.js +0 -143
- package/dist/tools/wording.js +0 -680
- /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,13 +9,40 @@
|
|
|
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
|
|
13
|
-
import
|
|
12
|
+
import * as fs from "node:fs";
|
|
13
|
+
import * as path from "node:path";
|
|
14
|
+
|
|
15
|
+
import {
|
|
16
|
+
activeDoneSteps,
|
|
17
|
+
allRunsDoneSteps,
|
|
18
|
+
appendLine,
|
|
19
|
+
lastDoneStepAllRuns,
|
|
20
|
+
nextStrategy,
|
|
21
|
+
runNumber,
|
|
22
|
+
statusTimestamp,
|
|
23
|
+
type Step,
|
|
24
|
+
} from "../../ledgers/status.js";
|
|
25
|
+
import {
|
|
26
|
+
ASK_POINTS,
|
|
27
|
+
readBkitConfig,
|
|
28
|
+
type AskPoint,
|
|
29
|
+
type AskSetting,
|
|
30
|
+
} from "../../shared/settings.js";
|
|
31
|
+
import { headlessRun } from "./runtime.js";
|
|
32
|
+
import {
|
|
33
|
+
CommandError,
|
|
34
|
+
EXIT,
|
|
35
|
+
git,
|
|
36
|
+
runGit,
|
|
37
|
+
type CommandSpec,
|
|
38
|
+
type FlagValue,
|
|
39
|
+
type RunContext,
|
|
40
|
+
} from "../lib.js";
|
|
14
41
|
import {
|
|
15
42
|
EXIT_NO_STATUS,
|
|
16
43
|
FILE_FLAG,
|
|
44
|
+
GROUP_FLAG,
|
|
17
45
|
STEP_FLAG,
|
|
18
|
-
SUB_PLAN_FLAG,
|
|
19
46
|
WORKFLOW_FLAG,
|
|
20
47
|
positiveInt,
|
|
21
48
|
readRuns,
|
|
@@ -24,24 +51,28 @@ import {
|
|
|
24
51
|
str,
|
|
25
52
|
} from "./status.js";
|
|
26
53
|
|
|
27
|
-
/**
|
|
28
|
-
export
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
54
|
+
/** An ask point by name (`build.verify`); an unknown name is a usage error. */
|
|
55
|
+
export function askPoint(name: string): AskPoint {
|
|
56
|
+
if (!(ASK_POINTS as readonly string[]).includes(name))
|
|
57
|
+
throw new CommandError(EXIT.USAGE, `unknown point ${name}; known: ${ASK_POINTS.join(", ")}`);
|
|
58
|
+
return name as AskPoint;
|
|
59
|
+
}
|
|
60
|
+
|
|
61
|
+
/** The checkout `cwd` sits in. */
|
|
62
|
+
const checkoutRoot = (cwd: string): string => git(cwd, ["rev-parse", "--show-toplevel"]) ?? cwd;
|
|
63
|
+
|
|
64
|
+
/** `bkit.workflows.<point>` for the checkout `cwd` sits in. */
|
|
65
|
+
export function askSetting(cwd: string, point: AskPoint): AskSetting {
|
|
66
|
+
return readBkitConfig(checkoutRoot(cwd)).asks[point];
|
|
67
|
+
}
|
|
68
|
+
|
|
69
|
+
/** Paths a fix round's code change is judged on: everything but plan logs and ledgers. */
|
|
70
|
+
const SOURCE_PATHS = [
|
|
71
|
+
".",
|
|
72
|
+
":(exclude)docs/plans",
|
|
73
|
+
":(exclude)docs/*.jsonl",
|
|
74
|
+
":(exclude).bkit/*.jsonl",
|
|
75
|
+
];
|
|
45
76
|
|
|
46
77
|
/** Exit code: `--position=current` found no row — the step's own row is missing. */
|
|
47
78
|
export const EXIT_NO_OWN_ROW = 4;
|
|
@@ -59,7 +90,8 @@ const nonNegativeInt = (v: FlagValue, flag: string): number => {
|
|
|
59
90
|
|
|
60
91
|
/**
|
|
61
92
|
* `--of=<step>:<position>` over `--file` / `--workflow`: the counter at that position.
|
|
62
|
-
* `--of=<step>,<step>...:count` sums the DONE rows of every listed step.
|
|
93
|
+
* `--of=<step>,<step>...:count` sums the DONE rows of every listed step. `--all-runs`
|
|
94
|
+
* counts every run of the workflow in the file, not only the active one.
|
|
63
95
|
*/
|
|
64
96
|
function derivedOf(ctx: RunContext): number {
|
|
65
97
|
const [list, position] = String(ctx.flags.of).split(":");
|
|
@@ -71,12 +103,10 @@ function derivedOf(ctx: RunContext): number {
|
|
|
71
103
|
if (ctx.flags.file === undefined || ctx.flags.workflow === undefined)
|
|
72
104
|
throw new CommandError(EXIT.USAGE, "--of needs --file and --workflow");
|
|
73
105
|
const runs = readRuns(statusFile(ctx));
|
|
74
|
-
const
|
|
106
|
+
const group = positiveInt(ctx.flags.group, "group");
|
|
107
|
+
const doneSteps = ctx.flags.allRuns === true ? allRunsDoneSteps : activeDoneSteps;
|
|
75
108
|
const count = steps.reduce(
|
|
76
|
-
(n, step) =>
|
|
77
|
-
n +
|
|
78
|
-
activeDoneSteps(runs, String(ctx.flags.workflow), { step, subPlan }, str(ctx.flags.since))
|
|
79
|
-
.length,
|
|
109
|
+
(n, step) => n + doneSteps(runs, String(ctx.flags.workflow), { step, group }).length,
|
|
80
110
|
0,
|
|
81
111
|
);
|
|
82
112
|
if (position === "current" && count === 0)
|
|
@@ -87,39 +117,285 @@ function derivedOf(ctx: RunContext): number {
|
|
|
87
117
|
return position === "next" ? count + 1 : count;
|
|
88
118
|
}
|
|
89
119
|
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
|
|
93
|
-
|
|
94
|
-
|
|
95
|
-
|
|
96
|
-
|
|
120
|
+
/** `--all-runs`: count every run of the workflow in `--file`, not only the active one. */
|
|
121
|
+
const ALL_RUNS_FLAG = {
|
|
122
|
+
name: "all-runs",
|
|
123
|
+
type: "boolean",
|
|
124
|
+
help: "count every run of the workflow in --file, not only the active one",
|
|
125
|
+
} as const;
|
|
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
|
+
|
|
153
|
+
/** Rows of `type` in `workflow`'s active run (since its last workflow-started row). */
|
|
154
|
+
function typedRowCount(file: string, workflow: string, type: string): number {
|
|
155
|
+
const rows = readStatusRows(file);
|
|
156
|
+
let start = -1;
|
|
157
|
+
rows.forEach((r, i) => {
|
|
158
|
+
if (r.type === "workflow-started" && r.workflow === workflow) start = i;
|
|
159
|
+
});
|
|
160
|
+
return rows
|
|
161
|
+
.slice(start + 1)
|
|
162
|
+
.filter((r) => r.type === type && (r.workflow === undefined || r.workflow === workflow)).length;
|
|
163
|
+
}
|
|
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
|
+
|
|
211
|
+
/** `route --rows=<type>:count`: rows of that type in the active run. */
|
|
212
|
+
function derivedRows(ctx: RunContext): number {
|
|
213
|
+
const [type, position] = String(ctx.flags.rows).split(":");
|
|
214
|
+
if (!type || position !== "count")
|
|
215
|
+
throw new CommandError(EXIT.USAGE, "--rows must be <row type>:count");
|
|
216
|
+
if (ctx.flags.file === undefined || ctx.flags.workflow === undefined)
|
|
217
|
+
throw new CommandError(EXIT.USAGE, "--rows needs --file and --workflow");
|
|
218
|
+
return typedRowCount(statusFile(ctx), String(ctx.flags.workflow), type);
|
|
219
|
+
}
|
|
220
|
+
|
|
221
|
+
/** The checkout a status.jsonl under `docs/plans/` belongs to; `cwd` when it is elsewhere. */
|
|
222
|
+
function checkoutOf(file: string, cwd: string): string {
|
|
223
|
+
const abs = path.resolve(cwd, file);
|
|
224
|
+
const at = abs.lastIndexOf(`${path.sep}docs${path.sep}plans${path.sep}`);
|
|
225
|
+
return at < 0 ? cwd : abs.slice(0, at);
|
|
226
|
+
}
|
|
227
|
+
|
|
228
|
+
export type LoopTrend = "first-round" | "closing" | "stuck" | "worse";
|
|
229
|
+
|
|
230
|
+
/**
|
|
231
|
+
* The loop's direction from its check rounds: `worse` when the problem count rose,
|
|
232
|
+
* `closing` when it fell and the rounds changed code, `stuck` otherwise.
|
|
233
|
+
*/
|
|
234
|
+
export function loopTrend(rounds: Step[], codeChanged: boolean | null): LoopTrend {
|
|
235
|
+
if (rounds.length < 2) return "first-round";
|
|
236
|
+
const first = rounds[0]?.failures;
|
|
237
|
+
const last = rounds.at(-1)?.failures;
|
|
238
|
+
if (first === undefined || last === undefined) return "stuck";
|
|
239
|
+
if (last > first) return "worse";
|
|
240
|
+
if (last < first && codeChanged !== false) return "closing";
|
|
241
|
+
return "stuck";
|
|
242
|
+
}
|
|
243
|
+
|
|
244
|
+
export interface LoopProgress {
|
|
245
|
+
rounds: { attempt: number | null; failures: number | null; at: string }[];
|
|
246
|
+
counts: string;
|
|
247
|
+
codeChanged: boolean | null;
|
|
248
|
+
lastStrategy: string | null;
|
|
249
|
+
nextStrategy: string;
|
|
250
|
+
finalSpent: boolean;
|
|
251
|
+
minutesPerRound: number | null;
|
|
252
|
+
trend: LoopTrend;
|
|
253
|
+
recommend: "try-again" | "stop" | null;
|
|
254
|
+
}
|
|
255
|
+
|
|
256
|
+
/** A fix loop's progress in the active run: `check` counts problems, `fix` fixes them. */
|
|
257
|
+
export function loopProgress(
|
|
258
|
+
file: string,
|
|
259
|
+
cwd: string,
|
|
260
|
+
workflow: string,
|
|
261
|
+
check: string,
|
|
262
|
+
fix: string,
|
|
263
|
+
group: number | undefined,
|
|
264
|
+
): LoopProgress {
|
|
265
|
+
const runs = readRuns(file);
|
|
266
|
+
const rounds = activeDoneSteps(runs, workflow, { step: check, group });
|
|
267
|
+
const fixes = activeDoneSteps(runs, workflow, { step: fix, group });
|
|
268
|
+
const first = rounds[0];
|
|
269
|
+
const last = rounds.at(-1);
|
|
270
|
+
let codeChanged: boolean | null = null;
|
|
271
|
+
if (first && last && first !== last && first.parentSha && last.parentSha) {
|
|
272
|
+
const diff = runGit(checkoutOf(file, cwd), [
|
|
273
|
+
"diff",
|
|
274
|
+
"--quiet",
|
|
275
|
+
first.parentSha,
|
|
276
|
+
last.parentSha,
|
|
277
|
+
"--",
|
|
278
|
+
...SOURCE_PATHS,
|
|
279
|
+
]);
|
|
280
|
+
// --quiet: exit 0 = no change, 1 = changed; anything else (unknown sha) leaves null.
|
|
281
|
+
if (diff.ok) codeChanged = false;
|
|
282
|
+
else if (diff.stderr === "") codeChanged = true;
|
|
97
283
|
}
|
|
98
|
-
|
|
284
|
+
const ladder = lastDoneStepAllRuns(runs, workflow, { step: fix, group })?.strategy;
|
|
285
|
+
const trend = loopTrend(rounds, codeChanged);
|
|
286
|
+
const span =
|
|
287
|
+
first && last && rounds.length > 1
|
|
288
|
+
? (Date.parse(last.at) - Date.parse(first.at)) / 60000 / (rounds.length - 1)
|
|
289
|
+
: null;
|
|
290
|
+
return {
|
|
291
|
+
rounds: rounds.map((r) => ({
|
|
292
|
+
attempt: r.attempt ?? null,
|
|
293
|
+
failures: r.failures ?? null,
|
|
294
|
+
at: r.at,
|
|
295
|
+
})),
|
|
296
|
+
counts: rounds.map((r) => (r.failures === undefined ? "?" : String(r.failures))).join(" → "),
|
|
297
|
+
codeChanged,
|
|
298
|
+
lastStrategy: fixes.at(-1)?.strategy ?? null,
|
|
299
|
+
nextStrategy: nextStrategy(ladder),
|
|
300
|
+
finalSpent: fixes.some((r) => r.strategy === "FINAL") || ladder === "FINAL",
|
|
301
|
+
minutesPerRound: span === null || Number.isNaN(span) ? null : Math.round(span),
|
|
302
|
+
trend,
|
|
303
|
+
recommend: trend === "first-round" ? null : trend === "closing" ? "try-again" : "stop",
|
|
304
|
+
};
|
|
305
|
+
}
|
|
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");
|
|
99
378
|
}
|
|
100
379
|
|
|
101
380
|
export const countersCommand: CommandSpec = {
|
|
102
381
|
noun: "counters",
|
|
103
|
-
summary: "Attempt counters derived from status.jsonl, and the
|
|
382
|
+
summary: "Attempt counters derived from status.jsonl, and the ask points' limits.",
|
|
104
383
|
verbs: {
|
|
105
384
|
derive: {
|
|
106
385
|
summary: "Count a step's DONE rows in the active run, at one of three positions.",
|
|
386
|
+
use: "workflow",
|
|
107
387
|
flags: [
|
|
108
388
|
FILE_FLAG,
|
|
109
389
|
WORKFLOW_FLAG,
|
|
110
390
|
STEP_FLAG,
|
|
111
|
-
|
|
391
|
+
GROUP_FLAG,
|
|
112
392
|
{
|
|
113
393
|
name: "position",
|
|
114
394
|
type: "string",
|
|
115
395
|
required: true,
|
|
116
396
|
help: "next (step start: count+1) | current (after own row: count, 0 refused) | count (other step: 0 legal)",
|
|
117
397
|
},
|
|
118
|
-
|
|
119
|
-
name: "since",
|
|
120
|
-
type: "string",
|
|
121
|
-
help: "run field holding a timestamp; only rows after it count (soakEntryAt)",
|
|
122
|
-
},
|
|
398
|
+
ALL_RUNS_FLAG,
|
|
123
399
|
],
|
|
124
400
|
output: { value: "the counter at that position", count: "DONE rows counted" },
|
|
125
401
|
exitCodes: {
|
|
@@ -131,11 +407,10 @@ export const countersCommand: CommandSpec = {
|
|
|
131
407
|
if (!["next", "current", "count"].includes(position)) {
|
|
132
408
|
throw new CommandError(EXIT.USAGE, "--position must be next, current, or count");
|
|
133
409
|
}
|
|
134
|
-
const count = activeDoneSteps(
|
|
410
|
+
const count = (ctx.flags.allRuns === true ? allRunsDoneSteps : activeDoneSteps)(
|
|
135
411
|
readRuns(statusFile(ctx)),
|
|
136
412
|
String(ctx.flags.workflow),
|
|
137
|
-
{ step: String(ctx.flags.step),
|
|
138
|
-
str(ctx.flags.since),
|
|
413
|
+
{ step: String(ctx.flags.step), group: positiveInt(ctx.flags.group, "group") },
|
|
139
414
|
).length;
|
|
140
415
|
if (position === "current" && count === 0) {
|
|
141
416
|
ctx.log(
|
|
@@ -149,6 +424,7 @@ export const countersCommand: CommandSpec = {
|
|
|
149
424
|
},
|
|
150
425
|
run: {
|
|
151
426
|
summary: "Which run of the workflow this invocation is (1-based; a resume keeps its number).",
|
|
427
|
+
use: "workflow",
|
|
152
428
|
flags: [FILE_FLAG, WORKFLOW_FLAG],
|
|
153
429
|
output: { run: "run number" },
|
|
154
430
|
exitCodes: { [EXIT_NO_STATUS]: "status.jsonl missing, unreadable, or not valid NDJSON" },
|
|
@@ -158,29 +434,17 @@ export const countersCommand: CommandSpec = {
|
|
|
158
434
|
},
|
|
159
435
|
},
|
|
160
436
|
route: {
|
|
161
|
-
summary:
|
|
437
|
+
summary:
|
|
438
|
+
"Compare a counter to its max: exit 0 continue, exit 1 exceeded; with --point, also whether to ask.",
|
|
439
|
+
use: "workflow",
|
|
162
440
|
flags: [
|
|
163
|
-
|
|
441
|
+
...VALUE_FLAGS,
|
|
442
|
+
{ name: "max", type: "string", help: "max as a number (or use --point)" },
|
|
164
443
|
{
|
|
165
|
-
name: "
|
|
444
|
+
name: "point",
|
|
166
445
|
type: "string",
|
|
167
|
-
help:
|
|
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`,
|
|
168
447
|
},
|
|
169
|
-
{
|
|
170
|
-
name: "of",
|
|
171
|
-
type: "string",
|
|
172
|
-
help: "<step>:<next|current|count> — derive the value from --file (active run); <step>,<step>...:count sums the listed steps",
|
|
173
|
-
},
|
|
174
|
-
{ ...FILE_FLAG, required: false, help: "status.jsonl, with --of" },
|
|
175
|
-
{ ...WORKFLOW_FLAG, required: false, help: "workflow, with --of" },
|
|
176
|
-
{ ...SUB_PLAN_FLAG, help: "with --of: only rows for this sub-plan" },
|
|
177
|
-
{
|
|
178
|
-
name: "since",
|
|
179
|
-
type: "string",
|
|
180
|
-
help: "with --of: run field holding a timestamp; only rows after it count (soakEntryAt)",
|
|
181
|
-
},
|
|
182
|
-
{ name: "max", type: "string", help: "max as a number (or use --limit)" },
|
|
183
|
-
{ name: "limit", type: "string", help: "max as a threshold name, e.g. MAX_VERIFY_ATTEMPT" },
|
|
184
448
|
{ name: "continue", type: "string", help: "step to go to when value <= max" },
|
|
185
449
|
{ name: "exceeded", type: "string", help: "step to go to when value > max" },
|
|
186
450
|
],
|
|
@@ -189,52 +453,183 @@ export const countersCommand: CommandSpec = {
|
|
|
189
453
|
exceeded: "true when value > max",
|
|
190
454
|
next: "--continue or --exceeded step, whichever applies (null when not given)",
|
|
191
455
|
max: "the max compared against",
|
|
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",
|
|
192
463
|
},
|
|
193
464
|
exitCodes: {
|
|
194
|
-
[EXIT_NO_STATUS]: "--of: status.jsonl missing, unreadable, or not valid NDJSON",
|
|
465
|
+
[EXIT_NO_STATUS]: "--of / --rows: status.jsonl missing, unreadable, or not valid NDJSON",
|
|
195
466
|
[EXIT_NO_OWN_ROW]: "--of=<step>:current counted 0: the step's own row is missing",
|
|
196
467
|
},
|
|
197
468
|
run: (ctx) => {
|
|
198
469
|
const name = String(ctx.flags.name);
|
|
199
|
-
|
|
200
|
-
|
|
201
|
-
|
|
202
|
-
ctx.flags.of !== undefined ? derivedOf(ctx) : nonNegativeInt(ctx.flags.value, "value");
|
|
203
|
-
if ((ctx.flags.max === undefined) === (ctx.flags.limit === undefined)) {
|
|
204
|
-
throw new CommandError(EXIT.USAGE, "give exactly one of --max or --limit");
|
|
470
|
+
const value = counterValue(ctx);
|
|
471
|
+
if ((ctx.flags.max === undefined) === (ctx.flags.point === undefined)) {
|
|
472
|
+
throw new CommandError(EXIT.USAGE, "give exactly one of --max or --point");
|
|
205
473
|
}
|
|
206
|
-
const
|
|
207
|
-
|
|
208
|
-
? threshold(String(ctx.flags.limit))
|
|
209
|
-
: nonNegativeInt(ctx.flags.max, "max");
|
|
474
|
+
const limit = pointLimit(ctx);
|
|
475
|
+
const max = limit === undefined ? nonNegativeInt(ctx.flags.max, "max") : limit.max;
|
|
210
476
|
const exceeded = value > max;
|
|
211
477
|
if (exceeded) ctx.log(`counter ${name} exceeded max=${max} (value=${value})`);
|
|
212
478
|
ctx.emit({
|
|
213
479
|
value,
|
|
214
480
|
exceeded,
|
|
215
|
-
next:
|
|
481
|
+
next: (exceeded ? str(ctx.flags.exceeded) : str(ctx.flags.continue)) ?? null,
|
|
216
482
|
max,
|
|
483
|
+
ask: limit?.ask ?? false,
|
|
484
|
+
...(limit === undefined ? {} : limit.out),
|
|
217
485
|
});
|
|
218
486
|
return exceeded ? EXIT.NO : EXIT.OK;
|
|
219
487
|
},
|
|
220
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
|
+
},
|
|
221
547
|
max: {
|
|
222
|
-
summary: "The
|
|
548
|
+
summary: "The ask points' limits and ask settings: one by --point, or all.",
|
|
549
|
+
use: "workflow",
|
|
223
550
|
flags: [
|
|
224
|
-
{ name: "
|
|
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
|
+
],
|
|
560
|
+
output: {
|
|
561
|
+
value: "the point's limit (with --point)",
|
|
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",
|
|
569
|
+
points: "every point's {ask, max} as set (without --point)",
|
|
570
|
+
},
|
|
571
|
+
run: (ctx) => {
|
|
572
|
+
const name = str(ctx.flags.point);
|
|
573
|
+
if (name === undefined) {
|
|
574
|
+
ctx.emit({ points: readBkitConfig(checkoutRoot(ctx.cwd)).asks });
|
|
575
|
+
return EXIT.OK;
|
|
576
|
+
}
|
|
577
|
+
const limit = pointLimit(ctx)!;
|
|
578
|
+
ctx.emit({ value: limit.max, ask: limit.ask, ...limit.out });
|
|
579
|
+
return EXIT.OK;
|
|
580
|
+
},
|
|
581
|
+
},
|
|
582
|
+
progress: {
|
|
583
|
+
summary:
|
|
584
|
+
"Progress report for a fix loop in the active run: counts per round, code change, strategy, trend.",
|
|
585
|
+
use: "workflow",
|
|
586
|
+
flags: [
|
|
587
|
+
FILE_FLAG,
|
|
588
|
+
WORKFLOW_FLAG,
|
|
589
|
+
{
|
|
590
|
+
name: "check",
|
|
591
|
+
type: "string",
|
|
592
|
+
required: true,
|
|
593
|
+
help: "the step that counts problems, e.g. build-plan-verify",
|
|
594
|
+
},
|
|
595
|
+
{
|
|
596
|
+
name: "fix",
|
|
597
|
+
type: "string",
|
|
598
|
+
required: true,
|
|
599
|
+
help: "the step that fixes them, e.g. build-plan-gaps-remediate",
|
|
600
|
+
},
|
|
601
|
+
GROUP_FLAG,
|
|
225
602
|
],
|
|
226
603
|
output: {
|
|
227
|
-
|
|
228
|
-
|
|
604
|
+
rounds: "the check rounds counted: attempt, failures, at",
|
|
605
|
+
counts: "problem count after each round, e.g. 5 → 2",
|
|
606
|
+
codeChanged:
|
|
607
|
+
"source changed between the first and last check round (null when git cannot tell)",
|
|
608
|
+
lastStrategy: "strategy of the last fix round (null when none ran)",
|
|
609
|
+
nextStrategy: "strategy the next fix round would use",
|
|
610
|
+
finalSpent: "true when a fix round already ran FINAL",
|
|
611
|
+
minutesPerRound: "average minutes between check rounds (null under two rounds)",
|
|
612
|
+
trend: "first-round | closing | stuck | worse",
|
|
613
|
+
recommend: "try-again when closing, else stop (null on the first round)",
|
|
229
614
|
},
|
|
615
|
+
exitCodes: { [EXIT_NO_STATUS]: "status.jsonl missing, unreadable, or not valid NDJSON" },
|
|
230
616
|
run: (ctx) => {
|
|
231
|
-
|
|
232
|
-
|
|
617
|
+
ctx.emit({
|
|
618
|
+
...loopProgress(
|
|
619
|
+
statusFile(ctx),
|
|
620
|
+
ctx.cwd,
|
|
621
|
+
String(ctx.flags.workflow),
|
|
622
|
+
String(ctx.flags.check),
|
|
623
|
+
String(ctx.flags.fix),
|
|
624
|
+
positiveInt(ctx.flags.group, "group"),
|
|
625
|
+
),
|
|
626
|
+
});
|
|
233
627
|
return EXIT.OK;
|
|
234
628
|
},
|
|
235
629
|
},
|
|
236
630
|
rows: {
|
|
237
631
|
summary: "Count rows of one audit type in the active run (since its workflow-started row).",
|
|
632
|
+
use: "workflow",
|
|
238
633
|
flags: [
|
|
239
634
|
FILE_FLAG,
|
|
240
635
|
WORKFLOW_FLAG,
|
|
@@ -257,18 +652,11 @@ export const countersCommand: CommandSpec = {
|
|
|
257
652
|
const position = String(ctx.flags.position);
|
|
258
653
|
if (!["next", "count"].includes(position))
|
|
259
654
|
throw new CommandError(EXIT.USAGE, "--position must be next or count");
|
|
260
|
-
const
|
|
261
|
-
|
|
262
|
-
|
|
263
|
-
|
|
264
|
-
|
|
265
|
-
if (r.type === "workflow-started" && r.workflow === workflow) start = i;
|
|
266
|
-
});
|
|
267
|
-
const count = rows
|
|
268
|
-
.slice(start + 1)
|
|
269
|
-
.filter(
|
|
270
|
-
(r) => r.type === type && (r.workflow === undefined || r.workflow === workflow),
|
|
271
|
-
).length;
|
|
655
|
+
const count = typedRowCount(
|
|
656
|
+
statusFile(ctx),
|
|
657
|
+
String(ctx.flags.workflow),
|
|
658
|
+
String(ctx.flags.type),
|
|
659
|
+
);
|
|
272
660
|
ctx.emit({ value: position === "next" ? count + 1 : count, count });
|
|
273
661
|
return EXIT.OK;
|
|
274
662
|
},
|