@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
|
@@ -0,0 +1,381 @@
|
|
|
1
|
+
// The ordered steps of each workflow, and where a stopped run resumes.
|
|
2
|
+
//
|
|
3
|
+
// `bkit status resume` folds the active run and names the step to continue at.
|
|
4
|
+
// The rule: take the run's last DONE row for a step this table knows (rows for
|
|
5
|
+
// steps a workflow no longer has are ignored, except the retired steps mapped
|
|
6
|
+
// below, and Decision Pause rows that record their route), skip the setup steps
|
|
7
|
+
// (1-2 run again on every resume), and resume at the
|
|
8
|
+
// step after it — or at its `resumeOnVerdict` entry for the row's verdict, or its
|
|
9
|
+
// `resumeAt`, for a step whose next step depends on a verdict or that loops back. `workflow-shape.test.ts` holds this table to the
|
|
10
|
+
// workflows' `## Step N — Title` headings and `--step=` calls.
|
|
11
|
+
|
|
12
|
+
import type { WorkflowRun } from "../../ledgers/status.js";
|
|
13
|
+
import { CONFIG_DEFAULTS } from "../../shared/settings.js";
|
|
14
|
+
|
|
15
|
+
/** One row-writing step of a workflow, or a numbered step that writes no row (`step` absent). */
|
|
16
|
+
export interface WorkflowStep {
|
|
17
|
+
/** The `--step=` its status row carries. */
|
|
18
|
+
step?: string;
|
|
19
|
+
number: number;
|
|
20
|
+
/** The step heading's title, after `Step N — `. */
|
|
21
|
+
title: string;
|
|
22
|
+
/** Steps 1-2: run again on every resume, so their rows place no resume point. */
|
|
23
|
+
setup?: true;
|
|
24
|
+
/** The step a run whose last DONE row is this one resumes at, when not the next step. */
|
|
25
|
+
resumeAt?: string;
|
|
26
|
+
/** The step a run resumes at when this DONE row's `verdict` is a key here, before `resumeAt`. */
|
|
27
|
+
resumeOnVerdict?: Readonly<Record<string, string>>;
|
|
28
|
+
}
|
|
29
|
+
|
|
30
|
+
export type ResumableWorkflow = "plan" | "design" | "build" | "debug" | "ship";
|
|
31
|
+
|
|
32
|
+
export const WORKFLOW_STEPS: Readonly<Record<ResumableWorkflow, readonly WorkflowStep[]>> = {
|
|
33
|
+
plan: [
|
|
34
|
+
{ step: "plan-start-workflow", number: 1, title: "Start Workflow", setup: true },
|
|
35
|
+
{ step: "plan-worktree-setup", number: 2, title: "Worktree Setup", setup: true },
|
|
36
|
+
{ step: "plan-generate", number: 3, title: "Generate Plan" },
|
|
37
|
+
{ step: "plan-fetch-context", number: 4, title: "Fetch Context" },
|
|
38
|
+
{ step: "plan-review", number: 5, title: "Review Plan" },
|
|
39
|
+
{ step: "plan-apply-review", number: 6, title: "Apply Review" },
|
|
40
|
+
{ step: "plan-summary", number: 7, title: "Summary" },
|
|
41
|
+
{ step: "plan-close-workflow", number: 8, title: "Close Workflow" },
|
|
42
|
+
],
|
|
43
|
+
design: [
|
|
44
|
+
{ step: "design-start-workflow", number: 1, title: "Start Workflow", setup: true },
|
|
45
|
+
{ step: "design-worktree-setup", number: 2, title: "Worktree Setup", setup: true },
|
|
46
|
+
{ step: "design-grill", number: 3, title: "Grill" },
|
|
47
|
+
{ step: "design-brainstorm-ideate", number: 4, title: "Brainstorm & Ideate" },
|
|
48
|
+
{ step: "design-generate", number: 5, title: "Generate Design" },
|
|
49
|
+
{ step: "design-review", number: 6, title: "Design Review" },
|
|
50
|
+
{ step: "design-spike", number: 7, title: "Spike" },
|
|
51
|
+
{ step: "design-apply-review", number: 8, title: "Apply Review" },
|
|
52
|
+
{ step: "design-organise", number: 9, title: "Design Organise" },
|
|
53
|
+
{ step: "design-summary", number: 10, title: "Summary" },
|
|
54
|
+
{ step: "design-workstream-suggest", number: 11, title: "Suggest Plans" },
|
|
55
|
+
{ step: "design-close-workflow", number: 12, title: "Close Workflow" },
|
|
56
|
+
],
|
|
57
|
+
build: [
|
|
58
|
+
{ step: "build-start-workflow", number: 1, title: "Start Workflow", setup: true },
|
|
59
|
+
{ step: "build-worktree-setup", number: 2, title: "Worktree Setup", setup: true },
|
|
60
|
+
{ step: "build-branch-sync", number: 3, title: "Branch Sync" },
|
|
61
|
+
// A converted plan is checked again: Step 4 runs its plan check once more.
|
|
62
|
+
{
|
|
63
|
+
step: "build-plan-convert",
|
|
64
|
+
number: 4,
|
|
65
|
+
title: "Plan Convert",
|
|
66
|
+
resumeAt: "build-plan-convert",
|
|
67
|
+
},
|
|
68
|
+
{ step: "build-plan-current", number: 5, title: "Plan Current" },
|
|
69
|
+
{ step: "build-install-skills", number: 6, title: "Install Skills" },
|
|
70
|
+
// A group's start commit is recorded before its execute runs: Step 7 again.
|
|
71
|
+
{
|
|
72
|
+
step: "build-group-start",
|
|
73
|
+
number: 7,
|
|
74
|
+
title: "Plan Execute",
|
|
75
|
+
resumeAt: "build-plan-tasks",
|
|
76
|
+
},
|
|
77
|
+
// The group's tests are written before its code: Step 7 resumes at the tests step.
|
|
78
|
+
{ step: "build-plan-tests", number: 7, title: "Plan Execute", resumeAt: "build-plan-tests" },
|
|
79
|
+
// A handover stops a group part-done: Step 7 runs again with a fresh brief.
|
|
80
|
+
{
|
|
81
|
+
step: "build-plan-tasks",
|
|
82
|
+
number: 7,
|
|
83
|
+
title: "Plan Execute",
|
|
84
|
+
resumeOnVerdict: { HANDOVER: "build-plan-tasks" },
|
|
85
|
+
},
|
|
86
|
+
// Verify, its group gate and the gaps fix route on the verify verdict: Step 8 again.
|
|
87
|
+
{ step: "build-plan-verify", number: 8, title: "Plan Verify", resumeAt: "build-plan-verify" },
|
|
88
|
+
{ step: "build-group-gate", number: 8, title: "Plan Verify", resumeAt: "build-plan-verify" },
|
|
89
|
+
{
|
|
90
|
+
step: "build-plan-gaps-remediate",
|
|
91
|
+
number: 9,
|
|
92
|
+
title: "Plan Gaps Remediate",
|
|
93
|
+
resumeAt: "build-plan-verify",
|
|
94
|
+
},
|
|
95
|
+
{ step: "build-plan-verify-holistic", number: 10, title: "Plan Verify Holistic" },
|
|
96
|
+
// The reports are written: Step 11 continues at `bkit challenge merge`.
|
|
97
|
+
{ step: "build-challenge", number: 11, title: "Build Challenge", resumeAt: "build-challenge" },
|
|
98
|
+
// Run Tests routes on its own verdict, and a fix loops back to it.
|
|
99
|
+
{ step: "build-run-tests", number: 12, title: "Run Tests", resumeAt: "build-run-tests" },
|
|
100
|
+
{ step: "build-failure-diagnose", number: 13, title: "Failure Diagnose" },
|
|
101
|
+
{
|
|
102
|
+
step: "build-failure-remediate",
|
|
103
|
+
number: 14,
|
|
104
|
+
title: "Failure Remediate",
|
|
105
|
+
resumeAt: "build-run-tests",
|
|
106
|
+
},
|
|
107
|
+
{ step: "build-summary", number: 15, title: "Summary" },
|
|
108
|
+
{ step: "build-create-pr", number: 16, title: "Close Workflow & Create PR" },
|
|
109
|
+
{ step: "build-close-workflow", number: 16, title: "Close Workflow & Create PR" },
|
|
110
|
+
],
|
|
111
|
+
debug: [
|
|
112
|
+
{ step: "debug-start-workflow", number: 1, title: "Start Workflow", setup: true },
|
|
113
|
+
{ step: "debug-worktree-setup", number: 2, title: "Worktree Setup", setup: true },
|
|
114
|
+
// Run Tests routes on its own verdict, and every fix loops back to it.
|
|
115
|
+
{ step: "debug-run-tests", number: 3, title: "Run Tests", resumeAt: "debug-run-tests" },
|
|
116
|
+
{ step: "context-fetch", number: 4, title: "Fetch Context" },
|
|
117
|
+
{ step: "debug-failure-reproduce", number: 5, title: "Failure Reproduce" },
|
|
118
|
+
{ step: "debug-failure-diagnose", number: 6, title: "Failure Diagnose" },
|
|
119
|
+
{
|
|
120
|
+
step: "debug-failure-remediate",
|
|
121
|
+
number: 7,
|
|
122
|
+
title: "Failure Remediate",
|
|
123
|
+
resumeAt: "debug-run-tests",
|
|
124
|
+
},
|
|
125
|
+
{
|
|
126
|
+
step: "debug-failure-soak",
|
|
127
|
+
number: 8,
|
|
128
|
+
title: "Failure Remediate Soak",
|
|
129
|
+
resumeAt: "debug-run-tests",
|
|
130
|
+
},
|
|
131
|
+
{ step: "debug-push-remediation", number: 9, title: "Push Remediation" },
|
|
132
|
+
{ step: "debug-summary", number: 10, title: "Summary" },
|
|
133
|
+
{ step: "debug-create-pr", number: 11, title: "Close Workflow" },
|
|
134
|
+
{ step: "debug-close-workflow", number: 11, title: "Close Workflow" },
|
|
135
|
+
],
|
|
136
|
+
ship: [
|
|
137
|
+
{ step: "ship-start-workflow", number: 1, title: "Start Workflow", setup: true },
|
|
138
|
+
{
|
|
139
|
+
step: "ship-worktree-setup",
|
|
140
|
+
number: 2,
|
|
141
|
+
title: "Verify PR (Worktree Setup + Regression Guard)",
|
|
142
|
+
setup: true,
|
|
143
|
+
},
|
|
144
|
+
{
|
|
145
|
+
step: "ship-regression-guard",
|
|
146
|
+
number: 2,
|
|
147
|
+
title: "Verify PR (Worktree Setup + Regression Guard)",
|
|
148
|
+
setup: true,
|
|
149
|
+
},
|
|
150
|
+
{ number: 3, title: "Base Check" },
|
|
151
|
+
{ step: "ship-conflict-resolve", number: 4, title: "Integrate (Path B only)" },
|
|
152
|
+
{ step: "ship-deferred-sweep", number: 5, title: "Deferred Sweep" },
|
|
153
|
+
// Docs and summary are one step: the summary half still has to run.
|
|
154
|
+
{
|
|
155
|
+
step: "ship-update-docs",
|
|
156
|
+
number: 6,
|
|
157
|
+
title: "Update Docs & Summary",
|
|
158
|
+
resumeAt: "ship-summary",
|
|
159
|
+
},
|
|
160
|
+
{ step: "ship-summary", number: 6, title: "Update Docs & Summary" },
|
|
161
|
+
{ step: "ship-prune-skills", number: 7, title: "Prune Skills" },
|
|
162
|
+
{ step: "ship-bookkeeping-push", number: 8, title: "Commit + Push Bookkeeping" },
|
|
163
|
+
{ number: 9, title: "Re-validate" },
|
|
164
|
+
// The merge gate reads the PR state again: a merged PR goes on to Step 13.
|
|
165
|
+
{
|
|
166
|
+
step: "ship-merge-pr",
|
|
167
|
+
number: 10,
|
|
168
|
+
title: "Merge Gate + Merge PR",
|
|
169
|
+
resumeAt: "ship-merge-pr",
|
|
170
|
+
},
|
|
171
|
+
{ step: "ship-failure-diagnose", number: 11, title: "Failure Diagnose" },
|
|
172
|
+
// A PASS fix is committed and pushed at Step 12 sub-step 4 (a re-run commits nothing
|
|
173
|
+
// new), then re-validated at Step 9; any other verdict re-reads the PR at Step 10.
|
|
174
|
+
{
|
|
175
|
+
step: "ship-failure-remediate",
|
|
176
|
+
number: 12,
|
|
177
|
+
title: "Failure Remediate",
|
|
178
|
+
resumeAt: "ship-merge-pr",
|
|
179
|
+
resumeOnVerdict: { PASS: "ship-failure-remediate" },
|
|
180
|
+
},
|
|
181
|
+
{ step: "ship-switch-to-dev", number: 13, title: "Update Local Dev" },
|
|
182
|
+
{ step: "ship-close-workflow", number: 14, title: "Close Workflow" },
|
|
183
|
+
],
|
|
184
|
+
};
|
|
185
|
+
|
|
186
|
+
/**
|
|
187
|
+
* Rows of steps a workflow no longer has that still place a resume point: the
|
|
188
|
+
* old build challenge steps ran after the reports, so a run stopped in them
|
|
189
|
+
* resumes at Run Tests.
|
|
190
|
+
*/
|
|
191
|
+
export const RETIRED_STEPS: Readonly<Partial<Record<ResumableWorkflow, Record<string, string>>>> = {
|
|
192
|
+
build: {
|
|
193
|
+
"build-challenge-reconcile": "build-run-tests",
|
|
194
|
+
"build-challenge-remediate": "build-run-tests",
|
|
195
|
+
"build-challenge-tests": "build-run-tests",
|
|
196
|
+
},
|
|
197
|
+
};
|
|
198
|
+
|
|
199
|
+
/**
|
|
200
|
+
* Decision Pause rows (`build-decision`, no step number) that place a resume point: the
|
|
201
|
+
* row's `route` names the step the decision sent the run to, either directly or keyed on
|
|
202
|
+
* the step of the last non-decision row before it (the loop the pause came from). A row
|
|
203
|
+
* without a known `route`, or a keyed route with no matching prior row, places none.
|
|
204
|
+
*/
|
|
205
|
+
export const DECISION_ROUTES: Readonly<
|
|
206
|
+
Partial<
|
|
207
|
+
Record<
|
|
208
|
+
ResumableWorkflow,
|
|
209
|
+
{ step: string; routes: Record<string, string | Readonly<Record<string, string>>> }
|
|
210
|
+
>
|
|
211
|
+
>
|
|
212
|
+
> = {
|
|
213
|
+
build: {
|
|
214
|
+
step: "build-decision",
|
|
215
|
+
routes: {
|
|
216
|
+
fix: "build-plan-tasks",
|
|
217
|
+
verify: "build-plan-verify",
|
|
218
|
+
tests: "build-run-tests",
|
|
219
|
+
// Try again: a verify loop goes on to its gaps fix (Step 9), a tests loop to Step 13.
|
|
220
|
+
retry: {
|
|
221
|
+
"build-plan-verify": "build-plan-gaps-remediate",
|
|
222
|
+
"build-group-gate": "build-plan-gaps-remediate",
|
|
223
|
+
"build-run-tests": "build-failure-diagnose",
|
|
224
|
+
},
|
|
225
|
+
},
|
|
226
|
+
},
|
|
227
|
+
};
|
|
228
|
+
|
|
229
|
+
export const isResumable = (w: string): w is ResumableWorkflow => w in WORKFLOW_STEPS;
|
|
230
|
+
|
|
231
|
+
/** A completed numbered position, with build groups expanded in plan order. */
|
|
232
|
+
export function runProgress(input: {
|
|
233
|
+
workflow: ResumableWorkflow;
|
|
234
|
+
step?: string;
|
|
235
|
+
number?: number;
|
|
236
|
+
groups?: number[];
|
|
237
|
+
group?: number;
|
|
238
|
+
attempt?: number;
|
|
239
|
+
max?: number;
|
|
240
|
+
}): { percent: number; progressLine: string } {
|
|
241
|
+
const table = WORKFLOW_STEPS[input.workflow];
|
|
242
|
+
const entry = table.find((s) =>
|
|
243
|
+
input.number === undefined ? s.step === input.step : s.number === input.number,
|
|
244
|
+
);
|
|
245
|
+
if (entry === undefined) throw new Error("unknown workflow progress position");
|
|
246
|
+
const steps = new Set(table.map((s) => s.number)).size;
|
|
247
|
+
const groups = input.groups?.length ? input.groups : [1];
|
|
248
|
+
const ordinal = Math.max(1, groups.indexOf(input.group ?? groups[0]!) + 1);
|
|
249
|
+
const grouped = input.workflow === "build" && entry.number >= 7 && entry.number <= 9;
|
|
250
|
+
const total = input.workflow === "build" ? 13 + 3 * groups.length : steps;
|
|
251
|
+
const position =
|
|
252
|
+
input.workflow !== "build" || entry.number < 7
|
|
253
|
+
? entry.number
|
|
254
|
+
: grouped
|
|
255
|
+
? 6 + 3 * (ordinal - 1) + entry.number - 6
|
|
256
|
+
: 6 + 3 * groups.length + entry.number - 9;
|
|
257
|
+
const percent = entry.number === steps ? 100 : Math.min(99, Math.round((100 * position) / total));
|
|
258
|
+
const filled = Math.min(10, Math.max(0, Math.round(percent / 10)));
|
|
259
|
+
let progressLine = `Progress: ${"█".repeat(filled)}${"░".repeat(10 - filled)} ${percent}% · Step ${entry.number}/${steps} ${entry.title}`;
|
|
260
|
+
if (grouped) progressLine += ` · Group ${ordinal} of ${groups.length}`;
|
|
261
|
+
if (input.attempt !== undefined && input.attempt > 1)
|
|
262
|
+
progressLine += ` · Attempt ${input.attempt}${input.max === undefined ? "" : ` of ${input.max}`}`;
|
|
263
|
+
return { percent, progressLine };
|
|
264
|
+
}
|
|
265
|
+
|
|
266
|
+
export interface ResumePoint {
|
|
267
|
+
/** The step to continue at: its row name (null for a step that writes no row), number and title. */
|
|
268
|
+
step: string | null;
|
|
269
|
+
number: number;
|
|
270
|
+
title: string;
|
|
271
|
+
/** The DONE row that placed the point, or null when none did (resume at Step 1). */
|
|
272
|
+
after: string | null;
|
|
273
|
+
/** That row's task group, or null. */
|
|
274
|
+
group: number | null;
|
|
275
|
+
/** Whether the latest run is this workflow, still IN_PROGRESS. */
|
|
276
|
+
active: boolean;
|
|
277
|
+
/** Build only (null otherwise): the round Step 11's challenge runs as — see `challengeRound`. */
|
|
278
|
+
challengeRound: number | null;
|
|
279
|
+
/** Build only (null otherwise): the last allowed round has merged, so Step 11 goes on to Step 12. */
|
|
280
|
+
challengeDone: boolean | null;
|
|
281
|
+
}
|
|
282
|
+
|
|
283
|
+
const CHALLENGE_ROUTES = new Set(["build-plan-tasks", "build-decision", "build-run-tests"]);
|
|
284
|
+
const roundOf = (s: WorkflowRun["steps"][number]): number => {
|
|
285
|
+
const round = Number((s as { round?: unknown }).round);
|
|
286
|
+
return Number.isInteger(round) && round >= 1 ? round : 1;
|
|
287
|
+
};
|
|
288
|
+
|
|
289
|
+
/** The run's DONE `build-challenge` rows and the route rows after them, in order. */
|
|
290
|
+
const challengeRows = (steps: WorkflowRun["steps"]) =>
|
|
291
|
+
steps.filter(
|
|
292
|
+
(s) => s.status === "DONE" && (s.step === "build-challenge" || CHALLENGE_ROUTES.has(s.step)),
|
|
293
|
+
);
|
|
294
|
+
|
|
295
|
+
/** Whether a challenge row at round `max` or later has a route row after it: no round is left. */
|
|
296
|
+
function challengeDone(steps: WorkflowRun["steps"], max: number): boolean {
|
|
297
|
+
const rows = challengeRows(steps);
|
|
298
|
+
return rows.some(
|
|
299
|
+
(s, i) => s.step === "build-challenge" && roundOf(s) >= max && rows[i + 1] !== undefined,
|
|
300
|
+
);
|
|
301
|
+
}
|
|
302
|
+
|
|
303
|
+
/**
|
|
304
|
+
* The build challenge's round, read from the run's `build-challenge` rows (each carries the
|
|
305
|
+
* `round` it ran as; a row without one counts as round 1) and the step row after each: the
|
|
306
|
+
* next of `build-plan-tasks` (route fix), `build-decision` (route pause) or
|
|
307
|
+
* `build-run-tests` (route none). A challenge row with no such row after it has not merged
|
|
308
|
+
* yet, so the run keeps that row's round. Otherwise one past the highest round whose merge
|
|
309
|
+
* wrote tasks (route fix or pause), or that ran past round 1; at most `max`
|
|
310
|
+
* (`bkit.workflows.build.challenge.maxAttempts`).
|
|
311
|
+
*/
|
|
312
|
+
function challengeRound(steps: WorkflowRun["steps"], max: number): number {
|
|
313
|
+
const rows = challengeRows(steps);
|
|
314
|
+
const last = rows.at(-1);
|
|
315
|
+
if (last?.step === "build-challenge") return roundOf(last);
|
|
316
|
+
const done = rows
|
|
317
|
+
.filter(
|
|
318
|
+
(s, i) =>
|
|
319
|
+
s.step === "build-challenge" && (roundOf(s) > 1 || rows[i + 1]?.step !== "build-run-tests"),
|
|
320
|
+
)
|
|
321
|
+
.map(roundOf);
|
|
322
|
+
return done.length === 0 ? 1 : Math.min(Math.max(...done) + 1, max);
|
|
323
|
+
}
|
|
324
|
+
|
|
325
|
+
/** Where `workflow`'s active run resumes; Step 1 when no run is active or no known step is DONE. */
|
|
326
|
+
export function resumePoint(
|
|
327
|
+
runs: WorkflowRun[],
|
|
328
|
+
workflow: ResumableWorkflow,
|
|
329
|
+
challengeMax = CONFIG_DEFAULTS.asks["build.challenge"].max,
|
|
330
|
+
): ResumePoint {
|
|
331
|
+
const table = WORKFLOW_STEPS[workflow];
|
|
332
|
+
const retired = RETIRED_STEPS[workflow] ?? {};
|
|
333
|
+
const decision = DECISION_ROUTES[workflow];
|
|
334
|
+
const byStep = new Map(table.filter((s) => s.step !== undefined).map((s) => [s.step!, s]));
|
|
335
|
+
const latest = runs.at(-1);
|
|
336
|
+
const active = latest?.workflow === workflow && latest.status === "IN_PROGRESS";
|
|
337
|
+
const steps = active ? latest.steps : [];
|
|
338
|
+
const at = (entry: WorkflowStep, after: string | null, group: number | null) => ({
|
|
339
|
+
step: entry.step ?? null,
|
|
340
|
+
number: entry.number,
|
|
341
|
+
title: entry.title,
|
|
342
|
+
after,
|
|
343
|
+
group,
|
|
344
|
+
active,
|
|
345
|
+
challengeRound: workflow === "build" ? challengeRound(steps, challengeMax) : null,
|
|
346
|
+
challengeDone: workflow === "build" ? challengeDone(steps, challengeMax) : null,
|
|
347
|
+
});
|
|
348
|
+
const routeOf = (s: WorkflowRun["steps"][number]): string | undefined => {
|
|
349
|
+
if (decision === undefined || s.step !== decision.step) return undefined;
|
|
350
|
+
const route = decision.routes[String((s as { route?: unknown }).route)];
|
|
351
|
+
if (typeof route !== "object") return route;
|
|
352
|
+
const prior = steps
|
|
353
|
+
.slice(0, steps.lastIndexOf(s))
|
|
354
|
+
.filter((r) => r.status === "DONE" && r.step !== decision.step && byStep.has(r.step))
|
|
355
|
+
.at(-1);
|
|
356
|
+
return prior === undefined ? undefined : route[prior.step];
|
|
357
|
+
};
|
|
358
|
+
const done = steps.filter(
|
|
359
|
+
(s) =>
|
|
360
|
+
s.status === "DONE" && (byStep.has(s.step) || s.step in retired || routeOf(s) !== undefined),
|
|
361
|
+
);
|
|
362
|
+
const last = done.filter((s) => byStep.get(s.step)?.setup !== true).at(-1) ?? done.at(-1);
|
|
363
|
+
if (last === undefined) return at(table[0]!, null, null);
|
|
364
|
+
const routed = routeOf(last);
|
|
365
|
+
if (routed !== undefined) {
|
|
366
|
+
// A decision row carries no group: the group is the one the paused step worked on.
|
|
367
|
+
const before = done.slice(0, done.lastIndexOf(last)).reverse();
|
|
368
|
+
const prior = before.find((s) => (s.group ?? s.subPlan) !== undefined);
|
|
369
|
+
return at(byStep.get(routed)!, last.step, prior?.group ?? prior?.subPlan ?? null);
|
|
370
|
+
}
|
|
371
|
+
const group = last.group ?? last.subPlan ?? null;
|
|
372
|
+
const verdict = String(last.verdict);
|
|
373
|
+
const target =
|
|
374
|
+
retired[last.step] ??
|
|
375
|
+
byStep.get(last.step)!.resumeOnVerdict?.[verdict] ??
|
|
376
|
+
byStep.get(last.step)!.resumeAt;
|
|
377
|
+
if (target !== undefined) return at(byStep.get(target)!, last.step, group);
|
|
378
|
+
const own = byStep.get(last.step)!;
|
|
379
|
+
const next = table.find((s) => s.number > own.number);
|
|
380
|
+
return at(next ?? own, last.step, group);
|
|
381
|
+
}
|