@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
|
@@ -23,10 +23,12 @@ import * as fs from "node:fs";
|
|
|
23
23
|
import * as os from "node:os";
|
|
24
24
|
import * as path from "node:path";
|
|
25
25
|
import { appendLine, fold, lastRun, runNumber, runOrStepField, statusTimestamp, } from "../../ledgers/status.js";
|
|
26
|
-
import { foldFrom, normalize, resolveRepoSlug, workflowTelemetry, } from "../../ledgers/telemetry.js";
|
|
27
|
-
import {
|
|
26
|
+
import { compareTs, foldFrom, normalize, resolveRepoSlug, workflowTelemetry, } from "../../ledgers/telemetry.js";
|
|
27
|
+
import { check as checkCompleteness, deriveContract, parseRows, readCompleteness, } from "../../checks/status-holes.js";
|
|
28
|
+
import { getWorkflowsRoot } from "../../shared/package-roots.js";
|
|
29
|
+
import { ASK_POINTS, readBkitConfig } from "../../shared/settings.js";
|
|
28
30
|
import { gradeCompliance } from "../comply.js";
|
|
29
|
-
import { landDir, pushToDev } from "../land.js";
|
|
31
|
+
import { fetchDev, landDir, pushToDev } from "../land.js";
|
|
30
32
|
import { CommandError, DEV, EXIT, git, isSharedBranch, parseJson, repoRoot, runGh, runGit, statusLocation, statusRelPath, } from "../lib.js";
|
|
31
33
|
import { anchorBkitStatus, pushBranch, readAnchor, stampAnchor } from "./branches.js";
|
|
32
34
|
import { AUTO_LABEL, AUTO_ROUTE_SUFFIX, buildComment, issueParts, parseComments, sortOldestFirst, trackerState, transitionLabels, } from "./issues.js";
|
|
@@ -34,7 +36,7 @@ import { EXIT_EMPTY, activeRecord, commitBookkeeping, ownPathCommit, ownSet, rem
|
|
|
34
36
|
import { readIssueTracker } from "./fids.js";
|
|
35
37
|
import { agentContextBlock, buildBlock, chatFingerprint, ciList, claudeTranscripts, hostChat, planBlock, planFiles, runChats, runLines, runStatusRows, stepsBlock, timeBlock, } from "./run-facts.js";
|
|
36
38
|
import { buildSummary, refOf, SUMMARY_WORKFLOWS } from "./summary.js";
|
|
37
|
-
import { parseWorkstreams } from "./
|
|
39
|
+
import { parsePlans, parseWorkstreams } from "./plans.js";
|
|
38
40
|
import { EXIT_REMOVE_FAILED, EXIT_SPLIT_BUCKET, acquireWorkflowLock, owns, readHolder, releaseLock, resolveMonth, workflowLockPath, } from "./locks.js";
|
|
39
41
|
import { highestVersion } from "./plan-versions.js";
|
|
40
42
|
import { mergePr, probePr } from "./prs.js";
|
|
@@ -158,19 +160,25 @@ function checkHeldLock(file, who) {
|
|
|
158
160
|
// fail
|
|
159
161
|
// ---------------------------------------------------------------------------
|
|
160
162
|
/**
|
|
161
|
-
* Abort a rebase left in progress in `tree
|
|
162
|
-
*
|
|
163
|
+
* Abort a rebase or a merge left in progress in `tree` (ship Step 4 leaves a merge
|
|
164
|
+
* of origin/dev in progress for a hand resolution). `git rev-parse --git-path X`
|
|
165
|
+
* always exits 0 (it only computes the path), so the path's existence is the test.
|
|
163
166
|
*/
|
|
164
167
|
function abortRebase(tree, log) {
|
|
165
|
-
const
|
|
168
|
+
const present = (name) => {
|
|
166
169
|
const p = git(tree, ["rev-parse", "--path-format=absolute", "--git-path", name]);
|
|
167
170
|
return p !== null && fs.existsSync(p);
|
|
168
|
-
}
|
|
169
|
-
|
|
171
|
+
};
|
|
172
|
+
const op = ["rebase-merge", "rebase-apply"].some(present)
|
|
173
|
+
? "rebase"
|
|
174
|
+
: present("MERGE_HEAD")
|
|
175
|
+
? "merge"
|
|
176
|
+
: null;
|
|
177
|
+
if (op === null)
|
|
170
178
|
return false;
|
|
171
|
-
const res = runGit(tree, [
|
|
179
|
+
const res = runGit(tree, [op, "--abort"]);
|
|
172
180
|
if (!res.ok)
|
|
173
|
-
log(`git
|
|
181
|
+
log(`git ${op} --abort failed in ${tree}: ${res.stderr}`);
|
|
174
182
|
return res.ok;
|
|
175
183
|
}
|
|
176
184
|
/** The workflow-failed state: row, rebase abort, lock release, sentinels. */
|
|
@@ -668,7 +676,9 @@ async function handoverVerb(ctx) {
|
|
|
668
676
|
skipped = r.skipped;
|
|
669
677
|
}
|
|
670
678
|
else if (push) {
|
|
671
|
-
addAllButCopied(tree);
|
|
679
|
+
const added = addAllButCopied(tree);
|
|
680
|
+
if (!added.ok)
|
|
681
|
+
ctx.log(`abort commit: git add failed: ${added.stderr}`);
|
|
672
682
|
const made = runGit(tree, ["commit", "-m", `docs(${fid}): ${workflow} aborted bkit [skip ci]`]);
|
|
673
683
|
if (!made.ok)
|
|
674
684
|
ctx.log(`abort commit: ${made.stderr || made.stdout}`);
|
|
@@ -816,6 +826,83 @@ function appendStats(tree, rows, log) {
|
|
|
816
826
|
return false;
|
|
817
827
|
}
|
|
818
828
|
}
|
|
829
|
+
/**
|
|
830
|
+
* The rows of `workflow`'s `nth` run in `file` (the last when omitted), in time order;
|
|
831
|
+
* unreadable lines skipped. Runs split as `fold` splits them: rows ordered by `at`, file
|
|
832
|
+
* order on a tie, each new `workflow-started` opening a run, so a previous run's rows in
|
|
833
|
+
* the same second as this run's start stay with the previous run.
|
|
834
|
+
*/
|
|
835
|
+
function runRowsOf(file, workflow, nth = -1) {
|
|
836
|
+
const at = (r) => (typeof r["at"] === "string" ? r["at"] : "");
|
|
837
|
+
const ordered = parseRows(fs.readFileSync(file, "utf-8"))
|
|
838
|
+
.map((r, i) => ({ r, i }))
|
|
839
|
+
.filter(({ r }) => r.workflow === workflow)
|
|
840
|
+
.sort((a, b) => (at(a.r) < at(b.r) ? -1 : at(a.r) > at(b.r) ? 1 : a.i - b.i))
|
|
841
|
+
.map(({ r }) => r);
|
|
842
|
+
const runs = [];
|
|
843
|
+
const starts = new Set();
|
|
844
|
+
for (const r of ordered) {
|
|
845
|
+
if (r.type === "workflow-started" && !starts.has(at(r))) {
|
|
846
|
+
starts.add(at(r));
|
|
847
|
+
runs.push([]);
|
|
848
|
+
}
|
|
849
|
+
else if (runs.length === 0 && r.type === "step-done") {
|
|
850
|
+
runs.push([]);
|
|
851
|
+
}
|
|
852
|
+
runs.at(-1)?.push(r);
|
|
853
|
+
}
|
|
854
|
+
return runs.at(nth) ?? [];
|
|
855
|
+
}
|
|
856
|
+
/** The contract of `workflow`, derived from its shipped markdown rendered for the tracker `cwd` is configured with. */
|
|
857
|
+
const contractOf = (workflow, cwd) => deriveContract(fs.readFileSync(path.join(getWorkflowsRoot(), `bkit-${workflow}.md`), "utf-8"), workflow, readIssueTracker(cwd));
|
|
858
|
+
/**
|
|
859
|
+
* Appends the close's `completeness` row for `workflow`'s last run. Advisory:
|
|
860
|
+
* a failure of the check or of the write is logged in one line and never fails the close.
|
|
861
|
+
* `journalSuspect` is set here only: the closing engine journals itself.
|
|
862
|
+
*/
|
|
863
|
+
function writeCompletenessRow(file, workflow, parentSha, log) {
|
|
864
|
+
try {
|
|
865
|
+
const verdict = checkCompleteness(runRowsOf(file, workflow), contractOf(workflow, path.dirname(file)), {
|
|
866
|
+
journalSuspect: true,
|
|
867
|
+
});
|
|
868
|
+
const row = { type: "completeness", ...verdict, at: statusTimestamp(), parentSha };
|
|
869
|
+
fs.appendFileSync(file, appendLine(row));
|
|
870
|
+
if (verdict.journalSuspect) {
|
|
871
|
+
log("[bkit-telemetry] journal looks dead at close: no engine-call rows for this run; the completeness verdict cannot be trusted");
|
|
872
|
+
}
|
|
873
|
+
}
|
|
874
|
+
catch (err) {
|
|
875
|
+
// The check is advisory: report the failure and close without the row.
|
|
876
|
+
log(`[bkit-telemetry] completeness row not written: ${err.message}`);
|
|
877
|
+
}
|
|
878
|
+
}
|
|
879
|
+
/**
|
|
880
|
+
* The warning line for the run before the one being started (or resumed) when that run
|
|
881
|
+
* was holey; `null` when it is clean, absent or unreadable. Never throws.
|
|
882
|
+
*/
|
|
883
|
+
function previousRunWarning(file, resumed) {
|
|
884
|
+
try {
|
|
885
|
+
const events = readStatusEvents(file);
|
|
886
|
+
const runs = fold(events);
|
|
887
|
+
const at = runs.length - (resumed ? 2 : 1);
|
|
888
|
+
const prev = runs[at];
|
|
889
|
+
if (prev === undefined)
|
|
890
|
+
return null;
|
|
891
|
+
const number = runs.slice(0, at + 1).filter((r) => r.workflow === prev.workflow).length;
|
|
892
|
+
const own = runRowsOf(file, prev.workflow, number - 1);
|
|
893
|
+
const { verdict } = readCompleteness(own, contractOf(prev.workflow, path.dirname(file)));
|
|
894
|
+
if (!verdict.holey)
|
|
895
|
+
return null;
|
|
896
|
+
const closed = own.filter((e) => e.type === "workflow-done").at(-1)?.["at"] ?? "never";
|
|
897
|
+
return (`[bkit-workflows] previous run (${prev.workflow} run ${number}, closed ${closed}) was incomplete: ` +
|
|
898
|
+
`${verdict.evidenceHoles.length} evidence hole(s), ${verdict.stepHoles.length} step hole(s); ` +
|
|
899
|
+
`see: bkit completeness check --workflow=${prev.workflow} --file=${path.relative(process.cwd(), file) || file}`);
|
|
900
|
+
}
|
|
901
|
+
catch {
|
|
902
|
+
// Advisory: an unreadable run or checker failure degrades to no warning.
|
|
903
|
+
return null;
|
|
904
|
+
}
|
|
905
|
+
}
|
|
819
906
|
/** Markdown link per feature doc and per log of this workflow, as on `ref`. */
|
|
820
907
|
export function artifactLinks(root, ref, month, fid, workflow, ownerRepo) {
|
|
821
908
|
const list = (dir) => (git(root, ["ls-tree", "-r", "--name-only", ref, "--", dir]) ?? "").split("\n").filter(Boolean);
|
|
@@ -846,6 +933,19 @@ function closeComment(cwd, outbox, o) {
|
|
|
846
933
|
sections,
|
|
847
934
|
});
|
|
848
935
|
}
|
|
936
|
+
/** `--ending` / `--publish` of the close verb, validated. */
|
|
937
|
+
function closeEnding(f) {
|
|
938
|
+
const ending = str(f.ending);
|
|
939
|
+
if (ending !== undefined && ending !== "done" && ending !== "held")
|
|
940
|
+
throw new CommandError(EXIT.USAGE, `--ending must be done or held, got ${ending}`);
|
|
941
|
+
const publish = str(f.publish);
|
|
942
|
+
if (publish !== undefined && publish !== "true" && publish !== "false")
|
|
943
|
+
throw new CommandError(EXIT.USAGE, `--publish must be true or false, got ${publish}`);
|
|
944
|
+
return {
|
|
945
|
+
...(ending === undefined ? {} : { ending }),
|
|
946
|
+
...(publish === undefined ? {} : { publish: publish === "true" }),
|
|
947
|
+
};
|
|
948
|
+
}
|
|
849
949
|
/**
|
|
850
950
|
* Grade compliance, append the workflow-done row (and, with `recordStep`, the
|
|
851
951
|
* close step's row first), the counter and outcome telemetry rows, and build the
|
|
@@ -871,11 +971,22 @@ export function closeWorkflow(cwd, o, log) {
|
|
|
871
971
|
const parentSha = headSha(where.tree);
|
|
872
972
|
// Graded first, so the report below carries this run's grade.
|
|
873
973
|
const violations = gradeCompliance(where.tree, workflow, log, o.squashSha, { parentSha, step });
|
|
974
|
+
let progressLine;
|
|
874
975
|
if (o.recordStep === true) {
|
|
875
|
-
writeStepRow(where.tree, { file: where.status, workflow, step, artifacts: [], commit: "none" }, log);
|
|
976
|
+
const written = writeStepRow(where.tree, { file: where.status, workflow, step, artifacts: [], commit: "none" }, log);
|
|
977
|
+
progressLine = written.progressLine;
|
|
876
978
|
}
|
|
979
|
+
writeCompletenessRow(where.status, workflow, parentSha, log);
|
|
877
980
|
const endAt = statusTimestamp();
|
|
878
|
-
const
|
|
981
|
+
const ending = o.ending ?? "done";
|
|
982
|
+
const row = {
|
|
983
|
+
type: "workflow-done",
|
|
984
|
+
workflow,
|
|
985
|
+
at: endAt,
|
|
986
|
+
parentSha,
|
|
987
|
+
ending,
|
|
988
|
+
...(o.publish === undefined ? {} : { publish: o.publish }),
|
|
989
|
+
};
|
|
879
990
|
fs.appendFileSync(where.status, appendLine(row));
|
|
880
991
|
const repo = resolveRepoSlug(where.root) || "unknown/repo";
|
|
881
992
|
const started = lastOfType(events, "workflow-started", workflow);
|
|
@@ -888,7 +999,6 @@ export function closeWorkflow(cwd, o, log) {
|
|
|
888
999
|
? runLines(where.tree, `${o.squashSha}^`, o.squashSha)
|
|
889
1000
|
: runLines(where.tree, base, parentSha);
|
|
890
1001
|
const startedRows = new Set(events.filter((e) => e.type === "workflow-started" && e.workflow === workflow).map((e) => e.at)).size;
|
|
891
|
-
const logDir = path.join(where.tree, logDirRel(where.month, o.fid));
|
|
892
1002
|
const by = { workflow, step };
|
|
893
1003
|
const counterRow = {
|
|
894
1004
|
kind: "counter",
|
|
@@ -920,7 +1030,8 @@ export function closeWorkflow(cwd, o, log) {
|
|
|
920
1030
|
by,
|
|
921
1031
|
run: { parentSha, ...(o.prNumber === undefined ? {} : { pr: o.prNumber }) },
|
|
922
1032
|
time: startKnown === undefined ? null : timeBlock(startKnown, Math.max(startKnown, endMs)),
|
|
923
|
-
ending
|
|
1033
|
+
ending,
|
|
1034
|
+
...(o.publish === undefined ? {} : { publish: o.publish }),
|
|
924
1035
|
lines,
|
|
925
1036
|
...(runRowsOf.length > 0 ? { steps: stepsBlock(runRowsOf) } : {}),
|
|
926
1037
|
...(ci.length > 0 ? { ci } : {}),
|
|
@@ -928,7 +1039,7 @@ export function closeWorkflow(cwd, o, log) {
|
|
|
928
1039
|
...(plan === undefined ? {} : { plan }),
|
|
929
1040
|
...(workflow === "build"
|
|
930
1041
|
? {
|
|
931
|
-
build: buildBlock(runRowsOf,
|
|
1042
|
+
build: buildBlock(runRowsOf, planFiles(where.tree, where.month, o.fid), runDeferrals()),
|
|
932
1043
|
}
|
|
933
1044
|
: {}),
|
|
934
1045
|
...(context === undefined ? {} : { context }),
|
|
@@ -1000,6 +1111,7 @@ export function closeWorkflow(cwd, o, log) {
|
|
|
1000
1111
|
comment,
|
|
1001
1112
|
roadmapFoldNeeded: true,
|
|
1002
1113
|
featureStatus: FEATURE_STATUS[workflow],
|
|
1114
|
+
...(progressLine === undefined ? {} : { progressLine }),
|
|
1003
1115
|
};
|
|
1004
1116
|
}
|
|
1005
1117
|
/**
|
|
@@ -1039,8 +1151,8 @@ function closePr(ctx, dir, fid, subject) {
|
|
|
1039
1151
|
* checkout): the close rows there, then ONE `docs({fid}): ship DONE bkit [skip ci]`
|
|
1040
1152
|
* commit built in a throwaway origin/dev checkout carrying the run's book and
|
|
1041
1153
|
* landed on dev — a refused push publishes it through a `ship-close/{fid}` PR.
|
|
1042
|
-
*
|
|
1043
|
-
*
|
|
1154
|
+
* Once the close is on dev, the feature worktree and `branch` are removed; then
|
|
1155
|
+
* a close that landed (or opened its PR) releases the workflow lock. A close
|
|
1044
1156
|
* that did not land keeps the lock for the Failure Path.
|
|
1045
1157
|
*/
|
|
1046
1158
|
async function shipClose(ctx, o, token) {
|
|
@@ -1108,22 +1220,14 @@ async function shipClose(ctx, o, token) {
|
|
|
1108
1220
|
ctx.log(`throwaway checkout failed: ${res.stderr} — ${kept}`);
|
|
1109
1221
|
return { code: EXIT_FLUSH_FAILED, out: null };
|
|
1110
1222
|
}
|
|
1111
|
-
|
|
1112
|
-
|
|
1113
|
-
fid: o.fid,
|
|
1114
|
-
token,
|
|
1115
|
-
});
|
|
1116
|
-
if (released.removeFailed) {
|
|
1117
|
-
ctx.log("Lock removal failed");
|
|
1118
|
-
return { code: EXIT_FLUSH_FAILED, out: null };
|
|
1119
|
-
}
|
|
1120
|
-
// The book is on dev only once the close landed or its PR merged.
|
|
1223
|
+
// The book is on dev only once the close landed or its PR merged. The worktree
|
|
1224
|
+
// goes while the lock is still held, so no run of this FID resumes into it.
|
|
1121
1225
|
let worktree = null;
|
|
1122
1226
|
if (landed.via === "close-pr-open") {
|
|
1123
1227
|
ctx.log(`close PR not merged — ${kept} until it is`);
|
|
1124
1228
|
}
|
|
1125
1229
|
else {
|
|
1126
|
-
if (landed.via === "close-pr" && !
|
|
1230
|
+
if (landed.via === "close-pr" && !fetchDev(root).ok)
|
|
1127
1231
|
ctx.log(`fetch of dev after the close PR failed — origin/${DEV} is stale until the next fetch`);
|
|
1128
1232
|
try {
|
|
1129
1233
|
worktree = removeWorktree(root, o.fid, o.branch, ctx.log);
|
|
@@ -1132,6 +1236,15 @@ async function shipClose(ctx, o, token) {
|
|
|
1132
1236
|
ctx.log(`${err.message} — remove ${book} by hand`);
|
|
1133
1237
|
}
|
|
1134
1238
|
}
|
|
1239
|
+
const released = releaseLock(workflowLockPath(root, month, o.fid), {
|
|
1240
|
+
workflow: "ship",
|
|
1241
|
+
fid: o.fid,
|
|
1242
|
+
token,
|
|
1243
|
+
});
|
|
1244
|
+
if (released.removeFailed) {
|
|
1245
|
+
ctx.log("Lock removal failed");
|
|
1246
|
+
return { code: EXIT_FLUSH_FAILED, out: null };
|
|
1247
|
+
}
|
|
1135
1248
|
return { code: EXIT.OK, out: { ...out, landed, worktree } };
|
|
1136
1249
|
}
|
|
1137
1250
|
// ---------------------------------------------------------------------------
|
|
@@ -1252,22 +1365,30 @@ function summaryVerb(ctx) {
|
|
|
1252
1365
|
const abs = path.resolve(tree, r);
|
|
1253
1366
|
return fs.existsSync(abs) && fs.statSync(abs).isFile() ? fs.readFileSync(abs, "utf-8") : null;
|
|
1254
1367
|
};
|
|
1255
|
-
const
|
|
1256
|
-
|
|
1257
|
-
.filter((r) =>
|
|
1368
|
+
const deferralHistory = ledgerRows(path.join(tree, "docs", "deferrals.jsonl")).map((r) => normalize(r));
|
|
1369
|
+
const runDeferralKeys = new Set(deferralHistory
|
|
1370
|
+
.filter((r) => isRunsOwnRow(r, { fid, workflow, startMs }, new Set()))
|
|
1371
|
+
.map((r) => r.key));
|
|
1372
|
+
const currentDeferrals = new Map(deferralHistory.sort((a, b) => compareTs({ ts: a.ts }, { ts: b.ts })).map((r) => [r.key, r]));
|
|
1373
|
+
const deferrals = [...currentDeferrals.values()].filter((r) => runDeferralKeys.has(r.key));
|
|
1258
1374
|
const organisedPath = path.join(logDir, "design-v3-organised.md");
|
|
1259
1375
|
const organised = workflow === "design" && fs.existsSync(organisedPath)
|
|
1260
1376
|
? fs.readFileSync(organisedPath, "utf-8")
|
|
1261
1377
|
: undefined;
|
|
1262
1378
|
const prNumber = positiveInt(ctx.flags.pr, "pr");
|
|
1379
|
+
const publishFlag = str(ctx.flags.publish);
|
|
1380
|
+
if (publishFlag !== undefined && publishFlag !== "true" && publishFlag !== "false")
|
|
1381
|
+
throw new CommandError(EXIT.USAGE, `--publish must be true or false, got ${publishFlag}`);
|
|
1263
1382
|
const summary = buildSummary({
|
|
1383
|
+
root: tree,
|
|
1384
|
+
publish: publishFlag === undefined ? undefined : publishFlag === "true",
|
|
1264
1385
|
workflow: workflow,
|
|
1265
1386
|
fid,
|
|
1266
1387
|
ref: refOf(fid, readIssueTracker(tree)),
|
|
1267
1388
|
rows,
|
|
1268
1389
|
plans: plans.map((p) => ({ path: rel(p), text: fs.readFileSync(p, "utf-8") })),
|
|
1269
1390
|
deferrals,
|
|
1270
|
-
deferralsAdded:
|
|
1391
|
+
deferralsAdded: deferrals.filter((r) => r.status !== "CLOSED").length,
|
|
1271
1392
|
decisionFiles: (workflow === "build" || workflow === "ship") && fs.existsSync(logDir)
|
|
1272
1393
|
? fs
|
|
1273
1394
|
.readdirSync(logDir)
|
|
@@ -1277,6 +1398,7 @@ function summaryVerb(ctx) {
|
|
|
1277
1398
|
: [],
|
|
1278
1399
|
read,
|
|
1279
1400
|
workstreams: organised === undefined ? undefined : parseWorkstreams(organised),
|
|
1401
|
+
suggestedPlans: organised === undefined ? undefined : parsePlans(organised),
|
|
1280
1402
|
organised,
|
|
1281
1403
|
pr: workflow === "ship" && prNumber !== undefined
|
|
1282
1404
|
? prSize(ctx.cwd, prNumber, ctx.log)
|
|
@@ -1541,6 +1663,7 @@ export const workflowsCommand = {
|
|
|
1541
1663
|
verbs: {
|
|
1542
1664
|
start: {
|
|
1543
1665
|
summary: "Take the feature lock and open a run (workflow-started unless resuming).",
|
|
1666
|
+
use: "workflow",
|
|
1544
1667
|
flags: [
|
|
1545
1668
|
WORKFLOW_FLAG,
|
|
1546
1669
|
FID_FLAG,
|
|
@@ -1562,7 +1685,7 @@ export const workflowsCommand = {
|
|
|
1562
1685
|
lock: "{path, month, token, reclaimed} of the lock taken, or {path} with --lock-held",
|
|
1563
1686
|
file: "absolute path to status.jsonl",
|
|
1564
1687
|
resumed: "the latest run was this workflow, IN_PROGRESS: no new row",
|
|
1565
|
-
row: "the appended workflow-started row, or null when resuming",
|
|
1688
|
+
row: "the appended workflow-started row, with `limits` (the workflow's ask points from bkit.workflows, frozen for the run), or null when resuming",
|
|
1566
1689
|
run: "which run of the workflow this is (1-based)",
|
|
1567
1690
|
lastDoneStep: "the current run's last DONE step: resume after it (null on a new run)",
|
|
1568
1691
|
openDecision: "{file, decision, question, from, pauseStep, group, verifyAttempt, testAttempt, plan} of the current run's highest {workflow}-decision-{run}-{N}.md holding Status: OPEN, else null",
|
|
@@ -1625,15 +1748,21 @@ export const workflowsCommand = {
|
|
|
1625
1748
|
ctx.log(`cleared stale ${name}`);
|
|
1626
1749
|
}
|
|
1627
1750
|
}
|
|
1628
|
-
const
|
|
1629
|
-
const
|
|
1751
|
+
const resumed = lastRun(fold(readStatusEvents(file)), workflow)?.status === "IN_PROGRESS";
|
|
1752
|
+
const holeyWarning = previousRunWarning(file, resumed);
|
|
1753
|
+
if (holeyWarning !== null)
|
|
1754
|
+
ctx.log(holeyWarning);
|
|
1630
1755
|
let row = null;
|
|
1631
1756
|
if (!resumed) {
|
|
1757
|
+
// The run's limits, frozen here: `counters route` reads them for the whole run.
|
|
1758
|
+
const asks = readBkitConfig(where.tree).asks;
|
|
1759
|
+
const limits = Object.fromEntries(ASK_POINTS.filter((p) => p.startsWith(`${workflow}.`)).map((p) => [p, asks[p]]));
|
|
1632
1760
|
row = {
|
|
1633
1761
|
type: "workflow-started",
|
|
1634
1762
|
workflow,
|
|
1635
1763
|
at: statusTimestamp(),
|
|
1636
1764
|
parentSha: headSha(path.dirname(file)),
|
|
1765
|
+
...(Object.keys(limits).length === 0 ? {} : { limits }),
|
|
1637
1766
|
};
|
|
1638
1767
|
fs.appendFileSync(file, appendLine(row));
|
|
1639
1768
|
}
|
|
@@ -1657,6 +1786,7 @@ export const workflowsCommand = {
|
|
|
1657
1786
|
},
|
|
1658
1787
|
fail: {
|
|
1659
1788
|
summary: "Failure Path: workflow-failed row, abort rebase, release lock, clear sentinels (with --token); the bkit:failed labels and the failure comment.",
|
|
1789
|
+
use: "workflow",
|
|
1660
1790
|
flags: [
|
|
1661
1791
|
WORKFLOW_FLAG,
|
|
1662
1792
|
{ ...FID_FLAG, required: false, help: "feature id (needed with --token)" },
|
|
@@ -1713,7 +1843,7 @@ export const workflowsCommand = {
|
|
|
1713
1843
|
],
|
|
1714
1844
|
output: {
|
|
1715
1845
|
row: "the appended workflow-failed row, or null (no --token, or no status.jsonl)",
|
|
1716
|
-
rebaseAborted: "an in-progress rebase was found and aborted",
|
|
1846
|
+
rebaseAborted: "an in-progress rebase or merge was found and aborted",
|
|
1717
1847
|
lock: "{path, existed, released, heldBy}: heldBy is another owner's lock line, left in place; null without --token",
|
|
1718
1848
|
sentinels: "[{name, path}] sentinels that existed before this call removed them",
|
|
1719
1849
|
handoverNeeded: "--max-exceeded, a sentinel existed, or a debug run in SOAK mode: write the abort handover",
|
|
@@ -1736,6 +1866,7 @@ export const workflowsCommand = {
|
|
|
1736
1866
|
},
|
|
1737
1867
|
handover: {
|
|
1738
1868
|
summary: "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.",
|
|
1869
|
+
use: "workflow",
|
|
1739
1870
|
flags: [
|
|
1740
1871
|
WORKFLOW_FLAG,
|
|
1741
1872
|
FID_FLAG,
|
|
@@ -1791,6 +1922,7 @@ export const workflowsCommand = {
|
|
|
1791
1922
|
},
|
|
1792
1923
|
close: {
|
|
1793
1924
|
summary: "Grade compliance, workflow-done row, counter + outcome telemetry, report, artifact links; --flush lands ship's close on dev.",
|
|
1925
|
+
use: "workflow",
|
|
1794
1926
|
flags: [
|
|
1795
1927
|
WORKFLOW_FLAG,
|
|
1796
1928
|
FID_FLAG,
|
|
@@ -1840,6 +1972,16 @@ export const workflowsCommand = {
|
|
|
1840
1972
|
},
|
|
1841
1973
|
...COMMENT_FLAGS,
|
|
1842
1974
|
{ name: "tree", type: "string", help: "the close comment links the tree of this ref" },
|
|
1975
|
+
{
|
|
1976
|
+
name: "ending",
|
|
1977
|
+
type: "string",
|
|
1978
|
+
help: "done|held (default done); held = a local build that published nothing",
|
|
1979
|
+
},
|
|
1980
|
+
{
|
|
1981
|
+
name: "publish",
|
|
1982
|
+
type: "string",
|
|
1983
|
+
help: "build: true|false, the resolved publish value; recorded on the workflow-done and outcome rows",
|
|
1984
|
+
},
|
|
1843
1985
|
{
|
|
1844
1986
|
name: "flush",
|
|
1845
1987
|
type: "boolean",
|
|
@@ -1902,6 +2044,7 @@ export const workflowsCommand = {
|
|
|
1902
2044
|
tracker: TRACKER_OUTPUT,
|
|
1903
2045
|
roadmapFoldNeeded: "always true: append the feature row and re-render the board (not run here)",
|
|
1904
2046
|
featureStatus: "roadmap status this close moves the feature to",
|
|
2047
|
+
progressLine: "--record-step: the exact chat progress line after a numbered completion is recorded",
|
|
1905
2048
|
landed: "--flush: {ref, via: head-push | close-pr | close-pr-open}",
|
|
1906
2049
|
worktree: "--flush: the `bkit worktrees remove` result once the close is on dev; null while the close PR is unmerged or the removal failed",
|
|
1907
2050
|
sessionRemoved: SESSION_REMOVED_OUTPUT,
|
|
@@ -1935,6 +2078,7 @@ export const workflowsCommand = {
|
|
|
1935
2078
|
number: str(f.number),
|
|
1936
2079
|
title: str(f.title),
|
|
1937
2080
|
tree: str(f.tree),
|
|
2081
|
+
...closeEnding(f),
|
|
1938
2082
|
};
|
|
1939
2083
|
const finalParts = finalReturnParts(ctx, input.fid);
|
|
1940
2084
|
if (f.flush === true) {
|
|
@@ -1959,6 +2103,7 @@ export const workflowsCommand = {
|
|
|
1959
2103
|
},
|
|
1960
2104
|
input: {
|
|
1961
2105
|
summary: "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.",
|
|
2106
|
+
use: "workflow",
|
|
1962
2107
|
flags: [
|
|
1963
2108
|
WORKFLOW_FLAG,
|
|
1964
2109
|
FID_FLAG,
|
|
@@ -2006,6 +2151,7 @@ export const workflowsCommand = {
|
|
|
2006
2151
|
},
|
|
2007
2152
|
promote: {
|
|
2008
2153
|
summary: "Design / plan close: the highest versioned draft becomes the canonical doc (anchor stamped, a changed canonical archived).",
|
|
2154
|
+
use: "workflow",
|
|
2009
2155
|
flags: [
|
|
2010
2156
|
{ ...WORKFLOW_FLAG, help: "design | plan" },
|
|
2011
2157
|
FID_FLAG,
|
|
@@ -2035,6 +2181,7 @@ export const workflowsCommand = {
|
|
|
2035
2181
|
},
|
|
2036
2182
|
links: {
|
|
2037
2183
|
summary: "The feature's docs and this workflow's logs on a ref as markdown links; optionally the close comment.",
|
|
2184
|
+
use: "workflow",
|
|
2038
2185
|
flags: [
|
|
2039
2186
|
WORKFLOW_FLAG,
|
|
2040
2187
|
FID_FLAG,
|
|
@@ -2091,6 +2238,7 @@ export const workflowsCommand = {
|
|
|
2091
2238
|
},
|
|
2092
2239
|
summary: {
|
|
2093
2240
|
summary: "The Summary step: write {workflow}-summary.md next to --file with the run's verdict, reasons and next command.",
|
|
2241
|
+
use: "workflow",
|
|
2094
2242
|
flags: [
|
|
2095
2243
|
{ ...WORKFLOW_FLAG, help: "plan | design | build | debug | ship" },
|
|
2096
2244
|
{
|
|
@@ -2110,6 +2258,11 @@ export const workflowsCommand = {
|
|
|
2110
2258
|
type: "string",
|
|
2111
2259
|
help: "ship: the PR number; its size comes from gh pr view (left out when gh cannot answer)",
|
|
2112
2260
|
},
|
|
2261
|
+
{
|
|
2262
|
+
name: "publish",
|
|
2263
|
+
type: "string",
|
|
2264
|
+
help: "build: true|false, the resolved ending; false writes `Publish: held` and `Docs: not synced` (default true)",
|
|
2265
|
+
},
|
|
2113
2266
|
],
|
|
2114
2267
|
output: {
|
|
2115
2268
|
verdict: "PASS | CONCERNS | FAIL",
|