oh-my-codex 0.14.4 → 0.15.1

package/dist/sidecar/index.js

@@ -0,0 +1,165 @@
+import { collectSidecarSnapshot } from './collector.js';
+import { renderSidecar } from './render.js';
+import { launchSidecarTmuxPane } from './tmux.js';
+export const SIDECAR_USAGE = [
+    'Usage:',
+    '  omx sidecar <team-name>              Render sidecar once',
+    '  omx sidecar <team-name> --json       Output normalized sidecar snapshot',
+    '  omx sidecar <team-name> --watch      Refresh sidecar in the current terminal',
+    '  omx sidecar <team-name> --tmux       Open a right-side tmux pane running watch mode',
+    'Options:',
+    '  --width <cols> / --width=<cols>      Sidecar width (default 48, minimum 30)',
+    '  --interval-ms <ms>                   Watch refresh interval (default 1000)',
+].join('\n');
+function parsePositiveInt(value, fallback) {
+    const parsed = Number.parseInt(value || '', 10);
+    return Number.isFinite(parsed) && parsed > 0 ? parsed : fallback;
+}
+export function parseSidecarArgs(args) {
+    const flags = { json: false, watch: false, tmux: false };
+    const rest = [];
+    for (let index = 0; index < args.length; index += 1) {
+        const arg = args[index];
+        if (arg === '--json')
+            flags.json = true;
+        else if (arg === '--watch' || arg === '-w')
+            flags.watch = true;
+        else if (arg === '--tmux')
+            flags.tmux = true;
+        else if (arg === '--width') {
+            flags.width = parsePositiveInt(args[index + 1], 48);
+            index += 1;
+        }
+        else if (arg.startsWith('--width=')) {
+            flags.width = parsePositiveInt(arg.slice('--width='.length), 48);
+        }
+        else if (arg === '--interval-ms') {
+            flags.intervalMs = parsePositiveInt(args[index + 1], 1000);
+            index += 1;
+        }
+        else if (arg.startsWith('--interval-ms=')) {
+            flags.intervalMs = parsePositiveInt(arg.slice('--interval-ms='.length), 1000);
+        }
+        else {
+            rest.push(arg);
+        }
+    }
+    return { teamName: rest[0] || '', flags };
+}
+function defaultSleep(ms, signal) {
+    return new Promise((resolve) => {
+        if (signal?.aborted) {
+            resolve();
+            return;
+        }
+        const timer = setTimeout(resolve, ms);
+        signal?.addEventListener('abort', () => {
+            clearTimeout(timer);
+            resolve();
+        }, { once: true });
+    });
+}
+export async function runSidecarWatch(teamName, flags, options = {}, deps = {}) {
+    const dependencies = {
+        collect: deps.collect ?? collectSidecarSnapshot,
+        render: deps.render ?? renderSidecar,
+        writeStdout: deps.writeStdout ?? ((text) => process.stdout.write(text)),
+        writeStderr: deps.writeStderr ?? ((text) => process.stderr.write(text)),
+        sleep: deps.sleep ?? defaultSleep,
+        registerSigint: deps.registerSigint ?? ((handler) => process.on('SIGINT', handler)),
+        stdoutColumns: deps.stdoutColumns ?? (() => process.stdout.columns),
+        stdoutRows: deps.stdoutRows ?? (() => process.stdout.rows),
+    };
+    const intervalMs = Math.max(100, flags.intervalMs ?? 1000);
+    const abortController = new AbortController();
+    let firstRender = true;
+    let inFlight = false;
+    let queued = false;
+    let stopped = false;
+    const stop = () => {
+        if (stopped)
+            return;
+        stopped = true;
+        abortController.abort();
+        dependencies.writeStdout('\x1b[?25h');
+    };
+    dependencies.registerSigint(stop);
+    dependencies.writeStdout('\x1b[?25l');
+    const renderTick = async () => {
+        if (stopped)
+            return;
+        if (inFlight) {
+            queued = true;
+            return;
+        }
+        inFlight = true;
+        try {
+            const snapshot = await dependencies.collect(teamName, options);
+            const output = snapshot
+                ? dependencies.render(snapshot, { width: flags.width ?? dependencies.stdoutColumns?.(), height: dependencies.stdoutRows?.() })
+                : `No team state found for ${teamName}`;
+            dependencies.writeStdout(firstRender ? '\x1b[2J\x1b[H' : '\x1b[H');
+            firstRender = false;
+            dependencies.writeStdout(`${output}\x1b[J`);
+        }
+        catch (error) {
+            dependencies.writeStderr(`Sidecar watch render failed: ${error instanceof Error ? error.message : String(error)}\n`);
+            stop();
+        }
+        finally {
+            inFlight = false;
+        }
+        if (queued) {
+            queued = false;
+            await renderTick();
+        }
+    };
+    while (!stopped && !abortController.signal.aborted) {
+        const started = Date.now();
+        await renderTick();
+        if (stopped || abortController.signal.aborted)
+            break;
+        await dependencies.sleep(Math.max(0, intervalMs - (Date.now() - started)), abortController.signal);
+    }
+    dependencies.writeStdout('\x1b[?25h');
+}
+export async function sidecarCommand(args) {
+    if (args[0] === '--help' || args[0] === '-h' || args.length === 0) {
+        console.log(SIDECAR_USAGE);
+        return;
+    }
+    const { teamName, flags } = parseSidecarArgs(args);
+    if (!teamName)
+        throw new Error(SIDECAR_USAGE);
+    const cwd = process.cwd();
+    if (flags.tmux) {
+        if (!process.env.TMUX) {
+            console.error('Not inside a tmux session. Start tmux first, then run: omx sidecar <team-name> --tmux');
+            process.exitCode = 1;
+            return;
+        }
+        const paneId = launchSidecarTmuxPane({ cwd, teamName, width: flags.width, sessionId: process.env.OMX_SESSION_ID });
+        if (!paneId) {
+            console.error('Failed to create sidecar tmux pane. Ensure tmux is available.');
+            process.exitCode = 1;
+            return;
+        }
+        console.log(`Sidecar launched in right tmux pane ${paneId}.`);
+        return;
+    }
+    if (flags.watch) {
+        await runSidecarWatch(teamName, flags, { cwd });
+        return;
+    }
+    const snapshot = await collectSidecarSnapshot(teamName, { cwd });
+    if (flags.json) {
+        console.log(JSON.stringify(snapshot ?? { status: 'missing', team_name: teamName }, null, 2));
+        return;
+    }
+    if (!snapshot) {
+        console.log(`No team state found for ${teamName}`);
+        return;
+    }
+    console.log(renderSidecar(snapshot, { width: flags.width ?? process.stdout.columns }));
+}
+//# sourceMappingURL=index.js.map

package/dist/sidecar/index.js.map

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

package/dist/sidecar/render.d.ts

@@ -0,0 +1,3 @@
+import type { RenderSidecarOptions, SidecarSnapshot } from './types.js';
+export declare function renderSidecar(snapshot: SidecarSnapshot, options?: RenderSidecarOptions): string;
+//# sourceMappingURL=render.d.ts.map

package/dist/sidecar/render.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../../src/sidecar/render.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,oBAAoB,EAAoB,eAAe,EAAsC,MAAM,YAAY,CAAC;AAwD9H,wBAAgB,aAAa,CAAC,QAAQ,EAAE,eAAe,EAAE,OAAO,GAAE,oBAAyB,GAAG,MAAM,CAsBnG"}

package/dist/sidecar/render.js

@@ -0,0 +1,72 @@
+import { bold, cyan, dim, green, isColorEnabled, setColorEnabled, yellow } from '../hud/colors.js';
+const CONTROL_CHARS_RE = /[\u0000-\u001f\u007f-\u009f]/g;
+const OSC_RE = /\x1b\][\s\S]*?(?:\u0007|\x1b\\)/g;
+const ANSI_RE = /\x1b\[[0-?]*[ -/]*[@-~]/g;
+function clean(value) {
+    return (value ?? '').replace(OSC_RE, '').replace(ANSI_RE, '').replace(CONTROL_CHARS_RE, '').trim();
+}
+function visibleLength(value) {
+    return clean(value).length;
+}
+function truncate(value, width) {
+    const sanitized = clean(value);
+    if (width <= 0)
+        return '';
+    if (sanitized.length <= width)
+        return sanitized;
+    if (width <= 1)
+        return '…';
+    return `${sanitized.slice(0, Math.max(0, width - 1))}…`;
+}
+function panel(title, lines, width) {
+    const safeWidth = Math.max(24, width);
+    const rule = '─'.repeat(Math.max(1, safeWidth - visibleLength(title) - 4));
+    return [bold(`╭ ${title} ${rule}`), ...lines.map((line) => `│ ${truncate(line, safeWidth - 2)}`)];
+}
+function taskLabel(task) {
+    const owner = task.owner ? ` @${task.owner}` : '';
+    return `task-${task.id} [${task.status}]${owner} ${task.subject}`;
+}
+function workerLabel(worker) {
+    const alive = worker.alive === false ? 'dead' : worker.alive === true ? 'alive' : 'unknown';
+    const task = worker.current_task ? ` task-${worker.current_task.id}` : '';
+    const pane = worker.pane_id ? ` ${worker.pane_id}` : '';
+    const turns = typeof worker.turns_without_progress === 'number' ? ` Δturns=${worker.turns_without_progress}` : '';
+    return `${worker.name} [${worker.status.state}/${alive}] ${worker.role}${task}${pane}${turns}`;
+}
+function highlightLabel(highlight) {
+    const prefix = highlight.severity === 'critical' ? '!!' : highlight.severity === 'warning' ? '!' : '·';
+    return `${prefix} ${highlight.target}: ${highlight.message}`;
+}
+function withColorSetting(enabled, fn) {
+    const previous = isColorEnabled();
+    setColorEnabled(enabled);
+    try {
+        return fn();
+    }
+    finally {
+        setColorEnabled(previous);
+    }
+}
+export function renderSidecar(snapshot, options = {}) {
+    const width = Math.max(32, Math.floor(options.width ?? 72));
+    const maxLines = Math.max(0, Math.floor(options.height ?? 0));
+    return withColorSetting(options.color !== false, () => {
+        const lines = [];
+        lines.push(cyan(bold(`OMX Sidecar · ${clean(snapshot.team_name)}`)));
+        lines.push(dim(`phase=${clean(snapshot.phase ?? 'unknown')} generated=${clean(snapshot.generated_at)}`));
+        lines.push('');
+        lines.push(...panel('Topology', [snapshot.topology.summary, ...snapshot.topology.edges.map((edge) => `${edge.from} ──${edge.label ? ` ${edge.label} ` : ' '}→ ${edge.to}`)], width));
+        lines.push(...panel('Agents', snapshot.workers.length > 0 ? snapshot.workers.map(workerLabel) : ['no workers found'], width));
+        lines.push(...panel('Tasks', snapshot.tasks.length > 0 ? snapshot.tasks.map(taskLabel) : ['no tasks found'], width));
+        lines.push(...panel('Highlights', snapshot.highlights.length > 0 ? snapshot.highlights.map(highlightLabel) : [green('no blockers detected')], width));
+        lines.push(...panel('Panes', snapshot.panes.length > 0 ? snapshot.panes.map((pane) => `${pane.target} [${pane.role}] ${pane.pane_id}`) : ['no pane mapping available'], width));
+        lines.push(...panel('Events', snapshot.events.length > 0 ? snapshot.events.map((event) => `${event.created_at} ${event.type} ${event.worker}${event.task_id ? ` task-${event.task_id}` : ''}${event.reason ? ` · ${event.reason}` : ''}`) : ['no recent events'], width));
+        if (snapshot.source_warnings.length > 0) {
+            lines.push(...panel('Warnings', snapshot.source_warnings.map((warning) => yellow(warning)), width));
+        }
+        const rendered = maxLines > 0 && lines.length > maxLines ? [...lines.slice(0, Math.max(0, maxLines - 1)), dim(`… ${lines.length - maxLines + 1} more lines`)] : lines;
+        return rendered.join('\n');
+    });
+}
+//# sourceMappingURL=render.js.map

package/dist/sidecar/render.js.map

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

package/dist/sidecar/tmux.d.ts

@@ -0,0 +1,13 @@
+export interface SidecarTmuxOptions {
+    cwd: string;
+    teamName: string;
+    width?: number;
+    sessionId?: string;
+    omxBin?: string;
+}
+type TmuxExecSync = (args: string[]) => string;
+export declare function buildSidecarWatchCommand(options: SidecarTmuxOptions): string;
+export declare function buildSidecarTmuxSplitArgs(options: SidecarTmuxOptions): string[];
+export declare function launchSidecarTmuxPane(options: SidecarTmuxOptions, execTmuxSync?: TmuxExecSync): string | null;
+export {};
+//# sourceMappingURL=tmux.d.ts.map

package/dist/sidecar/tmux.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tmux.d.ts","sourceRoot":"","sources":["../../src/sidecar/tmux.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,kBAAkB;IACjC,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,KAAK,YAAY,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,MAAM,CAAC;AAM/C,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,kBAAkB,GAAG,MAAM,CAK5E;AAED,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,kBAAkB,GAAG,MAAM,EAAE,CAc/E;AASD,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,kBAAkB,EAC3B,YAAY,GAAE,YAAkC,GAC/C,MAAM,GAAG,IAAI,CAMf"}

package/dist/sidecar/tmux.js

@@ -0,0 +1,44 @@
+import { execFileSync } from 'node:child_process';
+import { parsePaneIdFromTmuxOutput, shellEscapeSingle } from '../hud/tmux.js';
+import { resolveTmuxBinaryForPlatform } from '../utils/platform-command.js';
+import { resolveOmxCliEntryPath } from '../utils/paths.js';
+function sidecarWidth(width) {
+    return Number.isFinite(width) && (width ?? 0) >= 30 ? Math.floor(width ?? 48) : 48;
+}
+export function buildSidecarWatchCommand(options) {
+    const omxBin = options.omxBin ?? resolveOmxCliEntryPath();
+    if (!omxBin)
+        throw new Error('Failed to resolve OMX launcher path for sidecar startup.');
+    const prefix = options.sessionId ? `OMX_SESSION_ID=${shellEscapeSingle(options.sessionId)} ` : '';
+    return `${prefix}node ${shellEscapeSingle(omxBin)} sidecar ${shellEscapeSingle(options.teamName)} --watch --width ${sidecarWidth(options.width)}`;
+}
+export function buildSidecarTmuxSplitArgs(options) {
+    return [
+        'split-window',
+        '-h',
+        '-d',
+        '-l',
+        String(sidecarWidth(options.width)),
+        '-c',
+        options.cwd,
+        '-P',
+        '-F',
+        '#{pane_id}',
+        buildSidecarWatchCommand(options),
+    ];
+}
+function defaultExecTmuxSync(args) {
+    return execFileSync(resolveTmuxBinaryForPlatform() || 'tmux', args, {
+        encoding: 'utf-8',
+        ...(process.platform === 'win32' ? { windowsHide: true } : {}),
+    });
+}
+export function launchSidecarTmuxPane(options, execTmuxSync = defaultExecTmuxSync) {
+    try {
+        return parsePaneIdFromTmuxOutput(execTmuxSync(buildSidecarTmuxSplitArgs(options)));
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=tmux.js.map

package/dist/sidecar/tmux.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tmux.js","sourceRoot":"","sources":["../../src/sidecar/tmux.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,yBAAyB,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAC9E,OAAO,EAAE,4BAA4B,EAAE,MAAM,8BAA8B,CAAC;AAC5E,OAAO,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAY3D,SAAS,YAAY,CAAC,KAAyB;IAC7C,OAAO,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;AACrF,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,OAA2B;IAClE,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,sBAAsB,EAAE,CAAC;IAC1D,IAAI,CAAC,MAAM;QAAE,MAAM,IAAI,KAAK,CAAC,0DAA0D,CAAC,CAAC;IACzF,MAAM,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,kBAAkB,iBAAiB,CAAC,OAAO,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IAClG,OAAO,GAAG,MAAM,QAAQ,iBAAiB,CAAC,MAAM,CAAC,YAAY,iBAAiB,CAAC,OAAO,CAAC,QAAQ,CAAC,oBAAoB,YAAY,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;AACpJ,CAAC;AAED,MAAM,UAAU,yBAAyB,CAAC,OAA2B;IACnE,OAAO;QACL,cAAc;QACd,IAAI;QACJ,IAAI;QACJ,IAAI;QACJ,MAAM,CAAC,YAAY,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QACnC,IAAI;QACJ,OAAO,CAAC,GAAG;QACX,IAAI;QACJ,IAAI;QACJ,YAAY;QACZ,wBAAwB,CAAC,OAAO,CAAC;KAClC,CAAC;AACJ,CAAC;AAED,SAAS,mBAAmB,CAAC,IAAc;IACzC,OAAO,YAAY,CAAC,4BAA4B,EAAE,IAAI,MAAM,EAAE,IAAI,EAAE;QAClE,QAAQ,EAAE,OAAO;QACjB,GAAG,CAAC,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC/D,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,qBAAqB,CACnC,OAA2B,EAC3B,eAA6B,mBAAmB;IAEhD,IAAI,CAAC;QACH,OAAO,yBAAyB,CAAC,YAAY,CAAC,yBAAyB,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IACrF,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/sidecar/types.d.ts

@@ -0,0 +1,125 @@
+import type { TeamEventType, TeamTaskStatus } from '../team/contracts.js';
+export type SidecarWorkerState = 'idle' | 'working' | 'blocked' | 'done' | 'failed' | 'draining' | 'unknown';
+export interface SidecarTeamConfig {
+    name: string;
+    task: string;
+    worker_count: number;
+    tmux_session: string;
+    leader_pane_id: string | null;
+    hud_pane_id: string | null;
+    workers: SidecarWorkerInfo[];
+}
+export interface SidecarWorkerInfo {
+    name: string;
+    index: number;
+    role: string;
+    assigned_tasks: string[];
+    pane_id?: string;
+    worker_cli?: string;
+    working_dir?: string;
+    worktree_path?: string;
+    worktree_branch?: string;
+}
+export interface SidecarWorkerStatus {
+    state: SidecarWorkerState;
+    current_task_id?: string;
+    reason?: string;
+    updated_at?: string;
+}
+export interface SidecarWorkerHeartbeat {
+    pid?: number;
+    last_turn_at?: string;
+    turn_count?: number;
+    alive?: boolean;
+}
+export interface SidecarTask {
+    id: string;
+    subject: string;
+    description: string;
+    status: TeamTaskStatus;
+    owner?: string;
+    role?: string;
+    result?: string;
+    error?: string;
+    blocked_by?: string[];
+    depends_on?: string[];
+    version?: number;
+    claim?: {
+        owner: string;
+        leased_until: string;
+    };
+    created_at?: string;
+    completed_at?: string;
+}
+export interface SidecarWorkerSnapshot extends SidecarWorkerInfo {
+    status: SidecarWorkerStatus;
+    heartbeat: SidecarWorkerHeartbeat | null;
+    alive: boolean | null;
+    current_task: SidecarTask | null;
+    turns_without_progress: number | null;
+}
+export interface SidecarEvent {
+    event_id: string;
+    team: string;
+    type: TeamEventType | string;
+    worker: string;
+    task_id?: string;
+    state?: SidecarWorkerState;
+    prev_state?: SidecarWorkerState;
+    reason?: string;
+    source_type?: string;
+    created_at: string;
+}
+export interface SidecarPaneMapping {
+    target: string;
+    pane_id: string;
+    role: 'leader' | 'hud' | 'worker';
+}
+export interface SidecarHighlight {
+    severity: 'info' | 'warning' | 'critical';
+    target: string;
+    kind: 'blocked-worker' | 'blocked-task' | 'failed-task' | 'dead-worker' | 'non-reporting-worker';
+    message: string;
+}
+export interface SidecarTopology {
+    summary: string;
+    nodes: string[];
+    edges: Array<{
+        from: string;
+        to: string;
+        label?: string;
+    }>;
+}
+export interface SidecarSnapshot {
+    schema_version: 'omx.sidecar/v1';
+    generated_at: string;
+    team_name: string;
+    team_task: string;
+    phase: string | null;
+    topology: SidecarTopology;
+    workers: SidecarWorkerSnapshot[];
+    tasks: SidecarTask[];
+    events: SidecarEvent[];
+    panes: SidecarPaneMapping[];
+    highlights: SidecarHighlight[];
+    source_warnings: string[];
+}
+export interface CollectSidecarSnapshotOptions {
+    cwd?: string;
+    now?: Date;
+    eventLimit?: number;
+    env?: NodeJS.ProcessEnv;
+}
+export interface RenderSidecarOptions {
+    width?: number;
+    height?: number;
+    color?: boolean;
+}
+export interface SidecarFlags {
+    json: boolean;
+    watch: boolean;
+    tmux: boolean;
+    width?: number;
+    intervalMs?: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/sidecar/types.d.ts.map

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

package/dist/sidecar/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/sidecar/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/sidecar/types.ts"],"names":[],"mappings":""}

package/dist/state/__tests__/operations.test.js

@@ -84,7 +84,7 @@ exit 1
     return fakeBin;
 }
 describe('state operations directory initialization', () => {
-    it('creates .omx/state for state operations without setup', async () => {
+    it('keeps state_list_active side-effect-free without setup', async () => {
         const wd = await mkdtemp(join(tmpdir(), 'omx-state-ops-test-'));
         try {
             const stateDir = join(wd, '.omx', 'state');
@@ -94,15 +94,55 @@ describe('state operations directory initialization', () => {
             const response = await executeStateOperation('state_list_active', {
                 workingDirectory: wd,
             });
-            assert.equal(existsSync(stateDir), true);
-            assert.equal(existsSync(tmuxHookConfig), true);
+            assert.equal(existsSync(stateDir), false);
+            assert.equal(existsSync(tmuxHookConfig), false);
             assert.deepEqual(response.payload, { active_modes: [] });
         }
         finally {
             await rm(wd, { recursive: true, force: true });
         }
     });
-    it('bootstraps tmux-hook from the current tmux pane when available', async () => {
+    it('keeps state_get_status side-effect-free when session_id is provided', async () => {
+        const wd = await mkdtemp(join(tmpdir(), 'omx-state-ops-status-readonly-'));
+        try {
+            const stateDir = join(wd, '.omx', 'state');
+            const sessionDir = join(stateDir, 'sessions', 'sess1');
+            const tmuxHookConfig = join(wd, '.omx', 'tmux-hook.json');
+            assert.equal(existsSync(sessionDir), false);
+            assert.equal(existsSync(tmuxHookConfig), false);
+            const response = await executeStateOperation('state_get_status', {
+                workingDirectory: wd,
+                session_id: 'sess1',
+            });
+            assert.equal(existsSync(stateDir), false);
+            assert.equal(existsSync(sessionDir), false);
+            assert.equal(existsSync(tmuxHookConfig), false);
+            assert.deepEqual(response.payload, { statuses: {} });
+        }
+        finally {
+            await rm(wd, { recursive: true, force: true });
+        }
+    });
+    it('keeps missing state_read side-effect-free without setup', async () => {
+        const wd = await mkdtemp(join(tmpdir(), 'omx-state-ops-readonly-missing-'));
+        try {
+            const stateDir = join(wd, '.omx', 'state');
+            const tmuxHookConfig = join(wd, '.omx', 'tmux-hook.json');
+            assert.equal(existsSync(stateDir), false);
+            assert.equal(existsSync(tmuxHookConfig), false);
+            const response = await executeStateOperation('state_read', {
+                workingDirectory: wd,
+                mode: 'deep-interview',
+            });
+            assert.equal(existsSync(stateDir), false);
+            assert.equal(existsSync(tmuxHookConfig), false);
+            assert.deepEqual(response.payload, { exists: false, mode: 'deep-interview' });
+        }
+        finally {
+            await rm(wd, { recursive: true, force: true });
+        }
+    });
+    it('bootstraps tmux-hook from the current tmux pane for mutating state operations', async () => {
         const wd = await mkdtemp(join(tmpdir(), 'omx-state-ops-live-'));
         try {
             const tmuxHookConfig = join(wd, '.omx', 'tmux-hook.json');
@@ -112,10 +152,14 @@ describe('state operations directory initialization', () => {
                 TMUX_PANE: '%777',
                 PATH: `${fakeBin}:${process.env.PATH || ''}`,
             }, async () => {
-                const response = await executeStateOperation('state_list_active', {
+                const response = await executeStateOperation('state_write', {
                     workingDirectory: wd,
+                    mode: 'deep-interview',
+                    active: true,
+                    current_phase: 'deep-interview',
                 });
-                assert.deepEqual(response.payload, { active_modes: [] });
+                assert.equal(response.isError, undefined);
+                assert.equal(response.payload.success, true);
             });
             const tmuxConfig = JSON.parse(await readFile(tmuxHookConfig, 'utf-8'));
             assert.deepEqual(tmuxConfig.target, { type: 'pane', value: '%777' });
@@ -204,22 +248,6 @@ describe('state operations directory initialization', () => {
             await rm(wd, { recursive: true, force: true });
         }
     });
-    it('creates session-scoped state directory when session_id is provided', async () => {
-        const wd = await mkdtemp(join(tmpdir(), 'omx-state-ops-session-'));
-        try {
-            const sessionDir = join(wd, '.omx', 'state', 'sessions', 'sess1');
-            assert.equal(existsSync(sessionDir), false);
-            const response = await executeStateOperation('state_get_status', {
-                workingDirectory: wd,
-                session_id: 'sess1',
-            });
-            assert.equal(existsSync(sessionDir), true);
-            assert.deepEqual(response.payload, { statuses: {} });
-        }
-        finally {
-            await rm(wd, { recursive: true, force: true });
-        }
-    });
     it('serializes concurrent state_write calls per mode file and preserves merged fields', async () => {
         const wd = await mkdtemp(join(tmpdir(), 'omx-state-ops-concurrency-'));
         try {