@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,245 @@
1
+ import { cliName } from '../identity.js';
2
+ import { HttpNodeApi } from './node-api.js';
3
+ import { registerNode } from './enrollment.js';
4
+ import { NodeEngine } from './node-engine.js';
5
+ import { NodeLogger, readLogTail, formatLogRecord } from './logger.js';
6
+ import { startDaemonHost } from './daemon.js';
7
+ import { nodeLogPath, nodePidPath, nodeSocketPath, nodeStateDir, nodeTmpDir } from './paths.js';
8
+ import { resolveNodeConfig, saveNodeConfig } from './node-config.js';
9
+ import { probeCapabilities, runStartupSelfTest, } from './capabilities.js';
10
+ import { MemoryWatchdog, memoryWatchdogEnabled } from './memory-watchdog.js';
11
+ import { writeHeapSnapshot } from './heap-snapshot.js';
12
+ import { resolveDefaultConcurrency } from './runtime-tuning.js';
13
+ import { snapshotsDir } from './paths.js';
14
+ import { NodeVitalsProvider } from './node-vitals.js';
15
+ /** Exit code for "this node cannot do the work it advertised". */
16
+ export const EXIT_MISSING_CAPABILITY = 70;
17
+ /**
18
+ * Start a worker in this process and return once it is serving.
19
+ *
20
+ * Returns rather than awaiting the run loop, so a caller can hold the handle —
21
+ * which is what makes this testable and what #279's TUI needs.
22
+ */
23
+ export async function startNode(options = {}) {
24
+ const stderr = options.stderr ?? process.stderr;
25
+ const pathCtx = {
26
+ ...(options.env !== undefined ? { env: options.env } : {}),
27
+ ...(options.home !== undefined ? { home: options.home } : {}),
28
+ ...(options.platform !== undefined ? { platform: options.platform } : {}),
29
+ };
30
+ // The RAM- and core-aware default lands here rather than in `node-config.ts`
31
+ // so the config module stays free of any runtime-tuning dependency; an
32
+ // explicit setting in the file or the environment still wins.
33
+ const config = resolveNodeConfig({ ...pathCtx, defaultConcurrency: resolveDefaultConcurrency() });
34
+ const headless = options.headless ?? config.headless;
35
+ const logger = new NodeLogger({
36
+ path: nodeLogPath(pathCtx),
37
+ // In the foreground a human wants to see what is happening; a detached run
38
+ // has its stdio redirected to the same file anyway, so mirroring would
39
+ // double every line.
40
+ ...(headless ? {} : { mirror: (record) => stderr.write(`${formatLogRecord(record)}\n`) }),
41
+ });
42
+ // ---------------------------------------------------------------------------
43
+ // The startup self-test (#276), BEFORE anything is registered or claimed
44
+ // ---------------------------------------------------------------------------
45
+ // A node that cannot do the work it advertised must not reach the claim loop:
46
+ // there it would take a lease, fail it, and charge the job an attempt — once
47
+ // per job, looking healthy the whole time.
48
+ const probe = options.probe ?? probeCapabilities();
49
+ const selfTestEnabled = options.selfTest ?? headless;
50
+ if (selfTestEnabled) {
51
+ const failures = [];
52
+ const result = runStartupSelfTest({
53
+ types: config.node.eligibleTypes,
54
+ probe,
55
+ ...(options.requirements !== undefined ? { requirements: options.requirements } : {}),
56
+ warn: (message) => logger.warn(message),
57
+ fail: (message) => {
58
+ logger.error(message);
59
+ failures.push(message);
60
+ },
61
+ });
62
+ if (!result.ok) {
63
+ stderr.write(`${failures.join('\n')}\n`);
64
+ const exit = options.exit ?? ((code) => process.exit(code));
65
+ exit(EXIT_MISSING_CAPABILITY);
66
+ }
67
+ }
68
+ const api = options.createApi?.(config) ?? HttpNodeApi.create(config.serverUrl, config.token);
69
+ // Register on first start. `validateTypes: false` because a start must not
70
+ // fail because `GET /nodes/job-types` was briefly unavailable — the server
71
+ // re-checks every claim against its own registry regardless.
72
+ let nodeId = config.nodeId;
73
+ if (nodeId === undefined) {
74
+ const registered = await registerNode({
75
+ api,
76
+ node: config.node,
77
+ validateTypes: false,
78
+ configContext: pathCtx,
79
+ ...(options.capabilities !== undefined ? { capabilities: options.capabilities } : {}),
80
+ });
81
+ nodeId = registered.node.id;
82
+ logger.info(registered.reattached ? 'reattached to node' : 'registered node', {
83
+ nodeId,
84
+ name: registered.node.name,
85
+ });
86
+ }
87
+ let host;
88
+ // The vitals provider (#605). The watchdog is built AFTER the engine (its
89
+ // valve stops the engine), so the provider reads it through this late-bound
90
+ // reference; until it is assigned — or when the watchdog is disabled — the
91
+ // heartbeat simply reports no `watchdogTrips`.
92
+ let watchdogRef;
93
+ const vitals = options.vitals === false
94
+ ? undefined
95
+ : new NodeVitalsProvider({
96
+ stateDir: nodeStateDir(pathCtx),
97
+ watchdogState: () => watchdogRef?.getState(),
98
+ });
99
+ const engine = new NodeEngine({
100
+ api,
101
+ nodeId,
102
+ concurrency: config.node.concurrency,
103
+ eligibleTypes: config.node.eligibleTypes,
104
+ pollIntervalMs: config.node.pollIntervalMs,
105
+ tmpDir: nodeTmpDir(pathCtx),
106
+ capabilities: { ...(options.capabilities ?? {}), probe: { ...probe } },
107
+ ...(vitals !== undefined ? { collectVitals: (input) => vitals.collect(input) } : {}),
108
+ persistConcurrency: (value) => {
109
+ saveNodeConfig({ node: { concurrency: value } }, { ...pathCtx, degradeOnFailure: true });
110
+ },
111
+ onEvent: (event) => {
112
+ logEvent(logger, event);
113
+ host?.broadcast(event);
114
+ },
115
+ });
116
+ // The `heap-snapshot` IPC command asks the LIVE daemon to write one, which
117
+ // is the point: restarting to attach a diagnostic flag discards exactly the
118
+ // accumulated state that names the retainer.
119
+ const snapshotWriter = options.writeHeapSnapshot ??
120
+ (async () => {
121
+ const result = writeHeapSnapshot({ dir: snapshotsDir(pathCtx), reason: 'manual', ...(options.env !== undefined ? { env: options.env } : {}) });
122
+ if (!result.written)
123
+ throw new Error(result.skipped ?? 'The snapshot could not be written.');
124
+ return { path: result.path ?? '', size: result.size ?? 0 };
125
+ });
126
+ host = await startDaemonHost(engine, logger, {
127
+ pidPath: nodePidPath(pathCtx),
128
+ socketPath: nodeSocketPath(pathCtx),
129
+ logTail: () => readLogTail(nodeLogPath(pathCtx), 50),
130
+ writeHeapSnapshot: snapshotWriter,
131
+ });
132
+ // ---------------------------------------------------------------------------
133
+ // The memory watchdog (#277)
134
+ // ---------------------------------------------------------------------------
135
+ // ⚠ Its valve EXITS DELIBERATELY after a clean drain. Without a supervisor —
136
+ // `Restart=on-failure` (#276) or `restart: unless-stopped` (#278) — that
137
+ // successful drain leaves the worker down.
138
+ const watchdog = options.watchdog === false || !memoryWatchdogEnabled(options.env ?? process.env)
139
+ ? undefined
140
+ : new MemoryWatchdog({
141
+ snapshotDir: snapshotsDir(pathCtx),
142
+ ...(options.env !== undefined ? { env: options.env } : {}),
143
+ stop: () => engine.stop({ deregister: false }),
144
+ log: (message, fields) => logger.warn(message, fields),
145
+ });
146
+ watchdogRef = watchdog;
147
+ watchdog?.start();
148
+ const install = options.installSignalHandlers ??
149
+ ((handler) => {
150
+ for (const signal of ['SIGINT', 'SIGTERM', 'SIGHUP'])
151
+ process.on(signal, () => handler(signal));
152
+ });
153
+ let shuttingDown = false;
154
+ install((signal) => {
155
+ if (shuttingDown)
156
+ return;
157
+ shuttingDown = true;
158
+ logger.info('shutdown signal received', { signal, headless });
159
+ // THE ONE BRANCH THAT MATTERS. See the file header.
160
+ void engine.stop({ deregister: !headless });
161
+ });
162
+ const finished = engine
163
+ .run()
164
+ .then(async () => {
165
+ watchdog?.stop();
166
+ vitals?.stop();
167
+ await host?.close();
168
+ })
169
+ .catch(async (error) => {
170
+ logger.error('worker exited with an error', { error: error instanceof Error ? error.message : String(error) });
171
+ watchdog?.stop();
172
+ vitals?.stop();
173
+ await host?.close();
174
+ throw error;
175
+ });
176
+ logger.info('worker started', {
177
+ nodeId,
178
+ name: config.node.name,
179
+ concurrency: config.node.concurrency,
180
+ types: engine.claimableTypes(),
181
+ headless,
182
+ });
183
+ if (!headless) {
184
+ stderr.write(`Worker ${config.node.name} (${nodeId}) is running.\n` +
185
+ ` Concurrency ${config.node.concurrency}; types ${engine.claimableTypes().length > 0 ? engine.claimableTypes().join(', ') : '(none — this node has no executors)'}\n` +
186
+ ` Attach from another terminal: ${cliName()} node status\n`);
187
+ }
188
+ return { engine, host, logger, config, watchdog, finished };
189
+ }
190
+ /**
191
+ * One engine event → one log line.
192
+ *
193
+ * Kept OUT of the engine deliberately: the engine is UI-free and must stay
194
+ * renderable by a printer, the IPC broadcast and the TUI without any of them
195
+ * inheriting a logging opinion from it.
196
+ */
197
+ function logEvent(logger, event) {
198
+ switch (event.kind) {
199
+ case 'job-succeeded':
200
+ logger.info('job succeeded', { jobId: event.jobId, type: event.type, durationMs: event.durationMs });
201
+ return;
202
+ case 'job-failed':
203
+ logger.error('job failed', {
204
+ jobId: event.jobId,
205
+ type: event.type,
206
+ error: event.error,
207
+ rateLimited: event.rateLimited,
208
+ willRetry: event.willRetry,
209
+ });
210
+ return;
211
+ case 'job-started':
212
+ logger.info('job started', { jobId: event.jobId, type: event.type });
213
+ return;
214
+ case 'lease-renew-failed':
215
+ logger.warn('lease renew failed', { jobId: event.jobId, error: event.error });
216
+ return;
217
+ case 'heartbeat-failed':
218
+ logger.warn('heartbeat failed', { error: event.error });
219
+ return;
220
+ case 'vitals-disabled':
221
+ logger.warn('server refused heartbeat vitals; not sending them again this process', { error: event.error });
222
+ return;
223
+ case 'telemetry-disabled':
224
+ logger.warn('server has no span relay (older API); not sending job spans again this process', { error: event.error });
225
+ return;
226
+ case 'claim-failed':
227
+ logger.warn('claim failed', { error: event.error });
228
+ return;
229
+ case 'concurrency-changed':
230
+ logger.info('concurrency changed', { concurrency: event.concurrency });
231
+ return;
232
+ case 'draining':
233
+ logger.info('draining', { inFlight: event.inFlight });
234
+ return;
235
+ case 'stopped':
236
+ logger.info('stopped', { deregistered: event.deregistered });
237
+ return;
238
+ default:
239
+ // `idle`, `claimed`, `heartbeat`, `job-input`, `job-log`, `lease-renewed`
240
+ // and `started` are high-volume or uninteresting on their own; they still
241
+ // reach attached clients through the broadcast.
242
+ logger.debug(event.kind, { event });
243
+ }
244
+ }
245
+ //# sourceMappingURL=start.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"start.js","sourceRoot":"","sources":["../../../src/engine/node/start.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,15 @@
1
+ /** The HTML comment markers `apps/cli/README.md` wraps the generated table in. */
2
+ export declare const WORKER_ENV_TABLE_START = "<!-- GENERATED:WORKER_ENV_TABLE:START -->";
3
+ export declare const WORKER_ENV_TABLE_END = "<!-- GENERATED:WORKER_ENV_TABLE:END -->";
4
+ /**
5
+ * Builds the markdown table, one row per `WORKER_ENV` entry, in the object's
6
+ * own declaration order (identity pair first, then work, then runtime, then
7
+ * memory — the same order `worker-env.ts` already reads in).
8
+ *
9
+ * Every key is included, `heapTuned` (the re-exec latch) among them — there
10
+ * is no hand-picked "operator-facing" subset to keep in sync with the map;
11
+ * its own JSDoc says plainly that it is not a knob to set by hand, and that
12
+ * warning reaches the table for the same reason everything else here does.
13
+ */
14
+ export declare function buildWorkerEnvTable(): string;
15
+ //# sourceMappingURL=worker-env-table.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"worker-env-table.d.ts","sourceRoot":"","sources":["../../../src/engine/node/worker-env-table.ts"],"names":[],"mappings":"AAmFA,kFAAkF;AAClF,eAAO,MAAM,sBAAsB,8CAA8C,CAAC;AAClF,eAAO,MAAM,oBAAoB,4CAA4C,CAAC;AAE9E;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,CAU5C"}
@@ -0,0 +1,97 @@
1
+ import { readFileSync } from 'node:fs';
2
+ import { dirname, join } from 'node:path';
3
+ import { fileURLToPath } from 'node:url';
4
+ import { workerEnv } from './worker-env.js';
5
+ // =============================================================================
6
+ // The "Worker environment variables" table, generated from WORKER_ENV
7
+ // (issue #289, epic #254 — the documentation rollup)
8
+ // =============================================================================
9
+ //
10
+ // `apps/cli/README.md`'s worker environment variable table used to be typed
11
+ // out by hand, one row per `WORKER_ENV` entry. That is exactly the shape of
12
+ // drift `worker-env.ts`'s own header warns about: a variable renamed or added
13
+ // there is a variable the README silently stops describing correctly, and
14
+ // nothing fails — the same failure mode `worker-env.test.ts`'s branding guard
15
+ // exists to catch for the Dockerfile and compose file, one layer up.
16
+ //
17
+ // So the table is DERIVED, not retyped:
18
+ //
19
+ // - the VARIABLE NAME comes from `WORKER_ENV` itself (imported, never
20
+ // hand-copied), so a rename in `branding.ts` is reflected with zero edits
21
+ // here — exactly the property the map's own header promises;
22
+ // - the DESCRIPTION comes from the JSDoc comment already sitting above each
23
+ // property in `worker-env.ts`. That is the ONLY place a human writes this
24
+ // text; there is no second copy for a doc writer to keep in sync.
25
+ //
26
+ // `worker-env-table.test.ts` asserts the committed table in
27
+ // `apps/cli/README.md` (the block between the two marker comments below)
28
+ // equals what this module generates, so a drifted table is a failing test in
29
+ // CI rather than a stale doc nobody notices. `scripts/generate-worker-env
30
+ // -table.ts` is the writer that regenerates it.
31
+ // =============================================================================
32
+ const HERE = dirname(fileURLToPath(import.meta.url));
33
+ /**
34
+ * Extracts the JSDoc comment immediately preceding each `WORKER_ENV` property,
35
+ * keyed by the property's own name (`serverUrl`, `nodeId`, ...).
36
+ *
37
+ * Reads `worker-env.ts` as TEXT rather than reflecting on the imported object,
38
+ * because the description is not a runtime value — it lives only in the
39
+ * comment. This mirrors `apps/cli/src/deploy/env-spec.ts`'s own approach to
40
+ * `.env.example`: the file's comments ARE the specification, parsed rather
41
+ * than restated.
42
+ */
43
+ function parseWorkerEnvDescriptions() {
44
+ const source = readFileSync(join(HERE, 'worker-env.ts'), 'utf8');
45
+ const descriptions = {};
46
+ // A `/** ... */` block immediately followed by ` <key>:` — the exact shape
47
+ // every entry in the `WORKER_ENV` object literal takes. The leading
48
+ // `[ \t]+` before `/**` is load-bearing: it is what excludes the doc
49
+ // comment above `export const WORKER_ENV = {` itself, which starts at
50
+ // column 0 rather than indented inside the object literal. Without it, a
51
+ // `/** ... */` whose own trailing-key check fails (the file-level comment
52
+ // is followed by `export const`, not a bare identifier and colon) makes the
53
+ // non-greedy `[\s\S]*?` backtrack PAST that comment's own closing `*/` and
54
+ // swallow everything up to the NEXT one — merging two unrelated comments
55
+ // into one description.
56
+ const pattern = /^[ \t]+\/\*\*([\s\S]*?)\*\/\s*\n[ \t]+(\w+):/gm;
57
+ for (const match of source.matchAll(pattern)) {
58
+ const raw = match[1] ?? '';
59
+ const key = match[2];
60
+ // Strip each line's leading `*`, collapse paragraph breaks to a single
61
+ // space. A multi-paragraph comment (heapTuned's) becomes one flowing
62
+ // description rather than only its first sentence — nothing in the
63
+ // comment is discarded on the way into the table.
64
+ const text = raw
65
+ .split('\n')
66
+ .map((line) => line.replace(/^\s*\*\s?/, '').trim())
67
+ .filter((line) => line.length > 0)
68
+ .join(' ')
69
+ .trim();
70
+ if (text.length > 0)
71
+ descriptions[key] = text;
72
+ }
73
+ return descriptions;
74
+ }
75
+ /** The HTML comment markers `apps/cli/README.md` wraps the generated table in. */
76
+ export const WORKER_ENV_TABLE_START = '<!-- GENERATED:WORKER_ENV_TABLE:START -->';
77
+ export const WORKER_ENV_TABLE_END = '<!-- GENERATED:WORKER_ENV_TABLE:END -->';
78
+ /**
79
+ * Builds the markdown table, one row per `WORKER_ENV` entry, in the object's
80
+ * own declaration order (identity pair first, then work, then runtime, then
81
+ * memory — the same order `worker-env.ts` already reads in).
82
+ *
83
+ * Every key is included, `heapTuned` (the re-exec latch) among them — there
84
+ * is no hand-picked "operator-facing" subset to keep in sync with the map;
85
+ * its own JSDoc says plainly that it is not a knob to set by hand, and that
86
+ * warning reaches the table for the same reason everything else here does.
87
+ */
88
+ export function buildWorkerEnvTable() {
89
+ const descriptions = parseWorkerEnvDescriptions();
90
+ const rows = Object.keys(workerEnv()).map((key) => {
91
+ const name = workerEnv()[key];
92
+ const description = descriptions[key] ?? '';
93
+ return `| \`${name}\` | ${description} |`;
94
+ });
95
+ return ['| Variable | Description |', '| --- | --- |', ...rows].join('\n');
96
+ }
97
+ //# sourceMappingURL=worker-env-table.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"worker-env-table.js","sourceRoot":"","sources":["../../../src/engine/node/worker-env-table.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,50 @@
1
+ /**
2
+ * Every environment variable a worker node reads.
3
+ *
4
+ * Keys are the internal names code uses; values are the actual variable names
5
+ * a user sets. Adding a variable means adding it here first — #278's guard
6
+ * asserts this map and the container files agree in BOTH directions, so a
7
+ * variable that exists in only one of the two places is a failing test.
8
+ */
9
+ export declare function workerEnv(): {
10
+ /** `APPCTL_SERVER_URL` — reused from `config.ts`, never minted again. */
11
+ readonly serverUrl: string;
12
+ /** `APPCTL_TOKEN` — reused from `config.ts`. A `nod_` credential, normally. */
13
+ readonly token: string;
14
+ /** The node row this process re-attaches to, so a restart is not a new node. */
15
+ readonly nodeId: string;
16
+ /** Display name; defaults to the hostname. Reattachment keys on it server-side. */
17
+ readonly nodeName: string;
18
+ /** How many jobs this process runs at once. 1–64, per the server's own cap. */
19
+ readonly concurrency: string;
20
+ /** Comma-separated job types this node will claim. Empty means "all it can". */
21
+ readonly types: string;
22
+ /** Idle poll interval in milliseconds. */
23
+ readonly pollMs: string;
24
+ /** `true` to run without a TTY and drain on SIGTERM WITHOUT deregistering. */
25
+ readonly headless: string;
26
+ /** Overrides the state directory. The one variable a container almost always sets. */
27
+ readonly stateDir: string;
28
+ /** Old-space limit in MB for the re-exec. `0` disables re-tuning entirely. */
29
+ readonly heapLimitMb: string;
30
+ /**
31
+ * The re-exec LATCH. Set by the parent shim on the child it spawns.
32
+ *
33
+ * Not an operator knob — it exists so the re-exec cannot loop. It is still
34
+ * declared here rather than read as a literal, because the rule this map
35
+ * enforces has no exceptions: a variable the code reads is a variable a
36
+ * rename must reach.
37
+ */
38
+ readonly heapTuned: string;
39
+ /** `false` to disable the memory watchdog and its pre-OOM valve. */
40
+ readonly memoryWatchdog: string;
41
+ /** heapUsed/heapLimit fraction at which the valve fires. Default ~0.9. */
42
+ readonly memoryThreshold: string;
43
+ /** `false` to disable ALL THREE heap-snapshot paths. */
44
+ readonly heapSnapshots: string;
45
+ };
46
+ /** The key set of `WORKER_ENV`, for exhaustive iteration in guards and docs. */
47
+ export type WorkerEnvKey = keyof ReturnType<typeof workerEnv>;
48
+ /** Every variable name the worker reads, deduplicated and sorted. */
49
+ export declare function workerEnvNames(): string[];
50
+ //# sourceMappingURL=worker-env.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"worker-env.d.ts","sourceRoot":"","sources":["../../../src/engine/node/worker-env.ts"],"names":[],"mappings":"AAmDA;;;;;;;GAOG;AACH,wBAAgB,SAAS;IAErB,yEAAyE;;IAEzE,+EAA+E;;IAE/E,gFAAgF;;IAEhF,mFAAmF;;IAEnF,+EAA+E;;IAE/E,gFAAgF;;IAEhF,0CAA0C;;IAE1C,8EAA8E;;IAE9E,sFAAsF;;IAEtF,8EAA8E;;IAE9E;;;;;;;OAOG;;IAEH,oEAAoE;;IAEpE,0EAA0E;;IAE1E,wDAAwD;;EAG3D;AAED,gFAAgF;AAChF,MAAM,MAAM,YAAY,GAAG,MAAM,UAAU,CAAC,OAAO,SAAS,CAAC,CAAC;AAE9D,qEAAqE;AACrE,wBAAgB,cAAc,IAAI,MAAM,EAAE,CAEzC"}
@@ -0,0 +1,101 @@
1
+ import { envVar } from '../identity.js';
2
+ import { serverUrlEnvVar, tokenEnvVar } from '../config.js';
3
+ // =============================================================================
4
+ // Worker environment variables — one map, one source of truth (issue #272, epic #254)
5
+ // =============================================================================
6
+ //
7
+ // This repository is a TEMPLATE, and the worker node is the part of it most
8
+ // exposed to that fact. The application this design is ported from hard-codes
9
+ // its own product name into roughly a dozen environment variables, its state
10
+ // directory, its systemd unit and its compose file. Ported literally, every
11
+ // one of those is wrong the moment somebody renames this template — and none
12
+ // of them would fail loudly. A worker would simply never see its
13
+ // configuration and would sit idle, or start with defaults nobody asked for.
14
+ //
15
+ // So every variable the worker reads is declared HERE, once, built through
16
+ // the existing `envVar()` so it inherits `ENV_PREFIX` from `CLI_NAME`. Call
17
+ // sites read `workerEnv().concurrency`, never `process.env.APPCTL_CONCURRENCY`.
18
+ // A rename is then still a one-line edit in `branding.ts`.
19
+ //
20
+ // -----------------------------------------------------------------------------
21
+ // WHY `serverUrl` AND `token` ARE NOT NEW NAMES
22
+ // -----------------------------------------------------------------------------
23
+ //
24
+ // They are the EXISTING `serverUrlEnvVar` / `tokenEnvVar` from
25
+ // `config.ts`, re-exported through this map rather than minted again. Two
26
+ // reasons, and both matter more than the small ugliness of a map whose first
27
+ // two entries come from somewhere else:
28
+ //
29
+ // 1. A worker container authenticates exactly the way `appctl login`
30
+ // does — it IS the same CLI, reading the same config file. A second name
31
+ // for the server URL would mean a machine where `appctl api` works and
32
+ // `appctl node start` does not, for no reason a user could discover.
33
+ //
34
+ // 2. Two names for one value is precisely the drift `branding.ts` exists to
35
+ // prevent. It would also have to be written into the Dockerfile and the
36
+ // compose file (#278), where the bidirectional guard would then be
37
+ // asserting a duplicate.
38
+ //
39
+ // -----------------------------------------------------------------------------
40
+ // THE GUARD
41
+ // -----------------------------------------------------------------------------
42
+ //
43
+ // `env-prefix.test.ts` scans every non-test module under `src/` and fails if
44
+ // any of them contains a string literal starting with `ENV_PREFIX` outside
45
+ // `branding.ts`. That is what makes "every read goes through this map" a
46
+ // structural property rather than a convention somebody remembers. The
47
+ // scanning pattern is BUILT from `ENV_PREFIX`, never written out, or the
48
+ // guard would itself contain the literal it forbids.
49
+ // =============================================================================
50
+ /**
51
+ * Every environment variable a worker node reads.
52
+ *
53
+ * Keys are the internal names code uses; values are the actual variable names
54
+ * a user sets. Adding a variable means adding it here first — #278's guard
55
+ * asserts this map and the container files agree in BOTH directions, so a
56
+ * variable that exists in only one of the two places is a failing test.
57
+ */
58
+ export function workerEnv() {
59
+ return {
60
+ /** `APPCTL_SERVER_URL` — reused from `config.ts`, never minted again. */
61
+ serverUrl: serverUrlEnvVar(),
62
+ /** `APPCTL_TOKEN` — reused from `config.ts`. A `nod_` credential, normally. */
63
+ token: tokenEnvVar(),
64
+ /** The node row this process re-attaches to, so a restart is not a new node. */
65
+ nodeId: envVar('NODE_ID'),
66
+ /** Display name; defaults to the hostname. Reattachment keys on it server-side. */
67
+ nodeName: envVar('NODE_NAME'),
68
+ /** How many jobs this process runs at once. 1–64, per the server's own cap. */
69
+ concurrency: envVar('CONCURRENCY'),
70
+ /** Comma-separated job types this node will claim. Empty means "all it can". */
71
+ types: envVar('ELIGIBLE_TYPES'),
72
+ /** Idle poll interval in milliseconds. */
73
+ pollMs: envVar('POLL_INTERVAL_MS'),
74
+ /** `true` to run without a TTY and drain on SIGTERM WITHOUT deregistering. */
75
+ headless: envVar('HEADLESS'),
76
+ /** Overrides the state directory. The one variable a container almost always sets. */
77
+ stateDir: envVar('STATE_DIR'),
78
+ /** Old-space limit in MB for the re-exec. `0` disables re-tuning entirely. */
79
+ heapLimitMb: envVar('HEAP_LIMIT_MB'),
80
+ /**
81
+ * The re-exec LATCH. Set by the parent shim on the child it spawns.
82
+ *
83
+ * Not an operator knob — it exists so the re-exec cannot loop. It is still
84
+ * declared here rather than read as a literal, because the rule this map
85
+ * enforces has no exceptions: a variable the code reads is a variable a
86
+ * rename must reach.
87
+ */
88
+ heapTuned: envVar('HEAP_TUNED'),
89
+ /** `false` to disable the memory watchdog and its pre-OOM valve. */
90
+ memoryWatchdog: envVar('MEMORY_WATCHDOG'),
91
+ /** heapUsed/heapLimit fraction at which the valve fires. Default ~0.9. */
92
+ memoryThreshold: envVar('MEMORY_THRESHOLD'),
93
+ /** `false` to disable ALL THREE heap-snapshot paths. */
94
+ heapSnapshots: envVar('HEAP_SNAPSHOTS'),
95
+ };
96
+ }
97
+ /** Every variable name the worker reads, deduplicated and sorted. */
98
+ export function workerEnvNames() {
99
+ return [...new Set(Object.values(workerEnv()))].sort();
100
+ }
101
+ //# sourceMappingURL=worker-env.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"worker-env.js","sourceRoot":"","sources":["../../../src/engine/node/worker-env.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AACxC,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE5D,gFAAgF;AAChF,uFAAuF;AACvF,gFAAgF;AAChF,EAAE;AACF,4EAA4E;AAC5E,8EAA8E;AAC9E,6EAA6E;AAC7E,4EAA4E;AAC5E,6EAA6E;AAC7E,iEAAiE;AACjE,6EAA6E;AAC7E,EAAE;AACF,2EAA2E;AAC3E,4EAA4E;AAC5E,gFAAgF;AAChF,2DAA2D;AAC3D,EAAE;AACF,gFAAgF;AAChF,gDAAgD;AAChD,gFAAgF;AAChF,EAAE;AACF,+DAA+D;AAC/D,0EAA0E;AAC1E,6EAA6E;AAC7E,wCAAwC;AACxC,EAAE;AACF,uEAAuE;AACvE,8EAA8E;AAC9E,4EAA4E;AAC5E,0EAA0E;AAC1E,EAAE;AACF,8EAA8E;AAC9E,6EAA6E;AAC7E,wEAAwE;AACxE,8BAA8B;AAC9B,EAAE;AACF,gFAAgF;AAChF,YAAY;AACZ,gFAAgF;AAChF,EAAE;AACF,6EAA6E;AAC7E,2EAA2E;AAC3E,yEAAyE;AACzE,uEAAuE;AACvE,yEAAyE;AACzE,qDAAqD;AACrD,gFAAgF;AAEhF;;;;;;;GAOG;AACH,MAAM,UAAU,SAAS;IACvB,OAAO;QACL,yEAAyE;QACzE,SAAS,EAAE,eAAe,EAAE;QAC5B,+EAA+E;QAC/E,KAAK,EAAE,WAAW,EAAE;QACpB,gFAAgF;QAChF,MAAM,EAAE,MAAM,CAAC,SAAS,CAAC;QACzB,mFAAmF;QACnF,QAAQ,EAAE,MAAM,CAAC,WAAW,CAAC;QAC7B,+EAA+E;QAC/E,WAAW,EAAE,MAAM,CAAC,aAAa,CAAC;QAClC,gFAAgF;QAChF,KAAK,EAAE,MAAM,CAAC,gBAAgB,CAAC;QAC/B,0CAA0C;QAC1C,MAAM,EAAE,MAAM,CAAC,kBAAkB,CAAC;QAClC,8EAA8E;QAC9E,QAAQ,EAAE,MAAM,CAAC,UAAU,CAAC;QAC5B,sFAAsF;QACtF,QAAQ,EAAE,MAAM,CAAC,WAAW,CAAC;QAC7B,8EAA8E;QAC9E,WAAW,EAAE,MAAM,CAAC,eAAe,CAAC;QACpC;;;;;;;WAOG;QACH,SAAS,EAAE,MAAM,CAAC,YAAY,CAAC;QAC/B,oEAAoE;QACpE,cAAc,EAAE,MAAM,CAAC,iBAAiB,CAAC;QACzC,0EAA0E;QAC1E,eAAe,EAAE,MAAM,CAAC,kBAAkB,CAAC;QAC3C,wDAAwD;QACxD,aAAa,EAAE,MAAM,CAAC,gBAAgB,CAAC;KAC/B,CAAC;AACb,CAAC;AAKD,qEAAqE;AACrE,MAAM,UAAU,cAAc;IAC5B,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;AACzD,CAAC"}
@@ -0,0 +1,97 @@
1
+ /** Inputs to the colour decision, injectable so this is testable without a TTY. */
2
+ export interface ColourDecisionInput {
3
+ /** `--no-color` sets this to false. `undefined` means the user said nothing. */
4
+ requested?: boolean | undefined;
5
+ /** Whether the destination stream is a terminal. */
6
+ isTTY: boolean;
7
+ env: NodeJS.ProcessEnv;
8
+ }
9
+ /**
10
+ * Should output be coloured?
11
+ *
12
+ * Precedence, most specific first — each layer overrides the ones below it:
13
+ *
14
+ * 1. `--no-color`. An explicit flag about THIS invocation always wins.
15
+ * 2. `NO_COLOR` (https://no-color.org). Present and non-empty disables
16
+ * colour for every tool that honours it; ignoring it is how a CLI ends
17
+ * up escaping-sequence-spamming somebody's accessibility setup.
18
+ * 3. `FORCE_COLOR`. The escape hatch for the case a TTY check cannot detect:
19
+ * a CI runner that renders ANSI in its web log viewer while handing the
20
+ * process a pipe. `FORCE_COLOR=0` is the conventional "off" value.
21
+ * 4. `TERM=dumb`. A terminal that has told us it cannot render sequences.
22
+ * 5. Is it a TTY at all — the default, and the case that catches every pipe
23
+ * and every redirect without anyone having to configure anything.
24
+ *
25
+ * NOTE the caller's other obligation: `--raw` must not even ASK this question.
26
+ * Raw output is machine input, and colour in it is corruption regardless of
27
+ * how loudly FORCE_COLOR was set. `commands/api.ts` hard-codes `false` there
28
+ * rather than routing the decision through here, so no environment variable on
29
+ * any machine can break a pipeline.
30
+ */
31
+ export declare function shouldUseColour(input: ColourDecisionInput): boolean;
32
+ export interface FormatJsonOptions {
33
+ colour: boolean;
34
+ /** Spaces per level. Two, like `JSON.stringify(v, null, 2)`. */
35
+ indent?: number | undefined;
36
+ }
37
+ /**
38
+ * Pretty-print a parsed JSON value for a human, optionally coloured.
39
+ *
40
+ * WHY NOT `JSON.stringify(value, null, 2)` PLUS A REGEX RECOLOURING PASS —
41
+ * which is the usual shortcut: a regex cannot tell a `"` that opens a string
42
+ * from a `\"` inside one, so any value containing a quote, a colon or a brace
43
+ * (a JSON blob stored in a `system_settings` JSONB column, say, or an error
44
+ * `details` field) gets mis-highlighted, and mis-highlighting looks exactly
45
+ * like corrupted data. Walking the parsed structure cannot make that mistake,
46
+ * because it never has to guess what a character means.
47
+ *
48
+ * The escaping of every scalar still goes through `JSON.stringify`, so the
49
+ * UNCOLOURED output of this function is byte-identical to
50
+ * `JSON.stringify(value, null, 2)`. That equality is worth keeping: it means
51
+ * the pretty form and the `--raw` form can never disagree about what the data
52
+ * actually was, only about whitespace.
53
+ */
54
+ export declare function formatJson(value: unknown, options: FormatJsonOptions): string;
55
+ /**
56
+ * The one-line "what just happened" that goes to STDERR.
57
+ *
58
+ * On stderr and not stdout even though it is arguably part of the answer,
59
+ * because it is not part of the DATA — see the header of this file. A user
60
+ * reading a terminal sees it interleaved exactly where they expect; a pipe
61
+ * never sees it at all.
62
+ */
63
+ export declare function formatStatusLine(args: {
64
+ method: string;
65
+ path: string;
66
+ status: number;
67
+ durationMs: number;
68
+ }): string;
69
+ /**
70
+ * Start a stderr spinner; returns the function that stops and erases it.
71
+ *
72
+ * THREE PROPERTIES THIS HAS TO GET RIGHT, all of which are silent when wrong:
73
+ *
74
+ * 1. It writes to STDERR ONLY. A spinner on stdout is the textbook way to
75
+ * corrupt `--raw` (#144 says so explicitly), and it would do so
76
+ * INTERMITTENTLY — only on requests slow enough to trigger it — which is
77
+ * the worst kind of bug to be handed in a report.
78
+ *
79
+ * 2. It is disabled whenever stderr is not a TTY. Carriage returns do not
80
+ * overwrite anything in a CI log; they accumulate into one enormous line
81
+ * that some viewers refuse to render at all. `commands/login.ts` carries
82
+ * the same rule for its polling status.
83
+ *
84
+ * 3. Both timers are `unref()`d. A referenced interval keeps the event loop
85
+ * alive, so a CLI that had already computed its exit code would sit there
86
+ * spinning instead of exiting. `unref` means the process ends the moment
87
+ * the real work is done, whatever the timer thinks.
88
+ *
89
+ * The returned stopper is idempotent and MUST be called from a `finally`, so a
90
+ * thrown ApiError cannot leave a half-drawn frame in front of the error
91
+ * message.
92
+ */
93
+ export declare function createSpinner(label: string, options: {
94
+ enabled: boolean;
95
+ stream?: NodeJS.WriteStream | undefined;
96
+ }): () => void;
97
+ //# sourceMappingURL=output.d.ts.map