steroids-cli 0.4.47

package/dist/runners/global-db.js

@@ -0,0 +1,230 @@
+"use strict";
+/**
+ * Global database for runner state
+ * Located at ~/.steroids/steroids.db (user home, not project)
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getGlobalSteroidsDir = getGlobalSteroidsDir;
+exports.getGlobalDbPath = getGlobalDbPath;
+exports.isGlobalDbInitialized = isGlobalDbInitialized;
+exports.openGlobalDatabase = openGlobalDatabase;
+exports.getGlobalSchemaVersion = getGlobalSchemaVersion;
+const better_sqlite3_1 = __importDefault(require("better-sqlite3"));
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const node_os_1 = require("node:os");
+const STEROIDS_DIR = '.steroids';
+const DB_NAME = 'steroids.db';
+/**
+ * Schema for global database (runners and locks)
+ */
+const GLOBAL_SCHEMA_SQL = `
+-- Runners table for tracking runner state
+CREATE TABLE IF NOT EXISTS runners (
+    id TEXT PRIMARY KEY,
+    status TEXT NOT NULL DEFAULT 'idle',
+    pid INTEGER,
+    project_path TEXT,
+    current_task_id TEXT,
+    started_at TEXT,
+    heartbeat_at TEXT NOT NULL DEFAULT (datetime('now'))
+);
+
+-- Runner lock for singleton enforcement
+-- Only one row allowed (id = 1)
+CREATE TABLE IF NOT EXISTS runner_lock (
+    id INTEGER PRIMARY KEY CHECK (id = 1),
+    runner_id TEXT NOT NULL,
+    acquired_at TEXT NOT NULL DEFAULT (datetime('now'))
+);
+
+-- Schema metadata
+CREATE TABLE IF NOT EXISTS _global_schema (
+    key TEXT PRIMARY KEY,
+    value TEXT NOT NULL
+);
+`;
+/**
+ * Schema upgrade from version 1 to version 2: Add projects table
+ */
+const GLOBAL_SCHEMA_V2_SQL = `
+-- Projects table for tracking registered projects
+CREATE TABLE IF NOT EXISTS projects (
+    path TEXT PRIMARY KEY,
+    name TEXT,
+    registered_at TEXT NOT NULL DEFAULT (datetime('now')),
+    last_seen_at TEXT NOT NULL DEFAULT (datetime('now')),
+    enabled INTEGER NOT NULL DEFAULT 1
+);
+`;
+/**
+ * Schema upgrade from version 2 to version 3: Add stats columns to projects table
+ */
+const GLOBAL_SCHEMA_V3_SQL = `
+-- Add task stats columns (for API/WebUI display without accessing project DBs)
+ALTER TABLE projects ADD COLUMN pending_count INTEGER DEFAULT 0;
+ALTER TABLE projects ADD COLUMN in_progress_count INTEGER DEFAULT 0;
+ALTER TABLE projects ADD COLUMN review_count INTEGER DEFAULT 0;
+ALTER TABLE projects ADD COLUMN completed_count INTEGER DEFAULT 0;
+ALTER TABLE projects ADD COLUMN stats_updated_at TEXT;
+`;
+/**
+ * Schema upgrade from version 3 to version 4: Add section_id to runners table
+ */
+const GLOBAL_SCHEMA_V4_SQL = `
+-- Add section_id column to runners for section focus feature
+ALTER TABLE runners ADD COLUMN section_id TEXT;
+`;
+/**
+ * Schema upgrade from version 4 to version 5: Add activity_log table
+ */
+const GLOBAL_SCHEMA_V5_SQL = `
+-- Activity log for tracking task completions across all projects
+CREATE TABLE IF NOT EXISTS activity_log (
+    id INTEGER PRIMARY KEY AUTOINCREMENT,
+    project_path TEXT NOT NULL,
+    runner_id TEXT NOT NULL,
+    task_id TEXT NOT NULL,
+    task_title TEXT NOT NULL,
+    section_name TEXT,
+    final_status TEXT NOT NULL,
+    created_at TEXT NOT NULL DEFAULT (datetime('now'))
+);
+CREATE INDEX IF NOT EXISTS idx_activity_log_created_at ON activity_log(created_at);
+CREATE INDEX IF NOT EXISTS idx_activity_log_project ON activity_log(project_path);
+`;
+/**
+ * Schema upgrade from version 5 to version 6: Add commit_message to activity_log
+ */
+const GLOBAL_SCHEMA_V6_SQL = `
+-- Add commit_message column to activity_log for storing coder's final message
+ALTER TABLE activity_log ADD COLUMN commit_message TEXT;
+`;
+/**
+ * Schema upgrade from version 6 to version 7: Add commit_sha to activity_log
+ */
+const GLOBAL_SCHEMA_V7_SQL = `
+-- Add commit_sha column to activity_log for GitHub links
+ALTER TABLE activity_log ADD COLUMN commit_sha TEXT;
+`;
+const GLOBAL_SCHEMA_VERSION = '7';
+/**
+ * Get the path to the global steroids directory
+ */
+function getGlobalSteroidsDir() {
+    return (0, node_path_1.join)((0, node_os_1.homedir)(), STEROIDS_DIR);
+}
+/**
+ * Get the path to the global database
+ */
+function getGlobalDbPath() {
+    return (0, node_path_1.join)(getGlobalSteroidsDir(), DB_NAME);
+}
+/**
+ * Check if global database exists
+ */
+function isGlobalDbInitialized() {
+    return (0, node_fs_1.existsSync)(getGlobalDbPath());
+}
+/**
+ * Initialize and open the global database
+ * Creates it if it doesn't exist
+ */
+function openGlobalDatabase() {
+    const dbPath = getGlobalDbPath();
+    const steroidsDir = getGlobalSteroidsDir();
+    // Create ~/.steroids directory if it doesn't exist
+    if (!(0, node_fs_1.existsSync)(steroidsDir)) {
+        (0, node_fs_1.mkdirSync)(steroidsDir, { recursive: true });
+    }
+    const db = new better_sqlite3_1.default(dbPath);
+    // Configure SQLite for optimal performance and safety
+    db.pragma('journal_mode = WAL');
+    db.pragma('busy_timeout = 5000');
+    // Create base schema (IF NOT EXISTS makes this idempotent)
+    db.exec(GLOBAL_SCHEMA_SQL);
+    // Get current version
+    const versionRow = db
+        .prepare('SELECT value FROM _global_schema WHERE key = ?')
+        .get('version');
+    const currentVersion = versionRow?.value;
+    if (!currentVersion) {
+        // Fresh database - apply all schemas and set to latest version
+        db.exec(GLOBAL_SCHEMA_V2_SQL);
+        db.exec(GLOBAL_SCHEMA_V3_SQL);
+        db.exec(GLOBAL_SCHEMA_V4_SQL);
+        db.exec(GLOBAL_SCHEMA_V5_SQL);
+        db.exec(GLOBAL_SCHEMA_V6_SQL);
+        db.exec(GLOBAL_SCHEMA_V7_SQL);
+        db.prepare('INSERT INTO _global_schema (key, value) VALUES (?, ?)').run('version', GLOBAL_SCHEMA_VERSION);
+        db.prepare('INSERT INTO _global_schema (key, value) VALUES (?, ?)').run('created_at', new Date().toISOString());
+    }
+    else if (currentVersion === '1') {
+        // Upgrade from version 1 to latest
+        db.exec(GLOBAL_SCHEMA_V2_SQL);
+        db.exec(GLOBAL_SCHEMA_V3_SQL);
+        db.exec(GLOBAL_SCHEMA_V4_SQL);
+        db.exec(GLOBAL_SCHEMA_V5_SQL);
+        db.exec(GLOBAL_SCHEMA_V6_SQL);
+        db.exec(GLOBAL_SCHEMA_V7_SQL);
+        db.prepare('UPDATE _global_schema SET value = ? WHERE key = ?').run(GLOBAL_SCHEMA_VERSION, 'version');
+    }
+    else if (currentVersion === '2') {
+        // Upgrade from version 2 to latest
+        db.exec(GLOBAL_SCHEMA_V3_SQL);
+        db.exec(GLOBAL_SCHEMA_V4_SQL);
+        db.exec(GLOBAL_SCHEMA_V5_SQL);
+        db.exec(GLOBAL_SCHEMA_V6_SQL);
+        db.exec(GLOBAL_SCHEMA_V7_SQL);
+        db.prepare('UPDATE _global_schema SET value = ? WHERE key = ?').run(GLOBAL_SCHEMA_VERSION, 'version');
+    }
+    else if (currentVersion === '3') {
+        // Upgrade from version 3 to latest
+        db.exec(GLOBAL_SCHEMA_V4_SQL);
+        db.exec(GLOBAL_SCHEMA_V5_SQL);
+        db.exec(GLOBAL_SCHEMA_V6_SQL);
+        db.exec(GLOBAL_SCHEMA_V7_SQL);
+        db.prepare('UPDATE _global_schema SET value = ? WHERE key = ?').run(GLOBAL_SCHEMA_VERSION, 'version');
+    }
+    else if (currentVersion === '4') {
+        // Upgrade from version 4 to latest
+        db.exec(GLOBAL_SCHEMA_V5_SQL);
+        db.exec(GLOBAL_SCHEMA_V6_SQL);
+        db.exec(GLOBAL_SCHEMA_V7_SQL);
+        db.prepare('UPDATE _global_schema SET value = ? WHERE key = ?').run(GLOBAL_SCHEMA_VERSION, 'version');
+    }
+    else if (currentVersion === '5') {
+        // Upgrade from version 5 to latest
+        db.exec(GLOBAL_SCHEMA_V6_SQL);
+        db.exec(GLOBAL_SCHEMA_V7_SQL);
+        db.prepare('UPDATE _global_schema SET value = ? WHERE key = ?').run(GLOBAL_SCHEMA_VERSION, 'version');
+    }
+    else if (currentVersion === '6') {
+        // Upgrade from version 6 to version 7
+        db.exec(GLOBAL_SCHEMA_V7_SQL);
+        db.prepare('UPDATE _global_schema SET value = ? WHERE key = ?').run(GLOBAL_SCHEMA_VERSION, 'version');
+    }
+    // Future upgrades would be handled here with additional conditions
+    return {
+        db,
+        close: () => db.close(),
+    };
+}
+/**
+ * Get global schema version
+ */
+function getGlobalSchemaVersion(db) {
+    try {
+        const row = db
+            .prepare('SELECT value FROM _global_schema WHERE key = ?')
+            .get('version');
+        return row?.value ?? null;
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=global-db.js.map

package/dist/runners/global-db.js.map

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

package/dist/runners/hang-detector.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Subprocess hang detection
+ * Monitors log output and kills processes that appear stuck
+ */
+import type { ChildProcess } from 'node:child_process';
+export interface HangDetectorOptions {
+    timeoutMs?: number;
+    onHang?: (lastOutput: Date, elapsedMs: number) => void;
+    onOutput?: () => void;
+}
+export interface HangDetector {
+    recordOutput: () => void;
+    isHung: () => boolean;
+    getLastOutputTime: () => Date;
+    getElapsedSinceOutput: () => number;
+    stop: () => void;
+}
+/**
+ * Create a hang detector for a subprocess
+ * Monitors output activity and detects when a process appears stuck
+ */
+export declare function createHangDetector(options?: HangDetectorOptions): HangDetector;
+/**
+ * Attach hang detection to a child process
+ * Monitors stdout/stderr for output activity
+ */
+export declare function attachHangDetector(child: ChildProcess, options?: HangDetectorOptions & {
+    killOnHang?: boolean;
+}): HangDetector;
+/**
+ * Get default hang timeout in milliseconds
+ */
+export declare function getDefaultHangTimeout(): number;
+/**
+ * Format elapsed time for display
+ */
+export declare function formatElapsed(ms: number): string;
+//# sourceMappingURL=hang-detector.d.ts.map

package/dist/runners/hang-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hang-detector.d.ts","sourceRoot":"","sources":["../../src/runners/hang-detector.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAIvD,MAAM,WAAW,mBAAmB;IAClC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,CAAC,UAAU,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;IACvD,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;CACvB;AAED,MAAM,WAAW,YAAY;IAC3B,YAAY,EAAE,MAAM,IAAI,CAAC;IACzB,MAAM,EAAE,MAAM,OAAO,CAAC;IACtB,iBAAiB,EAAE,MAAM,IAAI,CAAC;IAC9B,qBAAqB,EAAE,MAAM,MAAM,CAAC;IACpC,IAAI,EAAE,MAAM,IAAI,CAAC;CAClB;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,GAAE,mBAAwB,GAChC,YAAY,CAmDd;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,YAAY,EACnB,OAAO,GAAE,mBAAmB,GAAG;IAAE,UAAU,CAAC,EAAE,OAAO,CAAA;CAAO,GAC3D,YAAY,CA2Dd;AAED;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,MAAM,CAE9C;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAYhD"}

package/dist/runners/hang-detector.js

@@ -0,0 +1,136 @@
+"use strict";
+/**
+ * Subprocess hang detection
+ * Monitors log output and kills processes that appear stuck
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createHangDetector = createHangDetector;
+exports.attachHangDetector = attachHangDetector;
+exports.getDefaultHangTimeout = getDefaultHangTimeout;
+exports.formatElapsed = formatElapsed;
+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
+ */
+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
+ */
+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
+ */
+function getDefaultHangTimeout() {
+    return DEFAULT_HANG_TIMEOUT_MS;
+}
+/**
+ * Format elapsed time for display
+ */
+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/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/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/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/runners/heartbeat.js

@@ -0,0 +1,79 @@
+"use strict";
+/**
+ * Heartbeat system for runner liveness detection
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.updateHeartbeat = updateHeartbeat;
+exports.isHeartbeatStale = isHeartbeatStale;
+exports.findStaleRunners = findStaleRunners;
+exports.createHeartbeatManager = createHeartbeatManager;
+exports.getHeartbeatInterval = getHeartbeatInterval;
+exports.getStaleTimeout = getStaleTimeout;
+const HEARTBEAT_INTERVAL_MS = 30 * 1000; // 30 seconds
+const STALE_TIMEOUT_MS = 5 * 60 * 1000; // 5 minutes
+/**
+ * Update heartbeat timestamp for a runner
+ */
+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
+ */
+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)
+ */
+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
+ */
+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
+ */
+function getHeartbeatInterval() {
+    return HEARTBEAT_INTERVAL_MS;
+}
+/**
+ * Get stale timeout in milliseconds
+ */
+function getStaleTimeout() {
+    return STALE_TIMEOUT_MS;
+}
+//# sourceMappingURL=heartbeat.js.map

package/dist/runners/heartbeat.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"heartbeat.js","sourceRoot":"","sources":["../../src/runners/heartbeat.ts"],"names":[],"mappings":";AAAA;;GAEG;;AAgBH,0CAIC;AAKD,4CAcC;AAKD,4CAYC;AAMD,wDA0BC;AAKD,oDAEC;AAKD,0CAEC;AAlGD,MAAM,qBAAqB,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,aAAa;AACtD,MAAM,gBAAgB,GAAG,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,YAAY;AAQpD;;GAEG;AACH,SAAgB,eAAe,CAAC,EAAqB,EAAE,QAAgB;IACrE,EAAE,CAAC,OAAO,CACR,gEAAgE,CACjE,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;AAClB,CAAC;AAED;;GAEG;AACH,SAAgB,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,SAAgB,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,SAAgB,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,SAAgB,oBAAoB;IAClC,OAAO,qBAAqB,CAAC;AAC/B,CAAC;AAED;;GAEG;AACH,SAAgB,eAAe;IAC7B,OAAO,gBAAgB,CAAC;AAC1B,CAAC"}

package/dist/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/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"}