@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
@@ -1,11 +1,10 @@
1
1
  import { Database } from 'bun:sqlite';
2
2
  import { expect, it } from 'bun:test';
3
3
  import { execFileSync, spawn } from 'node:child_process';
4
- import { mkdir, mkdtemp, readdir, readFile, realpath, rm, symlink, writeFile } from 'node:fs/promises';
5
- import { tmpdir } from 'node:os';
4
+ import { mkdir, readdir, readFile, symlink, writeFile } from 'node:fs/promises';
6
5
  import { join } from 'node:path';
7
6
  import { guardEvent } from './__tests__/counted-cargo.js';
8
- import { fixtureNxEnv, stopFixtureNxDaemon } from './__tests__/fixture-nx-env.js';
7
+ import { fixtureNxEnv, stopFixtureNxDaemon, withNxFixture } from './__tests__/fixture-nx-env.js';
9
8
 
10
9
  /**
11
10
  * Guards `patches/nx@23.2.1.patch`, the local build of nrwl/nx#37268 (issue
@@ -89,95 +88,94 @@ async function recordedRuns(directory: string) {
89
88
  }
90
89
 
91
90
  it('records task history in the client database when the running daemon resolved the shared one', async () => {
92
- const base = await realpath(await mkdtemp(join(tmpdir(), 'nx-history-owner-')));
93
- const root = join(base, 'workspace');
94
- // Nx shares its DB and cache across a repository's checkouts under ~/.nx/<id>;
95
- // a private HOME keeps that shared scope inside the fixture.
96
- const home = join(base, 'home');
97
- const { NX_WORKSPACE_DATA_DIRECTORY: _data, NX_CACHE_DIRECTORY: _cache, ...defaultScope } = fixtureNxEnv(root);
98
- // NX_DAEMON: this regression needs the daemon even when the enclosing gate
99
- // runs with CI=true, where Nx would otherwise disable it.
100
- const sharedEnv = { ...defaultScope, HOME: home, NX_DAEMON: 'true' };
101
- // Naming the checkout's default workspace-data directory explicitly keeps the
102
- // same daemon record, but any explicit data/cache directory turns Nx's sharing
103
- // off: this client's task details and cache rows land in the checkout DB.
104
- const localEnv = { ...fixtureNxEnv(root), HOME: home, NX_DAEMON: 'true' };
105
- const localData = join(root, '.nx/workspace-data');
106
- try {
107
- await mkdir(join(root, 'app'), { recursive: true });
108
- await mkdir(home);
109
- await symlink(join(repositoryRoot, 'node_modules'), join(root, 'node_modules'), 'dir');
110
- await writeFile(join(root, '.gitignore'), 'node_modules\n.nx\nexecutions.log\napp/result.txt\n');
111
- await writeFile(join(root, 'package.json'), JSON.stringify({ name: 'history-owner-fixture', private: true }));
112
- await writeFile(join(root, 'nx.json'), '{}\n');
113
- await writeFile(
114
- join(root, 'app/project.json'),
115
- JSON.stringify({
116
- name: 'app',
117
- targets: {
118
- build: {
119
- executor: 'nx:run-commands',
120
- cache: true,
121
- inputs: ['{projectRoot}/build.cjs'],
122
- outputs: ['{projectRoot}/result.txt'],
123
- options: { cwd: 'app' },
124
- configurations: {
125
- first: { command: 'node build.cjs first' },
126
- second: { command: 'node build.cjs second' },
91
+ await withNxFixture(
92
+ 'nx-history-owner-',
93
+ async ({ root: base, socketDirectory, workspace: root }) => {
94
+ // Nx shares its DB and cache across a repository's checkouts under ~/.nx/<id>;
95
+ // a private HOME keeps that shared scope inside the fixture.
96
+ const home = join(base, 'home');
97
+ const {
98
+ NX_WORKSPACE_DATA_DIRECTORY: _data,
99
+ NX_CACHE_DIRECTORY: _cache,
100
+ ...defaultScope
101
+ } = fixtureNxEnv(root, socketDirectory);
102
+ // NX_DAEMON: this regression needs the daemon, which fixtureNxEnv turns off.
103
+ const sharedEnv = { ...defaultScope, HOME: home, NX_DAEMON: 'true' };
104
+ // Naming the checkout's default workspace-data directory explicitly keeps the
105
+ // same daemon record, but any explicit data/cache directory turns Nx's sharing
106
+ // off: this client's task details and cache rows land in the checkout DB.
107
+ const localEnv = { ...fixtureNxEnv(root, socketDirectory), HOME: home, NX_DAEMON: 'true' };
108
+ const localData = join(root, '.nx/workspace-data');
109
+ await mkdir(join(root, 'app'), { recursive: true });
110
+ await mkdir(home);
111
+ await symlink(join(repositoryRoot, 'node_modules'), join(root, 'node_modules'), 'dir');
112
+ await writeFile(join(root, '.gitignore'), 'node_modules\n.nx\nexecutions.log\napp/result.txt\n');
113
+ await writeFile(join(root, 'package.json'), JSON.stringify({ name: 'history-owner-fixture', private: true }));
114
+ await writeFile(join(root, 'nx.json'), '{}\n');
115
+ await writeFile(
116
+ join(root, 'app/project.json'),
117
+ JSON.stringify({
118
+ name: 'app',
119
+ targets: {
120
+ build: {
121
+ executor: 'nx:run-commands',
122
+ cache: true,
123
+ inputs: ['{projectRoot}/build.cjs'],
124
+ outputs: ['{projectRoot}/result.txt'],
125
+ options: { cwd: 'app' },
126
+ configurations: {
127
+ first: { command: 'node build.cjs first' },
128
+ second: { command: 'node build.cjs second' },
129
+ },
127
130
  },
128
131
  },
129
- },
130
- }),
131
- );
132
- await writeFile(
133
- join(root, 'app/build.cjs'),
134
- `const fs = require('node:fs');\nconst value = process.argv[2];\nfs.writeFileSync('result.txt', value);\nfs.appendFileSync('../executions.log', value + '\\n');\n`,
135
- );
136
-
137
- execFileSync('git', ['init', '--quiet', root], { stdio: 'pipe' });
138
- // A remote is what gives the checkout the repository identity Nx shares by.
139
- execFileSync('git', ['-C', root, 'remote', 'add', 'origin', 'https://github.com/example/history-owner.git'], {
140
- stdio: 'pipe',
141
- });
142
- const firstOutput = await runNx(root, sharedEnv, 'first');
143
- const daemonRecord = join(localData, 'd/server-process.json');
144
- const initialDaemon = await readFile(daemonRecord, 'utf8').catch(async (error: unknown) => {
145
- const log = await readFile(join(localData, 'd/daemon.log'), 'utf8').catch(
146
- (readError: unknown) => `daemon log unreadable: ${String(readError)}`,
132
+ }),
133
+ );
134
+ await writeFile(
135
+ join(root, 'app/build.cjs'),
136
+ `const fs = require('node:fs');\nconst value = process.argv[2];\nfs.writeFileSync('result.txt', value);\nfs.appendFileSync('../executions.log', value + '\\n');\n`,
147
137
  );
148
- throw new Error(`fixture Nx did not retain its normal daemon record\n${firstOutput}\n${log}`, { cause: error });
149
- });
150
138
 
151
- // Same daemon, but this client's TaskDetails select the checkout DB. Unpatched
152
- // Nx 23.2.1 forwards RECORD_TASK_RUNS to the daemon, whose DB scope was frozen
153
- // shared at startup and lacks the new hash: after the successful task footer
154
- // it prints "DB transaction error ... extended_code: 787" and exits 1.
155
- await runNx(root, localEnv, 'second');
156
- expect(await readFile(daemonRecord, 'utf8')).toBe(initialDaemon);
157
- expect(await readFile(join(root, 'executions.log'), 'utf8')).toBe('first\nsecond\n');
139
+ execFileSync('git', ['init', '--quiet', root], { stdio: 'pipe' });
140
+ // A remote is what gives the checkout the repository identity Nx shares by.
141
+ execFileSync('git', ['-C', root, 'remote', 'add', 'origin', 'https://github.com/example/history-owner.git'], {
142
+ stdio: 'pipe',
143
+ });
144
+ const firstOutput = await runNx(root, sharedEnv, 'first');
145
+ const daemonRecord = join(localData, 'd/server-process.json');
146
+ const initialDaemon = await readFile(daemonRecord, 'utf8').catch(async (error: unknown) => {
147
+ const log = await readFile(join(localData, 'd/daemon.log'), 'utf8').catch(
148
+ (readError: unknown) => `daemon log unreadable: ${String(readError)}`,
149
+ );
150
+ throw new Error(`fixture Nx did not retain its normal daemon record\n${firstOutput}\n${log}`, { cause: error });
151
+ });
158
152
 
159
- // The checkout cache answers the repeat: the recorded hash is usable.
160
- await runNx(root, localEnv, 'second');
161
- expect(await readFile(join(root, 'executions.log'), 'utf8')).toBe('first\nsecond\n');
162
- expect(await readFile(join(root, 'app/result.txt'), 'utf8')).toBe('second');
163
- expect(await readFile(daemonRecord, 'utf8')).toBe(initialDaemon);
164
- // Stop the fixture's daemon so no Nx process still holds either database
165
- // when the independent SQLite reader inspects them.
166
- await stopFixtureNxDaemon(root);
167
- const [sharedId, ...otherShared] = await readdir(join(home, '.nx'));
168
- expect(otherShared).toEqual([]);
169
- if (sharedId === undefined) throw new Error(`no shared Nx scope under ${home}/.nx`);
170
- expect(await recordedRuns(join(home, '.nx', sharedId, 'databases'))).toEqual([
171
- { configuration: 'first', status: 'success', code: 0, cacheCode: 0 },
172
- ]);
173
- expect(await recordedRuns(localData)).toEqual([
174
- { configuration: 'second', status: 'success', code: 0, cacheCode: 0 },
175
- ]);
176
- } finally {
177
- try {
178
- await stopFixtureNxDaemon(root);
179
- } finally {
180
- await rm(base, { recursive: true, force: true });
181
- }
182
- }
153
+ // Same daemon, but this client's TaskDetails select the checkout DB. Unpatched
154
+ // Nx 23.2.1 forwards RECORD_TASK_RUNS to the daemon, whose DB scope was frozen
155
+ // shared at startup and lacks the new hash: after the successful task footer
156
+ // it prints "DB transaction error ... extended_code: 787" and exits 1.
157
+ await runNx(root, localEnv, 'second');
158
+ expect(await readFile(daemonRecord, 'utf8')).toBe(initialDaemon);
159
+ expect(await readFile(join(root, 'executions.log'), 'utf8')).toBe('first\nsecond\n');
160
+
161
+ // The checkout cache answers the repeat: the recorded hash is usable.
162
+ await runNx(root, localEnv, 'second');
163
+ expect(await readFile(join(root, 'executions.log'), 'utf8')).toBe('first\nsecond\n');
164
+ expect(await readFile(join(root, 'app/result.txt'), 'utf8')).toBe('second');
165
+ expect(await readFile(daemonRecord, 'utf8')).toBe(initialDaemon);
166
+ // Stop the fixture's daemon so no Nx process still holds either database
167
+ // when the independent SQLite reader inspects them.
168
+ await stopFixtureNxDaemon(root, fixtureNxEnv(root, socketDirectory));
169
+ const [sharedId, ...otherShared] = await readdir(join(home, '.nx'));
170
+ expect(otherShared).toEqual([]);
171
+ if (sharedId === undefined) throw new Error(`no shared Nx scope under ${home}/.nx`);
172
+ expect(await recordedRuns(join(home, '.nx', sharedId, 'databases'))).toEqual([
173
+ { configuration: 'first', status: 'success', code: 0, cacheCode: 0 },
174
+ ]);
175
+ expect(await recordedRuns(localData)).toEqual([
176
+ { configuration: 'second', status: 'success', code: 0, cacheCode: 0 },
177
+ ]);
178
+ },
179
+ 'workspace',
180
+ );
183
181
  });
@@ -0,0 +1,226 @@
1
+ import { expect, it } from 'bun:test';
2
+ import { mkdir, readdir, readFile, realpath, stat, symlink, writeFile } from 'node:fs/promises';
3
+ import { dirname, join } from 'node:path';
4
+ import { fileURLToPath } from 'node:url';
5
+ import { fixtureNxEnv, withNxFixture } from './__tests__/fixture-nx-env.js';
6
+
7
+ /**
8
+ * The plugin's `preTasksExecution`/`postTasksExecution` hooks, run by a real Nx subprocess in a
9
+ * fixture workspace that registers the compiled `@smoothbricks/nx-plugin`. The hooks write a hint
10
+ * only under a controller-selected receipt id: an ordinary run and an invalid id leave no namespace,
11
+ * and a failed task is recorded as a failure, never as a success. The receipt variable is spelled
12
+ * here rather than imported, so the test loads only the compiled plugin through Nx.
13
+ */
14
+
15
+ const RECEIPT_ENV = 'COWSHED_NX_TASK_RECEIPT_ID';
16
+ const RECEIPT = '0123456789abcdef0123456789abcdef';
17
+ const CHANGED_RECEIPT = 'fedcba9876543210fedcba9876543210';
18
+ const packageRoot = dirname(dirname(fileURLToPath(import.meta.url)));
19
+ const repoRoot = dirname(dirname(packageRoot));
20
+ const nxEntry = join(repoRoot, 'node_modules', '.bin', 'nx');
21
+ const HINTS = join('.nx', 'cache', '.cowshed-task-results');
22
+
23
+ /** A fixture workspace: `app:build` caches its copy of `source.txt`; `app:fail` always exits 3. */
24
+ async function writeWorkspace(workspace: string): Promise<void> {
25
+ await mkdir(join(workspace, 'app'), { recursive: true });
26
+ const git = Bun.spawnSync(['git', 'init', '--quiet', workspace]);
27
+ expect(git.exitCode, git.stderr.toString()).toBe(0);
28
+ // The repository's own node_modules: the Nx and the plugin under test.
29
+ await symlink(join(repoRoot, 'node_modules'), join(workspace, 'node_modules'), 'dir');
30
+ await writeFile(
31
+ join(workspace, 'nx.json'),
32
+ JSON.stringify({ cacheDirectory: '.nx/cache', plugins: ['@smoothbricks/nx-plugin'] }),
33
+ );
34
+ await writeFile(
35
+ join(workspace, 'app', 'project.json'),
36
+ JSON.stringify({
37
+ name: 'app',
38
+ targets: {
39
+ build: {
40
+ executor: 'nx:run-commands',
41
+ cache: true,
42
+ inputs: ['{projectRoot}/source.txt'],
43
+ outputs: ['{projectRoot}/result.txt'],
44
+ // runs.txt is an undeclared execution marker: it counts real executions, not cache hits.
45
+ options: { cwd: 'app', command: 'cp source.txt result.txt && echo run >> runs.txt' },
46
+ },
47
+ fail: { executor: 'nx:run-commands', cache: false, options: { cwd: 'app', command: 'exit 3' } },
48
+ },
49
+ }),
50
+ );
51
+ await writeFile(join(workspace, 'app', 'source.txt'), 'one');
52
+ }
53
+
54
+ /** Runs one target with `nx run` under `env`, returning its exit code, output and argv. */
55
+ async function nx(workspace: string, env: Record<string, string>, target: string) {
56
+ const argv = [process.execPath, nxEntry, 'run', target, '--outputStyle=static'];
57
+ const child = Bun.spawn(argv, { cwd: workspace, env, stdout: 'pipe', stderr: 'pipe' });
58
+ const [exitCode, stdout, stderr] = await Promise.all([
59
+ child.exited,
60
+ new Response(child.stdout).text(),
61
+ new Response(child.stderr).text(),
62
+ ]);
63
+ return { exitCode, log: `${stdout}${stderr}`, argv };
64
+ }
65
+
66
+ async function exists(path: string): Promise<boolean> {
67
+ try {
68
+ await stat(path);
69
+ return true;
70
+ } catch (error) {
71
+ if (error instanceof Error && 'code' in error && error.code === 'ENOENT') return false;
72
+ throw error;
73
+ }
74
+ }
75
+
76
+ /** Executions of `app:build`, one `run` line per real execution. */
77
+ async function runCount(workspace: string): Promise<number> {
78
+ const lines = (await readFile(join(workspace, 'app', 'runs.txt'), 'utf8')).split('\n');
79
+ return lines.filter((line) => line === 'run').length;
80
+ }
81
+
82
+ /** The single hint in a receipt's namespace, parsed. */
83
+ async function readHint(namespace: string): Promise<unknown> {
84
+ const files = await readdir(namespace);
85
+ expect(files).toHaveLength(1);
86
+ const [file] = files;
87
+ if (file === undefined) throw new Error(`no hint in ${namespace}`);
88
+ return JSON.parse(await readFile(join(namespace, file), 'utf8'));
89
+ }
90
+
91
+ it('records a task hint only under a controller receipt, and never on an ordinary run', async () => {
92
+ await withNxFixture(
93
+ 'task-results',
94
+ async ({ workspace, socketDirectory }) => {
95
+ await writeWorkspace(workspace);
96
+ // The inherited receipt is dropped: only this test's runs choose one.
97
+ const { [RECEIPT_ENV]: _inherited, ...ordinary } = fixtureNxEnv(workspace, socketDirectory);
98
+ const hints = join(workspace, HINTS);
99
+ const source = join(workspace, 'app', 'source.txt');
100
+
101
+ const first = await nx(workspace, ordinary, 'app:build');
102
+ expect(first.exitCode, first.log).toBe(0);
103
+ expect(await runCount(workspace)).toBe(1);
104
+ expect(await exists(hints)).toBe(false);
105
+
106
+ const hit = await nx(workspace, { ...ordinary, [RECEIPT_ENV]: RECEIPT }, 'app:build');
107
+ expect(hit.exitCode, hit.log).toBe(0);
108
+ expect(hit.log).toContain('local cache');
109
+ expect(await runCount(workspace)).toBe(1);
110
+ expect(await readdir(hints)).toEqual([RECEIPT]);
111
+ expect(await readHint(join(hints, RECEIPT))).toMatchObject({
112
+ version: 1,
113
+ requestId: RECEIPT,
114
+ workspaceRoot: workspace,
115
+ run: { argv: [process.execPath, await realpath(nxEntry), ...hit.argv.slice(2)] },
116
+ tasks: [{ task: { id: 'app:build', hash: expect.stringMatching(/^\d+$/) }, status: 'local-cache', code: 0 }],
117
+ });
118
+
119
+ const invalid = await nx(workspace, { ...ordinary, [RECEIPT_ENV]: 'NOT-A-REQUEST-ID' }, 'app:build');
120
+ expect(invalid.exitCode, invalid.log).toBe(0);
121
+ expect(invalid.log).toContain('is not a controller-selected 32-hex request id');
122
+ expect(await readdir(hints)).toEqual([RECEIPT]);
123
+
124
+ await writeFile(source, 'two');
125
+ const changed = await nx(workspace, { ...ordinary, [RECEIPT_ENV]: CHANGED_RECEIPT }, 'app:build');
126
+ expect(changed.exitCode, changed.log).toBe(0);
127
+ expect(await runCount(workspace)).toBe(2);
128
+ expect((await readdir(hints)).sort()).toEqual([RECEIPT, CHANGED_RECEIPT].sort());
129
+ expect(await readHint(join(hints, CHANGED_RECEIPT))).toMatchObject({
130
+ version: 1,
131
+ requestId: CHANGED_RECEIPT,
132
+ run: { argv: [process.execPath, await realpath(nxEntry), ...changed.argv.slice(2)] },
133
+ tasks: [{ task: { id: 'app:build', hash: expect.stringMatching(/^\d+$/) }, status: 'success', code: 0 }],
134
+ });
135
+ },
136
+ '.',
137
+ );
138
+ }, 180_000);
139
+
140
+ it('records a failed task as a failure under a receipt, never as a success', async () => {
141
+ await withNxFixture(
142
+ 'task-results-failure',
143
+ async ({ workspace, socketDirectory }) => {
144
+ await writeWorkspace(workspace);
145
+ const { [RECEIPT_ENV]: _inherited, ...ordinary } = fixtureNxEnv(workspace, socketDirectory);
146
+
147
+ const failed = await nx(workspace, { ...ordinary, [RECEIPT_ENV]: RECEIPT }, 'app:fail');
148
+ expect(failed.exitCode).not.toBe(0);
149
+ expect(await readHint(join(workspace, HINTS, RECEIPT))).toMatchObject({
150
+ requestId: RECEIPT,
151
+ tasks: [{ task: { id: 'app:fail' }, status: 'failure', code: 1 }],
152
+ });
153
+ },
154
+ '.',
155
+ );
156
+ }, 120_000);
157
+
158
+ it('records hints through a daemon-backed Nx only under a checked receipt', async () => {
159
+ await withNxFixture(
160
+ 'task-results-daemon',
161
+ async ({ workspace, socketDirectory }) => {
162
+ await writeWorkspace(workspace);
163
+ // The daemon is on, as in normal use: the hooks run in the daemon, which receives the client's env.
164
+ const daemon: Record<string, string> = { ...fixtureNxEnv(workspace, socketDirectory), NX_DAEMON: 'true' };
165
+ const { [RECEIPT_ENV]: _inherited, ...ordinary } = daemon;
166
+ const hints = join(workspace, HINTS);
167
+ const namespaceA = join(hints, RECEIPT);
168
+
169
+ const first = await nx(workspace, ordinary, 'app:build');
170
+ expect(first.exitCode, first.log).toBe(0);
171
+ expect(await runCount(workspace)).toBe(1);
172
+ expect(await exists(hints)).toBe(false);
173
+
174
+ const checkedA = await nx(workspace, { ...ordinary, [RECEIPT_ENV]: RECEIPT }, 'app:build');
175
+ expect(checkedA.exitCode, checkedA.log).toBe(0);
176
+ expect(checkedA.log).toContain('[existing outputs match the cache, left as is]');
177
+ expect(await runCount(workspace)).toBe(1);
178
+ expect(await readHint(namespaceA)).toMatchObject({
179
+ version: 1,
180
+ requestId: RECEIPT,
181
+ workspaceRoot: workspace,
182
+ run: { argv: [checkedA.argv[0] ?? '', await realpath(nxEntry), ...checkedA.argv.slice(2)] },
183
+ tasks: [
184
+ {
185
+ task: { id: 'app:build', hash: expect.stringMatching(/^\d+$/) },
186
+ status: 'local-cache-kept-existing',
187
+ code: 0,
188
+ },
189
+ ],
190
+ });
191
+
192
+ // An ordinary run without a key must neither add a hint nor rewrite checked hint A.
193
+ const [fileA] = await readdir(namespaceA);
194
+ if (fileA === undefined) throw new Error(`no hint in ${namespaceA}`);
195
+ const hintA = join(namespaceA, fileA);
196
+ const bytesA = await readFile(hintA, 'utf8');
197
+ const mtimeA = (await stat(hintA, { bigint: true })).mtimeNs;
198
+ const ordinaryAgain = await nx(workspace, ordinary, 'app:build');
199
+ expect(ordinaryAgain.exitCode, ordinaryAgain.log).toBe(0);
200
+ expect(await readdir(hints)).toEqual([RECEIPT]);
201
+ expect(await readdir(namespaceA)).toEqual([fileA]);
202
+ expect(await readFile(hintA, 'utf8')).toBe(bytesA);
203
+ expect((await stat(hintA, { bigint: true })).mtimeNs).toBe(mtimeA);
204
+
205
+ // A new valid receipt records its own namespace, and the unchanged task is still not executed.
206
+ const checkedB = await nx(workspace, { ...ordinary, [RECEIPT_ENV]: CHANGED_RECEIPT }, 'app:build');
207
+ expect(checkedB.exitCode, checkedB.log).toBe(0);
208
+ expect(await runCount(workspace)).toBe(1);
209
+ expect((await readdir(hints)).sort()).toEqual([RECEIPT, CHANGED_RECEIPT].sort());
210
+ expect(await readHint(join(hints, CHANGED_RECEIPT))).toMatchObject({
211
+ version: 1,
212
+ requestId: CHANGED_RECEIPT,
213
+ workspaceRoot: workspace,
214
+ run: { argv: [checkedB.argv[0] ?? '', await realpath(nxEntry), ...checkedB.argv.slice(2)] },
215
+ tasks: [
216
+ {
217
+ task: { id: 'app:build', hash: expect.stringMatching(/^\d+$/) },
218
+ status: 'local-cache-kept-existing',
219
+ code: 0,
220
+ },
221
+ ],
222
+ });
223
+ },
224
+ '.',
225
+ );
226
+ }, 120_000);
@@ -0,0 +1,75 @@
1
+ import { createHash } from 'node:crypto';
2
+ import { mkdir, rename, writeFile } from 'node:fs/promises';
3
+ import { join } from 'node:path';
4
+ import { cacheDir, logger } from 'nx/src/devkit-exports.js';
5
+ import type { PostTasksExecutionContext, PreTasksExecutionContext } from 'nx/src/project-graph/plugins/public-api.js';
6
+ import type { TaskResult } from 'nx/src/tasks-runner/life-cycle.js';
7
+ import typia, { type tags } from 'typia';
8
+
9
+ /** A controller-selected hint namespace, not publication authority or a backend credential. */
10
+ export const NX_TASK_RECEIPT_ENV = 'COWSHED_NX_TASK_RECEIPT_ID';
11
+ type RequestId = string & tags.Pattern<'^[0-9a-f]{32}$'>;
12
+ const isRequestId = typia.createIs<RequestId>();
13
+ interface TaskHint {
14
+ readonly task: Pick<TaskResult['task'], 'id' | 'hash'>;
15
+ readonly status: TaskResult['status'];
16
+ readonly code: TaskResult['code'];
17
+ }
18
+ interface ResultHint {
19
+ readonly version: 1;
20
+ readonly requestId: RequestId;
21
+ readonly workspaceRoot: PostTasksExecutionContext['workspaceRoot'];
22
+ readonly run: Pick<PostTasksExecutionContext, 'id' | 'argv' | 'startTime' | 'endTime'>;
23
+ readonly tasks: readonly TaskHint[];
24
+ }
25
+ type WriteOutcome = { readonly ok: true } | { readonly ok: false; readonly path: string; readonly reason: string };
26
+ const WRITTEN: WriteOutcome = { ok: true };
27
+
28
+ function requestId(): RequestId | undefined {
29
+ const value = process.env[NX_TASK_RECEIPT_ENV];
30
+ return isRequestId(value) ? value : undefined;
31
+ }
32
+ export function preTasksExecution(_options: unknown, _context: PreTasksExecutionContext): void {
33
+ const requested = process.env[NX_TASK_RECEIPT_ENV];
34
+ if (requested !== undefined && !isRequestId(requested)) {
35
+ logger.warn(
36
+ `${NX_TASK_RECEIPT_ENV} is not a controller-selected 32-hex request id; no task hint will be recorded.`,
37
+ );
38
+ }
39
+ }
40
+ async function writeHint(hint: ResultHint): Promise<WriteOutcome> {
41
+ const directory = join(cacheDir, '.cowshed-task-results', hint.requestId);
42
+ const invocation = createHash('sha256').update(hint.run.id).digest('hex');
43
+ const destination = join(directory, `${invocation}.json`);
44
+ const temporary = join(directory, `.${invocation}-${process.pid}.tmp`);
45
+ const json = JSON.stringify(hint);
46
+ if (Buffer.byteLength(json) > 1024 * 1024) {
47
+ return { ok: false, path: destination, reason: 'task-results hint exceeds the 1 MiB inspection envelope' };
48
+ }
49
+ try {
50
+ await mkdir(directory, { recursive: true, mode: 0o700 });
51
+ await writeFile(temporary, json, { mode: 0o600, flag: 'wx' });
52
+ await rename(temporary, destination);
53
+ return WRITTEN;
54
+ } catch (cause) {
55
+ // A leftover temporary makes the private inspector refuse the whole namespace; it can
56
+ // never be mistaken for a successful hint. The workspace's own retirement owns the bytes.
57
+ return { ok: false, path: destination, reason: String(cause) };
58
+ }
59
+ }
60
+ export async function postTasksExecution(_options: unknown, context: PostTasksExecutionContext): Promise<void> {
61
+ const id = requestId();
62
+ if (id === undefined) return;
63
+ const results = Object.values(context.taskResults);
64
+ // Hash-only API inspections pair the hooks too but ran no task; never overwrite real hints.
65
+ if (results.length === 0) return;
66
+ const hint: ResultHint = {
67
+ version: 1,
68
+ requestId: id,
69
+ workspaceRoot: context.workspaceRoot,
70
+ run: { id: context.id, argv: context.argv, startTime: context.startTime, endTime: context.endTime },
71
+ tasks: results.map(({ task, status, code }) => ({ task: { id: task.id, hash: task.hash }, status, code })),
72
+ };
73
+ const written = await writeHint(hint);
74
+ if (!written.ok) logger.warn(`Cannot record Nx task-results hint ${written.path}: ${written.reason}`);
75
+ }