@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.
Files changed (440) hide show
  1. package/README.md +1095 -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/all-verdicts/executor.d.ts +35 -0
  59. package/dist/executors/all-verdicts/executor.d.ts.map +1 -0
  60. package/dist/executors/all-verdicts/executor.js +133 -0
  61. package/dist/executors/all-verdicts/schema.d.ts +10 -0
  62. package/dist/executors/all-verdicts/schema.d.ts.map +1 -0
  63. package/dist/executors/all-verdicts/schema.js +2 -0
  64. package/dist/executors/bounded-exec/bounds.d.ts +56 -0
  65. package/dist/executors/bounded-exec/bounds.d.ts.map +1 -0
  66. package/dist/executors/bounded-exec/bounds.js +43 -0
  67. package/dist/executors/bounded-exec/cpu-pool.d.ts +33 -36
  68. package/dist/executors/bounded-exec/cpu-pool.d.ts.map +1 -1
  69. package/dist/executors/bounded-exec/cpu-pool.js +54 -119
  70. package/dist/executors/bounded-exec/executor.d.ts +19 -12
  71. package/dist/executors/bounded-exec/executor.d.ts.map +1 -1
  72. package/dist/executors/bounded-exec/executor.js +371 -239
  73. package/dist/executors/bounded-exec/gateway-lease.d.ts +22 -19
  74. package/dist/executors/bounded-exec/gateway-lease.d.ts.map +1 -1
  75. package/dist/executors/bounded-exec/gateway-lease.js +81 -28
  76. package/dist/executors/bounded-exec/hang-diagnostics.d.ts +18 -1
  77. package/dist/executors/bounded-exec/hang-diagnostics.d.ts.map +1 -1
  78. package/dist/executors/bounded-exec/hang-diagnostics.js +148 -30
  79. package/dist/executors/bounded-exec/lease-wait.d.ts +43 -0
  80. package/dist/executors/bounded-exec/lease-wait.d.ts.map +1 -0
  81. package/dist/executors/bounded-exec/lease-wait.js +68 -0
  82. package/dist/executors/bounded-exec/lock-wait.d.ts +51 -0
  83. package/dist/executors/bounded-exec/lock-wait.d.ts.map +1 -0
  84. package/dist/executors/bounded-exec/lock-wait.js +108 -0
  85. package/dist/executors/bounded-exec/owned-subtree.d.ts +84 -0
  86. package/dist/executors/bounded-exec/owned-subtree.d.ts.map +1 -0
  87. package/dist/executors/bounded-exec/owned-subtree.js +178 -0
  88. package/dist/executors/bounded-exec/progress.d.ts +4 -1
  89. package/dist/executors/bounded-exec/progress.d.ts.map +1 -1
  90. package/dist/executors/bounded-exec/progress.js +5 -2
  91. package/dist/executors/bounded-exec/ram-attach.d.ts +19 -0
  92. package/dist/executors/bounded-exec/ram-attach.d.ts.map +1 -0
  93. package/dist/executors/bounded-exec/ram-attach.js +207 -0
  94. package/dist/executors/bounded-exec/ram-detach.d.ts +25 -0
  95. package/dist/executors/bounded-exec/ram-detach.d.ts.map +1 -0
  96. package/dist/executors/bounded-exec/ram-detach.js +207 -0
  97. package/dist/executors/bounded-exec/ram-temp-fixtures.d.ts +76 -0
  98. package/dist/executors/bounded-exec/ram-temp-fixtures.d.ts.map +1 -1
  99. package/dist/executors/bounded-exec/ram-temp-fixtures.js +296 -0
  100. package/dist/executors/bounded-exec/ram-temp.d.ts +388 -88
  101. package/dist/executors/bounded-exec/ram-temp.d.ts.map +1 -1
  102. package/dist/executors/bounded-exec/ram-temp.js +1213 -399
  103. package/dist/executors/bounded-exec/run-cpu-pool.d.ts +4 -4
  104. package/dist/executors/bounded-exec/run-cpu-pool.d.ts.map +1 -1
  105. package/dist/executors/bounded-exec/run-cpu-pool.js +20 -30
  106. package/dist/executors/bounded-exec/runner-hook.js +14 -5
  107. package/dist/executors/bounded-exec/runner-lifecycle.d.ts +14 -1
  108. package/dist/executors/bounded-exec/runner-lifecycle.d.ts.map +1 -1
  109. package/dist/executors/bounded-exec/runner-lifecycle.js +27 -6
  110. package/dist/executors/bounded-exec/{cpu-tokens.d.ts → runner-sizing.d.ts} +14 -42
  111. package/dist/executors/bounded-exec/runner-sizing.d.ts.map +1 -0
  112. package/dist/executors/bounded-exec/{cpu-tokens.js → runner-sizing.js} +5 -35
  113. package/dist/executors/bounded-exec/runtime-pin.d.ts +73 -0
  114. package/dist/executors/bounded-exec/runtime-pin.d.ts.map +1 -0
  115. package/dist/executors/bounded-exec/runtime-pin.js +167 -0
  116. package/dist/executors/bounded-exec/schema.d.ts +18 -1
  117. package/dist/executors/bounded-exec/schema.d.ts.map +1 -1
  118. package/dist/executors/bounded-exec/verdict.d.ts +40 -11
  119. package/dist/executors/bounded-exec/verdict.d.ts.map +1 -1
  120. package/dist/executors/bounded-exec/verdict.js +88 -19
  121. package/dist/executors/cargo-zigbuild/executor.d.ts +21 -0
  122. package/dist/executors/cargo-zigbuild/executor.d.ts.map +1 -1
  123. package/dist/executors/cargo-zigbuild/executor.js +67 -12
  124. package/dist/executors/clean-outputs/executor.js +1 -0
  125. package/dist/executors/scriptc-native/executor.d.ts +79 -0
  126. package/dist/executors/scriptc-native/executor.d.ts.map +1 -0
  127. package/dist/executors/scriptc-native/executor.js +367 -0
  128. package/dist/executors/scriptc-native/ffi-paths.d.ts +9 -0
  129. package/dist/executors/scriptc-native/ffi-paths.d.ts.map +1 -0
  130. package/dist/executors/scriptc-native/ffi-paths.js +25 -0
  131. package/dist/executors/scriptc-native/schema.d.ts +34 -0
  132. package/dist/executors/scriptc-native/schema.d.ts.map +1 -0
  133. package/dist/executors/scriptc-native/schema.js +1 -0
  134. package/dist/executors/typescript-emit/executor.d.ts +3 -1
  135. package/dist/executors/typescript-emit/executor.d.ts.map +1 -1
  136. package/dist/executors/typescript-emit/executor.js +164 -33
  137. package/dist/forbidden-spelling-policy.d.ts +56 -0
  138. package/dist/forbidden-spelling-policy.d.ts.map +1 -0
  139. package/dist/forbidden-spelling-policy.js +176 -0
  140. package/dist/generators/create-package/generator.d.ts.map +1 -1
  141. package/dist/generators/create-package/generator.js +3 -4
  142. package/dist/graph-input-contract.d.ts +14 -0
  143. package/dist/graph-input-contract.d.ts.map +1 -1
  144. package/dist/graph-input-contract.js +67 -2
  145. package/dist/index.d.ts +23 -6
  146. package/dist/index.d.ts.map +1 -1
  147. package/dist/index.js +676 -215
  148. package/dist/managed-assets.d.ts +2 -0
  149. package/dist/managed-assets.d.ts.map +1 -1
  150. package/dist/managed-files/files.d.ts +3 -3
  151. package/dist/managed-files/files.d.ts.map +1 -1
  152. package/dist/managed-files/files.js +28 -3
  153. package/dist/managed-files/managed-format.d.ts.map +1 -1
  154. package/dist/managed-files/managed-format.js +1 -0
  155. package/dist/nextest-code-bound.js +1 -0
  156. package/dist/nextest-timings.d.ts +35 -0
  157. package/dist/nextest-timings.d.ts.map +1 -0
  158. package/dist/nextest-timings.js +168 -0
  159. package/dist/owned-installation.d.ts +6 -5
  160. package/dist/owned-installation.d.ts.map +1 -1
  161. package/dist/owned-installation.js +150 -26
  162. package/dist/package-target-policy.d.ts.map +1 -1
  163. package/dist/package-target-policy.js +2 -3
  164. package/dist/process-children.d.ts +7 -0
  165. package/dist/process-children.d.ts.map +1 -0
  166. package/dist/process-children.darwin.d.ts +7 -0
  167. package/dist/process-children.darwin.d.ts.map +1 -0
  168. package/dist/process-children.darwin.js +13 -0
  169. package/dist/process-children.js +14 -0
  170. package/dist/process-children.linux.d.ts +8 -0
  171. package/dist/process-children.linux.d.ts.map +1 -0
  172. package/dist/process-children.linux.js +25 -0
  173. package/dist/process-group.d.ts +108 -0
  174. package/dist/process-group.d.ts.map +1 -0
  175. package/dist/process-group.js +171 -0
  176. package/dist/process-listing.d.ts +7 -0
  177. package/dist/process-listing.d.ts.map +1 -0
  178. package/dist/process-listing.js +51 -0
  179. package/dist/producer-receipts.d.ts +8 -2
  180. package/dist/producer-receipts.d.ts.map +1 -1
  181. package/dist/producer-receipts.js +75 -48
  182. package/dist/task-graph-policy.d.ts +21 -0
  183. package/dist/task-graph-policy.d.ts.map +1 -0
  184. package/dist/task-graph-policy.js +91 -0
  185. package/dist/test-timings.js +4 -4
  186. package/dist/test-walk-policy.d.ts +14 -5
  187. package/dist/test-walk-policy.d.ts.map +1 -1
  188. package/dist/test-walk-policy.js +8 -2
  189. package/dist/testing.d.ts +73 -28
  190. package/dist/testing.d.ts.map +1 -1
  191. package/dist/testing.js +217 -223
  192. package/dist/tool-bins.d.ts +33 -0
  193. package/dist/tool-bins.d.ts.map +1 -0
  194. package/dist/tool-bins.js +72 -0
  195. package/dist/typecheck-test-policy.d.ts.map +1 -1
  196. package/dist/typecheck-test-policy.js +3 -4
  197. package/dist/wait-why-policy.d.ts +28 -0
  198. package/dist/wait-why-policy.d.ts.map +1 -0
  199. package/dist/wait-why-policy.js +223 -0
  200. package/dist/workspace-config-policy.d.ts +14 -8
  201. package/dist/workspace-config-policy.d.ts.map +1 -1
  202. package/dist/workspace-config-policy.js +60 -16
  203. package/dist/workspace-manifest.d.ts +41 -6
  204. package/dist/workspace-manifest.d.ts.map +1 -1
  205. package/dist/workspace-manifest.js +57 -0
  206. package/executors.json +21 -1
  207. package/loader.js +2 -0
  208. package/managed/raw/envrc +11 -0
  209. package/managed/raw/patches/nx@23.2.1.patch +2840 -199
  210. package/managed/raw/patches/ttsc@0.34.1.patch +119 -0
  211. package/managed/raw/tooling/direnv/cargo-fetch-bound.ts +245 -0
  212. package/managed/raw/tooling/direnv/cargo-fetch-run.ts +299 -0
  213. package/managed/raw/tooling/direnv/compiler-variables.sh +42 -0
  214. package/managed/raw/tooling/direnv/developer-links.ts +464 -25
  215. package/managed/raw/tooling/direnv/devenv.smoo.nix +78 -38
  216. package/managed/raw/tooling/direnv/github-actions-bootstrap.sh +14 -12
  217. package/managed/raw/tooling/direnv/installed-bun-links.ts +308 -0
  218. package/managed/raw/tooling/direnv/linked-snapshots.ts +62 -3
  219. package/managed/raw/tooling/direnv/nx-socket-dir.sh +56 -17
  220. package/managed/raw/tooling/direnv/repo-path +68 -6
  221. package/managed/raw/tooling/direnv/secret-references.ts +13 -4
  222. package/managed/raw/tooling/direnv/setup-environment.ts +128 -537
  223. package/managed/raw/tooling/direnv/toolchain-stamp.ts +4 -2
  224. package/managed/raw/tooling/direnv/ttsc-env.sh +9 -0
  225. package/managed/raw/tooling/direnv/uv-relocation.ts +227 -0
  226. package/managed/raw/tooling/git-hooks/commit-msg.sh +2 -1
  227. package/managed/raw/tooling/git-hooks/pre-commit.sh +2 -1
  228. package/managed/raw/tooling/git-hooks/pre-push.sh +2 -1
  229. package/managed/templates/github/actions/cache-ttsc-plugins/action.yml +85 -7
  230. package/managed/templates/github/actions/save-nix-devenv/action.yml +12 -2
  231. package/managed/templates/github/actions/setup-devenv/action.yml +2 -0
  232. package/package.json +77 -13
  233. package/src/bin/smoo-nx-cargo-toolchain.ts +11 -0
  234. package/src/bin/smoo-nx-forbidden-spellings.ts +33 -0
  235. package/src/bin/smoo-nx-nextest-timings.ts +31 -0
  236. package/src/bounded-test-policy.ts +12 -14
  237. package/src/build-state-output-policy.ts +458 -34
  238. package/src/bun-lock-scope.ts +108 -0
  239. package/src/cargo-build-script-env.ts +265 -0
  240. package/src/cargo-closure-input.ts +74 -7
  241. package/src/cargo-retention-hook.ts +94 -0
  242. package/src/cargo-source-hash.ts +138 -41
  243. package/src/cargo-toolchain-paths.ts +95 -0
  244. package/src/cargo-toolchain-policy.ts +49 -5
  245. package/src/cargo-workspace.ts +72 -123
  246. package/src/cross-check-policy.ts +12 -10
  247. package/src/disk-command-policy.ts +1 -0
  248. package/src/ensure-built-receipt.ts +132 -39
  249. package/src/ensure-built-witness.ts +62 -10
  250. package/src/ensure-built.ts +11 -1
  251. package/src/eslint-config-closure.ts +357 -0
  252. package/src/executors/all-verdicts/executor.ts +164 -0
  253. package/src/executors/all-verdicts/schema.json +22 -0
  254. package/src/executors/all-verdicts/schema.ts +10 -0
  255. package/src/executors/bounded-exec/bounds.ts +76 -0
  256. package/src/executors/bounded-exec/cpu-pool.ts +51 -117
  257. package/src/executors/bounded-exec/executor.ts +423 -259
  258. package/src/executors/bounded-exec/gateway-lease.ts +82 -33
  259. package/src/executors/bounded-exec/hang-diagnostics.ts +173 -31
  260. package/src/executors/bounded-exec/lease-wait.ts +89 -0
  261. package/src/executors/bounded-exec/lock-wait.ts +141 -0
  262. package/src/executors/bounded-exec/owned-subtree.ts +235 -0
  263. package/src/executors/bounded-exec/progress.ts +9 -3
  264. package/src/executors/bounded-exec/ram-attach.ts +238 -0
  265. package/src/executors/bounded-exec/ram-detach.ts +226 -0
  266. package/src/executors/bounded-exec/ram-temp-fixtures.ts +358 -0
  267. package/src/executors/bounded-exec/ram-temp-registry.txt +440 -0
  268. package/src/executors/bounded-exec/ram-temp.ts +1497 -460
  269. package/src/executors/bounded-exec/run-cpu-pool.ts +22 -30
  270. package/src/executors/bounded-exec/runner-hook.ts +14 -6
  271. package/src/executors/bounded-exec/runner-lifecycle.ts +31 -8
  272. package/src/executors/bounded-exec/{cpu-tokens.ts → runner-sizing.ts} +13 -59
  273. package/src/executors/bounded-exec/runtime-pin.ts +232 -0
  274. package/src/executors/bounded-exec/schema.json +11 -2
  275. package/src/executors/bounded-exec/schema.ts +19 -1
  276. package/src/executors/bounded-exec/verdict.ts +137 -34
  277. package/src/executors/cargo-zigbuild/executor.ts +82 -8
  278. package/src/executors/clean-outputs/executor.ts +1 -0
  279. package/src/executors/scriptc-native/executor.ts +394 -0
  280. package/src/executors/scriptc-native/ffi-paths.ts +29 -0
  281. package/src/executors/scriptc-native/schema.json +60 -0
  282. package/src/executors/scriptc-native/schema.ts +34 -0
  283. package/src/executors/typescript-emit/executor.ts +205 -38
  284. package/src/forbidden-spelling-policy.ts +226 -0
  285. package/src/generators/create-package/generator.ts +7 -7
  286. package/src/graph-input-contract.ts +61 -2
  287. package/src/index.ts +792 -225
  288. package/src/managed-assets.ts +3 -0
  289. package/src/managed-files/files.ts +28 -3
  290. package/src/managed-files/managed-format.ts +1 -0
  291. package/src/nextest-code-bound.ts +1 -0
  292. package/src/nextest-timings.ts +106 -0
  293. package/src/owned-installation.ts +150 -23
  294. package/src/package-target-policy.ts +2 -3
  295. package/src/process-children.darwin.ts +14 -0
  296. package/src/process-children.linux.ts +33 -0
  297. package/src/process-children.ts +22 -0
  298. package/src/process-group.ts +209 -0
  299. package/src/process-listing.ts +54 -0
  300. package/src/producer-receipts.ts +68 -45
  301. package/src/task-graph-policy.ts +98 -0
  302. package/src/test-walk-policy.ts +23 -8
  303. package/src/testing.ts +240 -232
  304. package/src/tool-bins.ts +108 -0
  305. package/src/typecheck-test-policy.ts +2 -3
  306. package/src/wait-why-policy.ts +226 -0
  307. package/src/workspace-config-policy.ts +63 -15
  308. package/src/workspace-manifest.ts +89 -6
  309. package/test-timings.json +123 -98
  310. package/dist/bin/smoo-nx-failures.d.ts +0 -3
  311. package/dist/bin/smoo-nx-failures.d.ts.map +0 -1
  312. package/dist/bin/smoo-nx-failures.js +0 -3
  313. package/dist/bin/smoo-nx-nextest-extract.d.ts +0 -3
  314. package/dist/bin/smoo-nx-nextest-extract.d.ts.map +0 -1
  315. package/dist/bin/smoo-nx-nextest-extract.js +0 -42
  316. package/dist/executors/bounded-exec/cpu-tokens.d.ts.map +0 -1
  317. package/dist/failure-summary.d.ts +0 -5
  318. package/dist/failure-summary.d.ts.map +0 -1
  319. package/dist/failure-summary.js +0 -118
  320. package/dist/nextest-extraction.d.ts +0 -117
  321. package/dist/nextest-extraction.d.ts.map +0 -1
  322. package/dist/nextest-extraction.js +0 -303
  323. package/managed/raw/patches/ttsc@0.30.4.patch +0 -2255
  324. package/src/__tests__/cargo-closure-filesets.ts +0 -94
  325. package/src/__tests__/cargo-closure-fixture.ts +0 -113
  326. package/src/__tests__/counted-cargo-process.ts +0 -286
  327. package/src/__tests__/counted-cargo.ts +0 -713
  328. package/src/__tests__/directory-change.ts +0 -27
  329. package/src/__tests__/fixture-cargo-home.ts +0 -36
  330. package/src/__tests__/fixture-nx-env.ts +0 -193
  331. package/src/__tests__/owned-installation.ts +0 -13
  332. package/src/__tests__/past-tick.ts +0 -12
  333. package/src/__tests__/progress-clock.ts +0 -43
  334. package/src/__tests__/runtime-input.ts +0 -23
  335. package/src/bin/smoo-nx-bound-failures.test.ts +0 -127
  336. package/src/bin/smoo-nx-failures.ts +0 -4
  337. package/src/bin/smoo-nx-nextest-extract.ts +0 -44
  338. package/src/bounded-test-policy.test.ts +0 -1029
  339. package/src/build-state-output-policy.test.ts +0 -115
  340. package/src/bun-bootstrap.test.ts +0 -102
  341. package/src/bun-file-packages.test.ts +0 -47
  342. package/src/cargo-closure-filesets.test.ts +0 -63
  343. package/src/cargo-closure-input.property.test.ts +0 -50
  344. package/src/cargo-closure-input.test.ts +0 -506
  345. package/src/cargo-closure-key.test.ts +0 -240
  346. package/src/cargo-resolve-cache.test.ts +0 -1181
  347. package/src/cargo-source-hash.test.ts +0 -707
  348. package/src/cargo-workspace.test.ts +0 -615
  349. package/src/cross-check-policy.test.ts +0 -316
  350. package/src/disk-command-policy.test.ts +0 -61
  351. package/src/ensure-built-receipt.test.ts +0 -279
  352. package/src/ensure-built-witness.test.ts +0 -688
  353. package/src/ensure-built.test.ts +0 -1462
  354. package/src/executors/bounded-exec/cargo-progress-host.test.ts +0 -332
  355. package/src/executors/bounded-exec/cpu-pool.test.ts +0 -684
  356. package/src/executors/bounded-exec/cpu-tokens.test.ts +0 -519
  357. package/src/executors/bounded-exec/disk-lease.test.ts +0 -219
  358. package/src/executors/bounded-exec/executor-host.test.ts +0 -800
  359. package/src/executors/bounded-exec/executor.test.ts +0 -1819
  360. package/src/executors/bounded-exec/go-progress-host.test.ts +0 -171
  361. package/src/executors/bounded-exec/hang-diagnostics.test.ts +0 -291
  362. package/src/executors/bounded-exec/progress.test.ts +0 -139
  363. package/src/executors/bounded-exec/ram-temp-held.test.ts +0 -264
  364. package/src/executors/bounded-exec/ram-temp-host.test.ts +0 -635
  365. package/src/executors/bounded-exec/ram-temp.test.ts +0 -750
  366. package/src/executors/bounded-exec/run-cpu-pool.test.ts +0 -79
  367. package/src/executors/bounded-exec/runner-hook.test.ts +0 -193
  368. package/src/executors/bounded-exec/runner-lifecycle.test.ts +0 -82
  369. package/src/executors/bounded-exec/verdict.test.ts +0 -545
  370. package/src/executors/cargo-zigbuild/executor.test.ts +0 -129
  371. package/src/executors/clean-outputs/executor.test.ts +0 -20
  372. package/src/executors/typescript-emit/executor.test.ts +0 -83
  373. package/src/failure-summary.ts +0 -119
  374. package/src/generators/bounded-test-targets/generator.test.ts +0 -138
  375. package/src/generators/bun-test-tracing/generator.test.ts +0 -250
  376. package/src/generators/create-package/generator.test.ts +0 -190
  377. package/src/generators/make-public/generator.test.ts +0 -137
  378. package/src/graph-input-contract.test.ts +0 -379
  379. package/src/host-controller-wiring.test.ts +0 -31
  380. package/src/index.test.ts +0 -3319
  381. package/src/linked-snapshots.nx.test.ts +0 -254
  382. package/src/managed-files/forgejo-artifact.test.ts +0 -395
  383. package/src/managed-files/generator.test.ts +0 -243
  384. package/src/managed-files/github-host-cache-isolation.test.ts +0 -86
  385. package/src/managed-files/json-edit.test.ts +0 -216
  386. package/src/managed-files/managed-content.test.ts +0 -166
  387. package/src/managed-files/managed-format-json.test.ts +0 -308
  388. package/src/managed-files/repo-path.test.ts +0 -172
  389. package/src/managed-files/setup-devenv-free-disk.test.ts +0 -95
  390. package/src/managed-files/trace-db-artifact.test.ts +0 -7
  391. package/src/managed-files/tree-permissions.test.ts +0 -109
  392. package/src/managed-files/tree.test.ts +0 -123
  393. package/src/manifest-hash.test.ts +0 -219
  394. package/src/nextest-code-bound.test.ts +0 -161
  395. package/src/nextest-extraction.test.ts +0 -216
  396. package/src/nextest-extraction.ts +0 -371
  397. package/src/nextest-partitions.test.ts +0 -501
  398. package/src/nx-cache-bound.test.ts +0 -109
  399. package/src/nx-cache-restore-mtime.test.ts +0 -170
  400. package/src/nx-daemon-claim.test.ts +0 -279
  401. package/src/nx-daemon-idle-cpu.test.ts +0 -80
  402. package/src/nx-daemon-idle-policy.test.ts +0 -111
  403. package/src/nx-daemon-ignore-files.test.ts +0 -210
  404. package/src/nx-daemon-root-normalization.test.ts +0 -105
  405. package/src/nx-daemon-start-never.test.ts +0 -292
  406. package/src/nx-daemon-validity.test.ts +0 -1055
  407. package/src/nx-dot-input-policy.test.ts +0 -353
  408. package/src/nx-failure-life-cycles.test.ts +0 -207
  409. package/src/nx-files-archive-racy.test.ts +0 -97
  410. package/src/nx-foreign-workspace-env.test.ts +0 -329
  411. package/src/nx-incomplete-run-summary.test.ts +0 -70
  412. package/src/nx-plugin-load-errors.test.ts +0 -120
  413. package/src/nx-project-graph-errors.test.ts +0 -70
  414. package/src/nx-project-resolution-cache.test.ts +0 -176
  415. package/src/nx-raw-inputs.test.ts +0 -166
  416. package/src/nx-resident-graph-workers.test.ts +0 -112
  417. package/src/nx-run-information.test.ts +0 -118
  418. package/src/nx-skipped-task-exit.test.ts +0 -180
  419. package/src/nx-state-location.test.ts +0 -63
  420. package/src/nx-store-resolution.test.ts +0 -81
  421. package/src/nx-task-graph-cycles.test.ts +0 -148
  422. package/src/nx-task-output-lease.test.ts +0 -550
  423. package/src/nx-use-local.test.ts +0 -105
  424. package/src/owned-installation.test.ts +0 -105
  425. package/src/package-target-policy.test.ts +0 -1014
  426. package/src/producer-receipts.test.ts +0 -285
  427. package/src/release-config-policy.test.ts +0 -311
  428. package/src/runtime-input.test.ts +0 -393
  429. package/src/serial-group-wiring.test.ts +0 -326
  430. package/src/task-history-namespace.test.ts +0 -181
  431. package/src/task-results.test.ts +0 -228
  432. package/src/test-clock-policy.test.ts +0 -338
  433. package/src/test-program.test.ts +0 -303
  434. package/src/test-timings.test.ts +0 -240
  435. package/src/test-walk-policy.test.ts +0 -620
  436. package/src/testing.test.ts +0 -509
  437. package/src/typecheck-test-policy.test.ts +0 -1468
  438. package/src/typescript-resolution.test.ts +0 -76
  439. package/src/version-actions.test.ts +0 -80
  440. package/src/workspace-config-policy.test.ts +0 -737
@@ -1,713 +0,0 @@
1
- import { expect } from 'bun:test';
2
- import { subscribe, unsubscribe } from 'node:diagnostics_channel';
3
- import { realpathSync } from 'node:fs';
4
- import { chmod, mkdir, readFile, writeFile } from 'node:fs/promises';
5
- import { createServer, type Server, type Socket } from 'node:net';
6
- import { delimiter, join } from 'node:path';
7
- import { fileURLToPath } from 'node:url';
8
-
9
- import type { LogSchema, OpContextBinding } from '@smoothbricks/lmao';
10
- import { type QueryableSpan, querySpan } from '@smoothbricks/lmao/testing';
11
- import { useTestSpan } from '@smoothbricks/lmao/testing/bun';
12
- import { AggregateCreateNodesError } from 'nx/src/project-graph/error-types.js';
13
- import { CargoMetadataError } from '../cargo-source-hash.js';
14
- import { BOUNDED_TEST_IDLE_TIMEOUT_MS } from '../test-backstop.js';
15
- import { bindListener } from '../testing.js';
16
- import { BROKER_HOST, encodeOrder, type ProcessReport, parseReport, readLines } from './counted-cargo-process.js';
17
-
18
- /** What one fixture's `cargo metadata` children have done so far, in the order they did it. */
19
- export interface CargoMetadataRuns {
20
- /** `cargo metadata` children started. */
21
- readonly spawned: number;
22
- /** Those whose Cargo has read the workspace, whether or not the answer has been handed over yet. */
23
- readonly read: number;
24
- /** The most that were alive at once; a child killed before it answered never counts as ended. */
25
- readonly peak: number;
26
- /** Each child's pid, in the order they started. */
27
- readonly pids: readonly number[];
28
- /** Processes the children left running behind them (see `leaveGrandchildren`). */
29
- readonly grandchildren: readonly number[];
30
- }
31
-
32
- /** One step of a `cargo metadata` child's life, as the broker received it. */
33
- export interface CargoMetadataEvent {
34
- readonly kind: 'start' | 'read' | 'end' | 'grandchild';
35
- /** The child's pid; for `grandchild`, the pid of the process the child left behind. */
36
- readonly pid: number;
37
- }
38
-
39
- /** The events are in the order things happened, so a running count over them is the true concurrency. */
40
- export function cargoMetadataRuns(events: readonly CargoMetadataEvent[]): CargoMetadataRuns {
41
- const pids: number[] = [];
42
- const grandchildren: number[] = [];
43
- let read = 0;
44
- let alive = 0;
45
- let peak = 0;
46
- for (const { kind, pid } of events) {
47
- switch (kind) {
48
- case 'start':
49
- pids.push(pid);
50
- alive += 1;
51
- peak = Math.max(peak, alive);
52
- break;
53
- case 'read':
54
- read += 1;
55
- break;
56
- case 'end':
57
- alive -= 1;
58
- break;
59
- case 'grandchild':
60
- grandchildren.push(pid);
61
- break;
62
- }
63
- }
64
- return { spawned: pids.length, read, peak, pids, grandchildren };
65
- }
66
-
67
- /** The test spans still open under `span`, itself included: the work a hung test is still inside. */
68
- function openSpans<T extends LogSchema>(span: QueryableSpan<T>, open: string[]): string[] {
69
- // Row 1 holds a span's completion; its timestamp stays 0 until the span ends.
70
- if (span.buffer.timestamp[1] === 0n) open.push(span.name);
71
- for (const child of span.children) openSpans(child, open);
72
- return open;
73
- }
74
-
75
- /**
76
- * `operation`, settling exactly as it does, unless no event settles it within `timeoutMs`: then it
77
- * rejects with `what`, the test spans still open and `diagnostics()`. The test span is taken now, so
78
- * call this from the test's own async context. `signal` disarms the guard; the result still follows
79
- * `operation`. The default is the leg's no-progress backstop: a guard that fires sooner races a
80
- * loaded host (a 15 s and a 30 s guard failed slow but healthy daemon and Cargo waits), so it only
81
- * names what was still open when a wait truly hangs. A guard only ever fails a wait; nothing advances
82
- * on it.
83
- */
84
- export function guardEvent<T>(
85
- operation: Promise<T>,
86
- what: string,
87
- diagnostics: () => string | Promise<string>,
88
- signal?: AbortSignal,
89
- timeoutMs = BOUNDED_TEST_IDLE_TIMEOUT_MS,
90
- ): Promise<T> {
91
- let spans: () => string;
92
- try {
93
- const test = querySpan(useTestSpan<OpContextBinding>().buffer);
94
- spans = () => {
95
- try {
96
- return `open test spans: [${openSpans(test, []).join(', ')}]`;
97
- } catch (error) {
98
- return `open test spans unreadable: ${error instanceof Error ? error.message : String(error)}`;
99
- }
100
- };
101
- } catch (error) {
102
- const reason = error instanceof Error ? error.message : String(error);
103
- spans = () => `no test span to report: ${reason}`;
104
- }
105
- return new Promise<T>((resolve, reject) => {
106
- const report = async (): Promise<void> => {
107
- let details: string;
108
- try {
109
- details = await diagnostics();
110
- } catch (error) {
111
- details = `diagnostics failed: ${error instanceof Error ? (error.stack ?? error.message) : String(error)}`;
112
- }
113
- reject(new Error(`${what}: no event within ${timeoutMs} ms\n${spans()}\n${details}`));
114
- };
115
- // Kept referenced: when nothing else is left to wake the process, the report still comes.
116
- const timer = setTimeout(() => void report(), timeoutMs);
117
- const disarm = () => clearTimeout(timer);
118
- if (signal?.aborted) disarm();
119
- else signal?.addEventListener('abort', disarm, { once: true });
120
- operation.then(resolve, reject).finally(() => {
121
- disarm();
122
- signal?.removeEventListener('abort', disarm);
123
- });
124
- });
125
- }
126
-
127
- /** Where `readCargoResolve` says a call joined a resolution already in flight. */
128
- const CARGO_RESOLVE_CHANNEL = '@smoothbricks/nx-plugin:cargo-resolve';
129
-
130
- /**
131
- * Counts the calls that join a resolution of `manifest` already in flight in this process, from now:
132
- * subscribe before the calls start. `joined` resolves once `count` have joined. `dispose` stops
133
- * counting and disarms the guard; a `joined` not yet reached then never settles.
134
- */
135
- export function waitForCargoJoins(manifest: string, count: number): { joined: Promise<void>; dispose(): void } {
136
- const canonical = realpathSync(manifest);
137
- const elsewhere: string[] = [];
138
- const malformed: string[] = [];
139
- const abort = new AbortController();
140
- let seen = 0;
141
- let listener: ((message: unknown) => void) | null = null;
142
- const stop = () => {
143
- if (listener !== null) unsubscribe(CARGO_RESOLVE_CHANNEL, listener);
144
- listener = null;
145
- };
146
- const counted = new Promise<void>((resolve) => {
147
- const onMessage = (message: unknown) => {
148
- if (typeof message !== 'object' || message === null || !('phase' in message) || !('manifest' in message)) {
149
- malformed.push(String(message));
150
- return;
151
- }
152
- if (message.phase !== 'join') return;
153
- if (message.manifest !== canonical) {
154
- elsewhere.push(String(message.manifest));
155
- return;
156
- }
157
- seen += 1;
158
- if (seen === count) {
159
- stop();
160
- resolve();
161
- }
162
- };
163
- listener = onMessage;
164
- subscribe(CARGO_RESOLVE_CHANNEL, onMessage);
165
- });
166
- const joined = guardEvent(
167
- counted,
168
- `waiting for ${count} calls to join the resolution of ${canonical}`,
169
- () =>
170
- `saw ${seen} of ${count} joins on ${CARGO_RESOLVE_CHANNEL}; ` +
171
- `joins of other manifests: [${elsewhere.join(', ')}]; malformed messages: [${malformed.join(', ')}]`,
172
- abort.signal,
173
- );
174
- return {
175
- joined,
176
- dispose: () => {
177
- stop();
178
- abort.abort();
179
- },
180
- };
181
- }
182
-
183
- /** A gate a test closes to hold every `cargo metadata` child at one point of its life, and opens to let them go on. */
184
- export interface Latch {
185
- close(): Promise<void>;
186
- open(): Promise<void>;
187
- }
188
-
189
- export interface CountedCargo {
190
- /** The directory holding the `cargo` that goes ahead of the real one. */
191
- readonly bin: string;
192
- /**
193
- * What a process under test needs: this Cargo ahead of everything else on PATH, and the Nx
194
- * workspace-data directory (where Cargo resolutions are kept between processes) inside the
195
- * fixture, so the persistent cache is the fixture's own and is deleted with it, whatever
196
- * `NX_WORKSPACE_DATA_DIRECTORY` the test run itself inherited.
197
- */
198
- readonly environment: Readonly<Record<string, string>>;
199
- /** Hold every child before it reads the workspace: an edit made now is one its answer includes. */
200
- readonly beforeRead: Latch;
201
- /** Hold every child after it read the workspace: an edit made now is one its answer predates. */
202
- readonly beforeAnswer: Latch;
203
- /** While set, a child that has read answers with this on stderr and exit code 101 instead. */
204
- failWith(stderr: string): Promise<void>;
205
- recover(): Promise<void>;
206
- /** Whether every child leaves a background process running behind it, as a real Cargo does with rustc. */
207
- leaveGrandchildren(leave: boolean): Promise<void>;
208
- runs(): Promise<CargoMetadataRuns>;
209
- /**
210
- * The first runs `predicate` holds for: now, or after whichever child's report makes it hold. A
211
- * child counts as `read`, and its grandchild among `grandchildren`, only once that grandchild is
212
- * running and connected, so a predicate over both sees them together.
213
- */
214
- waitForRuns(predicate: (runs: CargoMetadataRuns) => boolean, what: string): Promise<CargoMetadataRuns>;
215
- /**
216
- * Resolves once every one of `pids` (children and grandchildren) has died: its connection to the
217
- * fixture closed without the child having finished. Rejects for a pid that never connected, or one
218
- * that ended normally or was let go by `release`, since none of those died.
219
- */
220
- waitForDisconnects(pids: readonly number[]): Promise<void>;
221
- /**
222
- * Open every latch, end every grandchild, stop accepting children, and wait until every process
223
- * the fixture started has gone, so nothing outlives it. Idempotent.
224
- */
225
- release(): Promise<void>;
226
- }
227
-
228
- export interface CannedCargo extends CountedCargo {
229
- /** What `cargo metadata` prints from now on: this document, as JSON. */
230
- answerWith(metadata: unknown): Promise<void>;
231
- /** What `cargo metadata` prints from now on: this text, whatever it is. */
232
- answerWithText(text: string): Promise<void>;
233
- }
234
-
235
- /** How a process's connection to the fixture ended. */
236
- type Departure =
237
- /** A child that finished: it said `end` before hanging up. */
238
- | 'ended'
239
- /** A grandchild the fixture let go on `release`. */
240
- | 'released'
241
- /** Died: hung up without finishing, killed or crashed (its stderr says which). */
242
- | 'vanished';
243
-
244
- /** Where a `cargo metadata` child is in its life: each step is taken when its gate lets it. */
245
- type ChildPhase =
246
- | 'before-read'
247
- | 'reading'
248
- /** It has read; the grandchild it named has not connected yet. */
249
- | 'awaiting-grandchild'
250
- | 'before-answer'
251
- | 'answering'
252
- | 'ended';
253
-
254
- interface MetadataChild {
255
- readonly role: 'metadata';
256
- readonly pid: number;
257
- readonly socket: Socket;
258
- phase: ChildPhase;
259
- grandchild: number | null;
260
- status: number | null;
261
- departure: Departure | null;
262
- error: string | null;
263
- }
264
-
265
- interface Grandchild {
266
- readonly role: 'grandchild';
267
- readonly pid: number;
268
- readonly parent: number;
269
- readonly socket: Socket;
270
- released: boolean;
271
- departure: Departure | null;
272
- error: string | null;
273
- }
274
-
275
- type Registered = MetadataChild | Grandchild;
276
-
277
- const quote = (value: string): string => `'${value.replaceAll("'", `'"'"'`)}'`;
278
-
279
- const PROGRAM = fileURLToPath(new URL('./counted-cargo-process.ts', import.meta.url));
280
-
281
- interface Listening {
282
- readonly server: Server;
283
- readonly port: number;
284
- }
285
-
286
- /**
287
- * `server` listening on the broker's host at `port` (0: the kernel's choice), with the port it holds; rejects with
288
- * the bind's own error.
289
- */
290
- function listen(server: Server, port: number): Promise<Listening> {
291
- const { promise, resolve, reject } = Promise.withResolvers<Listening>();
292
- server.once('error', reject);
293
- server.listen(port, BROKER_HOST, () => {
294
- server.off('error', reject);
295
- const address = server.address();
296
- if (address === null || typeof address === 'string') {
297
- server.close();
298
- reject(new Error(`the broker has no port: ${address}`));
299
- } else {
300
- resolve({ server, port: address.port });
301
- }
302
- });
303
- return promise;
304
- }
305
-
306
- /**
307
- * A `cargo` ahead of the real one on PATH, and the broker in this process it reports to. Every
308
- * subcommand but `metadata` runs the real Cargo (`forward` is the command line that does). A
309
- * `metadata` child is `counted-cargo-process.ts` under the same pid and process group; it reports
310
- * `start` as it begins, `read` once it has its answer, and `end` after the answer has been handed
311
- * over, so the broker orders each child's life against every other's. Its answer is the real
312
- * `cargo metadata`'s while `canned` is null, else `canned`, as it is when the child reads.
313
- */
314
- async function shim(
315
- root: string,
316
- forward: string,
317
- initial: string | null,
318
- ): Promise<{ cargo: CountedCargo; answer(text: string): void }> {
319
- const path = process.env.PATH ?? '';
320
- const real = Bun.which('cargo', { PATH: path });
321
- if (real === null) throw new Error('cargo is not on PATH');
322
- const directory = join(root, 'counted-cargo');
323
- const bin = join(directory, 'bin');
324
-
325
- const events: CargoMetadataEvent[] = [];
326
- const processes = new Map<number, Registered>();
327
- const connections = new Set<Socket>();
328
- const listeners = new Set<() => void>();
329
- const faults: string[] = [];
330
- const torn: string[] = [];
331
- const closed = { read: false, answer: false };
332
- let canned = initial;
333
- let failure: string | null = null;
334
- let leave = false;
335
- let releasing = false;
336
- let listening = true;
337
- let released: Promise<void> | null = null;
338
-
339
- const changed = () => {
340
- for (const listener of [...listeners]) listener();
341
- };
342
-
343
- /** Settles with the first verdict `judge` gives: now, or after a later broker event; a fault fails it. */
344
- const verdict = <T>(judge: () => T | Error | null): Promise<T> =>
345
- new Promise((resolve, reject) => {
346
- const listener = () => {
347
- const result = faults.length > 0 ? new Error(`the counted Cargo broke: ${faults.join('; ')}`) : judge();
348
- if (result === null) return;
349
- listeners.delete(listener);
350
- if (result instanceof Error) reject(result);
351
- else resolve(result);
352
- };
353
- listeners.add(listener);
354
- listener();
355
- });
356
-
357
- /** Takes every step `child` may take now, in order; a child that has gone takes none. */
358
- const advance = (child: MetadataChild) => {
359
- if (child.departure !== null) return;
360
- if (child.phase === 'before-read' && !closed.read) {
361
- child.phase = 'reading';
362
- child.socket.write(encodeOrder({ kind: 'read', grandchild: leave, canned }));
363
- }
364
- if (child.phase === 'awaiting-grandchild') {
365
- const left = child.grandchild === null ? undefined : processes.get(child.grandchild);
366
- if (child.grandchild !== null && left?.role !== 'grandchild') return;
367
- if (child.grandchild !== null) events.push({ kind: 'grandchild', pid: child.grandchild });
368
- events.push({ kind: 'read', pid: child.pid });
369
- child.phase = 'before-answer';
370
- }
371
- if (child.phase === 'before-answer' && !closed.answer) {
372
- child.phase = 'answering';
373
- child.socket.write(encodeOrder({ kind: 'answer', failure }));
374
- }
375
- };
376
- const advanceAll = () => {
377
- for (const record of processes.values()) if (record.role === 'metadata') advance(record);
378
- changed();
379
- };
380
-
381
- /** What `report` makes of the connection that sent it: the process it registers, or the one it was. */
382
- const receive = (self: Registered | null, report: ProcessReport, socket: Socket): Registered | string => {
383
- if (self === null) {
384
- if (report.kind !== 'start' && report.kind !== 'grandchild') return `first report was ${report.kind}`;
385
- if (processes.has(report.pid)) return `pid ${report.pid} registered twice`;
386
- if (report.kind === 'start') {
387
- const child: MetadataChild = {
388
- role: 'metadata',
389
- pid: report.pid,
390
- socket,
391
- phase: 'before-read',
392
- grandchild: null,
393
- status: null,
394
- departure: null,
395
- error: null,
396
- };
397
- processes.set(child.pid, child);
398
- events.push({ kind: 'start', pid: child.pid });
399
- advance(child);
400
- return child;
401
- }
402
- const grandchild: Grandchild = {
403
- role: 'grandchild',
404
- pid: report.pid,
405
- parent: report.parent,
406
- socket,
407
- released: releasing,
408
- departure: null,
409
- error: null,
410
- };
411
- processes.set(grandchild.pid, grandchild);
412
- if (releasing) socket.end();
413
- const parent = processes.get(report.parent);
414
- if (parent?.role === 'metadata') advance(parent);
415
- return grandchild;
416
- }
417
- if (self.role === 'grandchild') return `grandchild ${self.pid} reported ${report.kind}`;
418
- if (report.kind === 'read' && self.phase === 'reading') {
419
- self.grandchild = report.grandchild;
420
- self.phase = 'awaiting-grandchild';
421
- advance(self);
422
- return self;
423
- }
424
- if (report.kind === 'end' && self.phase === 'answering') {
425
- self.phase = 'ended';
426
- self.status = report.status;
427
- events.push({ kind: 'end', pid: self.pid });
428
- return self;
429
- }
430
- return `child ${self.pid} reported ${report.kind} while ${self.phase}`;
431
- };
432
-
433
- const accept = (socket: Socket): void => {
434
- connections.add(socket);
435
- let self: Registered | null = null;
436
- const unterminated = readLines(socket, (line) => {
437
- const report = parseReport(line);
438
- const outcome = report instanceof Error ? report.message : receive(self, report, socket);
439
- if (typeof outcome === 'string') {
440
- faults.push(outcome);
441
- socket.destroy();
442
- } else {
443
- self = outcome;
444
- }
445
- changed();
446
- });
447
- socket.on('error', (error) => {
448
- // A process killed while the broker writes to it resets the connection; its close says the rest.
449
- if (self !== null) self.error = error.message;
450
- });
451
- socket.on('close', () => {
452
- connections.delete(socket);
453
- // A process that died mid-write leaves part of a line: evidence of how it died, not a broken broker.
454
- const tail = unterminated();
455
- if (tail !== '') torn.push(`${self === null ? 'unregistered' : `${self.role} ${self.pid}`}: ${tail}`);
456
- if (self !== null) {
457
- if (self.role === 'metadata') self.departure = self.phase === 'ended' ? 'ended' : 'vanished';
458
- else self.departure = self.released ? 'released' : 'vanished';
459
- }
460
- changed();
461
- });
462
- };
463
- // The children connect back to this listener, so it binds in the workspace's port block when it has
464
- // one: a port-0 listener binds there too, and then no sandboxed child can connect to it.
465
- const { server, port } = await bindListener((candidate) => listen(createServer(accept), candidate));
466
- server.on('close', () => {
467
- listening = false;
468
- changed();
469
- });
470
- // Only the processes it serves keep the test process alive, never the listener itself.
471
- server.unref();
472
-
473
- /** Everything the broker knows, for a guard that ran out of patience. */
474
- const describe = async (): Promise<string> => {
475
- const lines = [
476
- `counted Cargo broker ${BROKER_HOST}:${port}: ${listening ? 'listening' : 'closed'}${releasing ? ', releasing' : ''}`,
477
- `gates: before-read ${closed.read ? 'closed' : 'open'}, before-answer ${closed.answer ? 'closed' : 'open'}; ` +
478
- `failing: ${failure !== null}; leaving grandchildren: ${leave}`,
479
- `runs: ${JSON.stringify(cargoMetadataRuns(events))}`,
480
- `connections open: ${connections.size}`,
481
- ];
482
- for (const record of processes.values()) {
483
- const state = record.departure === null ? 'connected' : `gone (${record.departure})`;
484
- const socket = record.error === null ? '' : `, socket error: ${record.error}`;
485
- if (record.role === 'metadata') {
486
- lines.push(
487
- `metadata child ${record.pid}: ${record.phase}, ${state}, grandchild ${record.grandchild ?? 'none'}, ` +
488
- `status ${record.status ?? 'none'}${socket}`,
489
- );
490
- } else {
491
- let log: string;
492
- try {
493
- log = await readFile(join(directory, `grandchild-of-${record.parent}.log`), 'utf8');
494
- } catch (error) {
495
- log = `unreadable: ${error instanceof Error ? error.message : String(error)}`;
496
- }
497
- lines.push(`grandchild ${record.pid} of ${record.parent}: ${state}${socket}; log: ${JSON.stringify(log)}`);
498
- }
499
- }
500
- if (faults.length > 0) lines.push(`faults: ${faults.join('; ')}`);
501
- if (torn.length > 0) lines.push(`partial reports from processes that died: ${torn.join('; ')}`);
502
- return lines.join('\n');
503
- };
504
-
505
- /** SIGKILL `target` (a pid, or a negated process-group id); a target already gone is no failure. */
506
- const kill = (target: number, failures: string[]) => {
507
- try {
508
- process.kill(target, 'SIGKILL');
509
- } catch (error) {
510
- if (!(error instanceof Error && 'code' in error && error.code === 'ESRCH')) {
511
- failures.push(`kill ${target}: ${error instanceof Error ? error.message : String(error)}`);
512
- }
513
- }
514
- };
515
-
516
- const drain = async (): Promise<void> => {
517
- // Gates first, so every held child answers; then the grandchildren, which live until let go.
518
- releasing = true;
519
- closed.read = false;
520
- closed.answer = false;
521
- server.close();
522
- for (const record of processes.values()) {
523
- if (record.role === 'grandchild' && record.departure === null) {
524
- record.released = true;
525
- record.socket.end();
526
- }
527
- }
528
- advanceAll();
529
- try {
530
- await guardEvent(
531
- verdict(() => (connections.size === 0 ? true : null)),
532
- 'releasing the counted Cargo',
533
- describe,
534
- );
535
- } catch (error) {
536
- // A process still connected is still running, so its pid is still its own: kill it and, for a
537
- // child, the process group it leads (`readCargoResolve` starts each one detached), with whatever
538
- // real Cargo or grandchild is in it. Nothing the fixture started outlives a failed release.
539
- const failures: string[] = [];
540
- const killed: string[] = [];
541
- for (const record of processes.values()) {
542
- if (record.departure !== null) continue;
543
- if (record.role === 'metadata') kill(-record.pid, failures);
544
- kill(record.pid, failures);
545
- killed.push(`${record.role} ${record.pid}`);
546
- }
547
- for (const socket of connections) socket.destroy();
548
- const message = error instanceof Error ? error.message : String(error);
549
- throw new Error(
550
- `${message}\nkilled: [${killed.join(', ')}]${failures.length > 0 ? `; kill failures: ${failures.join('; ')}` : ''}`,
551
- { cause: error },
552
- );
553
- }
554
- };
555
-
556
- await mkdir(bin, { recursive: true });
557
- await writeFile(
558
- join(bin, 'cargo'),
559
- [
560
- '#!/bin/sh',
561
- // Delegate with the caller's original search path: nothing the real Cargo starts may resolve this shim again.
562
- `export PATH=${quote(path)}`,
563
- `real=${quote(real)}`,
564
- `if [ "$1" != metadata ]; then ${forward}; fi`,
565
- `exec ${quote(process.execPath)} ${quote(PROGRAM)} metadata ${port} "$real" ${quote(directory)} "$@"`,
566
- '',
567
- ].join('\n'),
568
- );
569
- await chmod(join(bin, 'cargo'), 0o755);
570
-
571
- const latch = (gate: 'read' | 'answer'): Latch => ({
572
- close: async () => {
573
- closed[gate] = true;
574
- },
575
- open: async () => {
576
- closed[gate] = false;
577
- advanceAll();
578
- },
579
- });
580
- const cargo: CountedCargo = {
581
- bin,
582
- environment: {
583
- PATH: `${bin}${delimiter}${path}`,
584
- NX_WORKSPACE_DATA_DIRECTORY: join(root, '.nx/workspace-data'),
585
- },
586
- beforeRead: latch('read'),
587
- beforeAnswer: latch('answer'),
588
- failWith: async (stderr) => {
589
- failure = stderr;
590
- },
591
- recover: async () => {
592
- failure = null;
593
- },
594
- leaveGrandchildren: async (value) => {
595
- leave = value;
596
- },
597
- runs: async () => cargoMetadataRuns(events),
598
- waitForRuns: (predicate, what) =>
599
- guardEvent(
600
- verdict(() => {
601
- const runs = cargoMetadataRuns(events);
602
- return predicate(runs) ? runs : null;
603
- }),
604
- `waiting for ${what}`,
605
- describe,
606
- ),
607
- waitForDisconnects: async (pids) => {
608
- await guardEvent(
609
- verdict(() => {
610
- const unknown = pids.filter((pid) => !processes.has(pid));
611
- if (unknown.length > 0) return new Error(`never connected to the counted Cargo: ${unknown.join(', ')}`);
612
- const records = pids.flatMap((pid) => processes.get(pid) ?? []);
613
- const survived = records.filter((record) => record.departure !== null && record.departure !== 'vanished');
614
- if (survived.length > 0) {
615
- const which = survived.map((record) => `${record.role} ${record.pid} (${record.departure})`);
616
- return new Error(`expected to die, but finished: ${which.join(', ')}`);
617
- }
618
- return records.every((record) => record.departure === 'vanished') ? true : null;
619
- }),
620
- `waiting for ${pids.join(', ')} to die`,
621
- describe,
622
- );
623
- },
624
- release: () => {
625
- released ??= drain();
626
- return released;
627
- },
628
- };
629
- return {
630
- cargo,
631
- answer: (text) => {
632
- canned = text;
633
- },
634
- };
635
- }
636
-
637
- /** The real Cargo, counted: `metadata` prints what the real `cargo metadata` prints. */
638
- export async function countedCargo(root: string): Promise<CountedCargo> {
639
- const { cargo } = await shim(root, 'exec "$real" "$@"', null);
640
- return cargo;
641
- }
642
-
643
- /**
644
- * A Cargo whose `metadata` prints whatever the test says, whatever is on disk: the cache's own behavior,
645
- * alone. Its other subcommands run the real Cargo under no rustup selection, which the canned answers do
646
- * not depend on.
647
- */
648
- export async function cannedCargo(root: string): Promise<CannedCargo> {
649
- const { cargo, answer } = await shim(root, 'exec env -u RUSTUP_TOOLCHAIN -u RUSTUP_HOME "$real" "$@"', '');
650
- return {
651
- ...cargo,
652
- answerWith: async (document) => answer(JSON.stringify(document)),
653
- answerWithText: async (text) => answer(text),
654
- };
655
- }
656
-
657
- /** `body` with `overrides` in this process's environment, which the module's Cargo children inherit. */
658
- export async function withEnvironment<T>(
659
- overrides: Readonly<Record<string, string>>,
660
- body: () => Promise<T>,
661
- ): Promise<T> {
662
- const saved = Object.keys(overrides).map((key): [string, string | undefined] => [key, process.env[key]]);
663
- Object.assign(process.env, overrides);
664
- try {
665
- return await body();
666
- } finally {
667
- for (const [key, value] of saved) {
668
- if (value === undefined) delete process.env[key];
669
- else process.env[key] = value;
670
- }
671
- }
672
- }
673
-
674
- /** The error `promise` rejects with; a promise that resolves fails the test. */
675
- export async function rejectionOf(promise: Promise<unknown>): Promise<unknown> {
676
- try {
677
- await promise;
678
- } catch (error) {
679
- return error;
680
- }
681
- throw new Error('expected a rejection, but the promise resolved');
682
- }
683
-
684
- /** The typed Cargo refusal, including the requested manifest and the original failure. */
685
- export function expectCargoMetadataError(error: unknown, manifestPath: string): CargoMetadataError {
686
- expect(error).toBeInstanceOf(CargoMetadataError);
687
- if (!(error instanceof CargoMetadataError)) throw new Error(`expected a CargoMetadataError, got ${String(error)}`);
688
- expect(error.name).toBe('CargoMetadataError');
689
- expect(error.manifestPath).toBe(manifestPath);
690
- expect(error.cause).toBeInstanceOf(Error);
691
- return error;
692
- }
693
-
694
- /** `failure` is the whole refusal of a project-graph computation: Nx's aggregate of the per-file errors. */
695
- export function aggregateOf(failure: unknown): AggregateCreateNodesError {
696
- if (!(failure instanceof AggregateCreateNodesError)) {
697
- throw new Error(`expected the graph computation to fail as an aggregate, got ${String(failure)}`);
698
- }
699
- return failure;
700
- }
701
-
702
- /**
703
- * `failure` is a project-graph computation refused for want of a Cargo resolution: an aggregate whose
704
- * every error is the typed `CargoMetadataError` for the workspace manifest `manifestPath`, and which
705
- * carries no partial result a runtime hash of the whole workspace could have filled.
706
- */
707
- export function expectGraphRefusal(failure: unknown, manifestPath: string): AggregateCreateNodesError {
708
- const aggregate = aggregateOf(failure);
709
- expect(aggregate.errors.length).toBeGreaterThan(0);
710
- for (const [, error] of aggregate.errors) expectCargoMetadataError(error, manifestPath);
711
- expect(JSON.stringify(aggregate.partialResults)).not.toContain('--include-workspace');
712
- return aggregate;
713
- }