@pleri/olam-cli 0.1.7

package/dist/commands/pr.js

@@ -0,0 +1,148 @@
+/**
+ * olam pr — inspect and decide PR-gate requests opened by in-world hooks.
+ *
+ * Each running world's PreToolUse hook intercepts `gh pr create` and
+ * POSTs a gate to its own control plane. This CLI surface lets the
+ * human fan out across all running worlds, pick a gate, and approve
+ * or block it. Codex adversarial review (future) will plug in beside
+ * this as a second decision source.
+ *
+ *   olam pr list                                list all pending gates
+ *   olam pr show <id>                           full detail (diff, cmd)
+ *   olam pr approve <id> [--reason <r>]         let the PR proceed
+ *   olam pr reject <id> [--reason <r>]          block with a reason
+ */
+import pc from 'picocolors';
+import { WorldRegistry } from '@olam/core/src/world/registry.js';
+import { decideGate, getGate, listGates, } from '@olam/core/src/pr-gate/index.js';
+import { printError, printHeader, printInfo, printSuccess } from '../output.js';
+function runningWorlds() {
+    const registry = new WorldRegistry();
+    try {
+        return registry.list({ status: 'running' });
+    }
+    finally {
+        registry.close();
+    }
+}
+async function fanoutList() {
+    const worlds = runningWorlds();
+    const results = [];
+    await Promise.all(worlds.map(async (world) => {
+        try {
+            const gates = await listGates(world.portOffset);
+            for (const gate of gates)
+                results.push({ world, gate });
+        }
+        catch {
+            // World control plane unreachable — skip, don't fail the whole list
+        }
+    }));
+    results.sort((a, b) => b.gate.openedAt.localeCompare(a.gate.openedAt));
+    return results;
+}
+async function findGate(id) {
+    const worlds = runningWorlds();
+    for (const world of worlds) {
+        try {
+            const gate = await getGate(world.portOffset, id);
+            if (gate)
+                return { world, gate };
+        }
+        catch {
+            // Skip unreachable worlds
+        }
+    }
+    return null;
+}
+function formatStateBadge(state) {
+    if (state === 'approve')
+        return pc.green('approve');
+    if (state === 'block')
+        return pc.red('block');
+    // Phase C C2 (CP3 ADV-C2-HIGH3 fix): explicit branch for the new
+    // 'denied' state so `olam pr list` shows the C2-era reaper-takes-over
+    // gates as gray 'denied' instead of falling through to the default
+    // yellow 'pending' badge — which would have misled operators into
+    // running `olam pr approve <id>` and getting a 409 because
+    // handlePrGateDecide rejects non-pending gates.
+    if (state === 'denied')
+        return pc.gray('denied');
+    return pc.yellow('pending');
+}
+export function registerPr(program) {
+    const pr = program.command('pr').description('Review and decide PR-gate requests from running worlds');
+    pr.command('list')
+        .description('List all PR-gate requests across every running world')
+        .action(async () => {
+        const all = await fanoutList();
+        if (all.length === 0) {
+            console.log(pc.dim('No gates open.'));
+            return;
+        }
+        printHeader(`${all.length} gate(s)`);
+        for (const { world, gate } of all) {
+            const badge = formatStateBadge(gate.state);
+            console.log(`  ${pc.bold(gate.id.slice(0, 8))} ${badge.padEnd(20)} ${pc.dim(world.name)} ${pc.dim(gate.branch)}`);
+            console.log(`    ${pc.dim(gate.command.slice(0, 100))}`);
+        }
+    });
+    pr.command('show')
+        .description('Show full gate detail (diff, command, commits)')
+        .argument('<id>', 'Gate id (prefix match ok)')
+        .action(async (id) => {
+        const found = await findGate(id);
+        if (!found) {
+            printError(`No gate found with id "${id}" in any running world.`);
+            process.exitCode = 1;
+            return;
+        }
+        const { world, gate } = found;
+        printHeader(`Gate ${gate.id}`);
+        printInfo('World', `${world.name} (${world.id})`);
+        printInfo('State', gate.state);
+        printInfo('Branch', gate.branch);
+        printInfo('Base', gate.base);
+        printInfo('Command', gate.command);
+        printInfo('Opened', gate.openedAt);
+        if (gate.decidedAt) {
+            printInfo('Decided', `${gate.decidedAt} by ${gate.decidedBy ?? 'unknown'}`);
+            if (gate.reason)
+                printInfo('Reason', gate.reason);
+        }
+        printHeader('Commits');
+        console.log(gate.commitLog || pc.dim('  (empty)'));
+        printHeader('Diff stat');
+        console.log(gate.diffStat || pc.dim('  (empty)'));
+    });
+    function decideCommand(verb, decision) {
+        pr.command(verb)
+            .description(`${verb[0].toUpperCase()}${verb.slice(1)} a pending gate`)
+            .argument('<id>', 'Gate id')
+            .option('--reason <reason>', 'Short free-text reason')
+            .option('--by <name>', 'Deciding identity (defaults to $USER)', process.env['USER'] ?? 'human')
+            .action(async (id, opts) => {
+            const found = await findGate(id);
+            if (!found) {
+                printError(`No gate found with id "${id}" in any running world.`);
+                process.exitCode = 1;
+                return;
+            }
+            try {
+                const result = await decideGate(found.world.portOffset, found.gate.id, {
+                    decision,
+                    by: opts.by,
+                    ...(opts.reason ? { reason: opts.reason } : {}),
+                });
+                printSuccess(`Gate ${result.id}: ${result.state}`);
+            }
+            catch (err) {
+                printError(err instanceof Error ? err.message : String(err));
+                process.exitCode = 1;
+            }
+        });
+    }
+    decideCommand('approve', 'approve');
+    decideCommand('reject', 'block');
+}
+//# sourceMappingURL=pr.js.map

package/dist/commands/pr.js.map

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

package/dist/commands/ps.d.ts

@@ -0,0 +1,25 @@
+import type { Command } from 'commander';
+interface ProcessRow {
+    pid: string;
+    user: string;
+    cpu: string;
+    mem: string;
+    started: string;
+    state: string;
+    command: string;
+}
+type SortKey = 'cpu' | 'mem' | 'pid';
+/**
+ * Parse docker top stdout into ProcessRow[].
+ * Accepts two formats:
+ *   1. JSON: {"Titles":[...],"Processes":[[...],...]}  (HTTP API / docker daemon)
+ *   2. Tabular text with a header line                 (bare CLI spawnSync path)
+ *
+ * The tabular format uses stime (single-word start time like "10:00" or "Feb11")
+ * to avoid multi-word timestamp parsing issues.
+ */
+export declare function parseDockerTop(stdout: string): ProcessRow[];
+export declare function sortRows(rows: ProcessRow[], key: SortKey): ProcessRow[];
+export declare function registerPs(program: Command): void;
+export {};
+//# sourceMappingURL=ps.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ps.d.ts","sourceRoot":"","sources":["../../src/commands/ps.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAMzC,UAAU,UAAU;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,KAAK,OAAO,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,CAAC;AAKrC;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,EAAE,CAoD3D;AAED,wBAAgB,QAAQ,CAAC,IAAI,EAAE,UAAU,EAAE,EAAE,GAAG,EAAE,OAAO,GAAG,UAAU,EAAE,CAKvE;AA0CD,wBAAgB,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAkEjD"}

package/dist/commands/ps.js

@@ -0,0 +1,164 @@
+import pc from 'picocolors';
+import { spawnSync } from 'node:child_process';
+import { loadContext } from '../context.js';
+import { printError } from '../output.js';
+// Matches valid world IDs — same invariant enforced by enter.ts, destroy.ts, etc.
+const SAFE_IDENT = /^[a-z0-9][a-z0-9-]{0,63}$/;
+/**
+ * Parse docker top stdout into ProcessRow[].
+ * Accepts two formats:
+ *   1. JSON: {"Titles":[...],"Processes":[[...],...]}  (HTTP API / docker daemon)
+ *   2. Tabular text with a header line                 (bare CLI spawnSync path)
+ *
+ * The tabular format uses stime (single-word start time like "10:00" or "Feb11")
+ * to avoid multi-word timestamp parsing issues.
+ */
+export function parseDockerTop(stdout) {
+    const trimmed = stdout.trim();
+    if (!trimmed)
+        return [];
+    let titles;
+    let processes;
+    if (trimmed.startsWith('{')) {
+        try {
+            const parsed = JSON.parse(trimmed);
+            titles = (parsed.Titles ?? []).map((t) => t.toLowerCase().trim());
+            processes = parsed.Processes ?? [];
+        }
+        catch {
+            return [];
+        }
+    }
+    else {
+        const lines = trimmed.split('\n');
+        if (lines.length < 2)
+            return [];
+        titles = (lines[0] ?? '').trim().toLowerCase().split(/\s+/);
+        processes = lines.slice(1).map((l) => l.trim().split(/\s+/));
+    }
+    const idx = (candidates) => {
+        for (const c of candidates) {
+            const i = titles.indexOf(c);
+            if (i !== -1)
+                return i;
+        }
+        return -1;
+    };
+    const pidIdx = idx(['pid']);
+    const userIdx = idx(['user', 'uid']);
+    const cpuIdx = idx(['%cpu', 'cpu', 'pcpu']);
+    const memIdx = idx(['%mem', 'mem', 'pmem']);
+    const startIdx = idx(['stime', 'lstart', 'start_time', 'started', 'start']);
+    const stateIdx = idx(['stat', 'state', 's']);
+    const cmdIdx = idx(['cmd', 'command', 'args']);
+    if (pidIdx === -1 || cmdIdx === -1)
+        return [];
+    return processes.map((parts) => {
+        const cmdFull = parts.slice(cmdIdx).join(' ');
+        return {
+            pid: parts[pidIdx] ?? '',
+            user: userIdx !== -1 ? (parts[userIdx] ?? '') : '',
+            cpu: cpuIdx !== -1 ? (parts[cpuIdx] ?? '0.0') : '0.0',
+            mem: memIdx !== -1 ? (parts[memIdx] ?? '0.0') : '0.0',
+            started: startIdx !== -1 ? (parts[startIdx] ?? '') : '',
+            state: stateIdx !== -1 ? (parts[stateIdx] ?? '') : '',
+            command: cmdFull,
+        };
+    }).filter((r) => r.pid !== '');
+}
+export function sortRows(rows, key) {
+    return [...rows].sort((a, b) => {
+        if (key === 'pid')
+            return parseInt(b.pid, 10) - parseInt(a.pid, 10);
+        return parseFloat(b[key]) - parseFloat(a[key]);
+    });
+}
+function printTable(rows) {
+    const cols = process.stdout.columns ?? 80;
+    const fixedWidth = 5 + 1 + 8 + 1 + 6 + 1 + 6 + 1 + 10 + 1 + 6 + 1;
+    const cmdWidth = Math.max(20, cols - fixedWidth);
+    const header = [
+        pc.bold(pc.dim('PID'.padEnd(5))),
+        pc.bold(pc.dim('USER'.padEnd(8))),
+        pc.bold(pc.dim('%CPU'.padEnd(6))),
+        pc.bold(pc.dim('%MEM'.padEnd(6))),
+        pc.bold(pc.dim('STARTED'.padEnd(10))),
+        pc.bold(pc.dim('STATE'.padEnd(6))),
+        pc.bold(pc.dim('COMMAND')),
+    ].join(' ');
+    console.log(header);
+    for (const row of rows) {
+        const cmd = row.command.length > cmdWidth
+            ? row.command.slice(0, cmdWidth - 1) + '…'
+            : row.command;
+        const stateFn = row.state.startsWith('R')
+            ? pc.green
+            : row.state.startsWith('Z')
+                ? pc.red
+                : pc.dim;
+        console.log([
+            row.pid.padEnd(5),
+            row.user.slice(0, 8).padEnd(8),
+            row.cpu.slice(0, 5).padEnd(6),
+            row.mem.slice(0, 5).padEnd(6),
+            row.started.slice(0, 10).padEnd(10),
+            stateFn(row.state.slice(0, 6).padEnd(6)),
+            cmd,
+        ].join(' '));
+    }
+}
+export function registerPs(program) {
+    program
+        .command('ps')
+        .description('List running processes in a world container')
+        .argument('<world>', 'World ID')
+        .option('--watch', 'Refresh every 5 seconds (Ctrl-C to exit)')
+        .option('--sort <key>', 'Sort column: cpu, mem, pid', 'cpu')
+        .action(async (worldId, opts) => {
+        if (!SAFE_IDENT.test(worldId)) {
+            printError(`Invalid world ID "${worldId}". World IDs must match [a-z0-9][a-z0-9-]{0,63}.`);
+            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;
+        }
+        const sortKey = ['cpu', 'mem', 'pid'].includes(opts.sort)
+            ? opts.sort
+            : 'cpu';
+        const containerName = `olam-${worldId}-devbox`;
+        let watchInterval;
+        function fetchAndPrint() {
+            const result = spawnSync('docker', ['top', containerName, 'pid', 'user', 'pcpu', 'pmem', 'stime', 'stat', 'cmd'], { encoding: 'utf-8', timeout: 3000 });
+            if (result.status !== 0 || result.error) {
+                const msg = result.stderr?.trim() || result.error?.message || 'docker top failed';
+                printError(`ps failed for "${worldId}": ${msg}`);
+                if (watchInterval !== undefined) {
+                    clearInterval(watchInterval);
+                    process.exit(1);
+                }
+                process.exitCode = 1;
+                return;
+            }
+            const rows = sortRows(parseDockerTop(result.stdout ?? ''), sortKey);
+            if (opts.watch)
+                process.stdout.write('\x1b[2J\x1b[H');
+            printTable(rows);
+            if (opts.watch) {
+                process.stdout.write(`\n${pc.dim(`world: ${worldId}  sort: ${sortKey}  refresh: 5s  Ctrl-C to exit`)}\n`);
+            }
+        }
+        fetchAndPrint();
+        if (opts.watch) {
+            watchInterval = setInterval(fetchAndPrint, 5000);
+            process.on('SIGINT', () => {
+                clearInterval(watchInterval);
+                process.exit(0);
+            });
+        }
+    });
+}
+//# sourceMappingURL=ps.js.map

package/dist/commands/ps.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ps.js","sourceRoot":"","sources":["../../src/commands/ps.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,YAAY,CAAC;AAC5B,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAc1C,kFAAkF;AAClF,MAAM,UAAU,GAAG,2BAA2B,CAAC;AAE/C;;;;;;;;GAQG;AACH,MAAM,UAAU,cAAc,CAAC,MAAc;IAC3C,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC;IAC9B,IAAI,CAAC,OAAO;QAAE,OAAO,EAAE,CAAC;IAExB,IAAI,MAAgB,CAAC;IACrB,IAAI,SAAqB,CAAC;IAE1B,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QAC5B,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAkD,CAAC;YACpF,MAAM,GAAG,CAAC,MAAM,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC;YAClE,SAAS,GAAG,MAAM,CAAC,SAAS,IAAI,EAAE,CAAC;QACrC,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,EAAE,CAAC;QACZ,CAAC;IACH,CAAC;SAAM,CAAC;QACN,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAClC,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;YAAE,OAAO,EAAE,CAAC;QAChC,MAAM,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAC5D,SAAS,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;IAC/D,CAAC;IAED,MAAM,GAAG,GAAG,CAAC,UAAoB,EAAE,EAAE;QACnC,KAAK,MAAM,CAAC,IAAI,UAAU,EAAE,CAAC;YAC3B,MAAM,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;YAC5B,IAAI,CAAC,KAAK,CAAC,CAAC;gBAAE,OAAO,CAAC,CAAC;QACzB,CAAC;QACD,OAAO,CAAC,CAAC,CAAC;IACZ,CAAC,CAAC;IAEF,MAAM,MAAM,GAAG,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;IAC5B,MAAM,OAAO,GAAG,GAAG,CAAC,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC;IACrC,MAAM,MAAM,GAAG,GAAG,CAAC,CAAC,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC;IAC5C,MAAM,MAAM,GAAG,GAAG,CAAC,CAAC,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC;IAC5C,MAAM,QAAQ,GAAG,GAAG,CAAC,CAAC,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC,CAAC;IAC5E,MAAM,QAAQ,GAAG,GAAG,CAAC,CAAC,MAAM,EAAE,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC;IAC7C,MAAM,MAAM,GAAG,GAAG,CAAC,CAAC,KAAK,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC;IAE/C,IAAI,MAAM,KAAK,CAAC,CAAC,IAAI,MAAM,KAAK,CAAC,CAAC;QAAE,OAAO,EAAE,CAAC;IAE9C,OAAO,SAAS,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;QAC7B,MAAM,OAAO,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC9C,OAAO;YACL,GAAG,EAAE,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE;YACxB,IAAI,EAAE,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE;YAClD,GAAG,EAAE,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK;YACrD,GAAG,EAAE,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK;YACrD,OAAO,EAAE,QAAQ,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE;YACvD,KAAK,EAAE,QAAQ,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE;YACrD,OAAO,EAAE,OAAO;SACjB,CAAC;IACJ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,KAAK,EAAE,CAAC,CAAC;AACjC,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,IAAkB,EAAE,GAAY;IACvD,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QAC7B,IAAI,GAAG,KAAK,KAAK;YAAE,OAAO,QAAQ,CAAC,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;QACpE,OAAO,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IACjD,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,UAAU,CAAC,IAAkB;IACpC,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,OAAO,IAAI,EAAE,CAAC;IAC1C,MAAM,UAAU,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAClE,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,IAAI,GAAG,UAAU,CAAC,CAAC;IAEjD,MAAM,MAAM,GAAG;QACb,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;QAChC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;QACjC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;QACjC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;QACjC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;QACrC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;QAClC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;KAC3B,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAEZ,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAEpB,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,MAAM,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,MAAM,GAAG,QAAQ;YACvC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,GAAG,CAAC,CAAC,GAAG,GAAG;YAC1C,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC;QAEhB,MAAM,OAAO,GAAG,GAAG,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC;YACvC,CAAC,CAAC,EAAE,CAAC,KAAK;YACV,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC;gBACzB,CAAC,CAAC,EAAE,CAAC,GAAG;gBACR,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC;QAEb,OAAO,CAAC,GAAG,CAAC;YACV,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;YACjB,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;YAC9B,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;YAC7B,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;YAC7B,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC;YACnC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;YACxC,GAAG;SACJ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IACf,CAAC;AACH,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,OAAgB;IACzC,OAAO;SACJ,OAAO,CAAC,IAAI,CAAC;SACb,WAAW,CAAC,6CAA6C,CAAC;SAC1D,QAAQ,CAAC,SAAS,EAAE,UAAU,CAAC;SAC/B,MAAM,CAAC,SAAS,EAAE,0CAA0C,CAAC;SAC7D,MAAM,CAAC,cAAc,EAAE,4BAA4B,EAAE,KAAK,CAAC;SAC3D,MAAM,CAAC,KAAK,EAAE,OAAe,EAAE,IAAuC,EAAE,EAAE;QACzE,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;YAC9B,UAAU,CAAC,qBAAqB,OAAO,kDAAkD,CAAC,CAAC;YAC3F,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;YACrB,OAAO;QACT,CAAC;QAED,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,MAAM,WAAW,EAAE,CAAC;QAC3C,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,UAAU,CAAC,KAAK,EAAE,OAAO,IAAI,gDAAgD,CAAC,CAAC;YAC/E,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;YACrB,OAAO;QACT,CAAC;QAED,MAAM,OAAO,GAAa,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,CAAe,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAe,CAAC;YAC1F,CAAC,CAAE,IAAI,CAAC,IAAgB;YACxB,CAAC,CAAC,KAAK,CAAC;QAEV,MAAM,aAAa,GAAG,QAAQ,OAAO,SAAS,CAAC;QAE/C,IAAI,aAAyD,CAAC;QAE9D,SAAS,aAAa;YACpB,MAAM,MAAM,GAAG,SAAS,CACtB,QAAQ,EACR,CAAC,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAC7E,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CACrC,CAAC;YAEF,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;gBACxC,MAAM,GAAG,GAAG,MAAM,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,MAAM,CAAC,KAAK,EAAE,OAAO,IAAI,mBAAmB,CAAC;gBAClF,UAAU,CAAC,kBAAkB,OAAO,MAAM,GAAG,EAAE,CAAC,CAAC;gBACjD,IAAI,aAAa,KAAK,SAAS,EAAE,CAAC;oBAChC,aAAa,CAAC,aAAa,CAAC,CAAC;oBAC7B,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;gBAClB,CAAC;gBACD,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;gBACrB,OAAO;YACT,CAAC;YAED,MAAM,IAAI,GAAG,QAAQ,CAAC,cAAc,CAAC,MAAM,CAAC,MAAM,IAAI,EAAE,CAAC,EAAE,OAAO,CAAC,CAAC;YAEpE,IAAI,IAAI,CAAC,KAAK;gBAAE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;YACtD,UAAU,CAAC,IAAI,CAAC,CAAC;YACjB,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;gBACf,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC,GAAG,CAAC,UAAU,OAAO,WAAW,OAAO,+BAA+B,CAAC,IAAI,CAAC,CAAC;YAC5G,CAAC;QACH,CAAC;QAED,aAAa,EAAE,CAAC;QAEhB,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACf,aAAa,GAAG,WAAW,CAAC,aAAa,EAAE,IAAI,CAAC,CAAC;YACjD,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE;gBACxB,aAAa,CAAC,aAAa,CAAC,CAAC;gBAC7B,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAClB,CAAC,CAAC,CAAC;QACL,CAAC;IACH,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/commands/refresh-helpers.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Pure helper functions for `olam refresh`.
+ *
+ * Kept in a separate file so unit tests can import them without
+ * pulling in @olam/adapters (which requires a built package).
+ */
+export interface CpSourceEntry {
+    readonly srcPath: string;
+    /** Relative to /opt/olam/control-plane/ inside the container. */
+    readonly destRelPath: string;
+}
+/**
+ * Collect the CP source files to copy — mirrors build-devbox.sh:38-77.
+ *
+ * Includes:
+ *   - standalone/*.mjs  (excluding *.test.mjs)
+ *   - standalone/lib/*.mjs  (excluding *.test.mjs) when lib/ exists
+ */
+export declare function collectCpSourceFiles(standaloneDir: string): CpSourceEntry[];
+/**
+ * Validate server.mjs is present — mirrors build-devbox.sh:62-66.
+ * Throws if missing so the caller gets a clear, actionable error.
+ */
+export declare function validateServerMjsPresent(entries: CpSourceEntry[]): void;
+//# sourceMappingURL=refresh-helpers.d.ts.map

package/dist/commands/refresh-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"refresh-helpers.d.ts","sourceRoot":"","sources":["../../src/commands/refresh-helpers.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,iEAAiE;IACjE,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,aAAa,EAAE,MAAM,GAAG,aAAa,EAAE,CAmC3E;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,aAAa,EAAE,GAAG,IAAI,CAOvE"}

package/dist/commands/refresh-helpers.js

@@ -0,0 +1,56 @@
+/**
+ * Pure helper functions for `olam refresh`.
+ *
+ * Kept in a separate file so unit tests can import them without
+ * pulling in @olam/adapters (which requires a built package).
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+/**
+ * Collect the CP source files to copy — mirrors build-devbox.sh:38-77.
+ *
+ * Includes:
+ *   - standalone/*.mjs  (excluding *.test.mjs)
+ *   - standalone/lib/*.mjs  (excluding *.test.mjs) when lib/ exists
+ */
+export function collectCpSourceFiles(standaloneDir) {
+    if (!fs.existsSync(standaloneDir)) {
+        throw new Error(`CP standalone dir not found: ${standaloneDir}`);
+    }
+    const entries = [];
+    // Top-level *.mjs (except *.test.mjs) — mirrors build-devbox.sh:39-44
+    const topLevel = fs.readdirSync(standaloneDir)
+        .filter(f => {
+        const stat = fs.statSync(path.join(standaloneDir, f));
+        return stat.isFile() && f.endsWith('.mjs') && !f.endsWith('.test.mjs');
+    })
+        .sort();
+    for (const f of topLevel) {
+        entries.push({ srcPath: path.join(standaloneDir, f), destRelPath: f });
+    }
+    // lib/*.mjs (except *.test.mjs) — mirrors build-devbox.sh:53-61
+    const libDir = path.join(standaloneDir, 'lib');
+    if (fs.existsSync(libDir) && fs.statSync(libDir).isDirectory()) {
+        const libFiles = fs.readdirSync(libDir)
+            .filter(f => {
+            const stat = fs.statSync(path.join(libDir, f));
+            return stat.isFile() && f.endsWith('.mjs') && !f.endsWith('.test.mjs');
+        })
+            .sort();
+        for (const f of libFiles) {
+            entries.push({ srcPath: path.join(libDir, f), destRelPath: `lib/${f}` });
+        }
+    }
+    return entries;
+}
+/**
+ * Validate server.mjs is present — mirrors build-devbox.sh:62-66.
+ * Throws if missing so the caller gets a clear, actionable error.
+ */
+export function validateServerMjsPresent(entries) {
+    if (!entries.some(e => e.destRelPath === 'server.mjs')) {
+        throw new Error('server.mjs not found in the source list — standalone/ may not be built. ' +
+            'Use --skip-build to bypass this check.');
+    }
+}
+//# sourceMappingURL=refresh-helpers.js.map

package/dist/commands/refresh-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"refresh-helpers.js","sourceRoot":"","sources":["../../src/commands/refresh-helpers.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAQlC;;;;;;GAMG;AACH,MAAM,UAAU,oBAAoB,CAAC,aAAqB;IACxD,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,aAAa,CAAC,EAAE,CAAC;QAClC,MAAM,IAAI,KAAK,CAAC,gCAAgC,aAAa,EAAE,CAAC,CAAC;IACnE,CAAC;IAED,MAAM,OAAO,GAAoB,EAAE,CAAC;IAEpC,sEAAsE;IACtE,MAAM,QAAQ,GAAG,EAAE,CAAC,WAAW,CAAC,aAAa,CAAC;SAC3C,MAAM,CAAC,CAAC,CAAC,EAAE;QACV,MAAM,IAAI,GAAG,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,CAAC;QACtD,OAAO,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;IACzE,CAAC,CAAC;SACD,IAAI,EAAE,CAAC;IAEV,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;QACzB,OAAO,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,EAAE,CAAC,CAAC;IACzE,CAAC;IAED,gEAAgE;IAChE,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,KAAK,CAAC,CAAC;IAC/C,IAAI,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC;QAC/D,MAAM,QAAQ,GAAG,EAAE,CAAC,WAAW,CAAC,MAAM,CAAC;aACpC,MAAM,CAAC,CAAC,CAAC,EAAE;YACV,MAAM,IAAI,GAAG,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC;YAC/C,OAAO,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;QACzE,CAAC,CAAC;aACD,IAAI,EAAE,CAAC;QAEV,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;YACzB,OAAO,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,EAAE,WAAW,EAAE,OAAO,CAAC,EAAE,EAAE,CAAC,CAAC;QAC3E,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,wBAAwB,CAAC,OAAwB;IAC/D,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,WAAW,KAAK,YAAY,CAAC,EAAE,CAAC;QACvD,MAAM,IAAI,KAAK,CACb,0EAA0E;YAC1E,wCAAwC,CACzC,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/commands/refresh.d.ts

@@ -0,0 +1,23 @@
+/**
+ * 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 type { Command } from 'commander';
+export { collectCpSourceFiles, validateServerMjsPresent, type CpSourceEntry } from './refresh-helpers.js';
+export declare function registerRefresh(program: Command): void;
+//# sourceMappingURL=refresh.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"refresh.d.ts","sourceRoot":"","sources":["../../src/commands/refresh.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAezC,OAAO,EAAE,oBAAoB,EAAE,wBAAwB,EAAE,KAAK,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAqI1G,wBAAgB,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA6HtD"}