@smoothbricks/nx-plugin 0.5.7 → 0.6.0

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