@smoothbricks/nx-plugin 0.5.7 → 0.6.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (446) hide show
  1. package/README.md +1097 -360
  2. package/dist/.build-inputs.json +141 -0
  3. package/dist/bin/smoo-nx-cargo-toolchain.d.ts +3 -0
  4. package/dist/bin/smoo-nx-cargo-toolchain.d.ts.map +1 -0
  5. package/dist/bin/smoo-nx-cargo-toolchain.js +8 -0
  6. package/dist/bin/smoo-nx-forbidden-spellings.d.ts +3 -0
  7. package/dist/bin/smoo-nx-forbidden-spellings.d.ts.map +1 -0
  8. package/dist/bin/smoo-nx-forbidden-spellings.js +32 -0
  9. package/dist/bin/smoo-nx-nextest-timings.d.ts +3 -0
  10. package/dist/bin/smoo-nx-nextest-timings.d.ts.map +1 -0
  11. package/dist/bin/smoo-nx-nextest-timings.js +28 -0
  12. package/dist/bounded-test-policy.d.ts +1 -1
  13. package/dist/bounded-test-policy.d.ts.map +1 -1
  14. package/dist/bounded-test-policy.js +14 -15
  15. package/dist/build-state-output-policy.d.ts +95 -1
  16. package/dist/build-state-output-policy.d.ts.map +1 -1
  17. package/dist/build-state-output-policy.js +368 -30
  18. package/dist/bun-lock-scope.d.ts +44 -0
  19. package/dist/bun-lock-scope.d.ts.map +1 -0
  20. package/dist/bun-lock-scope.js +97 -0
  21. package/dist/cargo-build-script-env.d.ts +49 -0
  22. package/dist/cargo-build-script-env.d.ts.map +1 -0
  23. package/dist/cargo-build-script-env.js +324 -0
  24. package/dist/cargo-closure-input.d.ts +31 -4
  25. package/dist/cargo-closure-input.d.ts.map +1 -1
  26. package/dist/cargo-closure-input.js +66 -6
  27. package/dist/cargo-retention-hook.d.ts +17 -0
  28. package/dist/cargo-retention-hook.d.ts.map +1 -0
  29. package/dist/cargo-retention-hook.js +85 -0
  30. package/dist/cargo-source-hash.d.ts +25 -7
  31. package/dist/cargo-source-hash.d.ts.map +1 -1
  32. package/dist/cargo-source-hash.js +108 -43
  33. package/dist/cargo-toolchain-paths.d.ts +40 -0
  34. package/dist/cargo-toolchain-paths.d.ts.map +1 -0
  35. package/dist/cargo-toolchain-paths.js +84 -0
  36. package/dist/cargo-toolchain-policy.d.ts +25 -8
  37. package/dist/cargo-toolchain-policy.d.ts.map +1 -1
  38. package/dist/cargo-toolchain-policy.js +39 -5
  39. package/dist/cargo-workspace.d.ts +10 -4
  40. package/dist/cargo-workspace.d.ts.map +1 -1
  41. package/dist/cargo-workspace.js +65 -95
  42. package/dist/cross-check-policy.d.ts +9 -9
  43. package/dist/cross-check-policy.d.ts.map +1 -1
  44. package/dist/cross-check-policy.js +11 -11
  45. package/dist/disk-command-policy.d.ts.map +1 -1
  46. package/dist/disk-command-policy.js +1 -0
  47. package/dist/ensure-built-receipt.d.ts +22 -5
  48. package/dist/ensure-built-receipt.d.ts.map +1 -1
  49. package/dist/ensure-built-receipt.js +168 -48
  50. package/dist/ensure-built-witness.d.ts +27 -8
  51. package/dist/ensure-built-witness.d.ts.map +1 -1
  52. package/dist/ensure-built-witness.js +45 -15
  53. package/dist/ensure-built.d.ts.map +1 -1
  54. package/dist/ensure-built.js +9 -1
  55. package/dist/eslint-config-closure.d.ts +7 -0
  56. package/dist/eslint-config-closure.d.ts.map +1 -0
  57. package/dist/eslint-config-closure.js +346 -0
  58. package/dist/executors/bounded-exec/bounds.d.ts +56 -0
  59. package/dist/executors/bounded-exec/bounds.d.ts.map +1 -0
  60. package/dist/executors/bounded-exec/bounds.js +43 -0
  61. package/dist/executors/bounded-exec/cpu-pool-thread.d.ts +28 -0
  62. package/dist/executors/bounded-exec/cpu-pool-thread.d.ts.map +1 -0
  63. package/dist/executors/bounded-exec/cpu-pool-thread.js +20 -0
  64. package/dist/executors/bounded-exec/cpu-pool.d.ts +35 -38
  65. package/dist/executors/bounded-exec/cpu-pool.d.ts.map +1 -1
  66. package/dist/executors/bounded-exec/cpu-pool.js +56 -120
  67. package/dist/executors/bounded-exec/executor.d.ts +19 -12
  68. package/dist/executors/bounded-exec/executor.d.ts.map +1 -1
  69. package/dist/executors/bounded-exec/executor.js +389 -239
  70. package/dist/executors/bounded-exec/gateway-lease.d.ts +23 -19
  71. package/dist/executors/bounded-exec/gateway-lease.d.ts.map +1 -1
  72. package/dist/executors/bounded-exec/gateway-lease.js +102 -29
  73. package/dist/executors/bounded-exec/hang-diagnostics.d.ts +18 -1
  74. package/dist/executors/bounded-exec/hang-diagnostics.d.ts.map +1 -1
  75. package/dist/executors/bounded-exec/hang-diagnostics.js +148 -30
  76. package/dist/executors/bounded-exec/lease-wait.d.ts +64 -0
  77. package/dist/executors/bounded-exec/lease-wait.d.ts.map +1 -0
  78. package/dist/executors/bounded-exec/lease-wait.js +72 -0
  79. package/dist/executors/bounded-exec/lock-wait.d.ts +51 -0
  80. package/dist/executors/bounded-exec/lock-wait.d.ts.map +1 -0
  81. package/dist/executors/bounded-exec/lock-wait.js +108 -0
  82. package/dist/executors/bounded-exec/mbx-pool.d.ts +31 -0
  83. package/dist/executors/bounded-exec/mbx-pool.d.ts.map +1 -0
  84. package/dist/executors/bounded-exec/mbx-pool.js +24 -0
  85. package/dist/executors/bounded-exec/owned-subtree.d.ts +84 -0
  86. package/dist/executors/bounded-exec/owned-subtree.d.ts.map +1 -0
  87. package/dist/executors/bounded-exec/owned-subtree.js +178 -0
  88. package/dist/executors/bounded-exec/progress.d.ts +4 -1
  89. package/dist/executors/bounded-exec/progress.d.ts.map +1 -1
  90. package/dist/executors/bounded-exec/progress.js +5 -2
  91. package/dist/executors/bounded-exec/ram-attach.d.ts +19 -0
  92. package/dist/executors/bounded-exec/ram-attach.d.ts.map +1 -0
  93. package/dist/executors/bounded-exec/ram-attach.js +207 -0
  94. package/dist/executors/bounded-exec/ram-detach.d.ts +25 -0
  95. package/dist/executors/bounded-exec/ram-detach.d.ts.map +1 -0
  96. package/dist/executors/bounded-exec/ram-detach.js +207 -0
  97. package/dist/executors/bounded-exec/ram-temp-fixtures.d.ts +76 -0
  98. package/dist/executors/bounded-exec/ram-temp-fixtures.d.ts.map +1 -1
  99. package/dist/executors/bounded-exec/ram-temp-fixtures.js +296 -0
  100. package/dist/executors/bounded-exec/ram-temp.d.ts +388 -88
  101. package/dist/executors/bounded-exec/ram-temp.d.ts.map +1 -1
  102. package/dist/executors/bounded-exec/ram-temp.js +1213 -399
  103. package/dist/executors/bounded-exec/run-cpu-pool.d.ts +10 -4
  104. package/dist/executors/bounded-exec/run-cpu-pool.d.ts.map +1 -1
  105. package/dist/executors/bounded-exec/run-cpu-pool.js +122 -35
  106. package/dist/executors/bounded-exec/runner-hook.js +14 -5
  107. package/dist/executors/bounded-exec/runner-lifecycle.d.ts +14 -1
  108. package/dist/executors/bounded-exec/runner-lifecycle.d.ts.map +1 -1
  109. package/dist/executors/bounded-exec/runner-lifecycle.js +27 -6
  110. package/dist/executors/bounded-exec/{cpu-tokens.d.ts → runner-sizing.d.ts} +14 -42
  111. package/dist/executors/bounded-exec/runner-sizing.d.ts.map +1 -0
  112. package/dist/executors/bounded-exec/{cpu-tokens.js → runner-sizing.js} +5 -35
  113. package/dist/executors/bounded-exec/runtime-pin.d.ts +73 -0
  114. package/dist/executors/bounded-exec/runtime-pin.d.ts.map +1 -0
  115. package/dist/executors/bounded-exec/runtime-pin.js +167 -0
  116. package/dist/executors/bounded-exec/schema.d.ts +18 -1
  117. package/dist/executors/bounded-exec/schema.d.ts.map +1 -1
  118. package/dist/executors/bounded-exec/verdict.d.ts +48 -11
  119. package/dist/executors/bounded-exec/verdict.d.ts.map +1 -1
  120. package/dist/executors/bounded-exec/verdict.js +89 -20
  121. package/dist/executors/cargo-zigbuild/executor.d.ts +21 -0
  122. package/dist/executors/cargo-zigbuild/executor.d.ts.map +1 -1
  123. package/dist/executors/cargo-zigbuild/executor.js +67 -12
  124. package/dist/executors/clean-outputs/executor.js +1 -0
  125. package/dist/executors/scriptc-native/executor.d.ts +79 -0
  126. package/dist/executors/scriptc-native/executor.d.ts.map +1 -0
  127. package/dist/executors/scriptc-native/executor.js +367 -0
  128. package/dist/executors/scriptc-native/ffi-paths.d.ts +9 -0
  129. package/dist/executors/scriptc-native/ffi-paths.d.ts.map +1 -0
  130. package/dist/executors/scriptc-native/ffi-paths.js +25 -0
  131. package/dist/executors/scriptc-native/schema.d.ts +34 -0
  132. package/dist/executors/scriptc-native/schema.d.ts.map +1 -0
  133. package/dist/executors/scriptc-native/schema.js +1 -0
  134. package/dist/executors/typescript-emit/emit-overrides.d.ts +14 -0
  135. package/dist/executors/typescript-emit/emit-overrides.d.ts.map +1 -0
  136. package/dist/executors/typescript-emit/emit-overrides.js +24 -0
  137. package/dist/executors/typescript-emit/executor.d.ts +3 -1
  138. package/dist/executors/typescript-emit/executor.d.ts.map +1 -1
  139. package/dist/executors/typescript-emit/executor.js +146 -33
  140. package/dist/forbidden-spelling-policy.d.ts +56 -0
  141. package/dist/forbidden-spelling-policy.d.ts.map +1 -0
  142. package/dist/forbidden-spelling-policy.js +176 -0
  143. package/dist/generators/create-package/generator.d.ts.map +1 -1
  144. package/dist/generators/create-package/generator.js +3 -4
  145. package/dist/graph-input-contract.d.ts +14 -0
  146. package/dist/graph-input-contract.d.ts.map +1 -1
  147. package/dist/graph-input-contract.js +67 -2
  148. package/dist/index.d.ts +23 -6
  149. package/dist/index.d.ts.map +1 -1
  150. package/dist/index.js +672 -214
  151. package/dist/managed-assets.d.ts +2 -0
  152. package/dist/managed-assets.d.ts.map +1 -1
  153. package/dist/managed-files/files.d.ts +3 -3
  154. package/dist/managed-files/files.d.ts.map +1 -1
  155. package/dist/managed-files/files.js +28 -3
  156. package/dist/managed-files/managed-format.d.ts.map +1 -1
  157. package/dist/managed-files/managed-format.js +1 -0
  158. package/dist/managed-files/publish-workflow.js +14 -11
  159. package/dist/nextest-code-bound.js +1 -0
  160. package/dist/nextest-timings.d.ts +35 -0
  161. package/dist/nextest-timings.d.ts.map +1 -0
  162. package/dist/nextest-timings.js +168 -0
  163. package/dist/owned-installation.d.ts +6 -5
  164. package/dist/owned-installation.d.ts.map +1 -1
  165. package/dist/owned-installation.js +150 -26
  166. package/dist/package-target-policy.d.ts.map +1 -1
  167. package/dist/package-target-policy.js +2 -3
  168. package/dist/process-children.d.ts +7 -0
  169. package/dist/process-children.d.ts.map +1 -0
  170. package/dist/process-children.darwin.d.ts +7 -0
  171. package/dist/process-children.darwin.d.ts.map +1 -0
  172. package/dist/process-children.darwin.js +13 -0
  173. package/dist/process-children.js +14 -0
  174. package/dist/process-children.linux.d.ts +8 -0
  175. package/dist/process-children.linux.d.ts.map +1 -0
  176. package/dist/process-children.linux.js +25 -0
  177. package/dist/process-group.d.ts +108 -0
  178. package/dist/process-group.d.ts.map +1 -0
  179. package/dist/process-group.js +171 -0
  180. package/dist/process-listing.d.ts +7 -0
  181. package/dist/process-listing.d.ts.map +1 -0
  182. package/dist/process-listing.js +51 -0
  183. package/dist/producer-receipts.d.ts +8 -2
  184. package/dist/producer-receipts.d.ts.map +1 -1
  185. package/dist/producer-receipts.js +514 -47
  186. package/dist/task-graph-policy.d.ts +21 -0
  187. package/dist/task-graph-policy.d.ts.map +1 -0
  188. package/dist/task-graph-policy.js +91 -0
  189. package/dist/test-timings.js +4 -4
  190. package/dist/test-walk-policy.d.ts +14 -5
  191. package/dist/test-walk-policy.d.ts.map +1 -1
  192. package/dist/test-walk-policy.js +8 -2
  193. package/dist/testing.d.ts +73 -28
  194. package/dist/testing.d.ts.map +1 -1
  195. package/dist/testing.js +217 -223
  196. package/dist/tool-bins.d.ts +33 -0
  197. package/dist/tool-bins.d.ts.map +1 -0
  198. package/dist/tool-bins.js +72 -0
  199. package/dist/typecheck-test-policy.d.ts.map +1 -1
  200. package/dist/typecheck-test-policy.js +3 -4
  201. package/dist/wait-why-policy.d.ts +28 -0
  202. package/dist/wait-why-policy.d.ts.map +1 -0
  203. package/dist/wait-why-policy.js +223 -0
  204. package/dist/workspace-config-policy.d.ts +14 -8
  205. package/dist/workspace-config-policy.d.ts.map +1 -1
  206. package/dist/workspace-config-policy.js +60 -16
  207. package/dist/workspace-manifest.d.ts +41 -6
  208. package/dist/workspace-manifest.d.ts.map +1 -1
  209. package/dist/workspace-manifest.js +57 -0
  210. package/executors.json +16 -1
  211. package/loader.js +2 -0
  212. package/managed/raw/envrc +11 -0
  213. package/managed/raw/patches/nx@23.2.1.patch +2840 -199
  214. package/managed/raw/patches/ttsc@0.34.1.patch +119 -0
  215. package/managed/raw/tooling/direnv/cargo-fetch-bound.ts +245 -0
  216. package/managed/raw/tooling/direnv/cargo-fetch-run.ts +299 -0
  217. package/managed/raw/tooling/direnv/compiler-variables.sh +42 -0
  218. package/managed/raw/tooling/direnv/developer-links.ts +464 -25
  219. package/managed/raw/tooling/direnv/devenv.smoo.nix +78 -38
  220. package/managed/raw/tooling/direnv/github-actions-bootstrap.sh +14 -12
  221. package/managed/raw/tooling/direnv/installed-bun-links.ts +308 -0
  222. package/managed/raw/tooling/direnv/linked-snapshots.ts +62 -3
  223. package/managed/raw/tooling/direnv/nx-socket-dir.sh +56 -17
  224. package/managed/raw/tooling/direnv/repo-path +68 -6
  225. package/managed/raw/tooling/direnv/secret-references.ts +13 -4
  226. package/managed/raw/tooling/direnv/setup-environment.ts +128 -537
  227. package/managed/raw/tooling/direnv/toolchain-stamp.ts +4 -2
  228. package/managed/raw/tooling/direnv/ttsc-env.sh +9 -0
  229. package/managed/raw/tooling/direnv/uv-relocation.ts +227 -0
  230. package/managed/raw/tooling/git-hooks/commit-msg.sh +2 -1
  231. package/managed/raw/tooling/git-hooks/pre-commit.sh +2 -1
  232. package/managed/raw/tooling/git-hooks/pre-push.sh +2 -1
  233. package/managed/templates/github/actions/cache-ttsc-plugins/action.yml +85 -7
  234. package/managed/templates/github/actions/save-nix-devenv/action.yml +12 -2
  235. package/managed/templates/github/actions/setup-devenv/action.yml +2 -0
  236. package/package.json +95 -14
  237. package/src/bin/smoo-nx-cargo-toolchain.ts +11 -0
  238. package/src/bin/smoo-nx-forbidden-spellings.ts +33 -0
  239. package/src/bin/smoo-nx-nextest-timings.ts +31 -0
  240. package/src/bounded-test-policy.ts +12 -14
  241. package/src/build-state-output-policy.ts +458 -34
  242. package/src/bun-lock-scope.ts +108 -0
  243. package/src/cargo-build-script-env.ts +265 -0
  244. package/src/cargo-closure-input.ts +74 -7
  245. package/src/cargo-retention-hook.ts +94 -0
  246. package/src/cargo-source-hash.ts +138 -41
  247. package/src/cargo-toolchain-paths.ts +95 -0
  248. package/src/cargo-toolchain-policy.ts +49 -5
  249. package/src/cargo-workspace.ts +72 -123
  250. package/src/cross-check-policy.ts +12 -10
  251. package/src/disk-command-policy.ts +1 -0
  252. package/src/ensure-built-receipt.ts +173 -39
  253. package/src/ensure-built-witness.ts +62 -10
  254. package/src/ensure-built.ts +11 -1
  255. package/src/eslint-config-closure.ts +357 -0
  256. package/src/executors/bounded-exec/bounds.ts +76 -0
  257. package/src/executors/bounded-exec/cpu-pool-thread.ts +43 -0
  258. package/src/executors/bounded-exec/cpu-pool.ts +55 -120
  259. package/src/executors/bounded-exec/executor.ts +442 -260
  260. package/src/executors/bounded-exec/gateway-lease.ts +94 -35
  261. package/src/executors/bounded-exec/hang-diagnostics.ts +173 -31
  262. package/src/executors/bounded-exec/lease-wait.ts +116 -0
  263. package/src/executors/bounded-exec/lock-wait.ts +141 -0
  264. package/src/executors/bounded-exec/mbx-pool.ts +48 -0
  265. package/src/executors/bounded-exec/owned-subtree.ts +235 -0
  266. package/src/executors/bounded-exec/progress.ts +9 -3
  267. package/src/executors/bounded-exec/ram-attach.ts +238 -0
  268. package/src/executors/bounded-exec/ram-detach.ts +226 -0
  269. package/src/executors/bounded-exec/ram-temp-fixtures.ts +358 -0
  270. package/src/executors/bounded-exec/ram-temp-registry.txt +440 -0
  271. package/src/executors/bounded-exec/ram-temp.ts +1497 -460
  272. package/src/executors/bounded-exec/run-cpu-pool.ts +129 -35
  273. package/src/executors/bounded-exec/runner-hook.ts +14 -6
  274. package/src/executors/bounded-exec/runner-lifecycle.ts +31 -8
  275. package/src/executors/bounded-exec/{cpu-tokens.ts → runner-sizing.ts} +13 -59
  276. package/src/executors/bounded-exec/runtime-pin.ts +232 -0
  277. package/src/executors/bounded-exec/schema.json +11 -2
  278. package/src/executors/bounded-exec/schema.ts +19 -1
  279. package/src/executors/bounded-exec/verdict.ts +145 -35
  280. package/src/executors/cargo-zigbuild/executor.ts +82 -8
  281. package/src/executors/clean-outputs/executor.ts +1 -0
  282. package/src/executors/scriptc-native/executor.ts +394 -0
  283. package/src/executors/scriptc-native/ffi-paths.ts +29 -0
  284. package/src/executors/scriptc-native/schema.json +60 -0
  285. package/src/executors/scriptc-native/schema.ts +34 -0
  286. package/src/executors/typescript-emit/emit-overrides.ts +24 -0
  287. package/src/executors/typescript-emit/executor.ts +186 -38
  288. package/src/forbidden-spelling-policy.ts +226 -0
  289. package/src/generators/create-package/generator.ts +7 -7
  290. package/src/graph-input-contract.ts +61 -2
  291. package/src/index.ts +788 -224
  292. package/src/managed-assets.ts +3 -0
  293. package/src/managed-files/files.ts +28 -3
  294. package/src/managed-files/managed-format.ts +1 -0
  295. package/src/managed-files/publish-workflow.ts +20 -15
  296. package/src/nextest-code-bound.ts +1 -0
  297. package/src/nextest-timings.ts +106 -0
  298. package/src/owned-installation.ts +150 -23
  299. package/src/package-target-policy.ts +2 -3
  300. package/src/process-children.darwin.ts +14 -0
  301. package/src/process-children.linux.ts +33 -0
  302. package/src/process-children.ts +22 -0
  303. package/src/process-group.ts +209 -0
  304. package/src/process-listing.ts +54 -0
  305. package/src/producer-receipts.ts +92 -41
  306. package/src/task-graph-policy.ts +98 -0
  307. package/src/test-walk-policy.ts +23 -8
  308. package/src/testing.ts +240 -232
  309. package/src/tool-bins.ts +108 -0
  310. package/src/typecheck-test-policy.ts +2 -3
  311. package/src/wait-why-policy.ts +226 -0
  312. package/src/workspace-config-policy.ts +63 -15
  313. package/src/workspace-manifest.ts +89 -6
  314. package/test-timings.json +124 -99
  315. package/dist/bin/smoo-nx-failures.d.ts +0 -3
  316. package/dist/bin/smoo-nx-failures.d.ts.map +0 -1
  317. package/dist/bin/smoo-nx-failures.js +0 -3
  318. package/dist/bin/smoo-nx-nextest-extract.d.ts +0 -3
  319. package/dist/bin/smoo-nx-nextest-extract.d.ts.map +0 -1
  320. package/dist/bin/smoo-nx-nextest-extract.js +0 -42
  321. package/dist/executors/bounded-exec/cpu-tokens.d.ts.map +0 -1
  322. package/dist/failure-summary.d.ts +0 -5
  323. package/dist/failure-summary.d.ts.map +0 -1
  324. package/dist/failure-summary.js +0 -118
  325. package/dist/nextest-extraction.d.ts +0 -117
  326. package/dist/nextest-extraction.d.ts.map +0 -1
  327. package/dist/nextest-extraction.js +0 -303
  328. package/managed/raw/patches/ttsc@0.30.4.patch +0 -2255
  329. package/src/__tests__/cargo-closure-filesets.ts +0 -94
  330. package/src/__tests__/cargo-closure-fixture.ts +0 -113
  331. package/src/__tests__/counted-cargo-process.ts +0 -286
  332. package/src/__tests__/counted-cargo.ts +0 -713
  333. package/src/__tests__/directory-change.ts +0 -27
  334. package/src/__tests__/fixture-cargo-home.ts +0 -36
  335. package/src/__tests__/fixture-nx-env.ts +0 -193
  336. package/src/__tests__/owned-installation.ts +0 -13
  337. package/src/__tests__/past-tick.ts +0 -12
  338. package/src/__tests__/progress-clock.ts +0 -43
  339. package/src/__tests__/runtime-input.ts +0 -23
  340. package/src/bin/smoo-nx-bound-failures.test.ts +0 -127
  341. package/src/bin/smoo-nx-failures.ts +0 -4
  342. package/src/bin/smoo-nx-nextest-extract.ts +0 -44
  343. package/src/bounded-test-policy.test.ts +0 -1029
  344. package/src/build-state-output-policy.test.ts +0 -115
  345. package/src/bun-bootstrap.test.ts +0 -102
  346. package/src/bun-file-packages.test.ts +0 -47
  347. package/src/cargo-closure-filesets.test.ts +0 -63
  348. package/src/cargo-closure-input.property.test.ts +0 -50
  349. package/src/cargo-closure-input.test.ts +0 -506
  350. package/src/cargo-closure-key.test.ts +0 -240
  351. package/src/cargo-resolve-cache.test.ts +0 -1181
  352. package/src/cargo-source-hash.test.ts +0 -707
  353. package/src/cargo-workspace.test.ts +0 -615
  354. package/src/cross-check-policy.test.ts +0 -316
  355. package/src/disk-command-policy.test.ts +0 -61
  356. package/src/ensure-built-receipt.test.ts +0 -279
  357. package/src/ensure-built-witness.test.ts +0 -688
  358. package/src/ensure-built.test.ts +0 -1462
  359. package/src/executors/all-verdicts/executor.test.ts +0 -135
  360. package/src/executors/bounded-exec/cargo-progress-host.test.ts +0 -332
  361. package/src/executors/bounded-exec/cpu-pool.test.ts +0 -684
  362. package/src/executors/bounded-exec/cpu-tokens.test.ts +0 -519
  363. package/src/executors/bounded-exec/disk-lease.test.ts +0 -219
  364. package/src/executors/bounded-exec/executor-host.test.ts +0 -800
  365. package/src/executors/bounded-exec/executor.test.ts +0 -1819
  366. package/src/executors/bounded-exec/go-progress-host.test.ts +0 -171
  367. package/src/executors/bounded-exec/hang-diagnostics.test.ts +0 -291
  368. package/src/executors/bounded-exec/progress.test.ts +0 -139
  369. package/src/executors/bounded-exec/ram-temp-held.test.ts +0 -264
  370. package/src/executors/bounded-exec/ram-temp-host.test.ts +0 -635
  371. package/src/executors/bounded-exec/ram-temp.test.ts +0 -750
  372. package/src/executors/bounded-exec/run-cpu-pool.test.ts +0 -79
  373. package/src/executors/bounded-exec/runner-hook.test.ts +0 -193
  374. package/src/executors/bounded-exec/runner-lifecycle.test.ts +0 -82
  375. package/src/executors/bounded-exec/verdict.test.ts +0 -545
  376. package/src/executors/cargo-zigbuild/executor.test.ts +0 -129
  377. package/src/executors/clean-outputs/executor.test.ts +0 -20
  378. package/src/executors/typescript-emit/executor.test.ts +0 -83
  379. package/src/failure-summary.ts +0 -119
  380. package/src/generators/bounded-test-targets/generator.test.ts +0 -138
  381. package/src/generators/bun-test-tracing/generator.test.ts +0 -250
  382. package/src/generators/create-package/generator.test.ts +0 -190
  383. package/src/generators/make-public/generator.test.ts +0 -137
  384. package/src/graph-input-contract.test.ts +0 -379
  385. package/src/host-controller-wiring.test.ts +0 -31
  386. package/src/index.test.ts +0 -3321
  387. package/src/linked-snapshots.nx.test.ts +0 -254
  388. package/src/managed-files/forgejo-artifact.test.ts +0 -395
  389. package/src/managed-files/generator.test.ts +0 -243
  390. package/src/managed-files/github-host-cache-isolation.test.ts +0 -86
  391. package/src/managed-files/json-edit.test.ts +0 -216
  392. package/src/managed-files/managed-content.test.ts +0 -166
  393. package/src/managed-files/managed-format-json.test.ts +0 -308
  394. package/src/managed-files/repo-path.test.ts +0 -172
  395. package/src/managed-files/setup-devenv-free-disk.test.ts +0 -95
  396. package/src/managed-files/trace-db-artifact.test.ts +0 -7
  397. package/src/managed-files/tree-permissions.test.ts +0 -109
  398. package/src/managed-files/tree.test.ts +0 -123
  399. package/src/manifest-hash.test.ts +0 -219
  400. package/src/nextest-code-bound.test.ts +0 -161
  401. package/src/nextest-extraction.test.ts +0 -216
  402. package/src/nextest-extraction.ts +0 -371
  403. package/src/nextest-partitions.test.ts +0 -501
  404. package/src/nx-cache-bound.test.ts +0 -109
  405. package/src/nx-cache-restore-mtime.test.ts +0 -170
  406. package/src/nx-daemon-claim.test.ts +0 -279
  407. package/src/nx-daemon-idle-cpu.test.ts +0 -80
  408. package/src/nx-daemon-idle-policy.test.ts +0 -111
  409. package/src/nx-daemon-ignore-files.test.ts +0 -210
  410. package/src/nx-daemon-root-normalization.test.ts +0 -105
  411. package/src/nx-daemon-start-never.test.ts +0 -292
  412. package/src/nx-daemon-validity.test.ts +0 -1055
  413. package/src/nx-dot-input-policy.test.ts +0 -353
  414. package/src/nx-failure-life-cycles.test.ts +0 -207
  415. package/src/nx-files-archive-racy.test.ts +0 -97
  416. package/src/nx-foreign-workspace-env.test.ts +0 -329
  417. package/src/nx-incomplete-run-summary.test.ts +0 -70
  418. package/src/nx-plugin-load-errors.test.ts +0 -120
  419. package/src/nx-project-graph-errors.test.ts +0 -70
  420. package/src/nx-project-resolution-cache.test.ts +0 -176
  421. package/src/nx-raw-inputs.test.ts +0 -166
  422. package/src/nx-resident-graph-workers.test.ts +0 -112
  423. package/src/nx-run-information.test.ts +0 -118
  424. package/src/nx-skipped-task-exit.test.ts +0 -180
  425. package/src/nx-state-location.test.ts +0 -63
  426. package/src/nx-store-resolution.test.ts +0 -81
  427. package/src/nx-task-graph-cycles.test.ts +0 -148
  428. package/src/nx-task-output-lease.test.ts +0 -550
  429. package/src/nx-use-local.test.ts +0 -105
  430. package/src/owned-installation.test.ts +0 -105
  431. package/src/package-target-policy.test.ts +0 -1014
  432. package/src/producer-receipts.test.ts +0 -285
  433. package/src/release-config-policy.test.ts +0 -311
  434. package/src/runtime-input.test.ts +0 -393
  435. package/src/serial-group-wiring.test.ts +0 -326
  436. package/src/task-history-namespace.test.ts +0 -181
  437. package/src/task-results.test.ts +0 -228
  438. package/src/test-clock-policy.test.ts +0 -338
  439. package/src/test-program.test.ts +0 -303
  440. package/src/test-timings.test.ts +0 -240
  441. package/src/test-walk-policy.test.ts +0 -620
  442. package/src/testing.test.ts +0 -509
  443. package/src/typecheck-test-policy.test.ts +0 -1468
  444. package/src/typescript-resolution.test.ts +0 -76
  445. package/src/version-actions.test.ts +0 -80
  446. package/src/workspace-config-policy.test.ts +0 -737
@@ -1,11 +1,21 @@
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
-
18
+ import { EMIT_OVERRIDES } from './emit-overrides.js';
9
19
  import type { TypeScriptEmitOptions } from './schema.js';
10
20
 
11
21
  interface TypeScriptEmitContext {
@@ -17,7 +27,9 @@ interface TypeScriptEmitResult {
17
27
  }
18
28
 
19
29
  interface TsConfigJson {
20
- references?: unknown;
30
+ include?: unknown;
31
+ exclude?: unknown;
32
+ compilerOptions?: { outDir?: unknown };
21
33
  }
22
34
 
23
35
  export interface CompilerInvocation {
@@ -32,59 +44,194 @@ export default function typescriptEmitExecutor(
32
44
  options: TypeScriptEmitOptions,
33
45
  context: TypeScriptEmitContext,
34
46
  ): Promise<TypeScriptEmitResult> {
35
- return runTypeScriptEmit(options, context, runCompiler);
47
+ const producer = buildInputProducer(process.env);
48
+ return runTypeScriptEmit(options, context, runCompiler, producer);
36
49
  }
37
50
 
51
+ /** Runs with the caller's compiler and task identity; only the Nx entry reads its environment. */
38
52
  export async function runTypeScriptEmit(
39
53
  options: TypeScriptEmitOptions,
40
54
  context: TypeScriptEmitContext,
41
55
  runner: CompilerRunner,
56
+ producer?: BuildInputProducer,
42
57
  ): Promise<TypeScriptEmitResult> {
43
58
  const cwd = isAbsolute(options.cwd) ? options.cwd : join(context.root, options.cwd);
44
59
  const tsConfigPath = isAbsolute(options.tsConfig) ? options.tsConfig : join(cwd, options.tsConfig);
45
60
  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 } : {}),
61
+ const outputDirectory = emitOutputDirectory(tsConfigPath, tsConfig);
62
+
63
+ // Taken before the emit, so a source edited while it runs is recorded with its earlier bytes and reads as changed.
64
+ const inputs = outputDirectory === null ? null : typeScriptInputs(tsConfigPath, tsConfig, producer);
65
+ const previous = outputDirectory === null ? null : await snapshotOutput(outputDirectory);
66
+ const javascriptSucceeded = await runner({
67
+ command: 'ttsc',
68
+ args: ['-p', tsConfigPath, '--emit', ...EMIT_OVERRIDES],
69
+ cwd,
70
+ });
71
+ if (!javascriptSucceeded) {
72
+ return { success: false };
73
+ }
74
+
75
+ // Before the execute bits: their chmod moves a bin's ctime, as a write does.
76
+ if (previous !== null) await removeUnwritten(previous);
77
+ await makePackageBinsExecutable(cwd, options.executableOutputs ?? []);
78
+ if (outputDirectory !== null && inputs !== null) writeBuildInputs(outputDirectory, inputs);
79
+
80
+ return { success: true };
81
+ }
82
+
83
+ /**
84
+ * The config's outDir, which inference declares as the target's only Nx output. The emit owns it whole: after a
85
+ * successful emit it holds exactly what that emit wrote, so neither outDir nor the artifact Nx captures from it keeps a
86
+ * file an earlier build wrote and this one no longer does (a bin moved to another package, a deleted module). The emit
87
+ * writes outDir in place rather than into a fresh directory swapped over it: outDir's parent is usually the package
88
+ * root, whose listing a concurrent ttsc transform of a consumer proves while it compiles (EMIT_OVERRIDES). A config
89
+ * without a literal outDir emits beside its sources and owns no directory.
90
+ */
91
+ function emitOutputDirectory(tsConfigPath: string, tsConfig: TsConfigJson): string | null {
92
+ const outDir = tsConfig.compilerOptions?.outDir;
93
+ if (typeof outDir !== 'string' || outDir.length === 0) return null;
94
+ const configDirectory = dirname(tsConfigPath);
95
+ const outputDirectory = resolve(configDirectory, outDir);
96
+ if (!isInside(configDirectory, outputDirectory)) {
97
+ throw new Error(`${tsConfigPath}: compilerOptions.outDir must stay inside the project: ${outDir}`);
98
+ }
99
+ return outputDirectory;
100
+ }
101
+
102
+ /**
103
+ * A file as writes change it: a write moves its mtime and, on POSIX, its ctime (Windows reports birth time there), and a
104
+ * replacement gives it another inode.
105
+ */
106
+ interface FileIdentity {
107
+ readonly ino: bigint;
108
+ readonly ctimeNs: bigint;
109
+ readonly mtimeNs: bigint;
110
+ }
111
+
112
+ /** What outDir held before the emit: its files by identity, and its directories, each before those inside it. */
113
+ interface OutputSnapshot {
114
+ readonly files: ReadonlyMap<string, FileIdentity>;
115
+ readonly directories: readonly string[];
116
+ }
117
+
118
+ /**
119
+ * Lists outDir before the emit. A TypeScript source in it means outDir holds inputs, which no emit rewrites, so the
120
+ * snapshot refuses before the compiler runs rather than let the removal take them.
121
+ */
122
+ async function snapshotOutput(outputDirectory: string): Promise<OutputSnapshot> {
123
+ const files = new Map<string, FileIdentity>();
124
+ const directories: string[] = [];
125
+ const root = await lstat(outputDirectory).catch((error: unknown) => {
126
+ if (errorCode(error) === 'ENOENT') return null;
127
+ throw error;
128
+ });
129
+ if (root === null) return { files, directories };
130
+ // Removal follows outDir's own path only: through a link it would reach files outside the project.
131
+ if (!root.isDirectory()) throw new Error(`${outputDirectory} is the emit's outDir but is not a directory`);
132
+ const visit = async (directory: string): Promise<void> => {
133
+ for (const name of await readdir(directory)) {
134
+ const path = join(directory, name);
135
+ const stats = await lstat(path, { bigint: true });
136
+ if (stats.isDirectory()) {
137
+ directories.push(path);
138
+ await visit(path);
139
+ continue;
140
+ }
141
+ if (/\.[cm]?tsx?$/.test(name) && !/\.d\.[cm]?ts$/.test(name)) {
142
+ throw new Error(`${outputDirectory} is the emit's outDir but holds the TypeScript source ${path}`);
143
+ }
144
+ files.set(path, { ino: stats.ino, ctimeNs: stats.ctimeNs, mtimeNs: stats.mtimeNs });
145
+ }
57
146
  };
147
+ await visit(outputDirectory);
148
+ return { files, directories };
149
+ }
58
150
 
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,
151
+ /**
152
+ * Removes what the emit left as it was: each file whose identity is still the one it had before the emit, then
153
+ * each directory that removal emptied. The compiler truncates and rewrites every output of a non-incremental emit,
154
+ * unchanged bytes included (TypeScript-Go's writer opens each output O_TRUNC, and the transform hosts ttsc loads write
155
+ * through it), so an untouched file is one this emit no longer produces. The executor tests hold that contract against
156
+ * the real compiler by emitting twice.
157
+ */
158
+ async function removeUnwritten({ files, directories }: OutputSnapshot): Promise<void> {
159
+ for (const [path, before] of files) {
160
+ const now = await lstat(path, { bigint: true }).catch((error: unknown) => {
161
+ if (errorCode(error) === 'ENOENT') return null;
162
+ throw error;
65
163
  });
66
- if (!javascriptSucceeded) {
67
- return { success: false };
68
- }
164
+ const untouched =
165
+ now !== null && now.ino === before.ino && now.ctimeNs === before.ctimeNs && now.mtimeNs === before.mtimeNs;
166
+ if (untouched) await rm(path, { force: true });
167
+ }
168
+ for (const directory of [...directories].reverse()) {
169
+ await rmdir(directory).catch((error: unknown) => {
170
+ const code = errorCode(error);
171
+ if (code === 'ENOTEMPTY' || code === 'EEXIST' || code === 'ENOENT') return;
172
+ throw error;
173
+ });
174
+ }
175
+ }
69
176
 
70
- await makePackageBinsExecutable(cwd, options.executableOutputs ?? []);
177
+ function errorCode(error: unknown): unknown {
178
+ return error instanceof Error && 'code' in error ? error.code : undefined;
179
+ }
71
180
 
72
- return { success: true };
73
- } finally {
74
- await rm(overlayPath, { force: true });
75
- }
181
+ const TYPESCRIPT_SOURCES = ['ts', 'tsx', 'mts', 'cts'];
182
+
183
+ /**
184
+ * The emit's input record (build-inputs.ts) for its outDir, which is the target's Nx output: the tracked and untracked
185
+ * files the config's `include` matches less its `exclude`, and the config. `complete` carries the same pathspecs, so a
186
+ * source added since this emit is an input the consumer finds missing from the record. A config without a literal
187
+ * include gets none, nor does an emit that owns no outDir (emitOutputDirectory), and its consumers judge it by
188
+ * modification time.
189
+ */
190
+ function typeScriptInputs(
191
+ tsConfigPath: string,
192
+ tsConfig: TsConfigJson,
193
+ producer?: BuildInputProducer,
194
+ ): BuildInputRecord | null {
195
+ const strings = (value: unknown) =>
196
+ Array.isArray(value) ? value.filter((entry): entry is string => typeof entry === 'string') : [];
197
+ const include = strings(tsConfig.include);
198
+ if (include.length === 0) return null;
199
+ const configDirectory = realpathSync(dirname(tsConfigPath));
200
+ const workspaceRoot = gitWorkspaceRoot(configDirectory);
201
+ if (workspaceRoot === null) return null;
202
+ const prefix = workspacePath(workspaceRoot, configDirectory);
203
+ // tsconfig names a directory to mean the TypeScript sources under it.
204
+ const globs = (entry: string) =>
205
+ /[*?[]/.test(entry) || /\.[a-z]+$/.test(entry)
206
+ ? [entry]
207
+ : TYPESCRIPT_SOURCES.map((extension) => `${entry.replace(/\/$/, '')}/**/*.${extension}`);
208
+ const spec = (entry: string, exclude: boolean) =>
209
+ globs(entry).map((glob) => globPathspec(prefix === '.' ? glob : `${prefix}/${glob}`, exclude));
210
+ const complete = [
211
+ ...include.flatMap((entry) => spec(entry, false)),
212
+ ...strings(tsConfig.exclude).flatMap((entry) => spec(entry, true)),
213
+ ];
214
+ return buildInputRecord(
215
+ workspaceRoot,
216
+ [
217
+ ...pathspecFiles(workspaceRoot, complete),
218
+ workspacePath(workspaceRoot, join(configDirectory, basename(tsConfigPath))),
219
+ ],
220
+ complete,
221
+ producer,
222
+ );
223
+ }
224
+
225
+ /** Whether `path` lies strictly beneath `directory`. */
226
+ function isInside(directory: string, path: string): boolean {
227
+ const beneath = relative(directory, path);
228
+ return beneath.length > 0 && beneath !== '..' && !beneath.startsWith(`..${sep}`) && !isAbsolute(beneath);
76
229
  }
77
230
 
78
231
  async function makePackageBinsExecutable(cwd: string, outputs: readonly string[]): Promise<void> {
79
232
  for (const output of new Set(outputs)) {
80
233
  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
- ) {
234
+ if (!isInside(cwd, outputPath)) {
88
235
  throw new Error(`Executable output must stay inside the project: ${output}`);
89
236
  }
90
237
  const outputStat = await stat(outputPath);
@@ -102,6 +249,7 @@ async function runCompiler(invocation: CompilerInvocation): Promise<boolean> {
102
249
  windowsHide: true,
103
250
  });
104
251
  try {
252
+ // 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
253
  await once(child, 'exit');
106
254
  return child.exitCode === 0 && child.signalCode === null;
107
255
  } 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,