@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,265 @@
1
+ /**
2
+ * Which environment variables a Cargo target's build-script runs recorded with a value other than the one Cargo would
3
+ * see now (specs/cowshed/16_build_volumes.md, "One Cargo environment on every path").
4
+ *
5
+ * `cargo:rerun-if-env-changed=VAR` makes VAR's value part of a build-script run's identity. Cargo records the value it
6
+ * saw in the run's fingerprint (`fingerprint/run-build-script-*.json`, `local[].RerunIfEnvChanged`) and, on the next
7
+ * build, reruns the script when the value it sees then differs, and rebuilds every unit that depends on the script's
8
+ * package. The value Cargo sees is its `[env]` configuration's when that entry is forced or its own environment lacks
9
+ * the variable, and its own environment's otherwise.
10
+ */
11
+ import { readdirSync, readFileSync, realpathSync } from 'node:fs';
12
+ import { homedir } from 'node:os';
13
+ import { dirname, join, resolve } from 'node:path';
14
+ import { type Result, readCargoFingerprint } from '@smoothbricks/cargo-retain';
15
+ import { parse as parseToml } from 'smol-toml';
16
+ import typia from 'typia';
17
+
18
+ /** One variable whose recorded value differs from the value Cargo would see now, and the runs that recorded it. */
19
+ export interface EnvironmentDrift {
20
+ readonly variable: string;
21
+ /** What the runs recorded; `null` is unset. */
22
+ readonly recorded: string | null;
23
+ /** What Cargo would see now; `null` is unset. */
24
+ readonly current: string | null;
25
+ /** The packages whose build scripts recorded it, sorted, each once. */
26
+ readonly packages: readonly string[];
27
+ /** How many build-script runs recorded it: a package's script runs once per profile, target and feature set. */
28
+ readonly runs: number;
29
+ }
30
+
31
+ /** The value Cargo would give a variable now; `null` is unset. */
32
+ export type CargoSees = (variable: string) => string | null;
33
+
34
+ type CargoEnvEntry = string | { readonly value: string; readonly force?: boolean; readonly relative?: boolean };
35
+ interface CargoConfig {
36
+ readonly env?: Readonly<Record<string, CargoEnvEntry>>;
37
+ }
38
+ const validateConfig = typia.createValidate<CargoConfig>();
39
+
40
+ /**
41
+ * Variables Cargo itself sets for the processes it runs (build scripts, rustc and test binaries): Cargo's own
42
+ * namespace and the build-script names it documents
43
+ * (https://doc.rust-lang.org/cargo/reference/environment-variables.html). A run that recorded one with a value was
44
+ * started by a `cargo` that a Cargo-run process spawned (a test that runs `cargo` passes on its own
45
+ * `CARGO_MANIFEST_DIR`), and no shell gives or takes it.
46
+ */
47
+ const SET_BY_CARGO: Readonly<Record<string, true>> = {
48
+ CARGO: true,
49
+ OUT_DIR: true,
50
+ TARGET: true,
51
+ HOST: true,
52
+ NUM_JOBS: true,
53
+ OPT_LEVEL: true,
54
+ DEBUG: true,
55
+ PROFILE: true,
56
+ RUSTC: true,
57
+ RUSTDOC: true,
58
+ RUSTC_LINKER: true,
59
+ RUSTC_WRAPPER: true,
60
+ RUSTC_WORKSPACE_WRAPPER: true,
61
+ };
62
+
63
+ function describeCause(error: unknown): string {
64
+ return error instanceof Error ? error.message : String(error);
65
+ }
66
+
67
+ function errorCode(error: unknown): string | undefined {
68
+ return error instanceof Error && 'code' in error && typeof error.code === 'string' ? error.code : undefined;
69
+ }
70
+
71
+ /** The entries of `directory`, or none when it is absent or not a directory. */
72
+ function entries(directory: string): string[] {
73
+ try {
74
+ return readdirSync(directory);
75
+ } catch (error) {
76
+ // Nothing there, or a stray file where Cargo keeps a directory: no runs to read.
77
+ if (errorCode(error) === 'ENOENT' || errorCode(error) === 'ENOTDIR') return [];
78
+ throw error;
79
+ }
80
+ }
81
+
82
+ /** Every build-script run fingerprint under one profile directory, with its package, in either Cargo layout. */
83
+ function buildScriptRuns(profile: string): { readonly pkg: string; readonly file: string }[] {
84
+ const runs: { pkg: string; file: string }[] = [];
85
+ const collect = (pkg: string, fingerprint: string): void => {
86
+ for (const name of entries(fingerprint)) {
87
+ if (name.startsWith('run-build-script-') && name.endsWith('.json'))
88
+ runs.push({ pkg, file: join(fingerprint, name) });
89
+ }
90
+ };
91
+ // `build/<package>/<hash>/fingerprint/`: the layout this repository's Cargo writes.
92
+ const build = join(profile, 'build');
93
+ for (const pkg of entries(build)) {
94
+ for (const hash of entries(join(build, pkg))) collect(pkg, join(build, pkg, hash, 'fingerprint'));
95
+ }
96
+ // `.fingerprint/<package>-<hash>/`: the layout before it.
97
+ const legacy = join(profile, '.fingerprint');
98
+ for (const unit of entries(legacy)) collect(unit.replace(/-[0-9a-f]{16}$/, ''), join(legacy, unit));
99
+ return runs;
100
+ }
101
+
102
+ /**
103
+ * The drift between the build-script runs recorded under `profile` (a target directory's `debug`, say) and what
104
+ * `sees` gives each recorded variable, one entry per variable and recorded value, sorted by variable. Variables Cargo
105
+ * sets for the processes it runs are not compared. A missing profile directory has nothing to compare.
106
+ */
107
+ export function buildScriptEnvironmentDrift(profile: string, sees: CargoSees): Result<EnvironmentDrift[], string> {
108
+ const drift = new Map<
109
+ string,
110
+ { variable: string; recorded: string | null; current: string | null; packages: Set<string>; runs: number }
111
+ >();
112
+ let runs: { readonly pkg: string; readonly file: string }[];
113
+ try {
114
+ runs = buildScriptRuns(profile);
115
+ } catch (error) {
116
+ return { ok: false, error: `cannot list the build-script runs under ${profile}: ${describeCause(error)}` };
117
+ }
118
+ for (const { pkg, file } of runs) {
119
+ let text: string;
120
+ try {
121
+ text = readFileSync(file, 'utf8');
122
+ } catch (error) {
123
+ return { ok: false, error: `cannot read ${file}: ${describeCause(error)}` };
124
+ }
125
+ const fingerprint = readCargoFingerprint(text);
126
+ if (!fingerprint.ok) return { ok: false, error: `${file}: ${fingerprint.error}` };
127
+ for (const local of fingerprint.value.local ?? []) {
128
+ const recorded = local.RerunIfEnvChanged;
129
+ if (recorded === undefined || recorded.var.startsWith('CARGO_') || SET_BY_CARGO[recorded.var] === true) continue;
130
+ const current = sees(recorded.var);
131
+ if (current === recorded.val) continue;
132
+ const key = `${recorded.var}\u0000${recorded.val ?? '\u0000'}`;
133
+ const entry = drift.get(key) ?? {
134
+ variable: recorded.var,
135
+ recorded: recorded.val,
136
+ current,
137
+ packages: new Set<string>(),
138
+ runs: 0,
139
+ };
140
+ entry.packages.add(pkg);
141
+ entry.runs += 1;
142
+ drift.set(key, entry);
143
+ }
144
+ }
145
+ return {
146
+ ok: true,
147
+ value: [...drift.values()]
148
+ .map(({ packages, ...entry }) => ({ ...entry, packages: [...packages].sort() }))
149
+ .sort((a, b) => (a.variable < b.variable ? -1 : a.variable > b.variable ? 1 : 0)),
150
+ };
151
+ }
152
+
153
+ /** One Cargo configuration file: its text, and the directory its `relative` paths resolve against. */
154
+ export interface CargoConfigFile {
155
+ readonly path: string;
156
+ /** The parent of the `.cargo` directory holding the file (for `$CARGO_HOME/config.toml`, `$CARGO_HOME`'s parent). */
157
+ readonly root: string;
158
+ readonly text: string;
159
+ }
160
+
161
+ /**
162
+ * The configuration files a Cargo invoked in `directory` reads, deepest first: each ancestor's `.cargo/config.toml`
163
+ * (or `.cargo/config`, which Cargo prefers when both exist) up to `/`, then `$CARGO_HOME/config.toml` unless the walk
164
+ * already read it.
165
+ */
166
+ export function cargoConfigFiles(directory: string, cargoHome: string): Result<CargoConfigFile[], string> {
167
+ const files: CargoConfigFile[] = [];
168
+ const seen = new Set<string>();
169
+ const read = (candidates: readonly string[], root: string): string | null => {
170
+ for (const path of candidates) {
171
+ let text: string;
172
+ try {
173
+ text = readFileSync(path, 'utf8');
174
+ } catch (error) {
175
+ if (errorCode(error) === 'ENOENT' || errorCode(error) === 'ENOTDIR') continue;
176
+ return `cannot read ${path}: ${describeCause(error)}`;
177
+ }
178
+ const real = realpathSync(path);
179
+ if (!seen.has(real)) files.push({ path, root, text });
180
+ seen.add(real);
181
+ return null;
182
+ }
183
+ return null;
184
+ };
185
+ for (let at = resolve(directory); ; at = dirname(at)) {
186
+ const failed = read([join(at, '.cargo', 'config'), join(at, '.cargo', 'config.toml')], at);
187
+ if (failed !== null) return { ok: false, error: failed };
188
+ if (dirname(at) === at) break;
189
+ }
190
+ const home = resolve(cargoHome);
191
+ const failed = read([join(home, 'config'), join(home, 'config.toml')], dirname(home));
192
+ return failed === null ? { ok: true, value: files } : { ok: false, error: failed };
193
+ }
194
+
195
+ /**
196
+ * What Cargo sees for a variable under `files` (deepest first, as `cargoConfigFiles` lists them) with `environment`
197
+ * its own: the deepest `[env]` entry for it decides; a forced entry wins, else the environment's value, else the
198
+ * entry's; a `relative` entry's value is a path under its file's root.
199
+ */
200
+ export function cargoSees(
201
+ files: readonly CargoConfigFile[],
202
+ environment: Readonly<Record<string, string | undefined>>,
203
+ ): Result<CargoSees, string> {
204
+ const entries = new Map<string, { readonly entry: CargoEnvEntry; readonly root: string }>();
205
+ for (const file of [...files].reverse()) {
206
+ let parsed: unknown;
207
+ try {
208
+ parsed = parseToml(file.text);
209
+ } catch (error) {
210
+ return { ok: false, error: `${file.path} is not TOML: ${describeCause(error)}` };
211
+ }
212
+ const checked = validateConfig(parsed);
213
+ if (!checked.success) {
214
+ return {
215
+ ok: false,
216
+ error: `${file.path} [env]: ${checked.errors.map((e) => `${e.path} expected ${e.expected}`).join('; ')}`,
217
+ };
218
+ }
219
+ for (const [variable, entry] of Object.entries(checked.data.env ?? {}))
220
+ entries.set(variable, { entry, root: file.root });
221
+ }
222
+ return {
223
+ ok: true,
224
+ value: (variable) => {
225
+ const own = environment[variable] ?? null;
226
+ const configured = entries.get(variable);
227
+ if (configured === undefined) return own;
228
+ const { entry, root } = configured;
229
+ const { value, force = false, relative = false } = typeof entry === 'string' ? { value: entry } : entry;
230
+ if (own !== null && !force) return own;
231
+ return relative ? join(root, value) : value;
232
+ },
233
+ };
234
+ }
235
+
236
+ /** One line for a drift: the variable, both values, and the runs Cargo reruns for it. */
237
+ export function describeDrift(drift: EnvironmentDrift): string {
238
+ const [recorded, current] = [drift.recorded, drift.current].map((value) =>
239
+ value === null ? 'unset' : JSON.stringify(value),
240
+ );
241
+ return `${drift.variable}: ${drift.runs} build-script run(s) of ${drift.packages.join(', ')} recorded ${recorded}; Cargo now sees ${current}, so it reruns them and rebuilds what depends on them`;
242
+ }
243
+
244
+ /**
245
+ * `<checkout>`: print each drift between `<checkout>/target/debug`'s build-script runs and what a Cargo invoked in
246
+ * `<checkout>` with this process's environment would see, one line each. Exits 0 when it could compare, drift or not;
247
+ * 1 when a record or a configuration file cannot be read; 64 on a usage error.
248
+ */
249
+ export function runBuildScriptEnvironmentDrift(args: readonly string[]): number {
250
+ const [checkout] = args;
251
+ if (checkout === undefined || args.length !== 1) {
252
+ process.stderr.write('usage: cargo-build-script-env <checkout>\n');
253
+ return 64;
254
+ }
255
+ const home = process.env.CARGO_HOME ?? join(homedir(), '.cargo');
256
+ const files = cargoConfigFiles(checkout, home);
257
+ const sees = files.ok ? cargoSees(files.value, process.env) : files;
258
+ const drift = sees.ok ? buildScriptEnvironmentDrift(join(checkout, 'target', 'debug'), sees.value) : sees;
259
+ if (!drift.ok) {
260
+ process.stderr.write(`cargo-build-script-env: ${drift.error}\n`);
261
+ return 1;
262
+ }
263
+ for (const entry of drift.value) process.stdout.write(`cargo-build-script-env: ${describeDrift(entry)}\n`);
264
+ return 0;
265
+ }
@@ -1,10 +1,11 @@
1
+ import { createHash } from 'node:crypto';
1
2
  import { realpath } from 'node:fs/promises';
2
3
  import { isAbsolute, join, posix, relative, sep } from 'node:path';
3
4
 
4
- import type { TargetConfiguration } from 'nx/src/devkit-exports.js';
5
+ import { CARGO_ANCESTOR_INPUTS } from '@smoothbricks/cargo-retain/cargo-ancestor-inputs';
6
+ import type { ProjectGraphExternalNode, TargetConfiguration } from 'nx/src/devkit-exports.js';
5
7
 
6
8
  import {
7
- CARGO_ANCESTOR_INPUTS,
8
9
  type CargoResolve,
9
10
  type CompiledCargoInput,
10
11
  compiledInFiles,
@@ -18,10 +19,30 @@ import { globIndexedFiles } from './workspace-index.js';
18
19
  /**
19
20
  * The named input the plugin infers for every project with crates of a Cargo
20
21
  * workspace under its root: the mutable sources of the Cargo-resolved
21
- * dependency closure of those crates, and the lockfile that pins the rest.
22
+ * dependency closure of those crates, and the lock-scope node that stands for
23
+ * the Cargo.lock entries the closure reaches ({@link cargoLockNode}).
22
24
  */
23
25
  export const CARGO_CLOSURE_INPUT = 'cargoClosure';
24
26
 
27
+ /** Every lock-scope node's name starts with this; the rest is the directory whose crates it covers. */
28
+ export const CARGO_LOCK_NODE_PREFIX = 'cargo-lock:';
29
+
30
+ /** The lock-scope node for the crates under `directory`, workspace-relative (`.` for the root). */
31
+ export function cargoLockNodeName(directory: string): string {
32
+ return `${CARGO_LOCK_NODE_PREFIX}${posix.normalize(directory === '' ? '.' : directory)}`;
33
+ }
34
+
35
+ /** An input naming only lock-scope nodes: it keys a target on locked crates, never on npm packages. */
36
+ export function isCargoLockInput(input: unknown): boolean {
37
+ if (typeof input !== 'object' || input === null || !('externalDependencies' in input)) return false;
38
+ const names: unknown = input.externalDependencies;
39
+ return (
40
+ Array.isArray(names) &&
41
+ names.length > 0 &&
42
+ names.every((name) => typeof name === 'string' && name.startsWith(CARGO_LOCK_NODE_PREFIX))
43
+ );
44
+ }
45
+
25
46
  type Input = NonNullable<TargetConfiguration['inputs']>[number];
26
47
 
27
48
  /** A closure Nx cannot express exactly is a refusal, never a broader cache key. */
@@ -97,8 +118,8 @@ export async function resolveCargoClosureSource(
97
118
 
98
119
  /**
99
120
  * The `cargoClosure` definition for the project at `projectRoot`: for each
100
- * Cargo workspace with crates under it, the workspace's `Cargo.lock` plus the
101
- * resolve closure of those crates.
121
+ * Cargo workspace with crates under it, the resolve closure of those crates,
122
+ * and the lock-scope node of `projectRoot` for the locked rest.
102
123
  *
103
124
  * Closure members in Nx's file index are hashed by Nx itself, as filesets:
104
125
  * each package's Rust sources, manifests and Cargo configuration below its
@@ -142,11 +163,11 @@ export async function cargoClosureInputs(
142
163
  inputs.push(input);
143
164
  }
144
165
  }
166
+ inputs.push({ externalDependencies: [cargoLockNodeName(projectRoot)] });
145
167
  return inputs;
146
168
  }
147
169
 
148
170
  async function workspaceClosureInputs(projectRoot: string, source: CargoClosureSource): Promise<Input[]> {
149
- const lock = posix.join('{workspaceRoot}', posix.dirname(source.manifest), 'Cargo.lock');
150
171
  const closureArguments = `--closure ${shellWord(projectRoot)} ${shellWord(source.manifest)}`;
151
172
 
152
173
  const { root, cargo, indexed } = source;
@@ -231,7 +252,6 @@ async function workspaceClosureInputs(projectRoot: string, source: CargoClosureS
231
252
  );
232
253
  const anchored = (path: string, pattern = '') => posix.join('{workspaceRoot}', path, pattern);
233
254
  return [
234
- lock,
235
255
  ...packageGlobs.map((glob) => anchored(glob, PACKAGE_FILES)),
236
256
  ...packageGlobs.map((glob) => `!${anchored(glob, SKIPPED_TREES)}`),
237
257
  ...[...ancestors].sort().map((ancestor) => anchored(ancestor, ANCESTOR_FILES)),
@@ -241,6 +261,53 @@ async function workspaceClosureInputs(projectRoot: string, source: CargoClosureS
241
261
  ];
242
262
  }
243
263
 
264
+ /**
265
+ * The external project-graph node that stands for the part of Cargo.lock the
266
+ * crates under `directory` reach, over every source with a crate there.
267
+ *
268
+ * Its hash digests, per Cargo workspace in manifest order, every package of
269
+ * the resolve closure of those crates: a locked package by its Cargo package
270
+ * id and source (registry, name and version; a git dependency's commit), a
271
+ * path package by name, each with the packages its built dependencies resolved to
272
+ * (a dependency's own dev-dependencies are not built for these crates; see `buildClosure`).
273
+ * That is everything Cargo.lock decides for the closure. An edit to an entry
274
+ * no crate under `directory` reaches leaves the digest alone, and Nx hashes
275
+ * the node only into the targets that name it, so a lockfile change re-keys
276
+ * the users of what changed and nothing else. A registry package's checksum is
277
+ * not in Cargo's metadata and adds nothing: a published version's bytes never
278
+ * change, and every `--locked` build verifies them against Cargo.lock.
279
+ *
280
+ * Path packages are named, never identified by their ids: an id carries the
281
+ * checkout's absolute path, and a task key must not.
282
+ */
283
+ export async function cargoLockNode(
284
+ directory: string,
285
+ sources: readonly CargoClosureSource[],
286
+ ): Promise<ProjectGraphExternalNode> {
287
+ const name = cargoLockNodeName(directory);
288
+ if (sources.length === 0) {
289
+ throw new CargoClosureInputError(directory, new Error('no Cargo workspace has a crate under it'));
290
+ }
291
+ const hash = createHash('sha256');
292
+ try {
293
+ for (const source of [...sources].sort((left, right) =>
294
+ left.manifest < right.manifest ? -1 : left.manifest > right.manifest ? 1 : 0,
295
+ )) {
296
+ const { cargo, root } = source;
297
+ const closure = await dependencyClosure(cargo, join(root, directory));
298
+ const paths = new Map(cargo.local.map((pkg) => [pkg.id, `path:${pkg.name}`]));
299
+ const label = (id: string) => paths.get(id) ?? id;
300
+ const rows = [...closure]
301
+ .map(([id, built]) => [label(id), cargo.locked.get(id) ?? '', ...built.map(label).sort()].join('\t'))
302
+ .sort();
303
+ hash.update(`${source.manifest}\n${rows.join('\n')}\n\0`);
304
+ }
305
+ } catch (error) {
306
+ throw new CargoClosureInputError(directory, error);
307
+ }
308
+ const digest = hash.digest('hex');
309
+ return { type: 'cargo', name, data: { packageName: name, version: digest, hash: digest } };
310
+ }
244
311
  /** A compiled-in file and the source whose `include_str!`/`include_bytes!` names it, relative to the workspace root. */
245
312
  export interface CompiledInclusion {
246
313
  readonly declaring: string;
@@ -0,0 +1,94 @@
1
+ import { join, relative } from 'node:path';
2
+ import {
3
+ describeRetention,
4
+ describeRetentionError,
5
+ type Result,
6
+ type RetentionError,
7
+ type RetentionReport,
8
+ refusedAnywhere,
9
+ retainCargoWorkspace,
10
+ } from '@smoothbricks/cargo-retain';
11
+ import { nodeLocks } from '@smoothbricks/cargo-retain/locks-node';
12
+ import { logger, type ProjectGraph, readCachedProjectGraph } from 'nx/src/devkit-exports.js';
13
+ import type { PostTasksExecutionContext } from 'nx/src/project-graph/plugins/public-api.js';
14
+
15
+ function describeCause(error: unknown): string {
16
+ return error instanceof Error ? error.message : String(error);
17
+ }
18
+
19
+ type TaskStatus = PostTasksExecutionContext['taskResults'][string]['status'];
20
+
21
+ /** Whether a task with this status ran its command, and so may have built into a Cargo target directory. */
22
+ function ran(status: TaskStatus): boolean {
23
+ switch (status) {
24
+ case 'success':
25
+ case 'failure':
26
+ case 'stopped':
27
+ return true;
28
+ case 'skipped':
29
+ case 'local-cache-kept-existing':
30
+ case 'local-cache':
31
+ case 'remote-cache':
32
+ return false;
33
+ }
34
+ }
35
+
36
+ /**
37
+ * The metadata the plugin puts on every target it infers that builds, checks or tests into a Cargo
38
+ * target directory. Only an executed task carrying it starts a retention pass: a fetch, a lint of
39
+ * another language or a cache-restored replay wrote nothing there.
40
+ */
41
+ export const CARGO_PRODUCER_METADATA = { cargoProducer: true } as const;
42
+
43
+ /**
44
+ * After a run that executed a Cargo producer task ({@link CARGO_PRODUCER_METADATA}), check whether
45
+ * each Cargo workspace is due for its daily maintenance. A successful receipt schedules only;
46
+ * every due pass reads the current graph under Cargo's locks and is awaited by this Nx process.
47
+ * Maintenance never fails the run it follows: every outcome, a refused or busy pass included, is only reported.
48
+ */
49
+ export async function postTasksExecution(_options: unknown, context: PostTasksExecutionContext): Promise<void> {
50
+ const executed = Object.values(context.taskResults).filter(({ status }) => ran(status));
51
+ if (executed.length === 0) return;
52
+ let graph: ProjectGraph;
53
+ try {
54
+ graph = readCachedProjectGraph();
55
+ } catch (error) {
56
+ logger.warn(
57
+ `Cargo retention: cannot read the project graph that names Cargo producer tasks: ${describeCause(error)}`,
58
+ );
59
+ return;
60
+ }
61
+ const roots = new Set<string>();
62
+ for (const { task } of executed) {
63
+ const project = graph.nodes[task.target.project];
64
+ if (project?.data.targets?.[task.target.target]?.metadata?.cargoProducer !== true) continue;
65
+ roots.add(join(context.workspaceRoot, task.projectRoot ?? project.data.root));
66
+ }
67
+ const done: string[] = [];
68
+ for (const root of [...roots].sort()) {
69
+ if (done.some((workspaceRoot) => !relative(workspaceRoot, root).startsWith('..'))) continue;
70
+ const started = performance.now();
71
+ const cpu = process.cpuUsage();
72
+ let result: Result<RetentionReport, RetentionError>;
73
+ try {
74
+ result = await retainCargoWorkspace(root, { apply: true, automatic: true, now: Date.now() }, nodeLocks);
75
+ } catch (error) {
76
+ // Maintenance never fails the run it follows: say what escaped, then go on to the next workspace.
77
+ const detail = error instanceof Error ? (error.stack ?? error.message) : String(error);
78
+ logger.warn(`Cargo retention for ${root}: unexpected failure: ${detail}`);
79
+ continue;
80
+ } finally {
81
+ performance.measure('cargoRetention:total', { start: started });
82
+ const used = process.cpuUsage(cpu);
83
+ performance.measure('cargoRetention:cpu', { start: 0, duration: (used.user + used.system) / 1000 });
84
+ }
85
+ if (!result.ok) {
86
+ logger.warn(`Cargo retention for ${root}: ${describeRetentionError(result.error)}`);
87
+ continue;
88
+ }
89
+ done.push(result.value.workspaceRoot);
90
+ const line = describeRetention(result.value);
91
+ if (refusedAnywhere(result.value)) logger.warn(line);
92
+ else logger.info(line);
93
+ }
94
+ }