steroids-cli 0.4.47

package/dist/orchestrator/reviewer.js

@@ -0,0 +1,241 @@
+"use strict";
+/**
+ * Reviewer invocation
+ * Uses AI provider system for flexible LLM support
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.invokeReviewer = invokeReviewer;
+exports.invokeReviewerBatch = invokeReviewerBatch;
+const node_fs_1 = require("node:fs");
+const node_os_1 = require("node:os");
+const node_path_1 = require("node:path");
+const queries_js_1 = require("../database/queries.js");
+const connection_js_1 = require("../database/connection.js");
+const reviewer_js_1 = require("../prompts/reviewer.js");
+const status_js_1 = require("../git/status.js");
+const loader_js_1 = require("../config/loader.js");
+const registry_js_1 = require("../providers/registry.js");
+const invocation_logger_js_1 = require("../providers/invocation-logger.js");
+/**
+ * Write prompt to temp file
+ */
+function writePromptToTempFile(prompt) {
+    const tempPath = (0, node_path_1.join)((0, node_os_1.tmpdir)(), `steroids-reviewer-${Date.now()}.txt`);
+    (0, node_fs_1.writeFileSync)(tempPath, prompt, 'utf-8');
+    return tempPath;
+}
+/**
+ * Parse reviewer output for decision
+ */
+function parseReviewerDecision(output) {
+    const upperOutput = output.toUpperCase();
+    // Look for explicit decision markers
+    if (upperOutput.includes('DECISION: APPROVE') || upperOutput.includes('**APPROVE**') || /\bAPPROVE\b/.test(upperOutput)) {
+        // Extract notes if present
+        const notesMatch = output.match(/(?:notes?|feedback|comments?):\s*["']?([^"'\n]+)/i);
+        return { decision: 'approve', notes: notesMatch?.[1]?.trim() };
+    }
+    if (upperOutput.includes('DECISION: REJECT') || upperOutput.includes('**REJECT**') || /\bREJECT\b/.test(upperOutput)) {
+        // Extract rejection notes
+        const notesMatch = output.match(/(?:notes?|reason|feedback|issues?):\s*["']?([^"'\n]+)/i);
+        return { decision: 'reject', notes: notesMatch?.[1]?.trim() || 'See reviewer output for details' };
+    }
+    if (upperOutput.includes('DECISION: DISPUTE') || upperOutput.includes('**DISPUTE**') || /\bDISPUTE\b/.test(upperOutput)) {
+        const notesMatch = output.match(/(?:reason|notes?):\s*["']?([^"'\n]+)/i);
+        return { decision: 'dispute', notes: notesMatch?.[1]?.trim() };
+    }
+    return {};
+}
+/**
+ * Invoke AI provider with prompt
+ * Uses configuration to determine which provider to use
+ */
+async function invokeProvider(promptFile, timeoutMs = 600_000, // 10 minutes default for reviewer
+taskId, projectPath) {
+    // Load configuration to get reviewer provider settings
+    // Project config overrides global config
+    const config = (0, loader_js_1.loadConfig)(projectPath);
+    const reviewerConfig = config.ai?.reviewer;
+    if (!reviewerConfig?.provider || !reviewerConfig?.model) {
+        throw new Error('Reviewer AI provider not configured. Run "steroids config ai reviewer" to configure.');
+    }
+    // Get the provider from registry
+    const registry = (0, registry_js_1.getProviderRegistry)();
+    const provider = registry.get(reviewerConfig.provider);
+    // Check if provider is available
+    if (!(await provider.isAvailable())) {
+        throw new Error(`Provider '${reviewerConfig.provider}' is not available. ` +
+            `Ensure the CLI is installed and in PATH.`);
+    }
+    // Read prompt content
+    const promptContent = (0, node_fs_1.readFileSync)(promptFile, 'utf-8');
+    // Invoke the provider
+    const result = await provider.invoke(promptContent, {
+        model: reviewerConfig.model,
+        timeout: timeoutMs,
+        cwd: process.cwd(),
+        promptFile,
+        role: 'reviewer',
+        streamOutput: true,
+    });
+    // Log the invocation (to both file and database)
+    (0, invocation_logger_js_1.logInvocation)(promptContent, result, {
+        role: 'reviewer',
+        provider: reviewerConfig.provider,
+        model: reviewerConfig.model,
+        taskId,
+        projectPath,
+    });
+    // Parse the decision from output
+    const { decision, notes } = parseReviewerDecision(result.stdout);
+    return {
+        success: result.success,
+        exitCode: result.exitCode,
+        stdout: result.stdout,
+        stderr: result.stderr,
+        duration: result.duration,
+        timedOut: result.timedOut,
+        decision,
+        notes,
+    };
+}
+/**
+ * Invoke reviewer for a task
+ * @param coordinatorGuidance Optional guidance from coordinator after repeated rejections
+ * @param coordinatorDecision Optional decision type from coordinator
+ */
+async function invokeReviewer(task, projectPath, coordinatorGuidance, coordinatorDecision) {
+    // Load config to show provider/model being used
+    const config = (0, loader_js_1.loadConfig)(projectPath);
+    const reviewerConfig = config.ai?.reviewer;
+    console.log(`\n${'='.repeat(60)}`);
+    console.log(`REVIEWER: ${task.title}`);
+    console.log(`Task ID: ${task.id}`);
+    console.log(`Rejection count: ${task.rejection_count}/15`);
+    console.log(`Provider: ${reviewerConfig?.provider ?? 'not configured'}`);
+    console.log(`Model: ${reviewerConfig?.model ?? 'not configured'}`);
+    console.log(`${'='.repeat(60)}\n`);
+    // Try to find the specific commit for this task
+    let gitDiff;
+    let modifiedFiles;
+    const commitHash = (0, status_js_1.findTaskCommit)(projectPath, task.title);
+    if (commitHash) {
+        console.log(`Found task commit: ${commitHash}`);
+        gitDiff = (0, status_js_1.getCommitDiff)(projectPath, commitHash);
+        modifiedFiles = (0, status_js_1.getCommitFiles)(projectPath, commitHash);
+    }
+    else {
+        // Fallback to HEAD~1 if no matching commit found
+        console.log('No matching commit found, using HEAD~1 diff');
+        gitDiff = (0, status_js_1.getGitDiff)(projectPath, 'HEAD~1');
+        modifiedFiles = (0, status_js_1.getModifiedFiles)(projectPath);
+    }
+    // Fetch other tasks in the same section for context
+    let sectionTasks = [];
+    let rejectionHistory = [];
+    let submissionNotes = null;
+    try {
+        const { db, close } = (0, connection_js_1.openDatabase)(projectPath);
+        // Get section tasks
+        if (task.section_id) {
+            const allSectionTasks = (0, queries_js_1.listTasks)(db, { sectionId: task.section_id });
+            sectionTasks = allSectionTasks.map(t => ({
+                id: t.id,
+                title: t.title,
+                status: t.status,
+            }));
+        }
+        // Get rejection history - ALWAYS fetch this so reviewer can see past attempts
+        rejectionHistory = (0, queries_js_1.getTaskRejections)(db, task.id);
+        if (rejectionHistory.length > 0) {
+            console.log(`Found ${rejectionHistory.length} previous rejection(s) for this task`);
+        }
+        // Get coder's submission notes (if any)
+        submissionNotes = (0, queries_js_1.getLatestSubmissionNotes)(db, task.id);
+        if (submissionNotes) {
+            console.log(`Coder included notes with submission`);
+        }
+        close();
+    }
+    catch (error) {
+        console.warn('Could not fetch task context:', error);
+    }
+    // Reuse config loaded earlier, get reviewer model
+    const reviewerModel = reviewerConfig?.model || 'unknown';
+    const context = {
+        task,
+        projectPath,
+        reviewerModel,
+        gitDiff,
+        modifiedFiles,
+        sectionTasks,
+        rejectionHistory,
+        submissionNotes,
+        config,
+        coordinatorGuidance,
+        coordinatorDecision,
+    };
+    const prompt = (0, reviewer_js_1.generateReviewerPrompt)(context);
+    // Write prompt to temp file
+    const promptFile = writePromptToTempFile(prompt);
+    try {
+        const result = await invokeProvider(promptFile, 600_000, task.id, projectPath);
+        console.log(`\n${'='.repeat(60)}`);
+        console.log(`REVIEWER COMPLETED`);
+        console.log(`Exit code: ${result.exitCode}`);
+        console.log(`Duration: ${(result.duration / 1000).toFixed(1)}s`);
+        console.log(`${'='.repeat(60)}\n`);
+        return result;
+    }
+    finally {
+        // Clean up temp file
+        if ((0, node_fs_1.existsSync)(promptFile)) {
+            (0, node_fs_1.unlinkSync)(promptFile);
+        }
+    }
+}
+/**
+ * Invoke reviewer for a batch of tasks
+ */
+async function invokeReviewerBatch(tasks, sectionName, projectPath) {
+    // Load config for quality settings and to show provider/model being used
+    const config = (0, loader_js_1.loadConfig)(projectPath);
+    const reviewerConfig = config.ai?.reviewer;
+    console.log(`\n${'='.repeat(60)}`);
+    console.log(`BATCH REVIEWER: Section "${sectionName}"`);
+    console.log(`Tasks: ${tasks.length}`);
+    tasks.forEach((t, i) => console.log(`  ${i + 1}. ${t.title} (${t.id})`));
+    console.log(`Provider: ${reviewerConfig?.provider ?? 'not configured'}`);
+    console.log(`Model: ${reviewerConfig?.model ?? 'not configured'}`);
+    console.log(`${'='.repeat(60)}\n`);
+    // Get combined git diff for all tasks (compare against base before batch started)
+    // We look for the earliest task's commit and diff from there
+    const gitDiff = (0, status_js_1.getGitDiff)(projectPath, 'HEAD~' + tasks.length);
+    const modifiedFiles = (0, status_js_1.getModifiedFiles)(projectPath);
+    const context = {
+        tasks,
+        projectPath,
+        sectionName,
+        gitDiff,
+        modifiedFiles,
+        config,
+    };
+    const prompt = (0, reviewer_js_1.generateBatchReviewerPrompt)(context);
+    const promptFile = writePromptToTempFile(prompt);
+    try {
+        // Longer timeout for batch: base 20 minutes + 3 minutes per task
+        const timeoutMs = 20 * 60 * 1000 + tasks.length * 3 * 60 * 1000;
+        const result = await invokeProvider(promptFile, timeoutMs, undefined, projectPath);
+        console.log(`\n${'='.repeat(60)}`);
+        console.log(`BATCH REVIEWER COMPLETED`);
+        console.log(`Duration: ${(result.duration / 1000).toFixed(1)}s`);
+        console.log(`${'='.repeat(60)}\n`);
+        return { ...result, taskCount: tasks.length };
+    }
+    finally {
+        if ((0, node_fs_1.existsSync)(promptFile)) {
+            (0, node_fs_1.unlinkSync)(promptFile);
+        }
+    }
+}
+//# sourceMappingURL=reviewer.js.map

package/dist/orchestrator/reviewer.js.map

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

package/dist/orchestrator/task-selector.d.ts

@@ -0,0 +1,102 @@
+/**
+ * Task selection algorithm with locking integration
+ * Following ORCHESTRATOR.md specification
+ */
+import type Database from 'better-sqlite3';
+import type { Task } from '../database/queries.js';
+import { isTaskLocked, type LockAcquisitionResult, type LockReleaseResult, type HeartbeatHandle } from '../locking/task-lock.js';
+import { acquireSectionLock, releaseSectionLock, isSectionLocked } from '../locking/section-lock.js';
+export interface SelectedTask {
+    task: Task;
+    action: 'review' | 'resume' | 'start';
+    rejectionNotes?: string;
+}
+export interface SelectedTaskWithLock extends SelectedTask {
+    lockResult: LockAcquisitionResult;
+    heartbeat?: HeartbeatHandle;
+}
+export interface TaskSelectionOptions {
+    runnerId: string;
+    timeoutMinutes?: number;
+    noWait?: boolean;
+    waitTimeoutMs?: number;
+    pollIntervalMs?: number;
+    sectionId?: string;
+}
+/**
+ * Select the next task to work on
+ *
+ * Priority order:
+ * 1. Tasks in 'review' status (complete review loop first)
+ * 2. Tasks in 'in_progress' status (resume incomplete work)
+ * 3. Tasks in 'pending' status (start new work)
+ *
+ * Within each priority, tasks are ordered by:
+ * - Section position (lower first)
+ * - Creation time (older first)
+ */
+export declare function selectNextTask(db: Database.Database, sectionId?: string): SelectedTask | null;
+/**
+ * Batch of tasks from a single section
+ */
+export interface TaskBatch {
+    tasks: Task[];
+    sectionId: string;
+    sectionName: string;
+}
+/**
+ * Select a batch of pending tasks from the first available section
+ * Used when batch mode is enabled
+ */
+export declare function selectTaskBatch(db: Database.Database, maxSize?: number): TaskBatch | null;
+/**
+ * Mark a task as in_progress when starting
+ */
+export declare function markTaskInProgress(db: Database.Database, taskId: string): void;
+/**
+ * Check if all tasks are completed
+ */
+export declare function areAllTasksComplete(db: Database.Database, sectionId?: string): boolean;
+/**
+ * Count tasks by status
+ */
+export declare function getTaskCounts(db: Database.Database, sectionId?: string): {
+    pending: number;
+    in_progress: number;
+    review: number;
+    completed: number;
+    disputed: number;
+    failed: number;
+    total: number;
+};
+/**
+ * Select the next task and acquire a lock on it
+ * Skips tasks that are already locked by other runners
+ */
+export declare function selectNextTaskWithLock(db: Database.Database, options: TaskSelectionOptions): SelectedTaskWithLock | null;
+/**
+ * Select next task with wait behavior
+ * Waits for a locked task if no unlocked tasks are available
+ */
+export declare function selectNextTaskWithWait(db: Database.Database, options: TaskSelectionOptions): Promise<SelectedTaskWithLock | null>;
+/**
+ * Release task lock after completion
+ */
+export declare function releaseTaskLockAfterCompletion(db: Database.Database, taskId: string, runnerId: string, heartbeat?: HeartbeatHandle): LockReleaseResult;
+/**
+ * Mark task in progress and acquire lock
+ */
+export declare function startTaskWithLock(db: Database.Database, taskId: string, runnerId: string, timeoutMinutes?: number): {
+    success: boolean;
+    heartbeat?: HeartbeatHandle;
+    error?: string;
+};
+/**
+ * Complete task and release lock
+ */
+export declare function completeTaskWithLock(db: Database.Database, taskId: string, runnerId: string, newStatus: 'review' | 'completed', heartbeat?: HeartbeatHandle): {
+    success: boolean;
+    error?: string;
+};
+export { isTaskLocked, isSectionLocked, acquireSectionLock, releaseSectionLock, };
+//# sourceMappingURL=task-selector.d.ts.map

package/dist/orchestrator/task-selector.d.ts.map

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