@smoothbricks/nx-plugin 0.4.25 → 0.4.27

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 (348) hide show
  1. package/README.md +1078 -98
  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 +16 -85
  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 +16 -17
  21. package/dist/cargo-closure-input.d.ts.map +1 -1
  22. package/dist/cargo-closure-input.js +37 -44
  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 +50 -8
  27. package/dist/cargo-source-hash.d.ts.map +1 -1
  28. package/dist/cargo-source-hash.js +691 -71
  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 +108 -12
  33. package/dist/cargo-workspace.d.ts.map +1 -1
  34. package/dist/cargo-workspace.js +299 -18
  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 +213 -12
  48. package/dist/ensure-built.d.ts.map +1 -1
  49. package/dist/ensure-built.js +624 -177
  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 +435 -230
  102. package/dist/managed-assets.d.ts +6 -0
  103. package/dist/managed-assets.d.ts.map +1 -1
  104. package/dist/managed-files/ci-workflow.d.ts +13 -0
  105. package/dist/managed-files/ci-workflow.d.ts.map +1 -1
  106. package/dist/managed-files/ci-workflow.js +44 -13
  107. package/dist/managed-files/files.d.ts +7 -1
  108. package/dist/managed-files/files.d.ts.map +1 -1
  109. package/dist/managed-files/files.js +62 -8
  110. package/dist/managed-files/json-edit.d.ts +21 -0
  111. package/dist/managed-files/json-edit.d.ts.map +1 -0
  112. package/dist/managed-files/json-edit.js +295 -0
  113. package/dist/managed-files/managed-format.d.ts +33 -1
  114. package/dist/managed-files/managed-format.d.ts.map +1 -1
  115. package/dist/managed-files/managed-format.js +82 -2
  116. package/dist/managed-files/pr-preview-cleanup-workflow.d.ts +7 -0
  117. package/dist/managed-files/pr-preview-cleanup-workflow.d.ts.map +1 -1
  118. package/dist/managed-files/pr-preview-cleanup-workflow.js +68 -4
  119. package/dist/managed-files/publish-workflow.d.ts.map +1 -1
  120. package/dist/managed-files/publish-workflow.js +231 -48
  121. package/dist/managed-files/tree.d.ts +5 -0
  122. package/dist/managed-files/tree.d.ts.map +1 -1
  123. package/dist/managed-files/tree.js +5 -3
  124. package/dist/manifest-hash.js +3 -2
  125. package/dist/nextest-code-bound.d.ts +62 -0
  126. package/dist/nextest-code-bound.d.ts.map +1 -0
  127. package/dist/nextest-code-bound.js +154 -0
  128. package/dist/nextest-extraction.d.ts +24 -8
  129. package/dist/nextest-extraction.d.ts.map +1 -1
  130. package/dist/nextest-extraction.js +42 -7
  131. package/dist/package-target-policy.d.ts.map +1 -1
  132. package/dist/package-target-policy.js +3 -5
  133. package/dist/release-config-policy.d.ts.map +1 -1
  134. package/dist/release-config-policy.js +3 -5
  135. package/dist/runtime-input.d.ts +14 -0
  136. package/dist/runtime-input.d.ts.map +1 -0
  137. package/dist/runtime-input.js +15 -0
  138. package/dist/rust-tokens.d.ts +11 -0
  139. package/dist/rust-tokens.d.ts.map +1 -0
  140. package/dist/rust-tokens.js +81 -0
  141. package/dist/task-results.d.ts +6 -0
  142. package/dist/task-results.d.ts.map +1 -0
  143. package/dist/task-results.js +61 -0
  144. package/dist/test-program.d.ts +54 -0
  145. package/dist/test-program.d.ts.map +1 -0
  146. package/dist/test-program.js +292 -0
  147. package/dist/test-timings.d.ts +71 -0
  148. package/dist/test-timings.d.ts.map +1 -0
  149. package/dist/test-timings.js +393 -0
  150. package/dist/test-walk-policy.d.ts +103 -0
  151. package/dist/test-walk-policy.d.ts.map +1 -0
  152. package/dist/test-walk-policy.js +657 -0
  153. package/dist/testing.d.ts +177 -0
  154. package/dist/testing.d.ts.map +1 -0
  155. package/dist/testing.js +824 -0
  156. package/dist/type-guards.d.ts +3 -0
  157. package/dist/type-guards.d.ts.map +1 -0
  158. package/dist/type-guards.js +4 -0
  159. package/dist/typecheck-test-policy.d.ts +8 -5
  160. package/dist/typecheck-test-policy.d.ts.map +1 -1
  161. package/dist/typecheck-test-policy.js +113 -100
  162. package/dist/workspace-config-policy.d.ts +8 -0
  163. package/dist/workspace-config-policy.d.ts.map +1 -1
  164. package/dist/workspace-config-policy.js +175 -63
  165. package/dist/workspace-index.d.ts +12 -0
  166. package/dist/workspace-index.d.ts.map +1 -0
  167. package/dist/workspace-index.js +17 -0
  168. package/dist/workspace-manifest.d.ts +37 -1
  169. package/dist/workspace-manifest.d.ts.map +1 -1
  170. package/executors.json +5 -0
  171. package/loader.js +13 -11
  172. package/managed/raw/envrc +33 -62
  173. package/managed/raw/git-format-staged.yml +30 -35
  174. package/managed/raw/patches/nx@23.2.1.patch +3484 -0
  175. package/managed/raw/tooling/direnv/apple-developer.sh +83 -0
  176. package/managed/raw/tooling/direnv/developer-links.ts +607 -17
  177. package/managed/raw/tooling/direnv/devenv.smoo.nix +314 -92
  178. package/managed/raw/tooling/direnv/github-actions-bootstrap.sh +20 -11
  179. package/managed/raw/tooling/direnv/linked-snapshots.ts +845 -0
  180. package/managed/raw/tooling/direnv/nx-socket-dir.sh +82 -0
  181. package/managed/raw/tooling/direnv/repo-path +14 -2
  182. package/managed/raw/tooling/direnv/setup-environment.ts +1009 -118
  183. package/managed/raw/tooling/direnv/toolchain-stamp.ts +45 -3
  184. package/managed/raw/tooling/direnv/ttsc-env.sh +39 -0
  185. package/managed/raw/tooling/git-hooks/commit-msg.sh +5 -6
  186. package/managed/raw/tooling/git-hooks/pre-commit.sh +7 -6
  187. package/managed/raw/tooling/git-hooks/pre-push.sh +20 -15
  188. package/managed/templates/github/actions/cache-nix-devenv/action.yml +6 -6
  189. package/managed/templates/github/actions/cache-node-modules/action.yml +6 -4
  190. package/managed/templates/github/actions/cache-nx/action.yml +1 -1
  191. package/managed/templates/github/actions/cache-ttsc-plugins/action.yml +1 -1
  192. package/managed/templates/github/actions/forgejo-artifact.cjs +99 -0
  193. package/managed/templates/github/actions/forgejo-download-artifact/action.yml +49 -0
  194. package/managed/templates/github/actions/forgejo-download-artifact/index.cjs +7 -0
  195. package/managed/templates/github/actions/forgejo-upload-artifact/action.yml +65 -0
  196. package/managed/templates/github/actions/forgejo-upload-artifact/index.cjs +7 -0
  197. package/managed/templates/github/actions/setup-devenv/action.yml +21 -3
  198. package/managed/templates/github/workflows/managed-files.yml +1 -2
  199. package/nextest.toml +8 -75
  200. package/package.json +75 -13
  201. package/runtime-input.sh +81 -0
  202. package/src/__tests__/counted-cargo-process.ts +286 -0
  203. package/src/__tests__/counted-cargo.ts +730 -0
  204. package/src/__tests__/fixture-cargo-home.ts +36 -0
  205. package/src/__tests__/fixture-nx-env.ts +157 -2
  206. package/src/__tests__/progress-clock.ts +43 -0
  207. package/src/__tests__/runtime-input.ts +23 -0
  208. package/src/bin/smoo-nx-bound-failures.test.ts +127 -0
  209. package/src/bin/smoo-nx-bound-failures.ts +33 -0
  210. package/src/bin/smoo-nx-cargo-hash.ts +28 -3
  211. package/src/bin/smoo-nx-exec.ts +17 -86
  212. package/src/bin/smoo-nx-failures.ts +4 -0
  213. package/src/bin/smoo-nx-nextest-extract.ts +3 -2
  214. package/src/bin/smoo-nx-test-walks.ts +42 -0
  215. package/src/bounded-test-policy.test.ts +268 -22
  216. package/src/bounded-test-policy.ts +114 -42
  217. package/src/build-state-output-policy.test.ts +115 -0
  218. package/src/build-state-output-policy.ts +90 -0
  219. package/src/bun-bootstrap.test.ts +57 -3
  220. package/src/bun-file-packages.test.ts +47 -0
  221. package/src/cargo-closure-input.test.ts +432 -62
  222. package/src/cargo-closure-input.ts +51 -57
  223. package/src/cargo-dev-profile.ts +137 -0
  224. package/src/cargo-resolve-cache.test.ts +1044 -0
  225. package/src/cargo-source-hash.test.ts +203 -93
  226. package/src/cargo-source-hash.ts +762 -75
  227. package/src/cargo-toolchain-policy.ts +6 -0
  228. package/src/cargo-workspace.test.ts +320 -0
  229. package/src/cargo-workspace.ts +344 -18
  230. package/src/cross-check-policy.test.ts +59 -1
  231. package/src/cross-check-policy.ts +25 -6
  232. package/src/disk-command-policy.test.ts +61 -0
  233. package/src/disk-command-policy.ts +107 -0
  234. package/src/ensure-built-receipt.test.ts +184 -0
  235. package/src/ensure-built-receipt.ts +263 -0
  236. package/src/ensure-built-witness.test.ts +344 -0
  237. package/src/ensure-built-witness.ts +252 -0
  238. package/src/ensure-built.test.ts +1043 -483
  239. package/src/ensure-built.ts +870 -197
  240. package/src/eslint-file-set.ts +9 -0
  241. package/src/executors/bounded-exec/cpu-pool.test.ts +454 -0
  242. package/src/executors/bounded-exec/cpu-pool.ts +417 -0
  243. package/src/executors/bounded-exec/cpu-tokens.test.ts +269 -0
  244. package/src/executors/bounded-exec/cpu-tokens.ts +177 -0
  245. package/src/executors/bounded-exec/disk-lease.test.ts +185 -0
  246. package/src/executors/bounded-exec/disk-lease.ts +139 -0
  247. package/src/executors/bounded-exec/executor-host.test.ts +778 -0
  248. package/src/executors/bounded-exec/executor.test.ts +1116 -63
  249. package/src/executors/bounded-exec/executor.ts +565 -67
  250. package/src/executors/bounded-exec/gateway-lease.ts +176 -0
  251. package/src/executors/bounded-exec/hang-diagnostics.test.ts +285 -0
  252. package/src/executors/bounded-exec/hang-diagnostics.ts +283 -0
  253. package/src/executors/bounded-exec/progress.test.ts +79 -0
  254. package/src/executors/bounded-exec/progress.ts +118 -0
  255. package/src/executors/bounded-exec/ram-temp-fixtures.ts +12 -0
  256. package/src/executors/bounded-exec/ram-temp-held.test.ts +264 -0
  257. package/src/executors/bounded-exec/ram-temp-held.ts +242 -0
  258. package/src/executors/bounded-exec/ram-temp-host.test.ts +605 -0
  259. package/src/executors/bounded-exec/ram-temp.test.ts +674 -0
  260. package/src/executors/bounded-exec/ram-temp.ts +1918 -0
  261. package/src/executors/bounded-exec/schema.json +11 -5
  262. package/src/executors/bounded-exec/schema.ts +27 -11
  263. package/src/executors/bounded-exec/verdict.test.ts +440 -0
  264. package/src/executors/bounded-exec/verdict.ts +433 -0
  265. package/src/executors/shard-timings/executor.ts +36 -0
  266. package/src/executors/shard-timings/schema.json +21 -0
  267. package/src/executors/shard-timings/schema.ts +4 -0
  268. package/src/failure-summary.ts +119 -0
  269. package/src/generators/bounded-test-targets/generator.test.ts +4 -4
  270. package/src/generators/bun-test-tracing/generator.test.ts +2 -2
  271. package/src/generators/create-package/generator.test.ts +6 -0
  272. package/src/generators/create-package/generator.ts +6 -2
  273. package/src/host-controller-wiring.test.ts +31 -0
  274. package/src/index.test.ts +1070 -360
  275. package/src/index.ts +524 -255
  276. package/src/linked-snapshots.nx.test.ts +172 -0
  277. package/src/managed-assets.ts +12 -0
  278. package/src/managed-files/ci-workflow.ts +54 -13
  279. package/src/managed-files/files.ts +65 -9
  280. package/src/managed-files/forgejo-artifact.test.ts +395 -0
  281. package/src/managed-files/generator.test.ts +60 -1
  282. package/src/managed-files/json-edit.test.ts +216 -0
  283. package/src/managed-files/json-edit.ts +290 -0
  284. package/src/managed-files/managed-format-json.test.ts +308 -0
  285. package/src/managed-files/managed-format.ts +90 -2
  286. package/src/managed-files/pr-preview-cleanup-workflow.ts +69 -3
  287. package/src/managed-files/publish-workflow.ts +285 -67
  288. package/src/managed-files/repo-path.test.ts +129 -0
  289. package/src/managed-files/trace-db-artifact.test.ts +7 -0
  290. package/src/managed-files/tree.ts +11 -3
  291. package/src/manifest-hash.ts +3 -2
  292. package/src/nextest-code-bound.test.ts +155 -0
  293. package/src/nextest-code-bound.ts +195 -0
  294. package/src/nextest-extraction.test.ts +37 -5
  295. package/src/nextest-extraction.ts +51 -9
  296. package/src/nextest-partitions.test.ts +495 -0
  297. package/src/nx-cache-bound.test.ts +109 -0
  298. package/src/nx-cache-restore-mtime.test.ts +170 -0
  299. package/src/nx-daemon-claim.test.ts +277 -0
  300. package/src/nx-daemon-idle-cpu.test.ts +81 -0
  301. package/src/nx-daemon-idle-policy.test.ts +51 -0
  302. package/src/nx-daemon-ignore-files.test.ts +210 -0
  303. package/src/nx-daemon-root-normalization.test.ts +105 -0
  304. package/src/nx-daemon-validity.test.ts +925 -0
  305. package/src/nx-dot-input-policy.test.ts +353 -0
  306. package/src/nx-failure-life-cycles.test.ts +207 -0
  307. package/src/nx-files-archive-racy.test.ts +97 -0
  308. package/src/nx-foreign-workspace-env.test.ts +329 -0
  309. package/src/nx-incomplete-run-summary.test.ts +70 -0
  310. package/src/nx-plugin-load-errors.test.ts +120 -0
  311. package/src/nx-project-resolution-cache.test.ts +176 -0
  312. package/src/nx-raw-inputs.test.ts +166 -0
  313. package/src/nx-resident-graph-workers.test.ts +112 -0
  314. package/src/nx-run-information.test.ts +118 -0
  315. package/src/nx-skipped-task-exit.test.ts +180 -0
  316. package/src/nx-state-location.test.ts +63 -0
  317. package/src/nx-store-resolution.test.ts +99 -0
  318. package/src/nx-task-graph-cycles.test.ts +148 -0
  319. package/src/nx-task-output-lease.test.ts +414 -0
  320. package/src/nx-use-local.test.ts +103 -0
  321. package/src/package-target-policy.ts +3 -6
  322. package/src/release-config-policy.ts +3 -6
  323. package/src/runtime-input.test.ts +215 -0
  324. package/src/runtime-input.ts +17 -0
  325. package/src/rust-tokens.ts +78 -0
  326. package/src/serial-group-wiring.test.ts +326 -0
  327. package/src/task-history-namespace.test.ts +181 -0
  328. package/src/task-results.test.ts +226 -0
  329. package/src/task-results.ts +75 -0
  330. package/src/test-program.test.ts +303 -0
  331. package/src/test-program.ts +341 -0
  332. package/src/test-timings.test.ts +240 -0
  333. package/src/test-timings.ts +311 -0
  334. package/src/test-walk-policy.test.ts +585 -0
  335. package/src/test-walk-policy.ts +731 -0
  336. package/src/testing.test.ts +509 -0
  337. package/src/testing.ts +922 -0
  338. package/src/type-guards.ts +4 -0
  339. package/src/typecheck-test-policy.test.ts +496 -11
  340. package/src/typecheck-test-policy.ts +137 -103
  341. package/src/workspace-config-policy.test.ts +212 -13
  342. package/src/workspace-config-policy.ts +101 -73
  343. package/src/workspace-index.ts +18 -0
  344. package/src/workspace-manifest.ts +41 -1
  345. package/test-timings.json +85 -28
  346. package/managed/raw/tooling/direnv/inherited-devenv.ts +0 -615
  347. package/managed/raw/tooling/direnv/shared-caches.sh +0 -53
  348. package/src/__tests__/in-process-nx-index.ts +0 -9
@@ -0,0 +1,240 @@
1
+ import { afterEach, describe, expect, it, spyOn } from 'bun:test';
2
+ import { spawnSync } from 'node:child_process';
3
+ import { existsSync } from 'node:fs';
4
+ import { mkdir, mkdtemp, readFile, realpath, rm, symlink, writeFile } from 'node:fs/promises';
5
+ import { tmpdir } from 'node:os';
6
+ import { dirname, join } from 'node:path';
7
+ import typia from 'typia';
8
+
9
+ import shardTimingsExecutor from './executors/shard-timings/executor.js';
10
+ import {
11
+ refreshTestTimingsCommand,
12
+ type TimingManifest,
13
+ timingsCoverage,
14
+ timingsShardedSuite,
15
+ } from './test-timings.js';
16
+
17
+ const SHARD = (n: number) =>
18
+ `bun test --timeout=30000 --timings=test-timings.json --shard=${n}/2 --path-ignore-patterns='**/*-host.test.ts'`;
19
+ const SUITE_ARGS = ['--timeout=30000', '--timings=test-timings.json', '--path-ignore-patterns=**/*-host.test.ts'];
20
+
21
+ function shardTargets(command: (n: number) => string = SHARD): Record<string, unknown> {
22
+ return {
23
+ test: { executor: 'nx:noop', dependsOn: ['test-shard1', 'test-shard2'] },
24
+ 'test-shard1': {
25
+ executor: '@smoothbricks/nx-plugin:bounded-exec',
26
+ options: { command: command(1), cwd: '{projectRoot}' },
27
+ },
28
+ 'test-shard2': {
29
+ executor: '@smoothbricks/nx-plugin:bounded-exec',
30
+ options: { command: command(2), cwd: '{projectRoot}' },
31
+ },
32
+ };
33
+ }
34
+
35
+ describe('timingsShardedSuite', () => {
36
+ it('reads one suite from shard targets that differ only in --shard', () => {
37
+ expect(timingsShardedSuite('packages/example', shardTargets())).toEqual({
38
+ ok: true,
39
+ suite: { targets: ['test-shard1', 'test-shard2'], cwd: 'packages/example', args: SUITE_ARGS },
40
+ });
41
+ });
42
+
43
+ it('finds no suite where shards balance by count, without a manifest', () => {
44
+ expect(
45
+ timingsShardedSuite(
46
+ 'packages/example',
47
+ shardTargets((n) => `bun test --shard=${n}/2`),
48
+ ),
49
+ ).toEqual({
50
+ ok: true,
51
+ suite: null,
52
+ });
53
+ });
54
+
55
+ it('refuses shards whose files cannot be read off their command', () => {
56
+ const positional = timingsShardedSuite(
57
+ 'packages/example',
58
+ shardTargets((n) => `bun test --timings test-timings.json --shard=${n}/2`),
59
+ );
60
+ expect(positional).toEqual({
61
+ ok: false,
62
+ error: expect.stringContaining('passes `test-timings.json` positionally'),
63
+ });
64
+ const shell = timingsShardedSuite(
65
+ 'packages/example',
66
+ shardTargets((n) => `bun test --timings=t.json --shard=${n}/2 --path-ignore-patterns=**/*-host.test.ts`),
67
+ );
68
+ expect(shell).toEqual({ ok: false, error: expect.stringContaining('shell syntax beyond quoting') });
69
+ });
70
+
71
+ it('refuses shards of what are really two suites', () => {
72
+ const result = timingsShardedSuite(
73
+ 'packages/example',
74
+ shardTargets((n) => (n === 1 ? SHARD(1) : `bun test --timings=test-timings.json --shard=${n}/2`)),
75
+ );
76
+ expect(result).toEqual({ ok: false, error: expect.stringContaining('differ in more than --shard') });
77
+ });
78
+ });
79
+
80
+ describe('shard-timings check', () => {
81
+ let root: string | undefined;
82
+ afterEach(async () => {
83
+ if (root !== undefined) await rm(root, { recursive: true, force: true });
84
+ root = undefined;
85
+ });
86
+
87
+ async function fixture(timed: readonly string[]): Promise<string> {
88
+ root = await realpath(await mkdtemp(join(tmpdir(), 'smoothbricks-shard-timings-')));
89
+ const files = [
90
+ 'src/a.test.ts',
91
+ 'src/b_spec.mts',
92
+ 'src/nested/c.test.tsx',
93
+ // Never run by these shards: ignored, a dependency, hidden, or not a test name.
94
+ 'src/d-host.test.ts',
95
+ 'node_modules/dep/e.test.ts',
96
+ '.cache/f.test.ts',
97
+ 'src/g.tests.ts',
98
+ ];
99
+ for (const file of files) {
100
+ const path = join(root, 'packages/example', file);
101
+ await mkdir(dirname(path), { recursive: true });
102
+ await writeFile(path, '');
103
+ }
104
+ const manifest = { version: 1, files: Object.fromEntries(timed.map((file, index) => [file, 100 + index])) };
105
+ await writeFile(join(root, 'packages/example/test-timings.json'), `${JSON.stringify(manifest)}\n`);
106
+ return root;
107
+ }
108
+
109
+ async function check(workspaceRoot: string): Promise<{ success: boolean; stdout: string; stderr: string }> {
110
+ const stdout = spyOn(console, 'log').mockImplementation(() => {});
111
+ const stderr = spyOn(console, 'error').mockImplementation(() => {});
112
+ try {
113
+ const result = await shardTimingsExecutor(
114
+ { cwd: 'packages/example', args: SUITE_ARGS },
115
+ { root: workspaceRoot, projectName: '@scope/example' },
116
+ );
117
+ return { ...result, stdout: stdout.mock.calls.join('\n'), stderr: stderr.mock.calls.join('\n') };
118
+ } finally {
119
+ stdout.mockRestore();
120
+ stderr.mockRestore();
121
+ }
122
+ }
123
+
124
+ it('passes when the manifest names every file the shards run', async () => {
125
+ const workspaceRoot = await fixture([
126
+ 'src/a.test.ts',
127
+ 'src/b_spec.mts',
128
+ 'src/nested/c.test.tsx',
129
+ 'src/gone.test.ts',
130
+ ]);
131
+
132
+ const result = await check(workspaceRoot);
133
+
134
+ expect(result).toEqual({
135
+ success: true,
136
+ stdout: 'shard-timings: packages/example/test-timings.json names all 3 test files the shards run',
137
+ stderr: '',
138
+ });
139
+ });
140
+
141
+ it('fails naming each untimed file and the command that refreshes the manifest', async () => {
142
+ const workspaceRoot = await fixture(['src/a.test.ts']);
143
+
144
+ const result = await check(workspaceRoot);
145
+
146
+ expect(result.success).toBe(false);
147
+ expect(result.stderr).toBe(
148
+ [
149
+ 'packages/example/test-timings.json names no duration for 2 of the 3 test files the shards of @scope/example run.',
150
+ "Bun charges each the manifest's median and they cluster into one shard, which can push it past its deadline:",
151
+ ' packages/example/src/b_spec.mts',
152
+ ' packages/example/src/nested/c.test.tsx',
153
+ `Refresh the manifest with: ${refreshTestTimingsCommand('@scope/example')}`,
154
+ ].join('\n'),
155
+ );
156
+ expect(refreshTestTimingsCommand('@scope/example')).toBe('smoo nx refresh-test-timings @scope/example');
157
+ });
158
+
159
+ it("honours bunfig's root and ignore patterns where the command passes none", async () => {
160
+ const workspaceRoot = await fixture([]);
161
+ await writeFile(
162
+ join(workspaceRoot, 'packages/example/bunfig.toml'),
163
+ '[test]\nroot = "src"\npathIgnorePatterns = ["src/nested/**"]\n',
164
+ );
165
+
166
+ const coverage = await timingsCoverage(workspaceRoot, {
167
+ cwd: 'packages/example',
168
+ args: ['--timings=test-timings.json'],
169
+ });
170
+
171
+ expect(coverage).toEqual({
172
+ ok: true,
173
+ coverage: {
174
+ manifests: ['test-timings.json'],
175
+ files: ['src/a.test.ts', 'src/b_spec.mts', 'src/d-host.test.ts'],
176
+ untimed: ['src/a.test.ts', 'src/b_spec.mts', 'src/d-host.test.ts'],
177
+ },
178
+ });
179
+ });
180
+
181
+ it('finds the test files Bun itself runs', async () => {
182
+ const workspace = await realpath(await mkdtemp(join(tmpdir(), 'smoothbricks-bun-discovery-')));
183
+ root = workspace;
184
+ const project = join(workspace, 'packages/example');
185
+ const external = join(workspace, 'external');
186
+ const put = async (directory: string, file: string): Promise<void> => {
187
+ await mkdir(dirname(join(directory, file)), { recursive: true });
188
+ await writeFile(join(directory, file), "import { test } from 'bun:test';\n\ntest('runs', () => {});\n");
189
+ };
190
+ const names = ['.test', '_test', '.spec', '_spec'].flatMap((suffix) =>
191
+ ['js', 'jsx', 'ts', 'tsx', 'mjs', 'cjs', 'mts', 'cts'].map((ext) => `src/names/${ext}${suffix}.${ext}`),
192
+ );
193
+ for (const file of [
194
+ ...names,
195
+ // Bun matches every name in lower case.
196
+ 'src/names/Upper.TEST.TS',
197
+ 'src/names/Node_Modules/dep/upper.test.ts',
198
+ // Not test names.
199
+ 'src/names/test.ts',
200
+ 'src/names/helper.tests.ts',
201
+ 'src/nested/n.spec.jsx', // bunfig ignores it, and the CLI's patterns replace bunfig's
202
+ 'src/d-host.test.ts', // the CLI's pattern ignores it
203
+ 'src/ignored.test.ts', // .gitignore plays no part
204
+ 'src/.hidden.test.ts', // a hidden file runs, a hidden directory does not
205
+ 'src/.hidden/h.test.ts',
206
+ 'src/node_modules/dep/m.test.ts',
207
+ 'outside.test.ts', // outside bunfig's test.root
208
+ ]) {
209
+ await put(project, file);
210
+ }
211
+ await put(external, 'e.test.ts');
212
+ await writeFile(join(project, '.gitignore'), 'src/ignored.test.ts\n');
213
+ await writeFile(join(project, 'bunfig.toml'), '[test]\nroot = "src"\npathIgnorePatterns = ["src/nested/**"]\n');
214
+ await writeFile(join(project, 'other.toml'), '[test]\nroot = "src/names"\n');
215
+ // Bun follows a symlink wherever it leads, outside the project too, and takes one that leads nowhere for a file.
216
+ await symlink(external, join(project, 'src/linkdir'), 'dir');
217
+ await symlink('../outside.test.ts', join(project, 'src/linkfile.test.ts'));
218
+ await symlink('missing.test.ts', join(project, 'src/dangling.test.ts'));
219
+
220
+ const runs = [
221
+ { manifest: 'by-bunfig.json', args: [] },
222
+ { manifest: 'by-cli.json', args: ['--path-ignore-patterns=**/*-host.test.ts'] },
223
+ { manifest: 'by-config.json', args: ['--config=other.toml'] },
224
+ ];
225
+ for (const { manifest, args } of runs) {
226
+ const suiteArgs = [`--timings=${manifest}`, ...args];
227
+ // A run that matches no test exits 1 by design, yet writes every file it discovered to the manifest.
228
+ const bun = spawnSync(process.execPath, ['test', ...suiteArgs, '--update-timings', '-t', '^__none__$'], {
229
+ cwd: project,
230
+ encoding: 'utf8',
231
+ });
232
+ expect(existsSync(join(project, manifest)), bun.stdout + bun.stderr).toBe(true);
233
+ const written = typia.json.assertParse<TimingManifest>(await readFile(join(project, manifest), 'utf8'));
234
+
235
+ const walker = await timingsCoverage(workspace, { cwd: 'packages/example', args: suiteArgs });
236
+ if (!walker.ok) throw new Error(walker.error);
237
+ expect(walker.coverage.files).toEqual(Object.keys(written.files).sort());
238
+ }
239
+ });
240
+ });
@@ -0,0 +1,311 @@
1
+ import { readdir, readFile, stat } from 'node:fs/promises';
2
+ import { join, posix } from 'node:path';
3
+ import { parse as parseToml } from 'smol-toml';
4
+ import typia, { type IValidation } from 'typia';
5
+
6
+ import { shellWord } from './runtime-input.js';
7
+ import { isRecord } from './type-guards.js';
8
+
9
+ /**
10
+ * The check inferred beside a Bun suite that `--shard=N/M` targets split and a `--timings` manifest balances. Bun
11
+ * charges a file the manifest does not name at the manifest's median, and it cuts the path-sorted files into contiguous
12
+ * runs, so unnamed files cluster into one shard and push it past its deadline without a word. `lint` depends on this
13
+ * target, which fails naming every such file instead.
14
+ */
15
+ export const SHARD_TIMINGS_TARGET = 'shard-timings';
16
+ export const SHARD_TIMINGS_EXECUTOR = '@smoothbricks/nx-plugin:shard-timings';
17
+
18
+ /** The one command that rewrites a project's timing manifest: its suite, unsharded, under `--update-timings`. */
19
+ export function refreshTestTimingsCommand(projectName: string): string {
20
+ return `smoo nx refresh-test-timings ${shellWord(projectName)}`;
21
+ }
22
+
23
+ /** One `bun test` suite whose shard targets differ only in `--shard=N/M`. */
24
+ export interface TimingsShardedSuite {
25
+ /** The shard targets, by name, in declaration order. */
26
+ readonly targets: readonly string[];
27
+ /** Where every shard runs `bun test`, relative to the workspace root (`.` for the root itself). */
28
+ readonly cwd: string;
29
+ /** The `bun test` arguments every shard shares, which is all of them but `--shard`. */
30
+ readonly args: readonly string[];
31
+ }
32
+
33
+ export type TimingsShardedSuiteResult =
34
+ | { readonly ok: true; readonly suite: TimingsShardedSuite | null }
35
+ | { readonly ok: false; readonly error: string };
36
+
37
+ const SHARD_FLAG = /^--shard=\d+\/\d+$/;
38
+
39
+ /**
40
+ * The project's timings-sharded Bun suite, or `null` when no target runs `bun test` with both `--shard` and
41
+ * `--timings`. A target that does but is not a plain `bun test` command (shell syntax, a positional filter, a value
42
+ * flag spelled without `=`) is refused: the files it would run could only be guessed, and a guess is the silent
43
+ * imbalance this check exists to end. Every shard must share one working directory and one argument list apart from
44
+ * `--shard`, because "the files the shards run" is only defined for one suite.
45
+ */
46
+ export function timingsShardedSuite(
47
+ projectRoot: string,
48
+ targets: Readonly<Record<string, unknown>>,
49
+ ): TimingsShardedSuiteResult {
50
+ let suite: TimingsShardedSuite | null = null;
51
+ for (const [name, target] of Object.entries(targets)) {
52
+ const options = isRecord(target) ? target.options : undefined;
53
+ const command = isRecord(options) ? options.command : undefined;
54
+ if (typeof command !== 'string' || !command.includes('--shard') || !command.includes('--timings')) continue;
55
+ const parsed = shardArgs(command);
56
+ if (!parsed.ok) return { ok: false, error: `target ${name}: ${parsed.error}` };
57
+ const cwd = projectCwd(projectRoot, isRecord(options) ? options.cwd : undefined);
58
+ if (suite === null) {
59
+ suite = { targets: [name], cwd, args: parsed.args };
60
+ continue;
61
+ }
62
+ if (cwd !== suite.cwd || parsed.args.join('\0') !== suite.args.join('\0')) {
63
+ return {
64
+ ok: false,
65
+ error: `targets ${suite.targets.join(', ')} and ${name} shard one Bun timings suite but differ in more than --shard: \`bun test ${suite.args.join(' ')}\` in ${suite.cwd} against \`bun test ${parsed.args.join(' ')}\` in ${cwd}`,
66
+ };
67
+ }
68
+ suite = { ...suite, targets: [...suite.targets, name] };
69
+ }
70
+ return { ok: true, suite };
71
+ }
72
+
73
+ function shardArgs(command: string): { ok: true; args: string[] } | { ok: false; error: string } {
74
+ const words = shellWords(command);
75
+ if (words === null) {
76
+ return { ok: false, error: `\`${command}\` uses shell syntax beyond quoting; run \`bun test\` with plain flags` };
77
+ }
78
+ if (words[0] !== 'bun' || words[1] !== 'test') {
79
+ return { ok: false, error: `\`${command}\` must start with \`bun test\`` };
80
+ }
81
+ const args = words.slice(2);
82
+ const positional = args.find((word) => !word.startsWith('-'));
83
+ if (positional !== undefined) {
84
+ return {
85
+ ok: false,
86
+ error: `\`${command}\` passes \`${positional}\` positionally; give flag values as --flag=value and select files with --path-ignore-patterns`,
87
+ };
88
+ }
89
+ const shards = args.filter((word) => word.startsWith('--shard'));
90
+ if (shards.length !== 1 || !SHARD_FLAG.test(shards[0] ?? '')) {
91
+ return { ok: false, error: `\`${command}\` must pass exactly one --shard=N/M` };
92
+ }
93
+ return { ok: true, args: args.filter((word) => !word.startsWith('--shard')) };
94
+ }
95
+
96
+ /** Nx runs a target without `cwd` from the workspace root and interpolates the two root tokens. */
97
+ function projectCwd(projectRoot: string, cwd: unknown): string {
98
+ if (typeof cwd !== 'string' || cwd === '') return '.';
99
+ return posix.normalize(cwd.replaceAll('{projectRoot}', projectRoot).replaceAll('{workspaceRoot}', '.'));
100
+ }
101
+
102
+ /** Unquoted, each of these makes the shell expand, redirect, chain or comment instead of passing a word on. */
103
+ const SHELL_SYNTAX = '|&;<>()$`*?[#~';
104
+
105
+ /**
106
+ * The words a POSIX shell makes of a command that uses nothing but quoting, or `null` when it would expand, redirect
107
+ * or chain anything: then the arguments `bun test` receives are not knowable from the text.
108
+ */
109
+ function shellWords(command: string): string[] | null {
110
+ const words: string[] = [];
111
+ let word = '';
112
+ let inWord = false;
113
+ for (let index = 0; index < command.length; index++) {
114
+ const char = command.charAt(index);
115
+ if (char === "'") {
116
+ const end = command.indexOf("'", index + 1);
117
+ if (end < 0) return null;
118
+ word += command.slice(index + 1, end);
119
+ index = end;
120
+ inWord = true;
121
+ } else if (char === '"') {
122
+ index++;
123
+ while (index < command.length && command.charAt(index) !== '"') {
124
+ let quoted = command.charAt(index);
125
+ if (quoted === '$' || quoted === '`') return null;
126
+ if (quoted === '\\' && '"\\$`'.includes(command.charAt(index + 1))) {
127
+ index++;
128
+ quoted = command.charAt(index);
129
+ }
130
+ word += quoted;
131
+ index++;
132
+ }
133
+ if (index >= command.length) return null;
134
+ inWord = true;
135
+ } else if (char === '\\') {
136
+ if (index + 1 >= command.length) return null;
137
+ index++;
138
+ word += command.charAt(index);
139
+ inWord = true;
140
+ } else if (/\s/.test(char)) {
141
+ if (inWord) words.push(word);
142
+ word = '';
143
+ inWord = false;
144
+ } else if (SHELL_SYNTAX.includes(char)) {
145
+ return null;
146
+ } else {
147
+ word += char;
148
+ inWord = true;
149
+ }
150
+ }
151
+ if (inWord) words.push(word);
152
+ return words;
153
+ }
154
+
155
+ /** The suite's test files measured against its `--timings` manifests. Paths are relative to the suite's cwd, sorted. */
156
+ export interface TimingsCoverage {
157
+ /** Every `--timings` file, as the command names it. Bun merges them; the first is the one `--update-timings` writes. */
158
+ readonly manifests: readonly string[];
159
+ /** Every file the shards run between them. */
160
+ readonly files: readonly string[];
161
+ /** The files no manifest names, which Bun costs at the median. */
162
+ readonly untimed: readonly string[];
163
+ }
164
+
165
+ export type TimingsCoverageResult =
166
+ | { readonly ok: true; readonly coverage: TimingsCoverage }
167
+ | { readonly ok: false; readonly error: string };
168
+
169
+ /** What `bun test --update-timings` writes: milliseconds per cwd-relative test file. */
170
+ export interface TimingManifest {
171
+ version: number;
172
+ files: Record<string, number>;
173
+ }
174
+
175
+ /** The `[test]` keys of `bunfig.toml` that change which files `bun test` finds. */
176
+ interface BunfigDiscovery {
177
+ test?: {
178
+ root?: string;
179
+ pathIgnorePatterns?: string | string[];
180
+ };
181
+ }
182
+
183
+ const parseTimingManifest = typia.json.createValidateParse<TimingManifest>();
184
+ const validateBunfigDiscovery = typia.createValidate<BunfigDiscovery>();
185
+
186
+ /**
187
+ * Bun's test discovery for `args` in `cwd`, replayed without running a test: files named `*.test.*`, `*_test.*`,
188
+ * `*.spec.*` or `*_spec.*` with a JavaScript extension, in any letter case, under bunfig's `test.root`, outside
189
+ * `node_modules` and hidden directories. A symlink counts as its target, a directory entered and a file matched, and a
190
+ * link to nothing as a file; the link's own name is the one the name rules see. `--path-ignore-patterns` globs match
191
+ * the cwd-relative path as written and replace bunfig's `pathIgnorePatterns` when given; `--config=` names another
192
+ * bunfig; `.gitignore` plays no part. These are the rules of Bun 1.4: `test-timings.test.ts` compares them with the
193
+ * files `bun test --update-timings` writes for a fixture, so a Bun release that changes them fails there.
194
+ */
195
+ export async function timingsCoverage(
196
+ workspaceRoot: string,
197
+ suite: Pick<TimingsShardedSuite, 'cwd' | 'args'>,
198
+ ): Promise<TimingsCoverageResult> {
199
+ const cwd = join(workspaceRoot, suite.cwd);
200
+ const manifests = flagValues(suite.args, '--timings');
201
+ if (manifests.length === 0) {
202
+ return { ok: false, error: `\`bun test ${suite.args.join(' ')}\` names no --timings file` };
203
+ }
204
+ const bunfigPath = flagValues(suite.args, '--config').at(-1) ?? 'bunfig.toml';
205
+ const bunfig = await readBunfigDiscovery(join(cwd, bunfigPath));
206
+ if (!bunfig.ok) return bunfig;
207
+ const cliIgnores = flagValues(suite.args, '--path-ignore-patterns');
208
+ const bunfigIgnores = bunfig.test?.pathIgnorePatterns ?? [];
209
+ const ignores =
210
+ cliIgnores.length > 0 ? cliIgnores : typeof bunfigIgnores === 'string' ? [bunfigIgnores] : bunfigIgnores;
211
+ const root = posix.normalize(bunfig.test?.root ?? '.');
212
+ const files: string[] = [];
213
+ await collectTestFiles(cwd, root === '.' ? '' : root.replace(/\/$/, ''), ignores, files);
214
+ files.sort();
215
+ const timed = new Set<string>();
216
+ for (const manifest of manifests) {
217
+ const read = await readTimingManifest(join(cwd, manifest));
218
+ if (!read.ok) return { ok: false, error: `${join(suite.cwd, manifest)}: ${read.error}` };
219
+ for (const file of Object.keys(read.files)) timed.add(file);
220
+ }
221
+ return { ok: true, coverage: { manifests, files, untimed: files.filter((file) => !timed.has(file)) } };
222
+ }
223
+
224
+ /**
225
+ * The failure an untimed file earns: every such file, and the one command that refreshes the manifest. `cwd` is the
226
+ * suite's workspace-relative directory, so the operator can find the files from the repository root.
227
+ */
228
+ export function untimedTestFilesReport(projectName: string, cwd: string, coverage: TimingsCoverage): string {
229
+ const manifest = posix.join(cwd, coverage.manifests[0] ?? '');
230
+ return [
231
+ `${manifest} names no duration for ${coverage.untimed.length} of the ${coverage.files.length} test files the shards of ${projectName} run.`,
232
+ `Bun charges each the manifest's median and they cluster into one shard, which can push it past its deadline:`,
233
+ ...coverage.untimed.map((file) => ` ${posix.join(cwd, file)}`),
234
+ `Refresh the manifest with: ${refreshTestTimingsCommand(projectName)}`,
235
+ ].join('\n');
236
+ }
237
+
238
+ const TEST_FILE = /[._](?:test|spec)\.(?:js|jsx|ts|tsx|mjs|cjs|mts|cts)$/;
239
+
240
+ async function collectTestFiles(cwd: string, dir: string, ignores: readonly string[], files: string[]): Promise<void> {
241
+ for (const entry of await readdir(join(cwd, dir), { withFileTypes: true })) {
242
+ const path = dir === '' ? entry.name : `${dir}/${entry.name}`;
243
+ // Bun matches every name in lower case, and its ignore globs see the path as written.
244
+ const name = entry.name.toLowerCase();
245
+ // Bun follows a symlink to what it points at and takes one that points at nothing for a file.
246
+ const resolved = entry.isSymbolicLink() ? await stat(join(cwd, path)).catch(() => null) : entry;
247
+ if (resolved?.isDirectory()) {
248
+ if (!name.startsWith('.') && name !== 'node_modules') {
249
+ await collectTestFiles(cwd, path, ignores, files);
250
+ }
251
+ } else if (
252
+ (resolved === null || resolved.isFile()) &&
253
+ TEST_FILE.test(name) &&
254
+ !ignores.some((glob) => posix.matchesGlob(path, glob))
255
+ ) {
256
+ files.push(path);
257
+ }
258
+ }
259
+ }
260
+
261
+ function flagValues(args: readonly string[], flag: string): string[] {
262
+ const prefix = `${flag}=`;
263
+ return args.filter((arg) => arg.startsWith(prefix)).map((arg) => arg.slice(prefix.length));
264
+ }
265
+
266
+ async function readBunfigDiscovery(
267
+ path: string,
268
+ ): Promise<({ ok: true } & BunfigDiscovery) | { ok: false; error: string }> {
269
+ const text = await readOptionalFile(path);
270
+ if (text === null) return { ok: true };
271
+ let parsed: unknown;
272
+ try {
273
+ parsed = parseToml(text);
274
+ } catch (error) {
275
+ return { ok: false, error: `${path} is not valid TOML: ${error instanceof Error ? error.message : String(error)}` };
276
+ }
277
+ const validated = validateBunfigDiscovery(parsed);
278
+ if (!validated.success) return { ok: false, error: `${path}: ${validationErrors(validated.errors)}` };
279
+ return { ok: true, ...validated.data };
280
+ }
281
+
282
+ async function readTimingManifest(
283
+ path: string,
284
+ ): Promise<{ ok: true; files: Record<string, number> } | { ok: false; error: string }> {
285
+ const text = await readOptionalFile(path);
286
+ // Bun runs without the file and times nothing, so every test file is untimed.
287
+ if (text === null) return { ok: true, files: {} };
288
+ let validated: IValidation<TimingManifest>;
289
+ try {
290
+ validated = parseTimingManifest(text);
291
+ } catch (error) {
292
+ return { ok: false, error: `not valid JSON: ${error instanceof Error ? error.message : String(error)}` };
293
+ }
294
+ if (!validated.success) {
295
+ return { ok: false, error: `not a Bun timing manifest: ${validationErrors(validated.errors)}` };
296
+ }
297
+ return { ok: true, files: validated.data.files };
298
+ }
299
+
300
+ async function readOptionalFile(path: string): Promise<string | null> {
301
+ try {
302
+ return await readFile(path, 'utf-8');
303
+ } catch (error) {
304
+ if (error instanceof Error && 'code' in error && error.code === 'ENOENT') return null;
305
+ throw error;
306
+ }
307
+ }
308
+
309
+ function validationErrors(errors: readonly IValidation.IError[]): string {
310
+ return errors.map((error) => `${error.path.replace(/^\$input\.?/, '')}: expected ${error.expected}`).join(', ');
311
+ }