@pleri/olam-cli 0.1.7

package/dist/__tests__/keys.test.js

@@ -0,0 +1,145 @@
+/**
+ * Unit tests for keys.ts pure helpers.
+ *
+ * Covers readKeysFile (missing/empty/malformed/valid) and the
+ * env-merge precedence contract (OLAM_LLM_* keys do not overwrite
+ * existing worldEnv entries).
+ */
+import { describe, it, expect, beforeEach, afterEach } from 'vitest';
+import * as fs from 'node:fs';
+import * as os from 'node:os';
+import * as path from 'node:path';
+import { readKeysFile, keysFilePath } from '../commands/keys.js';
+let tmpHome;
+let originalHome;
+beforeEach(() => {
+    tmpHome = fs.mkdtempSync(path.join(os.tmpdir(), 'olam-keys-test-'));
+    originalHome = process.env.OLAM_HOME;
+    process.env.OLAM_HOME = tmpHome;
+});
+afterEach(() => {
+    if (originalHome === undefined)
+        delete process.env.OLAM_HOME;
+    else
+        process.env.OLAM_HOME = originalHome;
+    fs.rmSync(tmpHome, { recursive: true, force: true });
+});
+// ── keysFilePath ──────────────────────────────────────────────────
+describe('keysFilePath', () => {
+    it('returns path under OLAM_HOME', () => {
+        expect(keysFilePath()).toBe(path.join(tmpHome, 'keys.yaml'));
+    });
+    it('honors OLAM_HOME so tests do not stomp on the real ~/.olam', () => {
+        expect(keysFilePath()).not.toContain(os.homedir() + path.sep + '.olam');
+    });
+});
+// ── readKeysFile ──────────────────────────────────────────────────
+describe('readKeysFile', () => {
+    it('returns null when ~/.olam/keys.yaml does not exist', () => {
+        expect(readKeysFile()).toBeNull();
+    });
+    it('returns null for an empty file', () => {
+        fs.mkdirSync(tmpHome, { recursive: true });
+        fs.writeFileSync(keysFilePath(), '');
+        expect(readKeysFile()).toBeNull();
+    });
+    it('returns null for a whitespace-only file', () => {
+        fs.mkdirSync(tmpHome, { recursive: true });
+        fs.writeFileSync(keysFilePath(), '   \n\n');
+        expect(readKeysFile()).toBeNull();
+    });
+    it('returns null for malformed YAML', () => {
+        fs.mkdirSync(tmpHome, { recursive: true });
+        fs.writeFileSync(keysFilePath(), ': bad: yaml: [}');
+        expect(readKeysFile()).toBeNull();
+    });
+    it('returns null when YAML is not an object (array)', () => {
+        fs.mkdirSync(tmpHome, { recursive: true });
+        fs.writeFileSync(keysFilePath(), '- item1\n- item2\n');
+        expect(readKeysFile()).toBeNull();
+    });
+    it('returns null when YAML is a scalar', () => {
+        fs.mkdirSync(tmpHome, { recursive: true });
+        fs.writeFileSync(keysFilePath(), 'just a string\n');
+        expect(readKeysFile()).toBeNull();
+    });
+    it('parses a valid single-key file', () => {
+        fs.mkdirSync(tmpHome, { recursive: true });
+        fs.writeFileSync(keysFilePath(), 'OPENAI: sk-proj-testvalue\n');
+        expect(readKeysFile()).toEqual({ OPENAI: 'sk-proj-testvalue' });
+    });
+    it('parses multiple keys', () => {
+        fs.mkdirSync(tmpHome, { recursive: true });
+        fs.writeFileSync(keysFilePath(), 'OPENAI: sk-proj-aaa\nGEMINI: AIzaBBB\n');
+        expect(readKeysFile()).toEqual({ OPENAI: 'sk-proj-aaa', GEMINI: 'AIzaBBB' });
+    });
+    it('skips non-string values silently', () => {
+        fs.mkdirSync(tmpHome, { recursive: true });
+        fs.writeFileSync(keysFilePath(), 'OPENAI: sk-valid\nnumeric: 12345\n');
+        // numeric is a YAML integer, not a string — should be skipped
+        const result = readKeysFile();
+        expect(result).not.toBeNull();
+        expect(result.OPENAI).toBe('sk-valid');
+        expect('numeric' in result).toBe(false);
+    });
+    it('returns null when all values are non-string', () => {
+        fs.mkdirSync(tmpHome, { recursive: true });
+        fs.writeFileSync(keysFilePath(), 'count: 42\nflag: true\n');
+        expect(readKeysFile()).toBeNull();
+    });
+    it('honors OLAM_HOME so tests do not stomp on the real ~/.olam', () => {
+        fs.mkdirSync(tmpHome, { recursive: true });
+        fs.writeFileSync(keysFilePath(), 'OPENAI: sentinel\n');
+        expect(readKeysFile()).toEqual({ OPENAI: 'sentinel' });
+        expect(keysFilePath()).toBe(path.join(tmpHome, 'keys.yaml'));
+    });
+});
+// ── env-merge precedence helper ───────────────────────────────────
+//
+// The manager.ts injection logic is: only set OLAM_LLM_<KEY> when it
+// is NOT already present in worldEnv. Verify that contract here by
+// simulating the merge logic used in manager.ts.
+function mergeKeysIntoEnv(keys, existing) {
+    const env = { ...existing };
+    for (const [k, v] of Object.entries(keys)) {
+        const envKey = `OLAM_LLM_${k.toUpperCase()}`;
+        if (!(envKey in env)) {
+            env[envKey] = v;
+        }
+    }
+    return env;
+}
+describe('env-merge precedence', () => {
+    it('injects OLAM_LLM_<UPPER_KEY> for each key', () => {
+        const result = mergeKeysIntoEnv({ OPENAI: 'sk-abc', GEMINI: 'AIza-xyz' }, {});
+        expect(result).toEqual({
+            OLAM_LLM_OPENAI: 'sk-abc',
+            OLAM_LLM_GEMINI: 'AIza-xyz',
+        });
+    });
+    it('uppercases the key name regardless of file case', () => {
+        const result = mergeKeysIntoEnv({ openai: 'sk-lower' }, {});
+        expect(result.OLAM_LLM_OPENAI).toBe('sk-lower');
+    });
+    it('does NOT overwrite an existing OLAM_LLM_* entry', () => {
+        const result = mergeKeysIntoEnv({ OPENAI: 'from-file' }, { OLAM_LLM_OPENAI: 'already-set' });
+        expect(result.OLAM_LLM_OPENAI).toBe('already-set');
+    });
+    it('does NOT overwrite OLAM_TASK or other protected env keys', () => {
+        const result = mergeKeysIntoEnv({ TASK: 'injected' }, { OLAM_LLM_TASK: 'protected' });
+        expect(result.OLAM_LLM_TASK).toBe('protected');
+    });
+    it('does not inject anything when keys map is empty', () => {
+        const existing = { OLAM_TASK: 'build feature' };
+        const result = mergeKeysIntoEnv({}, existing);
+        expect(result).toEqual(existing);
+    });
+    it('preserves all existing env entries unchanged', () => {
+        const existing = { OLAM_TASK: 'task', OLAM_R2_BUCKET: 'bucket' };
+        const result = mergeKeysIntoEnv({ OPENAI: 'sk-new' }, existing);
+        expect(result.OLAM_TASK).toBe('task');
+        expect(result.OLAM_R2_BUCKET).toBe('bucket');
+        expect(result.OLAM_LLM_OPENAI).toBe('sk-new');
+    });
+});
+//# sourceMappingURL=keys.test.js.map

package/dist/__tests__/keys.test.js.map

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

package/dist/__tests__/logs.test.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Unit tests for logs.ts pure helpers.
+ *
+ * The colorLine and formatLine functions are exported for testability.
+ * http.get streaming is exercised by manual `olam logs` invocation against
+ * a running world (see B1 Verification in the tracker).
+ */
+export {};
+//# sourceMappingURL=logs.test.d.ts.map

package/dist/__tests__/logs.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logs.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/logs.test.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/dist/__tests__/logs.test.js

@@ -0,0 +1,124 @@
+/**
+ * Unit tests for logs.ts pure helpers.
+ *
+ * The colorLine and formatLine functions are exported for testability.
+ * http.get streaming is exercised by manual `olam logs` invocation against
+ * a running world (see B1 Verification in the tracker).
+ */
+import { describe, it, expect } from 'vitest';
+import { colorLine, formatLine, parseSseEvent } from '../commands/logs.js';
+// picocolors is applied in the tests; we test the string content rather than
+// exact ANSI codes since ANSI output depends on the terminal environment.
+// To make assertions deterministic, we strip ANSI codes via a simple regex.
+const ANSI_RE = /\x1b\[[0-9;]*[A-Za-z]/g;
+function strip(s) {
+    return s.replace(ANSI_RE, '');
+}
+describe('parseSseEvent', () => {
+    it('returns null for non-data lines', () => {
+        expect(parseSseEvent('')).toBeNull();
+        expect(parseSseEvent(': ping')).toBeNull();
+        expect(parseSseEvent('event: heartbeat')).toBeNull();
+        expect(parseSseEvent(': connected')).toBeNull();
+    });
+    it('returns null for malformed JSON', () => {
+        expect(parseSseEvent('data: {bad json')).toBeNull();
+        expect(parseSseEvent('data: not-json')).toBeNull();
+    });
+    it('returns null for unknown event types', () => {
+        expect(parseSseEvent('data: {"type":"unknown","foo":"bar"}')).toBeNull();
+        expect(parseSseEvent('data: {"type":"error","message":"x"}')).toBeNull();
+    });
+    it('parses replay events correctly', () => {
+        const ev = parseSseEvent('data: {"type":"replay","service":"atlas-core","lines":["a","b"]}');
+        expect(ev).not.toBeNull();
+        expect(ev.type).toBe('replay');
+        if (ev !== null && ev.type === 'replay') {
+            expect(ev.service).toBe('atlas-core');
+            expect(ev.lines).toEqual(['a', 'b']);
+        }
+    });
+    it('parses replay events without service field', () => {
+        const ev = parseSseEvent('data: {"type":"replay","lines":["x"]}');
+        expect(ev).not.toBeNull();
+        expect(ev.type).toBe('replay');
+    });
+    it('parses line events correctly', () => {
+        const ev = parseSseEvent('data: {"type":"line","service":"diner-app","line":"server started","ts":1234567}');
+        expect(ev).not.toBeNull();
+        expect(ev.type).toBe('line');
+        if (ev !== null && ev.type === 'line') {
+            expect(ev.service).toBe('diner-app');
+            expect(ev.line).toBe('server started');
+            expect(ev.ts).toBe(1234567);
+        }
+    });
+    it('returns null for replay with non-array lines', () => {
+        expect(parseSseEvent('data: {"type":"replay","lines":"not-array"}')).toBeNull();
+    });
+    it('returns null for line event with non-string line', () => {
+        expect(parseSseEvent('data: {"type":"line","line":42,"ts":0}')).toBeNull();
+    });
+});
+describe('colorLine', () => {
+    it('returns plain text unchanged', () => {
+        expect(strip(colorLine('server started'))).toBe('server started');
+    });
+    it('colors ERROR lines (output contains the text)', () => {
+        const result = colorLine('ERROR: database unreachable');
+        expect(strip(result)).toBe('ERROR: database unreachable');
+        // Colored output should differ from plain (ANSI codes present or same in no-color mode).
+        // We verify the content is preserved, not the specific ANSI code.
+    });
+    it('colors WARN lines', () => {
+        const result = colorLine('WARN: slow query detected');
+        expect(strip(result)).toBe('WARN: slow query detected');
+    });
+    it('dims INFO lines', () => {
+        const result = colorLine('INFO: server listening on port 3000');
+        expect(strip(result)).toBe('INFO: server listening on port 3000');
+    });
+    it('does not false-positive on ERRORS (plural) — word boundary check', () => {
+        // "ERRORS" should still match \bERROR\b in some regex flavors; check it works
+        const result = colorLine('ERRORS found: 3');
+        // "ERRORS" contains "ERROR" — \bERROR\b does NOT match inside "ERRORS"
+        // because \b is a word boundary and S follows R. Actually \bERROR\b will NOT
+        // match in "ERRORS" because after the R comes S, not a non-word char. Good.
+        expect(strip(result)).toBe('ERRORS found: 3');
+    });
+    it('preserves multi-word lines', () => {
+        const line = '2024-01-15T10:00:00Z INFO [atlas-core] Request completed in 42ms';
+        expect(strip(colorLine(line))).toBe(line);
+    });
+});
+describe('formatLine', () => {
+    it('no prefix when showService=false', () => {
+        const result = formatLine('hello world', 'atlas-core', false);
+        expect(strip(result)).toBe('hello world');
+    });
+    it('no prefix when showService=true but service is undefined', () => {
+        const result = formatLine('hello world', undefined, true);
+        expect(strip(result)).toBe('hello world');
+    });
+    it('prepends [service] when showService=true and service provided', () => {
+        const result = formatLine('server started', 'atlas-core', true);
+        expect(strip(result)).toContain('[atlas-core]');
+        expect(strip(result)).toContain('server started');
+        // Service prefix comes first
+        const plain = strip(result);
+        expect(plain.indexOf('[atlas-core]')).toBeLessThan(plain.indexOf('server started'));
+    });
+    it('prepends [service] for multi-service stream with diner-app', () => {
+        const result = formatLine('compiled successfully', 'diner-app', true);
+        const plain = strip(result);
+        expect(plain).toContain('[diner-app]');
+        expect(plain).toContain('compiled successfully');
+    });
+    it('applies color AND prefix together — ERROR line with service', () => {
+        const result = formatLine('ERROR: crash', 'atlas-core', true);
+        const plain = strip(result);
+        expect(plain).toContain('[atlas-core]');
+        expect(plain).toContain('ERROR: crash');
+    });
+});
+//# sourceMappingURL=logs.test.js.map

package/dist/__tests__/logs.test.js.map

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

package/dist/__tests__/ps.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=ps.test.d.ts.map

package/dist/__tests__/ps.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ps.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/ps.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/ps.test.js

@@ -0,0 +1,172 @@
+import { vi, describe, it, expect } from 'vitest';
+import { parseDockerTop, sortRows } from '../commands/ps.js';
+// context.js transitively imports @olam/adapters (not built in devbox);
+// mock it so pure-function tests don't pull in the workspace dep graph.
+vi.mock('../context.js', () => ({ loadContext: vi.fn() }));
+// ── parseDockerTop — JSON format ──────────────────────────────────
+describe('parseDockerTop — JSON format', () => {
+    const jsonFixture = JSON.stringify({
+        Titles: ['PID', 'USER', '%CPU', '%MEM', 'STIME', 'STAT', 'CMD'],
+        Processes: [
+            ['1234', 'root', '45.2', '12.3', '10:00', 'S', '/usr/bin/node', 'server.js'],
+            ['5678', 'olam', '0.5', '1.2', 'Feb11', 'R', '/bin/bash'],
+        ],
+    });
+    it('parses JSON format and returns correct row count', () => {
+        const rows = parseDockerTop(jsonFixture);
+        expect(rows).toHaveLength(2);
+    });
+    it('extracts pid correctly', () => {
+        const rows = parseDockerTop(jsonFixture);
+        expect(rows[0].pid).toBe('1234');
+        expect(rows[1].pid).toBe('5678');
+    });
+    it('extracts user correctly', () => {
+        const rows = parseDockerTop(jsonFixture);
+        expect(rows[0].user).toBe('root');
+        expect(rows[1].user).toBe('olam');
+    });
+    it('extracts cpu correctly', () => {
+        const rows = parseDockerTop(jsonFixture);
+        expect(rows[0].cpu).toBe('45.2');
+    });
+    it('extracts mem correctly', () => {
+        const rows = parseDockerTop(jsonFixture);
+        expect(rows[0].mem).toBe('12.3');
+    });
+    it('extracts started (stime) correctly', () => {
+        const rows = parseDockerTop(jsonFixture);
+        expect(rows[0].started).toBe('10:00');
+        expect(rows[1].started).toBe('Feb11');
+    });
+    it('extracts state correctly', () => {
+        const rows = parseDockerTop(jsonFixture);
+        expect(rows[0].state).toBe('S');
+        expect(rows[1].state).toBe('R');
+    });
+    it('joins all tokens from cmdIdx onward into a single command string', () => {
+        const rows = parseDockerTop(jsonFixture);
+        expect(rows[0].command).toBe('/usr/bin/node server.js');
+        expect(rows[1].command).toBe('/bin/bash');
+    });
+    it('returns [] for empty JSON Processes array', () => {
+        const empty = JSON.stringify({ Titles: ['PID', 'CMD'], Processes: [] });
+        expect(parseDockerTop(empty)).toHaveLength(0);
+    });
+    it('returns [] when JSON is missing Titles/Processes', () => {
+        expect(parseDockerTop(JSON.stringify({}))).toHaveLength(0);
+    });
+    it('returns [] when required pid column is absent', () => {
+        const noPid = JSON.stringify({
+            Titles: ['USER', 'CMD'],
+            Processes: [['root', '/bin/bash']],
+        });
+        expect(parseDockerTop(noPid)).toHaveLength(0);
+    });
+    it('returns [] when required cmd column is absent', () => {
+        const noCmd = JSON.stringify({
+            Titles: ['PID', 'USER'],
+            Processes: [['1', 'root']],
+        });
+        expect(parseDockerTop(noCmd)).toHaveLength(0);
+    });
+    it('filters out rows with empty pid', () => {
+        const fixture = JSON.stringify({
+            Titles: ['PID', 'CMD'],
+            Processes: [
+                ['', '/bin/bash'],
+                ['99', '/bin/sh'],
+            ],
+        });
+        const rows = parseDockerTop(fixture);
+        expect(rows).toHaveLength(1);
+        expect(rows[0].pid).toBe('99');
+    });
+    it('accepts lowercase title variants', () => {
+        const lower = JSON.stringify({
+            Titles: ['pid', 'user', '%cpu', '%mem', 'stime', 'stat', 'cmd'],
+            Processes: [['42', 'root', '1.0', '2.0', '10:00', 'S', 'sleep']],
+        });
+        const rows = parseDockerTop(lower);
+        expect(rows[0].pid).toBe('42');
+        expect(rows[0].command).toBe('sleep');
+    });
+    it('falls back cpu/mem to "0.0" when columns are missing', () => {
+        const noCpu = JSON.stringify({
+            Titles: ['PID', 'CMD'],
+            Processes: [['1', '/bin/sh']],
+        });
+        const rows = parseDockerTop(noCpu);
+        expect(rows[0].cpu).toBe('0.0');
+        expect(rows[0].mem).toBe('0.0');
+    });
+});
+// ── parseDockerTop — tabular format ──────────────────────────────
+describe('parseDockerTop — tabular format', () => {
+    const tabularFixture = [
+        'PID   USER  %CPU  %MEM  STIME  STAT  CMD',
+        '1234  root  45.2  12.3  10:00  S     /usr/bin/node server.js',
+        '5678  olam  0.5   1.2   Feb11  R     /bin/bash',
+    ].join('\n');
+    it('parses tabular format and returns correct row count', () => {
+        expect(parseDockerTop(tabularFixture)).toHaveLength(2);
+    });
+    it('extracts pid from tabular format', () => {
+        expect(parseDockerTop(tabularFixture)[0].pid).toBe('1234');
+    });
+    it('joins multi-word command from tabular format', () => {
+        expect(parseDockerTop(tabularFixture)[0].command).toBe('/usr/bin/node server.js');
+    });
+    it('returns [] for empty string', () => {
+        expect(parseDockerTop('')).toHaveLength(0);
+    });
+    it('returns [] when only a header line (no data rows)', () => {
+        expect(parseDockerTop('PID CMD')).toHaveLength(0);
+    });
+    it('returns [] for malformed JSON-like string', () => {
+        expect(parseDockerTop('{bad json')).toHaveLength(0);
+    });
+});
+// ── sortRows ──────────────────────────────────────────────────────
+describe('sortRows', () => {
+    const rows = [
+        { pid: '100', user: 'root', cpu: '5.0', mem: '10.0', started: 'Feb01', state: 'S', command: 'node' },
+        { pid: '200', user: 'olam', cpu: '80.0', mem: '2.0', started: 'Feb02', state: 'R', command: 'build' },
+        { pid: '50', user: 'nobody', cpu: '1.0', mem: '50.0', started: 'Feb03', state: 'Z', command: 'zombie' },
+    ];
+    it('sorts by cpu descending', () => {
+        const sorted = sortRows(rows, 'cpu');
+        expect(sorted).toHaveLength(3);
+        expect(sorted[0].cpu).toBe('80.0');
+        expect(sorted[1].cpu).toBe('5.0');
+        expect(sorted[2].cpu).toBe('1.0');
+    });
+    it('sorts by mem descending', () => {
+        const sorted = sortRows(rows, 'mem');
+        expect(sorted).toHaveLength(3);
+        expect(sorted[0].mem).toBe('50.0');
+        expect(sorted[1].mem).toBe('10.0');
+        expect(sorted[2].mem).toBe('2.0');
+    });
+    it('sorts by pid descending', () => {
+        const sorted = sortRows(rows, 'pid');
+        expect(sorted).toHaveLength(3);
+        expect(sorted[0].pid).toBe('200');
+        expect(sorted[1].pid).toBe('100');
+        expect(sorted[2].pid).toBe('50');
+    });
+    it('does not mutate the input array', () => {
+        const original = [...rows];
+        sortRows(rows, 'cpu');
+        expect(rows).toEqual(original);
+    });
+    it('handles equal cpu values without throwing', () => {
+        const equal = [
+            { pid: '1', user: 'a', cpu: '5.0', mem: '1.0', started: 'Feb01', state: 'S', command: 'a' },
+            { pid: '2', user: 'b', cpu: '5.0', mem: '2.0', started: 'Feb02', state: 'R', command: 'b' },
+        ];
+        expect(() => sortRows(equal, 'cpu')).not.toThrow();
+        expect(sortRows(equal, 'cpu')).toHaveLength(2);
+    });
+});
+//# sourceMappingURL=ps.test.js.map

package/dist/__tests__/ps.test.js.map

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

package/dist/__tests__/status-app-urls.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=status-app-urls.test.d.ts.map

package/dist/__tests__/status-app-urls.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status-app-urls.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/status-app-urls.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/status-app-urls.test.js

@@ -0,0 +1,125 @@
+import { vi, describe, it, expect, beforeEach, afterEach } from 'vitest';
+import { Command } from 'commander';
+// Mock loadContext before importing the command so vitest can intercept
+vi.mock('../context.js', () => ({ loadContext: vi.fn() }));
+// After mock declaration, import the mocked function and the command registrar
+const { loadContext } = await import('../context.js');
+const { registerStatus } = await import('../commands/status.js');
+const ANSI_RE = /\x1b\[[0-9;]*[A-Za-z]/g;
+function strip(s) {
+    return s.replace(ANSI_RE, '');
+}
+const SAMPLE_URLS = [
+    { repoName: 'atlas-core', internalPort: 3000, hostPort: 13000, url: 'http://localhost:13000' },
+    { repoName: 'diner-app', internalPort: 4000, hostPort: 14000, url: 'http://localhost:14000' },
+];
+function makeWorld(overrides) {
+    return {
+        id: 'test-world-1',
+        name: 'Test World',
+        status: 'running',
+        repos: ['olam'],
+        branch: 'main',
+        portOffset: 0,
+        workspacePath: '/home/olam/workspace/olam',
+        computeProvider: 'docker',
+        totalCostUsd: 0.0042,
+        thoughtCount: 7,
+        createdAt: '2026-05-01T10:00:00.000Z',
+        updatedAt: '2026-05-01T11:00:00.000Z',
+        ...overrides,
+    };
+}
+function makeCtx(world) {
+    return {
+        worldManager: {
+            getWorld: vi.fn().mockReturnValue(world),
+        },
+        costTracker: {
+            getWorldCost: vi.fn().mockReturnValue(0.0042),
+        },
+    };
+}
+describe('olam status — appPortUrls output', () => {
+    let logSpy;
+    beforeEach(() => {
+        logSpy = vi.spyOn(console, 'log').mockImplementation(() => { });
+        vi.mocked(loadContext).mockReset();
+    });
+    afterEach(() => {
+        logSpy.mockRestore();
+        vi.unstubAllEnvs();
+    });
+    async function runStatus(worldId = 'test-world-1', extraArgs = []) {
+        const program = new Command().exitOverride();
+        registerStatus(program);
+        await program.parseAsync(['node', 'cli', 'status', worldId, ...extraArgs]);
+    }
+    it('prints Dashboard and Apps block when appPortUrls is present', async () => {
+        const world = makeWorld({ appPortUrls: SAMPLE_URLS });
+        vi.mocked(loadContext).mockResolvedValue({ ctx: makeCtx(world) });
+        await runStatus();
+        const output = logSpy.mock.calls.map((args) => strip(String(args[0]))).join('\n');
+        expect(output).toContain('http://localhost:19080'); // dashboard
+        expect(output).toContain('atlas-core');
+        expect(output).toContain('http://localhost:13000');
+        expect(output).toContain('diner-app');
+        expect(output).toContain('http://localhost:14000');
+    });
+    it('prints first app URL with "Apps" label, subsequent with empty label', async () => {
+        const world = makeWorld({ appPortUrls: SAMPLE_URLS });
+        vi.mocked(loadContext).mockResolvedValue({ ctx: makeCtx(world) });
+        await runStatus();
+        const lines = logSpy.mock.calls.map((args) => strip(String(args[0])));
+        const appsLine = lines.find((l) => l.includes('Apps') && l.includes('atlas-core'));
+        expect(appsLine).toBeDefined();
+        // Second app URL line uses empty label (14 spaces of padding)
+        const dinerLine = lines.find((l) => l.includes('diner-app') && l.includes('http://localhost:14000'));
+        expect(dinerLine).toBeDefined();
+        expect(dinerLine).not.toMatch(/Apps/);
+    });
+    it('does NOT print Apps block when appPortUrls is absent', async () => {
+        const world = makeWorld(); // no appPortUrls
+        vi.mocked(loadContext).mockResolvedValue({ ctx: makeCtx(world) });
+        await runStatus();
+        const output = logSpy.mock.calls.map((args) => strip(String(args[0]))).join('\n');
+        expect(output).not.toContain('Apps');
+        expect(output).toContain('http://localhost:19080'); // dashboard still present
+    });
+    it('does NOT print Apps block when appPortUrls is empty array', async () => {
+        const world = makeWorld({ appPortUrls: [] });
+        vi.mocked(loadContext).mockResolvedValue({ ctx: makeCtx(world) });
+        await runStatus();
+        const output = logSpy.mock.calls.map((args) => strip(String(args[0]))).join('\n');
+        expect(output).not.toContain('Apps');
+    });
+    it('--json output includes appPortUrls array', async () => {
+        const world = makeWorld({ appPortUrls: SAMPLE_URLS });
+        vi.mocked(loadContext).mockResolvedValue({ ctx: makeCtx(world) });
+        await runStatus('test-world-1', ['--json']);
+        const jsonCall = logSpy.mock.calls.find((args) => String(args[0]).startsWith('{'));
+        expect(jsonCall).toBeDefined();
+        const parsed = JSON.parse(String(jsonCall[0]));
+        expect(parsed.appPortUrls).toEqual(SAMPLE_URLS);
+        expect(parsed.dashboardUrl).toBe('http://localhost:19080');
+    });
+    it('--json output without appPortUrls omits the field', async () => {
+        const world = makeWorld(); // no appPortUrls
+        vi.mocked(loadContext).mockResolvedValue({ ctx: makeCtx(world) });
+        await runStatus('test-world-1', ['--json']);
+        const jsonCall = logSpy.mock.calls.find((args) => String(args[0]).startsWith('{'));
+        expect(jsonCall).toBeDefined();
+        const parsed = JSON.parse(String(jsonCall[0]));
+        expect(parsed.appPortUrls).toBeUndefined();
+        expect(parsed.dashboardUrl).toBe('http://localhost:19080');
+    });
+    it('uses portOffset to compute correct dashboardUrl', async () => {
+        const world = makeWorld({ portOffset: 200, appPortUrls: SAMPLE_URLS });
+        vi.mocked(loadContext).mockResolvedValue({ ctx: makeCtx(world) });
+        await runStatus('test-world-1', ['--json']);
+        const jsonCall = logSpy.mock.calls.find((args) => String(args[0]).startsWith('{'));
+        const parsed = JSON.parse(String(jsonCall[0]));
+        expect(parsed.dashboardUrl).toBe('http://localhost:19280'); // 19080 + 200
+    });
+});
+//# sourceMappingURL=status-app-urls.test.js.map