@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,409 @@
1
+ import { existsSync, mkdirSync, readFileSync, readdirSync, statSync, rmSync, symlinkSync, unlinkSync, writeFileSync, } from "node:fs";
2
+ import { basename, join, resolve } from "node:path";
3
+ import { CURRENT_LINK, KEEP_BYTES, KEEP_FOR_MS, KEEP_NEWEST, META_FILE, RUNS_DIRECTORY, } from "./run-registry-model.js";
4
+ import { processStartToken, sameProcess } from "./process-identity.js";
5
+ /**
6
+ * Whether a pid is still ours to find.
7
+ *
8
+ * `kill(pid, 0)` sends no signal; it only asks whether the process exists.
9
+ * `EPERM` means it exists and belongs to someone else, which still counts as
10
+ * alive. The one thing this cannot see through is pid reuse — a recycled pid
11
+ * makes a dead run look live — but a run directory also carries the start time,
12
+ * so a reader with a reason to doubt has something to compare.
13
+ */
14
+ /** Recursive, because a run holds its cached bodies and read artifacts. */
15
+ function directorySize(directory) {
16
+ let total = 0;
17
+ try {
18
+ for (const entry of readdirSync(directory, { withFileTypes: true })) {
19
+ const path = join(directory, entry.name);
20
+ total += entry.isDirectory() ? directorySize(path) : statSync(path).size;
21
+ }
22
+ }
23
+ catch {
24
+ // a directory we cannot measure counts as nothing rather than failing
25
+ }
26
+ return total;
27
+ }
28
+ function isAlive(pid) {
29
+ try {
30
+ process.kill(pid, 0);
31
+ return true;
32
+ }
33
+ catch (error) {
34
+ return error.code === "EPERM";
35
+ }
36
+ }
37
+ /** Trades an ambiguous selector for the list the caller has to choose from. */
38
+ export class AmbiguousRunError extends Error {
39
+ candidates;
40
+ constructor(candidates) {
41
+ super(`Several runs match. Name one:\n${candidates
42
+ .map((run) => ` ${run.meta.id} (${run.status})`)
43
+ .join("\n")}`);
44
+ this.candidates = candidates;
45
+ }
46
+ }
47
+ export class NoSuchRunError extends Error {
48
+ constructor(selector) {
49
+ super(selector
50
+ ? `No run matches "${selector}".`
51
+ : "No onboarding run found. Start one with `sk onboarding <customerPath>`.");
52
+ }
53
+ }
54
+ /** A run this process owns, and can still write to. */
55
+ export class RunHandle {
56
+ dir;
57
+ meta;
58
+ onFinish;
59
+ constructor(dir, meta,
60
+ /** Lets the registry re-point `current` once this run is no longer it. */
61
+ onFinish) {
62
+ this.dir = dir;
63
+ this.meta = meta;
64
+ this.onFinish = onFinish;
65
+ }
66
+ get id() {
67
+ return this.meta.id;
68
+ }
69
+ /** Fill in what was not known at startup, e.g. the app once the config is read. */
70
+ update(patch) {
71
+ this.meta = { ...this.meta, ...patch };
72
+ this.write();
73
+ }
74
+ /**
75
+ * Stamp the outcome. Safe to call twice — the first call wins, so a `finally`
76
+ * that runs after `process.on("exit")` cannot overwrite a recorded failure
77
+ * with a cheerful one.
78
+ */
79
+ finish(status, error) {
80
+ if (this.meta.endedAt) {
81
+ return;
82
+ }
83
+ this.meta = {
84
+ ...this.meta,
85
+ status,
86
+ error: error ?? this.meta.error,
87
+ endedAt: new Date().toISOString(),
88
+ };
89
+ this.write();
90
+ this.onFinish?.(this);
91
+ }
92
+ write() {
93
+ // Synchronous on purpose: this also runs from `process.on("exit")`, where
94
+ // nothing asynchronous is allowed to finish.
95
+ writeFileSync(join(this.dir, META_FILE), `${JSON.stringify(this.meta, undefined, 2)}\n`);
96
+ }
97
+ }
98
+ /**
99
+ * Owns `<cacheDir>/runs/`: one directory per `sk onboarding` run, holding what
100
+ * that run was and — later — what it emitted.
101
+ *
102
+ * A file rather than a socket, because the interesting cases are
103
+ * disproportionately the ones where the process is gone. A directory outlives
104
+ * its run, so a crash stays explainable.
105
+ */
106
+ export class RunRegistry {
107
+ runsDirectory;
108
+ /** @param cacheDirectory oclif's cache dir, i.e. `environment.cacheDir`. */
109
+ constructor(cacheDirectory) {
110
+ this.runsDirectory = resolve(cacheDirectory, RUNS_DIRECTORY);
111
+ }
112
+ get directory() {
113
+ return this.runsDirectory;
114
+ }
115
+ /**
116
+ * Record a run that is starting, and prune old ones while we are here.
117
+ *
118
+ * The pid is part of the directory name, so concurrent runs of the same
119
+ * customer and config separate naturally.
120
+ */
121
+ start(input) {
122
+ const customer = basename(resolve(input.customerPath));
123
+ const meta = {
124
+ id: `${customer}-${input.configName}-${process.pid}`,
125
+ customer,
126
+ customerPath: input.customerPath,
127
+ customerDir: resolve(input.customerPath),
128
+ configName: input.configName,
129
+ domain: input.domain,
130
+ pid: process.pid,
131
+ startToken: processStartToken(process.pid) ?? undefined,
132
+ startedAt: new Date().toISOString(),
133
+ status: "running",
134
+ flags: input.flags,
135
+ debugPort: input.debugPort,
136
+ cliVersion: input.cliVersion,
137
+ buildTime: input.buildTime,
138
+ commit: input.commit,
139
+ logSchemaVersion: input.logSchemaVersion,
140
+ };
141
+ const dir = join(this.runsDirectory, meta.id);
142
+ mkdirSync(dir, { recursive: true });
143
+ writeFileSync(join(dir, META_FILE), `${JSON.stringify(meta, undefined, 2)}\n`);
144
+ // Not `pointCurrentAt(meta.id)`: starting a second run while one is live
145
+ // would hand `current` to the newest and quietly orphan the other. The
146
+ // meta file is on disk by now, so this sees the new run as live too.
147
+ this.repointCurrent();
148
+ this.prune();
149
+ return new RunHandle(dir, meta, () => this.repointCurrent());
150
+ }
151
+ /** Every run, newest first, with its status reconciled against the pid. */
152
+ list() {
153
+ if (!existsSync(this.runsDirectory)) {
154
+ return [];
155
+ }
156
+ const runs = [];
157
+ for (const entry of readdirSync(this.runsDirectory, {
158
+ withFileTypes: true,
159
+ })) {
160
+ if (entry.name === CURRENT_LINK || !entry.isDirectory()) {
161
+ continue;
162
+ }
163
+ const run = this.read(join(this.runsDirectory, entry.name));
164
+ if (run) {
165
+ runs.push(run);
166
+ }
167
+ }
168
+ return runs.sort((a, b) => b.meta.startedAt.localeCompare(a.meta.startedAt));
169
+ }
170
+ /**
171
+ * Live runs that would collide with one about to start.
172
+ *
173
+ * Both collisions are silent otherwise. A second run of the same customer
174
+ * path shares its config files, its `.local` scratch space and its browser
175
+ * profile, so the two fight over everything the first one is using. A second
176
+ * run on the same debug port is worse than silent: Chrome does not fail to
177
+ * start, it simply does not get the port, and one of them binds `127.0.0.1`
178
+ * while the other binds `[::1]` — so both survive and CDP reaches whichever
179
+ * resolves first. You can then spend a long time inspecting the wrong browser.
180
+ *
181
+ * Facts only. What to say and whether to stop is the command's business.
182
+ */
183
+ conflicts(intent) {
184
+ const wanted = resolve(intent.customerPath);
185
+ const live = this.list().filter((run) => run.live);
186
+ return {
187
+ // Resolved on both sides, so `customers/x`, `./customers/x` and
188
+ // `./customers/x/` are recognised as the one directory they are.
189
+ sameCustomer: live.filter((run) => resolve(run.meta.customerPath) === wanted),
190
+ samePort: intent.debugPort === undefined
191
+ ? []
192
+ : live.filter((run) => run.meta.debugPort === intent.debugPort),
193
+ };
194
+ }
195
+ /**
196
+ * Every run whose process is still alive, newest first.
197
+ *
198
+ * There is deliberately no `current()` that picks one of these. It used to
199
+ * exist, as `list().find(run => run.live)`, and it was the only thing in the
200
+ * registry that guessed: `resolve()` two methods down refuses a tie and names
201
+ * the candidates, while `current()` returned whichever run happened to be
202
+ * newest and said nothing about the other. Callers that need one run ask
203
+ * {@link resolve}; callers that can present several — or that must decide for
204
+ * themselves what a tie means — take the list.
205
+ */
206
+ liveRuns() {
207
+ return this.list().filter((run) => run.live);
208
+ }
209
+ /**
210
+ * Find the run a caller meant.
211
+ *
212
+ * Without a selector this is the current run — but only when there is exactly
213
+ * one. Several live runs and no selector is an error listing the candidates,
214
+ * never a guess: the operations this resolves for are not all reversible, and
215
+ * a wrong-session one cannot be taken back by reading more carefully.
216
+ */
217
+ resolve(selector) {
218
+ const runs = this.list();
219
+ if (selector) {
220
+ const match = this.matching(runs, selector);
221
+ if (match.length === 0) {
222
+ throw new NoSuchRunError(selector);
223
+ }
224
+ // A customer name matches every run they have ever had, so naming one
225
+ // would stop working the moment they had a second. Prefer the live run:
226
+ // it is the only one anything can be done to, and between finished runs
227
+ // there is nothing to get wrong, so the newest wins there.
228
+ const liveMatches = match.filter((run) => run.live);
229
+ if (liveMatches.length > 1) {
230
+ throw new AmbiguousRunError(liveMatches);
231
+ }
232
+ return liveMatches[0] ?? match[0];
233
+ }
234
+ const live = runs.filter((run) => run.live);
235
+ if (live.length > 1) {
236
+ throw new AmbiguousRunError(live);
237
+ }
238
+ if (live.length === 1) {
239
+ return live[0];
240
+ }
241
+ if (runs.length === 0) {
242
+ throw new NoSuchRunError();
243
+ }
244
+ return runs[0];
245
+ }
246
+ /**
247
+ * The runs a selector names: exactly, by id, customer or the path the run was
248
+ * started with — or, when nothing matches exactly, by the start of a customer
249
+ * name or id.
250
+ *
251
+ * The prefix is what people type. A customer directory is `hirmer-de`, and
252
+ * `--run hirmer` answering "no run matches" while `list` shows four hirmer
253
+ * runs reads as a broken registry. A prefix that reaches two customers is
254
+ * refused with one run of each named, never decided.
255
+ */
256
+ matching(runs, selector) {
257
+ const path = normalisePath(selector);
258
+ const exact = runs.filter((run) => run.meta.id === selector ||
259
+ run.meta.customer === selector ||
260
+ normalisePath(run.meta.customerPath) === path);
261
+ if (exact.length > 0) {
262
+ return exact;
263
+ }
264
+ const prefixed = runs.filter((run) => run.meta.customer.startsWith(selector) ||
265
+ run.meta.id.startsWith(selector));
266
+ const customers = new Map();
267
+ for (const run of prefixed) {
268
+ if (!customers.has(run.meta.customer)) {
269
+ customers.set(run.meta.customer, run);
270
+ }
271
+ }
272
+ if (customers.size > 1) {
273
+ throw new AmbiguousRunError([...customers.values()]);
274
+ }
275
+ return prefixed;
276
+ }
277
+ read(dir) {
278
+ const file = join(dir, META_FILE);
279
+ if (!existsSync(file)) {
280
+ return null;
281
+ }
282
+ let meta;
283
+ try {
284
+ meta = JSON.parse(readFileSync(file, "utf8"));
285
+ }
286
+ catch {
287
+ // A half-written meta.json is not worth failing a listing over.
288
+ return null;
289
+ }
290
+ if (meta.status !== "running") {
291
+ // Nothing to reconcile: the run said what became of it before it went.
292
+ return {
293
+ meta,
294
+ dir,
295
+ status: meta.status,
296
+ live: false,
297
+ liveVerified: true,
298
+ };
299
+ }
300
+ const running = isAlive(meta.pid);
301
+ const identity = running
302
+ ? sameProcess(meta.pid, meta.startToken)
303
+ : { same: false, verified: true };
304
+ const live = running && identity.same;
305
+ return {
306
+ meta,
307
+ dir,
308
+ status: live ? "running" : "crashed",
309
+ live,
310
+ liveVerified: identity.verified,
311
+ };
312
+ }
313
+ /**
314
+ * A `current` symlink next to the runs, so the newest one can be opened
315
+ * without listing first. Best-effort: Windows refuses symlinks without a
316
+ * privilege, and nothing here depends on it — {@link current} derives the
317
+ * answer from the listing.
318
+ */
319
+ pointCurrentAt(id) {
320
+ const link = join(this.runsDirectory, CURRENT_LINK);
321
+ try {
322
+ if (existsSync(link)) {
323
+ unlinkSync(link);
324
+ }
325
+ if (id) {
326
+ symlinkSync(id, link, "junction");
327
+ }
328
+ }
329
+ catch {
330
+ // no symlink, no problem
331
+ }
332
+ }
333
+ /**
334
+ * Hand `current` to whatever is still running, or remove it.
335
+ *
336
+ * Called when a run ends, because the alternative is a `current` that points
337
+ * at a finished run while a live one sits next to it. Someone reading
338
+ * `runs/current/meta.json` by hand would get a confident wrong answer, which
339
+ * is worse than getting none.
340
+ */
341
+ repointCurrent() {
342
+ const live = this.liveRuns();
343
+ // One live run gets the link; several get none. `current` can only name
344
+ // one directory, so with two live runs it would be pointing at an
345
+ // arbitrary one of them — the same confident wrong answer this method
346
+ // exists to prevent, just harder to notice because the link still resolves.
347
+ this.pointCurrentAt(live.length === 1 ? live[0].meta.id : null);
348
+ }
349
+ /**
350
+ * Keep the newest {@link KEEP_NEWEST} runs plus anything younger than
351
+ * {@link KEEP_FOR_MS}, within {@link KEEP_BYTES} overall, and never touch one
352
+ * that is still running.
353
+ *
354
+ * Public because it is worth doing at times other than starting a run — `sk
355
+ * mcp` calls it, so a machine that has stopped running onboarding still tidies
356
+ * up when something asks about the runs.
357
+ */
358
+ prune() {
359
+ const cutoff = Date.now() - KEEP_FOR_MS;
360
+ const runs = this.list();
361
+ const survivors = [];
362
+ for (const [index, run] of runs.entries()) {
363
+ if (run.live) {
364
+ survivors.push(run);
365
+ continue;
366
+ }
367
+ const young = Date.parse(run.meta.startedAt) >= cutoff;
368
+ if (index < KEEP_NEWEST || young) {
369
+ survivors.push(run);
370
+ continue;
371
+ }
372
+ this.remove(run);
373
+ }
374
+ this.enforceBudget(survivors);
375
+ }
376
+ /**
377
+ * Evict oldest-first until what is left fits the budget.
378
+ *
379
+ * Runs the count and age rules cannot bound: they count runs, and what grows
380
+ * is bytes. A live run is never evicted, however large — taking the cache out
381
+ * from under a running session would be worse than the disk it saves.
382
+ */
383
+ enforceBudget(runs) {
384
+ const sized = runs.map((run) => ({ run, bytes: directorySize(run.dir) }));
385
+ let total = sized.reduce((sum, entry) => sum + entry.bytes, 0);
386
+ for (const { run, bytes } of [...sized].reverse()) {
387
+ if (total <= KEEP_BYTES) {
388
+ return;
389
+ }
390
+ if (run.live) {
391
+ continue;
392
+ }
393
+ this.remove(run);
394
+ total -= bytes;
395
+ }
396
+ }
397
+ remove(run) {
398
+ try {
399
+ rmSync(run.dir, { recursive: true, force: true });
400
+ }
401
+ catch {
402
+ // a run we cannot delete is not a reason to fail the run we are starting
403
+ }
404
+ }
405
+ }
406
+ /** `./customers/x/` and `customers/x` are the same path as a selector. */
407
+ function normalisePath(path) {
408
+ return path.replace(/^\.\//, "").replace(/\/+$/, "");
409
+ }
@@ -0,0 +1,82 @@
1
+ import { expect } from "chai";
2
+ import { describe, it } from "mocha";
3
+ import { classifyExit } from "../exit-classification.js";
4
+ describe("classifyExit", () => {
5
+ it("should call a Ctrl+C a stop, and name the signal", () => {
6
+ expect(classifyExit({
7
+ stopping: true,
8
+ signal: "SIGINT",
9
+ runReturned: true,
10
+ code: 0,
11
+ })).to.deep.equal({ status: "stopped", error: "received SIGINT" });
12
+ });
13
+ it("should tell a Ctrl+C from a tmux kill", () => {
14
+ const sigint = classifyExit({
15
+ stopping: true,
16
+ signal: "SIGINT",
17
+ runReturned: false,
18
+ code: 130,
19
+ });
20
+ const sighup = classifyExit({
21
+ stopping: true,
22
+ signal: "SIGHUP",
23
+ runReturned: false,
24
+ code: 0,
25
+ });
26
+ // The whole point of recording the signal: these were indistinguishable.
27
+ expect(sigint.error).to.not.equal(sighup.error);
28
+ });
29
+ it("should still call it a stop when the teardown after it went wrong", () => {
30
+ // A non-zero code after a requested stop describes the exit path, not what
31
+ // happened — the run was stopped either way.
32
+ expect(classifyExit({
33
+ stopping: true,
34
+ signal: "SIGINT",
35
+ runReturned: false,
36
+ code: 1,
37
+ }).status).to.equal("stopped");
38
+ });
39
+ it("should not call a run that ended by itself anything else", () => {
40
+ expect(classifyExit({ stopping: false, runReturned: true, code: 0 })).to.deep.equal({ status: "finished" });
41
+ });
42
+ it("should not call a process that vanished mid-run finished", () => {
43
+ // This is the case that read as a clean finish: exit code 0, no signal, and
44
+ // the run still in flight. A zero code there means the event loop ran dry,
45
+ // which is what happens once the browser and every watcher have gone.
46
+ const outcome = classifyExit({
47
+ stopping: false,
48
+ runReturned: false,
49
+ code: 0,
50
+ });
51
+ expect(outcome.status).to.equal("stopped");
52
+ expect(outcome.error).to.equal("the process exited before the run finished");
53
+ });
54
+ it("should separate the two zero-code cases, which is the whole job", () => {
55
+ const byItself = classifyExit({
56
+ stopping: false,
57
+ runReturned: true,
58
+ code: 0,
59
+ });
60
+ const vanished = classifyExit({
61
+ stopping: false,
62
+ runReturned: false,
63
+ code: 0,
64
+ });
65
+ expect(byItself).to.not.deep.equal(vanished);
66
+ });
67
+ it("should report a non-zero exit as a failure, with the code", () => {
68
+ expect(classifyExit({ stopping: false, runReturned: true, code: 3 })).to.deep.equal({
69
+ status: "failed",
70
+ error: "process exited with code 3",
71
+ });
72
+ });
73
+ it("should say a non-zero exit cut the run short, when it did", () => {
74
+ expect(classifyExit({ stopping: false, runReturned: false, code: 3 }).error).to.contain("before the run finished");
75
+ });
76
+ it("should treat an unknown code as clean, for the path that has none", () => {
77
+ // The in-process path classifies without an exit code at all.
78
+ expect(classifyExit({ stopping: false, runReturned: true })).to.deep.equal({
79
+ status: "finished",
80
+ });
81
+ });
82
+ });