@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
@@ -1,11 +1,11 @@
1
1
  import { createHash, randomUUID } from 'node:crypto';
2
- import { existsSync, lstatSync, mkdirSync, readdirSync, readFileSync, realpathSync, renameSync, rmSync, writeFileSync, } from 'node:fs';
2
+ import { existsSync, lstatSync, mkdirSync, readFileSync, realpathSync, renameSync, rmSync, writeFileSync, } from 'node:fs';
3
3
  import { createRequire } from 'node:module';
4
4
  import { delimiter, dirname, join, resolve } from 'node:path';
5
5
  import typia from 'typia';
6
6
  import { createWorkspaceNxRequire, parseTargetSelector, providerInputProof, selectorTaskId, } from './ensure-built.js';
7
- import { captureProducerSource, producerOutputPaths, providerReceipt, receiptNode, } from './ensure-built-receipt.js';
8
- import { censusFileHashes, censusStart, graphInstallationCensus, movedNodes, readInstallationCensus, workspaceSnapshot, writeWitness, } from './ensure-built-witness.js';
7
+ import { captureProducerSource, captureProducerSources, producerOutputPaths, providerReceipt, receiptNode, } from './ensure-built-receipt.js';
8
+ import { censusFileHashes, censusStart, directoryMembers, graphInstallationCensus, movedNodes, readInstallationCensus, workspaceSnapshot, writeWitness, } from './ensure-built-witness.js';
9
9
  import { graphInputContractIdentity } from './graph-input-contract.js';
10
10
  /**
11
11
  * Where a checkout keeps its producer records, relative to its root: in its own source tree, never in Nx's
@@ -79,6 +79,14 @@ function recordedTool(tools) {
79
79
  return node !== undefined && same(receiptNode(path, path), node);
80
80
  };
81
81
  }
82
+ /**
83
+ * The first tool nodes that moved since `tools` recorded them ({@link movedNodes}), or null when none did. A node whose
84
+ * ctime alone moved, and a directory whose membership may have, is compared with what `tools` recorded of it.
85
+ */
86
+ export function movedToolNodes(nodes, tools) {
87
+ const recorded = recordedTool(tools);
88
+ return movedNodes(nodes, recorded, recorded);
89
+ }
82
90
  function missing(paths) {
83
91
  return paths.every((path) => {
84
92
  try {
@@ -104,8 +112,9 @@ function targetGraph(root, target, projectGraph) {
104
112
  /**
105
113
  * The installed closure of Nx, this plugin, TypeScript and the local graph plugins as one producer tool: every node of
106
114
  * the installation census, and the module namespace each of its resolutions searched. The census is not proved by a
107
- * stat pass of its own: each of its nodes is stat-ed again as a tool node, a file whose stamp moved since the census
108
- * read it is read again, and the capture's stability check refuses a tool node that moves before publication.
115
+ * stat pass of its own, and is not read twice: a tool node takes the stat, listing and hash the census read of it
116
+ * ({@link CensusRead}), and the stability check after execution reads every tool node again and refuses one that moved
117
+ * at any point from this capture to the run's completion.
109
118
  *
110
119
  * Its value is a function of the closure's node stamps (device, inode, mode, size, mtime and ctime), not of the moment
111
120
  * it is taken. So every node is stat-ed on every call, and that is what makes reuse safe: a file whose stamp is the one
@@ -117,10 +126,11 @@ function targetGraph(root, target, projectGraph) {
117
126
  */
118
127
  export function installedClosureTool(root, nxJson, localInputs, record, resolvePackage, expand, census) {
119
128
  let installationMiss = 'unproved installed module/resolution closure';
129
+ const reads = new Map();
120
130
  performance.mark('producerReceipts:census:start');
121
131
  const installation = graphInstallationCensus(root, nxJson, resolvePackage, expand, localInputs ?? { plugins: [], packages: [], identity: '[]' }, (detail) => {
122
132
  installationMiss = detail;
123
- }, readInstallationCensus(record));
133
+ }, readInstallationCensus(record), reads);
124
134
  performance.measure('producerReceipts:census', 'producerReceipts:census:start');
125
135
  if (installation === null)
126
136
  return { ok: false, detail: `Producer installed module/resolution closure is unproved: ${installationMiss}` };
@@ -143,7 +153,7 @@ export function installedClosureTool(root, nxJson, localInputs, record, resolveP
143
153
  if (stats.isSymbolicLink())
144
154
  paths.add(realpathSync(path));
145
155
  if (stats.isDirectory())
146
- for (const name of readdirSync(path))
156
+ for (const name of directoryMembers(path))
147
157
  paths.add(join(path, name));
148
158
  }
149
159
  const resolutions = [];
@@ -159,7 +169,7 @@ export function installedClosureTool(root, nxJson, localInputs, record, resolveP
159
169
  }
160
170
  }
161
171
  const recorded = censusFileHashes(installation);
162
- const nodes = [...paths].sort().map((path) => receiptNode(path, path, census, recorded));
172
+ const nodes = [...paths].sort().map((path) => receiptNode(path, path, census, recorded, reads.get(path)));
163
173
  return {
164
174
  ok: true,
165
175
  value: {
@@ -231,9 +241,6 @@ function toolsFor(root, nxJson, projectGraph, bases) {
231
241
  sha256: sha(entries),
232
242
  });
233
243
  }
234
- const capture = movedNodes(observed, recordedTool(tools));
235
- if (capture !== null)
236
- return { ok: false, detail: `Producer tool/module namespace moved during capture: ${capture}` };
237
244
  if (!missing(module.missing))
238
245
  return { ok: false, detail: 'Producer tool/module namespace moved during capture: a missing candidate appeared' };
239
246
  return { ok: true, value: { tools, nodes: observed } };
@@ -255,7 +262,7 @@ function verifyTools(tools) {
255
262
  if (!same(nodes, tool.nodes) || sha(nodes) !== tool.sha256)
256
263
  return { ok: false, detail: `Producer tool/module bytes changed: ${tool.name}` };
257
264
  }
258
- const moved = movedNodes(observed, recordedTool(tools));
265
+ const moved = movedToolNodes(observed, tools);
259
266
  return moved === null
260
267
  ? { ok: true, value: observed }
261
268
  : { ok: false, detail: `Producer tool nodes changed during readonly validation: ${moved}` };
@@ -296,44 +303,67 @@ export async function preTasksExecution(options, context) {
296
303
  const targets = configured(options);
297
304
  if (targets.length === 0)
298
305
  return;
306
+ const rootIds = new Map();
299
307
  try {
300
308
  const load = createWorkspaceNxRequire(context.workspaceRoot);
301
- // A hook that can hold a run for minutes names its phases: Nx reports each measure under NX_PERF_LOGGING.
302
- performance.mark('producerReceipts:graph:start');
303
- const projectGraph = await load('nx/src/project-graph/project-graph').createProjectGraphAsync();
304
- performance.measure('producerReceipts:graph', 'producerReceipts:graph:start');
305
- const bases = new Map();
309
+ const projectGraph = context.projectGraph;
310
+ const graphs = new Map();
306
311
  for (const target of targets) {
307
- performance.mark('producerReceipts:source:start');
312
+ const selected = parseTargetSelector(target);
313
+ if (selected === null)
314
+ throw new Error(`Invalid declared producer target ${target}`);
308
315
  const graph = targetGraph(context.workspaceRoot, target, projectGraph);
309
- const outputs = producerOutputPaths(context.workspaceRoot, Object.values(graph.tasks), load('nx/src/native').expandOutputs);
310
- const source = captureProducerSource(context.workspaceRoot, outputs);
311
- performance.measure('producerReceipts:source', 'producerReceipts:source:start');
312
- if (!source.ok) {
313
- runs.set(context.id, source);
314
- return;
315
- }
316
- bases.set(target, { graph, source: source.value });
316
+ const root = Object.values(graph.tasks).find((task) => task.target.project === selected.project && task.target.target === selected.target);
317
+ if (root !== undefined)
318
+ rootIds.set(target, root.id);
319
+ const actual = root === undefined ? undefined : context.taskGraph.tasks[root.id];
320
+ if (actual !== undefined && defaultOverrides(actual))
321
+ graphs.set(target, graph);
322
+ }
323
+ if (graphs.size === 0) {
324
+ runs.set(context.id, { ok: false, detail: 'No default producer roots scheduled', rootIds });
325
+ return;
326
+ }
327
+ const outputs = new Map([...graphs].map(([target, graph]) => [
328
+ target,
329
+ producerOutputPaths(context.workspaceRoot, Object.values(graph.tasks), load('nx/src/native').expandOutputs),
330
+ ]));
331
+ performance.mark('producerReceipts:source:start');
332
+ const sources = captureProducerSources(context.workspaceRoot, outputs);
333
+ performance.measure('producerReceipts:source', 'producerReceipts:source:start');
334
+ if (!sources.ok) {
335
+ runs.set(context.id, { ...sources, rootIds });
336
+ return;
337
+ }
338
+ const bases = new Map();
339
+ for (const [target, graph] of graphs) {
340
+ const source = sources.value.get(target);
341
+ if (source === undefined)
342
+ throw new Error('Lost selected producer source basis');
343
+ bases.set(target, { graph, source });
317
344
  }
318
345
  performance.mark('producerReceipts:tools:start');
319
346
  const tools = toolsFor(context.workspaceRoot, context.nxJsonConfiguration, projectGraph, [...bases.values()]);
320
347
  performance.measure('producerReceipts:tools', 'producerReceipts:tools:start');
321
- runs.set(context.id, tools.ok
322
- ? {
323
- ok: true,
324
- value: {
325
- projectGraph,
326
- nxJson: context.nxJsonConfiguration,
327
- targets: bases,
328
- tools: tools.value.tools,
329
- toolNodes: tools.value.nodes,
330
- },
331
- }
332
- : tools);
348
+ runs.set(context.id, {
349
+ rootIds,
350
+ ...(tools.ok
351
+ ? {
352
+ ok: true,
353
+ value: {
354
+ projectGraph,
355
+ nxJson: context.nxJsonConfiguration,
356
+ targets: bases,
357
+ tools: tools.value.tools,
358
+ toolNodes: tools.value.nodes,
359
+ },
360
+ }
361
+ : tools),
362
+ });
333
363
  }
334
364
  catch (error) {
335
365
  if (error instanceof Error)
336
- runs.set(context.id, { ok: false, detail: error.message });
366
+ runs.set(context.id, { ok: false, detail: error.message, rootIds });
337
367
  else
338
368
  throw error;
339
369
  }
@@ -345,15 +375,12 @@ export async function postTasksExecution(options, context) {
345
375
  const selected = parseTargetSelector(target);
346
376
  if (selected === null)
347
377
  continue;
348
- const targetBasis = frame?.ok === true ? frame.value.targets.get(target) : undefined;
349
- const plannedRoot = targetBasis === undefined
350
- ? undefined
351
- : Object.values(targetBasis.graph.tasks).find((task) => task.target.project === selected.project && task.target.target === selected.target);
378
+ const plannedRoot = frame?.rootIds.get(target);
352
379
  const rootResult = plannedRoot === undefined
353
380
  ? Object.values(context.taskResults).find(({ task }) => task.target.project === selected.project &&
354
381
  task.target.target === selected.target &&
355
382
  (selected.configuration === undefined || task.target.configuration === selected.configuration))
356
- : context.taskResults[plannedRoot.id];
383
+ : context.taskResults[plannedRoot];
357
384
  if (rootResult === undefined)
358
385
  continue;
359
386
  const refuse = (detail) => {
@@ -378,9 +405,9 @@ export async function postTasksExecution(options, context) {
378
405
  }
379
406
  const tasks = completed.value;
380
407
  let detail;
381
- const execution = movedNodes(frame.value.toolNodes, recordedTool(frame.value.tools));
408
+ const execution = movedToolNodes(frame.value.toolNodes, frame.value.tools);
382
409
  if (execution !== null) {
383
- refuse(`Producer tool/module nodes changed across actual execution: ${execution}`);
410
+ refuse(`Producer tool/module nodes changed between capture and the end of execution: ${execution}`);
384
411
  continue;
385
412
  }
386
413
  const load = createWorkspaceNxRequire(context.workspaceRoot);
@@ -437,7 +464,7 @@ export async function postTasksExecution(options, context) {
437
464
  refuse(result.reason.detail);
438
465
  continue;
439
466
  }
440
- const census = movedNodes(frame.value.toolNodes, recordedTool(frame.value.tools));
467
+ const census = movedToolNodes(frame.value.toolNodes, frame.value.tools);
441
468
  if (census !== null) {
442
469
  refuse(`Producer tools changed during post-execution product census: ${census}`);
443
470
  continue;
@@ -969,7 +996,7 @@ function validatedReceipt(root, target) {
969
996
  ? 'Public product bytes differ from actual producer receipt'
970
997
  : census.reason.detail,
971
998
  };
972
- const moved = movedNodes(tools.value, recordedTool(receipt.producer.tools));
999
+ const moved = movedToolNodes(tools.value, receipt.producer.tools);
973
1000
  if (moved !== null)
974
1001
  return { ok: false, detail: `Producer tool namespace changed during independent product validation: ${moved}` };
975
1002
  return { ok: true, value: receipt };
@@ -0,0 +1,21 @@
1
+ import type { ProjectGraph } from 'nx/src/devkit-exports.js';
2
+ /** The semantic kind inference already knows, retained through Nx target merging. */
3
+ export type TaskKind = 'build' | 'test';
4
+ export declare function inferredTaskKind(name: string): TaskKind | undefined;
5
+ export interface BuildTestDependency {
6
+ /** The build whose Nx-expanded task closure contains the offending edge. */
7
+ readonly build: string;
8
+ readonly source: string;
9
+ readonly test: string;
10
+ }
11
+ export declare class BuildTestDependencyError extends Error {
12
+ readonly findings: readonly BuildTestDependency[];
13
+ constructor(findings: readonly BuildTestDependency[]);
14
+ }
15
+ /**
16
+ * Nx owns dependency normalization, wildcard/caret expansion, configurations, cycles and reachability. Expanding one
17
+ * build root returns only its reachable tasks; inspecting those edges needs no second graph traversal or name list.
18
+ */
19
+ export declare function buildTestDependencies(inputGraph: ProjectGraph, workspaceRoot: string): BuildTestDependency[];
20
+ export declare function refuseBuildTestDependencies(graph: ProjectGraph, workspaceRoot: string): void;
21
+ //# sourceMappingURL=task-graph-policy.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"task-graph-policy.d.ts","sourceRoot":"","sources":["../src/task-graph-policy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAwB,YAAY,EAAuB,MAAM,0BAA0B,CAAC;AAQxG,qFAAqF;AACrF,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,CAAC;AAExC,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS,CAGnE;AAqBD,MAAM,WAAW,mBAAmB;IAClC,4EAA4E;IAC5E,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,qBAAa,wBAAyB,SAAQ,KAAK;IACrC,QAAQ,CAAC,QAAQ,EAAE,SAAS,mBAAmB,EAAE;IAA7D,YAAqB,QAAQ,EAAE,SAAS,mBAAmB,EAAE,EAM5D;CACF;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,GAAG,mBAAmB,EAAE,CAoC5G;AAED,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,GAAG,IAAI,CAG5F"}
@@ -0,0 +1,91 @@
1
+ import { ProjectGraphBuilder } from 'nx/src/project-graph/project-graph-builder.js';
2
+ import { applyImplicitDependencies } from 'nx/src/project-graph/utils/implicit-project-dependencies.js';
3
+ import { createTaskGraph } from 'nx/src/tasks-runner/create-task-graph.js';
4
+ import { createTaskId } from 'nx/src/tasks-runner/utils.js';
5
+ import { declaredOutputs, taskConfigurations } from './build-state-output-policy.js';
6
+ import { isBuildOutputTargetName, isTestRunnerTargetName } from './workspace-config-policy.js';
7
+ export function inferredTaskKind(name) {
8
+ if (isTestRunnerTargetName(name))
9
+ return 'test';
10
+ return name === 'build' || isBuildOutputTargetName(name) ? 'build' : undefined;
11
+ }
12
+ function isTestWork(name, target) {
13
+ return inferredTaskKind(name) === 'test' || target.metadata?.smooTaskKind === 'test';
14
+ }
15
+ /** Metadata hooks precede Nx's implicit-edge pass. Reuse that pass without changing the hook's shared graph. */
16
+ function withImplicitDependencies(graph) {
17
+ const implicit = Object.entries(graph.nodes).filter(([, node]) => node.data.implicitDependencies?.length);
18
+ if (implicit.length === 0)
19
+ return graph;
20
+ const dependencies = { ...graph.dependencies };
21
+ const projects = {};
22
+ for (const [source, node] of implicit) {
23
+ dependencies[source] = [...(dependencies[source] ?? [])];
24
+ projects[source] = node.data;
25
+ }
26
+ const builder = new ProjectGraphBuilder({ ...graph, externalNodes: graph.externalNodes ?? {}, dependencies }, {}, []);
27
+ applyImplicitDependencies(projects, builder);
28
+ return builder.getUpdatedProjectGraph();
29
+ }
30
+ export class BuildTestDependencyError extends Error {
31
+ findings;
32
+ constructor(findings) {
33
+ super('Build outputs must not depend on test work:\n' +
34
+ findings.map(({ build, source, test }) => ` ${build}: ${source} -> ${test}`).join('\n'));
35
+ this.findings = findings;
36
+ this.name = 'BuildTestDependencyError';
37
+ }
38
+ }
39
+ /**
40
+ * Nx owns dependency normalization, wildcard/caret expansion, configurations, cycles and reachability. Expanding one
41
+ * build root returns only its reachable tasks; inspecting those edges needs no second graph traversal or name list.
42
+ */
43
+ export function buildTestDependencies(inputGraph, workspaceRoot) {
44
+ const graph = withImplicitDependencies(inputGraph);
45
+ const producers = new Set();
46
+ for (const output of declaredOutputs(graph, workspaceRoot)) {
47
+ const target = graph.nodes[output.project]?.data.targets?.[output.target];
48
+ if (!target)
49
+ throw new Error(`Nx output declaration has no owning target: ${output.project}:${output.target}`);
50
+ producers.add(target);
51
+ }
52
+ const findings = [];
53
+ for (const [project, node] of Object.entries(graph.nodes)) {
54
+ for (const [name, target] of Object.entries(node.data.targets ?? {})) {
55
+ if (isTestWork(name, target))
56
+ continue;
57
+ if (inferredTaskKind(name) !== 'build' && target.metadata?.smooTaskKind !== 'build' && !producers.has(target))
58
+ continue;
59
+ for (const configuration of taskConfigurations(target)) {
60
+ const tasks = createTaskGraph(graph, {}, [project], [name], configuration, {});
61
+ const build = tasks.tasks[createTaskId(project, name, configuration)];
62
+ if (!build)
63
+ throw new Error(`Nx omitted the requested build task ${project}:${name}`);
64
+ for (const edges of [tasks.dependencies, tasks.continuousDependencies ?? {}]) {
65
+ for (const [source, dependencies] of Object.entries(edges)) {
66
+ const from = tasks.tasks[source];
67
+ if (!from)
68
+ throw new Error(`Nx task edge has no source: ${source}`);
69
+ const fromTarget = graph.nodes[from.target.project]?.data.targets?.[from.target.target];
70
+ if (!fromTarget || isTestWork(from.target.target, fromTarget))
71
+ continue;
72
+ for (const test of dependencies) {
73
+ const to = tasks.tasks[test];
74
+ if (!to)
75
+ throw new Error(`Nx task edge has no dependency: ${test}`);
76
+ const toTarget = graph.nodes[to.target.project]?.data.targets?.[to.target.target];
77
+ if (toTarget && isTestWork(to.target.target, toTarget))
78
+ findings.push({ build: build.id, source, test });
79
+ }
80
+ }
81
+ }
82
+ }
83
+ }
84
+ }
85
+ return findings;
86
+ }
87
+ export function refuseBuildTestDependencies(graph, workspaceRoot) {
88
+ const findings = buildTestDependencies(graph, workspaceRoot);
89
+ if (findings.length > 0)
90
+ throw new BuildTestDependencyError(findings);
91
+ }
@@ -144,6 +144,8 @@ function shellWords(command) {
144
144
  return words;
145
145
  }
146
146
  const parseTimingManifest = (() => {
147
+ let errors;
148
+ let _report;
147
149
  const _io0 = input => "number" === typeof input.version && ("object" === typeof input.files && null !== input.files && false === Array.isArray(input.files) && _io1(input.files));
148
150
  const _io1 = input => Object.keys(input).every(key => {
149
151
  const value = input[key];
@@ -175,8 +177,6 @@ const parseTimingManifest = (() => {
175
177
  });
176
178
  }).every(flag => flag)].every(flag => flag);
177
179
  const __is = input => "object" === typeof input && null !== input && _io0(input);
178
- let errors;
179
- let _report;
180
180
  const __validate = input => {
181
181
  if (false === __is(input)) {
182
182
  errors = [];
@@ -208,6 +208,8 @@ const parseTimingManifest = (() => {
208
208
  return input => __validate(JSON.parse(input));
209
209
  })();
210
210
  const validateBunfigDiscovery = (() => {
211
+ let errors;
212
+ let _report;
211
213
  const _io0 = input => undefined === input.test || "object" === typeof input.test && null !== input.test && false === Array.isArray(input.test) && _io1(input.test);
212
214
  const _io1 = input => (undefined === input.root || "string" === typeof input.root) && (null !== input.pathIgnorePatterns && (undefined === input.pathIgnorePatterns || "string" === typeof input.pathIgnorePatterns || Array.isArray(input.pathIgnorePatterns) && input.pathIgnorePatterns.every(elem => "string" === typeof elem)));
213
215
  const _vo0 = (input, _path, _exceptionable = true) => [undefined === input.test || ("object" === typeof input.test && null !== input.test && false === Array.isArray(input.test) || _report(_exceptionable, {
@@ -241,8 +243,6 @@ const validateBunfigDiscovery = (() => {
241
243
  value: input.pathIgnorePatterns
242
244
  }))].every(flag => flag);
243
245
  const __is = input => "object" === typeof input && null !== input && false === Array.isArray(input) && _io0(input);
244
- let errors;
245
- let _report;
246
246
  return _createStandardSchema_1._createStandardSchema(input => {
247
247
  if (false === __is(input)) {
248
248
  errors = [];
@@ -52,10 +52,15 @@ export interface DuplicateScenario {
52
52
  /** Statements the two cases share: exactly, in shape, or in skeleton, by kind. */
53
53
  readonly shared: number;
54
54
  }
55
- /** A changed line range on the new side of a diff, inclusive. */
55
+ /**
56
+ * A changed line range on the new side of a diff, inclusive. A pure deletion adds no line: its range is the line before
57
+ * the deleted ones (0 at the file's start), marked `deleted`, so a check that judges the code around a change still
58
+ * sees it and one that judges added lines skips it.
59
+ */
56
60
  export interface ChangeRange {
57
61
  readonly start: number;
58
62
  readonly end: number;
63
+ readonly deleted?: true;
59
64
  }
60
65
  /** A file under a test directory, or named as a test. Rust test fns are read from any `.rs` file. */
61
66
  export declare const TEST_PATH: RegExp;
@@ -100,12 +105,16 @@ export declare function upstreamBase(root: string): GitAnswer<string>;
100
105
  * byte channel. Workspaces that never declare the check are untouched.
101
106
  */
102
107
  export declare function assertUpstreamBasePrecondition(workspaceRoot: string): void;
108
+ /** The files a change touches since a base, the new-side line ranges of each, and the files it adds. */
109
+ export interface DiffScope {
110
+ readonly files: readonly string[];
111
+ readonly changes: ReadonlyMap<string, readonly ChangeRange[]>;
112
+ /** The paths absent at the base, tracked or untracked; with rename detection off, a moved file's new path is one. */
113
+ readonly added: ReadonlySet<string>;
114
+ }
103
115
  /**
104
116
  * The files changed since `base`, tracked or untracked, and the new-side line ranges of each change; an untracked
105
117
  * file is changed throughout.
106
118
  */
107
- export declare function diffScope(root: string, base: string): GitAnswer<{
108
- readonly files: readonly string[];
109
- readonly changes: ReadonlyMap<string, readonly ChangeRange[]>;
110
- }>;
119
+ export declare function diffScope(root: string, base: string): GitAnswer<DiffScope>;
111
120
  //# sourceMappingURL=test-walk-policy.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"test-walk-policy.d.ts","sourceRoot":"","sources":["../src/test-walk-policy.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"test-walk-policy.d.ts","sourceRoot":"","sources":["../src/test-walk-policy.ts"],"names":[],"mappings":"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"}
@@ -565,6 +565,7 @@ export function formatDuplicateScenario(duplicate) {
565
565
  }
566
566
  /** Runs git without global or system configuration, so a sandboxed caller gets the same answer as its host. */
567
567
  function git(root, args) {
568
+ // eslint-disable-next-line deadline/no-unbounded-wait -- WHY unbounded: a local git query whose length is its own read of this repository: it asks no remote, and a held index.lock fails it at once rather than waiting, so only the operator's interrupt ends a hung one
568
569
  const result = spawnSync('git', args, {
569
570
  cwd: root,
570
571
  encoding: 'utf8',
@@ -672,6 +673,10 @@ export function diffScope(root, base) {
672
673
  if (!listed.ok)
673
674
  return listed;
674
675
  const untracked = new Set(listed.value.split('\0'));
676
+ const addedTracked = read(['diff', '--name-only', '--diff-filter=A', '--no-renames', '-z', base, '--']);
677
+ if (!addedTracked.ok)
678
+ return addedTracked;
679
+ const added = new Set([...addedTracked.value.split('\0'), ...untracked].filter(Boolean));
675
680
  const files = [...new Set([...changed.value.split('\0'), ...untracked].filter(Boolean))].sort();
676
681
  const changes = new Map();
677
682
  for (const file of files) {
@@ -684,8 +689,9 @@ export function diffScope(root, base) {
684
689
  return diff;
685
690
  changes.set(file, Array.from(diff.value.matchAll(/^@@ -\d+(?:,\d+)? \+(\d+)(?:,(\d+))? @@/gmu), (match) => {
686
691
  const start = Number(match[1]);
687
- return { start, end: start + Math.max(Number(match[2] ?? 1), 1) - 1 };
692
+ const count = Number(match[2] ?? 1);
693
+ return count === 0 ? { start, end: start, deleted: true } : { start, end: start + count - 1 };
688
694
  }));
689
695
  }
690
- return { ok: true, value: { files, changes } };
696
+ return { ok: true, value: { files, changes, added } };
691
697
  }
package/dist/testing.d.ts CHANGED
@@ -6,8 +6,25 @@ export interface ProcessEntry {
6
6
  readonly stat: string;
7
7
  readonly command: string;
8
8
  }
9
- /** Every process on the host, as `ps` lists it on macOS and Linux alike. */
10
- export declare function processTable(): Promise<ProcessEntry[]>;
9
+ /**
10
+ * The processes among `pids` that still exist, zombies included, as `ps -p` lists them on macOS and Linux alike, in
11
+ * `ps`'s order. Only the named processes are read.
12
+ */
13
+ export declare function processesOf(pids: readonly number[]): Promise<ProcessEntry[]>;
14
+ /**
15
+ /**
16
+ * `roots` and every process descending from one, each once, in the order found: generation by generation, each the
17
+ * children `children` lists for the pids the one before added. A pid already found is not walked again, so a reused
18
+ * pid listed as a child of its own descendant ends the walk instead of looping it. The walk reads nothing but
19
+ * `children`, and keeps a root that no longer runs: whoever reads the processes drops it.
20
+ */
21
+ export declare function walkTree(roots: readonly number[], children: (parents: readonly number[]) => Promise<readonly number[]>): Promise<number[]>;
22
+ /**
23
+ * The processes of `roots` that still exist and every process descending from one, roots first, in the order
24
+ * {@link walkTree} found them. Only those processes are read. A child forked after its parent's children were listed,
25
+ * or reparented away before, is not in it.
26
+ */
27
+ export declare function processTree(roots: readonly number[]): Promise<ProcessEntry[]>;
11
28
  /**
12
29
  * The listed processes among `pids`, and every process descending from one, each once: a pid that
13
30
  * descends from another in `pids` is not listed twice.
@@ -22,16 +39,14 @@ export declare function terminate(pid: number, signal?: NodeJS.Signals): void;
22
39
  * `timeoutMs` later is an error naming it and `owner`.
23
40
  */
24
41
  export declare function awaitExit(processes: readonly ProcessEntry[], owner: string, timeoutMs?: number): Promise<void>;
25
- /** Every process of this user whose working directory is `root` or lies beneath it, deleted or not. */
26
- export declare function pidsWorkingIn(root: string): Promise<number[]>;
27
42
  /**
28
- * Every process of this user started with `TMPDIR` set to `root` or beneath it. Such a process
29
- * writes there whatever its working directory: a ttsc plugin build copies its Go sources into
30
- * `$TMPDIR` from a process working in its project, and Node and Bun write their compile cache
31
- * there on the way out. The environment is the one the process was started with, which is the
32
- * one its children inherit unless it changed it for them.
43
+ * This process's descendants that still run, as text for a failure report about `subject`, or null when none does.
44
+ * A process is named as this process's own, never for where it works, and no caller signals anything on its word: a
45
+ * process is ended by the owner that started it, the supervisor's observed tree (specs/cowshed/11_shell.md, "Process
46
+ * identity and signal ownership"). One reparented away when its parent exited is no longer this process's to see. A
47
+ * listing that cannot be read says so instead of failing the report it serves.
33
48
  */
34
- export declare function pidsWithTempIn(root: string): Promise<number[]>;
49
+ export declare function descendantsDiagnostic(subject: string): Promise<string | null>;
35
50
  /**
36
51
  * The Nx daemon `workspace` runs, the daemon first, then every process it
37
52
  * started. Empty when the workspace records no daemon or the recorded one is
@@ -47,11 +62,12 @@ export declare function nxDaemonProcesses(workspace: string): Promise<ProcessEnt
47
62
  * is free to delete; the processes can. The daemon also leaves what it
48
63
  * spawned to end on its own: plugin workers once they see it gone, the editor
49
64
  * extension probe it starts at launch never. Those get SIGTERM with it, the
50
- * ones it started while it was stopping included. A child that outlives the
51
- * daemon is reparented to init and leaves the daemon's process tree, but it
52
- * still works in the workspace, so the workspace census ends what is left.
53
- * A missing record can mean startup has not published it yet: skip the
54
- * daemon-stop command, but never skip the working-directory census.
65
+ * ones it started while it was stopping included: the daemon's own record
66
+ * names the root, and the walk down its children the rest. A child that
67
+ * outlives the daemon is reparented and leaves that tree; it stays in the
68
+ * tree the job's supervisor observes, which ends it with the test command's
69
+ * subtree (bounded-exec). A missing record can mean startup has not published
70
+ * it yet: then nothing is stopped here.
55
71
  */
56
72
  export declare function stopNxDaemon(workspace: string, stop: () => Promise<void>): Promise<void>;
57
73
  /**
@@ -69,12 +85,13 @@ export declare function stopNxDaemon(workspace: string, stop: () => Promise<void
69
85
  */
70
86
  export declare function ownedFixtureRoot(parentDirectory: string, suite: string, prefix: string): Promise<string>;
71
87
  /**
72
- * Stop every process working in a run of `suite` under `parentDirectory` whose
73
- * owner is gone, then delete the run, and return the suite's directory there.
74
- * The first fixture root of a suite under a parent in a process does this; a
75
- * test that just watched a fixture-owning process die may too. An owner's pid
76
- * reused by an unrelated process makes its run look alive; it is reclaimed once
77
- * that process is gone too, never early.
88
+ * Delete every run of `suite` under `parentDirectory` whose owner is gone, and
89
+ * return the suite's directory there. The first fixture root of a suite under a
90
+ * parent in a process does this; a test that just watched a fixture-owning
91
+ * process die may too. An owner's pid reused by an unrelated process makes its
92
+ * run look alive; it is reclaimed once that process is gone too, never early.
93
+ * Nothing still working in a dead run is signalled here: whatever its owner
94
+ * left running belongs to that owner's subtree, which its supervisor retires.
78
95
  */
79
96
  export declare function reclaimDeadFixtureRuns(parentDirectory: string, suite: string): Promise<string>;
80
97
  /**
@@ -167,13 +184,16 @@ export declare function ownedWorkspaceSocketDirectory(workspace: string, slot: '
167
184
  export declare function retireFixtureSocketDirectory(workspace: string): Promise<void>;
168
185
  /**
169
186
  * Bind a real listener where a Cowshed job's other processes can connect to
170
- * it. In a block, `bind` is called with each candidate `base+1 … base+size-1`,
171
- * lowest first (a long-lived test listener scans from the bottom), and the
172
- * first that binds is kept: only a real bind claims a port, so nothing probes
173
- * and closes. Only `EADDRINUSE` (by `code`) moves on to the next candidate;
174
- * any other failure is that bind's own and surfaces as is, and so does the
175
- * last candidate's, so an exhausted block reports `EADDRINUSE`, never a silent
176
- * port 0. Outside a block `bind` is called with 0, and the kernel picks.
187
+ * it. In a block, `bind` is called with each service port `base+1, base+3, …
188
+ * base+size-1`, lowest first (a long-lived test listener scans from the
189
+ * bottom), and the first that binds is kept: only a real bind claims a port, so
190
+ * nothing probes and closes. Even offsets are never candidates: each is the
191
+ * session port of the service port above it, bound by that port's holder or by
192
+ * nobody (08_testing.md), which is what `claimRefusingPort` relies on. Only
193
+ * `EADDRINUSE` (by `code`) moves on to the next candidate; any other failure
194
+ * is that bind's own and surfaces as is, and so does the last candidate's, so an
195
+ * exhausted block reports `EADDRINUSE`, never a silent port 0. Outside a block
196
+ * `bind` is called with 0, and the kernel picks.
177
197
  *
178
198
  * `bind` creates and binds one listener per call and returns it, and a failed
179
199
  * bind leaves nothing behind. It may throw (`Bun.serve` does) or reject (a
@@ -182,4 +202,29 @@ export declare function retireFixtureSocketDirectory(workspace: string): Promise
182
202
  * caller's to keep and close.
183
203
  */
184
204
  export declare function bindListener<T>(bind: (port: number) => T | Promise<T>): Promise<T>;
205
+ /**
206
+ * A loopback port where nothing listens. In a port block it stays out of every other fixture's reach while it is held,
207
+ * and disposing it lets it go; outside one nothing claims it, and disposing it does nothing (`claimRefusingPort`).
208
+ */
209
+ export interface RefusingPort extends AsyncDisposable {
210
+ readonly port: number;
211
+ }
212
+ /**
213
+ * A port where nothing listens, for a client that must be refused (a cache
214
+ * server that is down). In a block it is the session port of a service port
215
+ * this process holds for as long as the claim is held: no allocator binds a
216
+ * session port but its service port's holder (08_testing.md), so a connect to
217
+ * it is refused at once, and no other test's listener takes it while the client
218
+ * is still asking. A port bound and closed would be the next lowest-first
219
+ * allocator's to bind; a socket bound and never listening is no refusal either,
220
+ * since macOS drops the SYNs it gets and the connect times out. The service
221
+ * ports start at `base+3`, because the session port of `base+1` is the
222
+ * gateway's own `base`; a block of two ports has no session port to give.
223
+ *
224
+ * Outside a block (Linux, or no Cowshed) there is no shared allocator to claim
225
+ * against, so there is no claim: the port is one the kernel picked for a
226
+ * listener this process then closed, and another process's port-0 listener may
227
+ * be given it before the client connects.
228
+ */
229
+ export declare function claimRefusingPort(): Promise<RefusingPort>;
185
230
  //# sourceMappingURL=testing.d.ts.map