@mknightzzz/stw 0.1.0

package/dist/task-graph.js

@@ -0,0 +1,226 @@
+import { VALID_TASK_TRANSITIONS } from './transitions.js';
+const BROAD_TASK_PATTERN = /\b(clean\s*up|cleanup|refactor|polish|integrate|integration|wire\s*up|hook\s*up|finalize|follow[- ]up|misc)\b/i;
+const CATCH_ALL_CHECK_PATTERN = /\b(run\s+(all|full)\s+(tests|checks|validation)|validate\s+everything|full\s+validation|all\s+tests)\b/i;
+const WEAK_CHECK_PATTERN = /\b(manual|looks good|works as expected|sanity check|spot check)\b/i;
+const WEAK_DESCRIPTION_PATTERN = /^.{0,18}$|\b(handle|support|update|improve|fix|adjust|address)\b/i;
+const LOCAL_COMMAND_PATTERN = /\b(npx|npm run|pnpm|yarn|node|vitest|jest|tsc|pytest|go test|cargo test|mvn|gradle)\b/i;
+const PROOF_COMMAND_PATTERN = /\b(vitest|jest|tsc|eslint|pytest|go test|cargo test|mvn|gradle|npm run|pnpm|yarn|npx)\b/i;
+const INTEGRATION_TASK_PATTERN = /\b(integration|integrate|final[_ -]?validation|finalize|validation|verify|ship|release)\b/i;
+export function validateTaskGraph(graph) {
+    const errors = [];
+    const warnings = [];
+    const taskIds = new Set();
+    for (const task of graph.tasks) {
+        if (taskIds.has(task.id)) {
+            errors.push(`Duplicate task ID: ${task.id}`);
+        }
+        taskIds.add(task.id);
+    }
+    for (const task of graph.tasks) {
+        for (const dep of task.dependencies) {
+            if (!taskIds.has(dep)) {
+                errors.push(`Task ${task.id} has unknown dependency: ${dep}`);
+            }
+        }
+    }
+    if (errors.length > 0) {
+        return { valid: false, errors, warnings, executionOrder: [] };
+    }
+    const inDegree = new Map();
+    const adj = new Map();
+    for (const task of graph.tasks) {
+        inDegree.set(task.id, task.dependencies.length);
+        adj.set(task.id, []);
+    }
+    for (const task of graph.tasks) {
+        for (const dep of task.dependencies) {
+            adj.get(dep)?.push(task.id);
+        }
+    }
+    const queue = [];
+    for (const [id, deg] of inDegree) {
+        if (deg === 0)
+            queue.push(id);
+    }
+    const order = [];
+    while (queue.length > 0) {
+        queue.sort();
+        const current = queue.shift();
+        if (!current) {
+            continue;
+        }
+        order.push(current);
+        for (const next of adj.get(current) ?? []) {
+            const currentDegree = inDegree.get(next);
+            if (currentDegree === undefined) {
+                continue;
+            }
+            const newDeg = currentDegree - 1;
+            inDegree.set(next, newDeg);
+            if (newDeg === 0)
+                queue.push(next);
+        }
+    }
+    if (order.length !== graph.tasks.length) {
+        errors.push('Task graph contains a cycle');
+        return { valid: false, errors, warnings, executionOrder: [] };
+    }
+    warnings.push(...collectTaskGraphWarnings(graph));
+    return { valid: true, errors: [], warnings, executionOrder: order };
+}
+function collectTaskGraphWarnings(graph) {
+    const warnings = [];
+    for (const task of graph.tasks) {
+        if (BROAD_TASK_PATTERN.test(task.description) && task.scope.files.length > 2) {
+            warnings.push(`${task.id}: task description appears broad for its file scope`);
+        }
+        if (WEAK_DESCRIPTION_PATTERN.test(task.description) && task.scope.files.length > 1) {
+            warnings.push(`${task.id}: task description may be ambiguous for a multi-file task`);
+        }
+        if (task.acceptance_checks.length === 0) {
+            warnings.push(`${task.id}: task has no acceptance checks`);
+            continue;
+        }
+        if (task.acceptance_checks.some((check) => CATCH_ALL_CHECK_PATTERN.test(check))) {
+            warnings.push(`${task.id}: task uses catch-all validation checks`);
+        }
+        if (task.acceptance_checks.some((check) => WEAK_CHECK_PATTERN.test(check))) {
+            warnings.push(`${task.id}: task uses weak acceptance checks`);
+        }
+        if (task.acceptance_checks.some((check) => !LOCAL_COMMAND_PATTERN.test(check))) {
+            warnings.push(`${task.id}: acceptance checks may not be locally runnable commands`);
+        }
+        if (task.acceptance_checks.every((check) => !PROOF_COMMAND_PATTERN.test(check))) {
+            warnings.push(`${task.id}: acceptance checks may lack executable proof of completion`);
+        }
+        if (INTEGRATION_TASK_PATTERN.test(task.task_type) || INTEGRATION_TASK_PATTERN.test(task.description)) {
+            if (task.scope.files.length > 3) {
+                warnings.push(`${task.id}: integration/final-validation task may be too broad`);
+            }
+            if (task.dependencies.length === 0 && graph.tasks.length > 1) {
+                warnings.push(`${task.id}: integration/final-validation task should usually depend on prior implementation tasks`);
+            }
+        }
+    }
+    warnings.push(...detectOverlappingImplementationScope(graph));
+    return dedupe(warnings);
+}
+function detectOverlappingImplementationScope(graph) {
+    const warnings = [];
+    const taskById = new Map(graph.tasks.map((task) => [task.id, task]));
+    const reachabilityCache = new Map();
+    for (let index = 0; index < graph.tasks.length; index += 1) {
+        for (let otherIndex = index + 1; otherIndex < graph.tasks.length; otherIndex += 1) {
+            const left = graph.tasks[index];
+            const right = graph.tasks[otherIndex];
+            if (!left || !right) {
+                continue;
+            }
+            if (isSerialized(left.id, right.id, taskById, reachabilityCache)) {
+                continue;
+            }
+            const overlap = intersectFiles(left.scope.files, right.scope.files);
+            if (overlap.length === 0) {
+                continue;
+            }
+            if (left.scope.allow_shared_files && right.scope.allow_shared_files) {
+                warnings.push(`${left.id}/${right.id}: shared-file parallelism risk on ${overlap.join(', ')}`);
+                warnings.push(`${left.id}/${right.id}: consider consolidating shared-file tasks or serializing them explicitly`);
+                continue;
+            }
+            warnings.push(`${left.id}/${right.id}: overlapping implementation scope on ${overlap.join(', ')}`);
+            warnings.push(`${left.id}/${right.id}: consolidation or dependency serialization is recommended`);
+        }
+    }
+    return warnings;
+}
+function isSerialized(leftTaskId, rightTaskId, taskById, reachabilityCache) {
+    return (hasDependencyPath(leftTaskId, rightTaskId, taskById, reachabilityCache) ||
+        hasDependencyPath(rightTaskId, leftTaskId, taskById, reachabilityCache));
+}
+function hasDependencyPath(fromTaskId, toTaskId, taskById, reachabilityCache) {
+    return getReachableDependencies(fromTaskId, taskById, reachabilityCache).has(toTaskId);
+}
+function getReachableDependencies(taskId, taskById, reachabilityCache) {
+    const cached = reachabilityCache.get(taskId);
+    if (cached) {
+        return cached;
+    }
+    const task = taskById.get(taskId);
+    const reachable = new Set();
+    if (task) {
+        for (const dependencyId of task.dependencies) {
+            reachable.add(dependencyId);
+            for (const nestedDependencyId of getReachableDependencies(dependencyId, taskById, reachabilityCache)) {
+                reachable.add(nestedDependencyId);
+            }
+        }
+    }
+    reachabilityCache.set(taskId, reachable);
+    return reachable;
+}
+function intersectFiles(leftFiles, rightFiles) {
+    const rightSet = new Set(rightFiles);
+    const overlap = [];
+    for (const file of leftFiles) {
+        if (rightSet.has(file) && !overlap.includes(file)) {
+            overlap.push(file);
+        }
+    }
+    return overlap.sort();
+}
+function dedupe(values) {
+    return [...new Set(values)];
+}
+export function getDependentTaskIds(graph, taskId) {
+    const adj = buildDownstreamAdjacency(graph);
+    const visited = new Set();
+    const queue = [...(adj.get(taskId) ?? [])];
+    while (queue.length > 0) {
+        const current = queue.shift();
+        if (!current || visited.has(current))
+            continue;
+        visited.add(current);
+        for (const next of adj.get(current) ?? []) {
+            if (!visited.has(next))
+                queue.push(next);
+        }
+    }
+    return [...visited].sort();
+}
+export function getSkippableDescendantTaskIds(graph, taskId, states) {
+    return getDependentTaskIds(graph, taskId).filter((id) => {
+        const state = states.get(id) ?? 'pending';
+        const transitions = VALID_TASK_TRANSITIONS[state];
+        return transitions && transitions.includes('skipped');
+    });
+}
+export function getResettableSkippedTaskIds(graph, taskId, states) {
+    const taskMap = new Map(graph.tasks.map((t) => [t.id, t]));
+    return getDependentTaskIds(graph, taskId).filter((id) => {
+        if (states.get(id) !== 'skipped')
+            return false;
+        const task = taskMap.get(id);
+        if (!task)
+            return false;
+        return task.dependencies.every((depId) => {
+            if (depId === taskId)
+                return true;
+            const depState = states.get(depId) ?? 'pending';
+            return depState !== 'failed' && depState !== 'rejected' && depState !== 'skipped';
+        });
+    });
+}
+function buildDownstreamAdjacency(graph) {
+    const adj = new Map();
+    for (const task of graph.tasks) {
+        adj.set(task.id, []);
+    }
+    for (const task of graph.tasks) {
+        for (const dep of task.dependencies) {
+            adj.get(dep)?.push(task.id);
+        }
+    }
+    return adj;
+}
+//# sourceMappingURL=task-graph.js.map

package/dist/task-graph.js.map

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

package/dist/task-pipeline-helpers.d.ts

@@ -0,0 +1,45 @@
+import { type CheckpointName } from './checkpoint.js';
+import type { Task, TaskState, PricingConfig, BudgetConfig, ModelTier, FailureCategory } from './types.js';
+import type { Logger } from './logger.js';
+import type { WorkerResult } from './worker-runner.js';
+export declare class RetryBudgetExceededError extends Error {
+    readonly taskRetryConsumers: string[];
+    constructor(taskRetryConsumers: string[]);
+}
+export declare function tryTransition(stwRoot: string, runId: string, taskId: string, state: TaskState, updatedBy: string): void;
+export declare function archiveRetryAttemptArtifacts(taskDir: string, attemptNumber: number): void;
+export interface PrepareRetryContext {
+    task: Task;
+    worktreePath: string;
+    taskDir: string;
+    attempts: number;
+    stwRoot?: string;
+    runId?: string;
+    budget?: BudgetConfig;
+    log?: ReturnType<Logger['withTask']>;
+}
+export declare function prepareRetryWithDiagnostic(ctx: PrepareRetryContext, reason: string, diagnosticInput?: {
+    stderr: string;
+    stdout?: string;
+    diff?: string;
+}, failureCategory?: FailureCategory): Promise<{
+    retryReason: string;
+    currentCheckpoint: CheckpointName;
+    failureCategory?: FailureCategory;
+}>;
+export declare function transitionToRetrying(stwRoot?: string, runId?: string, taskId?: string): void;
+export interface RecordWorkerCostOptions {
+    stwRoot: string;
+    runId: string;
+    taskId: string;
+    workerResult: WorkerResult;
+    currentTier: ModelTier;
+    pricing: PricingConfig;
+    budget?: BudgetConfig;
+    log?: ReturnType<Logger['withTask']>;
+}
+export declare function recordWorkerCost(opts: RecordWorkerCostOptions): void;
+export declare function applyPreviousDiff(taskDir: string, worktreePath: string, attempt: number): {
+    applied: boolean;
+    warning?: string;
+};

package/dist/task-pipeline-helpers.js

@@ -0,0 +1,160 @@
+import { copyFileSync, existsSync, mkdirSync, readdirSync } from 'node:fs';
+import { execFileSync } from 'node:child_process';
+import { join } from 'node:path';
+import { writeTaskState, writeRunState } from './status.js';
+import { estimateCost, recordCost, checkBudget, checkRetryBudget, recordRetry } from './cost.js';
+import { analyzeDiagnostic } from './diagnostic.js';
+import { clearCheckpointsFrom } from './checkpoint.js';
+export class RetryBudgetExceededError extends Error {
+    taskRetryConsumers;
+    constructor(taskRetryConsumers) {
+        super('Run-level retry budget exceeded');
+        this.name = 'RetryBudgetExceededError';
+        this.taskRetryConsumers = taskRetryConsumers;
+    }
+}
+export function tryTransition(stwRoot, runId, taskId, state, updatedBy) {
+    try {
+        writeTaskState(stwRoot, runId, taskId, state, updatedBy);
+    }
+    catch (err) {
+        console.warn(`[tryTransition] Failed to write task state ${taskId} → ${state}: ${err instanceof Error ? err.message : String(err)}`);
+    }
+}
+export function archiveRetryAttemptArtifacts(taskDir, attemptNumber) {
+    const attemptDir = join(taskDir, 'attempts', String(attemptNumber));
+    mkdirSync(attemptDir, { recursive: true });
+    for (const artifactName of [
+        'diff.patch',
+        'diagnostic.json',
+        'worker_output_failure.json',
+        'response_raw.txt',
+        'response.json',
+        'agentic_run.json',
+        'agentic_summary.json',
+        'agentic_transcript.txt',
+        'agentic_prompt.md',
+        'agentic_stdout.txt',
+        'agentic_stderr.txt',
+        'agentic-subprocess.log',
+        'backend-shim.log',
+        'mechanical-review.json',
+        'acceptance-errors.txt',
+    ]) {
+        const artifactPath = join(taskDir, artifactName);
+        if (existsSync(artifactPath)) {
+            copyFileSync(artifactPath, join(attemptDir, artifactName));
+        }
+    }
+}
+export async function prepareRetryWithDiagnostic(ctx, reason, diagnosticInput, failureCategory) {
+    const { task, worktreePath, taskDir, attempts, stwRoot, runId, budget, log } = ctx;
+    if (stwRoot && runId) {
+        const retryBudgetResult = checkRetryBudget(stwRoot, runId, { budget });
+        if (retryBudgetResult.status === 'exceeded') {
+            log?.warn('Run-level retry budget exceeded, pausing run', {
+                totalRetries: retryBudgetResult.totalRetries,
+                runRetryBudget: retryBudgetResult.runRetryBudget,
+                taskRetryConsumers: retryBudgetResult.taskRetryConsumers,
+            });
+            writeRunState(stwRoot, runId, 'paused', { pause_reason: 'retry_budget_exceeded' });
+            throw new RetryBudgetExceededError(retryBudgetResult.taskRetryConsumers ?? []);
+        }
+        recordRetry(stwRoot, runId, task.id);
+        tryTransition(stwRoot, runId, task.id, 'diagnosing', 'task-executor');
+    }
+    if (diagnosticInput) {
+        try {
+            await analyzeDiagnostic({
+                task,
+                cwd: worktreePath,
+                stderr: diagnosticInput.stderr,
+                stdout: diagnosticInput.stdout,
+                diff: diagnosticInput.diff,
+                artifactDir: taskDir,
+            });
+        }
+        catch (error) {
+            ctx.log?.warn('Diagnostic analysis failed', {
+                error: error instanceof Error ? error.message : String(error),
+            });
+        }
+    }
+    archiveRetryAttemptArtifacts(taskDir, attempts);
+    transitionToRetrying(stwRoot, runId, task.id);
+    clearCheckpointsFrom(taskDir, 'pre_worker');
+    return { retryReason: reason, currentCheckpoint: 'pre_worker', failureCategory };
+}
+export function transitionToRetrying(stwRoot, runId, taskId) {
+    if (stwRoot && runId && taskId) {
+        tryTransition(stwRoot, runId, taskId, 'retrying', 'task-executor');
+        tryTransition(stwRoot, runId, taskId, 'working', 'task-executor');
+    }
+}
+export function recordWorkerCost(opts) {
+    const { stwRoot, runId, taskId, workerResult, currentTier, pricing, budget, log } = opts;
+    const actualModel = workerResult.model ?? currentTier;
+    const costUsd = estimateCost(pricing, actualModel, workerResult.token_usage.input_tokens, workerResult.token_usage.output_tokens);
+    try {
+        recordCost(stwRoot, runId, taskId, {
+            task_id: taskId,
+            model: workerResult.model,
+            provider: 'unknown',
+            input_tokens: workerResult.token_usage.input_tokens,
+            output_tokens: workerResult.token_usage.output_tokens,
+            cost_usd: costUsd,
+            tier: currentTier,
+            latency_ms: workerResult.latency_ms,
+        });
+        log?.info('Cost recorded', { cost_usd: costUsd, model: currentTier });
+    }
+    catch (error) {
+        log?.warn('Failed to record cost', {
+            error: error instanceof Error ? error.message : String(error),
+            cost_usd: costUsd,
+        });
+    }
+    if (budget) {
+        const budgetResult = checkBudget(stwRoot, runId, taskId, { budget });
+        if (budgetResult.status === 'exceeded' && budgetResult.action === 'pause') {
+            log?.warn('Budget exceeded, pausing run', {
+                totalCost: budgetResult.totalCost,
+                runBudget: budgetResult.runBudget,
+            });
+            writeRunState(stwRoot, runId, 'paused', { pause_reason: 'budget_exceeded' });
+        }
+        else if (budgetResult.status === 'warning') {
+            log?.warn('Budget warning', {
+                totalCost: budgetResult.totalCost,
+                runBudget: budgetResult.runBudget,
+            });
+        }
+    }
+}
+export function applyPreviousDiff(taskDir, worktreePath, attempt) {
+    const attemptsDir = join(taskDir, 'attempts');
+    if (!existsSync(attemptsDir)) {
+        return { applied: false };
+    }
+    const entries = readdirSync(attemptsDir, { withFileTypes: true });
+    const attemptNumbers = entries
+        .filter((e) => e.isDirectory())
+        .map((e) => parseInt(e.name, 10))
+        .filter((n) => !isNaN(n) && n < attempt);
+    if (attemptNumbers.length === 0) {
+        return { applied: false };
+    }
+    const latestAttempt = attemptNumbers.length > 0 ? Math.max(...attemptNumbers) : 0;
+    const patchPath = join(attemptsDir, String(latestAttempt), 'diff.patch');
+    if (!existsSync(patchPath)) {
+        return { applied: false };
+    }
+    try {
+        execFileSync('git', ['apply', '--3way', patchPath], { cwd: worktreePath });
+        return { applied: true };
+    }
+    catch {
+        return { applied: false, warning: 'Previous diff could not be applied cleanly' };
+    }
+}
+//# sourceMappingURL=task-pipeline-helpers.js.map

package/dist/task-pipeline-helpers.js.map

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

package/dist/task-review.d.ts

@@ -0,0 +1,51 @@
+import { type CheckpointName } from './checkpoint.js';
+import type { WorkerResult } from './worker-runner.js';
+import type { Task, TaskState, StwConfig, PricingConfig, ModelTier, PhaseChangeState } from './types.js';
+import type { Logger } from './logger.js';
+export interface ReviewContext {
+    task: Task;
+    config: StwConfig;
+    workerResult: WorkerResult;
+    worktreePath: string;
+    taskDir: string;
+    runBranch: string;
+    currentTier: ModelTier;
+    consecutiveRejects: number;
+    attempts: number;
+    maxAttempts: number;
+    totalTokens: {
+        input_tokens: number;
+        output_tokens: number;
+    };
+    stwRoot?: string;
+    runId?: string;
+    log?: Logger;
+    pricing?: PricingConfig;
+    onPhaseChange?: (taskId: string, phase: string, state: PhaseChangeState) => void;
+    tryTransition: (stwRoot: string, runId: string, taskId: string, state: TaskState, updatedBy: string) => void;
+}
+export interface DiagnosticInput {
+    stderr: string;
+    stdout?: string;
+    diff?: string;
+}
+export type ReviewPhaseOutcome = {
+    type: 'complete';
+} | {
+    type: 'terminal';
+    finalState: 'escalated' | 'rejected';
+} | {
+    type: 'retry';
+    reason: string;
+    diagnosticInput?: DiagnosticInput;
+    escalateTo?: ModelTier;
+    resetAttempts: boolean;
+    resetRejects: boolean;
+    incrementRejects?: boolean;
+    transitionState?: TaskState;
+};
+export declare function checkpointNotDone(current: CheckpointName, target: CheckpointName): boolean;
+export declare function runReviewPhase(ctx: ReviewContext, currentCheckpoint: CheckpointName): Promise<{
+    outcome: ReviewPhaseOutcome;
+    nextCheckpoint: CheckpointName;
+}>;