@marinoscar/platform-cli 0.0.0-stage → 0.1.0-next.4

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 (748) hide show
  1. package/CHANGELOG.md +100 -0
  2. package/LICENSE +21 -0
  3. package/README.md +182 -2
  4. package/dist/android/build.d.ts +30 -0
  5. package/dist/android/build.d.ts.map +1 -0
  6. package/dist/android/build.js +126 -0
  7. package/dist/android/build.js.map +1 -0
  8. package/dist/android/command.d.ts +21 -0
  9. package/dist/android/command.d.ts.map +1 -0
  10. package/dist/android/command.js +355 -0
  11. package/dist/android/command.js.map +1 -0
  12. package/dist/android/deploy-step.d.ts +85 -0
  13. package/dist/android/deploy-step.d.ts.map +1 -0
  14. package/dist/android/deploy-step.js +268 -0
  15. package/dist/android/deploy-step.js.map +1 -0
  16. package/dist/android/doctor.d.ts +47 -0
  17. package/dist/android/doctor.d.ts.map +1 -0
  18. package/dist/android/doctor.js +219 -0
  19. package/dist/android/doctor.js.map +1 -0
  20. package/dist/android/exec.d.ts +42 -0
  21. package/dist/android/exec.d.ts.map +1 -0
  22. package/dist/android/exec.js +103 -0
  23. package/dist/android/exec.js.map +1 -0
  24. package/dist/android/fix-plan.d.ts +44 -0
  25. package/dist/android/fix-plan.d.ts.map +1 -0
  26. package/dist/android/fix-plan.js +86 -0
  27. package/dist/android/fix-plan.js.map +1 -0
  28. package/dist/android/git-freshness.d.ts +34 -0
  29. package/dist/android/git-freshness.d.ts.map +1 -0
  30. package/dist/android/git-freshness.js +120 -0
  31. package/dist/android/git-freshness.js.map +1 -0
  32. package/dist/android/gradle.d.ts +32 -0
  33. package/dist/android/gradle.d.ts.map +1 -0
  34. package/dist/android/gradle.js +55 -0
  35. package/dist/android/gradle.js.map +1 -0
  36. package/dist/android/identity.d.ts +27 -0
  37. package/dist/android/identity.d.ts.map +1 -0
  38. package/dist/android/identity.js +60 -0
  39. package/dist/android/identity.js.map +1 -0
  40. package/dist/android/index.d.ts +7 -0
  41. package/dist/android/index.d.ts.map +1 -0
  42. package/dist/android/index.js +8 -0
  43. package/dist/android/index.js.map +1 -0
  44. package/dist/android/installer.d.ts +28 -0
  45. package/dist/android/installer.d.ts.map +1 -0
  46. package/dist/android/installer.js +96 -0
  47. package/dist/android/installer.js.map +1 -0
  48. package/dist/android/java.d.ts +26 -0
  49. package/dist/android/java.d.ts.map +1 -0
  50. package/dist/android/java.js +65 -0
  51. package/dist/android/java.js.map +1 -0
  52. package/dist/android/keystore.d.ts +54 -0
  53. package/dist/android/keystore.d.ts.map +1 -0
  54. package/dist/android/keystore.js +159 -0
  55. package/dist/android/keystore.js.map +1 -0
  56. package/dist/android/metadata.d.ts +39 -0
  57. package/dist/android/metadata.d.ts.map +1 -0
  58. package/dist/android/metadata.js +61 -0
  59. package/dist/android/metadata.js.map +1 -0
  60. package/dist/android/operations.d.ts +42 -0
  61. package/dist/android/operations.d.ts.map +1 -0
  62. package/dist/android/operations.js +59 -0
  63. package/dist/android/operations.js.map +1 -0
  64. package/dist/android/paths.d.ts +29 -0
  65. package/dist/android/paths.d.ts.map +1 -0
  66. package/dist/android/paths.js +97 -0
  67. package/dist/android/paths.js.map +1 -0
  68. package/dist/android/publish.d.ts +37 -0
  69. package/dist/android/publish.d.ts.map +1 -0
  70. package/dist/android/publish.js +119 -0
  71. package/dist/android/publish.js.map +1 -0
  72. package/dist/android/registrations.d.ts +92 -0
  73. package/dist/android/registrations.d.ts.map +1 -0
  74. package/dist/android/registrations.js +112 -0
  75. package/dist/android/registrations.js.map +1 -0
  76. package/dist/android/release-status.d.ts +73 -0
  77. package/dist/android/release-status.d.ts.map +1 -0
  78. package/dist/android/release-status.js +161 -0
  79. package/dist/android/release-status.js.map +1 -0
  80. package/dist/android/release.d.ts +33 -0
  81. package/dist/android/release.d.ts.map +1 -0
  82. package/dist/android/release.js +59 -0
  83. package/dist/android/release.js.map +1 -0
  84. package/dist/android/screen-layout.d.ts +26 -0
  85. package/dist/android/screen-layout.d.ts.map +1 -0
  86. package/dist/android/screen-layout.js +24 -0
  87. package/dist/android/screen-layout.js.map +1 -0
  88. package/dist/android/screen-model.d.ts +56 -0
  89. package/dist/android/screen-model.d.ts.map +1 -0
  90. package/dist/android/screen-model.js +207 -0
  91. package/dist/android/screen-model.js.map +1 -0
  92. package/dist/android/screen.d.ts +8 -0
  93. package/dist/android/screen.d.ts.map +1 -0
  94. package/dist/android/screen.js +395 -0
  95. package/dist/android/screen.js.map +1 -0
  96. package/dist/android/sdk.d.ts +48 -0
  97. package/dist/android/sdk.d.ts.map +1 -0
  98. package/dist/android/sdk.js +82 -0
  99. package/dist/android/sdk.js.map +1 -0
  100. package/dist/android/server-url.d.ts +19 -0
  101. package/dist/android/server-url.d.ts.map +1 -0
  102. package/dist/android/server-url.js +36 -0
  103. package/dist/android/server-url.js.map +1 -0
  104. package/dist/android/upload-progress.d.ts +3 -0
  105. package/dist/android/upload-progress.d.ts.map +1 -0
  106. package/dist/android/upload-progress.js +47 -0
  107. package/dist/android/upload-progress.js.map +1 -0
  108. package/dist/android/version.d.ts +47 -0
  109. package/dist/android/version.d.ts.map +1 -0
  110. package/dist/android/version.js +136 -0
  111. package/dist/android/version.js.map +1 -0
  112. package/dist/api-client/index.d.ts +3 -0
  113. package/dist/api-client/index.d.ts.map +1 -0
  114. package/dist/api-client/index.js +5 -0
  115. package/dist/api-client/index.js.map +1 -0
  116. package/dist/commands/index.d.ts +52 -0
  117. package/dist/commands/index.d.ts.map +1 -0
  118. package/dist/commands/index.js +63 -0
  119. package/dist/commands/index.js.map +1 -0
  120. package/dist/core/cli-registry.d.ts +41 -0
  121. package/dist/core/cli-registry.d.ts.map +1 -0
  122. package/dist/core/cli-registry.js +49 -0
  123. package/dist/core/cli-registry.js.map +1 -0
  124. package/dist/core/command-registry.d.ts +60 -0
  125. package/dist/core/command-registry.d.ts.map +1 -0
  126. package/dist/core/command-registry.js +114 -0
  127. package/dist/core/command-registry.js.map +1 -0
  128. package/dist/core/env-annotation-registry.d.ts +58 -0
  129. package/dist/core/env-annotation-registry.d.ts.map +1 -0
  130. package/dist/core/env-annotation-registry.js +80 -0
  131. package/dist/core/env-annotation-registry.js.map +1 -0
  132. package/dist/core/env-generator-registry.d.ts +59 -0
  133. package/dist/core/env-generator-registry.d.ts.map +1 -0
  134. package/dist/core/env-generator-registry.js +102 -0
  135. package/dist/core/env-generator-registry.js.map +1 -0
  136. package/dist/core/env-group-registry.d.ts +65 -0
  137. package/dist/core/env-group-registry.d.ts.map +1 -0
  138. package/dist/core/env-group-registry.js +77 -0
  139. package/dist/core/env-group-registry.js.map +1 -0
  140. package/dist/core/env-spec-registry.d.ts +133 -0
  141. package/dist/core/env-spec-registry.d.ts.map +1 -0
  142. package/dist/core/env-spec-registry.js +103 -0
  143. package/dist/core/env-spec-registry.js.map +1 -0
  144. package/dist/core/env-values.d.ts +76 -0
  145. package/dist/core/env-values.d.ts.map +1 -0
  146. package/dist/core/env-values.js +125 -0
  147. package/dist/core/env-values.js.map +1 -0
  148. package/dist/core/index.d.ts +14 -0
  149. package/dist/core/index.d.ts.map +1 -0
  150. package/dist/core/index.js +10 -0
  151. package/dist/core/index.js.map +1 -0
  152. package/dist/deploy/index.d.ts +3 -0
  153. package/dist/deploy/index.d.ts.map +1 -0
  154. package/dist/deploy/index.js +5 -0
  155. package/dist/deploy/index.js.map +1 -0
  156. package/dist/engine/api-client.d.ts +211 -0
  157. package/dist/engine/api-client.d.ts.map +1 -0
  158. package/dist/engine/api-client.js +350 -0
  159. package/dist/engine/api-client.js.map +1 -0
  160. package/dist/engine/browser.d.ts +18 -0
  161. package/dist/engine/browser.d.ts.map +1 -0
  162. package/dist/engine/browser.js +115 -0
  163. package/dist/engine/browser.js.map +1 -0
  164. package/dist/engine/builtin-registrations.d.ts +20 -0
  165. package/dist/engine/builtin-registrations.d.ts.map +1 -0
  166. package/dist/engine/builtin-registrations.js +86 -0
  167. package/dist/engine/builtin-registrations.js.map +1 -0
  168. package/dist/engine/commands/api.d.ts +88 -0
  169. package/dist/engine/commands/api.d.ts.map +1 -0
  170. package/dist/engine/commands/api.js +398 -0
  171. package/dist/engine/commands/api.js.map +1 -0
  172. package/dist/engine/commands/config.d.ts +5 -0
  173. package/dist/engine/commands/config.d.ts.map +1 -0
  174. package/dist/engine/commands/config.js +83 -0
  175. package/dist/engine/commands/config.js.map +1 -0
  176. package/dist/engine/commands/deploy.d.ts +243 -0
  177. package/dist/engine/commands/deploy.d.ts.map +1 -0
  178. package/dist/engine/commands/deploy.js +1159 -0
  179. package/dist/engine/commands/deploy.js.map +1 -0
  180. package/dist/engine/commands/init.d.ts +18 -0
  181. package/dist/engine/commands/init.d.ts.map +1 -0
  182. package/dist/engine/commands/init.js +50 -0
  183. package/dist/engine/commands/init.js.map +1 -0
  184. package/dist/engine/commands/login.d.ts +4 -0
  185. package/dist/engine/commands/login.d.ts.map +1 -0
  186. package/dist/engine/commands/login.js +205 -0
  187. package/dist/engine/commands/login.js.map +1 -0
  188. package/dist/engine/commands/node.d.ts +21 -0
  189. package/dist/engine/commands/node.d.ts.map +1 -0
  190. package/dist/engine/commands/node.js +436 -0
  191. package/dist/engine/commands/node.js.map +1 -0
  192. package/dist/engine/config.d.ts +246 -0
  193. package/dist/engine/config.d.ts.map +1 -0
  194. package/dist/engine/config.js +414 -0
  195. package/dist/engine/config.js.map +1 -0
  196. package/dist/engine/conformance.d.ts +187 -0
  197. package/dist/engine/conformance.d.ts.map +1 -0
  198. package/dist/engine/conformance.js +227 -0
  199. package/dist/engine/conformance.js.map +1 -0
  200. package/dist/engine/create-cli.d.ts +94 -0
  201. package/dist/engine/create-cli.d.ts.map +1 -0
  202. package/dist/engine/create-cli.js +60 -0
  203. package/dist/engine/create-cli.js.map +1 -0
  204. package/dist/engine/deploy/about.d.ts +12 -0
  205. package/dist/engine/deploy/about.d.ts.map +1 -0
  206. package/dist/engine/deploy/about.js +110 -0
  207. package/dist/engine/deploy/about.js.map +1 -0
  208. package/dist/engine/deploy/adopt.d.ts +21 -0
  209. package/dist/engine/deploy/adopt.d.ts.map +1 -0
  210. package/dist/engine/deploy/adopt.js +78 -0
  211. package/dist/engine/deploy/adopt.js.map +1 -0
  212. package/dist/engine/deploy/answers-file.d.ts +7 -0
  213. package/dist/engine/deploy/answers-file.d.ts.map +1 -0
  214. package/dist/engine/deploy/answers-file.js +49 -0
  215. package/dist/engine/deploy/answers-file.js.map +1 -0
  216. package/dist/engine/deploy/app-role.d.ts +278 -0
  217. package/dist/engine/deploy/app-role.d.ts.map +1 -0
  218. package/dist/engine/deploy/app-role.js +826 -0
  219. package/dist/engine/deploy/app-role.js.map +1 -0
  220. package/dist/engine/deploy/app-version.d.ts +47 -0
  221. package/dist/engine/deploy/app-version.d.ts.map +1 -0
  222. package/dist/engine/deploy/app-version.js +232 -0
  223. package/dist/engine/deploy/app-version.js.map +1 -0
  224. package/dist/engine/deploy/checks/database.d.ts +83 -0
  225. package/dist/engine/deploy/checks/database.d.ts.map +1 -0
  226. package/dist/engine/deploy/checks/database.js +455 -0
  227. package/dist/engine/deploy/checks/database.js.map +1 -0
  228. package/dist/engine/deploy/checks/dns.d.ts +3 -0
  229. package/dist/engine/deploy/checks/dns.d.ts.map +1 -0
  230. package/dist/engine/deploy/checks/dns.js +85 -0
  231. package/dist/engine/deploy/checks/dns.js.map +1 -0
  232. package/dist/engine/deploy/checks/host.d.ts +19 -0
  233. package/dist/engine/deploy/checks/host.d.ts.map +1 -0
  234. package/dist/engine/deploy/checks/host.js +530 -0
  235. package/dist/engine/deploy/checks/host.js.map +1 -0
  236. package/dist/engine/deploy/checks/index.d.ts +33 -0
  237. package/dist/engine/deploy/checks/index.d.ts.map +1 -0
  238. package/dist/engine/deploy/checks/index.js +67 -0
  239. package/dist/engine/deploy/checks/index.js.map +1 -0
  240. package/dist/engine/deploy/checks/registry.d.ts +102 -0
  241. package/dist/engine/deploy/checks/registry.d.ts.map +1 -0
  242. package/dist/engine/deploy/checks/registry.js +103 -0
  243. package/dist/engine/deploy/checks/registry.js.map +1 -0
  244. package/dist/engine/deploy/checks/source.d.ts +45 -0
  245. package/dist/engine/deploy/checks/source.d.ts.map +1 -0
  246. package/dist/engine/deploy/checks/source.js +175 -0
  247. package/dist/engine/deploy/checks/source.js.map +1 -0
  248. package/dist/engine/deploy/checks/tls.d.ts +87 -0
  249. package/dist/engine/deploy/checks/tls.d.ts.map +1 -0
  250. package/dist/engine/deploy/checks/tls.js +552 -0
  251. package/dist/engine/deploy/checks/tls.js.map +1 -0
  252. package/dist/engine/deploy/checks/types.d.ts +178 -0
  253. package/dist/engine/deploy/checks/types.d.ts.map +1 -0
  254. package/dist/engine/deploy/checks/types.js +199 -0
  255. package/dist/engine/deploy/checks/types.js.map +1 -0
  256. package/dist/engine/deploy/compose-files.d.ts +29 -0
  257. package/dist/engine/deploy/compose-files.d.ts.map +1 -0
  258. package/dist/engine/deploy/compose-files.js +118 -0
  259. package/dist/engine/deploy/compose-files.js.map +1 -0
  260. package/dist/engine/deploy/consent.d.ts +29 -0
  261. package/dist/engine/deploy/consent.d.ts.map +1 -0
  262. package/dist/engine/deploy/consent.js +35 -0
  263. package/dist/engine/deploy/consent.js.map +1 -0
  264. package/dist/engine/deploy/database-drop.d.ts +22 -0
  265. package/dist/engine/deploy/database-drop.d.ts.map +1 -0
  266. package/dist/engine/deploy/database-drop.js +135 -0
  267. package/dist/engine/deploy/database-drop.js.map +1 -0
  268. package/dist/engine/deploy/database.d.ts +116 -0
  269. package/dist/engine/deploy/database.d.ts.map +1 -0
  270. package/dist/engine/deploy/database.js +252 -0
  271. package/dist/engine/deploy/database.js.map +1 -0
  272. package/dist/engine/deploy/deploy-info.d.ts +48 -0
  273. package/dist/engine/deploy/deploy-info.d.ts.map +1 -0
  274. package/dist/engine/deploy/deploy-info.js +163 -0
  275. package/dist/engine/deploy/deploy-info.js.map +1 -0
  276. package/dist/engine/deploy/deployment-evidence.d.ts +38 -0
  277. package/dist/engine/deploy/deployment-evidence.d.ts.map +1 -0
  278. package/dist/engine/deploy/deployment-evidence.js +92 -0
  279. package/dist/engine/deploy/deployment-evidence.js.map +1 -0
  280. package/dist/engine/deploy/edge-config.d.ts +103 -0
  281. package/dist/engine/deploy/edge-config.d.ts.map +1 -0
  282. package/dist/engine/deploy/edge-config.js +170 -0
  283. package/dist/engine/deploy/edge-config.js.map +1 -0
  284. package/dist/engine/deploy/env-absence.d.ts +61 -0
  285. package/dist/engine/deploy/env-absence.d.ts.map +1 -0
  286. package/dist/engine/deploy/env-absence.js +33 -0
  287. package/dist/engine/deploy/env-absence.js.map +1 -0
  288. package/dist/engine/deploy/env-file.d.ts +14 -0
  289. package/dist/engine/deploy/env-file.d.ts.map +1 -0
  290. package/dist/engine/deploy/env-file.js +58 -0
  291. package/dist/engine/deploy/env-file.js.map +1 -0
  292. package/dist/engine/deploy/env-fragments.d.ts +29 -0
  293. package/dist/engine/deploy/env-fragments.d.ts.map +1 -0
  294. package/dist/engine/deploy/env-fragments.js +73 -0
  295. package/dist/engine/deploy/env-fragments.js.map +1 -0
  296. package/dist/engine/deploy/env-metadata.d.ts +73 -0
  297. package/dist/engine/deploy/env-metadata.d.ts.map +1 -0
  298. package/dist/engine/deploy/env-metadata.js +227 -0
  299. package/dist/engine/deploy/env-metadata.js.map +1 -0
  300. package/dist/engine/deploy/env-spec.d.ts +75 -0
  301. package/dist/engine/deploy/env-spec.d.ts.map +1 -0
  302. package/dist/engine/deploy/env-spec.js +239 -0
  303. package/dist/engine/deploy/env-spec.js.map +1 -0
  304. package/dist/engine/deploy/env-wizard.d.ts +56 -0
  305. package/dist/engine/deploy/env-wizard.d.ts.map +1 -0
  306. package/dist/engine/deploy/env-wizard.js +235 -0
  307. package/dist/engine/deploy/env-wizard.js.map +1 -0
  308. package/dist/engine/deploy/executor.d.ts +81 -0
  309. package/dist/engine/deploy/executor.d.ts.map +1 -0
  310. package/dist/engine/deploy/executor.js +247 -0
  311. package/dist/engine/deploy/executor.js.map +1 -0
  312. package/dist/engine/deploy/health.d.ts +146 -0
  313. package/dist/engine/deploy/health.d.ts.map +1 -0
  314. package/dist/engine/deploy/health.js +323 -0
  315. package/dist/engine/deploy/health.js.map +1 -0
  316. package/dist/engine/deploy/hooks.d.ts +66 -0
  317. package/dist/engine/deploy/hooks.d.ts.map +1 -0
  318. package/dist/engine/deploy/hooks.js +19 -0
  319. package/dist/engine/deploy/hooks.js.map +1 -0
  320. package/dist/engine/deploy/host-facts.d.ts +23 -0
  321. package/dist/engine/deploy/host-facts.d.ts.map +1 -0
  322. package/dist/engine/deploy/host-facts.js +67 -0
  323. package/dist/engine/deploy/host-facts.js.map +1 -0
  324. package/dist/engine/deploy/install.d.ts +233 -0
  325. package/dist/engine/deploy/install.d.ts.map +1 -0
  326. package/dist/engine/deploy/install.js +1304 -0
  327. package/dist/engine/deploy/install.js.map +1 -0
  328. package/dist/engine/deploy/inventory.d.ts +30 -0
  329. package/dist/engine/deploy/inventory.d.ts.map +1 -0
  330. package/dist/engine/deploy/inventory.js +122 -0
  331. package/dist/engine/deploy/inventory.js.map +1 -0
  332. package/dist/engine/deploy/journal.d.ts +77 -0
  333. package/dist/engine/deploy/journal.d.ts.map +1 -0
  334. package/dist/engine/deploy/journal.js +221 -0
  335. package/dist/engine/deploy/journal.js.map +1 -0
  336. package/dist/engine/deploy/layout.d.ts +77 -0
  337. package/dist/engine/deploy/layout.d.ts.map +1 -0
  338. package/dist/engine/deploy/layout.js +191 -0
  339. package/dist/engine/deploy/layout.js.map +1 -0
  340. package/dist/engine/deploy/oauth-check.d.ts +58 -0
  341. package/dist/engine/deploy/oauth-check.d.ts.map +1 -0
  342. package/dist/engine/deploy/oauth-check.js +213 -0
  343. package/dist/engine/deploy/oauth-check.js.map +1 -0
  344. package/dist/engine/deploy/proxy-bootstrap.d.ts +149 -0
  345. package/dist/engine/deploy/proxy-bootstrap.d.ts.map +1 -0
  346. package/dist/engine/deploy/proxy-bootstrap.js +416 -0
  347. package/dist/engine/deploy/proxy-bootstrap.js.map +1 -0
  348. package/dist/engine/deploy/proxy-streams.d.ts +110 -0
  349. package/dist/engine/deploy/proxy-streams.d.ts.map +1 -0
  350. package/dist/engine/deploy/proxy-streams.js +208 -0
  351. package/dist/engine/deploy/proxy-streams.js.map +1 -0
  352. package/dist/engine/deploy/proxy.d.ts +375 -0
  353. package/dist/engine/deploy/proxy.d.ts.map +1 -0
  354. package/dist/engine/deploy/proxy.js +758 -0
  355. package/dist/engine/deploy/proxy.js.map +1 -0
  356. package/dist/engine/deploy/renewal.d.ts +54 -0
  357. package/dist/engine/deploy/renewal.d.ts.map +1 -0
  358. package/dist/engine/deploy/renewal.js +169 -0
  359. package/dist/engine/deploy/renewal.js.map +1 -0
  360. package/dist/engine/deploy/repo.d.ts +101 -0
  361. package/dist/engine/deploy/repo.d.ts.map +1 -0
  362. package/dist/engine/deploy/repo.js +250 -0
  363. package/dist/engine/deploy/repo.js.map +1 -0
  364. package/dist/engine/deploy/run-record.d.ts +28 -0
  365. package/dist/engine/deploy/run-record.d.ts.map +1 -0
  366. package/dist/engine/deploy/run-record.js +44 -0
  367. package/dist/engine/deploy/run-record.js.map +1 -0
  368. package/dist/engine/deploy/state.d.ts +262 -0
  369. package/dist/engine/deploy/state.d.ts.map +1 -0
  370. package/dist/engine/deploy/state.js +163 -0
  371. package/dist/engine/deploy/state.js.map +1 -0
  372. package/dist/engine/deploy/steps/app-step-context.d.ts +24 -0
  373. package/dist/engine/deploy/steps/app-step-context.d.ts.map +1 -0
  374. package/dist/engine/deploy/steps/app-step-context.js +45 -0
  375. package/dist/engine/deploy/steps/app-step-context.js.map +1 -0
  376. package/dist/engine/deploy/steps/pipeline.d.ts +46 -0
  377. package/dist/engine/deploy/steps/pipeline.d.ts.map +1 -0
  378. package/dist/engine/deploy/steps/pipeline.js +73 -0
  379. package/dist/engine/deploy/steps/pipeline.js.map +1 -0
  380. package/dist/engine/deploy/steps/plan.d.ts +28 -0
  381. package/dist/engine/deploy/steps/plan.d.ts.map +1 -0
  382. package/dist/engine/deploy/steps/plan.js +32 -0
  383. package/dist/engine/deploy/steps/plan.js.map +1 -0
  384. package/dist/engine/deploy/steps/registry.d.ts +182 -0
  385. package/dist/engine/deploy/steps/registry.d.ts.map +1 -0
  386. package/dist/engine/deploy/steps/registry.js +212 -0
  387. package/dist/engine/deploy/steps/registry.js.map +1 -0
  388. package/dist/engine/deploy/steps/step-values.d.ts +28 -0
  389. package/dist/engine/deploy/steps/step-values.d.ts.map +1 -0
  390. package/dist/engine/deploy/steps/step-values.js +33 -0
  391. package/dist/engine/deploy/steps/step-values.js.map +1 -0
  392. package/dist/engine/deploy/testing/fake-postgres.d.ts +88 -0
  393. package/dist/engine/deploy/testing/fake-postgres.d.ts.map +1 -0
  394. package/dist/engine/deploy/testing/fake-postgres.js +236 -0
  395. package/dist/engine/deploy/testing/fake-postgres.js.map +1 -0
  396. package/dist/engine/deploy/testing/fake-vps.d.ts +147 -0
  397. package/dist/engine/deploy/testing/fake-vps.d.ts.map +1 -0
  398. package/dist/engine/deploy/testing/fake-vps.js +365 -0
  399. package/dist/engine/deploy/testing/fake-vps.js.map +1 -0
  400. package/dist/engine/deploy/uninstall.d.ts +87 -0
  401. package/dist/engine/deploy/uninstall.d.ts.map +1 -0
  402. package/dist/engine/deploy/uninstall.js +320 -0
  403. package/dist/engine/deploy/uninstall.js.map +1 -0
  404. package/dist/engine/deploy/update.d.ts +111 -0
  405. package/dist/engine/deploy/update.d.ts.map +1 -0
  406. package/dist/engine/deploy/update.js +1228 -0
  407. package/dist/engine/deploy/update.js.map +1 -0
  408. package/dist/engine/deploy/version-step.d.ts +65 -0
  409. package/dist/engine/deploy/version-step.d.ts.map +1 -0
  410. package/dist/engine/deploy/version-step.js +176 -0
  411. package/dist/engine/deploy/version-step.js.map +1 -0
  412. package/dist/engine/device-auth.d.ts +240 -0
  413. package/dist/engine/device-auth.d.ts.map +1 -0
  414. package/dist/engine/device-auth.js +442 -0
  415. package/dist/engine/device-auth.js.map +1 -0
  416. package/dist/engine/device-login.d.ts +126 -0
  417. package/dist/engine/device-login.d.ts.map +1 -0
  418. package/dist/engine/device-login.js +164 -0
  419. package/dist/engine/device-login.js.map +1 -0
  420. package/dist/engine/errors.d.ts +314 -0
  421. package/dist/engine/errors.d.ts.map +1 -0
  422. package/dist/engine/errors.js +561 -0
  423. package/dist/engine/errors.js.map +1 -0
  424. package/dist/engine/identity.d.ts +169 -0
  425. package/dist/engine/identity.d.ts.map +1 -0
  426. package/dist/engine/identity.js +227 -0
  427. package/dist/engine/identity.js.map +1 -0
  428. package/dist/engine/index.d.ts +104 -0
  429. package/dist/engine/index.d.ts.map +1 -0
  430. package/dist/engine/index.js +126 -0
  431. package/dist/engine/index.js.map +1 -0
  432. package/dist/engine/init/local-profile.d.ts +93 -0
  433. package/dist/engine/init/local-profile.d.ts.map +1 -0
  434. package/dist/engine/init/local-profile.js +295 -0
  435. package/dist/engine/init/local-profile.js.map +1 -0
  436. package/dist/engine/init/run-init.d.ts +41 -0
  437. package/dist/engine/init/run-init.d.ts.map +1 -0
  438. package/dist/engine/init/run-init.js +297 -0
  439. package/dist/engine/init/run-init.js.map +1 -0
  440. package/dist/engine/node/capabilities.d.ts +238 -0
  441. package/dist/engine/node/capabilities.d.ts.map +1 -0
  442. package/dist/engine/node/capabilities.js +316 -0
  443. package/dist/engine/node/capabilities.js.map +1 -0
  444. package/dist/engine/node/daemon.d.ts +63 -0
  445. package/dist/engine/node/daemon.d.ts.map +1 -0
  446. package/dist/engine/node/daemon.js +227 -0
  447. package/dist/engine/node/daemon.js.map +1 -0
  448. package/dist/engine/node/doctor.d.ts +58 -0
  449. package/dist/engine/node/doctor.d.ts.map +1 -0
  450. package/dist/engine/node/doctor.js +394 -0
  451. package/dist/engine/node/doctor.js.map +1 -0
  452. package/dist/engine/node/enrollment.d.ts +98 -0
  453. package/dist/engine/node/enrollment.d.ts.map +1 -0
  454. package/dist/engine/node/enrollment.js +189 -0
  455. package/dist/engine/node/enrollment.js.map +1 -0
  456. package/dist/engine/node/env-flags.d.ts +5 -0
  457. package/dist/engine/node/env-flags.d.ts.map +1 -0
  458. package/dist/engine/node/env-flags.js +22 -0
  459. package/dist/engine/node/env-flags.js.map +1 -0
  460. package/dist/engine/node/executors/credential-hygiene.d.ts +63 -0
  461. package/dist/engine/node/executors/credential-hygiene.d.ts.map +1 -0
  462. package/dist/engine/node/executors/credential-hygiene.js +189 -0
  463. package/dist/engine/node/executors/credential-hygiene.js.map +1 -0
  464. package/dist/engine/node/executors/db-backup-run.d.ts +73 -0
  465. package/dist/engine/node/executors/db-backup-run.d.ts.map +1 -0
  466. package/dist/engine/node/executors/db-backup-run.js +362 -0
  467. package/dist/engine/node/executors/db-backup-run.js.map +1 -0
  468. package/dist/engine/node/executors/example-checksum.d.ts +30 -0
  469. package/dist/engine/node/executors/example-checksum.d.ts.map +1 -0
  470. package/dist/engine/node/executors/example-checksum.js +56 -0
  471. package/dist/engine/node/executors/example-checksum.js.map +1 -0
  472. package/dist/engine/node/executors/index.d.ts +168 -0
  473. package/dist/engine/node/executors/index.d.ts.map +1 -0
  474. package/dist/engine/node/executors/index.js +44 -0
  475. package/dist/engine/node/executors/index.js.map +1 -0
  476. package/dist/engine/node/executors/registry.d.ts +38 -0
  477. package/dist/engine/node/executors/registry.d.ts.map +1 -0
  478. package/dist/engine/node/executors/registry.js +92 -0
  479. package/dist/engine/node/executors/registry.js.map +1 -0
  480. package/dist/engine/node/heap-snapshot.d.ts +37 -0
  481. package/dist/engine/node/heap-snapshot.d.ts.map +1 -0
  482. package/dist/engine/node/heap-snapshot.js +160 -0
  483. package/dist/engine/node/heap-snapshot.js.map +1 -0
  484. package/dist/engine/node/install-deps.d.ts +73 -0
  485. package/dist/engine/node/install-deps.d.ts.map +1 -0
  486. package/dist/engine/node/install-deps.js +150 -0
  487. package/dist/engine/node/install-deps.js.map +1 -0
  488. package/dist/engine/node/ipc-protocol.d.ts +67 -0
  489. package/dist/engine/node/ipc-protocol.d.ts.map +1 -0
  490. package/dist/engine/node/ipc-protocol.js +83 -0
  491. package/dist/engine/node/ipc-protocol.js.map +1 -0
  492. package/dist/engine/node/lifecycle.d.ts +103 -0
  493. package/dist/engine/node/lifecycle.d.ts.map +1 -0
  494. package/dist/engine/node/lifecycle.js +259 -0
  495. package/dist/engine/node/lifecycle.js.map +1 -0
  496. package/dist/engine/node/logger.d.ts +82 -0
  497. package/dist/engine/node/logger.d.ts.map +1 -0
  498. package/dist/engine/node/logger.js +241 -0
  499. package/dist/engine/node/logger.js.map +1 -0
  500. package/dist/engine/node/memory-watchdog.d.ts +78 -0
  501. package/dist/engine/node/memory-watchdog.d.ts.map +1 -0
  502. package/dist/engine/node/memory-watchdog.js +224 -0
  503. package/dist/engine/node/memory-watchdog.js.map +1 -0
  504. package/dist/engine/node/node-api.d.ts +391 -0
  505. package/dist/engine/node/node-api.d.ts.map +1 -0
  506. package/dist/engine/node/node-api.js +123 -0
  507. package/dist/engine/node/node-api.js.map +1 -0
  508. package/dist/engine/node/node-config.d.ts +128 -0
  509. package/dist/engine/node/node-config.d.ts.map +1 -0
  510. package/dist/engine/node/node-config.js +237 -0
  511. package/dist/engine/node/node-config.js.map +1 -0
  512. package/dist/engine/node/node-dashboard-source.d.ts +56 -0
  513. package/dist/engine/node/node-dashboard-source.d.ts.map +1 -0
  514. package/dist/engine/node/node-dashboard-source.js +213 -0
  515. package/dist/engine/node/node-dashboard-source.js.map +1 -0
  516. package/dist/engine/node/node-engine.d.ts +229 -0
  517. package/dist/engine/node/node-engine.d.ts.map +1 -0
  518. package/dist/engine/node/node-engine.js +723 -0
  519. package/dist/engine/node/node-engine.js.map +1 -0
  520. package/dist/engine/node/node-errors.d.ts +54 -0
  521. package/dist/engine/node/node-errors.d.ts.map +1 -0
  522. package/dist/engine/node/node-errors.js +71 -0
  523. package/dist/engine/node/node-errors.js.map +1 -0
  524. package/dist/engine/node/node-events.d.ts +132 -0
  525. package/dist/engine/node/node-events.d.ts.map +1 -0
  526. package/dist/engine/node/node-events.js +2 -0
  527. package/dist/engine/node/node-events.js.map +1 -0
  528. package/dist/engine/node/node-vitals.d.ts +123 -0
  529. package/dist/engine/node/node-vitals.d.ts.map +1 -0
  530. package/dist/engine/node/node-vitals.js +266 -0
  531. package/dist/engine/node/node-vitals.js.map +1 -0
  532. package/dist/engine/node/paths.d.ts +39 -0
  533. package/dist/engine/node/paths.d.ts.map +1 -0
  534. package/dist/engine/node/paths.js +60 -0
  535. package/dist/engine/node/paths.js.map +1 -0
  536. package/dist/engine/node/pg-dump.d.ts +126 -0
  537. package/dist/engine/node/pg-dump.d.ts.map +1 -0
  538. package/dist/engine/node/pg-dump.js +223 -0
  539. package/dist/engine/node/pg-dump.js.map +1 -0
  540. package/dist/engine/node/pidfile.d.ts +38 -0
  541. package/dist/engine/node/pidfile.d.ts.map +1 -0
  542. package/dist/engine/node/pidfile.js +156 -0
  543. package/dist/engine/node/pidfile.js.map +1 -0
  544. package/dist/engine/node/runtime-tuning.d.ts +65 -0
  545. package/dist/engine/node/runtime-tuning.d.ts.map +1 -0
  546. package/dist/engine/node/runtime-tuning.js +198 -0
  547. package/dist/engine/node/runtime-tuning.js.map +1 -0
  548. package/dist/engine/node/service.d.ts +39 -0
  549. package/dist/engine/node/service.d.ts.map +1 -0
  550. package/dist/engine/node/service.js +211 -0
  551. package/dist/engine/node/service.js.map +1 -0
  552. package/dist/engine/node/start.d.ts +62 -0
  553. package/dist/engine/node/start.d.ts.map +1 -0
  554. package/dist/engine/node/start.js +245 -0
  555. package/dist/engine/node/start.js.map +1 -0
  556. package/dist/engine/node/worker-env-table.d.ts +15 -0
  557. package/dist/engine/node/worker-env-table.d.ts.map +1 -0
  558. package/dist/engine/node/worker-env-table.js +97 -0
  559. package/dist/engine/node/worker-env-table.js.map +1 -0
  560. package/dist/engine/node/worker-env.d.ts +50 -0
  561. package/dist/engine/node/worker-env.d.ts.map +1 -0
  562. package/dist/engine/node/worker-env.js +101 -0
  563. package/dist/engine/node/worker-env.js.map +1 -0
  564. package/dist/engine/output.d.ts +97 -0
  565. package/dist/engine/output.d.ts.map +1 -0
  566. package/dist/engine/output.js +274 -0
  567. package/dist/engine/output.js.map +1 -0
  568. package/dist/engine/package-info.d.ts +7 -0
  569. package/dist/engine/package-info.d.ts.map +1 -0
  570. package/dist/engine/package-info.js +38 -0
  571. package/dist/engine/package-info.js.map +1 -0
  572. package/dist/engine/program.d.ts +50 -0
  573. package/dist/engine/program.d.ts.map +1 -0
  574. package/dist/engine/program.js +197 -0
  575. package/dist/engine/program.js.map +1 -0
  576. package/dist/engine/prompt.d.ts +69 -0
  577. package/dist/engine/prompt.d.ts.map +1 -0
  578. package/dist/engine/prompt.js +205 -0
  579. package/dist/engine/prompt.js.map +1 -0
  580. package/dist/engine/registries.d.ts +5 -0
  581. package/dist/engine/registries.d.ts.map +1 -0
  582. package/dist/engine/registries.js +52 -0
  583. package/dist/engine/registries.js.map +1 -0
  584. package/dist/engine/request-body.d.ts +31 -0
  585. package/dist/engine/request-body.d.ts.map +1 -0
  586. package/dist/engine/request-body.js +156 -0
  587. package/dist/engine/request-body.js.map +1 -0
  588. package/dist/engine/test-support.d.ts +50 -0
  589. package/dist/engine/test-support.d.ts.map +1 -0
  590. package/dist/engine/test-support.js +86 -0
  591. package/dist/engine/test-support.js.map +1 -0
  592. package/dist/engine/tui/app.d.ts +3 -0
  593. package/dist/engine/tui/app.d.ts.map +1 -0
  594. package/dist/engine/tui/app.js +100 -0
  595. package/dist/engine/tui/app.js.map +1 -0
  596. package/dist/engine/tui/builtin-screens.d.ts +6 -0
  597. package/dist/engine/tui/builtin-screens.d.ts.map +1 -0
  598. package/dist/engine/tui/builtin-screens.js +54 -0
  599. package/dist/engine/tui/builtin-screens.js.map +1 -0
  600. package/dist/engine/tui/index.d.ts +23 -0
  601. package/dist/engine/tui/index.d.ts.map +1 -0
  602. package/dist/engine/tui/index.js +71 -0
  603. package/dist/engine/tui/index.js.map +1 -0
  604. package/dist/engine/tui/layout.d.ts +132 -0
  605. package/dist/engine/tui/layout.d.ts.map +1 -0
  606. package/dist/engine/tui/layout.js +200 -0
  607. package/dist/engine/tui/layout.js.map +1 -0
  608. package/dist/engine/tui/routes.d.ts +5 -0
  609. package/dist/engine/tui/routes.d.ts.map +1 -0
  610. package/dist/engine/tui/routes.js +16 -0
  611. package/dist/engine/tui/routes.js.map +1 -0
  612. package/dist/engine/tui/screen-registry.d.ts +100 -0
  613. package/dist/engine/tui/screen-registry.d.ts.map +1 -0
  614. package/dist/engine/tui/screen-registry.js +96 -0
  615. package/dist/engine/tui/screen-registry.js.map +1 -0
  616. package/dist/engine/tui/screen-sections.d.ts +9 -0
  617. package/dist/engine/tui/screen-sections.d.ts.map +1 -0
  618. package/dist/engine/tui/screen-sections.js +45 -0
  619. package/dist/engine/tui/screen-sections.js.map +1 -0
  620. package/dist/engine/tui/screens/deploy/advanced-model.d.ts +69 -0
  621. package/dist/engine/tui/screens/deploy/advanced-model.d.ts.map +1 -0
  622. package/dist/engine/tui/screens/deploy/advanced-model.js +228 -0
  623. package/dist/engine/tui/screens/deploy/advanced-model.js.map +1 -0
  624. package/dist/engine/tui/screens/deploy/doctor-model.d.ts +37 -0
  625. package/dist/engine/tui/screens/deploy/doctor-model.d.ts.map +1 -0
  626. package/dist/engine/tui/screens/deploy/doctor-model.js +89 -0
  627. package/dist/engine/tui/screens/deploy/doctor-model.js.map +1 -0
  628. package/dist/engine/tui/screens/deploy/doctor.d.ts +8 -0
  629. package/dist/engine/tui/screens/deploy/doctor.d.ts.map +1 -0
  630. package/dist/engine/tui/screens/deploy/doctor.js +153 -0
  631. package/dist/engine/tui/screens/deploy/doctor.js.map +1 -0
  632. package/dist/engine/tui/screens/deploy/fields.d.ts +123 -0
  633. package/dist/engine/tui/screens/deploy/fields.d.ts.map +1 -0
  634. package/dist/engine/tui/screens/deploy/fields.js +202 -0
  635. package/dist/engine/tui/screens/deploy/fields.js.map +1 -0
  636. package/dist/engine/tui/screens/deploy/flags-model.d.ts +67 -0
  637. package/dist/engine/tui/screens/deploy/flags-model.d.ts.map +1 -0
  638. package/dist/engine/tui/screens/deploy/flags-model.js +302 -0
  639. package/dist/engine/tui/screens/deploy/flags-model.js.map +1 -0
  640. package/dist/engine/tui/screens/deploy/index.d.ts +6 -0
  641. package/dist/engine/tui/screens/deploy/index.d.ts.map +1 -0
  642. package/dist/engine/tui/screens/deploy/index.js +83 -0
  643. package/dist/engine/tui/screens/deploy/index.js.map +1 -0
  644. package/dist/engine/tui/screens/deploy/install-model.d.ts +159 -0
  645. package/dist/engine/tui/screens/deploy/install-model.d.ts.map +1 -0
  646. package/dist/engine/tui/screens/deploy/install-model.js +319 -0
  647. package/dist/engine/tui/screens/deploy/install-model.js.map +1 -0
  648. package/dist/engine/tui/screens/deploy/install.d.ts +8 -0
  649. package/dist/engine/tui/screens/deploy/install.d.ts.map +1 -0
  650. package/dist/engine/tui/screens/deploy/install.js +361 -0
  651. package/dist/engine/tui/screens/deploy/install.js.map +1 -0
  652. package/dist/engine/tui/screens/deploy/model.d.ts +49 -0
  653. package/dist/engine/tui/screens/deploy/model.d.ts.map +1 -0
  654. package/dist/engine/tui/screens/deploy/model.js +59 -0
  655. package/dist/engine/tui/screens/deploy/model.js.map +1 -0
  656. package/dist/engine/tui/screens/deploy/run-model.d.ts +58 -0
  657. package/dist/engine/tui/screens/deploy/run-model.d.ts.map +1 -0
  658. package/dist/engine/tui/screens/deploy/run-model.js +117 -0
  659. package/dist/engine/tui/screens/deploy/run-model.js.map +1 -0
  660. package/dist/engine/tui/screens/deploy/run.d.ts +75 -0
  661. package/dist/engine/tui/screens/deploy/run.d.ts.map +1 -0
  662. package/dist/engine/tui/screens/deploy/run.js +201 -0
  663. package/dist/engine/tui/screens/deploy/run.js.map +1 -0
  664. package/dist/engine/tui/screens/deploy/status.d.ts +17 -0
  665. package/dist/engine/tui/screens/deploy/status.d.ts.map +1 -0
  666. package/dist/engine/tui/screens/deploy/status.js +107 -0
  667. package/dist/engine/tui/screens/deploy/status.js.map +1 -0
  668. package/dist/engine/tui/screens/deploy/update.d.ts +41 -0
  669. package/dist/engine/tui/screens/deploy/update.d.ts.map +1 -0
  670. package/dist/engine/tui/screens/deploy/update.js +175 -0
  671. package/dist/engine/tui/screens/deploy/update.js.map +1 -0
  672. package/dist/engine/tui/screens/deploy.d.ts +12 -0
  673. package/dist/engine/tui/screens/deploy.d.ts.map +1 -0
  674. package/dist/engine/tui/screens/deploy.js +23 -0
  675. package/dist/engine/tui/screens/deploy.js.map +1 -0
  676. package/dist/engine/tui/screens/invoke.d.ts +6 -0
  677. package/dist/engine/tui/screens/invoke.d.ts.map +1 -0
  678. package/dist/engine/tui/screens/invoke.js +193 -0
  679. package/dist/engine/tui/screens/invoke.js.map +1 -0
  680. package/dist/engine/tui/screens/login.d.ts +6 -0
  681. package/dist/engine/tui/screens/login.d.ts.map +1 -0
  682. package/dist/engine/tui/screens/login.js +255 -0
  683. package/dist/engine/tui/screens/login.js.map +1 -0
  684. package/dist/engine/tui/screens/logout.d.ts +6 -0
  685. package/dist/engine/tui/screens/logout.d.ts.map +1 -0
  686. package/dist/engine/tui/screens/logout.js +142 -0
  687. package/dist/engine/tui/screens/logout.js.map +1 -0
  688. package/dist/engine/tui/screens/menu.d.ts +22 -0
  689. package/dist/engine/tui/screens/menu.d.ts.map +1 -0
  690. package/dist/engine/tui/screens/menu.js +84 -0
  691. package/dist/engine/tui/screens/menu.js.map +1 -0
  692. package/dist/engine/tui/screens/node.d.ts +6 -0
  693. package/dist/engine/tui/screens/node.d.ts.map +1 -0
  694. package/dist/engine/tui/screens/node.js +228 -0
  695. package/dist/engine/tui/screens/node.js.map +1 -0
  696. package/dist/engine/tui/screens/status.d.ts +6 -0
  697. package/dist/engine/tui/screens/status.d.ts.map +1 -0
  698. package/dist/engine/tui/screens/status.js +134 -0
  699. package/dist/engine/tui/screens/status.js.map +1 -0
  700. package/dist/engine/tui/scroll-box.d.ts +27 -0
  701. package/dist/engine/tui/scroll-box.d.ts.map +1 -0
  702. package/dist/engine/tui/scroll-box.js +52 -0
  703. package/dist/engine/tui/scroll-box.js.map +1 -0
  704. package/dist/engine/tui/section-registry.d.ts +65 -0
  705. package/dist/engine/tui/section-registry.d.ts.map +1 -0
  706. package/dist/engine/tui/section-registry.js +90 -0
  707. package/dist/engine/tui/section-registry.js.map +1 -0
  708. package/dist/engine/tui/terminal.d.ts +31 -0
  709. package/dist/engine/tui/terminal.d.ts.map +1 -0
  710. package/dist/engine/tui/terminal.js +142 -0
  711. package/dist/engine/tui/terminal.js.map +1 -0
  712. package/dist/engine/tui/tty.d.ts +49 -0
  713. package/dist/engine/tui/tty.d.ts.map +1 -0
  714. package/dist/engine/tui/tty.js +139 -0
  715. package/dist/engine/tui/tty.js.map +1 -0
  716. package/dist/index.d.ts +10 -0
  717. package/dist/index.d.ts.map +1 -0
  718. package/dist/index.js +11 -0
  719. package/dist/index.js.map +1 -0
  720. package/dist/node/index.d.ts +3 -0
  721. package/dist/node/index.d.ts.map +1 -0
  722. package/dist/node/index.js +5 -0
  723. package/dist/node/index.js.map +1 -0
  724. package/dist/telemetry/env-fragment.d.ts +47 -0
  725. package/dist/telemetry/env-fragment.d.ts.map +1 -0
  726. package/dist/telemetry/env-fragment.js +73 -0
  727. package/dist/telemetry/env-fragment.js.map +1 -0
  728. package/dist/telemetry/index.d.ts +7 -0
  729. package/dist/telemetry/index.d.ts.map +1 -0
  730. package/dist/telemetry/index.js +7 -0
  731. package/dist/telemetry/index.js.map +1 -0
  732. package/dist/telemetry/node-span-relay.d.ts +107 -0
  733. package/dist/telemetry/node-span-relay.d.ts.map +1 -0
  734. package/dist/telemetry/node-span-relay.js +314 -0
  735. package/dist/telemetry/node-span-relay.js.map +1 -0
  736. package/dist/telemetry/node-span.d.ts +92 -0
  737. package/dist/telemetry/node-span.d.ts.map +1 -0
  738. package/dist/telemetry/node-span.js +28 -0
  739. package/dist/telemetry/node-span.js.map +1 -0
  740. package/dist/testing/index.d.ts +3 -0
  741. package/dist/testing/index.d.ts.map +1 -0
  742. package/dist/testing/index.js +4 -0
  743. package/dist/testing/index.js.map +1 -0
  744. package/dist/tui/index.d.ts +3 -0
  745. package/dist/tui/index.d.ts.map +1 -0
  746. package/dist/tui/index.js +5 -0
  747. package/dist/tui/index.js.map +1 -0
  748. package/package.json +102 -4
@@ -0,0 +1,198 @@
1
+ import { spawn } from 'node:child_process';
2
+ import { cpus, totalmem } from 'node:os';
3
+ import { getHeapStatistics } from 'node:v8';
4
+ import { envFlagOn } from './env-flags.js';
5
+ import { MAX_NODE_CONCURRENCY, MIN_NODE_CONCURRENCY } from './node-config.js';
6
+ import { workerEnv } from './worker-env.js';
7
+ // =============================================================================
8
+ // Runtime tuning (issue #277, epic #254)
9
+ // =============================================================================
10
+ //
11
+ // Node's default old-space limit is derived from a general-purpose heuristic,
12
+ // and it is low for a machine whose entire job is being a worker: a box with
13
+ // 32 GB of RAM can OOM at a fraction of it, while the operator watches `free`
14
+ // and sees nothing wrong. So a worker re-execs itself once with an explicit,
15
+ // RAM-aware `--max-old-space-size`.
16
+ //
17
+ // -----------------------------------------------------------------------------
18
+ // THE RE-EXEC MAKES THIS PROCESS A SIGNAL-FORWARDING SHIM, AND THAT IS THE
19
+ // PART WITH A TRAP IN IT
20
+ // -----------------------------------------------------------------------------
21
+ //
22
+ // After spawning the child, the parent is still PID 1 in a container and still
23
+ // the process systemd is supervising. If it does not forward signals, a
24
+ // container SIGTERM kills the shim and ORPHANS the worker — no drain, in-flight
25
+ // jobs abandoned, leases left to expire.
26
+ //
27
+ // And when the child dies FROM A SIGNAL, the shim must die of the SAME signal
28
+ // rather than exiting 0. A supervisor reads the exit reason: a shim that exits
29
+ // cleanly after its child was OOM-killed reports a clean shutdown, and the
30
+ // restart policy that should have fired does not.
31
+ //
32
+ // -----------------------------------------------------------------------------
33
+ // IT CAN NEVER LOOP
34
+ // -----------------------------------------------------------------------------
35
+ //
36
+ // Two independent guards, because either alone has a failure mode:
37
+ //
38
+ // - an ENV LATCH on the child — but an operator could set it by hand, or it
39
+ // could leak from a parent shell
40
+ // - a check of the heap limit ACTUALLY IN FORCE — but a platform that
41
+ // ignores the flag would then re-exec forever
42
+ //
43
+ // Requiring both means a spawn happens at most once per process tree.
44
+ // =============================================================================
45
+ /** Floor for the tuned heap. Below this, re-tuning is not worth a re-exec. */
46
+ export const MIN_HEAP_LIMIT_MB = 512;
47
+ /** Ceiling. Beyond this V8's own GC pauses become the problem. */
48
+ export const MAX_HEAP_LIMIT_MB = 8_192;
49
+ /** Fraction of total RAM to hand to the old space by default. */
50
+ export const HEAP_FRACTION_OF_RAM = 0.5;
51
+ /** The exit code a supervisor sees when the pre-OOM valve fires. */
52
+ export const EXIT_MEMORY_VALVE = 71;
53
+ /**
54
+ * How large the old space should be, in MB.
55
+ *
56
+ * `0` from the environment DISABLES re-tuning entirely — the escape hatch for a
57
+ * platform that manages memory itself (a cgroup with a hard limit, a PaaS that
58
+ * sets `NODE_OPTIONS`), where a second opinion is worse than none.
59
+ */
60
+ export function resolveHeapLimitMb(options) {
61
+ const env = options?.env ?? process.env;
62
+ const raw = env[workerEnv().heapLimitMb]?.trim();
63
+ if (raw !== undefined && raw.length > 0) {
64
+ const value = Number(raw);
65
+ if (!Number.isInteger(value) || value < 0) {
66
+ throw new RangeError(`${workerEnv().heapLimitMb} must be a whole number of megabytes, or 0 to disable.`);
67
+ }
68
+ if (value === 0)
69
+ return 0;
70
+ return clamp(value, MIN_HEAP_LIMIT_MB, MAX_HEAP_LIMIT_MB);
71
+ }
72
+ const total = options?.totalMemoryBytes ?? safeTotalMem();
73
+ if (total <= 0)
74
+ return 0;
75
+ return clamp(Math.round((total * HEAP_FRACTION_OF_RAM) / 1024 / 1024), MIN_HEAP_LIMIT_MB, MAX_HEAP_LIMIT_MB);
76
+ }
77
+ /** The old-space ceiling actually in force right now, in MB. */
78
+ export function currentHeapLimitMb() {
79
+ try {
80
+ return Math.round(getHeapStatistics().heap_size_limit / 1024 / 1024);
81
+ }
82
+ catch {
83
+ return 0;
84
+ }
85
+ }
86
+ /**
87
+ * Default concurrency, core- and RAM-aware.
88
+ *
89
+ * A flat `1` leaves a 16-core box almost entirely idle, and asking every
90
+ * operator to discover the flag is how a fleet ends up running at a fraction
91
+ * of what it was provisioned for. Bounded by RAM as well as cores because the
92
+ * limiting resource for a worker is usually memory per slot, not CPU.
93
+ */
94
+ export function resolveDefaultConcurrency(options) {
95
+ const cores = options?.cpuCount ?? safeCpuCount();
96
+ const totalMb = Math.round((options?.totalMemoryBytes ?? safeTotalMem()) / 1024 / 1024);
97
+ // One slot per core, minus one for everything else on the box; and one slot
98
+ // per gigabyte, so a 1 GB VPS with 8 cores does not run eight jobs.
99
+ const byCores = Math.max(1, cores - 1);
100
+ const byMemory = Math.max(1, Math.floor(totalMb / 1024));
101
+ return clamp(Math.min(byCores, byMemory), MIN_NODE_CONCURRENCY, MAX_NODE_CONCURRENCY);
102
+ }
103
+ /**
104
+ * Called as THE FIRST THING in `node start`, before config load.
105
+ *
106
+ * Before config load specifically: the re-exec replaces the process, so any
107
+ * work done first is work done twice — and a config error reported twice, from
108
+ * two processes, is a confusing first experience.
109
+ */
110
+ export function maybeReexecWithHeapLimit(options) {
111
+ const env = options?.env ?? process.env;
112
+ // Under a test runner a re-exec would spawn a second copy of the RUNNER, not
113
+ // of the worker. Detected rather than configured, so no suite has to
114
+ // remember to opt out.
115
+ const skip = options?.skip ?? isTestRunner(env);
116
+ if (skip)
117
+ return { reexeced: false, reason: 'skipped (test runner)', heapLimitMb: 0 };
118
+ let heapLimitMb;
119
+ try {
120
+ heapLimitMb = resolveHeapLimitMb({ env });
121
+ }
122
+ catch {
123
+ // A malformed value must not stop a worker starting; it simply does not
124
+ // get tuned, and `doctor` is where a human finds out.
125
+ return { reexeced: false, reason: 'invalid heap limit', heapLimitMb: 0 };
126
+ }
127
+ if (heapLimitMb === 0)
128
+ return { reexeced: false, reason: 'disabled', heapLimitMb: 0 };
129
+ // GUARD 1: the latch.
130
+ if (envFlagOn(env[workerEnv().heapTuned])) {
131
+ return { reexeced: false, reason: 'already tuned (latch)', heapLimitMb };
132
+ }
133
+ // GUARD 2: the limit actually in force. Within 10% counts as tuned — V8
134
+ // rounds, and re-execing to change 4096 into 4095 would be absurd.
135
+ const current = options?.currentLimitMb ?? currentHeapLimitMb();
136
+ if (current > 0 && current >= heapLimitMb * 0.9) {
137
+ return { reexeced: false, reason: 'already tuned (limit in force)', heapLimitMb };
138
+ }
139
+ const spawnImpl = options?.spawnFn ?? spawn;
140
+ const child = spawnImpl(options?.execPath ?? process.execPath, [`--max-old-space-size=${heapLimitMb}`, ...(options?.execArgv ?? []), ...(options?.argv ?? process.argv.slice(1))], {
141
+ stdio: 'inherit',
142
+ env: { ...env, [workerEnv().heapTuned]: '1' },
143
+ });
144
+ const exit = options?.exit ?? ((code) => process.exit(code));
145
+ const raise = options?.raise ??
146
+ ((signal) => {
147
+ // Re-raise with the default handler restored, so this process dies OF
148
+ // the signal rather than exiting 0. `process.exit(128 + n)` looks
149
+ // equivalent and is not: a supervisor reading `WIFSIGNALED` sees a clean
150
+ // exit, and the restart policy that should have fired does not.
151
+ process.removeAllListeners(signal);
152
+ process.kill(process.pid, signal);
153
+ });
154
+ const forward = options?.onSignal ?? ((handler) => {
155
+ for (const signal of ['SIGINT', 'SIGTERM', 'SIGHUP'])
156
+ process.on(signal, () => handler(signal));
157
+ });
158
+ forward((signal) => {
159
+ try {
160
+ child.kill(signal);
161
+ }
162
+ catch {
163
+ // The child is already gone; its `exit` handler below settles the shim.
164
+ }
165
+ });
166
+ child.on('exit', (code, signal) => {
167
+ if (signal !== null && signal !== undefined) {
168
+ raise(signal);
169
+ return;
170
+ }
171
+ exit(code ?? 0);
172
+ });
173
+ return { reexeced: true, reason: 'spawned tuned child', heapLimitMb, child };
174
+ }
175
+ /** Vitest and Jest both set these; neither should ever spawn a worker child. */
176
+ function isTestRunner(env) {
177
+ return env.VITEST !== undefined || env.JEST_WORKER_ID !== undefined || env.NODE_ENV === 'test';
178
+ }
179
+ function clamp(value, min, max) {
180
+ return Math.min(Math.max(value, min), max);
181
+ }
182
+ function safeTotalMem() {
183
+ try {
184
+ return totalmem();
185
+ }
186
+ catch {
187
+ return 0;
188
+ }
189
+ }
190
+ function safeCpuCount() {
191
+ try {
192
+ return cpus().length;
193
+ }
194
+ catch {
195
+ return 1;
196
+ }
197
+ }
198
+ //# sourceMappingURL=runtime-tuning.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"runtime-tuning.js","sourceRoot":"","sources":["../../../src/engine/node/runtime-tuning.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,39 @@
1
+ /** `appctl-node.service`. Derived from `CLI_NAME`, never written out. */
2
+ export declare function serviceUnitName(): string;
3
+ export interface ServiceContext {
4
+ home?: string | undefined;
5
+ platform?: NodeJS.Platform | undefined;
6
+ /** Test seam for `systemctl`. */
7
+ run?: ((args: string[]) => string) | undefined;
8
+ /** Absolute path of the CLI entrypoint the unit should exec. */
9
+ execPath?: string | undefined;
10
+ scriptPath?: string | undefined;
11
+ }
12
+ /** `~/.config/systemd/user`. */
13
+ export declare function userUnitDir(ctx?: ServiceContext): string;
14
+ export declare function userUnitPath(ctx?: ServiceContext): string;
15
+ /** Render the unit file. Pure, so its derived names are directly assertable. */
16
+ export declare function renderUnit(ctx?: ServiceContext): string;
17
+ export type ServiceAction = 'installed' | 'uninstalled' | 'unsupported' | 'absent';
18
+ export interface ServiceResult {
19
+ action: ServiceAction;
20
+ unitPath: string;
21
+ detail: string;
22
+ /** Extra guidance, e.g. the linger tip or the Windows alternative. */
23
+ guidance?: string | undefined;
24
+ }
25
+ /** Is there a user systemd on this machine? */
26
+ export declare function hasUserSystemd(ctx?: ServiceContext): boolean;
27
+ export declare function installService(ctx?: ServiceContext): ServiceResult;
28
+ export declare function uninstallService(ctx?: ServiceContext): ServiceResult;
29
+ export interface ServiceStatus {
30
+ installed: boolean;
31
+ /** systemd's own words: `active`, `inactive`, `failed`, … */
32
+ activeState: string | undefined;
33
+ enabled: boolean | undefined;
34
+ unitPath: string;
35
+ detail: string;
36
+ }
37
+ /** Reflects the REAL unit state, by asking systemd rather than by inference. */
38
+ export declare function serviceStatus(ctx?: ServiceContext): ServiceStatus;
39
+ //# sourceMappingURL=service.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../../src/engine/node/service.ts"],"names":[],"mappings":"AA4CA,yEAAyE;AACzE,wBAAgB,eAAe,IAAI,MAAM,CAExC;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC,QAAQ,GAAG,SAAS,CAAC;IACvC,iCAAiC;IACjC,GAAG,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,MAAM,CAAC,GAAG,SAAS,CAAC;IAC/C,gEAAgE;IAChE,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACjC;AAED,gCAAgC;AAChC,wBAAgB,WAAW,CAAC,GAAG,CAAC,EAAE,cAAc,GAAG,MAAM,CAExD;AAED,wBAAgB,YAAY,CAAC,GAAG,CAAC,EAAE,cAAc,GAAG,MAAM,CAEzD;AAED,gFAAgF;AAChF,wBAAgB,UAAU,CAAC,GAAG,CAAC,EAAE,cAAc,GAAG,MAAM,CA0BvD;AAED,MAAM,MAAM,aAAa,GAAG,WAAW,GAAG,aAAa,GAAG,aAAa,GAAG,QAAQ,CAAC;AAEnF,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,aAAa,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,sEAAsE;IACtE,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC/B;AAED,+CAA+C;AAC/C,wBAAgB,cAAc,CAAC,GAAG,CAAC,EAAE,cAAc,GAAG,OAAO,CAS5D;AA6CD,wBAAgB,cAAc,CAAC,GAAG,CAAC,EAAE,cAAc,GAAG,aAAa,CAuBlE;AAED,wBAAgB,gBAAgB,CAAC,GAAG,CAAC,EAAE,cAAc,GAAG,aAAa,CAoBpE;AAED,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,OAAO,CAAC;IACnB,6DAA6D;IAC7D,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,OAAO,EAAE,OAAO,GAAG,SAAS,CAAC;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,gFAAgF;AAChF,wBAAgB,aAAa,CAAC,GAAG,CAAC,EAAE,cAAc,GAAG,aAAa,CA2CjE"}
@@ -0,0 +1,211 @@
1
+ import { execFileSync } from 'node:child_process';
2
+ import { existsSync, mkdirSync, rmSync, writeFileSync } from 'node:fs';
3
+ import { homedir } from 'node:os';
4
+ import { join } from 'node:path';
5
+ import { cliIdentity, cliName } from '../identity.js';
6
+ // =============================================================================
7
+ // `node service` — a systemd USER unit (issue #276, epic #254)
8
+ // =============================================================================
9
+ //
10
+ // A worker installed by hand does not survive a reboot, and a worker that does
11
+ // not survive a reboot is one somebody has to remember. This writes the unit.
12
+ //
13
+ // -----------------------------------------------------------------------------
14
+ // A USER UNIT, NOT A SYSTEM ONE
15
+ // -----------------------------------------------------------------------------
16
+ //
17
+ // A system-wide unit needs root to install. A user unit does not, and a worker
18
+ // has no reason whatsoever to run as root — it reads a config file in the
19
+ // invoking user's home directory and talks HTTPS to one server. Installing it
20
+ // as the user who owns the credential is also the only way the unit finds that
21
+ // credential without a second copy of it somewhere readable by root.
22
+ //
23
+ // -----------------------------------------------------------------------------
24
+ // `Restart=on-failure` IS NOT DECORATION
25
+ // -----------------------------------------------------------------------------
26
+ //
27
+ // #277's memory watchdog EXITS DELIBERATELY when the heap crosses its
28
+ // threshold, after draining cleanly and writing a snapshot. Without a
29
+ // supervisor, that successful drain leaves the worker down — a self-healing
30
+ // mechanism that turns into an outage. The same is true of the container's
31
+ // `restart: unless-stopped` in #278.
32
+ //
33
+ // -----------------------------------------------------------------------------
34
+ // THE UNIT NAME IS DERIVED
35
+ // -----------------------------------------------------------------------------
36
+ //
37
+ // `<CLI_NAME>-node.service`, and the Description carries `APP_NAME`. Neither is
38
+ // written out, so a fork's rename reaches the unit file — and a test asserts
39
+ // exactly that, because the failure mode otherwise is a service called
40
+ // `appctl-node` on a product that has not been called that for a year.
41
+ // =============================================================================
42
+ /** `appctl-node.service`. Derived from `CLI_NAME`, never written out. */
43
+ export function serviceUnitName() {
44
+ return `${cliName()}-node.service`;
45
+ }
46
+ /** `~/.config/systemd/user`. */
47
+ export function userUnitDir(ctx) {
48
+ return join(ctx?.home ?? homedir(), '.config', 'systemd', 'user');
49
+ }
50
+ export function userUnitPath(ctx) {
51
+ return join(userUnitDir(ctx), serviceUnitName());
52
+ }
53
+ /** Render the unit file. Pure, so its derived names are directly assertable. */
54
+ export function renderUnit(ctx) {
55
+ const node = ctx?.execPath ?? process.execPath;
56
+ const script = ctx?.scriptPath ?? process.argv[1] ?? '';
57
+ return [
58
+ '[Unit]',
59
+ `Description=${cliIdentity().productName} worker node (${cliName()})`,
60
+ 'After=network-online.target',
61
+ 'Wants=network-online.target',
62
+ '',
63
+ '[Service]',
64
+ 'Type=simple',
65
+ // `--headless` so a systemd restart RE-ATTACHES to the existing node row
66
+ // instead of leaking one per restart.
67
+ `ExecStart=${node} ${script} node start --headless`,
68
+ // Required by #277's memory valve, which exits on purpose. See the header.
69
+ 'Restart=on-failure',
70
+ 'RestartSec=10',
71
+ // Long enough for a drain; systemd SIGKILLs after this.
72
+ 'TimeoutStopSec=300',
73
+ 'KillSignal=SIGTERM',
74
+ '',
75
+ '[Install]',
76
+ 'WantedBy=default.target',
77
+ '',
78
+ ].join('\n');
79
+ }
80
+ /** Is there a user systemd on this machine? */
81
+ export function hasUserSystemd(ctx) {
82
+ if ((ctx?.platform ?? process.platform) !== 'linux')
83
+ return false;
84
+ const run = ctx?.run ?? defaultSystemctl;
85
+ try {
86
+ run(['--user', 'show', '--property=Version']);
87
+ return true;
88
+ }
89
+ catch {
90
+ return false;
91
+ }
92
+ }
93
+ function defaultSystemctl(args) {
94
+ return execFileSync('systemctl', args, { encoding: 'utf8' });
95
+ }
96
+ /** Windows and no-user-systemd both get GUIDANCE, never a stack trace. */
97
+ function unsupported(ctx, unitPath) {
98
+ const platform = ctx?.platform ?? process.platform;
99
+ if (platform === 'win32') {
100
+ return {
101
+ action: 'unsupported',
102
+ unitPath,
103
+ detail: 'Windows has no systemd.',
104
+ guidance: `Run the worker in the background with \`${cliName()} node start --daemon\`, or wrap it in a ` +
105
+ 'Scheduled Task set to run at startup with "Run whether user is logged on or not".',
106
+ };
107
+ }
108
+ if (platform === 'darwin') {
109
+ return {
110
+ action: 'unsupported',
111
+ unitPath,
112
+ detail: 'macOS uses launchd, not systemd.',
113
+ guidance: `Run \`${cliName()} node start --daemon\`, or write a launchd agent that execs the same command.`,
114
+ };
115
+ }
116
+ if (!hasUserSystemd(ctx)) {
117
+ return {
118
+ action: 'unsupported',
119
+ unitPath,
120
+ detail: 'No per-user systemd instance is available here.',
121
+ guidance: 'This is normal inside a container and inside WSL 1. On WSL 2, enable systemd by adding ' +
122
+ '`[boot]\\nsystemd=true` to /etc/wsl.conf and running `wsl --shutdown`. ' +
123
+ `Otherwise run \`${cliName()} node start --daemon\`.`,
124
+ };
125
+ }
126
+ return undefined;
127
+ }
128
+ export function installService(ctx) {
129
+ const unitPath = userUnitPath(ctx);
130
+ const blocked = unsupported(ctx, unitPath);
131
+ if (blocked !== undefined)
132
+ return blocked;
133
+ mkdirSync(userUnitDir(ctx), { recursive: true });
134
+ writeFileSync(unitPath, renderUnit(ctx), { encoding: 'utf8', mode: 0o644 });
135
+ const run = ctx?.run ?? defaultSystemctl;
136
+ run(['--user', 'daemon-reload']);
137
+ run(['--user', 'enable', '--now', serviceUnitName()]);
138
+ return {
139
+ action: 'installed',
140
+ unitPath,
141
+ detail: `Installed and started ${serviceUnitName()}.`,
142
+ // THE STEP PEOPLE MISS. Without lingering, a user unit stops when the last
143
+ // session for that user ends — so a worker on a box you SSH into dies when
144
+ // you log out, which reads as a crash rather than as policy.
145
+ guidance: `Run \`loginctl enable-linger $USER\` so the worker keeps running after you log out, ` +
146
+ `and survives a reboot without anybody logging in.`,
147
+ };
148
+ }
149
+ export function uninstallService(ctx) {
150
+ const unitPath = userUnitPath(ctx);
151
+ const blocked = unsupported(ctx, unitPath);
152
+ if (blocked !== undefined)
153
+ return blocked;
154
+ if (!existsSync(unitPath)) {
155
+ return { action: 'absent', unitPath, detail: 'No unit is installed here.' };
156
+ }
157
+ const run = ctx?.run ?? defaultSystemctl;
158
+ try {
159
+ run(['--user', 'disable', '--now', serviceUnitName()]);
160
+ }
161
+ catch {
162
+ // A unit that is already stopped, or was never enabled, must not make
163
+ // uninstall fail — the file removal below is the part that matters.
164
+ }
165
+ rmSync(unitPath, { force: true });
166
+ run(['--user', 'daemon-reload']);
167
+ return { action: 'uninstalled', unitPath, detail: `Removed ${serviceUnitName()}.` };
168
+ }
169
+ /** Reflects the REAL unit state, by asking systemd rather than by inference. */
170
+ export function serviceStatus(ctx) {
171
+ const unitPath = userUnitPath(ctx);
172
+ const installed = existsSync(unitPath);
173
+ const platform = ctx?.platform ?? process.platform;
174
+ if (platform !== 'linux' || !hasUserSystemd(ctx)) {
175
+ return {
176
+ installed,
177
+ activeState: undefined,
178
+ enabled: undefined,
179
+ unitPath,
180
+ detail: unsupported(ctx, unitPath)?.detail ?? 'systemd is not available here.',
181
+ };
182
+ }
183
+ const run = ctx?.run ?? defaultSystemctl;
184
+ let activeState;
185
+ try {
186
+ activeState = run(['--user', 'show', serviceUnitName(), '--property=ActiveState', '--value']).trim();
187
+ }
188
+ catch {
189
+ activeState = undefined;
190
+ }
191
+ let enabled;
192
+ try {
193
+ enabled = run(['--user', 'is-enabled', serviceUnitName()]).trim() === 'enabled';
194
+ }
195
+ catch {
196
+ // `is-enabled` EXITS NON-ZERO for a disabled unit, which is an answer, not
197
+ // an error — but it also exits non-zero for a unit that does not exist, so
198
+ // the file check above is what distinguishes them.
199
+ enabled = installed ? false : undefined;
200
+ }
201
+ return {
202
+ installed,
203
+ activeState,
204
+ enabled,
205
+ unitPath,
206
+ detail: installed
207
+ ? `${serviceUnitName()} is ${activeState ?? 'unknown'}${enabled === true ? ' and enabled' : ''}.`
208
+ : 'No unit is installed here.',
209
+ };
210
+ }
211
+ //# sourceMappingURL=service.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"service.js","sourceRoot":"","sources":["../../../src/engine/node/service.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,62 @@
1
+ import { type NodeApi } from './node-api.js';
2
+ import { NodeEngine } from './node-engine.js';
3
+ import { NodeLogger } from './logger.js';
4
+ import { type DaemonHost } from './daemon.js';
5
+ import { type NodePathsContext } from './paths.js';
6
+ import { type ResolvedNodeConfig } from './node-config.js';
7
+ import { type CapabilityProbe, type JobTypeRequirements } from './capabilities.js';
8
+ import { MemoryWatchdog } from './memory-watchdog.js';
9
+ export interface StartNodeOptions extends NodePathsContext {
10
+ /** Drain-without-deregister on SIGTERM. Also settable through the environment. */
11
+ headless?: boolean | undefined;
12
+ /** Streams. Human output goes to stderr, per program.ts. */
13
+ stderr?: {
14
+ write(chunk: string): unknown;
15
+ } | undefined;
16
+ /** Test seams. */
17
+ createApi?: ((config: ResolvedNodeConfig) => NodeApi) | undefined;
18
+ /** Replaces the signal wiring, which a test must not install globally. */
19
+ installSignalHandlers?: ((handler: (signal: NodeJS.Signals) => void) => void) | undefined;
20
+ /** Wired by #277. */
21
+ writeHeapSnapshot?: (() => Promise<{
22
+ path: string;
23
+ size: number;
24
+ }>) | undefined;
25
+ capabilities?: Record<string, unknown> | undefined;
26
+ /** Overrides the capability probe. Injected by tests; never in production. */
27
+ probe?: CapabilityProbe | undefined;
28
+ /** Overrides `JOB_TYPE_REQUIREMENTS`. A fork could supply its own map here. */
29
+ requirements?: Record<string, JobTypeRequirements> | undefined;
30
+ /**
31
+ * Run the startup self-test. Defaults to ON in headless mode, where a hard
32
+ * exit is a visible crash-loop with a reason; interactive runs default to
33
+ * warning, because a human is right there to read it.
34
+ */
35
+ selfTest?: boolean | undefined;
36
+ /** Replaces `process.exit` for the self-test's hard failure. */
37
+ exit?: ((code: number) => never) | undefined;
38
+ /** `false` disables the memory watchdog for this run (#277). */
39
+ watchdog?: boolean | undefined;
40
+ /** `false` sends heartbeats without `vitals` (#605). Test seam; on by default. */
41
+ vitals?: boolean | undefined;
42
+ }
43
+ /** Exit code for "this node cannot do the work it advertised". */
44
+ export declare const EXIT_MISSING_CAPABILITY = 70;
45
+ export interface StartedNode {
46
+ engine: NodeEngine;
47
+ /** `undefined` when the watchdog is disabled. */
48
+ watchdog: MemoryWatchdog | undefined;
49
+ host: DaemonHost;
50
+ logger: NodeLogger;
51
+ config: ResolvedNodeConfig;
52
+ /** Resolves when the engine has drained and the socket is closed. */
53
+ finished: Promise<void>;
54
+ }
55
+ /**
56
+ * Start a worker in this process and return once it is serving.
57
+ *
58
+ * Returns rather than awaiting the run loop, so a caller can hold the handle —
59
+ * which is what makes this testable and what #279's TUI needs.
60
+ */
61
+ export declare function startNode(options?: StartNodeOptions): Promise<StartedNode>;
62
+ //# sourceMappingURL=start.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"start.d.ts","sourceRoot":"","sources":["../../../src/engine/node/start.ts"],"names":[],"mappings":"AACA,OAAO,EAAe,KAAK,OAAO,EAAE,MAAM,eAAe,CAAC;AAE1D,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C,OAAO,EAAE,UAAU,EAAgC,MAAM,aAAa,CAAC;AACvE,OAAO,EAAmB,KAAK,UAAU,EAAE,MAAM,aAAa,CAAC;AAC/D,OAAO,EAAsE,KAAK,gBAAgB,EAAE,MAAM,YAAY,CAAC;AACvH,OAAO,EAAqC,KAAK,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAC9F,OAAO,EAGL,KAAK,eAAe,EACpB,KAAK,mBAAmB,EACzB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,cAAc,EAAyB,MAAM,sBAAsB,CAAC;AAyB7E,MAAM,WAAW,gBAAiB,SAAQ,gBAAgB;IACxD,kFAAkF;IAClF,QAAQ,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC/B,4DAA4D;IAC5D,MAAM,CAAC,EAAE;QAAE,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,GAAG,SAAS,CAAC;IACvD,kBAAkB;IAClB,SAAS,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,kBAAkB,KAAK,OAAO,CAAC,GAAG,SAAS,CAAC;IAClE,0EAA0E;IAC1E,qBAAqB,CAAC,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,OAAO,KAAK,IAAI,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;IAC1F,qBAAqB;IACrB,iBAAiB,CAAC,EAAE,CAAC,MAAM,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC,GAAG,SAAS,CAAC;IAChF,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;IACnD,8EAA8E;IAC9E,KAAK,CAAC,EAAE,eAAe,GAAG,SAAS,CAAC;IACpC,+EAA+E;IAC/E,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,GAAG,SAAS,CAAC;IAC/D;;;;OAIG;IACH,QAAQ,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC/B,gEAAgE;IAChE,IAAI,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,KAAK,KAAK,CAAC,GAAG,SAAS,CAAC;IAC7C,gEAAgE;IAChE,QAAQ,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC/B,kFAAkF;IAClF,MAAM,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CAC9B;AAED,kEAAkE;AAClE,eAAO,MAAM,uBAAuB,KAAK,CAAC;AAE1C,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,UAAU,CAAC;IACnB,iDAAiD;IACjD,QAAQ,EAAE,cAAc,GAAG,SAAS,CAAC;IACrC,IAAI,EAAE,UAAU,CAAC;IACjB,MAAM,EAAE,UAAU,CAAC;IACnB,MAAM,EAAE,kBAAkB,CAAC;IAC3B,qEAAqE;IACrE,QAAQ,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;CACzB;AAED;;;;;GAKG;AACH,wBAAsB,SAAS,CAAC,OAAO,GAAE,gBAAqB,GAAG,OAAO,CAAC,WAAW,CAAC,CA6LpF"}