steroids-api 0.2.7

package/dist/src/config/loader.d.ts

@@ -0,0 +1,160 @@
+/**
+ * Configuration loader
+ * Loads and merges global and project config files
+ */
+export interface SteroidsConfig {
+    ai?: {
+        orchestrator?: {
+            provider?: 'claude' | 'gemini' | 'openai';
+            model?: string;
+            cli?: string;
+        };
+        coder?: {
+            provider?: 'claude' | 'gemini' | 'openai';
+            model?: string;
+            cli?: string;
+        };
+        reviewer?: {
+            provider?: 'claude' | 'gemini' | 'openai';
+            model?: string;
+            cli?: string;
+        };
+    };
+    output?: {
+        format?: 'table' | 'json';
+        colors?: boolean;
+        verbose?: boolean;
+    };
+    git?: {
+        autoPush?: boolean;
+        remote?: string;
+        branch?: string;
+        commitPrefix?: string;
+        retryOnFailure?: boolean;
+    };
+    runners?: {
+        heartbeatInterval?: string;
+        staleTimeout?: string;
+        subprocessHangTimeout?: string;
+        maxConcurrent?: number;
+        logRetention?: string;
+        daemonLogs?: boolean;
+    };
+    health?: {
+        threshold?: number;
+        checks?: {
+            git?: boolean;
+            deps?: boolean;
+            tests?: boolean;
+            lint?: boolean;
+        };
+        orphanedTaskTimeout?: number;
+        maxCoderDuration?: number;
+        maxReviewerDuration?: number;
+        runnerHeartbeatTimeout?: number;
+        invocationStaleness?: number;
+        autoRecover?: boolean;
+        maxRecoveryAttempts?: number;
+        maxIncidentsPerHour?: number;
+    };
+    locking?: {
+        taskTimeout?: string;
+        sectionTimeout?: string;
+        waitTimeout?: string;
+        pollInterval?: string;
+    };
+    database?: {
+        autoMigrate?: boolean;
+        backupBeforeMigrate?: boolean;
+    };
+    logs?: {
+        retention?: string;
+        keepLogs?: boolean;
+        level?: 'debug' | 'info' | 'warn' | 'error';
+    };
+    disputes?: {
+        timeoutDays?: number;
+        autoCreateOnMaxRejections?: boolean;
+        majorBlocksLoop?: boolean;
+        coordinatorCanDispute?: boolean;
+    };
+    projects?: {
+        scanPaths?: string[];
+        excludePatterns?: string[];
+    };
+    backup?: {
+        enabled?: boolean;
+        retention?: string;
+        includeConfig?: boolean;
+        includeLogs?: boolean;
+    };
+    build?: {
+        timeout?: string;
+    };
+    test?: {
+        timeout?: string;
+    };
+    webui?: {
+        port?: number;
+        host?: string;
+        auth?: boolean;
+    };
+    quality?: {
+        tests?: {
+            required?: boolean;
+            minCoverage?: number;
+        };
+    };
+    sections?: {
+        batchMode?: boolean;
+        maxBatchSize?: number;
+    };
+    hooks?: unknown[];
+}
+/**
+ * Default configuration values
+ */
+export declare const DEFAULT_CONFIG: SteroidsConfig;
+/**
+ * Get global config path (~/.steroids/config.yaml)
+ */
+export declare function getGlobalConfigPath(): string;
+/**
+ * Get project config path (.steroids/config.yaml)
+ */
+export declare function getProjectConfigPath(projectPath?: string): string;
+/**
+ * Load config from a file
+ * Returns empty object if file doesn't exist
+ */
+export declare function loadConfigFile(filePath: string): Partial<SteroidsConfig>;
+/**
+ * Deep merge two config objects
+ * Second object values override first
+ */
+export declare function mergeConfigs(base: Partial<SteroidsConfig>, override: Partial<SteroidsConfig>): Partial<SteroidsConfig>;
+/**
+ * Apply environment variable overrides
+ * STEROIDS_AI_CODER_MODEL -> ai.coder.model
+ */
+export declare function applyEnvOverrides(config: Partial<SteroidsConfig>): Partial<SteroidsConfig>;
+/**
+ * Load merged configuration
+ * Priority: defaults < global < project < environment
+ */
+export declare function loadConfig(projectPath?: string): SteroidsConfig;
+/**
+ * Save config to file
+ */
+export declare function saveConfig(config: Partial<SteroidsConfig>, filePath: string): void;
+/**
+ * Get a config value by dot-notation path
+ * e.g., getConfigValue(config, 'ai.coder.model')
+ */
+export declare function getConfigValue(config: SteroidsConfig, path: string): unknown;
+/**
+ * Set a config value by dot-notation path
+ * Returns a new config object with the value set
+ */
+export declare function setConfigValue(config: SteroidsConfig, path: string, value: unknown): SteroidsConfig;
+//# sourceMappingURL=loader.d.ts.map

package/dist/src/config/loader.d.ts.map

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

package/dist/src/config/loader.js

@@ -0,0 +1,276 @@
+/**
+ * Configuration loader
+ * Loads and merges global and project config files
+ */
+import { existsSync, readFileSync, writeFileSync, mkdirSync } from 'node:fs';
+import { join, dirname } from 'node:path';
+import { homedir } from 'node:os';
+import { parse, stringify } from 'yaml';
+const STEROIDS_DIR = '.steroids';
+const CONFIG_FILE = 'config.yaml';
+/**
+ * Default configuration values
+ */
+export const DEFAULT_CONFIG = {
+    ai: {
+        orchestrator: {
+            provider: 'claude',
+            model: 'claude-sonnet-4',
+        },
+        coder: {
+            provider: 'claude',
+            model: 'claude-sonnet-4',
+        },
+        reviewer: {
+            provider: 'claude',
+            model: 'claude-sonnet-4',
+        },
+    },
+    output: {
+        format: 'table',
+        colors: true,
+        verbose: false,
+    },
+    git: {
+        autoPush: true,
+        remote: 'origin',
+        branch: 'main',
+        commitPrefix: '',
+        retryOnFailure: true,
+    },
+    runners: {
+        heartbeatInterval: '30s',
+        staleTimeout: '5m',
+        subprocessHangTimeout: '15m',
+        maxConcurrent: 1,
+        logRetention: '7d',
+    },
+    health: {
+        threshold: 80,
+        checks: {
+            git: true,
+            deps: true,
+            tests: true,
+            lint: true,
+        },
+        orphanedTaskTimeout: 600,
+        maxCoderDuration: 1800,
+        maxReviewerDuration: 900,
+        runnerHeartbeatTimeout: 300,
+        invocationStaleness: 600,
+        autoRecover: true,
+        maxRecoveryAttempts: 3,
+        maxIncidentsPerHour: 10,
+    },
+    locking: {
+        taskTimeout: '60m',
+        sectionTimeout: '120m',
+        waitTimeout: '30m',
+        pollInterval: '5s',
+    },
+    database: {
+        autoMigrate: true,
+        backupBeforeMigrate: true,
+    },
+    logs: {
+        retention: '30d',
+        keepLogs: true,
+        level: 'info',
+    },
+    disputes: {
+        timeoutDays: 7,
+        autoCreateOnMaxRejections: true,
+        majorBlocksLoop: false,
+    },
+    projects: {
+        scanPaths: ['~/Projects'],
+        excludePatterns: ['node_modules', '.git'],
+    },
+    backup: {
+        enabled: true,
+        retention: '7d',
+        includeConfig: true,
+        includeLogs: false,
+    },
+    build: {
+        timeout: '5m',
+    },
+    test: {
+        timeout: '10m',
+    },
+    webui: {
+        port: 3000,
+        host: 'localhost',
+        auth: false,
+    },
+    quality: {
+        tests: {
+            required: false,
+        },
+    },
+    sections: {
+        batchMode: false,
+        maxBatchSize: 10,
+    },
+};
+/**
+ * Get global config path (~/.steroids/config.yaml)
+ */
+export function getGlobalConfigPath() {
+    return join(homedir(), STEROIDS_DIR, CONFIG_FILE);
+}
+/**
+ * Get project config path (.steroids/config.yaml)
+ */
+export function getProjectConfigPath(projectPath) {
+    const basePath = projectPath ?? process.cwd();
+    return join(basePath, STEROIDS_DIR, CONFIG_FILE);
+}
+/**
+ * Load config from a file
+ * Returns empty object if file doesn't exist
+ */
+export function loadConfigFile(filePath) {
+    if (!existsSync(filePath)) {
+        return {};
+    }
+    try {
+        const content = readFileSync(filePath, 'utf-8');
+        return parse(content) ?? {};
+    }
+    catch (error) {
+        console.warn(`Warning: Failed to parse config at ${filePath}`);
+        return {};
+    }
+}
+/**
+ * Deep merge two config objects
+ * Second object values override first
+ */
+export function mergeConfigs(base, override) {
+    const result = { ...base };
+    for (const key of Object.keys(override)) {
+        const baseValue = base[key];
+        const overrideValue = override[key];
+        // Skip "unset" values - empty strings, null, or undefined should not override base values
+        // This preserves base config when override has empty/unset values
+        // Note: We intentionally DO NOT skip false or 0, as these are legitimate override values
+        if (overrideValue === undefined || overrideValue === null || overrideValue === '') {
+            continue;
+        }
+        if (baseValue !== null &&
+            typeof baseValue === 'object' &&
+            !Array.isArray(baseValue) &&
+            overrideValue !== null &&
+            typeof overrideValue === 'object' &&
+            !Array.isArray(overrideValue)) {
+            // Deep merge nested objects
+            result[key] = mergeConfigs(baseValue, overrideValue);
+        }
+        else {
+            // Override value
+            result[key] = overrideValue;
+        }
+    }
+    return result;
+}
+/**
+ * Apply environment variable overrides
+ * STEROIDS_AI_CODER_MODEL -> ai.coder.model
+ */
+export function applyEnvOverrides(config) {
+    const result = { ...config };
+    for (const [key, value] of Object.entries(process.env)) {
+        if (!key.startsWith('STEROIDS_'))
+            continue;
+        // Convert STEROIDS_AI_CODER_MODEL to ['ai', 'coder', 'model']
+        const path = key
+            .substring('STEROIDS_'.length)
+            .toLowerCase()
+            .split('_');
+        // Set nested value
+        let current = result;
+        for (let i = 0; i < path.length - 1; i++) {
+            if (!(path[i] in current) || typeof current[path[i]] !== 'object') {
+                current[path[i]] = {};
+            }
+            current = current[path[i]];
+        }
+        // Convert value type
+        const finalKey = path[path.length - 1];
+        if (value === 'true') {
+            current[finalKey] = true;
+        }
+        else if (value === 'false') {
+            current[finalKey] = false;
+        }
+        else if (!isNaN(Number(value))) {
+            current[finalKey] = Number(value);
+        }
+        else {
+            current[finalKey] = value;
+        }
+    }
+    return result;
+}
+/**
+ * Load merged configuration
+ * Priority: defaults < global < project < environment
+ */
+export function loadConfig(projectPath) {
+    // Start with defaults
+    let config = { ...DEFAULT_CONFIG };
+    // Load and merge global config
+    const globalConfig = loadConfigFile(getGlobalConfigPath());
+    config = mergeConfigs(config, globalConfig);
+    // Load and merge project config
+    const projectConfig = loadConfigFile(getProjectConfigPath(projectPath));
+    config = mergeConfigs(config, projectConfig);
+    // Apply environment overrides
+    config = applyEnvOverrides(config);
+    return config;
+}
+/**
+ * Save config to file
+ */
+export function saveConfig(config, filePath) {
+    const dir = dirname(filePath);
+    if (!existsSync(dir)) {
+        mkdirSync(dir, { recursive: true });
+    }
+    const content = stringify(config, { indent: 2 });
+    writeFileSync(filePath, content, 'utf-8');
+}
+/**
+ * Get a config value by dot-notation path
+ * e.g., getConfigValue(config, 'ai.coder.model')
+ */
+export function getConfigValue(config, path) {
+    const parts = path.split('.');
+    let current = config;
+    for (const part of parts) {
+        if (current === null || typeof current !== 'object') {
+            return undefined;
+        }
+        current = current[part];
+    }
+    return current;
+}
+/**
+ * Set a config value by dot-notation path
+ * Returns a new config object with the value set
+ */
+export function setConfigValue(config, path, value) {
+    const result = JSON.parse(JSON.stringify(config));
+    const parts = path.split('.');
+    let current = result;
+    for (let i = 0; i < parts.length - 1; i++) {
+        if (!(parts[i] in current) || typeof current[parts[i]] !== 'object') {
+            current[parts[i]] = {};
+        }
+        current = current[parts[i]];
+    }
+    current[parts[parts.length - 1]] = value;
+    return result;
+}
+//# sourceMappingURL=loader.js.map

package/dist/src/config/loader.js.map

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

package/dist/src/database/connection.d.ts

@@ -0,0 +1,35 @@
+/**
+ * SQLite database connection management
+ * Uses better-sqlite3 for synchronous operations with WAL mode
+ */
+import Database from 'better-sqlite3';
+export interface DatabaseConnection {
+    db: Database.Database;
+    close: () => void;
+}
+/**
+ * Get the path to the steroids database
+ */
+export declare function getDbPath(projectPath?: string): string;
+/**
+ * Check if steroids is initialized in the given directory
+ */
+export declare function isInitialized(projectPath?: string): boolean;
+/**
+ * Initialize the database with schema
+ */
+export declare function initDatabase(projectPath?: string): DatabaseConnection;
+/**
+ * Open an existing database connection
+ * Automatically applies pending migrations if any are found
+ */
+export declare function openDatabase(projectPath?: string): DatabaseConnection;
+/**
+ * Get schema version from database
+ */
+export declare function getSchemaVersion(db: Database.Database): string | null;
+/**
+ * Check if database schema is current
+ */
+export declare function isSchemaUpToDate(db: Database.Database): boolean;
+//# sourceMappingURL=connection.d.ts.map

package/dist/src/database/connection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection.d.ts","sourceRoot":"","sources":["../../../../src/database/connection.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AAStC,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,QAAQ,CAAC,QAAQ,CAAC;IACtB,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,CAGtD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAE3D;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,kBAAkB,CAwBrE;AAyCD;;;GAGG;AACH,wBAAgB,YAAY,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,kBAAkB,CAoCrE;AAsED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,GAAG,MAAM,GAAG,IAAI,CASrE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,GAAG,OAAO,CAG/D"}

package/dist/src/database/connection.js

@@ -0,0 +1,197 @@
+/**
+ * SQLite database connection management
+ * Uses better-sqlite3 for synchronous operations with WAL mode
+ */
+import Database from 'better-sqlite3';
+import { existsSync, mkdirSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { SCHEMA_SQL, INITIAL_SCHEMA_DATA, SCHEMA_VERSION } from './schema.js';
+import { autoMigrate } from '../migrations/runner.js';
+const STEROIDS_DIR = '.steroids';
+const DB_NAME = 'steroids.db';
+/**
+ * Get the path to the steroids database
+ */
+export function getDbPath(projectPath) {
+    const basePath = projectPath || process.cwd();
+    return join(basePath, STEROIDS_DIR, DB_NAME);
+}
+/**
+ * Check if steroids is initialized in the given directory
+ */
+export function isInitialized(projectPath) {
+    return existsSync(getDbPath(projectPath));
+}
+/**
+ * Initialize the database with schema
+ */
+export function initDatabase(projectPath) {
+    const dbPath = getDbPath(projectPath);
+    const steroidsDir = dirname(dbPath);
+    // 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');
+    db.pragma('foreign_keys = ON');
+    // Create schema
+    db.exec(SCHEMA_SQL);
+    db.exec(INITIAL_SCHEMA_DATA);
+    return {
+        db,
+        close: () => db.close(),
+    };
+}
+/**
+ * Check if an error is a schema mismatch (missing column/table)
+ */
+function isSchemaMismatchError(err) {
+    if (!(err instanceof Error))
+        return false;
+    const msg = err.message.toLowerCase();
+    return (msg.includes('has no column named') ||
+        msg.includes('no such column') ||
+        msg.includes('no such table'));
+}
+/**
+ * Format a helpful error message for schema mismatches
+ */
+function formatMigrationHint(originalError, migrationResult) {
+    const lines = [
+        `Database schema is out of date: ${originalError.message}`,
+        '',
+        'Your database is missing columns or tables added in a newer version of Steroids.',
+    ];
+    if (migrationResult) {
+        lines.push(`Auto-migration failed: ${migrationResult}`);
+    }
+    lines.push('', 'To fix this, run:', '', '  STEROIDS_AUTO_MIGRATE=1 steroids health', '', 'Or set STEROIDS_AUTO_MIGRATE=1 in your environment to migrate automatically.');
+    return lines.join('\n');
+}
+/**
+ * Open an existing database connection
+ * Automatically applies pending migrations if any are found
+ */
+export function openDatabase(projectPath) {
+    const dbPath = getDbPath(projectPath);
+    if (!existsSync(dbPath)) {
+        throw new Error(`Steroids not initialized. Run 'steroids init' first.\nExpected database at: ${dbPath}`);
+    }
+    const db = new Database(dbPath);
+    // Configure SQLite
+    db.pragma('journal_mode = WAL');
+    db.pragma('busy_timeout = 5000');
+    db.pragma('foreign_keys = ON');
+    // Always attempt auto-migration for pending migrations
+    try {
+        const result = autoMigrate(db, dbPath);
+        if (result.applied && result.migrations.length > 0) {
+            console.log(`Auto-migrated database: ${result.migrations.join(', ')}`);
+        }
+        if (result.error) {
+            console.error(`Warning: Migration issue: ${result.error}`);
+        }
+    }
+    catch (err) {
+        // Log but don't fail - the DB may still work if no new columns are needed
+        const msg = err instanceof Error ? err.message : String(err);
+        console.warn(`Warning: Could not check migrations: ${msg}`);
+    }
+    // Wrap the database with schema error interception
+    return {
+        db: wrapWithSchemaErrorHandling(db),
+        close: () => db.close(),
+    };
+}
+/**
+ * Wrap a database instance to intercept schema mismatch errors
+ * and provide helpful migration instructions instead of raw SQLite errors
+ */
+function wrapWithSchemaErrorHandling(db) {
+    const originalPrepare = db.prepare.bind(db);
+    db.prepare = function wrappedPrepare(sql) {
+        try {
+            const stmt = originalPrepare(sql);
+            return wrapStatement(stmt);
+        }
+        catch (err) {
+            if (isSchemaMismatchError(err)) {
+                const hint = formatMigrationHint(err);
+                const wrapped = new Error(hint);
+                wrapped.name = 'MigrationRequired';
+                throw wrapped;
+            }
+            throw err;
+        }
+    };
+    // Also wrap db.exec for raw SQL execution
+    const originalExec = db.exec.bind(db);
+    db.exec = function wrappedExec(sql) {
+        try {
+            return originalExec(sql);
+        }
+        catch (err) {
+            if (isSchemaMismatchError(err)) {
+                const hint = formatMigrationHint(err);
+                const wrapped = new Error(hint);
+                wrapped.name = 'MigrationRequired';
+                throw wrapped;
+            }
+            throw err;
+        }
+    };
+    return db;
+}
+/**
+ * Wrap a prepared statement to intercept schema errors at execution time
+ */
+function wrapStatement(stmt) {
+    const wrapMethod = (fn) => {
+        return ((...args) => {
+            try {
+                return fn.apply(stmt, args);
+            }
+            catch (err) {
+                if (isSchemaMismatchError(err)) {
+                    const hint = formatMigrationHint(err);
+                    const wrapped = new Error(hint);
+                    wrapped.name = 'MigrationRequired';
+                    throw wrapped;
+                }
+                throw err;
+            }
+        });
+    };
+    if (stmt.run)
+        stmt.run = wrapMethod(stmt.run.bind(stmt));
+    if (stmt.get)
+        stmt.get = wrapMethod(stmt.get.bind(stmt));
+    if (stmt.all)
+        stmt.all = wrapMethod(stmt.all.bind(stmt));
+    return stmt;
+}
+/**
+ * Get schema version from database
+ */
+export function getSchemaVersion(db) {
+    try {
+        const row = db
+            .prepare('SELECT value FROM _schema WHERE key = ?')
+            .get('version');
+        return row?.value ?? null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Check if database schema is current
+ */
+export function isSchemaUpToDate(db) {
+    const version = getSchemaVersion(db);
+    return version === SCHEMA_VERSION;
+}
+//# sourceMappingURL=connection.js.map