@smoothbricks/nx-plugin 0.5.7 → 0.6.1

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 (446) hide show
  1. package/README.md +1097 -360
  2. package/dist/.build-inputs.json +141 -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 +22 -5
  48. package/dist/ensure-built-receipt.d.ts.map +1 -1
  49. package/dist/ensure-built-receipt.js +168 -48
  50. package/dist/ensure-built-witness.d.ts +27 -8
  51. package/dist/ensure-built-witness.d.ts.map +1 -1
  52. package/dist/ensure-built-witness.js +45 -15
  53. package/dist/ensure-built.d.ts.map +1 -1
  54. package/dist/ensure-built.js +9 -1
  55. package/dist/eslint-config-closure.d.ts +7 -0
  56. package/dist/eslint-config-closure.d.ts.map +1 -0
  57. package/dist/eslint-config-closure.js +346 -0
  58. package/dist/executors/bounded-exec/bounds.d.ts +56 -0
  59. package/dist/executors/bounded-exec/bounds.d.ts.map +1 -0
  60. package/dist/executors/bounded-exec/bounds.js +43 -0
  61. package/dist/executors/bounded-exec/cpu-pool-thread.d.ts +28 -0
  62. package/dist/executors/bounded-exec/cpu-pool-thread.d.ts.map +1 -0
  63. package/dist/executors/bounded-exec/cpu-pool-thread.js +20 -0
  64. package/dist/executors/bounded-exec/cpu-pool.d.ts +35 -38
  65. package/dist/executors/bounded-exec/cpu-pool.d.ts.map +1 -1
  66. package/dist/executors/bounded-exec/cpu-pool.js +56 -120
  67. package/dist/executors/bounded-exec/executor.d.ts +19 -12
  68. package/dist/executors/bounded-exec/executor.d.ts.map +1 -1
  69. package/dist/executors/bounded-exec/executor.js +389 -239
  70. package/dist/executors/bounded-exec/gateway-lease.d.ts +23 -19
  71. package/dist/executors/bounded-exec/gateway-lease.d.ts.map +1 -1
  72. package/dist/executors/bounded-exec/gateway-lease.js +102 -29
  73. package/dist/executors/bounded-exec/hang-diagnostics.d.ts +18 -1
  74. package/dist/executors/bounded-exec/hang-diagnostics.d.ts.map +1 -1
  75. package/dist/executors/bounded-exec/hang-diagnostics.js +148 -30
  76. package/dist/executors/bounded-exec/lease-wait.d.ts +64 -0
  77. package/dist/executors/bounded-exec/lease-wait.d.ts.map +1 -0
  78. package/dist/executors/bounded-exec/lease-wait.js +72 -0
  79. package/dist/executors/bounded-exec/lock-wait.d.ts +51 -0
  80. package/dist/executors/bounded-exec/lock-wait.d.ts.map +1 -0
  81. package/dist/executors/bounded-exec/lock-wait.js +108 -0
  82. package/dist/executors/bounded-exec/mbx-pool.d.ts +31 -0
  83. package/dist/executors/bounded-exec/mbx-pool.d.ts.map +1 -0
  84. package/dist/executors/bounded-exec/mbx-pool.js +24 -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 +10 -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 +122 -35
  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 +48 -11
  119. package/dist/executors/bounded-exec/verdict.d.ts.map +1 -1
  120. package/dist/executors/bounded-exec/verdict.js +89 -20
  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/emit-overrides.d.ts +14 -0
  135. package/dist/executors/typescript-emit/emit-overrides.d.ts.map +1 -0
  136. package/dist/executors/typescript-emit/emit-overrides.js +24 -0
  137. package/dist/executors/typescript-emit/executor.d.ts +3 -1
  138. package/dist/executors/typescript-emit/executor.d.ts.map +1 -1
  139. package/dist/executors/typescript-emit/executor.js +146 -33
  140. package/dist/forbidden-spelling-policy.d.ts +56 -0
  141. package/dist/forbidden-spelling-policy.d.ts.map +1 -0
  142. package/dist/forbidden-spelling-policy.js +176 -0
  143. package/dist/generators/create-package/generator.d.ts.map +1 -1
  144. package/dist/generators/create-package/generator.js +3 -4
  145. package/dist/graph-input-contract.d.ts +14 -0
  146. package/dist/graph-input-contract.d.ts.map +1 -1
  147. package/dist/graph-input-contract.js +67 -2
  148. package/dist/index.d.ts +23 -6
  149. package/dist/index.d.ts.map +1 -1
  150. package/dist/index.js +672 -214
  151. package/dist/managed-assets.d.ts +2 -0
  152. package/dist/managed-assets.d.ts.map +1 -1
  153. package/dist/managed-files/files.d.ts +3 -3
  154. package/dist/managed-files/files.d.ts.map +1 -1
  155. package/dist/managed-files/files.js +28 -3
  156. package/dist/managed-files/managed-format.d.ts.map +1 -1
  157. package/dist/managed-files/managed-format.js +1 -0
  158. package/dist/managed-files/publish-workflow.js +14 -11
  159. package/dist/nextest-code-bound.js +1 -0
  160. package/dist/nextest-timings.d.ts +35 -0
  161. package/dist/nextest-timings.d.ts.map +1 -0
  162. package/dist/nextest-timings.js +168 -0
  163. package/dist/owned-installation.d.ts +6 -5
  164. package/dist/owned-installation.d.ts.map +1 -1
  165. package/dist/owned-installation.js +150 -26
  166. package/dist/package-target-policy.d.ts.map +1 -1
  167. package/dist/package-target-policy.js +2 -3
  168. package/dist/process-children.d.ts +7 -0
  169. package/dist/process-children.d.ts.map +1 -0
  170. package/dist/process-children.darwin.d.ts +7 -0
  171. package/dist/process-children.darwin.d.ts.map +1 -0
  172. package/dist/process-children.darwin.js +13 -0
  173. package/dist/process-children.js +14 -0
  174. package/dist/process-children.linux.d.ts +8 -0
  175. package/dist/process-children.linux.d.ts.map +1 -0
  176. package/dist/process-children.linux.js +25 -0
  177. package/dist/process-group.d.ts +108 -0
  178. package/dist/process-group.d.ts.map +1 -0
  179. package/dist/process-group.js +171 -0
  180. package/dist/process-listing.d.ts +7 -0
  181. package/dist/process-listing.d.ts.map +1 -0
  182. package/dist/process-listing.js +51 -0
  183. package/dist/producer-receipts.d.ts +8 -2
  184. package/dist/producer-receipts.d.ts.map +1 -1
  185. package/dist/producer-receipts.js +514 -47
  186. package/dist/task-graph-policy.d.ts +21 -0
  187. package/dist/task-graph-policy.d.ts.map +1 -0
  188. package/dist/task-graph-policy.js +91 -0
  189. package/dist/test-timings.js +4 -4
  190. package/dist/test-walk-policy.d.ts +14 -5
  191. package/dist/test-walk-policy.d.ts.map +1 -1
  192. package/dist/test-walk-policy.js +8 -2
  193. package/dist/testing.d.ts +73 -28
  194. package/dist/testing.d.ts.map +1 -1
  195. package/dist/testing.js +217 -223
  196. package/dist/tool-bins.d.ts +33 -0
  197. package/dist/tool-bins.d.ts.map +1 -0
  198. package/dist/tool-bins.js +72 -0
  199. package/dist/typecheck-test-policy.d.ts.map +1 -1
  200. package/dist/typecheck-test-policy.js +3 -4
  201. package/dist/wait-why-policy.d.ts +28 -0
  202. package/dist/wait-why-policy.d.ts.map +1 -0
  203. package/dist/wait-why-policy.js +223 -0
  204. package/dist/workspace-config-policy.d.ts +14 -8
  205. package/dist/workspace-config-policy.d.ts.map +1 -1
  206. package/dist/workspace-config-policy.js +60 -16
  207. package/dist/workspace-manifest.d.ts +41 -6
  208. package/dist/workspace-manifest.d.ts.map +1 -1
  209. package/dist/workspace-manifest.js +57 -0
  210. package/executors.json +16 -1
  211. package/loader.js +2 -0
  212. package/managed/raw/envrc +11 -0
  213. package/managed/raw/patches/nx@23.2.1.patch +2840 -199
  214. package/managed/raw/patches/ttsc@0.34.1.patch +119 -0
  215. package/managed/raw/tooling/direnv/cargo-fetch-bound.ts +245 -0
  216. package/managed/raw/tooling/direnv/cargo-fetch-run.ts +299 -0
  217. package/managed/raw/tooling/direnv/compiler-variables.sh +42 -0
  218. package/managed/raw/tooling/direnv/developer-links.ts +464 -25
  219. package/managed/raw/tooling/direnv/devenv.smoo.nix +78 -38
  220. package/managed/raw/tooling/direnv/github-actions-bootstrap.sh +14 -12
  221. package/managed/raw/tooling/direnv/installed-bun-links.ts +308 -0
  222. package/managed/raw/tooling/direnv/linked-snapshots.ts +62 -3
  223. package/managed/raw/tooling/direnv/nx-socket-dir.sh +56 -17
  224. package/managed/raw/tooling/direnv/repo-path +68 -6
  225. package/managed/raw/tooling/direnv/secret-references.ts +13 -4
  226. package/managed/raw/tooling/direnv/setup-environment.ts +128 -537
  227. package/managed/raw/tooling/direnv/toolchain-stamp.ts +4 -2
  228. package/managed/raw/tooling/direnv/ttsc-env.sh +9 -0
  229. package/managed/raw/tooling/direnv/uv-relocation.ts +227 -0
  230. package/managed/raw/tooling/git-hooks/commit-msg.sh +2 -1
  231. package/managed/raw/tooling/git-hooks/pre-commit.sh +2 -1
  232. package/managed/raw/tooling/git-hooks/pre-push.sh +2 -1
  233. package/managed/templates/github/actions/cache-ttsc-plugins/action.yml +85 -7
  234. package/managed/templates/github/actions/save-nix-devenv/action.yml +12 -2
  235. package/managed/templates/github/actions/setup-devenv/action.yml +2 -0
  236. package/package.json +95 -14
  237. package/src/bin/smoo-nx-cargo-toolchain.ts +11 -0
  238. package/src/bin/smoo-nx-forbidden-spellings.ts +33 -0
  239. package/src/bin/smoo-nx-nextest-timings.ts +31 -0
  240. package/src/bounded-test-policy.ts +12 -14
  241. package/src/build-state-output-policy.ts +458 -34
  242. package/src/bun-lock-scope.ts +108 -0
  243. package/src/cargo-build-script-env.ts +265 -0
  244. package/src/cargo-closure-input.ts +74 -7
  245. package/src/cargo-retention-hook.ts +94 -0
  246. package/src/cargo-source-hash.ts +138 -41
  247. package/src/cargo-toolchain-paths.ts +95 -0
  248. package/src/cargo-toolchain-policy.ts +49 -5
  249. package/src/cargo-workspace.ts +72 -123
  250. package/src/cross-check-policy.ts +12 -10
  251. package/src/disk-command-policy.ts +1 -0
  252. package/src/ensure-built-receipt.ts +173 -39
  253. package/src/ensure-built-witness.ts +62 -10
  254. package/src/ensure-built.ts +11 -1
  255. package/src/eslint-config-closure.ts +357 -0
  256. package/src/executors/bounded-exec/bounds.ts +76 -0
  257. package/src/executors/bounded-exec/cpu-pool-thread.ts +43 -0
  258. package/src/executors/bounded-exec/cpu-pool.ts +55 -120
  259. package/src/executors/bounded-exec/executor.ts +442 -260
  260. package/src/executors/bounded-exec/gateway-lease.ts +94 -35
  261. package/src/executors/bounded-exec/hang-diagnostics.ts +173 -31
  262. package/src/executors/bounded-exec/lease-wait.ts +116 -0
  263. package/src/executors/bounded-exec/lock-wait.ts +141 -0
  264. package/src/executors/bounded-exec/mbx-pool.ts +48 -0
  265. package/src/executors/bounded-exec/owned-subtree.ts +235 -0
  266. package/src/executors/bounded-exec/progress.ts +9 -3
  267. package/src/executors/bounded-exec/ram-attach.ts +238 -0
  268. package/src/executors/bounded-exec/ram-detach.ts +226 -0
  269. package/src/executors/bounded-exec/ram-temp-fixtures.ts +358 -0
  270. package/src/executors/bounded-exec/ram-temp-registry.txt +440 -0
  271. package/src/executors/bounded-exec/ram-temp.ts +1497 -460
  272. package/src/executors/bounded-exec/run-cpu-pool.ts +129 -35
  273. package/src/executors/bounded-exec/runner-hook.ts +14 -6
  274. package/src/executors/bounded-exec/runner-lifecycle.ts +31 -8
  275. package/src/executors/bounded-exec/{cpu-tokens.ts → runner-sizing.ts} +13 -59
  276. package/src/executors/bounded-exec/runtime-pin.ts +232 -0
  277. package/src/executors/bounded-exec/schema.json +11 -2
  278. package/src/executors/bounded-exec/schema.ts +19 -1
  279. package/src/executors/bounded-exec/verdict.ts +145 -35
  280. package/src/executors/cargo-zigbuild/executor.ts +82 -8
  281. package/src/executors/clean-outputs/executor.ts +1 -0
  282. package/src/executors/scriptc-native/executor.ts +394 -0
  283. package/src/executors/scriptc-native/ffi-paths.ts +29 -0
  284. package/src/executors/scriptc-native/schema.json +60 -0
  285. package/src/executors/scriptc-native/schema.ts +34 -0
  286. package/src/executors/typescript-emit/emit-overrides.ts +24 -0
  287. package/src/executors/typescript-emit/executor.ts +186 -38
  288. package/src/forbidden-spelling-policy.ts +226 -0
  289. package/src/generators/create-package/generator.ts +7 -7
  290. package/src/graph-input-contract.ts +61 -2
  291. package/src/index.ts +788 -224
  292. package/src/managed-assets.ts +3 -0
  293. package/src/managed-files/files.ts +28 -3
  294. package/src/managed-files/managed-format.ts +1 -0
  295. package/src/managed-files/publish-workflow.ts +20 -15
  296. package/src/nextest-code-bound.ts +1 -0
  297. package/src/nextest-timings.ts +106 -0
  298. package/src/owned-installation.ts +150 -23
  299. package/src/package-target-policy.ts +2 -3
  300. package/src/process-children.darwin.ts +14 -0
  301. package/src/process-children.linux.ts +33 -0
  302. package/src/process-children.ts +22 -0
  303. package/src/process-group.ts +209 -0
  304. package/src/process-listing.ts +54 -0
  305. package/src/producer-receipts.ts +92 -41
  306. package/src/task-graph-policy.ts +98 -0
  307. package/src/test-walk-policy.ts +23 -8
  308. package/src/testing.ts +240 -232
  309. package/src/tool-bins.ts +108 -0
  310. package/src/typecheck-test-policy.ts +2 -3
  311. package/src/wait-why-policy.ts +226 -0
  312. package/src/workspace-config-policy.ts +63 -15
  313. package/src/workspace-manifest.ts +89 -6
  314. package/test-timings.json +124 -99
  315. package/dist/bin/smoo-nx-failures.d.ts +0 -3
  316. package/dist/bin/smoo-nx-failures.d.ts.map +0 -1
  317. package/dist/bin/smoo-nx-failures.js +0 -3
  318. package/dist/bin/smoo-nx-nextest-extract.d.ts +0 -3
  319. package/dist/bin/smoo-nx-nextest-extract.d.ts.map +0 -1
  320. package/dist/bin/smoo-nx-nextest-extract.js +0 -42
  321. package/dist/executors/bounded-exec/cpu-tokens.d.ts.map +0 -1
  322. package/dist/failure-summary.d.ts +0 -5
  323. package/dist/failure-summary.d.ts.map +0 -1
  324. package/dist/failure-summary.js +0 -118
  325. package/dist/nextest-extraction.d.ts +0 -117
  326. package/dist/nextest-extraction.d.ts.map +0 -1
  327. package/dist/nextest-extraction.js +0 -303
  328. package/managed/raw/patches/ttsc@0.30.4.patch +0 -2255
  329. package/src/__tests__/cargo-closure-filesets.ts +0 -94
  330. package/src/__tests__/cargo-closure-fixture.ts +0 -113
  331. package/src/__tests__/counted-cargo-process.ts +0 -286
  332. package/src/__tests__/counted-cargo.ts +0 -713
  333. package/src/__tests__/directory-change.ts +0 -27
  334. package/src/__tests__/fixture-cargo-home.ts +0 -36
  335. package/src/__tests__/fixture-nx-env.ts +0 -193
  336. package/src/__tests__/owned-installation.ts +0 -13
  337. package/src/__tests__/past-tick.ts +0 -12
  338. package/src/__tests__/progress-clock.ts +0 -43
  339. package/src/__tests__/runtime-input.ts +0 -23
  340. package/src/bin/smoo-nx-bound-failures.test.ts +0 -127
  341. package/src/bin/smoo-nx-failures.ts +0 -4
  342. package/src/bin/smoo-nx-nextest-extract.ts +0 -44
  343. package/src/bounded-test-policy.test.ts +0 -1029
  344. package/src/build-state-output-policy.test.ts +0 -115
  345. package/src/bun-bootstrap.test.ts +0 -102
  346. package/src/bun-file-packages.test.ts +0 -47
  347. package/src/cargo-closure-filesets.test.ts +0 -63
  348. package/src/cargo-closure-input.property.test.ts +0 -50
  349. package/src/cargo-closure-input.test.ts +0 -506
  350. package/src/cargo-closure-key.test.ts +0 -240
  351. package/src/cargo-resolve-cache.test.ts +0 -1181
  352. package/src/cargo-source-hash.test.ts +0 -707
  353. package/src/cargo-workspace.test.ts +0 -615
  354. package/src/cross-check-policy.test.ts +0 -316
  355. package/src/disk-command-policy.test.ts +0 -61
  356. package/src/ensure-built-receipt.test.ts +0 -279
  357. package/src/ensure-built-witness.test.ts +0 -688
  358. package/src/ensure-built.test.ts +0 -1462
  359. package/src/executors/all-verdicts/executor.test.ts +0 -135
  360. package/src/executors/bounded-exec/cargo-progress-host.test.ts +0 -332
  361. package/src/executors/bounded-exec/cpu-pool.test.ts +0 -684
  362. package/src/executors/bounded-exec/cpu-tokens.test.ts +0 -519
  363. package/src/executors/bounded-exec/disk-lease.test.ts +0 -219
  364. package/src/executors/bounded-exec/executor-host.test.ts +0 -800
  365. package/src/executors/bounded-exec/executor.test.ts +0 -1819
  366. package/src/executors/bounded-exec/go-progress-host.test.ts +0 -171
  367. package/src/executors/bounded-exec/hang-diagnostics.test.ts +0 -291
  368. package/src/executors/bounded-exec/progress.test.ts +0 -139
  369. package/src/executors/bounded-exec/ram-temp-held.test.ts +0 -264
  370. package/src/executors/bounded-exec/ram-temp-host.test.ts +0 -635
  371. package/src/executors/bounded-exec/ram-temp.test.ts +0 -750
  372. package/src/executors/bounded-exec/run-cpu-pool.test.ts +0 -79
  373. package/src/executors/bounded-exec/runner-hook.test.ts +0 -193
  374. package/src/executors/bounded-exec/runner-lifecycle.test.ts +0 -82
  375. package/src/executors/bounded-exec/verdict.test.ts +0 -545
  376. package/src/executors/cargo-zigbuild/executor.test.ts +0 -129
  377. package/src/executors/clean-outputs/executor.test.ts +0 -20
  378. package/src/executors/typescript-emit/executor.test.ts +0 -83
  379. package/src/failure-summary.ts +0 -119
  380. package/src/generators/bounded-test-targets/generator.test.ts +0 -138
  381. package/src/generators/bun-test-tracing/generator.test.ts +0 -250
  382. package/src/generators/create-package/generator.test.ts +0 -190
  383. package/src/generators/make-public/generator.test.ts +0 -137
  384. package/src/graph-input-contract.test.ts +0 -379
  385. package/src/host-controller-wiring.test.ts +0 -31
  386. package/src/index.test.ts +0 -3321
  387. package/src/linked-snapshots.nx.test.ts +0 -254
  388. package/src/managed-files/forgejo-artifact.test.ts +0 -395
  389. package/src/managed-files/generator.test.ts +0 -243
  390. package/src/managed-files/github-host-cache-isolation.test.ts +0 -86
  391. package/src/managed-files/json-edit.test.ts +0 -216
  392. package/src/managed-files/managed-content.test.ts +0 -166
  393. package/src/managed-files/managed-format-json.test.ts +0 -308
  394. package/src/managed-files/repo-path.test.ts +0 -172
  395. package/src/managed-files/setup-devenv-free-disk.test.ts +0 -95
  396. package/src/managed-files/trace-db-artifact.test.ts +0 -7
  397. package/src/managed-files/tree-permissions.test.ts +0 -109
  398. package/src/managed-files/tree.test.ts +0 -123
  399. package/src/manifest-hash.test.ts +0 -219
  400. package/src/nextest-code-bound.test.ts +0 -161
  401. package/src/nextest-extraction.test.ts +0 -216
  402. package/src/nextest-extraction.ts +0 -371
  403. package/src/nextest-partitions.test.ts +0 -501
  404. package/src/nx-cache-bound.test.ts +0 -109
  405. package/src/nx-cache-restore-mtime.test.ts +0 -170
  406. package/src/nx-daemon-claim.test.ts +0 -279
  407. package/src/nx-daemon-idle-cpu.test.ts +0 -80
  408. package/src/nx-daemon-idle-policy.test.ts +0 -111
  409. package/src/nx-daemon-ignore-files.test.ts +0 -210
  410. package/src/nx-daemon-root-normalization.test.ts +0 -105
  411. package/src/nx-daemon-start-never.test.ts +0 -292
  412. package/src/nx-daemon-validity.test.ts +0 -1055
  413. package/src/nx-dot-input-policy.test.ts +0 -353
  414. package/src/nx-failure-life-cycles.test.ts +0 -207
  415. package/src/nx-files-archive-racy.test.ts +0 -97
  416. package/src/nx-foreign-workspace-env.test.ts +0 -329
  417. package/src/nx-incomplete-run-summary.test.ts +0 -70
  418. package/src/nx-plugin-load-errors.test.ts +0 -120
  419. package/src/nx-project-graph-errors.test.ts +0 -70
  420. package/src/nx-project-resolution-cache.test.ts +0 -176
  421. package/src/nx-raw-inputs.test.ts +0 -166
  422. package/src/nx-resident-graph-workers.test.ts +0 -112
  423. package/src/nx-run-information.test.ts +0 -118
  424. package/src/nx-skipped-task-exit.test.ts +0 -180
  425. package/src/nx-state-location.test.ts +0 -63
  426. package/src/nx-store-resolution.test.ts +0 -81
  427. package/src/nx-task-graph-cycles.test.ts +0 -148
  428. package/src/nx-task-output-lease.test.ts +0 -550
  429. package/src/nx-use-local.test.ts +0 -105
  430. package/src/owned-installation.test.ts +0 -105
  431. package/src/package-target-policy.test.ts +0 -1014
  432. package/src/producer-receipts.test.ts +0 -285
  433. package/src/release-config-policy.test.ts +0 -311
  434. package/src/runtime-input.test.ts +0 -393
  435. package/src/serial-group-wiring.test.ts +0 -326
  436. package/src/task-history-namespace.test.ts +0 -181
  437. package/src/task-results.test.ts +0 -228
  438. package/src/test-clock-policy.test.ts +0 -338
  439. package/src/test-program.test.ts +0 -303
  440. package/src/test-timings.test.ts +0 -240
  441. package/src/test-walk-policy.test.ts +0 -620
  442. package/src/testing.test.ts +0 -509
  443. package/src/typecheck-test-policy.test.ts +0 -1468
  444. package/src/typescript-resolution.test.ts +0 -76
  445. package/src/version-actions.test.ts +0 -80
  446. 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
+ }