@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
|
@@ -23,7 +23,7 @@
|
|
|
23
23
|
import * as fs from "node:fs";
|
|
24
24
|
import * as path from "node:path";
|
|
25
25
|
import { statusTimestamp } from "../../ledgers/status.js";
|
|
26
|
-
import { CommandError, EXIT, repoRoot, runTool } from "../lib.js";
|
|
26
|
+
import { CommandError, EXIT, git, repoRoot, runTool, } from "../lib.js";
|
|
27
27
|
import { EXIT_NO_STATUS, FILE_FLAG, WORKFLOW_FLAG, readStatusEvents, statusFile, str, } from "./status.js";
|
|
28
28
|
export const RUNTIMES = [
|
|
29
29
|
"LOCAL",
|
|
@@ -88,6 +88,17 @@ export function classify(env, root, log) {
|
|
|
88
88
|
const capable = (runtime) => runtime === "LOCAL" || runtime === "GITHUB_ACTION" || runtime === "CLOUD_CURSOR";
|
|
89
89
|
/** No human can reply into the session: a GitHub Actions run. */
|
|
90
90
|
const headless = (runtime) => runtime === "GITHUB_ACTION";
|
|
91
|
+
/**
|
|
92
|
+
* `classify` for a process working in `cwd`, which may be a build worktree: the Cursor
|
|
93
|
+
* marker sits in the main checkout (`repoRoot`), as `runtime detect` reads it. Outside a
|
|
94
|
+
* git repo the marker is looked for under `cwd`.
|
|
95
|
+
*/
|
|
96
|
+
export function classifyAt(cwd) {
|
|
97
|
+
const common = git(cwd, ["rev-parse", "--path-format=absolute", "--git-common-dir"]);
|
|
98
|
+
return classify(process.env, common ? path.dirname(common) : cwd, () => undefined);
|
|
99
|
+
}
|
|
100
|
+
/** Whether a process working in `cwd` runs headless, classified like `runtime detect`. */
|
|
101
|
+
export const headlessRun = (cwd) => headless(classifyAt(cwd));
|
|
91
102
|
/** The full table: classification, default capabilities, and the one live gh probe. */
|
|
92
103
|
export function detect(cwd, root, log) {
|
|
93
104
|
const runtime = classify(process.env, root, log);
|
|
@@ -159,6 +170,7 @@ export const runtimeCommand = {
|
|
|
159
170
|
verbs: {
|
|
160
171
|
detect: {
|
|
161
172
|
summary: "Classify the runtime, its default capabilities, gh auth, and the worktree path.",
|
|
173
|
+
use: "by-hand",
|
|
162
174
|
flags: [FID_FLAG],
|
|
163
175
|
output: {
|
|
164
176
|
...TABLE_OUTPUT,
|
|
@@ -176,6 +188,7 @@ export const runtimeCommand = {
|
|
|
176
188
|
},
|
|
177
189
|
row: {
|
|
178
190
|
summary: "Detect, then build the runtime-resolved row (and append it with --file).",
|
|
191
|
+
use: "workflow",
|
|
179
192
|
flags: [
|
|
180
193
|
WORKFLOW_FLAG,
|
|
181
194
|
{
|
|
@@ -214,6 +227,7 @@ export const runtimeCommand = {
|
|
|
214
227
|
},
|
|
215
228
|
assert: {
|
|
216
229
|
summary: "Read back the latest runtime-resolved row and fail unless every field is resolved.",
|
|
230
|
+
use: "workflow",
|
|
217
231
|
flags: [
|
|
218
232
|
FILE_FLAG,
|
|
219
233
|
{ ...WORKFLOW_FLAG, required: false, help: "only rows written by this workflow" },
|
|
@@ -1,8 +1,13 @@
|
|
|
1
|
-
// bkit status route|meta|path|row — read and annotate a workflow's `status.jsonl`.
|
|
1
|
+
// bkit status route|resume|meta|path|row — read and annotate a workflow's `status.jsonl`.
|
|
2
2
|
import * as fs from "node:fs";
|
|
3
3
|
import * as path from "node:path";
|
|
4
|
-
import {
|
|
5
|
-
import {
|
|
4
|
+
import { BKIT_DEBUG_GATES } from "../../install/manifest.js";
|
|
5
|
+
import { appendFrictionRow, journalEnabled, pauseFrictionRow } from "../../ledgers/journal.js";
|
|
6
|
+
import { resolveGitSha } from "../../ledgers/telemetry.js";
|
|
7
|
+
import { readBkitConfig } from "../../shared/settings.js";
|
|
8
|
+
import { activeDoneSteps, validateCiSelection, ciSelectionIdentity, allRunsDoneSteps, appendLine, fold, lastDoneStepAllRuns, lastRun, nextStrategy, runNumber, runOrStepField, statusTimestamp, } from "../../ledgers/status.js";
|
|
9
|
+
import { CommandError, EXIT, git, parseJson, resolveActiveRun, statusLocation, } from "../lib.js";
|
|
10
|
+
import { WORKFLOW_STEPS, isResumable, resumePoint } from "./step-table.js";
|
|
6
11
|
// ---------------------------------------------------------------------------
|
|
7
12
|
// Shared with counters / steps
|
|
8
13
|
// ---------------------------------------------------------------------------
|
|
@@ -24,13 +29,15 @@ export const STEP_FLAG = {
|
|
|
24
29
|
required: true,
|
|
25
30
|
help: "step name",
|
|
26
31
|
};
|
|
27
|
-
export const
|
|
28
|
-
name: "
|
|
32
|
+
export const GROUP_FLAG = {
|
|
33
|
+
name: "group",
|
|
29
34
|
type: "string",
|
|
30
|
-
help: "only rows for this
|
|
35
|
+
help: "only rows for this task group (positive integer)",
|
|
31
36
|
};
|
|
32
37
|
/** Exit code: status.jsonl missing, unreadable, or not valid NDJSON. */
|
|
33
38
|
export const EXIT_NO_STATUS = 3;
|
|
39
|
+
/** Exit code: the owner-pause friction row was not written; the status row is kept. */
|
|
40
|
+
export const EXIT_PAUSE_FRICTION = 4;
|
|
34
41
|
/** Every row of status.jsonl, whatever its type; exit 3 when the file is missing or a line is not JSON. */
|
|
35
42
|
export function readStatusRows(file) {
|
|
36
43
|
if (!fs.existsSync(file))
|
|
@@ -59,6 +66,14 @@ export function readStatusRowsAt(file, ref) {
|
|
|
59
66
|
throw new CommandError(EXIT_NO_STATUS, `${spec} does not exist`);
|
|
60
67
|
return parseStatusRows(text, spec);
|
|
61
68
|
}
|
|
69
|
+
/**
|
|
70
|
+
* Step names a row may carry from before a rename, read as the current name so a run
|
|
71
|
+
* in flight across the rename folds, resumes and counts as one (`docs/migrations.md`).
|
|
72
|
+
* The row on disk is history and is not rewritten.
|
|
73
|
+
*/
|
|
74
|
+
const RENAMED_STEPS = {
|
|
75
|
+
"build-plan-execute": "build-plan-tasks",
|
|
76
|
+
};
|
|
62
77
|
/** Parse NDJSON status text; `label` names it in errors. Malformed is an error, never "no rows". */
|
|
63
78
|
function parseStatusRows(text, label) {
|
|
64
79
|
return text
|
|
@@ -72,7 +87,9 @@ function parseStatusRows(text, label) {
|
|
|
72
87
|
if (typeof parsed.value !== "object" || parsed.value === null) {
|
|
73
88
|
throw new CommandError(EXIT_NO_STATUS, `${label} line ${i + 1} is not a JSON object`);
|
|
74
89
|
}
|
|
75
|
-
|
|
90
|
+
const row = parsed.value;
|
|
91
|
+
const renamed = typeof row.step === "string" ? RENAMED_STEPS[row.step] : undefined;
|
|
92
|
+
return renamed === undefined ? row : { ...row, step: renamed };
|
|
76
93
|
});
|
|
77
94
|
}
|
|
78
95
|
/** The rows as the fold reads them; the fold skips types it does not model. */
|
|
@@ -124,10 +141,17 @@ const VERDICTS = ["PASS", "CONCERNS", "FAIL"];
|
|
|
124
141
|
const DEBUG_MODES = ["NORMAL", "SOAK"];
|
|
125
142
|
const PUSH_MODES = ["PR", "LOCAL"];
|
|
126
143
|
const STRATEGIES = ["STANDARD", "PIVOT", "FINAL"];
|
|
127
|
-
const ROUTE_FIELDS = [
|
|
144
|
+
const ROUTE_FIELDS = [
|
|
145
|
+
"verdict",
|
|
146
|
+
"failures",
|
|
147
|
+
"strategy",
|
|
148
|
+
"debugMode",
|
|
149
|
+
"pushMode",
|
|
150
|
+
"publish",
|
|
151
|
+
];
|
|
128
152
|
/** Exit code: a `--require`d field is missing or holds a value outside its set. */
|
|
129
153
|
export const EXIT_ROUTE_MISSING = 4;
|
|
130
|
-
function route(runs, workflow, step,
|
|
154
|
+
function route(runs, workflow, step, group) {
|
|
131
155
|
const out = {
|
|
132
156
|
verdict: null,
|
|
133
157
|
failures: null,
|
|
@@ -135,11 +159,16 @@ function route(runs, workflow, step, subPlan) {
|
|
|
135
159
|
nextStrategy: null,
|
|
136
160
|
debugMode: null,
|
|
137
161
|
pushMode: null,
|
|
162
|
+
publish: null,
|
|
163
|
+
publishSource: null,
|
|
138
164
|
debugAttempt: 0,
|
|
165
|
+
parentSha: null,
|
|
139
166
|
};
|
|
140
167
|
const problems = {};
|
|
141
168
|
if (step !== undefined) {
|
|
142
|
-
const last = activeDoneSteps(runs, workflow, { step,
|
|
169
|
+
const last = activeDoneSteps(runs, workflow, { step, group }).at(-1);
|
|
170
|
+
if (typeof last?.parentSha === "string")
|
|
171
|
+
out.parentSha = last.parentSha;
|
|
143
172
|
if (!last) {
|
|
144
173
|
problems.verdict = `no DONE ${step} row in the active ${workflow} run`;
|
|
145
174
|
problems.failures = problems.verdict;
|
|
@@ -150,13 +179,16 @@ function route(runs, workflow, step, subPlan) {
|
|
|
150
179
|
}
|
|
151
180
|
else {
|
|
152
181
|
out.verdict = last.verdict;
|
|
153
|
-
|
|
154
|
-
|
|
182
|
+
// An absent count on FAIL is unknown, never 0: a FAIL always has failures.
|
|
183
|
+
const failures = last.failures ?? (last.verdict === "FAIL" ? null : 0);
|
|
184
|
+
if (failures === null)
|
|
185
|
+
out.failures = null;
|
|
186
|
+
else if (Number.isInteger(failures) && failures >= 0)
|
|
155
187
|
out.failures = failures;
|
|
156
188
|
else
|
|
157
189
|
problems.failures = `${step} failures "${String(failures)}" is not a non-negative integer`;
|
|
158
190
|
}
|
|
159
|
-
const prior = lastDoneStepAllRuns(runs, workflow, { step,
|
|
191
|
+
const prior = lastDoneStepAllRuns(runs, workflow, { step, group })?.strategy;
|
|
160
192
|
if (prior === undefined || STRATEGIES.includes(prior)) {
|
|
161
193
|
out.strategy = prior ?? null;
|
|
162
194
|
out.nextStrategy = nextStrategy(prior);
|
|
@@ -176,10 +208,87 @@ function route(runs, workflow, step, subPlan) {
|
|
|
176
208
|
problems[field] =
|
|
177
209
|
value === "" ? `${field} not recorded` : `${field} "${value}" is not ${allowed.join("|")}`;
|
|
178
210
|
}
|
|
211
|
+
problems.publish = "publish not resolved: needs --workflow=build with --prompt-file";
|
|
179
212
|
const attempt = Number(lastRun(runs, workflow)?.debugAttempt ?? 0);
|
|
180
213
|
out.debugAttempt = Number.isFinite(attempt) ? attempt : 0;
|
|
181
214
|
return { out, problems };
|
|
182
215
|
}
|
|
216
|
+
/**
|
|
217
|
+
* The debug run's start decisions, from the session prompt and the feature's debug runs.
|
|
218
|
+
* `fixMax` is `bkit.workflows.debug.fix.maxAttempts`: once that many fix rounds ran across
|
|
219
|
+
* every debug run, the run starts in SOAK.
|
|
220
|
+
*/
|
|
221
|
+
export function debugStart(runs, promptText, fixMax) {
|
|
222
|
+
const attempt = runNumber(runs, "debug");
|
|
223
|
+
const latest = runs.at(-1);
|
|
224
|
+
// A resume: the newest run is debug's and still open. A finished run's modes never
|
|
225
|
+
// carry into the next run; its fix rounds count against `fixMax`.
|
|
226
|
+
const open = latest?.workflow === "debug" && latest.status === "IN_PROGRESS" ? latest : null;
|
|
227
|
+
const soaking = open !== null &&
|
|
228
|
+
(runOrStepField([open], "debug", "debugMode") === "SOAK" ||
|
|
229
|
+
open.steps.some((s) => s.step === "debug-failure-soak" && s.status === "DONE"));
|
|
230
|
+
const fixes = allRunsDoneSteps(runs, "debug", { step: "debug-failure-remediate" }).length;
|
|
231
|
+
const debugMode = promptText.includes("[soak]") || soaking || fixes >= fixMax ? "SOAK" : "NORMAL";
|
|
232
|
+
const selection = !promptText.includes("[local]") && validateCiSelection(open?.ciSelection)
|
|
233
|
+
? open.ciSelection
|
|
234
|
+
: null;
|
|
235
|
+
const ci = selection?.mode === "ci" ? selection : null;
|
|
236
|
+
const ciGeneration = typeof open?.ciGeneration === "number" ? open.ciGeneration : 0;
|
|
237
|
+
const current = open?.steps.filter((s) => s.status === "DONE" && s.ciGeneration === ciGeneration) ?? [];
|
|
238
|
+
const defaults = promptText.includes("[live=off]")
|
|
239
|
+
? BKIT_DEBUG_GATES.filter((g) => !g.endsWith("-live"))
|
|
240
|
+
: [...BKIT_DEBUG_GATES];
|
|
241
|
+
const covering = ci && ci.redTiers.length > 0
|
|
242
|
+
? defaults
|
|
243
|
+
.filter((g) => ci.redTiers.every((tier) => g.slice("bkit:gate:".length).split("-").includes(tier)))
|
|
244
|
+
.reverse()
|
|
245
|
+
: [];
|
|
246
|
+
return {
|
|
247
|
+
debugAttempt: attempt,
|
|
248
|
+
debugMode,
|
|
249
|
+
repro: promptText.includes("[repro]"),
|
|
250
|
+
gates: [...new Set([...covering, ...defaults])],
|
|
251
|
+
ciRun: ci?.runId ?? null,
|
|
252
|
+
ciGeneration,
|
|
253
|
+
redTiers: ci?.redTiers ?? [],
|
|
254
|
+
ciFixDone: ci !== null &&
|
|
255
|
+
current.some((s) => ["debug-failure-remediate", "debug-failure-soak"].includes(s.step)),
|
|
256
|
+
ciReproduced: ci !== null &&
|
|
257
|
+
current.some((s) => s.step === "debug-failure-reproduce" && s.reproduced === "YES"),
|
|
258
|
+
};
|
|
259
|
+
}
|
|
260
|
+
const PUBLISH_TOKEN = /(?<![\w-])publish=(true|false)(?![\w-])/;
|
|
261
|
+
/**
|
|
262
|
+
* Build's ending, from the session prompt, `bkit.workflows.build.publish` and the runtime.
|
|
263
|
+
* A `publish=true|false` token wins; else LOCAL reads `publish.local` and any other runtime
|
|
264
|
+
* `publish.remote`. A non-LOCAL `false` resolves `true`. No `runtime-resolved` row throws.
|
|
265
|
+
*/
|
|
266
|
+
export function publishRoute(rows, promptText, config) {
|
|
267
|
+
const row = rows.filter((r) => r.type === "runtime-resolved" && r.workflow === "build").at(-1);
|
|
268
|
+
if (row === undefined)
|
|
269
|
+
throw new CommandError(EXIT_ROUTE_MISSING, "no runtime-resolved row for build: Step 2 never recorded the runtime");
|
|
270
|
+
const local = row.runtime === "LOCAL";
|
|
271
|
+
const token = PUBLISH_TOKEN.exec(promptText)?.[1];
|
|
272
|
+
const wanted = token !== undefined ? token === "true" : local ? config.local : config.remote;
|
|
273
|
+
if (!local && !wanted)
|
|
274
|
+
return { publish: true, publishSource: "coerced" };
|
|
275
|
+
return {
|
|
276
|
+
publish: wanted,
|
|
277
|
+
publishSource: token !== undefined ? "token" : local ? "local" : "remote",
|
|
278
|
+
};
|
|
279
|
+
}
|
|
280
|
+
/** `--file`, else the debug status.jsonl `--fid` and `--month` name. */
|
|
281
|
+
function routeFile(ctx) {
|
|
282
|
+
if (ctx.flags.file !== undefined)
|
|
283
|
+
return statusFile(ctx);
|
|
284
|
+
const fid = str(ctx.flags.fid);
|
|
285
|
+
const month = str(ctx.flags.month);
|
|
286
|
+
if (fid === undefined || month === undefined || ctx.flags.promptFile === undefined)
|
|
287
|
+
throw new CommandError(EXIT.USAGE, "give --file, or --prompt-file with --fid and --month");
|
|
288
|
+
if (!/^[0-9]{6}$/.test(month))
|
|
289
|
+
throw new CommandError(EXIT.USAGE, "--month must be YYYYMM");
|
|
290
|
+
return statusLocation({ cwd: ctx.cwd, workflow: "debug", fid, month }).path;
|
|
291
|
+
}
|
|
183
292
|
// ---------------------------------------------------------------------------
|
|
184
293
|
// meta
|
|
185
294
|
// ---------------------------------------------------------------------------
|
|
@@ -187,7 +296,6 @@ const META_FIELDS = {
|
|
|
187
296
|
"debug-mode": { key: "debugMode", check: (v) => oneOf(v, DEBUG_MODES, "--debug-mode") },
|
|
188
297
|
"push-mode": { key: "pushMode", check: (v) => oneOf(v, PUSH_MODES, "--push-mode") },
|
|
189
298
|
"debug-attempt": { key: "debugAttempt", check: (v) => positiveInt(v, "debug-attempt") },
|
|
190
|
-
"plan-source": { key: "planSource", check: (v) => oneOf(v, PLAN_SOURCES, "--plan-source") },
|
|
191
299
|
};
|
|
192
300
|
/** Row types the fold reads; each has its own verb (workflows start|fail|close, steps done, status meta). */
|
|
193
301
|
const FOLDED_TYPES = new Set([
|
|
@@ -197,13 +305,10 @@ const FOLDED_TYPES = new Set([
|
|
|
197
305
|
"workflow-done",
|
|
198
306
|
"workflow-failed",
|
|
199
307
|
]);
|
|
200
|
-
/** Markers that record
|
|
308
|
+
/** Markers that record a fact, not a value. */
|
|
201
309
|
const META_MARKS = {
|
|
202
|
-
"soak-entry": (at) => ({ soakEntryAt: at }),
|
|
203
310
|
"opened-pr": () => ({ openedPr: true }),
|
|
204
311
|
};
|
|
205
|
-
/** `brief` = the run had no plan file and works from its input file. */
|
|
206
|
-
const PLAN_SOURCES = ["brief", "plan"];
|
|
207
312
|
const camelFlag = (kebab) => kebab.replace(/-([a-z])/g, (_, c) => c.toUpperCase());
|
|
208
313
|
function oneOf(v, allowed, flag) {
|
|
209
314
|
if (!allowed.includes(v))
|
|
@@ -219,6 +324,7 @@ export const statusCommand = {
|
|
|
219
324
|
verbs: {
|
|
220
325
|
path: {
|
|
221
326
|
summary: "Where this workflow's status.jsonl lives.",
|
|
327
|
+
use: "by-hand",
|
|
222
328
|
flags: [
|
|
223
329
|
WORKFLOW_FLAG,
|
|
224
330
|
{ name: "fid", type: "string", required: true, help: "feature id" },
|
|
@@ -244,16 +350,17 @@ export const statusCommand = {
|
|
|
244
350
|
},
|
|
245
351
|
},
|
|
246
352
|
route: {
|
|
247
|
-
summary: "Routing state: last verdict / failures / strategy of a step, debug and push mode.",
|
|
353
|
+
summary: "Routing state: last verdict / failures / strategy of a step, debug and push mode; with --prompt-file, debug's start decisions.",
|
|
354
|
+
use: "workflow",
|
|
248
355
|
flags: [
|
|
249
|
-
FILE_FLAG,
|
|
356
|
+
{ ...FILE_FLAG, required: false, help: `${FILE_FLAG.help}; or --fid and --month` },
|
|
250
357
|
WORKFLOW_FLAG,
|
|
251
358
|
{
|
|
252
359
|
...STEP_FLAG,
|
|
253
360
|
required: false,
|
|
254
361
|
help: "step whose last DONE row gives verdict, failures, strategy",
|
|
255
362
|
},
|
|
256
|
-
|
|
363
|
+
GROUP_FLAG,
|
|
257
364
|
{
|
|
258
365
|
name: "require",
|
|
259
366
|
type: "string",
|
|
@@ -266,15 +373,32 @@ export const statusCommand = {
|
|
|
266
373
|
repeatable: true,
|
|
267
374
|
help: "field=value — fail (exit 4) unless the field holds this value, e.g. debugMode=NORMAL",
|
|
268
375
|
},
|
|
376
|
+
{
|
|
377
|
+
name: "prompt-file",
|
|
378
|
+
type: "string",
|
|
379
|
+
help: "debug or build: the session prompt; debug: this run's attempt, mode, repro and gates (a missing status.jsonl is a fresh run); build: publish and publishSource",
|
|
380
|
+
},
|
|
381
|
+
{ name: "fid", type: "string", help: "with --prompt-file, in place of --file: feature id" },
|
|
382
|
+
{ name: "month", type: "string", help: "with --prompt-file, in place of --file: YYYYMM" },
|
|
269
383
|
],
|
|
270
384
|
output: {
|
|
271
385
|
verdict: "PASS|CONCERNS|FAIL of the step's last DONE row in the active run, or null",
|
|
272
|
-
|
|
386
|
+
ciRun: "active saved CI run ID with --prompt-file, or null; explicit [local] clears it",
|
|
387
|
+
ciGeneration: "active saved selection generation with --prompt-file, or 0",
|
|
388
|
+
redTiers: "active selected failed tiers with --prompt-file; empty for local or unknown jobs",
|
|
389
|
+
ciFixDone: "whether the active generation has a DONE remediation or soak",
|
|
390
|
+
ciReproduced: "whether the active generation has DONE reproduction with YES",
|
|
391
|
+
failures: "its failures (absent on PASS|CONCERNS = 0, absent on FAIL = null: count unknown), or null",
|
|
273
392
|
strategy: "the step's last strategy across ALL runs, or null",
|
|
274
393
|
nextStrategy: "next rung: STANDARD, PIVOT, FINAL (null without --step)",
|
|
275
|
-
debugMode: "NORMAL|SOAK of the active run, or null",
|
|
394
|
+
debugMode: "NORMAL|SOAK of the active run, or null; with --prompt-file, the mode this invocation runs in (SOAK on [soak] in the prompt, an open run already in SOAK, or bkit.workflows.debug.fix.maxAttempts fix rounds already run across every debug run; else NORMAL)",
|
|
276
395
|
pushMode: "PR|LOCAL of the active run, or null",
|
|
277
|
-
debugAttempt: "debugAttempt of the active run (0 when unset)",
|
|
396
|
+
debugAttempt: "debugAttempt of the active run (0 when unset); with --prompt-file, this invocation's run number (a resume keeps its number)",
|
|
397
|
+
repro: "with --prompt-file: [repro] in the prompt",
|
|
398
|
+
gates: "with --prompt-file: the gates to try, deepest first; [live=off] in the prompt drops the live gate",
|
|
399
|
+
publish: "with --workflow=build and --prompt-file: whether the build publishes (a publish=true|false token, else publish.local on LOCAL or publish.remote elsewhere; a non-LOCAL false resolves true), else null",
|
|
400
|
+
publishSource: "with publish: token | local | remote | coerced (a non-LOCAL false forced to true), else null",
|
|
401
|
+
parentSha: "HEAD when the step's last DONE row in the active run was written — a build-group-start row's is the group's start commit, the base for `context diff` — or null",
|
|
278
402
|
},
|
|
279
403
|
exitCodes: {
|
|
280
404
|
[EXIT_NO_STATUS]: "status.jsonl missing, unreadable, or not valid NDJSON",
|
|
@@ -302,8 +426,32 @@ export const statusCommand = {
|
|
|
302
426
|
throw new CommandError(EXIT.USAGE, `--require ${r} needs --step`);
|
|
303
427
|
}
|
|
304
428
|
}
|
|
305
|
-
const
|
|
306
|
-
|
|
429
|
+
const promptFile = str(ctx.flags.promptFile);
|
|
430
|
+
if (promptFile !== undefined && !["debug", "build"].includes(String(ctx.flags.workflow)))
|
|
431
|
+
throw new CommandError(EXIT.USAGE, "--prompt-file is for --workflow=debug or build");
|
|
432
|
+
const file = routeFile(ctx);
|
|
433
|
+
let promptText = "";
|
|
434
|
+
if (promptFile !== undefined) {
|
|
435
|
+
const abs = path.resolve(ctx.cwd, promptFile);
|
|
436
|
+
if (!fs.existsSync(abs))
|
|
437
|
+
throw new CommandError(EXIT.USAGE, `--prompt-file ${abs} does not exist`);
|
|
438
|
+
promptText = fs.readFileSync(abs, "utf-8");
|
|
439
|
+
}
|
|
440
|
+
const runs = promptFile !== undefined && !fs.existsSync(file) ? [] : readRuns(file);
|
|
441
|
+
const { out, problems } = route(runs, String(ctx.flags.workflow), step, positiveInt(ctx.flags.group, "group"));
|
|
442
|
+
if (promptFile !== undefined) {
|
|
443
|
+
const root = git(ctx.cwd, ["rev-parse", "--show-toplevel"]) ?? ctx.cwd;
|
|
444
|
+
const config = readBkitConfig(root);
|
|
445
|
+
if (ctx.flags.workflow === "debug") {
|
|
446
|
+
Object.assign(out, debugStart(runs, promptText, config.asks["debug.fix"].max));
|
|
447
|
+
delete problems.debugMode;
|
|
448
|
+
}
|
|
449
|
+
else {
|
|
450
|
+
const rows = fs.existsSync(file) ? readStatusRows(file) : [];
|
|
451
|
+
Object.assign(out, publishRoute(rows, promptText, config.buildPublish));
|
|
452
|
+
delete problems.publish;
|
|
453
|
+
}
|
|
454
|
+
}
|
|
307
455
|
ctx.emit(out);
|
|
308
456
|
const failed = required.filter((r) => problems[r] !== undefined);
|
|
309
457
|
for (const r of failed)
|
|
@@ -315,21 +463,56 @@ export const statusCommand = {
|
|
|
315
463
|
return failed.length === 0 && differ.length === 0 ? EXIT.OK : EXIT_ROUTE_MISSING;
|
|
316
464
|
},
|
|
317
465
|
},
|
|
466
|
+
resume: {
|
|
467
|
+
summary: "The step a stopped run continues at: after its last DONE step, setup steps and retired rows aside.",
|
|
468
|
+
use: "by-hand",
|
|
469
|
+
flags: [
|
|
470
|
+
{ ...FILE_FLAG, help: "path to status.jsonl; a missing file is a run with no rows" },
|
|
471
|
+
{ ...WORKFLOW_FLAG, help: `workflow name: ${Object.keys(WORKFLOW_STEPS).join(", ")}` },
|
|
472
|
+
],
|
|
473
|
+
output: {
|
|
474
|
+
step: "the step's row name, or null for a step that writes no row",
|
|
475
|
+
number: "the step number to continue at (1 when no run is active)",
|
|
476
|
+
title: "the step heading's title",
|
|
477
|
+
after: "the DONE row that placed it, or null",
|
|
478
|
+
group: "that row's task group, or null",
|
|
479
|
+
active: "whether the latest run is this workflow, still IN_PROGRESS",
|
|
480
|
+
challengeRound: "build: the round Step 11's challenge runs as (1 up to bkit.workflows.build.challenge.maxAttempts), from the build-challenge rows' round field; null for other workflows",
|
|
481
|
+
challengeDone: "build: true once the last allowed challenge round has merged, so Step 11 goes on to Step 12; null for other workflows",
|
|
482
|
+
},
|
|
483
|
+
exitCodes: { [EXIT_NO_STATUS]: "status.jsonl unreadable or not valid NDJSON" },
|
|
484
|
+
run: (ctx) => {
|
|
485
|
+
const workflow = String(ctx.flags.workflow);
|
|
486
|
+
if (!isResumable(workflow))
|
|
487
|
+
throw new CommandError(EXIT.USAGE, `--workflow must be ${Object.keys(WORKFLOW_STEPS).join("|")}, got "${workflow}"`);
|
|
488
|
+
const file = statusFile(ctx);
|
|
489
|
+
const root = git(ctx.cwd, ["rev-parse", "--show-toplevel"]) ?? ctx.cwd;
|
|
490
|
+
const challengeMax = readBkitConfig(root).asks["build.challenge"].max;
|
|
491
|
+
ctx.emit({
|
|
492
|
+
...resumePoint(fs.existsSync(file) ? readRuns(file) : [], workflow, challengeMax),
|
|
493
|
+
});
|
|
494
|
+
return EXIT.OK;
|
|
495
|
+
},
|
|
496
|
+
},
|
|
318
497
|
meta: {
|
|
319
498
|
summary: "Append a workflow-meta row (run-level routing state).",
|
|
499
|
+
use: "workflow",
|
|
320
500
|
flags: [
|
|
321
501
|
FILE_FLAG,
|
|
322
502
|
WORKFLOW_FLAG,
|
|
323
503
|
{ name: "debug-mode", type: "string", help: "NORMAL|SOAK" },
|
|
324
504
|
{ name: "push-mode", type: "string", help: "PR|LOCAL" },
|
|
325
|
-
{ name: "debug-attempt", type: "string", help: "positive integer" },
|
|
326
|
-
{ name: "plan-source", type: "string", help: "brief|plan" },
|
|
327
505
|
{
|
|
328
|
-
name: "
|
|
329
|
-
type: "
|
|
330
|
-
help: "
|
|
506
|
+
name: "debug-attempt",
|
|
507
|
+
type: "string",
|
|
508
|
+
help: "positive integer, or run (the active run's number)",
|
|
331
509
|
},
|
|
332
510
|
{ name: "opened-pr", type: "boolean", help: "record openedPr: this run opened the PR" },
|
|
511
|
+
{
|
|
512
|
+
name: "ci-selection-file",
|
|
513
|
+
type: "string",
|
|
514
|
+
help: "validated atomic debug CI or local selection JSON",
|
|
515
|
+
},
|
|
333
516
|
],
|
|
334
517
|
output: { row: "the appended workflow-meta row" },
|
|
335
518
|
exitCodes: { [EXIT_NO_STATUS]: "status.jsonl does not exist (meta never starts a log)" },
|
|
@@ -337,10 +520,27 @@ export const statusCommand = {
|
|
|
337
520
|
const file = statusFile(ctx);
|
|
338
521
|
const at = statusTimestamp();
|
|
339
522
|
const fields = {};
|
|
523
|
+
if (ctx.flags.ciSelectionFile !== undefined) {
|
|
524
|
+
const parsed = parseJson(fs.readFileSync(path.resolve(ctx.cwd, String(ctx.flags.ciSelectionFile)), "utf-8"));
|
|
525
|
+
const selection = parsed.ok ? parsed.value : null;
|
|
526
|
+
if (!validateCiSelection(selection))
|
|
527
|
+
throw new CommandError(EXIT.USAGE, "invalid CI selection");
|
|
528
|
+
const active = readRuns(file).at(-1);
|
|
529
|
+
if (ctx.flags.workflow !== "debug" ||
|
|
530
|
+
active?.workflow !== "debug" ||
|
|
531
|
+
active.status !== "IN_PROGRESS")
|
|
532
|
+
throw new CommandError(EXIT.USAGE, "CI selection needs an active debug run");
|
|
533
|
+
const same = validateCiSelection(active.ciSelection) &&
|
|
534
|
+
ciSelectionIdentity(active.ciSelection) === ciSelectionIdentity(selection);
|
|
535
|
+
fields.ciSelection =
|
|
536
|
+
selection.mode === "local" ? { mode: "local", reason: selection.reason } : selection;
|
|
537
|
+
fields.ciGeneration = (Number(active.ciGeneration) || 0) + (same ? 0 : 1);
|
|
538
|
+
}
|
|
340
539
|
for (const { key, check } of Object.values(META_FIELDS)) {
|
|
341
540
|
const v = str(ctx.flags[key]);
|
|
541
|
+
// `--debug-attempt=run`: the active run's number, read once the log is known to exist.
|
|
342
542
|
if (v !== undefined)
|
|
343
|
-
fields[key] = check(v);
|
|
543
|
+
fields[key] = key === "debugAttempt" && v === "run" ? v : check(v);
|
|
344
544
|
}
|
|
345
545
|
for (const [flag, mark] of Object.entries(META_MARKS)) {
|
|
346
546
|
if (ctx.flags[camelFlag(flag)] === true)
|
|
@@ -353,6 +553,9 @@ export const statusCommand = {
|
|
|
353
553
|
}
|
|
354
554
|
if (!fs.existsSync(file))
|
|
355
555
|
throw new CommandError(EXIT_NO_STATUS, `${file} does not exist`);
|
|
556
|
+
if (fields.debugAttempt === "run") {
|
|
557
|
+
fields.debugAttempt = runNumber(readRuns(file), String(ctx.flags.workflow));
|
|
558
|
+
}
|
|
356
559
|
const row = {
|
|
357
560
|
type: "workflow-meta",
|
|
358
561
|
workflow: String(ctx.flags.workflow),
|
|
@@ -365,7 +568,8 @@ export const statusCommand = {
|
|
|
365
568
|
},
|
|
366
569
|
},
|
|
367
570
|
row: {
|
|
368
|
-
summary: "Append a typed audit row the fold does not model (ship's gate refusals, CI probes, merge CI).",
|
|
571
|
+
summary: "Append a typed audit row the fold does not model (ship's gate refusals, CI probes, merge CI); an owner-pause row also logs a human-confirm friction row.",
|
|
572
|
+
use: "workflow",
|
|
369
573
|
flags: [
|
|
370
574
|
FILE_FLAG,
|
|
371
575
|
WORKFLOW_FLAG,
|
|
@@ -383,7 +587,10 @@ export const statusCommand = {
|
|
|
383
587
|
},
|
|
384
588
|
],
|
|
385
589
|
output: { row: "the appended row" },
|
|
386
|
-
exitCodes: {
|
|
590
|
+
exitCodes: {
|
|
591
|
+
[EXIT_NO_STATUS]: "status.jsonl does not exist (a row never starts a log)",
|
|
592
|
+
[EXIT_PAUSE_FRICTION]: "an owner-pause row was appended but its human-confirm friction row was not written",
|
|
593
|
+
},
|
|
387
594
|
run: (ctx) => {
|
|
388
595
|
const type = String(ctx.flags.type);
|
|
389
596
|
if (!/^[a-z][a-z0-9]*(?:-[a-z0-9]+)*$/.test(type))
|
|
@@ -403,10 +610,51 @@ export const statusCommand = {
|
|
|
403
610
|
at: statusTimestamp(),
|
|
404
611
|
...fields,
|
|
405
612
|
};
|
|
613
|
+
const prior = type === "owner-pause" ? fs.readFileSync(file, "utf-8") : "";
|
|
406
614
|
fs.appendFileSync(file, appendLine(row));
|
|
615
|
+
if (type === "owner-pause")
|
|
616
|
+
recordPause(ctx.cwd, file, row, prior);
|
|
407
617
|
ctx.emit({ row });
|
|
408
618
|
return EXIT.OK;
|
|
409
619
|
},
|
|
410
620
|
},
|
|
411
621
|
},
|
|
412
622
|
};
|
|
623
|
+
const pauseReason = (row) => row["reason"] === undefined ? undefined : String(row["reason"]);
|
|
624
|
+
/**
|
|
625
|
+
* Log an owner pause as `human-confirm` friction in the active run's books. A
|
|
626
|
+
* follow-up wait writes nothing: `prior` (the status file before this row) holds an
|
|
627
|
+
* `owner-pause` row with the same workflow and reason and no `step-done` row after it.
|
|
628
|
+
* Nothing is written outside an active run or with `BKIT_ENGINE_JOURNAL=off`.
|
|
629
|
+
*/
|
|
630
|
+
function recordPause(cwd, file, row, prior) {
|
|
631
|
+
if (!journalEnabled())
|
|
632
|
+
return;
|
|
633
|
+
const reason = pauseReason(row);
|
|
634
|
+
let waiting = false;
|
|
635
|
+
for (const line of prior.split("\n")) {
|
|
636
|
+
const parsed = parseJson(line);
|
|
637
|
+
if (!parsed.ok || parsed.value === null || typeof parsed.value !== "object")
|
|
638
|
+
continue;
|
|
639
|
+
const r = parsed.value;
|
|
640
|
+
if (r["type"] === "step-done")
|
|
641
|
+
waiting = false;
|
|
642
|
+
else if (r["type"] === "owner-pause" && r["workflow"] === row.workflow) {
|
|
643
|
+
waiting ||= pauseReason(r) === reason;
|
|
644
|
+
}
|
|
645
|
+
}
|
|
646
|
+
if (waiting)
|
|
647
|
+
return;
|
|
648
|
+
const run = resolveActiveRun({ cwd, file });
|
|
649
|
+
if (run === undefined)
|
|
650
|
+
return;
|
|
651
|
+
const wrote = appendFrictionRow(run.bookRoot, pauseFrictionRow({
|
|
652
|
+
workflow: row.workflow,
|
|
653
|
+
reason,
|
|
654
|
+
bookRoot: run.bookRoot,
|
|
655
|
+
parentSha: resolveGitSha("HEAD", run.bookRoot),
|
|
656
|
+
}));
|
|
657
|
+
if (!wrote.ok) {
|
|
658
|
+
throw new CommandError(EXIT_PAUSE_FRICTION, `owner-pause row kept; its friction row was not written: ${wrote.error}`);
|
|
659
|
+
}
|
|
660
|
+
}
|