@mknightzzz/stw 0.1.0

package/dist/task-review.js

@@ -0,0 +1,410 @@
+/* eslint-disable max-lines */
+import { writeCheckpoint, readCheckpoint, CHECKPOINT_ORDER } from './checkpoint.js';
+import { runValidation } from './validation.js';
+import { reviewTask } from './llm-reviewer.js';
+import { runMechanicalReview } from './mechanical-review.js';
+import { estimateCost, recordCost } from './cost.js';
+import { getNextTier } from './router.js';
+import { join } from 'node:path';
+import { appendFileSync, existsSync, mkdirSync } from 'node:fs';
+export function checkpointNotDone(current, target) {
+    const ORDER = CHECKPOINT_ORDER;
+    return ORDER.indexOf(current) <= ORDER.indexOf(target);
+}
+/**
+ * Writes acceptance check errors to the specified attempt directory.
+ * Called after runValidation() and after runMechanicalReview().
+ * Appends to the file so both validation and mechanical review errors are preserved.
+ */
+function writeAcceptanceErrors(taskDir, attemptNumber, content) {
+    const attemptDir = join(taskDir, 'attempts', String(attemptNumber));
+    const errorPath = join(attemptDir, 'acceptance-errors.txt');
+    if (!existsSync(attemptDir)) {
+        mkdirSync(attemptDir, { recursive: true });
+    }
+    appendFileSync(errorPath, content, 'utf-8');
+}
+/**
+ * Formats validation check failures for error output.
+ */
+function formatValidationFailures(validationResult) {
+    const lines = [];
+    for (const check of validationResult.checks) {
+        if (!check.passed) {
+            lines.push(`Command: ${check.command}`);
+            lines.push(`Exit code: ${check.exit_code}`);
+            if (check.stderr) {
+                lines.push(`Stderr: ${check.stderr}`);
+            }
+            if (check.stdout) {
+                lines.push(`Stdout: ${check.stdout}`);
+            }
+            lines.push('---');
+        }
+    }
+    return lines.join('\n');
+}
+/**
+ * Formats mechanical review failures for error output.
+ */
+function formatMechanicalFailures(mechanicalResult) {
+    const lines = [];
+    const tests = mechanicalResult.checks.tests;
+    if (!tests.passed) {
+        lines.push('Tests failed:');
+        lines.push(tests.output);
+        lines.push('---');
+    }
+    const typecheck = mechanicalResult.checks.typecheck;
+    if (!typecheck.passed) {
+        lines.push('Typecheck failed:');
+        lines.push(typecheck.output);
+        lines.push('---');
+    }
+    const scope = mechanicalResult.checks.scope;
+    if (!scope.passed) {
+        lines.push('Scope violations detected:');
+        if (scope.undeclared.length > 0) {
+            lines.push(`Undeclared files: ${scope.undeclared.join(', ')}`);
+        }
+        lines.push('---');
+    }
+    return lines.join('\n');
+}
+export async function runReviewPhase(ctx, currentCheckpoint) {
+    const { task, config, workerResult, worktreePath, taskDir, runBranch, currentTier, consecutiveRejects, attempts, maxAttempts, totalTokens, stwRoot, runId, log, pricing, onPhaseChange, tryTransition, } = ctx;
+    let checkpoint = currentCheckpoint;
+    // --- post_write ---
+    if (checkpointNotDone(checkpoint, 'post_write')) {
+        writeCheckpoint(taskDir, 'post_write', {
+            files_written: workerResult.files_written,
+            diff_length: workerResult.diff.length,
+            timestamp: new Date().toISOString(),
+        });
+        checkpoint = 'post_validate';
+    }
+    // --- post_validate ---
+    if (checkpointNotDone(checkpoint, 'post_validate')) {
+        if (stwRoot && runId) {
+            tryTransition(stwRoot, runId, task.id, 'validating', 'task-executor');
+            log?.withPhase('post_validate').info('Validating');
+        }
+        onPhaseChange?.(task.id, `validation/${task.id}`, 'running');
+        let validationResult;
+        try {
+            validationResult = await runValidation({
+                cwd: worktreePath,
+                commands: task.acceptance_checks,
+                timeout_ms: config.defaults.task_timeout_minutes * 60 * 1000,
+            });
+        }
+        catch (error) {
+            onPhaseChange?.(task.id, `validation/${task.id}`, 'failed');
+            throw error;
+        }
+        // Capture validation errors if validation failed
+        if (!validationResult.passed) {
+            const validationErrors = formatValidationFailures(validationResult);
+            const timestamp = new Date().toISOString();
+            const header = `=== Validation Errors (${timestamp}) ===\n`;
+            writeAcceptanceErrors(taskDir, attempts, header + validationErrors + '\n');
+        }
+        let mechanicalResult;
+        let validationPassed = validationResult.passed;
+        try {
+            mechanicalResult = await runMechanicalReview({
+                cwd: worktreePath,
+                declaredScope: task.scope.files,
+                baseBranch: runBranch,
+                excludeCommands: task.acceptance_checks,
+            });
+            validationPassed = validationPassed && mechanicalResult.passed;
+            log?.info('Mechanical review completed', { passed: mechanicalResult.passed });
+        }
+        catch (err) {
+            validationPassed = false;
+            log?.warn('Mechanical review failed to run', {
+                error: err instanceof Error ? err.message : String(err),
+            });
+        }
+        // Append mechanical review errors if mechanical review failed
+        if (mechanicalResult && !mechanicalResult.passed) {
+            const mechanicalErrors = formatMechanicalFailures(mechanicalResult);
+            const timestamp = new Date().toISOString();
+            const header = `=== Mechanical Review Errors (${timestamp}) ===\n`;
+            writeAcceptanceErrors(taskDir, attempts, header + mechanicalErrors + '\n');
+        }
+        onPhaseChange?.(task.id, `validation/${task.id}`, validationPassed ? 'success' : 'failed');
+        writeCheckpoint(taskDir, 'post_validate', {
+            validation_result: validationResult,
+            mechanical_review: mechanicalResult ?? null,
+            timestamp: new Date().toISOString(),
+        });
+        // Fast-fail: if actual validation/mechanical failures, skip LLM review and retry
+        // Note: We only fast-fail on actual failures, not on infrastructure errors (mechanical review throw)
+        const hasValidationFailures = !validationResult.passed;
+        const hasMechanicalFailures = mechanicalResult && !mechanicalResult.passed;
+        if (hasValidationFailures || hasMechanicalFailures) {
+            // Build synthetic review result for acceptance failure
+            const reasons = [];
+            if (!validationResult.passed) {
+                const failedChecks = validationResult.checks.filter((c) => !c.passed);
+                for (const check of failedChecks) {
+                    reasons.push(`Validation failed: ${check.command} (exit ${check.exit_code})`);
+                }
+            }
+            if (mechanicalResult && !mechanicalResult.passed) {
+                if (!mechanicalResult.checks.tests.passed) {
+                    reasons.push(`Tests failed: ${mechanicalResult.checks.tests.output}`);
+                }
+                if (!mechanicalResult.checks.typecheck.passed) {
+                    reasons.push(`Typecheck failed: ${mechanicalResult.checks.typecheck.output}`);
+                }
+                if (!mechanicalResult.checks.scope.passed) {
+                    reasons.push(`Scope violation: undeclared files changed: ${mechanicalResult.checks.scope.undeclared.join(', ')}`);
+                }
+            }
+            const syntheticReviewResult = {
+                decision: 'revise',
+                reasons,
+            };
+            // Write synthetic post_review checkpoint for resumability
+            writeCheckpoint(taskDir, 'post_review', {
+                review_result: syntheticReviewResult,
+                timestamp: new Date().toISOString(),
+            });
+            log?.info('Acceptance checks failed, skipping LLM review', {
+                reasons,
+            });
+            return {
+                outcome: {
+                    type: 'retry',
+                    reason: 'Acceptance checks failed',
+                    diagnosticInput: {
+                        stderr: reasons.join('; '),
+                        diff: workerResult.diff,
+                    },
+                    resetAttempts: false,
+                    resetRejects: false,
+                    incrementRejects: true,
+                    transitionState: 'revision_requested',
+                },
+                nextCheckpoint: 'post_review',
+            };
+        }
+        checkpoint = 'post_review';
+    }
+    // --- post_review ---
+    if (checkpointNotDone(checkpoint, 'post_review')) {
+        if (stwRoot && runId) {
+            tryTransition(stwRoot, runId, task.id, 'reviewing', 'task-executor');
+            log?.withPhase('post_review').info('Reviewing');
+        }
+        onPhaseChange?.(task.id, `review/${task.id}`, 'running');
+        const validationData = readCheckpoint(taskDir, 'post_validate');
+        if (!validationData) {
+            throw new Error('Cannot proceed to post_review: validation data is missing');
+        }
+        let reviewResult;
+        try {
+            reviewResult = await reviewTask(task, config, workerResult.diff, validationData.validation_result, taskDir, worktreePath);
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            // If mechanical review already passed, the code is valid — don't retry just because the LLM reviewer failed
+            const mechanicalData = readCheckpoint(taskDir, 'post_validate');
+            const mechanicalPassed = mechanicalData?.mechanical_review?.passed === true;
+            if (mechanicalPassed) {
+                onPhaseChange?.(task.id, `review/${task.id}`, 'success');
+                log?.warn('Reviewer failed but mechanical review passed, auto-approving', { error: errorMessage });
+                reviewResult = {
+                    decision: 'complete',
+                    reasons: ['Auto-approved: mechanical review passed, LLM reviewer unavailable'],
+                };
+            }
+            else {
+                onPhaseChange?.(task.id, `review/${task.id}`, 'failed');
+                log?.warn('Reviewer failed, treating as retry-able', { error: errorMessage });
+                return {
+                    outcome: {
+                        type: 'retry',
+                        reason: `Reviewer error: ${errorMessage}`,
+                        diagnosticInput: { stderr: errorMessage, diff: workerResult.diff },
+                        resetAttempts: false,
+                        resetRejects: false,
+                    },
+                    nextCheckpoint: checkpoint,
+                };
+            }
+        }
+        onPhaseChange?.(task.id, `review/${task.id}`, reviewResult.decision === 'complete' ? 'success' : 'failed');
+        // Record review cost
+        const effectivePricing = pricing ?? config.pricing;
+        if (stwRoot && runId && effectivePricing && reviewResult.usage) {
+            const reviewModel = reviewResult.model ?? currentTier;
+            const reviewCostUsd = estimateCost(effectivePricing, reviewModel, reviewResult.usage.input_tokens, reviewResult.usage.output_tokens);
+            try {
+                recordCost(stwRoot, runId, task.id, {
+                    task_id: task.id,
+                    model: reviewResult.model ?? 'unknown',
+                    provider: 'unknown',
+                    input_tokens: reviewResult.usage.input_tokens,
+                    output_tokens: reviewResult.usage.output_tokens,
+                    cost_usd: reviewCostUsd,
+                    tier: currentTier,
+                    latency_ms: reviewResult.latency_ms ?? 0,
+                });
+                totalTokens.input_tokens += reviewResult.usage.input_tokens;
+                totalTokens.output_tokens += reviewResult.usage.output_tokens;
+                log?.info('Reviewer cost recorded', { cost_usd: reviewCostUsd, model: reviewModel });
+            }
+            catch (error) {
+                log?.warn('Failed to record reviewer cost', {
+                    error: error instanceof Error ? error.message : String(error),
+                    cost_usd: reviewCostUsd,
+                });
+            }
+        }
+        writeCheckpoint(taskDir, 'post_review', {
+            review_result: reviewResult,
+            timestamp: new Date().toISOString(),
+        });
+        const decision = processReviewDecision({
+            reviewResult,
+            workerDiff: workerResult.diff,
+            currentTier,
+            consecutiveRejects,
+            attempts,
+            maxAttempts,
+            stwRoot,
+            runId,
+            log,
+            task,
+            totalTokens,
+            taskDir,
+            tryTransition,
+        });
+        return { outcome: decision, nextCheckpoint: 'post_review' };
+    }
+    // All checkpoints already done — check if review was complete
+    const reviewData = readCheckpoint(taskDir, 'post_review');
+    if (reviewData?.review_result.decision === 'complete') {
+        if (stwRoot && runId) {
+            tryTransition(stwRoot, runId, task.id, 'complete', 'task-executor');
+        }
+        writeCheckpoint(taskDir, 'complete', {
+            final_state: 'complete',
+            attempts,
+            total_tokens: totalTokens,
+            timestamp: new Date().toISOString(),
+        });
+        return { outcome: { type: 'complete' }, nextCheckpoint: 'complete' };
+    }
+    // Shouldn't reach here in normal flow — signal terminal
+    return { outcome: { type: 'terminal', finalState: 'escalated' }, nextCheckpoint: checkpoint };
+}
+function processReviewDecision(input) {
+    const { reviewResult, workerDiff, currentTier, consecutiveRejects, attempts, maxAttempts, stwRoot, runId, log, task, totalTokens, taskDir, tryTransition, } = input;
+    if (reviewResult.decision === 'complete') {
+        if (stwRoot && runId) {
+            tryTransition(stwRoot, runId, task.id, 'complete', 'task-executor');
+            log?.withPhase('complete').info('Task complete');
+        }
+        writeCheckpoint(taskDir, 'complete', {
+            final_state: 'complete',
+            attempts,
+            total_tokens: totalTokens,
+            timestamp: new Date().toISOString(),
+        });
+        return { type: 'complete' };
+    }
+    if (reviewResult.decision === 'escalate') {
+        const nextTier = getNextTier(currentTier);
+        if (nextTier) {
+            log?.info('Escalating tier after reviewer escalation', { from: currentTier, to: nextTier });
+            return {
+                type: 'retry',
+                reason: `Reviewer escalated from ${currentTier} to ${nextTier}`,
+                diagnosticInput: { stderr: reviewResult.reasons.join('; '), diff: workerDiff },
+                escalateTo: nextTier,
+                resetAttempts: true,
+                resetRejects: true,
+            };
+        }
+        if (stwRoot && runId) {
+            tryTransition(stwRoot, runId, task.id, 'escalated', 'task-executor');
+            log?.withPhase('escalated').info('Task escalated, no higher tier available');
+        }
+        return { type: 'terminal', finalState: 'escalated' };
+    }
+    if (reviewResult.decision === 'reject') {
+        const newRejects = consecutiveRejects + 1;
+        log?.info('Reject received', { consecutiveRejects: newRejects, currentTier });
+        if (newRejects >= 2) {
+            const nextTier = getNextTier(currentTier);
+            if (nextTier) {
+                log?.info('Escalating tier after double-reject', { from: currentTier, to: nextTier });
+                return {
+                    type: 'retry',
+                    reason: `Tier escalated from ${currentTier} to ${nextTier} after double-reject`,
+                    diagnosticInput: { stderr: reviewResult.reasons.join('; '), diff: workerDiff },
+                    escalateTo: nextTier,
+                    resetAttempts: true,
+                    resetRejects: true,
+                    transitionState: 'revision_requested',
+                };
+            }
+            if (stwRoot && runId) {
+                tryTransition(stwRoot, runId, task.id, 'rejected', 'task-executor');
+                log?.withPhase('rejected').info('Task rejected, no higher tier available');
+            }
+            return { type: 'terminal', finalState: 'rejected' };
+        }
+        if (attempts >= maxAttempts) {
+            if (stwRoot && runId) {
+                tryTransition(stwRoot, runId, task.id, 'rejected', 'task-executor');
+                log?.withPhase('rejected').info('Task rejected after exhausting retries');
+            }
+            return { type: 'terminal', finalState: 'rejected' };
+        }
+        return {
+            type: 'retry',
+            reason: `Rejected: ${reviewResult.reasons.join('; ')}`,
+            diagnosticInput: { stderr: reviewResult.reasons.join('; '), diff: workerDiff },
+            resetAttempts: false,
+            resetRejects: false,
+            incrementRejects: true,
+            transitionState: 'revision_requested',
+        };
+    }
+    // 'revise' decision
+    if (attempts >= maxAttempts) {
+        const nextTier = getNextTier(currentTier);
+        if (nextTier) {
+            log?.info('Escalating tier after exhausting retries on revise', { from: currentTier, to: nextTier });
+            return {
+                type: 'retry',
+                reason: `Tier escalated from ${currentTier} to ${nextTier} after exhausting retries`,
+                diagnosticInput: { stderr: reviewResult.reasons.join('; '), diff: workerDiff },
+                escalateTo: nextTier,
+                resetAttempts: true,
+                resetRejects: true,
+                transitionState: 'revision_requested',
+            };
+        }
+        if (stwRoot && runId) {
+            tryTransition(stwRoot, runId, task.id, 'escalated', 'task-executor');
+            log?.withPhase('escalated').info('Task escalated after exhausting all tiers');
+        }
+        return { type: 'terminal', finalState: 'escalated' };
+    }
+    return {
+        type: 'retry',
+        reason: reviewResult.reasons.join('; '),
+        diagnosticInput: { stderr: reviewResult.reasons.join('; '), diff: workerDiff },
+        resetAttempts: false,
+        resetRejects: true,
+        transitionState: 'revision_requested',
+    };
+}
+//# sourceMappingURL=task-review.js.map

package/dist/task-review.js.map

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

package/dist/transitions.d.ts

@@ -0,0 +1,13 @@
+import type { RunState, TaskState } from './types.js';
+export declare class TransitionError extends Error {
+    readonly from: string;
+    readonly to: string;
+    readonly entityType: 'run' | 'task';
+    constructor(from: string, to: string, entityType: 'run' | 'task');
+}
+export declare const VALID_RUN_TRANSITIONS: Readonly<Record<RunState, readonly RunState[]>>;
+export declare const VALID_TASK_TRANSITIONS: Readonly<Record<TaskState, readonly TaskState[]>>;
+export declare function validateRunTransition(from: RunState, to: RunState): boolean;
+export declare function validateTaskTransition(from: TaskState, to: TaskState): boolean;
+export declare function validateSchemaVersion(obj: unknown, expected: number): void;
+export declare function readJsonValidated<T>(filePath: string, validator: (raw: unknown) => T): T;

package/dist/transitions.js

@@ -0,0 +1,104 @@
+import { readJson } from './storage.js';
+export class TransitionError extends Error {
+    from;
+    to;
+    entityType;
+    constructor(from, to, entityType) {
+        super(`Invalid ${entityType} transition: ${from} -> ${to}`);
+        this.name = 'TransitionError';
+        this.from = from;
+        this.to = to;
+        this.entityType = entityType;
+    }
+}
+export const VALID_RUN_TRANSITIONS = {
+    pending: ['planning', 'running', 'stopped'],
+    planning: ['plan_ready', 'plan_blocked', 'paused', 'human_review_required', 'failed', 'stopped'],
+    plan_blocked: ['planning', 'paused', 'human_review_required', 'stopped', 'failed'],
+    plan_ready: ['routing', 'paused', 'human_review_required', 'stopped'],
+    routing: ['running', 'paused', 'human_review_required', 'failed', 'stopped'],
+    running: ['paused', 'human_review_required', 'complete', 'failed', 'stopped'],
+    paused: [
+        'paused',
+        'planning',
+        'plan_blocked',
+        'plan_ready',
+        'routing',
+        'running',
+        'human_review_required',
+        'stopped',
+        'failed',
+    ],
+    human_review_required: [
+        'planning',
+        'plan_blocked',
+        'plan_ready',
+        'routing',
+        'running',
+        'paused',
+        'stopped',
+        'failed',
+    ],
+    complete: [],
+    failed: [],
+    stopped: [],
+};
+export const VALID_TASK_TRANSITIONS = {
+    pending: ['queued', 'skipped'],
+    queued: ['working', 'skipped'],
+    working: ['diagnosing', 'validating', 'question_pending', 'failed', 'skipped'],
+    diagnosing: ['working', 'retrying', 'question_pending', 'failed', 'skipped'],
+    validating: ['reviewing', 'revision_requested', 'failed', 'skipped'],
+    reviewing: ['complete', 'revision_requested', 'escalated', 'waiting_for_human', 'rejected', 'failed', 'skipped'],
+    question_pending: ['working', 'failed', 'skipped'],
+    waiting_for_human: [
+        'working',
+        'reviewing',
+        'complete',
+        'revision_requested',
+        'escalated',
+        'rejected',
+        'failed',
+        'skipped',
+    ],
+    revision_requested: ['diagnosing', 'retrying', 'escalated', 'rejected', 'skipped'],
+    retrying: ['working', 'skipped'],
+    escalated: ['queued', 'rejected', 'failed', 'skipped'],
+    rejected: [],
+    complete: [],
+    failed: [],
+    skipped: ['queued', 'pending'],
+};
+export function validateRunTransition(from, to) {
+    return VALID_RUN_TRANSITIONS[from].includes(to);
+}
+export function validateTaskTransition(from, to) {
+    return VALID_TASK_TRANSITIONS[from].includes(to);
+}
+export function validateSchemaVersion(obj, expected) {
+    if (typeof obj !== 'object' || obj === null) {
+        throw new Error('expected an object with schema_version');
+    }
+    const actual = obj.schema_version;
+    if (actual !== expected) {
+        throw new Error(`expected schema_version ${expected}, got ${formatValue(actual)}`);
+    }
+}
+export function readJsonValidated(filePath, validator) {
+    const raw = readJson(filePath);
+    try {
+        return validator(raw);
+    }
+    catch (error) {
+        throw new Error(`Validation failed for ${filePath}: ${getErrorMessage(error)}`, {
+            cause: error,
+        });
+    }
+}
+function getErrorMessage(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+function formatValue(value) {
+    return value === undefined ? 'undefined' : JSON.stringify(value);
+}
+//# sourceMappingURL=transitions.js.map

package/dist/transitions.js.map

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