@marinoscar/platform-cli 0.1.0-next.3 → 0.1.0-next.5
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.
- package/CHANGELOG.md +88 -0
- package/README.md +126 -31
- package/dist/android/build.d.ts +30 -0
- package/dist/android/build.d.ts.map +1 -0
- package/dist/android/build.js +126 -0
- package/dist/android/build.js.map +1 -0
- package/dist/android/command.d.ts +21 -0
- package/dist/android/command.d.ts.map +1 -0
- package/dist/android/command.js +355 -0
- package/dist/android/command.js.map +1 -0
- package/dist/android/deploy-step.d.ts +85 -0
- package/dist/android/deploy-step.d.ts.map +1 -0
- package/dist/android/deploy-step.js +268 -0
- package/dist/android/deploy-step.js.map +1 -0
- package/dist/android/doctor.d.ts +47 -0
- package/dist/android/doctor.d.ts.map +1 -0
- package/dist/android/doctor.js +219 -0
- package/dist/android/doctor.js.map +1 -0
- package/dist/android/exec.d.ts +42 -0
- package/dist/android/exec.d.ts.map +1 -0
- package/dist/android/exec.js +103 -0
- package/dist/android/exec.js.map +1 -0
- package/dist/android/fix-plan.d.ts +44 -0
- package/dist/android/fix-plan.d.ts.map +1 -0
- package/dist/android/fix-plan.js +86 -0
- package/dist/android/fix-plan.js.map +1 -0
- package/dist/android/git-freshness.d.ts +34 -0
- package/dist/android/git-freshness.d.ts.map +1 -0
- package/dist/android/git-freshness.js +120 -0
- package/dist/android/git-freshness.js.map +1 -0
- package/dist/android/gradle.d.ts +32 -0
- package/dist/android/gradle.d.ts.map +1 -0
- package/dist/android/gradle.js +55 -0
- package/dist/android/gradle.js.map +1 -0
- package/dist/android/identity.d.ts +27 -0
- package/dist/android/identity.d.ts.map +1 -0
- package/dist/android/identity.js +60 -0
- package/dist/android/identity.js.map +1 -0
- package/dist/android/index.d.ts +7 -0
- package/dist/android/index.d.ts.map +1 -0
- package/dist/android/index.js +8 -0
- package/dist/android/index.js.map +1 -0
- package/dist/android/installer.d.ts +28 -0
- package/dist/android/installer.d.ts.map +1 -0
- package/dist/android/installer.js +96 -0
- package/dist/android/installer.js.map +1 -0
- package/dist/android/java.d.ts +26 -0
- package/dist/android/java.d.ts.map +1 -0
- package/dist/android/java.js +65 -0
- package/dist/android/java.js.map +1 -0
- package/dist/android/keystore.d.ts +54 -0
- package/dist/android/keystore.d.ts.map +1 -0
- package/dist/android/keystore.js +159 -0
- package/dist/android/keystore.js.map +1 -0
- package/dist/android/metadata.d.ts +39 -0
- package/dist/android/metadata.d.ts.map +1 -0
- package/dist/android/metadata.js +61 -0
- package/dist/android/metadata.js.map +1 -0
- package/dist/android/operations.d.ts +42 -0
- package/dist/android/operations.d.ts.map +1 -0
- package/dist/android/operations.js +59 -0
- package/dist/android/operations.js.map +1 -0
- package/dist/android/paths.d.ts +29 -0
- package/dist/android/paths.d.ts.map +1 -0
- package/dist/android/paths.js +97 -0
- package/dist/android/paths.js.map +1 -0
- package/dist/android/publish.d.ts +37 -0
- package/dist/android/publish.d.ts.map +1 -0
- package/dist/android/publish.js +119 -0
- package/dist/android/publish.js.map +1 -0
- package/dist/android/registrations.d.ts +92 -0
- package/dist/android/registrations.d.ts.map +1 -0
- package/dist/android/registrations.js +112 -0
- package/dist/android/registrations.js.map +1 -0
- package/dist/android/release-status.d.ts +73 -0
- package/dist/android/release-status.d.ts.map +1 -0
- package/dist/android/release-status.js +161 -0
- package/dist/android/release-status.js.map +1 -0
- package/dist/android/release.d.ts +33 -0
- package/dist/android/release.d.ts.map +1 -0
- package/dist/android/release.js +59 -0
- package/dist/android/release.js.map +1 -0
- package/dist/android/screen-layout.d.ts +26 -0
- package/dist/android/screen-layout.d.ts.map +1 -0
- package/dist/android/screen-layout.js +24 -0
- package/dist/android/screen-layout.js.map +1 -0
- package/dist/android/screen-model.d.ts +56 -0
- package/dist/android/screen-model.d.ts.map +1 -0
- package/dist/android/screen-model.js +207 -0
- package/dist/android/screen-model.js.map +1 -0
- package/dist/android/screen.d.ts +8 -0
- package/dist/android/screen.d.ts.map +1 -0
- package/dist/android/screen.js +395 -0
- package/dist/android/screen.js.map +1 -0
- package/dist/android/sdk.d.ts +48 -0
- package/dist/android/sdk.d.ts.map +1 -0
- package/dist/android/sdk.js +82 -0
- package/dist/android/sdk.js.map +1 -0
- package/dist/android/server-url.d.ts +19 -0
- package/dist/android/server-url.d.ts.map +1 -0
- package/dist/android/server-url.js +36 -0
- package/dist/android/server-url.js.map +1 -0
- package/dist/android/upload-progress.d.ts +3 -0
- package/dist/android/upload-progress.d.ts.map +1 -0
- package/dist/android/upload-progress.js +47 -0
- package/dist/android/upload-progress.js.map +1 -0
- package/dist/android/version.d.ts +47 -0
- package/dist/android/version.d.ts.map +1 -0
- package/dist/android/version.js +136 -0
- package/dist/android/version.js.map +1 -0
- package/dist/api-client/index.d.ts +3 -0
- package/dist/api-client/index.d.ts.map +1 -0
- package/dist/api-client/index.js +5 -0
- package/dist/api-client/index.js.map +1 -0
- package/dist/commands/index.d.ts +52 -0
- package/dist/commands/index.d.ts.map +1 -0
- package/dist/commands/index.js +63 -0
- package/dist/commands/index.js.map +1 -0
- package/dist/core/cli-registry.d.ts +41 -0
- package/dist/core/cli-registry.d.ts.map +1 -0
- package/dist/core/cli-registry.js +49 -0
- package/dist/core/cli-registry.js.map +1 -0
- package/dist/core/command-registry.d.ts +10 -0
- package/dist/core/command-registry.d.ts.map +1 -1
- package/dist/core/command-registry.js +17 -0
- package/dist/core/command-registry.js.map +1 -1
- package/dist/core/env-annotation-registry.d.ts +58 -0
- package/dist/core/env-annotation-registry.d.ts.map +1 -0
- package/dist/core/env-annotation-registry.js +80 -0
- package/dist/core/env-annotation-registry.js.map +1 -0
- package/dist/core/env-generator-registry.d.ts +59 -0
- package/dist/core/env-generator-registry.d.ts.map +1 -0
- package/dist/core/env-generator-registry.js +102 -0
- package/dist/core/env-generator-registry.js.map +1 -0
- package/dist/core/env-group-registry.d.ts +65 -0
- package/dist/core/env-group-registry.d.ts.map +1 -0
- package/dist/core/env-group-registry.js +77 -0
- package/dist/core/env-group-registry.js.map +1 -0
- package/dist/core/env-spec-registry.d.ts +16 -2
- package/dist/core/env-spec-registry.d.ts.map +1 -1
- package/dist/core/env-spec-registry.js +15 -0
- package/dist/core/env-spec-registry.js.map +1 -1
- package/dist/core/env-values.d.ts +3 -2
- package/dist/core/env-values.d.ts.map +1 -1
- package/dist/core/env-values.js +5 -3
- package/dist/core/env-values.js.map +1 -1
- package/dist/core/index.d.ts +10 -2
- package/dist/core/index.d.ts.map +1 -1
- package/dist/core/index.js +6 -2
- package/dist/core/index.js.map +1 -1
- package/dist/deploy/index.d.ts +3 -0
- package/dist/deploy/index.d.ts.map +1 -0
- package/dist/deploy/index.js +5 -0
- package/dist/deploy/index.js.map +1 -0
- package/dist/engine/api-client.d.ts +211 -0
- package/dist/engine/api-client.d.ts.map +1 -0
- package/dist/engine/api-client.js +350 -0
- package/dist/engine/api-client.js.map +1 -0
- package/dist/engine/browser.d.ts +18 -0
- package/dist/engine/browser.d.ts.map +1 -0
- package/dist/engine/browser.js +115 -0
- package/dist/engine/browser.js.map +1 -0
- package/dist/engine/builtin-registrations.d.ts +20 -0
- package/dist/engine/builtin-registrations.d.ts.map +1 -0
- package/dist/engine/builtin-registrations.js +86 -0
- package/dist/engine/builtin-registrations.js.map +1 -0
- package/dist/engine/commands/api.d.ts +88 -0
- package/dist/engine/commands/api.d.ts.map +1 -0
- package/dist/engine/commands/api.js +398 -0
- package/dist/engine/commands/api.js.map +1 -0
- package/dist/engine/commands/config.d.ts +5 -0
- package/dist/engine/commands/config.d.ts.map +1 -0
- package/dist/engine/commands/config.js +83 -0
- package/dist/engine/commands/config.js.map +1 -0
- package/dist/engine/commands/deploy.d.ts +243 -0
- package/dist/engine/commands/deploy.d.ts.map +1 -0
- package/dist/engine/commands/deploy.js +1159 -0
- package/dist/engine/commands/deploy.js.map +1 -0
- package/dist/engine/commands/init.d.ts +18 -0
- package/dist/engine/commands/init.d.ts.map +1 -0
- package/dist/engine/commands/init.js +50 -0
- package/dist/engine/commands/init.js.map +1 -0
- package/dist/engine/commands/login.d.ts +4 -0
- package/dist/engine/commands/login.d.ts.map +1 -0
- package/dist/engine/commands/login.js +205 -0
- package/dist/engine/commands/login.js.map +1 -0
- package/dist/engine/commands/node.d.ts +21 -0
- package/dist/engine/commands/node.d.ts.map +1 -0
- package/dist/engine/commands/node.js +436 -0
- package/dist/engine/commands/node.js.map +1 -0
- package/dist/engine/config.d.ts +246 -0
- package/dist/engine/config.d.ts.map +1 -0
- package/dist/engine/config.js +414 -0
- package/dist/engine/config.js.map +1 -0
- package/dist/engine/conformance.d.ts +187 -0
- package/dist/engine/conformance.d.ts.map +1 -0
- package/dist/engine/conformance.js +227 -0
- package/dist/engine/conformance.js.map +1 -0
- package/dist/engine/create-cli.d.ts +94 -0
- package/dist/engine/create-cli.d.ts.map +1 -0
- package/dist/engine/create-cli.js +60 -0
- package/dist/engine/create-cli.js.map +1 -0
- package/dist/engine/deploy/about.d.ts +12 -0
- package/dist/engine/deploy/about.d.ts.map +1 -0
- package/dist/engine/deploy/about.js +110 -0
- package/dist/engine/deploy/about.js.map +1 -0
- package/dist/engine/deploy/adopt.d.ts +21 -0
- package/dist/engine/deploy/adopt.d.ts.map +1 -0
- package/dist/engine/deploy/adopt.js +78 -0
- package/dist/engine/deploy/adopt.js.map +1 -0
- package/dist/engine/deploy/answers-file.d.ts +7 -0
- package/dist/engine/deploy/answers-file.d.ts.map +1 -0
- package/dist/engine/deploy/answers-file.js +49 -0
- package/dist/engine/deploy/answers-file.js.map +1 -0
- package/dist/engine/deploy/app-role.d.ts +278 -0
- package/dist/engine/deploy/app-role.d.ts.map +1 -0
- package/dist/engine/deploy/app-role.js +826 -0
- package/dist/engine/deploy/app-role.js.map +1 -0
- package/dist/engine/deploy/app-version.d.ts +47 -0
- package/dist/engine/deploy/app-version.d.ts.map +1 -0
- package/dist/engine/deploy/app-version.js +232 -0
- package/dist/engine/deploy/app-version.js.map +1 -0
- package/dist/engine/deploy/checks/database.d.ts +83 -0
- package/dist/engine/deploy/checks/database.d.ts.map +1 -0
- package/dist/engine/deploy/checks/database.js +455 -0
- package/dist/engine/deploy/checks/database.js.map +1 -0
- package/dist/engine/deploy/checks/dns.d.ts +3 -0
- package/dist/engine/deploy/checks/dns.d.ts.map +1 -0
- package/dist/engine/deploy/checks/dns.js +85 -0
- package/dist/engine/deploy/checks/dns.js.map +1 -0
- package/dist/engine/deploy/checks/host.d.ts +19 -0
- package/dist/engine/deploy/checks/host.d.ts.map +1 -0
- package/dist/engine/deploy/checks/host.js +530 -0
- package/dist/engine/deploy/checks/host.js.map +1 -0
- package/dist/engine/deploy/checks/index.d.ts +33 -0
- package/dist/engine/deploy/checks/index.d.ts.map +1 -0
- package/dist/engine/deploy/checks/index.js +67 -0
- package/dist/engine/deploy/checks/index.js.map +1 -0
- package/dist/engine/deploy/checks/registry.d.ts +102 -0
- package/dist/engine/deploy/checks/registry.d.ts.map +1 -0
- package/dist/engine/deploy/checks/registry.js +103 -0
- package/dist/engine/deploy/checks/registry.js.map +1 -0
- package/dist/engine/deploy/checks/source.d.ts +45 -0
- package/dist/engine/deploy/checks/source.d.ts.map +1 -0
- package/dist/engine/deploy/checks/source.js +175 -0
- package/dist/engine/deploy/checks/source.js.map +1 -0
- package/dist/engine/deploy/checks/tls.d.ts +87 -0
- package/dist/engine/deploy/checks/tls.d.ts.map +1 -0
- package/dist/engine/deploy/checks/tls.js +552 -0
- package/dist/engine/deploy/checks/tls.js.map +1 -0
- package/dist/engine/deploy/checks/types.d.ts +178 -0
- package/dist/engine/deploy/checks/types.d.ts.map +1 -0
- package/dist/engine/deploy/checks/types.js +199 -0
- package/dist/engine/deploy/checks/types.js.map +1 -0
- package/dist/engine/deploy/compose-files.d.ts +29 -0
- package/dist/engine/deploy/compose-files.d.ts.map +1 -0
- package/dist/engine/deploy/compose-files.js +118 -0
- package/dist/engine/deploy/compose-files.js.map +1 -0
- package/dist/engine/deploy/consent.d.ts +29 -0
- package/dist/engine/deploy/consent.d.ts.map +1 -0
- package/dist/engine/deploy/consent.js +35 -0
- package/dist/engine/deploy/consent.js.map +1 -0
- package/dist/engine/deploy/database-drop.d.ts +22 -0
- package/dist/engine/deploy/database-drop.d.ts.map +1 -0
- package/dist/engine/deploy/database-drop.js +135 -0
- package/dist/engine/deploy/database-drop.js.map +1 -0
- package/dist/engine/deploy/database.d.ts +116 -0
- package/dist/engine/deploy/database.d.ts.map +1 -0
- package/dist/engine/deploy/database.js +252 -0
- package/dist/engine/deploy/database.js.map +1 -0
- package/dist/engine/deploy/deploy-info.d.ts +48 -0
- package/dist/engine/deploy/deploy-info.d.ts.map +1 -0
- package/dist/engine/deploy/deploy-info.js +163 -0
- package/dist/engine/deploy/deploy-info.js.map +1 -0
- package/dist/engine/deploy/deployment-evidence.d.ts +38 -0
- package/dist/engine/deploy/deployment-evidence.d.ts.map +1 -0
- package/dist/engine/deploy/deployment-evidence.js +92 -0
- package/dist/engine/deploy/deployment-evidence.js.map +1 -0
- package/dist/engine/deploy/edge-config.d.ts +103 -0
- package/dist/engine/deploy/edge-config.d.ts.map +1 -0
- package/dist/engine/deploy/edge-config.js +170 -0
- package/dist/engine/deploy/edge-config.js.map +1 -0
- package/dist/engine/deploy/env-absence.d.ts +61 -0
- package/dist/engine/deploy/env-absence.d.ts.map +1 -0
- package/dist/engine/deploy/env-absence.js +33 -0
- package/dist/engine/deploy/env-absence.js.map +1 -0
- package/dist/engine/deploy/env-file.d.ts +14 -0
- package/dist/engine/deploy/env-file.d.ts.map +1 -0
- package/dist/engine/deploy/env-file.js +58 -0
- package/dist/engine/deploy/env-file.js.map +1 -0
- package/dist/engine/deploy/env-fragments.d.ts +29 -0
- package/dist/engine/deploy/env-fragments.d.ts.map +1 -0
- package/dist/engine/deploy/env-fragments.js +73 -0
- package/dist/engine/deploy/env-fragments.js.map +1 -0
- package/dist/engine/deploy/env-metadata.d.ts +73 -0
- package/dist/engine/deploy/env-metadata.d.ts.map +1 -0
- package/dist/engine/deploy/env-metadata.js +227 -0
- package/dist/engine/deploy/env-metadata.js.map +1 -0
- package/dist/engine/deploy/env-spec.d.ts +75 -0
- package/dist/engine/deploy/env-spec.d.ts.map +1 -0
- package/dist/engine/deploy/env-spec.js +239 -0
- package/dist/engine/deploy/env-spec.js.map +1 -0
- package/dist/engine/deploy/env-wizard.d.ts +56 -0
- package/dist/engine/deploy/env-wizard.d.ts.map +1 -0
- package/dist/engine/deploy/env-wizard.js +235 -0
- package/dist/engine/deploy/env-wizard.js.map +1 -0
- package/dist/engine/deploy/executor.d.ts +81 -0
- package/dist/engine/deploy/executor.d.ts.map +1 -0
- package/dist/engine/deploy/executor.js +247 -0
- package/dist/engine/deploy/executor.js.map +1 -0
- package/dist/engine/deploy/health.d.ts +146 -0
- package/dist/engine/deploy/health.d.ts.map +1 -0
- package/dist/engine/deploy/health.js +323 -0
- package/dist/engine/deploy/health.js.map +1 -0
- package/dist/engine/deploy/hooks.d.ts +66 -0
- package/dist/engine/deploy/hooks.d.ts.map +1 -0
- package/dist/engine/deploy/hooks.js +19 -0
- package/dist/engine/deploy/hooks.js.map +1 -0
- package/dist/engine/deploy/host-facts.d.ts +23 -0
- package/dist/engine/deploy/host-facts.d.ts.map +1 -0
- package/dist/engine/deploy/host-facts.js +67 -0
- package/dist/engine/deploy/host-facts.js.map +1 -0
- package/dist/engine/deploy/install.d.ts +233 -0
- package/dist/engine/deploy/install.d.ts.map +1 -0
- package/dist/engine/deploy/install.js +1304 -0
- package/dist/engine/deploy/install.js.map +1 -0
- package/dist/engine/deploy/inventory.d.ts +30 -0
- package/dist/engine/deploy/inventory.d.ts.map +1 -0
- package/dist/engine/deploy/inventory.js +122 -0
- package/dist/engine/deploy/inventory.js.map +1 -0
- package/dist/engine/deploy/journal.d.ts +77 -0
- package/dist/engine/deploy/journal.d.ts.map +1 -0
- package/dist/engine/deploy/journal.js +221 -0
- package/dist/engine/deploy/journal.js.map +1 -0
- package/dist/engine/deploy/layout.d.ts +77 -0
- package/dist/engine/deploy/layout.d.ts.map +1 -0
- package/dist/engine/deploy/layout.js +191 -0
- package/dist/engine/deploy/layout.js.map +1 -0
- package/dist/engine/deploy/oauth-check.d.ts +58 -0
- package/dist/engine/deploy/oauth-check.d.ts.map +1 -0
- package/dist/engine/deploy/oauth-check.js +213 -0
- package/dist/engine/deploy/oauth-check.js.map +1 -0
- package/dist/engine/deploy/proxy-bootstrap.d.ts +149 -0
- package/dist/engine/deploy/proxy-bootstrap.d.ts.map +1 -0
- package/dist/engine/deploy/proxy-bootstrap.js +416 -0
- package/dist/engine/deploy/proxy-bootstrap.js.map +1 -0
- package/dist/engine/deploy/proxy-streams.d.ts +110 -0
- package/dist/engine/deploy/proxy-streams.d.ts.map +1 -0
- package/dist/engine/deploy/proxy-streams.js +208 -0
- package/dist/engine/deploy/proxy-streams.js.map +1 -0
- package/dist/engine/deploy/proxy.d.ts +375 -0
- package/dist/engine/deploy/proxy.d.ts.map +1 -0
- package/dist/engine/deploy/proxy.js +758 -0
- package/dist/engine/deploy/proxy.js.map +1 -0
- package/dist/engine/deploy/renewal.d.ts +54 -0
- package/dist/engine/deploy/renewal.d.ts.map +1 -0
- package/dist/engine/deploy/renewal.js +169 -0
- package/dist/engine/deploy/renewal.js.map +1 -0
- package/dist/engine/deploy/repo.d.ts +101 -0
- package/dist/engine/deploy/repo.d.ts.map +1 -0
- package/dist/engine/deploy/repo.js +250 -0
- package/dist/engine/deploy/repo.js.map +1 -0
- package/dist/engine/deploy/run-record.d.ts +28 -0
- package/dist/engine/deploy/run-record.d.ts.map +1 -0
- package/dist/engine/deploy/run-record.js +44 -0
- package/dist/engine/deploy/run-record.js.map +1 -0
- package/dist/engine/deploy/state.d.ts +262 -0
- package/dist/engine/deploy/state.d.ts.map +1 -0
- package/dist/engine/deploy/state.js +163 -0
- package/dist/engine/deploy/state.js.map +1 -0
- package/dist/engine/deploy/steps/app-step-context.d.ts +24 -0
- package/dist/engine/deploy/steps/app-step-context.d.ts.map +1 -0
- package/dist/engine/deploy/steps/app-step-context.js +45 -0
- package/dist/engine/deploy/steps/app-step-context.js.map +1 -0
- package/dist/engine/deploy/steps/pipeline.d.ts +46 -0
- package/dist/engine/deploy/steps/pipeline.d.ts.map +1 -0
- package/dist/engine/deploy/steps/pipeline.js +73 -0
- package/dist/engine/deploy/steps/pipeline.js.map +1 -0
- package/dist/engine/deploy/steps/plan.d.ts +28 -0
- package/dist/engine/deploy/steps/plan.d.ts.map +1 -0
- package/dist/engine/deploy/steps/plan.js +32 -0
- package/dist/engine/deploy/steps/plan.js.map +1 -0
- package/dist/engine/deploy/steps/registry.d.ts +182 -0
- package/dist/engine/deploy/steps/registry.d.ts.map +1 -0
- package/dist/engine/deploy/steps/registry.js +212 -0
- package/dist/engine/deploy/steps/registry.js.map +1 -0
- package/dist/engine/deploy/steps/step-values.d.ts +28 -0
- package/dist/engine/deploy/steps/step-values.d.ts.map +1 -0
- package/dist/engine/deploy/steps/step-values.js +33 -0
- package/dist/engine/deploy/steps/step-values.js.map +1 -0
- package/dist/engine/deploy/testing/fake-postgres.d.ts +88 -0
- package/dist/engine/deploy/testing/fake-postgres.d.ts.map +1 -0
- package/dist/engine/deploy/testing/fake-postgres.js +236 -0
- package/dist/engine/deploy/testing/fake-postgres.js.map +1 -0
- package/dist/engine/deploy/testing/fake-vps.d.ts +147 -0
- package/dist/engine/deploy/testing/fake-vps.d.ts.map +1 -0
- package/dist/engine/deploy/testing/fake-vps.js +365 -0
- package/dist/engine/deploy/testing/fake-vps.js.map +1 -0
- package/dist/engine/deploy/uninstall.d.ts +87 -0
- package/dist/engine/deploy/uninstall.d.ts.map +1 -0
- package/dist/engine/deploy/uninstall.js +320 -0
- package/dist/engine/deploy/uninstall.js.map +1 -0
- package/dist/engine/deploy/update.d.ts +111 -0
- package/dist/engine/deploy/update.d.ts.map +1 -0
- package/dist/engine/deploy/update.js +1228 -0
- package/dist/engine/deploy/update.js.map +1 -0
- package/dist/engine/deploy/version-step.d.ts +65 -0
- package/dist/engine/deploy/version-step.d.ts.map +1 -0
- package/dist/engine/deploy/version-step.js +176 -0
- package/dist/engine/deploy/version-step.js.map +1 -0
- package/dist/engine/device-auth.d.ts +240 -0
- package/dist/engine/device-auth.d.ts.map +1 -0
- package/dist/engine/device-auth.js +442 -0
- package/dist/engine/device-auth.js.map +1 -0
- package/dist/engine/device-login.d.ts +126 -0
- package/dist/engine/device-login.d.ts.map +1 -0
- package/dist/engine/device-login.js +164 -0
- package/dist/engine/device-login.js.map +1 -0
- package/dist/engine/errors.d.ts +314 -0
- package/dist/engine/errors.d.ts.map +1 -0
- package/dist/engine/errors.js +561 -0
- package/dist/engine/errors.js.map +1 -0
- package/dist/engine/identity.d.ts +169 -0
- package/dist/engine/identity.d.ts.map +1 -0
- package/dist/engine/identity.js +227 -0
- package/dist/engine/identity.js.map +1 -0
- package/dist/engine/index.d.ts +104 -0
- package/dist/engine/index.d.ts.map +1 -0
- package/dist/engine/index.js +126 -0
- package/dist/engine/index.js.map +1 -0
- package/dist/engine/init/local-profile.d.ts +93 -0
- package/dist/engine/init/local-profile.d.ts.map +1 -0
- package/dist/engine/init/local-profile.js +295 -0
- package/dist/engine/init/local-profile.js.map +1 -0
- package/dist/engine/init/run-init.d.ts +41 -0
- package/dist/engine/init/run-init.d.ts.map +1 -0
- package/dist/engine/init/run-init.js +297 -0
- package/dist/engine/init/run-init.js.map +1 -0
- package/dist/engine/node/capabilities.d.ts +238 -0
- package/dist/engine/node/capabilities.d.ts.map +1 -0
- package/dist/engine/node/capabilities.js +316 -0
- package/dist/engine/node/capabilities.js.map +1 -0
- package/dist/engine/node/daemon.d.ts +63 -0
- package/dist/engine/node/daemon.d.ts.map +1 -0
- package/dist/engine/node/daemon.js +227 -0
- package/dist/engine/node/daemon.js.map +1 -0
- package/dist/engine/node/doctor.d.ts +58 -0
- package/dist/engine/node/doctor.d.ts.map +1 -0
- package/dist/engine/node/doctor.js +394 -0
- package/dist/engine/node/doctor.js.map +1 -0
- package/dist/engine/node/enrollment.d.ts +98 -0
- package/dist/engine/node/enrollment.d.ts.map +1 -0
- package/dist/engine/node/enrollment.js +189 -0
- package/dist/engine/node/enrollment.js.map +1 -0
- package/dist/engine/node/env-flags.d.ts +5 -0
- package/dist/engine/node/env-flags.d.ts.map +1 -0
- package/dist/engine/node/env-flags.js +22 -0
- package/dist/engine/node/env-flags.js.map +1 -0
- package/dist/engine/node/executors/credential-hygiene.d.ts +63 -0
- package/dist/engine/node/executors/credential-hygiene.d.ts.map +1 -0
- package/dist/engine/node/executors/credential-hygiene.js +189 -0
- package/dist/engine/node/executors/credential-hygiene.js.map +1 -0
- package/dist/engine/node/executors/db-backup-run.d.ts +73 -0
- package/dist/engine/node/executors/db-backup-run.d.ts.map +1 -0
- package/dist/engine/node/executors/db-backup-run.js +362 -0
- package/dist/engine/node/executors/db-backup-run.js.map +1 -0
- package/dist/engine/node/executors/example-checksum.d.ts +30 -0
- package/dist/engine/node/executors/example-checksum.d.ts.map +1 -0
- package/dist/engine/node/executors/example-checksum.js +56 -0
- package/dist/engine/node/executors/example-checksum.js.map +1 -0
- package/dist/engine/node/executors/index.d.ts +168 -0
- package/dist/engine/node/executors/index.d.ts.map +1 -0
- package/dist/engine/node/executors/index.js +44 -0
- package/dist/engine/node/executors/index.js.map +1 -0
- package/dist/engine/node/executors/registry.d.ts +38 -0
- package/dist/engine/node/executors/registry.d.ts.map +1 -0
- package/dist/engine/node/executors/registry.js +92 -0
- package/dist/engine/node/executors/registry.js.map +1 -0
- package/dist/engine/node/heap-snapshot.d.ts +37 -0
- package/dist/engine/node/heap-snapshot.d.ts.map +1 -0
- package/dist/engine/node/heap-snapshot.js +160 -0
- package/dist/engine/node/heap-snapshot.js.map +1 -0
- package/dist/engine/node/install-deps.d.ts +73 -0
- package/dist/engine/node/install-deps.d.ts.map +1 -0
- package/dist/engine/node/install-deps.js +150 -0
- package/dist/engine/node/install-deps.js.map +1 -0
- package/dist/engine/node/ipc-protocol.d.ts +67 -0
- package/dist/engine/node/ipc-protocol.d.ts.map +1 -0
- package/dist/engine/node/ipc-protocol.js +83 -0
- package/dist/engine/node/ipc-protocol.js.map +1 -0
- package/dist/engine/node/lifecycle.d.ts +103 -0
- package/dist/engine/node/lifecycle.d.ts.map +1 -0
- package/dist/engine/node/lifecycle.js +259 -0
- package/dist/engine/node/lifecycle.js.map +1 -0
- package/dist/engine/node/logger.d.ts +82 -0
- package/dist/engine/node/logger.d.ts.map +1 -0
- package/dist/engine/node/logger.js +241 -0
- package/dist/engine/node/logger.js.map +1 -0
- package/dist/engine/node/memory-watchdog.d.ts +78 -0
- package/dist/engine/node/memory-watchdog.d.ts.map +1 -0
- package/dist/engine/node/memory-watchdog.js +224 -0
- package/dist/engine/node/memory-watchdog.js.map +1 -0
- package/dist/engine/node/node-api.d.ts +391 -0
- package/dist/engine/node/node-api.d.ts.map +1 -0
- package/dist/engine/node/node-api.js +123 -0
- package/dist/engine/node/node-api.js.map +1 -0
- package/dist/engine/node/node-config.d.ts +128 -0
- package/dist/engine/node/node-config.d.ts.map +1 -0
- package/dist/engine/node/node-config.js +237 -0
- package/dist/engine/node/node-config.js.map +1 -0
- package/dist/engine/node/node-dashboard-source.d.ts +56 -0
- package/dist/engine/node/node-dashboard-source.d.ts.map +1 -0
- package/dist/engine/node/node-dashboard-source.js +213 -0
- package/dist/engine/node/node-dashboard-source.js.map +1 -0
- package/dist/engine/node/node-engine.d.ts +229 -0
- package/dist/engine/node/node-engine.d.ts.map +1 -0
- package/dist/engine/node/node-engine.js +723 -0
- package/dist/engine/node/node-engine.js.map +1 -0
- package/dist/engine/node/node-errors.d.ts +54 -0
- package/dist/engine/node/node-errors.d.ts.map +1 -0
- package/dist/engine/node/node-errors.js +71 -0
- package/dist/engine/node/node-errors.js.map +1 -0
- package/dist/engine/node/node-events.d.ts +132 -0
- package/dist/engine/node/node-events.d.ts.map +1 -0
- package/dist/engine/node/node-events.js +2 -0
- package/dist/engine/node/node-events.js.map +1 -0
- package/dist/engine/node/node-vitals.d.ts +123 -0
- package/dist/engine/node/node-vitals.d.ts.map +1 -0
- package/dist/engine/node/node-vitals.js +266 -0
- package/dist/engine/node/node-vitals.js.map +1 -0
- package/dist/engine/node/paths.d.ts +39 -0
- package/dist/engine/node/paths.d.ts.map +1 -0
- package/dist/engine/node/paths.js +60 -0
- package/dist/engine/node/paths.js.map +1 -0
- package/dist/engine/node/pg-dump.d.ts +126 -0
- package/dist/engine/node/pg-dump.d.ts.map +1 -0
- package/dist/engine/node/pg-dump.js +223 -0
- package/dist/engine/node/pg-dump.js.map +1 -0
- package/dist/engine/node/pidfile.d.ts +38 -0
- package/dist/engine/node/pidfile.d.ts.map +1 -0
- package/dist/engine/node/pidfile.js +156 -0
- package/dist/engine/node/pidfile.js.map +1 -0
- package/dist/engine/node/runtime-tuning.d.ts +65 -0
- package/dist/engine/node/runtime-tuning.d.ts.map +1 -0
- package/dist/engine/node/runtime-tuning.js +198 -0
- package/dist/engine/node/runtime-tuning.js.map +1 -0
- package/dist/engine/node/service.d.ts +39 -0
- package/dist/engine/node/service.d.ts.map +1 -0
- package/dist/engine/node/service.js +211 -0
- package/dist/engine/node/service.js.map +1 -0
- package/dist/engine/node/start.d.ts +62 -0
- package/dist/engine/node/start.d.ts.map +1 -0
- package/dist/engine/node/start.js +245 -0
- package/dist/engine/node/start.js.map +1 -0
- package/dist/engine/node/worker-env-table.d.ts +15 -0
- package/dist/engine/node/worker-env-table.d.ts.map +1 -0
- package/dist/engine/node/worker-env-table.js +97 -0
- package/dist/engine/node/worker-env-table.js.map +1 -0
- package/dist/engine/node/worker-env.d.ts +50 -0
- package/dist/engine/node/worker-env.d.ts.map +1 -0
- package/dist/engine/node/worker-env.js +101 -0
- package/dist/engine/node/worker-env.js.map +1 -0
- package/dist/engine/output.d.ts +97 -0
- package/dist/engine/output.d.ts.map +1 -0
- package/dist/engine/output.js +274 -0
- package/dist/engine/output.js.map +1 -0
- package/dist/engine/package-info.d.ts +7 -0
- package/dist/engine/package-info.d.ts.map +1 -0
- package/dist/engine/package-info.js +38 -0
- package/dist/engine/package-info.js.map +1 -0
- package/dist/engine/program.d.ts +50 -0
- package/dist/engine/program.d.ts.map +1 -0
- package/dist/engine/program.js +197 -0
- package/dist/engine/program.js.map +1 -0
- package/dist/engine/prompt.d.ts +69 -0
- package/dist/engine/prompt.d.ts.map +1 -0
- package/dist/engine/prompt.js +205 -0
- package/dist/engine/prompt.js.map +1 -0
- package/dist/engine/registries.d.ts +5 -0
- package/dist/engine/registries.d.ts.map +1 -0
- package/dist/engine/registries.js +52 -0
- package/dist/engine/registries.js.map +1 -0
- package/dist/engine/request-body.d.ts +31 -0
- package/dist/engine/request-body.d.ts.map +1 -0
- package/dist/engine/request-body.js +156 -0
- package/dist/engine/request-body.js.map +1 -0
- package/dist/engine/test-support.d.ts +50 -0
- package/dist/engine/test-support.d.ts.map +1 -0
- package/dist/engine/test-support.js +86 -0
- package/dist/engine/test-support.js.map +1 -0
- package/dist/engine/tui/app.d.ts +3 -0
- package/dist/engine/tui/app.d.ts.map +1 -0
- package/dist/engine/tui/app.js +100 -0
- package/dist/engine/tui/app.js.map +1 -0
- package/dist/engine/tui/builtin-screens.d.ts +6 -0
- package/dist/engine/tui/builtin-screens.d.ts.map +1 -0
- package/dist/engine/tui/builtin-screens.js +54 -0
- package/dist/engine/tui/builtin-screens.js.map +1 -0
- package/dist/engine/tui/index.d.ts +23 -0
- package/dist/engine/tui/index.d.ts.map +1 -0
- package/dist/engine/tui/index.js +71 -0
- package/dist/engine/tui/index.js.map +1 -0
- package/dist/engine/tui/layout.d.ts +132 -0
- package/dist/engine/tui/layout.d.ts.map +1 -0
- package/dist/engine/tui/layout.js +200 -0
- package/dist/engine/tui/layout.js.map +1 -0
- package/dist/engine/tui/routes.d.ts +5 -0
- package/dist/engine/tui/routes.d.ts.map +1 -0
- package/dist/engine/tui/routes.js +16 -0
- package/dist/engine/tui/routes.js.map +1 -0
- package/dist/engine/tui/screen-registry.d.ts +100 -0
- package/dist/engine/tui/screen-registry.d.ts.map +1 -0
- package/dist/engine/tui/screen-registry.js +96 -0
- package/dist/engine/tui/screen-registry.js.map +1 -0
- package/dist/engine/tui/screen-sections.d.ts +9 -0
- package/dist/engine/tui/screen-sections.d.ts.map +1 -0
- package/dist/engine/tui/screen-sections.js +45 -0
- package/dist/engine/tui/screen-sections.js.map +1 -0
- package/dist/engine/tui/screens/deploy/advanced-model.d.ts +69 -0
- package/dist/engine/tui/screens/deploy/advanced-model.d.ts.map +1 -0
- package/dist/engine/tui/screens/deploy/advanced-model.js +228 -0
- package/dist/engine/tui/screens/deploy/advanced-model.js.map +1 -0
- package/dist/engine/tui/screens/deploy/doctor-model.d.ts +37 -0
- package/dist/engine/tui/screens/deploy/doctor-model.d.ts.map +1 -0
- package/dist/engine/tui/screens/deploy/doctor-model.js +89 -0
- package/dist/engine/tui/screens/deploy/doctor-model.js.map +1 -0
- package/dist/engine/tui/screens/deploy/doctor.d.ts +8 -0
- package/dist/engine/tui/screens/deploy/doctor.d.ts.map +1 -0
- package/dist/engine/tui/screens/deploy/doctor.js +153 -0
- package/dist/engine/tui/screens/deploy/doctor.js.map +1 -0
- package/dist/engine/tui/screens/deploy/fields.d.ts +123 -0
- package/dist/engine/tui/screens/deploy/fields.d.ts.map +1 -0
- package/dist/engine/tui/screens/deploy/fields.js +202 -0
- package/dist/engine/tui/screens/deploy/fields.js.map +1 -0
- package/dist/engine/tui/screens/deploy/flags-model.d.ts +67 -0
- package/dist/engine/tui/screens/deploy/flags-model.d.ts.map +1 -0
- package/dist/engine/tui/screens/deploy/flags-model.js +302 -0
- package/dist/engine/tui/screens/deploy/flags-model.js.map +1 -0
- package/dist/engine/tui/screens/deploy/index.d.ts +6 -0
- package/dist/engine/tui/screens/deploy/index.d.ts.map +1 -0
- package/dist/engine/tui/screens/deploy/index.js +83 -0
- package/dist/engine/tui/screens/deploy/index.js.map +1 -0
- package/dist/engine/tui/screens/deploy/install-model.d.ts +159 -0
- package/dist/engine/tui/screens/deploy/install-model.d.ts.map +1 -0
- package/dist/engine/tui/screens/deploy/install-model.js +319 -0
- package/dist/engine/tui/screens/deploy/install-model.js.map +1 -0
- package/dist/engine/tui/screens/deploy/install.d.ts +8 -0
- package/dist/engine/tui/screens/deploy/install.d.ts.map +1 -0
- package/dist/engine/tui/screens/deploy/install.js +361 -0
- package/dist/engine/tui/screens/deploy/install.js.map +1 -0
- package/dist/engine/tui/screens/deploy/model.d.ts +49 -0
- package/dist/engine/tui/screens/deploy/model.d.ts.map +1 -0
- package/dist/engine/tui/screens/deploy/model.js +59 -0
- package/dist/engine/tui/screens/deploy/model.js.map +1 -0
- package/dist/engine/tui/screens/deploy/run-model.d.ts +58 -0
- package/dist/engine/tui/screens/deploy/run-model.d.ts.map +1 -0
- package/dist/engine/tui/screens/deploy/run-model.js +117 -0
- package/dist/engine/tui/screens/deploy/run-model.js.map +1 -0
- package/dist/engine/tui/screens/deploy/run.d.ts +75 -0
- package/dist/engine/tui/screens/deploy/run.d.ts.map +1 -0
- package/dist/engine/tui/screens/deploy/run.js +201 -0
- package/dist/engine/tui/screens/deploy/run.js.map +1 -0
- package/dist/engine/tui/screens/deploy/status.d.ts +17 -0
- package/dist/engine/tui/screens/deploy/status.d.ts.map +1 -0
- package/dist/engine/tui/screens/deploy/status.js +107 -0
- package/dist/engine/tui/screens/deploy/status.js.map +1 -0
- package/dist/engine/tui/screens/deploy/update.d.ts +41 -0
- package/dist/engine/tui/screens/deploy/update.d.ts.map +1 -0
- package/dist/engine/tui/screens/deploy/update.js +175 -0
- package/dist/engine/tui/screens/deploy/update.js.map +1 -0
- package/dist/engine/tui/screens/deploy.d.ts +12 -0
- package/dist/engine/tui/screens/deploy.d.ts.map +1 -0
- package/dist/engine/tui/screens/deploy.js +23 -0
- package/dist/engine/tui/screens/deploy.js.map +1 -0
- package/dist/engine/tui/screens/invoke.d.ts +6 -0
- package/dist/engine/tui/screens/invoke.d.ts.map +1 -0
- package/dist/engine/tui/screens/invoke.js +193 -0
- package/dist/engine/tui/screens/invoke.js.map +1 -0
- package/dist/engine/tui/screens/login.d.ts +6 -0
- package/dist/engine/tui/screens/login.d.ts.map +1 -0
- package/dist/engine/tui/screens/login.js +255 -0
- package/dist/engine/tui/screens/login.js.map +1 -0
- package/dist/engine/tui/screens/logout.d.ts +6 -0
- package/dist/engine/tui/screens/logout.d.ts.map +1 -0
- package/dist/engine/tui/screens/logout.js +142 -0
- package/dist/engine/tui/screens/logout.js.map +1 -0
- package/dist/engine/tui/screens/menu.d.ts +22 -0
- package/dist/engine/tui/screens/menu.d.ts.map +1 -0
- package/dist/engine/tui/screens/menu.js +84 -0
- package/dist/engine/tui/screens/menu.js.map +1 -0
- package/dist/engine/tui/screens/node.d.ts +6 -0
- package/dist/engine/tui/screens/node.d.ts.map +1 -0
- package/dist/engine/tui/screens/node.js +228 -0
- package/dist/engine/tui/screens/node.js.map +1 -0
- package/dist/engine/tui/screens/status.d.ts +6 -0
- package/dist/engine/tui/screens/status.d.ts.map +1 -0
- package/dist/engine/tui/screens/status.js +134 -0
- package/dist/engine/tui/screens/status.js.map +1 -0
- package/dist/engine/tui/scroll-box.d.ts +27 -0
- package/dist/engine/tui/scroll-box.d.ts.map +1 -0
- package/dist/engine/tui/scroll-box.js +52 -0
- package/dist/engine/tui/scroll-box.js.map +1 -0
- package/dist/engine/tui/section-registry.d.ts +65 -0
- package/dist/engine/tui/section-registry.d.ts.map +1 -0
- package/dist/engine/tui/section-registry.js +90 -0
- package/dist/engine/tui/section-registry.js.map +1 -0
- package/dist/engine/tui/terminal.d.ts +31 -0
- package/dist/engine/tui/terminal.d.ts.map +1 -0
- package/dist/engine/tui/terminal.js +142 -0
- package/dist/engine/tui/terminal.js.map +1 -0
- package/dist/engine/tui/tty.d.ts +49 -0
- package/dist/engine/tui/tty.d.ts.map +1 -0
- package/dist/engine/tui/tty.js +139 -0
- package/dist/engine/tui/tty.js.map +1 -0
- package/dist/index.d.ts +4 -5
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +5 -5
- package/dist/index.js.map +1 -1
- package/dist/node/index.d.ts +3 -0
- package/dist/node/index.d.ts.map +1 -0
- package/dist/node/index.js +5 -0
- package/dist/node/index.js.map +1 -0
- package/dist/telemetry/index.d.ts +2 -1
- package/dist/telemetry/index.d.ts.map +1 -1
- package/dist/telemetry/index.js +1 -0
- package/dist/telemetry/index.js.map +1 -1
- package/dist/telemetry/node-span-relay.d.ts +1 -1
- package/dist/telemetry/node-span-relay.d.ts.map +1 -1
- package/dist/telemetry/node-span-relay.js +39 -6
- package/dist/telemetry/node-span-relay.js.map +1 -1
- package/dist/telemetry/node-span.d.ts +39 -7
- package/dist/telemetry/node-span.d.ts.map +1 -1
- package/dist/telemetry/node-span.js +19 -1
- package/dist/telemetry/node-span.js.map +1 -1
- package/dist/testing/index.d.ts +3 -0
- package/dist/testing/index.d.ts.map +1 -0
- package/dist/testing/index.js +4 -0
- package/dist/testing/index.js.map +1 -0
- package/dist/tui/index.d.ts +3 -0
- package/dist/tui/index.d.ts.map +1 -0
- package/dist/tui/index.js +5 -0
- package/dist/tui/index.js.map +1 -0
- package/package.json +43 -5
|
@@ -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
|