steroids-cli 0.4.47

package/dist/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/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/database/connection.js

@@ -0,0 +1,208 @@
+"use strict";
+/**
+ * SQLite database connection management
+ * Uses better-sqlite3 for synchronous operations with WAL mode
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getDbPath = getDbPath;
+exports.isInitialized = isInitialized;
+exports.initDatabase = initDatabase;
+exports.openDatabase = openDatabase;
+exports.getSchemaVersion = getSchemaVersion;
+exports.isSchemaUpToDate = isSchemaUpToDate;
+const better_sqlite3_1 = __importDefault(require("better-sqlite3"));
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const schema_js_1 = require("./schema.js");
+const runner_js_1 = require("../migrations/runner.js");
+const STEROIDS_DIR = '.steroids';
+const DB_NAME = 'steroids.db';
+/**
+ * Get the path to the steroids database
+ */
+function getDbPath(projectPath) {
+    const basePath = projectPath || process.cwd();
+    return (0, node_path_1.join)(basePath, STEROIDS_DIR, DB_NAME);
+}
+/**
+ * Check if steroids is initialized in the given directory
+ */
+function isInitialized(projectPath) {
+    return (0, node_fs_1.existsSync)(getDbPath(projectPath));
+}
+/**
+ * Initialize the database with schema
+ */
+function initDatabase(projectPath) {
+    const dbPath = getDbPath(projectPath);
+    const steroidsDir = (0, node_path_1.dirname)(dbPath);
+    // 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');
+    db.pragma('foreign_keys = ON');
+    // Create schema
+    db.exec(schema_js_1.SCHEMA_SQL);
+    db.exec(schema_js_1.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
+ */
+function openDatabase(projectPath) {
+    const dbPath = getDbPath(projectPath);
+    if (!(0, node_fs_1.existsSync)(dbPath)) {
+        throw new Error(`Steroids not initialized. Run 'steroids init' first.\nExpected database at: ${dbPath}`);
+    }
+    const db = new better_sqlite3_1.default(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 = (0, runner_js_1.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
+ */
+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
+ */
+function isSchemaUpToDate(db) {
+    const version = getSchemaVersion(db);
+    return version === schema_js_1.SCHEMA_VERSION;
+}
+//# sourceMappingURL=connection.js.map

package/dist/database/connection.js.map

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

package/dist/database/queries.d.ts

@@ -0,0 +1,218 @@
+/**
+ * Database query functions for tasks, sections, and audit
+ */
+import type Database from 'better-sqlite3';
+export type TaskStatus = 'pending' | 'in_progress' | 'review' | 'completed' | 'disputed' | 'failed' | 'skipped' | 'partial';
+export declare const STATUS_MARKERS: Record<TaskStatus, string>;
+export interface Task {
+    id: string;
+    title: string;
+    status: TaskStatus;
+    section_id: string | null;
+    source_file: string | null;
+    file_path: string | null;
+    file_line: number | null;
+    file_commit_sha: string | null;
+    file_content_hash: string | null;
+    rejection_count: number;
+    created_at: string;
+    updated_at: string;
+}
+export interface Section {
+    id: string;
+    name: string;
+    position: number;
+    priority?: number;
+    skipped?: number;
+    created_at: string;
+}
+export interface SectionDependency {
+    id: string;
+    section_id: string;
+    depends_on_section_id: string;
+    created_at: string;
+}
+export interface AuditEntry {
+    id: number;
+    task_id: string;
+    from_status: string | null;
+    to_status: string;
+    actor: string;
+    notes: string | null;
+    commit_sha: string | null;
+    created_at: string;
+}
+export interface RejectionEntry {
+    rejection_number: number;
+    commit_sha: string | null;
+    notes: string | null;
+    actor: string;
+    created_at: string;
+}
+export declare function createSection(db: Database.Database, name: string, position?: number): Section;
+export declare function listSections(db: Database.Database): Section[];
+export declare function getSection(db: Database.Database, id: string): Section | null;
+export declare function getSectionByName(db: Database.Database, name: string): Section | null;
+export declare function getOrCreateFeedbackSection(db: Database.Database): Section;
+export declare function getSectionTaskCount(db: Database.Database, sectionId: string): number;
+/**
+ * Get dependencies for a section that have incomplete tasks
+ * Returns sections that the given section depends on and have any non-completed tasks
+ * (pending, in_progress, review, disputed, failed, skipped, partial)
+ */
+export declare function getPendingDependencies(db: Database.Database, sectionId: string): Section[];
+/**
+ * Check if all dependencies for a section are met
+ * Dependencies are considered met when all tasks in dependent sections are completed
+ */
+export declare function hasDependenciesMet(db: Database.Database, sectionId: string): boolean;
+/**
+ * Set the priority of a section
+ * Priority range: 0 (highest) to 100 (lowest), default is 50
+ */
+export declare function setSectionPriority(db: Database.Database, sectionId: string, priority: number): void;
+/**
+ * Check if adding a dependency would create a circular dependency
+ * Returns true if circular dependency would be created
+ */
+export declare function wouldCreateCircularDependency(db: Database.Database, sectionId: string, dependsOnSectionId: string): boolean;
+/**
+ * Add a dependency between sections
+ * Makes sectionId depend on dependsOnSectionId
+ */
+export declare function addSectionDependency(db: Database.Database, sectionId: string, dependsOnSectionId: string): SectionDependency;
+/**
+ * Remove a dependency between sections
+ */
+export declare function removeSectionDependency(db: Database.Database, sectionId: string, dependsOnSectionId: string): void;
+/**
+ * Get all dependencies for a section
+ */
+export declare function getSectionDependencies(db: Database.Database, sectionId: string): Section[];
+/**
+ * Get all sections that depend on a given section
+ */
+export declare function getSectionDependents(db: Database.Database, sectionId: string): Section[];
+export declare function createTask(db: Database.Database, title: string, options?: {
+    sectionId?: string;
+    sourceFile?: string;
+    status?: TaskStatus;
+    filePath?: string;
+    fileLine?: number;
+    fileCommitSha?: string;
+    fileContentHash?: string;
+}): Task;
+export declare function getTask(db: Database.Database, id: string): Task | null;
+export declare function getTaskByTitle(db: Database.Database, title: string): Task | null;
+export declare function listTasks(db: Database.Database, options?: {
+    status?: TaskStatus | 'all';
+    sectionId?: string;
+    search?: string;
+}): Task[];
+export declare function updateTaskStatus(db: Database.Database, taskId: string, newStatus: TaskStatus, actor: string, notes?: string, commitSha?: string): void;
+/**
+ * Reset rejection count to 0 (keeps audit history)
+ * Use when manually restarting a task after spec changes
+ */
+export declare function resetRejectionCount(db: Database.Database, taskId: string, actor: string, notes?: string): number;
+export declare function approveTask(db: Database.Database, taskId: string, model: string, notes?: string, commitSha?: string): void;
+export declare function rejectTask(db: Database.Database, taskId: string, model: string, notes?: string, commitSha?: string): {
+    status: 'retry' | 'failed';
+    rejectionCount: number;
+};
+export interface AuditOptions {
+    notes?: string;
+    commitSha?: string;
+    actorType?: 'human' | 'coder' | 'reviewer' | 'orchestrator';
+    model?: string;
+}
+export declare function addAuditEntry(db: Database.Database, taskId: string, fromStatus: string | null, toStatus: string, actor: string, options?: AuditOptions | string, commitSha?: string): void;
+export declare function getTaskAudit(db: Database.Database, taskId: string): AuditEntry[];
+/**
+ * Get rejection history for a task
+ * Returns entries where a review was rejected (review -> in_progress)
+ * Includes commit hash for easy reference
+ */
+export declare function getTaskRejections(db: Database.Database, taskId: string): RejectionEntry[];
+/**
+ * Get the latest submission notes (when coder submitted for review)
+ * This captures any notes the coder included with --notes flag
+ */
+export declare function getLatestSubmissionNotes(db: Database.Database, taskId: string): string | null;
+export declare function createSystemDisputeForRejection(db: Database.Database, taskId: string, reason: string): string;
+export declare function findNextTask(db: Database.Database, sectionId?: string): {
+    task: Task | null;
+    action: 'review' | 'resume' | 'start' | 'idle';
+};
+/**
+ * Get the last rejection notes for a task
+ */
+export declare function getLastRejectionNotes(db: Database.Database, taskId: string): string | null;
+/**
+ * Get task counts by status for project stats
+ * Used by runner heartbeat to update global database
+ */
+export declare function getTaskCountsByStatus(db: Database.Database): {
+    pending: number;
+    in_progress: number;
+    review: number;
+    completed: number;
+};
+export interface TaskInvocation {
+    id: number;
+    task_id: string;
+    role: 'coder' | 'reviewer';
+    provider: string;
+    model: string;
+    prompt: string;
+    response: string | null;
+    error: string | null;
+    exit_code: number;
+    duration_ms: number;
+    success: number;
+    timed_out: number;
+    rejection_number: number | null;
+    created_at: string;
+}
+export interface CreateInvocationParams {
+    taskId: string;
+    role: 'coder' | 'reviewer';
+    provider: string;
+    model: string;
+    prompt: string;
+    response?: string;
+    error?: string;
+    exitCode: number;
+    durationMs: number;
+    success: boolean;
+    timedOut: boolean;
+    rejectionNumber?: number;
+}
+/**
+ * Log an LLM invocation for a task
+ * This stores the full prompt and response for debugging
+ */
+export declare function createTaskInvocation(db: Database.Database, params: CreateInvocationParams): number;
+/**
+ * Get all invocations for a task
+ * Ordered by creation time (oldest first)
+ */
+export declare function getTaskInvocations(db: Database.Database, taskId: string): TaskInvocation[];
+/**
+ * Get recent invocations for a task (limited)
+ * Ordered by creation time (newest first)
+ */
+export declare function getRecentTaskInvocations(db: Database.Database, taskId: string, limit?: number): TaskInvocation[];
+/**
+ * Get the latest invocation for a specific role
+ */
+export declare function getLatestInvocation(db: Database.Database, taskId: string, role: 'coder' | 'reviewer'): TaskInvocation | null;
+/**
+ * Get invocation count for a task
+ */
+export declare function getInvocationCount(db: Database.Database, taskId: string): {
+    coder: number;
+    reviewer: number;
+    total: number;
+};
+//# sourceMappingURL=queries.d.ts.map

package/dist/database/queries.d.ts.map

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