@cbartens/bkit 6.0.0 → 6.1.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.bkit/README.md +154 -151
- package/.bkit/core/.agents/context.md +95 -29
- package/.bkit/core/.agents/docs.md +17 -15
- package/.bkit/core/.agents/plugins/bkit/hooks/bkit-gateguard.cjs +1 -0
- package/.bkit/core/.agents/plugins/bkit/hooks/bkit-guardrails.cjs +6 -5
- package/.bkit/core/.agents/plugins/bkit/hooks/bkit-readguard.cjs +1 -0
- package/.bkit/core/.agents/plugins/bkit/hooks/bkit-rules.cjs +65 -0
- package/.bkit/core/.agents/rules.md +108 -107
- package/.bkit/core/.agents/skills.md +63 -15
- package/.bkit/core/.bkit/README.md +154 -151
- package/.bkit/core/.bkit/authoring.md +714 -84
- package/.bkit/core/.bkit/cli.md +407 -0
- package/.bkit/core/.bkit/cloud.md +281 -193
- package/.bkit/core/.bkit/comparison.md +43 -41
- package/.bkit/core/.bkit/install.md +154 -84
- package/.bkit/core/.bkit/jsonl.md +193 -130
- package/.bkit/core/.bkit/pipeline.md +114 -114
- package/.bkit/core/.bkit/prompts.md +272 -165
- package/.bkit/core/.bkit/providers.md +457 -271
- package/.bkit/core/.bkit/router.md +69 -0
- package/.bkit/core/.bkit/templates.md +529 -256
- package/.bkit/core/.bkit/trackers.md +80 -52
- package/.bkit/core/.bkit/workflows.md +589 -504
- package/.bkit/core/.claude/hooks/bkit-gateguard.cjs +2 -2
- package/.bkit/core/.claude/hooks/bkit-guardrails.cjs +3 -3
- package/.bkit/core/.claude/hooks/bkit-preflight.sh +45 -14
- package/.bkit/core/.codex/hooks/bkit-guardrails.cjs +3 -3
- package/.bkit/core/.codex/hooks/bkit-rules.cjs +57 -0
- package/.bkit/core/.cursor/hooks/bkit-guardrails.cjs +7 -7
- package/.bkit/core/.cursor/hooks/bkit-preflight.sh +47 -12
- package/.bkit/core/.opencode/plugin/bkit-rules.js +89 -0
- package/.bkit/core/AGENTS.md +5 -73
- package/.bkit/core/docs/templates/bkit-audit-accessibility.md +127 -105
- package/.bkit/core/docs/templates/bkit-audit-adoption.md +104 -70
- package/.bkit/core/docs/templates/bkit-audit-agents.md +94 -72
- package/.bkit/core/docs/templates/bkit-audit-aio-seo.md +99 -78
- package/.bkit/core/docs/templates/bkit-audit-analytics.md +140 -82
- package/.bkit/core/docs/templates/bkit-audit-annotations.md +98 -72
- package/.bkit/core/docs/templates/bkit-audit-app-performance.md +121 -96
- package/.bkit/core/docs/templates/bkit-audit-app-store.md +157 -76
- package/.bkit/core/docs/templates/bkit-audit-architecture.md +113 -71
- package/.bkit/core/docs/templates/bkit-audit-ci-performance.md +75 -72
- package/.bkit/core/docs/templates/bkit-audit-config.md +122 -76
- package/.bkit/core/docs/templates/bkit-audit-cost.md +85 -74
- package/.bkit/core/docs/templates/bkit-audit-coverage.md +75 -68
- package/.bkit/core/docs/templates/bkit-audit-database.md +101 -70
- package/.bkit/core/docs/templates/bkit-audit-dead-code.md +164 -83
- package/.bkit/core/docs/templates/bkit-audit-deferrals.md +115 -86
- package/.bkit/core/docs/templates/bkit-audit-dependencies.md +264 -88
- package/.bkit/core/docs/templates/bkit-audit-documentation.md +118 -93
- package/.bkit/core/docs/templates/bkit-audit-duplication.md +139 -86
- package/.bkit/core/docs/templates/bkit-audit-failures.md +110 -81
- package/.bkit/core/docs/templates/bkit-audit-flakes.md +99 -74
- package/.bkit/core/docs/templates/bkit-audit-gates.md +105 -77
- package/.bkit/core/docs/templates/bkit-audit-issues.md +104 -80
- package/.bkit/core/docs/templates/bkit-audit-llm.md +131 -58
- package/.bkit/core/docs/templates/bkit-audit-logs.md +123 -100
- package/.bkit/core/docs/templates/bkit-audit-models.md +98 -53
- package/.bkit/core/docs/templates/bkit-audit-privacy.md +56 -52
- package/.bkit/core/docs/templates/bkit-audit-prompts.md +63 -54
- package/.bkit/core/docs/templates/bkit-audit-red-team.md +124 -68
- package/.bkit/core/docs/templates/bkit-audit-reliability.md +95 -70
- package/.bkit/core/docs/templates/bkit-audit-repo.md +169 -73
- package/.bkit/core/docs/templates/bkit-audit-security.md +206 -96
- package/.bkit/core/docs/templates/bkit-audit-slop.md +77 -70
- package/.bkit/core/docs/templates/bkit-audit-testing.md +162 -114
- package/.bkit/core/docs/templates/bkit-audit-usability.md +113 -71
- package/.bkit/core/docs/templates/bkit-plan.md +138 -132
- package/.bkit/core/engine/checks/after/auth.ts +40 -37
- package/.bkit/core/engine/checks/after/ci-yml.ts +65 -2
- package/.bkit/core/engine/checks/after/index.ts +12 -2
- package/.bkit/core/engine/checks/after/tools.ts +80 -33
- package/.bkit/core/engine/checks/before/context-fetch.ts +227 -33
- package/.bkit/core/engine/checks/before/env.ts +1 -1
- package/.bkit/core/engine/checks/before/index.ts +7 -0
- package/.bkit/core/engine/checks/before/repo.ts +40 -0
- package/.bkit/core/engine/checks/status-holes.ts +916 -123
- package/.bkit/core/engine/checks/tips/catalogue.ts +68 -17
- package/.bkit/core/engine/checks/tips/detect.ts +32 -0
- package/.bkit/core/engine/checks/tips/index.ts +47 -6
- package/.bkit/core/engine/cli.ts +238 -84
- package/.bkit/core/engine/commands/analysis.ts +128 -76
- package/.bkit/core/engine/commands/ci/ci.ts +363 -29
- package/.bkit/core/engine/commands/ci/pins.ts +172 -0
- package/.bkit/core/engine/commands/ci/push-gate.ts +223 -0
- package/.bkit/core/engine/commands/install/uninstall.ts +21 -27
- package/.bkit/core/engine/commands/install/upgrade.ts +32 -15
- package/.bkit/core/engine/commands/land.ts +126 -11
- package/.bkit/core/engine/commands/lib.ts +303 -6
- package/.bkit/core/engine/commands/registry.ts +6 -2
- package/.bkit/core/engine/commands/setup/setup.ts +1 -0
- package/.bkit/core/engine/commands/stats.ts +91 -35
- package/.bkit/core/engine/commands/workflow/branches.ts +1477 -117
- package/.bkit/core/engine/commands/workflow/challenge.ts +114 -39
- package/.bkit/core/engine/commands/workflow/completeness.ts +109 -0
- package/.bkit/core/engine/commands/workflow/context.ts +433 -55
- package/.bkit/core/engine/commands/workflow/counters.ts +244 -39
- package/.bkit/core/engine/commands/workflow/decisions.ts +61 -17
- package/.bkit/core/engine/commands/workflow/disk.ts +237 -55
- package/.bkit/core/engine/commands/workflow/fids.ts +19 -1
- package/.bkit/core/engine/commands/workflow/issues.ts +6 -0
- package/.bkit/core/engine/commands/workflow/ledgers.ts +458 -18
- package/.bkit/core/engine/commands/workflow/locks.ts +2 -0
- package/.bkit/core/engine/commands/workflow/plan-blocks.ts +124 -15
- package/.bkit/core/engine/commands/workflow/plans.ts +257 -0
- package/.bkit/core/engine/commands/workflow/prs.ts +12 -3
- package/.bkit/core/engine/commands/workflow/repo.ts +8 -0
- package/.bkit/core/engine/commands/workflow/roadmap.ts +56 -15
- package/.bkit/core/engine/commands/workflow/run-facts.ts +22 -31
- package/.bkit/core/engine/commands/workflow/runs.ts +652 -34
- package/.bkit/core/engine/commands/workflow/runtime.ts +3 -0
- package/.bkit/core/engine/commands/workflow/skills.ts +1 -0
- package/.bkit/core/engine/commands/workflow/status.ts +200 -17
- package/.bkit/core/engine/commands/workflow/step-table.ts +75 -33
- package/.bkit/core/engine/commands/workflow/steps.ts +635 -24
- package/.bkit/core/engine/commands/workflow/summary-findings.ts +177 -0
- package/.bkit/core/engine/commands/workflow/summary.ts +192 -46
- package/.bkit/core/engine/commands/workflow/tasks.ts +409 -0
- package/.bkit/core/engine/commands/workflow/test-blocks.ts +254 -0
- package/.bkit/core/engine/commands/workflow/tests-changed.ts +201 -0
- package/.bkit/core/engine/commands/workflow/tests.ts +1285 -356
- package/.bkit/core/engine/commands/workflow/workflows.ts +228 -43
- package/.bkit/core/engine/commands/workflow/worktrees.ts +389 -47
- package/.bkit/core/engine/install/cloud-env.ts +251 -121
- package/.bkit/core/engine/install/context-ci-workflow.ts +102 -0
- package/.bkit/core/engine/install/manifest.ts +60 -12
- package/.bkit/core/engine/install/modules/antigravity.ts +3 -2
- package/.bkit/core/engine/install/modules/cloud.ts +3 -3
- package/.bkit/core/engine/install/modules/codex.ts +15 -2
- package/.bkit/core/engine/install/modules/core.ts +956 -52
- package/.bkit/core/engine/install/modules/cursor.ts +6 -6
- package/.bkit/core/engine/install/modules/opencode.ts +16 -4
- package/.bkit/core/engine/install/template-notes.ts +130 -0
- package/.bkit/core/engine/install/version-file.ts +3 -2
- package/.bkit/core/engine/install/write.ts +5 -0
- package/.bkit/core/engine/ledgers/compact.ts +124 -0
- package/.bkit/core/engine/ledgers/journal.ts +291 -0
- package/.bkit/core/engine/ledgers/status.ts +160 -9
- package/.bkit/core/engine/ledgers/telemetry.ts +158 -21
- package/.bkit/core/engine/render/hosts.ts +114 -14
- package/.bkit/core/engine/shared/bkit-latest.ts +26 -4
- package/.bkit/core/engine/shared/dep-updater.ts +60 -0
- package/.bkit/core/engine/shared/egress.ts +1 -1
- package/.bkit/core/engine/shared/package-manager.ts +9 -0
- package/.bkit/core/engine/shared/settings.ts +92 -17
- package/.bkit/core/engine/shared/timeouts.ts +2 -0
- package/.bkit/core/engine/tools/cli-doc.ts +111 -0
- package/.bkit/core/engine/tools/grammar-density.ts +1 -1
- package/.bkit/core/engine/tools/instructions-sources.ts +15 -17
- package/.bkit/core/engine/tools/instructions.ts +94 -43
- package/.bkit/core/hooks/antigravity-hook.js +25 -10
- package/.bkit/core/hooks/gateguard-engine.js +53 -29
- package/.bkit/core/hooks/guardrails-shell.js +4 -4
- package/.bkit/core/hooks/guardrails-tiers.js +3 -3
- package/.bkit/core/hooks/preflight-linear.sh +9 -9
- package/.bkit/core/hooks/preflight-rules.sh +8 -0
- package/.bkit/core/hooks/readguard-engine.js +29 -10
- package/.bkit/core/hooks/session-rules-advisory.js +61 -0
- package/.bkit/core/prompts/bkit-audit-generate.md +187 -116
- package/.bkit/core/prompts/bkit-build-challenge-1.md +56 -37
- package/.bkit/core/prompts/bkit-build-challenge-2.md +65 -45
- package/.bkit/core/prompts/bkit-build-install-skills.md +38 -29
- package/.bkit/core/prompts/bkit-build-plan-convert.md +43 -32
- package/.bkit/core/prompts/bkit-build-plan-current.md +49 -39
- package/.bkit/core/prompts/bkit-build-plan-gaps-remediate.md +79 -55
- package/.bkit/core/prompts/bkit-build-plan-tasks.md +149 -0
- package/.bkit/core/prompts/bkit-build-plan-tests.md +120 -0
- package/.bkit/core/prompts/bkit-build-plan-verify.md +87 -50
- package/.bkit/core/prompts/bkit-debug-abort-handover.md +36 -35
- package/.bkit/core/prompts/bkit-debug-failure-diagnose.md +96 -64
- package/.bkit/core/prompts/bkit-debug-failure-remediate.md +54 -45
- package/.bkit/core/prompts/bkit-debug-failure-reproduce.md +42 -33
- package/.bkit/core/prompts/bkit-debug-failure-soak.md +53 -37
- package/.bkit/core/prompts/bkit-design-brainstorm-ideate-1.md +35 -30
- package/.bkit/core/prompts/bkit-design-brainstorm-ideate-2.md +34 -29
- package/.bkit/core/prompts/bkit-design-brainstorm-ideate-3.md +32 -28
- package/.bkit/core/prompts/bkit-design-generate.md +68 -52
- package/.bkit/core/prompts/bkit-design-organise.md +73 -35
- package/.bkit/core/prompts/bkit-design-review-1.md +58 -54
- package/.bkit/core/prompts/bkit-design-review-2.md +54 -50
- package/.bkit/core/prompts/bkit-design-spike.md +54 -47
- package/.bkit/core/prompts/bkit-design-update.md +42 -31
- package/.bkit/core/prompts/bkit-plan-generate.md +76 -58
- package/.bkit/core/prompts/bkit-plan-review-1.md +63 -49
- package/.bkit/core/prompts/bkit-plan-review-2.md +60 -48
- package/.bkit/core/prompts/bkit-plan-scope-check.md +53 -46
- package/.bkit/core/prompts/bkit-plan-update.md +70 -52
- package/.bkit/core/prompts/bkit-ship-conflict-resolve.md +82 -50
- package/.bkit/core/prompts/bkit-ship-deferred-sweep.md +80 -45
- package/.bkit/core/prompts/bkit-ship-update-docs.md +35 -29
- package/.bkit/core/prompts/bkit-utility-compress-markdown.md +55 -49
- package/.bkit/core/prompts/bkit-utility-update-decisions.md +76 -49
- package/.bkit/core/prompts/bkit-utility-update-deferrals.md +70 -41
- package/.bkit/core/prompts/bkit-utility-update-documentation.md +33 -30
- package/.bkit/core/prompts/bkit-utility-update-failures.md +73 -43
- package/.bkit/core/prompts/bkit-utility-update-knowledge.md +77 -50
- package/.bkit/core/prompts/bkit-utility-update-roadmap.md +77 -45
- package/.bkit/core/prompts/bkit-utility-update-tracker.md +144 -68
- package/.bkit/core/workflows/bkit-auto.md +53 -30
- package/.bkit/core/workflows/bkit-build.md +635 -304
- package/.bkit/core/workflows/bkit-debug.md +301 -148
- package/.bkit/core/workflows/bkit-design.md +167 -95
- package/.bkit/core/workflows/bkit-plan.md +172 -84
- package/.bkit/core/workflows/bkit-ship.md +299 -152
- package/.bkit/shared/.agents/plugins/bkit/hooks.json +10 -0
- package/.bkit/shared/.claude/bkit-cloud.md +12 -10
- package/.bkit/shared/.claude/settings.json +3 -0
- package/.bkit/shared/.codex/bkit-cloud.md +98 -0
- package/.bkit/shared/.codex/hooks.json +20 -0
- package/.bkit/shared/.cursor/bkit-cloud.md +3 -3
- package/.bkit/shared/.opencode/opencode.json +1 -1
- package/.bkit/shared/CLAUDE.md +5 -1
- package/.bkit/shared/GEMINI.md +4 -1
- package/.bkit/shared/docs/architecture.md +4 -7
- package/.bkit/shared/docs/data-schema.md +4 -7
- package/.bkit/shared/docs/deployments.md +239 -166
- package/.bkit/shared/docs/design.md +11 -12
- package/.bkit/shared/docs/noise.md +8 -7
- package/.bkit/shared/docs/observability.md +5 -8
- package/.bkit/shared/docs/security.md +35 -17
- package/.bkit/shared/docs/setup.md +29 -18
- package/.bkit/shared/docs/technology.md +3 -6
- package/.bkit/shared/docs/testing.md +282 -176
- package/.bkit/shared/gitignore +6 -2
- package/.bkit/templates/.claude/hooks/bkit-cloud-bootstrap.sh +15 -16
- package/.bkit/templates/.cursor/Dockerfile +12 -8
- package/.bkit/templates/.cursor/environment.json +1 -1
- package/.bkit/templates/.github/ISSUE_TEMPLATE/bkit-bug.yml +10 -8
- package/.bkit/templates/.github/ISSUE_TEMPLATE/bkit-change.yml +24 -12
- package/.bkit/templates/.github/ISSUE_TEMPLATE/bkit-idea.yml +3 -3
- package/.bkit/templates/.github/renovate.json5 +34 -6
- package/.bkit/templates/.github/workflows/bkit-ci.yml +53 -50
- package/.bkit/templates/.github/workflows/bkit-cloud.yml +13 -14
- package/.bkit/templates/.github/workflows/bkit-health.yml +97 -0
- package/.bkit/templates/.github/workflows/bkit-renovate.yml +5 -4
- package/.bkit/templates/.github/workflows/bkit-trivy.yml +5 -4
- package/.bkit/templates/.husky/pre-commit +2 -2
- package/.bkit/templates/.husky/pre-push +95 -35
- package/.bkit/templates/.prettierignore +6 -7
- package/.bkit/templates/.vale.ini +27 -27
- package/.bkit/templates/context/bkit-cloudrun.md +23 -15
- package/.bkit/templates/context/bkit-expo.md +70 -52
- package/.bkit/templates/context/bkit-github.md +93 -56
- package/.bkit/templates/context/bkit-inngest.md +21 -15
- package/.bkit/templates/context/bkit-maestro.md +22 -16
- package/.bkit/templates/context/bkit-playwright.md +23 -17
- package/.bkit/templates/context/bkit-resend.md +12 -10
- package/.bkit/templates/context/bkit-sentry.md +30 -20
- package/.bkit/templates/context/bkit-serena.md +8 -7
- package/.bkit/templates/context/bkit-stripe.md +14 -13
- package/.bkit/templates/context/bkit-supabase.md +16 -13
- package/.bkit/templates/context/bkit-tavily.md +14 -11
- package/.bkit/templates/context/bkit-vercel.md +27 -18
- package/.bkit/templates/docs/capabilities.md +15 -14
- package/.bkit/templates/scripts/ci/{check-accepted-divergences.mjs → bkit-check-accepted-divergences.mjs} +6 -3
- package/.bkit/templates/scripts/ci/{check-accepted-divergences.test.mjs → bkit-check-accepted-divergences.test.mjs} +3 -3
- package/.bkit/templates/scripts/ci/{check-capstone.mjs → bkit-check-capstone.mjs} +2 -2
- package/.bkit/templates/scripts/ci/{check-capstone.test.mjs → bkit-check-capstone.test.mjs} +4 -4
- package/.bkit/templates/scripts/ci/{check-dependency-audit.mjs → bkit-check-dependency-audit.mjs} +103 -18
- package/.bkit/templates/scripts/ci/{check-dependency-audit.test.mjs → bkit-check-dependency-audit.test.mjs} +31 -3
- package/.bkit/templates/scripts/ci/bkit-machine-lock.sh +387 -0
- package/.bkit/templates/scripts/ci/bkit-test-awake.mjs +75 -0
- package/.bkit/templates/scripts/ci/bkit-test-awake.test.mjs +160 -0
- package/.bkit/templates/scripts/ci/lanes/{resolve-push-base.mjs → bkit-resolve-push-base.mjs} +3 -3
- package/.bkit/templates/scripts/ci/lanes/{resolve-push-base.test.mjs → bkit-resolve-push-base.test.mjs} +4 -4
- package/.bkit/templates/scripts/cleanup/bkit-disk-prune.mjs +9 -1
- package/.bkit/templates/scripts/graphify/bkit-graph-drift.py +1 -1
- package/.bkit/templates/scripts/graphify/bkit-graph-eager.py +3 -3
- package/.bkit/templates/scripts/graphify/bkit-graph-embed.py +63 -0
- package/.bkit/templates/scripts/graphify/bkit-graph-imports.py +2 -2
- package/.bkit/templates/scripts/graphify/bkit-graph-pre-push.sh +69 -18
- package/.bkit/templates/scripts/graphify/bkit-graph-repair.py +3 -3
- package/.bkit/templates/scripts/graphify/bkit-graph-surface.py +1 -1
- package/.bkit/templates/scripts/graphify/bkit-graphify-graphml.py +1 -1
- package/.bkit/templates/scripts/graphify/bkit-graphify-rollup.py +197 -126
- package/.bkit/templates/scripts/graphify/bkit-graphify.sh +64 -41
- package/.bkit/templates/scripts/slop/bkit-slop-type-suppression.mjs +23 -7
- package/.bkit/templates/slop-scan.config.json +9 -2
- package/CHANGELOG.md +119 -0
- package/README.md +250 -76
- package/dist/checks/after/auth.js +36 -33
- package/dist/checks/after/ci-yml.js +52 -2
- package/dist/checks/after/index.js +12 -4
- package/dist/checks/after/tools.js +73 -33
- package/dist/checks/before/context-fetch.js +218 -33
- package/dist/checks/before/env.js +1 -1
- package/dist/checks/before/index.js +6 -2
- package/dist/checks/before/repo.js +35 -1
- package/dist/checks/status-holes.js +739 -114
- package/dist/checks/tips/catalogue.js +59 -17
- package/dist/checks/tips/detect.js +30 -0
- package/dist/checks/tips/index.js +48 -6
- package/dist/cli.js +222 -84
- package/dist/commands/analysis.js +77 -53
- package/dist/commands/ci/ci.js +302 -25
- package/dist/commands/ci/pins.js +142 -0
- package/dist/commands/ci/push-gate.js +194 -0
- package/dist/commands/install/uninstall.js +23 -27
- package/dist/commands/install/upgrade.js +21 -11
- package/dist/commands/land.js +126 -10
- package/dist/commands/lib.js +244 -5
- package/dist/commands/registry.js +6 -2
- package/dist/commands/setup/setup.js +1 -0
- package/dist/commands/stats.js +69 -30
- package/dist/commands/workflow/branches.js +1232 -111
- package/dist/commands/workflow/challenge.js +90 -37
- package/dist/commands/workflow/completeness.js +97 -0
- package/dist/commands/workflow/context.js +371 -51
- package/dist/commands/workflow/counters.js +206 -40
- package/dist/commands/workflow/decisions.js +60 -17
- package/dist/commands/workflow/disk.js +213 -55
- package/dist/commands/workflow/fids.js +18 -1
- package/dist/commands/workflow/issues.js +6 -0
- package/dist/commands/workflow/ledgers.js +372 -21
- package/dist/commands/workflow/locks.js +2 -0
- package/dist/commands/workflow/plan-blocks.js +78 -14
- package/dist/commands/workflow/plans.js +205 -0
- package/dist/commands/workflow/prs.js +12 -3
- package/dist/commands/workflow/repo.js +6 -0
- package/dist/commands/workflow/roadmap.js +50 -17
- package/dist/commands/workflow/run-facts.js +23 -28
- package/dist/commands/workflow/runs.js +530 -33
- package/dist/commands/workflow/runtime.js +3 -0
- package/dist/commands/workflow/skills.js +1 -0
- package/dist/commands/workflow/status.js +166 -19
- package/dist/commands/workflow/step-table.js +61 -29
- package/dist/commands/workflow/steps.js +542 -26
- package/dist/commands/workflow/summary-findings.js +117 -0
- package/dist/commands/workflow/summary.js +154 -41
- package/dist/commands/workflow/tasks.js +378 -0
- package/dist/commands/workflow/test-blocks.js +231 -0
- package/dist/commands/workflow/tests-changed.js +172 -0
- package/dist/commands/workflow/tests.js +1013 -321
- package/dist/commands/workflow/workflows.js +191 -38
- package/dist/commands/workflow/worktrees.js +310 -42
- package/dist/install/cloud-env.js +233 -99
- package/dist/install/context-ci-workflow.js +85 -0
- package/dist/install/manifest.js +57 -12
- package/dist/install/modules/antigravity.js +3 -2
- package/dist/install/modules/cloud.js +3 -3
- package/dist/install/modules/codex.js +12 -2
- package/dist/install/modules/core.js +851 -53
- package/dist/install/modules/cursor.js +6 -6
- package/dist/install/modules/opencode.js +11 -5
- package/dist/install/template-notes.js +116 -0
- package/dist/install/version-file.js +3 -2
- package/dist/ledgers/compact.js +87 -0
- package/dist/ledgers/journal.js +233 -0
- package/dist/ledgers/status.js +115 -5
- package/dist/ledgers/telemetry.js +121 -17
- package/dist/render/hosts.js +100 -14
- package/dist/shared/bkit-latest.js +26 -4
- package/dist/shared/dep-updater.js +49 -0
- package/dist/shared/egress.js +1 -1
- package/dist/shared/package-manager.js +6 -0
- package/dist/shared/settings.js +59 -10
- package/dist/shared/timeouts.js +2 -0
- package/dist/tools/cli-doc.js +97 -0
- package/dist/tools/grammar-density.js +1 -1
- package/dist/tools/instructions-sources.js +15 -16
- package/dist/tools/instructions.js +83 -39
- package/package.json +58 -42
- package/.bkit/core/.bkit/lite.md +0 -73
- package/.bkit/core/engine/commands/workflow/workstreams.ts +0 -172
- package/.bkit/core/prompts/bkit-build-plan-execute.md +0 -124
- package/.bkit/templates/scripts/ci/bkit-local-stack-lock.sh +0 -194
- package/dist/commands/workflow/workstreams.js +0 -149
- /package/.bkit/templates/.vale/styles/{House → Bkit}/Filler.yml +0 -0
- /package/.bkit/templates/.vale/styles/{House → Bkit}/Hedging.yml +0 -0
- /package/.bkit/templates/.vale/styles/{House → Bkit}/LLMSlop.yml +0 -0
- /package/.bkit/templates/.vale/styles/{House → Bkit}/Verbose.yml +0 -0
- /package/.bkit/templates/scripts/ci/{accepted-advisories.json → bkit-accepted-advisories.json} +0 -0
- /package/.bkit/templates/scripts/ci/{accepted-divergences.json → bkit-accepted-divergences.json} +0 -0
- /package/.bkit/templates/scripts/launchd/{launchd.env.example → bkit-launchd.env.example} +0 -0
- /package/.bkit/templates/scripts/launchd/{ai.bkit.launchd.plist → bkit-launchd.plist} +0 -0
|
@@ -0,0 +1,194 @@
|
|
|
1
|
+
// Local full-gate receipts, shared by linked worktrees and bound to committed trees.
|
|
2
|
+
import { spawnSync } from "node:child_process";
|
|
3
|
+
import { createHash, randomUUID } from "node:crypto";
|
|
4
|
+
import * as fs from "node:fs";
|
|
5
|
+
import * as os from "node:os";
|
|
6
|
+
import * as path from "node:path";
|
|
7
|
+
import { gitEnv } from "../../ledgers/telemetry.js";
|
|
8
|
+
import { parseJson, readJsonFile } from "../../shared/json.js";
|
|
9
|
+
import { readPackageJson } from "../../shared/package-json.js";
|
|
10
|
+
import { scriptCommand, testCommand } from "../../shared/package-manager.js";
|
|
11
|
+
import { EXIT, git, outboxRoot, runGit } from "../lib.js";
|
|
12
|
+
import { changedOutside } from "../workflow/ledgers.js";
|
|
13
|
+
const UNIT = "bkit:gate:static-unit";
|
|
14
|
+
const INTEGRATION = "bkit:gate:static-unit-integration";
|
|
15
|
+
const SHA = /^(?:[0-9a-f]{40}|[0-9a-f]{64})$/;
|
|
16
|
+
function scriptsOf(pkg) {
|
|
17
|
+
if (!pkg || typeof pkg !== "object" || !("scripts" in pkg))
|
|
18
|
+
return null;
|
|
19
|
+
const scripts = pkg.scripts;
|
|
20
|
+
if (!scripts || typeof scripts !== "object" || Array.isArray(scripts))
|
|
21
|
+
return null;
|
|
22
|
+
return scripts;
|
|
23
|
+
}
|
|
24
|
+
function gateDefinition(pkg) {
|
|
25
|
+
const values = scriptsOf(pkg);
|
|
26
|
+
if (!values)
|
|
27
|
+
return null;
|
|
28
|
+
const gate = typeof values[INTEGRATION] === "string" ? INTEGRATION : UNIT;
|
|
29
|
+
if (typeof values[gate] !== "string" || values[gate].trim() === "")
|
|
30
|
+
return null;
|
|
31
|
+
const fingerprint = createHash("sha256")
|
|
32
|
+
.update(JSON.stringify(Object.entries(values).sort(([a], [b]) => a.localeCompare(b))))
|
|
33
|
+
.digest("hex");
|
|
34
|
+
return { gate, fingerprint };
|
|
35
|
+
}
|
|
36
|
+
/** The deepest full push gate declared by this checkout. */
|
|
37
|
+
export function requiredPushGate(cwd) {
|
|
38
|
+
const pkg = readPackageJson(cwd);
|
|
39
|
+
return pkg.ok ? (gateDefinition(pkg.pkg)?.gate ?? null) : null;
|
|
40
|
+
}
|
|
41
|
+
const receiptPath = (cwd, sha) => {
|
|
42
|
+
const outbox = outboxRoot(cwd);
|
|
43
|
+
return outbox ? path.join(outbox, "push-gates", `${sha}.json`) : null;
|
|
44
|
+
};
|
|
45
|
+
function cleanHead(cwd) {
|
|
46
|
+
const status = git(cwd, [
|
|
47
|
+
"status",
|
|
48
|
+
"--porcelain",
|
|
49
|
+
"--untracked-files=all",
|
|
50
|
+
"--ignore-submodules=none",
|
|
51
|
+
]);
|
|
52
|
+
if (status !== "")
|
|
53
|
+
return null;
|
|
54
|
+
const sha = git(cwd, ["rev-parse", "--verify", "HEAD^{commit}"]);
|
|
55
|
+
const tree = git(cwd, ["rev-parse", "--verify", "HEAD^{tree}"]);
|
|
56
|
+
return sha && tree ? { sha, tree } : null;
|
|
57
|
+
}
|
|
58
|
+
/** Execute a consumer gate; only a successful deepest full gate on an unchanged clean tree earns proof. */
|
|
59
|
+
export function runPushGate(cwd, gate, log) {
|
|
60
|
+
const pkg = readPackageJson(cwd);
|
|
61
|
+
const script = pkg.ok ? scriptsOf(pkg.pkg)?.[gate] : null;
|
|
62
|
+
if (typeof script !== "string" || script.trim() === "") {
|
|
63
|
+
log(`package.json must declare a non-empty ${gate} script`);
|
|
64
|
+
return EXIT.USAGE;
|
|
65
|
+
}
|
|
66
|
+
const definition = pkg.ok ? gateDefinition(pkg.pkg) : null;
|
|
67
|
+
const before = cleanHead(cwd);
|
|
68
|
+
const head = git(cwd, ["rev-parse", "--verify", "HEAD^{commit}"]);
|
|
69
|
+
const file = head ? receiptPath(cwd, head) : null;
|
|
70
|
+
const attempt = file && definition?.gate === gate ? path.join(`${file}.running`, randomUUID()) : null;
|
|
71
|
+
const fail = () => {
|
|
72
|
+
if (!attempt || !file)
|
|
73
|
+
return;
|
|
74
|
+
fs.mkdirSync(path.dirname(file), { recursive: true });
|
|
75
|
+
fs.writeFileSync(`${file}.failed`, JSON.stringify({ version: 1, sha: head, gate, passed: false }) + "\n");
|
|
76
|
+
fs.rmSync(file, { force: true });
|
|
77
|
+
};
|
|
78
|
+
if (attempt) {
|
|
79
|
+
fs.mkdirSync(path.dirname(attempt), { recursive: true });
|
|
80
|
+
fs.writeFileSync(attempt, JSON.stringify({ pid: process.pid, sha: head }) + "\n");
|
|
81
|
+
fail();
|
|
82
|
+
}
|
|
83
|
+
const finish = (code) => {
|
|
84
|
+
if (attempt)
|
|
85
|
+
fs.rmSync(attempt, { force: true });
|
|
86
|
+
return code;
|
|
87
|
+
};
|
|
88
|
+
const argv = testCommand(scriptCommand(gate));
|
|
89
|
+
log(`running ${scriptCommand(gate).join(" ")}`);
|
|
90
|
+
const result = spawnSync(argv[0], argv.slice(1), {
|
|
91
|
+
cwd,
|
|
92
|
+
env: gitEnv(),
|
|
93
|
+
stdio: ["ignore", 2, 2],
|
|
94
|
+
});
|
|
95
|
+
const status = result.error
|
|
96
|
+
? 127
|
|
97
|
+
: (result.status ??
|
|
98
|
+
128 + ((result.signal ? os.constants.signals[result.signal] : undefined) ?? 1));
|
|
99
|
+
if (result.error)
|
|
100
|
+
log(result.error.message);
|
|
101
|
+
if (status !== 0 || !before || definition?.gate !== gate) {
|
|
102
|
+
fail();
|
|
103
|
+
return finish(status);
|
|
104
|
+
}
|
|
105
|
+
const after = cleanHead(cwd);
|
|
106
|
+
const afterPkg = readPackageJson(cwd);
|
|
107
|
+
if (after?.sha !== before.sha ||
|
|
108
|
+
after.tree !== before.tree ||
|
|
109
|
+
!afterPkg.ok ||
|
|
110
|
+
gateDefinition(afterPkg.pkg)?.fingerprint !== definition.fingerprint) {
|
|
111
|
+
log("full gate passed, but the checkout changed — no reusable push receipt");
|
|
112
|
+
fail();
|
|
113
|
+
return finish(status);
|
|
114
|
+
}
|
|
115
|
+
if (file) {
|
|
116
|
+
fs.mkdirSync(path.dirname(file), { recursive: true });
|
|
117
|
+
fs.writeFileSync(file, JSON.stringify({ version: 1, ...before, ...definition, passed: true }) + "\n");
|
|
118
|
+
fs.rmSync(`${file}.failed`, { force: true });
|
|
119
|
+
log(`recorded full push gate for ${before.sha}`);
|
|
120
|
+
}
|
|
121
|
+
return finish(status);
|
|
122
|
+
}
|
|
123
|
+
/** Pending files survive interrupted runners; one read suffices to block earlier proof. */
|
|
124
|
+
function pendingAttempt(file) {
|
|
125
|
+
const dir = `${file}.running`;
|
|
126
|
+
if (!fs.existsSync(dir))
|
|
127
|
+
return false;
|
|
128
|
+
const handle = fs.opendirSync(dir);
|
|
129
|
+
try {
|
|
130
|
+
return handle.readSync() !== null;
|
|
131
|
+
}
|
|
132
|
+
finally {
|
|
133
|
+
handle.closeSync();
|
|
134
|
+
}
|
|
135
|
+
}
|
|
136
|
+
function validReceipt(cwd, file, sha, definition) {
|
|
137
|
+
const read = readJsonFile(file);
|
|
138
|
+
if (!read.ok || !read.value || typeof read.value !== "object")
|
|
139
|
+
return false;
|
|
140
|
+
const receipt = read.value;
|
|
141
|
+
return (receipt.version === 1 &&
|
|
142
|
+
receipt.passed === true &&
|
|
143
|
+
receipt.sha === sha &&
|
|
144
|
+
receipt.gate === definition.gate &&
|
|
145
|
+
receipt.fingerprint === definition.fingerprint &&
|
|
146
|
+
receipt.tree === git(cwd, ["rev-parse", `${sha}^{tree}`]));
|
|
147
|
+
}
|
|
148
|
+
/** Every commit not covered by this success must be free of failed or unreadable gate evidence. */
|
|
149
|
+
function noLaterFailure(cwd, dir, sha, newSha, definition) {
|
|
150
|
+
const range = git(cwd, ["rev-list", "--max-count=129", newSha, `^${sha}`]);
|
|
151
|
+
if (range === null)
|
|
152
|
+
return false;
|
|
153
|
+
const commits = range ? range.split("\n") : [];
|
|
154
|
+
if (commits.length > 128)
|
|
155
|
+
return false;
|
|
156
|
+
for (const commit of [sha, ...commits]) {
|
|
157
|
+
const file = path.join(dir, `${commit}.json`);
|
|
158
|
+
if (fs.existsSync(`${file}.failed`) ||
|
|
159
|
+
pendingAttempt(file) ||
|
|
160
|
+
(fs.existsSync(file) && !validReceipt(cwd, file, commit, definition)))
|
|
161
|
+
return false;
|
|
162
|
+
}
|
|
163
|
+
return true;
|
|
164
|
+
}
|
|
165
|
+
/** A bounded ancestor search; absent, malformed or stale proof always requires the full gate. */
|
|
166
|
+
export function hasVerifiedIncrement(cwd, oldSha, newSha, paths) {
|
|
167
|
+
if (!SHA.test(oldSha) ||
|
|
168
|
+
!SHA.test(newSha) ||
|
|
169
|
+
/^0+$/.test(oldSha) ||
|
|
170
|
+
!runGit(cwd, ["merge-base", "--is-ancestor", oldSha, newSha]).ok)
|
|
171
|
+
return false;
|
|
172
|
+
const raw = git(cwd, ["show", `${newSha}:package.json`]);
|
|
173
|
+
const parsed = raw === null ? null : parseJson(raw);
|
|
174
|
+
const definition = parsed?.ok ? gateDefinition(parsed.value) : null;
|
|
175
|
+
const localPkg = readPackageJson(cwd);
|
|
176
|
+
if (!definition ||
|
|
177
|
+
!localPkg.ok ||
|
|
178
|
+
gateDefinition(localPkg.pkg)?.fingerprint !== definition.fingerprint)
|
|
179
|
+
return false;
|
|
180
|
+
const ancestors = git(cwd, ["rev-list", "--max-count=128", oldSha]);
|
|
181
|
+
const firstFile = receiptPath(cwd, oldSha);
|
|
182
|
+
if (!ancestors || !firstFile)
|
|
183
|
+
return false;
|
|
184
|
+
const dir = path.dirname(firstFile);
|
|
185
|
+
for (const sha of ancestors.split("\n")) {
|
|
186
|
+
const file = path.join(dir, `${sha}.json`);
|
|
187
|
+
if (!validReceipt(cwd, file, sha, definition))
|
|
188
|
+
continue;
|
|
189
|
+
const diff = changedOutside(cwd, sha, newSha, paths);
|
|
190
|
+
if (diff.ok && diff.outside.length === 0 && noLaterFailure(cwd, dir, sha, newSha, definition))
|
|
191
|
+
return true;
|
|
192
|
+
}
|
|
193
|
+
return false;
|
|
194
|
+
}
|
|
@@ -35,7 +35,7 @@ import { applyModelOverrides, buildOpencodeModelLookup, parseEffortMap, } from "
|
|
|
35
35
|
import { readInstallingVersion } from "../../shared/package-json.js";
|
|
36
36
|
import { readBkitConfig } from "../../shared/settings.js";
|
|
37
37
|
import { SEEDED_BKIT_DEFAULTS } from "../../install/modules/core.js";
|
|
38
|
-
import { CLAUDE_CLOUD_RELPATH, CURSOR_CLOUD_RELPATH, resolveClaudeDerivedAllows, } from "../../install/cloud-env.js";
|
|
38
|
+
import { CLAUDE_CLOUD_RELPATH, CODEX_CLOUD_RELPATH, CURSOR_CLOUD_RELPATH, resolveClaudeDerivedAllows, } from "../../install/cloud-env.js";
|
|
39
39
|
import { LOG_PREFIX, setLogPrefix } from "../../shared/log-prefix.js";
|
|
40
40
|
import { unusedTrackerMcpServers } from "../../checks/before/mcp.js";
|
|
41
41
|
// ---------------------------------------------------------------------------
|
|
@@ -258,8 +258,10 @@ const CORE_TEMPLATE_DOCTRINE = [
|
|
|
258
258
|
{ path: ".agents/docs.md", format: "markered-text", module: "core" },
|
|
259
259
|
{ path: ".agents/rules.md", format: "markered-text", module: "core" },
|
|
260
260
|
{ path: ".agents/skills.md", format: "markered-text", module: "core" },
|
|
261
|
-
// Retired
|
|
261
|
+
// Retired `.agents/shortcuts.md` (5.1.0 – 5.2.4), for an install never upgraded since.
|
|
262
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" },
|
|
263
265
|
];
|
|
264
266
|
/**
|
|
265
267
|
* The top-level `docs/*.md` the core payload pass installs: each carries bkit's managed
|
|
@@ -752,31 +754,25 @@ export async function runUninstall(modules, ctx) {
|
|
|
752
754
|
}
|
|
753
755
|
}
|
|
754
756
|
}
|
|
755
|
-
// Remove
|
|
756
|
-
// secrets).
|
|
757
|
-
//
|
|
758
|
-
//
|
|
759
|
-
|
|
760
|
-
|
|
761
|
-
|
|
762
|
-
|
|
763
|
-
|
|
764
|
-
|
|
765
|
-
|
|
766
|
-
|
|
767
|
-
|
|
768
|
-
|
|
769
|
-
|
|
770
|
-
|
|
771
|
-
|
|
772
|
-
|
|
773
|
-
|
|
774
|
-
if (fs.existsSync(cloudAbs)) {
|
|
775
|
-
result.deleted.push(CURSOR_CLOUD_RELPATH);
|
|
776
|
-
if (!ctx.dryRun) {
|
|
777
|
-
fs.rmSync(cloudAbs, { force: true });
|
|
778
|
-
console.log(`${ctx.logPrefix} delete: ${CURSOR_CLOUD_RELPATH} (generated cloud setup doc)`);
|
|
779
|
-
}
|
|
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)`);
|
|
780
776
|
}
|
|
781
777
|
}
|
|
782
778
|
// Full/core uninstall: the consumer's template copies (`.bkit/templates/`) are
|
|
@@ -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
|
@@ -6,12 +6,19 @@
|
|
|
6
6
|
// dev and push again, with backoff. Used by the design / plan close, the
|
|
7
7
|
// build / debug roadmap mirror, ship's close and FAILED record, and the
|
|
8
8
|
// own-commit push of a debug run in place on dev, which replays the run's
|
|
9
|
-
// commits. The throwaway runs
|
|
10
|
-
|
|
9
|
+
// commits. The throwaway runs its declared gate explicitly before pushing.
|
|
10
|
+
import { spawnSync } from "node:child_process";
|
|
11
11
|
import * as fs from "node:fs";
|
|
12
12
|
import * as path from "node:path";
|
|
13
13
|
import { CommandError, DEV, EXIT, git, runGit } from "./lib.js";
|
|
14
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";
|
|
15
22
|
const REMOTE = "origin";
|
|
16
23
|
const UPSTREAM = `${REMOTE}/${DEV}`;
|
|
17
24
|
/** dev moved before git sent anything: git compared the remote's dev and stopped. */
|
|
@@ -20,6 +27,20 @@ const MOVED_BEFORE = /\[rejected\][^\n]*\((?:fetch first|non-fast-forward)\)/;
|
|
|
20
27
|
const MOVED_DURING = /\[remote rejected\][^\n]*\((?:incorrect old value provided|cannot lock ref[^\n]*)\)/;
|
|
21
28
|
/** The server turned the push away: branch protection, a ruleset, an HTTP 403. */
|
|
22
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);
|
|
23
44
|
/** A dev push rejected only because dev moved: rebuild on the new dev, push again. */
|
|
24
45
|
export const devMoved = (stderr) => MOVED_BEFORE.test(stderr) || MOVED_DURING.test(stderr);
|
|
25
46
|
/** A dev push the server refused for a reason other than dev moving. */
|
|
@@ -81,27 +102,119 @@ export async function withoutHooks(fn) {
|
|
|
81
102
|
delete process.env[value];
|
|
82
103
|
}
|
|
83
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
|
+
}
|
|
84
187
|
/**
|
|
85
188
|
* Land on dev what `build` makes: per attempt, fetch dev, add `dir` detached at
|
|
86
189
|
* origin/dev, let `build` make one or more commits there (a bookkeeping commit,
|
|
87
|
-
* or a replay of a run's commits), push `HEAD:dev
|
|
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`
|
|
88
192
|
* throwing stops the landing with that throw. A server refusal runs `refused` on
|
|
89
|
-
* the built commits first, when given.
|
|
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.
|
|
90
196
|
*/
|
|
91
197
|
export async function pushToDev(o) {
|
|
92
|
-
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");
|
|
93
199
|
for (let attempt = 1;; attempt++) {
|
|
94
200
|
let wait = 0;
|
|
95
201
|
dropLandTree(o.root, o.dir);
|
|
96
202
|
try {
|
|
97
203
|
const outcome = await withoutHooks(async () => {
|
|
98
|
-
const fetched =
|
|
99
|
-
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";
|
|
100
208
|
return { kind: "fetch-failed", stderr: fetched.stderr };
|
|
209
|
+
}
|
|
101
210
|
const added = runGit(o.root, ["worktree", "add", "--detach", o.dir, UPSTREAM]);
|
|
102
211
|
if (!added.ok)
|
|
103
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");
|
|
104
216
|
o.build(o.dir, attempt);
|
|
217
|
+
checkLanding(o.root, o.dir, base, o.log);
|
|
105
218
|
const pushed = runGit(o.dir, ["push", REMOTE, `HEAD:${DEV}`]);
|
|
106
219
|
if (pushed.ok) {
|
|
107
220
|
return {
|
|
@@ -116,14 +229,17 @@ export async function pushToDev(o) {
|
|
|
116
229
|
}
|
|
117
230
|
if (!devMoved(pushed.stderr))
|
|
118
231
|
return { kind: "push-failed", stderr: pushed.stderr };
|
|
119
|
-
return
|
|
232
|
+
return "moved";
|
|
120
233
|
});
|
|
121
|
-
if (outcome !==
|
|
234
|
+
if (typeof outcome !== "string")
|
|
122
235
|
return outcome;
|
|
123
236
|
if (attempt >= TIMEOUTS.LAND_ATTEMPTS)
|
|
124
237
|
return { kind: "exhausted", attempts: attempt };
|
|
125
238
|
wait = landBackoffMs(attempt);
|
|
126
|
-
|
|
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`);
|
|
127
243
|
}
|
|
128
244
|
finally {
|
|
129
245
|
dropLandTree(o.root, o.dir);
|