@speedkit/cli 4.51.0-run-control.5 → 4.51.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 (486) hide show
  1. package/CHANGELOG.md +37 -0
  2. package/README.md +14 -1426
  3. package/dist/commands/diff.d.ts +1 -7
  4. package/dist/commands/diff.js +3 -9
  5. package/dist/commands/login.d.ts +0 -3
  6. package/dist/commands/login.js +3 -14
  7. package/dist/commands/onboarding.d.ts +0 -26
  8. package/dist/commands/onboarding.js +4 -221
  9. package/dist/commands/origin-request.d.ts +0 -4
  10. package/dist/commands/origin-request.js +0 -4
  11. package/dist/services/browser-fetch/device-emulation.d.ts +0 -11
  12. package/dist/services/browser-fetch/device-emulation.js +0 -14
  13. package/dist/services/bundler/bundle-service-factory.d.ts +3 -0
  14. package/dist/services/bundler/bundle-service-factory.js +5 -1
  15. package/dist/services/bundler/bundle-service.d.ts +10 -1
  16. package/dist/services/bundler/bundle-service.js +16 -1
  17. package/dist/services/bundler/error/packjockel-error.d.ts +3 -0
  18. package/dist/services/bundler/error/packjockel-error.js +3 -0
  19. package/dist/services/bundler/index.d.ts +1 -0
  20. package/dist/services/bundler/index.js +1 -0
  21. package/dist/services/bundler/packjockel-service.d.ts +112 -0
  22. package/dist/services/bundler/packjockel-service.js +202 -0
  23. package/dist/services/bundler/spec/packjockel-service.spec.js +186 -0
  24. package/dist/services/cli/cli-environment-factory.d.ts +0 -3
  25. package/dist/services/cli/cli-environment-factory.js +0 -1
  26. package/dist/services/cli/cli-service-build-context.d.ts +0 -3
  27. package/dist/services/cli/cli-service-factory.js +1 -1
  28. package/dist/services/cli/cli-service-model.d.ts +10 -29
  29. package/dist/services/cli/cli-service.d.ts +11 -60
  30. package/dist/services/cli/cli-service.js +32 -196
  31. package/dist/services/cli/index.d.ts +0 -2
  32. package/dist/services/cli/index.js +0 -2
  33. package/dist/services/cli/spec/cli-service.spec.js +50 -113
  34. package/dist/services/deploy/checks/activation/customer-approval-check.js +1 -1
  35. package/dist/services/deploy/checks/pre-deploy/device-detection-changed-check.js +2 -3
  36. package/dist/services/deploy/checks/pre-deploy/split-change-check.js +2 -3
  37. package/dist/services/deploy/handler/customer-config-handler.d.ts +9 -0
  38. package/dist/services/deploy/handler/customer-config-handler.js +41 -6
  39. package/dist/services/deploy/interface/install.d.ts +7 -1
  40. package/dist/services/deploy/mr/live-state-check.js +21 -2
  41. package/dist/services/deploy/policy/auto-deploy-policy.js +2 -0
  42. package/dist/services/deploy/policy/deploy-policy-model.d.ts +4 -0
  43. package/dist/services/deploy/policy/deploy-policy-model.js +4 -0
  44. package/dist/services/deploy/policy/testing-deploy-policy.js +2 -0
  45. package/dist/services/deploy/spec/handler/customer-config-handler.spec.js +98 -0
  46. package/dist/services/deploy/spec/mr/live-state-check.spec.js +45 -4
  47. package/dist/services/deploy/spec/policy/auto-deploy-policy.spec.js +2 -0
  48. package/dist/services/deploy/spec/policy/testing-deploy-policy.spec.js +3 -1
  49. package/dist/services/diff/diff-service-build-context.d.ts +0 -12
  50. package/dist/services/diff/diff-service-build-context.js +1 -45
  51. package/dist/services/diff/diff-service-factory.d.ts +0 -2
  52. package/dist/services/diff/diff-service-factory.js +25 -65
  53. package/dist/services/diff/diff-service.d.ts +0 -11
  54. package/dist/services/diff/diff-service.js +11 -37
  55. package/dist/services/diff/page-source.d.ts +0 -12
  56. package/dist/services/diff/page-source.js +11 -16
  57. package/dist/services/diff/sinks/tool-diff-sink.d.ts +2 -3
  58. package/dist/services/diff/sinks/tool-diff-sink.js +2 -3
  59. package/dist/services/diff/spec/diff-service-build-context.spec.js +0 -19
  60. package/dist/services/diff/spec/diff-service.spec.js +0 -95
  61. package/dist/services/document-handler-runtime/document-handler-browser-mock.d.ts +13 -0
  62. package/dist/services/document-handler-runtime/document-handler-browser-mock.js +69 -0
  63. package/dist/services/document-handler-runtime/document-handler-server.d.ts +27 -0
  64. package/dist/services/document-handler-runtime/document-handler-server.js +112 -19
  65. package/dist/services/document-handler-runtime/spec/document-handler-browser-mock.spec.js +34 -0
  66. package/dist/services/git/git-repository.d.ts +0 -2
  67. package/dist/services/git/git-repository.js +0 -6
  68. package/dist/services/integration-api/customer-config-flags.js +0 -1
  69. package/dist/services/integration-api/integration-api-model.d.ts +4 -1
  70. package/dist/services/integration-api/spec/customer-config-file.spec.js +56 -0
  71. package/dist/services/integration-api/spec/speed-kit-config-file.spec.js +68 -8
  72. package/dist/services/integration-api/struct/customer-config-file.d.ts +15 -0
  73. package/dist/services/integration-api/struct/customer-config-file.js +42 -0
  74. package/dist/services/integration-api/struct/customer-config.d.ts +55 -1
  75. package/dist/services/integration-api/struct/customer-config.js +70 -3
  76. package/dist/services/integration-api/struct/speed-kit-config-file.d.ts +11 -4
  77. package/dist/services/integration-api/struct/speed-kit-config-file.js +31 -10
  78. package/dist/services/onboarding/browse/browse-service.d.ts +1 -13
  79. package/dist/services/onboarding/browse/browse-service.js +7 -43
  80. package/dist/services/onboarding/browser/baqend-response.d.ts +1 -17
  81. package/dist/services/onboarding/browser/baqend-response.js +0 -23
  82. package/dist/services/onboarding/browser/emulate-device.d.ts +1 -12
  83. package/dist/services/onboarding/browser/emulate-device.js +13 -68
  84. package/dist/services/onboarding/browser/executable/executable-validator.js +2 -4
  85. package/dist/services/onboarding/browser/extension/extension-bridge.js +3 -5
  86. package/dist/services/onboarding/browser/extension/extension-downloader.js +8 -17
  87. package/dist/services/onboarding/browser/extension/extension-validator.js +4 -9
  88. package/dist/services/onboarding/browser/launch-browser.d.ts +1 -2
  89. package/dist/services/onboarding/browser/launch-browser.js +1 -6
  90. package/dist/services/onboarding/config-renderer/speed-kit-install-context.d.ts +2 -0
  91. package/dist/services/onboarding/config-renderer/speed-kit-install-context.js +29 -8
  92. package/dist/services/onboarding/dashboard/diff-against-current-page.js +1 -3
  93. package/dist/services/onboarding/dashboard/index.js +2 -7
  94. package/dist/services/onboarding/fetch-event-handler.d.ts +5 -24
  95. package/dist/services/onboarding/fetch-event-handler.js +32 -103
  96. package/dist/services/onboarding/fetch-events/spec/speed-kit-install-js.spec.js +59 -0
  97. package/dist/services/onboarding/fetch-events/speed-kit-install-js.js +7 -14
  98. package/dist/services/onboarding/fetch-events/speed-kit-rum-pi-request.d.ts +0 -14
  99. package/dist/services/onboarding/fetch-events/speed-kit-rum-pi-request.js +0 -30
  100. package/dist/services/onboarding/fetch-events/speed-kit-service-worker-js.d.ts +3 -14
  101. package/dist/services/onboarding/fetch-events/speed-kit-service-worker-js.js +10 -29
  102. package/dist/services/onboarding/file-events/file-watcher.d.ts +4 -43
  103. package/dist/services/onboarding/file-events/file-watcher.js +21 -119
  104. package/dist/services/onboarding/inject/inject-service.js +1 -1
  105. package/dist/services/onboarding/onboarding-model.d.ts +7 -40
  106. package/dist/services/onboarding/onboarding-model.js +9 -20
  107. package/dist/services/onboarding/onboarding-service-build-context.d.ts +0 -4
  108. package/dist/services/onboarding/onboarding-service-build-context.js +1 -7
  109. package/dist/services/onboarding/onboarding-service-factory.d.ts +1 -17
  110. package/dist/services/onboarding/onboarding-service-factory.js +35 -152
  111. package/dist/services/onboarding/onboarding-service.d.ts +1 -40
  112. package/dist/services/onboarding/onboarding-service.js +23 -139
  113. package/dist/services/onboarding/request-cache/cache.d.ts +5 -62
  114. package/dist/services/onboarding/request-cache/cache.js +17 -128
  115. package/dist/services/onboarding/spec/file-events/file-watcher.spec.js +67 -0
  116. package/dist/services/onboarding/spec/onboarding-model.spec.js +3 -39
  117. package/dist/services/onboarding/spec/onboarding-service-factory.spec.js +1 -25
  118. package/dist/services/onboarding/templates/install-speed-kit-js-template.js +5 -0
  119. package/dist/services/onboarding/todo-collector.d.ts +2 -7
  120. package/dist/services/onboarding/todo-collector.js +12 -49
  121. package/dist/services/onboarding/virtual-orestes-app/index.d.ts +0 -38
  122. package/dist/services/onboarding/virtual-orestes-app/index.js +27 -113
  123. package/dist/services/origin-request/asset-variations.d.ts +0 -14
  124. package/dist/services/origin-request/asset-variations.js +4 -11
  125. package/dist/services/origin-request/origin-fetcher.d.ts +0 -7
  126. package/dist/services/origin-request/origin-fetcher.js +5 -43
  127. package/dist/services/origin-request/origin-request-service-build-context.d.ts +0 -17
  128. package/dist/services/origin-request/origin-request-service-build-context.js +0 -8
  129. package/dist/services/origin-request/origin-request-service-factory.d.ts +5 -0
  130. package/dist/services/origin-request/origin-request-service-factory.js +30 -2
  131. package/dist/services/origin-request/origin-request-service.d.ts +6 -121
  132. package/dist/services/origin-request/origin-request-service.js +49 -273
  133. package/dist/services/origin-request/runtime-config-source.d.ts +0 -6
  134. package/dist/services/origin-request/runtime-config-source.js +4 -15
  135. package/dist/services/origin-request/spec/asset-variations.spec.js +0 -20
  136. package/dist/services/origin-request/spec/origin-request-service.spec.js +6 -329
  137. package/dist/services/pull/pull-service.js +23 -5
  138. package/dist/services/query-builder/query-builder-factory.js +3 -3
  139. package/dist/services/setup/os/tool-registry.js +2 -2
  140. package/oclif.manifest.json +269 -3390
  141. package/package.json +3 -20
  142. package/dist/base/run-control-command.d.ts +0 -15
  143. package/dist/base/run-control-command.js +0 -20
  144. package/dist/build-info.json +0 -6
  145. package/dist/commands/onboarding/browser/click.d.ts +0 -75
  146. package/dist/commands/onboarding/browser/click.js +0 -19
  147. package/dist/commands/onboarding/browser/emulate.d.ts +0 -105
  148. package/dist/commands/onboarding/browser/emulate.js +0 -26
  149. package/dist/commands/onboarding/browser/navigate.d.ts +0 -75
  150. package/dist/commands/onboarding/browser/navigate.js +0 -19
  151. package/dist/commands/onboarding/browser/panel.d.ts +0 -63
  152. package/dist/commands/onboarding/browser/panel.js +0 -12
  153. package/dist/commands/onboarding/browser/reinstall-sw.d.ts +0 -63
  154. package/dist/commands/onboarding/browser/reinstall-sw.js +0 -14
  155. package/dist/commands/onboarding/browser/reset.d.ts +0 -71
  156. package/dist/commands/onboarding/browser/reset.js +0 -18
  157. package/dist/commands/onboarding/browser/screenshot.d.ts +0 -77
  158. package/dist/commands/onboarding/browser/screenshot.js +0 -19
  159. package/dist/commands/onboarding/browser/state.d.ts +0 -63
  160. package/dist/commands/onboarding/browser/state.js +0 -12
  161. package/dist/commands/onboarding/browser/tabs.d.ts +0 -58
  162. package/dist/commands/onboarding/browser/tabs.js +0 -16
  163. package/dist/commands/onboarding/cache/clear.d.ts +0 -58
  164. package/dist/commands/onboarding/cache/clear.js +0 -12
  165. package/dist/commands/onboarding/cache/errors.d.ts +0 -58
  166. package/dist/commands/onboarding/cache/errors.js +0 -12
  167. package/dist/commands/onboarding/cache/evict.d.ts +0 -62
  168. package/dist/commands/onboarding/cache/evict.js +0 -15
  169. package/dist/commands/onboarding/cache/get.d.ts +0 -85
  170. package/dist/commands/onboarding/cache/get.js +0 -17
  171. package/dist/commands/onboarding/cache/list.d.ts +0 -58
  172. package/dist/commands/onboarding/cache/list.js +0 -15
  173. package/dist/commands/onboarding/cache/prewarm.d.ts +0 -73
  174. package/dist/commands/onboarding/cache/prewarm.js +0 -20
  175. package/dist/commands/onboarding/cache/refresh.d.ts +0 -62
  176. package/dist/commands/onboarding/cache/refresh.js +0 -18
  177. package/dist/commands/onboarding/cdp.d.ts +0 -81
  178. package/dist/commands/onboarding/cdp.js +0 -18
  179. package/dist/commands/onboarding/debug/arm.d.ts +0 -83
  180. package/dist/commands/onboarding/debug/arm.js +0 -19
  181. package/dist/commands/onboarding/debug/await.d.ts +0 -71
  182. package/dist/commands/onboarding/debug/await.js +0 -18
  183. package/dist/commands/onboarding/debug/disarm.d.ts +0 -63
  184. package/dist/commands/onboarding/debug/disarm.js +0 -12
  185. package/dist/commands/onboarding/debug/eval.d.ts +0 -75
  186. package/dist/commands/onboarding/debug/eval.js +0 -16
  187. package/dist/commands/onboarding/debug/release.d.ts +0 -63
  188. package/dist/commands/onboarding/debug/release.js +0 -12
  189. package/dist/commands/onboarding/debug/resume.d.ts +0 -63
  190. package/dist/commands/onboarding/debug/resume.js +0 -12
  191. package/dist/commands/onboarding/debug/status.d.ts +0 -63
  192. package/dist/commands/onboarding/debug/status.js +0 -12
  193. package/dist/commands/onboarding/debug/step.d.ts +0 -67
  194. package/dist/commands/onboarding/debug/step.js +0 -15
  195. package/dist/commands/onboarding/files/list.d.ts +0 -58
  196. package/dist/commands/onboarding/files/list.js +0 -12
  197. package/dist/commands/onboarding/files/read.d.ts +0 -73
  198. package/dist/commands/onboarding/files/read.js +0 -16
  199. package/dist/commands/onboarding/files/rebuild.d.ts +0 -63
  200. package/dist/commands/onboarding/files/rebuild.js +0 -18
  201. package/dist/commands/onboarding/files/validate.d.ts +0 -58
  202. package/dist/commands/onboarding/files/validate.js +0 -12
  203. package/dist/commands/onboarding/fouc.d.ts +0 -77
  204. package/dist/commands/onboarding/fouc.js +0 -16
  205. package/dist/commands/onboarding/inject/add.d.ts +0 -89
  206. package/dist/commands/onboarding/inject/add.js +0 -17
  207. package/dist/commands/onboarding/inject/clear.d.ts +0 -63
  208. package/dist/commands/onboarding/inject/clear.js +0 -12
  209. package/dist/commands/onboarding/inject/list.d.ts +0 -63
  210. package/dist/commands/onboarding/inject/list.js +0 -12
  211. package/dist/commands/onboarding/inject/read.d.ts +0 -75
  212. package/dist/commands/onboarding/inject/read.js +0 -18
  213. package/dist/commands/onboarding/inject/recipes.d.ts +0 -63
  214. package/dist/commands/onboarding/inject/recipes.js +0 -12
  215. package/dist/commands/onboarding/inject/remove.d.ts +0 -67
  216. package/dist/commands/onboarding/inject/remove.js +0 -15
  217. package/dist/commands/onboarding/list.d.ts +0 -13
  218. package/dist/commands/onboarding/list.js +0 -12
  219. package/dist/commands/onboarding/logs.d.ts +0 -41
  220. package/dist/commands/onboarding/logs.js +0 -257
  221. package/dist/commands/onboarding/navwalk.d.ts +0 -95
  222. package/dist/commands/onboarding/navwalk.js +0 -19
  223. package/dist/commands/onboarding/response.d.ts +0 -67
  224. package/dist/commands/onboarding/response.js +0 -18
  225. package/dist/commands/onboarding/rum/beacons.d.ts +0 -75
  226. package/dist/commands/onboarding/rum/beacons.js +0 -16
  227. package/dist/commands/onboarding/rum/get.d.ts +0 -77
  228. package/dist/commands/onboarding/rum/get.js +0 -18
  229. package/dist/commands/onboarding/rum/key.d.ts +0 -67
  230. package/dist/commands/onboarding/rum/key.js +0 -13
  231. package/dist/commands/onboarding/rum/previous.d.ts +0 -63
  232. package/dist/commands/onboarding/rum/previous.js +0 -12
  233. package/dist/commands/onboarding/status.d.ts +0 -13
  234. package/dist/commands/onboarding/status.js +0 -17
  235. package/dist/commands/onboarding/stop.d.ts +0 -13
  236. package/dist/commands/onboarding/stop.js +0 -17
  237. package/dist/commands/onboarding/todo.d.ts +0 -58
  238. package/dist/commands/onboarding/todo.js +0 -12
  239. package/dist/commands/onboarding/viewport.d.ts +0 -101
  240. package/dist/commands/onboarding/viewport.js +0 -18
  241. package/dist/commands/onboarding/watch.d.ts +0 -93
  242. package/dist/commands/onboarding/watch.js +0 -16
  243. package/dist/commands/spec/onboarding.spec.js +0 -127
  244. package/dist/services/cli/build-info.d.ts +0 -33
  245. package/dist/services/cli/build-info.js +0 -63
  246. package/dist/services/cli/sink.d.ts +0 -47
  247. package/dist/services/cli/sink.js +0 -31
  248. package/dist/services/cli/spec/build-identity.spec.js +0 -85
  249. package/dist/services/cli/spec/build-info.spec.js +0 -10
  250. package/dist/services/cli/spec/cli-service-log.spec.js +0 -133
  251. package/dist/services/cli/spec/memory-cli.d.ts +0 -9
  252. package/dist/services/cli/spec/memory-cli.js +0 -9
  253. package/dist/services/diff/config-at-ref.d.ts +0 -20
  254. package/dist/services/diff/config-at-ref.js +0 -33
  255. package/dist/services/diff/run-runtime-config.d.ts +0 -33
  256. package/dist/services/diff/run-runtime-config.js +0 -74
  257. package/dist/services/diff/spec/config-at-ref.spec.js +0 -46
  258. package/dist/services/diff/spec/run-runtime-config.spec.js +0 -87
  259. package/dist/services/onboarding/browser/answer-dialogs.d.ts +0 -12
  260. package/dist/services/onboarding/browser/answer-dialogs.js +0 -25
  261. package/dist/services/onboarding/browser/console-log.d.ts +0 -9
  262. package/dist/services/onboarding/browser/console-log.js +0 -27
  263. package/dist/services/onboarding/browser/resume-restarted-workers.d.ts +0 -14
  264. package/dist/services/onboarding/browser/resume-restarted-workers.js +0 -26
  265. package/dist/services/onboarding/control/body-inspect.d.ts +0 -24
  266. package/dist/services/onboarding/control/body-inspect.js +0 -106
  267. package/dist/services/onboarding/control/browser-session.d.ts +0 -547
  268. package/dist/services/onboarding/control/browser-session.js +0 -1337
  269. package/dist/services/onboarding/control/config-validation.d.ts +0 -17
  270. package/dist/services/onboarding/control/config-validation.js +0 -46
  271. package/dist/services/onboarding/control/control-protocol.d.ts +0 -1430
  272. package/dist/services/onboarding/control/control-protocol.js +0 -58
  273. package/dist/services/onboarding/control/control-server.d.ts +0 -292
  274. package/dist/services/onboarding/control/control-server.js +0 -1629
  275. package/dist/services/onboarding/control/debug-session.d.ts +0 -219
  276. package/dist/services/onboarding/control/debug-session.js +0 -897
  277. package/dist/services/onboarding/control/fouc.d.ts +0 -23
  278. package/dist/services/onboarding/control/fouc.js +0 -151
  279. package/dist/services/onboarding/control/index.d.ts +0 -4
  280. package/dist/services/onboarding/control/index.js +0 -4
  281. package/dist/services/onboarding/control/navigate-wait.d.ts +0 -33
  282. package/dist/services/onboarding/control/navigate-wait.js +0 -56
  283. package/dist/services/onboarding/control/navwalk.d.ts +0 -65
  284. package/dist/services/onboarding/control/navwalk.js +0 -248
  285. package/dist/services/onboarding/control/preload-registry.d.ts +0 -150
  286. package/dist/services/onboarding/control/preload-registry.js +0 -829
  287. package/dist/services/onboarding/control/response-explainer.d.ts +0 -24
  288. package/dist/services/onboarding/control/response-explainer.js +0 -257
  289. package/dist/services/onboarding/control/rum.d.ts +0 -8
  290. package/dist/services/onboarding/control/rum.js +0 -220
  291. package/dist/services/onboarding/control/service-worker-tracker.d.ts +0 -68
  292. package/dist/services/onboarding/control/service-worker-tracker.js +0 -120
  293. package/dist/services/onboarding/control/viewport.d.ts +0 -45
  294. package/dist/services/onboarding/control/viewport.js +0 -344
  295. package/dist/services/onboarding/control/watch.d.ts +0 -26
  296. package/dist/services/onboarding/control/watch.js +0 -157
  297. package/dist/services/onboarding/request-cache/asset-key.d.ts +0 -61
  298. package/dist/services/onboarding/request-cache/asset-key.js +0 -115
  299. package/dist/services/onboarding/spec/browser/answer-dialogs.spec.d.ts +0 -1
  300. package/dist/services/onboarding/spec/browser/answer-dialogs.spec.js +0 -66
  301. package/dist/services/onboarding/spec/browser/console-log.spec.d.ts +0 -1
  302. package/dist/services/onboarding/spec/browser/console-log.spec.js +0 -42
  303. package/dist/services/onboarding/spec/browser/resume-restarted-workers.spec.d.ts +0 -1
  304. package/dist/services/onboarding/spec/browser/resume-restarted-workers.spec.js +0 -45
  305. package/dist/services/onboarding/spec/control/browser-session.spec.d.ts +0 -1
  306. package/dist/services/onboarding/spec/control/browser-session.spec.js +0 -753
  307. package/dist/services/onboarding/spec/control/control-server.spec.d.ts +0 -1
  308. package/dist/services/onboarding/spec/control/control-server.spec.js +0 -371
  309. package/dist/services/onboarding/spec/control/debug-session.spec.d.ts +0 -1
  310. package/dist/services/onboarding/spec/control/debug-session.spec.js +0 -751
  311. package/dist/services/onboarding/spec/control/fakes.d.ts +0 -31
  312. package/dist/services/onboarding/spec/control/fakes.js +0 -67
  313. package/dist/services/onboarding/spec/control/fouc.spec.d.ts +0 -1
  314. package/dist/services/onboarding/spec/control/fouc.spec.js +0 -167
  315. package/dist/services/onboarding/spec/control/navigate-wait.spec.d.ts +0 -1
  316. package/dist/services/onboarding/spec/control/navigate-wait.spec.js +0 -47
  317. package/dist/services/onboarding/spec/control/navwalk.spec.d.ts +0 -1
  318. package/dist/services/onboarding/spec/control/navwalk.spec.js +0 -222
  319. package/dist/services/onboarding/spec/control/preload-registry.spec.d.ts +0 -1
  320. package/dist/services/onboarding/spec/control/preload-registry.spec.js +0 -432
  321. package/dist/services/onboarding/spec/control/response-explainer.spec.d.ts +0 -1
  322. package/dist/services/onboarding/spec/control/response-explainer.spec.js +0 -324
  323. package/dist/services/onboarding/spec/control/rum.spec.d.ts +0 -1
  324. package/dist/services/onboarding/spec/control/rum.spec.js +0 -222
  325. package/dist/services/onboarding/spec/control/service-worker-tracker.spec.d.ts +0 -1
  326. package/dist/services/onboarding/spec/control/service-worker-tracker.spec.js +0 -193
  327. package/dist/services/onboarding/spec/control/viewport.spec.d.ts +0 -1
  328. package/dist/services/onboarding/spec/control/viewport.spec.js +0 -200
  329. package/dist/services/onboarding/spec/control/watch.spec.d.ts +0 -1
  330. package/dist/services/onboarding/spec/control/watch.spec.js +0 -187
  331. package/dist/services/onboarding/spec/fetch-event-handler.spec.d.ts +0 -1
  332. package/dist/services/onboarding/spec/fetch-event-handler.spec.js +0 -219
  333. package/dist/services/onboarding/spec/fetch-events/speed-kit-service-worker-js.spec.d.ts +0 -1
  334. package/dist/services/onboarding/spec/fetch-events/speed-kit-service-worker-js.spec.js +0 -41
  335. package/dist/services/onboarding/spec/request-cache/cache.spec.d.ts +0 -1
  336. package/dist/services/onboarding/spec/request-cache/cache.spec.js +0 -107
  337. package/dist/services/onboarding/spec/todo-collector.spec.d.ts +0 -1
  338. package/dist/services/onboarding/spec/todo-collector.spec.js +0 -136
  339. package/dist/services/onboarding/spec/virtual-orestes-app/virtual-orestes-app.spec.d.ts +0 -1
  340. package/dist/services/onboarding/spec/virtual-orestes-app/virtual-orestes-app.spec.js +0 -65
  341. package/dist/services/query-builder/rules/rule-match.d.ts +0 -35
  342. package/dist/services/query-builder/rules/rule-match.js +0 -70
  343. package/dist/services/query-builder/spec/rules/rule-match.spec.d.ts +0 -1
  344. package/dist/services/query-builder/spec/rules/rule-match.spec.js +0 -121
  345. package/dist/services/run-control/browser/run-browser-contexts.d.ts +0 -557
  346. package/dist/services/run-control/browser/run-browser-contexts.js +0 -91
  347. package/dist/services/run-control/browser/run-browser-service-factory.d.ts +0 -5
  348. package/dist/services/run-control/browser/run-browser-service-factory.js +0 -7
  349. package/dist/services/run-control/browser/run-browser-service.d.ts +0 -68
  350. package/dist/services/run-control/browser/run-browser-service.js +0 -206
  351. package/dist/services/run-control/cache/run-cache-contexts.d.ts +0 -349
  352. package/dist/services/run-control/cache/run-cache-contexts.js +0 -51
  353. package/dist/services/run-control/cache/run-cache-service-factory.d.ts +0 -6
  354. package/dist/services/run-control/cache/run-cache-service-factory.js +0 -12
  355. package/dist/services/run-control/cache/run-cache-service.d.ts +0 -35
  356. package/dist/services/run-control/cache/run-cache-service.js +0 -151
  357. package/dist/services/run-control/control-client.d.ts +0 -36
  358. package/dist/services/run-control/control-client.js +0 -147
  359. package/dist/services/run-control/debug/run-debug-contexts.d.ts +0 -416
  360. package/dist/services/run-control/debug/run-debug-contexts.js +0 -47
  361. package/dist/services/run-control/debug/run-debug-service-factory.d.ts +0 -5
  362. package/dist/services/run-control/debug/run-debug-service-factory.js +0 -7
  363. package/dist/services/run-control/debug/run-debug-service.d.ts +0 -39
  364. package/dist/services/run-control/debug/run-debug-service.js +0 -164
  365. package/dist/services/run-control/files/run-files-contexts.d.ts +0 -238
  366. package/dist/services/run-control/files/run-files-contexts.js +0 -26
  367. package/dist/services/run-control/files/run-files-service-factory.d.ts +0 -5
  368. package/dist/services/run-control/files/run-files-service-factory.js +0 -7
  369. package/dist/services/run-control/files/run-files-service.d.ts +0 -29
  370. package/dist/services/run-control/files/run-files-service.js +0 -120
  371. package/dist/services/run-control/index.d.ts +0 -32
  372. package/dist/services/run-control/index.js +0 -31
  373. package/dist/services/run-control/inject/run-inject-contexts.d.ts +0 -319
  374. package/dist/services/run-control/inject/run-inject-contexts.js +0 -38
  375. package/dist/services/run-control/inject/run-inject-service-factory.d.ts +0 -5
  376. package/dist/services/run-control/inject/run-inject-service-factory.js +0 -7
  377. package/dist/services/run-control/inject/run-inject-service.d.ts +0 -31
  378. package/dist/services/run-control/inject/run-inject-service.js +0 -227
  379. package/dist/services/run-control/live-run.d.ts +0 -37
  380. package/dist/services/run-control/live-run.js +0 -56
  381. package/dist/services/run-control/probe/run-probe-contexts.d.ts +0 -333
  382. package/dist/services/run-control/probe/run-probe-contexts.js +0 -73
  383. package/dist/services/run-control/probe/run-probe-service-factory.d.ts +0 -5
  384. package/dist/services/run-control/probe/run-probe-service-factory.js +0 -7
  385. package/dist/services/run-control/probe/run-probe-service.d.ts +0 -54
  386. package/dist/services/run-control/probe/run-probe-service.js +0 -194
  387. package/dist/services/run-control/rum/run-rum-contexts.d.ts +0 -216
  388. package/dist/services/run-control/rum/run-rum-contexts.js +0 -34
  389. package/dist/services/run-control/rum/run-rum-service-factory.d.ts +0 -5
  390. package/dist/services/run-control/rum/run-rum-service-factory.js +0 -7
  391. package/dist/services/run-control/rum/run-rum-service.d.ts +0 -36
  392. package/dist/services/run-control/rum/run-rum-service.js +0 -122
  393. package/dist/services/run-control/run-answer.d.ts +0 -28
  394. package/dist/services/run-control/run-answer.js +0 -58
  395. package/dist/services/run-control/run-control-context.d.ts +0 -102
  396. package/dist/services/run-control/run-control-context.js +0 -36
  397. package/dist/services/run-control/run-control-flags.d.ts +0 -12
  398. package/dist/services/run-control/run-control-flags.js +0 -22
  399. package/dist/services/run-control/run-control-model.d.ts +0 -9
  400. package/dist/services/run-control/run-control-model.js +0 -1
  401. package/dist/services/run-control/run-control-service-factory.d.ts +0 -14
  402. package/dist/services/run-control/run-control-service-factory.js +0 -26
  403. package/dist/services/run-control/session/run-session-contexts.d.ts +0 -25
  404. package/dist/services/run-control/session/run-session-contexts.js +0 -20
  405. package/dist/services/run-control/session/run-session-service-factory.d.ts +0 -8
  406. package/dist/services/run-control/session/run-session-service-factory.js +0 -18
  407. package/dist/services/run-control/session/run-session-service.d.ts +0 -32
  408. package/dist/services/run-control/session/run-session-service.js +0 -151
  409. package/dist/services/run-control/spec/browser/run-browser-service.spec.d.ts +0 -1
  410. package/dist/services/run-control/spec/browser/run-browser-service.spec.js +0 -328
  411. package/dist/services/run-control/spec/cache/run-cache-service.spec.d.ts +0 -1
  412. package/dist/services/run-control/spec/cache/run-cache-service.spec.js +0 -454
  413. package/dist/services/run-control/spec/debug/run-debug-service.spec.d.ts +0 -1
  414. package/dist/services/run-control/spec/debug/run-debug-service.spec.js +0 -113
  415. package/dist/services/run-control/spec/files/run-files-service.spec.d.ts +0 -1
  416. package/dist/services/run-control/spec/files/run-files-service.spec.js +0 -234
  417. package/dist/services/run-control/spec/inject/run-inject-service.spec.d.ts +0 -1
  418. package/dist/services/run-control/spec/inject/run-inject-service.spec.js +0 -251
  419. package/dist/services/run-control/spec/live-run-fixture.d.ts +0 -32
  420. package/dist/services/run-control/spec/live-run-fixture.js +0 -109
  421. package/dist/services/run-control/spec/probe/run-probe-service.spec.d.ts +0 -1
  422. package/dist/services/run-control/spec/probe/run-probe-service.spec.js +0 -108
  423. package/dist/services/run-control/spec/rum/run-rum-service.spec.d.ts +0 -1
  424. package/dist/services/run-control/spec/rum/run-rum-service.spec.js +0 -47
  425. package/dist/services/run-control/spec/run-answer.spec.d.ts +0 -1
  426. package/dist/services/run-control/spec/run-answer.spec.js +0 -57
  427. package/dist/services/run-control/spec/session/run-session-service.spec.d.ts +0 -1
  428. package/dist/services/run-control/spec/session/run-session-service.spec.js +0 -150
  429. package/dist/services/run-log/crash-mirror.d.ts +0 -31
  430. package/dist/services/run-log/crash-mirror.js +0 -69
  431. package/dist/services/run-log/index.d.ts +0 -11
  432. package/dist/services/run-log/index.js +0 -11
  433. package/dist/services/run-log/jsonl-appender.d.ts +0 -46
  434. package/dist/services/run-log/jsonl-appender.js +0 -91
  435. package/dist/services/run-log/log-event-model.d.ts +0 -104
  436. package/dist/services/run-log/log-event-model.js +0 -56
  437. package/dist/services/run-log/log-query-service-factory.d.ts +0 -11
  438. package/dist/services/run-log/log-query-service-factory.js +0 -14
  439. package/dist/services/run-log/log-query-service.d.ts +0 -59
  440. package/dist/services/run-log/log-query-service.js +0 -111
  441. package/dist/services/run-log/log-reader.d.ts +0 -84
  442. package/dist/services/run-log/log-reader.js +0 -180
  443. package/dist/services/run-log/log-summary.d.ts +0 -72
  444. package/dist/services/run-log/log-summary.js +0 -208
  445. package/dist/services/run-log/redaction.d.ts +0 -34
  446. package/dist/services/run-log/redaction.js +0 -124
  447. package/dist/services/run-log/request-log.d.ts +0 -82
  448. package/dist/services/run-log/request-log.js +0 -69
  449. package/dist/services/run-log/request-summary.d.ts +0 -76
  450. package/dist/services/run-log/request-summary.js +0 -0
  451. package/dist/services/run-log/run-log.d.ts +0 -61
  452. package/dist/services/run-log/run-log.js +0 -102
  453. package/dist/services/run-log/spec/log-query-service.spec.d.ts +0 -1
  454. package/dist/services/run-log/spec/log-query-service.spec.js +0 -197
  455. package/dist/services/run-log/spec/log-reader.spec.d.ts +0 -1
  456. package/dist/services/run-log/spec/log-reader.spec.js +0 -109
  457. package/dist/services/run-log/spec/log-summary.spec.d.ts +0 -1
  458. package/dist/services/run-log/spec/log-summary.spec.js +0 -153
  459. package/dist/services/run-log/spec/redaction.spec.d.ts +0 -1
  460. package/dist/services/run-log/spec/redaction.spec.js +0 -61
  461. package/dist/services/run-log/spec/request-log.spec.d.ts +0 -1
  462. package/dist/services/run-log/spec/request-log.spec.js +0 -101
  463. package/dist/services/run-log/spec/request-summary.spec.d.ts +0 -1
  464. package/dist/services/run-log/spec/request-summary.spec.js +0 -171
  465. package/dist/services/run-log/spec/run-log.spec.d.ts +0 -1
  466. package/dist/services/run-log/spec/run-log.spec.js +0 -122
  467. package/dist/services/run-registry/exit-classification.d.ts +0 -39
  468. package/dist/services/run-registry/exit-classification.js +0 -42
  469. package/dist/services/run-registry/index.d.ts +0 -3
  470. package/dist/services/run-registry/index.js +0 -3
  471. package/dist/services/run-registry/process-identity.d.ts +0 -28
  472. package/dist/services/run-registry/process-identity.js +0 -80
  473. package/dist/services/run-registry/run-registry-model.d.ts +0 -128
  474. package/dist/services/run-registry/run-registry-model.js +0 -16
  475. package/dist/services/run-registry/run-registry.d.ts +0 -155
  476. package/dist/services/run-registry/run-registry.js +0 -430
  477. package/dist/services/run-registry/spec/exit-classification.spec.d.ts +0 -1
  478. package/dist/services/run-registry/spec/exit-classification.spec.js +0 -82
  479. package/dist/services/run-registry/spec/run-registry.spec.d.ts +0 -1
  480. package/dist/services/run-registry/spec/run-registry.spec.js +0 -526
  481. /package/dist/{commands/spec/onboarding.spec.d.ts → services/bundler/spec/packjockel-service.spec.d.ts} +0 -0
  482. /package/dist/services/{cli/spec/build-identity.spec.d.ts → deploy/spec/handler/customer-config-handler.spec.d.ts} +0 -0
  483. /package/dist/services/{cli/spec/build-info.spec.d.ts → document-handler-runtime/spec/document-handler-browser-mock.spec.d.ts} +0 -0
  484. /package/dist/services/{cli/spec/cli-service-log.spec.d.ts → integration-api/spec/customer-config-file.spec.d.ts} +0 -0
  485. /package/dist/services/{diff/spec/config-at-ref.spec.d.ts → onboarding/fetch-events/spec/speed-kit-install-js.spec.d.ts} +0 -0
  486. /package/dist/services/{diff/spec/run-runtime-config.spec.d.ts → onboarding/spec/file-events/file-watcher.spec.d.ts} +0 -0
@@ -1,430 +0,0 @@
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
- // A browse run without a customer directory is named after the host it browses.
123
- const customer = input.customerPath
124
- ? basename(resolve(input.customerPath))
125
- : hostOf(input.domain);
126
- const meta = {
127
- id: `${customer}-${input.configName}-${process.pid}`,
128
- customer,
129
- customerPath: input.customerPath ?? "",
130
- customerDir: input.customerPath ? resolve(input.customerPath) : undefined,
131
- configName: input.configName,
132
- domain: input.domain,
133
- pid: process.pid,
134
- startToken: processStartToken(process.pid) ?? undefined,
135
- startedAt: new Date().toISOString(),
136
- status: "running",
137
- flags: input.flags,
138
- debugPort: input.debugPort,
139
- cliVersion: input.cliVersion,
140
- buildTime: input.buildTime,
141
- commit: input.commit,
142
- logSchemaVersion: input.logSchemaVersion,
143
- };
144
- const dir = join(this.runsDirectory, meta.id);
145
- mkdirSync(dir, { recursive: true });
146
- writeFileSync(join(dir, META_FILE), `${JSON.stringify(meta, undefined, 2)}\n`);
147
- // Not `pointCurrentAt(meta.id)`: starting a second run while one is live
148
- // would hand `current` to the newest and quietly orphan the other. The
149
- // meta file is on disk by now, so this sees the new run as live too.
150
- this.repointCurrent();
151
- this.prune();
152
- return new RunHandle(dir, meta, () => this.repointCurrent());
153
- }
154
- /** Every run, newest first, with its status reconciled against the pid. */
155
- list() {
156
- if (!existsSync(this.runsDirectory)) {
157
- return [];
158
- }
159
- const runs = [];
160
- for (const entry of readdirSync(this.runsDirectory, {
161
- withFileTypes: true,
162
- })) {
163
- if (entry.name === CURRENT_LINK || !entry.isDirectory()) {
164
- continue;
165
- }
166
- const run = this.read(join(this.runsDirectory, entry.name));
167
- if (run) {
168
- runs.push(run);
169
- }
170
- }
171
- return runs.sort((a, b) => b.meta.startedAt.localeCompare(a.meta.startedAt));
172
- }
173
- /**
174
- * Live runs that would collide with one about to start.
175
- *
176
- * Both collisions are silent otherwise. A second run of the same customer
177
- * path shares its config files, its `.local` scratch space and its browser
178
- * profile, so the two fight over everything the first one is using. A second
179
- * run on the same debug port is worse than silent: Chrome does not fail to
180
- * start, it simply does not get the port, and one of them binds `127.0.0.1`
181
- * while the other binds `[::1]` — so both survive and CDP reaches whichever
182
- * resolves first. You can then spend a long time inspecting the wrong browser.
183
- *
184
- * Facts only. What to say and whether to stop is the command's business.
185
- */
186
- conflicts(intent) {
187
- const wanted = intent.customerPath && resolve(intent.customerPath);
188
- const live = this.list().filter((run) => run.live);
189
- return {
190
- // Resolved on both sides, so `customers/x`, `./customers/x` and
191
- // `./customers/x/` are recognised as the one directory they are.
192
- sameCustomer: wanted
193
- ? live.filter((run) => run.meta.customerPath &&
194
- resolve(run.meta.customerPath) === wanted)
195
- : [],
196
- samePort: intent.debugPort === undefined
197
- ? []
198
- : live.filter((run) => run.meta.debugPort === intent.debugPort),
199
- };
200
- }
201
- /**
202
- * Whether the process that recorded the run still exists. Unlike `live`, this
203
- * stays true while a stopped run shuts its browser down.
204
- */
205
- processAlive(run) {
206
- return (isAlive(run.meta.pid) &&
207
- sameProcess(run.meta.pid, run.meta.startToken).same);
208
- }
209
- /**
210
- * Every run whose process is still alive, newest first.
211
- *
212
- * There is deliberately no `current()` that picks one of these. It used to
213
- * exist, as `list().find(run => run.live)`, and it was the only thing in the
214
- * registry that guessed: `resolve()` two methods down refuses a tie and names
215
- * the candidates, while `current()` returned whichever run happened to be
216
- * newest and said nothing about the other. Callers that need one run ask
217
- * {@link resolve}; callers that can present several — or that must decide for
218
- * themselves what a tie means — take the list.
219
- */
220
- liveRuns() {
221
- return this.list().filter((run) => run.live);
222
- }
223
- /**
224
- * Find the run a caller meant.
225
- *
226
- * Without a selector this is the current run — but only when there is exactly
227
- * one. Several live runs and no selector is an error listing the candidates,
228
- * never a guess: the operations this resolves for are not all reversible, and
229
- * a wrong-session one cannot be taken back by reading more carefully.
230
- */
231
- resolve(selector) {
232
- const runs = this.list();
233
- if (selector) {
234
- const match = this.matching(runs, selector);
235
- if (match.length === 0) {
236
- throw new NoSuchRunError(selector);
237
- }
238
- // A customer name matches every run they have ever had, so naming one
239
- // would stop working the moment they had a second. Prefer the live run:
240
- // it is the only one anything can be done to, and between finished runs
241
- // there is nothing to get wrong, so the newest wins there.
242
- const liveMatches = match.filter((run) => run.live);
243
- if (liveMatches.length > 1) {
244
- throw new AmbiguousRunError(liveMatches);
245
- }
246
- return liveMatches[0] ?? match[0];
247
- }
248
- const live = runs.filter((run) => run.live);
249
- if (live.length > 1) {
250
- throw new AmbiguousRunError(live);
251
- }
252
- if (live.length === 1) {
253
- return live[0];
254
- }
255
- if (runs.length === 0) {
256
- throw new NoSuchRunError();
257
- }
258
- return runs[0];
259
- }
260
- /**
261
- * The runs a selector names: exactly, by id, customer or the path the run was
262
- * started with — or, when nothing matches exactly, by the start of a customer
263
- * name or id.
264
- *
265
- * The prefix is what people type. A customer directory is `hirmer-de`, and
266
- * `--run hirmer` answering "no run matches" while `list` shows four hirmer
267
- * runs reads as a broken registry. A prefix that reaches two customers is
268
- * refused with one run of each named, never decided.
269
- */
270
- matching(runs, selector) {
271
- const path = normalisePath(selector);
272
- const exact = runs.filter((run) => run.meta.id === selector ||
273
- run.meta.customer === selector ||
274
- normalisePath(run.meta.customerPath) === path);
275
- if (exact.length > 0) {
276
- return exact;
277
- }
278
- const prefixed = runs.filter((run) => run.meta.customer.startsWith(selector) ||
279
- run.meta.id.startsWith(selector));
280
- const customers = new Map();
281
- for (const run of prefixed) {
282
- if (!customers.has(run.meta.customer)) {
283
- customers.set(run.meta.customer, run);
284
- }
285
- }
286
- if (customers.size > 1) {
287
- throw new AmbiguousRunError([...customers.values()]);
288
- }
289
- return prefixed;
290
- }
291
- read(dir) {
292
- const file = join(dir, META_FILE);
293
- if (!existsSync(file)) {
294
- return null;
295
- }
296
- let meta;
297
- try {
298
- meta = JSON.parse(readFileSync(file, "utf8"));
299
- }
300
- catch {
301
- // A half-written meta.json is not worth failing a listing over.
302
- return null;
303
- }
304
- if (meta.status !== "running") {
305
- // Nothing to reconcile: the run said what became of it before it went.
306
- return {
307
- meta,
308
- dir,
309
- status: meta.status,
310
- live: false,
311
- liveVerified: true,
312
- };
313
- }
314
- const running = isAlive(meta.pid);
315
- const identity = running
316
- ? sameProcess(meta.pid, meta.startToken)
317
- : { same: false, verified: true };
318
- const live = running && identity.same;
319
- return {
320
- meta,
321
- dir,
322
- status: live ? "running" : "crashed",
323
- live,
324
- liveVerified: identity.verified,
325
- };
326
- }
327
- /**
328
- * A `current` symlink next to the runs, so the newest one can be opened
329
- * without listing first. Best-effort: Windows refuses symlinks without a
330
- * privilege, and nothing here depends on it — {@link current} derives the
331
- * answer from the listing.
332
- */
333
- pointCurrentAt(id) {
334
- const link = join(this.runsDirectory, CURRENT_LINK);
335
- try {
336
- if (existsSync(link)) {
337
- unlinkSync(link);
338
- }
339
- if (id) {
340
- symlinkSync(id, link, "junction");
341
- }
342
- }
343
- catch {
344
- // no symlink, no problem
345
- }
346
- }
347
- /**
348
- * Hand `current` to whatever is still running, or remove it.
349
- *
350
- * Called when a run ends, because the alternative is a `current` that points
351
- * at a finished run while a live one sits next to it. Someone reading
352
- * `runs/current/meta.json` by hand would get a confident wrong answer, which
353
- * is worse than getting none.
354
- */
355
- repointCurrent() {
356
- const live = this.liveRuns();
357
- // One live run gets the link; several get none. `current` can only name
358
- // one directory, so with two live runs it would be pointing at an
359
- // arbitrary one of them — the same confident wrong answer this method
360
- // exists to prevent, just harder to notice because the link still resolves.
361
- this.pointCurrentAt(live.length === 1 ? live[0].meta.id : null);
362
- }
363
- /**
364
- * Keep the newest {@link KEEP_NEWEST} runs plus anything younger than
365
- * {@link KEEP_FOR_MS}, within {@link KEEP_BYTES} overall, and never touch one
366
- * that is still running.
367
- *
368
- * Public because it is worth doing at times other than starting a run — `sk
369
- * mcp` calls it, so a machine that has stopped running onboarding still tidies
370
- * up when something asks about the runs.
371
- */
372
- prune() {
373
- const cutoff = Date.now() - KEEP_FOR_MS;
374
- const runs = this.list();
375
- const survivors = [];
376
- for (const [index, run] of runs.entries()) {
377
- if (run.live) {
378
- survivors.push(run);
379
- continue;
380
- }
381
- const young = Date.parse(run.meta.startedAt) >= cutoff;
382
- if (index < KEEP_NEWEST || young) {
383
- survivors.push(run);
384
- continue;
385
- }
386
- this.remove(run);
387
- }
388
- this.enforceBudget(survivors);
389
- }
390
- /**
391
- * Evict oldest-first until what is left fits the budget.
392
- *
393
- * Runs the count and age rules cannot bound: they count runs, and what grows
394
- * is bytes. A live run is never evicted, however large — taking the cache out
395
- * from under a running session would be worse than the disk it saves.
396
- */
397
- enforceBudget(runs) {
398
- const sized = runs.map((run) => ({ run, bytes: directorySize(run.dir) }));
399
- let total = sized.reduce((sum, entry) => sum + entry.bytes, 0);
400
- for (const { run, bytes } of [...sized].reverse()) {
401
- if (total <= KEEP_BYTES) {
402
- return;
403
- }
404
- if (run.live) {
405
- continue;
406
- }
407
- this.remove(run);
408
- total -= bytes;
409
- }
410
- }
411
- remove(run) {
412
- try {
413
- rmSync(run.dir, { recursive: true, force: true });
414
- }
415
- catch {
416
- // a run we cannot delete is not a reason to fail the run we are starting
417
- }
418
- }
419
- }
420
- /** `./customers/x/` and `customers/x` are the same path as a selector. */
421
- function normalisePath(path) {
422
- return path.replace(/^\.\//, "").replace(/\/+$/, "");
423
- }
424
- /** `www.example.com` for `-d https://www.example.com/de`, `browse` without a domain. */
425
- function hostOf(domain) {
426
- if (!domain)
427
- return "browse";
428
- const host = domain.replace(/^[a-z]+:\/\//i, "").split(/[/?#]/)[0];
429
- return host || "browse";
430
- }
@@ -1,82 +0,0 @@
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
- });