@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
@@ -0,0 +1,119 @@
1
+ diff --git a/node_modules/ttsc/driver/force_emit_analysis_options_test.go b/driver/force_emit_analysis_options_test.go
2
+ new file mode 100644
3
+ index 0000000000000000000000000000000000000000..97d1522f7979b488dc62b86cc1d78d72f1913cb5
4
+ --- /dev/null
5
+ +++ b/driver/force_emit_analysis_options_test.go
6
+ @@ -0,0 +1,69 @@
7
+ +package driver
8
+ +
9
+ +import (
10
+ + "os"
11
+ + "path/filepath"
12
+ + "strings"
13
+ + "testing"
14
+ +
15
+ + shimast "github.com/microsoft/typescript-go/shim/ast"
16
+ + shimcompiler "github.com/microsoft/typescript-go/shim/compiler"
17
+ + shimprinter "github.com/microsoft/typescript-go/shim/printer"
18
+ +)
19
+ +
20
+ +func TestForceEmitRewritesAnalysisOnlyImports(t *testing.T) {
21
+ + root, err := filepath.EvalSymlinks(t.TempDir())
22
+ + if err != nil {
23
+ + t.Fatal(err)
24
+ + }
25
+ + files := map[string]string{
26
+ + "tsconfig.json": `{"compilerOptions":{"target":"ES2022","module":"ESNext","moduleResolution":"Bundler","types":[],"strict":true,"noEmit":true,"noEmitOnError":true,"allowImportingTsExtensions":true,"outDir":"out"},"files":["index.ts","dependency.ts"]}`,
27
+ + "dependency.ts": `export const value = 7;`,
28
+ + "index.ts": `import { value } from "./dependency.ts"; export const result = value;`,
29
+ + }
30
+ + for name, text := range files {
31
+ + if err := os.WriteFile(filepath.Join(root, name), []byte(text), 0o644); err != nil {
32
+ + t.Fatal(err)
33
+ + }
34
+ + }
35
+ + analysis, diagnostics, err := LoadProgram(root, "tsconfig.json", LoadProgramOptions{})
36
+ + if err != nil || CountErrors(diagnostics) != 0 {
37
+ + t.Fatalf("analysis load failed: %v; %v", err, diagnostics)
38
+ + }
39
+ + defer analysis.Close()
40
+ + if diagnostics := analysis.Diagnostics(); CountErrors(diagnostics) != 0 {
41
+ + t.Fatalf("valid analysis-only imports failed checking: %v", diagnostics)
42
+ + }
43
+ + diagnostics, err = analysis.EmitWithPluginTransformer(
44
+ + func(_ *shimprinter.EmitContext, source *shimast.SourceFile) *shimast.SourceFile {
45
+ + t.Fatal("analysis-only program ran a JavaScript emit hook")
46
+ + return source
47
+ + },
48
+ + func(name, text string, _ *shimcompiler.WriteFileData) error {
49
+ + t.Fatalf("analysis-only program wrote %s", name)
50
+ + return nil
51
+ + },
52
+ + )
53
+ + if err != nil || CountErrors(diagnostics) != 0 {
54
+ + t.Fatalf("analysis-only emit failed: %v; %v", err, diagnostics)
55
+ + }
56
+ + emitting, diagnostics, err := LoadProgram(root, "tsconfig.json", LoadProgramOptions{ForceEmit: true})
57
+ + if err != nil || CountErrors(diagnostics) != 0 {
58
+ + t.Fatalf("forced emit load failed: %v; %v", err, diagnostics)
59
+ + }
60
+ + defer emitting.Close()
61
+ + output := make(map[string]string)
62
+ + diagnostics, err = emitting.EmitWithPluginTransformer(
63
+ + func(_ *shimprinter.EmitContext, source *shimast.SourceFile) *shimast.SourceFile { return source },
64
+ + func(name, text string, _ *shimcompiler.WriteFileData) error {
65
+ + output[filepath.Base(name)] = text
66
+ + return nil
67
+ + },
68
+ + )
69
+ + if err != nil || CountErrors(diagnostics) != 0 {
70
+ + t.Fatalf("forced emit rejected analysis-only imports: %v; %v", err, diagnostics)
71
+ + }
72
+ + if !strings.Contains(output["index.js"], `from "./dependency.js"`) {
73
+ + t.Fatalf("forced emit did not rewrite the runtime import: %s", output["index.js"])
74
+ + }
75
+ +}
76
+ diff --git a/driver/program.go b/driver/program.go
77
+ index f6ee81fb1af41deea022b92e838a7c4665eb9778..112faf913ce38b1f4624b38db37839370b9c5e8b 100644
78
+ --- a/driver/program.go
79
+ +++ b/driver/program.go
80
+ @@ -738,6 +738,12 @@ func forceEmit(parsed *tsoptions.ParsedCommandLine) {
81
+ options := parsed.ParsedConfig.CompilerOptions
82
+ options.NoEmit = core.TSFalse
83
+ options.EmitDeclarationOnly = core.TSFalse
84
+ + // Match the CLI's --emit override: TypeScript-extension imports must become
85
+ + // JavaScript-extension imports when an analysis-only program is emitted,
86
+ + // including private plugin traversals whose caller discards the output.
87
+ + if options.AllowImportingTsExtensions.IsTrue() {
88
+ + options.RewriteRelativeImportExtensions = core.TSTrue
89
+ + }
90
+ }
91
+
92
+ // forceNoEmit sets noEmit so the program type-checks without writing files.
93
+ diff --git a/lib/plugin/internal/source/PluginBuildEnvironmentReadings.js b/lib/plugin/internal/source/PluginBuildEnvironmentReadings.js
94
+ --- a/lib/plugin/internal/source/PluginBuildEnvironmentReadings.js
95
+ +++ b/lib/plugin/internal/source/PluginBuildEnvironmentReadings.js
96
+ @@ -20,10 +20,10 @@
97
+ * Cold asynchronous reads run in an exclusively owned worker. Its complete
98
+ * environment snapshot is passed explicitly to the native reader. Publication
99
+ * rechecks both current host variables and external witnesses after transfer.
100
+ - * The worker reads the parent's shared environment for native fallback rules;
101
+ - * neither it nor this owner writes that environment. Explicit reader inputs
102
+ - * still use the request snapshot and publication still qualifies that
103
+ - * snapshot.
104
+ + * The worker keeps the environment copy it started with, never SHARE_ENV:
105
+ + * Bun replaces the parent's process.env object for SHARE_ENV, stranding every
106
+ + * module that captured the old one (node:os tmpdir() among them). Explicit
107
+ + * reader inputs use the request snapshot, which publication qualifies.
108
+ *
109
+ * @evidence contracts/common.md#principled-implementation Readings pair complete environment identity with the producer's native pre-read witness; cached reuse validates that witness and asynchronous publication rechecks variables/witness after transfer. Synchronous fresh reads publish their paired observations without an extra post-read holds call here; native metadata distinguishability remains a premise.
110
+ * @evidence contracts/common.md#clear-and-simple-design One owner shares observation records across synchronous reads, cache-only proof and asynchronous preparation.
111
+ @@ -253,7 +253,7 @@
112
+ function acquireWorker() {
113
+ if (worker !== undefined)
114
+ return worker;
115
+ - const created = new node_worker_threads_1.Worker((0, workerModuleUrl_1.workerModuleUrl)(node_path_1.default.join(__dirname, `pluginBuildEnvironmentWorker${node_path_1.default.extname(__filename)}`)), { env: node_worker_threads_1.SHARE_ENV });
116
+ + const created = new node_worker_threads_1.Worker((0, workerModuleUrl_1.workerModuleUrl)(node_path_1.default.join(__dirname, `pluginBuildEnvironmentWorker${node_path_1.default.extname(__filename)}`)), {});
117
+ worker = created;
118
+ const retire = () => {
119
+ if (worker === created)
@@ -0,0 +1,245 @@
1
+ /**
2
+ * The bound on `cargo fetch --locked`, as decisions over facts, and the choice of where its stamp lives. Pure: no
3
+ * clock, no process, no environment and no file of its own. cargo-fetch-run.ts is the shell that measures time,
4
+ * spawns, signals and reads the environment, and asks here what to do; setup-environment.ts reports what comes back.
5
+ *
6
+ * While `cargo fetch` runs it holds Cargo's global package-cache lock, `$CARGO_HOME/.package-cache`, and every other
7
+ * cargo that shares the CARGO_HOME waits behind it. Git has no low-speed limit unless one is configured, so the fetch of
8
+ * a git dependency whose connection stalls holds that lock for as long as the connection stays up. A fetch therefore has
9
+ * two bounds:
10
+ *
11
+ * - git drops a transfer that has all but stopped for GIT_HTTP_LOW_SPEED_TIME_S seconds (`boundedFetchEnv`). Cargo runs
12
+ * the `git` executable for git dependencies unless `net.git-fetch-with-cli = false`, so this reaches the HTTP(S)
13
+ * transfers of its fetches and not an ssh or git-protocol one, nor Cargo's own git library; and
14
+ * - the fetch's whole process group is killed when its deadline passes (`judgeBound`), and killed again while the
15
+ * group still has members (`judgeReap`), which bounds whatever the first does not reach.
16
+ *
17
+ * This file is a managed raw script like secret-references.ts: shell entry loads it before anything is installed, so
18
+ * it imports only the runtime's path functions.
19
+ */
20
+ import { isAbsolute, join } from 'node:path';
21
+
22
+ /**
23
+ * The longest one `cargo fetch --locked` may run. It is the bound the Nx plugin puts on each Cargo child of project-graph
24
+ * resolution (CARGO_RESOLVE_BOUND_MS), for the same reason: a Cargo wait without a bound stops every Cargo behind it.
25
+ */
26
+ export const CARGO_FETCH_DEADLINE_MS = 300_000;
27
+
28
+ /**
29
+ * Names a deadline shorter than CARGO_FETCH_DEADLINE_MS, in whole milliseconds. It only shortens: a fetch that needs
30
+ * longer is failing, and the cure is its network, not a longer hold on the lock.
31
+ */
32
+ export const CARGO_FETCH_DEADLINE_ENV = 'SMOO_CARGO_FETCH_DEADLINE_MS';
33
+
34
+ /**
35
+ * Git's low-speed abort, which git leaves off: a transfer that moves under this many bytes a second for
36
+ * GIT_HTTP_LOW_SPEED_TIME_S seconds is dropped. One byte a second is the least git accepts (it ignores 0), so only a
37
+ * transfer that has all but stopped is dropped, and one that is slow but moving is not. A server that prepares a pack
38
+ * in silence sends only a five-byte keepalive every five seconds (`uploadpack.keepAlive`), which is under the limit
39
+ * too: that silence counts as the stall it looks like once the window has passed.
40
+ */
41
+ export const GIT_HTTP_LOW_SPEED_LIMIT = 1;
42
+
43
+ /**
44
+ * The window of the limit, in seconds. It has to outlast the pack a server may prepare in silence, since Cargo runs
45
+ * `git fetch --quiet` and the server then sends nothing else until the pack starts. A stall is dropped this long after
46
+ * its last byte, and up to five seconds later, because libcurl averages the speed over five seconds.
47
+ */
48
+ export const GIT_HTTP_LOW_SPEED_TIME_S = 60;
49
+
50
+ export type FetchDeadline =
51
+ | { readonly kind: 'deadline'; readonly ms: number }
52
+ | { readonly kind: 'refused'; readonly message: string };
53
+
54
+ const WHOLE_MILLISECONDS = /^[1-9][0-9]*$/;
55
+
56
+ /** The deadline `raw`, the value of CARGO_FETCH_DEADLINE_ENV, asks for, or why it asks for none. Unset is the default. */
57
+ export function fetchDeadline(raw: string | undefined): FetchDeadline {
58
+ if (raw === undefined) return { kind: 'deadline', ms: CARGO_FETCH_DEADLINE_MS };
59
+ const ms = WHOLE_MILLISECONDS.test(raw) ? Number(raw) : Number.NaN;
60
+ if (!Number.isSafeInteger(ms)) {
61
+ return {
62
+ kind: 'refused',
63
+ message: `${CARGO_FETCH_DEADLINE_ENV}=${JSON.stringify(raw)} is not a positive whole number of milliseconds`,
64
+ };
65
+ }
66
+ if (ms > CARGO_FETCH_DEADLINE_MS) {
67
+ return {
68
+ kind: 'refused',
69
+ message: `${CARGO_FETCH_DEADLINE_ENV}=${raw} would lengthen the ${CARGO_FETCH_DEADLINE_MS} ms deadline; it only shortens it`,
70
+ };
71
+ }
72
+ return { kind: 'deadline', ms };
73
+ }
74
+
75
+ /**
76
+ * The environment the fetch runs in: `env` with git's low-speed limit set. Cargo runs `git fetch` for git dependencies
77
+ * and git reads these variables ahead of its configuration, so a limit the caller or a git config already holds gives
78
+ * way to this one: the bound is the step's, not the ambient environment's. The variables are carried as own properties
79
+ * (`Object.fromEntries`, a spread): assigning by name would lose one called `__proto__`.
80
+ */
81
+ export function boundedFetchEnv(env: Readonly<Record<string, string | undefined>>): Record<string, string> {
82
+ const carried = Object.entries(env).filter((entry): entry is [string, string] => entry[1] !== undefined);
83
+ return {
84
+ ...Object.fromEntries(carried),
85
+ GIT_HTTP_LOW_SPEED_LIMIT: String(GIT_HTTP_LOW_SPEED_LIMIT),
86
+ GIT_HTTP_LOW_SPEED_TIME: String(GIT_HTTP_LOW_SPEED_TIME_S),
87
+ };
88
+ }
89
+
90
+ /**
91
+ * Smoo's directory in the user cache, below which a fetch keeps its stamp. The stamp cannot live in CARGO_HOME: a
92
+ * sandboxed shell may write only Cargo's own paths there, and the user cache is the shell's own. It is
93
+ * `$XDG_CACHE_HOME/smoo`, or `<home>/.cache/smoo` when the variable is unset, empty or not an absolute path, as the XDG
94
+ * base directory rule has it: a relative value is invalid and is ignored. The shell reads both facts, the variable's
95
+ * value (`xdgCacheHome`) and the user's home directory (`home`).
96
+ */
97
+ export function smooCacheDirectory(xdgCacheHome: string | undefined, home: string): string {
98
+ const cacheHome = xdgCacheHome !== undefined && isAbsolute(xdgCacheHome) ? xdgCacheHome : join(home, '.cache');
99
+ return join(cacheHome, 'smoo');
100
+ }
101
+
102
+ /** What the shell knows about the command when it asks for a verdict. */
103
+ export interface BoundFacts {
104
+ /** The deadline, in milliseconds after the command started. */
105
+ readonly deadlineMs: number;
106
+ /** Milliseconds since the command started, read by the shell from its clock. */
107
+ readonly elapsedMs: number;
108
+ /** The command has exited and closed its output. */
109
+ readonly finished: boolean;
110
+ }
111
+
112
+ export type BoundVerdict =
113
+ | { readonly kind: 'finished' }
114
+ /** Ask again after this many milliseconds, or when the command finishes. */
115
+ | { readonly kind: 'wait'; readonly forMs: number }
116
+ /** Kill the command and its process group. */
117
+ | { readonly kind: 'kill' };
118
+
119
+ /**
120
+ * What to do about a command now. A finished command is left alone however late it finished. A running one is waited
121
+ * for until its deadline and killed from then on. Time that is not a number before a finite deadline is a command past
122
+ * it: no input makes the wait unbounded.
123
+ */
124
+ export function judgeBound({ deadlineMs, elapsedMs, finished }: BoundFacts): BoundVerdict {
125
+ if (finished) return { kind: 'finished' };
126
+ const forMs = deadlineMs - elapsedMs;
127
+ if (forMs > 0 && Number.isFinite(forMs)) return { kind: 'wait', forMs };
128
+ return { kind: 'kill' };
129
+ }
130
+
131
+ /**
132
+ * How long the shell goes on killing a process group: it signals the group at most `rounds` times and waits
133
+ * `pauseMs` milliseconds after each.
134
+ */
135
+ export interface Patience {
136
+ readonly rounds: number;
137
+ readonly pauseMs: number;
138
+ }
139
+
140
+ /**
141
+ * For a kill on the way out of this process, which can wait for nothing and should hold the exit up for as little as it
142
+ * can: signals a millisecond apart, thirty at most. Rounds with no pause do not do it: a fork already under way when
143
+ * the first signal goes out joins the group after they have all run.
144
+ */
145
+ export const TEARDOWN_PATIENCE: Patience = { rounds: 30, pauseMs: 1 };
146
+
147
+ /**
148
+ * For the kill at the deadline, whose outcome is told: signals 5 ms apart for up to two seconds, the time the
149
+ * bounded-exec executor allows a force-killed command to be reaped. A host under load can take that long to finish
150
+ * exiting what it was sent, and the group lists a member until it has.
151
+ */
152
+ export const DEADLINE_PATIENCE: Patience = { rounds: 400, pauseMs: 5 };
153
+
154
+ /** What the shell knows of the group when it asks whether to signal it again. */
155
+ export interface ReapFacts {
156
+ /** Signals sent to the group so far. */
157
+ readonly round: number;
158
+ readonly patience: Patience;
159
+ /** The kernel still lists a member of the group. */
160
+ readonly members: boolean;
161
+ }
162
+
163
+ export type ReapVerdict =
164
+ /** Nothing is left in the group. */
165
+ | { readonly kind: 'empty' }
166
+ /** Signal the group again. */
167
+ | { readonly kind: 'signal' }
168
+ /** The patience is spent and the group still lists members. */
169
+ | { readonly kind: 'members-left' };
170
+
171
+ /**
172
+ * Whether to signal a group again. A group signal reaches the members that exist when it goes out, and macOS does not
173
+ * hold a fork back while it does: a member forked in that moment is missed, and so is one that member forks next. A
174
+ * group with members is therefore signalled again, until it has none or the patience is spent. Patience that is not a
175
+ * positive finite number of rounds ahead is spent, so no input makes the signalling unbounded.
176
+ */
177
+ export function judgeReap({ round, patience, members }: ReapFacts): ReapVerdict {
178
+ if (!members) return { kind: 'empty' };
179
+ const roundsLeft = patience.rounds - round;
180
+ return roundsLeft > 0 && Number.isFinite(roundsLeft) ? { kind: 'signal' } : { kind: 'members-left' };
181
+ }
182
+
183
+ /** What is told of a process group that its kill could not empty. */
184
+ export function describeMembersLeft(group: number): string {
185
+ return [
186
+ `process group ${group} still had members when the kill gave up: one that left the group is beyond a group kill,`,
187
+ 'and one that exited and has not been reaped yet looks the same.',
188
+ ].join(' ');
189
+ }
190
+
191
+ /** What the failure of a command that outlived its deadline is told. */
192
+ export interface DeadlineFacts {
193
+ /** The command as a person would type it. */
194
+ readonly command: string;
195
+ readonly deadlineMs: number;
196
+ readonly elapsedMs: number;
197
+ /** Cargo's package-cache lock file, which the command held while it ran. */
198
+ readonly lockPath: string;
199
+ /** The process group the command ran in. */
200
+ readonly group: number;
201
+ /** The kill stopped signalling with the group still listing members (`judgeReap`'s `members-left`). */
202
+ readonly membersLeft: boolean;
203
+ }
204
+
205
+ /**
206
+ * The failure of a command that outlived its deadline, naming the command and the lock it held. A group kill reaches
207
+ * the process group and nothing beyond it, so the failure says the group was killed, and no more than that.
208
+ */
209
+ export function describeDeadline({
210
+ command,
211
+ deadlineMs,
212
+ elapsedMs,
213
+ lockPath,
214
+ group,
215
+ membersLeft,
216
+ }: DeadlineFacts): string {
217
+ const killed = membersLeft ? `killed, but ${describeMembersLeft(group)}` : 'killed with its whole process group.';
218
+ return [
219
+ `${command} was still running ${elapsedMs} ms after it started, past its ${deadlineMs} ms deadline, and was`,
220
+ `${killed} While it runs it holds Cargo's package-cache lock (${lockPath}), which makes`,
221
+ 'every other cargo that shares this CARGO_HOME wait behind it, so a stalled fetch is ended rather than waited out.',
222
+ "Cargo's output up to the kill follows.",
223
+ ].join('\n');
224
+ }
225
+
226
+ /** What a kill made on the way out has to tell: the call is ending or failing, so no failure of its own carries it. */
227
+ export interface TeardownFacts {
228
+ /** The command as a person would type it. */
229
+ readonly command: string;
230
+ /** The process group the command ran in, which the kernel still listed when the kill gave up. */
231
+ readonly group: number;
232
+ }
233
+
234
+ /**
235
+ * The line a kill on the way out leaves on stderr when the group is still listed. This process can wait for nothing
236
+ * there, not even for its command's leader to be reaped, and the kernel lists the leader as a member of its own group
237
+ * until then. So what is left is listed, and not known to be running.
238
+ */
239
+ export function describeTeardown({ command, group }: TeardownFacts): string {
240
+ return [
241
+ `While ending ${command}, process group ${group} was still listed when the kill gave up;`,
242
+ 'whether a process in it still runs is unconfirmed, because its leader is listed until this process reaps it,',
243
+ 'which it cannot do while it is ending.',
244
+ ].join(' ');
245
+ }
@@ -0,0 +1,299 @@
1
+ /**
2
+ * The imperative shell around cargo-fetch-bound.ts: it spawns the command in a process group of its own, reads its
3
+ * output, keeps the clock, and kills the group when cargo-fetch-bound.ts says the deadline has passed, and again while
4
+ * the group still has members. Every decision is that file's; this one only measures and acts.
5
+ *
6
+ * The command runs detached (`setsid`), so a signal that ends this process no longer reaches it the way a terminal's
7
+ * would. The shell therefore ends the group itself when this process is ending (a SIGINT, SIGTERM or SIGHUP, or exit),
8
+ * and a fetch never outlives the step that started it. Like secret-references.ts this is a managed raw script that
9
+ * shell entry loads before anything is installed, so it imports only the runtime and its sibling.
10
+ */
11
+ import { writeSync } from 'node:fs';
12
+ import { constants } from 'node:os';
13
+ import {
14
+ DEADLINE_PATIENCE,
15
+ describeTeardown,
16
+ judgeBound,
17
+ judgeReap,
18
+ type Patience,
19
+ TEARDOWN_PATIENCE,
20
+ } from './cargo-fetch-bound.ts';
21
+
22
+ /** The shell's two uses of time, so a caller can move it by hand. */
23
+ export interface Clock {
24
+ /** Milliseconds on a scale that only moves forward; its differences are the elapsed time. */
25
+ now(): number;
26
+ /** Calls `wake` after `ms` milliseconds unless the returned function cancels it first. */
27
+ after(ms: number, wake: () => void): () => void;
28
+ }
29
+
30
+ export const systemClock: Clock = {
31
+ now: () => performance.now(),
32
+ after: (ms, wake) => {
33
+ const timer = setTimeout(wake, ms);
34
+ return () => clearTimeout(timer);
35
+ },
36
+ };
37
+
38
+ export interface BoundedCommand {
39
+ readonly argv: readonly string[];
40
+ readonly cwd: string;
41
+ readonly env: Readonly<Record<string, string>>;
42
+ readonly deadlineMs: number;
43
+ /** Copy the output to this process's own as it arrives, besides capturing it. */
44
+ readonly echo: boolean;
45
+ }
46
+
47
+ export type BoundedOutcome =
48
+ /** The command ended on its own; a signal that ended it is reported as a shell does, 128 plus its number. */
49
+ | { readonly kind: 'exited'; readonly exitCode: number; readonly stdout: Uint8Array; readonly stderr: Uint8Array }
50
+ /**
51
+ * The deadline passed with the command still running: it and its process group were killed. The output is what was
52
+ * read before the kill. `membersLeft` is whether the kernel still listed members of process group `group` when the
53
+ * kill stopped signalling it: a member that left the group is beyond the kill's reach.
54
+ */
55
+ | {
56
+ readonly kind: 'expired';
57
+ readonly elapsedMs: number;
58
+ readonly group: number;
59
+ readonly membersLeft: boolean;
60
+ readonly stdout: Uint8Array;
61
+ readonly stderr: Uint8Array;
62
+ };
63
+
64
+ /** The signals that end this process and so must end the command with it. */
65
+ const TEARDOWN_SIGNALS = ['SIGINT', 'SIGTERM', 'SIGHUP'] as const;
66
+
67
+ /**
68
+ * Runs `command` and returns how it ended. Failure to start it rejects; so does a failure to read its output, after
69
+ * the group is killed. Whatever way this returns or throws, the group is killed on every path but the command ending
70
+ * itself, and killed again while it still has members (`reapGroup`). What a kill on the way out leaves is said on
71
+ * stderr, and what the deadline's leaves is in the outcome.
72
+ */
73
+ export async function runBounded(command: BoundedCommand, clock: Clock = systemClock): Promise<BoundedOutcome> {
74
+ const commandLine = command.argv.join(' ');
75
+ let group: number | undefined;
76
+ // The kill on the paths where nobody reads an outcome: this process is ending, or the call is failing. Nothing can be
77
+ // awaited there, not even the leader's exit, and until this process reaps it the kernel lists the leader as a member
78
+ // of its own group. So the kill cannot tell a member it missed from the leader, and what it leaves is said as listed,
79
+ // not as running.
80
+ const endGroup = (): void => {
81
+ if (group === undefined) return;
82
+ try {
83
+ if (reapGroup(group, TEARDOWN_PATIENCE)) tell(describeTeardown({ command: commandLine, group }));
84
+ } catch (error) {
85
+ const reason = error instanceof Error ? error.message : String(error);
86
+ tell(`${commandLine} could not be ended on the way out: ${reason}`);
87
+ }
88
+ };
89
+ // The hooks come before the spawn: a signal that arrives from the spawn on runs its handler after this synchronous
90
+ // body, by which time the group is known.
91
+ const release = endWithThisProcess(endGroup);
92
+ try {
93
+ const child = Bun.spawn({
94
+ cmd: [...command.argv],
95
+ cwd: command.cwd,
96
+ env: { ...command.env },
97
+ stdin: 'ignore',
98
+ stdout: 'pipe',
99
+ stderr: 'pipe',
100
+ detached: true,
101
+ });
102
+ group = child.pid;
103
+ const stdout: Uint8Array[] = [];
104
+ const stderr: Uint8Array[] = [];
105
+ const stdoutReader = child.stdout.getReader();
106
+ const stderrReader = child.stderr.getReader();
107
+ let finished = false;
108
+ const done = Promise.all([
109
+ child.exited,
110
+ pump(stdoutReader, stdout, command.echo ? (chunk) => process.stdout.write(chunk) : null),
111
+ pump(stderrReader, stderr, command.echo ? (chunk) => process.stderr.write(chunk) : null),
112
+ ]).then(() => {
113
+ finished = true;
114
+ });
115
+ const started = clock.now();
116
+ for (;;) {
117
+ const elapsedMs = clock.now() - started;
118
+ const verdict = judgeBound({ deadlineMs: command.deadlineMs, elapsedMs, finished });
119
+ switch (verdict.kind) {
120
+ case 'finished':
121
+ return {
122
+ kind: 'exited',
123
+ exitCode: statusOf(child),
124
+ stdout: Buffer.concat(stdout),
125
+ stderr: Buffer.concat(stderr),
126
+ };
127
+ case 'kill': {
128
+ // Until it is reaped the leader is a member of its own group, and reapGroup looks for members the kill
129
+ // missed: the leader's exit is awaited before the group is asked about.
130
+ signalGroup(child.pid);
131
+ await child.exited;
132
+ const membersLeft = reapGroup(child.pid, DEADLINE_PATIENCE);
133
+ return {
134
+ kind: 'expired',
135
+ elapsedMs,
136
+ group: child.pid,
137
+ membersLeft,
138
+ stdout: Buffer.concat(stdout),
139
+ stderr: Buffer.concat(stderr),
140
+ };
141
+ }
142
+ case 'wait':
143
+ await untilFinishedOrAfter(done, clock, verdict.forMs);
144
+ }
145
+ }
146
+ } catch (error) {
147
+ endGroup();
148
+ throw error;
149
+ } finally {
150
+ release();
151
+ }
152
+ }
153
+
154
+ /** Resolves when `done` does, or `ms` after now on `clock`, whichever is first, leaving no timer behind. */
155
+ async function untilFinishedOrAfter(done: Promise<void>, clock: Clock, ms: number): Promise<void> {
156
+ const { promise: elapsed, resolve } = Promise.withResolvers<void>();
157
+ const cancel = clock.after(ms, resolve);
158
+ try {
159
+ await Promise.race([done, elapsed]);
160
+ } finally {
161
+ cancel();
162
+ }
163
+ }
164
+
165
+ /** What the shell asks of the reader of a piped stream: the part every typing of the runtime's readers shares. */
166
+ interface PipeReader {
167
+ read(): Promise<{ readonly done: boolean; readonly value?: Uint8Array }>;
168
+ }
169
+
170
+ /** Copies a stream to `sink`, and to `echo` when there is one, until it ends. */
171
+ async function pump(reader: PipeReader, sink: Uint8Array[], echo: ((chunk: Uint8Array) => void) | null): Promise<void> {
172
+ for (;;) {
173
+ const { done, value } = await reader.read();
174
+ if (done) return;
175
+ if (value !== undefined) {
176
+ sink.push(value);
177
+ echo?.(value);
178
+ }
179
+ }
180
+ }
181
+
182
+ /** The exit status of a command that has exited: its own, or a shell's 128 plus the number of the signal that ended it. */
183
+ function statusOf(child: {
184
+ readonly exitCode: number | null;
185
+ readonly signalCode: NodeJS.Signals | number | null;
186
+ }): number {
187
+ if (child.exitCode !== null) return child.exitCode;
188
+ const signal = child.signalCode;
189
+ if (typeof signal === 'number') return 128 + signal;
190
+ // invariant: a command that has exited has an exit code or the signal that ended it.
191
+ if (signal === null) throw new Error('an exited command reports neither an exit code nor a signal');
192
+ return 128 + constants.signals[signal];
193
+ }
194
+
195
+ /** The errno code of a failed system call, when it has one. */
196
+ function errorCode(error: unknown): string | undefined {
197
+ return error instanceof Error && 'code' in error && typeof error.code === 'string' ? error.code : undefined;
198
+ }
199
+
200
+ /**
201
+ * SIGKILL to every process of the group led by `pgid`. A group that is already gone is not an error, nor is one with no
202
+ * member left that can be signalled. Nothing is asked to stop first: a fetch past its deadline is stalled, a member
203
+ * that ignores SIGTERM would go on holding the package-cache lock, and a kill costs a fetch nothing it relies on (the
204
+ * kernel drops the lock, and Cargo's caches tolerate being killed).
205
+ */
206
+ function signalGroup(pgid: number): void {
207
+ try {
208
+ process.kill(-pgid, 'SIGKILL');
209
+ } catch (error) {
210
+ // ESRCH: the group is gone. EPERM: no member of it can be signalled, which is what a member that exited and has not
211
+ // been reaped yet answers on macOS; groupHasMembers says whether any is left. Any other answer is a failure.
212
+ const code = errorCode(error);
213
+ if (code !== 'ESRCH' && code !== 'EPERM') throw error;
214
+ }
215
+ }
216
+
217
+ /**
218
+ * Whether the kernel lists a member of the group led by `pgid`. It is the probe the bounded-exec executor makes
219
+ * (`processGroupHasMembers`), which this script cannot import because it runs before anything is installed. ESRCH
220
+ * proves the group is empty. EPERM proves a member exists that this process may not signal, such as one that exited
221
+ * and has not been reaped, which macOS reports that way. Any other answer proves neither and is a failure, not a
222
+ * verdict. A group outlives its reaped leader for as long as one member does, and no process can take its id
223
+ * meanwhile.
224
+ */
225
+ function groupHasMembers(pgid: number): boolean {
226
+ try {
227
+ process.kill(-pgid, 0);
228
+ return true;
229
+ } catch (error) {
230
+ const code = errorCode(error);
231
+ if (code === 'ESRCH') return false;
232
+ if (code === 'EPERM') return true;
233
+ throw error;
234
+ }
235
+ }
236
+
237
+ /**
238
+ * Kills the group led by `pgid` and keeps killing it while it has members, as `judgeReap` in cargo-fetch-bound.ts says:
239
+ * a group signal reaches the members that exist when it goes out, and macOS does not hold a fork back while it does, so
240
+ * a member forked in that moment survives it. Each round signals once and then waits `patience.pauseMs`, blocking this
241
+ * process: while a kill is being finished nothing else is wanted of it. Returns whether members were left when the
242
+ * patience ran out.
243
+ */
244
+ function reapGroup(pgid: number, patience: Patience): boolean {
245
+ for (let round = 0; ; round += 1) {
246
+ const verdict = judgeReap({ round, patience, members: groupHasMembers(pgid) });
247
+ switch (verdict.kind) {
248
+ case 'empty':
249
+ return false;
250
+ case 'members-left':
251
+ return true;
252
+ case 'signal':
253
+ signalGroup(pgid);
254
+ if (patience.pauseMs > 0) Bun.sleepSync(patience.pauseMs);
255
+ }
256
+ }
257
+ }
258
+
259
+ /**
260
+ * Says `message` on stderr. Where stderr is gone there is nobody to tell, and a diagnostic must neither replace the
261
+ * failure it accompanies nor stop the signal being given back.
262
+ */
263
+ function tell(message: string): void {
264
+ try {
265
+ writeSync(2, `${message}\n`);
266
+ } catch {
267
+ // Nobody is left to tell.
268
+ }
269
+ }
270
+
271
+ /**
272
+ * Has `end` run when this process is ending: on exit, and on a SIGINT, SIGTERM or SIGHUP, which also gives the signal
273
+ * back to the process afterwards so it still ends by that signal. A signal somebody already handles stays theirs.
274
+ * Returns the function that takes the hooks away.
275
+ */
276
+ function endWithThisProcess(end: () => void): () => void {
277
+ const hooks: Array<readonly [NodeJS.Signals, () => void]> = [];
278
+ const release = (): void => {
279
+ process.removeListener('exit', end);
280
+ for (const [signal, handler] of hooks) process.removeListener(signal, handler);
281
+ hooks.length = 0;
282
+ };
283
+ process.on('exit', end);
284
+ for (const signal of TEARDOWN_SIGNALS) {
285
+ if (process.listenerCount(signal) !== 0) continue;
286
+ const handler = (): void => {
287
+ // The signal is given back whatever `end` does: this process must still end by it.
288
+ try {
289
+ end();
290
+ } finally {
291
+ release();
292
+ process.kill(process.pid, signal);
293
+ }
294
+ };
295
+ process.on(signal, handler);
296
+ hooks.push([signal, handler]);
297
+ }
298
+ return release;
299
+ }