run-spaceapp 1.0.2 → 1.0.35

package/src/index.mjs

@@ -20,17 +20,41 @@ import {
 import { UNIVERSAL_COMMAND } from "./package-info.mjs";
 
 const CONFIG_SCHEMA_VERSION = 4;
-const MIN_INSTALL_CPU_COUNT = 4;
-const MIN_INSTALL_MEMORY_BYTES = 7 * 1024 ** 3;
-const MIN_INSTALL_MEMORY_LABEL = "7 GiB usable (8 GB-class system)";
 const CONTAINER_SECRET_MODE = 0o644;
-const MIN_INSTALL_FREE_DISK_BYTES = 15 * 1024 ** 3;
+export const MIN_INSTALL_FREE_DISK_BYTES_STANDARD = 15 * 1024 ** 3;
+export const MIN_INSTALL_FREE_DISK_BYTES_LIGHT = 7 * 1024 ** 3;
+export const MIN_INSTALL_FREE_DISK_BYTES = MIN_INSTALL_FREE_DISK_BYTES_STANDARD;
 const PROFILE_RUNTIME_SETTINGS = Object.freeze({
+  small: Object.freeze({
+    browserEnabled: false, temporalEnabled: false,
+    coreMemoryLimit: "2g", coreCpuLimit: "2.0",
+    cliMemoryLimit: "2g", cliCpuLimit: "1.5",
+    browserMemoryLimit: "1536m", browserCpuLimit: "1.5",
+    postgresMemoryLimit: "768m", postgresCpuLimit: "1.0",
+    temporalMemoryLimit: "768m", temporalCpuLimit: "1.0"
+  }),
+  medium: Object.freeze({
+    browserEnabled: false, temporalEnabled: true,
+    coreMemoryLimit: "3g", coreCpuLimit: "3.0",
+    cliMemoryLimit: "3g", cliCpuLimit: "2.0",
+    browserMemoryLimit: "1536m", browserCpuLimit: "1.5",
+    postgresMemoryLimit: "1g", postgresCpuLimit: "1.0",
+    temporalMemoryLimit: "768m", temporalCpuLimit: "1.0"
+  }),
+  large: Object.freeze({
+    browserEnabled: true, temporalEnabled: true,
+    coreMemoryLimit: "4g", coreCpuLimit: "4.0",
+    cliMemoryLimit: "4g", cliCpuLimit: "3.0",
+    browserMemoryLimit: "2g", browserCpuLimit: "2.0",
+    postgresMemoryLimit: "1g", postgresCpuLimit: "2.0",
+    temporalMemoryLimit: "1g", temporalCpuLimit: "2.0"
+  }),
   light: Object.freeze({
     browserEnabled: false,
+    temporalEnabled: true,
     coreMemoryLimit: "2g",
     coreCpuLimit: "2.0",
-    cliMemoryLimit: "1536m",
+    cliMemoryLimit: "2g",
     cliCpuLimit: "1.5",
     browserMemoryLimit: "1536m",
     browserCpuLimit: "1.5",
@@ -41,6 +65,7 @@ const PROFILE_RUNTIME_SETTINGS = Object.freeze({
   }),
   standard: Object.freeze({
     browserEnabled: true,
+    temporalEnabled: true,
     coreMemoryLimit: "4g",
     coreCpuLimit: "4.0",
     cliMemoryLimit: "3g",
@@ -53,12 +78,27 @@ const PROFILE_RUNTIME_SETTINGS = Object.freeze({
     temporalCpuLimit: "2.0"
   })
 });
+export const INSTALL_PROFILES = Object.freeze(["small", "medium", "large", "light", "standard"]);
+export const PROFILE_REQUIREMENTS = Object.freeze({
+  small: { cpuCount: 4, memoryBytes: 7 * 1024 ** 3, freshDiskBytes: 6.5 * 1024 ** 3 },
+  medium: { cpuCount: 4, memoryBytes: 11 * 1024 ** 3, freshDiskBytes: 8 * 1024 ** 3 },
+  large: { cpuCount: 8, memoryBytes: 15 * 1024 ** 3, freshDiskBytes: 11 * 1024 ** 3 },
+  // Existing installations keep their settings and background integrations.
+  light: { cpuCount: 4, memoryBytes: 7 * 1024 ** 3, freshDiskBytes: 8 * 1024 ** 3 },
+  standard: { cpuCount: 4, memoryBytes: 7 * 1024 ** 3, freshDiskBytes: 11 * 1024 ** 3 }
+});
+
+export function profileRuntimeSettings(profile) {
+  const settings = PROFILE_RUNTIME_SETTINGS[profile];
+  if (!settings) throw new Error("Install profile must be small, medium, large, light, or standard.");
+  return settings;
+}
 const SECRET_FIELD = /password|secret|token|api.?key|credential/i;
 const VERSION_PATTERN = /^\d+\.\d+\.\d+(?:-[0-9A-Za-z.-]+)?$/;
 const BACKUP_ID_PATTERN = /^spaceapp-backup-\d{8}T\d{9}Z$/;
 const PROVIDERS = Object.freeze({
-  bundled: Object.freeze(["opencode", "codex", "gemini", "qwen", "kimi", "grok", "autohand", "cursor", "copilot"]),
-  ownerInstalled: Object.freeze(["claude"]),
+  bundled: Object.freeze(["opencode"]),
+  ownerInstalled: Object.freeze(["codex", "gemini", "qwen", "kimi", "grok", "autohand", "cursor", "copilot", "claude"]),
   experimental: Object.freeze(["deepseek"])
 });
 const ALL_PROVIDERS = new Set(Object.values(PROVIDERS).flat());
@@ -99,17 +139,23 @@ export function resolveSpaceAppHome({
   return resolve(env.XDG_CONFIG_HOME || join(home, ".config"), "spaceapp");
 }
 
-export function resolveInstallProfile(requestedProfile, totalMemoryBytes) {
-  if (requestedProfile === "light" || requestedProfile === "standard") {
+export function resolveInstallProfile(requestedProfile, resources) {
+  if (INSTALL_PROFILES.includes(requestedProfile)) {
     return requestedProfile;
   }
   if (requestedProfile !== "auto") {
-    throw new Error("Install profile must be auto, light, or standard.");
+    throw new Error("Install profile must be auto, small, medium, large, light, or standard.");
   }
+  const totalMemoryBytes = typeof resources === "number" ? resources : resources?.totalMemoryBytes;
   if (!Number.isFinite(totalMemoryBytes) || totalMemoryBytes <= 0) {
     throw new Error("Total system memory must be available for automatic profile selection.");
   }
-  return "light";
+  // Memory-only callers cannot safely choose a larger footprint.
+  if (typeof resources === "number") return "small";
+  for (const profile of ["large", "medium", "small"]) {
+    if (installResourceChecks(resources, profile).every((check) => check.ok)) return profile;
+  }
+  return "small";
 }
 
 export function resolveInstallAccessMode(requestedMode, existingMode = "isolated") {
@@ -198,29 +244,37 @@ export async function inspectSystemResources(root) {
   };
 }
 
-export function installResourceChecks(resources) {
+export function installResourceChecks(resources, profile = "small", { requiredDiskBytes, operation = "fresh" } = {}) {
   const cpuCount = Number(resources?.cpuCount);
   const totalMemoryBytes = Number(resources?.totalMemoryBytes);
   const freeDiskBytes = Number(resources?.freeDiskBytes);
   if (![cpuCount, totalMemoryBytes, freeDiskBytes].every((value) => Number.isFinite(value) && value >= 0)) {
     throw new Error("System CPU, memory, and free-disk information is required.");
   }
+  const requirements = PROFILE_REQUIREMENTS[profile];
+  if (!requirements) throw new Error("Unknown installation profile.");
+  const minFreeDisk = requiredDiskBytes ?? (operation === "fresh" ? requirements.freshDiskBytes : 512 * 1024 ** 2);
+  const engineMemoryBytes = { small: 3, medium: 5, large: 7, light: 3, standard: 3 }[profile] * 1024 ** 3;
   return [
     {
       name: "CPU",
-      ok: cpuCount >= MIN_INSTALL_CPU_COUNT,
-      detail: `${cpuCount} available; ${MIN_INSTALL_CPU_COUNT} required`
+      ok: cpuCount >= requirements.cpuCount,
+      detail: `${cpuCount} available; ${requirements.cpuCount} required`
     },
     {
       name: "Memory",
-      ok: totalMemoryBytes >= MIN_INSTALL_MEMORY_BYTES,
-      detail: `${formatGibibytes(totalMemoryBytes)} GiB available; ${MIN_INSTALL_MEMORY_LABEL} required`
+      ok: totalMemoryBytes >= requirements.memoryBytes,
+      detail: `${formatGibibytes(totalMemoryBytes)} GiB available; ${formatGibibytes(requirements.memoryBytes)} GiB usable${requirements.memoryBytes === 7 * 1024 ** 3 ? " (8 GB-class system)" : ""} required`
     },
     {
       name: "Free disk",
-      ok: freeDiskBytes >= MIN_INSTALL_FREE_DISK_BYTES,
-      detail: `${formatGibibytes(freeDiskBytes)} GiB available; ${formatGibibytes(MIN_INSTALL_FREE_DISK_BYTES)} GiB required`
-    }
+      ok: freeDiskBytes >= minFreeDisk,
+      detail: `${formatGibibytes(freeDiskBytes)} GiB available; ${formatGibibytes(minFreeDisk)} GiB required${operation === "fresh" ? "" : " additionally for " + operation}`
+    },
+    ...(resources.engineMemoryBytes > 0 ? [{ name: "Docker memory", ok: resources.engineMemoryBytes >= engineMemoryBytes,
+      detail: `${formatGibibytes(resources.engineMemoryBytes)} GiB allocated; ${formatGibibytes(engineMemoryBytes)} GiB required for ${profile}` }] : []),
+    ...(resources.engineCpuCount > 0 ? [{ name: "Docker CPU", ok: resources.engineCpuCount >= 4,
+      detail: `${resources.engineCpuCount} allocated; 4 required` }] : [])
   ];
 }
 
@@ -231,8 +285,8 @@ export function createDefaultConfig({
   companionsEnabled = false
 }) {
   assertVersion(version);
-  if (profile !== "light" && profile !== "standard") {
-    throw new Error("Default config requires a resolved light or standard profile.");
+  if (!INSTALL_PROFILES.includes(profile)) {
+    throw new Error("Default config requires a resolved installation profile.");
   }
   const resolvedAccessMode = resolveInstallAccessMode(accessMode);
   return {
@@ -277,8 +331,8 @@ export function validateConfig(config) {
   if (typeof config.telemetry !== "boolean") {
     throw new Error("telemetry must be boolean.");
   }
-  if (!["light", "standard"].includes(config.profile)) {
-    throw new Error("profile must be light or standard.");
+  if (!INSTALL_PROFILES.includes(config.profile)) {
+    throw new Error("profile must be small, medium, large, light, or standard.");
   }
   if (config.accessMode !== "isolated" && config.accessMode !== "host-root") {
     throw new Error("accessMode must be isolated or host-root.");
@@ -487,6 +541,7 @@ export function renderRuntimeEnv(config) {
     `SPACEAPP_TELEMETRY=${config.telemetry}`,
     `SPACEAPP_PROFILE=${safeEnv(config.profile)}`,
     `SPACEAPP_BROWSER_ENABLED=${settings.browserEnabled}`,
+    `SPACEAPP_WORKFLOWS_ENABLED=${settings.temporalEnabled}`,
     `SPACEAPP_CORE_MEMORY_LIMIT=${settings.coreMemoryLimit}`,
     `SPACEAPP_CORE_CPU_LIMIT=${settings.coreCpuLimit}`,
     `SPACEAPP_CLI_MEMORY_LIMIT=${settings.cliMemoryLimit}`,
@@ -557,9 +612,7 @@ export function composeCommand(action, root, options = {}) {
   const stateRoot = options.stateRoot ?? root;
   validateHome(stateRoot);
   const profile = options.profile ?? "standard";
-  if (profile !== "light" && profile !== "standard") {
-    throw new Error("Compose profile must be light or standard.");
-  }
+  const settings = profileRuntimeSettings(profile);
   const base = [
     "compose",
     "--project-name", composeProjectName(root),
@@ -568,7 +621,8 @@ export function composeCommand(action, root, options = {}) {
     "-f", join(stateRoot, "compose.yml"),
     "-f", join(stateRoot, "compose.workspaces.yml"),
     "-f", join(stateRoot, "compose.host-access.yml"),
-    ...(profile === "standard" ? ["--profile", "standard"] : []),
+    ...(settings.browserEnabled ? ["--profile", "standard"] : []),
+    ...(settings.temporalEnabled ? ["--profile", "workflows"] : []),
     ...(options.companionsEnabled ? ["--profile", "companions"] : [])
   ];
   const actions = {
@@ -617,11 +671,20 @@ export function composeCommand(action, root, options = {}) {
       "--stdin"
     ],
     removeBrowser: ["rm", "--stop", "--force", "spaceapp-browser"],
+    removeTemporal: ["rm", "--stop", "--force", "temporal"],
+    enableTemporal: ["up", "-d", "--force-recreate", "temporal"],
+    databaseSize: ["exec", "-T", "postgres", "psql", "-U", "spaceapp", "-d", "spaceapp", "-Atc", "SELECT pg_database_size(current_database())"],
+    storageFree: ["exec", "-T", "spaceapp-core", "node", "-e", "const fs=require('node:fs');const s=fs.statfsSync('/var/lib/spaceapp');console.log(Number(s.bavail)*Number(s.bsize))"],
     purge: ["down", "--volumes", "--remove-orphans"],
     repair: ["up", "-d", "--remove-orphans", "--force-recreate"],
+    ensureCheckpointDatabase: ["up", "-d", "--no-deps", "--wait", "--wait-timeout", "120", "postgres"],
     checkpointDump: ["exec", "-T", "postgres", "pg_dump", "-c", "--if-exists", "-U", "spaceapp", "-d", "spaceapp"],
     checkpointRestore: ["exec", "-T", "postgres", "psql", "-v", "ON_ERROR_STOP=1", "-U", "spaceapp", "-d", "spaceapp"]
   };
+  if (action === "installProvider") {
+    assertProvider(options.provider);
+    actions.installProvider = ["exec", "-T", "--user", "10001:10001", "spaceapp-cli", "node", "/app/deploy/docker/provider-install.mjs", options.provider];
+  }
   let selected = actions[action];
   if (action === "restore") {
     if (typeof options.backupId !== "string" || !BACKUP_ID_PATTERN.test(options.backupId)) {
@@ -697,7 +760,7 @@ export async function prepareInstallation(root, {
   ]);
   const resolvedProfile = profile === undefined
     ? undefined
-    : resolveInstallProfile(profile, totalmem());
+    : resolveInstallProfile(profile, profile === "auto" ? await inspectSystemResources(root) : totalmem());
   let config;
   try {
     config = await loadConfig(root);
@@ -786,7 +849,8 @@ export async function prepareInstallation(root, {
 }
 
 export async function commitInstallation(root, config, {
-  templateDir = defaultTemplateDir()
+  templateDir = defaultTemplateDir(),
+  persistConfig = true
 } = {}) {
   validateHome(root);
   validateConfig(config);
@@ -794,7 +858,7 @@ export async function commitInstallation(root, config, {
   await mkdir(root, { recursive: true, mode: 0o700 });
   await atomicWrite(join(root, "compose.yml"), composeTemplate);
   await writeRuntimeFiles(root, config);
-  await saveConfig(root, config);
+  if (persistConfig) await saveConfig(root, config);
 }
 
 export async function initializeInstallation(root, options) {

package/src/prerequisites.mjs

@@ -73,6 +73,8 @@ export function windowsPowerShellArgs(operation) {
       "exit $process.ExitCode"
     ].join("; "),
     "start-docker-desktop": [
+      "Set-Service -Name 'com.docker.service' -StartupType Automatic -ErrorAction SilentlyContinue",
+      "Start-Service -Name 'com.docker.service' -ErrorAction SilentlyContinue",
       "$path = $env:SPACEAPP_DOCKER_DESKTOP_PATH",
       "if ([string]::IsNullOrWhiteSpace($path)) { exit 1 }",
       "Start-Process -FilePath $path"
@@ -164,7 +166,8 @@ export async function ensureDockerAvailable({
       launch,
       download,
       pathExists,
-      sleep
+      sleep,
+      installArgs
     });
   }
   return ensureLinuxDocker({
@@ -201,7 +204,12 @@ async function ensureWindowsDocker({
 
   if (!application) {
     stdout.write("Docker Desktop is required and is not installed.\n");
-    const accepted = await confirmDesktopInstall({ platformName: "Windows", stdin, stdout });
+    const accepted = await confirmDesktopInstall({
+      platformName: "Windows",
+      stdin,
+      stdout,
+      autoConfirm: Boolean(installArgs?.autoConfirm)
+    });
     if (!accepted) {
       stderr.write("Docker Desktop installation was cancelled.\n");
       return { code: 1, reexecuted: false };
@@ -404,7 +412,8 @@ async function ensureMacDocker({
   launch,
   download,
   pathExists,
-  sleep
+  sleep,
+  installArgs
 }) {
   const application = "/Applications/Docker.app";
   const cliDirectory = posix.join(application, "Contents", "Resources", "bin");
@@ -412,7 +421,12 @@ async function ensureMacDocker({
 
   if (!installed) {
     stdout.write("Docker Desktop is required and is not installed.\n");
-    const accepted = await confirmDesktopInstall({ platformName: "macOS", stdin, stdout });
+    const accepted = await confirmDesktopInstall({
+      platformName: "macOS",
+      stdin,
+      stdout,
+      autoConfirm: Boolean(installArgs?.autoConfirm)
+    });
     if (!accepted) {
       stderr.write("Docker Desktop installation was cancelled.\n");
       return { code: 1, reexecuted: false };
@@ -508,12 +522,12 @@ async function ensureMacDocker({
     stderr.write("Docker Desktop is installed, but SpaceApp could not start it.\n");
     return { code: launchCode, reexecuted: false };
   }
-  if (await waitForDocker({ execute, sleep })) {
+  if (await waitForDocker({ execute, sleep, attempts: 300 })) {
     stdout.write("Docker Desktop is ready.\n");
     return { code: 0, reexecuted: false };
   }
   stderr.write(
-    `Docker Desktop was installed but did not become ready. Complete any Docker Desktop prompt, then run "${UNIVERSAL_INSTALL_COMMAND}" again.\n`
+    `Docker Desktop did not become ready after 10 minutes. Complete any Docker Desktop prompt, then run "${UNIVERSAL_INSTALL_COMMAND}" again.\n`
   );
   return { code: 1, reexecuted: false };
 }
@@ -526,6 +540,7 @@ async function ensureLinuxDocker({
   stderr,
   execute,
   download,
+  sleep,
   osRelease,
   installArgs
 }) {
@@ -557,7 +572,7 @@ async function ensureLinuxDocker({
     stderr.write("Docker Engine was installed, but its system service could not be started.\n");
     return { code: startCode, reexecuted: false };
   }
-  if (await dockerIsReady(execute)) {
+  if (await waitForDocker({ execute, sleep, attempts: 15 })) {
     stdout.write("Docker Engine is ready.\n");
     return { code: 0, reexecuted: false };
   }
@@ -596,7 +611,11 @@ async function ensureLinuxDocker({
   return { code: reentryCode, reexecuted: true };
 }
 
-async function confirmDesktopInstall({ platformName, stdin, stdout }) {
+async function confirmDesktopInstall({ platformName, stdin, stdout, autoConfirm = false }) {
+  if (autoConfirm) {
+    stdout.write(`Installing Docker Desktop for ${platformName} automatically as approved in setup plan...\n`);
+    return true;
+  }
   return confirmQuestion({
     stdin,
     stdout,
@@ -832,7 +851,7 @@ function linuxReentryCommand({
   requestedAccessMode,
   noOpen = false
 } = {}) {
-  if (!["auto", "light", "standard"].includes(requestedProfile)) {
+  if (!["auto", "small", "medium", "large", "light", "standard"].includes(requestedProfile)) {
     throw new Error("Invalid SpaceApp profile for Docker group re-entry.");
   }
   const entrypoint = fileURLToPath(new URL("../bin/spaceapp.mjs", import.meta.url));
@@ -856,7 +875,7 @@ export function windowsResumeScript({
   requestedAccessMode,
   noOpen = false
 } = {}) {
-  if (!["auto", "light", "standard"].includes(requestedProfile)) {
+  if (!["auto", "small", "medium", "large", "light", "standard"].includes(requestedProfile)) {
     throw new Error("Invalid SpaceApp profile for Windows resume.");
   }
   if (typeof noOpen !== "boolean") {
@@ -1050,7 +1069,7 @@ function launchDetachedCommand(spec) {
       if (spec.operation === "start-docker-desktop") {
         child = spawn("powershell.exe", windowsPowerShellArgs(spec.operation), options);
       } else if (spec.operation === "open-docker-desktop") {
-        child = spawn("open", ["-a", "Docker"], options);
+        child = spawn("open", ["-a", "/Applications/Docker.app"], options);
       } else {
         resolve(1);
         return;
@@ -1061,9 +1080,15 @@ function launchDetachedCommand(spec) {
     }
     child.once("error", () => resolve(1));
     child.once("spawn", () => {
+      // macOS open exits after Launch Services accepts or rejects the launch.
+      // Spawning the utility alone is not evidence that it opened Docker.
+      if (spec.operation === "open-docker-desktop") return;
       child.unref();
       resolve(0);
     });
+    if (spec.operation === "open-docker-desktop") {
+      child.once("exit", (code, signal) => resolve(code ?? (signal ? 1 : 0)));
+    }
   });
 }