@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,283 @@
1
+ import { spawn } from 'node:child_process';
2
+ import { type ProcessEntry, withDescendants } from '../../testing.js';
3
+
4
+ export const HANG_CAPTURE_MS = 5_000;
5
+ const MAX_PROBE_BYTES = 4 * 1024 * 1024;
6
+ const PS_FIELDS = 'pid=,ppid=,pgid=,stat=,%cpu=,etime=,lstart=,command=';
7
+
8
+ export interface HangDiagnostics {
9
+ startedAtMs: number;
10
+ capturedAtMs: number;
11
+ /** Positive when the observation completed before the idle expiry. */
12
+ offsetFromExpiryMs: number;
13
+ outcome: 'holders' | 'none' | 'incomplete';
14
+ text: string;
15
+ }
16
+
17
+ export interface HangCaptureRequest {
18
+ pid: number;
19
+ pgid: number | null;
20
+ expiresAtMs: number;
21
+ deadlineMs: number;
22
+ signal?: AbortSignal;
23
+ }
24
+
25
+ export type HangProbeResult =
26
+ | { status: 'exited'; code: number; stdout: string; stderr: string }
27
+ | { status: 'unavailable' | 'timed-out' | 'failed'; detail: string; stdout: string; stderr: string };
28
+
29
+ /** The process boundary, injectable so unavailable and non-answering probes have exact witnesses. */
30
+ export interface HangDiagnosticHost {
31
+ platform: NodeJS.Platform;
32
+ probe(file: string, args: readonly string[], timeoutMs: number, signal: AbortSignal): Promise<HangProbeResult>;
33
+ }
34
+
35
+ interface ObservedProcess extends ProcessEntry {
36
+ pgid: number;
37
+ started: string;
38
+ raw: string;
39
+ }
40
+
41
+ const host: HangDiagnosticHost = { platform: process.platform, probe: runProbe };
42
+
43
+ /** A pre-expiry observation, never an assertion that an open file is a contested lock. */
44
+ export function captureHangDiagnostics(
45
+ request: HangCaptureRequest,
46
+ source: HangDiagnosticHost = host,
47
+ ): Promise<HangDiagnostics> {
48
+ const startedAtMs = Date.now();
49
+ const budgetMs = Math.max(0, Math.min(HANG_CAPTURE_MS, request.deadlineMs, request.expiresAtMs - startedAtMs));
50
+ const endsAtMs = startedAtMs + budgetMs;
51
+ const controller = new AbortController();
52
+ const lines = [
53
+ `Hang snapshot: pid=${request.pid} pgid=${request.pgid ?? 'unknown'} startedAtMs=${startedAtMs}`,
54
+ 'Open files and process observations are evidence, not proof of a contested lock or its owner.',
55
+ ];
56
+ let active = 'process census';
57
+ let finished = false;
58
+ // This package targets lib es2022, which does not declare Promise.withResolvers.
59
+ return new Promise((resolve) => {
60
+ const finish = (outcome: HangDiagnostics['outcome']): void => {
61
+ if (finished) return;
62
+ finished = true;
63
+ clearTimeout(timer);
64
+ request.signal?.removeEventListener('abort', cancelled);
65
+ controller.abort();
66
+ const capturedAtMs = Date.now();
67
+ const offsetFromExpiryMs = request.expiresAtMs - capturedAtMs;
68
+ resolve({
69
+ startedAtMs,
70
+ capturedAtMs,
71
+ offsetFromExpiryMs,
72
+ outcome,
73
+ text: `${lines.join('\n')}\nHang snapshot outcome=${outcome} capturedAtMs=${capturedAtMs} offsetFromExpiryMs=${offsetFromExpiryMs}\n`,
74
+ });
75
+ };
76
+ const timer = setTimeout(() => {
77
+ lines.push(`Capture incomplete: ${budgetMs}ms deadline reached during ${active}; no empty-holder conclusion.`);
78
+ finish('incomplete');
79
+ }, budgetMs);
80
+ const cancelled = (): void => {
81
+ if (finished) return;
82
+ lines.push(`Capture cancelled during ${active}; its progress generation is no longer current.`);
83
+ finish('incomplete');
84
+ };
85
+ request.signal?.addEventListener('abort', cancelled, { once: true });
86
+ if (request.signal?.aborted) {
87
+ cancelled();
88
+ return;
89
+ }
90
+ if (budgetMs === 0) {
91
+ lines.push('Capture incomplete: the pre-expiry window already ended or has no budget; no probe started.');
92
+ finish('incomplete');
93
+ return;
94
+ }
95
+ const probe = async (name: string, file: string, args: readonly string[], limitMs: number) => {
96
+ active = name;
97
+ lines.push(`${name}: ${file} ${args.join(' ')}`);
98
+ const result = await source.probe(
99
+ file,
100
+ args,
101
+ Math.max(0, Math.min(limitMs, endsAtMs - Date.now())),
102
+ controller.signal,
103
+ );
104
+ if (!finished) {
105
+ lines.push(
106
+ `${name}: ${result.status}${result.status === 'exited' ? ` code=${result.code}` : ` ${result.detail}`}`,
107
+ );
108
+ if (result.stderr.trim() !== '') lines.push(`${name} stderr:\n${result.stderr.trimEnd()}`);
109
+ }
110
+ return result;
111
+ };
112
+ const census = async (name: string): Promise<ObservedProcess[] | null> => {
113
+ // Bare `ps`, resolved through PATH like testing.ts's processTable: NixOS has no /bin/ps.
114
+ const result = await probe(name, 'ps', ['-A', '-o', PS_FIELDS], 1_000);
115
+ if (finished) return null;
116
+ if (result.status !== 'exited' || result.code !== 0) {
117
+ lines.push(`${name}: could not inspect the process table; not an empty process tree.`);
118
+ return null;
119
+ }
120
+ const parsed: ObservedProcess[] = [];
121
+ for (const row of result.stdout.split('\n').filter((line) => line.trim() !== '')) {
122
+ const match =
123
+ /^\s*(\d+)\s+(\d+)\s+(\d+)\s+(\S+)\s+(\S+)\s+(\S+)\s+(\S+\s+\S+\s+\d+\s+\d\d:\d\d:\d\d\s+\d{4})\s+(.*)$/.exec(
124
+ row,
125
+ );
126
+ if (match === null) {
127
+ lines.push(`${name}: could not decode ps row: ${row}`);
128
+ return null;
129
+ }
130
+ const [, pid, ppid, pgid, stat, , , started, command] = match;
131
+ if (
132
+ pid === undefined ||
133
+ ppid === undefined ||
134
+ pgid === undefined ||
135
+ stat === undefined ||
136
+ started === undefined ||
137
+ command === undefined
138
+ ) {
139
+ lines.push(`${name}: incomplete ps row: ${row}`);
140
+ return null;
141
+ }
142
+ parsed.push({ pid: Number(pid), ppid: Number(ppid), pgid: Number(pgid), stat, started, command, raw: row });
143
+ }
144
+ const roots = [request.pid, ...parsed.filter((entry) => entry.pgid === request.pgid).map((entry) => entry.pid)];
145
+ const selected = new Set(withDescendants(parsed, roots).map((entry) => entry.pid));
146
+ const tree = parsed.filter((entry) => selected.has(entry.pid));
147
+ lines.push(`${name}: PID PPID PGID STAT %CPU ELAPSED STARTED COMMAND`);
148
+ lines.push(...tree.map((entry) => entry.raw));
149
+ if (!tree.some((entry) => entry.pid === request.pid)) {
150
+ lines.push(`${name}: root pid ${request.pid} exited or is not visible; capture raced or is incomplete.`);
151
+ return null;
152
+ }
153
+ return tree;
154
+ };
155
+ const collect = async (): Promise<void> => {
156
+ const before = await census('ps before');
157
+ if (finished) return;
158
+ if (before === null) return finish('incomplete');
159
+ let incomplete = false;
160
+ let observed = before.length > 0;
161
+ if (source.platform === 'darwin') {
162
+ const args = ['-nP', '-p', before.map((entry) => entry.pid).join(',')];
163
+ // Bare `sudo`/`lsof` through PATH, like `ps` above: NixOS provides neither /usr/bin/sudo nor /usr/sbin/lsof.
164
+ let resources = await probe('lsof privileged', 'sudo', ['-n', 'lsof', ...args], 1_500);
165
+ if (finished) return;
166
+ const answered = (result: HangProbeResult): boolean =>
167
+ result.status === 'exited' && (result.code === 0 || (result.code === 1 && result.stderr.trim() === ''));
168
+ if (!answered(resources)) {
169
+ incomplete = true;
170
+ if (resources.stdout.trim() !== '')
171
+ lines.push(`Partial privileged lsof output:\n${resources.stdout.trimEnd()}`);
172
+ lines.push(
173
+ 'Privileged resource census unavailable; fallback is ordinary-user visibility only, not proof of no holders.',
174
+ );
175
+ resources = await probe('lsof user-scoped fallback', 'lsof', args, 1_000);
176
+ if (finished) return;
177
+ }
178
+ if (resources.stdout.trim() !== '')
179
+ lines.push(`lsof open files/sockets (not contested-lock proof):\n${resources.stdout.trimEnd()}`);
180
+ if (!answered(resources) || resources.stderr.trim() !== '') incomplete = true;
181
+ observed = resources.stdout.trim() !== '';
182
+ if (!observed && answered(resources))
183
+ lines.push('lsof reported no open-file matches within its stated visibility.');
184
+ } else {
185
+ lines.push(`Open-file census not provided on ${source.platform}; observations below name processes only.`);
186
+ }
187
+ const after = await census('ps after');
188
+ if (finished) return;
189
+ if (after === null) return finish('incomplete');
190
+ if (
191
+ before.length !== after.length ||
192
+ before.some(
193
+ (entry) =>
194
+ !after.some(
195
+ (other) =>
196
+ other.pid === entry.pid &&
197
+ other.ppid === entry.ppid &&
198
+ other.pgid === entry.pgid &&
199
+ other.started === entry.started &&
200
+ other.command === entry.command &&
201
+ other.stat.startsWith('Z') === entry.stat.startsWith('Z'),
202
+ ),
203
+ )
204
+ ) {
205
+ incomplete = true;
206
+ lines.push('Process identities or membership changed during capture; open-file census raced.');
207
+ }
208
+ finish(incomplete ? 'incomplete' : observed ? 'holders' : 'none');
209
+ };
210
+ void collect().catch((error: unknown) => {
211
+ if (finished) return;
212
+ lines.push(`Capture incomplete during ${active}: ${error instanceof Error ? error.message : String(error)}`);
213
+ finish('incomplete');
214
+ });
215
+ });
216
+ }
217
+
218
+ /** A probe owns its group and output pipes; its deadline never waits for an unresponsive child to reap. */
219
+ function runProbe(
220
+ file: string,
221
+ args: readonly string[],
222
+ timeoutMs: number,
223
+ signal: AbortSignal,
224
+ ): Promise<HangProbeResult> {
225
+ // Keep the package's es2022-compatible event-completion convention.
226
+ return new Promise((resolve) => {
227
+ if (signal.aborted) {
228
+ resolve({ status: 'timed-out', detail: 'capture deadline already reached', stdout: '', stderr: '' });
229
+ return;
230
+ }
231
+ const child = spawn(file, [...args], { detached: true, stdio: ['ignore', 'pipe', 'pipe'] });
232
+ let stdout = '';
233
+ let stderr = '';
234
+ let bytes = 0;
235
+ let settled = false;
236
+ const finish = (result: HangProbeResult): void => {
237
+ if (settled) return;
238
+ settled = true;
239
+ clearTimeout(timer);
240
+ signal.removeEventListener('abort', aborted);
241
+ child.stdout.destroy();
242
+ child.stderr.destroy();
243
+ child.unref();
244
+ resolve(result);
245
+ };
246
+ const stop = (detail: string, status: 'timed-out' | 'failed' = 'timed-out'): void => {
247
+ if (settled) return;
248
+ let killFailure = '';
249
+ if (child.pid !== undefined) {
250
+ try {
251
+ process.kill(-child.pid, 'SIGKILL');
252
+ } catch (error) {
253
+ killFailure = `; probe group cleanup: ${error instanceof Error ? error.message : String(error)}`;
254
+ }
255
+ }
256
+ finish({ status, detail: detail + killFailure, stdout, stderr });
257
+ };
258
+ const aborted = (): void => stop('capture deadline reached');
259
+ const timer = setTimeout(() => stop(`probe exceeded ${timeoutMs}ms`), timeoutMs);
260
+ signal.addEventListener('abort', aborted, { once: true });
261
+ const append = (stream: 'stdout' | 'stderr', chunk: string): void => {
262
+ bytes += Buffer.byteLength(chunk);
263
+ if (bytes > MAX_PROBE_BYTES) {
264
+ stop(`probe output exceeded ${MAX_PROBE_BYTES} bytes; output is incomplete`, 'failed');
265
+ return;
266
+ }
267
+ if (stream === 'stdout') stdout += chunk;
268
+ else stderr += chunk;
269
+ };
270
+ child.stdout.setEncoding('utf8').on('data', (chunk: string) => append('stdout', chunk));
271
+ child.stderr.setEncoding('utf8').on('data', (chunk: string) => append('stderr', chunk));
272
+ child.once('error', (error) => {
273
+ finish({ status: 'unavailable', detail: error.message, stdout, stderr });
274
+ });
275
+ child.once('close', (code, killedBy) => {
276
+ finish(
277
+ code === null
278
+ ? { status: 'failed', detail: `probe ended by ${killedBy ?? 'unknown signal'}`, stdout, stderr }
279
+ : { status: 'exited', code, stdout, stderr },
280
+ );
281
+ });
282
+ });
283
+ }
@@ -0,0 +1,79 @@
1
+ import { describe, expect, it } from 'bun:test';
2
+
3
+ import { createRunProgress, withProgressReport } from './progress.js';
4
+
5
+ describe('run progress', () => {
6
+ it('counts a nextest status line with its run counter as a finished test, and a SLOW line as none', () => {
7
+ const progress = createRunProgress();
8
+ expect(progress.scan('stderr', ' SLOW [> 1.000s] (───) nt tests::hangs\n')).toBe(false);
9
+ expect(progress.scan('stderr', ' SLOW [> 1.000s] (───) nt tests::slow3\n')).toBe(false);
10
+ expect(progress.inFlight()).toEqual(['nt tests::hangs', 'nt tests::slow3']);
11
+ expect(progress.scan('stderr', ' PASS [ 2.512s] (2/4) nt tests::slow3\n')).toBe(true);
12
+ expect(progress.inFlight()).toEqual(['nt tests::hangs']);
13
+ for (const finished of [
14
+ ' FAIL [ 0.443s] (3/4) nt tests::fails',
15
+ ' SIGSEGV [ 0.010s] ( 4/12) nt tests::crash',
16
+ ' TRY 2 FAIL [ 0.010s] (5/12) nt tests::flaky',
17
+ ' LEAK-FAIL [ 0.010s] (6/12) nt tests::leaky',
18
+ ]) {
19
+ expect(createRunProgress().scan('stderr', `${finished}\n`)).toBe(true);
20
+ }
21
+ });
22
+
23
+ it('counts libtest result lines and names a test libtest says is still running', () => {
24
+ const progress = createRunProgress();
25
+ expect(progress.scan('stdout', 'running 3 tests\n')).toBe(false);
26
+ expect(progress.scan('stdout', 'test tests::slow has been running for over 60 seconds\n')).toBe(false);
27
+ expect(progress.inFlight()).toEqual(['tests::slow']);
28
+ expect(progress.scan('stdout', 'test tests::quick ... ok\n')).toBe(true);
29
+ expect(progress.scan('stdout', 'test tests::slow ... FAILED\n')).toBe(true);
30
+ expect(progress.inFlight()).toEqual([]);
31
+ });
32
+
33
+ it("counts bun's result lines and each new dot, however the chunks split them", () => {
34
+ const progress = createRunProgress();
35
+ expect(progress.scan('stderr', '(pass) suite > one [0.02ms]\n')).toBe(true);
36
+ expect(progress.scan('stderr', '.')).toBe(true);
37
+ expect(progress.scan('stderr', '.')).toBe(true);
38
+ // The newline that ends the dots line reports nothing new.
39
+ expect(progress.scan('stderr', '\n')).toBe(false);
40
+ expect(progress.scan('stderr', '..\n.')).toBe(true);
41
+ expect(progress.scan('stderr', '\n\n4 pass\n0 fail\n')).toBe(false);
42
+ });
43
+
44
+ it('keeps each stream its own partial line', () => {
45
+ const progress = createRunProgress();
46
+ expect(progress.scan('stderr', ' PASS [ 0.001s] (1/2) nt ')).toBe(false);
47
+ expect(progress.scan('stdout', 'unrelated\n')).toBe(false);
48
+ expect(progress.scan('stderr', 'tests::split\n')).toBe(true);
49
+ });
50
+
51
+ it('finds no progress in a heartbeat, a warning, or ANSI-coloured noise', () => {
52
+ const progress = createRunProgress();
53
+ expect(progress.scan('stdout', 'still waiting...\n')).toBe(false);
54
+ expect(progress.scan('stderr', 'warning: slow host\n')).toBe(false);
55
+ expect(progress.scan('stderr', '\u001b[33m SLOW\u001b[0m [> 30.000s] (───) nt tests::hangs\n')).toBe(false);
56
+ expect(progress.inFlight()).toEqual(['nt tests::hangs']);
57
+ expect(progress.scan('stderr', '\u001b[32m PASS\u001b[0m [ 31.000s] (1/1) nt tests::hangs\n')).toBe(true);
58
+ expect(progress.inFlight()).toEqual([]);
59
+ });
60
+ });
61
+
62
+ describe('progress report', () => {
63
+ it('asks a lone bun test for dots, keeping the runtime the target named', () => {
64
+ expect(withProgressReport('bun test --timeout=30000 src')).toBe('bun test --dots --timeout=30000 src');
65
+ expect(withProgressReport('../x/.runtime/bun test a')).toBe('../x/.runtime/bun test --dots a');
66
+ });
67
+
68
+ it('leaves a command with no bun, two runners, or dots already chosen unchanged', () => {
69
+ for (const command of [
70
+ 'cargo nextest run -E all()',
71
+ 'bun test a && bun test b',
72
+ 'bun test --dots src',
73
+ 'bun test --reporter=dots src',
74
+ 'node script.js',
75
+ ]) {
76
+ expect(withProgressReport(command)).toBe(command);
77
+ }
78
+ });
79
+ });
@@ -0,0 +1,118 @@
1
+ import { BUN_TEST, NEXTEST_RUN } from './verdict.js';
2
+
3
+ /**
4
+ * What a run's output says about its forward motion: whether a test finished, and which tests the runner said
5
+ * are running and has not said finished. `idleTimeoutMs` re-arms only on a finished test.
6
+ *
7
+ * Output alone is not progress. nextest repeats a `SLOW` line for every test still running at each slow-timeout
8
+ * period, and a hung test may print a heartbeat, so a bound on silence never fires on either. A finished test is
9
+ * what each runner reports once per test:
10
+ *
11
+ * - nextest: a status line carrying the run's counter, `PASS [ 0.438s] (1/4) nt tests::quick` (also `FAIL`,
12
+ * `LEAK`, a signal name, `TRY 2 FAIL`, ...). A test still running is named by a `SLOW [> 30.000s] (───) …` or
13
+ * `START` line, which carries no counter; the name is nextest's `<binary-id> <test>`, as its JUnit report
14
+ * spells `classname name`.
15
+ * - libtest (`cargo test`): `test tests::quick ... ok` (or `FAILED`, `ignored`); a test still running is named by
16
+ * `test tests::slow has been running for over 60 seconds`.
17
+ * - bun: a line of dots, one per test finished (`--dots`, which `withProgressReport` asks for: bun prints nothing
18
+ * per passing test when it believes an agent runs it), or a `(pass)`/`(fail)`/`(skip)`/`(todo)` line. bun names
19
+ * no test before it finishes, so a bun run names nothing in flight.
20
+ *
21
+ * A command that reports no tests makes progress only by exiting.
22
+ */
23
+ export interface RunProgress {
24
+ /** One chunk of one of the command's output streams; true when it reports at least one finished test. */
25
+ scan(stream: OutputStream, chunk: string): boolean;
26
+ /** The tests the runner reported running and has not reported finished, in the order it first named them. */
27
+ inFlight(): string[];
28
+ }
29
+
30
+ export type OutputStream = 'stdout' | 'stderr';
31
+
32
+ const ANSI = new RegExp(`${String.fromCharCode(27)}\\[[0-9;]*[A-Za-z]`, 'g');
33
+ /** Lines naming a test that finished; group 1 is its name. */
34
+ const FINISHED = [
35
+ /^\s*(?:[A-Z0-9][A-Z0-9-]*\s+)+\[\s*[0-9.]+s\]\s+\(\s*\d+\/\d+\)\s+(\S.*)$/,
36
+ /^test (\S+) \.\.\. (?:ok|FAILED|ignored)\b/,
37
+ /^\((?:pass|fail|skip|todo)\) (.+)$/,
38
+ ];
39
+ /** Lines naming a test still running; group 1 is its name. */
40
+ const RUNNING = [
41
+ /^\s*(?:SLOW|START)\s+\[[^\]]*\]\s+(?:\([^)]*\)\s+)?(\S.*)$/,
42
+ /^test (\S+) has been running for over \d+ seconds$/,
43
+ ];
44
+ const DOTS = /^\.+$/;
45
+
46
+ /** A stream's unfinished last line, and how many of its dots were already counted. */
47
+ interface LineState {
48
+ partial: string;
49
+ countedDots: number;
50
+ }
51
+
52
+ export function createRunProgress(): RunProgress {
53
+ const streams: Record<OutputStream, LineState> = {
54
+ stdout: { partial: '', countedDots: 0 },
55
+ stderr: { partial: '', countedDots: 0 },
56
+ };
57
+ const running = new Set<string>();
58
+
59
+ // One complete line, ANSI stripped, that is not a line of dots: true when it names a finished test.
60
+ const finishedLine = (text: string): boolean => {
61
+ for (const pattern of FINISHED) {
62
+ const name = pattern.exec(text)?.[1];
63
+ if (name !== undefined) {
64
+ running.delete(name);
65
+ return true;
66
+ }
67
+ }
68
+ for (const pattern of RUNNING) {
69
+ const name = pattern.exec(text)?.[1];
70
+ if (name !== undefined) {
71
+ running.add(name);
72
+ return false;
73
+ }
74
+ }
75
+ return false;
76
+ };
77
+
78
+ return {
79
+ scan(stream, chunk) {
80
+ const state = streams[stream];
81
+ const lines = (state.partial + chunk).split('\n');
82
+ const rest = lines.pop() ?? '';
83
+ let progressed = false;
84
+ // The first complete line continues the partial one, whose dots were counted as they came.
85
+ let counted = state.countedDots;
86
+ for (const raw of lines) {
87
+ const text = raw.replace(ANSI, '').trimEnd();
88
+ if (DOTS.test(text)) {
89
+ progressed ||= text.length > counted;
90
+ } else if (finishedLine(text)) {
91
+ progressed = true;
92
+ }
93
+ counted = 0;
94
+ }
95
+ const tail = rest.replace(ANSI, '');
96
+ const dots = DOTS.test(tail) ? tail.length : 0;
97
+ progressed ||= dots > counted;
98
+ state.partial = rest;
99
+ state.countedDots = dots;
100
+ return progressed;
101
+ },
102
+ inFlight: () => [...running],
103
+ };
104
+ }
105
+
106
+ /**
107
+ * `command` with its one `bun test` asked for a line of dots, one per finished test: the only per-test report bun
108
+ * prints whoever runs it. A command that runs no bun, more than one runner, or already chose bun's dots is returned
109
+ * unchanged.
110
+ */
111
+ export function withProgressReport(command: string): string {
112
+ const bun = command.match(BUN_TEST)?.length ?? 0;
113
+ const nextest = command.match(NEXTEST_RUN)?.length ?? 0;
114
+ if (bun !== 1 || nextest !== 0 || /(?:^|\s)(?:--dots|--reporter[=\s]dots)(?=\s|$)/.test(command)) {
115
+ return command;
116
+ }
117
+ return command.replace(BUN_TEST, (_match, runtime: string) => `${runtime} test --dots`);
118
+ }
@@ -0,0 +1,12 @@
1
+ /** One attached image as `ioreg -r -c AppleDiskImageDevice -l -w0` lists it. */
2
+ export function registryDevice(url: string, disk: string): string[] {
3
+ return [
4
+ '+-o AppleDiskImageDevice@5d6 <class AppleDiskImageDevice, id 0x100659c38, registered, matched, active>',
5
+ ` | "DiskImageURL" = "${url}"`,
6
+ ' +-o IOBlockStorageDriver <class IOBlockStorageDriver, id 0x100659c3a, registered>',
7
+ ' +-o Apple Disk Image Media <class IOMedia, id 0x100659c3b, registered>',
8
+ ` | "BSD Name" = "${disk}"`,
9
+ ' +-o Untitled 1@1 <class IOMedia, id 0x10037ce47, registered>',
10
+ ` | "BSD Name" = "${disk}s1"`,
11
+ ];
12
+ }