@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,387 @@
|
|
|
1
|
+
#!/bin/bash
|
|
2
|
+
# Example. Copy into scripts/ci/ and own it.
|
|
3
|
+
# bkit install does not write this file and does not overwrite a copy.
|
|
4
|
+
#
|
|
5
|
+
# bkit-machine-lock.sh — machine-wide named locks and the checkout's shared stack lock.
|
|
6
|
+
#
|
|
7
|
+
# . scripts/ci/bkit-machine-lock.sh
|
|
8
|
+
# take_local_stack_lock "<who>" [name] # waits, returns 1 on refusal
|
|
9
|
+
# try_local_stack_lock "<who>" [name] # returns 1 immediately while busy
|
|
10
|
+
# release_local_stack_lock [name] # optional; caller exit also frees the lock
|
|
11
|
+
# local_stack_lock_holder [name]
|
|
12
|
+
# local_stack_lock_file [name]
|
|
13
|
+
#
|
|
14
|
+
# package.json: wrap test gates with
|
|
15
|
+
# bash scripts/ci/bkit-machine-lock.sh run --lock tests -- <gate command> [args…]
|
|
16
|
+
# run ["<who>"] [--lock <name>] -- <command> exits with the command's status:
|
|
17
|
+
# 2 usage, 73 the lock could not be taken, 75 the wait gave up.
|
|
18
|
+
# The run name defaults to LOCAL_STACK_LOCK_WHO, npm_lifecycle_event, then run.
|
|
19
|
+
# TERM, INT and HUP defer cancellation until the foreground command ends, keeping
|
|
20
|
+
# its lock held throughout; the wrapper then returns the signal's exit status.
|
|
21
|
+
#
|
|
22
|
+
# Named locks live in ${XDG_CACHE_HOME:-$HOME/.cache}/bkit/machine-lock/ with no
|
|
23
|
+
# repository prefix. The unnamed stack lock keeps its local-stack-lock/ path and
|
|
24
|
+
# LOCAL_STACK_LOCK_OWNER / LOCAL_STACK_LOCK_PID names, so adopted copies still work.
|
|
25
|
+
# Named owners use LOCAL_STACK_LOCK_OWNER_<key> and LOCAL_STACK_LOCK_PID_<key>.
|
|
26
|
+
# Each holder records its checkout, process id and start time.
|
|
27
|
+
#
|
|
28
|
+
# Take locks in this order: tests, other named locks, then the unnamed stack lock.
|
|
29
|
+
# A child reuses only the named or unnamed lock its live parent holds.
|
|
30
|
+
# BKIT_TEST_SLOTS sets the tests slots (whole number >= 1, default 1). Taking tests
|
|
31
|
+
# exports BKIT_TEST_WORKERS=max(1, floor(cores / slots) - 1) for the runner to use.
|
|
32
|
+
# LOCAL_STACK_LOCK_WAIT_S caps the wait; otherwise it is 60s without a TTY, 3600s
|
|
33
|
+
# with a TTY. Named releases save each checkout's held seconds in <name>.last.
|
|
34
|
+
# Waiting notes name every holder and that checkout's last run. CI=true / CI=1 is a no-op.
|
|
35
|
+
# A Perl flock holder exits within a second of its caller; killed callers leave no stale lock.
|
|
36
|
+
# Requires Bash 3.2+ and /usr/bin/perl.
|
|
37
|
+
|
|
38
|
+
_LOCAL_STACK_LOCK_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
|
|
39
|
+
_LOCAL_STACK_LOCK_ROOT="$(git -C "$_LOCAL_STACK_LOCK_DIR" rev-parse --show-toplevel 2>/dev/null || echo "$_LOCAL_STACK_LOCK_DIR")"
|
|
40
|
+
LOCAL_STACK_LOCK_PID="${LOCAL_STACK_LOCK_PID:-}"
|
|
41
|
+
_LOCAL_STACK_LOCK_EXIT=73
|
|
42
|
+
|
|
43
|
+
# The stack's name: BKIT_LOCAL_STACK, else the main checkout's folder name, the same from every
|
|
44
|
+
# worktree. Characters outside A-Z a-z 0-9 . _ - become _.
|
|
45
|
+
local_stack_lock_name() {
|
|
46
|
+
_lsl_name="${BKIT_LOCAL_STACK:-}"
|
|
47
|
+
if [ -z "$_lsl_name" ]; then
|
|
48
|
+
_lsl_common="$(git -C "$_LOCAL_STACK_LOCK_DIR" rev-parse --path-format=absolute --git-common-dir 2>/dev/null)" || return 1
|
|
49
|
+
[ -n "$_lsl_common" ] || return 1
|
|
50
|
+
case "$(basename "$_lsl_common")" in
|
|
51
|
+
.git) _lsl_name="$(basename "$(dirname "$_lsl_common")")" ;;
|
|
52
|
+
*) _lsl_name="$(basename "$_lsl_common" .git)" ;;
|
|
53
|
+
esac
|
|
54
|
+
fi
|
|
55
|
+
printf '%s\n' "$_lsl_name" | LC_ALL=C tr -c 'A-Za-z0-9._\n-' '_'
|
|
56
|
+
}
|
|
57
|
+
|
|
58
|
+
# A named lock has one machine-wide path; the unnamed path remains stack-scoped.
|
|
59
|
+
local_stack_lock_file() {
|
|
60
|
+
local _lsl_stack
|
|
61
|
+
if [ -n "${1:-}" ]; then
|
|
62
|
+
_lsl_stack="$(printf '%s' "$1" | LC_ALL=C tr -c 'A-Za-z0-9._-' '_')"
|
|
63
|
+
echo "${XDG_CACHE_HOME:-$HOME/.cache}/bkit/machine-lock/${_lsl_stack}.lock"
|
|
64
|
+
else
|
|
65
|
+
_lsl_stack="$(local_stack_lock_name)" || return 1
|
|
66
|
+
echo "${XDG_CACHE_HOME:-$HOME/.cache}/bkit/local-stack-lock/${_lsl_stack}.lock"
|
|
67
|
+
fi
|
|
68
|
+
}
|
|
69
|
+
|
|
70
|
+
# "<who> — <checkout> (pid N, since HH:MM:SS)" for the run holding the lock.
|
|
71
|
+
local_stack_lock_holder() {
|
|
72
|
+
local _lsl_held _lsl_slot
|
|
73
|
+
_lsl_held="$(local_stack_lock_file "${1:-}")" || return 0
|
|
74
|
+
if [ -f "${_lsl_held}.holder" ]; then
|
|
75
|
+
cat "${_lsl_held}.holder"
|
|
76
|
+
fi
|
|
77
|
+
if [ "${1:-}" = tests ]; then
|
|
78
|
+
for _lsl_slot in "${_lsl_held%.lock}".[0-9]*.lock.holder; do
|
|
79
|
+
[ -f "$_lsl_slot" ] && cat "$_lsl_slot"
|
|
80
|
+
done
|
|
81
|
+
fi
|
|
82
|
+
return 0
|
|
83
|
+
}
|
|
84
|
+
|
|
85
|
+
_local_stack_lock_slots() {
|
|
86
|
+
_lsl_slots="${BKIT_TEST_SLOTS-1}"
|
|
87
|
+
case "$_lsl_slots" in
|
|
88
|
+
*[!0-9]*|"") _lsl_slots=0 ;;
|
|
89
|
+
*) _lsl_slots=$((10#$_lsl_slots)) ;;
|
|
90
|
+
esac
|
|
91
|
+
if [ "$_lsl_slots" -lt 1 ]; then
|
|
92
|
+
if [ "${_LOCAL_STACK_LOCK_SLOTS_NOTED:-}" != 1 ]; then
|
|
93
|
+
echo "[machine-lock] invalid BKIT_TEST_SLOTS; using 1 slot" >&2
|
|
94
|
+
_LOCAL_STACK_LOCK_SLOTS_NOTED=1
|
|
95
|
+
fi
|
|
96
|
+
_lsl_slots=1
|
|
97
|
+
fi
|
|
98
|
+
}
|
|
99
|
+
|
|
100
|
+
_local_stack_lock_workers() {
|
|
101
|
+
local _lsl_cores="" _lsl_probe
|
|
102
|
+
for _lsl_probe in getconf nproc sysctl; do
|
|
103
|
+
case "$_lsl_probe" in
|
|
104
|
+
getconf) _lsl_cores="$(getconf _NPROCESSORS_ONLN 2>/dev/null)" || continue ;;
|
|
105
|
+
nproc) _lsl_cores="$(nproc 2>/dev/null)" || continue ;;
|
|
106
|
+
sysctl) _lsl_cores="$(sysctl -n hw.ncpu 2>/dev/null)" || continue ;;
|
|
107
|
+
esac
|
|
108
|
+
case "$_lsl_cores" in *[!0-9]*|""|0) continue ;; esac
|
|
109
|
+
break
|
|
110
|
+
done
|
|
111
|
+
case "$_lsl_cores" in *[!0-9]*|""|0) _lsl_cores=1 ;; esac
|
|
112
|
+
BKIT_TEST_WORKERS=$((_lsl_cores / _lsl_slots - 1))
|
|
113
|
+
[ "$BKIT_TEST_WORKERS" -ge 1 ] || BKIT_TEST_WORKERS=1
|
|
114
|
+
export BKIT_TEST_WORKERS
|
|
115
|
+
}
|
|
116
|
+
|
|
117
|
+
_local_stack_lock_vars() {
|
|
118
|
+
local _lsl_key
|
|
119
|
+
_lsl_key="$(printf '%s' "${1:-}" | LC_ALL=C tr -c 'A-Za-z0-9._-' '_')"
|
|
120
|
+
_lsl_key="${_lsl_key//_/__}"
|
|
121
|
+
_lsl_key="${_lsl_key//-/_h}"
|
|
122
|
+
_lsl_key="${_lsl_key//./_d}"
|
|
123
|
+
_lsl_pid_var="LOCAL_STACK_LOCK_PID"
|
|
124
|
+
_lsl_owner_var="LOCAL_STACK_LOCK_OWNER"
|
|
125
|
+
_lsl_name_var="LOCAL_STACK_LOCK_NAME"
|
|
126
|
+
if [ -n "${1:-}" ]; then
|
|
127
|
+
_lsl_pid_var="${_lsl_pid_var}_${_lsl_key}"
|
|
128
|
+
_lsl_owner_var="${_lsl_owner_var}_${_lsl_key}"
|
|
129
|
+
_lsl_name_var="${_lsl_name_var}_${_lsl_key}"
|
|
130
|
+
fi
|
|
131
|
+
}
|
|
132
|
+
|
|
133
|
+
_local_stack_lock() {
|
|
134
|
+
local _lsl_mode="$1" _lsl_who="$2" _lsl_name="${3:-}"
|
|
135
|
+
local _lsl_pid_var _lsl_owner_var _lsl_name_var _lsl_owner _lsl_existing
|
|
136
|
+
local _lsl_file _lsl_label _lsl_fifo _lsl_pid _lsl_reply _lsl_checkout
|
|
137
|
+
local _lsl_slots=1 _lsl_wait _lsl_var _lsl_held_name _lsl_held_name_var
|
|
138
|
+
_LOCAL_STACK_LOCK_EXIT=73
|
|
139
|
+
_local_stack_lock_vars "$_lsl_name"
|
|
140
|
+
_lsl_owner="${!_lsl_owner_var:-}"
|
|
141
|
+
_lsl_existing="${!_lsl_pid_var:-}"
|
|
142
|
+
if [ "${CI:-}" = "true" ] || [ "${CI:-}" = "1" ]; then return 0; fi
|
|
143
|
+
if [ "$_lsl_name" = tests ]; then
|
|
144
|
+
_local_stack_lock_slots
|
|
145
|
+
_local_stack_lock_workers
|
|
146
|
+
fi
|
|
147
|
+
if [ -n "$_lsl_owner" ] && kill -0 "$_lsl_owner" 2>/dev/null; then return 0; fi
|
|
148
|
+
if [ -n "$_lsl_existing" ] && kill -0 "$_lsl_existing" 2>/dev/null; then return 0; fi
|
|
149
|
+
if [ -n "$_lsl_name" ]; then
|
|
150
|
+
for _lsl_var in ${!LOCAL_STACK_LOCK_OWNER*}; do
|
|
151
|
+
_lsl_owner="${!_lsl_var:-}"
|
|
152
|
+
[ -n "$_lsl_owner" ] && kill -0 "$_lsl_owner" 2>/dev/null || continue
|
|
153
|
+
if [ "$_lsl_var" = LOCAL_STACK_LOCK_OWNER ] || [ "$_lsl_name" = tests ]; then
|
|
154
|
+
_lsl_held_name_var="${_lsl_var/OWNER/NAME}"
|
|
155
|
+
_lsl_held_name="${!_lsl_held_name_var:-the unnamed stack lock}"
|
|
156
|
+
echo "[machine-lock] ❌ cannot take $_lsl_name while holding $_lsl_held_name: lock order is tests, other named locks, then the unnamed stack lock" >&2
|
|
157
|
+
return 1
|
|
158
|
+
fi
|
|
159
|
+
done
|
|
160
|
+
fi
|
|
161
|
+
if [ "${LOCAL_STACK_LOCK_WAIT_S+x}" = x ]; then
|
|
162
|
+
_lsl_wait="$LOCAL_STACK_LOCK_WAIT_S"
|
|
163
|
+
elif [ -t 0 ]; then
|
|
164
|
+
_lsl_wait=3600
|
|
165
|
+
else
|
|
166
|
+
_lsl_wait=60
|
|
167
|
+
fi
|
|
168
|
+
|
|
169
|
+
if ! _lsl_file="$(local_stack_lock_file "$_lsl_name")"; then
|
|
170
|
+
echo "[machine-lock] ❌ cannot name the local stack: run inside a git checkout, or set BKIT_LOCAL_STACK" >&2
|
|
171
|
+
return 1
|
|
172
|
+
fi
|
|
173
|
+
_lsl_label="the local stack $(basename "$_lsl_file" .lock)"
|
|
174
|
+
_lsl_checkout="$_LOCAL_STACK_LOCK_ROOT"
|
|
175
|
+
if [ -n "$_lsl_name" ]; then
|
|
176
|
+
_lsl_label="$_lsl_name"
|
|
177
|
+
_lsl_checkout="$(git -C "$PWD" rev-parse --show-toplevel 2>/dev/null || printf '%s' "$PWD")"
|
|
178
|
+
fi
|
|
179
|
+
if [ ! -x /usr/bin/perl ]; then
|
|
180
|
+
echo "[machine-lock] ❌ could not take the lock for $_lsl_label: /usr/bin/perl not found" >&2
|
|
181
|
+
return 1
|
|
182
|
+
fi
|
|
183
|
+
if ! mkdir -p "$(dirname "$_lsl_file")"; then
|
|
184
|
+
echo "[machine-lock] ❌ could not take the lock for $_lsl_label: cannot create $(dirname "$_lsl_file")" >&2
|
|
185
|
+
return 1
|
|
186
|
+
fi
|
|
187
|
+
_lsl_fifo="$(mktemp -u "${TMPDIR:-/tmp}/local-stack-lock.XXXXXX")"
|
|
188
|
+
mkfifo "$_lsl_fifo" || return 1
|
|
189
|
+
|
|
190
|
+
# The holder answers on the fifo once: ok, busy <holder>, timeout <holder> or error <why>.
|
|
191
|
+
/usr/bin/perl -e '
|
|
192
|
+
use strict;
|
|
193
|
+
use Fcntl qw(:flock);
|
|
194
|
+
use File::Glob qw(bsd_glob);
|
|
195
|
+
use POSIX qw(strftime);
|
|
196
|
+
my ($file, $owner, $who, $checkout, $fifo, $wait_s, $mode, $label, $slots, $name) = @ARGV;
|
|
197
|
+
# The caller is the parent of this process. When it exits, this process goes to init (or a
|
|
198
|
+
# subreaper) at once, while `kill 0` would still find it until whoever started it reaps it.
|
|
199
|
+
my $parent = getppid();
|
|
200
|
+
my $caller_alive = sub { getppid() == $parent };
|
|
201
|
+
open(my $out, ">", $fifo) or exit 1;
|
|
202
|
+
$out->autoflush(1);
|
|
203
|
+
my $stem = $file; $stem =~ s/\.lock$//;
|
|
204
|
+
my $history = "$stem.last";
|
|
205
|
+
my $holder = sub {
|
|
206
|
+
my @files = ("$file.holder");
|
|
207
|
+
push @files, grep { /^\Q$stem\E\.\d+\.lock\.holder$/ } bsd_glob("$stem.*.lock.holder") if $name eq "tests";
|
|
208
|
+
my @holders;
|
|
209
|
+
for my $held (@files) {
|
|
210
|
+
open(my $h, "<", $held) or next;
|
|
211
|
+
my $line = <$h>; close $h;
|
|
212
|
+
next unless defined $line;
|
|
213
|
+
chomp $line;
|
|
214
|
+
if (length $name) {
|
|
215
|
+
my ($held_checkout) = $line =~ / — (.*) \(pid /;
|
|
216
|
+
my $duration;
|
|
217
|
+
if (defined $held_checkout && open(my $last, "<", $history)) {
|
|
218
|
+
while (my $row = <$last>) {
|
|
219
|
+
chomp $row;
|
|
220
|
+
my ($path, $seconds) = split /\t/, $row, 2;
|
|
221
|
+
$duration = $seconds if $path eq $held_checkout && defined $seconds && $seconds =~ /^\d+$/;
|
|
222
|
+
}
|
|
223
|
+
close $last;
|
|
224
|
+
}
|
|
225
|
+
$line .= defined $duration ? ", last run took " . int($duration / 60) . "m" . ($duration % 60) . "s" : ", no earlier run";
|
|
226
|
+
}
|
|
227
|
+
push @holders, $line;
|
|
228
|
+
}
|
|
229
|
+
return @holders ? join("; ", @holders) : "another run";
|
|
230
|
+
};
|
|
231
|
+
my ($lock, $held_file);
|
|
232
|
+
my $start = time;
|
|
233
|
+
my $next_note = 0;
|
|
234
|
+
while (1) {
|
|
235
|
+
for my $slot (1 .. $slots) {
|
|
236
|
+
my $candidate = $slot == 1 ? $file : "$stem.$slot.lock";
|
|
237
|
+
open(my $next, ">>", $candidate) or do { print $out "error cannot open $candidate: $!\n"; exit 1 };
|
|
238
|
+
if (flock($next, LOCK_EX | LOCK_NB)) { $lock = $next; $held_file = $candidate; last }
|
|
239
|
+
close $next;
|
|
240
|
+
}
|
|
241
|
+
last if defined $lock;
|
|
242
|
+
exit 0 unless $caller_alive->();
|
|
243
|
+
if ($mode eq "try") { print $out "busy " . $holder->() . "\n"; exit 0 }
|
|
244
|
+
if (time - $start >= $wait_s) { print $out "timeout " . $holder->() . "\n"; exit 0 }
|
|
245
|
+
if (time >= $next_note) {
|
|
246
|
+
my $m = int((time - $start) / 60);
|
|
247
|
+
my $so_far = $m ? " (still, $m min so far)" : "";
|
|
248
|
+
print STDERR "[machine-lock] ⏳ $who is waiting for $label$so_far (up to ${wait_s}s): in use by " . $holder->() . "\n";
|
|
249
|
+
$next_note = time + 60;
|
|
250
|
+
}
|
|
251
|
+
select(undef, undef, undef, 0.1);
|
|
252
|
+
}
|
|
253
|
+
my $stopping = 0;
|
|
254
|
+
$SIG{TERM} = $SIG{INT} = $SIG{HUP} = sub { $stopping = 1 };
|
|
255
|
+
my $held_since = time;
|
|
256
|
+
if (open(my $h, ">", "$held_file.holder")) {
|
|
257
|
+
print $h "$who — $checkout (pid $owner, since " . strftime("%H:%M:%S", localtime) . ")\n";
|
|
258
|
+
close $h;
|
|
259
|
+
}
|
|
260
|
+
print $out "ok\n";
|
|
261
|
+
close $out;
|
|
262
|
+
select(undef, undef, undef, 0.1) while !$stopping && $caller_alive->();
|
|
263
|
+
if (length $name) {
|
|
264
|
+
# Serialize history updates across slots; the portable shell replaces just this checkout row.
|
|
265
|
+
my $history_lock;
|
|
266
|
+
if (open($history_lock, ">>", "$history.lock") && flock($history_lock, LOCK_EX)) {
|
|
267
|
+
my $pattern = $checkout; $pattern =~ s/([.\[\]\\*^\$])/\\$1/g;
|
|
268
|
+
$pattern = "^$pattern\t";
|
|
269
|
+
my $status = system("bash", "-c", q{
|
|
270
|
+
history="$1"; pattern="$2"; checkout="$3"; held="$4"
|
|
271
|
+
tmp=$(mktemp "$history.XXXXXX") || exit 1
|
|
272
|
+
if [ -f "$history" ]; then
|
|
273
|
+
grep -v "$pattern" "$history" >"$tmp"
|
|
274
|
+
code=$?
|
|
275
|
+
if [ "$code" -gt 1 ]; then rm -f "$tmp"; exit 1; fi
|
|
276
|
+
fi
|
|
277
|
+
printf "%s\t%s\n" "$checkout" "$held" >>"$tmp" && mv "$tmp" "$history"
|
|
278
|
+
}, "machine-lock-history", $history, $pattern, $checkout, time - $held_since);
|
|
279
|
+
print STDERR "[machine-lock] could not record $name held time in $history\n" if $status;
|
|
280
|
+
close $history_lock;
|
|
281
|
+
} else { print STDERR "[machine-lock] could not lock $history for held-time history: $!\n" }
|
|
282
|
+
}
|
|
283
|
+
unlink "$held_file.holder";
|
|
284
|
+
' "$_lsl_file" "$$" "$_lsl_who" "$_lsl_checkout" "$_lsl_fifo" "$_lsl_wait" "$_lsl_mode" "$_lsl_label" "$_lsl_slots" "$_lsl_name" </dev/null >/dev/null &
|
|
285
|
+
_lsl_pid=$!
|
|
286
|
+
# The fifo is opened read-write, so the read never blocks on a holder that died before it
|
|
287
|
+
# answered (a failed fork under load, a killed perl): the loop stops once it is gone.
|
|
288
|
+
_lsl_reply="$(
|
|
289
|
+
exec 3<>"$_lsl_fifo"
|
|
290
|
+
while :; do
|
|
291
|
+
if IFS= read -r -t 1 _lsl_line <&3; then
|
|
292
|
+
printf '%s' "$_lsl_line"
|
|
293
|
+
break
|
|
294
|
+
fi
|
|
295
|
+
if ! kill -0 "$_lsl_pid" 2>/dev/null; then
|
|
296
|
+
# The holder may have answered and exited between the read timing out and this check.
|
|
297
|
+
if IFS= read -r -t 1 _lsl_line <&3; then printf '%s' "$_lsl_line"; fi
|
|
298
|
+
break
|
|
299
|
+
fi
|
|
300
|
+
done
|
|
301
|
+
)" || true
|
|
302
|
+
rm -f "$_lsl_fifo"
|
|
303
|
+
|
|
304
|
+
case "$_lsl_reply" in
|
|
305
|
+
ok)
|
|
306
|
+
printf -v "$_lsl_pid_var" '%s' "$_lsl_pid"
|
|
307
|
+
printf -v "$_lsl_owner_var" '%s' "$$"
|
|
308
|
+
export "$_lsl_owner_var"
|
|
309
|
+
printf -v "$_lsl_name_var" '%s' "${_lsl_name:-the unnamed stack lock}"
|
|
310
|
+
export "$_lsl_name_var"
|
|
311
|
+
return 0
|
|
312
|
+
;;
|
|
313
|
+
busy\ *)
|
|
314
|
+
_LOCAL_STACK_LOCK_EXIT=75
|
|
315
|
+
echo "[machine-lock] $_lsl_label is in use by ${_lsl_reply#busy }" >&2
|
|
316
|
+
;;
|
|
317
|
+
timeout\ *)
|
|
318
|
+
_LOCAL_STACK_LOCK_EXIT=75
|
|
319
|
+
echo "[machine-lock] ❌ $_lsl_who gave up after ${_lsl_wait}s waiting for $_lsl_label, in use by ${_lsl_reply#timeout }" >&2
|
|
320
|
+
echo "[machine-lock] Let that run finish, or stop it. LOCAL_STACK_LOCK_WAIT_S sets how long to wait." >&2
|
|
321
|
+
;;
|
|
322
|
+
"")
|
|
323
|
+
echo "[machine-lock] ❌ could not take the lock for $_lsl_label: the perl process holding it stopped before it answered" >&2
|
|
324
|
+
;;
|
|
325
|
+
*)
|
|
326
|
+
echo "[machine-lock] ❌ could not take the lock for $_lsl_label: ${_lsl_reply#error }" >&2
|
|
327
|
+
;;
|
|
328
|
+
esac
|
|
329
|
+
wait "$_lsl_pid" 2>/dev/null || true
|
|
330
|
+
return 1
|
|
331
|
+
}
|
|
332
|
+
|
|
333
|
+
take_local_stack_lock() { _local_stack_lock wait "$1" "${2:-}"; }
|
|
334
|
+
try_local_stack_lock() { _local_stack_lock try "$1" "${2:-}"; }
|
|
335
|
+
|
|
336
|
+
release_local_stack_lock() {
|
|
337
|
+
local _lsl_pid_var _lsl_owner_var _lsl_name_var _lsl_release_pid
|
|
338
|
+
_local_stack_lock_vars "${1:-}"
|
|
339
|
+
_lsl_release_pid="${!_lsl_pid_var:-}"
|
|
340
|
+
[ -n "$_lsl_release_pid" ] || return 0
|
|
341
|
+
kill "$_lsl_release_pid" 2>/dev/null || true
|
|
342
|
+
wait "$_lsl_release_pid" 2>/dev/null || true
|
|
343
|
+
printf -v "$_lsl_pid_var" '%s' ""
|
|
344
|
+
unset "$_lsl_owner_var"
|
|
345
|
+
unset "$_lsl_name_var"
|
|
346
|
+
return 0
|
|
347
|
+
}
|
|
348
|
+
|
|
349
|
+
if [ "${BASH_SOURCE[0]}" = "$0" ]; then
|
|
350
|
+
_lsl_run_usage() {
|
|
351
|
+
echo 'usage: bash scripts/ci/bkit-machine-lock.sh run ["<who>"] [--lock <name>] -- <command> [args…]' >&2
|
|
352
|
+
exit 2
|
|
353
|
+
}
|
|
354
|
+
[ "${1:-}" = run ] || _lsl_run_usage
|
|
355
|
+
shift
|
|
356
|
+
_lsl_run_who="${LOCAL_STACK_LOCK_WHO:-${npm_lifecycle_event:-run}}"
|
|
357
|
+
_lsl_run_name=""
|
|
358
|
+
case "${1:-}" in
|
|
359
|
+
--lock|--) ;;
|
|
360
|
+
"") _lsl_run_usage ;;
|
|
361
|
+
*) _lsl_run_who="$1"; shift ;;
|
|
362
|
+
esac
|
|
363
|
+
if [ "${1:-}" = --lock ]; then
|
|
364
|
+
[ -n "${2:-}" ] && [ "$2" != -- ] || _lsl_run_usage
|
|
365
|
+
_lsl_run_name="$2"
|
|
366
|
+
shift 2
|
|
367
|
+
fi
|
|
368
|
+
[ "${1:-}" = -- ] || _lsl_run_usage
|
|
369
|
+
shift
|
|
370
|
+
[ "$#" -gt 0 ] || _lsl_run_usage
|
|
371
|
+
take_local_stack_lock "$_lsl_run_who" "$_lsl_run_name" || exit "$_LOCAL_STACK_LOCK_EXIT"
|
|
372
|
+
_lsl_run_signal_status=0
|
|
373
|
+
_lsl_run_cancel() {
|
|
374
|
+
_lsl_run_signal_status="$1"
|
|
375
|
+
echo "[machine-lock] cancellation requested; waiting for $_lsl_run_who to finish before releasing its lock" >&2
|
|
376
|
+
}
|
|
377
|
+
# Bash runs these traps after its foreground command ends. Keeping this owner
|
|
378
|
+
# alive also keeps the Perl holder alive while that command finishes naturally.
|
|
379
|
+
trap '_lsl_run_cancel 143' TERM
|
|
380
|
+
trap '_lsl_run_cancel 130' INT
|
|
381
|
+
trap '_lsl_run_cancel 129' HUP
|
|
382
|
+
"$@"
|
|
383
|
+
_lsl_run_status=$?
|
|
384
|
+
release_local_stack_lock "$_lsl_run_name"
|
|
385
|
+
[ "$_lsl_run_signal_status" -eq 0 ] || _lsl_run_status="$_lsl_run_signal_status"
|
|
386
|
+
exit "$_lsl_run_status"
|
|
387
|
+
fi
|
|
@@ -0,0 +1,75 @@
|
|
|
1
|
+
#!/usr/bin/env node
|
|
2
|
+
// Example. Copy into scripts/ci/ and own it. bkit install does not write this file.
|
|
3
|
+
// Usage: node scripts/ci/bkit-test-awake.mjs command [args...]
|
|
4
|
+
// Chains: node scripts/ci/bkit-test-awake.mjs --shell 'first && second'
|
|
5
|
+
|
|
6
|
+
import { spawn } from "node:child_process";
|
|
7
|
+
import spawnCommand from "cross-spawn";
|
|
8
|
+
import { once } from "node:events";
|
|
9
|
+
import { constants } from "node:os";
|
|
10
|
+
import { pathToFileURL } from "node:url";
|
|
11
|
+
|
|
12
|
+
/** Run a command with a macOS sleep assertion owned by this process. */
|
|
13
|
+
export async function runAwake(command, args, platform = process.platform) {
|
|
14
|
+
let assertion;
|
|
15
|
+
if (platform === "darwin") {
|
|
16
|
+
assertion = spawn("/usr/bin/caffeinate", ["-is", "-w", String(process.pid)], {
|
|
17
|
+
stdio: "ignore",
|
|
18
|
+
detached: true,
|
|
19
|
+
});
|
|
20
|
+
try {
|
|
21
|
+
await once(assertion, "spawn");
|
|
22
|
+
} catch (error) {
|
|
23
|
+
console.error(`bkit-test-awake: caffeinate could not run: ${error.message}`);
|
|
24
|
+
return 127;
|
|
25
|
+
}
|
|
26
|
+
}
|
|
27
|
+
|
|
28
|
+
const child = spawnCommand(command, args, {
|
|
29
|
+
stdio: "inherit",
|
|
30
|
+
});
|
|
31
|
+
const forward = (signal) => {
|
|
32
|
+
if (!child.pid) return;
|
|
33
|
+
try {
|
|
34
|
+
child.kill(signal);
|
|
35
|
+
} catch (error) {
|
|
36
|
+
if (error.code !== "ESRCH") throw error;
|
|
37
|
+
}
|
|
38
|
+
};
|
|
39
|
+
const handlers = ["SIGINT", "SIGTERM", "SIGHUP"].map((signal) => {
|
|
40
|
+
const handler = () => forward(signal);
|
|
41
|
+
process.on(signal, handler);
|
|
42
|
+
return [signal, handler];
|
|
43
|
+
});
|
|
44
|
+
try {
|
|
45
|
+
const [code, signal] = await once(child, "close");
|
|
46
|
+
return code ?? 128 + (constants.signals[signal] ?? 1);
|
|
47
|
+
} catch (error) {
|
|
48
|
+
const reason = error.code === "ENOENT" ? "not found on PATH" : "could not run";
|
|
49
|
+
console.error(`bkit-test-awake: ${command} ${reason}: ${error.message}`);
|
|
50
|
+
return error.code === "EACCES" ? 126 : 127;
|
|
51
|
+
} finally {
|
|
52
|
+
for (const [signal, handler] of handlers) process.off(signal, handler);
|
|
53
|
+
if (assertion && assertion.exitCode === null && assertion.signalCode === null) {
|
|
54
|
+
const closed = once(assertion, "close");
|
|
55
|
+
assertion.kill();
|
|
56
|
+
await closed;
|
|
57
|
+
}
|
|
58
|
+
}
|
|
59
|
+
}
|
|
60
|
+
|
|
61
|
+
if (process.argv[1] && import.meta.url === pathToFileURL(process.argv[1]).href) {
|
|
62
|
+
const [command, ...args] = process.argv.slice(2);
|
|
63
|
+
if (!command || (command === "--shell" && args.length !== 1)) {
|
|
64
|
+
console.error("bkit-test-awake: name a command, or --shell followed by one command string");
|
|
65
|
+
process.exitCode = 2;
|
|
66
|
+
} else if (command === "--shell") {
|
|
67
|
+
const windows = process.platform === "win32";
|
|
68
|
+
process.exitCode = await runAwake(
|
|
69
|
+
windows ? process.env.ComSpec || "cmd.exe" : "/bin/sh",
|
|
70
|
+
windows ? ["/d", "/s", "/c", args[0]] : ["-c", args[0]],
|
|
71
|
+
);
|
|
72
|
+
} else {
|
|
73
|
+
process.exitCode = await runAwake(command, args);
|
|
74
|
+
}
|
|
75
|
+
}
|
|
@@ -0,0 +1,160 @@
|
|
|
1
|
+
// Example. Copy into scripts/ci/ and own it. bkit install does not write this file.
|
|
2
|
+
import assert from "node:assert/strict";
|
|
3
|
+
import { spawn, spawnSync } from "node:child_process";
|
|
4
|
+
import { once } from "node:events";
|
|
5
|
+
import { existsSync, readFileSync } from "node:fs";
|
|
6
|
+
import { test } from "node:test";
|
|
7
|
+
import { fileURLToPath } from "node:url";
|
|
8
|
+
|
|
9
|
+
const script = fileURLToPath(new URL("./bkit-test-awake.mjs", import.meta.url));
|
|
10
|
+
|
|
11
|
+
function isRunning(pid) {
|
|
12
|
+
try {
|
|
13
|
+
process.kill(pid, 0);
|
|
14
|
+
if (process.platform === "linux") {
|
|
15
|
+
const stat = readFileSync(`/proc/${pid}/stat`, "utf8");
|
|
16
|
+
return stat.slice(stat.lastIndexOf(")") + 2, stat.lastIndexOf(")") + 3) !== "Z";
|
|
17
|
+
}
|
|
18
|
+
return true;
|
|
19
|
+
} catch (error) {
|
|
20
|
+
if (error.code === "ESRCH" || error.code === "ENOENT") return false;
|
|
21
|
+
throw error;
|
|
22
|
+
}
|
|
23
|
+
}
|
|
24
|
+
|
|
25
|
+
test("ships a command-scoped sleep prevention wrapper", () => {
|
|
26
|
+
assert.ok(existsSync(script));
|
|
27
|
+
});
|
|
28
|
+
|
|
29
|
+
test("preserves arguments, output and nonzero exit status", () => {
|
|
30
|
+
const result = spawnSync(
|
|
31
|
+
process.execPath,
|
|
32
|
+
[
|
|
33
|
+
script,
|
|
34
|
+
process.execPath,
|
|
35
|
+
"-e",
|
|
36
|
+
'console.log(JSON.stringify(process.argv.slice(1))); console.error("failure detail"); process.exit(23)',
|
|
37
|
+
"a b",
|
|
38
|
+
"$(echo unsafe)",
|
|
39
|
+
"",
|
|
40
|
+
"--flag",
|
|
41
|
+
],
|
|
42
|
+
{ encoding: "utf8" },
|
|
43
|
+
);
|
|
44
|
+
assert.equal(result.status, 23);
|
|
45
|
+
assert.deepEqual(JSON.parse(result.stdout), ["a b", "$(echo unsafe)", "", "--flag"]);
|
|
46
|
+
assert.equal(result.stderr, "failure detail\n");
|
|
47
|
+
});
|
|
48
|
+
|
|
49
|
+
test("runs an entire shell chain and retains its failure", () => {
|
|
50
|
+
const result = spawnSync(
|
|
51
|
+
process.execPath,
|
|
52
|
+
[script, "--shell", "echo first && echo second && exit 19"],
|
|
53
|
+
{ encoding: "utf8" },
|
|
54
|
+
);
|
|
55
|
+
assert.equal(result.status, 19);
|
|
56
|
+
assert.match(result.stdout, /first\r?\nsecond\r?\n/);
|
|
57
|
+
});
|
|
58
|
+
|
|
59
|
+
test("reports a missing command as 127", () => {
|
|
60
|
+
const result = spawnSync(process.execPath, [script, "bkit-command-that-does-not-exist"], {
|
|
61
|
+
encoding: "utf8",
|
|
62
|
+
});
|
|
63
|
+
assert.equal(result.status, 127);
|
|
64
|
+
assert.match(result.stderr, /bkit-command-that-does-not-exist/);
|
|
65
|
+
});
|
|
66
|
+
|
|
67
|
+
test("requires a command", () => {
|
|
68
|
+
const result = spawnSync(process.execPath, [script], { encoding: "utf8" });
|
|
69
|
+
assert.equal(result.status, 2);
|
|
70
|
+
assert.match(result.stderr, /command/);
|
|
71
|
+
});
|
|
72
|
+
|
|
73
|
+
test("non-macOS platform selection runs commands without sleep prevention", async () => {
|
|
74
|
+
const { runAwake } = await import("./bkit-test-awake.mjs");
|
|
75
|
+
for (const platform of ["linux", "win32"]) {
|
|
76
|
+
assert.equal(await runAwake(process.execPath, ["-e", "process.exit(17)"], platform), 17);
|
|
77
|
+
}
|
|
78
|
+
});
|
|
79
|
+
|
|
80
|
+
test(
|
|
81
|
+
"hard timeout escalation reaches a command that ignores TERM",
|
|
82
|
+
{ skip: process.platform === "win32" },
|
|
83
|
+
async () => {
|
|
84
|
+
const child = spawn(
|
|
85
|
+
process.execPath,
|
|
86
|
+
[
|
|
87
|
+
script,
|
|
88
|
+
process.execPath,
|
|
89
|
+
"-e",
|
|
90
|
+
'process.on("SIGTERM", () => {}); console.log(String(process.pid)); setInterval(() => {}, 1000)',
|
|
91
|
+
],
|
|
92
|
+
{
|
|
93
|
+
detached: true,
|
|
94
|
+
stdio: ["ignore", "pipe", "pipe"],
|
|
95
|
+
env: { ...process.env, FORCE_COLOR: "1" },
|
|
96
|
+
},
|
|
97
|
+
);
|
|
98
|
+
const exited = once(child, "exit");
|
|
99
|
+
const [data] = await once(child.stdout, "data");
|
|
100
|
+
const pid = Number(data.toString().trim());
|
|
101
|
+
assert.ok(pid > 0);
|
|
102
|
+
process.kill(-child.pid, "SIGTERM");
|
|
103
|
+
await new Promise((resolve) => setTimeout(resolve, 100));
|
|
104
|
+
process.kill(-child.pid, "SIGKILL");
|
|
105
|
+
await exited;
|
|
106
|
+
for (let attempt = 0; attempt < 40 && isRunning(pid); attempt++) {
|
|
107
|
+
await new Promise((resolve) => setTimeout(resolve, 25));
|
|
108
|
+
}
|
|
109
|
+
const alive = isRunning(pid);
|
|
110
|
+
if (alive) process.kill(pid, "SIGKILL");
|
|
111
|
+
child.stdout.destroy();
|
|
112
|
+
child.stderr.destroy();
|
|
113
|
+
assert.equal(alive, false, "a hard timeout must kill the test command too");
|
|
114
|
+
},
|
|
115
|
+
);
|
|
116
|
+
|
|
117
|
+
test(
|
|
118
|
+
"forwards POSIX cancellation to the command and releases the assertion",
|
|
119
|
+
{ skip: process.platform === "win32" },
|
|
120
|
+
async () => {
|
|
121
|
+
const child = spawn(
|
|
122
|
+
process.execPath,
|
|
123
|
+
[
|
|
124
|
+
script,
|
|
125
|
+
process.execPath,
|
|
126
|
+
"-e",
|
|
127
|
+
"console.log(String(process.pid)); setInterval(() => {}, 1000)",
|
|
128
|
+
],
|
|
129
|
+
{ stdio: ["ignore", "pipe", "pipe"], env: { ...process.env, FORCE_COLOR: "1" } },
|
|
130
|
+
);
|
|
131
|
+
const closed = once(child, "close");
|
|
132
|
+
const [data] = await once(child.stdout, "data");
|
|
133
|
+
const pid = Number(data.toString().trim());
|
|
134
|
+
assert.ok(pid > 0);
|
|
135
|
+
child.kill("SIGTERM");
|
|
136
|
+
const [code] = await closed;
|
|
137
|
+
assert.equal(code, 143);
|
|
138
|
+
assert.throws(() => process.kill(pid, 0), { code: "ESRCH" });
|
|
139
|
+
},
|
|
140
|
+
);
|
|
141
|
+
|
|
142
|
+
test(
|
|
143
|
+
"holds a real macOS assertion only while the command runs",
|
|
144
|
+
{ skip: process.platform !== "darwin" },
|
|
145
|
+
() => {
|
|
146
|
+
const probe = `
|
|
147
|
+
const { execFileSync } = require("node:child_process");
|
|
148
|
+
const pid = Number(execFileSync("pgrep", ["-P", String(process.ppid), "caffeinate"], {encoding:"utf8"}).trim());
|
|
149
|
+
const command = execFileSync("ps", ["-p", String(pid), "-o", "command="], {encoding:"utf8"});
|
|
150
|
+
console.log(JSON.stringify({pid, command, owner:process.ppid}));
|
|
151
|
+
`;
|
|
152
|
+
const result = spawnSync(process.execPath, [script, process.execPath, "-e", probe], {
|
|
153
|
+
encoding: "utf8",
|
|
154
|
+
});
|
|
155
|
+
assert.equal(result.status, 0, result.stderr);
|
|
156
|
+
const { pid, command, owner } = JSON.parse(result.stdout);
|
|
157
|
+
assert.match(command, new RegExp("caffeinate -is -w " + owner));
|
|
158
|
+
assert.throws(() => process.kill(pid, 0), { code: "ESRCH" });
|
|
159
|
+
},
|
|
160
|
+
);
|
package/.bkit/templates/scripts/ci/lanes/{resolve-push-base.mjs → bkit-resolve-push-base.mjs}
RENAMED
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
// Example. Copy into scripts/ci/lanes/ and own it. bkit install does not write this file
|
|
3
3
|
// and does not overwrite a copy.
|
|
4
4
|
/**
|
|
5
|
-
* resolve-push-base.mjs — the diff base for a push run's test plan.
|
|
5
|
+
* bkit-resolve-push-base.mjs — the diff base for a push run's test plan.
|
|
6
6
|
*
|
|
7
7
|
* A newer run on a branch cancels the older one, so the previous push's run may never have
|
|
8
8
|
* finished — and `github.event.before` is that previous push. Diffing against it would leave
|
|
@@ -17,9 +17,9 @@
|
|
|
17
17
|
* in for `event.before`, and ancestry is tested against the pushed commit (`--head`), which is
|
|
18
18
|
* not always the checked-out one. gh uses its own login.
|
|
19
19
|
*
|
|
20
|
-
* Usage: node scripts/ci/lanes/resolve-push-base.mjs
|
|
20
|
+
* Usage: node scripts/ci/lanes/bkit-resolve-push-base.mjs
|
|
21
21
|
* (env: GH_TOKEN, REPO, BRANCH, BEFORE_SHA, WORKFLOW_FILE; optional SOURCE_FILE)
|
|
22
|
-
* node scripts/ci/lanes/resolve-push-base.mjs --local --branch=dev --head=<pushed sha>
|
|
22
|
+
* node scripts/ci/lanes/bkit-resolve-push-base.mjs --local --branch=dev --head=<pushed sha>
|
|
23
23
|
* (env: optional WORKFLOW_FILE, SOURCE_FILE)
|
|
24
24
|
* Output: the base SHA on stdout; the chosen source (`last-green-run`, `event-before`, ...;
|
|
25
25
|
* `origin/<branch>` in place of `event-before` in local mode) on stderr, and in
|
|
@@ -2,9 +2,9 @@
|
|
|
2
2
|
// Example. Copy into scripts/ci/lanes/ and own it. bkit install does not write this file
|
|
3
3
|
// and does not overwrite a copy.
|
|
4
4
|
/**
|
|
5
|
-
* resolve-push-base.test.mjs — unit tests for the push-run diff base.
|
|
5
|
+
* bkit-resolve-push-base.test.mjs — unit tests for the push-run diff base.
|
|
6
6
|
*
|
|
7
|
-
* Pure Node, no runner: `node scripts/ci/lanes/resolve-push-base.test.mjs`.
|
|
7
|
+
* Pure Node, no runner: `node scripts/ci/lanes/bkit-resolve-push-base.test.mjs`.
|
|
8
8
|
* Exit: 0 = all tests passed, 1 = at least one test failed.
|
|
9
9
|
*/
|
|
10
10
|
|
|
@@ -18,9 +18,9 @@ import {
|
|
|
18
18
|
newestRunSha,
|
|
19
19
|
parseArgs,
|
|
20
20
|
repoFromRemoteUrl,
|
|
21
|
-
} from "./resolve-push-base.mjs";
|
|
21
|
+
} from "./bkit-resolve-push-base.mjs";
|
|
22
22
|
|
|
23
|
-
const SCRIPT = fileURLToPath(new URL("./resolve-push-base.mjs", import.meta.url));
|
|
23
|
+
const SCRIPT = fileURLToPath(new URL("./bkit-resolve-push-base.mjs", import.meta.url));
|
|
24
24
|
|
|
25
25
|
/** Run the script with fake `gh` / `git` binaries first on PATH; `gh` calls land in gh.log. */
|
|
26
26
|
function runWithFakes({ gh, git, args = [], env = {} }) {
|