@cbartens/bkit 5.5.1 → 6.1.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.bkit/README.md +167 -154
- package/.bkit/core/.agents/context.md +95 -29
- package/.bkit/core/.agents/docs.md +18 -15
- package/.bkit/core/.agents/plugins/bkit/hooks/bkit-gateguard.cjs +1 -0
- package/.bkit/core/.agents/plugins/bkit/hooks/bkit-guardrails.cjs +6 -5
- package/.bkit/core/.agents/plugins/bkit/hooks/bkit-readguard.cjs +1 -0
- package/.bkit/core/.agents/plugins/bkit/hooks/bkit-rules.cjs +65 -0
- package/.bkit/core/.agents/rules.md +112 -102
- package/.bkit/core/.agents/skills.md +63 -15
- package/.bkit/core/.bkit/README.md +167 -154
- package/.bkit/core/.bkit/authoring.md +747 -0
- package/.bkit/core/.bkit/cli.md +407 -0
- package/.bkit/core/.bkit/cloud.md +283 -195
- package/.bkit/core/.bkit/comparison.md +45 -43
- package/.bkit/core/.bkit/install.md +166 -95
- package/.bkit/core/.bkit/jsonl.md +339 -196
- package/.bkit/core/.bkit/pipeline.md +142 -145
- package/.bkit/core/.bkit/prompts.md +295 -264
- package/.bkit/core/.bkit/providers.md +460 -277
- package/.bkit/core/.bkit/router.md +69 -0
- package/.bkit/core/.bkit/templates.md +530 -256
- package/.bkit/core/.bkit/trackers.md +116 -65
- package/.bkit/core/.bkit/workflows.md +742 -618
- package/.bkit/core/.claude/hooks/bkit-gateguard.cjs +2 -2
- package/.bkit/core/.claude/hooks/bkit-guardrails.cjs +3 -3
- package/.bkit/core/.claude/hooks/bkit-preflight.sh +45 -14
- package/.bkit/core/.codex/hooks/bkit-guardrails.cjs +3 -3
- package/.bkit/core/.codex/hooks/bkit-rules.cjs +57 -0
- package/.bkit/core/.cursor/hooks/bkit-guardrails.cjs +7 -7
- package/.bkit/core/.cursor/hooks/bkit-preflight.sh +47 -12
- package/.bkit/core/.opencode/plugin/bkit-rules.js +89 -0
- package/.bkit/core/AGENTS.md +6 -80
- package/.bkit/core/docs/templates/bkit-audit-accessibility.md +128 -130
- package/.bkit/core/docs/templates/bkit-audit-adoption.md +104 -94
- package/.bkit/core/docs/templates/bkit-audit-agents.md +96 -98
- package/.bkit/core/docs/templates/bkit-audit-aio-seo.md +100 -103
- package/.bkit/core/docs/templates/bkit-audit-analytics.md +141 -107
- package/.bkit/core/docs/templates/bkit-audit-annotations.md +99 -97
- package/.bkit/core/docs/templates/bkit-audit-app-performance.md +122 -121
- package/.bkit/core/docs/templates/bkit-audit-app-store.md +158 -101
- package/.bkit/core/docs/templates/bkit-audit-architecture.md +114 -96
- package/.bkit/core/docs/templates/bkit-audit-ci-performance.md +76 -97
- package/.bkit/core/docs/templates/bkit-audit-config.md +123 -101
- package/.bkit/core/docs/templates/bkit-audit-cost.md +86 -99
- package/.bkit/core/docs/templates/bkit-audit-coverage.md +76 -93
- package/.bkit/core/docs/templates/bkit-audit-database.md +102 -95
- package/.bkit/core/docs/templates/bkit-audit-dead-code.md +165 -108
- package/.bkit/core/docs/templates/bkit-audit-deferrals.md +115 -109
- package/.bkit/core/docs/templates/bkit-audit-dependencies.md +265 -113
- package/.bkit/core/docs/templates/bkit-audit-documentation.md +119 -118
- package/.bkit/core/docs/templates/bkit-audit-duplication.md +140 -111
- package/.bkit/core/docs/templates/bkit-audit-failures.md +111 -106
- package/.bkit/core/docs/templates/bkit-audit-flakes.md +100 -99
- package/.bkit/core/docs/templates/bkit-audit-gates.md +107 -103
- package/.bkit/core/docs/templates/bkit-audit-issues.md +105 -105
- package/.bkit/core/docs/templates/bkit-audit-llm.md +134 -85
- package/.bkit/core/docs/templates/bkit-audit-logs.md +124 -125
- package/.bkit/core/docs/templates/bkit-audit-models.md +99 -78
- package/.bkit/core/docs/templates/bkit-audit-privacy.md +56 -76
- package/.bkit/core/docs/templates/bkit-audit-prompts.md +63 -78
- package/.bkit/core/docs/templates/bkit-audit-red-team.md +125 -93
- package/.bkit/core/docs/templates/bkit-audit-reliability.md +97 -96
- package/.bkit/core/docs/templates/bkit-audit-repo.md +170 -98
- package/.bkit/core/docs/templates/bkit-audit-security.md +207 -121
- package/.bkit/core/docs/templates/bkit-audit-slop.md +78 -95
- package/.bkit/core/docs/templates/bkit-audit-testing.md +163 -139
- package/.bkit/core/docs/templates/bkit-audit-usability.md +114 -96
- package/.bkit/core/docs/templates/bkit-plan.md +158 -281
- package/.bkit/core/engine/checks/after/auth.ts +40 -37
- package/.bkit/core/engine/checks/after/ci-yml.ts +104 -31
- package/.bkit/core/engine/checks/after/github.ts +95 -17
- package/.bkit/core/engine/checks/after/index.ts +21 -8
- package/.bkit/core/engine/checks/after/suppression.ts +8 -5
- package/.bkit/core/engine/checks/after/tools.ts +125 -123
- package/.bkit/core/engine/checks/before/context-fetch.ts +227 -33
- package/.bkit/core/engine/checks/before/env.ts +3 -3
- package/.bkit/core/engine/checks/before/files.ts +5 -4
- package/.bkit/core/engine/checks/before/index.ts +25 -1
- package/.bkit/core/engine/checks/before/repo.ts +208 -2
- package/.bkit/core/engine/checks/status-holes.ts +916 -123
- package/.bkit/core/engine/checks/tips/catalogue.ts +82 -20
- package/.bkit/core/engine/checks/tips/detect.ts +66 -0
- package/.bkit/core/engine/checks/tips/index.ts +52 -11
- package/.bkit/core/engine/cli.ts +251 -130
- package/.bkit/core/engine/commands/analysis.ts +282 -199
- package/.bkit/core/engine/commands/ci/ci.ts +363 -29
- package/.bkit/core/engine/commands/ci/pins.ts +172 -0
- package/.bkit/core/engine/commands/ci/push-gate.ts +223 -0
- package/.bkit/core/engine/commands/comply.ts +77 -103
- package/.bkit/core/engine/commands/install/doctor.ts +2 -2
- package/.bkit/core/engine/commands/install/install.ts +57 -18
- package/.bkit/core/engine/commands/install/uninstall.ts +86 -55
- package/.bkit/core/engine/commands/install/upgrade.ts +32 -15
- package/.bkit/core/engine/commands/land.ts +139 -18
- package/.bkit/core/engine/commands/lib.ts +381 -22
- package/.bkit/core/engine/commands/registry.ts +10 -2
- package/.bkit/core/engine/commands/setup/setup.ts +8 -7
- package/.bkit/core/engine/commands/stats.ts +260 -0
- package/.bkit/core/engine/commands/tips.ts +10 -5
- package/.bkit/core/engine/commands/workflow/branches.ts +2215 -176
- package/.bkit/core/engine/commands/workflow/challenge.ts +748 -0
- package/.bkit/core/engine/commands/workflow/completeness.ts +109 -0
- package/.bkit/core/engine/commands/workflow/context.ts +1249 -47
- package/.bkit/core/engine/commands/workflow/counters.ts +483 -95
- package/.bkit/core/engine/commands/workflow/decisions.ts +585 -0
- package/.bkit/core/engine/commands/workflow/disk.ts +238 -56
- package/.bkit/core/engine/commands/workflow/fids.ts +811 -33
- package/.bkit/core/engine/commands/workflow/issues.ts +413 -64
- package/.bkit/core/engine/commands/workflow/ledgers.ts +1333 -36
- package/.bkit/core/engine/commands/workflow/locks.ts +28 -2
- package/.bkit/core/engine/commands/workflow/plan-blocks.ts +691 -0
- package/.bkit/core/engine/commands/workflow/plan-versions.ts +21 -0
- package/.bkit/core/engine/commands/workflow/plans.ts +257 -0
- package/.bkit/core/engine/commands/workflow/prs.ts +178 -33
- package/.bkit/core/engine/commands/workflow/repo.ts +66 -8
- package/.bkit/core/engine/commands/workflow/roadmap.ts +72 -22
- package/.bkit/core/engine/commands/workflow/run-facts.ts +492 -0
- package/.bkit/core/engine/commands/workflow/runs.ts +827 -79
- package/.bkit/core/engine/commands/workflow/runtime.ts +25 -1
- package/.bkit/core/engine/commands/workflow/skills.ts +1 -0
- package/.bkit/core/engine/commands/workflow/status.ts +329 -33
- package/.bkit/core/engine/commands/workflow/step-table.ts +381 -0
- package/.bkit/core/engine/commands/workflow/steps.ts +841 -105
- package/.bkit/core/engine/commands/workflow/summary-findings.ts +177 -0
- package/.bkit/core/engine/commands/workflow/summary.ts +544 -0
- package/.bkit/core/engine/commands/workflow/tasks.ts +409 -0
- package/.bkit/core/engine/commands/workflow/test-blocks.ts +254 -0
- package/.bkit/core/engine/commands/workflow/tests-changed.ts +201 -0
- package/.bkit/core/engine/commands/workflow/tests.ts +2124 -330
- package/.bkit/core/engine/commands/workflow/tracker.ts +1195 -0
- package/.bkit/core/engine/commands/workflow/workflows.ts +1197 -235
- package/.bkit/core/engine/commands/workflow/worktrees.ts +543 -24
- package/.bkit/core/engine/install/cloud-env.ts +251 -121
- package/.bkit/core/engine/install/context-ci-workflow.ts +102 -0
- package/.bkit/core/engine/install/manifest.ts +67 -17
- package/.bkit/core/engine/install/modules/antigravity.ts +3 -2
- package/.bkit/core/engine/install/modules/cloud.ts +24 -16
- package/.bkit/core/engine/install/modules/codex.ts +15 -2
- package/.bkit/core/engine/install/modules/core.ts +1196 -45
- package/.bkit/core/engine/install/modules/cursor.ts +6 -6
- package/.bkit/core/engine/install/modules/opencode.ts +18 -6
- package/.bkit/core/engine/install/template-notes.ts +130 -0
- package/.bkit/core/engine/install/version-file.ts +9 -4
- package/.bkit/core/engine/install/write.ts +5 -0
- package/.bkit/core/engine/ledgers/compact.ts +124 -0
- package/.bkit/core/engine/ledgers/journal.ts +291 -0
- package/.bkit/core/engine/ledgers/migrate.ts +92 -0
- package/.bkit/core/engine/ledgers/status.ts +249 -21
- package/.bkit/core/engine/ledgers/telemetry.ts +1397 -253
- package/.bkit/core/engine/render/hosts.ts +118 -14
- package/.bkit/core/engine/render/models.ts +12 -0
- package/.bkit/core/engine/shared/bkit-latest.ts +26 -4
- package/.bkit/core/engine/shared/branches.ts +4 -1
- package/.bkit/core/engine/shared/dep-updater.ts +60 -0
- package/.bkit/core/engine/shared/egress.ts +8 -1
- package/.bkit/core/engine/shared/json.ts +25 -7
- package/.bkit/core/engine/shared/package-manager.ts +9 -0
- package/.bkit/core/engine/shared/settings.ts +243 -31
- package/.bkit/core/engine/shared/text.ts +361 -0
- package/.bkit/core/engine/shared/timeouts.ts +2 -0
- package/.bkit/core/engine/tools/cli-doc.ts +111 -0
- package/.bkit/core/engine/tools/grammar-density.ts +215 -0
- package/.bkit/core/engine/tools/instructions-sources.ts +832 -0
- package/.bkit/core/engine/tools/instructions.ts +1802 -0
- package/.bkit/core/hooks/antigravity-hook.js +25 -10
- package/.bkit/core/hooks/gateguard-engine.js +54 -29
- package/.bkit/core/hooks/guardrails-shell.js +4 -5
- package/.bkit/core/hooks/guardrails-tiers.js +10 -4
- package/.bkit/core/hooks/preflight-linear.sh +9 -9
- package/.bkit/core/hooks/preflight-rules.sh +8 -0
- package/.bkit/core/hooks/readguard-engine.js +29 -10
- package/.bkit/core/hooks/session-rules-advisory.js +61 -0
- package/.bkit/core/prompts/bkit-audit-generate.md +202 -94
- package/.bkit/core/prompts/bkit-build-challenge-1.md +76 -34
- package/.bkit/core/prompts/bkit-build-challenge-2.md +85 -38
- package/.bkit/core/prompts/bkit-build-install-skills.md +50 -28
- package/.bkit/core/prompts/bkit-build-plan-convert.md +85 -0
- package/.bkit/core/prompts/bkit-build-plan-current.md +59 -36
- package/.bkit/core/prompts/bkit-build-plan-gaps-remediate.md +101 -36
- package/.bkit/core/prompts/bkit-build-plan-tasks.md +149 -0
- package/.bkit/core/prompts/bkit-build-plan-tests.md +120 -0
- package/.bkit/core/prompts/bkit-build-plan-verify.md +104 -43
- package/.bkit/core/prompts/bkit-debug-abort-handover.md +47 -32
- package/.bkit/core/prompts/bkit-debug-failure-diagnose.md +109 -57
- package/.bkit/core/prompts/bkit-debug-failure-remediate.md +65 -39
- package/.bkit/core/prompts/bkit-debug-failure-reproduce.md +53 -31
- package/.bkit/core/prompts/bkit-debug-failure-soak.md +65 -34
- package/.bkit/core/prompts/bkit-design-brainstorm-ideate-1.md +46 -31
- package/.bkit/core/prompts/bkit-design-brainstorm-ideate-2.md +45 -31
- package/.bkit/core/prompts/bkit-design-brainstorm-ideate-3.md +43 -30
- package/.bkit/core/prompts/bkit-design-generate.md +80 -46
- package/.bkit/core/prompts/bkit-design-organise.md +83 -32
- package/.bkit/core/prompts/bkit-design-review-1.md +70 -50
- package/.bkit/core/prompts/bkit-design-review-2.md +65 -46
- package/.bkit/core/prompts/bkit-design-spike.md +64 -40
- package/.bkit/core/prompts/bkit-design-update.md +53 -28
- package/.bkit/core/prompts/bkit-plan-generate.md +101 -29
- package/.bkit/core/prompts/bkit-plan-review-1.md +78 -41
- package/.bkit/core/prompts/bkit-plan-review-2.md +78 -35
- package/.bkit/core/prompts/bkit-plan-scope-check.md +116 -0
- package/.bkit/core/prompts/bkit-plan-update.md +86 -31
- package/.bkit/core/prompts/bkit-ship-conflict-resolve.md +94 -50
- package/.bkit/core/prompts/bkit-ship-deferred-sweep.md +91 -41
- package/.bkit/core/prompts/bkit-ship-update-docs.md +45 -24
- package/.bkit/core/prompts/bkit-utility-compress-markdown.md +65 -49
- package/.bkit/core/prompts/bkit-utility-update-decisions.md +87 -42
- package/.bkit/core/prompts/bkit-utility-update-deferrals.md +81 -37
- package/.bkit/core/prompts/bkit-utility-update-documentation.md +43 -25
- package/.bkit/core/prompts/bkit-utility-update-failures.md +84 -37
- package/.bkit/core/prompts/bkit-utility-update-knowledge.md +88 -42
- package/.bkit/core/prompts/bkit-utility-update-roadmap.md +92 -39
- package/.bkit/core/prompts/bkit-utility-update-tracker.md +159 -60
- package/.bkit/core/workflows/bkit-auto.md +89 -58
- package/.bkit/core/workflows/bkit-build.md +967 -517
- package/.bkit/core/workflows/bkit-debug.md +555 -387
- package/.bkit/core/workflows/bkit-design.md +319 -283
- package/.bkit/core/workflows/bkit-plan.md +319 -342
- package/.bkit/core/workflows/bkit-ship.md +525 -328
- package/.bkit/shared/.agents/plugins/bkit/hooks.json +10 -0
- package/.bkit/shared/.bkit/.env.example +2 -2
- package/.bkit/shared/.claude/bkit-cloud.md +12 -10
- package/.bkit/shared/.claude/settings.json +14 -0
- package/.bkit/shared/.codex/bkit-cloud.md +98 -0
- package/.bkit/shared/.codex/hooks.json +20 -0
- package/.bkit/shared/.cursor/bkit-cloud.md +3 -3
- package/.bkit/shared/.cursor/mcp.json +1 -1
- package/.bkit/shared/.cursor/rules/bkit-rules.mdc +1 -1
- package/.bkit/shared/.gitattributes +1 -1
- package/.bkit/shared/.mcp.json +1 -1
- package/.bkit/shared/.opencode/opencode.json +12 -1
- package/.bkit/shared/CLAUDE.md +6 -2
- package/.bkit/shared/GEMINI.md +5 -2
- package/.bkit/shared/docs/architecture.md +4 -7
- package/.bkit/shared/docs/data-schema.md +4 -7
- package/.bkit/shared/docs/deployments.md +241 -168
- package/.bkit/shared/docs/design.md +11 -12
- package/.bkit/shared/docs/noise.md +8 -7
- package/.bkit/shared/docs/observability.md +5 -8
- package/.bkit/shared/docs/security.md +35 -17
- package/.bkit/shared/docs/setup.md +29 -18
- package/.bkit/shared/docs/technology.md +3 -6
- package/.bkit/shared/docs/testing.md +289 -174
- package/.bkit/shared/gitignore +6 -2
- package/.bkit/templates/.claude/hooks/bkit-cloud-bootstrap.sh +15 -16
- package/.bkit/templates/.cursor/Dockerfile +12 -8
- package/.bkit/templates/.cursor/environment.json +1 -1
- package/.bkit/templates/.github/ISSUE_TEMPLATE/bkit-bug.yml +10 -8
- package/.bkit/templates/.github/ISSUE_TEMPLATE/bkit-change.yml +45 -12
- package/.bkit/templates/.github/ISSUE_TEMPLATE/bkit-idea.yml +3 -3
- package/.bkit/templates/.github/renovate.json5 +34 -6
- package/.bkit/templates/.github/workflows/bkit-ci.yml +54 -51
- package/.bkit/templates/.github/workflows/bkit-cloud.yml +34 -33
- package/.bkit/templates/.github/workflows/bkit-health.yml +97 -0
- package/.bkit/templates/.github/workflows/bkit-renovate.yml +5 -4
- package/.bkit/templates/.github/workflows/bkit-trivy.yml +5 -4
- package/.bkit/templates/.husky/pre-commit +2 -2
- package/.bkit/templates/.husky/pre-push +96 -36
- package/.bkit/templates/.prettierignore +6 -0
- package/.bkit/templates/.vale.ini +27 -27
- package/.bkit/templates/context/bkit-cloudrun.md +23 -15
- package/.bkit/templates/context/bkit-expo.md +70 -52
- package/.bkit/templates/context/bkit-github.md +93 -56
- package/.bkit/templates/context/bkit-inngest.md +21 -15
- package/.bkit/templates/context/bkit-maestro.md +22 -16
- package/.bkit/templates/context/bkit-playwright.md +23 -17
- package/.bkit/templates/context/bkit-resend.md +12 -10
- package/.bkit/templates/context/bkit-sentry.md +30 -20
- package/.bkit/templates/context/bkit-serena.md +8 -7
- package/.bkit/templates/context/bkit-stripe.md +14 -13
- package/.bkit/templates/context/bkit-supabase.md +16 -13
- package/.bkit/templates/context/bkit-tavily.md +14 -11
- package/.bkit/templates/context/bkit-vercel.md +27 -18
- package/.bkit/templates/docs/capabilities.md +15 -14
- package/.bkit/templates/scripts/ci/{check-accepted-divergences.mjs → bkit-check-accepted-divergences.mjs} +6 -3
- package/.bkit/templates/scripts/ci/{check-accepted-divergences.test.mjs → bkit-check-accepted-divergences.test.mjs} +3 -3
- package/.bkit/templates/scripts/ci/{check-capstone.mjs → bkit-check-capstone.mjs} +2 -2
- package/.bkit/templates/scripts/ci/{check-capstone.test.mjs → bkit-check-capstone.test.mjs} +4 -4
- package/.bkit/templates/scripts/ci/{check-dependency-audit.mjs → bkit-check-dependency-audit.mjs} +103 -18
- package/.bkit/templates/scripts/ci/{check-dependency-audit.test.mjs → bkit-check-dependency-audit.test.mjs} +31 -3
- package/.bkit/templates/scripts/ci/bkit-machine-lock.sh +387 -0
- package/.bkit/templates/scripts/ci/bkit-test-awake.mjs +75 -0
- package/.bkit/templates/scripts/ci/bkit-test-awake.test.mjs +160 -0
- package/.bkit/templates/scripts/ci/lanes/{resolve-push-base.mjs → bkit-resolve-push-base.mjs} +3 -3
- package/.bkit/templates/scripts/ci/lanes/{resolve-push-base.test.mjs → bkit-resolve-push-base.test.mjs} +4 -4
- package/.bkit/templates/scripts/cleanup/bkit-disk-prune.mjs +10 -2
- package/.bkit/templates/scripts/graphify/bkit-graph-drift.py +1 -1
- package/.bkit/templates/scripts/graphify/bkit-graph-eager.py +3 -3
- package/.bkit/templates/scripts/graphify/bkit-graph-embed.py +63 -0
- package/.bkit/templates/scripts/graphify/bkit-graph-imports.py +2 -2
- package/.bkit/templates/scripts/graphify/bkit-graph-pre-push.sh +69 -18
- package/.bkit/templates/scripts/graphify/bkit-graph-repair.py +3 -3
- package/.bkit/templates/scripts/graphify/bkit-graph-surface.py +1 -1
- package/.bkit/templates/scripts/graphify/bkit-graphify-graphml.py +1 -1
- package/.bkit/templates/scripts/graphify/bkit-graphify-rollup.py +197 -126
- package/.bkit/templates/scripts/graphify/bkit-graphify.sh +64 -41
- package/.bkit/templates/scripts/slop/bkit-slop-type-suppression.mjs +23 -7
- package/.bkit/templates/slop-scan.config.json +9 -2
- package/CHANGELOG.md +231 -0
- package/README.md +278 -89
- package/dist/checks/after/auth.js +36 -33
- package/dist/checks/after/ci-yml.js +91 -30
- package/dist/checks/after/github.js +91 -17
- package/dist/checks/after/index.js +22 -11
- package/dist/checks/after/suppression.js +8 -5
- package/dist/checks/after/tools.js +111 -114
- package/dist/checks/before/context-fetch.js +218 -33
- package/dist/checks/before/env.js +3 -3
- package/dist/checks/before/files.js +5 -3
- package/dist/checks/before/index.js +20 -3
- package/dist/checks/before/repo.js +197 -2
- package/dist/checks/status-holes.js +739 -114
- package/dist/checks/tips/catalogue.js +70 -19
- package/dist/checks/tips/detect.js +62 -0
- package/dist/checks/tips/index.js +51 -9
- package/dist/cli.js +234 -124
- package/dist/commands/analysis.js +174 -141
- package/dist/commands/ci/ci.js +302 -25
- package/dist/commands/ci/pins.js +142 -0
- package/dist/commands/ci/push-gate.js +194 -0
- package/dist/commands/comply.js +54 -91
- package/dist/commands/install/doctor.js +2 -2
- package/dist/commands/install/install.js +50 -19
- package/dist/commands/install/uninstall.js +82 -55
- package/dist/commands/install/upgrade.js +21 -11
- package/dist/commands/land.js +137 -17
- package/dist/commands/lib.js +295 -21
- package/dist/commands/registry.js +10 -2
- package/dist/commands/setup/setup.js +8 -7
- package/dist/commands/stats.js +175 -0
- package/dist/commands/tips.js +7 -3
- package/dist/commands/workflow/branches.js +1873 -152
- package/dist/commands/workflow/challenge.js +609 -0
- package/dist/commands/workflow/completeness.js +97 -0
- package/dist/commands/workflow/context.js +1045 -46
- package/dist/commands/workflow/counters.js +385 -86
- package/dist/commands/workflow/decisions.js +484 -0
- package/dist/commands/workflow/disk.js +214 -56
- package/dist/commands/workflow/fids.js +706 -33
- package/dist/commands/workflow/issues.js +349 -59
- package/dist/commands/workflow/ledgers.js +1123 -37
- package/dist/commands/workflow/locks.js +26 -2
- package/dist/commands/workflow/plan-blocks.js +501 -0
- package/dist/commands/workflow/plan-versions.js +22 -0
- package/dist/commands/workflow/plans.js +205 -0
- package/dist/commands/workflow/prs.js +154 -35
- package/dist/commands/workflow/repo.js +58 -8
- package/dist/commands/workflow/roadmap.js +58 -23
- package/dist/commands/workflow/run-facts.js +421 -0
- package/dist/commands/workflow/runs.js +670 -72
- package/dist/commands/workflow/runtime.js +15 -1
- package/dist/commands/workflow/skills.js +1 -0
- package/dist/commands/workflow/status.js +282 -34
- package/dist/commands/workflow/step-table.js +308 -0
- package/dist/commands/workflow/steps.js +703 -96
- package/dist/commands/workflow/summary-findings.js +117 -0
- package/dist/commands/workflow/summary.js +388 -0
- package/dist/commands/workflow/tasks.js +378 -0
- package/dist/commands/workflow/test-blocks.js +231 -0
- package/dist/commands/workflow/tests-changed.js +172 -0
- package/dist/commands/workflow/tests.js +1695 -305
- package/dist/commands/workflow/tracker.js +983 -0
- package/dist/commands/workflow/workflows.js +1014 -222
- package/dist/commands/workflow/worktrees.js +432 -26
- package/dist/install/cloud-env.js +233 -99
- package/dist/install/context-ci-workflow.js +85 -0
- package/dist/install/manifest.js +64 -17
- package/dist/install/modules/antigravity.js +3 -2
- package/dist/install/modules/cloud.js +25 -16
- package/dist/install/modules/codex.js +12 -2
- package/dist/install/modules/core.js +1090 -48
- package/dist/install/modules/cursor.js +6 -6
- package/dist/install/modules/opencode.js +13 -7
- package/dist/install/template-notes.js +116 -0
- package/dist/install/version-file.js +9 -4
- package/dist/ledgers/compact.js +87 -0
- package/dist/ledgers/journal.js +233 -0
- package/dist/ledgers/migrate.js +81 -0
- package/dist/ledgers/status.js +176 -13
- package/dist/ledgers/telemetry.js +1010 -125
- package/dist/render/hosts.js +104 -14
- package/dist/render/models.js +12 -0
- package/dist/shared/bkit-latest.js +26 -4
- package/dist/shared/branches.js +3 -1
- package/dist/shared/dep-updater.js +49 -0
- package/dist/shared/egress.js +8 -1
- package/dist/shared/json.js +20 -7
- package/dist/shared/package-manager.js +6 -0
- package/dist/shared/settings.js +181 -24
- package/dist/shared/text.js +333 -0
- package/dist/shared/timeouts.js +2 -0
- package/dist/tools/cli-doc.js +97 -0
- package/dist/tools/grammar-density.js +183 -0
- package/dist/tools/instructions-sources.js +720 -0
- package/dist/tools/instructions.js +1623 -0
- package/package.json +156 -51
- package/.bkit/core/.bkit/lite.md +0 -73
- package/.bkit/core/engine/commands/harvest.ts +0 -459
- package/.bkit/core/engine/commands/workflow/workstreams.ts +0 -166
- package/.bkit/core/engine/tools/wording.ts +0 -748
- package/.bkit/core/prompts/bkit-build-challenge-reconcile.md +0 -69
- package/.bkit/core/prompts/bkit-build-challenge-remediate.md +0 -71
- package/.bkit/core/prompts/bkit-build-challenge-tests.md +0 -74
- package/.bkit/core/prompts/bkit-build-plan-execute.md +0 -76
- package/.bkit/core/prompts/bkit-build-summary.md +0 -94
- package/.bkit/core/prompts/bkit-debug-summary.md +0 -96
- package/.bkit/core/prompts/bkit-design-summary.md +0 -107
- package/.bkit/core/prompts/bkit-plan-complexity-check.md +0 -67
- package/.bkit/core/prompts/bkit-plan-complexity-split.md +0 -88
- package/.bkit/core/prompts/bkit-plan-review-3.md +0 -93
- package/.bkit/core/prompts/bkit-plan-scope-check-1.md +0 -85
- package/.bkit/core/prompts/bkit-plan-scope-check-2.md +0 -85
- package/.bkit/core/prompts/bkit-plan-summary.md +0 -107
- package/.bkit/core/prompts/bkit-ship-summary.md +0 -78
- package/.bkit/templates/scripts/ci/bkit-local-stack-lock.sh +0 -194
- package/dist/commands/harvest.js +0 -353
- package/dist/commands/workflow/workstreams.js +0 -143
- package/dist/tools/wording.js +0 -680
- /package/.bkit/templates/.vale/styles/{House → Bkit}/Filler.yml +0 -0
- /package/.bkit/templates/.vale/styles/{House → Bkit}/Hedging.yml +0 -0
- /package/.bkit/templates/.vale/styles/{House → Bkit}/LLMSlop.yml +0 -0
- /package/.bkit/templates/.vale/styles/{House → Bkit}/Verbose.yml +0 -0
- /package/.bkit/templates/scripts/ci/{accepted-advisories.json → bkit-accepted-advisories.json} +0 -0
- /package/.bkit/templates/scripts/ci/{accepted-divergences.json → bkit-accepted-divergences.json} +0 -0
- /package/.bkit/templates/scripts/launchd/{launchd.env.example → bkit-launchd.env.example} +0 -0
- /package/.bkit/templates/scripts/launchd/{ai.bkit.launchd.plist → bkit-launchd.plist} +0 -0
|
@@ -0,0 +1,205 @@
|
|
|
1
|
+
// bkit plans parse|comment — design Step 11: read the organised design's
|
|
2
|
+
// `## Suggested Workstreams` and `## Suggested Plans` and build the advisory comment
|
|
3
|
+
// for the feature's own issue.
|
|
4
|
+
//
|
|
5
|
+
// A workstream is a logical unit of the design; a plan is the filed unit (one issue,
|
|
6
|
+
// one plan doc, one branch / PR) covering one or more workstreams. Advisory only.
|
|
7
|
+
// Workflows never create tracker issues, comment on another issue, or set blockers,
|
|
8
|
+
// so nothing here matches plans to issues or builds blocked-by bodies. The tracker
|
|
9
|
+
// write itself stays an MCP call in the workflow; this prepares its body.
|
|
10
|
+
import * as fs from "node:fs";
|
|
11
|
+
import * as path from "node:path";
|
|
12
|
+
import { CommandError, EXIT } from "../lib.js";
|
|
13
|
+
import { COMMENT_FILE_OUTPUT, GENERATED_MARKER, commentFileOf, stampMarker } from "./tracker.js";
|
|
14
|
+
/** Exit code: no workstream parsed — the workflow's Failure Path. */
|
|
15
|
+
export const EXIT_NONE = 3;
|
|
16
|
+
const HEADING = /^(#{1,6})\s+(.*?)\s*$/;
|
|
17
|
+
const INLINE = /^\W*(Requires|Covers)\W*:\**\s*(.*)$/i;
|
|
18
|
+
/**
|
|
19
|
+
* Every `### {PREFIX}-{N}: {NAME}` block under the LAST `## {title}` heading (the
|
|
20
|
+
* organise step appends it after a verbatim copy of the design), with the first
|
|
21
|
+
* value line of each `####` subsection. An inline `Requires: [...]` or `Covers: [...]`
|
|
22
|
+
* line directly under the block heading is read too.
|
|
23
|
+
*/
|
|
24
|
+
function sectionBlocks(md, title, prefix) {
|
|
25
|
+
const lines = md.split("\n");
|
|
26
|
+
let start = -1;
|
|
27
|
+
lines.forEach((l, i) => {
|
|
28
|
+
if (new RegExp(`^##\\s+${title}\\s*$`).test(l))
|
|
29
|
+
start = i;
|
|
30
|
+
});
|
|
31
|
+
if (start === -1)
|
|
32
|
+
return [];
|
|
33
|
+
const blockHeading = new RegExp(`^###\\s+${prefix}-(\\d+):\\s*(.*?)\\s*$`);
|
|
34
|
+
const out = [];
|
|
35
|
+
let current;
|
|
36
|
+
/** The `####` subsection the line sits in; undefined directly under the block heading. */
|
|
37
|
+
let sub;
|
|
38
|
+
for (const line of lines.slice(start + 1)) {
|
|
39
|
+
const h = HEADING.exec(line);
|
|
40
|
+
if (h && h[1].length <= 2)
|
|
41
|
+
break;
|
|
42
|
+
const b = blockHeading.exec(line);
|
|
43
|
+
if (b) {
|
|
44
|
+
current = { n: Number(b[1]), name: b[2], fields: {} };
|
|
45
|
+
sub = undefined;
|
|
46
|
+
out.push(current);
|
|
47
|
+
continue;
|
|
48
|
+
}
|
|
49
|
+
if (!current)
|
|
50
|
+
continue;
|
|
51
|
+
if (h) {
|
|
52
|
+
sub = h[2].toLowerCase();
|
|
53
|
+
continue;
|
|
54
|
+
}
|
|
55
|
+
const inline = sub === undefined ? INLINE.exec(line) : null;
|
|
56
|
+
const key = sub ?? inline?.[1].toLowerCase();
|
|
57
|
+
const value = (sub === undefined ? inline?.[2] : line)?.trim();
|
|
58
|
+
if (key !== undefined && value && current.fields[key] === undefined)
|
|
59
|
+
current.fields[key] = value;
|
|
60
|
+
}
|
|
61
|
+
return out;
|
|
62
|
+
}
|
|
63
|
+
const ids = (text, prefix) => text.match(new RegExp(`${prefix}-\\d+`, "g")) ?? [];
|
|
64
|
+
/** Every `### WS-{N}: {NAME}` block under the last `## Suggested Workstreams`, with its `Requires`. */
|
|
65
|
+
export function parseWorkstreams(md) {
|
|
66
|
+
return sectionBlocks(md, "Suggested Workstreams", "WS").map((b) => {
|
|
67
|
+
const requiresText = b.fields.requires ?? "";
|
|
68
|
+
return {
|
|
69
|
+
id: `WS-${b.n}`,
|
|
70
|
+
n: b.n,
|
|
71
|
+
name: b.name,
|
|
72
|
+
requires: ids(requiresText, "WS"),
|
|
73
|
+
requiresText,
|
|
74
|
+
};
|
|
75
|
+
});
|
|
76
|
+
}
|
|
77
|
+
/**
|
|
78
|
+
* Every `### P-{N}: {NAME}` block under the last `## Suggested Plans`, with its
|
|
79
|
+
* `Covers` and `Requires`. A design with no plan block yields one plan per
|
|
80
|
+
* workstream: `P-{N}` covers `WS-{N}`, its `Requires` mapped to plan ids.
|
|
81
|
+
*/
|
|
82
|
+
export function parsePlans(md) {
|
|
83
|
+
const plans = sectionBlocks(md, "Suggested Plans", "P").map((b) => {
|
|
84
|
+
const requiresText = b.fields.requires ?? "";
|
|
85
|
+
return {
|
|
86
|
+
id: `P-${b.n}`,
|
|
87
|
+
n: b.n,
|
|
88
|
+
name: b.name,
|
|
89
|
+
covers: ids(b.fields.covers ?? "", "WS"),
|
|
90
|
+
requires: ids(requiresText, "P"),
|
|
91
|
+
requiresText,
|
|
92
|
+
};
|
|
93
|
+
});
|
|
94
|
+
if (plans.length > 0)
|
|
95
|
+
return plans;
|
|
96
|
+
return parseWorkstreams(md).map((w) => ({
|
|
97
|
+
id: `P-${w.n}`,
|
|
98
|
+
n: w.n,
|
|
99
|
+
name: w.name,
|
|
100
|
+
covers: [w.id],
|
|
101
|
+
requires: w.requires.map((r) => r.replace("WS-", "P-")),
|
|
102
|
+
requiresText: w.requiresText.replace(/WS-(\d+)/g, "P-$1"),
|
|
103
|
+
}));
|
|
104
|
+
}
|
|
105
|
+
/** `[]` or `[P-1, P-2]`. */
|
|
106
|
+
export const requiresList = (p) => `[${p.requires.join(", ")}]`;
|
|
107
|
+
/** `WS-1 (Data model), WS-2 (API)`: a plan's covered workstreams with their names. */
|
|
108
|
+
export function coversList(p, ws) {
|
|
109
|
+
return p.covers
|
|
110
|
+
.map((id) => {
|
|
111
|
+
const name = ws.find((w) => w.id === id)?.name;
|
|
112
|
+
return name === undefined ? id : `${id} (${name})`;
|
|
113
|
+
})
|
|
114
|
+
.join(", ");
|
|
115
|
+
}
|
|
116
|
+
/**
|
|
117
|
+
* The Step 11 comment: one line per plan with its covered workstreams, the filing
|
|
118
|
+
* line (one issue per plan; a single plan is planned on this issue), then the design
|
|
119
|
+
* doc link.
|
|
120
|
+
*/
|
|
121
|
+
export function commentBody(plans, ws, opts) {
|
|
122
|
+
const doc = `docs/plans/${opts.month}/${opts.fid}-design.md`;
|
|
123
|
+
const url = `https://github.com/${opts.ownerRepo}/blob/dev/${doc}`;
|
|
124
|
+
const filing = plans.length === 1
|
|
125
|
+
? "One plan covers every workstream: plan it on this issue, no new issue."
|
|
126
|
+
: `Filing one issue per plan: put \`**Parent design:** [${opts.fid}-design.md](${url})\` and \`**Workstreams:** {its Covers ids}\` in its body, and list the plan issues it requires in a blocked-by block (.bkit/trackers.md § Issue shapes).`;
|
|
127
|
+
const lines = [
|
|
128
|
+
GENERATED_MARKER,
|
|
129
|
+
"### Step 11 — Suggested Plans",
|
|
130
|
+
"Advisory only. NEVER auto-trigger.",
|
|
131
|
+
...plans.map((p) => `- ${p.id}: ${p.name}. Covers: ${coversList(p, ws)}. Requires: ${requiresList(p)}`),
|
|
132
|
+
filing,
|
|
133
|
+
`[${doc}](${url})`,
|
|
134
|
+
];
|
|
135
|
+
return stampMarker(lines.join("\n"));
|
|
136
|
+
}
|
|
137
|
+
const ARTIFACT_FLAG = {
|
|
138
|
+
name: "artifact",
|
|
139
|
+
type: "string",
|
|
140
|
+
required: true,
|
|
141
|
+
help: "the organised design, docs/plans/{YYYYMM}/logs/{FID}/design-v3-organised.md",
|
|
142
|
+
};
|
|
143
|
+
function read(ctx) {
|
|
144
|
+
const file = path.resolve(ctx.cwd, String(ctx.flags.artifact));
|
|
145
|
+
if (!fs.existsSync(file))
|
|
146
|
+
throw new CommandError(EXIT.USAGE, `--artifact ${file} does not exist`);
|
|
147
|
+
const md = fs.readFileSync(file, "utf-8");
|
|
148
|
+
const workstreams = parseWorkstreams(md);
|
|
149
|
+
if (workstreams.length === 0) {
|
|
150
|
+
throw new CommandError(EXIT_NONE, `no "### WS-{N}: {NAME}" block under "## Suggested Workstreams" in ${file}`);
|
|
151
|
+
}
|
|
152
|
+
return { workstreams, plans: parsePlans(md) };
|
|
153
|
+
}
|
|
154
|
+
export const plansCommand = {
|
|
155
|
+
noun: "plans",
|
|
156
|
+
summary: "Parse the organised design's suggested plans and workstreams and build the advisory comment.",
|
|
157
|
+
verbs: {
|
|
158
|
+
parse: {
|
|
159
|
+
summary: "List each P-{N} with its name, Covers and Requires; one plan per workstream when the design has no Suggested Plans.",
|
|
160
|
+
use: "by-hand",
|
|
161
|
+
flags: [ARTIFACT_FLAG],
|
|
162
|
+
output: {
|
|
163
|
+
plans: "[{id, n, name, covers, requires, requiresText}] in file order",
|
|
164
|
+
workstreams: "[{id, n, name, requires, requiresText}] in file order",
|
|
165
|
+
},
|
|
166
|
+
exitCodes: { [EXIT_NONE]: "no workstream parsed (Failure Path)" },
|
|
167
|
+
run: (ctx) => {
|
|
168
|
+
const { workstreams, plans } = read(ctx);
|
|
169
|
+
ctx.emit({ plans, workstreams });
|
|
170
|
+
return EXIT.OK;
|
|
171
|
+
},
|
|
172
|
+
},
|
|
173
|
+
comment: {
|
|
174
|
+
summary: "The Step 11 comment body for the feature's own issue (posted via MCP by the workflow).",
|
|
175
|
+
use: "workflow",
|
|
176
|
+
flags: [
|
|
177
|
+
ARTIFACT_FLAG,
|
|
178
|
+
{ name: "fid", type: "string", required: true, help: "feature id" },
|
|
179
|
+
{ name: "month", type: "string", required: true, help: "YYYYMM bucket of the design doc" },
|
|
180
|
+
{
|
|
181
|
+
name: "owner-repo",
|
|
182
|
+
type: "string",
|
|
183
|
+
required: true,
|
|
184
|
+
help: "owner/repo for the design doc link",
|
|
185
|
+
},
|
|
186
|
+
],
|
|
187
|
+
output: {
|
|
188
|
+
comment: "the comment body",
|
|
189
|
+
commentFile: COMMENT_FILE_OUTPUT,
|
|
190
|
+
plans: "the parsed plans",
|
|
191
|
+
},
|
|
192
|
+
exitCodes: { [EXIT_NONE]: "no workstream parsed (Failure Path)" },
|
|
193
|
+
run: (ctx) => {
|
|
194
|
+
const { workstreams, plans } = read(ctx);
|
|
195
|
+
const body = commentBody(plans, workstreams, {
|
|
196
|
+
ownerRepo: String(ctx.flags.ownerRepo),
|
|
197
|
+
month: String(ctx.flags.month),
|
|
198
|
+
fid: String(ctx.flags.fid),
|
|
199
|
+
});
|
|
200
|
+
ctx.emit({ comment: body, commentFile: commentFileOf(ctx.cwd, body), plans });
|
|
201
|
+
return EXIT.OK;
|
|
202
|
+
},
|
|
203
|
+
},
|
|
204
|
+
},
|
|
205
|
+
};
|
|
@@ -9,10 +9,13 @@
|
|
|
9
9
|
import * as fs from "node:fs";
|
|
10
10
|
import * as path from "node:path";
|
|
11
11
|
import { readBkitConfig } from "../../shared/settings.js";
|
|
12
|
-
import { appendLine, statusTimestamp } from "../../ledgers/status.js";
|
|
13
|
-
import { bodySkipToken, CommandError, DEV, EXIT, ghUnavailable, git, isSharedBranch, parseJson, repoRoot, runGh, runGit, SKIP_CI_TOKEN, } from "../lib.js";
|
|
12
|
+
import { actionHash, actionKey, alreadyDone, appendLine, recordAction, runNumber, statusTimestamp, } from "../../ledgers/status.js";
|
|
13
|
+
import { bodySkipToken, CommandError, DEV, EXIT, ghUnavailable, git, isSharedBranch, MAIN, parseJson, repoRoot, runGh, runGit, SKIP_CI_TOKEN, } from "../lib.js";
|
|
14
|
+
import { fidProblem } from "./fids.js";
|
|
14
15
|
import { AUTO_LABEL, AUTO_ROUTE_SUFFIX } from "./issues.js";
|
|
15
|
-
import {
|
|
16
|
+
import { resolveOwnerRepo } from "./repo.js";
|
|
17
|
+
import { writeBodyFile } from "./tracker.js";
|
|
18
|
+
import { EXIT_NO_STATUS, FILE_FLAG, readRuns, readStatusRows, statusFile, str } from "./status.js";
|
|
16
19
|
// ---------------------------------------------------------------------------
|
|
17
20
|
// gh
|
|
18
21
|
// ---------------------------------------------------------------------------
|
|
@@ -111,29 +114,19 @@ function refFlag(value, flag) {
|
|
|
111
114
|
// ---------------------------------------------------------------------------
|
|
112
115
|
// open
|
|
113
116
|
// ---------------------------------------------------------------------------
|
|
114
|
-
/**
|
|
115
|
-
|
|
116
|
-
|
|
117
|
-
|
|
118
|
-
|
|
119
|
-
none: /^[a-z0-9][a-z0-9-]*$/,
|
|
120
|
-
};
|
|
121
|
-
const ISSUE_FORMAT = {
|
|
122
|
-
github: /^[0-9]+$/,
|
|
123
|
-
linear: /^[A-Z]+-[0-9]+$/,
|
|
124
|
-
jira: /^[A-Z][A-Z0-9]+-[0-9]+$/,
|
|
125
|
-
};
|
|
126
|
-
/** The PR-body marker line for this tracker (`.bkit/trackers.md` `pr-body-marker`). */
|
|
117
|
+
/**
|
|
118
|
+
* The PR-body marker line for this tracker (`.bkit/trackers.md` `pr-body-marker`). With
|
|
119
|
+
* no issue the marker is FID-only (`<!-- bkit:fid={FID} -->`, the `none` shape) and the
|
|
120
|
+
* FID any slug; with an issue, the FID must embed that same issue id.
|
|
121
|
+
*/
|
|
127
122
|
export function prMarker(tracker, fid, issue) {
|
|
128
|
-
if (!FID_FORMAT[tracker].test(fid)) {
|
|
129
|
-
throw new CommandError(EXIT.USAGE, `--fid "${fid}" is not a ${tracker} FID slug`);
|
|
130
|
-
}
|
|
131
|
-
if (tracker === "none")
|
|
132
|
-
return `<!-- bkit:fid=${fid} -->`;
|
|
133
123
|
const id = (issue ?? "").replace(/^#/, "");
|
|
134
|
-
|
|
135
|
-
|
|
124
|
+
const problem = fidProblem(fid, tracker, id);
|
|
125
|
+
if (problem !== undefined) {
|
|
126
|
+
throw new CommandError(EXIT.USAGE, `--fid "${fid}" / --issue "${issue ?? ""}": ${problem}`);
|
|
136
127
|
}
|
|
128
|
+
if (tracker === "none" || id === "")
|
|
129
|
+
return `<!-- bkit:fid=${fid} -->`;
|
|
137
130
|
return tracker === "github"
|
|
138
131
|
? `<!-- bkit:issue=#${id} bkit:fid=${fid} -->`
|
|
139
132
|
: `<!-- bkit:issue=${id} bkit:fid=${fid} -->`;
|
|
@@ -145,10 +138,15 @@ export function prBody(marker, notes, plan) {
|
|
|
145
138
|
.join("\n")
|
|
146
139
|
.concat("\n");
|
|
147
140
|
}
|
|
141
|
+
/** The CI marker `branches force-build` puts on the PR title; `prs merge` drops it from the squash subject. */
|
|
142
|
+
export const FORCE_BUILD = "[force build]";
|
|
143
|
+
const FORCE_BUILD_TAG = / ?(bkit )?\[force build\]/g;
|
|
148
144
|
export const EXIT_PR_EXISTS = 3;
|
|
149
145
|
export const EXIT_SKIP_CI_TITLE = 4;
|
|
150
146
|
export const EXIT_GH_FAILED = 5;
|
|
151
147
|
export const EXIT_WRONG_BASE = 6;
|
|
148
|
+
/** Exit code (open): `--base=main` — bkit never opens a PR into `main`. */
|
|
149
|
+
export const EXIT_BASE_MAIN = 7;
|
|
152
150
|
/** Open (or, with `existing: "reuse"`, reuse) the PR for `head`; `code` is the verb's exit code. */
|
|
153
151
|
export function openPrFor(cwd, o, log) {
|
|
154
152
|
const tracker = readBkitConfig(repoRoot(cwd)).issueTracker;
|
|
@@ -164,6 +162,11 @@ export function openPrFor(cwd, o, log) {
|
|
|
164
162
|
return { code: EXIT_SKIP_CI_TITLE, out: null };
|
|
165
163
|
}
|
|
166
164
|
const base = refFlag(o.base ?? DEV, "base");
|
|
165
|
+
// `refs/heads/main`, `origin/main` and `heads/main` name the same branch for gh.
|
|
166
|
+
if (base.replace(/^(?:refs\/)?(?:heads\/|remotes\/)?(?:origin\/)?/, "") === MAIN) {
|
|
167
|
+
log(`refusing to open a PR into ${MAIN}: bkit opens PRs into ${DEV} only, releases stay manual`);
|
|
168
|
+
return { code: EXIT_BASE_MAIN, out: null };
|
|
169
|
+
}
|
|
167
170
|
const head = o.head === undefined ? currentBranch(cwd) : refFlag(o.head, "head");
|
|
168
171
|
if (head === base || isSharedBranch(head)) {
|
|
169
172
|
throw new CommandError(EXIT.USAGE, `refusing to open a PR from "${head}" into "${base}"`);
|
|
@@ -178,7 +181,17 @@ export function openPrFor(cwd, o, log) {
|
|
|
178
181
|
log(`${why} — create the PR through the GitHub MCP tool with this title and body`);
|
|
179
182
|
return {
|
|
180
183
|
code: EXIT.USE_MCP,
|
|
181
|
-
out: {
|
|
184
|
+
out: {
|
|
185
|
+
created: false,
|
|
186
|
+
useMcp: true,
|
|
187
|
+
number: null,
|
|
188
|
+
url: null,
|
|
189
|
+
base,
|
|
190
|
+
head,
|
|
191
|
+
title,
|
|
192
|
+
body,
|
|
193
|
+
bodyFile: writeBodyFile(cwd, "pr-body", body),
|
|
194
|
+
},
|
|
182
195
|
};
|
|
183
196
|
};
|
|
184
197
|
const existing = probePr(cwd, { head, base, state: "open" });
|
|
@@ -253,6 +266,26 @@ export function openPrFor(cwd, o, log) {
|
|
|
253
266
|
return { code: EXIT.OK, out };
|
|
254
267
|
}
|
|
255
268
|
function openPr(ctx) {
|
|
269
|
+
const fileFlag = str(ctx.flags.file);
|
|
270
|
+
const workflow = str(ctx.flags.workflow);
|
|
271
|
+
if (fileFlag !== undefined && workflow === undefined) {
|
|
272
|
+
throw new CommandError(EXIT.USAGE, "--file needs --workflow");
|
|
273
|
+
}
|
|
274
|
+
// A recorded open of this head into this base makes the PR now open on it this run's own.
|
|
275
|
+
let existing = str(ctx.flags.existing);
|
|
276
|
+
let action;
|
|
277
|
+
if (fileFlag !== undefined && workflow !== undefined) {
|
|
278
|
+
const file = path.resolve(ctx.cwd, fileFlag);
|
|
279
|
+
const head = str(ctx.flags.head) ?? currentBranch(ctx.cwd);
|
|
280
|
+
const run = fs.existsSync(file) ? runNumber(readRuns(file), workflow) : 1;
|
|
281
|
+
action = {
|
|
282
|
+
file,
|
|
283
|
+
key: actionKey(workflow, run, "pr-open"),
|
|
284
|
+
hash: actionHash(`${head}\n${str(ctx.flags.base) ?? DEV}`),
|
|
285
|
+
};
|
|
286
|
+
if (alreadyDone(action.file, action.key, action.hash))
|
|
287
|
+
existing = "reuse";
|
|
288
|
+
}
|
|
256
289
|
const r = openPrFor(ctx.cwd, {
|
|
257
290
|
fid: String(ctx.flags.fid),
|
|
258
291
|
title: String(ctx.flags.title),
|
|
@@ -261,8 +294,16 @@ function openPr(ctx) {
|
|
|
261
294
|
head: str(ctx.flags.head),
|
|
262
295
|
plan: str(ctx.flags.plan),
|
|
263
296
|
notes: ctx.flags.note ?? [],
|
|
264
|
-
existing
|
|
297
|
+
existing,
|
|
265
298
|
}, ctx.log);
|
|
299
|
+
if (action && r.code === EXIT.OK && r.out?.created === true) {
|
|
300
|
+
recordAction(action.file, {
|
|
301
|
+
action: "pr-open",
|
|
302
|
+
key: action.key,
|
|
303
|
+
hash: action.hash,
|
|
304
|
+
ref: r.out.url,
|
|
305
|
+
});
|
|
306
|
+
}
|
|
266
307
|
if (r.out)
|
|
267
308
|
ctx.emit(r.out);
|
|
268
309
|
return r.code;
|
|
@@ -272,9 +313,13 @@ function openPr(ctx) {
|
|
|
272
313
|
// ---------------------------------------------------------------------------
|
|
273
314
|
/** Exit code (merge --expect-merged): the PR did not reach MERGED. */
|
|
274
315
|
export const EXIT_NOT_MERGED = 7;
|
|
316
|
+
/** Exit code (merge): the PR's base is not `dev`, or could not be read — nothing merged. */
|
|
317
|
+
export const EXIT_BASE_NOT_DEV = 8;
|
|
275
318
|
/**
|
|
276
319
|
* Squash-merge a PR with an explicit empty body (never the default concatenated
|
|
277
|
-
* subjects), unless it is already MERGED, then read the state back.
|
|
320
|
+
* subjects), unless it is already MERGED, then read the state back. A PR whose base
|
|
321
|
+
* (read by the same `pr view` that reads its state) is not `dev`, or is unreadable, is
|
|
322
|
+
* never merged (EXIT_BASE_NOT_DEV). gh missing →
|
|
278
323
|
* EXIT.USE_MCP (merge through `merge_pull_request` with `subject`).
|
|
279
324
|
*/
|
|
280
325
|
export function mergePr(cwd, o, log) {
|
|
@@ -305,6 +350,10 @@ export function mergePr(cwd, o, log) {
|
|
|
305
350
|
}
|
|
306
351
|
if (before.pr?.state === "MERGED")
|
|
307
352
|
return result(EXIT.OK, before.pr, true);
|
|
353
|
+
if (before.pr?.baseRefName !== DEV) {
|
|
354
|
+
log(`refusing to merge PR ${o.number}: its base is ${before.pr?.baseRefName ?? "unknown"}, not ${DEV} — bkit merges into ${DEV} only, releases stay manual`);
|
|
355
|
+
return result(EXIT_BASE_NOT_DEV, before.pr, false);
|
|
356
|
+
}
|
|
308
357
|
const args = ["pr", "merge", o.number, "--squash", "--subject", o.subject, "--body", ""];
|
|
309
358
|
if (o.deleteBranch === true)
|
|
310
359
|
args.push("--delete-branch");
|
|
@@ -322,15 +371,58 @@ export function mergePr(cwd, o, log) {
|
|
|
322
371
|
log(after.message);
|
|
323
372
|
return result(EXIT_GH_FAILED, undefined, false);
|
|
324
373
|
}
|
|
374
|
+
// A retarget between the base check and the merge is caught here, loudly.
|
|
375
|
+
if (after.pr?.state === "MERGED" && after.pr.baseRefName !== DEV) {
|
|
376
|
+
log(`INTEGRITY FAILURE: PR ${o.number} merged into ${after.pr.baseRefName ?? "an unknown base"}, not ${DEV} — its base changed after the check; revert the merge`);
|
|
377
|
+
const r = result(EXIT_BASE_NOT_DEV, after.pr, false);
|
|
378
|
+
return { ...r, out: { ...r.out, verdict: "FAIL", failures: 1 } };
|
|
379
|
+
}
|
|
325
380
|
return result(EXIT.OK, after.pr, false);
|
|
326
381
|
}
|
|
382
|
+
/** Whether dev demands status checks (ruleset or branch protection): CI must then pass at the PR head. */
|
|
383
|
+
export function devRequiresChecks(gh, repo) {
|
|
384
|
+
const rules = gh(["api", `repos/${repo}/rules/branches/dev`]);
|
|
385
|
+
const read = rules.ok ? parseJson(rules.stdout) : { ok: false };
|
|
386
|
+
const list = read.ok && Array.isArray(read.value) ? read.value : [];
|
|
387
|
+
const hasCheckRule = list.some((r) => r !== null &&
|
|
388
|
+
typeof r === "object" &&
|
|
389
|
+
r.type === "required_status_checks");
|
|
390
|
+
if (hasCheckRule)
|
|
391
|
+
return true;
|
|
392
|
+
return gh(["api", `repos/${repo}/branches/dev/protection/required_status_checks`]).ok;
|
|
393
|
+
}
|
|
327
394
|
/**
|
|
328
|
-
* Request a server-side base-into-head refresh
|
|
329
|
-
*
|
|
330
|
-
*
|
|
395
|
+
* Request a server-side base-into-head refresh. GitHub authors the merge commit,
|
|
396
|
+
* so bkit cannot set its message and there is no local head to read back. Ship
|
|
397
|
+
* does not call it: its Step 4 merges origin/dev locally (`branches sync --merge`). gh missing →
|
|
331
398
|
* EXIT.USE_MCP (route through `update_pull_request_branch`).
|
|
399
|
+
*
|
|
400
|
+
* `onlyIfRequired`: refresh only when dev requires status checks. Otherwise the
|
|
401
|
+
* PR merges at the head CI already passed at, and the dev push run tests the
|
|
402
|
+
* merged result — a refresh would only re-run CI on the same feature change.
|
|
332
403
|
*/
|
|
333
|
-
export function updateBranch(cwd, number, log) {
|
|
404
|
+
export function updateBranch(cwd, number, log, o = {}) {
|
|
405
|
+
if (o.onlyIfRequired === true) {
|
|
406
|
+
const repo = resolveOwnerRepo(cwd)?.ownerRepo;
|
|
407
|
+
let ghMissing = false;
|
|
408
|
+
const gh = (args) => {
|
|
409
|
+
const res = runGh(cwd, args);
|
|
410
|
+
if (ghUnavailable(res))
|
|
411
|
+
ghMissing = true;
|
|
412
|
+
return res;
|
|
413
|
+
};
|
|
414
|
+
const required = repo === undefined || devRequiresChecks(gh, repo);
|
|
415
|
+
if (ghMissing) {
|
|
416
|
+
log("gh unavailable to read dev's required checks — update the branch through update_pull_request_branch");
|
|
417
|
+
return { code: EXIT.USE_MCP, out: null };
|
|
418
|
+
}
|
|
419
|
+
if (!required) {
|
|
420
|
+
log(`dev requires no status checks — PR ${number} merges at the head CI passed at; the dev push run tests the merged result`);
|
|
421
|
+
return { code: EXIT.OK, out: { number, updated: false } };
|
|
422
|
+
}
|
|
423
|
+
if (repo === undefined)
|
|
424
|
+
log("cannot resolve the repo to read dev's required checks — updating");
|
|
425
|
+
}
|
|
334
426
|
const res = runGh(cwd, ["pr", "update-branch", number]);
|
|
335
427
|
if (ghUnavailable(res)) {
|
|
336
428
|
log("gh unavailable for gh pr update-branch — update the branch through update_pull_request_branch");
|
|
@@ -593,6 +685,7 @@ export const prsCommand = {
|
|
|
593
685
|
verbs: {
|
|
594
686
|
open: {
|
|
595
687
|
summary: "Open a PR whose body carries the bkit:issue / bkit:fid marker (exit 80: use MCP).",
|
|
688
|
+
use: "workflow",
|
|
596
689
|
flags: [
|
|
597
690
|
{ name: "fid", type: "string", required: true, help: "feature id" },
|
|
598
691
|
{ name: "title", type: "string", required: true, help: "PR title (no skip-CI token)" },
|
|
@@ -615,22 +708,30 @@ export const prsCommand = {
|
|
|
615
708
|
type: "string",
|
|
616
709
|
help: "an open PR already on --head: fail (default, exit 3) | reuse",
|
|
617
710
|
},
|
|
711
|
+
{
|
|
712
|
+
name: "file",
|
|
713
|
+
type: "string",
|
|
714
|
+
help: "status.jsonl: record the open as an engine-action row; a re-run this run reuses that PR (needs --workflow)",
|
|
715
|
+
},
|
|
716
|
+
{ name: "workflow", type: "string", help: "--file: the workflow, for the run number" },
|
|
618
717
|
],
|
|
619
718
|
output: {
|
|
620
719
|
created: "true when this run created the PR",
|
|
621
|
-
useMcp: "true when gh is unavailable: create it through MCP with title/
|
|
720
|
+
useMcp: "true when gh is unavailable: create it through MCP with title/base/head and the body read from bodyFile",
|
|
622
721
|
number: "PR number, or null",
|
|
623
722
|
url: "PR URL, or null",
|
|
624
723
|
base: "base branch (read back from the PR when created)",
|
|
625
724
|
head: "head branch",
|
|
626
725
|
title: "PR title",
|
|
627
726
|
body: "PR body, marker first",
|
|
727
|
+
bodyFile: "useMcp only: absolute path of a file holding `body` byte-for-byte (the MCP fallback reads it); absent otherwise",
|
|
628
728
|
},
|
|
629
729
|
exitCodes: {
|
|
630
730
|
[EXIT_PR_EXISTS]: "--head already has an open PR (with --existing=fail)",
|
|
631
731
|
[EXIT_SKIP_CI_TITLE]: "the title carries a CI-suppressing token",
|
|
632
732
|
[EXIT_GH_FAILED]: "gh errored (probe, create after one retry, or read-back)",
|
|
633
733
|
[EXIT_WRONG_BASE]: "the created PR's base is not --base",
|
|
734
|
+
[EXIT_BASE_MAIN]: `--base is ${MAIN}: bkit opens PRs into ${DEV} only (no gh call made)`,
|
|
634
735
|
},
|
|
635
736
|
run: (ctx) => {
|
|
636
737
|
const existing = str(ctx.flags.existing);
|
|
@@ -642,6 +743,7 @@ export const prsCommand = {
|
|
|
642
743
|
},
|
|
643
744
|
probe: {
|
|
644
745
|
summary: "The open (or open-then-merged) PR for a branch, or one PR by number.",
|
|
746
|
+
use: "by-hand",
|
|
645
747
|
flags: [
|
|
646
748
|
HEAD_FLAG,
|
|
647
749
|
{ name: "base", type: "string", help: "only PRs into this base (default: any base)" },
|
|
@@ -679,6 +781,7 @@ export const prsCommand = {
|
|
|
679
781
|
},
|
|
680
782
|
merge: {
|
|
681
783
|
summary: "Squash-merge a PR with an empty body (skipped when already MERGED) and read its state back.",
|
|
784
|
+
use: "workflow",
|
|
682
785
|
flags: [
|
|
683
786
|
{ name: "number", type: "string", required: true, help: "the PR number" },
|
|
684
787
|
{
|
|
@@ -716,6 +819,7 @@ export const prsCommand = {
|
|
|
716
819
|
exitCodes: {
|
|
717
820
|
[EXIT_GH_FAILED]: "gh could not read the PR",
|
|
718
821
|
[EXIT_NOT_MERGED]: "--expect-merged and the PR did not reach MERGED",
|
|
822
|
+
[EXIT_BASE_NOT_DEV]: `the PR's base is not ${DEV}, or could not be read — nothing merged`,
|
|
719
823
|
},
|
|
720
824
|
run: (ctx) => {
|
|
721
825
|
const number = String(ctx.flags.number);
|
|
@@ -732,7 +836,7 @@ export const prsCommand = {
|
|
|
732
836
|
ctx.log(pr.kind === "failed" ? pr.message : `PR #${number} not found`);
|
|
733
837
|
return EXIT_GH_FAILED;
|
|
734
838
|
}
|
|
735
|
-
subject = `${pr.pr.title} (#${number})`;
|
|
839
|
+
subject = `${pr.pr.title.replace(FORCE_BUILD_TAG, "")} (#${number})`;
|
|
736
840
|
}
|
|
737
841
|
if ((ctx.flags.label ?? []).includes(AUTO_LABEL))
|
|
738
842
|
subject += AUTO_ROUTE_SUFFIX;
|
|
@@ -750,10 +854,18 @@ export const prsCommand = {
|
|
|
750
854
|
},
|
|
751
855
|
"update-branch": {
|
|
752
856
|
summary: "Refresh a PR's head from its base server-side (exit 80: use update_pull_request_branch).",
|
|
753
|
-
|
|
857
|
+
use: "workflow",
|
|
858
|
+
flags: [
|
|
859
|
+
{ name: "number", type: "string", required: true, help: "the PR number" },
|
|
860
|
+
{
|
|
861
|
+
name: "only-if-required",
|
|
862
|
+
type: "boolean",
|
|
863
|
+
help: "skip the update (updated: false) when dev requires no status checks",
|
|
864
|
+
},
|
|
865
|
+
],
|
|
754
866
|
output: {
|
|
755
867
|
number: "the PR number",
|
|
756
|
-
updated: "the update request succeeded (true even when already up to date)",
|
|
868
|
+
updated: "the update request succeeded (true even when already up to date); false when --only-if-required skipped it",
|
|
757
869
|
},
|
|
758
870
|
exitCodes: {
|
|
759
871
|
[EXIT_GH_FAILED]: "gh could not update the branch (403 = actions:write scope)",
|
|
@@ -762,7 +874,9 @@ export const prsCommand = {
|
|
|
762
874
|
const number = String(ctx.flags.number);
|
|
763
875
|
if (!/^[1-9][0-9]*$/.test(number))
|
|
764
876
|
throw new CommandError(EXIT.USAGE, "--number must be a PR number");
|
|
765
|
-
const r = updateBranch(ctx.cwd, number, ctx.log
|
|
877
|
+
const r = updateBranch(ctx.cwd, number, ctx.log, {
|
|
878
|
+
onlyIfRequired: ctx.flags.onlyIfRequired === true,
|
|
879
|
+
});
|
|
766
880
|
if (r.out)
|
|
767
881
|
ctx.emit(r.out);
|
|
768
882
|
return r.code;
|
|
@@ -770,6 +884,7 @@ export const prsCommand = {
|
|
|
770
884
|
},
|
|
771
885
|
checks: {
|
|
772
886
|
summary: "A PR's check rollup, classified: green when present and none failed or pending (exit 80: use MCP).",
|
|
887
|
+
use: "by-hand",
|
|
773
888
|
flags: [{ name: "number", type: "string", required: true, help: "the PR number" }],
|
|
774
889
|
output: {
|
|
775
890
|
number: "the PR number",
|
|
@@ -795,6 +910,7 @@ export const prsCommand = {
|
|
|
795
910
|
},
|
|
796
911
|
"verbose-ci": {
|
|
797
912
|
summary: "Add ` bkit [verbose ci]` to a PR title, or strip it (with an optional `bkit ` prefix); a no-op when already so.",
|
|
913
|
+
use: "workflow",
|
|
798
914
|
flags: [
|
|
799
915
|
{ name: "number", type: "string", required: true, help: "the PR number" },
|
|
800
916
|
{ name: "state", type: "string", required: true, help: "on | off" },
|
|
@@ -846,6 +962,7 @@ export const prsCommand = {
|
|
|
846
962
|
},
|
|
847
963
|
"scan-body": {
|
|
848
964
|
summary: "Check a landed commit's body (not its subject) for a CI-suppressing token.",
|
|
965
|
+
use: "by-hand",
|
|
849
966
|
flags: [
|
|
850
967
|
{ name: "sha", type: "string", required: true, help: "the landed commit" },
|
|
851
968
|
{
|
|
@@ -864,6 +981,7 @@ export const prsCommand = {
|
|
|
864
981
|
},
|
|
865
982
|
"cross-check": {
|
|
866
983
|
summary: "An mcp close with gh recorded unavailable must have a transport-fallback row.",
|
|
984
|
+
use: "workflow",
|
|
867
985
|
flags: [
|
|
868
986
|
FILE_FLAG,
|
|
869
987
|
{
|
|
@@ -884,6 +1002,7 @@ export const prsCommand = {
|
|
|
884
1002
|
},
|
|
885
1003
|
"transport-row": {
|
|
886
1004
|
summary: "Append a transport-fallback or close-transport audit row to status.jsonl.",
|
|
1005
|
+
use: "workflow",
|
|
887
1006
|
flags: [
|
|
888
1007
|
FILE_FLAG,
|
|
889
1008
|
{ name: "kind", type: "string", required: true, help: "fallback | close" },
|