@speedkit/cli 4.50.5 → 4.51.0-run-control.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (406) hide show
  1. package/README.md +1369 -10
  2. package/dist/base/run-control-command.d.ts +15 -0
  3. package/dist/base/run-control-command.js +20 -0
  4. package/dist/build-info.json +6 -0
  5. package/dist/commands/diff.d.ts +6 -1
  6. package/dist/commands/diff.js +9 -3
  7. package/dist/commands/onboarding/browser/click.d.ts +75 -0
  8. package/dist/commands/onboarding/browser/click.js +19 -0
  9. package/dist/commands/onboarding/browser/emulate.d.ts +93 -0
  10. package/dist/commands/onboarding/browser/emulate.js +23 -0
  11. package/dist/commands/onboarding/browser/navigate.d.ts +67 -0
  12. package/dist/commands/onboarding/browser/navigate.js +18 -0
  13. package/dist/commands/onboarding/browser/panel.d.ts +63 -0
  14. package/dist/commands/onboarding/browser/panel.js +12 -0
  15. package/dist/commands/onboarding/browser/reinstall-sw.d.ts +63 -0
  16. package/dist/commands/onboarding/browser/reinstall-sw.js +14 -0
  17. package/dist/commands/onboarding/browser/reset.d.ts +71 -0
  18. package/dist/commands/onboarding/browser/reset.js +18 -0
  19. package/dist/commands/onboarding/browser/screenshot.d.ts +77 -0
  20. package/dist/commands/onboarding/browser/screenshot.js +19 -0
  21. package/dist/commands/onboarding/browser/state.d.ts +63 -0
  22. package/dist/commands/onboarding/browser/state.js +12 -0
  23. package/dist/commands/onboarding/browser/tabs.d.ts +58 -0
  24. package/dist/commands/onboarding/browser/tabs.js +16 -0
  25. package/dist/commands/onboarding/cache/clear.d.ts +58 -0
  26. package/dist/commands/onboarding/cache/clear.js +12 -0
  27. package/dist/commands/onboarding/cache/errors.d.ts +58 -0
  28. package/dist/commands/onboarding/cache/errors.js +12 -0
  29. package/dist/commands/onboarding/cache/evict.d.ts +62 -0
  30. package/dist/commands/onboarding/cache/evict.js +15 -0
  31. package/dist/commands/onboarding/cache/get.d.ts +85 -0
  32. package/dist/commands/onboarding/cache/get.js +17 -0
  33. package/dist/commands/onboarding/cache/list.d.ts +58 -0
  34. package/dist/commands/onboarding/cache/list.js +15 -0
  35. package/dist/commands/onboarding/cache/prewarm.d.ts +73 -0
  36. package/dist/commands/onboarding/cache/prewarm.js +20 -0
  37. package/dist/commands/onboarding/cache/refresh.d.ts +62 -0
  38. package/dist/commands/onboarding/cache/refresh.js +18 -0
  39. package/dist/commands/onboarding/cdp.d.ts +81 -0
  40. package/dist/commands/onboarding/cdp.js +18 -0
  41. package/dist/commands/onboarding/debug/arm.d.ts +77 -0
  42. package/dist/commands/onboarding/debug/arm.js +18 -0
  43. package/dist/commands/onboarding/debug/await.d.ts +71 -0
  44. package/dist/commands/onboarding/debug/await.js +18 -0
  45. package/dist/commands/onboarding/debug/disarm.d.ts +63 -0
  46. package/dist/commands/onboarding/debug/disarm.js +12 -0
  47. package/dist/commands/onboarding/debug/eval.d.ts +75 -0
  48. package/dist/commands/onboarding/debug/eval.js +16 -0
  49. package/dist/commands/onboarding/debug/release.d.ts +63 -0
  50. package/dist/commands/onboarding/debug/release.js +12 -0
  51. package/dist/commands/onboarding/debug/resume.d.ts +63 -0
  52. package/dist/commands/onboarding/debug/resume.js +12 -0
  53. package/dist/commands/onboarding/debug/status.d.ts +63 -0
  54. package/dist/commands/onboarding/debug/status.js +12 -0
  55. package/dist/commands/onboarding/debug/step.d.ts +67 -0
  56. package/dist/commands/onboarding/debug/step.js +15 -0
  57. package/dist/commands/onboarding/files/list.d.ts +58 -0
  58. package/dist/commands/onboarding/files/list.js +12 -0
  59. package/dist/commands/onboarding/files/read.d.ts +73 -0
  60. package/dist/commands/onboarding/files/read.js +16 -0
  61. package/dist/commands/onboarding/files/rebuild.d.ts +63 -0
  62. package/dist/commands/onboarding/files/rebuild.js +18 -0
  63. package/dist/commands/onboarding/files/validate.d.ts +58 -0
  64. package/dist/commands/onboarding/files/validate.js +12 -0
  65. package/dist/commands/onboarding/fouc.d.ts +77 -0
  66. package/dist/commands/onboarding/fouc.js +16 -0
  67. package/dist/commands/onboarding/inject/add.d.ts +89 -0
  68. package/dist/commands/onboarding/inject/add.js +17 -0
  69. package/dist/commands/onboarding/inject/clear.d.ts +63 -0
  70. package/dist/commands/onboarding/inject/clear.js +12 -0
  71. package/dist/commands/onboarding/inject/list.d.ts +63 -0
  72. package/dist/commands/onboarding/inject/list.js +12 -0
  73. package/dist/commands/onboarding/inject/read.d.ts +75 -0
  74. package/dist/commands/onboarding/inject/read.js +18 -0
  75. package/dist/commands/onboarding/inject/recipes.d.ts +63 -0
  76. package/dist/commands/onboarding/inject/recipes.js +12 -0
  77. package/dist/commands/onboarding/inject/remove.d.ts +67 -0
  78. package/dist/commands/onboarding/inject/remove.js +15 -0
  79. package/dist/commands/onboarding/list.d.ts +13 -0
  80. package/dist/commands/onboarding/list.js +12 -0
  81. package/dist/commands/onboarding/logs.d.ts +41 -0
  82. package/dist/commands/onboarding/logs.js +256 -0
  83. package/dist/commands/onboarding/navwalk.d.ts +95 -0
  84. package/dist/commands/onboarding/navwalk.js +19 -0
  85. package/dist/commands/onboarding/response.d.ts +67 -0
  86. package/dist/commands/onboarding/response.js +18 -0
  87. package/dist/commands/onboarding/rum/beacons.d.ts +75 -0
  88. package/dist/commands/onboarding/rum/beacons.js +16 -0
  89. package/dist/commands/onboarding/rum/get.d.ts +77 -0
  90. package/dist/commands/onboarding/rum/get.js +18 -0
  91. package/dist/commands/onboarding/rum/key.d.ts +67 -0
  92. package/dist/commands/onboarding/rum/key.js +13 -0
  93. package/dist/commands/onboarding/rum/previous.d.ts +63 -0
  94. package/dist/commands/onboarding/rum/previous.js +12 -0
  95. package/dist/commands/onboarding/status.d.ts +13 -0
  96. package/dist/commands/onboarding/status.js +17 -0
  97. package/dist/commands/onboarding/todo.d.ts +58 -0
  98. package/dist/commands/onboarding/todo.js +12 -0
  99. package/dist/commands/onboarding/viewport.d.ts +101 -0
  100. package/dist/commands/onboarding/viewport.js +18 -0
  101. package/dist/commands/onboarding/watch.d.ts +93 -0
  102. package/dist/commands/onboarding/watch.js +16 -0
  103. package/dist/commands/onboarding.d.ts +26 -0
  104. package/dist/commands/onboarding.js +220 -3
  105. package/dist/commands/origin-request.d.ts +4 -0
  106. package/dist/commands/origin-request.js +4 -0
  107. package/dist/commands/spec/onboarding.spec.d.ts +1 -0
  108. package/dist/commands/spec/onboarding.spec.js +127 -0
  109. package/dist/services/cli/build-info.d.ts +33 -0
  110. package/dist/services/cli/build-info.js +63 -0
  111. package/dist/services/cli/cli-environment-factory.d.ts +3 -0
  112. package/dist/services/cli/cli-environment-factory.js +1 -0
  113. package/dist/services/cli/cli-service-build-context.d.ts +3 -0
  114. package/dist/services/cli/cli-service-factory.js +1 -1
  115. package/dist/services/cli/cli-service-model.d.ts +29 -10
  116. package/dist/services/cli/cli-service.d.ts +60 -11
  117. package/dist/services/cli/cli-service.js +196 -32
  118. package/dist/services/cli/index.d.ts +2 -0
  119. package/dist/services/cli/index.js +2 -0
  120. package/dist/services/cli/sink.d.ts +47 -0
  121. package/dist/services/cli/sink.js +31 -0
  122. package/dist/services/cli/spec/build-identity.spec.d.ts +1 -0
  123. package/dist/services/cli/spec/build-identity.spec.js +85 -0
  124. package/dist/services/cli/spec/build-info.spec.d.ts +1 -0
  125. package/dist/services/cli/spec/build-info.spec.js +10 -0
  126. package/dist/services/cli/spec/cli-service-log.spec.d.ts +1 -0
  127. package/dist/services/cli/spec/cli-service-log.spec.js +133 -0
  128. package/dist/services/cli/spec/cli-service.spec.js +113 -50
  129. package/dist/services/cli/spec/memory-cli.d.ts +9 -0
  130. package/dist/services/cli/spec/memory-cli.js +9 -0
  131. package/dist/services/diff/config-at-ref.d.ts +20 -0
  132. package/dist/services/diff/config-at-ref.js +33 -0
  133. package/dist/services/diff/diff-service-build-context.d.ts +8 -0
  134. package/dist/services/diff/diff-service-build-context.js +40 -1
  135. package/dist/services/diff/diff-service-factory.d.ts +2 -0
  136. package/dist/services/diff/diff-service-factory.js +48 -20
  137. package/dist/services/diff/diff-service.d.ts +11 -0
  138. package/dist/services/diff/diff-service.js +37 -11
  139. package/dist/services/diff/page-source.d.ts +12 -0
  140. package/dist/services/diff/page-source.js +16 -11
  141. package/dist/services/diff/sinks/tool-diff-sink.d.ts +3 -2
  142. package/dist/services/diff/sinks/tool-diff-sink.js +3 -2
  143. package/dist/services/diff/spec/config-at-ref.spec.d.ts +1 -0
  144. package/dist/services/diff/spec/config-at-ref.spec.js +46 -0
  145. package/dist/services/diff/spec/diff-service-build-context.spec.js +19 -0
  146. package/dist/services/diff/spec/diff-service.spec.js +95 -0
  147. package/dist/services/git/git-repository.d.ts +2 -0
  148. package/dist/services/git/git-repository.js +6 -0
  149. package/dist/services/integration-api/customer-config-flags.js +1 -0
  150. package/dist/services/onboarding/browser/baqend-response.d.ts +17 -1
  151. package/dist/services/onboarding/browser/baqend-response.js +23 -0
  152. package/dist/services/onboarding/browser/console-log.d.ts +9 -0
  153. package/dist/services/onboarding/browser/console-log.js +27 -0
  154. package/dist/services/onboarding/browser/executable/executable-validator.js +4 -2
  155. package/dist/services/onboarding/browser/extension/extension-bridge.js +5 -3
  156. package/dist/services/onboarding/browser/extension/extension-downloader.js +17 -8
  157. package/dist/services/onboarding/browser/extension/extension-validator.js +9 -4
  158. package/dist/services/onboarding/control/body-inspect.d.ts +24 -0
  159. package/dist/services/onboarding/control/body-inspect.js +106 -0
  160. package/dist/services/onboarding/control/browser-session.d.ts +521 -0
  161. package/dist/services/onboarding/control/browser-session.js +1273 -0
  162. package/dist/services/onboarding/control/config-validation.d.ts +17 -0
  163. package/dist/services/onboarding/control/config-validation.js +46 -0
  164. package/dist/services/onboarding/control/control-protocol.d.ts +1390 -0
  165. package/dist/services/onboarding/control/control-protocol.js +69 -0
  166. package/dist/services/onboarding/control/control-server.d.ts +284 -0
  167. package/dist/services/onboarding/control/control-server.js +1609 -0
  168. package/dist/services/onboarding/control/debug-session.d.ts +190 -0
  169. package/dist/services/onboarding/control/debug-session.js +801 -0
  170. package/dist/services/onboarding/control/fouc.d.ts +23 -0
  171. package/dist/services/onboarding/control/fouc.js +151 -0
  172. package/dist/services/onboarding/control/index.d.ts +4 -0
  173. package/dist/services/onboarding/control/index.js +4 -0
  174. package/dist/services/onboarding/control/navwalk.d.ts +65 -0
  175. package/dist/services/onboarding/control/navwalk.js +248 -0
  176. package/dist/services/onboarding/control/preload-registry.d.ts +150 -0
  177. package/dist/services/onboarding/control/preload-registry.js +829 -0
  178. package/dist/services/onboarding/control/response-explainer.d.ts +24 -0
  179. package/dist/services/onboarding/control/response-explainer.js +257 -0
  180. package/dist/services/onboarding/control/rum.d.ts +8 -0
  181. package/dist/services/onboarding/control/rum.js +220 -0
  182. package/dist/services/onboarding/control/service-worker-tracker.d.ts +68 -0
  183. package/dist/services/onboarding/control/service-worker-tracker.js +119 -0
  184. package/dist/services/onboarding/control/viewport.d.ts +45 -0
  185. package/dist/services/onboarding/control/viewport.js +344 -0
  186. package/dist/services/onboarding/control/watch.d.ts +26 -0
  187. package/dist/services/onboarding/control/watch.js +149 -0
  188. package/dist/services/onboarding/dashboard/diff-against-current-page.js +3 -1
  189. package/dist/services/onboarding/dashboard/index.js +7 -2
  190. package/dist/services/onboarding/fetch-event-handler.d.ts +24 -5
  191. package/dist/services/onboarding/fetch-event-handler.js +94 -32
  192. package/dist/services/onboarding/fetch-events/speed-kit-install-js.js +11 -2
  193. package/dist/services/onboarding/fetch-events/speed-kit-rum-pi-request.d.ts +14 -0
  194. package/dist/services/onboarding/fetch-events/speed-kit-rum-pi-request.js +30 -0
  195. package/dist/services/onboarding/fetch-events/speed-kit-service-worker-js.d.ts +13 -0
  196. package/dist/services/onboarding/fetch-events/speed-kit-service-worker-js.js +28 -1
  197. package/dist/services/onboarding/file-events/file-watcher.d.ts +42 -1
  198. package/dist/services/onboarding/file-events/file-watcher.js +117 -12
  199. package/dist/services/onboarding/onboarding-model.d.ts +30 -0
  200. package/dist/services/onboarding/onboarding-model.js +10 -0
  201. package/dist/services/onboarding/onboarding-service-build-context.d.ts +4 -0
  202. package/dist/services/onboarding/onboarding-service-build-context.js +6 -0
  203. package/dist/services/onboarding/onboarding-service-factory.d.ts +17 -1
  204. package/dist/services/onboarding/onboarding-service-factory.js +131 -17
  205. package/dist/services/onboarding/onboarding-service.d.ts +40 -1
  206. package/dist/services/onboarding/onboarding-service.js +135 -22
  207. package/dist/services/onboarding/request-cache/asset-key.d.ts +61 -0
  208. package/dist/services/onboarding/request-cache/asset-key.js +115 -0
  209. package/dist/services/onboarding/request-cache/cache.d.ts +62 -5
  210. package/dist/services/onboarding/request-cache/cache.js +128 -17
  211. package/dist/services/onboarding/spec/browser/console-log.spec.d.ts +1 -0
  212. package/dist/services/onboarding/spec/browser/console-log.spec.js +42 -0
  213. package/dist/services/onboarding/spec/control/browser-session.spec.d.ts +1 -0
  214. package/dist/services/onboarding/spec/control/browser-session.spec.js +526 -0
  215. package/dist/services/onboarding/spec/control/control-server.spec.d.ts +1 -0
  216. package/dist/services/onboarding/spec/control/control-server.spec.js +338 -0
  217. package/dist/services/onboarding/spec/control/debug-session.spec.d.ts +1 -0
  218. package/dist/services/onboarding/spec/control/debug-session.spec.js +693 -0
  219. package/dist/services/onboarding/spec/control/fakes.d.ts +31 -0
  220. package/dist/services/onboarding/spec/control/fakes.js +66 -0
  221. package/dist/services/onboarding/spec/control/fouc.spec.d.ts +1 -0
  222. package/dist/services/onboarding/spec/control/fouc.spec.js +167 -0
  223. package/dist/services/onboarding/spec/control/navwalk.spec.d.ts +1 -0
  224. package/dist/services/onboarding/spec/control/navwalk.spec.js +222 -0
  225. package/dist/services/onboarding/spec/control/preload-registry.spec.d.ts +1 -0
  226. package/dist/services/onboarding/spec/control/preload-registry.spec.js +432 -0
  227. package/dist/services/onboarding/spec/control/response-explainer.spec.d.ts +1 -0
  228. package/dist/services/onboarding/spec/control/response-explainer.spec.js +324 -0
  229. package/dist/services/onboarding/spec/control/rum.spec.d.ts +1 -0
  230. package/dist/services/onboarding/spec/control/rum.spec.js +222 -0
  231. package/dist/services/onboarding/spec/control/service-worker-tracker.spec.d.ts +1 -0
  232. package/dist/services/onboarding/spec/control/service-worker-tracker.spec.js +193 -0
  233. package/dist/services/onboarding/spec/control/viewport.spec.d.ts +1 -0
  234. package/dist/services/onboarding/spec/control/viewport.spec.js +200 -0
  235. package/dist/services/onboarding/spec/control/watch.spec.d.ts +1 -0
  236. package/dist/services/onboarding/spec/control/watch.spec.js +172 -0
  237. package/dist/services/onboarding/spec/fetch-event-handler.spec.d.ts +1 -0
  238. package/dist/services/onboarding/spec/fetch-event-handler.spec.js +202 -0
  239. package/dist/services/onboarding/spec/fetch-events/speed-kit-service-worker-js.spec.d.ts +1 -0
  240. package/dist/services/onboarding/spec/fetch-events/speed-kit-service-worker-js.spec.js +41 -0
  241. package/dist/services/onboarding/spec/onboarding-model.spec.js +37 -0
  242. package/dist/services/onboarding/spec/onboarding-service-factory.spec.js +1 -0
  243. package/dist/services/onboarding/spec/request-cache/cache.spec.d.ts +1 -0
  244. package/dist/services/onboarding/spec/request-cache/cache.spec.js +107 -0
  245. package/dist/services/onboarding/spec/todo-collector.spec.d.ts +1 -0
  246. package/dist/services/onboarding/spec/todo-collector.spec.js +136 -0
  247. package/dist/services/onboarding/todo-collector.d.ts +7 -2
  248. package/dist/services/onboarding/todo-collector.js +49 -12
  249. package/dist/services/onboarding/virtual-orestes-app/index.d.ts +34 -0
  250. package/dist/services/onboarding/virtual-orestes-app/index.js +82 -27
  251. package/dist/services/origin-request/asset-variations.d.ts +14 -0
  252. package/dist/services/origin-request/asset-variations.js +11 -4
  253. package/dist/services/origin-request/origin-fetcher.d.ts +7 -0
  254. package/dist/services/origin-request/origin-fetcher.js +43 -5
  255. package/dist/services/origin-request/origin-request-service-build-context.d.ts +17 -0
  256. package/dist/services/origin-request/origin-request-service-build-context.js +8 -0
  257. package/dist/services/origin-request/origin-request-service-factory.d.ts +0 -5
  258. package/dist/services/origin-request/origin-request-service-factory.js +2 -30
  259. package/dist/services/origin-request/origin-request-service.d.ts +121 -6
  260. package/dist/services/origin-request/origin-request-service.js +273 -49
  261. package/dist/services/origin-request/runtime-config-source.js +9 -4
  262. package/dist/services/origin-request/spec/asset-variations.spec.js +20 -0
  263. package/dist/services/origin-request/spec/origin-request-service.spec.js +329 -6
  264. package/dist/services/query-builder/rules/rule-match.d.ts +35 -0
  265. package/dist/services/query-builder/rules/rule-match.js +70 -0
  266. package/dist/services/query-builder/spec/rules/rule-match.spec.d.ts +1 -0
  267. package/dist/services/query-builder/spec/rules/rule-match.spec.js +121 -0
  268. package/dist/services/run-control/browser/run-browser-contexts.d.ts +541 -0
  269. package/dist/services/run-control/browser/run-browser-contexts.js +78 -0
  270. package/dist/services/run-control/browser/run-browser-service-factory.d.ts +5 -0
  271. package/dist/services/run-control/browser/run-browser-service-factory.js +7 -0
  272. package/dist/services/run-control/browser/run-browser-service.d.ts +64 -0
  273. package/dist/services/run-control/browser/run-browser-service.js +199 -0
  274. package/dist/services/run-control/cache/run-cache-contexts.d.ts +349 -0
  275. package/dist/services/run-control/cache/run-cache-contexts.js +51 -0
  276. package/dist/services/run-control/cache/run-cache-service-factory.d.ts +6 -0
  277. package/dist/services/run-control/cache/run-cache-service-factory.js +12 -0
  278. package/dist/services/run-control/cache/run-cache-service.d.ts +35 -0
  279. package/dist/services/run-control/cache/run-cache-service.js +151 -0
  280. package/dist/services/run-control/control-client.d.ts +36 -0
  281. package/dist/services/run-control/control-client.js +147 -0
  282. package/dist/services/run-control/debug/run-debug-contexts.d.ts +411 -0
  283. package/dist/services/run-control/debug/run-debug-contexts.js +44 -0
  284. package/dist/services/run-control/debug/run-debug-service-factory.d.ts +5 -0
  285. package/dist/services/run-control/debug/run-debug-service-factory.js +7 -0
  286. package/dist/services/run-control/debug/run-debug-service.d.ts +38 -0
  287. package/dist/services/run-control/debug/run-debug-service.js +161 -0
  288. package/dist/services/run-control/files/run-files-contexts.d.ts +238 -0
  289. package/dist/services/run-control/files/run-files-contexts.js +26 -0
  290. package/dist/services/run-control/files/run-files-service-factory.d.ts +5 -0
  291. package/dist/services/run-control/files/run-files-service-factory.js +7 -0
  292. package/dist/services/run-control/files/run-files-service.d.ts +29 -0
  293. package/dist/services/run-control/files/run-files-service.js +120 -0
  294. package/dist/services/run-control/index.d.ts +32 -0
  295. package/dist/services/run-control/index.js +31 -0
  296. package/dist/services/run-control/inject/run-inject-contexts.d.ts +319 -0
  297. package/dist/services/run-control/inject/run-inject-contexts.js +32 -0
  298. package/dist/services/run-control/inject/run-inject-service-factory.d.ts +5 -0
  299. package/dist/services/run-control/inject/run-inject-service-factory.js +7 -0
  300. package/dist/services/run-control/inject/run-inject-service.d.ts +31 -0
  301. package/dist/services/run-control/inject/run-inject-service.js +203 -0
  302. package/dist/services/run-control/live-run.d.ts +37 -0
  303. package/dist/services/run-control/live-run.js +56 -0
  304. package/dist/services/run-control/probe/run-probe-contexts.d.ts +333 -0
  305. package/dist/services/run-control/probe/run-probe-contexts.js +73 -0
  306. package/dist/services/run-control/probe/run-probe-service-factory.d.ts +5 -0
  307. package/dist/services/run-control/probe/run-probe-service-factory.js +7 -0
  308. package/dist/services/run-control/probe/run-probe-service.d.ts +54 -0
  309. package/dist/services/run-control/probe/run-probe-service.js +193 -0
  310. package/dist/services/run-control/rum/run-rum-contexts.d.ts +216 -0
  311. package/dist/services/run-control/rum/run-rum-contexts.js +34 -0
  312. package/dist/services/run-control/rum/run-rum-service-factory.d.ts +5 -0
  313. package/dist/services/run-control/rum/run-rum-service-factory.js +7 -0
  314. package/dist/services/run-control/rum/run-rum-service.d.ts +36 -0
  315. package/dist/services/run-control/rum/run-rum-service.js +122 -0
  316. package/dist/services/run-control/run-answer.d.ts +28 -0
  317. package/dist/services/run-control/run-answer.js +58 -0
  318. package/dist/services/run-control/run-control-context.d.ts +102 -0
  319. package/dist/services/run-control/run-control-context.js +36 -0
  320. package/dist/services/run-control/run-control-flags.d.ts +12 -0
  321. package/dist/services/run-control/run-control-flags.js +22 -0
  322. package/dist/services/run-control/run-control-model.d.ts +9 -0
  323. package/dist/services/run-control/run-control-model.js +1 -0
  324. package/dist/services/run-control/run-control-service-factory.d.ts +14 -0
  325. package/dist/services/run-control/run-control-service-factory.js +26 -0
  326. package/dist/services/run-control/session/run-session-contexts.d.ts +25 -0
  327. package/dist/services/run-control/session/run-session-contexts.js +20 -0
  328. package/dist/services/run-control/session/run-session-service-factory.d.ts +8 -0
  329. package/dist/services/run-control/session/run-session-service-factory.js +18 -0
  330. package/dist/services/run-control/session/run-session-service.d.ts +25 -0
  331. package/dist/services/run-control/session/run-session-service.js +95 -0
  332. package/dist/services/run-control/spec/browser/run-browser-service.spec.d.ts +1 -0
  333. package/dist/services/run-control/spec/browser/run-browser-service.spec.js +327 -0
  334. package/dist/services/run-control/spec/cache/run-cache-service.spec.d.ts +1 -0
  335. package/dist/services/run-control/spec/cache/run-cache-service.spec.js +454 -0
  336. package/dist/services/run-control/spec/debug/run-debug-service.spec.d.ts +1 -0
  337. package/dist/services/run-control/spec/debug/run-debug-service.spec.js +113 -0
  338. package/dist/services/run-control/spec/files/run-files-service.spec.d.ts +1 -0
  339. package/dist/services/run-control/spec/files/run-files-service.spec.js +234 -0
  340. package/dist/services/run-control/spec/inject/run-inject-service.spec.d.ts +1 -0
  341. package/dist/services/run-control/spec/inject/run-inject-service.spec.js +224 -0
  342. package/dist/services/run-control/spec/live-run-fixture.d.ts +32 -0
  343. package/dist/services/run-control/spec/live-run-fixture.js +109 -0
  344. package/dist/services/run-control/spec/probe/run-probe-service.spec.d.ts +1 -0
  345. package/dist/services/run-control/spec/probe/run-probe-service.spec.js +108 -0
  346. package/dist/services/run-control/spec/rum/run-rum-service.spec.d.ts +1 -0
  347. package/dist/services/run-control/spec/rum/run-rum-service.spec.js +47 -0
  348. package/dist/services/run-control/spec/run-answer.spec.d.ts +1 -0
  349. package/dist/services/run-control/spec/run-answer.spec.js +57 -0
  350. package/dist/services/run-control/spec/session/run-session-service.spec.d.ts +1 -0
  351. package/dist/services/run-control/spec/session/run-session-service.spec.js +101 -0
  352. package/dist/services/run-log/crash-mirror.d.ts +31 -0
  353. package/dist/services/run-log/crash-mirror.js +69 -0
  354. package/dist/services/run-log/index.d.ts +11 -0
  355. package/dist/services/run-log/index.js +11 -0
  356. package/dist/services/run-log/jsonl-appender.d.ts +46 -0
  357. package/dist/services/run-log/jsonl-appender.js +91 -0
  358. package/dist/services/run-log/log-event-model.d.ts +104 -0
  359. package/dist/services/run-log/log-event-model.js +56 -0
  360. package/dist/services/run-log/log-query-service-factory.d.ts +11 -0
  361. package/dist/services/run-log/log-query-service-factory.js +14 -0
  362. package/dist/services/run-log/log-query-service.d.ts +59 -0
  363. package/dist/services/run-log/log-query-service.js +111 -0
  364. package/dist/services/run-log/log-reader.d.ts +84 -0
  365. package/dist/services/run-log/log-reader.js +180 -0
  366. package/dist/services/run-log/log-summary.d.ts +72 -0
  367. package/dist/services/run-log/log-summary.js +208 -0
  368. package/dist/services/run-log/redaction.d.ts +34 -0
  369. package/dist/services/run-log/redaction.js +124 -0
  370. package/dist/services/run-log/request-log.d.ts +80 -0
  371. package/dist/services/run-log/request-log.js +69 -0
  372. package/dist/services/run-log/request-summary.d.ts +76 -0
  373. package/dist/services/run-log/request-summary.js +0 -0
  374. package/dist/services/run-log/run-log.d.ts +61 -0
  375. package/dist/services/run-log/run-log.js +102 -0
  376. package/dist/services/run-log/spec/log-query-service.spec.d.ts +1 -0
  377. package/dist/services/run-log/spec/log-query-service.spec.js +197 -0
  378. package/dist/services/run-log/spec/log-reader.spec.d.ts +1 -0
  379. package/dist/services/run-log/spec/log-reader.spec.js +109 -0
  380. package/dist/services/run-log/spec/log-summary.spec.d.ts +1 -0
  381. package/dist/services/run-log/spec/log-summary.spec.js +153 -0
  382. package/dist/services/run-log/spec/redaction.spec.d.ts +1 -0
  383. package/dist/services/run-log/spec/redaction.spec.js +61 -0
  384. package/dist/services/run-log/spec/request-log.spec.d.ts +1 -0
  385. package/dist/services/run-log/spec/request-log.spec.js +101 -0
  386. package/dist/services/run-log/spec/request-summary.spec.d.ts +1 -0
  387. package/dist/services/run-log/spec/request-summary.spec.js +171 -0
  388. package/dist/services/run-log/spec/run-log.spec.d.ts +1 -0
  389. package/dist/services/run-log/spec/run-log.spec.js +122 -0
  390. package/dist/services/run-registry/exit-classification.d.ts +39 -0
  391. package/dist/services/run-registry/exit-classification.js +42 -0
  392. package/dist/services/run-registry/index.d.ts +3 -0
  393. package/dist/services/run-registry/index.js +3 -0
  394. package/dist/services/run-registry/process-identity.d.ts +28 -0
  395. package/dist/services/run-registry/process-identity.js +80 -0
  396. package/dist/services/run-registry/run-registry-model.d.ts +128 -0
  397. package/dist/services/run-registry/run-registry-model.js +16 -0
  398. package/dist/services/run-registry/run-registry.d.ts +150 -0
  399. package/dist/services/run-registry/run-registry.js +409 -0
  400. package/dist/services/run-registry/spec/exit-classification.spec.d.ts +1 -0
  401. package/dist/services/run-registry/spec/exit-classification.spec.js +82 -0
  402. package/dist/services/run-registry/spec/run-registry.spec.d.ts +1 -0
  403. package/dist/services/run-registry/spec/run-registry.spec.js +509 -0
  404. package/dist/services/setup/os/tool-registry.js +2 -2
  405. package/oclif.manifest.json +3293 -272
  406. package/package.json +20 -2
@@ -0,0 +1,509 @@
1
+ import { expect } from "chai";
2
+ import { afterEach, beforeEach, describe, it } from "mocha";
3
+ import { existsSync, mkdtempSync, mkdirSync, readlinkSync, rmSync, truncateSync, writeFileSync, } from "node:fs";
4
+ import { tmpdir } from "node:os";
5
+ import { join } from "node:path";
6
+ import { AmbiguousRunError, NoSuchRunError, RunRegistry, } from "../run-registry.js";
7
+ import { CURRENT_LINK, META_FILE } from "../run-registry-model.js";
8
+ import { processStartToken, sameProcess } from "../process-identity.js";
9
+ import { KEEP_BYTES } from "../run-registry-model.js";
10
+ /** A pid nothing can be running under, so the registry must call it dead. */
11
+ const DEAD_PID = 2_147_483_646;
12
+ describe("RunRegistry", () => {
13
+ let cacheDirectory;
14
+ let registry;
15
+ const writeRun = (meta) => {
16
+ const full = {
17
+ customer: "example.com",
18
+ customerPath: "customers/example.com",
19
+ configName: "production",
20
+ pid: DEAD_PID,
21
+ startedAt: new Date().toISOString(),
22
+ status: "finished",
23
+ flags: {
24
+ local: false,
25
+ headless: false,
26
+ useTestConfig: false,
27
+ ignoreContentSecurityPolicy: false,
28
+ },
29
+ cliVersion: "0.0.0",
30
+ ...meta,
31
+ };
32
+ const dir = join(registry.directory, full.id);
33
+ mkdirSync(dir, { recursive: true });
34
+ writeFileSync(join(dir, META_FILE), JSON.stringify(full));
35
+ return dir;
36
+ };
37
+ beforeEach(() => {
38
+ cacheDirectory = mkdtempSync(join(tmpdir(), "sk-runs-"));
39
+ registry = new RunRegistry(cacheDirectory);
40
+ });
41
+ afterEach(() => {
42
+ rmSync(cacheDirectory, { recursive: true, force: true });
43
+ });
44
+ it("should answer an empty listing before anything has run", () => {
45
+ expect(registry.list()).to.deep.equal([]);
46
+ expect(registry.liveRuns()).to.deep.equal([]);
47
+ });
48
+ it("should record a starting run and find it again", () => {
49
+ const handle = registry.start({
50
+ customerPath: "customers/example.com",
51
+ configName: "production",
52
+ cliVersion: "1.2.3",
53
+ flags: {
54
+ local: true,
55
+ headless: false,
56
+ useTestConfig: false,
57
+ ignoreContentSecurityPolicy: false,
58
+ },
59
+ });
60
+ const [run] = registry.list();
61
+ expect(run.meta.id).to.equal(handle.id);
62
+ expect(run.meta.customer).to.equal("example.com");
63
+ expect(run.meta.pid).to.equal(process.pid);
64
+ expect(run.meta.flags.local).to.equal(true);
65
+ // this process is alive, so its own run must read as live
66
+ expect(run.status).to.equal("running");
67
+ expect(run.live).to.equal(true);
68
+ });
69
+ it("should call a run that claims to be running but is not, crashed", () => {
70
+ writeRun({ id: "example.com-production-1", status: "running" });
71
+ const [run] = registry.list();
72
+ expect(run.meta.status).to.equal("running"); // the claim is untouched
73
+ expect(run.status).to.equal("crashed"); // the reconciled answer
74
+ expect(run.live).to.equal(false);
75
+ });
76
+ it("should record why a run ended, alongside how", () => {
77
+ const handle = registry.start({
78
+ customerPath: "customers/example.com",
79
+ configName: "production",
80
+ cliVersion: "1.2.3",
81
+ flags: {
82
+ local: false,
83
+ headless: false,
84
+ useTestConfig: false,
85
+ ignoreContentSecurityPolicy: false,
86
+ },
87
+ });
88
+ // A teardown that throws after a requested stop is still a stop — but the
89
+ // message is worth keeping, or the status hides it.
90
+ handle.finish("stopped", "Target closed");
91
+ const [run] = registry.list();
92
+ expect(run.status).to.equal("stopped");
93
+ expect(run.meta.error).to.equal("Target closed");
94
+ });
95
+ it("should stamp an outcome, and let the first stamp win", () => {
96
+ const handle = registry.start({
97
+ customerPath: "customers/example.com",
98
+ configName: "production",
99
+ cliVersion: "1.2.3",
100
+ flags: {
101
+ local: false,
102
+ headless: false,
103
+ useTestConfig: false,
104
+ ignoreContentSecurityPolicy: false,
105
+ },
106
+ });
107
+ handle.finish("failed");
108
+ handle.finish("finished"); // a later `finally` must not overwrite it
109
+ const [run] = registry.list();
110
+ expect(run.status).to.equal("failed");
111
+ expect(run.meta.endedAt).to.be.a("string");
112
+ });
113
+ it("should fill in what was not known at startup", () => {
114
+ const handle = registry.start({
115
+ customerPath: "customers/example.com",
116
+ configName: "production",
117
+ cliVersion: "1.2.3",
118
+ flags: {
119
+ local: false,
120
+ headless: false,
121
+ useTestConfig: false,
122
+ ignoreContentSecurityPolicy: false,
123
+ },
124
+ });
125
+ handle.update({ app: "example-app" });
126
+ expect(registry.list()[0].meta.app).to.equal("example-app");
127
+ });
128
+ it("should list newest first", () => {
129
+ writeRun({ id: "a-production-1", startedAt: "2026-09-01T00:00:00.000Z" });
130
+ writeRun({ id: "b-production-2", startedAt: "2026-09-03T00:00:00.000Z" });
131
+ writeRun({ id: "c-production-3", startedAt: "2026-09-02T00:00:00.000Z" });
132
+ expect(registry.list().map((run) => run.meta.id)).to.deep.equal([
133
+ "b-production-2",
134
+ "c-production-3",
135
+ "a-production-1",
136
+ ]);
137
+ });
138
+ it("should ignore a half-written meta.json rather than fail the listing", () => {
139
+ writeRun({ id: "good-production-1" });
140
+ const broken = join(registry.directory, "broken-production-2");
141
+ mkdirSync(broken, { recursive: true });
142
+ writeFileSync(join(broken, META_FILE), "{ not json");
143
+ expect(registry.list().map((run) => run.meta.id)).to.deep.equal([
144
+ "good-production-1",
145
+ ]);
146
+ });
147
+ describe("conflicts", () => {
148
+ const liveRun = (id, extra = {}) => writeRun({
149
+ id,
150
+ status: "running",
151
+ pid: process.pid,
152
+ startToken: processStartToken(process.pid) ?? undefined,
153
+ ...extra,
154
+ });
155
+ it("should find nothing when nothing is running", () => {
156
+ writeRun({ id: "ended-production-1" });
157
+ expect(registry.conflicts({ customerPath: "customers/example.com" })).to.deep.equal({ sameCustomer: [], samePort: [] });
158
+ });
159
+ it("should recognise the same directory spelled differently", () => {
160
+ liveRun("example.com-production-1", {
161
+ customerPath: "./customers/example.com/",
162
+ });
163
+ const { sameCustomer } = registry.conflicts({
164
+ customerPath: "customers/example.com",
165
+ });
166
+ // The same customer is routinely given as `customers/x`, `./customers/x`
167
+ // and `./customers/x/`; they are one directory and one collision.
168
+ expect(sameCustomer.map((run) => run.meta.id)).to.deep.equal([
169
+ "example.com-production-1",
170
+ ]);
171
+ });
172
+ it("should not call a different customer a collision", () => {
173
+ liveRun("other.com-production-1", {
174
+ customerPath: "customers/other.com",
175
+ });
176
+ expect(registry.conflicts({ customerPath: "customers/example.com" })
177
+ .sameCustomer).to.deep.equal([]);
178
+ });
179
+ it("should report a live run holding the debug port", () => {
180
+ liveRun("other.com-production-1", {
181
+ customerPath: "customers/other.com",
182
+ debugPort: 9222,
183
+ });
184
+ const { samePort, sameCustomer } = registry.conflicts({
185
+ customerPath: "customers/example.com",
186
+ debugPort: 9222,
187
+ });
188
+ // A different customer entirely, but the port is the thing that collides.
189
+ expect(samePort.map((run) => run.meta.id)).to.deep.equal([
190
+ "other.com-production-1",
191
+ ]);
192
+ expect(sameCustomer).to.deep.equal([]);
193
+ });
194
+ it("should say nothing about the port when this run will not open one", () => {
195
+ liveRun("other.com-production-1", {
196
+ customerPath: "customers/other.com",
197
+ debugPort: 9222,
198
+ });
199
+ // Without -p the new run records no port and opens none, so the other
200
+ // run holding 9222 is not its problem.
201
+ expect(registry.conflicts({ customerPath: "customers/example.com" }).samePort).to.deep.equal([]);
202
+ });
203
+ it("should ignore a port held by a run that has ended", () => {
204
+ writeRun({ id: "other.com-production-1", debugPort: 9222 });
205
+ expect(registry.conflicts({
206
+ customerPath: "customers/example.com",
207
+ debugPort: 9222,
208
+ }).samePort).to.deep.equal([]);
209
+ });
210
+ it("should report both when both collide", () => {
211
+ liveRun("example.com-production-1", { debugPort: 9222 });
212
+ const conflicts = registry.conflicts({
213
+ customerPath: "customers/example.com",
214
+ debugPort: 9222,
215
+ });
216
+ expect(conflicts.sameCustomer).to.have.lengthOf(1);
217
+ expect(conflicts.samePort).to.have.lengthOf(1);
218
+ });
219
+ });
220
+ describe("retention", () => {
221
+ /**
222
+ * A run whose cache reports `bytes`.
223
+ *
224
+ * Sparse: truncate sets the size the pruner measures without the test
225
+ * having to write half a gigabyte to find out whether it is counted.
226
+ */
227
+ const withCachedBytes = (dir, bytes) => {
228
+ mkdirSync(join(dir, "dh-cache"), { recursive: true });
229
+ const path = join(dir, "dh-cache", "a.body");
230
+ writeFileSync(path, "");
231
+ truncateSync(path, bytes);
232
+ };
233
+ const writeHeavyRun = (id, startedAt, bytes) => withCachedBytes(writeRun({ id, startedAt }), bytes);
234
+ it("should evict oldest-first once the runs outgrow their budget", () => {
235
+ // Well inside the count and age rules, and far outside the byte one —
236
+ // which is the gap: those rules count runs, and what grows is bytes.
237
+ const chunk = Math.ceil(KEEP_BYTES / 3);
238
+ writeHeavyRun("a-production-1", "2026-09-01T00:00:00.000Z", chunk);
239
+ writeHeavyRun("b-production-2", "2026-09-02T00:00:00.000Z", chunk);
240
+ writeHeavyRun("c-production-3", "2026-09-03T00:00:00.000Z", chunk);
241
+ writeHeavyRun("d-production-4", "2026-09-04T00:00:00.000Z", chunk);
242
+ registry.prune();
243
+ const kept = registry.list().map((run) => run.meta.id);
244
+ expect(kept).to.not.contain("a-production-1");
245
+ expect(kept).to.contain("d-production-4");
246
+ });
247
+ it("should never evict a live run, however large", () => {
248
+ const dir = writeRun({
249
+ id: "live-production-1",
250
+ status: "running",
251
+ pid: process.pid,
252
+ startToken: processStartToken(process.pid) ?? undefined,
253
+ });
254
+ withCachedBytes(dir, KEEP_BYTES + 1);
255
+ registry.prune();
256
+ // Taking the cache out from under a running session would be worse than
257
+ // the disk it saves.
258
+ expect(registry.list().map((run) => run.meta.id)).to.contain("live-production-1");
259
+ });
260
+ });
261
+ describe("the current link", () => {
262
+ it("should hand current to a live run when the newest one ends", () => {
263
+ writeRun({
264
+ id: "live-production-1",
265
+ status: "running",
266
+ pid: process.pid,
267
+ startToken: processStartToken(process.pid) ?? undefined,
268
+ });
269
+ const handle = registry.start({
270
+ customerPath: "customers/later.com",
271
+ configName: "production",
272
+ cliVersion: "1.2.3",
273
+ flags: {
274
+ local: false,
275
+ headless: false,
276
+ useTestConfig: false,
277
+ ignoreContentSecurityPolicy: false,
278
+ },
279
+ });
280
+ // No link at all while two are live: `current` names one directory, so
281
+ // pointing it at the newer of two running sessions is exactly the
282
+ // confident wrong answer the link exists to avoid.
283
+ expect(existsSync(join(registry.directory, CURRENT_LINK))).to.equal(false);
284
+ handle.finish("finished");
285
+ // A current that points at a finished run while a live one sits next to
286
+ // it is a confident wrong answer for anyone reading it by hand.
287
+ expect(readlinkSync(join(registry.directory, CURRENT_LINK))).to.equal("live-production-1");
288
+ });
289
+ it("should point current at the only live run", () => {
290
+ const handle = registry.start({
291
+ customerPath: "customers/only.com",
292
+ configName: "production",
293
+ cliVersion: "1.2.3",
294
+ flags: {
295
+ local: false,
296
+ headless: false,
297
+ useTestConfig: false,
298
+ ignoreContentSecurityPolicy: false,
299
+ },
300
+ });
301
+ expect(readlinkSync(join(registry.directory, CURRENT_LINK))).to.equal(handle.id);
302
+ });
303
+ it("should remove current when nothing is running any more", () => {
304
+ const handle = registry.start({
305
+ customerPath: "customers/only.com",
306
+ configName: "production",
307
+ cliVersion: "1.2.3",
308
+ flags: {
309
+ local: false,
310
+ headless: false,
311
+ useTestConfig: false,
312
+ ignoreContentSecurityPolicy: false,
313
+ },
314
+ });
315
+ handle.finish("finished");
316
+ expect(existsSync(join(registry.directory, CURRENT_LINK))).to.equal(false);
317
+ });
318
+ });
319
+ describe("liveRuns", () => {
320
+ it("should return every live run rather than picking one", () => {
321
+ // The method it replaced was `list().find(run => run.live)`, which named
322
+ // the newest and said nothing about the rest — the only place in the
323
+ // registry that guessed where `resolve` refuses.
324
+ writeRun({
325
+ id: "one-production-1",
326
+ status: "running",
327
+ pid: process.pid,
328
+ startToken: processStartToken(process.pid) ?? undefined,
329
+ });
330
+ writeRun({
331
+ id: "two-production-1",
332
+ status: "running",
333
+ pid: process.pid,
334
+ startToken: processStartToken(process.pid) ?? undefined,
335
+ });
336
+ writeRun({ id: "ended-production-1" });
337
+ expect(registry
338
+ .liveRuns()
339
+ .map((run) => run.meta.id)
340
+ .sort()).to.deep.equal(["one-production-1", "two-production-1"]);
341
+ });
342
+ });
343
+ describe("process identity", () => {
344
+ it("should call a reused pid what it is: a different process", () => {
345
+ // The pid is this process, so it is alive — but the token says the run
346
+ // that recorded it was something else.
347
+ writeRun({
348
+ id: "example.com-production-1",
349
+ status: "running",
350
+ pid: process.pid,
351
+ startToken: "not-the-token-of-this-process",
352
+ });
353
+ const [run] = registry.list();
354
+ expect(run.live).to.equal(false);
355
+ expect(run.status).to.equal("crashed");
356
+ expect(run.liveVerified).to.equal(true);
357
+ });
358
+ it("should accept a live pid whose token matches", () => {
359
+ writeRun({
360
+ id: "example.com-production-1",
361
+ status: "running",
362
+ pid: process.pid,
363
+ startToken: processStartToken(process.pid) ?? undefined,
364
+ });
365
+ const [run] = registry.list();
366
+ expect(run.live).to.equal(true);
367
+ expect(run.status).to.equal("running");
368
+ });
369
+ it("should keep a live pid without a token, but say it is unconfirmed", () => {
370
+ // An older run directory, or a platform that cannot tell us. Hiding a
371
+ // live run because we could not confirm it is worse than the risk.
372
+ writeRun({
373
+ id: "example.com-production-1",
374
+ status: "running",
375
+ pid: process.pid,
376
+ });
377
+ const [run] = registry.list();
378
+ expect(run.live).to.equal(true);
379
+ expect(run.liveVerified).to.equal(false);
380
+ });
381
+ it("should be certain about a run that ended and one whose pid is gone", () => {
382
+ writeRun({ id: "ended-production-1", status: "finished" });
383
+ writeRun({ id: "gone-production-2", status: "running" });
384
+ for (const run of registry.list()) {
385
+ expect(run.live).to.equal(false);
386
+ expect(run.liveVerified).to.equal(true);
387
+ }
388
+ });
389
+ });
390
+ describe("sameProcess", () => {
391
+ it("should not claim a verdict it cannot support", () => {
392
+ expect(sameProcess(process.pid, undefined)).to.deep.equal({
393
+ same: true,
394
+ verified: false,
395
+ });
396
+ });
397
+ it("should confirm this process against its own token", () => {
398
+ const token = processStartToken(process.pid);
399
+ if (token === null) {
400
+ return; // platform gives us nothing to check; covered by the case above
401
+ }
402
+ expect(sameProcess(process.pid, token)).to.deep.equal({
403
+ same: true,
404
+ verified: true,
405
+ });
406
+ });
407
+ });
408
+ describe("resolve", () => {
409
+ it("should refuse to guess between several live runs", () => {
410
+ writeRun({ id: "a-production-1", status: "running", pid: process.pid });
411
+ writeRun({ id: "b-production-2", status: "running", pid: process.pid });
412
+ expect(() => registry.resolve()).to.throw(AmbiguousRunError);
413
+ });
414
+ it("should take the one live run without being asked", () => {
415
+ writeRun({
416
+ id: "old-production-1",
417
+ startedAt: "2026-09-01T00:00:00.000Z",
418
+ });
419
+ writeRun({
420
+ id: "live-production-2",
421
+ status: "running",
422
+ pid: process.pid,
423
+ startedAt: "2026-09-02T00:00:00.000Z",
424
+ });
425
+ expect(registry.resolve().meta.id).to.equal("live-production-2");
426
+ });
427
+ it("should fall back to the newest finished run when none is live", () => {
428
+ writeRun({ id: "a-production-1", startedAt: "2026-09-01T00:00:00.000Z" });
429
+ writeRun({ id: "b-production-2", startedAt: "2026-09-02T00:00:00.000Z" });
430
+ expect(registry.resolve().meta.id).to.equal("b-production-2");
431
+ });
432
+ it("should find a run by id, customer or path", () => {
433
+ writeRun({ id: "example.com-production-1" });
434
+ expect(registry.resolve("example.com-production-1").meta.id).to.equal("example.com-production-1");
435
+ expect(registry.resolve("example.com").meta.id).to.equal("example.com-production-1");
436
+ expect(registry.resolve("customers/example.com").meta.id).to.equal("example.com-production-1");
437
+ });
438
+ it("should read ./customers/x/ and customers/x as one path", () => {
439
+ writeRun({
440
+ id: "example.com-production-1",
441
+ customerPath: "./customers/example.com",
442
+ });
443
+ expect(registry.resolve("customers/example.com/").meta.id).to.equal("example.com-production-1");
444
+ });
445
+ it("should find a run by the start of its customer name", () => {
446
+ // What people type: the directory is hirmer-de, the selector is hirmer.
447
+ writeRun({
448
+ id: "hirmer-de-production-1",
449
+ customer: "hirmer-de",
450
+ status: "stopped",
451
+ });
452
+ expect(registry.resolve("hirmer").meta.id).to.equal("hirmer-de-production-1");
453
+ });
454
+ it("should refuse a prefix that reaches two customers", () => {
455
+ writeRun({ id: "hirmer-de-production-1", customer: "hirmer-de" });
456
+ writeRun({ id: "hirmer-at-production-1", customer: "hirmer-at" });
457
+ expect(() => registry.resolve("hirmer")).to.throw(AmbiguousRunError);
458
+ });
459
+ it("should prefer an exact match over a prefix", () => {
460
+ writeRun({ id: "shop-production-1", customer: "shop" });
461
+ writeRun({ id: "shop-de-production-1", customer: "shop-de" });
462
+ expect(registry.resolve("shop").meta.id).to.equal("shop-production-1");
463
+ });
464
+ it("should prefer the live run when a name matches several", () => {
465
+ // A customer name matches every run they have ever had, so this is the
466
+ // normal case rather than an edge one.
467
+ writeRun({ id: "example.com-production-1" });
468
+ writeRun({
469
+ id: "example.com-production-2",
470
+ status: "running",
471
+ pid: process.pid,
472
+ startToken: processStartToken(process.pid) ?? undefined,
473
+ });
474
+ writeRun({ id: "example.com-production-3" });
475
+ expect(registry.resolve("example.com").meta.id).to.equal("example.com-production-2");
476
+ });
477
+ it("should take the newest when a name matches only finished runs", () => {
478
+ writeRun({
479
+ id: "example.com-production-1",
480
+ startedAt: "2026-09-01T00:00:00.000Z",
481
+ });
482
+ writeRun({
483
+ id: "example.com-production-2",
484
+ startedAt: "2026-09-02T00:00:00.000Z",
485
+ });
486
+ // Nothing can be done to a finished run, so there is nothing to get wrong.
487
+ expect(registry.resolve("example.com").meta.id).to.equal("example.com-production-2");
488
+ });
489
+ it("should still refuse when a name matches several live runs", () => {
490
+ writeRun({
491
+ id: "example.com-production-1",
492
+ status: "running",
493
+ pid: process.pid,
494
+ startToken: processStartToken(process.pid) ?? undefined,
495
+ });
496
+ writeRun({
497
+ id: "example.com-production-2",
498
+ status: "running",
499
+ pid: process.pid,
500
+ startToken: processStartToken(process.pid) ?? undefined,
501
+ });
502
+ expect(() => registry.resolve("example.com")).to.throw(AmbiguousRunError);
503
+ });
504
+ it("should say so when there is nothing to resolve", () => {
505
+ expect(() => registry.resolve()).to.throw(NoSuchRunError);
506
+ expect(() => registry.resolve("nope")).to.throw(NoSuchRunError);
507
+ });
508
+ });
509
+ });
@@ -123,7 +123,7 @@ export const EDITORS = [
123
123
  id: "code",
124
124
  name: "Visual Studio Code",
125
125
  commands: ["code"],
126
- diffExecTemplate: '"$exec" --diff "$file1" "$file2"',
126
+ diffExecTemplate: '"$exec" --wait --diff "$file1" "$file2"',
127
127
  paths: {
128
128
  darwin: [
129
129
  "/Applications/Visual Studio Code.app/Contents/Resources/app/bin/code",
@@ -140,7 +140,7 @@ export const EDITORS = [
140
140
  id: "codium",
141
141
  name: "VSCodium",
142
142
  commands: ["codium"],
143
- diffExecTemplate: '"$exec" --diff "$file1" "$file2"',
143
+ diffExecTemplate: '"$exec" --wait --diff "$file1" "$file2"',
144
144
  paths: {
145
145
  darwin: [
146
146
  "/Applications/VSCodium.app/Contents/Resources/app/bin/codium",