@pleri/olam-cli 0.1.7

package/dist/commands/refresh.js

@@ -0,0 +1,237 @@
+/**
+ * olam refresh <world> — Hot-refresh per-world CP from the local checkout.
+ *
+ * Copies the latest packages/control-plane/standalone/ source into a running
+ * devbox container, then restarts the CP via `docker restart`.
+ *
+ * Restart mechanism: the devbox CMD is `node /opt/olam/control-plane/server.mjs`
+ * (PID 1 via entrypoint.sh's `exec "$@"`). No supervisor wrapper exists — killing
+ * PID 1 stops the container. `docker restart` is therefore the correct mechanism:
+ * it stops the container, re-runs entrypoint.sh + CMD, which reinstalls hooks
+ * and starts the CP cleanly.
+ *
+ * Side-effect: any running tmux sessions (including active claude sessions) are
+ * killed on restart. Operators should re-dispatch if needed afterward.
+ * This is the accepted tradeoff for a maintenance operation.
+ *
+ * Source parity: the file list mirrors build-devbox.sh:38-77 exactly. Any
+ * drift between this file and that script will produce a broken world.
+ */
+import * as fs from 'node:fs';
+import * as os from 'node:os';
+import * as path from 'node:path';
+import { spawnSync } from 'node:child_process';
+import ora from 'ora';
+import { loadContext } from '../context.js';
+import { printError, printInfo, printHeader, printWarning } from '../output.js';
+import { collectCpSourceFiles, validateServerMjsPresent, } from './refresh-helpers.js';
+// Re-export for consumers who want the pure helpers without the full command.
+export { collectCpSourceFiles, validateServerMjsPresent } from './refresh-helpers.js';
+// Container port 8080 maps to host port 19080 + portOffset (container.ts)
+const HOST_CP_BASE_PORT = 19080;
+// docker restart --time: seconds to wait for graceful stop before SIGKILL
+const RESTART_TIMEOUT_S = 30;
+// Health poll interval / total timeout
+const HEALTH_POLL_MS = 500;
+const HEALTH_TIMEOUT_MS = 30_000;
+// ── Docker helpers ──────────────────────────────────────────────────────────
+function docker(args) {
+    const result = spawnSync('docker', args, {
+        encoding: 'utf-8',
+        stdio: ['ignore', 'pipe', 'pipe'],
+    });
+    return {
+        ok: result.status === 0 && result.error === undefined,
+        stdout: result.stdout ?? '',
+        stderr: result.stderr ?? '',
+    };
+}
+async function waitForCpHealth(port, timeoutMs = HEALTH_TIMEOUT_MS) {
+    const deadline = Date.now() + timeoutMs;
+    while (Date.now() < deadline) {
+        try {
+            const res = await fetch(`http://127.0.0.1:${port}/health`, {
+                signal: AbortSignal.timeout(2000),
+            });
+            if (res.ok)
+                return true;
+        }
+        catch {
+            // not up yet — keep polling
+        }
+        await new Promise(r => setTimeout(r, HEALTH_POLL_MS));
+    }
+    return false;
+}
+async function refreshWorld(worldId, portOffset, standaloneDir, opts) {
+    const containerName = `olam-${worldId}-devbox`;
+    // 1. Collect + validate source files
+    let entries;
+    try {
+        entries = collectCpSourceFiles(standaloneDir);
+        if (!opts.skipBuild) {
+            validateServerMjsPresent(entries);
+        }
+    }
+    catch (err) {
+        return {
+            worldId,
+            ok: false,
+            error: err instanceof Error ? err.message : String(err),
+        };
+    }
+    // 2. Stage into a temp dir (mirrors build-devbox.sh's BUILD_DIR staging)
+    const stagingDir = fs.mkdtempSync(path.join(os.tmpdir(), `olam-refresh-${worldId}-`));
+    try {
+        const hasLib = entries.some(e => e.destRelPath.startsWith('lib/'));
+        if (hasLib) {
+            fs.mkdirSync(path.join(stagingDir, 'lib'), { recursive: true });
+        }
+        for (const { srcPath, destRelPath } of entries) {
+            fs.copyFileSync(srcPath, path.join(stagingDir, destRelPath));
+        }
+        // 3. docker cp staging contents → container
+        // Trailing /. on the source copies contents, not the dir itself.
+        const cpResult = docker([
+            'cp',
+            `${stagingDir}/.`,
+            `${containerName}:/opt/olam/control-plane/`,
+        ]);
+        if (!cpResult.ok) {
+            return {
+                worldId,
+                ok: false,
+                error: `docker cp failed: ${cpResult.stderr.trim() || cpResult.stdout.trim()}`,
+            };
+        }
+    }
+    finally {
+        fs.rmSync(stagingDir, { recursive: true, force: true });
+    }
+    // 4. Restart if requested
+    if (opts.restart) {
+        const restartResult = docker([
+            'restart', '--time', String(RESTART_TIMEOUT_S), containerName,
+        ]);
+        if (!restartResult.ok) {
+            return {
+                worldId,
+                ok: false,
+                error: `docker restart failed: ${restartResult.stderr.trim() || restartResult.stdout.trim()}`,
+            };
+        }
+        // 5. Poll health endpoint
+        const cpPort = HOST_CP_BASE_PORT + portOffset;
+        const healthy = await waitForCpHealth(cpPort);
+        if (!healthy) {
+            // Non-fatal: files are copied and container restarted, just slow to respond
+            return { worldId, ok: true, error: `healthy but /health at :${cpPort} didn't respond within ${HEALTH_TIMEOUT_MS / 1000}s` };
+        }
+    }
+    return { worldId, ok: true };
+}
+// ── Command registration ────────────────────────────────────────────────────
+export function registerRefresh(program) {
+    program
+        .command('refresh')
+        .description("Hot-refresh a running world's per-world CP from the local checkout")
+        .argument('[world]', 'World ID')
+        .option('--all', 'Refresh every running world sequentially (overrides positional arg)')
+        .option('--no-restart', 'Copy files but skip CP restart (for debugging)')
+        .option('--skip-build', 'Skip the prerequisite server.mjs presence check')
+        .action(async (worldId, opts) => {
+        // Validate: need world ID or --all
+        if (!opts.all && !worldId) {
+            printError('Specify a world ID or use --all to refresh all running worlds.');
+            process.exitCode = 1;
+            return;
+        }
+        const { ctx, error } = await loadContext();
+        if (!ctx) {
+            printError(error?.message ?? 'Olam is not configured. Run `olam init` first.');
+            process.exitCode = 1;
+            return;
+        }
+        // Locate standalone source dir (must run from olam repo root)
+        const standaloneDir = path.join(process.cwd(), 'packages/control-plane/standalone');
+        if (!fs.existsSync(standaloneDir)) {
+            printError(`CP standalone source not found at ${standaloneDir}.\n` +
+                'Run `olam refresh` from the olam repo root.');
+            process.exitCode = 1;
+            return;
+        }
+        const restart = opts.restart !== false;
+        const skipBuild = opts.skipBuild === true;
+        // Collect worlds to refresh
+        const worldsToRefresh = opts.all
+            ? ctx.worldManager.listWorlds({ status: 'running' })
+            : (() => {
+                const w = ctx.worldManager.getWorld(worldId);
+                if (!w) {
+                    printError(`World "${worldId}" not found in registry. Run \`olam list\` to see worlds.`);
+                    process.exitCode = 1;
+                    return null;
+                }
+                if (w.status !== 'running') {
+                    printError(`World "${worldId}" is ${w.status}. Only running worlds can be refreshed.`);
+                    process.exitCode = 1;
+                    return null;
+                }
+                return [w];
+            })();
+        if (!worldsToRefresh)
+            return; // error already printed above
+        if (worldsToRefresh.length === 0) {
+            printInfo('No worlds', 'No running worlds found to refresh.');
+            return;
+        }
+        printHeader('olam refresh');
+        printInfo('Source', standaloneDir);
+        printInfo('Worlds', worldsToRefresh.map(w => `${w.name} (${w.id})`).join(', '));
+        printInfo('Restart', restart ? 'yes (docker restart)' : 'no (--no-restart)');
+        process.stdout.write('\n');
+        const results = [];
+        for (const world of worldsToRefresh) {
+            const spinner = ora(`${world.name}: copying CP source...`).start();
+            try {
+                const result = await refreshWorld(world.id, world.portOffset, standaloneDir, { restart, skipBuild });
+                results.push(result);
+                if (!result.ok) {
+                    spinner.fail(`${world.name}: ${result.error}`);
+                    continue;
+                }
+                // ok=true but with a warning (health timeout)
+                if (result.error) {
+                    spinner.warn(`${world.name}: refreshed — ${result.error}`);
+                }
+                else if (restart) {
+                    spinner.succeed(`${world.name}: refreshed and healthy`);
+                }
+                else {
+                    spinner.succeed(`${world.name}: files copied (restart skipped)`);
+                }
+            }
+            catch (err) {
+                const msg = err instanceof Error ? err.message : String(err);
+                results.push({ worldId: world.id, ok: false, error: msg });
+                spinner.fail(`${world.name}: ${msg}`);
+            }
+        }
+        // Summary for --all
+        if (opts.all) {
+            const okCount = results.filter(r => r.ok).length;
+            const errCount = results.filter(r => !r.ok).length;
+            process.stdout.write('\n');
+            if (errCount > 0) {
+                printWarning(`refreshed: ${okCount}, errored: ${errCount}`);
+            }
+            else {
+                printInfo('Summary', `refreshed: ${okCount}`);
+            }
+        }
+        if (results.some(r => !r.ok)) {
+            process.exitCode = 1;
+        }
+    });
+}
+//# sourceMappingURL=refresh.js.map

package/dist/commands/refresh.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"refresh.js","sourceRoot":"","sources":["../../src/commands/refresh.ts"],"names":[],"mappings":"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"}

package/dist/commands/status.d.ts

@@ -0,0 +1,6 @@
+/**
+ * olam status <world> — Show detailed world status.
+ */
+import type { Command } from 'commander';
+export declare function registerStatus(program: Command): void;
+//# sourceMappingURL=status.d.ts.map

package/dist/commands/status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../src/commands/status.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIzC,wBAAgB,cAAc,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAgDrD"}

package/dist/commands/status.js

@@ -0,0 +1,51 @@
+/**
+ * olam status <world> — Show detailed world status.
+ */
+import { loadContext } from '../context.js';
+import { printError, printInfo, printHeader, formatAge } from '../output.js';
+export function registerStatus(program) {
+    program
+        .command('status')
+        .description('Show detailed world status')
+        .argument('<world>', 'World ID')
+        .option('--json', 'Output as JSON')
+        .action(async (worldId, opts) => {
+        const { ctx, error } = await loadContext();
+        if (!ctx) {
+            printError(error?.message ?? 'Olam is not configured. Run `olam init` first.');
+            process.exitCode = 1;
+            return;
+        }
+        const world = ctx.worldManager.getWorld(worldId);
+        if (!world) {
+            printError(`World "${worldId}" not found. Run \`olam list\` to see worlds.`);
+            process.exitCode = 1;
+            return;
+        }
+        const cost = ctx.costTracker.getWorldCost(worldId);
+        const dashboardUrl = `http://localhost:${19080 + world.portOffset}`;
+        if (opts.json) {
+            console.log(JSON.stringify({ ...world, dashboardUrl, cost }, null, 2));
+            return;
+        }
+        printHeader(`${world.name} (${world.id})`);
+        printInfo('Status', world.status);
+        printInfo('Repos', world.repos.join(', '));
+        printInfo('Branch', world.branch);
+        printInfo('Provider', world.computeProvider);
+        printInfo('Port Offset', String(world.portOffset));
+        printInfo('Workspace', world.workspacePath);
+        printInfo('Dashboard', dashboardUrl);
+        if (world.appPortUrls && world.appPortUrls.length > 0) {
+            world.appPortUrls.forEach((ap, i) => {
+                printInfo(i === 0 ? 'Apps' : '', `${ap.repoName}  ${ap.url}`);
+            });
+        }
+        printInfo('Cost', `$${cost.toFixed(4)}`);
+        printInfo('Thoughts', String(world.thoughtCount));
+        printInfo('Created', world.createdAt);
+        printInfo('Uptime', formatAge(world.createdAt));
+        printInfo('Updated', world.updatedAt);
+    });
+}
+//# sourceMappingURL=status.js.map

package/dist/commands/status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.js","sourceRoot":"","sources":["../../src/commands/status.ts"],"names":[],"mappings":"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"}

package/dist/commands/upgrade.d.ts

@@ -0,0 +1,67 @@
+/**
+ * `olam upgrade` — self-upgrade the local Olam dev stack.
+ *
+ * Runs the full manual sequence in one command:
+ *   git fetch + git pull --ff-only
+ *   npm install
+ *   npm run build
+ *   vite build (SPA)
+ *   bash build-host-cp.sh (image)
+ *   docker compose up -d --force-recreate
+ *   wait for /health
+ */
+import type { Command } from 'commander';
+export interface UpgradeOpts {
+    readonly yes: boolean;
+    readonly skipImage: boolean;
+    readonly skipInstall: boolean;
+    readonly branch: string | null;
+}
+/**
+ * Check whether node_modules is in sync with package-lock.json.
+ *
+ * npm writes node_modules/.package-lock.json after every successful install.
+ * If its mtime is >= package-lock.json's mtime, the last install ran after
+ * the last lockfile change — node_modules is current.
+ *
+ * Returns true  → skip install (node_modules reflects the current lockfile).
+ * Returns false → run install (lockfile changed or marker absent).
+ */
+export declare function isNodeModulesInSync(cwd: string): boolean;
+/**
+ * Decide whether the npm install step should be skipped.
+ *
+ * Priority:
+ *   1. --skip-install flag → always skip
+ *   2. node_modules in sync with lockfile → skip (log reason)
+ *   3. otherwise → run install
+ */
+export declare function shouldSkipInstall(opts: {
+    skipInstall: boolean;
+}, cwd: string): {
+    skip: true;
+    reason: string;
+} | {
+    skip: false;
+};
+/** Check cwd looks like the olam repo root. */
+export declare function validateRepoRoot(cwd: string): {
+    ok: true;
+} | {
+    ok: false;
+    error: string;
+};
+/** Normalise raw Commander option object into typed opts. */
+export declare function parseUpgradeOpts(raw: {
+    yes?: boolean;
+    skipImage?: boolean;
+    skipInstall?: boolean;
+    branch?: string;
+}): UpgradeOpts;
+/**
+ * Extract the JS bundle hash from index.html.
+ * Looks for the canonical Vite output pattern: `/assets/index-<hash>.js`.
+ */
+export declare function extractBundleHash(indexHtml: string): string | null;
+export declare function registerUpgrade(program: Command): void;
+//# sourceMappingURL=upgrade.d.ts.map

package/dist/commands/upgrade.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"upgrade.d.ts","sourceRoot":"","sources":["../../src/commands/upgrade.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAUzC,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CAChC;AAED;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAaxD;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE;IAAE,WAAW,EAAE,OAAO,CAAA;CAAE,EAC9B,GAAG,EAAE,MAAM,GACV;IAAE,IAAI,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,KAAK,CAAA;CAAE,CAQlD;AAED,+CAA+C;AAC/C,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG;IAAE,EAAE,EAAE,IAAI,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAWzF;AAED,6DAA6D;AAC7D,wBAAgB,gBAAgB,CAAC,GAAG,EAAE;IACpC,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,GAAG,WAAW,CAOd;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAGlE;AAmUD,wBAAgB,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAetD"}