steroids-api 0.2.7

package/dist/src/runners/hang-detector.js

@@ -0,0 +1,130 @@
+/**
+ * Subprocess hang detection
+ * Monitors log output and kills processes that appear stuck
+ */
+const DEFAULT_HANG_TIMEOUT_MS = 15 * 60 * 1000; // 15 minutes
+/**
+ * Create a hang detector for a subprocess
+ * Monitors output activity and detects when a process appears stuck
+ */
+export function createHangDetector(options = {}) {
+    const { timeoutMs = DEFAULT_HANG_TIMEOUT_MS, onHang, onOutput } = options;
+    let lastOutputTime = new Date();
+    let checkInterval = null;
+    let hasNotifiedHang = false;
+    const recordOutput = () => {
+        lastOutputTime = new Date();
+        hasNotifiedHang = false;
+        if (onOutput) {
+            onOutput();
+        }
+    };
+    const getElapsedSinceOutput = () => {
+        return Date.now() - lastOutputTime.getTime();
+    };
+    const isHung = () => {
+        return getElapsedSinceOutput() > timeoutMs;
+    };
+    const getLastOutputTime = () => {
+        return lastOutputTime;
+    };
+    // Start periodic check
+    checkInterval = setInterval(() => {
+        if (isHung() && !hasNotifiedHang) {
+            hasNotifiedHang = true;
+            if (onHang) {
+                onHang(lastOutputTime, getElapsedSinceOutput());
+            }
+        }
+    }, 60 * 1000); // Check every minute
+    const stop = () => {
+        if (checkInterval) {
+            clearInterval(checkInterval);
+            checkInterval = null;
+        }
+    };
+    return {
+        recordOutput,
+        isHung,
+        getLastOutputTime,
+        getElapsedSinceOutput,
+        stop,
+    };
+}
+/**
+ * Attach hang detection to a child process
+ * Monitors stdout/stderr for output activity
+ */
+export function attachHangDetector(child, options = {}) {
+    const { killOnHang = true, ...detectorOptions } = options;
+    const detector = createHangDetector({
+        ...detectorOptions,
+        onHang: (lastOutput, elapsed) => {
+            const minutes = Math.floor(elapsed / 60000);
+            console.error(`Process appears hung (no output for ${minutes} minutes)`);
+            if (killOnHang && child.pid) {
+                console.error(`Killing hung process (PID: ${child.pid})`);
+                try {
+                    child.kill('SIGTERM');
+                    // Force kill after 10 seconds if still alive
+                    setTimeout(() => {
+                        try {
+                            child.kill('SIGKILL');
+                        }
+                        catch {
+                            // Process already dead
+                        }
+                    }, 10000);
+                }
+                catch {
+                    // Process already dead
+                }
+            }
+            if (detectorOptions.onHang) {
+                detectorOptions.onHang(lastOutput, elapsed);
+            }
+        },
+    });
+    // Monitor stdout
+    if (child.stdout) {
+        child.stdout.on('data', () => {
+            detector.recordOutput();
+        });
+    }
+    // Monitor stderr
+    if (child.stderr) {
+        child.stderr.on('data', () => {
+            detector.recordOutput();
+        });
+    }
+    // Clean up on process exit
+    child.on('exit', () => {
+        detector.stop();
+    });
+    child.on('error', () => {
+        detector.stop();
+    });
+    return detector;
+}
+/**
+ * Get default hang timeout in milliseconds
+ */
+export function getDefaultHangTimeout() {
+    return DEFAULT_HANG_TIMEOUT_MS;
+}
+/**
+ * Format elapsed time for display
+ */
+export function formatElapsed(ms) {
+    const seconds = Math.floor(ms / 1000);
+    const minutes = Math.floor(seconds / 60);
+    const hours = Math.floor(minutes / 60);
+    if (hours > 0) {
+        return `${hours}h ${minutes % 60}m`;
+    }
+    if (minutes > 0) {
+        return `${minutes}m ${seconds % 60}s`;
+    }
+    return `${seconds}s`;
+}
+//# sourceMappingURL=hang-detector.js.map

package/dist/src/runners/hang-detector.js.map

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

package/dist/src/runners/heartbeat.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Heartbeat system for runner liveness detection
+ */
+import type Database from 'better-sqlite3';
+export interface HeartbeatManager {
+    start: () => void;
+    stop: () => void;
+    beat: () => void;
+}
+/**
+ * Update heartbeat timestamp for a runner
+ */
+export declare function updateHeartbeat(db: Database.Database, runnerId: string): void;
+/**
+ * Check if a runner's heartbeat is stale
+ */
+export declare function isHeartbeatStale(db: Database.Database, runnerId: string): boolean;
+/**
+ * Find stale runners (no heartbeat for > 5 minutes)
+ */
+export declare function findStaleRunners(db: Database.Database): Array<{
+    id: string;
+    pid: number | null;
+    heartbeat_at: string;
+}>;
+/**
+ * Create a heartbeat manager for a runner
+ * Automatically updates heartbeat at regular intervals
+ */
+export declare function createHeartbeatManager(db: Database.Database, runnerId: string): HeartbeatManager;
+/**
+ * Get heartbeat interval in milliseconds
+ */
+export declare function getHeartbeatInterval(): number;
+/**
+ * Get stale timeout in milliseconds
+ */
+export declare function getStaleTimeout(): number;
+//# sourceMappingURL=heartbeat.d.ts.map

package/dist/src/runners/heartbeat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"heartbeat.d.ts","sourceRoot":"","sources":["../../../../src/runners/heartbeat.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAK3C,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,IAAI,EAAE,MAAM,IAAI,CAAC;IACjB,IAAI,EAAE,MAAM,IAAI,CAAC;CAClB;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAI7E;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,QAAQ,EAAE,MAAM,GACf,OAAO,CAWT;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,EAAE,EAAE,QAAQ,CAAC,QAAQ,GACpB,KAAK,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,CAAC,CAUjE;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,QAAQ,EAAE,MAAM,GACf,gBAAgB,CAuBlB;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,CAE7C;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,MAAM,CAExC"}

package/dist/src/runners/heartbeat.js

@@ -0,0 +1,71 @@
+/**
+ * Heartbeat system for runner liveness detection
+ */
+const HEARTBEAT_INTERVAL_MS = 30 * 1000; // 30 seconds
+const STALE_TIMEOUT_MS = 5 * 60 * 1000; // 5 minutes
+/**
+ * Update heartbeat timestamp for a runner
+ */
+export function updateHeartbeat(db, runnerId) {
+    db.prepare(`UPDATE runners SET heartbeat_at = datetime('now') WHERE id = ?`).run(runnerId);
+}
+/**
+ * Check if a runner's heartbeat is stale
+ */
+export function isHeartbeatStale(db, runnerId) {
+    // Use SQLite's datetime comparison to avoid JavaScript/SQLite format issues
+    const result = db
+        .prepare(`SELECT 1 FROM runners
+       WHERE id = ? AND heartbeat_at >= datetime('now', '-5 minutes')`)
+        .get(runnerId);
+    // If no row returned, either runner doesn't exist or heartbeat is stale
+    return result === undefined;
+}
+/**
+ * Find stale runners (no heartbeat for > 5 minutes)
+ */
+export function findStaleRunners(db) {
+    // Use SQLite's datetime function to avoid timestamp format mismatches
+    // JavaScript ISO format ("2026-02-08T22:28:49.000Z") differs from
+    // SQLite datetime format ("2026-02-08 22:33:49"), breaking string comparison
+    return db
+        .prepare(`SELECT id, pid, heartbeat_at FROM runners
+       WHERE heartbeat_at < datetime('now', '-5 minutes') AND status != 'idle'`)
+        .all();
+}
+/**
+ * Create a heartbeat manager for a runner
+ * Automatically updates heartbeat at regular intervals
+ */
+export function createHeartbeatManager(db, runnerId) {
+    let intervalId = null;
+    const beat = () => {
+        updateHeartbeat(db, runnerId);
+    };
+    const start = () => {
+        // Update immediately
+        beat();
+        // Then update every 30 seconds
+        intervalId = setInterval(beat, HEARTBEAT_INTERVAL_MS);
+    };
+    const stop = () => {
+        if (intervalId) {
+            clearInterval(intervalId);
+            intervalId = null;
+        }
+    };
+    return { start, stop, beat };
+}
+/**
+ * Get heartbeat interval in milliseconds
+ */
+export function getHeartbeatInterval() {
+    return HEARTBEAT_INTERVAL_MS;
+}
+/**
+ * Get stale timeout in milliseconds
+ */
+export function getStaleTimeout() {
+    return STALE_TIMEOUT_MS;
+}
+//# sourceMappingURL=heartbeat.js.map

package/dist/src/runners/heartbeat.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"heartbeat.js","sourceRoot":"","sources":["../../../../src/runners/heartbeat.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,MAAM,qBAAqB,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,aAAa;AACtD,MAAM,gBAAgB,GAAG,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,YAAY;AAQpD;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,EAAqB,EAAE,QAAgB;IACrE,EAAE,CAAC,OAAO,CACR,gEAAgE,CACjE,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;AAClB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAC9B,EAAqB,EACrB,QAAgB;IAEhB,4EAA4E;IAC5E,MAAM,MAAM,GAAG,EAAE;SACd,OAAO,CACN;sEACgE,CACjE;SACA,GAAG,CAAC,QAAQ,CAA8B,CAAC;IAE9C,wEAAwE;IACxE,OAAO,MAAM,KAAK,SAAS,CAAC;AAC9B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAC9B,EAAqB;IAErB,sEAAsE;IACtE,kEAAkE;IAClE,6EAA6E;IAC7E,OAAO,EAAE;SACN,OAAO,CACN;+EACyE,CAC1E;SACA,GAAG,EAAqE,CAAC;AAC9E,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,sBAAsB,CACpC,EAAqB,EACrB,QAAgB;IAEhB,IAAI,UAAU,GAA0B,IAAI,CAAC;IAE7C,MAAM,IAAI,GAAG,GAAS,EAAE;QACtB,eAAe,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC;IAChC,CAAC,CAAC;IAEF,MAAM,KAAK,GAAG,GAAS,EAAE;QACvB,qBAAqB;QACrB,IAAI,EAAE,CAAC;QAEP,+BAA+B;QAC/B,UAAU,GAAG,WAAW,CAAC,IAAI,EAAE,qBAAqB,CAAC,CAAC;IACxD,CAAC,CAAC;IAEF,MAAM,IAAI,GAAG,GAAS,EAAE;QACtB,IAAI,UAAU,EAAE,CAAC;YACf,aAAa,CAAC,UAAU,CAAC,CAAC;YAC1B,UAAU,GAAG,IAAI,CAAC;QACpB,CAAC;IACH,CAAC,CAAC;IAEF,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;AAC/B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB;IAClC,OAAO,qBAAqB,CAAC;AAC/B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe;IAC7B,OAAO,gBAAgB,CAAC;AAC1B,CAAC"}

package/dist/src/runners/lock.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Singleton lock for runner daemon
+ * Uses directory-based locking with PID file
+ */
+export interface LockResult {
+    acquired: boolean;
+    existingPid?: number;
+    isZombie?: boolean;
+}
+/**
+ * Get the lock directory path
+ */
+export declare function getLockDir(): string;
+/**
+ * Get the PID file path
+ */
+export declare function getPidFilePath(): string;
+/**
+ * Check if a process with given PID is running
+ */
+export declare function isProcessAlive(pid: number): boolean;
+/**
+ * Read the PID from lock file
+ */
+export declare function readLockPid(): number | null;
+/**
+ * Remove the lock directory
+ */
+export declare function removeLock(): void;
+/**
+ * Attempt to acquire the singleton lock
+ * Returns result indicating success or existing lock holder
+ */
+export declare function acquireLock(): LockResult;
+/**
+ * Release the lock (should be called on shutdown)
+ */
+export declare function releaseLock(): void;
+/**
+ * Check lock status without acquiring
+ */
+export declare function checkLockStatus(): {
+    locked: boolean;
+    pid: number | null;
+    isZombie: boolean;
+};
+//# sourceMappingURL=lock.d.ts.map

package/dist/src/runners/lock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lock.d.ts","sourceRoot":"","sources":["../../../../src/runners/lock.ts"],"names":[],"mappings":"AAAA;;;GAGG;AASH,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,OAAO,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;GAEG;AACH,wBAAgB,UAAU,IAAI,MAAM,CAEnC;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAQnD;AAED;;GAEG;AACH,wBAAgB,WAAW,IAAI,MAAM,GAAG,IAAI,CAa3C;AAED;;GAEG;AACH,wBAAgB,UAAU,IAAI,IAAI,CAKjC;AAED;;;GAGG;AACH,wBAAgB,WAAW,IAAI,UAAU,CAiDxC;AAED;;GAEG;AACH,wBAAgB,WAAW,IAAI,IAAI,CAOlC;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI;IACjC,MAAM,EAAE,OAAO,CAAC;IAChB,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,QAAQ,EAAE,OAAO,CAAC;CACnB,CAkBA"}

package/dist/src/runners/lock.js

@@ -0,0 +1,140 @@
+/**
+ * Singleton lock for runner daemon
+ * Uses directory-based locking with PID file
+ */
+import { existsSync, mkdirSync, rmSync, readFileSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { getGlobalSteroidsDir } from './global-db.js';
+const LOCK_DIR = 'runners/lock';
+const PID_FILE = 'pid';
+/**
+ * Get the lock directory path
+ */
+export function getLockDir() {
+    return join(getGlobalSteroidsDir(), LOCK_DIR);
+}
+/**
+ * Get the PID file path
+ */
+export function getPidFilePath() {
+    return join(getLockDir(), PID_FILE);
+}
+/**
+ * Check if a process with given PID is running
+ */
+export function isProcessAlive(pid) {
+    try {
+        // Sending signal 0 checks if process exists without killing it
+        process.kill(pid, 0);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Read the PID from lock file
+ */
+export function readLockPid() {
+    const pidPath = getPidFilePath();
+    if (!existsSync(pidPath)) {
+        return null;
+    }
+    try {
+        const content = readFileSync(pidPath, 'utf-8').trim();
+        const pid = parseInt(content, 10);
+        return isNaN(pid) ? null : pid;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Remove the lock directory
+ */
+export function removeLock() {
+    const lockDir = getLockDir();
+    if (existsSync(lockDir)) {
+        rmSync(lockDir, { recursive: true, force: true });
+    }
+}
+/**
+ * Attempt to acquire the singleton lock
+ * Returns result indicating success or existing lock holder
+ */
+export function acquireLock() {
+    const lockDir = getLockDir();
+    const pidPath = getPidFilePath();
+    // Check if lock exists
+    if (existsSync(lockDir)) {
+        const existingPid = readLockPid();
+        if (existingPid !== null) {
+            if (isProcessAlive(existingPid)) {
+                // Another runner is active
+                return {
+                    acquired: false,
+                    existingPid,
+                    isZombie: false,
+                };
+            }
+            // Zombie lock - process is dead
+            removeLock();
+            // Fall through to acquire
+        }
+        else {
+            // Lock dir exists but no valid PID - clean up
+            removeLock();
+        }
+    }
+    // Create lock directory
+    try {
+        mkdirSync(lockDir, { recursive: true });
+    }
+    catch (err) {
+        // Race condition - another process may have created it
+        if (existsSync(lockDir)) {
+            const existingPid = readLockPid();
+            if (existingPid !== null && isProcessAlive(existingPid)) {
+                return {
+                    acquired: false,
+                    existingPid,
+                    isZombie: false,
+                };
+            }
+        }
+        throw err;
+    }
+    // Write our PID
+    writeFileSync(pidPath, String(process.pid));
+    return { acquired: true };
+}
+/**
+ * Release the lock (should be called on shutdown)
+ */
+export function releaseLock() {
+    const existingPid = readLockPid();
+    // Only release if we own the lock
+    if (existingPid === process.pid) {
+        removeLock();
+    }
+}
+/**
+ * Check lock status without acquiring
+ */
+export function checkLockStatus() {
+    const lockDir = getLockDir();
+    if (!existsSync(lockDir)) {
+        return { locked: false, pid: null, isZombie: false };
+    }
+    const pid = readLockPid();
+    if (pid === null) {
+        return { locked: false, pid: null, isZombie: false };
+    }
+    const alive = isProcessAlive(pid);
+    return {
+        locked: alive,
+        pid,
+        isZombie: !alive,
+    };
+}
+//# sourceMappingURL=lock.js.map

package/dist/src/runners/lock.js.map

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

package/dist/src/runners/orchestrator-loop.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Orchestrator loop - core task processing logic
+ * Used by both the daemon and the loop command
+ */
+export interface LoopOptions {
+    projectPath: string;
+    once?: boolean;
+    sectionId?: string;
+    runnerId?: string;
+    onIteration?: (iteration: number) => void;
+    onTaskStart?: (taskId: string, action: string) => void;
+    onTaskComplete?: (taskId: string) => void;
+    shouldStop?: () => boolean;
+}
+/**
+ * Run the orchestrator loop
+ * Processes tasks until all are complete or shouldStop returns true
+ */
+export declare function runOrchestratorLoop(options: LoopOptions): Promise<void>;
+//# sourceMappingURL=orchestrator-loop.d.ts.map

package/dist/src/runners/orchestrator-loop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestrator-loop.d.ts","sourceRoot":"","sources":["../../../../src/runners/orchestrator-loop.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAwBH,MAAM,WAAW,WAAW;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;IAC1C,WAAW,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IACvD,cAAc,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IAC1C,UAAU,CAAC,EAAE,MAAM,OAAO,CAAC;CAC5B;AAED;;;GAGG;AACH,wBAAsB,mBAAmB,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAmP7E"}