@smoothbricks/nx-plugin 0.4.26 → 0.4.28

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 (343) hide show
  1. package/README.md +994 -117
  2. package/dist/bin/smoo-nx-bound-failures.d.ts +3 -0
  3. package/dist/bin/smoo-nx-bound-failures.d.ts.map +1 -0
  4. package/dist/bin/smoo-nx-bound-failures.js +31 -0
  5. package/dist/bin/smoo-nx-cargo-hash.js +28 -3
  6. package/dist/bin/smoo-nx-exec.js +15 -73
  7. package/dist/bin/smoo-nx-failures.d.ts +3 -0
  8. package/dist/bin/smoo-nx-failures.d.ts.map +1 -0
  9. package/dist/bin/smoo-nx-failures.js +3 -0
  10. package/dist/bin/smoo-nx-nextest-extract.js +3 -2
  11. package/dist/bin/smoo-nx-test-walks.d.ts +3 -0
  12. package/dist/bin/smoo-nx-test-walks.d.ts.map +1 -0
  13. package/dist/bin/smoo-nx-test-walks.js +34 -0
  14. package/dist/bounded-test-policy.d.ts +7 -1
  15. package/dist/bounded-test-policy.d.ts.map +1 -1
  16. package/dist/bounded-test-policy.js +101 -40
  17. package/dist/build-state-output-policy.d.ts +25 -0
  18. package/dist/build-state-output-policy.d.ts.map +1 -0
  19. package/dist/build-state-output-policy.js +64 -0
  20. package/dist/cargo-closure-input.d.ts +3 -2
  21. package/dist/cargo-closure-input.d.ts.map +1 -1
  22. package/dist/cargo-closure-input.js +16 -15
  23. package/dist/cargo-dev-profile.d.ts +37 -0
  24. package/dist/cargo-dev-profile.d.ts.map +1 -0
  25. package/dist/cargo-dev-profile.js +108 -0
  26. package/dist/cargo-source-hash.d.ts +43 -6
  27. package/dist/cargo-source-hash.d.ts.map +1 -1
  28. package/dist/cargo-source-hash.js +309 -73
  29. package/dist/cargo-toolchain-policy.d.ts +4 -0
  30. package/dist/cargo-toolchain-policy.d.ts.map +1 -1
  31. package/dist/cargo-toolchain-policy.js +5 -0
  32. package/dist/cargo-workspace.d.ts +101 -5
  33. package/dist/cargo-workspace.d.ts.map +1 -1
  34. package/dist/cargo-workspace.js +291 -10
  35. package/dist/cross-check-policy.d.ts +21 -3
  36. package/dist/cross-check-policy.d.ts.map +1 -1
  37. package/dist/cross-check-policy.js +24 -6
  38. package/dist/disk-command-policy.d.ts +7 -0
  39. package/dist/disk-command-policy.d.ts.map +1 -0
  40. package/dist/disk-command-policy.js +98 -0
  41. package/dist/ensure-built-receipt.d.ts +25 -0
  42. package/dist/ensure-built-receipt.d.ts.map +1 -0
  43. package/dist/ensure-built-receipt.js +261 -0
  44. package/dist/ensure-built-witness.d.ts +57 -0
  45. package/dist/ensure-built-witness.d.ts.map +1 -0
  46. package/dist/ensure-built-witness.js +412 -0
  47. package/dist/ensure-built.d.ts +207 -12
  48. package/dist/ensure-built.d.ts.map +1 -1
  49. package/dist/ensure-built.js +576 -202
  50. package/dist/eslint-file-set.d.ts +7 -0
  51. package/dist/eslint-file-set.d.ts.map +1 -0
  52. package/dist/eslint-file-set.js +12 -0
  53. package/dist/executors/bounded-exec/cpu-pool.d.ts +63 -0
  54. package/dist/executors/bounded-exec/cpu-pool.d.ts.map +1 -0
  55. package/dist/executors/bounded-exec/cpu-pool.js +379 -0
  56. package/dist/executors/bounded-exec/cpu-tokens.d.ts +82 -0
  57. package/dist/executors/bounded-exec/cpu-tokens.d.ts.map +1 -0
  58. package/dist/executors/bounded-exec/cpu-tokens.js +114 -0
  59. package/dist/executors/bounded-exec/disk-lease.d.ts +61 -0
  60. package/dist/executors/bounded-exec/disk-lease.d.ts.map +1 -0
  61. package/dist/executors/bounded-exec/disk-lease.js +91 -0
  62. package/dist/executors/bounded-exec/executor.d.ts +45 -2
  63. package/dist/executors/bounded-exec/executor.d.ts.map +1 -1
  64. package/dist/executors/bounded-exec/executor.js +447 -52
  65. package/dist/executors/bounded-exec/gateway-lease.d.ts +52 -0
  66. package/dist/executors/bounded-exec/gateway-lease.d.ts.map +1 -0
  67. package/dist/executors/bounded-exec/gateway-lease.js +143 -0
  68. package/dist/executors/bounded-exec/hang-diagnostics.d.ts +35 -0
  69. package/dist/executors/bounded-exec/hang-diagnostics.d.ts.map +1 -0
  70. package/dist/executors/bounded-exec/hang-diagnostics.js +231 -0
  71. package/dist/executors/bounded-exec/progress.d.ts +35 -0
  72. package/dist/executors/bounded-exec/progress.d.ts.map +1 -0
  73. package/dist/executors/bounded-exec/progress.js +79 -0
  74. package/dist/executors/bounded-exec/ram-temp-fixtures.d.ts +3 -0
  75. package/dist/executors/bounded-exec/ram-temp-fixtures.d.ts.map +1 -0
  76. package/dist/executors/bounded-exec/ram-temp-fixtures.js +12 -0
  77. package/dist/executors/bounded-exec/ram-temp-held.d.ts +91 -0
  78. package/dist/executors/bounded-exec/ram-temp-held.d.ts.map +1 -0
  79. package/dist/executors/bounded-exec/ram-temp-held.js +152 -0
  80. package/dist/executors/bounded-exec/ram-temp.d.ts +223 -0
  81. package/dist/executors/bounded-exec/ram-temp.d.ts.map +1 -0
  82. package/dist/executors/bounded-exec/ram-temp.js +1528 -0
  83. package/dist/executors/bounded-exec/schema.d.ts +29 -11
  84. package/dist/executors/bounded-exec/schema.d.ts.map +1 -1
  85. package/dist/executors/bounded-exec/verdict.d.ts +162 -0
  86. package/dist/executors/bounded-exec/verdict.d.ts.map +1 -0
  87. package/dist/executors/bounded-exec/verdict.js +318 -0
  88. package/dist/executors/shard-timings/executor.d.ts +14 -0
  89. package/dist/executors/shard-timings/executor.d.ts.map +1 -0
  90. package/dist/executors/shard-timings/executor.js +25 -0
  91. package/dist/executors/shard-timings/schema.d.ts +4 -0
  92. package/dist/executors/shard-timings/schema.d.ts.map +1 -0
  93. package/dist/executors/shard-timings/schema.js +1 -0
  94. package/dist/failure-summary.d.ts +5 -0
  95. package/dist/failure-summary.d.ts.map +1 -0
  96. package/dist/failure-summary.js +118 -0
  97. package/dist/generators/create-package/generator.d.ts.map +1 -1
  98. package/dist/generators/create-package/generator.js +6 -2
  99. package/dist/index.d.ts +14 -2
  100. package/dist/index.d.ts.map +1 -1
  101. package/dist/index.js +370 -138
  102. package/dist/managed-files/ci-workflow.d.ts +13 -0
  103. package/dist/managed-files/ci-workflow.d.ts.map +1 -1
  104. package/dist/managed-files/ci-workflow.js +44 -13
  105. package/dist/managed-files/files.d.ts +7 -1
  106. package/dist/managed-files/files.d.ts.map +1 -1
  107. package/dist/managed-files/files.js +62 -8
  108. package/dist/managed-files/json-edit.d.ts +21 -0
  109. package/dist/managed-files/json-edit.d.ts.map +1 -0
  110. package/dist/managed-files/json-edit.js +295 -0
  111. package/dist/managed-files/managed-format.d.ts +33 -1
  112. package/dist/managed-files/managed-format.d.ts.map +1 -1
  113. package/dist/managed-files/managed-format.js +82 -2
  114. package/dist/managed-files/pr-preview-cleanup-workflow.d.ts +7 -0
  115. package/dist/managed-files/pr-preview-cleanup-workflow.d.ts.map +1 -1
  116. package/dist/managed-files/pr-preview-cleanup-workflow.js +68 -4
  117. package/dist/managed-files/publish-workflow.d.ts.map +1 -1
  118. package/dist/managed-files/publish-workflow.js +231 -48
  119. package/dist/managed-files/tree.d.ts +5 -0
  120. package/dist/managed-files/tree.d.ts.map +1 -1
  121. package/dist/managed-files/tree.js +5 -3
  122. package/dist/manifest-hash.d.ts.map +1 -1
  123. package/dist/manifest-hash.js +2 -5
  124. package/dist/nextest-code-bound.d.ts +62 -0
  125. package/dist/nextest-code-bound.d.ts.map +1 -0
  126. package/dist/nextest-code-bound.js +154 -0
  127. package/dist/nextest-extraction.d.ts +24 -8
  128. package/dist/nextest-extraction.d.ts.map +1 -1
  129. package/dist/nextest-extraction.js +42 -7
  130. package/dist/package-target-policy.d.ts.map +1 -1
  131. package/dist/package-target-policy.js +3 -5
  132. package/dist/release-config-policy.d.ts.map +1 -1
  133. package/dist/release-config-policy.js +3 -5
  134. package/dist/runtime-input.d.ts +14 -0
  135. package/dist/runtime-input.d.ts.map +1 -0
  136. package/dist/runtime-input.js +15 -0
  137. package/dist/rust-tokens.d.ts +11 -0
  138. package/dist/rust-tokens.d.ts.map +1 -0
  139. package/dist/rust-tokens.js +81 -0
  140. package/dist/task-results.d.ts +6 -0
  141. package/dist/task-results.d.ts.map +1 -0
  142. package/dist/task-results.js +61 -0
  143. package/dist/test-program.d.ts +54 -0
  144. package/dist/test-program.d.ts.map +1 -0
  145. package/dist/test-program.js +292 -0
  146. package/dist/test-timings.d.ts +71 -0
  147. package/dist/test-timings.d.ts.map +1 -0
  148. package/dist/test-timings.js +393 -0
  149. package/dist/test-walk-policy.d.ts +103 -0
  150. package/dist/test-walk-policy.d.ts.map +1 -0
  151. package/dist/test-walk-policy.js +657 -0
  152. package/dist/testing.d.ts +177 -0
  153. package/dist/testing.d.ts.map +1 -0
  154. package/dist/testing.js +824 -0
  155. package/dist/type-guards.d.ts +3 -0
  156. package/dist/type-guards.d.ts.map +1 -0
  157. package/dist/type-guards.js +4 -0
  158. package/dist/typecheck-test-policy.d.ts +8 -5
  159. package/dist/typecheck-test-policy.d.ts.map +1 -1
  160. package/dist/typecheck-test-policy.js +113 -100
  161. package/dist/workspace-config-policy.d.ts +8 -0
  162. package/dist/workspace-config-policy.d.ts.map +1 -1
  163. package/dist/workspace-config-policy.js +175 -63
  164. package/dist/workspace-index.d.ts +12 -0
  165. package/dist/workspace-index.d.ts.map +1 -0
  166. package/dist/workspace-index.js +17 -0
  167. package/dist/workspace-manifest.d.ts +37 -0
  168. package/dist/workspace-manifest.d.ts.map +1 -1
  169. package/executors.json +5 -0
  170. package/loader.js +13 -11
  171. package/managed/raw/envrc +33 -67
  172. package/managed/raw/git-format-staged.yml +30 -35
  173. package/managed/raw/patches/nx@23.2.1.patch +3484 -0
  174. package/managed/raw/tooling/direnv/apple-developer.sh +83 -0
  175. package/managed/raw/tooling/direnv/developer-links.ts +569 -11
  176. package/managed/raw/tooling/direnv/devenv.smoo.nix +314 -93
  177. package/managed/raw/tooling/direnv/github-actions-bootstrap.sh +20 -11
  178. package/managed/raw/tooling/direnv/linked-snapshots.ts +845 -0
  179. package/managed/raw/tooling/direnv/nx-socket-dir.sh +82 -0
  180. package/managed/raw/tooling/direnv/repo-path +14 -2
  181. package/managed/raw/tooling/direnv/setup-environment.ts +1146 -159
  182. package/managed/raw/tooling/direnv/toolchain-stamp.ts +45 -3
  183. package/managed/raw/tooling/direnv/ttsc-env.sh +39 -0
  184. package/managed/raw/tooling/git-hooks/commit-msg.sh +5 -6
  185. package/managed/raw/tooling/git-hooks/pre-commit.sh +7 -6
  186. package/managed/raw/tooling/git-hooks/pre-push.sh +20 -15
  187. package/managed/templates/github/actions/cache-nix-devenv/action.yml +6 -6
  188. package/managed/templates/github/actions/cache-node-modules/action.yml +6 -4
  189. package/managed/templates/github/actions/cache-nx/action.yml +1 -1
  190. package/managed/templates/github/actions/cache-ttsc-plugins/action.yml +1 -1
  191. package/managed/templates/github/actions/forgejo-artifact.cjs +99 -0
  192. package/managed/templates/github/actions/forgejo-download-artifact/action.yml +49 -0
  193. package/managed/templates/github/actions/forgejo-download-artifact/index.cjs +7 -0
  194. package/managed/templates/github/actions/forgejo-upload-artifact/action.yml +65 -0
  195. package/managed/templates/github/actions/forgejo-upload-artifact/index.cjs +7 -0
  196. package/managed/templates/github/actions/setup-devenv/action.yml +21 -3
  197. package/managed/templates/github/workflows/managed-files.yml +1 -2
  198. package/nextest.toml +8 -41
  199. package/package.json +74 -12
  200. package/runtime-input.sh +81 -0
  201. package/src/__tests__/counted-cargo.ts +33 -14
  202. package/src/__tests__/fixture-nx-env.ts +111 -46
  203. package/src/__tests__/progress-clock.ts +43 -0
  204. package/src/__tests__/runtime-input.ts +23 -0
  205. package/src/bin/smoo-nx-bound-failures.test.ts +127 -0
  206. package/src/bin/smoo-nx-bound-failures.ts +33 -0
  207. package/src/bin/smoo-nx-cargo-hash.ts +28 -3
  208. package/src/bin/smoo-nx-exec.ts +16 -74
  209. package/src/bin/smoo-nx-failures.ts +4 -0
  210. package/src/bin/smoo-nx-nextest-extract.ts +3 -2
  211. package/src/bin/smoo-nx-test-walks.ts +42 -0
  212. package/src/bounded-test-policy.test.ts +268 -21
  213. package/src/bounded-test-policy.ts +114 -42
  214. package/src/build-state-output-policy.test.ts +115 -0
  215. package/src/build-state-output-policy.ts +90 -0
  216. package/src/bun-bootstrap.test.ts +57 -3
  217. package/src/bun-file-packages.test.ts +47 -0
  218. package/src/cargo-closure-input.test.ts +138 -66
  219. package/src/cargo-closure-input.ts +17 -15
  220. package/src/cargo-dev-profile.ts +137 -0
  221. package/src/cargo-resolve-cache.test.ts +70 -1
  222. package/src/cargo-source-hash.test.ts +193 -97
  223. package/src/cargo-source-hash.ts +345 -68
  224. package/src/cargo-toolchain-policy.ts +6 -0
  225. package/src/cargo-workspace.test.ts +320 -0
  226. package/src/cargo-workspace.ts +336 -10
  227. package/src/cross-check-policy.test.ts +59 -1
  228. package/src/cross-check-policy.ts +25 -6
  229. package/src/disk-command-policy.test.ts +61 -0
  230. package/src/disk-command-policy.ts +107 -0
  231. package/src/ensure-built-receipt.test.ts +184 -0
  232. package/src/ensure-built-receipt.ts +263 -0
  233. package/src/ensure-built-witness.test.ts +344 -0
  234. package/src/ensure-built-witness.ts +252 -0
  235. package/src/ensure-built.test.ts +1036 -578
  236. package/src/ensure-built.ts +820 -224
  237. package/src/eslint-file-set.ts +9 -0
  238. package/src/executors/bounded-exec/cpu-pool.test.ts +454 -0
  239. package/src/executors/bounded-exec/cpu-pool.ts +417 -0
  240. package/src/executors/bounded-exec/cpu-tokens.test.ts +269 -0
  241. package/src/executors/bounded-exec/cpu-tokens.ts +177 -0
  242. package/src/executors/bounded-exec/disk-lease.test.ts +185 -0
  243. package/src/executors/bounded-exec/disk-lease.ts +139 -0
  244. package/src/executors/bounded-exec/executor-host.test.ts +778 -0
  245. package/src/executors/bounded-exec/executor.test.ts +1116 -63
  246. package/src/executors/bounded-exec/executor.ts +565 -67
  247. package/src/executors/bounded-exec/gateway-lease.ts +176 -0
  248. package/src/executors/bounded-exec/hang-diagnostics.test.ts +285 -0
  249. package/src/executors/bounded-exec/hang-diagnostics.ts +283 -0
  250. package/src/executors/bounded-exec/progress.test.ts +79 -0
  251. package/src/executors/bounded-exec/progress.ts +118 -0
  252. package/src/executors/bounded-exec/ram-temp-fixtures.ts +12 -0
  253. package/src/executors/bounded-exec/ram-temp-held.test.ts +264 -0
  254. package/src/executors/bounded-exec/ram-temp-held.ts +242 -0
  255. package/src/executors/bounded-exec/ram-temp-host.test.ts +605 -0
  256. package/src/executors/bounded-exec/ram-temp.test.ts +674 -0
  257. package/src/executors/bounded-exec/ram-temp.ts +1918 -0
  258. package/src/executors/bounded-exec/schema.json +11 -5
  259. package/src/executors/bounded-exec/schema.ts +27 -11
  260. package/src/executors/bounded-exec/verdict.test.ts +440 -0
  261. package/src/executors/bounded-exec/verdict.ts +433 -0
  262. package/src/executors/shard-timings/executor.ts +36 -0
  263. package/src/executors/shard-timings/schema.json +21 -0
  264. package/src/executors/shard-timings/schema.ts +4 -0
  265. package/src/failure-summary.ts +119 -0
  266. package/src/generators/bounded-test-targets/generator.test.ts +4 -4
  267. package/src/generators/bun-test-tracing/generator.test.ts +2 -2
  268. package/src/generators/create-package/generator.test.ts +6 -0
  269. package/src/generators/create-package/generator.ts +6 -2
  270. package/src/host-controller-wiring.test.ts +31 -0
  271. package/src/index.test.ts +909 -295
  272. package/src/index.ts +441 -143
  273. package/src/linked-snapshots.nx.test.ts +172 -0
  274. package/src/managed-files/ci-workflow.ts +54 -13
  275. package/src/managed-files/files.ts +65 -9
  276. package/src/managed-files/forgejo-artifact.test.ts +395 -0
  277. package/src/managed-files/generator.test.ts +60 -1
  278. package/src/managed-files/json-edit.test.ts +216 -0
  279. package/src/managed-files/json-edit.ts +290 -0
  280. package/src/managed-files/managed-format-json.test.ts +308 -0
  281. package/src/managed-files/managed-format.ts +90 -2
  282. package/src/managed-files/pr-preview-cleanup-workflow.ts +69 -3
  283. package/src/managed-files/publish-workflow.ts +285 -67
  284. package/src/managed-files/repo-path.test.ts +129 -0
  285. package/src/managed-files/trace-db-artifact.test.ts +7 -0
  286. package/src/managed-files/tree.ts +11 -3
  287. package/src/manifest-hash.ts +2 -6
  288. package/src/nextest-code-bound.test.ts +155 -0
  289. package/src/nextest-code-bound.ts +195 -0
  290. package/src/nextest-extraction.test.ts +37 -5
  291. package/src/nextest-extraction.ts +51 -9
  292. package/src/nextest-partitions.test.ts +427 -82
  293. package/src/nx-cache-bound.test.ts +5 -10
  294. package/src/nx-cache-restore-mtime.test.ts +170 -0
  295. package/src/nx-daemon-claim.test.ts +277 -0
  296. package/src/nx-daemon-idle-cpu.test.ts +81 -0
  297. package/src/nx-daemon-idle-policy.test.ts +51 -0
  298. package/src/nx-daemon-ignore-files.test.ts +210 -0
  299. package/src/nx-daemon-root-normalization.test.ts +105 -0
  300. package/src/nx-daemon-validity.test.ts +925 -0
  301. package/src/nx-dot-input-policy.test.ts +353 -0
  302. package/src/nx-failure-life-cycles.test.ts +207 -0
  303. package/src/nx-files-archive-racy.test.ts +97 -0
  304. package/src/nx-foreign-workspace-env.test.ts +329 -0
  305. package/src/nx-incomplete-run-summary.test.ts +70 -0
  306. package/src/nx-plugin-load-errors.test.ts +120 -0
  307. package/src/nx-project-resolution-cache.test.ts +176 -0
  308. package/src/nx-raw-inputs.test.ts +166 -0
  309. package/src/nx-resident-graph-workers.test.ts +7 -16
  310. package/src/nx-run-information.test.ts +118 -0
  311. package/src/nx-skipped-task-exit.test.ts +180 -0
  312. package/src/nx-state-location.test.ts +63 -0
  313. package/src/nx-store-resolution.test.ts +26 -25
  314. package/src/nx-task-graph-cycles.test.ts +148 -0
  315. package/src/nx-task-output-lease.test.ts +414 -0
  316. package/src/nx-use-local.test.ts +103 -0
  317. package/src/package-target-policy.ts +3 -6
  318. package/src/release-config-policy.ts +3 -6
  319. package/src/runtime-input.test.ts +215 -0
  320. package/src/runtime-input.ts +17 -0
  321. package/src/rust-tokens.ts +78 -0
  322. package/src/serial-group-wiring.test.ts +326 -0
  323. package/src/task-history-namespace.test.ts +87 -89
  324. package/src/task-results.test.ts +226 -0
  325. package/src/task-results.ts +75 -0
  326. package/src/test-program.test.ts +303 -0
  327. package/src/test-program.ts +341 -0
  328. package/src/test-timings.test.ts +240 -0
  329. package/src/test-timings.ts +311 -0
  330. package/src/test-walk-policy.test.ts +585 -0
  331. package/src/test-walk-policy.ts +731 -0
  332. package/src/testing.test.ts +509 -0
  333. package/src/testing.ts +922 -0
  334. package/src/type-guards.ts +4 -0
  335. package/src/typecheck-test-policy.test.ts +496 -11
  336. package/src/typecheck-test-policy.ts +137 -103
  337. package/src/workspace-config-policy.test.ts +212 -13
  338. package/src/workspace-config-policy.ts +101 -73
  339. package/src/workspace-index.ts +18 -0
  340. package/src/workspace-manifest.ts +41 -0
  341. package/test-timings.json +85 -30
  342. package/managed/raw/tooling/direnv/inherited-devenv.ts +0 -665
  343. package/managed/raw/tooling/direnv/shared-caches.sh +0 -53
@@ -0,0 +1,344 @@
1
+ import { afterEach, beforeEach, describe, expect, it } from 'bun:test';
2
+ import { createHash } from 'node:crypto';
3
+ import {
4
+ chmod,
5
+ mkdir,
6
+ mkdtemp,
7
+ readFile,
8
+ realpath,
9
+ rename,
10
+ rm,
11
+ stat,
12
+ symlink,
13
+ utimes,
14
+ writeFile,
15
+ } from 'node:fs/promises';
16
+ import { tmpdir } from 'node:os';
17
+ import { join } from 'node:path';
18
+ import type { ProjectGraph } from 'nx/src/config/project-graph';
19
+ import { WorkspaceContext } from 'nx/src/native';
20
+ import { workspaceDataDirectoryForWorkspace } from 'nx/src/utils/cache-directory';
21
+ import type { readModulePackageJsonWithoutFallbacks } from 'nx/src/utils/package-json';
22
+ import typia from 'typia';
23
+ import {
24
+ type GraphWitness,
25
+ graphInstallationIdentity,
26
+ type NodeWitness,
27
+ nodesUnchanged,
28
+ readGraphWitness,
29
+ reusableGraph,
30
+ snapshotsEqual,
31
+ workspaceSnapshot,
32
+ writeWitness,
33
+ } from './ensure-built-witness.js';
34
+
35
+ let root = '';
36
+ const graph: ProjectGraph = {
37
+ nodes: {
38
+ app: { name: 'app', type: 'app', data: { root: 'packages/app', targets: { build: { executor: 'nx:noop' } } } },
39
+ },
40
+ dependencies: { app: [] },
41
+ };
42
+ const data = () => join(root, '.nx', 'workspace-data');
43
+ const snapshot = (previous?: GraphWitness['snapshot']) =>
44
+ workspaceSnapshot(root, new WorkspaceContext(root, data()), previous);
45
+
46
+ beforeEach(async () => {
47
+ root = await realpath(await mkdtemp(join(tmpdir(), 'ensure-built-witness-')));
48
+ await mkdir(data(), { recursive: true });
49
+ await mkdir(join(root, 'packages', 'app'), { recursive: true });
50
+ await writeFile(join(root, '.gitignore'), '.nx/\n');
51
+ await writeFile(join(root, 'nx.json'), '{}');
52
+ await writeFile(join(root, 'packages', 'app', 'project.json'), '{"name":"app"}');
53
+ await writeFile(join(root, 'packages', 'app', 'package.json'), '{"name":"app","version":"1"}');
54
+ await writeFile(join(root, 'packages', 'app', 'source.txt'), 'before');
55
+ await writeFile(join(root, 'bun.lock'), 'lock-before');
56
+ });
57
+ afterEach(async () => {
58
+ await rm(root, { recursive: true, force: true });
59
+ });
60
+
61
+ function witness(): GraphWitness {
62
+ return {
63
+ version: 1,
64
+ workspaceRoot: root,
65
+ environment: 'env',
66
+ installation: 'installed',
67
+ snapshot: snapshot(),
68
+ projectGraph: graph,
69
+ };
70
+ }
71
+
72
+ describe('authoritative graph witness', () => {
73
+ it('returns the exact previously awaited graph only for unchanged complete inputs', () => {
74
+ const previous = witness();
75
+ expect(reusableGraph(previous, root, 'env', 'installed', snapshot(previous.snapshot))).toBe(graph);
76
+ expect(reusableGraph(previous, root, 'env-changed', 'installed', previous.snapshot)).toBeNull();
77
+ expect(reusableGraph(previous, root, 'env', 'provider-changed', previous.snapshot)).toBeNull();
78
+ expect(reusableGraph(previous, root, 'env', null, previous.snapshot)).toBeNull();
79
+ expect(reusableGraph(previous, root + '/other', 'env', 'installed', previous.snapshot)).toBeNull();
80
+ expect(reusableGraph(null, root, 'env', 'installed', previous.snapshot)).toBeNull();
81
+ expect(reusableGraph(previous, root, 'env', 'installed', { ...previous.snapshot, stable: false })).toBeNull();
82
+ });
83
+
84
+ for (const file of [
85
+ 'nx.json',
86
+ 'bun.lock',
87
+ 'packages/app/project.json',
88
+ 'packages/app/package.json',
89
+ 'packages/app/source.txt',
90
+ ]) {
91
+ it(`immediately rejects changed ${file}, including same-length writes with restored mtime`, async () => {
92
+ const previous = witness();
93
+ const path = join(root, file);
94
+ const { stat } = await import('node:fs/promises');
95
+ const before = await stat(path);
96
+ const original = await readFile(path, 'utf8');
97
+ await writeFile(path, 'x'.repeat(original.length));
98
+ await utimes(path, before.atime, before.mtime);
99
+ expect(reusableGraph(previous, root, 'env', 'installed', snapshot(previous.snapshot))).toBeNull();
100
+ });
101
+ }
102
+
103
+ it('rejects newly created and deleted files, including manifests under broad output-like directories', async () => {
104
+ const previous = witness();
105
+ await mkdir(join(root, 'packages', 'app', 'dist'));
106
+ await writeFile(join(root, 'packages', 'app', 'dist', 'project.json'), '{"name":"new-project"}');
107
+ expect(snapshotsEqual(previous.snapshot, snapshot(previous.snapshot))).toBe(false);
108
+ await rm(join(root, 'packages', 'app', 'dist'), { recursive: true });
109
+ await rm(join(root, 'packages', 'app', 'source.txt'));
110
+ expect(snapshotsEqual(previous.snapshot, snapshot(previous.snapshot))).toBe(false);
111
+ });
112
+
113
+ it('rehashes a replacement node even when its length and mtime match the previous one', async () => {
114
+ const previous = witness();
115
+ const path = join(root, 'packages', 'app', 'source.txt');
116
+ const { stat } = await import('node:fs/promises');
117
+ const before = await stat(path);
118
+ await writeFile(path + '.replacement', 'AFTER!');
119
+ await utimes(path + '.replacement', before.atime, before.mtime);
120
+ await rename(path + '.replacement', path);
121
+ expect(reusableGraph(previous, root, 'env', 'installed', snapshot(previous.snapshot))).toBeNull();
122
+ });
123
+
124
+ it('revokes node evidence for a write/revert even when pre/post content hashes are equal', async () => {
125
+ const previous = witness();
126
+ const path = join(root, 'packages/app/source.txt');
127
+ await writeFile(path, 'AFTER!');
128
+ await writeFile(path, 'before');
129
+ const after = snapshot(previous.snapshot);
130
+ expect(snapshotsEqual(previous.snapshot, after)).toBe(true);
131
+ expect(nodesUnchanged(previous.snapshot.nodes)).toBe(false);
132
+ });
133
+ it('does not admit missing, unreadable, malformed or wrong-version evidence', async () => {
134
+ const path = join(data(), 'ensure-built-graph.json');
135
+ expect(readGraphWitness(path)).toBeNull();
136
+ await writeFile(path, 'not JSON');
137
+ expect(readGraphWitness(path)).toBeNull();
138
+ writeWitness(path, witness());
139
+ expect(readGraphWitness(path)?.projectGraph).toEqual(graph);
140
+ await chmod(path, 0);
141
+ try {
142
+ expect(readGraphWitness(path)).toBeNull();
143
+ } finally {
144
+ await chmod(path, 0o600);
145
+ }
146
+ await writeFile(path, JSON.stringify({ ...witness(), version: 2 }));
147
+ expect(readGraphWitness(path)).toBeNull();
148
+ });
149
+ });
150
+
151
+ describe('runtime graph witness storage', () => {
152
+ it.each(['relative', 'absolute'])(
153
+ 'uses the %s workspace-data binding for missing and unreadable witnesses',
154
+ async (kind) => {
155
+ const inherited = process.env.NX_WORKSPACE_DATA_DIRECTORY;
156
+ process.env.NX_WORKSPACE_DATA_DIRECTORY =
157
+ kind === 'relative' ? '.nx/runtime-data' : join(root, '.nx', 'runtime-data');
158
+ try {
159
+ const directory = workspaceDataDirectoryForWorkspace(root);
160
+ await mkdir(directory, { recursive: true });
161
+ const original = witness();
162
+ writeWitness(join(directory, 'ensure-built-graph.json'), original);
163
+ expect(directory).toBe(join(root, '.nx', 'runtime-data'));
164
+ const path = join(directory, 'ensure-built-graph.json');
165
+ await chmod(path, 0);
166
+ try {
167
+ expect(readGraphWitness(path)).toBeNull();
168
+ } finally {
169
+ await chmod(path, 0o600);
170
+ }
171
+ expect(readGraphWitness(path)).toEqual(original);
172
+ await rm(path);
173
+ expect(readGraphWitness(path)).toBeNull();
174
+ writeWitness(path, original);
175
+ expect(readGraphWitness(path)).toEqual(original);
176
+ } finally {
177
+ if (inherited === undefined) delete process.env.NX_WORKSPACE_DATA_DIRECTORY;
178
+ else process.env.NX_WORKSPACE_DATA_DIRECTORY = inherited;
179
+ }
180
+ },
181
+ );
182
+ });
183
+
184
+ describe('installed graph input identity', () => {
185
+ const parseInstallation = typia.json.createAssertParse<{
186
+ resolutions: [string, string, string | null][];
187
+ nodes: NodeWitness[];
188
+ files: { path: string; sha256: string }[];
189
+ }>();
190
+ const parsed = (identity: string | null) => parseInstallation(typia.assert<string>(identity));
191
+ async function packages() {
192
+ const nx = join(root, 'installed-nx');
193
+ const plugin = join(root, 'installed-plugin');
194
+ const dependency = join(root, 'installed-dependency');
195
+ for (const path of [nx, plugin, dependency]) {
196
+ await mkdir(join(path, 'dist'), { recursive: true });
197
+ await writeFile(join(path, 'package.json'), '{"name":"owned","version":"1","exports":"./dist/index.js"}');
198
+ await writeFile(join(path, 'dist', 'index.js'), 'exports.value = 1;');
199
+ }
200
+ const resolver: typeof readModulePackageJsonWithoutFallbacks = (name) => {
201
+ const path = name === 'nx' ? nx : name === '@smoothbricks/nx-plugin' ? plugin : dependency;
202
+ const dependencies: Record<string, string> =
203
+ name === '@smoothbricks/nx-plugin' ? { alias: 'npm:dependency@1' } : {};
204
+ return {
205
+ path: join(path, 'package.json'),
206
+ packageJson: {
207
+ name,
208
+ version: '1',
209
+ exports: './dist/index.js',
210
+ files: ['dist'],
211
+ dependencies,
212
+ },
213
+ };
214
+ };
215
+ return { nx, plugin, dependency, resolver };
216
+ }
217
+
218
+ it('binds public plugin bytes, package resolution metadata, dependency alias targets and tree membership', async () => {
219
+ const { nx, plugin, dependency, resolver } = await packages();
220
+ const output = join(plugin, 'dist', 'index.js');
221
+ await utimes(output, 1_600_000_000, 1_600_000_000);
222
+ const identity = () => graphInstallationIdentity(root, { plugins: ['@smoothbricks/nx-plugin'] }, resolver);
223
+ const original = identity();
224
+ expect(original).not.toBeNull();
225
+ expect(identity()).toBe(original);
226
+ const files = parsed(original).files;
227
+ expect(files.map(({ path }) => path).sort()).toEqual(
228
+ [nx, plugin, dependency].flatMap((path) => [join(path, 'dist', 'index.js'), join(path, 'package.json')]).sort(),
229
+ );
230
+ for (const file of files) {
231
+ expect(file.sha256, file.path).toBe(
232
+ createHash('sha256')
233
+ .update(await readFile(file.path))
234
+ .digest('hex'),
235
+ );
236
+ }
237
+ const before = await stat(output);
238
+ await writeFile(output, 'exports.value = 2;');
239
+ await utimes(output, before.atime, before.mtime);
240
+ expect((await stat(output)).size).toBe(before.size);
241
+ expect((await stat(output)).mtimeMs).toBe(before.mtimeMs);
242
+ const changed = identity();
243
+ expect(changed).not.toBe(original);
244
+ expect(parsed(changed).files.find(({ path }) => path === output)?.sha256).toBe(
245
+ createHash('sha256').update('exports.value = 2;').digest('hex'),
246
+ );
247
+ expect(parsed(changed).files.find(({ path }) => path === output)?.sha256).not.toBe(
248
+ files.find(({ path }) => path === output)?.sha256,
249
+ );
250
+ const emitted = identity();
251
+ await writeFile(join(plugin, 'package.json'), '{"name":"renamed","version":"2","exports":"./other.js"}');
252
+ expect(identity()).not.toBe(emitted);
253
+ const manifest = identity();
254
+ await writeFile(join(dependency, 'added.js'), 'exports.member = true;');
255
+ expect(identity()).not.toBe(manifest);
256
+ const member = identity();
257
+ await rm(join(dependency, 'added.js'));
258
+ expect(identity()).not.toBe(member);
259
+ });
260
+
261
+ it('streams every byte across multiple buffer fills, including the final partial fill', async () => {
262
+ const { dependency, resolver } = await packages();
263
+ const output = join(dependency, 'dist', 'payload.bin');
264
+ const bytes = Buffer.alloc(2 * 64 * 1024 + 17, 0x61);
265
+ await writeFile(output, bytes);
266
+ const identity = () => graphInstallationIdentity(root, { plugins: ['@smoothbricks/nx-plugin'] }, resolver);
267
+ const original = parsed(identity());
268
+ expect(original.files.find(({ path }) => path === output)?.sha256).toBe(
269
+ createHash('sha256').update(bytes).digest('hex'),
270
+ );
271
+ const before = await stat(output);
272
+ bytes[64 * 1024] = 0x62;
273
+ bytes[bytes.length - 1] = 0x63;
274
+ await writeFile(output, bytes);
275
+ await utimes(output, before.atime, before.mtime);
276
+ expect((await stat(output)).size).toBe(before.size);
277
+ const changed = parsed(identity());
278
+ expect(changed.files.find(({ path }) => path === output)?.sha256).toBe(
279
+ createHash('sha256').update(bytes).digest('hex'),
280
+ );
281
+ expect(changed.files.find(({ path }) => path === output)?.sha256).not.toBe(
282
+ original.files.find(({ path }) => path === output)?.sha256,
283
+ );
284
+ });
285
+ it('proves a declared dist link by its physical output tree and rejects changed public bytes', async () => {
286
+ const { plugin, resolver } = await packages();
287
+ const published = join(root, 'published-build-volume');
288
+ await rename(join(plugin, 'dist'), published);
289
+ await symlink(published, join(plugin, 'dist'), 'dir');
290
+ const identity = () => graphInstallationIdentity(root, { plugins: ['@smoothbricks/nx-plugin'] }, resolver);
291
+ const original = identity();
292
+ expect(original).not.toBeNull();
293
+ expect(identity()).toBe(original);
294
+ const output = join(published, 'index.js');
295
+ const before = await stat(output);
296
+ await writeFile(output, 'exports.value = 2;');
297
+ await utimes(output, before.atime, before.mtime);
298
+ const changed = identity();
299
+ expect(changed).not.toBe(original);
300
+ expect(parsed(changed).files.find(({ path }) => path === output)?.sha256).toBe(
301
+ createHash('sha256').update('exports.value = 2;').digest('hex'),
302
+ );
303
+ });
304
+
305
+ it('binds an alias to its physical resolution target, not just its package name', async () => {
306
+ const { resolver, dependency } = await packages();
307
+ const alternative = join(root, 'alternative-dependency');
308
+ await mkdir(alternative);
309
+ await writeFile(join(alternative, 'package.json'), '{"name":"owned","version":"1"}');
310
+ const original = graphInstallationIdentity(root, { plugins: ['@smoothbricks/nx-plugin'] }, resolver);
311
+ const changed: typeof resolver = (name, from) => {
312
+ const result = resolver(name, from);
313
+ return name === 'alias' ? { ...result, path: join(alternative, 'package.json') } : result;
314
+ };
315
+ expect(graphInstallationIdentity(root, { plugins: ['@smoothbricks/nx-plugin'] }, changed)).not.toBe(original);
316
+ expect(dependency).not.toBe(alternative);
317
+ });
318
+
319
+ it('fails loudly for unreadable required module bytes rather than publishing an installation witness', async () => {
320
+ const { plugin, resolver } = await packages();
321
+ const output = join(plugin, 'dist/index.js');
322
+ await chmod(output, 0);
323
+ try {
324
+ expect(() => graphInstallationIdentity(root, { plugins: ['@smoothbricks/nx-plugin'] }, resolver)).toThrow();
325
+ } finally {
326
+ await chmod(output, 0o600);
327
+ }
328
+ });
329
+ it('does not invent an input contract for unknown plugins or unresolved required dependencies', async () => {
330
+ const { resolver } = await packages();
331
+ expect(graphInstallationIdentity(root, { plugins: ['opaque-plugin'] }, resolver)).toBeNull();
332
+ expect(
333
+ graphInstallationIdentity(root, {}, () => {
334
+ throw Object.assign(new Error('missing'), { code: 'MODULE_NOT_FOUND' });
335
+ }),
336
+ ).toBeNull();
337
+ });
338
+
339
+ it('refuses an unproved directory link instead of overlooking external plugin files', async () => {
340
+ const { plugin, dependency, resolver } = await packages();
341
+ await symlink(dependency, join(plugin, 'external'), 'dir');
342
+ expect(graphInstallationIdentity(root, { plugins: ['@smoothbricks/nx-plugin'] }, resolver)).toBeNull();
343
+ });
344
+ });
@@ -0,0 +1,252 @@
1
+ import { createHash, randomUUID } from 'node:crypto';
2
+ import type { BigIntStats } from 'node:fs';
3
+ import {
4
+ closeSync,
5
+ lstatSync,
6
+ openSync,
7
+ readdirSync,
8
+ readFileSync,
9
+ readSync,
10
+ realpathSync,
11
+ renameSync,
12
+ rmSync,
13
+ writeFileSync,
14
+ } from 'node:fs';
15
+ import { dirname, join } from 'node:path';
16
+ import type { NxJsonConfiguration } from 'nx/src/config/nx-json';
17
+ import type { ProjectGraph } from 'nx/src/config/project-graph';
18
+ import type { FileData, WorkspaceContext } from 'nx/src/native';
19
+ import type { readModulePackageJsonWithoutFallbacks } from 'nx/src/utils/package-json';
20
+ import typia from 'typia';
21
+
22
+ /** Identity of a previously read node, not a timestamp freshness threshold. */
23
+ export function nodeStamp(stats: BigIntStats): string {
24
+ return `${stats.dev}:${stats.ino}:${stats.mode}:${stats.size}:${stats.mtimeNs}:${stats.ctimeNs}`;
25
+ }
26
+
27
+ export interface NodeWitness {
28
+ readonly path: string;
29
+ readonly stamp: string;
30
+ }
31
+
32
+ export interface WorkspaceSnapshot {
33
+ readonly files: readonly FileData[];
34
+ readonly nodes: readonly NodeWitness[];
35
+ readonly stable: boolean;
36
+ }
37
+
38
+ export interface GraphWitness {
39
+ readonly version: 1;
40
+ readonly workspaceRoot: string;
41
+ readonly environment: string;
42
+ readonly installation: string;
43
+ readonly snapshot: WorkspaceSnapshot;
44
+ readonly projectGraph: ProjectGraph;
45
+ }
46
+
47
+ /** An absent, unreadable or malformed optional witness never authorizes reuse. */
48
+ export function readGraphWitness(path: string): GraphWitness | null {
49
+ try {
50
+ return typia.json.isParse<GraphWitness>(readFileSync(path, 'utf8'));
51
+ } catch (error) {
52
+ if (error instanceof SyntaxError || systemError(error)) return null;
53
+ throw error;
54
+ }
55
+ }
56
+
57
+ export function writeWitness(path: string, value: GraphWitness | ArtifactWitness): void {
58
+ const temporary = `${path}.${randomUUID()}`;
59
+ try {
60
+ writeFileSync(temporary, JSON.stringify(value), { flag: 'wx', mode: 0o600 });
61
+ renameSync(temporary, path);
62
+ } finally {
63
+ rmSync(temporary, { force: true });
64
+ }
65
+ }
66
+
67
+ /** Capture exact node identity and rehash new/replaced/rewritten nodes.
68
+ * Nx's Unix archive uses whole-second mtimes, so allFileData alone cannot
69
+ * prove an immediate same-second rewrite. An unbound archive hash is never
70
+ * admitted: on the first capture every file is rehashed through Nx itself.
71
+ */
72
+ export function workspaceSnapshot(
73
+ workspaceRoot: string,
74
+ context: WorkspaceContext,
75
+ previous: WorkspaceSnapshot | undefined,
76
+ ): WorkspaceSnapshot {
77
+ const files = context.allFileData();
78
+ const prior = new Map(previous?.nodes.map((node) => [node.path, node.stamp]));
79
+ const nodes: NodeWitness[] = [];
80
+ const changed: string[] = [];
81
+ let complete = true;
82
+ for (const { file } of files) {
83
+ const path = join(workspaceRoot, file);
84
+ const stats = lstatSync(path, { bigint: true });
85
+ const node = { path, stamp: nodeStamp(stats) };
86
+ nodes.push(node);
87
+ let moved = prior.get(path) !== node.stamp;
88
+ if (stats.isSymbolicLink()) {
89
+ const physical = realpathSync(path);
90
+ const targetStats = lstatSync(physical, { bigint: true });
91
+ const target = { path: physical, stamp: nodeStamp(targetStats) };
92
+ nodes.push(target);
93
+ moved ||= prior.get(physical) !== target.stamp;
94
+ // A file table does not prove the membership of an external directory.
95
+ if (!targetStats.isFile()) complete = false;
96
+ }
97
+ if (moved) changed.push(file);
98
+ }
99
+ if (changed.length > 0) context.incrementalUpdate(changed, []);
100
+ return { files: context.allFileData(), nodes, stable: complete && nodesUnchanged(nodes) };
101
+ }
102
+
103
+ export function nodesUnchanged(nodes: readonly NodeWitness[]): boolean {
104
+ for (const node of nodes) {
105
+ try {
106
+ if (nodeStamp(lstatSync(node.path, { bigint: true })) !== node.stamp) return false;
107
+ } catch (error) {
108
+ if (systemError(error)) return false;
109
+ throw error;
110
+ }
111
+ }
112
+ return true;
113
+ }
114
+
115
+ /** Membership and content are exact. Outputs do not exempt manifests or
116
+ * newly created/deleted files; this graph witness has no output exclusions.
117
+ */
118
+ export function snapshotsEqual(left: WorkspaceSnapshot, right: WorkspaceSnapshot): boolean {
119
+ if (!left.stable || !right.stable || left.files.length !== right.files.length) return false;
120
+ const hashes = new Map(left.files.map(({ file, hash }) => [file, hash]));
121
+ return right.files.every(({ file, hash }) => hashes.get(file) === hash);
122
+ }
123
+
124
+ export function reusableGraph(
125
+ witness: GraphWitness | null,
126
+ workspaceRoot: string,
127
+ environment: string,
128
+ installation: string | null,
129
+ snapshot: WorkspaceSnapshot,
130
+ ): ProjectGraph | null {
131
+ return witness !== null &&
132
+ witness.version === 1 &&
133
+ witness.workspaceRoot === workspaceRoot &&
134
+ installation !== null &&
135
+ witness.installation === installation &&
136
+ witness.environment === environment &&
137
+ snapshotsEqual(witness.snapshot, snapshot)
138
+ ? witness.projectGraph
139
+ : null;
140
+ }
141
+
142
+ /** Plugins with opaque external graph inputs cannot borrow this proof.
143
+ * For the repository plugin and Nx, bind the entire owned module/file tree
144
+ * and its dependency/optional/peer resolution closure, including each alias,
145
+ * physical target and package manifest. SHA-256 binds every regular file's
146
+ * bytes, including manifest metadata; pre/post node stamps still reject a
147
+ * tree that moved while reading. A missing optional dependency is recorded too.
148
+ */
149
+ export function graphInstallationIdentity(
150
+ workspaceRoot: string,
151
+ nxJson: NxJsonConfiguration,
152
+ resolvePackage: typeof readModulePackageJsonWithoutFallbacks,
153
+ ): string | null {
154
+ const plugins = (nxJson.plugins ?? []).map((plugin) => (typeof plugin === 'string' ? plugin : plugin.plugin));
155
+ if (plugins.some((plugin) => plugin !== '@smoothbricks/nx-plugin')) return null;
156
+ const nodes: NodeWitness[] = [];
157
+ const files: { path: string; sha256: string }[] = [];
158
+ const buffer = Buffer.allocUnsafe(64 * 1024);
159
+ const resolutions: [string, string, string | null][] = [];
160
+ const visited = new Set<string>();
161
+ const declaredDirectoryLinks = new Set<string>();
162
+ function walk(path: string): void {
163
+ const stats = lstatSync(path, { bigint: true });
164
+ nodes.push({ path, stamp: nodeStamp(stats) });
165
+ if (stats.isSymbolicLink()) {
166
+ const physical = realpathSync(path);
167
+ if (lstatSync(physical).isDirectory() && !declaredDirectoryLinks.has(path)) {
168
+ throw new Error(`Unproved directory link in graph package: ${path}`);
169
+ }
170
+ walk(physical);
171
+ } else if (stats.isDirectory()) {
172
+ for (const name of readdirSync(path).sort()) {
173
+ if (name !== 'node_modules' && name !== '.git' && name !== '.nx') walk(join(path, name));
174
+ }
175
+ } else if (!stats.isFile()) {
176
+ throw new Error(`Unproved graph package node: ${path}`);
177
+ } else {
178
+ const hash = createHash('sha256');
179
+ const fd = openSync(path, 'r');
180
+ try {
181
+ for (let count = readSync(fd, buffer); count > 0; count = readSync(fd, buffer)) {
182
+ hash.update(buffer.subarray(0, count));
183
+ }
184
+ } finally {
185
+ closeSync(fd);
186
+ }
187
+ files.push({ path, sha256: hash.digest('hex') });
188
+ }
189
+ }
190
+ function visit(name: string, from: string, optional: boolean): void {
191
+ let resolved: ReturnType<typeof readModulePackageJsonWithoutFallbacks>;
192
+ try {
193
+ resolved = resolvePackage(name, [from]);
194
+ } catch (error) {
195
+ if (optional && systemError(error) && error.code === 'MODULE_NOT_FOUND') {
196
+ resolutions.push([from, name, null]);
197
+ return;
198
+ }
199
+ throw error;
200
+ }
201
+ const physical = realpathSync(resolved.path);
202
+ resolutions.push([from, name, physical]);
203
+ if (visited.has(physical)) return;
204
+ visited.add(physical);
205
+ const packageRoot = dirname(physical);
206
+ const manifest = resolved.packageJson;
207
+ // A package-owned published dist lane may live on its build volume. Its
208
+ // link node and every physical target node remain part of this proof.
209
+ if (manifest.files?.includes('dist')) declaredDirectoryLinks.add(join(packageRoot, 'dist'));
210
+ walk(packageRoot);
211
+ const dependencies = { ...manifest.peerDependencies, ...manifest.dependencies, ...manifest.optionalDependencies };
212
+ for (const dependency of Object.keys(dependencies).sort()) {
213
+ visit(
214
+ dependency,
215
+ packageRoot,
216
+ manifest.optionalDependencies?.[dependency] !== undefined ||
217
+ manifest.peerDependenciesMeta?.[dependency]?.optional === true,
218
+ );
219
+ }
220
+ }
221
+ try {
222
+ for (const name of ['nx', ...plugins]) visit(name, workspaceRoot, false);
223
+ visit('typescript', workspaceRoot, true);
224
+ return nodesUnchanged(nodes) ? JSON.stringify({ resolutions, nodes, files }) : null;
225
+ } catch (error) {
226
+ if (systemError(error) && ['EACCES', 'EPERM', 'EIO'].includes(error.code)) throw error;
227
+ // Installation uncertainty disables only graph reuse. Nx's authoritative
228
+ // RPC remains responsible for diagnosing invalid plugin installations.
229
+ if (error instanceof Error) return null;
230
+ throw error;
231
+ }
232
+ }
233
+
234
+ export interface ArtifactWitness {
235
+ readonly version: 1;
236
+ readonly workspaceRoot: string;
237
+ readonly claims: string;
238
+ readonly nodes: readonly (NodeWitness & { readonly taskId: string })[];
239
+ }
240
+
241
+ export function readArtifactWitness(path: string): ArtifactWitness | null {
242
+ try {
243
+ return typia.json.isParse<ArtifactWitness>(readFileSync(path, 'utf8'));
244
+ } catch (error) {
245
+ if (error instanceof SyntaxError || systemError(error)) return null;
246
+ throw error;
247
+ }
248
+ }
249
+
250
+ function systemError(error: unknown): error is Error & { code: string } {
251
+ return error instanceof Error && 'code' in error && typeof error.code === 'string';
252
+ }