@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
|
@@ -34,7 +34,8 @@ import { removeOpencodeProviderBlock, renderOpencodeAgentsCommands, renderOpenco
|
|
|
34
34
|
import { applyModelOverrides, buildOpencodeModelLookup, parseEffortMap, } from "../../render/models.js";
|
|
35
35
|
import { readInstallingVersion } from "../../shared/package-json.js";
|
|
36
36
|
import { readBkitConfig } from "../../shared/settings.js";
|
|
37
|
-
import {
|
|
37
|
+
import { SEEDED_BKIT_DEFAULTS } from "../../install/modules/core.js";
|
|
38
|
+
import { CLAUDE_CLOUD_RELPATH, CODEX_CLOUD_RELPATH, CURSOR_CLOUD_RELPATH, resolveClaudeDerivedAllows, } from "../../install/cloud-env.js";
|
|
38
39
|
import { LOG_PREFIX, setLogPrefix } from "../../shared/log-prefix.js";
|
|
39
40
|
import { unusedTrackerMcpServers } from "../../checks/before/mcp.js";
|
|
40
41
|
// ---------------------------------------------------------------------------
|
|
@@ -257,8 +258,10 @@ const CORE_TEMPLATE_DOCTRINE = [
|
|
|
257
258
|
{ path: ".agents/docs.md", format: "markered-text", module: "core" },
|
|
258
259
|
{ path: ".agents/rules.md", format: "markered-text", module: "core" },
|
|
259
260
|
{ path: ".agents/skills.md", format: "markered-text", module: "core" },
|
|
260
|
-
// Retired
|
|
261
|
+
// Retired `.agents/shortcuts.md` (5.1.0 – 5.2.4), for an install never upgraded since.
|
|
261
262
|
{ path: ".agents/shortcuts.md", format: "markered-text", module: "core" },
|
|
263
|
+
// Retired `.bkit/lite.md` (5.2.5 – 6.0.0), for an install never upgraded since.
|
|
264
|
+
{ path: ".bkit/lite.md", format: "markered-text", module: "core" },
|
|
262
265
|
];
|
|
263
266
|
/**
|
|
264
267
|
* The top-level `docs/*.md` the core payload pass installs: each carries bkit's managed
|
|
@@ -654,7 +657,7 @@ export async function runUninstall(modules, ctx) {
|
|
|
654
657
|
}
|
|
655
658
|
}
|
|
656
659
|
// Full/core uninstall: strip the `bkit` install-state object from package.json
|
|
657
|
-
// (
|
|
660
|
+
// (tracker / providers / cloud and every other section), whatever keys it holds. Scripts
|
|
658
661
|
// and devDeps are the consumer's and stay. No try/catch — malformed package.json is a hard failure on full
|
|
659
662
|
// teardown (same as a missing dest would be).
|
|
660
663
|
if (moduleList.includes("core") && !ctx.dryRun) {
|
|
@@ -669,8 +672,8 @@ export async function runUninstall(modules, ctx) {
|
|
|
669
672
|
}
|
|
670
673
|
}
|
|
671
674
|
}
|
|
672
|
-
// Targeted uninstall:
|
|
673
|
-
// stop firing. Core keeps every other key.
|
|
675
|
+
// Targeted uninstall: reset the `bkit.*` keys the removed module records to unset, so its
|
|
676
|
+
// advisories stop firing. Core keeps every other key.
|
|
674
677
|
if (!moduleList.includes("core")) {
|
|
675
678
|
stripModuleBkitKeys(moduleList, ctx, result);
|
|
676
679
|
}
|
|
@@ -751,31 +754,25 @@ export async function runUninstall(modules, ctx) {
|
|
|
751
754
|
}
|
|
752
755
|
}
|
|
753
756
|
}
|
|
754
|
-
// Remove
|
|
755
|
-
// secrets).
|
|
756
|
-
//
|
|
757
|
-
//
|
|
758
|
-
|
|
759
|
-
|
|
760
|
-
|
|
761
|
-
|
|
762
|
-
|
|
763
|
-
|
|
764
|
-
|
|
765
|
-
|
|
766
|
-
|
|
767
|
-
|
|
768
|
-
|
|
769
|
-
|
|
770
|
-
|
|
771
|
-
|
|
772
|
-
|
|
773
|
-
if (fs.existsSync(cloudAbs)) {
|
|
774
|
-
result.deleted.push(CURSOR_CLOUD_RELPATH);
|
|
775
|
-
if (!ctx.dryRun) {
|
|
776
|
-
fs.rmSync(cloudAbs, { force: true });
|
|
777
|
-
console.log(`${ctx.logPrefix} delete: ${CURSOR_CLOUD_RELPATH} (generated cloud setup doc)`);
|
|
778
|
-
}
|
|
757
|
+
// Remove each uninstalled host's generated `<host>/bkit-cloud.md` (untracked,
|
|
758
|
+
// gitignored — holds resolved secrets). Not in the manifest, so the table-driven pass
|
|
759
|
+
// never sees them; delete explicitly so a live-secrets file is never left behind.
|
|
760
|
+
// Pushed to result.deleted so a dry-run reports them too.
|
|
761
|
+
const cloudDocs = [
|
|
762
|
+
["claude", CLAUDE_CLOUD_RELPATH],
|
|
763
|
+
["cursor", CURSOR_CLOUD_RELPATH],
|
|
764
|
+
["codex", CODEX_CLOUD_RELPATH],
|
|
765
|
+
];
|
|
766
|
+
for (const [host, relPath] of cloudDocs) {
|
|
767
|
+
if (!moduleList.includes(host))
|
|
768
|
+
continue;
|
|
769
|
+
const cloudAbs = path.join(ctx.cwd, relPath);
|
|
770
|
+
if (!fs.existsSync(cloudAbs))
|
|
771
|
+
continue;
|
|
772
|
+
result.deleted.push(relPath);
|
|
773
|
+
if (!ctx.dryRun) {
|
|
774
|
+
fs.rmSync(cloudAbs, { force: true });
|
|
775
|
+
console.log(`${ctx.logPrefix} delete: ${relPath} (generated cloud setup doc)`);
|
|
779
776
|
}
|
|
780
777
|
}
|
|
781
778
|
// Full/core uninstall: the consumer's template copies (`.bkit/templates/`) are
|
|
@@ -863,15 +860,33 @@ export async function runUninstall(modules, ctx) {
|
|
|
863
860
|
}
|
|
864
861
|
return result;
|
|
865
862
|
}
|
|
866
|
-
/** `package.json` `bkit.*` keys each module records on install. */
|
|
863
|
+
/** `package.json` `bkit.*` keys (dotted paths) each module records on install. */
|
|
867
864
|
const MODULE_BKIT_KEYS = {
|
|
868
|
-
cloud: ["
|
|
869
|
-
opencode: ["
|
|
865
|
+
cloud: ["cloud.agent"],
|
|
866
|
+
opencode: ["providers.opencode.default", "providers.opencode.installed"],
|
|
870
867
|
};
|
|
868
|
+
/** The object at dotted `keys` under `root`; null when a step is absent or not an object. */
|
|
869
|
+
function objectAt(root, keys) {
|
|
870
|
+
let node = root;
|
|
871
|
+
for (const k of keys) {
|
|
872
|
+
const next = node[k];
|
|
873
|
+
if (!isJsonObject(next))
|
|
874
|
+
return null;
|
|
875
|
+
node = next;
|
|
876
|
+
}
|
|
877
|
+
return node;
|
|
878
|
+
}
|
|
879
|
+
/** The seeded value at dotted `key` in SEEDED_BKIT_DEFAULTS, copied. */
|
|
880
|
+
function seededValue(key) {
|
|
881
|
+
const segs = key.split(".");
|
|
882
|
+
const parent = objectAt(SEEDED_BKIT_DEFAULTS, segs.slice(0, -1));
|
|
883
|
+
return structuredClone(parent?.[segs[segs.length - 1]]);
|
|
884
|
+
}
|
|
871
885
|
/**
|
|
872
|
-
*
|
|
873
|
-
*
|
|
874
|
-
*
|
|
886
|
+
* Reset the `bkit.*` keys recorded by the modules in `moduleList` to the value install
|
|
887
|
+
* seeds (`""` / `[]`, read as unset), keeping the package.json indent. Deleting them
|
|
888
|
+
* would leave `bkit check` reporting the seeded key as missing. Lists each reset key in
|
|
889
|
+
* `result.stripped`; a dry run lists without writing.
|
|
875
890
|
*/
|
|
876
891
|
function stripModuleBkitKeys(moduleList, ctx, result) {
|
|
877
892
|
const keys = moduleList.flatMap((m) => MODULE_BKIT_KEYS[m] ?? []);
|
|
@@ -886,14 +901,22 @@ function stripModuleBkitKeys(moduleList, ctx, result) {
|
|
|
886
901
|
if (pkg === null || !isJsonObject(pkg.bkit))
|
|
887
902
|
return;
|
|
888
903
|
const bkit = pkg.bkit;
|
|
889
|
-
const
|
|
890
|
-
|
|
904
|
+
const reset = keys.filter((k) => {
|
|
905
|
+
const segs = k.split(".");
|
|
906
|
+
const parent = objectAt(bkit, segs.slice(0, -1));
|
|
907
|
+
const key = segs[segs.length - 1];
|
|
908
|
+
return (parent !== null &&
|
|
909
|
+
key in parent &&
|
|
910
|
+
JSON.stringify(parent[key]) !== JSON.stringify(seededValue(k)));
|
|
911
|
+
});
|
|
912
|
+
if (reset.length === 0)
|
|
891
913
|
return;
|
|
892
|
-
for (const k of
|
|
893
|
-
|
|
914
|
+
for (const k of reset) {
|
|
915
|
+
const segs = k.split(".");
|
|
916
|
+
objectAt(bkit, segs.slice(0, -1))[segs[segs.length - 1]] = seededValue(k);
|
|
894
917
|
result.stripped.push(`package.json#bkit.${k}`);
|
|
895
918
|
}
|
|
896
|
-
console.log(`${ctx.logPrefix}${ctx.dryRun ? " [dry-run]" : ""} package.json:
|
|
919
|
+
console.log(`${ctx.logPrefix}${ctx.dryRun ? " [dry-run]" : ""} package.json: reset bkit.${reset.join(", bkit.")} to unset`);
|
|
897
920
|
if (ctx.dryRun)
|
|
898
921
|
return;
|
|
899
922
|
const indentMatch = raw.match(/\n([ \t]+)"/);
|
|
@@ -908,8 +931,8 @@ function stripModuleBkitKeys(moduleList, ctx, result) {
|
|
|
908
931
|
*
|
|
909
932
|
* Distinct from bare `bkit uninstall --opencode` (full host teardown):
|
|
910
933
|
* - Removes the provider block from `.opencode/opencode.json`
|
|
911
|
-
* - Updates `bkit.
|
|
912
|
-
* - If the removed provider was the active one, re-points `bkit.
|
|
934
|
+
* - Updates `bkit.providers.opencode.installed` in `package.json`
|
|
935
|
+
* - If the removed provider was the active one, re-points `bkit.providers.opencode.default`
|
|
913
936
|
* to the first remaining provider and emits a re-render advisory
|
|
914
937
|
* - If no providers remain, falls through to full host teardown via `runUninstall`
|
|
915
938
|
*/
|
|
@@ -923,7 +946,7 @@ export async function runSurgicalOpencodeUninstall(providerKey, dryRun, cwd) {
|
|
|
923
946
|
if (ws.writes.length > 0) {
|
|
924
947
|
console.log(`${LOG_PREFIX}${tag} removed provider block "${providerKey}" from opencode.json`);
|
|
925
948
|
}
|
|
926
|
-
// 2. Update bkit.
|
|
949
|
+
// 2. Update bkit.providers.opencode.installed in package.json (read inline — no detectOpencodeProviders import)
|
|
927
950
|
const pkgPath = path.join(cwd, "package.json");
|
|
928
951
|
let remainingProviders = [];
|
|
929
952
|
let wasActive = false;
|
|
@@ -936,31 +959,35 @@ export async function runSurgicalOpencodeUninstall(providerKey, dryRun, cwd) {
|
|
|
936
959
|
console.warn(`${LOG_PREFIX} package.json is malformed — skipping bkit section update`);
|
|
937
960
|
return;
|
|
938
961
|
}
|
|
939
|
-
const
|
|
940
|
-
const arr = Array.isArray(
|
|
941
|
-
? [...bkit.opencodeProviders]
|
|
942
|
-
: [];
|
|
962
|
+
const opencode = objectAt(pkg, ["bkit", "providers", "opencode"]) ?? {};
|
|
963
|
+
const arr = Array.isArray(opencode.installed) ? [...opencode.installed] : [];
|
|
943
964
|
remainingProviders = arr.filter((p) => p !== providerKey);
|
|
944
|
-
wasActive =
|
|
965
|
+
wasActive = opencode.default === providerKey;
|
|
945
966
|
if (wasActive && remainingProviders.length > 0) {
|
|
946
967
|
newActive = remainingProviders[0];
|
|
947
968
|
}
|
|
948
969
|
if (!dryRun) {
|
|
949
|
-
|
|
970
|
+
opencode.installed = remainingProviders;
|
|
950
971
|
if (wasActive) {
|
|
951
972
|
if (newActive !== null) {
|
|
952
|
-
|
|
973
|
+
opencode.default = newActive;
|
|
953
974
|
}
|
|
954
975
|
else {
|
|
955
|
-
delete
|
|
976
|
+
delete opencode.default;
|
|
956
977
|
}
|
|
957
978
|
}
|
|
958
|
-
pkg
|
|
979
|
+
if (objectAt(pkg, ["bkit", "providers", "opencode"]) === null) {
|
|
980
|
+
const bkit = objectAt(pkg, ["bkit"]) ?? {};
|
|
981
|
+
const providers = objectAt(bkit, ["providers"]) ?? {};
|
|
982
|
+
providers.opencode = opencode;
|
|
983
|
+
bkit.providers = providers;
|
|
984
|
+
pkg.bkit = bkit;
|
|
985
|
+
}
|
|
959
986
|
const indentMatch = raw.match(/\n([ \t]+)"/);
|
|
960
987
|
const indent = indentMatch ? indentMatch[1] : " ";
|
|
961
988
|
fs.writeFileSync(pkgPath, JSON.stringify(pkg, null, indent) + "\n", "utf-8");
|
|
962
|
-
console.log(`${LOG_PREFIX} updated package.json:
|
|
963
|
-
(wasActive ? `
|
|
989
|
+
console.log(`${LOG_PREFIX} updated package.json: bkit.providers.opencode.installed=[${remainingProviders.join(", ")}]` +
|
|
990
|
+
(wasActive ? ` bkit.providers.opencode.default=${newActive ?? "(removed)"}` : ""));
|
|
964
991
|
}
|
|
965
992
|
}
|
|
966
993
|
// 3. If none remain → full host teardown
|
|
@@ -37,7 +37,7 @@ import { readBkitConfig } from "../../shared/settings.js";
|
|
|
37
37
|
import { detectInstalledHostModules } from "../../install/hosts.js";
|
|
38
38
|
import { detectInstalledModules } from "./check.js";
|
|
39
39
|
import { remapTemplateDest } from "../../install/template-copies.js";
|
|
40
|
-
import { CLAUDE_CLOUD_RELPATH, CURSOR_CLOUD_RELPATH, writeClaudeCloudDoc, writeCursorCloudDoc, writeCursorCliPermissionsArtifact, } from "../../install/cloud-env.js";
|
|
40
|
+
import { CLAUDE_CLOUD_RELPATH, CODEX_CLOUD_RELPATH, CURSOR_CLOUD_RELPATH, writeClaudeCloudDoc, writeCodexCloudDoc, writeCursorCloudDoc, writeCursorCliPermissionsArtifact, } from "../../install/cloud-env.js";
|
|
41
41
|
import { syncTemplateCopies, formatTemplateChanges } from "../../install/template-copies.js";
|
|
42
42
|
import { formatPayloadLinkChanges, syncPayloadLinks } from "../../install/payload-links.js";
|
|
43
43
|
import { renderOpencodeJson, reconcileOpencodeJson } from "../../install/modules/opencode.js";
|
|
@@ -512,14 +512,17 @@ export async function runUpgradeCommand(upgradeFlags) {
|
|
|
512
512
|
else if (ent.isFile()) {
|
|
513
513
|
// Single shared dotfile remap (gitignore → .gitignore, npmignore → .npmignore).
|
|
514
514
|
const relPath = remapTemplateDest(entRel);
|
|
515
|
-
// `.claude
|
|
516
|
-
// (writeClaudeCloudDoc / writeCursorCloudDoc), not payload
|
|
517
|
-
// install/upgrade regenerate them with resolved secret values,
|
|
518
|
-
// source is never a byte-match and the walk must never drift-flag or
|
|
515
|
+
// `.claude/` + `.cursor/` + `.codex/bkit-cloud.md` are GENERATED output files
|
|
516
|
+
// (writeClaudeCloudDoc / writeCursorCloudDoc / writeCodexCloudDoc), not payload
|
|
517
|
+
// files to reconcile: install/upgrade regenerate them with resolved secret values,
|
|
518
|
+
// so the raw source is never a byte-match and the walk must never drift-flag or
|
|
519
519
|
// overwrite them. Regenerated explicitly in the runUpgrade block below
|
|
520
520
|
// (host-gated, non-dry-run).
|
|
521
|
-
if (relPath === CLAUDE_CLOUD_RELPATH ||
|
|
521
|
+
if (relPath === CLAUDE_CLOUD_RELPATH ||
|
|
522
|
+
relPath === CURSOR_CLOUD_RELPATH ||
|
|
523
|
+
relPath === CODEX_CLOUD_RELPATH) {
|
|
522
524
|
continue;
|
|
525
|
+
}
|
|
523
526
|
if (relPath === MCP_ROOT_RELPATH || relPath === CURSOR_MCP_RELPATH)
|
|
524
527
|
continue;
|
|
525
528
|
const entry = entryByPath.get(relPath);
|
|
@@ -725,14 +728,19 @@ export async function runUpgradeCommand(upgradeFlags) {
|
|
|
725
728
|
console.log(`${LOG_PREFIX} upgrade: .claude/bkit-cloud.md (regenerated — gitignored, holds resolved secrets)`);
|
|
726
729
|
}
|
|
727
730
|
}
|
|
728
|
-
// Same for `.cursor/bkit-cloud.md` —
|
|
729
|
-
//
|
|
730
|
-
//
|
|
731
|
+
// Same for `.cursor/bkit-cloud.md` and `.codex/bkit-cloud.md` — host-gated twins (see
|
|
732
|
+
// writeCursorCloudDoc / writeCodexCloudDoc); excluded from the payload walk above for
|
|
733
|
+
// the same reason as the Claude doc.
|
|
731
734
|
if (!upgradeFlags.dryRun && renderModules.has("cursor") && tokens) {
|
|
732
|
-
if (writeCursorCloudDoc(process.cwd(), tokens
|
|
735
|
+
if (writeCursorCloudDoc(process.cwd(), tokens)) {
|
|
733
736
|
console.log(`${LOG_PREFIX} upgrade: .cursor/bkit-cloud.md (regenerated — gitignored, holds resolved secrets)`);
|
|
734
737
|
}
|
|
735
738
|
}
|
|
739
|
+
if (!upgradeFlags.dryRun && renderModules.has("codex") && tokens) {
|
|
740
|
+
if (writeCodexCloudDoc(process.cwd(), tokens)) {
|
|
741
|
+
console.log(`${LOG_PREFIX} upgrade: .codex/bkit-cloud.md (regenerated — gitignored, holds resolved secrets)`);
|
|
742
|
+
}
|
|
743
|
+
}
|
|
736
744
|
// Network allowlist + MCP allows — OpenCode from renderOpencodeJson; Claude enrich
|
|
737
745
|
// below; `.bkit/allowlist.json` in renderManagedOutputs above; Cursor
|
|
738
746
|
// `.cursor/cli.json` only when cursor module installed. Written artifacts get their
|
|
@@ -763,7 +771,9 @@ export async function runUpgradeCommand(upgradeFlags) {
|
|
|
763
771
|
// exit), so feed those writes into canonicalHashes — keeping install/upgrade `.bkit/version`
|
|
764
772
|
// parity.
|
|
765
773
|
if (!upgradeFlags.dryRun) {
|
|
766
|
-
const renderedDocPaths = renderWs.writes
|
|
774
|
+
const renderedDocPaths = renderWs.writes
|
|
775
|
+
.filter((w) => !w.unhashed)
|
|
776
|
+
.map((w) => path.relative(process.cwd(), path.isAbsolute(w.path) ? w.path : path.resolve(process.cwd(), w.path)));
|
|
767
777
|
updateCanonicalHashesAfterUpgrade({
|
|
768
778
|
updated: [
|
|
769
779
|
...result.updated,
|
package/dist/commands/land.js
CHANGED
|
@@ -1,14 +1,24 @@
|
|
|
1
|
-
// The one way bkit lands
|
|
2
|
-
// worktree off a fresh origin/dev and push it as dev. The main
|
|
3
|
-
// branch, index and edits are never touched, and local dev commits
|
|
4
|
-
// origin/dev are never pushed
|
|
5
|
-
//
|
|
6
|
-
//
|
|
7
|
-
//
|
|
1
|
+
// The one way bkit lands commits on dev from a throwaway: build them in a
|
|
2
|
+
// detached worktree off a fresh origin/dev and push it as dev. The main
|
|
3
|
+
// checkout's branch, index and edits are never touched, and local dev commits
|
|
4
|
+
// missing from origin/dev are never pushed as they stand — a caller that wants
|
|
5
|
+
// some of them replays exactly those. dev moved underneath → rebuild on the new
|
|
6
|
+
// dev and push again, with backoff. Used by the design / plan close, the
|
|
7
|
+
// build / debug roadmap mirror, ship's close and FAILED record, and the
|
|
8
|
+
// own-commit push of a debug run in place on dev, which replays the run's
|
|
9
|
+
// commits. The throwaway runs its declared gate explicitly before pushing.
|
|
10
|
+
import { spawnSync } from "node:child_process";
|
|
8
11
|
import * as fs from "node:fs";
|
|
9
12
|
import * as path from "node:path";
|
|
10
13
|
import { CommandError, DEV, EXIT, git, runGit } from "./lib.js";
|
|
11
14
|
import { TIMEOUTS } from "../shared/timeouts.js";
|
|
15
|
+
import { gitEnv } from "../ledgers/telemetry.js";
|
|
16
|
+
import { readBkitConfig } from "../shared/settings.js";
|
|
17
|
+
import { readPackageJson } from "../shared/package-json.js";
|
|
18
|
+
import { installCommand } from "../shared/package-manager.js";
|
|
19
|
+
import { minPushPathspecs } from "./ci/ci.js";
|
|
20
|
+
import { requiredPushGate, runPushGate } from "./ci/push-gate.js";
|
|
21
|
+
import { changedOutside } from "./workflow/ledgers.js";
|
|
12
22
|
const REMOTE = "origin";
|
|
13
23
|
const UPSTREAM = `${REMOTE}/${DEV}`;
|
|
14
24
|
/** dev moved before git sent anything: git compared the remote's dev and stopped. */
|
|
@@ -17,6 +27,20 @@ const MOVED_BEFORE = /\[rejected\][^\n]*\((?:fetch first|non-fast-forward)\)/;
|
|
|
17
27
|
const MOVED_DURING = /\[remote rejected\][^\n]*\((?:incorrect old value provided|cannot lock ref[^\n]*)\)/;
|
|
18
28
|
/** The server turned the push away: branch protection, a ruleset, an HTTP 403. */
|
|
19
29
|
const REFUSED = /\[remote rejected\]|returned error: 403|\bGH0\d\d\b/;
|
|
30
|
+
/**
|
|
31
|
+
* The refspec every dev fetch uses. A bare `git fetch origin dev` writes only
|
|
32
|
+
* FETCH_HEAD when the clone's fetch refspec does not cover `dev` (a single-branch
|
|
33
|
+
* clone), leaving `origin/dev` stale; a landing built on it is rejected on every push.
|
|
34
|
+
*/
|
|
35
|
+
export const DEV_REFSPEC = `+refs/heads/${DEV}:refs/remotes/${UPSTREAM}`;
|
|
36
|
+
/** Fetch origin's dev into `origin/dev`, whatever the clone's fetch refspec covers. */
|
|
37
|
+
export const fetchDev = (cwd) => runGit(cwd, ["fetch", REMOTE, DEV_REFSPEC]);
|
|
38
|
+
/**
|
|
39
|
+
* A dev fetch that failed only because another git process in this clone (a
|
|
40
|
+
* second landing's fetch or push) updated or held `origin/dev` while it ran.
|
|
41
|
+
*/
|
|
42
|
+
const DEV_REF_RACE = new RegExp(`cannot lock ref 'refs/remotes/${UPSTREAM}'`);
|
|
43
|
+
export const devRefRace = (stderr) => DEV_REF_RACE.test(stderr);
|
|
20
44
|
/** A dev push rejected only because dev moved: rebuild on the new dev, push again. */
|
|
21
45
|
export const devMoved = (stderr) => MOVED_BEFORE.test(stderr) || MOVED_DURING.test(stderr);
|
|
22
46
|
/** A dev push the server refused for a reason other than dev moving. */
|
|
@@ -78,26 +102,119 @@ export async function withoutHooks(fn) {
|
|
|
78
102
|
delete process.env[value];
|
|
79
103
|
}
|
|
80
104
|
}
|
|
105
|
+
/** Copy ignored inputs without replacing anything in the built checkout. */
|
|
106
|
+
function prepareLandInputs(root, dir, log) {
|
|
107
|
+
const config = readBkitConfig(dir);
|
|
108
|
+
const sourceRoot = fs.realpathSync(root);
|
|
109
|
+
for (const entry of config.worktreeCopy) {
|
|
110
|
+
const relative = path.normalize(entry);
|
|
111
|
+
if (path.isAbsolute(relative) || relative === ".." || relative.startsWith(`..${path.sep}`)) {
|
|
112
|
+
log(`landing input is outside the checkout — skipped: ${entry}`);
|
|
113
|
+
continue;
|
|
114
|
+
}
|
|
115
|
+
const source = path.join(root, relative);
|
|
116
|
+
const destination = path.join(dir, relative);
|
|
117
|
+
const tracked = runGit(dir, ["ls-files", "--", relative]);
|
|
118
|
+
if (!tracked.ok)
|
|
119
|
+
throw new CommandError(EXIT.NO, `cannot inspect landing input: ${entry}`);
|
|
120
|
+
if (tracked.stdout || fs.existsSync(destination))
|
|
121
|
+
continue;
|
|
122
|
+
if (!runGit(dir, ["check-ignore", "-q", "--", relative]).ok)
|
|
123
|
+
continue;
|
|
124
|
+
if (!fs.existsSync(source)) {
|
|
125
|
+
log(`landing input absent in the main checkout: ${entry}`);
|
|
126
|
+
continue;
|
|
127
|
+
}
|
|
128
|
+
fs.mkdirSync(path.dirname(destination), { recursive: true });
|
|
129
|
+
fs.cpSync(source, destination, {
|
|
130
|
+
recursive: true,
|
|
131
|
+
dereference: true,
|
|
132
|
+
filter: (file) => {
|
|
133
|
+
const actual = fs.realpathSync(file);
|
|
134
|
+
if (actual !== sourceRoot && !actual.startsWith(`${sourceRoot}${path.sep}`)) {
|
|
135
|
+
throw new CommandError(EXIT.NO, `landing input resolves outside the checkout: ${entry}`);
|
|
136
|
+
}
|
|
137
|
+
return true;
|
|
138
|
+
},
|
|
139
|
+
});
|
|
140
|
+
}
|
|
141
|
+
if (config.worktreeInstall) {
|
|
142
|
+
const [command, ...args] = installCommand({ frozen: true });
|
|
143
|
+
if (!fs.existsSync(path.join(dir, "pnpm-workspace.yaml")))
|
|
144
|
+
args.push("--ignore-workspace");
|
|
145
|
+
log("installing frozen dependencies in the throwaway dev checkout");
|
|
146
|
+
const result = spawnSync(command, args, {
|
|
147
|
+
cwd: dir,
|
|
148
|
+
env: gitEnv(),
|
|
149
|
+
encoding: "utf8",
|
|
150
|
+
maxBuffer: 1 << 26,
|
|
151
|
+
});
|
|
152
|
+
if (result.error || result.status !== 0) {
|
|
153
|
+
for (const line of `${result.stdout ?? ""}${result.stderr ?? ""}`
|
|
154
|
+
.trim()
|
|
155
|
+
.split("\n")
|
|
156
|
+
.slice(-20))
|
|
157
|
+
log(line);
|
|
158
|
+
throw new CommandError(EXIT.NO, "landing dependency install failed — nothing pushed");
|
|
159
|
+
}
|
|
160
|
+
}
|
|
161
|
+
}
|
|
162
|
+
/** Validate the committed landing against the freshly fetched base before sending it. */
|
|
163
|
+
function checkLanding(root, dir, base, log) {
|
|
164
|
+
const head = git(dir, ["rev-parse", "HEAD"]);
|
|
165
|
+
const unchanged = () => head !== null &&
|
|
166
|
+
git(dir, ["rev-parse", "HEAD"]) === head &&
|
|
167
|
+
git(dir, ["status", "--porcelain", "--untracked-files=all", "--ignore-submodules=none"]) === "";
|
|
168
|
+
if (!unchanged())
|
|
169
|
+
throw new CommandError(EXIT.NO, "landing checkout is not clean — nothing pushed");
|
|
170
|
+
if (!readPackageJson(dir).ok)
|
|
171
|
+
throw new CommandError(EXIT.NO, "landing package.json is unreadable — nothing pushed");
|
|
172
|
+
const diff = changedOutside(dir, base, head, minPushPathspecs(readBkitConfig(dir)));
|
|
173
|
+
if (!diff.ok)
|
|
174
|
+
throw new CommandError(EXIT.NO, `cannot classify landing: ${diff.stderr}`);
|
|
175
|
+
const gate = diff.outside.length === 0 ? "bkit:gate:min" : requiredPushGate(dir);
|
|
176
|
+
if (!gate)
|
|
177
|
+
throw new CommandError(EXIT.NO, "landing has no declared full gate — nothing pushed");
|
|
178
|
+
prepareLandInputs(root, dir, log);
|
|
179
|
+
if (!unchanged())
|
|
180
|
+
throw new CommandError(EXIT.NO, "landing preparation changed the checkout — nothing pushed");
|
|
181
|
+
const status = runPushGate(dir, gate, log);
|
|
182
|
+
if (status !== 0)
|
|
183
|
+
throw new CommandError(EXIT.NO, `landing ${gate} failed (exit ${status}) — nothing pushed`);
|
|
184
|
+
if (!unchanged())
|
|
185
|
+
throw new CommandError(EXIT.NO, "landing gate changed the checkout — nothing pushed");
|
|
186
|
+
}
|
|
81
187
|
/**
|
|
82
|
-
* Land
|
|
83
|
-
* origin/dev, let `build` make
|
|
84
|
-
*
|
|
85
|
-
*
|
|
188
|
+
* Land on dev what `build` makes: per attempt, fetch dev, add `dir` detached at
|
|
189
|
+
* origin/dev, let `build` make one or more commits there (a bookkeeping commit,
|
|
190
|
+
* or a replay of a run's commits), validate the checkout, then push `HEAD:dev`.
|
|
191
|
+
* Git hooks are off; the minimum or full local gate runs explicitly. `build`
|
|
192
|
+
* throwing stops the landing with that throw. A server refusal runs `refused` on
|
|
193
|
+
* the built commits first, when given. dev moving, or another landing in this
|
|
194
|
+
* clone updating `origin/dev` during the fetch, retries with backoff within
|
|
195
|
+
* LAND_ATTEMPTS. `dir` is removed on every path.
|
|
86
196
|
*/
|
|
87
197
|
export async function pushToDev(o) {
|
|
88
|
-
o.log("git hooks skipped in the throwaway dev checkout —
|
|
198
|
+
o.log("git hooks skipped in the throwaway dev checkout — its declared minimum or full gate runs explicitly");
|
|
89
199
|
for (let attempt = 1;; attempt++) {
|
|
90
200
|
let wait = 0;
|
|
91
201
|
dropLandTree(o.root, o.dir);
|
|
92
202
|
try {
|
|
93
203
|
const outcome = await withoutHooks(async () => {
|
|
94
|
-
const fetched =
|
|
95
|
-
if (!fetched.ok)
|
|
204
|
+
const fetched = fetchDev(o.root);
|
|
205
|
+
if (!fetched.ok) {
|
|
206
|
+
if (devRefRace(fetched.stderr) && attempt < TIMEOUTS.LAND_ATTEMPTS)
|
|
207
|
+
return "raced";
|
|
96
208
|
return { kind: "fetch-failed", stderr: fetched.stderr };
|
|
209
|
+
}
|
|
97
210
|
const added = runGit(o.root, ["worktree", "add", "--detach", o.dir, UPSTREAM]);
|
|
98
211
|
if (!added.ok)
|
|
99
212
|
return { kind: "setup-failed", stderr: added.stderr };
|
|
213
|
+
const base = git(o.dir, ["rev-parse", "HEAD"]);
|
|
214
|
+
if (!base)
|
|
215
|
+
throw new CommandError(EXIT.NO, "cannot read the fetched landing base");
|
|
100
216
|
o.build(o.dir, attempt);
|
|
217
|
+
checkLanding(o.root, o.dir, base, o.log);
|
|
101
218
|
const pushed = runGit(o.dir, ["push", REMOTE, `HEAD:${DEV}`]);
|
|
102
219
|
if (pushed.ok) {
|
|
103
220
|
return {
|
|
@@ -112,14 +229,17 @@ export async function pushToDev(o) {
|
|
|
112
229
|
}
|
|
113
230
|
if (!devMoved(pushed.stderr))
|
|
114
231
|
return { kind: "push-failed", stderr: pushed.stderr };
|
|
115
|
-
return
|
|
232
|
+
return "moved";
|
|
116
233
|
});
|
|
117
|
-
if (outcome !==
|
|
234
|
+
if (typeof outcome !== "string")
|
|
118
235
|
return outcome;
|
|
119
236
|
if (attempt >= TIMEOUTS.LAND_ATTEMPTS)
|
|
120
237
|
return { kind: "exhausted", attempts: attempt };
|
|
121
238
|
wait = landBackoffMs(attempt);
|
|
122
|
-
|
|
239
|
+
const s = (wait / 1000).toFixed(1);
|
|
240
|
+
o.log(outcome === "moved"
|
|
241
|
+
? `dev moved before push ${attempt} of ${TIMEOUTS.LAND_ATTEMPTS} — rebuilding on the new dev in ${s}s`
|
|
242
|
+
: `another git process updated ${UPSTREAM} during the fetch of try ${attempt} of ${TIMEOUTS.LAND_ATTEMPTS} — fetching again in ${s}s`);
|
|
123
243
|
}
|
|
124
244
|
finally {
|
|
125
245
|
dropLandTree(o.root, o.dir);
|