@smoothbricks/nx-plugin 0.5.7 → 0.6.1

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