@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,20 @@
1
1
  import { spawn } from 'node:child_process';
2
- import { randomUUID } from 'node:crypto';
3
2
  import { once } from 'node:events';
4
- import { chmod, rm, stat, writeFile } from 'node:fs/promises';
3
+ import { realpathSync } from 'node:fs';
4
+ import { chmod, lstat, readdir, rm, rmdir, stat } from 'node:fs/promises';
5
5
  import { basename, dirname, isAbsolute, join, relative, resolve, sep } from 'node:path';
6
-
6
+ import {
7
+ type BuildInputProducer,
8
+ type BuildInputRecord,
9
+ buildInputProducer,
10
+ buildInputRecord,
11
+ gitWorkspaceRoot,
12
+ globPathspec,
13
+ pathspecFiles,
14
+ workspacePath,
15
+ writeBuildInputs,
16
+ } from '@smoothbricks/build-inputs';
7
17
  import { readJsonFile } from 'nx/src/devkit-exports.js';
8
-
9
18
  import type { TypeScriptEmitOptions } from './schema.js';
10
19
 
11
20
  interface TypeScriptEmitContext {
@@ -17,7 +26,9 @@ interface TypeScriptEmitResult {
17
26
  }
18
27
 
19
28
  interface TsConfigJson {
20
- references?: unknown;
29
+ include?: unknown;
30
+ exclude?: unknown;
31
+ compilerOptions?: { outDir?: unknown };
21
32
  }
22
33
 
23
34
  export interface CompilerInvocation {
@@ -28,63 +39,218 @@ export interface CompilerInvocation {
28
39
 
29
40
  export type CompilerRunner = (invocation: CompilerInvocation) => Promise<boolean>;
30
41
 
42
+ /**
43
+ * What the emit changes about the project's own options: JavaScript and declarations from one non-incremental program.
44
+ * They ride the command line onto the project's tsconfig. A synthesized config would have to sit beside that tsconfig,
45
+ * because `${configDir}` and `paths` anchor to the directory of the config that consumes them, and a transient file there
46
+ * changes the directory listing a concurrent ttsc transform of another project proves while it compiles; that
47
+ * transform then refuses with `graph/accessible-entries-changed`.
48
+ */
49
+ const EMIT_OVERRIDES = [
50
+ '--composite',
51
+ 'false',
52
+ '--declaration',
53
+ 'true',
54
+ '--declarationMap',
55
+ 'true',
56
+ '--emitDeclarationOnly',
57
+ 'false',
58
+ '--incremental',
59
+ 'false',
60
+ ];
61
+
31
62
  export default function typescriptEmitExecutor(
32
63
  options: TypeScriptEmitOptions,
33
64
  context: TypeScriptEmitContext,
34
65
  ): Promise<TypeScriptEmitResult> {
35
- return runTypeScriptEmit(options, context, runCompiler);
66
+ const producer = buildInputProducer(process.env);
67
+ return runTypeScriptEmit(options, context, runCompiler, producer);
36
68
  }
37
69
 
70
+ /** Runs with the caller's compiler and task identity; only the Nx entry reads its environment. */
38
71
  export async function runTypeScriptEmit(
39
72
  options: TypeScriptEmitOptions,
40
73
  context: TypeScriptEmitContext,
41
74
  runner: CompilerRunner,
75
+ producer?: BuildInputProducer,
42
76
  ): Promise<TypeScriptEmitResult> {
43
77
  const cwd = isAbsolute(options.cwd) ? options.cwd : join(context.root, options.cwd);
44
78
  const tsConfigPath = isAbsolute(options.tsConfig) ? options.tsConfig : join(cwd, options.tsConfig);
45
79
  const tsConfig = readJsonFile<TsConfigJson>(tsConfigPath);
46
- const overlayPath = join(dirname(tsConfigPath), `.ttsc-js-${process.pid}-${randomUUID()}.json`);
47
- const overlay = {
48
- extends: `./${basename(tsConfigPath)}`,
49
- compilerOptions: {
50
- composite: false,
51
- declaration: true,
52
- declarationMap: true,
53
- emitDeclarationOnly: false,
54
- incremental: false,
55
- },
56
- ...(Array.isArray(tsConfig.references) ? { references: tsConfig.references } : {}),
80
+ const outputDirectory = emitOutputDirectory(tsConfigPath, tsConfig);
81
+
82
+ // Taken before the emit, so a source edited while it runs is recorded with its earlier bytes and reads as changed.
83
+ const inputs = outputDirectory === null ? null : typeScriptInputs(tsConfigPath, tsConfig, producer);
84
+ const previous = outputDirectory === null ? null : await snapshotOutput(outputDirectory);
85
+ const javascriptSucceeded = await runner({
86
+ command: 'ttsc',
87
+ args: ['-p', tsConfigPath, '--emit', ...EMIT_OVERRIDES],
88
+ cwd,
89
+ });
90
+ if (!javascriptSucceeded) {
91
+ return { success: false };
92
+ }
93
+
94
+ // Before the execute bits: their chmod moves a bin's ctime, as a write does.
95
+ if (previous !== null) await removeUnwritten(previous);
96
+ await makePackageBinsExecutable(cwd, options.executableOutputs ?? []);
97
+ if (outputDirectory !== null && inputs !== null) writeBuildInputs(outputDirectory, inputs);
98
+
99
+ return { success: true };
100
+ }
101
+
102
+ /**
103
+ * The config's outDir, which inference declares as the target's only Nx output. The emit owns it whole: after a
104
+ * successful emit it holds exactly what that emit wrote, so neither outDir nor the artifact Nx captures from it keeps a
105
+ * file an earlier build wrote and this one no longer does (a bin moved to another package, a deleted module). The emit
106
+ * writes outDir in place rather than into a fresh directory swapped over it: outDir's parent is usually the package
107
+ * root, whose listing a concurrent ttsc transform of a consumer proves while it compiles (EMIT_OVERRIDES). A config
108
+ * without a literal outDir emits beside its sources and owns no directory.
109
+ */
110
+ function emitOutputDirectory(tsConfigPath: string, tsConfig: TsConfigJson): string | null {
111
+ const outDir = tsConfig.compilerOptions?.outDir;
112
+ if (typeof outDir !== 'string' || outDir.length === 0) return null;
113
+ const configDirectory = dirname(tsConfigPath);
114
+ const outputDirectory = resolve(configDirectory, outDir);
115
+ if (!isInside(configDirectory, outputDirectory)) {
116
+ throw new Error(`${tsConfigPath}: compilerOptions.outDir must stay inside the project: ${outDir}`);
117
+ }
118
+ return outputDirectory;
119
+ }
120
+
121
+ /**
122
+ * A file as writes change it: a write moves its mtime and, on POSIX, its ctime (Windows reports birth time there), and a
123
+ * replacement gives it another inode.
124
+ */
125
+ interface FileIdentity {
126
+ readonly ino: bigint;
127
+ readonly ctimeNs: bigint;
128
+ readonly mtimeNs: bigint;
129
+ }
130
+
131
+ /** What outDir held before the emit: its files by identity, and its directories, each before those inside it. */
132
+ interface OutputSnapshot {
133
+ readonly files: ReadonlyMap<string, FileIdentity>;
134
+ readonly directories: readonly string[];
135
+ }
136
+
137
+ /**
138
+ * Lists outDir before the emit. A TypeScript source in it means outDir holds inputs, which no emit rewrites, so the
139
+ * snapshot refuses before the compiler runs rather than let the removal take them.
140
+ */
141
+ async function snapshotOutput(outputDirectory: string): Promise<OutputSnapshot> {
142
+ const files = new Map<string, FileIdentity>();
143
+ const directories: string[] = [];
144
+ const root = await lstat(outputDirectory).catch((error: unknown) => {
145
+ if (errorCode(error) === 'ENOENT') return null;
146
+ throw error;
147
+ });
148
+ if (root === null) return { files, directories };
149
+ // Removal follows outDir's own path only: through a link it would reach files outside the project.
150
+ if (!root.isDirectory()) throw new Error(`${outputDirectory} is the emit's outDir but is not a directory`);
151
+ const visit = async (directory: string): Promise<void> => {
152
+ for (const name of await readdir(directory)) {
153
+ const path = join(directory, name);
154
+ const stats = await lstat(path, { bigint: true });
155
+ if (stats.isDirectory()) {
156
+ directories.push(path);
157
+ await visit(path);
158
+ continue;
159
+ }
160
+ if (/\.[cm]?tsx?$/.test(name) && !/\.d\.[cm]?ts$/.test(name)) {
161
+ throw new Error(`${outputDirectory} is the emit's outDir but holds the TypeScript source ${path}`);
162
+ }
163
+ files.set(path, { ino: stats.ino, ctimeNs: stats.ctimeNs, mtimeNs: stats.mtimeNs });
164
+ }
57
165
  };
166
+ await visit(outputDirectory);
167
+ return { files, directories };
168
+ }
58
169
 
59
- await writeFile(overlayPath, `${JSON.stringify(overlay, null, 2)}\n`, { flag: 'wx' });
60
- try {
61
- const javascriptSucceeded = await runner({
62
- command: 'ttsc',
63
- args: ['-p', overlayPath, '--emit'],
64
- cwd,
170
+ /**
171
+ * Removes what the emit left as it was: each file whose identity is still the one it had before the emit, then
172
+ * each directory that removal emptied. The compiler truncates and rewrites every output of a non-incremental emit,
173
+ * unchanged bytes included (TypeScript-Go's writer opens each output O_TRUNC, and the transform hosts ttsc loads write
174
+ * through it), so an untouched file is one this emit no longer produces. The executor tests hold that contract against
175
+ * the real compiler by emitting twice.
176
+ */
177
+ async function removeUnwritten({ files, directories }: OutputSnapshot): Promise<void> {
178
+ for (const [path, before] of files) {
179
+ const now = await lstat(path, { bigint: true }).catch((error: unknown) => {
180
+ if (errorCode(error) === 'ENOENT') return null;
181
+ throw error;
65
182
  });
66
- if (!javascriptSucceeded) {
67
- return { success: false };
68
- }
183
+ const untouched =
184
+ now !== null && now.ino === before.ino && now.ctimeNs === before.ctimeNs && now.mtimeNs === before.mtimeNs;
185
+ if (untouched) await rm(path, { force: true });
186
+ }
187
+ for (const directory of [...directories].reverse()) {
188
+ await rmdir(directory).catch((error: unknown) => {
189
+ const code = errorCode(error);
190
+ if (code === 'ENOTEMPTY' || code === 'EEXIST' || code === 'ENOENT') return;
191
+ throw error;
192
+ });
193
+ }
194
+ }
69
195
 
70
- await makePackageBinsExecutable(cwd, options.executableOutputs ?? []);
196
+ function errorCode(error: unknown): unknown {
197
+ return error instanceof Error && 'code' in error ? error.code : undefined;
198
+ }
71
199
 
72
- return { success: true };
73
- } finally {
74
- await rm(overlayPath, { force: true });
75
- }
200
+ const TYPESCRIPT_SOURCES = ['ts', 'tsx', 'mts', 'cts'];
201
+
202
+ /**
203
+ * The emit's input record (build-inputs.ts) for its outDir, which is the target's Nx output: the tracked and untracked
204
+ * files the config's `include` matches less its `exclude`, and the config. `complete` carries the same pathspecs, so a
205
+ * source added since this emit is an input the consumer finds missing from the record. A config without a literal
206
+ * include gets none, nor does an emit that owns no outDir (emitOutputDirectory), and its consumers judge it by
207
+ * modification time.
208
+ */
209
+ function typeScriptInputs(
210
+ tsConfigPath: string,
211
+ tsConfig: TsConfigJson,
212
+ producer?: BuildInputProducer,
213
+ ): BuildInputRecord | null {
214
+ const strings = (value: unknown) =>
215
+ Array.isArray(value) ? value.filter((entry): entry is string => typeof entry === 'string') : [];
216
+ const include = strings(tsConfig.include);
217
+ if (include.length === 0) return null;
218
+ const configDirectory = realpathSync(dirname(tsConfigPath));
219
+ const workspaceRoot = gitWorkspaceRoot(configDirectory);
220
+ if (workspaceRoot === null) return null;
221
+ const prefix = workspacePath(workspaceRoot, configDirectory);
222
+ // tsconfig names a directory to mean the TypeScript sources under it.
223
+ const globs = (entry: string) =>
224
+ /[*?[]/.test(entry) || /\.[a-z]+$/.test(entry)
225
+ ? [entry]
226
+ : TYPESCRIPT_SOURCES.map((extension) => `${entry.replace(/\/$/, '')}/**/*.${extension}`);
227
+ const spec = (entry: string, exclude: boolean) =>
228
+ globs(entry).map((glob) => globPathspec(prefix === '.' ? glob : `${prefix}/${glob}`, exclude));
229
+ const complete = [
230
+ ...include.flatMap((entry) => spec(entry, false)),
231
+ ...strings(tsConfig.exclude).flatMap((entry) => spec(entry, true)),
232
+ ];
233
+ return buildInputRecord(
234
+ workspaceRoot,
235
+ [
236
+ ...pathspecFiles(workspaceRoot, complete),
237
+ workspacePath(workspaceRoot, join(configDirectory, basename(tsConfigPath))),
238
+ ],
239
+ complete,
240
+ producer,
241
+ );
242
+ }
243
+
244
+ /** Whether `path` lies strictly beneath `directory`. */
245
+ function isInside(directory: string, path: string): boolean {
246
+ const beneath = relative(directory, path);
247
+ return beneath.length > 0 && beneath !== '..' && !beneath.startsWith(`..${sep}`) && !isAbsolute(beneath);
76
248
  }
77
249
 
78
250
  async function makePackageBinsExecutable(cwd: string, outputs: readonly string[]): Promise<void> {
79
251
  for (const output of new Set(outputs)) {
80
252
  const outputPath = resolve(cwd, output);
81
- const projectRelative = relative(cwd, outputPath);
82
- if (
83
- projectRelative.length === 0 ||
84
- projectRelative === '..' ||
85
- projectRelative.startsWith(`..${sep}`) ||
86
- isAbsolute(projectRelative)
87
- ) {
253
+ if (!isInside(cwd, outputPath)) {
88
254
  throw new Error(`Executable output must stay inside the project: ${output}`);
89
255
  }
90
256
  const outputStat = await stat(outputPath);
@@ -102,6 +268,7 @@ async function runCompiler(invocation: CompilerInvocation): Promise<boolean> {
102
268
  windowsHide: true,
103
269
  });
104
270
  try {
271
+ // eslint-disable-next-line deadline/no-unbounded-wait -- WHY unbounded: a TypeScript emit lasts as long as its work; the operator's interrupt or the enclosing runner's bound ends a hung one
105
272
  await once(child, 'exit');
106
273
  return child.exitCode === 0 && child.signalCode === null;
107
274
  } catch (error) {
@@ -0,0 +1,226 @@
1
+ // FORBIDDEN-SPELLING: the AGENTS.md workarounds that have one spelling, judged on the lines a change adds. A rule here
2
+ // refuses a NEW site and removes none: existing sites need no allowance table, and the fixture source builds each
3
+ // forbidden spelling at runtime, so no repository file needs an exemption from the boundary it tests. The rules are
4
+ // pure (no I/O, no clock); `findForbiddenSpellings` is the shell that reads the files a `diffScope` names.
5
+ //
6
+ // What it cannot do. It reads one line at a time, so an argv list split across lines is judged by its first line only,
7
+ // and a quoted program whose arguments live in a variable (`probe('lsof', args)`) shows no option to judge: a quoted
8
+ // census is refused only where the line itself names a selecting option and no scoping one, while an unquoted shell
9
+ // command (`lsof | head`, `pgrep node`, `run: lsof`) is a census unless it names a pid scope. A spelling assembled at
10
+ // runtime or passed through a variable is invisible; a trailing comment is part of its code line; prose in a string
11
+ // literal that sits in command position reads as a command; a ledger kept inside a file with another name is not seen.
12
+ // Comment-only lines, Markdown and binary or generated text (`NOT_SCANNED`) are not read at all. A pure deletion
13
+ // changes no line it keeps, so its range is marked and no line rule judges it.
14
+ import { lstatSync, readFileSync } from 'node:fs';
15
+ import { join } from 'node:path';
16
+ import type { ChangeRange, DiffScope } from './test-walk-policy.js';
17
+
18
+ export type LineRuleId = 'NO-SKIP-NX-CACHE' | 'NO-HOST-CENSUS';
19
+ export type PathRuleId = 'NO-WAIVER-LEDGER';
20
+ export type SpellingRuleId = LineRuleId | PathRuleId;
21
+
22
+ export interface SpellingRule {
23
+ readonly id: SpellingRuleId;
24
+ /** The AGENTS.md rule this check enforces, by name. */
25
+ readonly rule: 'Diagnosis' | 'Proof' | 'Workarounds';
26
+ readonly message: string;
27
+ readonly help: string;
28
+ }
29
+
30
+ export const SPELLING_RULES: Readonly<Record<SpellingRuleId, SpellingRule>> = {
31
+ 'NO-SKIP-NX-CACHE': {
32
+ id: 'NO-SKIP-NX-CACHE',
33
+ rule: 'Diagnosis',
34
+ message: 'a cache bypass manufactures a pass',
35
+ help:
36
+ 'A task that passes only with the Nx cache bypassed has a broken input, output or dependency declaration. ' +
37
+ 'Repair that at its owner; never bypass the cache, not even to diagnose.',
38
+ },
39
+ 'NO-HOST-CENSUS': {
40
+ id: 'NO-HOST-CENSUS',
41
+ rule: 'Proof',
42
+ message: 'a walk of the whole host reads processes nobody gave this code',
43
+ help:
44
+ 'Start from pids the caller holds (a child it spawned, a daemon record) and read exactly those with `ps -p`, ' +
45
+ '`lsof -p` or `pgrep -P`. A host-wide census asks every process, and one in an uninterruptible kernel wait ' +
46
+ 'holds the census with it; a signal chosen by name reaches a peer’s processes.',
47
+ },
48
+ 'NO-WAIVER-LEDGER': {
49
+ id: 'NO-WAIVER-LEDGER',
50
+ rule: 'Workarounds',
51
+ message: 'a new ledger of known-broken sites is a waiver list',
52
+ help:
53
+ 'Fix the sites. A check that cannot pass on the current tree judges the lines a change adds instead, so it needs ' +
54
+ 'no list of current offenders; only an existing ledger may shrink.',
55
+ },
56
+ };
57
+
58
+ /** Every line rule, in the order a line's findings are reported. */
59
+ export const LINE_RULES: readonly LineRuleId[] = ['NO-SKIP-NX-CACHE', 'NO-HOST-CENSUS'];
60
+
61
+ export interface SpellingFinding {
62
+ readonly id: SpellingRuleId;
63
+ readonly line: number;
64
+ readonly column: number;
65
+ readonly text: string;
66
+ }
67
+
68
+ /** A finding in one file of a change. */
69
+ export interface FileSpellingFinding extends SpellingFinding {
70
+ readonly file: string;
71
+ }
72
+
73
+ // Prose and recorded data quote the forbidden forms as policy or history; every other text surface is read, including
74
+ // extensionless scripts and dot-configs. Patches carry upstream text, lock files and logs carry tool output.
75
+ const NOT_SCANNED =
76
+ /\.(?:mdx?|txt|lock|log|svgz?|png|jpe?g|gif|webp|ico|pdf|woff2?|ttf|otf|mp[34]|mov|zip|gz|zst|wasm|a|so|dylib|dll|exe|db|sqlite|patch|diff|jsonl)$/u;
77
+
78
+ /** A line that is only a comment: `//`, `/*`, a block continuation `* text`, `# text` and `<!--`. */
79
+ const COMMENT_ONLY = /^\s*(?:\/\/|\/\*|\*(?:\s|\/|$)|#(?:\s|$)|<!--)/u;
80
+
81
+ // Each pattern spells its own subject through a one-letter class (`[c]ache`), so the pattern's source line does not
82
+ // match the pattern.
83
+ const SKIP_CACHE_FLAG =
84
+ /(?<![\w-])--(?:skip-nx-[c]ache|disable-nx-[c]ache|skipNx[C]ache|disableNx[C]ache)(?![\w-]|=(?:false|0)\b)/u;
85
+ // Nx honors the switch only as the string `true`: a shell assignment, a property write, or an object, YAML or JSON key.
86
+ const SKIP_CACHE_ENV = /(?<!\w)NX_(?:SKIP|DISABLE)_NX_[C]ACHE["']?\s*[=:]\s*["']?true\b/u;
87
+ const PROC_LISTING =
88
+ /(?:read_dir|readdir(?:Sync)?|listdir|scandir|iterdir|glob(?:Sync)?)\s*\(\s*(?:Path::new\(\s*)?["']\/proc\/?["']|(?<![\w/.-])(?:ls|find)(?:\s+[^\s|;&]+)*?\s+\/proc\/?(?=\s|$)/u;
89
+
90
+ /**
91
+ * A program in command position (group 1 is what leads it): line start, a YAML `- ` or `key: ` prefix, a shell separator,
92
+ * `sudo`/`exec`/`env`/`xargs` with their options and assignments, or a quote (an argv element or a quoted shell string).
93
+ */
94
+ const CENSUS_PROGRAM =
95
+ /(^\s*(?:-\s+)?(?:[\w.-]+:\s+)?|[;&|({`'"]\s*|\$\(\s*|\b(?:sudo|exec|env|xargs|command)\s+(?:-\S+\s+|\w+=\S*\s+)*)(?:\/(?:usr\/(?:local\/)?)?s?bin\/)?(ps|l[s]of|pg[r]ep|p[k]ill|kill[a]ll)(?=$|[\s;&|)}`'",\]])/gu;
96
+
97
+ /** The words after a program, up to the end of its pipeline segment: shell words and argv elements alike. */
98
+ function argumentWords(rest: string): string[] {
99
+ const segment = rest.split(/[;&|]/u, 1)[0] ?? '';
100
+ return segment.split(/[\s,[\]()'"`]+/u).filter((word) => word !== '');
101
+ }
102
+
103
+ /**
104
+ * Whether `program` called with the words visible on its line reads every process of the host rather than pids the
105
+ * caller holds: a selecting option and no scoping one (`-p`, `-P`, `-g`, `--pid`). `bare` is an unquoted shell command,
106
+ * where `lsof` and `pgrep` select every process unless a pid scope says otherwise; a quoted program may take its
107
+ * arguments from a variable, so it needs a visible selecting option. A signal chosen by name is refused wherever it is
108
+ * spelled in command position.
109
+ */
110
+ export function readsWholeHost(program: string, words: readonly string[], bare: boolean): boolean {
111
+ const clusters = words.flatMap((word) => (/^-[A-Za-z]+$/u.test(word) ? [word.slice(1)] : []));
112
+ const has = (letters: RegExp): boolean => clusters.some((cluster) => letters.test(cluster));
113
+ const long = (names: RegExp): boolean => words.some((word) => names.test(word));
114
+ if (/^(?:p[k]ill|kill[a]ll)$/u.test(program)) return true;
115
+ switch (program) {
116
+ case 'pgrep':
117
+ return (bare || clusters.length > 0) && !has(/[PgGs]/u) && !long(/^--(?:parent|pgroup|session)/u);
118
+ case 'lsof':
119
+ // `-p` takes the pids; `-nP` is not `-p`, `-p123` and `-ap` are.
120
+ return (
121
+ (bare || clusters.length > 0 || words.some((word) => /^\+[Dd]$/u.test(word))) &&
122
+ !words.some((word) => /^-(?:[A-Za-z]*p|p\S+)$/u.test(word))
123
+ );
124
+ case 'ps': {
125
+ // BSD spelling `ps aux`: a first word of selection letters with no dash.
126
+ const first = words[0] ?? '';
127
+ const bsd = /^[auxwfeElLjvr]+$/u.test(first) && /[aex]/u.test(first);
128
+ return !(has(/[pg]/u) || long(/^--(?:pid|ppid|sid|group)/u)) && (has(/[AaeExu]/u) || bsd);
129
+ }
130
+ default:
131
+ return false;
132
+ }
133
+ }
134
+
135
+ function censusColumn(line: string): number | undefined {
136
+ for (const match of line.matchAll(CENSUS_PROGRAM)) {
137
+ const program = match[2] ?? '';
138
+ const start = match.index ?? 0;
139
+ const words = argumentWords(line.slice(start + match[0].length));
140
+ if (readsWholeHost(program, words, !/['"`]\s*$/u.test(match[1] ?? '')))
141
+ return start + match[0].lastIndexOf(program);
142
+ }
143
+ return PROC_LISTING.exec(line)?.index;
144
+ }
145
+
146
+ function lineColumn(id: LineRuleId, line: string): number | undefined {
147
+ switch (id) {
148
+ case 'NO-SKIP-NX-CACHE':
149
+ return (SKIP_CACHE_FLAG.exec(line) ?? SKIP_CACHE_ENV.exec(line))?.index;
150
+ case 'NO-HOST-CENSUS':
151
+ return censusColumn(line);
152
+ }
153
+ }
154
+
155
+ /** The text of one file the rules read: not prose, not data, not a binary. */
156
+ export function isScanned(path: string): boolean {
157
+ return !NOT_SCANNED.test(path);
158
+ }
159
+
160
+ /** The line rules' findings in `source`, on the lines `ranges` name only. */
161
+ export function findLineSpellings(
162
+ source: string,
163
+ ranges: readonly ChangeRange[],
164
+ ids: readonly LineRuleId[],
165
+ ): SpellingFinding[] {
166
+ if (source.includes('\0')) return [];
167
+ const findings: SpellingFinding[] = [];
168
+ for (const [index, text] of source.split('\n').entries()) {
169
+ const line = index + 1;
170
+ if (!ranges.some((range) => range.deleted !== true && line >= range.start && line <= range.end)) continue;
171
+ if (COMMENT_ONLY.test(text)) continue;
172
+ for (const id of ids) {
173
+ const column = lineColumn(id, text);
174
+ if (column !== undefined) findings.push({ id, line, column: column + 1, text: text.trim() });
175
+ }
176
+ }
177
+ return findings;
178
+ }
179
+
180
+ const LEDGER_PATH = /(?:^|\/)[^/]*(?:\.ledger\.[A-Za-z]+|known-(?:broken|failures)[^/]*)$/u;
181
+
182
+ /** A path rule's finding for a file this change adds. */
183
+ export function findAddedPathSpelling(path: string): SpellingFinding | undefined {
184
+ return LEDGER_PATH.test(path) ? { id: 'NO-WAIVER-LEDGER', line: 1, column: 1, text: path } : undefined;
185
+ }
186
+
187
+ /** A complete scan, or the exact input whose inspection was unavailable. */
188
+ export type ForbiddenSpellingScan =
189
+ | { readonly kind: 'scanned'; readonly findings: readonly FileSpellingFinding[] }
190
+ | { readonly kind: 'unavailable'; readonly file: string; readonly detail: string };
191
+
192
+ /**
193
+ * Every rule's findings in the change `scope` names, under `root`: the path rule on each file the change adds, and the
194
+ * line rules on the changed lines of each scanned regular file. A missing path is inactive (a deleted file), a symlink
195
+ * or directory is not read, and a binary is skipped; every other I/O failure makes the whole scan unavailable.
196
+ */
197
+ export function findForbiddenSpellings(root: string, scope: DiffScope): ForbiddenSpellingScan {
198
+ const findings: FileSpellingFinding[] = [];
199
+ for (const file of scope.files) {
200
+ const added = scope.added.has(file) ? findAddedPathSpelling(file) : undefined;
201
+ if (added !== undefined) findings.push({ file, ...added });
202
+ const ranges = scope.changes.get(file);
203
+ if (ranges === undefined || !isScanned(file)) continue;
204
+ let source: string;
205
+ try {
206
+ const path = join(root, file);
207
+ if (!lstatSync(path).isFile()) continue;
208
+ source = readFileSync(path, 'utf8');
209
+ } catch (error) {
210
+ if (error instanceof Error && 'code' in error && error.code === 'ENOENT') continue;
211
+ return { kind: 'unavailable', file, detail: error instanceof Error ? error.message : String(error) };
212
+ }
213
+ for (const finding of findLineSpellings(source, ranges, LINE_RULES)) findings.push({ file, ...finding });
214
+ }
215
+ return { kind: 'scanned', findings };
216
+ }
217
+
218
+ /** One finding in the shape every check of this tree prints. */
219
+ export function formatSpellingFinding(file: string, finding: SpellingFinding): string {
220
+ const rule = SPELLING_RULES[finding.id];
221
+ return (
222
+ `error[${rule.id}]: ${rule.message}: ${finding.text}\n` +
223
+ ` --> ${file}:${finding.line}:${finding.column}\n` +
224
+ ` = help: AGENTS.md ${rule.rule} rule. ${rule.help}`
225
+ );
226
+ }
@@ -1,7 +1,11 @@
1
1
  // Scaffold TypeScript libraries and Rust workspaces through one convention-owned generator.
2
2
  // CLI wiring: packages/cli/src/generate/index.ts (variant registry)
3
3
  import { readJson, type Tree, writeJson } from 'nx/src/devkit-exports.js';
4
- import { BOUNDED_TEST_IDLE_TIMEOUT_MS, BOUNDED_TEST_KILL_AFTER_MS } from '../../bounded-test-policy.js';
4
+ import {
5
+ BOUNDED_TEST_IDLE_TIMEOUT_MS,
6
+ BOUNDED_TEST_KILL_AFTER_MS,
7
+ BUN_TEST_TIMEOUT_FLAG,
8
+ } from '../../bounded-test-policy.js';
5
9
  import { renderCargoDevProfiles } from '../../cargo-dev-profile.js';
6
10
 
7
11
  import type { CreatePackageGeneratorSchema } from './schema.js';
@@ -83,10 +87,7 @@ function writeTypeScriptFiles(
83
87
  references: [{ path: './tsconfig.lib.json' }],
84
88
  });
85
89
 
86
- tree.write(
87
- `${projectRoot}/bunfig.toml`,
88
- '[test]\ntimeout = 30000\npreload = ["@smoothbricks/validation/bun/preload"]\n',
89
- );
90
+ tree.write(`${projectRoot}/bunfig.toml`, '[test]\npreload = ["@smoothbricks/validation/bun/preload"]\n');
90
91
 
91
92
  tree.write(`${projectRoot}/src/index.ts`, '');
92
93
  }
@@ -109,7 +110,6 @@ function buildTypeScriptPackageJson(
109
110
  './package.json': './package.json',
110
111
  '.': {
111
112
  types: './dist/index.d.ts',
112
- development: './src/index.ts',
113
113
  import: './dist/index.js',
114
114
  default: './dist/index.js',
115
115
  },
@@ -131,7 +131,7 @@ function buildTypeScriptPackageJson(
131
131
  test: {
132
132
  executor: '@smoothbricks/nx-plugin:bounded-exec',
133
133
  options: {
134
- command: 'bun test',
134
+ command: `bun test ${BUN_TEST_TIMEOUT_FLAG}`,
135
135
  cwd: '{projectRoot}',
136
136
  idleTimeoutMs: BOUNDED_TEST_IDLE_TIMEOUT_MS,
137
137
  killAfterMs: BOUNDED_TEST_KILL_AFTER_MS,
@@ -154,6 +154,49 @@ function contractOf(options: unknown): GraphInputContract | null {
154
154
  ? contract
155
155
  : null;
156
156
  }
157
+ /**
158
+ * The SHA-256 of each preload audited to leave graph evaluation alone. A preload's own bytes are not its whole input: it
159
+ * can load more code and read more files. So only an audited one is bounded, and every other loader stays opaque.
160
+ * The one entry is cowshed's port-0 preload (`packages/cowshed/crates/cowshed-core/src/port_zero.cjs`), which loads only
161
+ * Node and Bun builtins, reads no file and no variable but `COWSHED_PORT_BASE` and `COWSHED_PORT_BLOCK_SIZE`, and changes
162
+ * only which port a listener or a child's inspector takes. A changed preload is unaudited until its digest is added here.
163
+ */
164
+ export const AUDITED_PRELOADS: ReadonlySet<string> = new Set([
165
+ '8e4a5d9aeba854edf74b64b732392bf680e1831a80607e5d1b4aeace002205d2',
166
+ ]);
167
+
168
+ /** Each runtime's options variable and the one flag in it whose argument is a file the runtime preloads. */
169
+ const PRELOAD_FLAGS = [
170
+ ['NODE_OPTIONS', '--require'],
171
+ ['BUN_OPTIONS', '--preload'],
172
+ ] as const;
173
+
174
+ /**
175
+ * The files a loader variable preloads when it holds nothing but `flag <file>` or `flag=<file>` clauses, or null for
176
+ * any other text: another flag, a stray word, a flag without its file. Quoting is not parsed, so a quote or a backslash
177
+ * makes the variable opaque too.
178
+ */
179
+ export function loaderPreloads(value: string, flag: '--require' | '--preload'): string[] | null {
180
+ if (/["'\\]/.test(value)) return null;
181
+ const files: string[] = [];
182
+ let awaitingFile = false;
183
+ for (const token of value.split(/\s+/)) {
184
+ if (token === '') continue;
185
+ if (awaitingFile) {
186
+ if (token.startsWith('-')) return null;
187
+ files.push(token);
188
+ awaitingFile = false;
189
+ } else if (token === flag) {
190
+ awaitingFile = true;
191
+ } else if (token.startsWith(`${flag}=`) && token.length > flag.length + 1) {
192
+ files.push(token.slice(flag.length + 1));
193
+ } else {
194
+ return null;
195
+ }
196
+ }
197
+ return awaitingFile ? null : files;
198
+ }
199
+
157
200
  function witnessPath(root: string, plugin: string): string {
158
201
  return join(dataDirectory(root), `graph-input-${digest(plugin)}.json`);
159
202
  }
@@ -161,6 +204,7 @@ function gitEnvironment(): NodeJS.ProcessEnv {
161
204
  return { ...process.env, GIT_CONFIG_GLOBAL: '/dev/null', GIT_CONFIG_NOSYSTEM: '1' };
162
205
  }
163
206
  function gitQuery(path: string, query: Pick<GitQueryWitness, 'cwd' | 'args' | 'stdin'>): string {
207
+ // eslint-disable-next-line deadline/no-unbounded-wait -- WHY unbounded: a local git query: 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
164
208
  return execFileSync(path, ['-c', 'core.excludesFile=/dev/null', ...query.args], {
165
209
  cwd: query.cwd,
166
210
  env: gitEnvironment(),
@@ -205,7 +249,20 @@ export class GraphInputReadCollector {
205
249
  this.refuse('Bun runtime is not the PATH-selected executable');
206
250
  }
207
251
  if (!this.before.stable) this.refuse('native file list contains an unproved node');
208
- for (const name of ['NODE_OPTIONS', 'BUN_OPTIONS', 'LD_PRELOAD', 'DYLD_INSERT_LIBRARIES']) {
252
+ // A preload clause names one file the runtime loads: an audited preload is witnessed like any
253
+ // read, and anything else is opaque. A cowshed job preloads its port-0 module this way.
254
+ for (const [name, flag] of PRELOAD_FLAGS) {
255
+ const value = process.env[name];
256
+ if (!value) continue;
257
+ const files = loaderPreloads(value, flag);
258
+ if (files === null) this.refuse(`unbounded loader environment: ${name}`);
259
+ else
260
+ for (const file of files) {
261
+ this.file(file);
262
+ if (!AUDITED_PRELOADS.has(digest(readFileSync(file)))) this.refuse(`unaudited preload in ${name}: ${file}`);
263
+ }
264
+ }
265
+ for (const name of ['LD_PRELOAD', 'DYLD_INSERT_LIBRARIES']) {
209
266
  if (process.env[name]) this.refuse(`unbounded loader environment: ${name}`);
210
267
  }
211
268
  } catch (error) {
@@ -391,6 +448,7 @@ export class GraphInputReadCollector {
391
448
  this.gitQueries.push({ ...splitIndex, sha256: digest(sharedIndex) });
392
449
  if (sharedIndex.trim() !== '') this.observe(resolve(scope, sharedIndex.trim()));
393
450
  for (const name of ['index', 'info/exclude', 'info/attributes']) {
451
+ // eslint-disable-next-line deadline/no-unbounded-wait -- WHY unbounded: a local git path lookup: 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
394
452
  const path = execFileSync(tool, ['-c', 'core.excludesFile=/dev/null', 'rev-parse', '--git-path', name], {
395
453
  cwd: scope,
396
454
  env: gitEnvironment(),
@@ -410,7 +468,7 @@ export class GraphInputReadCollector {
410
468
  const attributes: Pick<GitQueryWitness, 'cwd' | 'args' | 'stdin'> = {
411
469
  cwd: scope,
412
470
  args: ['check-attr', '--all', '-z', '--stdin'],
413
- stdin: names.map((path) => path + '\0').join(''),
471
+ stdin: names.map((path) => `${path}\0`).join(''),
414
472
  };
415
473
  this.gitQueries.push({ ...attributes, sha256: digest(gitQuery(tool, attributes)) });
416
474
  });
@@ -579,6 +637,7 @@ export function graphInputContractIdentity(
579
637
  if (bun === undefined) return null;
580
638
  const recipe =
581
639
  "console.log(JSON.stringify(JSON.parse(require('node:fs').readFileSync(0,'utf8')).map(({from,specifier})=>{try{return require('node:fs').realpathSync(Bun.resolveSync(specifier,from))}catch{return null}})))";
640
+ // eslint-disable-next-line deadline/no-unbounded-wait -- WHY unbounded: bun resolves the specifiers on its stdin from the filesystem and exits; it waits on no other process
582
641
  const actual = execFileSync(bun.path, ['--eval', recipe], {
583
642
  input: JSON.stringify(bunResolutions),
584
643
  cwd: root,