@smoothbricks/nx-plugin 0.5.6 → 0.6.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/README.md +1095 -360
- package/dist/.build-inputs.json +138 -0
- package/dist/bin/smoo-nx-cargo-toolchain.d.ts +3 -0
- package/dist/bin/smoo-nx-cargo-toolchain.d.ts.map +1 -0
- package/dist/bin/smoo-nx-cargo-toolchain.js +8 -0
- package/dist/bin/smoo-nx-forbidden-spellings.d.ts +3 -0
- package/dist/bin/smoo-nx-forbidden-spellings.d.ts.map +1 -0
- package/dist/bin/smoo-nx-forbidden-spellings.js +32 -0
- package/dist/bin/smoo-nx-nextest-timings.d.ts +3 -0
- package/dist/bin/smoo-nx-nextest-timings.d.ts.map +1 -0
- package/dist/bin/smoo-nx-nextest-timings.js +28 -0
- package/dist/bounded-test-policy.d.ts +1 -1
- package/dist/bounded-test-policy.d.ts.map +1 -1
- package/dist/bounded-test-policy.js +14 -15
- package/dist/build-state-output-policy.d.ts +95 -1
- package/dist/build-state-output-policy.d.ts.map +1 -1
- package/dist/build-state-output-policy.js +368 -30
- package/dist/bun-lock-scope.d.ts +44 -0
- package/dist/bun-lock-scope.d.ts.map +1 -0
- package/dist/bun-lock-scope.js +97 -0
- package/dist/cargo-build-script-env.d.ts +49 -0
- package/dist/cargo-build-script-env.d.ts.map +1 -0
- package/dist/cargo-build-script-env.js +324 -0
- package/dist/cargo-closure-input.d.ts +31 -4
- package/dist/cargo-closure-input.d.ts.map +1 -1
- package/dist/cargo-closure-input.js +66 -6
- package/dist/cargo-retention-hook.d.ts +17 -0
- package/dist/cargo-retention-hook.d.ts.map +1 -0
- package/dist/cargo-retention-hook.js +85 -0
- package/dist/cargo-source-hash.d.ts +25 -7
- package/dist/cargo-source-hash.d.ts.map +1 -1
- package/dist/cargo-source-hash.js +108 -43
- package/dist/cargo-toolchain-paths.d.ts +40 -0
- package/dist/cargo-toolchain-paths.d.ts.map +1 -0
- package/dist/cargo-toolchain-paths.js +84 -0
- package/dist/cargo-toolchain-policy.d.ts +25 -8
- package/dist/cargo-toolchain-policy.d.ts.map +1 -1
- package/dist/cargo-toolchain-policy.js +39 -5
- package/dist/cargo-workspace.d.ts +10 -4
- package/dist/cargo-workspace.d.ts.map +1 -1
- package/dist/cargo-workspace.js +65 -95
- package/dist/cross-check-policy.d.ts +9 -9
- package/dist/cross-check-policy.d.ts.map +1 -1
- package/dist/cross-check-policy.js +11 -11
- package/dist/disk-command-policy.d.ts.map +1 -1
- package/dist/disk-command-policy.js +1 -0
- package/dist/ensure-built-receipt.d.ts +13 -5
- package/dist/ensure-built-receipt.d.ts.map +1 -1
- package/dist/ensure-built-receipt.js +126 -47
- package/dist/ensure-built-witness.d.ts +27 -8
- package/dist/ensure-built-witness.d.ts.map +1 -1
- package/dist/ensure-built-witness.js +45 -15
- package/dist/ensure-built.d.ts.map +1 -1
- package/dist/ensure-built.js +9 -1
- package/dist/eslint-config-closure.d.ts +7 -0
- package/dist/eslint-config-closure.d.ts.map +1 -0
- package/dist/eslint-config-closure.js +346 -0
- package/dist/executors/all-verdicts/executor.d.ts +35 -0
- package/dist/executors/all-verdicts/executor.d.ts.map +1 -0
- package/dist/executors/all-verdicts/executor.js +133 -0
- package/dist/executors/all-verdicts/schema.d.ts +10 -0
- package/dist/executors/all-verdicts/schema.d.ts.map +1 -0
- package/dist/executors/all-verdicts/schema.js +2 -0
- package/dist/executors/bounded-exec/bounds.d.ts +56 -0
- package/dist/executors/bounded-exec/bounds.d.ts.map +1 -0
- package/dist/executors/bounded-exec/bounds.js +43 -0
- package/dist/executors/bounded-exec/cpu-pool.d.ts +33 -36
- package/dist/executors/bounded-exec/cpu-pool.d.ts.map +1 -1
- package/dist/executors/bounded-exec/cpu-pool.js +54 -119
- package/dist/executors/bounded-exec/executor.d.ts +19 -12
- package/dist/executors/bounded-exec/executor.d.ts.map +1 -1
- package/dist/executors/bounded-exec/executor.js +371 -239
- package/dist/executors/bounded-exec/gateway-lease.d.ts +22 -19
- package/dist/executors/bounded-exec/gateway-lease.d.ts.map +1 -1
- package/dist/executors/bounded-exec/gateway-lease.js +81 -28
- package/dist/executors/bounded-exec/hang-diagnostics.d.ts +18 -1
- package/dist/executors/bounded-exec/hang-diagnostics.d.ts.map +1 -1
- package/dist/executors/bounded-exec/hang-diagnostics.js +148 -30
- package/dist/executors/bounded-exec/lease-wait.d.ts +43 -0
- package/dist/executors/bounded-exec/lease-wait.d.ts.map +1 -0
- package/dist/executors/bounded-exec/lease-wait.js +68 -0
- package/dist/executors/bounded-exec/lock-wait.d.ts +51 -0
- package/dist/executors/bounded-exec/lock-wait.d.ts.map +1 -0
- package/dist/executors/bounded-exec/lock-wait.js +108 -0
- package/dist/executors/bounded-exec/owned-subtree.d.ts +84 -0
- package/dist/executors/bounded-exec/owned-subtree.d.ts.map +1 -0
- package/dist/executors/bounded-exec/owned-subtree.js +178 -0
- package/dist/executors/bounded-exec/progress.d.ts +4 -1
- package/dist/executors/bounded-exec/progress.d.ts.map +1 -1
- package/dist/executors/bounded-exec/progress.js +5 -2
- package/dist/executors/bounded-exec/ram-attach.d.ts +19 -0
- package/dist/executors/bounded-exec/ram-attach.d.ts.map +1 -0
- package/dist/executors/bounded-exec/ram-attach.js +207 -0
- package/dist/executors/bounded-exec/ram-detach.d.ts +25 -0
- package/dist/executors/bounded-exec/ram-detach.d.ts.map +1 -0
- package/dist/executors/bounded-exec/ram-detach.js +207 -0
- package/dist/executors/bounded-exec/ram-temp-fixtures.d.ts +76 -0
- package/dist/executors/bounded-exec/ram-temp-fixtures.d.ts.map +1 -1
- package/dist/executors/bounded-exec/ram-temp-fixtures.js +296 -0
- package/dist/executors/bounded-exec/ram-temp.d.ts +388 -88
- package/dist/executors/bounded-exec/ram-temp.d.ts.map +1 -1
- package/dist/executors/bounded-exec/ram-temp.js +1213 -399
- package/dist/executors/bounded-exec/run-cpu-pool.d.ts +4 -4
- package/dist/executors/bounded-exec/run-cpu-pool.d.ts.map +1 -1
- package/dist/executors/bounded-exec/run-cpu-pool.js +20 -30
- package/dist/executors/bounded-exec/runner-hook.js +14 -5
- package/dist/executors/bounded-exec/runner-lifecycle.d.ts +14 -1
- package/dist/executors/bounded-exec/runner-lifecycle.d.ts.map +1 -1
- package/dist/executors/bounded-exec/runner-lifecycle.js +27 -6
- package/dist/executors/bounded-exec/{cpu-tokens.d.ts → runner-sizing.d.ts} +14 -42
- package/dist/executors/bounded-exec/runner-sizing.d.ts.map +1 -0
- package/dist/executors/bounded-exec/{cpu-tokens.js → runner-sizing.js} +5 -35
- package/dist/executors/bounded-exec/runtime-pin.d.ts +73 -0
- package/dist/executors/bounded-exec/runtime-pin.d.ts.map +1 -0
- package/dist/executors/bounded-exec/runtime-pin.js +167 -0
- package/dist/executors/bounded-exec/schema.d.ts +18 -1
- package/dist/executors/bounded-exec/schema.d.ts.map +1 -1
- package/dist/executors/bounded-exec/verdict.d.ts +40 -11
- package/dist/executors/bounded-exec/verdict.d.ts.map +1 -1
- package/dist/executors/bounded-exec/verdict.js +88 -19
- package/dist/executors/cargo-zigbuild/executor.d.ts +21 -0
- package/dist/executors/cargo-zigbuild/executor.d.ts.map +1 -1
- package/dist/executors/cargo-zigbuild/executor.js +67 -12
- package/dist/executors/clean-outputs/executor.js +1 -0
- package/dist/executors/scriptc-native/executor.d.ts +79 -0
- package/dist/executors/scriptc-native/executor.d.ts.map +1 -0
- package/dist/executors/scriptc-native/executor.js +367 -0
- package/dist/executors/scriptc-native/ffi-paths.d.ts +9 -0
- package/dist/executors/scriptc-native/ffi-paths.d.ts.map +1 -0
- package/dist/executors/scriptc-native/ffi-paths.js +25 -0
- package/dist/executors/scriptc-native/schema.d.ts +34 -0
- package/dist/executors/scriptc-native/schema.d.ts.map +1 -0
- package/dist/executors/scriptc-native/schema.js +1 -0
- package/dist/executors/typescript-emit/executor.d.ts +3 -1
- package/dist/executors/typescript-emit/executor.d.ts.map +1 -1
- package/dist/executors/typescript-emit/executor.js +164 -33
- package/dist/forbidden-spelling-policy.d.ts +56 -0
- package/dist/forbidden-spelling-policy.d.ts.map +1 -0
- package/dist/forbidden-spelling-policy.js +176 -0
- package/dist/generators/create-package/generator.d.ts.map +1 -1
- package/dist/generators/create-package/generator.js +3 -4
- package/dist/graph-input-contract.d.ts +14 -0
- package/dist/graph-input-contract.d.ts.map +1 -1
- package/dist/graph-input-contract.js +67 -2
- package/dist/index.d.ts +23 -6
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +676 -215
- package/dist/managed-assets.d.ts +2 -0
- package/dist/managed-assets.d.ts.map +1 -1
- package/dist/managed-files/files.d.ts +3 -3
- package/dist/managed-files/files.d.ts.map +1 -1
- package/dist/managed-files/files.js +28 -3
- package/dist/managed-files/managed-format.d.ts.map +1 -1
- package/dist/managed-files/managed-format.js +1 -0
- package/dist/nextest-code-bound.js +1 -0
- package/dist/nextest-timings.d.ts +35 -0
- package/dist/nextest-timings.d.ts.map +1 -0
- package/dist/nextest-timings.js +168 -0
- package/dist/owned-installation.d.ts +6 -5
- package/dist/owned-installation.d.ts.map +1 -1
- package/dist/owned-installation.js +150 -26
- package/dist/package-target-policy.d.ts.map +1 -1
- package/dist/package-target-policy.js +2 -3
- package/dist/process-children.d.ts +7 -0
- package/dist/process-children.d.ts.map +1 -0
- package/dist/process-children.darwin.d.ts +7 -0
- package/dist/process-children.darwin.d.ts.map +1 -0
- package/dist/process-children.darwin.js +13 -0
- package/dist/process-children.js +14 -0
- package/dist/process-children.linux.d.ts +8 -0
- package/dist/process-children.linux.d.ts.map +1 -0
- package/dist/process-children.linux.js +25 -0
- package/dist/process-group.d.ts +108 -0
- package/dist/process-group.d.ts.map +1 -0
- package/dist/process-group.js +171 -0
- package/dist/process-listing.d.ts +7 -0
- package/dist/process-listing.d.ts.map +1 -0
- package/dist/process-listing.js +51 -0
- package/dist/producer-receipts.d.ts +8 -2
- package/dist/producer-receipts.d.ts.map +1 -1
- package/dist/producer-receipts.js +75 -48
- package/dist/task-graph-policy.d.ts +21 -0
- package/dist/task-graph-policy.d.ts.map +1 -0
- package/dist/task-graph-policy.js +91 -0
- package/dist/test-timings.js +4 -4
- package/dist/test-walk-policy.d.ts +14 -5
- package/dist/test-walk-policy.d.ts.map +1 -1
- package/dist/test-walk-policy.js +8 -2
- package/dist/testing.d.ts +73 -28
- package/dist/testing.d.ts.map +1 -1
- package/dist/testing.js +217 -223
- package/dist/tool-bins.d.ts +33 -0
- package/dist/tool-bins.d.ts.map +1 -0
- package/dist/tool-bins.js +72 -0
- package/dist/typecheck-test-policy.d.ts.map +1 -1
- package/dist/typecheck-test-policy.js +3 -4
- package/dist/wait-why-policy.d.ts +28 -0
- package/dist/wait-why-policy.d.ts.map +1 -0
- package/dist/wait-why-policy.js +223 -0
- package/dist/workspace-config-policy.d.ts +14 -8
- package/dist/workspace-config-policy.d.ts.map +1 -1
- package/dist/workspace-config-policy.js +60 -16
- package/dist/workspace-manifest.d.ts +41 -6
- package/dist/workspace-manifest.d.ts.map +1 -1
- package/dist/workspace-manifest.js +57 -0
- package/executors.json +21 -1
- package/loader.js +2 -0
- package/managed/raw/envrc +11 -0
- package/managed/raw/patches/nx@23.2.1.patch +2840 -199
- package/managed/raw/patches/ttsc@0.34.1.patch +119 -0
- package/managed/raw/tooling/direnv/cargo-fetch-bound.ts +245 -0
- package/managed/raw/tooling/direnv/cargo-fetch-run.ts +299 -0
- package/managed/raw/tooling/direnv/compiler-variables.sh +42 -0
- package/managed/raw/tooling/direnv/developer-links.ts +464 -25
- package/managed/raw/tooling/direnv/devenv.smoo.nix +78 -38
- package/managed/raw/tooling/direnv/github-actions-bootstrap.sh +14 -12
- package/managed/raw/tooling/direnv/installed-bun-links.ts +308 -0
- package/managed/raw/tooling/direnv/linked-snapshots.ts +62 -3
- package/managed/raw/tooling/direnv/nx-socket-dir.sh +56 -17
- package/managed/raw/tooling/direnv/repo-path +68 -6
- package/managed/raw/tooling/direnv/secret-references.ts +13 -4
- package/managed/raw/tooling/direnv/setup-environment.ts +128 -537
- package/managed/raw/tooling/direnv/toolchain-stamp.ts +4 -2
- package/managed/raw/tooling/direnv/ttsc-env.sh +9 -0
- package/managed/raw/tooling/direnv/uv-relocation.ts +227 -0
- package/managed/raw/tooling/git-hooks/commit-msg.sh +2 -1
- package/managed/raw/tooling/git-hooks/pre-commit.sh +2 -1
- package/managed/raw/tooling/git-hooks/pre-push.sh +2 -1
- package/managed/templates/github/actions/cache-ttsc-plugins/action.yml +85 -7
- package/managed/templates/github/actions/save-nix-devenv/action.yml +12 -2
- package/managed/templates/github/actions/setup-devenv/action.yml +2 -0
- package/package.json +77 -13
- package/src/bin/smoo-nx-cargo-toolchain.ts +11 -0
- package/src/bin/smoo-nx-forbidden-spellings.ts +33 -0
- package/src/bin/smoo-nx-nextest-timings.ts +31 -0
- package/src/bounded-test-policy.ts +12 -14
- package/src/build-state-output-policy.ts +458 -34
- package/src/bun-lock-scope.ts +108 -0
- package/src/cargo-build-script-env.ts +265 -0
- package/src/cargo-closure-input.ts +74 -7
- package/src/cargo-retention-hook.ts +94 -0
- package/src/cargo-source-hash.ts +138 -41
- package/src/cargo-toolchain-paths.ts +95 -0
- package/src/cargo-toolchain-policy.ts +49 -5
- package/src/cargo-workspace.ts +72 -123
- package/src/cross-check-policy.ts +12 -10
- package/src/disk-command-policy.ts +1 -0
- package/src/ensure-built-receipt.ts +132 -39
- package/src/ensure-built-witness.ts +62 -10
- package/src/ensure-built.ts +11 -1
- package/src/eslint-config-closure.ts +357 -0
- package/src/executors/all-verdicts/executor.ts +164 -0
- package/src/executors/all-verdicts/schema.json +22 -0
- package/src/executors/all-verdicts/schema.ts +10 -0
- package/src/executors/bounded-exec/bounds.ts +76 -0
- package/src/executors/bounded-exec/cpu-pool.ts +51 -117
- package/src/executors/bounded-exec/executor.ts +423 -259
- package/src/executors/bounded-exec/gateway-lease.ts +82 -33
- package/src/executors/bounded-exec/hang-diagnostics.ts +173 -31
- package/src/executors/bounded-exec/lease-wait.ts +89 -0
- package/src/executors/bounded-exec/lock-wait.ts +141 -0
- package/src/executors/bounded-exec/owned-subtree.ts +235 -0
- package/src/executors/bounded-exec/progress.ts +9 -3
- package/src/executors/bounded-exec/ram-attach.ts +238 -0
- package/src/executors/bounded-exec/ram-detach.ts +226 -0
- package/src/executors/bounded-exec/ram-temp-fixtures.ts +358 -0
- package/src/executors/bounded-exec/ram-temp-registry.txt +440 -0
- package/src/executors/bounded-exec/ram-temp.ts +1497 -460
- package/src/executors/bounded-exec/run-cpu-pool.ts +22 -30
- package/src/executors/bounded-exec/runner-hook.ts +14 -6
- package/src/executors/bounded-exec/runner-lifecycle.ts +31 -8
- package/src/executors/bounded-exec/{cpu-tokens.ts → runner-sizing.ts} +13 -59
- package/src/executors/bounded-exec/runtime-pin.ts +232 -0
- package/src/executors/bounded-exec/schema.json +11 -2
- package/src/executors/bounded-exec/schema.ts +19 -1
- package/src/executors/bounded-exec/verdict.ts +137 -34
- package/src/executors/cargo-zigbuild/executor.ts +82 -8
- package/src/executors/clean-outputs/executor.ts +1 -0
- package/src/executors/scriptc-native/executor.ts +394 -0
- package/src/executors/scriptc-native/ffi-paths.ts +29 -0
- package/src/executors/scriptc-native/schema.json +60 -0
- package/src/executors/scriptc-native/schema.ts +34 -0
- package/src/executors/typescript-emit/executor.ts +205 -38
- package/src/forbidden-spelling-policy.ts +226 -0
- package/src/generators/create-package/generator.ts +7 -7
- package/src/graph-input-contract.ts +61 -2
- package/src/index.ts +792 -225
- package/src/managed-assets.ts +3 -0
- package/src/managed-files/files.ts +28 -3
- package/src/managed-files/managed-format.ts +1 -0
- package/src/nextest-code-bound.ts +1 -0
- package/src/nextest-timings.ts +106 -0
- package/src/owned-installation.ts +150 -23
- package/src/package-target-policy.ts +2 -3
- package/src/process-children.darwin.ts +14 -0
- package/src/process-children.linux.ts +33 -0
- package/src/process-children.ts +22 -0
- package/src/process-group.ts +209 -0
- package/src/process-listing.ts +54 -0
- package/src/producer-receipts.ts +68 -45
- package/src/task-graph-policy.ts +98 -0
- package/src/test-walk-policy.ts +23 -8
- package/src/testing.ts +240 -232
- package/src/tool-bins.ts +108 -0
- package/src/typecheck-test-policy.ts +2 -3
- package/src/wait-why-policy.ts +226 -0
- package/src/workspace-config-policy.ts +63 -15
- package/src/workspace-manifest.ts +89 -6
- package/test-timings.json +123 -98
- package/dist/bin/smoo-nx-failures.d.ts +0 -3
- package/dist/bin/smoo-nx-failures.d.ts.map +0 -1
- package/dist/bin/smoo-nx-failures.js +0 -3
- package/dist/bin/smoo-nx-nextest-extract.d.ts +0 -3
- package/dist/bin/smoo-nx-nextest-extract.d.ts.map +0 -1
- package/dist/bin/smoo-nx-nextest-extract.js +0 -42
- package/dist/executors/bounded-exec/cpu-tokens.d.ts.map +0 -1
- package/dist/failure-summary.d.ts +0 -5
- package/dist/failure-summary.d.ts.map +0 -1
- package/dist/failure-summary.js +0 -118
- package/dist/nextest-extraction.d.ts +0 -117
- package/dist/nextest-extraction.d.ts.map +0 -1
- package/dist/nextest-extraction.js +0 -303
- package/managed/raw/patches/ttsc@0.30.4.patch +0 -2255
- package/src/__tests__/cargo-closure-filesets.ts +0 -94
- package/src/__tests__/cargo-closure-fixture.ts +0 -113
- package/src/__tests__/counted-cargo-process.ts +0 -286
- package/src/__tests__/counted-cargo.ts +0 -713
- package/src/__tests__/directory-change.ts +0 -27
- package/src/__tests__/fixture-cargo-home.ts +0 -36
- package/src/__tests__/fixture-nx-env.ts +0 -193
- package/src/__tests__/owned-installation.ts +0 -13
- package/src/__tests__/past-tick.ts +0 -12
- package/src/__tests__/progress-clock.ts +0 -43
- package/src/__tests__/runtime-input.ts +0 -23
- package/src/bin/smoo-nx-bound-failures.test.ts +0 -127
- package/src/bin/smoo-nx-failures.ts +0 -4
- package/src/bin/smoo-nx-nextest-extract.ts +0 -44
- package/src/bounded-test-policy.test.ts +0 -1029
- package/src/build-state-output-policy.test.ts +0 -115
- package/src/bun-bootstrap.test.ts +0 -102
- package/src/bun-file-packages.test.ts +0 -47
- package/src/cargo-closure-filesets.test.ts +0 -63
- package/src/cargo-closure-input.property.test.ts +0 -50
- package/src/cargo-closure-input.test.ts +0 -506
- package/src/cargo-closure-key.test.ts +0 -240
- package/src/cargo-resolve-cache.test.ts +0 -1181
- package/src/cargo-source-hash.test.ts +0 -707
- package/src/cargo-workspace.test.ts +0 -615
- package/src/cross-check-policy.test.ts +0 -316
- package/src/disk-command-policy.test.ts +0 -61
- package/src/ensure-built-receipt.test.ts +0 -279
- package/src/ensure-built-witness.test.ts +0 -688
- package/src/ensure-built.test.ts +0 -1462
- package/src/executors/bounded-exec/cargo-progress-host.test.ts +0 -332
- package/src/executors/bounded-exec/cpu-pool.test.ts +0 -684
- package/src/executors/bounded-exec/cpu-tokens.test.ts +0 -519
- package/src/executors/bounded-exec/disk-lease.test.ts +0 -219
- package/src/executors/bounded-exec/executor-host.test.ts +0 -800
- package/src/executors/bounded-exec/executor.test.ts +0 -1819
- package/src/executors/bounded-exec/go-progress-host.test.ts +0 -171
- package/src/executors/bounded-exec/hang-diagnostics.test.ts +0 -291
- package/src/executors/bounded-exec/progress.test.ts +0 -139
- package/src/executors/bounded-exec/ram-temp-held.test.ts +0 -264
- package/src/executors/bounded-exec/ram-temp-host.test.ts +0 -635
- package/src/executors/bounded-exec/ram-temp.test.ts +0 -750
- package/src/executors/bounded-exec/run-cpu-pool.test.ts +0 -79
- package/src/executors/bounded-exec/runner-hook.test.ts +0 -193
- package/src/executors/bounded-exec/runner-lifecycle.test.ts +0 -82
- package/src/executors/bounded-exec/verdict.test.ts +0 -545
- package/src/executors/cargo-zigbuild/executor.test.ts +0 -129
- package/src/executors/clean-outputs/executor.test.ts +0 -20
- package/src/executors/typescript-emit/executor.test.ts +0 -83
- package/src/failure-summary.ts +0 -119
- package/src/generators/bounded-test-targets/generator.test.ts +0 -138
- package/src/generators/bun-test-tracing/generator.test.ts +0 -250
- package/src/generators/create-package/generator.test.ts +0 -190
- package/src/generators/make-public/generator.test.ts +0 -137
- package/src/graph-input-contract.test.ts +0 -379
- package/src/host-controller-wiring.test.ts +0 -31
- package/src/index.test.ts +0 -3319
- package/src/linked-snapshots.nx.test.ts +0 -254
- package/src/managed-files/forgejo-artifact.test.ts +0 -395
- package/src/managed-files/generator.test.ts +0 -243
- package/src/managed-files/github-host-cache-isolation.test.ts +0 -86
- package/src/managed-files/json-edit.test.ts +0 -216
- package/src/managed-files/managed-content.test.ts +0 -166
- package/src/managed-files/managed-format-json.test.ts +0 -308
- package/src/managed-files/repo-path.test.ts +0 -172
- package/src/managed-files/setup-devenv-free-disk.test.ts +0 -95
- package/src/managed-files/trace-db-artifact.test.ts +0 -7
- package/src/managed-files/tree-permissions.test.ts +0 -109
- package/src/managed-files/tree.test.ts +0 -123
- package/src/manifest-hash.test.ts +0 -219
- package/src/nextest-code-bound.test.ts +0 -161
- package/src/nextest-extraction.test.ts +0 -216
- package/src/nextest-extraction.ts +0 -371
- package/src/nextest-partitions.test.ts +0 -501
- package/src/nx-cache-bound.test.ts +0 -109
- package/src/nx-cache-restore-mtime.test.ts +0 -170
- package/src/nx-daemon-claim.test.ts +0 -279
- package/src/nx-daemon-idle-cpu.test.ts +0 -80
- package/src/nx-daemon-idle-policy.test.ts +0 -111
- package/src/nx-daemon-ignore-files.test.ts +0 -210
- package/src/nx-daemon-root-normalization.test.ts +0 -105
- package/src/nx-daemon-start-never.test.ts +0 -292
- package/src/nx-daemon-validity.test.ts +0 -1055
- package/src/nx-dot-input-policy.test.ts +0 -353
- package/src/nx-failure-life-cycles.test.ts +0 -207
- package/src/nx-files-archive-racy.test.ts +0 -97
- package/src/nx-foreign-workspace-env.test.ts +0 -329
- package/src/nx-incomplete-run-summary.test.ts +0 -70
- package/src/nx-plugin-load-errors.test.ts +0 -120
- package/src/nx-project-graph-errors.test.ts +0 -70
- package/src/nx-project-resolution-cache.test.ts +0 -176
- package/src/nx-raw-inputs.test.ts +0 -166
- package/src/nx-resident-graph-workers.test.ts +0 -112
- package/src/nx-run-information.test.ts +0 -118
- package/src/nx-skipped-task-exit.test.ts +0 -180
- package/src/nx-state-location.test.ts +0 -63
- package/src/nx-store-resolution.test.ts +0 -81
- package/src/nx-task-graph-cycles.test.ts +0 -148
- package/src/nx-task-output-lease.test.ts +0 -550
- package/src/nx-use-local.test.ts +0 -105
- package/src/owned-installation.test.ts +0 -105
- package/src/package-target-policy.test.ts +0 -1014
- package/src/producer-receipts.test.ts +0 -285
- package/src/release-config-policy.test.ts +0 -311
- package/src/runtime-input.test.ts +0 -393
- package/src/serial-group-wiring.test.ts +0 -326
- package/src/task-history-namespace.test.ts +0 -181
- package/src/task-results.test.ts +0 -228
- package/src/test-clock-policy.test.ts +0 -338
- package/src/test-program.test.ts +0 -303
- package/src/test-timings.test.ts +0 -240
- package/src/test-walk-policy.test.ts +0 -620
- package/src/testing.test.ts +0 -509
- package/src/typecheck-test-policy.test.ts +0 -1468
- package/src/typescript-resolution.test.ts +0 -76
- package/src/version-actions.test.ts +0 -80
- package/src/workspace-config-policy.test.ts +0 -737
|
@@ -1,48 +1,50 @@
|
|
|
1
|
-
import { lstat } from 'node:fs/promises';
|
|
2
1
|
import { availableParallelism } from 'node:os';
|
|
3
2
|
import { logger } from 'nx/src/devkit-exports.js';
|
|
4
3
|
import type { PostTasksExecutionContext, PreTasksExecutionContext } from 'nx/src/project-graph/plugins/public-api.js';
|
|
5
4
|
import { type CpuPool, createCpuPool, readInheritedCpuPool } from './cpu-pool.js';
|
|
6
|
-
import {
|
|
5
|
+
import { CPU_TOKENS_ENV, parseInheritedTokens } from './runner-sizing.js';
|
|
7
6
|
|
|
8
7
|
/**
|
|
9
|
-
* The CPU
|
|
10
|
-
*
|
|
8
|
+
* The CPU pool of an Nx run (specs/cowshed/05_gateway.md, "Host scheduling", "Parallelism inside a job", "Every Nx run
|
|
9
|
+
* budgets itself").
|
|
11
10
|
*
|
|
12
|
-
* Every runner sizes itself to the whole host unless something
|
|
13
|
-
*
|
|
14
|
-
*
|
|
15
|
-
*
|
|
16
|
-
*
|
|
17
|
-
*
|
|
11
|
+
* Every runner sizes itself to the whole host unless something sizes it: under `NX_PARALLEL=100%` Nx starts every
|
|
12
|
+
* target side by side and each one's runner takes the whole machine. The run therefore serves its own pool, as a
|
|
13
|
+
* granted executor serves its children, and every task inherits it: `bounded-exec` takes from it as from any parent
|
|
14
|
+
* pool, FIFO, the head taking `min(want, free)` once one token is free, and a Cargo that Nx's own `nx:run-commands`
|
|
15
|
+
* starts reads its jobserver fifo through the `CARGO_MAKEFLAGS` the pool exports, so the runners of one run together
|
|
16
|
+
* stay within its count.
|
|
18
17
|
*
|
|
19
|
-
*
|
|
20
|
-
*
|
|
21
|
-
*
|
|
18
|
+
* A run that inherits a pool (an enclosing executor's) takes from that one and serves none. Otherwise its pool holds
|
|
19
|
+
* one token per core, or the inherited positive `BOUNDED_EXEC_CPU_TOKENS` when that is fewer: inside a cowshed job
|
|
20
|
+
* that count is the job's own, so the job's `--want` bounds the run.
|
|
22
21
|
*/
|
|
23
22
|
|
|
24
23
|
/** The pools this process serves, by Nx run id, until that run's `postTasksExecution`. */
|
|
25
24
|
const pools = new Map<string, CpuPool>();
|
|
26
25
|
|
|
27
26
|
/**
|
|
28
|
-
* Serve `context`'s run a pool of `cores` tokens and publish it in `env`, which every task
|
|
29
|
-
* inherits
|
|
30
|
-
*
|
|
27
|
+
* Serve `context`'s run a pool of `min(inherited count, cores)` tokens and publish it in `env`, which every task
|
|
28
|
+
* inherits, unless the run inherits a pool. A pool that cannot be made is said, and the run's tasks are then sized only
|
|
29
|
+
* by the ceilings they inherit.
|
|
31
30
|
*/
|
|
32
31
|
export async function serveRunCpuPool(
|
|
33
32
|
context: Pick<PreTasksExecutionContext, 'id'>,
|
|
34
33
|
env: NodeJS.ProcessEnv = process.env,
|
|
35
|
-
gateway: string = GATEWAY_SOCKET,
|
|
36
34
|
cores: number = availableParallelism(),
|
|
37
35
|
): Promise<void> {
|
|
38
|
-
if (readInheritedCpuPool(env) !== null
|
|
36
|
+
if (readInheritedCpuPool(env) !== null) {
|
|
39
37
|
return;
|
|
40
38
|
}
|
|
39
|
+
const inherited = parseInheritedTokens(env[CPU_TOKENS_ENV]);
|
|
41
40
|
// The pool lives until the run's `postTasksExecution` closes it, or with this process.
|
|
42
|
-
const made = await createCpuPool(
|
|
41
|
+
const made = await createCpuPool(
|
|
42
|
+
inherited === null ? cores : Math.min(inherited, cores),
|
|
43
|
+
new Promise<void>(() => {}),
|
|
44
|
+
);
|
|
43
45
|
if (!made.ok) {
|
|
44
46
|
logger.warn(
|
|
45
|
-
`bounded-exec:
|
|
47
|
+
`bounded-exec: this run's CPU pool failed (${made.error}); its tasks are sized only by the ceilings they inherit`,
|
|
46
48
|
);
|
|
47
49
|
return;
|
|
48
50
|
}
|
|
@@ -64,13 +66,3 @@ export async function closeRunCpuPool(context: Pick<PostTasksExecutionContext, '
|
|
|
64
66
|
logger.warn(`bounded-exec: this run's CPU pool did not close cleanly: ${closed.error}`);
|
|
65
67
|
}
|
|
66
68
|
}
|
|
67
|
-
|
|
68
|
-
async function absent(path: string): Promise<boolean> {
|
|
69
|
-
try {
|
|
70
|
-
await lstat(path);
|
|
71
|
-
return false;
|
|
72
|
-
} catch (error) {
|
|
73
|
-
const code = error instanceof Error && 'code' in error ? error.code : undefined;
|
|
74
|
-
return code === 'ENOENT' || code === 'ENOTDIR';
|
|
75
|
-
}
|
|
76
|
-
}
|
|
@@ -1,16 +1,20 @@
|
|
|
1
1
|
/**
|
|
2
|
-
* Standalone supervisor: <runtime> runner-hook.js <id> <go|cargo> <executable> [args...].
|
|
2
|
+
* Standalone supervisor: <runtime> runner-hook.js <id> <go|cargo|build|run> <executable> [args...].
|
|
3
3
|
* The parent requests native JSON output and supplies a private duplex socket on fd 3.
|
|
4
4
|
* Each newline JSON {id,phase} must be echoed exactly after applying the watchdog state.
|
|
5
|
-
*
|
|
5
|
+
* The opening phase is acknowledged before spawn; each native transition is acknowledged before its
|
|
6
6
|
* stdout record is forwarded. Terminal follows child close and drained output, then its
|
|
7
7
|
* acknowledgement closes the channel. The tool receives only descriptors 0, 1, and 2.
|
|
8
|
+
*
|
|
9
|
+
* `go` and `cargo` open in build and go active on their native records. `build` is a compiler-fixture
|
|
10
|
+
* producer: compilation with no tests of its own, so it opens in build and never goes active. `run` is a
|
|
11
|
+
* command with no build interval to report: it opens active, bounded from spawn as an unhooked command is.
|
|
8
12
|
*/
|
|
9
13
|
import { type ChildProcess, spawn } from 'node:child_process';
|
|
10
14
|
import { Socket } from 'node:net';
|
|
11
15
|
import type { Readable, Writable } from 'node:stream';
|
|
12
16
|
|
|
13
|
-
type Runner = 'go' | 'cargo';
|
|
17
|
+
type Runner = 'go' | 'cargo' | 'build' | 'run';
|
|
14
18
|
type Phase = 'build' | 'active' | 'terminal';
|
|
15
19
|
|
|
16
20
|
interface Lifecycle {
|
|
@@ -24,6 +28,7 @@ function failure(context: string, error: unknown): Error {
|
|
|
24
28
|
|
|
25
29
|
// This executable inherits lib es2022; Promise.withResolvers requires es2024.
|
|
26
30
|
function write(stream: Writable, bytes: Buffer | string): Promise<Error | null> {
|
|
31
|
+
// eslint-disable-next-line deadline/no-unbounded-wait -- WHY unbounded: the parent executor drains these pipes for as long as the command runs; the operator's interrupt or the enclosing runner's bound ends a parent that stopped reading
|
|
27
32
|
return new Promise((resolve) => {
|
|
28
33
|
stream.write(bytes, (error) => resolve(error ?? null));
|
|
29
34
|
});
|
|
@@ -31,6 +36,7 @@ function write(stream: Writable, bytes: Buffer | string): Promise<Error | null>
|
|
|
31
36
|
|
|
32
37
|
/** Only native stdout records change the lifecycle; arbitrary runner text never does. */
|
|
33
38
|
function nativePhase(runner: Runner): (line: Buffer) => Phase | null {
|
|
39
|
+
if (runner === 'build' || runner === 'run') return () => null;
|
|
34
40
|
const packages = new Set<string>();
|
|
35
41
|
let cargoActive = false;
|
|
36
42
|
return (line) => {
|
|
@@ -129,6 +135,7 @@ function lifecycle(id: number, failed: (error: Error) => void): Lifecycle {
|
|
|
129
135
|
async close(): Promise<void> {
|
|
130
136
|
closing = true;
|
|
131
137
|
if (socket.destroyed) return;
|
|
138
|
+
// eslint-disable-next-line deadline/no-unbounded-wait -- WHY unbounded: socket.destroy() below closes this end locally; 'close' follows without the peer
|
|
132
139
|
await new Promise<void>((resolve) => {
|
|
133
140
|
socket.once('close', resolve);
|
|
134
141
|
// The shell retains this endpoint for later commands: shutdown/end would poison
|
|
@@ -208,11 +215,11 @@ async function main([idText, runner, executable, ...args]: readonly string[]): P
|
|
|
208
215
|
idText === undefined ||
|
|
209
216
|
!/^\d+$/.test(idText) ||
|
|
210
217
|
!Number.isSafeInteger(id) ||
|
|
211
|
-
(runner !== 'go' && runner !== 'cargo') ||
|
|
218
|
+
(runner !== 'go' && runner !== 'cargo' && runner !== 'build' && runner !== 'run') ||
|
|
212
219
|
executable === undefined ||
|
|
213
220
|
executable === ''
|
|
214
221
|
) {
|
|
215
|
-
process.stderr.write('runner-hook: usage: <invocation-id> <go|cargo> <executable> [arguments...]\n');
|
|
222
|
+
process.stderr.write('runner-hook: usage: <invocation-id> <go|cargo|build|run> <executable> [arguments...]\n');
|
|
216
223
|
process.exitCode = 2;
|
|
217
224
|
return;
|
|
218
225
|
}
|
|
@@ -242,12 +249,13 @@ async function main([idText, runner, executable, ...args]: readonly string[]): P
|
|
|
242
249
|
let exitSignal: NodeJS.Signals | null = null;
|
|
243
250
|
try {
|
|
244
251
|
channel = lifecycle(id, fail);
|
|
245
|
-
const ready = await channel.announce('build');
|
|
252
|
+
const ready = await channel.announce(runner === 'run' ? 'active' : 'build');
|
|
246
253
|
if (ready !== null) fail(ready);
|
|
247
254
|
if (!failed && interrupted === null) {
|
|
248
255
|
// Descriptor 3 belongs only to this supervisor, never the tool or its descendants.
|
|
249
256
|
const running = spawn(executable, args, { stdio: ['inherit', 'pipe', 'pipe'] });
|
|
250
257
|
child = running;
|
|
258
|
+
// eslint-disable-next-line deadline/no-unbounded-wait -- WHY unbounded: the go or cargo build this supervisor runs lasts as long as its work; the operator's interrupt or the enclosing runner's bound ends a hung one
|
|
251
259
|
const closed = new Promise<void>((resolve) => {
|
|
252
260
|
running.once('close', (status, reason) => {
|
|
253
261
|
code = status;
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
import { fileURLToPath } from 'node:url';
|
|
2
2
|
import { shellWord } from '../../runtime-input.js';
|
|
3
|
-
import { invocationSpan, withInvocationFlag } from './
|
|
3
|
+
import { invocationSpan, withInvocationFlag } from './runner-sizing.js';
|
|
4
4
|
import { GO_TEST } from './verdict.js';
|
|
5
5
|
|
|
6
6
|
const CARGO_TEST = /^cargo(?:\s+(?:-\S+|\+\S+))*\s+test(?=\s|$)/;
|
|
@@ -11,16 +11,23 @@ export interface RunnerPhaseEvent {
|
|
|
11
11
|
phase: RunnerPhase;
|
|
12
12
|
}
|
|
13
13
|
|
|
14
|
+
/** One segment's supervisor invocation: the runtime that adopts the inherited duplex descriptor, then the hook, its id and kind. */
|
|
15
|
+
function hookInvocation(id: number, kind: string, runner: string): string {
|
|
16
|
+
const hook = fileURLToPath(
|
|
17
|
+
new URL(import.meta.url.endsWith('.ts') ? './runner-hook.ts' : './runner-hook.js', import.meta.url),
|
|
18
|
+
);
|
|
19
|
+
// The hook owns an inherited duplex descriptor, which Bun's net.Socket({fd}) does not adopt.
|
|
20
|
+
const runtime = process.versions.bun === undefined ? process.execPath : 'node';
|
|
21
|
+
return `${shellWord(runtime)} ${shellWord(hook)} ${id} ${kind} ${runner}`;
|
|
22
|
+
}
|
|
23
|
+
|
|
14
24
|
/** Only complete, direct chains have a known lifecycle. Shell wrappers remain bounded from spawn. */
|
|
15
|
-
export function withRunnerLifecycle(command: string): { command: string; runners: number } | null {
|
|
25
|
+
export function withRunnerLifecycle(command: string, firstId = 0): { command: string; runners: number } | null {
|
|
16
26
|
// Redirections could replace the private descriptor; newlines/backticks/escapes need a real shell parser.
|
|
17
27
|
if (/[<>\n\r`\\]/.test(command)) return null;
|
|
18
28
|
let rest = command.trim();
|
|
19
29
|
const parts: string[] = [];
|
|
20
30
|
let runners = 0;
|
|
21
|
-
const hook = fileURLToPath(
|
|
22
|
-
new URL(import.meta.url.endsWith('.ts') ? './runner-hook.ts' : './runner-hook.js', import.meta.url),
|
|
23
|
-
);
|
|
24
31
|
while (rest !== '') {
|
|
25
32
|
const kind = rest.search(GO_TEST) === 0 ? 'go' : CARGO_TEST.test(rest) ? 'cargo' : null;
|
|
26
33
|
if (kind === null) return null;
|
|
@@ -40,9 +47,7 @@ export function withRunnerLifecycle(command: string): { command: string; runners
|
|
|
40
47
|
true,
|
|
41
48
|
) + runner.slice(end);
|
|
42
49
|
}
|
|
43
|
-
|
|
44
|
-
const runtime = process.versions.bun === undefined ? process.execPath : 'node';
|
|
45
|
-
parts.push(`${shellWord(runtime)} ${shellWord(hook)} ${runners} ${kind} ${runner}`);
|
|
50
|
+
parts.push(hookInvocation(firstId + runners, kind, runner));
|
|
46
51
|
runners += 1;
|
|
47
52
|
rest = rest.slice(argsEnd).trimStart();
|
|
48
53
|
if (rest === '') break;
|
|
@@ -55,6 +60,24 @@ export function withRunnerLifecycle(command: string): { command: string; runners
|
|
|
55
60
|
return runners === 0 ? null : { command: parts.join(' '), runners };
|
|
56
61
|
}
|
|
57
62
|
|
|
63
|
+
/**
|
|
64
|
+
* `command` preceded by its compiler-fixture producer (`fixtureCommand`, schema.ts): segment 0 supervises the
|
|
65
|
+
* fixture as a build interval for its whole life, and the command follows under `&&`, so a fixture failure ends
|
|
66
|
+
* the run before any test starts. A direct `cargo test`/`go test` chain keeps its own phases behind a brace
|
|
67
|
+
* group, so a `||` inside it cannot run a leg the fixture refused. Any other command runs as one `run`
|
|
68
|
+
* segment: active from its spawn, its output on the progress bound exactly as an unhooked command's is, with no
|
|
69
|
+
* descendant holding the private descriptor. The fixture is arbitrary shell, so it rides under `/bin/sh -c`;
|
|
70
|
+
* this lifecycle is POSIX-only, as the channel itself is.
|
|
71
|
+
*/
|
|
72
|
+
export function withFixtureLifecycle(fixtureCommand: string, command: string): { command: string; runners: number } {
|
|
73
|
+
const fixture = hookInvocation(0, 'build', `/bin/sh -c ${shellWord(fixtureCommand)}`);
|
|
74
|
+
const main = withRunnerLifecycle(command, 1);
|
|
75
|
+
if (main !== null) {
|
|
76
|
+
return { command: `${fixture} && { ${main.command}; }`, runners: main.runners + 1 };
|
|
77
|
+
}
|
|
78
|
+
return { command: `${fixture} && ${hookInvocation(1, 'run', `/bin/sh -c ${shellWord(command)}`)}`, runners: 2 };
|
|
79
|
+
}
|
|
80
|
+
|
|
58
81
|
/** A private supervisor channel, not runner output, grants authority to pause the test clock. */
|
|
59
82
|
export function createRunnerLifecycle(runners: number) {
|
|
60
83
|
let current = 0;
|
|
@@ -1,16 +1,14 @@
|
|
|
1
|
-
import { GATEWAY_SOCKET, holdLease, type UnleasedCause } from './gateway-lease.js';
|
|
2
1
|
import { BUN_TEST, GO_TEST, NEXTEST_RUN } from './verdict.js';
|
|
3
2
|
|
|
4
3
|
/**
|
|
5
|
-
*
|
|
4
|
+
* How a runner's parallelism is read from its command and sized to the tokens its CPU pool lends
|
|
5
|
+
* (specs/cowshed/05_gateway.md, "Host scheduling", "Parallelism inside a job").
|
|
6
6
|
*
|
|
7
|
-
*
|
|
8
|
-
* nextest run under it runs a test thread per core again
|
|
9
|
-
*
|
|
10
|
-
*
|
|
11
|
-
*
|
|
12
|
-
* processes at once, and sizes the runner to the grant: every gate keeps running in parallel, and
|
|
13
|
-
* the total stays near the core count.
|
|
7
|
+
* A runner sizes itself to the whole machine unless something sizes it: Nx runs a task per core and
|
|
8
|
+
* each nextest run under it runs a test thread per core again. Before it starts a runner,
|
|
9
|
+
* bounded-exec asks its parent's pool for as many tokens as the runner would run threads or
|
|
10
|
+
* processes at once and sizes the runner to the grant, so the runners of one build tree together
|
|
11
|
+
* stay within that tree's pool.
|
|
14
12
|
*/
|
|
15
13
|
|
|
16
14
|
/** How a runner's parallelism is set, which decides what it asks for and how a grant sizes it. */
|
|
@@ -38,7 +36,7 @@ export interface TestThreadCeilings {
|
|
|
38
36
|
}
|
|
39
37
|
|
|
40
38
|
/**
|
|
41
|
-
* What a runner asks
|
|
39
|
+
* What a runner asks its pool for. A cargo build, and a process whose script may start Cargo, carry the test-thread
|
|
42
40
|
* ceilings their sizing keeps; cargo-mutants carries how many cargo processes it runs at once, which share its grant.
|
|
43
41
|
*/
|
|
44
42
|
export type Demand =
|
|
@@ -286,8 +284,9 @@ export function withInvocationFlag(
|
|
|
286
284
|
* so they cannot outrank that size. `CPU_TOKENS_ENV` still reports the actual held grant.
|
|
287
285
|
*
|
|
288
286
|
* Cargo's rustc count is the pool's: the executor's sub-pool exports its jobserver fifo, so no `CARGO_BUILD_JOBS`
|
|
289
|
-
* comes from the grant (specs/cowshed/05_gateway.md, "
|
|
290
|
-
* cargo build's test threads are its size, and a process's, whose script may start Cargo, are
|
|
287
|
+
* comes from the grant (specs/cowshed/05_gateway.md, "Cargo reads its holder's jobserver"). Test threads take no
|
|
288
|
+
* jobserver token, so a cargo build's test threads are its size, and a process's, whose script may start Cargo, are
|
|
289
|
+
* its whole held grant.
|
|
291
290
|
*/
|
|
292
291
|
export function sizeRunner(
|
|
293
292
|
demand: Demand,
|
|
@@ -356,9 +355,8 @@ function inheritedCeiling(inherited: string | undefined, configured: string | un
|
|
|
356
355
|
|
|
357
356
|
/**
|
|
358
357
|
* The count `CPU_TOKENS_ENV` names, as a positive safe integer, or `null` when absent or malformed. It is
|
|
359
|
-
* descriptor input only: a count proves nothing about a live pool and grants nothing.
|
|
360
|
-
*
|
|
361
|
-
* absence follows the host path, while a connected parent's refusal fails admission to avoid hold-and-wait.
|
|
358
|
+
* descriptor input only: a count proves nothing about a live pool and grants nothing. It is a ceiling the
|
|
359
|
+
* runner keeps, and the size an Nx run's own pool takes (`run-cpu-pool.ts`).
|
|
362
360
|
*/
|
|
363
361
|
export function parseInheritedTokens(value: string | undefined): number | null {
|
|
364
362
|
if (value === undefined || !INHERITED_COUNT.test(value)) {
|
|
@@ -367,47 +365,3 @@ export function parseInheritedTokens(value: string | undefined): number | null {
|
|
|
367
365
|
const tokens = Number(value);
|
|
368
366
|
return Number.isSafeInteger(tokens) ? tokens : null;
|
|
369
367
|
}
|
|
370
|
-
|
|
371
|
-
/**
|
|
372
|
-
* Tokens held until released, or why the runner starts without the budget. `closed` resolves when
|
|
373
|
-
* the grant's connection closes, however it closes, so a sub-pool built on the grant ends with it.
|
|
374
|
-
* `inherited` marks tokens a parent's CPU pool lent, not tokens the host gateway granted.
|
|
375
|
-
*/
|
|
376
|
-
export type TokenGrant =
|
|
377
|
-
| { granted: true; tokens: number; release: () => void; closed: Promise<void>; inherited?: true }
|
|
378
|
-
| { granted: false; cause: UnleasedCause; reason: string };
|
|
379
|
-
|
|
380
|
-
/** Where bounded-exec takes its tokens; the gateway in production, a fake in tests. */
|
|
381
|
-
export interface CpuBudget {
|
|
382
|
-
take(want: number, checkout: string, command: string): Promise<TokenGrant>;
|
|
383
|
-
}
|
|
384
|
-
|
|
385
|
-
/**
|
|
386
|
-
* The gateway at `socket`'s budget. A grant has no deadline: the wait is how the budget works, and
|
|
387
|
-
* the gateway answers `queued` at once, so a client knows it is alive. `checkout` is the Nx
|
|
388
|
-
* workspace root: the gateway shares tokens fairly between checkouts.
|
|
389
|
-
*/
|
|
390
|
-
export function gatewayCpuBudget(socket: string = GATEWAY_SOCKET): CpuBudget {
|
|
391
|
-
return {
|
|
392
|
-
async take(want, checkout, command) {
|
|
393
|
-
const lease = await holdLease(socket, { op: 'cpu-tokens', want, checkout, command }, 'the CPU budget', {
|
|
394
|
-
ackMs: 2_000,
|
|
395
|
-
afterCloseMs: 5_000,
|
|
396
|
-
grantMs: null,
|
|
397
|
-
});
|
|
398
|
-
if (!lease.granted) {
|
|
399
|
-
return lease;
|
|
400
|
-
}
|
|
401
|
-
const tokens = lease.answer.tokens;
|
|
402
|
-
if (typeof tokens !== 'number' || !Number.isInteger(tokens) || tokens < 1 || tokens > want) {
|
|
403
|
-
lease.release();
|
|
404
|
-
return {
|
|
405
|
-
granted: false,
|
|
406
|
-
cause: 'other',
|
|
407
|
-
reason: `the gateway granted ${JSON.stringify(tokens)} tokens for ${want}`,
|
|
408
|
-
};
|
|
409
|
-
}
|
|
410
|
-
return { granted: true, tokens, release: lease.release, closed: lease.closed };
|
|
411
|
-
},
|
|
412
|
-
};
|
|
413
|
-
}
|
|
@@ -0,0 +1,232 @@
|
|
|
1
|
+
import { execFile } from 'node:child_process';
|
|
2
|
+
import { accessSync, constants, readFileSync, statSync } from 'node:fs';
|
|
3
|
+
import { delimiter, join, resolve } from 'node:path';
|
|
4
|
+
import { promisify } from 'node:util';
|
|
5
|
+
import type { Result } from './ram-temp.js';
|
|
6
|
+
|
|
7
|
+
/**
|
|
8
|
+
* A leg that runs `bun` runs the Bun its workspace declares.
|
|
9
|
+
*
|
|
10
|
+
* The root `package.json` names that Bun in `packageManager` (`bun@1.4.3`); the Bun the command gets is the first `bun`
|
|
11
|
+
* on the PATH it runs with. When the two disagree the leg is refused before it asks for anything, naming both versions
|
|
12
|
+
* and the binary. A Bun other than the declared one does not fail at startup: on Bun 1.4.2 `console.log` drops what a
|
|
13
|
+
* full pipe refuses, so a child's JSON document reaches the parent that reads it cut in the middle of a string, the
|
|
14
|
+
* child exits 0, and the leg fails three layers from the cause as `JSON Parse error: Unterminated string`. The refusal
|
|
15
|
+
* is that mismatch, said where it happens.
|
|
16
|
+
*/
|
|
17
|
+
|
|
18
|
+
/**
|
|
19
|
+
* `bun --version` answers in milliseconds. The bound is for a `bun` that never answers (a wrapper waiting on a lock):
|
|
20
|
+
* it refuses the leg, which would otherwise hang before its own bounds start.
|
|
21
|
+
*/
|
|
22
|
+
const VERSION_DEADLINE_MS = 120_000;
|
|
23
|
+
|
|
24
|
+
/**
|
|
25
|
+
* A word `bun` that the shell resolves through PATH, in command position or in a string a wrapper runs: `bun test`,
|
|
26
|
+
* `cd x && bun run y`, `FOO=1 bun a`, `sh -c 'bun test'`. A path-qualified `../runtime/bun` names its binary itself,
|
|
27
|
+
* so PATH decides nothing for it; `bunx`, `bun-runtime` and `bun.js` are other words.
|
|
28
|
+
*/
|
|
29
|
+
const BUN_COMMAND = /(?<=^|[\s;&|()'"`])bun(?=$|[\s;&|()'"`])/;
|
|
30
|
+
|
|
31
|
+
/** `bun@<version>` as corepack spells `packageManager`, with the content hash it may add after `+`. */
|
|
32
|
+
const BUN_DECLARATION = /^bun@(\d+\.\d+\.\d+(?:-[0-9A-Za-z.-]+)?)(?:\+.+)?$/;
|
|
33
|
+
|
|
34
|
+
const execFileAsync = promisify(execFile);
|
|
35
|
+
|
|
36
|
+
/** What the workspace declares: `bun@<version>` in its root `package.json`'s `packageManager`. */
|
|
37
|
+
export interface DeclaredBun {
|
|
38
|
+
/** The manifest that declares it. */
|
|
39
|
+
readonly manifest: string;
|
|
40
|
+
/** The field as written. */
|
|
41
|
+
readonly declaration: string;
|
|
42
|
+
/** The version it names, without the content hash. */
|
|
43
|
+
readonly version: string;
|
|
44
|
+
}
|
|
45
|
+
|
|
46
|
+
/** Where the command's PATH comes from: the target's own `env`, or the process the executor runs in. */
|
|
47
|
+
export type PathSource = "the target's env" | 'the inherited environment';
|
|
48
|
+
|
|
49
|
+
/** Why a leg that runs `bun` is not run, as the values the message is made of. */
|
|
50
|
+
export type RuntimePinRefusal =
|
|
51
|
+
| {
|
|
52
|
+
readonly code: 'mismatch';
|
|
53
|
+
readonly declared: DeclaredBun;
|
|
54
|
+
/** The first `bun` on the command's PATH. */
|
|
55
|
+
readonly bun: string;
|
|
56
|
+
/** What that `bun --version` printed. */
|
|
57
|
+
readonly version: string;
|
|
58
|
+
readonly pathSource: PathSource;
|
|
59
|
+
}
|
|
60
|
+
| {
|
|
61
|
+
readonly code: 'unreadable-version';
|
|
62
|
+
readonly declared: DeclaredBun;
|
|
63
|
+
readonly bun: string;
|
|
64
|
+
readonly reason: string;
|
|
65
|
+
readonly pathSource: PathSource;
|
|
66
|
+
}
|
|
67
|
+
| { readonly code: 'malformed-declaration'; readonly manifest: string; readonly declaration: string }
|
|
68
|
+
| { readonly code: 'unreadable-manifest'; readonly manifest: string; readonly reason: string };
|
|
69
|
+
|
|
70
|
+
/** What `bun --version` printed for `bun` run in `env` from `cwd`, or why it printed none. */
|
|
71
|
+
export type BunProbe = (bun: string, env: NodeJS.ProcessEnv, cwd: string) => Promise<Result<string, string>>;
|
|
72
|
+
|
|
73
|
+
export interface RuntimePinCheck {
|
|
74
|
+
/** The workspace root: its `package.json` declares the Bun. */
|
|
75
|
+
readonly root: string;
|
|
76
|
+
/** The command line, as the shell will run it. */
|
|
77
|
+
readonly command: string;
|
|
78
|
+
/** The environment the command runs with: its PATH decides which `bun` it gets. */
|
|
79
|
+
readonly env: NodeJS.ProcessEnv;
|
|
80
|
+
/** Where the command starts; a relative PATH entry is relative to it. */
|
|
81
|
+
readonly cwd: string;
|
|
82
|
+
readonly pathSource: PathSource;
|
|
83
|
+
}
|
|
84
|
+
|
|
85
|
+
/** Whether `command` names `bun` for the shell to find on PATH: the legs this guard is for. */
|
|
86
|
+
export function runsBun(command: string): boolean {
|
|
87
|
+
return BUN_COMMAND.test(command);
|
|
88
|
+
}
|
|
89
|
+
|
|
90
|
+
/**
|
|
91
|
+
* The first executable regular file `name` on `pathValue`, as the shell the command runs under finds it. An empty entry
|
|
92
|
+
* is the working directory, like `.`: the command starts in `cwd`, which is not the executor's.
|
|
93
|
+
*/
|
|
94
|
+
export function resolveOnPath(name: string, pathValue: string | undefined, cwd: string): string | null {
|
|
95
|
+
for (const entry of (pathValue ?? '').split(delimiter)) {
|
|
96
|
+
const candidate = resolve(cwd, entry === '' ? '.' : entry, name);
|
|
97
|
+
try {
|
|
98
|
+
if (!statSync(candidate).isFile()) {
|
|
99
|
+
continue;
|
|
100
|
+
}
|
|
101
|
+
accessSync(candidate, constants.X_OK);
|
|
102
|
+
} catch {
|
|
103
|
+
continue;
|
|
104
|
+
}
|
|
105
|
+
return candidate;
|
|
106
|
+
}
|
|
107
|
+
return null;
|
|
108
|
+
}
|
|
109
|
+
|
|
110
|
+
/**
|
|
111
|
+
* The Bun the workspace declares, `null` when it declares none: no manifest, no `packageManager`, or another package
|
|
112
|
+
* manager's. A `packageManager` that names `bun` and no version is refused, not read as no declaration: it says a Bun
|
|
113
|
+
* is declared, and a guard that skipped it would be silent exactly where the declaration is wrong.
|
|
114
|
+
*/
|
|
115
|
+
export function declaredBun(root: string): Result<DeclaredBun | null, RuntimePinRefusal> {
|
|
116
|
+
const manifest = join(root, 'package.json');
|
|
117
|
+
let parsed: unknown;
|
|
118
|
+
try {
|
|
119
|
+
parsed = JSON.parse(readFileSync(manifest, 'utf8'));
|
|
120
|
+
} catch (error) {
|
|
121
|
+
if (error instanceof Error && 'code' in error && error.code === 'ENOENT') {
|
|
122
|
+
return { ok: true, value: null };
|
|
123
|
+
}
|
|
124
|
+
const reason = error instanceof Error ? error.message : String(error);
|
|
125
|
+
return { ok: false, error: { code: 'unreadable-manifest', manifest, reason } };
|
|
126
|
+
}
|
|
127
|
+
const declaration: unknown =
|
|
128
|
+
typeof parsed === 'object' && parsed !== null && 'packageManager' in parsed ? parsed.packageManager : undefined;
|
|
129
|
+
if (typeof declaration !== 'string' || !declaration.startsWith('bun@')) {
|
|
130
|
+
return { ok: true, value: null };
|
|
131
|
+
}
|
|
132
|
+
const version = BUN_DECLARATION.exec(declaration)?.[1];
|
|
133
|
+
if (version === undefined) {
|
|
134
|
+
return { ok: false, error: { code: 'malformed-declaration', manifest, declaration } };
|
|
135
|
+
}
|
|
136
|
+
return { ok: true, value: { manifest, declaration, version } };
|
|
137
|
+
}
|
|
138
|
+
|
|
139
|
+
/** The version `bun --version` prints in the command's own environment, which is what a wrapper reads to route. */
|
|
140
|
+
export const probeBunVersion: BunProbe = async (bun, env, cwd) => {
|
|
141
|
+
try {
|
|
142
|
+
const { stdout } = await execFileAsync(bun, ['--version'], {
|
|
143
|
+
env,
|
|
144
|
+
cwd,
|
|
145
|
+
encoding: 'utf8',
|
|
146
|
+
timeout: VERSION_DEADLINE_MS,
|
|
147
|
+
killSignal: 'SIGKILL',
|
|
148
|
+
maxBuffer: 64 * 1024,
|
|
149
|
+
});
|
|
150
|
+
return { ok: true, value: stdout.trim() };
|
|
151
|
+
} catch (error) {
|
|
152
|
+
if (error instanceof Error && 'killed' in error && error.killed === true) {
|
|
153
|
+
return { ok: false, error: `\`bun --version\` gave no answer within ${VERSION_DEADLINE_MS} ms` };
|
|
154
|
+
}
|
|
155
|
+
const said =
|
|
156
|
+
error instanceof Error && 'stderr' in error && typeof error.stderr === 'string' ? error.stderr.trim() : '';
|
|
157
|
+
const reason = error instanceof Error ? error.message : String(error);
|
|
158
|
+
return { ok: false, error: `\`bun --version\` failed: ${reason}${said === '' ? '' : `: ${said}`}` };
|
|
159
|
+
}
|
|
160
|
+
};
|
|
161
|
+
|
|
162
|
+
/**
|
|
163
|
+
* The refusal that keeps a leg off a Bun its workspace does not declare, or `null` when the leg may run: it names no
|
|
164
|
+
* `bun`, the workspace declares none, PATH finds none (the shell will say so), or the one it finds is the declared
|
|
165
|
+
* version. Not checked on Windows, where the executor starts no lifecycle supervisor either.
|
|
166
|
+
*/
|
|
167
|
+
export async function checkRuntimePin(
|
|
168
|
+
check: RuntimePinCheck,
|
|
169
|
+
probe: BunProbe = probeBunVersion,
|
|
170
|
+
): Promise<RuntimePinRefusal | null> {
|
|
171
|
+
if (process.platform === 'win32' || !runsBun(check.command)) {
|
|
172
|
+
return null;
|
|
173
|
+
}
|
|
174
|
+
const declared = declaredBun(check.root);
|
|
175
|
+
if (!declared.ok) {
|
|
176
|
+
return declared.error;
|
|
177
|
+
}
|
|
178
|
+
if (declared.value === null) {
|
|
179
|
+
return null;
|
|
180
|
+
}
|
|
181
|
+
const bun = resolveOnPath('bun', check.env.PATH, check.cwd);
|
|
182
|
+
if (bun === null) {
|
|
183
|
+
return null;
|
|
184
|
+
}
|
|
185
|
+
const printed = await probe(bun, check.env, check.cwd);
|
|
186
|
+
if (!printed.ok) {
|
|
187
|
+
return {
|
|
188
|
+
code: 'unreadable-version',
|
|
189
|
+
declared: declared.value,
|
|
190
|
+
bun,
|
|
191
|
+
reason: printed.error,
|
|
192
|
+
pathSource: check.pathSource,
|
|
193
|
+
};
|
|
194
|
+
}
|
|
195
|
+
return printed.value === declared.value.version
|
|
196
|
+
? null
|
|
197
|
+
: { code: 'mismatch', declared: declared.value, bun, version: printed.value, pathSource: check.pathSource };
|
|
198
|
+
}
|
|
199
|
+
|
|
200
|
+
/** What the symptom of running another Bun looks like, so a reader sees what the refusal replaces. */
|
|
201
|
+
const SYMPTOM =
|
|
202
|
+
'A leg on another Bun can pass its startup and fail far from the cause: on Bun 1.4.2 `console.log` drops what a ' +
|
|
203
|
+
"full pipe refuses, so a child's JSON reaches its parent cut mid-string while the child exits 0.";
|
|
204
|
+
|
|
205
|
+
/** The refusal as the run's stderr says it, one line per fact, naming the task when the run has one. */
|
|
206
|
+
export function describeRuntimePinRefusal(refusal: RuntimePinRefusal, task?: string): string {
|
|
207
|
+
const refused = `${task ?? 'bounded-exec'}: refusing to run the command: `;
|
|
208
|
+
switch (refusal.code) {
|
|
209
|
+
case 'mismatch':
|
|
210
|
+
return `${[
|
|
211
|
+
`${refused}the workspace declares Bun ${refusal.declared.version}, and the \`bun\` it would run is Bun ${refusal.version}.`,
|
|
212
|
+
` declared by: packageManager "${refusal.declared.declaration}" in ${refusal.declared.manifest}`,
|
|
213
|
+
` resolved by: PATH from ${refusal.pathSource}; its first \`bun\` is ${refusal.bun}, which prints ${refusal.version}`,
|
|
214
|
+
SYMPTOM,
|
|
215
|
+
"Run the leg from the workspace's own shell, or put the declared Bun first on PATH.",
|
|
216
|
+
].join('\n')}\n`;
|
|
217
|
+
case 'unreadable-version':
|
|
218
|
+
return `${[
|
|
219
|
+
`${refused}the workspace declares Bun ${refusal.declared.version}, and the \`bun\` it would run did not say which Bun it is.`,
|
|
220
|
+
` declared by: packageManager "${refusal.declared.declaration}" in ${refusal.declared.manifest}`,
|
|
221
|
+
` resolved by: PATH from ${refusal.pathSource}; its first \`bun\` is ${refusal.bun}: ${refusal.reason}`,
|
|
222
|
+
SYMPTOM,
|
|
223
|
+
].join('\n')}\n`;
|
|
224
|
+
case 'malformed-declaration':
|
|
225
|
+
return `${[
|
|
226
|
+
`${refused}${refusal.manifest} declares packageManager "${refusal.declaration}", which names no Bun version to compare.`,
|
|
227
|
+
'Declare an exact version, `bun@<major>.<minor>.<patch>`.',
|
|
228
|
+
].join('\n')}\n`;
|
|
229
|
+
case 'unreadable-manifest':
|
|
230
|
+
return `${refused}cannot read the workspace's declaration in ${refusal.manifest}: ${refusal.reason}\n`;
|
|
231
|
+
}
|
|
232
|
+
}
|
|
@@ -32,7 +32,7 @@
|
|
|
32
32
|
"idleTimeoutMs": {
|
|
33
33
|
"type": "number",
|
|
34
34
|
"minimum": 1,
|
|
35
|
-
"description": "Kill the process tree when no test has finished for this many milliseconds: a
|
|
35
|
+
"description": "Kill the process tree when no test has finished for this many milliseconds: a runner's finished-test, file or package report, including Vitest reporter results, or a bun dot. Output that reports no finished test (a SLOW warning, a heartbeat) is not progress. A command that reports no tests makes progress only by exiting. Omit for no progress bound."
|
|
36
36
|
},
|
|
37
37
|
"killAfterMs": {
|
|
38
38
|
"type": "number",
|
|
@@ -40,10 +40,19 @@
|
|
|
40
40
|
"default": 10000,
|
|
41
41
|
"description": "Most milliseconds a timed-out or CPU-grant-revoked command gets after graceful termination before its process group is force-killed. The grace ends early when the command exits; whatever it leaves in its process group is force-killed then."
|
|
42
42
|
},
|
|
43
|
+
"fixtureCommand": {
|
|
44
|
+
"type": "string",
|
|
45
|
+
"description": "A compiler-fixture producer for command: a shell command run first, in the same cwd, environment and CPU grant, as a lifecycle build interval the progress bound does not run during. Its failure fails the run and command starts only after it exits 0. For warmth outside Nx outputs (a compiler plugin cache, a Cargo target directory): inside the consumer's task a cache hit restores the verdict and warms nothing, an execution warms first. Requires fixtureTimeoutMs."
|
|
46
|
+
},
|
|
47
|
+
"fixtureTimeoutMs": {
|
|
48
|
+
"type": "number",
|
|
49
|
+
"minimum": 1,
|
|
50
|
+
"description": "The fixture segment's own wall-clock ceiling in milliseconds: a build budget bounding only the fixture interval, never the command it prepares. Required with fixtureCommand."
|
|
51
|
+
},
|
|
43
52
|
"parallelism": {
|
|
44
53
|
"type": "integer",
|
|
45
54
|
"minimum": 1,
|
|
46
|
-
"description": "Requested threads or processes before inherited runner ceilings: positive NEXTEST_TEST_THREADS and CARGO_BUILD_JOBS cap their respective runners, and configured counts may only lower an inherited ceiling. Omit to let the command decide (nextest and cargo one per core, `bun test --parallel=N` N, anything else one). Runner concurrency is min(bounded request,
|
|
55
|
+
"description": "Requested threads or processes before inherited runner ceilings: positive NEXTEST_TEST_THREADS and CARGO_BUILD_JOBS cap their respective runners, and configured counts may only lower an inherited ceiling. Omit to let the command decide (nextest and cargo one per core, `bun test --parallel=N` N, anything else one). Runner concurrency is min(bounded request, tokens its parent CPU pool grants); the actual held grant reaches the command as BOUNDED_EXEC_CPU_TOKENS, with its sub-pool in BOUNDED_EXEC_CPU_POOL."
|
|
47
56
|
},
|
|
48
57
|
"forwardAllArgs": {
|
|
49
58
|
"type": "boolean",
|
|
@@ -26,9 +26,27 @@ export interface BoundedExecCommand {
|
|
|
26
26
|
*/
|
|
27
27
|
idleTimeoutMs?: number;
|
|
28
28
|
killAfterMs?: number;
|
|
29
|
+
|
|
30
|
+
/**
|
|
31
|
+
* A compiler-fixture producer for `command`: a shell command run first, in the same cwd, environment and CPU
|
|
32
|
+
* grant, whose whole life is a lifecycle build interval — the progress bound does not run during it, as it does
|
|
33
|
+
* not run during a `cargo test` build. Its failure fails the run; `command` starts only after it exits 0.
|
|
34
|
+
*
|
|
35
|
+
* It exists for warmth that lives outside Nx outputs (a compiler plugin cache, a Cargo target directory). As a
|
|
36
|
+
* separate `cache: false` prerequisite that warmth was paid even when every consumer then hit the cache, since
|
|
37
|
+
* Nx reaches a cached consumer only after its uncached dependencies; as plain text at the head of `command`
|
|
38
|
+
* its cold minutes would spend the progress bound. Inside the consumer's own task the cache decides: a hit
|
|
39
|
+
* restores the verdict and warms nothing, an execution warms first.
|
|
40
|
+
*/
|
|
41
|
+
fixtureCommand?: string;
|
|
42
|
+
/**
|
|
43
|
+
* The fixture segment's own wall-clock ceiling: a build budget, required with `fixtureCommand`. It bounds
|
|
44
|
+
* only the fixture interval, never the command it prepares.
|
|
45
|
+
*/
|
|
46
|
+
fixtureTimeoutMs?: number;
|
|
29
47
|
/**
|
|
30
48
|
* The most threads or processes the command runs at once, which is how many CPU tokens it asks
|
|
31
|
-
* its live parent pool
|
|
49
|
+
* its live parent pool for. Absent, the runner in the command decides:
|
|
32
50
|
* nextest and cargo one per core, `bun test --parallel=N` N, anything else one. The actual grant
|
|
33
51
|
* reaches the command as `BOUNDED_EXEC_CPU_TOKENS`, with its sub-pool in `BOUNDED_EXEC_CPU_POOL`.
|
|
34
52
|
*/
|