@cbartens/bkit 6.0.0 → 6.1.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.bkit/README.md +154 -151
- package/.bkit/core/.agents/context.md +95 -29
- package/.bkit/core/.agents/docs.md +17 -15
- package/.bkit/core/.agents/plugins/bkit/hooks/bkit-gateguard.cjs +1 -0
- package/.bkit/core/.agents/plugins/bkit/hooks/bkit-guardrails.cjs +6 -5
- package/.bkit/core/.agents/plugins/bkit/hooks/bkit-readguard.cjs +1 -0
- package/.bkit/core/.agents/plugins/bkit/hooks/bkit-rules.cjs +65 -0
- package/.bkit/core/.agents/rules.md +108 -107
- package/.bkit/core/.agents/skills.md +63 -15
- package/.bkit/core/.bkit/README.md +154 -151
- package/.bkit/core/.bkit/authoring.md +714 -84
- package/.bkit/core/.bkit/cli.md +407 -0
- package/.bkit/core/.bkit/cloud.md +281 -193
- package/.bkit/core/.bkit/comparison.md +43 -41
- package/.bkit/core/.bkit/install.md +154 -84
- package/.bkit/core/.bkit/jsonl.md +193 -130
- package/.bkit/core/.bkit/pipeline.md +114 -114
- package/.bkit/core/.bkit/prompts.md +272 -165
- package/.bkit/core/.bkit/providers.md +457 -271
- package/.bkit/core/.bkit/router.md +69 -0
- package/.bkit/core/.bkit/templates.md +529 -256
- package/.bkit/core/.bkit/trackers.md +80 -52
- package/.bkit/core/.bkit/workflows.md +589 -504
- package/.bkit/core/.claude/hooks/bkit-gateguard.cjs +2 -2
- package/.bkit/core/.claude/hooks/bkit-guardrails.cjs +3 -3
- package/.bkit/core/.claude/hooks/bkit-preflight.sh +45 -14
- package/.bkit/core/.codex/hooks/bkit-guardrails.cjs +3 -3
- package/.bkit/core/.codex/hooks/bkit-rules.cjs +57 -0
- package/.bkit/core/.cursor/hooks/bkit-guardrails.cjs +7 -7
- package/.bkit/core/.cursor/hooks/bkit-preflight.sh +47 -12
- package/.bkit/core/.opencode/plugin/bkit-rules.js +89 -0
- package/.bkit/core/AGENTS.md +5 -73
- package/.bkit/core/docs/templates/bkit-audit-accessibility.md +127 -105
- package/.bkit/core/docs/templates/bkit-audit-adoption.md +104 -70
- package/.bkit/core/docs/templates/bkit-audit-agents.md +94 -72
- package/.bkit/core/docs/templates/bkit-audit-aio-seo.md +99 -78
- package/.bkit/core/docs/templates/bkit-audit-analytics.md +140 -82
- package/.bkit/core/docs/templates/bkit-audit-annotations.md +98 -72
- package/.bkit/core/docs/templates/bkit-audit-app-performance.md +121 -96
- package/.bkit/core/docs/templates/bkit-audit-app-store.md +157 -76
- package/.bkit/core/docs/templates/bkit-audit-architecture.md +113 -71
- package/.bkit/core/docs/templates/bkit-audit-ci-performance.md +75 -72
- package/.bkit/core/docs/templates/bkit-audit-config.md +122 -76
- package/.bkit/core/docs/templates/bkit-audit-cost.md +85 -74
- package/.bkit/core/docs/templates/bkit-audit-coverage.md +75 -68
- package/.bkit/core/docs/templates/bkit-audit-database.md +101 -70
- package/.bkit/core/docs/templates/bkit-audit-dead-code.md +164 -83
- package/.bkit/core/docs/templates/bkit-audit-deferrals.md +115 -86
- package/.bkit/core/docs/templates/bkit-audit-dependencies.md +264 -88
- package/.bkit/core/docs/templates/bkit-audit-documentation.md +118 -93
- package/.bkit/core/docs/templates/bkit-audit-duplication.md +139 -86
- package/.bkit/core/docs/templates/bkit-audit-failures.md +110 -81
- package/.bkit/core/docs/templates/bkit-audit-flakes.md +99 -74
- package/.bkit/core/docs/templates/bkit-audit-gates.md +105 -77
- package/.bkit/core/docs/templates/bkit-audit-issues.md +104 -80
- package/.bkit/core/docs/templates/bkit-audit-llm.md +131 -58
- package/.bkit/core/docs/templates/bkit-audit-logs.md +123 -100
- package/.bkit/core/docs/templates/bkit-audit-models.md +98 -53
- package/.bkit/core/docs/templates/bkit-audit-privacy.md +56 -52
- package/.bkit/core/docs/templates/bkit-audit-prompts.md +63 -54
- package/.bkit/core/docs/templates/bkit-audit-red-team.md +124 -68
- package/.bkit/core/docs/templates/bkit-audit-reliability.md +95 -70
- package/.bkit/core/docs/templates/bkit-audit-repo.md +169 -73
- package/.bkit/core/docs/templates/bkit-audit-security.md +206 -96
- package/.bkit/core/docs/templates/bkit-audit-slop.md +77 -70
- package/.bkit/core/docs/templates/bkit-audit-testing.md +162 -114
- package/.bkit/core/docs/templates/bkit-audit-usability.md +113 -71
- package/.bkit/core/docs/templates/bkit-plan.md +138 -132
- package/.bkit/core/engine/checks/after/auth.ts +40 -37
- package/.bkit/core/engine/checks/after/ci-yml.ts +65 -2
- package/.bkit/core/engine/checks/after/index.ts +12 -2
- package/.bkit/core/engine/checks/after/tools.ts +80 -33
- package/.bkit/core/engine/checks/before/context-fetch.ts +227 -33
- package/.bkit/core/engine/checks/before/env.ts +1 -1
- package/.bkit/core/engine/checks/before/index.ts +7 -0
- package/.bkit/core/engine/checks/before/repo.ts +40 -0
- package/.bkit/core/engine/checks/status-holes.ts +916 -123
- package/.bkit/core/engine/checks/tips/catalogue.ts +68 -17
- package/.bkit/core/engine/checks/tips/detect.ts +32 -0
- package/.bkit/core/engine/checks/tips/index.ts +47 -6
- package/.bkit/core/engine/cli.ts +238 -84
- package/.bkit/core/engine/commands/analysis.ts +128 -76
- package/.bkit/core/engine/commands/ci/ci.ts +363 -29
- package/.bkit/core/engine/commands/ci/pins.ts +172 -0
- package/.bkit/core/engine/commands/ci/push-gate.ts +223 -0
- package/.bkit/core/engine/commands/install/uninstall.ts +21 -27
- package/.bkit/core/engine/commands/install/upgrade.ts +32 -15
- package/.bkit/core/engine/commands/land.ts +126 -11
- package/.bkit/core/engine/commands/lib.ts +303 -6
- package/.bkit/core/engine/commands/registry.ts +6 -2
- package/.bkit/core/engine/commands/setup/setup.ts +1 -0
- package/.bkit/core/engine/commands/stats.ts +91 -35
- package/.bkit/core/engine/commands/workflow/branches.ts +1477 -117
- package/.bkit/core/engine/commands/workflow/challenge.ts +114 -39
- package/.bkit/core/engine/commands/workflow/completeness.ts +109 -0
- package/.bkit/core/engine/commands/workflow/context.ts +433 -55
- package/.bkit/core/engine/commands/workflow/counters.ts +244 -39
- package/.bkit/core/engine/commands/workflow/decisions.ts +61 -17
- package/.bkit/core/engine/commands/workflow/disk.ts +237 -55
- package/.bkit/core/engine/commands/workflow/fids.ts +19 -1
- package/.bkit/core/engine/commands/workflow/issues.ts +6 -0
- package/.bkit/core/engine/commands/workflow/ledgers.ts +458 -18
- package/.bkit/core/engine/commands/workflow/locks.ts +2 -0
- package/.bkit/core/engine/commands/workflow/plan-blocks.ts +124 -15
- package/.bkit/core/engine/commands/workflow/plans.ts +257 -0
- package/.bkit/core/engine/commands/workflow/prs.ts +12 -3
- package/.bkit/core/engine/commands/workflow/repo.ts +8 -0
- package/.bkit/core/engine/commands/workflow/roadmap.ts +56 -15
- package/.bkit/core/engine/commands/workflow/run-facts.ts +22 -31
- package/.bkit/core/engine/commands/workflow/runs.ts +652 -34
- package/.bkit/core/engine/commands/workflow/runtime.ts +3 -0
- package/.bkit/core/engine/commands/workflow/skills.ts +1 -0
- package/.bkit/core/engine/commands/workflow/status.ts +200 -17
- package/.bkit/core/engine/commands/workflow/step-table.ts +75 -33
- package/.bkit/core/engine/commands/workflow/steps.ts +635 -24
- package/.bkit/core/engine/commands/workflow/summary-findings.ts +177 -0
- package/.bkit/core/engine/commands/workflow/summary.ts +192 -46
- package/.bkit/core/engine/commands/workflow/tasks.ts +409 -0
- package/.bkit/core/engine/commands/workflow/test-blocks.ts +254 -0
- package/.bkit/core/engine/commands/workflow/tests-changed.ts +201 -0
- package/.bkit/core/engine/commands/workflow/tests.ts +1285 -356
- package/.bkit/core/engine/commands/workflow/workflows.ts +228 -43
- package/.bkit/core/engine/commands/workflow/worktrees.ts +389 -47
- package/.bkit/core/engine/install/cloud-env.ts +251 -121
- package/.bkit/core/engine/install/context-ci-workflow.ts +102 -0
- package/.bkit/core/engine/install/manifest.ts +60 -12
- package/.bkit/core/engine/install/modules/antigravity.ts +3 -2
- package/.bkit/core/engine/install/modules/cloud.ts +3 -3
- package/.bkit/core/engine/install/modules/codex.ts +15 -2
- package/.bkit/core/engine/install/modules/core.ts +956 -52
- package/.bkit/core/engine/install/modules/cursor.ts +6 -6
- package/.bkit/core/engine/install/modules/opencode.ts +16 -4
- package/.bkit/core/engine/install/template-notes.ts +130 -0
- package/.bkit/core/engine/install/version-file.ts +3 -2
- package/.bkit/core/engine/install/write.ts +5 -0
- package/.bkit/core/engine/ledgers/compact.ts +124 -0
- package/.bkit/core/engine/ledgers/journal.ts +291 -0
- package/.bkit/core/engine/ledgers/status.ts +160 -9
- package/.bkit/core/engine/ledgers/telemetry.ts +158 -21
- package/.bkit/core/engine/render/hosts.ts +114 -14
- package/.bkit/core/engine/shared/bkit-latest.ts +26 -4
- package/.bkit/core/engine/shared/dep-updater.ts +60 -0
- package/.bkit/core/engine/shared/egress.ts +1 -1
- package/.bkit/core/engine/shared/package-manager.ts +9 -0
- package/.bkit/core/engine/shared/settings.ts +92 -17
- package/.bkit/core/engine/shared/timeouts.ts +2 -0
- package/.bkit/core/engine/tools/cli-doc.ts +111 -0
- package/.bkit/core/engine/tools/grammar-density.ts +1 -1
- package/.bkit/core/engine/tools/instructions-sources.ts +15 -17
- package/.bkit/core/engine/tools/instructions.ts +94 -43
- package/.bkit/core/hooks/antigravity-hook.js +25 -10
- package/.bkit/core/hooks/gateguard-engine.js +53 -29
- package/.bkit/core/hooks/guardrails-shell.js +4 -4
- package/.bkit/core/hooks/guardrails-tiers.js +3 -3
- package/.bkit/core/hooks/preflight-linear.sh +9 -9
- package/.bkit/core/hooks/preflight-rules.sh +8 -0
- package/.bkit/core/hooks/readguard-engine.js +29 -10
- package/.bkit/core/hooks/session-rules-advisory.js +61 -0
- package/.bkit/core/prompts/bkit-audit-generate.md +187 -116
- package/.bkit/core/prompts/bkit-build-challenge-1.md +56 -37
- package/.bkit/core/prompts/bkit-build-challenge-2.md +65 -45
- package/.bkit/core/prompts/bkit-build-install-skills.md +38 -29
- package/.bkit/core/prompts/bkit-build-plan-convert.md +43 -32
- package/.bkit/core/prompts/bkit-build-plan-current.md +49 -39
- package/.bkit/core/prompts/bkit-build-plan-gaps-remediate.md +79 -55
- package/.bkit/core/prompts/bkit-build-plan-tasks.md +149 -0
- package/.bkit/core/prompts/bkit-build-plan-tests.md +120 -0
- package/.bkit/core/prompts/bkit-build-plan-verify.md +87 -50
- package/.bkit/core/prompts/bkit-debug-abort-handover.md +36 -35
- package/.bkit/core/prompts/bkit-debug-failure-diagnose.md +96 -64
- package/.bkit/core/prompts/bkit-debug-failure-remediate.md +54 -45
- package/.bkit/core/prompts/bkit-debug-failure-reproduce.md +42 -33
- package/.bkit/core/prompts/bkit-debug-failure-soak.md +53 -37
- package/.bkit/core/prompts/bkit-design-brainstorm-ideate-1.md +35 -30
- package/.bkit/core/prompts/bkit-design-brainstorm-ideate-2.md +34 -29
- package/.bkit/core/prompts/bkit-design-brainstorm-ideate-3.md +32 -28
- package/.bkit/core/prompts/bkit-design-generate.md +68 -52
- package/.bkit/core/prompts/bkit-design-organise.md +73 -35
- package/.bkit/core/prompts/bkit-design-review-1.md +58 -54
- package/.bkit/core/prompts/bkit-design-review-2.md +54 -50
- package/.bkit/core/prompts/bkit-design-spike.md +54 -47
- package/.bkit/core/prompts/bkit-design-update.md +42 -31
- package/.bkit/core/prompts/bkit-plan-generate.md +76 -58
- package/.bkit/core/prompts/bkit-plan-review-1.md +63 -49
- package/.bkit/core/prompts/bkit-plan-review-2.md +60 -48
- package/.bkit/core/prompts/bkit-plan-scope-check.md +53 -46
- package/.bkit/core/prompts/bkit-plan-update.md +70 -52
- package/.bkit/core/prompts/bkit-ship-conflict-resolve.md +82 -50
- package/.bkit/core/prompts/bkit-ship-deferred-sweep.md +80 -45
- package/.bkit/core/prompts/bkit-ship-update-docs.md +35 -29
- package/.bkit/core/prompts/bkit-utility-compress-markdown.md +55 -49
- package/.bkit/core/prompts/bkit-utility-update-decisions.md +76 -49
- package/.bkit/core/prompts/bkit-utility-update-deferrals.md +70 -41
- package/.bkit/core/prompts/bkit-utility-update-documentation.md +33 -30
- package/.bkit/core/prompts/bkit-utility-update-failures.md +73 -43
- package/.bkit/core/prompts/bkit-utility-update-knowledge.md +77 -50
- package/.bkit/core/prompts/bkit-utility-update-roadmap.md +77 -45
- package/.bkit/core/prompts/bkit-utility-update-tracker.md +144 -68
- package/.bkit/core/workflows/bkit-auto.md +53 -30
- package/.bkit/core/workflows/bkit-build.md +635 -304
- package/.bkit/core/workflows/bkit-debug.md +301 -148
- package/.bkit/core/workflows/bkit-design.md +167 -95
- package/.bkit/core/workflows/bkit-plan.md +172 -84
- package/.bkit/core/workflows/bkit-ship.md +299 -152
- package/.bkit/shared/.agents/plugins/bkit/hooks.json +10 -0
- package/.bkit/shared/.claude/bkit-cloud.md +12 -10
- package/.bkit/shared/.claude/settings.json +3 -0
- package/.bkit/shared/.codex/bkit-cloud.md +98 -0
- package/.bkit/shared/.codex/hooks.json +20 -0
- package/.bkit/shared/.cursor/bkit-cloud.md +3 -3
- package/.bkit/shared/.opencode/opencode.json +1 -1
- package/.bkit/shared/CLAUDE.md +5 -1
- package/.bkit/shared/GEMINI.md +4 -1
- package/.bkit/shared/docs/architecture.md +4 -7
- package/.bkit/shared/docs/data-schema.md +4 -7
- package/.bkit/shared/docs/deployments.md +239 -166
- package/.bkit/shared/docs/design.md +11 -12
- package/.bkit/shared/docs/noise.md +8 -7
- package/.bkit/shared/docs/observability.md +5 -8
- package/.bkit/shared/docs/security.md +35 -17
- package/.bkit/shared/docs/setup.md +29 -18
- package/.bkit/shared/docs/technology.md +3 -6
- package/.bkit/shared/docs/testing.md +282 -176
- package/.bkit/shared/gitignore +6 -2
- package/.bkit/templates/.claude/hooks/bkit-cloud-bootstrap.sh +15 -16
- package/.bkit/templates/.cursor/Dockerfile +12 -8
- package/.bkit/templates/.cursor/environment.json +1 -1
- package/.bkit/templates/.github/ISSUE_TEMPLATE/bkit-bug.yml +10 -8
- package/.bkit/templates/.github/ISSUE_TEMPLATE/bkit-change.yml +24 -12
- package/.bkit/templates/.github/ISSUE_TEMPLATE/bkit-idea.yml +3 -3
- package/.bkit/templates/.github/renovate.json5 +34 -6
- package/.bkit/templates/.github/workflows/bkit-ci.yml +53 -50
- package/.bkit/templates/.github/workflows/bkit-cloud.yml +13 -14
- package/.bkit/templates/.github/workflows/bkit-health.yml +97 -0
- package/.bkit/templates/.github/workflows/bkit-renovate.yml +5 -4
- package/.bkit/templates/.github/workflows/bkit-trivy.yml +5 -4
- package/.bkit/templates/.husky/pre-commit +2 -2
- package/.bkit/templates/.husky/pre-push +95 -35
- package/.bkit/templates/.prettierignore +6 -7
- package/.bkit/templates/.vale.ini +27 -27
- package/.bkit/templates/context/bkit-cloudrun.md +23 -15
- package/.bkit/templates/context/bkit-expo.md +70 -52
- package/.bkit/templates/context/bkit-github.md +93 -56
- package/.bkit/templates/context/bkit-inngest.md +21 -15
- package/.bkit/templates/context/bkit-maestro.md +22 -16
- package/.bkit/templates/context/bkit-playwright.md +23 -17
- package/.bkit/templates/context/bkit-resend.md +12 -10
- package/.bkit/templates/context/bkit-sentry.md +30 -20
- package/.bkit/templates/context/bkit-serena.md +8 -7
- package/.bkit/templates/context/bkit-stripe.md +14 -13
- package/.bkit/templates/context/bkit-supabase.md +16 -13
- package/.bkit/templates/context/bkit-tavily.md +14 -11
- package/.bkit/templates/context/bkit-vercel.md +27 -18
- package/.bkit/templates/docs/capabilities.md +15 -14
- package/.bkit/templates/scripts/ci/{check-accepted-divergences.mjs → bkit-check-accepted-divergences.mjs} +6 -3
- package/.bkit/templates/scripts/ci/{check-accepted-divergences.test.mjs → bkit-check-accepted-divergences.test.mjs} +3 -3
- package/.bkit/templates/scripts/ci/{check-capstone.mjs → bkit-check-capstone.mjs} +2 -2
- package/.bkit/templates/scripts/ci/{check-capstone.test.mjs → bkit-check-capstone.test.mjs} +4 -4
- package/.bkit/templates/scripts/ci/{check-dependency-audit.mjs → bkit-check-dependency-audit.mjs} +103 -18
- package/.bkit/templates/scripts/ci/{check-dependency-audit.test.mjs → bkit-check-dependency-audit.test.mjs} +31 -3
- package/.bkit/templates/scripts/ci/bkit-machine-lock.sh +387 -0
- package/.bkit/templates/scripts/ci/bkit-test-awake.mjs +75 -0
- package/.bkit/templates/scripts/ci/bkit-test-awake.test.mjs +160 -0
- package/.bkit/templates/scripts/ci/lanes/{resolve-push-base.mjs → bkit-resolve-push-base.mjs} +3 -3
- package/.bkit/templates/scripts/ci/lanes/{resolve-push-base.test.mjs → bkit-resolve-push-base.test.mjs} +4 -4
- package/.bkit/templates/scripts/cleanup/bkit-disk-prune.mjs +9 -1
- package/.bkit/templates/scripts/graphify/bkit-graph-drift.py +1 -1
- package/.bkit/templates/scripts/graphify/bkit-graph-eager.py +3 -3
- package/.bkit/templates/scripts/graphify/bkit-graph-embed.py +63 -0
- package/.bkit/templates/scripts/graphify/bkit-graph-imports.py +2 -2
- package/.bkit/templates/scripts/graphify/bkit-graph-pre-push.sh +69 -18
- package/.bkit/templates/scripts/graphify/bkit-graph-repair.py +3 -3
- package/.bkit/templates/scripts/graphify/bkit-graph-surface.py +1 -1
- package/.bkit/templates/scripts/graphify/bkit-graphify-graphml.py +1 -1
- package/.bkit/templates/scripts/graphify/bkit-graphify-rollup.py +197 -126
- package/.bkit/templates/scripts/graphify/bkit-graphify.sh +64 -41
- package/.bkit/templates/scripts/slop/bkit-slop-type-suppression.mjs +23 -7
- package/.bkit/templates/slop-scan.config.json +9 -2
- package/CHANGELOG.md +119 -0
- package/README.md +250 -76
- package/dist/checks/after/auth.js +36 -33
- package/dist/checks/after/ci-yml.js +52 -2
- package/dist/checks/after/index.js +12 -4
- package/dist/checks/after/tools.js +73 -33
- package/dist/checks/before/context-fetch.js +218 -33
- package/dist/checks/before/env.js +1 -1
- package/dist/checks/before/index.js +6 -2
- package/dist/checks/before/repo.js +35 -1
- package/dist/checks/status-holes.js +739 -114
- package/dist/checks/tips/catalogue.js +59 -17
- package/dist/checks/tips/detect.js +30 -0
- package/dist/checks/tips/index.js +48 -6
- package/dist/cli.js +222 -84
- package/dist/commands/analysis.js +77 -53
- package/dist/commands/ci/ci.js +302 -25
- package/dist/commands/ci/pins.js +142 -0
- package/dist/commands/ci/push-gate.js +194 -0
- package/dist/commands/install/uninstall.js +23 -27
- package/dist/commands/install/upgrade.js +21 -11
- package/dist/commands/land.js +126 -10
- package/dist/commands/lib.js +244 -5
- package/dist/commands/registry.js +6 -2
- package/dist/commands/setup/setup.js +1 -0
- package/dist/commands/stats.js +69 -30
- package/dist/commands/workflow/branches.js +1232 -111
- package/dist/commands/workflow/challenge.js +90 -37
- package/dist/commands/workflow/completeness.js +97 -0
- package/dist/commands/workflow/context.js +371 -51
- package/dist/commands/workflow/counters.js +206 -40
- package/dist/commands/workflow/decisions.js +60 -17
- package/dist/commands/workflow/disk.js +213 -55
- package/dist/commands/workflow/fids.js +18 -1
- package/dist/commands/workflow/issues.js +6 -0
- package/dist/commands/workflow/ledgers.js +372 -21
- package/dist/commands/workflow/locks.js +2 -0
- package/dist/commands/workflow/plan-blocks.js +78 -14
- package/dist/commands/workflow/plans.js +205 -0
- package/dist/commands/workflow/prs.js +12 -3
- package/dist/commands/workflow/repo.js +6 -0
- package/dist/commands/workflow/roadmap.js +50 -17
- package/dist/commands/workflow/run-facts.js +23 -28
- package/dist/commands/workflow/runs.js +530 -33
- package/dist/commands/workflow/runtime.js +3 -0
- package/dist/commands/workflow/skills.js +1 -0
- package/dist/commands/workflow/status.js +166 -19
- package/dist/commands/workflow/step-table.js +61 -29
- package/dist/commands/workflow/steps.js +542 -26
- package/dist/commands/workflow/summary-findings.js +117 -0
- package/dist/commands/workflow/summary.js +154 -41
- package/dist/commands/workflow/tasks.js +378 -0
- package/dist/commands/workflow/test-blocks.js +231 -0
- package/dist/commands/workflow/tests-changed.js +172 -0
- package/dist/commands/workflow/tests.js +1013 -321
- package/dist/commands/workflow/workflows.js +191 -38
- package/dist/commands/workflow/worktrees.js +310 -42
- package/dist/install/cloud-env.js +233 -99
- package/dist/install/context-ci-workflow.js +85 -0
- package/dist/install/manifest.js +57 -12
- package/dist/install/modules/antigravity.js +3 -2
- package/dist/install/modules/cloud.js +3 -3
- package/dist/install/modules/codex.js +12 -2
- package/dist/install/modules/core.js +851 -53
- package/dist/install/modules/cursor.js +6 -6
- package/dist/install/modules/opencode.js +11 -5
- package/dist/install/template-notes.js +116 -0
- package/dist/install/version-file.js +3 -2
- package/dist/ledgers/compact.js +87 -0
- package/dist/ledgers/journal.js +233 -0
- package/dist/ledgers/status.js +115 -5
- package/dist/ledgers/telemetry.js +121 -17
- package/dist/render/hosts.js +100 -14
- package/dist/shared/bkit-latest.js +26 -4
- package/dist/shared/dep-updater.js +49 -0
- package/dist/shared/egress.js +1 -1
- package/dist/shared/package-manager.js +6 -0
- package/dist/shared/settings.js +59 -10
- package/dist/shared/timeouts.js +2 -0
- package/dist/tools/cli-doc.js +97 -0
- package/dist/tools/grammar-density.js +1 -1
- package/dist/tools/instructions-sources.js +15 -16
- package/dist/tools/instructions.js +83 -39
- package/package.json +58 -42
- package/.bkit/core/.bkit/lite.md +0 -73
- package/.bkit/core/engine/commands/workflow/workstreams.ts +0 -172
- package/.bkit/core/prompts/bkit-build-plan-execute.md +0 -124
- package/.bkit/templates/scripts/ci/bkit-local-stack-lock.sh +0 -194
- package/dist/commands/workflow/workstreams.js +0 -149
- /package/.bkit/templates/.vale/styles/{House → Bkit}/Filler.yml +0 -0
- /package/.bkit/templates/.vale/styles/{House → Bkit}/Hedging.yml +0 -0
- /package/.bkit/templates/.vale/styles/{House → Bkit}/LLMSlop.yml +0 -0
- /package/.bkit/templates/.vale/styles/{House → Bkit}/Verbose.yml +0 -0
- /package/.bkit/templates/scripts/ci/{accepted-advisories.json → bkit-accepted-advisories.json} +0 -0
- /package/.bkit/templates/scripts/ci/{accepted-divergences.json → bkit-accepted-divergences.json} +0 -0
- /package/.bkit/templates/scripts/launchd/{launchd.env.example → bkit-launchd.env.example} +0 -0
- /package/.bkit/templates/scripts/launchd/{ai.bkit.launchd.plist → bkit-launchd.plist} +0 -0
|
@@ -32,8 +32,10 @@ import {
|
|
|
32
32
|
runOrStepField,
|
|
33
33
|
statusTimestamp,
|
|
34
34
|
type StatusEvent,
|
|
35
|
+
type StatusRow,
|
|
35
36
|
} from "../../ledgers/status.js";
|
|
36
37
|
import {
|
|
38
|
+
compareTs,
|
|
37
39
|
foldFrom,
|
|
38
40
|
normalize,
|
|
39
41
|
resolveRepoSlug,
|
|
@@ -41,9 +43,17 @@ import {
|
|
|
41
43
|
type CoverageStats,
|
|
42
44
|
type OutcomePayload,
|
|
43
45
|
} from "../../ledgers/telemetry.js";
|
|
44
|
-
import {
|
|
46
|
+
import {
|
|
47
|
+
check as checkCompleteness,
|
|
48
|
+
deriveContract,
|
|
49
|
+
parseRows,
|
|
50
|
+
readCompleteness,
|
|
51
|
+
type StatusRow as HoleRow,
|
|
52
|
+
} from "../../checks/status-holes.js";
|
|
53
|
+
import { getWorkflowsRoot } from "../../shared/package-roots.js";
|
|
54
|
+
import { ASK_POINTS, readBkitConfig } from "../../shared/settings.js";
|
|
45
55
|
import { gradeCompliance } from "../comply.js";
|
|
46
|
-
import { landDir, pushToDev, type DevPush } from "../land.js";
|
|
56
|
+
import { fetchDev, landDir, pushToDev, type DevPush } from "../land.js";
|
|
47
57
|
import {
|
|
48
58
|
CommandError,
|
|
49
59
|
DEV,
|
|
@@ -102,7 +112,7 @@ import {
|
|
|
102
112
|
timeBlock,
|
|
103
113
|
} from "./run-facts.js";
|
|
104
114
|
import { buildSummary, refOf, SUMMARY_WORKFLOWS, type SummaryWorkflow } from "./summary.js";
|
|
105
|
-
import { parseWorkstreams } from "./
|
|
115
|
+
import { parsePlans, parseWorkstreams } from "./plans.js";
|
|
106
116
|
import {
|
|
107
117
|
EXIT_REMOVE_FAILED,
|
|
108
118
|
EXIT_SPLIT_BUCKET,
|
|
@@ -304,17 +314,23 @@ function checkHeldLock(file: string, who: { workflow: string; fid: string; token
|
|
|
304
314
|
// ---------------------------------------------------------------------------
|
|
305
315
|
|
|
306
316
|
/**
|
|
307
|
-
* Abort a rebase left in progress in `tree
|
|
308
|
-
*
|
|
317
|
+
* Abort a rebase or a merge left in progress in `tree` (ship Step 4 leaves a merge
|
|
318
|
+
* of origin/dev in progress for a hand resolution). `git rev-parse --git-path X`
|
|
319
|
+
* always exits 0 (it only computes the path), so the path's existence is the test.
|
|
309
320
|
*/
|
|
310
321
|
function abortRebase(tree: string, log: (m: string) => void): boolean {
|
|
311
|
-
const
|
|
322
|
+
const present = (name: string) => {
|
|
312
323
|
const p = git(tree, ["rev-parse", "--path-format=absolute", "--git-path", name]);
|
|
313
324
|
return p !== null && fs.existsSync(p);
|
|
314
|
-
}
|
|
315
|
-
|
|
316
|
-
|
|
317
|
-
|
|
325
|
+
};
|
|
326
|
+
const op = ["rebase-merge", "rebase-apply"].some(present)
|
|
327
|
+
? "rebase"
|
|
328
|
+
: present("MERGE_HEAD")
|
|
329
|
+
? "merge"
|
|
330
|
+
: null;
|
|
331
|
+
if (op === null) return false;
|
|
332
|
+
const res = runGit(tree, [op, "--abort"]);
|
|
333
|
+
if (!res.ok) log(`git ${op} --abort failed in ${tree}: ${res.stderr}`);
|
|
318
334
|
return res.ok;
|
|
319
335
|
}
|
|
320
336
|
|
|
@@ -871,7 +887,8 @@ async function handoverVerb(ctx: RunContext): Promise<number> {
|
|
|
871
887
|
ref = r.ref;
|
|
872
888
|
skipped = r.skipped;
|
|
873
889
|
} else if (push) {
|
|
874
|
-
addAllButCopied(tree);
|
|
890
|
+
const added = addAllButCopied(tree);
|
|
891
|
+
if (!added.ok) ctx.log(`abort commit: git add failed: ${added.stderr}`);
|
|
875
892
|
const made = runGit(tree, ["commit", "-m", `docs(${fid}): ${workflow} aborted bkit [skip ci]`]);
|
|
876
893
|
if (!made.ok) ctx.log(`abort commit: ${made.stderr || made.stdout}`);
|
|
877
894
|
const r = await pushBranch(tree, { mode: "abort", openPr: str(ctx.flags.openPr) }, ctx.log);
|
|
@@ -1033,6 +1050,100 @@ function appendStats(tree: string, rows: Array<Record<string, unknown>>, log: (m
|
|
|
1033
1050
|
}
|
|
1034
1051
|
}
|
|
1035
1052
|
|
|
1053
|
+
/**
|
|
1054
|
+
* The rows of `workflow`'s `nth` run in `file` (the last when omitted), in time order;
|
|
1055
|
+
* unreadable lines skipped. Runs split as `fold` splits them: rows ordered by `at`, file
|
|
1056
|
+
* order on a tie, each new `workflow-started` opening a run, so a previous run's rows in
|
|
1057
|
+
* the same second as this run's start stay with the previous run.
|
|
1058
|
+
*/
|
|
1059
|
+
function runRowsOf(file: string, workflow: string, nth = -1): HoleRow[] {
|
|
1060
|
+
const at = (r: HoleRow) => (typeof r["at"] === "string" ? r["at"] : "");
|
|
1061
|
+
const ordered = parseRows(fs.readFileSync(file, "utf-8"))
|
|
1062
|
+
.map((r, i) => ({ r, i }))
|
|
1063
|
+
.filter(({ r }) => r.workflow === workflow)
|
|
1064
|
+
.sort((a, b) => (at(a.r) < at(b.r) ? -1 : at(a.r) > at(b.r) ? 1 : a.i - b.i))
|
|
1065
|
+
.map(({ r }) => r);
|
|
1066
|
+
const runs: HoleRow[][] = [];
|
|
1067
|
+
const starts = new Set<string>();
|
|
1068
|
+
for (const r of ordered) {
|
|
1069
|
+
if (r.type === "workflow-started" && !starts.has(at(r))) {
|
|
1070
|
+
starts.add(at(r));
|
|
1071
|
+
runs.push([]);
|
|
1072
|
+
} else if (runs.length === 0 && r.type === "step-done") {
|
|
1073
|
+
runs.push([]);
|
|
1074
|
+
}
|
|
1075
|
+
runs.at(-1)?.push(r);
|
|
1076
|
+
}
|
|
1077
|
+
return runs.at(nth) ?? [];
|
|
1078
|
+
}
|
|
1079
|
+
|
|
1080
|
+
/** The contract of `workflow`, derived from its shipped markdown rendered for the tracker `cwd` is configured with. */
|
|
1081
|
+
const contractOf = (workflow: string, cwd: string) =>
|
|
1082
|
+
deriveContract(
|
|
1083
|
+
fs.readFileSync(path.join(getWorkflowsRoot(), `bkit-${workflow}.md`), "utf-8"),
|
|
1084
|
+
workflow,
|
|
1085
|
+
readIssueTracker(cwd),
|
|
1086
|
+
);
|
|
1087
|
+
|
|
1088
|
+
/**
|
|
1089
|
+
* Appends the close's `completeness` row for `workflow`'s last run. Advisory:
|
|
1090
|
+
* a failure of the check or of the write is logged in one line and never fails the close.
|
|
1091
|
+
* `journalSuspect` is set here only: the closing engine journals itself.
|
|
1092
|
+
*/
|
|
1093
|
+
function writeCompletenessRow(
|
|
1094
|
+
file: string,
|
|
1095
|
+
workflow: string,
|
|
1096
|
+
parentSha: string,
|
|
1097
|
+
log: (m: string) => void,
|
|
1098
|
+
): void {
|
|
1099
|
+
try {
|
|
1100
|
+
const verdict = checkCompleteness(
|
|
1101
|
+
runRowsOf(file, workflow),
|
|
1102
|
+
contractOf(workflow, path.dirname(file)),
|
|
1103
|
+
{
|
|
1104
|
+
journalSuspect: true,
|
|
1105
|
+
},
|
|
1106
|
+
);
|
|
1107
|
+
const row: StatusRow = { type: "completeness", ...verdict, at: statusTimestamp(), parentSha };
|
|
1108
|
+
fs.appendFileSync(file, appendLine(row));
|
|
1109
|
+
if (verdict.journalSuspect) {
|
|
1110
|
+
log(
|
|
1111
|
+
"[bkit-telemetry] journal looks dead at close: no engine-call rows for this run; the completeness verdict cannot be trusted",
|
|
1112
|
+
);
|
|
1113
|
+
}
|
|
1114
|
+
} catch (err) {
|
|
1115
|
+
// The check is advisory: report the failure and close without the row.
|
|
1116
|
+
log(`[bkit-telemetry] completeness row not written: ${(err as Error).message}`);
|
|
1117
|
+
}
|
|
1118
|
+
}
|
|
1119
|
+
|
|
1120
|
+
/**
|
|
1121
|
+
* The warning line for the run before the one being started (or resumed) when that run
|
|
1122
|
+
* was holey; `null` when it is clean, absent or unreadable. Never throws.
|
|
1123
|
+
*/
|
|
1124
|
+
function previousRunWarning(file: string, resumed: boolean): string | null {
|
|
1125
|
+
try {
|
|
1126
|
+
const events = readStatusEvents(file);
|
|
1127
|
+
const runs = fold(events);
|
|
1128
|
+
const at = runs.length - (resumed ? 2 : 1);
|
|
1129
|
+
const prev = runs[at];
|
|
1130
|
+
if (prev === undefined) return null;
|
|
1131
|
+
const number = runs.slice(0, at + 1).filter((r) => r.workflow === prev.workflow).length;
|
|
1132
|
+
const own = runRowsOf(file, prev.workflow, number - 1);
|
|
1133
|
+
const { verdict } = readCompleteness(own, contractOf(prev.workflow, path.dirname(file)));
|
|
1134
|
+
if (!verdict.holey) return null;
|
|
1135
|
+
const closed = own.filter((e) => e.type === "workflow-done").at(-1)?.["at"] ?? "never";
|
|
1136
|
+
return (
|
|
1137
|
+
`[bkit-workflows] previous run (${prev.workflow} run ${number}, closed ${closed}) was incomplete: ` +
|
|
1138
|
+
`${verdict.evidenceHoles.length} evidence hole(s), ${verdict.stepHoles.length} step hole(s); ` +
|
|
1139
|
+
`see: bkit completeness check --workflow=${prev.workflow} --file=${path.relative(process.cwd(), file) || file}`
|
|
1140
|
+
);
|
|
1141
|
+
} catch {
|
|
1142
|
+
// Advisory: an unreadable run or checker failure degrades to no warning.
|
|
1143
|
+
return null;
|
|
1144
|
+
}
|
|
1145
|
+
}
|
|
1146
|
+
|
|
1036
1147
|
/** Markdown link per feature doc and per log of this workflow, as on `ref`. */
|
|
1037
1148
|
export function artifactLinks(
|
|
1038
1149
|
root: string,
|
|
@@ -1085,6 +1196,20 @@ function closeComment(
|
|
|
1085
1196
|
});
|
|
1086
1197
|
}
|
|
1087
1198
|
|
|
1199
|
+
/** `--ending` / `--publish` of the close verb, validated. */
|
|
1200
|
+
function closeEnding(f: Record<string, FlagValue>): Pick<CloseInput, "ending" | "publish"> {
|
|
1201
|
+
const ending = str(f.ending);
|
|
1202
|
+
if (ending !== undefined && ending !== "done" && ending !== "held")
|
|
1203
|
+
throw new CommandError(EXIT.USAGE, `--ending must be done or held, got ${ending}`);
|
|
1204
|
+
const publish = str(f.publish);
|
|
1205
|
+
if (publish !== undefined && publish !== "true" && publish !== "false")
|
|
1206
|
+
throw new CommandError(EXIT.USAGE, `--publish must be true or false, got ${publish}`);
|
|
1207
|
+
return {
|
|
1208
|
+
...(ending === undefined ? {} : { ending }),
|
|
1209
|
+
...(publish === undefined ? {} : { publish: publish === "true" }),
|
|
1210
|
+
};
|
|
1211
|
+
}
|
|
1212
|
+
|
|
1088
1213
|
export interface CloseInput {
|
|
1089
1214
|
workflow: string;
|
|
1090
1215
|
fid: string;
|
|
@@ -1102,6 +1227,10 @@ export interface CloseInput {
|
|
|
1102
1227
|
number?: string;
|
|
1103
1228
|
title?: string;
|
|
1104
1229
|
tree?: string;
|
|
1230
|
+
/** `held` = a local build that published nothing; default `done`. */
|
|
1231
|
+
ending?: "done" | "held";
|
|
1232
|
+
/** The resolved publish value of a build; absent when unset. */
|
|
1233
|
+
publish?: boolean;
|
|
1105
1234
|
}
|
|
1106
1235
|
|
|
1107
1236
|
/**
|
|
@@ -1134,15 +1263,26 @@ export function closeWorkflow(
|
|
|
1134
1263
|
// Graded first, so the report below carries this run's grade.
|
|
1135
1264
|
const violations = gradeCompliance(where.tree, workflow, log, o.squashSha, { parentSha, step });
|
|
1136
1265
|
|
|
1266
|
+
let progressLine: string | undefined;
|
|
1137
1267
|
if (o.recordStep === true) {
|
|
1138
|
-
writeStepRow(
|
|
1268
|
+
const written = writeStepRow(
|
|
1139
1269
|
where.tree,
|
|
1140
1270
|
{ file: where.status, workflow, step, artifacts: [], commit: "none" },
|
|
1141
1271
|
log,
|
|
1142
1272
|
);
|
|
1273
|
+
progressLine = written.progressLine;
|
|
1143
1274
|
}
|
|
1275
|
+
writeCompletenessRow(where.status, workflow, parentSha, log);
|
|
1144
1276
|
const endAt = statusTimestamp();
|
|
1145
|
-
const
|
|
1277
|
+
const ending = o.ending ?? "done";
|
|
1278
|
+
const row = {
|
|
1279
|
+
type: "workflow-done" as const,
|
|
1280
|
+
workflow,
|
|
1281
|
+
at: endAt,
|
|
1282
|
+
parentSha,
|
|
1283
|
+
ending,
|
|
1284
|
+
...(o.publish === undefined ? {} : { publish: o.publish }),
|
|
1285
|
+
};
|
|
1146
1286
|
fs.appendFileSync(where.status, appendLine(row));
|
|
1147
1287
|
|
|
1148
1288
|
const repo = resolveRepoSlug(where.root) || "unknown/repo";
|
|
@@ -1159,7 +1299,6 @@ export function closeWorkflow(
|
|
|
1159
1299
|
const startedRows = new Set(
|
|
1160
1300
|
events.filter((e) => e.type === "workflow-started" && e.workflow === workflow).map((e) => e.at),
|
|
1161
1301
|
).size;
|
|
1162
|
-
const logDir = path.join(where.tree, logDirRel(where.month, o.fid));
|
|
1163
1302
|
const by = { workflow, step };
|
|
1164
1303
|
|
|
1165
1304
|
const counterRow = {
|
|
@@ -1199,7 +1338,8 @@ export function closeWorkflow(
|
|
|
1199
1338
|
by,
|
|
1200
1339
|
run: { parentSha, ...(o.prNumber === undefined ? {} : { pr: o.prNumber }) },
|
|
1201
1340
|
time: startKnown === undefined ? null : timeBlock(startKnown, Math.max(startKnown, endMs)),
|
|
1202
|
-
ending
|
|
1341
|
+
ending,
|
|
1342
|
+
...(o.publish === undefined ? {} : { publish: o.publish }),
|
|
1203
1343
|
lines,
|
|
1204
1344
|
...(runRowsOf.length > 0 ? { steps: stepsBlock(runRowsOf) } : {}),
|
|
1205
1345
|
...(ci.length > 0 ? { ci } : {}),
|
|
@@ -1207,12 +1347,7 @@ export function closeWorkflow(
|
|
|
1207
1347
|
...(plan === undefined ? {} : { plan }),
|
|
1208
1348
|
...(workflow === "build"
|
|
1209
1349
|
? {
|
|
1210
|
-
build: buildBlock(
|
|
1211
|
-
runRowsOf,
|
|
1212
|
-
logDir,
|
|
1213
|
-
planFiles(where.tree, where.month, o.fid),
|
|
1214
|
-
runDeferrals(),
|
|
1215
|
-
),
|
|
1350
|
+
build: buildBlock(runRowsOf, planFiles(where.tree, where.month, o.fid), runDeferrals()),
|
|
1216
1351
|
}
|
|
1217
1352
|
: {}),
|
|
1218
1353
|
...(context === undefined ? {} : { context }),
|
|
@@ -1296,6 +1431,7 @@ export function closeWorkflow(
|
|
|
1296
1431
|
comment,
|
|
1297
1432
|
roadmapFoldNeeded: true,
|
|
1298
1433
|
featureStatus: FEATURE_STATUS[workflow],
|
|
1434
|
+
...(progressLine === undefined ? {} : { progressLine }),
|
|
1299
1435
|
};
|
|
1300
1436
|
}
|
|
1301
1437
|
|
|
@@ -1343,8 +1479,8 @@ function closePr(
|
|
|
1343
1479
|
* checkout): the close rows there, then ONE `docs({fid}): ship DONE bkit [skip ci]`
|
|
1344
1480
|
* commit built in a throwaway origin/dev checkout carrying the run's book and
|
|
1345
1481
|
* landed on dev — a refused push publishes it through a `ship-close/{fid}` PR.
|
|
1346
|
-
*
|
|
1347
|
-
*
|
|
1482
|
+
* Once the close is on dev, the feature worktree and `branch` are removed; then
|
|
1483
|
+
* a close that landed (or opened its PR) releases the workflow lock. A close
|
|
1348
1484
|
* that did not land keeps the lock for the Failure Path.
|
|
1349
1485
|
*/
|
|
1350
1486
|
async function shipClose(
|
|
@@ -1420,22 +1556,13 @@ async function shipClose(
|
|
|
1420
1556
|
return { code: EXIT_FLUSH_FAILED, out: null };
|
|
1421
1557
|
}
|
|
1422
1558
|
|
|
1423
|
-
|
|
1424
|
-
|
|
1425
|
-
fid: o.fid,
|
|
1426
|
-
token,
|
|
1427
|
-
});
|
|
1428
|
-
if (released.removeFailed) {
|
|
1429
|
-
ctx.log("Lock removal failed");
|
|
1430
|
-
return { code: EXIT_FLUSH_FAILED, out: null };
|
|
1431
|
-
}
|
|
1432
|
-
|
|
1433
|
-
// The book is on dev only once the close landed or its PR merged.
|
|
1559
|
+
// The book is on dev only once the close landed or its PR merged. The worktree
|
|
1560
|
+
// goes while the lock is still held, so no run of this FID resumes into it.
|
|
1434
1561
|
let worktree: RemoveResult | null = null;
|
|
1435
1562
|
if (landed.via === "close-pr-open") {
|
|
1436
1563
|
ctx.log(`close PR not merged — ${kept} until it is`);
|
|
1437
1564
|
} else {
|
|
1438
|
-
if (landed.via === "close-pr" && !
|
|
1565
|
+
if (landed.via === "close-pr" && !fetchDev(root).ok)
|
|
1439
1566
|
ctx.log(
|
|
1440
1567
|
`fetch of dev after the close PR failed — origin/${DEV} is stale until the next fetch`,
|
|
1441
1568
|
);
|
|
@@ -1445,6 +1572,16 @@ async function shipClose(
|
|
|
1445
1572
|
ctx.log(`${(err as Error).message} — remove ${book} by hand`);
|
|
1446
1573
|
}
|
|
1447
1574
|
}
|
|
1575
|
+
|
|
1576
|
+
const released = releaseLock(workflowLockPath(root, month, o.fid), {
|
|
1577
|
+
workflow: "ship",
|
|
1578
|
+
fid: o.fid,
|
|
1579
|
+
token,
|
|
1580
|
+
});
|
|
1581
|
+
if (released.removeFailed) {
|
|
1582
|
+
ctx.log("Lock removal failed");
|
|
1583
|
+
return { code: EXIT_FLUSH_FAILED, out: null };
|
|
1584
|
+
}
|
|
1448
1585
|
return { code: EXIT.OK, out: { ...out, landed, worktree } };
|
|
1449
1586
|
}
|
|
1450
1587
|
|
|
@@ -1583,24 +1720,38 @@ function summaryVerb(ctx: RunContext): number {
|
|
|
1583
1720
|
const abs = path.resolve(tree, r);
|
|
1584
1721
|
return fs.existsSync(abs) && fs.statSync(abs).isFile() ? fs.readFileSync(abs, "utf-8") : null;
|
|
1585
1722
|
};
|
|
1586
|
-
const
|
|
1587
|
-
|
|
1588
|
-
|
|
1723
|
+
const deferralHistory = ledgerRows(path.join(tree, "docs", "deferrals.jsonl")).map((r) =>
|
|
1724
|
+
normalize(r),
|
|
1725
|
+
);
|
|
1726
|
+
const runDeferralKeys = new Set(
|
|
1727
|
+
deferralHistory
|
|
1728
|
+
.filter((r) => isRunsOwnRow(r, { fid, workflow, startMs }, new Set()))
|
|
1729
|
+
.map((r) => r.key),
|
|
1730
|
+
);
|
|
1731
|
+
const currentDeferrals = new Map(
|
|
1732
|
+
deferralHistory.sort((a, b) => compareTs({ ts: a.ts }, { ts: b.ts })).map((r) => [r.key, r]),
|
|
1733
|
+
);
|
|
1734
|
+
const deferrals = [...currentDeferrals.values()].filter((r) => runDeferralKeys.has(r.key));
|
|
1589
1735
|
const organisedPath = path.join(logDir, "design-v3-organised.md");
|
|
1590
1736
|
const organised =
|
|
1591
1737
|
workflow === "design" && fs.existsSync(organisedPath)
|
|
1592
1738
|
? fs.readFileSync(organisedPath, "utf-8")
|
|
1593
1739
|
: undefined;
|
|
1594
1740
|
const prNumber = positiveInt(ctx.flags.pr, "pr");
|
|
1741
|
+
const publishFlag = str(ctx.flags.publish);
|
|
1742
|
+
if (publishFlag !== undefined && publishFlag !== "true" && publishFlag !== "false")
|
|
1743
|
+
throw new CommandError(EXIT.USAGE, `--publish must be true or false, got ${publishFlag}`);
|
|
1595
1744
|
|
|
1596
1745
|
const summary = buildSummary({
|
|
1746
|
+
root: tree,
|
|
1747
|
+
publish: publishFlag === undefined ? undefined : publishFlag === "true",
|
|
1597
1748
|
workflow: workflow as SummaryWorkflow,
|
|
1598
1749
|
fid,
|
|
1599
1750
|
ref: refOf(fid, readIssueTracker(tree)),
|
|
1600
1751
|
rows,
|
|
1601
1752
|
plans: plans.map((p) => ({ path: rel(p), text: fs.readFileSync(p, "utf-8") })),
|
|
1602
1753
|
deferrals,
|
|
1603
|
-
deferralsAdded:
|
|
1754
|
+
deferralsAdded: deferrals.filter((r) => r.status !== "CLOSED").length,
|
|
1604
1755
|
decisionFiles:
|
|
1605
1756
|
(workflow === "build" || workflow === "ship") && fs.existsSync(logDir)
|
|
1606
1757
|
? fs
|
|
@@ -1611,6 +1762,7 @@ function summaryVerb(ctx: RunContext): number {
|
|
|
1611
1762
|
: [],
|
|
1612
1763
|
read,
|
|
1613
1764
|
workstreams: organised === undefined ? undefined : parseWorkstreams(organised),
|
|
1765
|
+
suggestedPlans: organised === undefined ? undefined : parsePlans(organised),
|
|
1614
1766
|
organised,
|
|
1615
1767
|
pr:
|
|
1616
1768
|
workflow === "ship" && prNumber !== undefined
|
|
@@ -1901,6 +2053,7 @@ export const workflowsCommand: CommandSpec = {
|
|
|
1901
2053
|
verbs: {
|
|
1902
2054
|
start: {
|
|
1903
2055
|
summary: "Take the feature lock and open a run (workflow-started unless resuming).",
|
|
2056
|
+
use: "workflow",
|
|
1904
2057
|
flags: [
|
|
1905
2058
|
WORKFLOW_FLAG,
|
|
1906
2059
|
FID_FLAG,
|
|
@@ -1922,7 +2075,7 @@ export const workflowsCommand: CommandSpec = {
|
|
|
1922
2075
|
lock: "{path, month, token, reclaimed} of the lock taken, or {path} with --lock-held",
|
|
1923
2076
|
file: "absolute path to status.jsonl",
|
|
1924
2077
|
resumed: "the latest run was this workflow, IN_PROGRESS: no new row",
|
|
1925
|
-
row: "the appended workflow-started row, or null when resuming",
|
|
2078
|
+
row: "the appended workflow-started row, with `limits` (the workflow's ask points from bkit.workflows, frozen for the run), or null when resuming",
|
|
1926
2079
|
run: "which run of the workflow this is (1-based)",
|
|
1927
2080
|
lastDoneStep: "the current run's last DONE step: resume after it (null on a new run)",
|
|
1928
2081
|
openDecision:
|
|
@@ -1986,15 +2139,22 @@ export const workflowsCommand: CommandSpec = {
|
|
|
1986
2139
|
}
|
|
1987
2140
|
}
|
|
1988
2141
|
|
|
1989
|
-
const
|
|
1990
|
-
const
|
|
2142
|
+
const resumed = lastRun(fold(readStatusEvents(file)), workflow)?.status === "IN_PROGRESS";
|
|
2143
|
+
const holeyWarning = previousRunWarning(file, resumed);
|
|
2144
|
+
if (holeyWarning !== null) ctx.log(holeyWarning);
|
|
1991
2145
|
let row: Record<string, unknown> | null = null;
|
|
1992
2146
|
if (!resumed) {
|
|
2147
|
+
// The run's limits, frozen here: `counters route` reads them for the whole run.
|
|
2148
|
+
const asks = readBkitConfig(where.tree).asks;
|
|
2149
|
+
const limits = Object.fromEntries(
|
|
2150
|
+
ASK_POINTS.filter((p) => p.startsWith(`${workflow}.`)).map((p) => [p, asks[p]]),
|
|
2151
|
+
);
|
|
1993
2152
|
row = {
|
|
1994
2153
|
type: "workflow-started",
|
|
1995
2154
|
workflow,
|
|
1996
2155
|
at: statusTimestamp(),
|
|
1997
2156
|
parentSha: headSha(path.dirname(file)),
|
|
2157
|
+
...(Object.keys(limits).length === 0 ? {} : { limits }),
|
|
1998
2158
|
};
|
|
1999
2159
|
fs.appendFileSync(file, appendLine(row as StatusEvent));
|
|
2000
2160
|
}
|
|
@@ -2019,6 +2179,7 @@ export const workflowsCommand: CommandSpec = {
|
|
|
2019
2179
|
fail: {
|
|
2020
2180
|
summary:
|
|
2021
2181
|
"Failure Path: workflow-failed row, abort rebase, release lock, clear sentinels (with --token); the bkit:failed labels and the failure comment.",
|
|
2182
|
+
use: "workflow",
|
|
2022
2183
|
flags: [
|
|
2023
2184
|
WORKFLOW_FLAG,
|
|
2024
2185
|
{ ...FID_FLAG, required: false, help: "feature id (needed with --token)" },
|
|
@@ -2075,7 +2236,7 @@ export const workflowsCommand: CommandSpec = {
|
|
|
2075
2236
|
],
|
|
2076
2237
|
output: {
|
|
2077
2238
|
row: "the appended workflow-failed row, or null (no --token, or no status.jsonl)",
|
|
2078
|
-
rebaseAborted: "an in-progress rebase was found and aborted",
|
|
2239
|
+
rebaseAborted: "an in-progress rebase or merge was found and aborted",
|
|
2079
2240
|
lock: "{path, existed, released, heldBy}: heldBy is another owner's lock line, left in place; null without --token",
|
|
2080
2241
|
sentinels: "[{name, path}] sentinels that existed before this call removed them",
|
|
2081
2242
|
handoverNeeded:
|
|
@@ -2103,6 +2264,7 @@ export const workflowsCommand: CommandSpec = {
|
|
|
2103
2264
|
handover: {
|
|
2104
2265
|
summary:
|
|
2105
2266
|
"Keep a failed run's record: commit and push it on the feature branch, or land its logs and ledgers on dev (--push from dev / main, ship's --flush); print the handover comment.",
|
|
2267
|
+
use: "workflow",
|
|
2106
2268
|
flags: [
|
|
2107
2269
|
WORKFLOW_FLAG,
|
|
2108
2270
|
FID_FLAG,
|
|
@@ -2163,6 +2325,7 @@ export const workflowsCommand: CommandSpec = {
|
|
|
2163
2325
|
close: {
|
|
2164
2326
|
summary:
|
|
2165
2327
|
"Grade compliance, workflow-done row, counter + outcome telemetry, report, artifact links; --flush lands ship's close on dev.",
|
|
2328
|
+
use: "workflow",
|
|
2166
2329
|
flags: [
|
|
2167
2330
|
WORKFLOW_FLAG,
|
|
2168
2331
|
FID_FLAG,
|
|
@@ -2212,6 +2375,16 @@ export const workflowsCommand: CommandSpec = {
|
|
|
2212
2375
|
},
|
|
2213
2376
|
...COMMENT_FLAGS,
|
|
2214
2377
|
{ name: "tree", type: "string", help: "the close comment links the tree of this ref" },
|
|
2378
|
+
{
|
|
2379
|
+
name: "ending",
|
|
2380
|
+
type: "string",
|
|
2381
|
+
help: "done|held (default done); held = a local build that published nothing",
|
|
2382
|
+
},
|
|
2383
|
+
{
|
|
2384
|
+
name: "publish",
|
|
2385
|
+
type: "string",
|
|
2386
|
+
help: "build: true|false, the resolved publish value; recorded on the workflow-done and outcome rows",
|
|
2387
|
+
},
|
|
2215
2388
|
{
|
|
2216
2389
|
name: "flush",
|
|
2217
2390
|
type: "boolean",
|
|
@@ -2278,6 +2451,8 @@ export const workflowsCommand: CommandSpec = {
|
|
|
2278
2451
|
roadmapFoldNeeded:
|
|
2279
2452
|
"always true: append the feature row and re-render the board (not run here)",
|
|
2280
2453
|
featureStatus: "roadmap status this close moves the feature to",
|
|
2454
|
+
progressLine:
|
|
2455
|
+
"--record-step: the exact chat progress line after a numbered completion is recorded",
|
|
2281
2456
|
landed: "--flush: {ref, via: head-push | close-pr | close-pr-open}",
|
|
2282
2457
|
worktree:
|
|
2283
2458
|
"--flush: the `bkit worktrees remove` result once the close is on dev; null while the close PR is unmerged or the removal failed",
|
|
@@ -2316,6 +2491,7 @@ export const workflowsCommand: CommandSpec = {
|
|
|
2316
2491
|
number: str(f.number),
|
|
2317
2492
|
title: str(f.title),
|
|
2318
2493
|
tree: str(f.tree),
|
|
2494
|
+
...closeEnding(f),
|
|
2319
2495
|
};
|
|
2320
2496
|
const finalParts = finalReturnParts(ctx, input.fid);
|
|
2321
2497
|
if (f.flush === true) {
|
|
@@ -2341,6 +2517,7 @@ export const workflowsCommand: CommandSpec = {
|
|
|
2341
2517
|
input: {
|
|
2342
2518
|
summary:
|
|
2343
2519
|
"Write logs/{FID}/{workflow}-input-{run}.md: the session prompt, the issue description and each human comment, then the plan, design and audit reports, each section dated.",
|
|
2520
|
+
use: "workflow",
|
|
2344
2521
|
flags: [
|
|
2345
2522
|
WORKFLOW_FLAG,
|
|
2346
2523
|
FID_FLAG,
|
|
@@ -2391,6 +2568,7 @@ export const workflowsCommand: CommandSpec = {
|
|
|
2391
2568
|
promote: {
|
|
2392
2569
|
summary:
|
|
2393
2570
|
"Design / plan close: the highest versioned draft becomes the canonical doc (anchor stamped, a changed canonical archived).",
|
|
2571
|
+
use: "workflow",
|
|
2394
2572
|
flags: [
|
|
2395
2573
|
{ ...WORKFLOW_FLAG, help: "design | plan" },
|
|
2396
2574
|
FID_FLAG,
|
|
@@ -2422,6 +2600,7 @@ export const workflowsCommand: CommandSpec = {
|
|
|
2422
2600
|
links: {
|
|
2423
2601
|
summary:
|
|
2424
2602
|
"The feature's docs and this workflow's logs on a ref as markdown links; optionally the close comment.",
|
|
2603
|
+
use: "workflow",
|
|
2425
2604
|
flags: [
|
|
2426
2605
|
WORKFLOW_FLAG,
|
|
2427
2606
|
FID_FLAG,
|
|
@@ -2487,6 +2666,7 @@ export const workflowsCommand: CommandSpec = {
|
|
|
2487
2666
|
summary: {
|
|
2488
2667
|
summary:
|
|
2489
2668
|
"The Summary step: write {workflow}-summary.md next to --file with the run's verdict, reasons and next command.",
|
|
2669
|
+
use: "workflow",
|
|
2490
2670
|
flags: [
|
|
2491
2671
|
{ ...WORKFLOW_FLAG, help: "plan | design | build | debug | ship" },
|
|
2492
2672
|
{
|
|
@@ -2506,6 +2686,11 @@ export const workflowsCommand: CommandSpec = {
|
|
|
2506
2686
|
type: "string",
|
|
2507
2687
|
help: "ship: the PR number; its size comes from gh pr view (left out when gh cannot answer)",
|
|
2508
2688
|
},
|
|
2689
|
+
{
|
|
2690
|
+
name: "publish",
|
|
2691
|
+
type: "string",
|
|
2692
|
+
help: "build: true|false, the resolved ending; false writes `Publish: held` and `Docs: not synced` (default true)",
|
|
2693
|
+
},
|
|
2509
2694
|
],
|
|
2510
2695
|
output: {
|
|
2511
2696
|
verdict: "PASS | CONCERNS | FAIL",
|