@smoothbricks/nx-plugin 0.5.7 → 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.
Files changed (432) hide show
  1. package/README.md +1086 -360
  2. package/dist/.build-inputs.json +138 -0
  3. package/dist/bin/smoo-nx-cargo-toolchain.d.ts +3 -0
  4. package/dist/bin/smoo-nx-cargo-toolchain.d.ts.map +1 -0
  5. package/dist/bin/smoo-nx-cargo-toolchain.js +8 -0
  6. package/dist/bin/smoo-nx-forbidden-spellings.d.ts +3 -0
  7. package/dist/bin/smoo-nx-forbidden-spellings.d.ts.map +1 -0
  8. package/dist/bin/smoo-nx-forbidden-spellings.js +32 -0
  9. package/dist/bin/smoo-nx-nextest-timings.d.ts +3 -0
  10. package/dist/bin/smoo-nx-nextest-timings.d.ts.map +1 -0
  11. package/dist/bin/smoo-nx-nextest-timings.js +28 -0
  12. package/dist/bounded-test-policy.d.ts +1 -1
  13. package/dist/bounded-test-policy.d.ts.map +1 -1
  14. package/dist/bounded-test-policy.js +14 -15
  15. package/dist/build-state-output-policy.d.ts +95 -1
  16. package/dist/build-state-output-policy.d.ts.map +1 -1
  17. package/dist/build-state-output-policy.js +368 -30
  18. package/dist/bun-lock-scope.d.ts +44 -0
  19. package/dist/bun-lock-scope.d.ts.map +1 -0
  20. package/dist/bun-lock-scope.js +97 -0
  21. package/dist/cargo-build-script-env.d.ts +49 -0
  22. package/dist/cargo-build-script-env.d.ts.map +1 -0
  23. package/dist/cargo-build-script-env.js +324 -0
  24. package/dist/cargo-closure-input.d.ts +31 -4
  25. package/dist/cargo-closure-input.d.ts.map +1 -1
  26. package/dist/cargo-closure-input.js +66 -6
  27. package/dist/cargo-retention-hook.d.ts +17 -0
  28. package/dist/cargo-retention-hook.d.ts.map +1 -0
  29. package/dist/cargo-retention-hook.js +85 -0
  30. package/dist/cargo-source-hash.d.ts +25 -7
  31. package/dist/cargo-source-hash.d.ts.map +1 -1
  32. package/dist/cargo-source-hash.js +108 -43
  33. package/dist/cargo-toolchain-paths.d.ts +40 -0
  34. package/dist/cargo-toolchain-paths.d.ts.map +1 -0
  35. package/dist/cargo-toolchain-paths.js +84 -0
  36. package/dist/cargo-toolchain-policy.d.ts +25 -8
  37. package/dist/cargo-toolchain-policy.d.ts.map +1 -1
  38. package/dist/cargo-toolchain-policy.js +39 -5
  39. package/dist/cargo-workspace.d.ts +10 -4
  40. package/dist/cargo-workspace.d.ts.map +1 -1
  41. package/dist/cargo-workspace.js +65 -95
  42. package/dist/cross-check-policy.d.ts +9 -9
  43. package/dist/cross-check-policy.d.ts.map +1 -1
  44. package/dist/cross-check-policy.js +11 -11
  45. package/dist/disk-command-policy.d.ts.map +1 -1
  46. package/dist/disk-command-policy.js +1 -0
  47. package/dist/ensure-built-receipt.d.ts +13 -5
  48. package/dist/ensure-built-receipt.d.ts.map +1 -1
  49. package/dist/ensure-built-receipt.js +126 -47
  50. package/dist/ensure-built-witness.d.ts +27 -8
  51. package/dist/ensure-built-witness.d.ts.map +1 -1
  52. package/dist/ensure-built-witness.js +45 -15
  53. package/dist/ensure-built.d.ts.map +1 -1
  54. package/dist/ensure-built.js +9 -1
  55. package/dist/eslint-config-closure.d.ts +7 -0
  56. package/dist/eslint-config-closure.d.ts.map +1 -0
  57. package/dist/eslint-config-closure.js +346 -0
  58. package/dist/executors/bounded-exec/bounds.d.ts +56 -0
  59. package/dist/executors/bounded-exec/bounds.d.ts.map +1 -0
  60. package/dist/executors/bounded-exec/bounds.js +43 -0
  61. package/dist/executors/bounded-exec/cpu-pool.d.ts +33 -36
  62. package/dist/executors/bounded-exec/cpu-pool.d.ts.map +1 -1
  63. package/dist/executors/bounded-exec/cpu-pool.js +54 -119
  64. package/dist/executors/bounded-exec/executor.d.ts +19 -12
  65. package/dist/executors/bounded-exec/executor.d.ts.map +1 -1
  66. package/dist/executors/bounded-exec/executor.js +371 -239
  67. package/dist/executors/bounded-exec/gateway-lease.d.ts +22 -19
  68. package/dist/executors/bounded-exec/gateway-lease.d.ts.map +1 -1
  69. package/dist/executors/bounded-exec/gateway-lease.js +81 -28
  70. package/dist/executors/bounded-exec/hang-diagnostics.d.ts +18 -1
  71. package/dist/executors/bounded-exec/hang-diagnostics.d.ts.map +1 -1
  72. package/dist/executors/bounded-exec/hang-diagnostics.js +148 -30
  73. package/dist/executors/bounded-exec/lease-wait.d.ts +43 -0
  74. package/dist/executors/bounded-exec/lease-wait.d.ts.map +1 -0
  75. package/dist/executors/bounded-exec/lease-wait.js +68 -0
  76. package/dist/executors/bounded-exec/lock-wait.d.ts +51 -0
  77. package/dist/executors/bounded-exec/lock-wait.d.ts.map +1 -0
  78. package/dist/executors/bounded-exec/lock-wait.js +108 -0
  79. package/dist/executors/bounded-exec/owned-subtree.d.ts +84 -0
  80. package/dist/executors/bounded-exec/owned-subtree.d.ts.map +1 -0
  81. package/dist/executors/bounded-exec/owned-subtree.js +178 -0
  82. package/dist/executors/bounded-exec/progress.d.ts +4 -1
  83. package/dist/executors/bounded-exec/progress.d.ts.map +1 -1
  84. package/dist/executors/bounded-exec/progress.js +5 -2
  85. package/dist/executors/bounded-exec/ram-attach.d.ts +19 -0
  86. package/dist/executors/bounded-exec/ram-attach.d.ts.map +1 -0
  87. package/dist/executors/bounded-exec/ram-attach.js +207 -0
  88. package/dist/executors/bounded-exec/ram-detach.d.ts +25 -0
  89. package/dist/executors/bounded-exec/ram-detach.d.ts.map +1 -0
  90. package/dist/executors/bounded-exec/ram-detach.js +207 -0
  91. package/dist/executors/bounded-exec/ram-temp-fixtures.d.ts +76 -0
  92. package/dist/executors/bounded-exec/ram-temp-fixtures.d.ts.map +1 -1
  93. package/dist/executors/bounded-exec/ram-temp-fixtures.js +296 -0
  94. package/dist/executors/bounded-exec/ram-temp.d.ts +388 -88
  95. package/dist/executors/bounded-exec/ram-temp.d.ts.map +1 -1
  96. package/dist/executors/bounded-exec/ram-temp.js +1213 -399
  97. package/dist/executors/bounded-exec/run-cpu-pool.d.ts +4 -4
  98. package/dist/executors/bounded-exec/run-cpu-pool.d.ts.map +1 -1
  99. package/dist/executors/bounded-exec/run-cpu-pool.js +20 -30
  100. package/dist/executors/bounded-exec/runner-hook.js +14 -5
  101. package/dist/executors/bounded-exec/runner-lifecycle.d.ts +14 -1
  102. package/dist/executors/bounded-exec/runner-lifecycle.d.ts.map +1 -1
  103. package/dist/executors/bounded-exec/runner-lifecycle.js +27 -6
  104. package/dist/executors/bounded-exec/{cpu-tokens.d.ts → runner-sizing.d.ts} +14 -42
  105. package/dist/executors/bounded-exec/runner-sizing.d.ts.map +1 -0
  106. package/dist/executors/bounded-exec/{cpu-tokens.js → runner-sizing.js} +5 -35
  107. package/dist/executors/bounded-exec/runtime-pin.d.ts +73 -0
  108. package/dist/executors/bounded-exec/runtime-pin.d.ts.map +1 -0
  109. package/dist/executors/bounded-exec/runtime-pin.js +167 -0
  110. package/dist/executors/bounded-exec/schema.d.ts +18 -1
  111. package/dist/executors/bounded-exec/schema.d.ts.map +1 -1
  112. package/dist/executors/bounded-exec/verdict.d.ts +40 -11
  113. package/dist/executors/bounded-exec/verdict.d.ts.map +1 -1
  114. package/dist/executors/bounded-exec/verdict.js +88 -19
  115. package/dist/executors/cargo-zigbuild/executor.d.ts +21 -0
  116. package/dist/executors/cargo-zigbuild/executor.d.ts.map +1 -1
  117. package/dist/executors/cargo-zigbuild/executor.js +67 -12
  118. package/dist/executors/clean-outputs/executor.js +1 -0
  119. package/dist/executors/scriptc-native/executor.d.ts +79 -0
  120. package/dist/executors/scriptc-native/executor.d.ts.map +1 -0
  121. package/dist/executors/scriptc-native/executor.js +367 -0
  122. package/dist/executors/scriptc-native/ffi-paths.d.ts +9 -0
  123. package/dist/executors/scriptc-native/ffi-paths.d.ts.map +1 -0
  124. package/dist/executors/scriptc-native/ffi-paths.js +25 -0
  125. package/dist/executors/scriptc-native/schema.d.ts +34 -0
  126. package/dist/executors/scriptc-native/schema.d.ts.map +1 -0
  127. package/dist/executors/scriptc-native/schema.js +1 -0
  128. package/dist/executors/typescript-emit/executor.d.ts +3 -1
  129. package/dist/executors/typescript-emit/executor.d.ts.map +1 -1
  130. package/dist/executors/typescript-emit/executor.js +164 -33
  131. package/dist/forbidden-spelling-policy.d.ts +56 -0
  132. package/dist/forbidden-spelling-policy.d.ts.map +1 -0
  133. package/dist/forbidden-spelling-policy.js +176 -0
  134. package/dist/generators/create-package/generator.d.ts.map +1 -1
  135. package/dist/generators/create-package/generator.js +3 -4
  136. package/dist/graph-input-contract.d.ts +14 -0
  137. package/dist/graph-input-contract.d.ts.map +1 -1
  138. package/dist/graph-input-contract.js +67 -2
  139. package/dist/index.d.ts +23 -6
  140. package/dist/index.d.ts.map +1 -1
  141. package/dist/index.js +672 -214
  142. package/dist/managed-assets.d.ts +2 -0
  143. package/dist/managed-assets.d.ts.map +1 -1
  144. package/dist/managed-files/files.d.ts +3 -3
  145. package/dist/managed-files/files.d.ts.map +1 -1
  146. package/dist/managed-files/files.js +28 -3
  147. package/dist/managed-files/managed-format.d.ts.map +1 -1
  148. package/dist/managed-files/managed-format.js +1 -0
  149. package/dist/nextest-code-bound.js +1 -0
  150. package/dist/nextest-timings.d.ts +35 -0
  151. package/dist/nextest-timings.d.ts.map +1 -0
  152. package/dist/nextest-timings.js +168 -0
  153. package/dist/owned-installation.d.ts +6 -5
  154. package/dist/owned-installation.d.ts.map +1 -1
  155. package/dist/owned-installation.js +150 -26
  156. package/dist/package-target-policy.d.ts.map +1 -1
  157. package/dist/package-target-policy.js +2 -3
  158. package/dist/process-children.d.ts +7 -0
  159. package/dist/process-children.d.ts.map +1 -0
  160. package/dist/process-children.darwin.d.ts +7 -0
  161. package/dist/process-children.darwin.d.ts.map +1 -0
  162. package/dist/process-children.darwin.js +13 -0
  163. package/dist/process-children.js +14 -0
  164. package/dist/process-children.linux.d.ts +8 -0
  165. package/dist/process-children.linux.d.ts.map +1 -0
  166. package/dist/process-children.linux.js +25 -0
  167. package/dist/process-group.d.ts +108 -0
  168. package/dist/process-group.d.ts.map +1 -0
  169. package/dist/process-group.js +171 -0
  170. package/dist/process-listing.d.ts +7 -0
  171. package/dist/process-listing.d.ts.map +1 -0
  172. package/dist/process-listing.js +51 -0
  173. package/dist/producer-receipts.d.ts +8 -2
  174. package/dist/producer-receipts.d.ts.map +1 -1
  175. package/dist/producer-receipts.js +75 -48
  176. package/dist/task-graph-policy.d.ts +21 -0
  177. package/dist/task-graph-policy.d.ts.map +1 -0
  178. package/dist/task-graph-policy.js +91 -0
  179. package/dist/test-timings.js +4 -4
  180. package/dist/test-walk-policy.d.ts +14 -5
  181. package/dist/test-walk-policy.d.ts.map +1 -1
  182. package/dist/test-walk-policy.js +8 -2
  183. package/dist/testing.d.ts +73 -28
  184. package/dist/testing.d.ts.map +1 -1
  185. package/dist/testing.js +217 -223
  186. package/dist/tool-bins.d.ts +33 -0
  187. package/dist/tool-bins.d.ts.map +1 -0
  188. package/dist/tool-bins.js +72 -0
  189. package/dist/typecheck-test-policy.d.ts.map +1 -1
  190. package/dist/typecheck-test-policy.js +3 -4
  191. package/dist/wait-why-policy.d.ts +28 -0
  192. package/dist/wait-why-policy.d.ts.map +1 -0
  193. package/dist/wait-why-policy.js +223 -0
  194. package/dist/workspace-config-policy.d.ts +14 -8
  195. package/dist/workspace-config-policy.d.ts.map +1 -1
  196. package/dist/workspace-config-policy.js +60 -16
  197. package/dist/workspace-manifest.d.ts +41 -6
  198. package/dist/workspace-manifest.d.ts.map +1 -1
  199. package/dist/workspace-manifest.js +57 -0
  200. package/executors.json +16 -1
  201. package/loader.js +2 -0
  202. package/managed/raw/envrc +11 -0
  203. package/managed/raw/patches/nx@23.2.1.patch +2840 -199
  204. package/managed/raw/patches/ttsc@0.34.1.patch +119 -0
  205. package/managed/raw/tooling/direnv/cargo-fetch-bound.ts +245 -0
  206. package/managed/raw/tooling/direnv/cargo-fetch-run.ts +299 -0
  207. package/managed/raw/tooling/direnv/compiler-variables.sh +42 -0
  208. package/managed/raw/tooling/direnv/developer-links.ts +464 -25
  209. package/managed/raw/tooling/direnv/devenv.smoo.nix +78 -38
  210. package/managed/raw/tooling/direnv/github-actions-bootstrap.sh +14 -12
  211. package/managed/raw/tooling/direnv/installed-bun-links.ts +308 -0
  212. package/managed/raw/tooling/direnv/linked-snapshots.ts +62 -3
  213. package/managed/raw/tooling/direnv/nx-socket-dir.sh +56 -17
  214. package/managed/raw/tooling/direnv/repo-path +68 -6
  215. package/managed/raw/tooling/direnv/secret-references.ts +13 -4
  216. package/managed/raw/tooling/direnv/setup-environment.ts +128 -537
  217. package/managed/raw/tooling/direnv/toolchain-stamp.ts +4 -2
  218. package/managed/raw/tooling/direnv/ttsc-env.sh +9 -0
  219. package/managed/raw/tooling/direnv/uv-relocation.ts +227 -0
  220. package/managed/raw/tooling/git-hooks/commit-msg.sh +2 -1
  221. package/managed/raw/tooling/git-hooks/pre-commit.sh +2 -1
  222. package/managed/raw/tooling/git-hooks/pre-push.sh +2 -1
  223. package/managed/templates/github/actions/cache-ttsc-plugins/action.yml +85 -7
  224. package/managed/templates/github/actions/save-nix-devenv/action.yml +12 -2
  225. package/managed/templates/github/actions/setup-devenv/action.yml +2 -0
  226. package/package.json +77 -13
  227. package/src/bin/smoo-nx-cargo-toolchain.ts +11 -0
  228. package/src/bin/smoo-nx-forbidden-spellings.ts +33 -0
  229. package/src/bin/smoo-nx-nextest-timings.ts +31 -0
  230. package/src/bounded-test-policy.ts +12 -14
  231. package/src/build-state-output-policy.ts +458 -34
  232. package/src/bun-lock-scope.ts +108 -0
  233. package/src/cargo-build-script-env.ts +265 -0
  234. package/src/cargo-closure-input.ts +74 -7
  235. package/src/cargo-retention-hook.ts +94 -0
  236. package/src/cargo-source-hash.ts +138 -41
  237. package/src/cargo-toolchain-paths.ts +95 -0
  238. package/src/cargo-toolchain-policy.ts +49 -5
  239. package/src/cargo-workspace.ts +72 -123
  240. package/src/cross-check-policy.ts +12 -10
  241. package/src/disk-command-policy.ts +1 -0
  242. package/src/ensure-built-receipt.ts +132 -39
  243. package/src/ensure-built-witness.ts +62 -10
  244. package/src/ensure-built.ts +11 -1
  245. package/src/eslint-config-closure.ts +357 -0
  246. package/src/executors/bounded-exec/bounds.ts +76 -0
  247. package/src/executors/bounded-exec/cpu-pool.ts +51 -117
  248. package/src/executors/bounded-exec/executor.ts +423 -259
  249. package/src/executors/bounded-exec/gateway-lease.ts +82 -33
  250. package/src/executors/bounded-exec/hang-diagnostics.ts +173 -31
  251. package/src/executors/bounded-exec/lease-wait.ts +89 -0
  252. package/src/executors/bounded-exec/lock-wait.ts +141 -0
  253. package/src/executors/bounded-exec/owned-subtree.ts +235 -0
  254. package/src/executors/bounded-exec/progress.ts +9 -3
  255. package/src/executors/bounded-exec/ram-attach.ts +238 -0
  256. package/src/executors/bounded-exec/ram-detach.ts +226 -0
  257. package/src/executors/bounded-exec/ram-temp-fixtures.ts +358 -0
  258. package/src/executors/bounded-exec/ram-temp-registry.txt +440 -0
  259. package/src/executors/bounded-exec/ram-temp.ts +1497 -460
  260. package/src/executors/bounded-exec/run-cpu-pool.ts +22 -30
  261. package/src/executors/bounded-exec/runner-hook.ts +14 -6
  262. package/src/executors/bounded-exec/runner-lifecycle.ts +31 -8
  263. package/src/executors/bounded-exec/{cpu-tokens.ts → runner-sizing.ts} +13 -59
  264. package/src/executors/bounded-exec/runtime-pin.ts +232 -0
  265. package/src/executors/bounded-exec/schema.json +11 -2
  266. package/src/executors/bounded-exec/schema.ts +19 -1
  267. package/src/executors/bounded-exec/verdict.ts +137 -34
  268. package/src/executors/cargo-zigbuild/executor.ts +82 -8
  269. package/src/executors/clean-outputs/executor.ts +1 -0
  270. package/src/executors/scriptc-native/executor.ts +394 -0
  271. package/src/executors/scriptc-native/ffi-paths.ts +29 -0
  272. package/src/executors/scriptc-native/schema.json +60 -0
  273. package/src/executors/scriptc-native/schema.ts +34 -0
  274. package/src/executors/typescript-emit/executor.ts +205 -38
  275. package/src/forbidden-spelling-policy.ts +226 -0
  276. package/src/generators/create-package/generator.ts +7 -7
  277. package/src/graph-input-contract.ts +61 -2
  278. package/src/index.ts +788 -224
  279. package/src/managed-assets.ts +3 -0
  280. package/src/managed-files/files.ts +28 -3
  281. package/src/managed-files/managed-format.ts +1 -0
  282. package/src/nextest-code-bound.ts +1 -0
  283. package/src/nextest-timings.ts +106 -0
  284. package/src/owned-installation.ts +150 -23
  285. package/src/package-target-policy.ts +2 -3
  286. package/src/process-children.darwin.ts +14 -0
  287. package/src/process-children.linux.ts +33 -0
  288. package/src/process-children.ts +22 -0
  289. package/src/process-group.ts +209 -0
  290. package/src/process-listing.ts +54 -0
  291. package/src/producer-receipts.ts +68 -45
  292. package/src/task-graph-policy.ts +98 -0
  293. package/src/test-walk-policy.ts +23 -8
  294. package/src/testing.ts +240 -232
  295. package/src/tool-bins.ts +108 -0
  296. package/src/typecheck-test-policy.ts +2 -3
  297. package/src/wait-why-policy.ts +226 -0
  298. package/src/workspace-config-policy.ts +63 -15
  299. package/src/workspace-manifest.ts +89 -6
  300. package/test-timings.json +122 -98
  301. package/dist/bin/smoo-nx-failures.d.ts +0 -3
  302. package/dist/bin/smoo-nx-failures.d.ts.map +0 -1
  303. package/dist/bin/smoo-nx-failures.js +0 -3
  304. package/dist/bin/smoo-nx-nextest-extract.d.ts +0 -3
  305. package/dist/bin/smoo-nx-nextest-extract.d.ts.map +0 -1
  306. package/dist/bin/smoo-nx-nextest-extract.js +0 -42
  307. package/dist/executors/bounded-exec/cpu-tokens.d.ts.map +0 -1
  308. package/dist/failure-summary.d.ts +0 -5
  309. package/dist/failure-summary.d.ts.map +0 -1
  310. package/dist/failure-summary.js +0 -118
  311. package/dist/nextest-extraction.d.ts +0 -117
  312. package/dist/nextest-extraction.d.ts.map +0 -1
  313. package/dist/nextest-extraction.js +0 -303
  314. package/managed/raw/patches/ttsc@0.30.4.patch +0 -2255
  315. package/src/__tests__/cargo-closure-filesets.ts +0 -94
  316. package/src/__tests__/cargo-closure-fixture.ts +0 -113
  317. package/src/__tests__/counted-cargo-process.ts +0 -286
  318. package/src/__tests__/counted-cargo.ts +0 -713
  319. package/src/__tests__/directory-change.ts +0 -27
  320. package/src/__tests__/fixture-cargo-home.ts +0 -36
  321. package/src/__tests__/fixture-nx-env.ts +0 -193
  322. package/src/__tests__/owned-installation.ts +0 -13
  323. package/src/__tests__/past-tick.ts +0 -12
  324. package/src/__tests__/progress-clock.ts +0 -43
  325. package/src/__tests__/runtime-input.ts +0 -23
  326. package/src/bin/smoo-nx-bound-failures.test.ts +0 -127
  327. package/src/bin/smoo-nx-failures.ts +0 -4
  328. package/src/bin/smoo-nx-nextest-extract.ts +0 -44
  329. package/src/bounded-test-policy.test.ts +0 -1029
  330. package/src/build-state-output-policy.test.ts +0 -115
  331. package/src/bun-bootstrap.test.ts +0 -102
  332. package/src/bun-file-packages.test.ts +0 -47
  333. package/src/cargo-closure-filesets.test.ts +0 -63
  334. package/src/cargo-closure-input.property.test.ts +0 -50
  335. package/src/cargo-closure-input.test.ts +0 -506
  336. package/src/cargo-closure-key.test.ts +0 -240
  337. package/src/cargo-resolve-cache.test.ts +0 -1181
  338. package/src/cargo-source-hash.test.ts +0 -707
  339. package/src/cargo-workspace.test.ts +0 -615
  340. package/src/cross-check-policy.test.ts +0 -316
  341. package/src/disk-command-policy.test.ts +0 -61
  342. package/src/ensure-built-receipt.test.ts +0 -279
  343. package/src/ensure-built-witness.test.ts +0 -688
  344. package/src/ensure-built.test.ts +0 -1462
  345. package/src/executors/all-verdicts/executor.test.ts +0 -135
  346. package/src/executors/bounded-exec/cargo-progress-host.test.ts +0 -332
  347. package/src/executors/bounded-exec/cpu-pool.test.ts +0 -684
  348. package/src/executors/bounded-exec/cpu-tokens.test.ts +0 -519
  349. package/src/executors/bounded-exec/disk-lease.test.ts +0 -219
  350. package/src/executors/bounded-exec/executor-host.test.ts +0 -800
  351. package/src/executors/bounded-exec/executor.test.ts +0 -1819
  352. package/src/executors/bounded-exec/go-progress-host.test.ts +0 -171
  353. package/src/executors/bounded-exec/hang-diagnostics.test.ts +0 -291
  354. package/src/executors/bounded-exec/progress.test.ts +0 -139
  355. package/src/executors/bounded-exec/ram-temp-held.test.ts +0 -264
  356. package/src/executors/bounded-exec/ram-temp-host.test.ts +0 -635
  357. package/src/executors/bounded-exec/ram-temp.test.ts +0 -750
  358. package/src/executors/bounded-exec/run-cpu-pool.test.ts +0 -79
  359. package/src/executors/bounded-exec/runner-hook.test.ts +0 -193
  360. package/src/executors/bounded-exec/runner-lifecycle.test.ts +0 -82
  361. package/src/executors/bounded-exec/verdict.test.ts +0 -545
  362. package/src/executors/cargo-zigbuild/executor.test.ts +0 -129
  363. package/src/executors/clean-outputs/executor.test.ts +0 -20
  364. package/src/executors/typescript-emit/executor.test.ts +0 -83
  365. package/src/failure-summary.ts +0 -119
  366. package/src/generators/bounded-test-targets/generator.test.ts +0 -138
  367. package/src/generators/bun-test-tracing/generator.test.ts +0 -250
  368. package/src/generators/create-package/generator.test.ts +0 -190
  369. package/src/generators/make-public/generator.test.ts +0 -137
  370. package/src/graph-input-contract.test.ts +0 -379
  371. package/src/host-controller-wiring.test.ts +0 -31
  372. package/src/index.test.ts +0 -3321
  373. package/src/linked-snapshots.nx.test.ts +0 -254
  374. package/src/managed-files/forgejo-artifact.test.ts +0 -395
  375. package/src/managed-files/generator.test.ts +0 -243
  376. package/src/managed-files/github-host-cache-isolation.test.ts +0 -86
  377. package/src/managed-files/json-edit.test.ts +0 -216
  378. package/src/managed-files/managed-content.test.ts +0 -166
  379. package/src/managed-files/managed-format-json.test.ts +0 -308
  380. package/src/managed-files/repo-path.test.ts +0 -172
  381. package/src/managed-files/setup-devenv-free-disk.test.ts +0 -95
  382. package/src/managed-files/trace-db-artifact.test.ts +0 -7
  383. package/src/managed-files/tree-permissions.test.ts +0 -109
  384. package/src/managed-files/tree.test.ts +0 -123
  385. package/src/manifest-hash.test.ts +0 -219
  386. package/src/nextest-code-bound.test.ts +0 -161
  387. package/src/nextest-extraction.test.ts +0 -216
  388. package/src/nextest-extraction.ts +0 -371
  389. package/src/nextest-partitions.test.ts +0 -501
  390. package/src/nx-cache-bound.test.ts +0 -109
  391. package/src/nx-cache-restore-mtime.test.ts +0 -170
  392. package/src/nx-daemon-claim.test.ts +0 -279
  393. package/src/nx-daemon-idle-cpu.test.ts +0 -80
  394. package/src/nx-daemon-idle-policy.test.ts +0 -111
  395. package/src/nx-daemon-ignore-files.test.ts +0 -210
  396. package/src/nx-daemon-root-normalization.test.ts +0 -105
  397. package/src/nx-daemon-start-never.test.ts +0 -292
  398. package/src/nx-daemon-validity.test.ts +0 -1055
  399. package/src/nx-dot-input-policy.test.ts +0 -353
  400. package/src/nx-failure-life-cycles.test.ts +0 -207
  401. package/src/nx-files-archive-racy.test.ts +0 -97
  402. package/src/nx-foreign-workspace-env.test.ts +0 -329
  403. package/src/nx-incomplete-run-summary.test.ts +0 -70
  404. package/src/nx-plugin-load-errors.test.ts +0 -120
  405. package/src/nx-project-graph-errors.test.ts +0 -70
  406. package/src/nx-project-resolution-cache.test.ts +0 -176
  407. package/src/nx-raw-inputs.test.ts +0 -166
  408. package/src/nx-resident-graph-workers.test.ts +0 -112
  409. package/src/nx-run-information.test.ts +0 -118
  410. package/src/nx-skipped-task-exit.test.ts +0 -180
  411. package/src/nx-state-location.test.ts +0 -63
  412. package/src/nx-store-resolution.test.ts +0 -81
  413. package/src/nx-task-graph-cycles.test.ts +0 -148
  414. package/src/nx-task-output-lease.test.ts +0 -550
  415. package/src/nx-use-local.test.ts +0 -105
  416. package/src/owned-installation.test.ts +0 -105
  417. package/src/package-target-policy.test.ts +0 -1014
  418. package/src/producer-receipts.test.ts +0 -285
  419. package/src/release-config-policy.test.ts +0 -311
  420. package/src/runtime-input.test.ts +0 -393
  421. package/src/serial-group-wiring.test.ts +0 -326
  422. package/src/task-history-namespace.test.ts +0 -181
  423. package/src/task-results.test.ts +0 -228
  424. package/src/test-clock-policy.test.ts +0 -338
  425. package/src/test-program.test.ts +0 -303
  426. package/src/test-timings.test.ts +0 -240
  427. package/src/test-walk-policy.test.ts +0 -620
  428. package/src/testing.test.ts +0 -509
  429. package/src/typecheck-test-policy.test.ts +0 -1468
  430. package/src/typescript-resolution.test.ts +0 -76
  431. package/src/version-actions.test.ts +0 -80
  432. package/src/workspace-config-policy.test.ts +0 -737
@@ -0,0 +1,346 @@
1
+ import * as _assertGuard_1 from "typia/lib/internal/_assertGuard";
2
+ /**
3
+ * The workspace files an ESLint flat config loads when ESLint loads it, found
4
+ * without running it: the files a lint verdict depends on beyond its sources.
5
+ *
6
+ * ESLint 10 under Node loads a TypeScript config through jiti and any other
7
+ * config with a native `import()` (eslint/lib/config/config-loader.js). Every
8
+ * module a config reaches loads the same way, so each module is read and each
9
+ * specifier resolved by that loader's own machinery, never a model of it:
10
+ *
11
+ * - jiti: its transform decides which imports survive type erasure, and its
12
+ * resolver (`esmResolve`, under the call's `require` or `import`
13
+ * conditions) picks the file.
14
+ * - Node: `import type` and `export type` are erased and every other import,
15
+ * `import()` and `require()` loads. One `node` process per walk layer, the
16
+ * `node` that runs ESLint, resolves each `require` with
17
+ * `createRequire(module).resolve` and each `import` with
18
+ * `import.meta.resolve(specifier, module)`.
19
+ *
20
+ * A builtin, or a package installed outside the workspace's own files, adds
21
+ * nothing: `bun.lock` and the root manifest key what is installed. A package
22
+ * that resolves into the workspace's own files (a workspace member linked into
23
+ * `node_modules`) is keyed and walked like a relative module. Every loaded
24
+ * file keys the package.json files that decide how it loads: the nearest one
25
+ * (its module format), a member's own (its entry), and that of a directory a
26
+ * relative specifier enters (its `main`). A load whose target the source does not spell
27
+ * (`require(name)`, `import(path)`, `createRequire`), a specifier that is
28
+ * neither relative nor a package name, a specifier the loader cannot resolve,
29
+ * and a workspace file Nx does not index all refuse: lint cannot cache a
30
+ * verdict whose key misses a file it read.
31
+ */
32
+ import { execFileSync } from 'node:child_process';
33
+ import { readFileSync, realpathSync, statSync } from 'node:fs';
34
+ import { createRequire, isBuiltin } from 'node:module';
35
+ import { dirname, isAbsolute, join, relative, resolve, sep } from 'node:path';
36
+ import { fileURLToPath, pathToFileURL } from 'node:url';
37
+ import ts from 'typescript';
38
+ import typia from 'typia';
39
+ /** The options ESLint creates its jiti with; `fsCache: false` only keeps graph construction from writing a cache. */
40
+ const JITI_OPTIONS = { moduleCache: false, fsCache: false };
41
+ const TYPESCRIPT_CONFIG = /\.[mc]?ts$/u;
42
+ /** The files a module that loads nothing is: data and native addons. */
43
+ const LEAF_MODULE = /\.(?:json|node)$/u;
44
+ const RELATIVE_SPECIFIER = /^\.\.?(?:\/|$)/u;
45
+ /** Node's own resolution of each `{kind, specifier, from}` on stdin: a path or file URL, `null` where Node throws. */
46
+ const NODE_RESOLVER = `import { createRequire } from 'node:module';
47
+ import { readFileSync } from 'node:fs';
48
+ const loads = JSON.parse(readFileSync(0, 'utf8'));
49
+ console.log(JSON.stringify(loads.map(({ kind, specifier, from }) => {
50
+ try {
51
+ return kind === 'require' ? createRequire(from).resolve(specifier) : import.meta.resolve(specifier, from);
52
+ } catch {
53
+ return null;
54
+ }
55
+ })));`;
56
+ /**
57
+ * The workspace-relative files `configs` load, transitively, the configs
58
+ * excluded, sorted. `indexed` is Nx's workspace file index (at least its
59
+ * JavaScript, TypeScript, JSON and package.json files); a file outside it refuses.
60
+ */
61
+ export function eslintConfigClosure(workspaceRoot, configs, indexed) {
62
+ const root = realpathSync(workspaceRoot);
63
+ const keyed = new Set();
64
+ const jiti = configs.some((config) => TYPESCRIPT_CONFIG.test(config)) ? workspaceJiti(workspaceRoot) : null;
65
+ for (const config of configs) {
66
+ const loader = TYPESCRIPT_CONFIG.test(config) ? jiti : null;
67
+ for (let layer = [config]; layer.length > 0;) {
68
+ const pending = layer.flatMap((module) => moduleLoads(root, config, module, loader));
69
+ const targets = loader === null
70
+ ? nodeResolve(pending)
71
+ : pending.map(({ jiti: instance, kind, specifier, from }) => jitiResolve(instance, kind, specifier, from));
72
+ layer = [];
73
+ pending.forEach((load, index) => {
74
+ const target = targets[index] ?? null;
75
+ if (target === null) {
76
+ throw new Error(`${load.importer} imports '${load.specifier}', which names no file ${loader === null ? 'Node' : 'jiti'} resolves, so no lint input can key it`);
77
+ }
78
+ const real = realpathSync(target);
79
+ const workspacePath = relative(root, real).split(sep).join('/');
80
+ const installed = workspacePath.split('/').includes('node_modules');
81
+ if (workspacePath.startsWith('../') || isAbsolute(workspacePath) || installed) {
82
+ if (load.bare || installed)
83
+ return;
84
+ throw new Error(`${load.importer} imports '${load.specifier}', which resolves outside the workspace to ${real}`);
85
+ }
86
+ for (const file of [workspacePath, ...packageMetadata(root, load, real)]) {
87
+ if (!indexed.has(file)) {
88
+ throw new Error(`${load.importer} imports '${load.specifier}', which reads ${file}, a file Nx's workspace file index does not hold, so no lint input can key it`);
89
+ }
90
+ if (keyed.has(file) || configs.includes(file))
91
+ continue;
92
+ keyed.add(file);
93
+ if (file === workspacePath && !LEAF_MODULE.test(file))
94
+ layer.push(file);
95
+ }
96
+ });
97
+ }
98
+ }
99
+ return [...keyed].sort();
100
+ }
101
+ /** The loads `module` performs that resolve to a file; refuses a computed load or an unresolvable specifier kind. */
102
+ function moduleLoads(root, config, module, jiti) {
103
+ const from = join(root, module);
104
+ const source = readFileSync(from, 'utf8');
105
+ const instance = jiti === null ? null : jiti.createJiti(from, JITI_OPTIONS);
106
+ const sites = instance === null ? loadSites(source, from) : loadSites(jitiTransform(instance, source, from), `${from}.cjs`);
107
+ const importer = module === config ? config : `${config} loads ${module}, which`;
108
+ return sites.flatMap((site) => {
109
+ if (site.kind === 'computed') {
110
+ throw new Error(`${importer} loads a module it computes at runtime (${site.text}), so no lint input can key what it loads`);
111
+ }
112
+ if (isBuiltin(site.specifier))
113
+ return [];
114
+ const bare = /^[@\w]/u.test(site.specifier) && !site.specifier.includes(':');
115
+ if (!bare && !RELATIVE_SPECIFIER.test(site.specifier)) {
116
+ throw new Error(`${importer} imports '${site.specifier}', which is neither relative nor a package name, so no lint input can key it`);
117
+ }
118
+ return [{ importer, from, kind: site.kind, specifier: site.specifier, bare, jiti: instance }];
119
+ });
120
+ }
121
+ /**
122
+ * `source` as jiti compiles it, leaving the process's stack-trace globals as
123
+ * they were.
124
+ *
125
+ * jiti compiles with Babel, whose first transform replaces
126
+ * `Error.prepareStackTrace` with a frame-hiding wrapper around the one it found
127
+ * and raises `Error.stackTraceLimit` to 50, for the life of the process. This
128
+ * walk runs inside whichever process builds the Nx graph (the Nx CLI, its
129
+ * daemon, smoo), so the wrapper would outlive it there. Under Bun the wrapped
130
+ * default is Bun's native `Error.prepareStackTrace`, which throws "First
131
+ * argument must be an Error object" for the non-Error targets
132
+ * `Error.captureStackTrace` accepts (oven-sh/bun#46393): every later stack
133
+ * capture onto such an object then fails in that process, as follow-redirects'
134
+ * error types do when axios loads. The walk only reads the transform's output.
135
+ */
136
+ function jitiTransform(instance, source, filename) {
137
+ const { prepareStackTrace, stackTraceLimit } = Error;
138
+ try {
139
+ return instance.transform({ source, filename, ts: /\.[mc]?tsx?$/u.test(filename) });
140
+ }
141
+ finally {
142
+ Error.prepareStackTrace = prepareStackTrace;
143
+ Error.stackTraceLimit = stackTraceLimit;
144
+ }
145
+ }
146
+ /**
147
+ * The jiti ESLint loads a TypeScript config with: the one ESLint's own
148
+ * `import('jiti')` reaches from the workspace's ESLint, which a linker that
149
+ * isolates packages need not hoist to the workspace root.
150
+ */
151
+ function workspaceJiti(workspaceRoot) {
152
+ try {
153
+ const eslint = createRequire(join(workspaceRoot, 'package.json')).resolve('eslint');
154
+ const jiti = createRequire(eslint)('jiti');
155
+ return jiti;
156
+ }
157
+ catch (error) {
158
+ throw new Error(`ESLint loads a TypeScript config through jiti, which the ESLint ${workspaceRoot} resolves cannot import: ${error instanceof Error ? error.message : String(error)}`);
159
+ }
160
+ }
161
+ /**
162
+ * Every load in `code`: a static import or re-export that survives type
163
+ * erasure, and every `import()`, `require()` or jiti `jitiImport()` call. A
164
+ * call whose specifier is not a literal, a loader function used as a value,
165
+ * and `createRequire` are computed loads.
166
+ */
167
+ function loadSites(code, fileName) {
168
+ const file = ts.createSourceFile(fileName, code, ts.ScriptTarget.Latest, true);
169
+ const sites = [];
170
+ const visit = (node) => {
171
+ if (ts.isImportDeclaration(node) && !node.importClause?.isTypeOnly && ts.isStringLiteral(node.moduleSpecifier)) {
172
+ sites.push({ kind: 'import', specifier: node.moduleSpecifier.text });
173
+ }
174
+ else if (ts.isExportDeclaration(node) &&
175
+ !node.isTypeOnly &&
176
+ node.moduleSpecifier !== undefined &&
177
+ ts.isStringLiteral(node.moduleSpecifier)) {
178
+ sites.push({ kind: 'import', specifier: node.moduleSpecifier.text });
179
+ }
180
+ else if (ts.isCallExpression(node)) {
181
+ const callee = node.expression;
182
+ const kind = callee.kind === ts.SyntaxKind.ImportKeyword || (ts.isIdentifier(callee) && callee.text === 'jitiImport')
183
+ ? 'import'
184
+ : ts.isIdentifier(callee) && callee.text === 'require'
185
+ ? 'require'
186
+ : null;
187
+ if (kind !== null) {
188
+ const [argument] = node.arguments;
189
+ sites.push(argument !== undefined && ts.isStringLiteralLike(argument)
190
+ ? { kind, specifier: argument.text }
191
+ : { kind: 'computed', text: node.getText(file) });
192
+ node.arguments.forEach(visit);
193
+ return;
194
+ }
195
+ }
196
+ else if (ts.isIdentifier(node) && loaderValue(node)) {
197
+ sites.push({ kind: 'computed', text: node.parent.getText(file) });
198
+ }
199
+ else if (ts.isElementAccessExpression(node) && loaderElement(node)) {
200
+ sites.push({ kind: 'computed', text: node.getText(file) });
201
+ }
202
+ ts.forEachChild(node, visit);
203
+ };
204
+ visit(file);
205
+ return sites;
206
+ }
207
+ /**
208
+ * A loader the walk cannot read a specifier from: `createRequire` anywhere, a
209
+ * `.require` member (`module.require`), and `require` or `jitiImport`
210
+ * anywhere but a direct call, `typeof`, or `require.resolve`, which loads
211
+ * nothing (`require.call`, `require.apply`, aliases, arguments).
212
+ */
213
+ function loaderValue(node) {
214
+ const parent = node.parent;
215
+ if (node.text === 'createRequire')
216
+ return true;
217
+ if (ts.isPropertyAccessExpression(parent) && parent.name === node)
218
+ return node.text === 'require';
219
+ if (node.text !== 'require' && node.text !== 'jitiImport')
220
+ return false;
221
+ if (ts.isPropertyAssignment(parent) && parent.name === node)
222
+ return false;
223
+ return !((ts.isTypeOfExpression(parent) && parent.expression === node) ||
224
+ (node.text === 'require' &&
225
+ ts.isPropertyAccessExpression(parent) &&
226
+ parent.expression === node &&
227
+ parent.name.text === 'resolve'));
228
+ }
229
+ /** Loader functions a module can reach by name. */
230
+ const LOADER_NAMES = new Set(['require', 'createRequire', 'jitiImport']);
231
+ /** Values a loader function hangs off, whose computed members can be one. */
232
+ const LOADER_HOLDERS = new Set(['module', 'require', 'jitiImport', 'globalThis', 'global']);
233
+ /**
234
+ * A loader reached through brackets: a literal loader name (`module['require']`),
235
+ * or any computed member of a value that holds one (`module[key]`).
236
+ */
237
+ function loaderElement(node) {
238
+ const key = node.argumentExpression;
239
+ if (ts.isStringLiteralLike(key))
240
+ return LOADER_NAMES.has(key.text);
241
+ return ts.isIdentifier(node.expression) && LOADER_HOLDERS.has(node.expression.text);
242
+ }
243
+ /** The file jiti loads for `specifier` from `from`: its runtime resolver, under the call's conditions. */
244
+ function jitiResolve(jiti, kind, specifier, from) {
245
+ if (jiti === null)
246
+ throw new Error(`${from}: a jiti-loaded module has no jiti instance`);
247
+ const url = jiti.esmResolve(specifier, {
248
+ parentURL: pathToFileURL(from).href,
249
+ conditions: ['node', kind],
250
+ try: true,
251
+ });
252
+ return url === undefined ? null : fileURLToPath(url);
253
+ }
254
+ /** Node's own resolution of every load in one layer, from the `node` that runs ESLint; `null` where Node throws. */
255
+ function nodeResolve(loads) {
256
+ if (loads.length === 0)
257
+ return [];
258
+ // eslint-disable-next-line deadline/no-unbounded-wait -- WHY unbounded: node resolves the specifiers on its stdin from the filesystem and exits; it waits on no other process
259
+ const output = execFileSync('node', ['--experimental-import-meta-resolve', '--no-warnings', '--input-type=module', '--eval', NODE_RESOLVER], {
260
+ input: JSON.stringify(loads.map(({ kind, specifier, from }) => ({
261
+ kind,
262
+ specifier,
263
+ from: kind === 'require' ? from : pathToFileURL(from).href,
264
+ }))),
265
+ encoding: 'utf8',
266
+ });
267
+ const resolved = (() => {
268
+ let _errorFactory;
269
+ const __is = input => Array.isArray(input) && input.every(elem => null === elem || "string" === typeof elem);
270
+ const __assert = (input, errorFactory) => {
271
+ if (false === __is(input)) {
272
+ _errorFactory = errorFactory;
273
+ ((input, _path, _exceptionable = true) => (Array.isArray(input) || _assertGuard_1._assertGuard(true, {
274
+ method: "typia.json.assertParse",
275
+ path: _path + "",
276
+ expected: "Array<null | string>",
277
+ value: input
278
+ }, _errorFactory)) && input.every((elem, _index2) => null === elem || "string" === typeof elem || _assertGuard_1._assertGuard(true, {
279
+ method: "typia.json.assertParse",
280
+ path: _path + "[" + _index2 + "]",
281
+ expected: "(null | string)",
282
+ value: elem
283
+ }, _errorFactory)) || _assertGuard_1._assertGuard(true, {
284
+ method: "typia.json.assertParse",
285
+ path: _path + "",
286
+ expected: "Array<null | string>",
287
+ value: input
288
+ }, _errorFactory))(input, "$input", true);
289
+ }
290
+ return input;
291
+ };
292
+ return (input, errorFactory) => __assert(JSON.parse(input), errorFactory);
293
+ })()(output);
294
+ if (resolved.length !== loads.length) {
295
+ throw new Error(`node resolved ${resolved.length} of ${loads.length} ESLint config loads`);
296
+ }
297
+ return resolved.map((target) => {
298
+ if (target === null)
299
+ return null;
300
+ const path = target.startsWith('file:') ? fileURLToPath(target) : target;
301
+ return statSync(path, { throwIfNoEntry: false })?.isFile() === true ? path : null;
302
+ });
303
+ }
304
+ /**
305
+ * The workspace package.json files that decide how `real` loads: the nearest
306
+ * one above it, whose `type` sets its module format; the one in the directory
307
+ * a relative specifier entered, whose `main` chose it; and a bare specifier's
308
+ * package root, whose `main` or `exports` chose it. The root manifest is a
309
+ * check input already.
310
+ */
311
+ function packageMetadata(root, load, real) {
312
+ const manifests = new Set();
313
+ const nearest = manifestAbove(root, dirname(real), () => true);
314
+ if (nearest !== null)
315
+ manifests.add(nearest);
316
+ const base = resolve(dirname(load.from), load.specifier);
317
+ if (load.bare) {
318
+ const [scope, name] = load.specifier.split('/');
319
+ const packageName = load.specifier.startsWith('@') ? `${scope}/${name}` : scope;
320
+ const owner = manifestAbove(root, dirname(real), (manifest) => (() => {
321
+ const _io0 = input => undefined === input.name || "string" === typeof input.name;
322
+ const __is = input => "object" === typeof input && null !== input && false === Array.isArray(input) && _io0(input);
323
+ return input => { input = JSON.parse(input); return __is(input) ? input : null; };
324
+ })()(readFileSync(manifest, 'utf8'))?.name === packageName);
325
+ if (owner !== null)
326
+ manifests.add(owner);
327
+ }
328
+ else if (statSync(base, { throwIfNoEntry: false })?.isDirectory() === true) {
329
+ const entered = join(realpathSync(base), 'package.json');
330
+ if (dirname(entered) !== root && isFile(entered))
331
+ manifests.add(entered);
332
+ }
333
+ return [...manifests].map((manifest) => relative(root, manifest).split(sep).join('/'));
334
+ }
335
+ /** The first package.json `accept` takes at or above `start`, below the workspace root. */
336
+ function manifestAbove(root, start, accept) {
337
+ for (let directory = start; directory.startsWith(root + sep); directory = dirname(directory)) {
338
+ const manifest = join(directory, 'package.json');
339
+ if (isFile(manifest) && accept(manifest))
340
+ return manifest;
341
+ }
342
+ return null;
343
+ }
344
+ function isFile(path) {
345
+ return statSync(path, { throwIfNoEntry: false })?.isFile() === true;
346
+ }
@@ -0,0 +1,56 @@
1
+ /**
2
+ * Which of a run's bounds is armed, and when each expires: the decision bounded-exec's timers carry out, kept here as
3
+ * a pure function of the run's events and the times they happened at, so a table can test it with no clock and no
4
+ * process (verdict.ts says why the bounds are separate).
5
+ *
6
+ * - The total ceiling runs from the spawn.
7
+ * - The fixture ceiling runs from the spawn while a supervised fixture runs, and ends with the fixture's segment.
8
+ * - The progress bound runs only while the runner is testing (runner-lifecycle.ts): from the spawn when the runner is
9
+ * testing then (startup is bounded until a build declares itself), restarted by a finished test or by the clock
10
+ * starting again after a build, and stopped while nothing tests.
11
+ */
12
+ /** The limits a run was given, in milliseconds; an absent one never expires. */
13
+ export interface BoundLimits {
14
+ readonly idleMs?: number;
15
+ readonly fixtureMs?: number;
16
+ readonly totalMs?: number;
17
+ }
18
+ /** When each armed bound expires, in the clock's milliseconds; `null` when it is not armed. */
19
+ export interface Bounds {
20
+ readonly idle: number | null;
21
+ readonly fixture: number | null;
22
+ readonly total: number | null;
23
+ }
24
+ export type BoundKind = keyof Bounds;
25
+ export type BoundEvent =
26
+ /** The command started; `testing` is the lifecycle's answer then, `fixture` whether a supervised fixture leads it. */
27
+ {
28
+ readonly kind: 'spawn';
29
+ readonly at: number;
30
+ readonly testing: boolean;
31
+ readonly fixture: boolean;
32
+ }
33
+ /**
34
+ * The runner's state may have moved: a test finished (`finished`), a phase changed, or the lifecycle failed.
35
+ * `wasTesting` is the answer before the event, `testing` the answer after it.
36
+ */
37
+ | {
38
+ readonly kind: 'progress';
39
+ readonly at: number;
40
+ readonly testing: boolean;
41
+ readonly wasTesting: boolean;
42
+ readonly finished: boolean;
43
+ }
44
+ /** The fixture's segment ended: its ceiling no longer applies. */
45
+ | {
46
+ readonly kind: 'fixture-done';
47
+ };
48
+ export declare const UNARMED: Bounds;
49
+ /** The bounds after `event`. */
50
+ export declare function stepBounds(bounds: Bounds, limits: BoundLimits, event: BoundEvent): Bounds;
51
+ /** The bound that expires first, or `null` when none is armed. A tie names the total, then the fixture, then idle. */
52
+ export declare function earliestBound(bounds: Bounds): {
53
+ readonly kind: BoundKind;
54
+ readonly at: number;
55
+ } | null;
56
+ //# sourceMappingURL=bounds.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"bounds.d.ts","sourceRoot":"","sources":["../../../src/executors/bounded-exec/bounds.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,gFAAgF;AAChF,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,+FAA+F;AAC/F,MAAM,WAAW,MAAM;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AAED,MAAM,MAAM,SAAS,GAAG,MAAM,MAAM,CAAC;AAErC,MAAM,MAAM,UAAU;AACpB,sHAAsH;AACpH;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;CAAE;AACvG;;;GAGG;GACD;IACE,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;CAC5B;AACH,kEAAkE;GAChE;IAAE,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAA;CAAE,CAAC;AAEtC,eAAO,MAAM,OAAO,EAAE,MAAmD,CAAC;AAE1E,gCAAgC;AAChC,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE,UAAU,GAAG,MAAM,CAiBzF;AAED,sHAAsH;AACtH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAOtG"}
@@ -0,0 +1,43 @@
1
+ /**
2
+ * Which of a run's bounds is armed, and when each expires: the decision bounded-exec's timers carry out, kept here as
3
+ * a pure function of the run's events and the times they happened at, so a table can test it with no clock and no
4
+ * process (verdict.ts says why the bounds are separate).
5
+ *
6
+ * - The total ceiling runs from the spawn.
7
+ * - The fixture ceiling runs from the spawn while a supervised fixture runs, and ends with the fixture's segment.
8
+ * - The progress bound runs only while the runner is testing (runner-lifecycle.ts): from the spawn when the runner is
9
+ * testing then (startup is bounded until a build declares itself), restarted by a finished test or by the clock
10
+ * starting again after a build, and stopped while nothing tests.
11
+ */
12
+ export const UNARMED = { idle: null, fixture: null, total: null };
13
+ /** The bounds after `event`. */
14
+ export function stepBounds(bounds, limits, event) {
15
+ switch (event.kind) {
16
+ case 'spawn':
17
+ return {
18
+ idle: event.testing && limits.idleMs !== undefined ? event.at + limits.idleMs : null,
19
+ fixture: event.fixture && limits.fixtureMs !== undefined ? event.at + limits.fixtureMs : null,
20
+ total: limits.totalMs !== undefined ? event.at + limits.totalMs : null,
21
+ };
22
+ case 'progress': {
23
+ if (!event.testing)
24
+ return { ...bounds, idle: null };
25
+ const restart = event.finished || !event.wasTesting;
26
+ if (!restart || limits.idleMs === undefined)
27
+ return bounds;
28
+ return { ...bounds, idle: event.at + limits.idleMs };
29
+ }
30
+ case 'fixture-done':
31
+ return { ...bounds, fixture: null };
32
+ }
33
+ }
34
+ /** The bound that expires first, or `null` when none is armed. A tie names the total, then the fixture, then idle. */
35
+ export function earliestBound(bounds) {
36
+ let earliest = null;
37
+ for (const kind of ['total', 'fixture', 'idle']) {
38
+ const at = bounds[kind];
39
+ if (at !== null && (earliest === null || at < earliest.at))
40
+ earliest = { kind, at };
41
+ }
42
+ return earliest;
43
+ }
@@ -1,29 +1,29 @@
1
- import { type TokenGrant } from './cpu-tokens.js';
1
+ import { type Unleased } from './gateway-lease.js';
2
2
  /**
3
- * A parent's CPU pool: the tokens a granted process lends its own children, held live rather than
4
- * inherited as a bare count (specs/cowshed/05_gateway.md, "Host CPU budget", "Nested runners use a
5
- * parent-held sub-ledger").
3
+ * A CPU pool: the tokens a process lends the runners it starts, held live rather than inherited as a
4
+ * bare count (specs/cowshed/05_gateway.md, "Host scheduling", "Parallelism inside a job"). An Nx run
5
+ * serves one (`run-cpu-pool.ts`), and every granted bounded-exec serves a sub-pool of its grant to
6
+ * its own descendants, so the runners of one build tree together stay within the tree's count.
6
7
  *
7
8
  * The pool is a private Unix socket in a directory the process owns: the directory 0700, the socket
8
- * 0600. A child asks it for a count with one request line, exactly as it asks the gateway
9
- * (`holdLease`). The pool answers `queued` at once and `granted` when the child reaches the head of
10
- * its FIFO queue. A grant lasts while its connection does, so a child that dies returns its tokens
11
- * with its socket. A pool grants only from its own count, and a pool whose upstream grant has gone
12
- * grants nothing.
9
+ * 0600. A child asks it for a count with one request line, in `holdLease`'s framing. The pool
10
+ * answers `queued` at once and `granted` when the child reaches the head of its FIFO queue. A grant
11
+ * lasts while its connection does, so a child that dies returns its tokens with its socket. A pool
12
+ * grants only from its own count, and a pool whose upstream grant has gone grants nothing.
13
13
  *
14
14
  * The same count is a GNU make jobserver fifo beside the socket, mode 0600, which Cargo, its build
15
15
  * scripts and every nested `cargo` read through `CARGO_MAKEFLAGS`/`MAKEFLAGS` (specs/cowshed/05_gateway.md,
16
- * "The jobserver fifo"). A pool of `g` holds `g − 1` token bytes there; the holder's own command holds the
17
- * implicit first token. A socket grant takes fifo bytes first and that implicit slot last, which the holder
18
- * is not using while it waits on the child it lends it to; release writes the bytes back and frees the slot.
19
- * A Cargo reading the fifo and a nested runner holding a socket grant so share one count.
16
+ * "Cargo reads its holder's jobserver"). A pool of `g` holds `g − 1` token bytes there; the holder's own
17
+ * command holds the implicit first token. A socket grant takes fifo bytes first and that implicit slot last,
18
+ * which the holder is not using while it waits on the child it lends it to; release writes the bytes back and
19
+ * frees the slot. A Cargo reading the fifo and a nested runner holding a socket grant so share one count.
20
20
  */
21
21
  /** The environment name a child reads its parent's pool endpoint from; its count is `CPU_TOKENS_ENV`. */
22
22
  export declare const CPU_POOL_ENV = "BOUNDED_EXEC_CPU_POOL";
23
23
  /** An inherited pool descriptor; only a grant from its endpoint proves a live allocation. */
24
24
  export interface InheritedCpuPool {
25
25
  readonly socket: string;
26
- /** The count the parent names beside its endpoint: 0 for a resident's relay pool, which holds no token. */
26
+ /** The count the parent names beside its endpoint. */
27
27
  readonly tokens: number;
28
28
  }
29
29
  /** A running pool: the environment a child inherits to reach it, and how to close it. */
@@ -43,38 +43,35 @@ type CloseOutcome = {
43
43
  ok: false;
44
44
  error: string;
45
45
  };
46
- /**
47
- * The run's count of descendant work queued for host CPU tokens (specs/cowshed/05_gateway.md, "The bounds start at
48
- * the grant"). A queued job is not an idle one: its owner stops the run's idle clock while any wait is held. Every
49
- * pool of one run, its sub-pools included, reports to the same one.
50
- */
51
- export interface HostWaits {
52
- begin(): void;
53
- end(): void;
54
- }
55
46
  /**
56
47
  * The inherited descriptor, or null when malformed or absent. A missing or bare count, or an empty
57
- * or NUL-bearing endpoint, proves no allocation. A resident's relay pool names a count of 0 beside its
58
- * endpoint: it holds no token for its lifetime and asks the host for each child that asks it, so zero is
59
- * valid only with the endpoint, and every other count is a positive whole number. A valid descriptor still
60
- * needs a live endpoint grant (specs/cowshed/05_gateway.md, "Host CPU budget", "A resident holds no token").
48
+ * or NUL-bearing endpoint, proves no allocation; the count is a positive whole number. A valid
49
+ * descriptor still needs a live endpoint grant.
61
50
  */
62
51
  export declare function readInheritedCpuPool(environment: Readonly<NodeJS.ProcessEnv>): InheritedCpuPool | null;
63
52
  /**
64
- * Ask the immediate parent pool for `want` tokens. Neither the inherited count nor the host's core count bounds the
65
- * ask: a lent pool grants at most what it holds, and a gate's or a resident's relay pool asks the host for each
66
- * child. A granted lease is the child's local allocation: its connection is the grant, and closing it returns only
67
- * that allocation. An absent endpoint allows normal host acquisition; a connected endpoint's refusal
68
- * or protocol failure must fail admission rather than taking a second grant above its parent.
53
+ * Tokens a parent pool lent, held until released, or why there are none. `closed` resolves when the grant's
54
+ * connection closes, however it closes, so a sub-pool built on the grant ends with it.
55
+ */
56
+ export type TokenGrant = {
57
+ granted: true;
58
+ tokens: number;
59
+ release: () => void;
60
+ closed: Promise<void>;
61
+ } | Unleased;
62
+ /**
63
+ * Ask the immediate parent pool for `want` tokens. The inherited count does not bound the ask: a pool grants at
64
+ * most what it holds. A granted lease is the child's local allocation: its connection is the grant, and closing it
65
+ * returns only that allocation. An absent endpoint grants nothing and refuses nothing; a connected endpoint's refusal
66
+ * or protocol failure must fail admission rather than run the child beside its parent's count.
69
67
  */
70
68
  export declare function takeParentCpuTokens(parent: InheritedCpuPool, want: number): Promise<TokenGrant>;
71
69
  /**
72
70
  * Make a pool of `tokens` that lives while `closed` does: when `closed` resolves the pool refuses
73
- * grants, ends its child connections, drains its jobserver fifo and removes its directory. A child's
74
- * `host-wait` is reported to `waits` for as long as its connection holds it; a sub-pool reports to the
75
- * same `waits`. Setup failures are values; a non-positive or unsafe count is a programmer bug and throws.
71
+ * grants, ends its child connections, drains its jobserver fifo and removes its directory. Setup
72
+ * failures are values; a non-positive or unsafe count is a programmer bug and throws.
76
73
  */
77
- export declare function createCpuPool(tokens: number, closed: Promise<void>, waits: HostWaits): Promise<{
74
+ export declare function createCpuPool(tokens: number, closed: Promise<void>): Promise<{
78
75
  ok: true;
79
76
  pool: CpuPool;
80
77
  } | {
@@ -1 +1 @@
1
- {"version":3,"file":"cpu-pool.d.ts","sourceRoot":"","sources":["../../../src/executors/bounded-exec/cpu-pool.ts"],"names":[],"mappings":"AAQA,OAAO,EAAwC,KAAK,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAGxF;;;;;;;;;;;;;;;;;;GAkBG;AAEH,yGAAyG;AACzG,eAAO,MAAM,YAAY,0BAA0B,CAAC;AAEpD,6FAA6F;AAC7F,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,2GAA2G;IAC3G,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,yFAAyF;AACzF,MAAM,WAAW,OAAO;IACtB,oFAAoF;IACpF,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7C;;;;OAIG;IACH,KAAK,IAAI,OAAO,CAAC,YAAY,CAAC,CAAC;CAChC;AAED,KAAK,YAAY,GAAG;IAAE,EAAE,EAAE,IAAI,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAEhE;;;;GAIG;AACH,MAAM,WAAW,SAAS;IACxB,KAAK,IAAI,IAAI,CAAC;IACd,GAAG,IAAI,IAAI,CAAC;CACb;AAwED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,QAAQ,CAAC,MAAM,CAAC,UAAU,CAAC,GAAG,gBAAgB,GAAG,IAAI,CAStG;AAED;;;;;;GAMG;AACH,wBAAsB,mBAAmB,CAAC,MAAM,EAAE,gBAAgB,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CA6BrG;AAsJD;;;;;GAKG;AACH,wBAAsB,aAAa,CACjC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,EACrB,KAAK,EAAE,SAAS,GACf,OAAO,CAAC;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,OAAO,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CA6WrE"}
1
+ {"version":3,"file":"cpu-pool.d.ts","sourceRoot":"","sources":["../../../src/executors/bounded-exec/cpu-pool.ts"],"names":[],"mappings":"AAQA,OAAO,EAAa,KAAK,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAI9D;;;;;;;;;;;;;;;;;;GAkBG;AAEH,yGAAyG;AACzG,eAAO,MAAM,YAAY,0BAA0B,CAAC;AAEpD,6FAA6F;AAC7F,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,sDAAsD;IACtD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,yFAAyF;AACzF,MAAM,WAAW,OAAO;IACtB,oFAAoF;IACpF,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7C;;;;OAIG;IACH,KAAK,IAAI,OAAO,CAAC,YAAY,CAAC,CAAC;CAChC;AAED,KAAK,YAAY,GAAG;IAAE,EAAE,EAAE,IAAI,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AA2DhE;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,QAAQ,CAAC,MAAM,CAAC,UAAU,CAAC,GAAG,gBAAgB,GAAG,IAAI,CAOtG;AAED;;;GAGG;AACH,MAAM,MAAM,UAAU,GAAG;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,IAAI,CAAC;IAAC,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,CAAA;CAAE,GAAG,QAAQ,CAAC;AAElH;;;;;GAKG;AACH,wBAAsB,mBAAmB,CAAC,MAAM,EAAE,gBAAgB,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAyBrG;AAsJD;;;;GAIG;AACH,wBAAsB,aAAa,CACjC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,GACpB,OAAO,CAAC;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,OAAO,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAsUrE"}