steroids-cli 0.4.47

package/dist/runners/cron.js

@@ -0,0 +1,176 @@
+"use strict";
+/**
+ * Cron management for runner wake-up
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.cronStatus = cronStatus;
+exports.cronInstall = cronInstall;
+exports.cronUninstall = cronUninstall;
+const node_child_process_1 = require("node:child_process");
+const node_os_1 = require("node:os");
+const CRON_COMMENT = '# steroids-runners-wakeup';
+const CRON_ENTRY = '* * * * * steroids runners wakeup --quiet';
+/**
+ * Get current crontab contents
+ */
+function getCrontab() {
+    try {
+        const result = (0, node_child_process_1.spawnSync)('crontab', ['-l'], {
+            encoding: 'utf-8',
+            stdio: ['pipe', 'pipe', 'pipe'],
+        });
+        if (result.status !== 0) {
+            // "no crontab for user" is not an error for our purposes
+            if (result.stderr?.includes('no crontab')) {
+                return '';
+            }
+            return null;
+        }
+        return result.stdout;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Set crontab contents
+ */
+function setCrontab(contents) {
+    try {
+        const result = (0, node_child_process_1.spawnSync)('crontab', ['-'], {
+            input: contents,
+            encoding: 'utf-8',
+            stdio: ['pipe', 'pipe', 'pipe'],
+        });
+        return result.status === 0;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Find the steroids binary path
+ */
+function findSteroidsPath() {
+    try {
+        const result = (0, node_child_process_1.execSync)('which steroids', { encoding: 'utf-8' }).trim();
+        return result || 'steroids';
+    }
+    catch {
+        return 'steroids';
+    }
+}
+/**
+ * Check cron installation status
+ */
+function cronStatus() {
+    if ((0, node_os_1.platform)() === 'win32') {
+        return {
+            installed: false,
+            error: 'Cron is not supported on Windows. Use Task Scheduler instead.',
+        };
+    }
+    const crontab = getCrontab();
+    if (crontab === null) {
+        return {
+            installed: false,
+            error: 'Failed to read crontab',
+        };
+    }
+    const lines = crontab.split('\n');
+    const steroidsLine = lines.find((line) => line.includes(CRON_COMMENT) || line.includes('steroids runners wakeup'));
+    if (steroidsLine) {
+        return {
+            installed: true,
+            entry: steroidsLine,
+        };
+    }
+    return { installed: false };
+}
+/**
+ * Install cron job for runner wake-up
+ */
+function cronInstall() {
+    if ((0, node_os_1.platform)() === 'win32') {
+        return {
+            success: false,
+            message: 'Cron not supported on Windows',
+            error: 'Use Task Scheduler to run: steroids runners wakeup --quiet',
+        };
+    }
+    // Check if already installed
+    const status = cronStatus();
+    if (status.installed) {
+        return {
+            success: true,
+            message: 'Cron job already installed',
+        };
+    }
+    const crontab = getCrontab();
+    if (crontab === null) {
+        return {
+            success: false,
+            message: 'Failed to read crontab',
+            error: 'Could not access crontab. Check permissions.',
+        };
+    }
+    // Find steroids path for full path in crontab
+    const steroidsPath = findSteroidsPath();
+    const cronLine = `${CRON_COMMENT}\n* * * * * ${steroidsPath} runners wakeup --quiet`;
+    // Append to existing crontab
+    const newCrontab = crontab.trim()
+        ? `${crontab.trim()}\n${cronLine}\n`
+        : `${cronLine}\n`;
+    if (!setCrontab(newCrontab)) {
+        return {
+            success: false,
+            message: 'Failed to update crontab',
+            error: 'Could not write to crontab. Check permissions.',
+        };
+    }
+    return {
+        success: true,
+        message: `Cron job installed. Wake-up runs every minute.`,
+    };
+}
+/**
+ * Uninstall cron job
+ */
+function cronUninstall() {
+    if ((0, node_os_1.platform)() === 'win32') {
+        return {
+            success: false,
+            message: 'Cron not supported on Windows',
+            error: 'Remove the Task Scheduler entry manually.',
+        };
+    }
+    const crontab = getCrontab();
+    if (crontab === null) {
+        return {
+            success: false,
+            message: 'Failed to read crontab',
+        };
+    }
+    // Remove lines containing steroids runners wakeup or our comment
+    const lines = crontab.split('\n');
+    const filteredLines = lines.filter((line) => !line.includes(CRON_COMMENT) &&
+        !line.includes('steroids runners wakeup'));
+    if (lines.length === filteredLines.length) {
+        return {
+            success: true,
+            message: 'No cron job found to remove',
+        };
+    }
+    const newCrontab = filteredLines.join('\n');
+    if (!setCrontab(newCrontab)) {
+        return {
+            success: false,
+            message: 'Failed to update crontab',
+        };
+    }
+    return {
+        success: true,
+        message: 'Cron job removed',
+    };
+}
+//# sourceMappingURL=cron.js.map

package/dist/runners/cron.js.map

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

package/dist/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/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/runners/daemon.js

@@ -0,0 +1,245 @@
+"use strict";
+/**
+ * Runner daemon - background process that executes tasks
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerRunner = registerRunner;
+exports.updateRunnerStatus = updateRunnerStatus;
+exports.updateRunnerHeartbeat = updateRunnerHeartbeat;
+exports.syncProjectStats = syncProjectStats;
+exports.updateRunnerCurrentTask = updateRunnerCurrentTask;
+exports.unregisterRunner = unregisterRunner;
+exports.listRunners = listRunners;
+exports.getRunner = getRunner;
+exports.startDaemon = startDaemon;
+exports.canStartDaemon = canStartDaemon;
+const node_path_1 = require("node:path");
+const uuid_1 = require("uuid");
+const global_db_js_1 = require("./global-db.js");
+const heartbeat_js_1 = require("./heartbeat.js");
+const wakeup_js_1 = require("./wakeup.js");
+const orchestrator_loop_js_1 = require("./orchestrator-loop.js");
+const projects_js_1 = require("./projects.js");
+const connection_js_1 = require("../database/connection.js");
+const queries_js_1 = require("../database/queries.js");
+/**
+ * Register a new runner in the database
+ */
+function registerRunner(projectPath, sectionId) {
+    const { db, close } = (0, global_db_js_1.openGlobalDatabase)();
+    const runnerId = (0, uuid_1.v4)();
+    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
+ */
+function updateRunnerStatus(runnerId, status, currentTaskId) {
+    const { db, close } = (0, global_db_js_1.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
+ */
+function updateRunnerHeartbeat(runnerId) {
+    const { db, close } = (0, global_db_js_1.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
+ */
+function syncProjectStats(projectPath) {
+    try {
+        const { db, close } = (0, connection_js_1.openDatabase)(projectPath);
+        try {
+            const stats = (0, queries_js_1.getTaskCountsByStatus)(db);
+            (0, projects_js_1.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
+ */
+function updateRunnerCurrentTask(runnerId, taskId) {
+    const { db, close } = (0, global_db_js_1.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
+ */
+function unregisterRunner(runnerId) {
+    const { db, close } = (0, global_db_js_1.openGlobalDatabase)();
+    try {
+        db.prepare('DELETE FROM runners WHERE id = ?').run(runnerId);
+    }
+    finally {
+        close();
+    }
+}
+/**
+ * Get all runners
+ */
+function listRunners() {
+    const { db, close } = (0, global_db_js_1.openGlobalDatabase)();
+    try {
+        return db.prepare('SELECT * FROM runners').all();
+    }
+    finally {
+        close();
+    }
+}
+/**
+ * Get runner by ID
+ */
+function getRunner(runnerId) {
+    const { db, close } = (0, global_db_js_1.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
+ */
+async function startDaemon(options = {}) {
+    // Compute effective project path - default to cwd if not specified
+    // Always resolve to absolute path for consistent tracking
+    const effectiveProjectPath = (0, node_path_1.resolve)(options.projectPath ?? process.cwd());
+    // Check if project is disabled in the global registry
+    const registeredProject = (0, projects_js_1.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 ((0, wakeup_js_1.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 } = (0, global_db_js_1.openGlobalDatabase)();
+    // Start heartbeat
+    const heartbeat = (0, heartbeat_js_1.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 (0, orchestrator_loop_js_1.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)
+ */
+function canStartDaemon(projectPath) {
+    // Default to cwd if not specified for consistent per-project tracking
+    // Always resolve to absolute path
+    const effectivePath = (0, node_path_1.resolve)(projectPath ?? process.cwd());
+    // Check if project is disabled
+    const registeredProject = (0, projects_js_1.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 ((0, wakeup_js_1.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/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/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/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"}