oh-my-claude-sisyphus 3.2.5 → 3.3.1

package/dist/tools/python-repl/session-lock.js

@@ -0,0 +1,510 @@
+/**
+ * Session Lock - Cross-platform file-based session locking
+ *
+ * Provides single-writer enforcement per session with:
+ * - PID-reuse safety via process start time verification
+ * - Cross-platform support (Linux, macOS)
+ * - Stale lock detection and safe breaking
+ * - Request queuing with timeout
+ */
+import * as fs from 'fs/promises';
+import * as fsSync from 'fs';
+import * as path from 'path';
+import * as os from 'os';
+import * as crypto from 'crypto';
+import { execFile } from 'child_process';
+import { promisify } from 'util';
+import { ensureDirSync } from '../../lib/atomic-write.js';
+import { getSessionLockPath } from './paths.js';
+const execFileAsync = promisify(execFile);
+// =============================================================================
+// CONSTANTS
+// =============================================================================
+const STALE_LOCK_AGE_MS = 60000; // 60 seconds
+const DEFAULT_ACQUIRE_TIMEOUT_MS = 30000; // 30 seconds
+const LOCK_RETRY_INTERVAL_MS = 100; // 100ms between retries
+const REMOTE_LOCK_STALE_AGE_MS = 300000; // 5 minutes for remote locks
+// =============================================================================
+// ERRORS
+// =============================================================================
+export class LockTimeoutError extends Error {
+    lockPath;
+    timeout;
+    lastHolder;
+    constructor(lockPath, timeout, lastHolder) {
+        super(`Failed to acquire lock within ${timeout}ms. ` +
+            (lastHolder
+                ? `Held by PID ${lastHolder.pid} on ${lastHolder.hostname} since ${lastHolder.acquiredAt}`
+                : 'Unknown holder') +
+            `. Lock path: ${lockPath}`);
+        this.lockPath = lockPath;
+        this.timeout = timeout;
+        this.lastHolder = lastHolder;
+        this.name = 'LockTimeoutError';
+    }
+}
+export class LockError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'LockError';
+    }
+}
+// =============================================================================
+// PID VALIDATION
+// =============================================================================
+/**
+ * Validate that a PID is a positive integer.
+ * Defense in depth against command injection via poisoned lock files.
+ */
+function isValidPid(pid) {
+    return typeof pid === 'number' && Number.isInteger(pid) && pid > 0;
+}
+// =============================================================================
+// PROCESS START TIME DETECTION
+// =============================================================================
+/**
+ * Get process start time on Linux via /proc/{pid}/stat field 22.
+ * The stat format is: pid (comm) state ppid... with field 22 being starttime.
+ * Command names can contain spaces/parens, so we parse from the last ')'.
+ *
+ * Returns clock ticks since boot (jiffies), or undefined if unavailable.
+ */
+async function getProcessStartTimeLinux(pid) {
+    try {
+        const stat = await fs.readFile(`/proc/${pid}/stat`, 'utf8');
+        const closeParen = stat.lastIndexOf(')');
+        if (closeParen === -1)
+            return undefined;
+        // Fields after comm: state(1) ppid(2) ... starttime(20) - 0-indexed after split
+        const fieldsAfterComm = stat.substring(closeParen + 2).split(' ');
+        // starttime is field 22 in /proc/pid/stat, which is index 19 after removing pid and comm
+        const startTimeField = fieldsAfterComm[19];
+        if (!startTimeField)
+            return undefined;
+        const startTime = parseInt(startTimeField, 10);
+        return isNaN(startTime) ? undefined : startTime;
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * Get process start time on macOS via `ps -p {pid} -o lstart=`.
+ * Returns Unix timestamp in ms, or undefined if unavailable.
+ */
+async function getProcessStartTimeMacOS(pid) {
+    if (!isValidPid(pid))
+        return undefined;
+    try {
+        const { stdout } = await execFileAsync('ps', ['-p', String(pid), '-o', 'lstart='], {
+            env: { ...process.env, LC_ALL: 'C' },
+        });
+        const lstart = stdout.trim();
+        if (!lstart)
+            return undefined;
+        const date = new Date(lstart);
+        if (isNaN(date.getTime()))
+            return undefined;
+        return date.getTime();
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * Get the start time of the current process.
+ * Used when creating lock files to enable PID reuse detection.
+ */
+export async function getCurrentProcessStartTime() {
+    const pid = process.pid;
+    if (process.platform === 'linux') {
+        return getProcessStartTimeLinux(pid);
+    }
+    else if (process.platform === 'darwin') {
+        return getProcessStartTimeMacOS(pid);
+    }
+    // Unsupported platform - return undefined
+    return undefined;
+}
+// =============================================================================
+// PROCESS LIVENESS DETECTION
+// =============================================================================
+/**
+ * Check if a process is alive with PID-reuse detection via start time comparison.
+ *
+ * @param pid - Process ID to check
+ * @param recordedStartTime - Start time recorded when lock was acquired
+ * @returns true if process is alive AND start time matches (or wasn't recorded)
+ */
+export async function isProcessAlive(pid, recordedStartTime) {
+    if (!isValidPid(pid))
+        return false;
+    if (process.platform === 'linux') {
+        const currentStartTime = await getProcessStartTimeLinux(pid);
+        if (currentStartTime === undefined)
+            return false;
+        // If we have a recorded start time, verify it matches
+        if (recordedStartTime !== undefined && currentStartTime !== recordedStartTime) {
+            return false; // PID reuse detected
+        }
+        return true;
+    }
+    else if (process.platform === 'darwin') {
+        try {
+            // First check if process exists
+            const { stdout } = await execFileAsync('ps', ['-p', String(pid), '-o', 'pid='], {
+                env: { ...process.env, LC_ALL: 'C' },
+            });
+            if (stdout.trim() === '')
+                return false;
+            // If we have a recorded start time, verify it matches
+            if (recordedStartTime !== undefined) {
+                const currentStartTime = await getProcessStartTimeMacOS(pid);
+                // Fail-closed: if we can't get current start time but we have a recorded one,
+                // assume PID reuse has occurred (safer than assuming same process)
+                if (currentStartTime === undefined) {
+                    return false;
+                }
+                if (currentStartTime !== recordedStartTime) {
+                    return false; // PID reuse detected
+                }
+            }
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    // Unknown platform: conservative assumption that process is alive
+    return true;
+}
+// =============================================================================
+// SYMLINK-SAFE FILE OPERATIONS
+// =============================================================================
+/**
+ * Open a file with O_NOFOLLOW to prevent symlink attacks.
+ * Falls back to lstat check on platforms that don't support O_NOFOLLOW.
+ */
+async function openNoFollow(filePath, flags, mode) {
+    // Add O_NOFOLLOW if available (Linux, macOS)
+    const O_NOFOLLOW = fsSync.constants.O_NOFOLLOW ?? 0x20000;
+    const flagsWithNoFollow = flags | O_NOFOLLOW;
+    try {
+        return await fs.open(filePath, flagsWithNoFollow, mode);
+    }
+    catch (err) {
+        // ELOOP means it's a symlink - reject it
+        if (err.code === 'ELOOP') {
+            throw new LockError(`Lock file is a symlink: ${filePath}`);
+        }
+        throw err;
+    }
+}
+/**
+ * Read a file safely, rejecting symlinks.
+ */
+async function readFileNoFollow(filePath) {
+    // First check if it's a symlink via lstat
+    try {
+        const stat = await fs.lstat(filePath);
+        if (stat.isSymbolicLink()) {
+            throw new LockError(`Lock file is a symlink: ${filePath}`);
+        }
+    }
+    catch (err) {
+        if (err.code === 'ENOENT') {
+            throw err; // File doesn't exist - propagate
+        }
+        if (err instanceof LockError) {
+            throw err;
+        }
+        // Other errors - let readFile handle them
+    }
+    return fs.readFile(filePath, 'utf8');
+}
+// =============================================================================
+// LOCK FILE OPERATIONS
+// =============================================================================
+/**
+ * Read and validate a lock file.
+ * Returns null if file doesn't exist, is invalid, or is a symlink.
+ */
+async function readLockFile(lockPath) {
+    try {
+        const content = await readFileNoFollow(lockPath);
+        const lockInfo = JSON.parse(content);
+        // Validate required fields
+        if (!lockInfo.lockId ||
+            !isValidPid(lockInfo.pid) ||
+            !lockInfo.hostname ||
+            !lockInfo.acquiredAt) {
+            return null;
+        }
+        return lockInfo;
+    }
+    catch {
+        // ENOENT = doesn't exist, ELOOP = symlink rejected, or parse error
+        return null;
+    }
+}
+/**
+ * Create a new LockInfo for the current process.
+ */
+async function createLockInfo(lockId) {
+    return {
+        lockId,
+        pid: process.pid,
+        processStartTime: await getCurrentProcessStartTime(),
+        hostname: os.hostname(),
+        acquiredAt: new Date().toISOString(),
+    };
+}
+/**
+ * Check if a lock can be safely broken. A lock is breakable if:
+ * - Age > 60 seconds AND owning process is dead OR start time differs (PID reuse)
+ * - For remote hosts: Only breaks if age > 5 minutes
+ */
+async function canBreakLock(lockInfo) {
+    const age = Date.now() - new Date(lockInfo.acquiredAt).getTime();
+    // Lock is too fresh to break
+    if (age < STALE_LOCK_AGE_MS) {
+        return false;
+    }
+    // For remote hosts, require much longer timeout
+    if (lockInfo.hostname !== os.hostname()) {
+        return age > REMOTE_LOCK_STALE_AGE_MS;
+    }
+    // Check if owning process is still alive with same start time
+    const alive = await isProcessAlive(lockInfo.pid, lockInfo.processStartTime);
+    return !alive;
+}
+// =============================================================================
+// SESSION LOCK CLASS
+// =============================================================================
+/**
+ * SessionLock manages a single lock file for session coordination.
+ *
+ * @example
+ * const lock = new SessionLock('my-session-id');
+ * try {
+ *   await lock.acquire();
+ *   // ... do work ...
+ * } finally {
+ *   await lock.release();
+ * }
+ */
+export class SessionLock {
+    lockPath;
+    lockId;
+    held = false;
+    lockInfo = null;
+    constructor(sessionId) {
+        this.lockPath = getSessionLockPath(sessionId);
+        this.lockId = crypto.randomUUID();
+    }
+    /**
+     * Acquire lock with timeout (default 30s).
+     * Blocks until lock is acquired or timeout is reached.
+     *
+     * @param timeout - Maximum time to wait in milliseconds
+     * @throws LockTimeoutError if lock cannot be acquired within timeout
+     */
+    async acquire(timeout = DEFAULT_ACQUIRE_TIMEOUT_MS) {
+        if (this.held) {
+            throw new LockError('Lock already held by this instance');
+        }
+        const startTime = Date.now();
+        let lastHolder;
+        while (Date.now() - startTime < timeout) {
+            const result = await this.tryAcquire();
+            if (result.acquired) {
+                return;
+            }
+            if (result.holder) {
+                lastHolder = result.holder;
+            }
+            await sleep(LOCK_RETRY_INTERVAL_MS);
+        }
+        throw new LockTimeoutError(this.lockPath, timeout, lastHolder);
+    }
+    /**
+     * Try to acquire lock (non-blocking).
+     * Returns immediately with result indicating success or failure.
+     */
+    async tryAcquire() {
+        try {
+            const existingLock = await readLockFile(this.lockPath);
+            if (existingLock) {
+                // Check if we can break the stale lock
+                if (await canBreakLock(existingLock)) {
+                    try {
+                        await fs.unlink(this.lockPath);
+                    }
+                    catch {
+                        // Lock might have been removed by another process
+                    }
+                    // Fall through to acquire
+                }
+                else {
+                    return {
+                        acquired: false,
+                        reason: 'held_by_other',
+                        holder: existingLock,
+                    };
+                }
+            }
+            // Create new lock info
+            const newLockInfo = await createLockInfo(this.lockId);
+            try {
+                // Ensure directory exists
+                ensureDirSync(path.dirname(this.lockPath));
+                // Atomic exclusive create with O_NOFOLLOW
+                const flags = fsSync.constants.O_WRONLY | fsSync.constants.O_CREAT | fsSync.constants.O_EXCL;
+                const lockFile = await openNoFollow(this.lockPath, flags, 0o644);
+                try {
+                    await lockFile.writeFile(JSON.stringify(newLockInfo, null, 2), { encoding: 'utf8' });
+                    await lockFile.sync();
+                }
+                finally {
+                    await lockFile.close();
+                }
+            }
+            catch (err) {
+                if (err.code === 'EEXIST') {
+                    // Another process created the lock file first
+                    return {
+                        acquired: false,
+                        reason: 'held_by_other',
+                    };
+                }
+                throw err;
+            }
+            // Verify our lock wasn't overwritten (race condition check)
+            const verifyLock = await readLockFile(this.lockPath);
+            if (!verifyLock || verifyLock.lockId !== this.lockId) {
+                return {
+                    acquired: false,
+                    reason: 'error',
+                };
+            }
+            this.held = true;
+            this.lockInfo = newLockInfo;
+            return {
+                acquired: true,
+                reason: existingLock ? 'stale_broken' : 'success',
+            };
+        }
+        catch (err) {
+            return {
+                acquired: false,
+                reason: 'error',
+            };
+        }
+    }
+    /**
+     * Release held lock.
+     * Safe to call multiple times - subsequent calls are no-ops.
+     */
+    async release() {
+        if (!this.held) {
+            return;
+        }
+        try {
+            // Verify we still own the lock before deleting
+            const currentLock = await readLockFile(this.lockPath);
+            if (currentLock && currentLock.lockId === this.lockId) {
+                await fs.unlink(this.lockPath);
+            }
+        }
+        catch {
+            // Ignore errors (lock might already be gone)
+        }
+        finally {
+            this.held = false;
+            this.lockInfo = null;
+        }
+    }
+    /**
+     * Force break a stale lock.
+     * USE WITH CAUTION: This will break the lock regardless of who holds it.
+     * Should only be used for recovery from known stale states.
+     */
+    async forceBreak() {
+        try {
+            await fs.unlink(this.lockPath);
+        }
+        catch (err) {
+            if (err.code !== 'ENOENT') {
+                throw err;
+            }
+        }
+        this.held = false;
+        this.lockInfo = null;
+    }
+    /**
+     * Check if lock is held by us.
+     */
+    isHeld() {
+        return this.held;
+    }
+    /**
+     * Get the lock file path.
+     */
+    getLockPath() {
+        return this.lockPath;
+    }
+    /**
+     * Get current lock info (if held).
+     */
+    getLockInfo() {
+        return this.lockInfo;
+    }
+}
+// =============================================================================
+// UTILITY FUNCTIONS
+// =============================================================================
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+/**
+ * Execute a function while holding a lock, releasing automatically on completion.
+ *
+ * @example
+ * await withLock('session-id', async () => {
+ *   // ... critical section ...
+ * });
+ */
+export async function withLock(sessionId, fn, timeout = DEFAULT_ACQUIRE_TIMEOUT_MS) {
+    const lock = new SessionLock(sessionId);
+    await lock.acquire(timeout);
+    try {
+        return await fn();
+    }
+    finally {
+        await lock.release();
+    }
+}
+/**
+ * Get the current status of a session lock.
+ */
+export async function getLockStatus(sessionId) {
+    const lockPath = getSessionLockPath(sessionId);
+    const lockInfo = await readLockFile(lockPath);
+    if (!lockInfo) {
+        return {
+            locked: false,
+            lockInfo: null,
+            canBreak: false,
+            ownedByUs: false,
+        };
+    }
+    const canBreakResult = await canBreakLock(lockInfo);
+    const ownedByUs = lockInfo.pid === process.pid && lockInfo.hostname === os.hostname();
+    return {
+        locked: true,
+        lockInfo,
+        canBreak: canBreakResult,
+        ownedByUs,
+    };
+}
+//# sourceMappingURL=session-lock.js.map

package/dist/tools/python-repl/session-lock.js.map

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

package/dist/tools/python-repl/socket-client.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Custom error types for socket communication
+ */
+export declare class SocketConnectionError extends Error {
+    readonly socketPath: string;
+    readonly originalError?: Error | undefined;
+    constructor(message: string, socketPath: string, originalError?: Error | undefined);
+}
+export declare class SocketTimeoutError extends Error {
+    readonly timeoutMs: number;
+    constructor(message: string, timeoutMs: number);
+}
+export declare class JsonRpcError extends Error {
+    readonly code: number;
+    readonly data?: unknown | undefined;
+    constructor(message: string, code: number, data?: unknown | undefined);
+}
+/**
+ * Send a JSON-RPC 2.0 request over Unix socket
+ *
+ * @param socketPath - Path to the Unix socket
+ * @param method - JSON-RPC method name
+ * @param params - Optional parameters object
+ * @param timeout - Request timeout in milliseconds (default: 60000ms / 1 min)
+ * @returns Promise resolving to the result typed as T
+ *
+ * @throws {SocketConnectionError} If socket connection fails
+ * @throws {SocketTimeoutError} If request times out
+ * @throws {JsonRpcError} If server returns an error response
+ *
+ * @example
+ * ```typescript
+ * const result = await sendSocketRequest<ExecuteResult>(
+ *   '/tmp/omc/abc123/bridge.sock',
+ *   'execute',
+ *   { code: 'print("hello")' },
+ *   60000
+ * );
+ * ```
+ */
+export declare function sendSocketRequest<T>(socketPath: string, method: string, params?: Record<string, unknown>, timeout?: number): Promise<T>;
+//# sourceMappingURL=socket-client.d.ts.map

package/dist/tools/python-repl/socket-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"socket-client.d.ts","sourceRoot":"","sources":["../../../src/tools/python-repl/socket-client.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,qBAAa,qBAAsB,SAAQ,KAAK;aACD,UAAU,EAAE,MAAM;aAAkB,aAAa,CAAC,EAAE,KAAK;gBAA1F,OAAO,EAAE,MAAM,EAAkB,UAAU,EAAE,MAAM,EAAkB,aAAa,CAAC,EAAE,KAAK,YAAA;CAIvG;AAED,qBAAa,kBAAmB,SAAQ,KAAK;aACE,SAAS,EAAE,MAAM;gBAAlD,OAAO,EAAE,MAAM,EAAkB,SAAS,EAAE,MAAM;CAI/D;AAED,qBAAa,YAAa,SAAQ,KAAK;aAGnB,IAAI,EAAE,MAAM;aACZ,IAAI,CAAC,EAAE,OAAO;gBAF9B,OAAO,EAAE,MAAM,EACC,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,OAAO,YAAA;CAKjC;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAsB,iBAAiB,CAAC,CAAC,EACvC,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,EACd,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,OAAO,GAAE,MAAc,GACtB,OAAO,CAAC,CAAC,CAAC,CA+IZ"}