openpalm 0.2.0 → 0.2.6

package/src/commands/install.ts

@@ -1,326 +0,0 @@
-import { join } from "node:path";
-import { chmod, writeFile, rm } from "node:fs/promises";
-import type { InstallOptions } from "../types.ts";
-import type { ComposeConfig } from "@openpalm/lib/types.ts";
-import { detectOS, detectArch, detectRuntime, resolveSocketPath, resolveComposeBin, validateRuntime } from "@openpalm/lib/runtime.ts";
-import { resolveXDGPaths, createDirectoryTree } from "@openpalm/lib/paths.ts";
-import { upsertEnvVars } from "@openpalm/lib/env.ts";
-import { generateToken } from "@openpalm/lib/tokens.ts";
-import { composePull, composeUp } from "@openpalm/lib/compose.ts";
-import { seedConfigFiles } from "@openpalm/lib/assets.ts";
-import { runPreflightChecks, noRuntimeGuidance, noComposeGuidance } from "@openpalm/lib/preflight.ts";
-import { log, info, warn, error, bold, green, cyan, yellow, dim, spinner } from "@openpalm/lib/ui.ts";
-
-export async function install(options: InstallOptions): Promise<void> {
-  // ============================================================================
-  // Phase 1: Setup infrastructure
-  // ============================================================================
-
-  log(bold("\nOpenPalm Installation\n"));
-
-  // 1. Detect OS
-  const os = detectOS();
-  if (os === "unknown") {
-    error("Unable to detect operating system. Installation aborted.");
-    process.exit(1);
-  }
-
-  // 2. Detect arch
-  const arch = detectArch();
-
-  // 3. Detect or use overridden container runtime
-  const platform = options.runtime ?? await detectRuntime(os);
-  if (!platform) {
-    error(noRuntimeGuidance(os));
-    process.exit(1);
-  }
-
-  // 4. Resolve compose bin/subcommand
-  const { bin, subcommand } = resolveComposeBin(platform);
-
-  // 5. Run pre-flight checks (daemon running, disk space, port 80)
-  const preflightWarnings = await runPreflightChecks(bin, platform);
-  for (const w of preflightWarnings) {
-    warn(w.message);
-    if (w.detail) {
-      for (const line of w.detail.split("\n")) {
-        info(`  ${line}`);
-      }
-    }
-    log("");
-  }
-
-  // Daemon not running is fatal — we can't proceed
-  const daemonWarning = preflightWarnings.find((w) =>
-    w.message.includes("daemon is not running")
-  );
-  if (daemonWarning) {
-    process.exit(1);
-  }
-
-  // 6. Validate compose works
-  const isValid = await validateRuntime(bin, subcommand);
-  if (!isValid) {
-    error(noComposeGuidance(platform));
-    process.exit(1);
-  }
-
-  // 7. Print detected info
-  log(bold("Detected environment:"));
-  info(`  OS: ${cyan(os)}`);
-  info(`  Architecture: ${cyan(arch)}`);
-  info(`  Container runtime: ${cyan(platform)}`);
-  info(`  Compose command: ${cyan(`${bin} ${subcommand}`)}\n`);
-
-  // 8. Resolve XDG paths, print them
-  const xdg = resolveXDGPaths();
-  log(bold("\nXDG paths:"));
-  info(`  Data: ${dim(xdg.data)}`);
-  info(`  Config: ${dim(xdg.config)}`);
-  info(`  State: ${dim(xdg.state)}\n`);
-
-  // 9. Check if .env exists in CWD, generate if not
-  const envPath = join(process.cwd(), ".env");
-  const envExists = await Bun.file(envPath).exists();
-
-  let generatedAdminToken = "";
-  if (!envExists) {
-    const spin2 = spinner("Generating .env file...");
-    generatedAdminToken = generateToken();
-    const overrides: Record<string, string> = {
-      ADMIN_TOKEN: generatedAdminToken,
-      POSTGRES_PASSWORD: generateToken(),
-      CHANNEL_CHAT_SECRET: generateToken(),
-      CHANNEL_DISCORD_SECRET: generateToken(),
-      CHANNEL_VOICE_SECRET: generateToken(),
-      CHANNEL_TELEGRAM_SECRET: generateToken(),
-    };
-    const envSeed = Object.entries(overrides).map(([key, value]) => `${key}=${value}`).join("\n") + "\n";
-    await writeFile(envPath, envSeed, "utf8");
-    spin2.stop(green(".env file created"));
-
-    // Display admin token prominently
-    log("");
-    log(bold(green("  YOUR ADMIN PASSWORD (save this!)")));
-    log("");
-    log(`  ${yellow(generatedAdminToken)}`);
-    log("");
-    info("  You will need this password to log in to the admin dashboard.");
-    info(`  It is also saved in: ${dim(envPath)}`);
-    log("");
-  } else {
-    info("Using existing .env file");
-  }
-
-  // 10. Upsert runtime config vars into .env (single read-write cycle)
-  const socketPath = resolveSocketPath(platform, os);
-  await upsertEnvVars(envPath, [
-    ["OPENPALM_DATA_HOME", xdg.data],
-    ["OPENPALM_CONFIG_HOME", xdg.config],
-    ["OPENPALM_STATE_HOME", xdg.state],
-    ["OPENPALM_CONTAINER_PLATFORM", platform],
-    ["OPENPALM_COMPOSE_BIN", bin],
-    ["OPENPALM_COMPOSE_SUBCOMMAND", subcommand],
-    ["OPENPALM_CONTAINER_SOCKET_PATH", socketPath],
-    ["OPENPALM_CONTAINER_SOCKET_IN_CONTAINER", "/var/run/docker.sock"],
-    ["OPENPALM_CONTAINER_SOCKET_URI", "unix:///var/run/docker.sock"],
-    ["OPENPALM_IMAGE_TAG", `latest-${arch}`],
-    ["OPENPALM_ENABLED_CHANNELS", ""],
-  ]);
-
-  // 11. Create XDG directory tree
-  const spin3 = spinner("Creating directory structure...");
-  await createDirectoryTree(xdg);
-  spin3.stop(green("Directory structure created"));
-
-  // 12. Copy .env to state home
-  const stateEnvFile = join(xdg.state, ".env");
-  await Bun.write(stateEnvFile, Bun.file(envPath));
-
-  // 13. Seed config files (embedded templates — no network needed)
-  const spin4 = spinner("Seeding configuration files...");
-  await seedConfigFiles(xdg.config);
-  spin4.stop(green("Configuration files seeded"));
-
-  // 14. Reset setup wizard state so every install/reinstall starts from first boot
-  await rm(join(xdg.data, "admin", "setup-state.json"), { force: true });
-
-  // 15. Write uninstall script to state home
-  const uninstallDst = join(xdg.state, "uninstall.sh");
-  await writeFile(uninstallDst, "#!/usr/bin/env bash\nopenpalm uninstall\n", "utf8");
-  try {
-    await chmod(uninstallDst, 0o755);
-  } catch {
-    // chmod may fail on Windows — non-critical
-  }
-
-  // 16. Write minimal setup-only Caddy JSON config (admin routes only)
-  const minimalCaddyJson = JSON.stringify({
-    admin: { disabled: true },
-    apps: {
-      http: {
-        servers: {
-          main: {
-            listen: [":80"],
-            routes: [
-              {
-                match: [{ path: ["/admin*"] }],
-                handle: [{
-                  handler: "subroute",
-                  routes: [
-                    {
-                      match: [{ path: ["/admin/api*"] }],
-                      handle: [
-                        { handler: "rewrite", uri_substring: [{ find: "/admin/api", replace: "/admin" }] },
-                        { handler: "reverse_proxy", upstreams: [{ dial: "admin:8100" }] },
-                      ],
-                      terminal: true,
-                    },
-                    {
-                      handle: [
-                        { handler: "rewrite", strip_path_prefix: "/admin" },
-                        { handler: "reverse_proxy", upstreams: [{ dial: "admin:8100" }] },
-                      ],
-                    },
-                  ],
-                }],
-                terminal: true,
-              },
-              {
-                handle: [{
-                  handler: "static_response",
-                  body: "OpenPalm is starting... Please visit /admin/ to complete setup.",
-                  status_code: "503",
-                }],
-              },
-            ],
-          },
-        },
-      },
-    },
-  }, null, 2) + "\n";
-  const caddyJsonPath = join(xdg.state, "rendered", "caddy", "caddy.json");
-  await writeFile(caddyJsonPath, minimalCaddyJson, "utf8");
-
-  // ============================================================================
-  // Phase 2: Early UI access
-  // ============================================================================
-
-  log(bold("\nDownloading OpenPalm services (this may take a few minutes on first install)...\n"));
-
-  // The compose file is generated by the admin on first stack apply.
-  // For initial install, we need a minimal compose file to start core services.
-  // The admin server will generate the full compose file when the stack is applied.
-  const stateComposeFile = join(xdg.state, "docker-compose.yml");
-
-  const composeConfig: ComposeConfig = {
-    bin,
-    subcommand,
-    composeFile: stateComposeFile,
-    envFile: stateEnvFile,
-  };
-
-  const coreServices = ["caddy", "admin"];
-
-  const spin6 = spinner("Pulling core service images...");
-  await composePull(composeConfig, coreServices);
-  spin6.stop(green("Core images pulled"));
-
-  const spin7 = spinner("Starting core services...");
-  await composeUp(composeConfig, coreServices, { detach: true });
-  spin7.stop(green("Core services started"));
-
-  // Wait for admin health check
-  const adminUrl = "http://localhost/admin";
-  const healthUrl = `${adminUrl}/api/setup/status`;
-  const spin8 = spinner("Waiting for admin interface...");
-
-  let healthy = false;
-  for (let i = 0; i < 90; i++) {
-    try {
-      const response = await fetch(healthUrl, { signal: AbortSignal.timeout(3000) });
-      if (response.ok) {
-        healthy = true;
-        break;
-      }
-    } catch {
-      // Service not ready yet
-    }
-    await Bun.sleep(2000);
-  }
-
-  if (!healthy) {
-    spin8.stop(yellow("Admin interface did not become healthy in time"));
-  } else {
-    spin8.stop(green("Admin interface ready"));
-  }
-
-  // Open browser
-  if (!options.noOpen && healthy) {
-    try {
-      if (os === "macos") {
-        Bun.spawn(["open", adminUrl]);
-      } else if (os === "linux") {
-        Bun.spawn(["xdg-open", adminUrl]);
-      } else {
-        // Windows — use cmd /c start
-        Bun.spawn(["cmd", "/c", "start", adminUrl]);
-      }
-    } catch {
-      // Ignore — we print the URL below
-    }
-  }
-
-  // ============================================================================
-  // Final output
-  // ============================================================================
-
-  if (healthy) {
-    log("");
-    log(bold(green("  OpenPalm setup wizard is ready!")));
-    log("");
-    info(`  Setup wizard: ${cyan(adminUrl)}`);
-    log("");
-    if (generatedAdminToken) {
-      info(`  Admin password: ${yellow(generatedAdminToken)}`);
-      log("");
-    }
-    log(bold("  What happens next:"));
-    info("    1. The setup wizard opens in your browser");
-    info("    2. Enter your AI provider API key (e.g. from console.anthropic.com)");
-    info("    3. The wizard will download and start remaining services automatically");
-    info("    4. Pick which channels to enable (chat, Discord, etc.)");
-    info("    5. Done! Start chatting with your assistant");
-    log("");
-    if (!options.noOpen) {
-      info("  Opening setup wizard in your browser...");
-    } else {
-      info(`  Open this URL in your browser to continue: ${adminUrl}`);
-    }
-  } else {
-    log("");
-    log(bold(yellow("  Setup did not come online within 90 seconds")));
-    log("");
-    info("  This usually means containers are still starting. Try these steps:");
-    log("");
-    info(`  1. Wait a minute, then open: ${adminUrl}`);
-    log("");
-    info("  2. Check if containers are running:");
-    info("     openpalm status");
-    log("");
-    info("  3. Check logs for errors:");
-    info("     openpalm logs");
-    log("");
-    info("  4. Common fixes:");
-    info("     - Make sure port 80 is not used by another service");
-    info("     - Restart Docker/Podman and try again");
-    info("     - Check that you have internet access (images need to download)");
-  }
-
-  log("");
-  log(bold("  Useful commands:"));
-  info("    View logs:  openpalm logs");
-  info("    Stop:       openpalm stop");
-  info("    Uninstall:  openpalm uninstall");
-  log("");
-}

package/src/commands/logs.ts

@@ -1,7 +0,0 @@
-import { composeLogs } from "@openpalm/lib/compose.ts";
-import { loadComposeConfig } from "@openpalm/lib/config.ts";
-
-export async function logs(services?: string[]): Promise<void> {
-  const config = await loadComposeConfig();
-  await composeLogs(config, services?.length ? services : undefined, { follow: true, tail: 50 });
-}

package/src/commands/preflight.ts

@@ -1,49 +0,0 @@
-import { statSync } from "node:fs";
-import { info } from "@openpalm/lib/ui.ts";
-
-const devDir = ".dev";
-const envFile = ".env";
-
-const requiredDirs = [
-  "config",
-  "data/postgres",
-  "data/qdrant",
-  "data/openmemory",
-  "data/assistant",
-  "state/gateway",
-  "state/caddy",
-  "state/rendered/caddy",
-];
-
-export function preflight(): void {
-  const issues: string[] = [];
-
-  try {
-    statSync(envFile);
-  } catch {
-    issues.push(`Missing ${envFile}. Run: bun run dev:setup`);
-  }
-
-  try {
-    statSync(devDir);
-  } catch {
-    issues.push(`Missing ${devDir}/ directory. Run: bun run dev:setup`);
-  }
-
-  if (issues.length === 0) {
-    for (const dir of requiredDirs) {
-      try {
-        statSync(`${devDir}/${dir}`);
-      } catch {
-        issues.push(`Missing ${devDir}/${dir}. Run: bun run dev:setup`);
-        break;
-      }
-    }
-  }
-
-  if (issues.length > 0) {
-    throw new Error(`Pre-flight check failed:\n\n${issues.map((issue) => `  - ${issue}`).join("\n")}\n\nRun 'bun run dev:setup' first, then try again.`);
-  }
-
-  info("Pre-flight check passed.");
-}

package/src/commands/restart.ts

@@ -1,10 +0,0 @@
-import { composeRestart } from "@openpalm/lib/compose.ts";
-import { loadComposeConfig } from "@openpalm/lib/config.ts";
-import { info, green } from "@openpalm/lib/ui.ts";
-
-export async function restart(services?: string[]): Promise<void> {
-  const config = await loadComposeConfig();
-  info("Restarting services...");
-  await composeRestart(config, services);
-  info(green("Services restarted."));
-}

package/src/commands/start.ts

@@ -1,10 +0,0 @@
-import { composeUp } from "@openpalm/lib/compose.ts";
-import { loadComposeConfig } from "@openpalm/lib/config.ts";
-import { info, green } from "@openpalm/lib/ui.ts";
-
-export async function start(services?: string[]): Promise<void> {
-  const config = await loadComposeConfig();
-  info("Starting services...");
-  await composeUp(config, services);
-  info(green("Services started."));
-}

package/src/commands/status.ts

@@ -1,9 +0,0 @@
-import { composePs } from "@openpalm/lib/compose.ts";
-import { loadComposeConfig } from "@openpalm/lib/config.ts";
-import { log } from "@openpalm/lib/ui.ts";
-
-export async function status(): Promise<void> {
-  const config = await loadComposeConfig();
-  const output = await composePs(config);
-  log(output);
-}

package/src/commands/stop.ts

@@ -1,10 +0,0 @@
-import { composeStop } from "@openpalm/lib/compose.ts";
-import { loadComposeConfig } from "@openpalm/lib/config.ts";
-import { info, green } from "@openpalm/lib/ui.ts";
-
-export async function stop(services?: string[]): Promise<void> {
-  const config = await loadComposeConfig();
-  info("Stopping services...");
-  await composeStop(config, services);
-  info(green("Services stopped."));
-}

package/src/commands/uninstall.ts

@@ -1,124 +0,0 @@
-import { rm, unlink } from "node:fs/promises";
-import { join } from "node:path";
-import type { UninstallOptions, ContainerPlatform } from "../types.ts";
-import type { ComposeConfig } from "@openpalm/lib/types.ts";
-import { composeDown } from "@openpalm/lib/compose.ts";
-import { readEnvFile } from "@openpalm/lib/env.ts";
-import { resolveXDGPaths } from "@openpalm/lib/paths.ts";
-import { resolveComposeBin, detectRuntime, detectOS } from "@openpalm/lib/runtime.ts";
-import { log, info, warn, error, bold, green, red, yellow, confirm } from "@openpalm/lib/ui.ts";
-
-export async function uninstall(options: UninstallOptions): Promise<void> {
-  // 1. Resolve XDG paths
-  const xdg = resolveXDGPaths();
-
-  // 2. Try to read .env from state home, falling back to CWD .env
-  let env: Record<string, string> = {};
-  const stateEnvPath = join(xdg.state, ".env");
-  try {
-    env = await readEnvFile(stateEnvPath);
-  } catch {
-    try {
-      env = await readEnvFile(".env");
-    } catch {
-      // No env file found, continue with empty env
-    }
-  }
-
-  // 3. Determine container platform
-  let platform: ContainerPlatform | null = null;
-  if (options.runtime) {
-    platform = options.runtime;
-  } else if (env.OPENPALM_CONTAINER_PLATFORM) {
-    platform = env.OPENPALM_CONTAINER_PLATFORM as ContainerPlatform;
-  } else {
-    platform = await detectRuntime(detectOS());
-  }
-
-  // 4. Resolve compose bin/subcommand if platform found
-  let composeBin: { bin: string; subcommand: string } | null = null;
-  if (platform) {
-    composeBin = resolveComposeBin(platform);
-  }
-
-  // 5. Print planned actions summary
-  log("");
-  log(bold("Uninstall Summary:"));
-  log(`Runtime platform: ${platform || "not detected"}`);
-  log("Stop/remove containers: yes");
-  log(`Remove images: ${options.removeImages ? "yes" : "no"}`);
-  log(`Remove all data/config/state: ${options.removeAll ? "yes" : "no"}`);
-  log("");
-  log(`Data directory: ${xdg.data}`);
-  log(`Config directory: ${xdg.config}`);
-  log(`State directory: ${xdg.state}`);
-  log("");
-
-  // 6. Prompt for confirmation if not --yes
-  if (!options.yes) {
-    const shouldContinue = await confirm("Continue?");
-    if (!shouldContinue) {
-      log("Aborted.");
-      return;
-    }
-  }
-
-  // 7. Stop and remove containers if compose is available
-  const composeFilePath = join(xdg.state, "docker-compose.yml");
-  if (composeBin && platform) {
-    try {
-      // Check if compose file exists by attempting to read env (simple existence check)
-      await Bun.file(composeFilePath).text();
-
-      const config: ComposeConfig = {
-        bin: composeBin.bin,
-        subcommand: composeBin.subcommand,
-        envFile: stateEnvPath,
-        composeFile: composeFilePath,
-      };
-
-      await composeDown(config, {
-        removeOrphans: true,
-        removeImages: options.removeImages,
-      });
-    } catch {
-      // 8. Compose file not found or other error
-      warn("Compose runtime or file not found; skipping container shutdown.");
-    }
-  } else {
-    // 8. No platform/compose bin detected
-    warn("Compose runtime or file not found; skipping container shutdown.");
-  }
-
-  // 9. Remove all data/config/state if requested
-  if (options.removeAll) {
-    try {
-      await rm(xdg.data, { recursive: true, force: true });
-    } catch {
-      // Directory may not exist, continue
-    }
-
-    try {
-      await rm(xdg.config, { recursive: true, force: true });
-    } catch {
-      // Directory may not exist, continue
-    }
-
-    try {
-      await rm(xdg.state, { recursive: true, force: true });
-    } catch {
-      // Directory may not exist, continue
-    }
-
-    try {
-      await unlink(".env");
-    } catch {
-      // .env may not exist in CWD, continue
-    }
-
-    info("Removed OpenPalm data/config/state and local .env.");
-  }
-
-  // 10. Success message
-  info(green("Uninstall complete."));
-}

package/src/commands/update.ts

@@ -1,12 +0,0 @@
-import { composePull, composeUp } from "@openpalm/lib/compose.ts";
-import { loadComposeConfig } from "@openpalm/lib/config.ts";
-import { info, green } from "@openpalm/lib/ui.ts";
-
-export async function update(): Promise<void> {
-  const config = await loadComposeConfig();
-  info("Pulling latest images...");
-  await composePull(config);
-  info("Recreating containers with updated images...");
-  await composeUp(config, undefined, { pull: "always" });
-  info(green("Update complete."));
-}