steroids-api 0.2.7

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

@@ -0,0 +1,71 @@
+/**
+ * Runner daemon - background process that executes tasks
+ */
+export type RunnerStatus = 'idle' | 'running' | 'stopping';
+export interface Runner {
+    id: string;
+    status: RunnerStatus;
+    pid: number | null;
+    project_path: string | null;
+    section_id: string | null;
+    current_task_id: string | null;
+    started_at: string | null;
+    heartbeat_at: string;
+}
+export interface DaemonOptions {
+    projectPath?: string;
+    sectionId?: string;
+    onTaskStart?: (taskId: string) => void;
+    onTaskComplete?: (taskId: string) => void;
+    onShutdown?: () => void;
+}
+/**
+ * Register a new runner in the database
+ */
+export declare function registerRunner(projectPath?: string, sectionId?: string): {
+    runnerId: string;
+    close: () => void;
+};
+/**
+ * Update runner status
+ */
+export declare function updateRunnerStatus(runnerId: string, status: RunnerStatus, currentTaskId?: string | null): void;
+/**
+ * Update runner heartbeat timestamp
+ */
+export declare function updateRunnerHeartbeat(runnerId: string): void;
+/**
+ * Sync project stats to global database
+ * Called during heartbeat to cache stats for API/WebUI
+ */
+export declare function syncProjectStats(projectPath: string): void;
+/**
+ * Update runner's current task
+ */
+export declare function updateRunnerCurrentTask(runnerId: string, taskId: string | null): void;
+/**
+ * Remove runner from database
+ */
+export declare function unregisterRunner(runnerId: string): void;
+/**
+ * Get all runners
+ */
+export declare function listRunners(): Runner[];
+/**
+ * Get runner by ID
+ */
+export declare function getRunner(runnerId: string): Runner | null;
+/**
+ * Start the runner daemon
+ * This is the main entry point for background task processing
+ */
+export declare function startDaemon(options?: DaemonOptions): Promise<void>;
+/**
+ * Check if daemon can be started (no existing lock or project-specific runner)
+ */
+export declare function canStartDaemon(projectPath?: string): {
+    canStart: boolean;
+    reason?: string;
+    existingPid?: number;
+};
+//# sourceMappingURL=daemon.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"daemon.d.ts","sourceRoot":"","sources":["../../../../src/runners/daemon.ts"],"names":[],"mappings":"AAAA;;GAEG;AAYH,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,SAAS,GAAG,UAAU,CAAC;AAE3D,MAAM,WAAW,MAAM;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,YAAY,CAAC;IACrB,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,aAAa;IAC5B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IACvC,cAAc,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IAC1C,UAAU,CAAC,EAAE,MAAM,IAAI,CAAC;CACzB;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,WAAW,CAAC,EAAE,MAAM,EACpB,SAAS,CAAC,EAAE,MAAM,GACjB;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,IAAI,CAAA;CAAE,CAUzC;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,YAAY,EACpB,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,GAC5B,IAAI,CAiBN;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAS5D;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAc1D;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,GAAG,IAAI,GACpB,IAAI,CASN;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAOvD;AAED;;GAEG;AACH,wBAAgB,WAAW,IAAI,MAAM,EAAE,CAOtC;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CASzD;AAED;;;GAGG;AACH,wBAAsB,WAAW,CAAC,OAAO,GAAE,aAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAgG5E;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG;IACpD,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAwBA"}

package/dist/src/runners/daemon.js

@@ -0,0 +1,233 @@
+/**
+ * Runner daemon - background process that executes tasks
+ */
+import { resolve } from 'node:path';
+import { v4 as uuidv4 } from 'uuid';
+import { openGlobalDatabase } from './global-db.js';
+import { createHeartbeatManager } from './heartbeat.js';
+import { hasActiveRunnerForProject } from './wakeup.js';
+import { runOrchestratorLoop } from './orchestrator-loop.js';
+import { updateProjectStats, getRegisteredProject } from './projects.js';
+import { openDatabase } from '../database/connection.js';
+import { getTaskCountsByStatus } from '../database/queries.js';
+/**
+ * Register a new runner in the database
+ */
+export function registerRunner(projectPath, sectionId) {
+    const { db, close } = openGlobalDatabase();
+    const runnerId = uuidv4();
+    db.prepare(`INSERT INTO runners (id, status, pid, project_path, section_id, started_at, heartbeat_at)
+     VALUES (?, 'idle', ?, ?, ?, datetime('now'), datetime('now'))`).run(runnerId, process.pid, projectPath ?? null, sectionId ?? null);
+    return { runnerId, close };
+}
+/**
+ * Update runner status
+ */
+export function updateRunnerStatus(runnerId, status, currentTaskId) {
+    const { db, close } = openGlobalDatabase();
+    try {
+        if (currentTaskId !== undefined) {
+            db.prepare(`UPDATE runners SET status = ?, current_task_id = ?, heartbeat_at = datetime('now')
+         WHERE id = ?`).run(status, currentTaskId, runnerId);
+        }
+        else {
+            db.prepare(`UPDATE runners SET status = ?, heartbeat_at = datetime('now')
+         WHERE id = ?`).run(status, runnerId);
+        }
+    }
+    finally {
+        close();
+    }
+}
+/**
+ * Update runner heartbeat timestamp
+ */
+export function updateRunnerHeartbeat(runnerId) {
+    const { db, close } = openGlobalDatabase();
+    try {
+        db.prepare(`UPDATE runners SET heartbeat_at = datetime('now') WHERE id = ?`).run(runnerId);
+    }
+    finally {
+        close();
+    }
+}
+/**
+ * Sync project stats to global database
+ * Called during heartbeat to cache stats for API/WebUI
+ */
+export function syncProjectStats(projectPath) {
+    try {
+        const { db, close } = openDatabase(projectPath);
+        try {
+            const stats = getTaskCountsByStatus(db);
+            updateProjectStats(projectPath, stats);
+        }
+        finally {
+            close();
+        }
+    }
+    catch (error) {
+        // Silently fail if project DB is unavailable
+        // (e.g., during initialization or corruption)
+        console.error(`Failed to sync stats for ${projectPath}:`, error);
+    }
+}
+/**
+ * Update runner's current task
+ */
+export function updateRunnerCurrentTask(runnerId, taskId) {
+    const { db, close } = openGlobalDatabase();
+    try {
+        db.prepare(`UPDATE runners SET current_task_id = ?, heartbeat_at = datetime('now') WHERE id = ?`).run(taskId, runnerId);
+    }
+    finally {
+        close();
+    }
+}
+/**
+ * Remove runner from database
+ */
+export function unregisterRunner(runnerId) {
+    const { db, close } = openGlobalDatabase();
+    try {
+        db.prepare('DELETE FROM runners WHERE id = ?').run(runnerId);
+    }
+    finally {
+        close();
+    }
+}
+/**
+ * Get all runners
+ */
+export function listRunners() {
+    const { db, close } = openGlobalDatabase();
+    try {
+        return db.prepare('SELECT * FROM runners').all();
+    }
+    finally {
+        close();
+    }
+}
+/**
+ * Get runner by ID
+ */
+export function getRunner(runnerId) {
+    const { db, close } = openGlobalDatabase();
+    try {
+        return db
+            .prepare('SELECT * FROM runners WHERE id = ?')
+            .get(runnerId);
+    }
+    finally {
+        close();
+    }
+}
+/**
+ * Start the runner daemon
+ * This is the main entry point for background task processing
+ */
+export async function startDaemon(options = {}) {
+    // Compute effective project path - default to cwd if not specified
+    // Always resolve to absolute path for consistent tracking
+    const effectiveProjectPath = resolve(options.projectPath ?? process.cwd());
+    // Check if project is disabled in the global registry
+    const registeredProject = getRegisteredProject(effectiveProjectPath);
+    if (registeredProject && !registeredProject.enabled) {
+        console.error(`Project is disabled: ${effectiveProjectPath}`);
+        console.error('Run "steroids projects enable" to enable it.');
+        process.exit(7); // Project disabled exit code
+    }
+    // Check if there's already an active runner for this specific project
+    if (hasActiveRunnerForProject(effectiveProjectPath)) {
+        console.error(`A runner is already active for project: ${effectiveProjectPath}`);
+        console.error('Only one runner per project is allowed.');
+        process.exit(6); // Resource locked exit code
+    }
+    // Register runner with effective project path and section ID
+    // Note: Per-project isolation is enforced by hasActiveRunnerForProject() above
+    const { runnerId, close: closeDb } = registerRunner(effectiveProjectPath, options.sectionId);
+    const { db } = openGlobalDatabase();
+    // Start heartbeat
+    const heartbeat = createHeartbeatManager(db, runnerId);
+    heartbeat.start();
+    let isShuttingDown = false;
+    // Graceful shutdown handler
+    const shutdown = async (signal) => {
+        if (isShuttingDown)
+            return;
+        isShuttingDown = true;
+        console.log(`\nReceived ${signal}, shutting down gracefully...`);
+        // Stop heartbeat
+        heartbeat.stop();
+        // Update status
+        updateRunnerStatus(runnerId, 'stopping');
+        // Call shutdown callback
+        if (options.onShutdown) {
+            options.onShutdown();
+        }
+        // Clean up
+        unregisterRunner(runnerId);
+        closeDb();
+        console.log('Runner stopped.');
+        process.exit(0);
+    };
+    // Register signal handlers
+    process.on('SIGTERM', () => shutdown('SIGTERM'));
+    process.on('SIGINT', () => shutdown('SIGINT'));
+    console.log(`Runner started (ID: ${runnerId}, PID: ${process.pid})`);
+    updateRunnerStatus(runnerId, 'running');
+    // Track if shutdown was requested
+    let shutdownRequested = false;
+    // Run the orchestrator loop
+    try {
+        await runOrchestratorLoop({
+            projectPath: effectiveProjectPath,
+            sectionId: options.sectionId,
+            runnerId, // Pass runner ID for activity logging
+            shouldStop: () => shutdownRequested,
+            onIteration: (iteration) => {
+                // Update heartbeat on each iteration
+                updateRunnerHeartbeat(runnerId);
+                // Sync project stats to global DB for API/WebUI access
+                syncProjectStats(effectiveProjectPath);
+            },
+            onTaskStart: (taskId) => {
+                updateRunnerCurrentTask(runnerId, taskId);
+            },
+            onTaskComplete: () => {
+                updateRunnerCurrentTask(runnerId, null);
+            },
+        });
+    }
+    catch (error) {
+        console.error('Loop error:', error);
+    }
+    // Cleanup and exit
+    shutdown('completed');
+}
+/**
+ * Check if daemon can be started (no existing lock or project-specific runner)
+ */
+export function canStartDaemon(projectPath) {
+    // Default to cwd if not specified for consistent per-project tracking
+    // Always resolve to absolute path
+    const effectivePath = resolve(projectPath ?? process.cwd());
+    // Check if project is disabled
+    const registeredProject = getRegisteredProject(effectivePath);
+    if (registeredProject && !registeredProject.enabled) {
+        return {
+            canStart: false,
+            reason: `Project is disabled: ${effectivePath}. Run "steroids projects enable" to enable it.`,
+        };
+    }
+    // Check for project-specific runner (one runner per project allowed)
+    if (hasActiveRunnerForProject(effectivePath)) {
+        return {
+            canStart: false,
+            reason: `A runner is already active for project: ${effectivePath}`,
+        };
+    }
+    // Multiple projects can run in parallel - no global lock check
+    return { canStart: true };
+}
+//# sourceMappingURL=daemon.js.map

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

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

package/dist/src/runners/global-db.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Global database for runner state
+ * Located at ~/.steroids/steroids.db (user home, not project)
+ */
+import Database from 'better-sqlite3';
+export interface GlobalDatabaseConnection {
+    db: Database.Database;
+    close: () => void;
+}
+/**
+ * Get the path to the global steroids directory
+ */
+export declare function getGlobalSteroidsDir(): string;
+/**
+ * Get the path to the global database
+ */
+export declare function getGlobalDbPath(): string;
+/**
+ * Check if global database exists
+ */
+export declare function isGlobalDbInitialized(): boolean;
+/**
+ * Initialize and open the global database
+ * Creates it if it doesn't exist
+ */
+export declare function openGlobalDatabase(): GlobalDatabaseConnection;
+/**
+ * Get global schema version
+ */
+export declare function getGlobalSchemaVersion(db: Database.Database): string | null;
+//# sourceMappingURL=global-db.d.ts.map

package/dist/src/runners/global-db.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"global-db.d.ts","sourceRoot":"","sources":["../../../../src/runners/global-db.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AAQtC,MAAM,WAAW,wBAAwB;IACvC,EAAE,EAAE,QAAQ,CAAC,QAAQ,CAAC;IACtB,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB;AAuGD;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,CAE7C;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,MAAM,CAExC;AAED;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,OAAO,CAE/C;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,IAAI,wBAAwB,CAyG7D;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,GAAG,MAAM,GAAG,IAAI,CAS3E"}

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

@@ -0,0 +1,220 @@
+/**
+ * Global database for runner state
+ * Located at ~/.steroids/steroids.db (user home, not project)
+ */
+import Database from 'better-sqlite3';
+import { existsSync, mkdirSync } from 'node:fs';
+import { join } from 'node:path';
+import { homedir } from '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
+ */
+export function getGlobalSteroidsDir() {
+    return join(homedir(), STEROIDS_DIR);
+}
+/**
+ * Get the path to the global database
+ */
+export function getGlobalDbPath() {
+    return join(getGlobalSteroidsDir(), DB_NAME);
+}
+/**
+ * Check if global database exists
+ */
+export function isGlobalDbInitialized() {
+    return existsSync(getGlobalDbPath());
+}
+/**
+ * Initialize and open the global database
+ * Creates it if it doesn't exist
+ */
+export function openGlobalDatabase() {
+    const dbPath = getGlobalDbPath();
+    const steroidsDir = getGlobalSteroidsDir();
+    // Create ~/.steroids directory if it doesn't exist
+    if (!existsSync(steroidsDir)) {
+        mkdirSync(steroidsDir, { recursive: true });
+    }
+    const db = new Database(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
+ */
+export 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/src/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/src/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/src/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"}