@mknightzzz/stw 0.1.0

package/dist/status.js

@@ -0,0 +1,261 @@
+import { unlinkSync } from 'node:fs';
+import { randomUUID } from 'node:crypto';
+import { join } from 'node:path';
+import { getRunLockState } from './lock.js';
+import { fileExists, readJson, runDir, taskDir, writeJson } from './storage.js';
+import { TransitionError, validateRunTransition, validateTaskTransition } from './transitions.js';
+import { loadCosts } from './cost.js';
+function runEventsPath(stwRoot, runId) {
+    return join(runDir(stwRoot, runId), 'events.json');
+}
+function runMetricsPath(stwRoot, runId) {
+    return join(runDir(stwRoot, runId), 'metrics.json');
+}
+export function writeTaskStatus(stwRoot, runId, taskId, input) {
+    const status = {
+        schema_version: 1,
+        task_id: taskId,
+        agent_id: input.agent_id,
+        status: input.status,
+        completed_at: new Date().toISOString(),
+        notes: input.notes,
+        question_number: input.question_number,
+        preserved_worktree_path: input.preserved_worktree_path,
+        preserved_worktree_paths: input.preserved_worktree_paths,
+        stop_reason: input.stop_reason,
+        stopped_at: input.stopped_at,
+        stopped_by: input.stopped_by,
+        execution_mode: input.execution_mode,
+        failure_class: input.failure_class,
+    };
+    writeJson(join(taskDir(stwRoot, runId, taskId), 'status.json'), status);
+    return status;
+}
+export function readTaskStatus(stwRoot, runId, taskId) {
+    const statusPath = join(taskDir(stwRoot, runId, taskId), 'status.json');
+    if (!fileExists(statusPath)) {
+        return null;
+    }
+    return readJson(statusPath);
+}
+export function writeTaskState(stwRoot, runId, taskId, state, updatedBy) {
+    const statePath = join(taskDir(stwRoot, runId, taskId), 'state.json');
+    const currentRecord = fileExists(statePath) ? readJson(statePath) : null;
+    const from = currentRecord?.state ?? 'pending';
+    if (!validateTaskTransition(from, state)) {
+        throw new TransitionError(from, state, 'task');
+    }
+    const record = {
+        schema_version: 1,
+        task_id: taskId,
+        state,
+        updated_at: new Date().toISOString(),
+        updated_by: updatedBy,
+        previous_state: currentRecord?.state ?? null,
+    };
+    writeJson(statePath, record);
+    return record;
+}
+export function writeRunState(stwRoot, runId, state, options) {
+    const manifestPath = join(runDir(stwRoot, runId), 'manifest.json');
+    const manifest = readJson(manifestPath);
+    if (!validateRunTransition(manifest.status, state)) {
+        throw new TransitionError(manifest.status, state, 'run');
+    }
+    manifest.status = state;
+    if (state === 'paused') {
+        if (options?.pause_reason) {
+            manifest.pause_reason = options.pause_reason;
+        }
+        if (options?.drift_detected !== undefined) {
+            manifest.drift_detected = options.drift_detected;
+        }
+    }
+    else {
+        delete manifest.pause_reason;
+        delete manifest.drift_detected;
+    }
+    writeJson(manifestPath, manifest);
+    return manifest;
+}
+export function readRunStatus(stwRoot, runId, taskIds) {
+    const summary = {};
+    for (const taskId of taskIds) {
+        summary[taskId] = readTaskStatus(stwRoot, runId, taskId)?.status ?? 'pending';
+    }
+    return summary;
+}
+export function readTaskState(stwRoot, runId, taskId) {
+    const statePath = join(taskDir(stwRoot, runId, taskId), 'state.json');
+    if (!fileExists(statePath)) {
+        return null;
+    }
+    return readJson(statePath);
+}
+export function buildRunRecoveryReport(stwRoot, runId, taskIds) {
+    const manifestPath = join(runDir(stwRoot, runId), 'manifest.json');
+    const manifest = readJson(manifestPath);
+    const lockState = getRunLockState(stwRoot, runId);
+    const staleTasks = taskIds
+        .map((taskId) => {
+        const taskStatus = readTaskStatus(stwRoot, runId, taskId);
+        if (!taskStatus || taskStatus.status !== 'in_progress') {
+            return null;
+        }
+        return {
+            taskId,
+            taskStatus,
+            taskState: readTaskState(stwRoot, runId, taskId),
+        };
+    })
+        .filter((entry) => entry !== null);
+    const persistedInProgressWithoutLiveLock = staleTasks.length > 0 && !lockState.hasLiveLock;
+    const staleLock = lockState.hasStaleLock;
+    const stale = staleLock || persistedInProgressWithoutLiveLock;
+    const reason = staleLock
+        ? 'stale_lock'
+        : persistedInProgressWithoutLiveLock
+            ? 'persisted_in_progress_without_live_lock'
+            : 'none';
+    const guidance = [];
+    if (staleLock) {
+        guidance.push(`Lock file for run ${runId} is stale. Inspect status output, then run 'stw unlock' before retrying or resuming if recovery is confirmed.`);
+        guidance.push(`A stale lock is advisory recovery evidence; no run or task files have been rewritten automatically.`);
+    }
+    if (persistedInProgressWithoutLiveLock) {
+        guidance.push(`Run ${runId} has persisted task status marked in_progress but no live lock for this run. Treat this as an interrupted run.`);
+        guidance.push(`Inspect the affected task directories and checkpoints before making any manual changes.`);
+        guidance.push(`Status output should be treated as advisory stale-state reporting only; no automatic status mutation has been applied.`);
+        guidance.push(`Use 'stw retry ${runId} <task-id>' to requeue a failed/escalated task, or 'stw resume ${runId} [task-id]' if checkpoint recovery is appropriate.`);
+        guidance.push(`If a stale lock file is still present for this run, run 'stw unlock' after confirming the prior worker is dead.`);
+        guidance.push(`Do not rewrite status files automatically; operator confirmation is required.`);
+    }
+    return {
+        manifest,
+        stale,
+        reason,
+        staleTasks,
+        guidance,
+    };
+}
+export function readRunEvents(stwRoot, runId) {
+    const path = runEventsPath(stwRoot, runId);
+    if (!fileExists(path)) {
+        return {
+            schema_version: 1,
+            run_id: runId,
+            events: [],
+        };
+    }
+    return readJson(path);
+}
+export function recordRunEvent(stwRoot, runId, input) {
+    const artifact = readRunEvents(stwRoot, runId);
+    const event = {
+        schema_version: 1,
+        event_id: randomUUID(),
+        run_id: runId,
+        event_type: input.event_type,
+        created_at: new Date().toISOString(),
+        actor: input.actor,
+        task_id: input.task_id,
+        summary: input.summary,
+        details: input.details,
+        escalation_category: input.escalation_category,
+        metadata: input.metadata,
+    };
+    artifact.events.push(event);
+    writeJson(runEventsPath(stwRoot, runId), artifact);
+    return event;
+}
+export function readRunMetrics(stwRoot, runId) {
+    const path = runMetricsPath(stwRoot, runId);
+    if (!fileExists(path)) {
+        return null;
+    }
+    return readJson(path);
+}
+export function writeRunMetrics(stwRoot, runId, input) {
+    const artifact = {
+        schema_version: 1,
+        run_id: runId,
+        machine: input.machine,
+        operator: input.operator,
+        updated_at: new Date().toISOString(),
+    };
+    writeJson(runMetricsPath(stwRoot, runId), artifact);
+    return artifact;
+}
+export function resetTaskToPending(stwRoot, runId, taskId) {
+    const statePath = join(taskDir(stwRoot, runId, taskId), 'state.json');
+    if (fileExists(statePath)) {
+        unlinkSync(statePath);
+    }
+}
+export function markTaskSkipped(stwRoot, runId, taskId, reason) {
+    const agentId = 'system';
+    const statePath = join(taskDir(stwRoot, runId, taskId), 'state.json');
+    const currentRecord = readTaskState(stwRoot, runId, taskId);
+    const record = {
+        schema_version: 1,
+        task_id: taskId,
+        state: 'skipped',
+        updated_at: new Date().toISOString(),
+        updated_by: agentId,
+        previous_state: currentRecord?.state ?? null,
+    };
+    writeJson(statePath, record);
+    writeTaskStatus(stwRoot, runId, taskId, {
+        agent_id: agentId,
+        status: 'skipped',
+        notes: reason,
+    });
+}
+export function markTaskComplete(stwRoot, runId, taskId) {
+    const agentId = 'system';
+    const statePath = join(taskDir(stwRoot, runId, taskId), 'state.json');
+    const currentRecord = readTaskState(stwRoot, runId, taskId);
+    const record = {
+        schema_version: 1,
+        task_id: taskId,
+        state: 'complete',
+        updated_at: new Date().toISOString(),
+        updated_by: agentId,
+        previous_state: currentRecord?.state ?? null,
+    };
+    writeJson(statePath, record);
+    writeTaskStatus(stwRoot, runId, taskId, {
+        agent_id: agentId,
+        status: 'complete',
+        notes: '',
+    });
+}
+export function getStatusData(stwRoot, runId) {
+    const manifestPath = join(runDir(stwRoot, runId), 'manifest.json');
+    const manifest = readJson(manifestPath);
+    const graphPath = join(runDir(stwRoot, runId), 'task_graph.json');
+    const graph = readJson(graphPath);
+    const costs = loadCosts(stwRoot, runId);
+    const tasks = graph.tasks.map((task) => {
+        const taskStatus = readTaskStatus(stwRoot, runId, task.id);
+        const taskCost = costs?.task_costs[task.id];
+        return {
+            id: task.id,
+            description: task.description,
+            task_type: task.task_type,
+            state: task.state,
+            status: taskStatus?.status ?? null,
+            agent_id: taskStatus?.agent_id ?? null,
+            notes: taskStatus?.notes ?? null,
+            completed_at: taskStatus?.completed_at ?? null,
+            cost_usd: taskCost ?? null,
+        };
+    });
+    return {
+        runId,
+        manifest,
+        tasks,
+        total_cost_usd: costs?.total_cost_usd ?? 0,
+    };
+}
+//# sourceMappingURL=status.js.map

package/dist/status.js.map

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

package/dist/storage.d.ts

@@ -0,0 +1,9 @@
+export declare function ensureDir(dir: string): void;
+export declare function writeAtomic(filePath: string, data: string): void;
+export declare function writeJson(filePath: string, obj: unknown): void;
+export declare function readJson<T>(filePath: string): T;
+export declare function readText(filePath: string): string;
+export declare function fileExists(filePath: string): boolean;
+export declare function runDir(stwRoot: string, runId: string): string;
+export declare function taskDir(stwRoot: string, runId: string, taskId: string): string;
+export declare function pollerCheckpointPath(stwRoot: string, runId: string, mrIid: number | string): string;

package/dist/storage.js

@@ -0,0 +1,35 @@
+import { mkdirSync, writeFileSync, readFileSync, renameSync, existsSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { randomUUID } from 'node:crypto';
+export function ensureDir(dir) {
+    mkdirSync(dir, { recursive: true });
+}
+export function writeAtomic(filePath, data) {
+    ensureDir(dirname(filePath));
+    const tmp = filePath + '.tmp.' + randomUUID().slice(0, 8);
+    writeFileSync(tmp, data, 'utf-8');
+    renameSync(tmp, filePath);
+}
+export function writeJson(filePath, obj) {
+    writeAtomic(filePath, JSON.stringify(obj, null, 2) + '\n');
+}
+export function readJson(filePath) {
+    const raw = readFileSync(filePath, 'utf-8');
+    return JSON.parse(raw);
+}
+export function readText(filePath) {
+    return readFileSync(filePath, 'utf-8');
+}
+export function fileExists(filePath) {
+    return existsSync(filePath);
+}
+export function runDir(stwRoot, runId) {
+    return join(stwRoot, 'runs', runId);
+}
+export function taskDir(stwRoot, runId, taskId) {
+    return join(stwRoot, 'runs', runId, 'tasks', taskId);
+}
+export function pollerCheckpointPath(stwRoot, runId, mrIid) {
+    return join(runDir(stwRoot, runId), 'gitlab', `mr-${mrIid}-poller-checkpoint.json`);
+}
+//# sourceMappingURL=storage.js.map

package/dist/storage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.js","sourceRoot":"","sources":["../src/storage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,YAAY,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACzF,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,MAAM,UAAU,SAAS,CAAC,GAAW;IACnC,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;AACtC,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,QAAgB,EAAE,IAAY;IACxD,SAAS,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC7B,MAAM,GAAG,GAAG,QAAQ,GAAG,OAAO,GAAG,UAAU,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAC1D,aAAa,CAAC,GAAG,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;IAClC,UAAU,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;AAC5B,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,QAAgB,EAAE,GAAY;IACtD,WAAW,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;AAC7D,CAAC;AAED,MAAM,UAAU,QAAQ,CAAI,QAAgB;IAC1C,MAAM,GAAG,GAAG,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC5C,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAM,CAAC;AAC9B,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,QAAgB;IACvC,OAAO,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;AACzC,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,QAAgB;IACzC,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC;AAC9B,CAAC;AAED,MAAM,UAAU,MAAM,CAAC,OAAe,EAAE,KAAa;IACnD,OAAO,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;AACtC,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,OAAe,EAAE,KAAa,EAAE,MAAc;IACpE,OAAO,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;AACvD,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,OAAe,EAAE,KAAa,EAAE,KAAsB;IACzF,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,EAAE,QAAQ,EAAE,MAAM,KAAK,yBAAyB,CAAC,CAAC;AACtF,CAAC"}

package/dist/task-executor-completion.d.ts

@@ -0,0 +1,12 @@
+import type { Logger } from './logger.js';
+import type { ExecuteTaskResult } from './task-executor.js';
+export declare function finalizeTaskResult(input: {
+    taskId: string;
+    taskDescription: string;
+    runBranch: string;
+    repoRoot: string;
+    worktreePath: string;
+    taskDir: string;
+    result: ExecuteTaskResult;
+    logger?: Logger;
+}): ExecuteTaskResult;

package/dist/task-executor-completion.js

@@ -0,0 +1,67 @@
+import { execFileSync } from 'node:child_process';
+import { existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { applyPatchToBranch } from './git-utils.js';
+import { cleanupWorktree } from './worktree.js';
+export function finalizeTaskResult(input) {
+    const { taskId, taskDescription, runBranch, repoRoot, worktreePath, taskDir, result, logger } = input;
+    if (result.finalState === 'complete') {
+        const gitOpts = { cwd: worktreePath, encoding: 'utf-8', stdio: 'pipe' };
+        try {
+            execFileSync('git', ['add', '-A'], gitOpts);
+            execFileSync('git', ['commit', '--allow-empty', '-m', `feat(${taskId}): ${taskDescription}`], gitOpts);
+            const taskBranch = `${runBranch}-${taskId}`;
+            execFileSync('git', ['fetch', '.', `${taskBranch}:${runBranch}`], {
+                cwd: repoRoot,
+                encoding: 'utf-8',
+                stdio: 'pipe',
+            });
+            logger?.info('Task output committed and merged to run branch', {
+                execution_mode: result.executionMode,
+                failure_class: result.failureClass,
+            });
+        }
+        catch (err) {
+            logger?.warn('Failed to commit/merge task output', {
+                error: err instanceof Error ? err.message : String(err),
+            });
+        }
+        const patchPath = join(taskDir, 'diff.patch');
+        if (existsSync(patchPath)) {
+            const applyResult = applyPatchToBranch({
+                repoRoot,
+                branch: runBranch,
+                patchPath,
+                commitMessage: `stw(${taskId}): apply task changes`,
+            });
+            if (applyResult.success) {
+                logger?.info('Applied task diff to run branch');
+            }
+            else {
+                logger?.warn('Failed to apply task diff to run branch', {
+                    error: applyResult.error,
+                });
+            }
+        }
+        cleanupWorktree(worktreePath, repoRoot);
+        try {
+            execFileSync('git', ['branch', '-D', `${runBranch}-${taskId}`], {
+                cwd: repoRoot,
+                encoding: 'utf-8',
+                stdio: 'pipe',
+            });
+        }
+        catch {
+            // Branch already gone.
+        }
+        return result;
+    }
+    result.preservedWorktreePath = worktreePath;
+    logger?.info('Worktree preserved for inspection', {
+        worktreePath,
+        execution_mode: result.executionMode,
+        failure_class: result.failureClass,
+    });
+    return result;
+}
+//# sourceMappingURL=task-executor-completion.js.map

package/dist/task-executor-completion.js.map

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

package/dist/task-executor-fallback.d.ts

@@ -0,0 +1,20 @@
+import type { StwConfig, Task } from './types.js';
+export declare function maybeSwitchToAgenticFallback(input: {
+    effectiveTask: Task;
+    config: StwConfig;
+    usedAgenticFallback: boolean;
+    retryReasonMessage: string;
+    diagnosticInput?: {
+        stderr: string;
+        stdout?: string;
+        diff?: string;
+    };
+    setEffectiveTask: (task: Task) => void;
+    markUsed: () => void;
+    resetAttempts: () => void;
+    doRetry: (reason: string, diagnosticInput?: {
+        stderr: string;
+        stdout?: string;
+        diff?: string;
+    }) => Promise<void>;
+}): Promise<boolean>;

package/dist/task-executor-fallback.js

@@ -0,0 +1,12 @@
+import { buildAgenticFallbackTask, shouldFallbackToAgentic } from './agentic-fallback.js';
+export async function maybeSwitchToAgenticFallback(input) {
+    if (input.usedAgenticFallback || !shouldFallbackToAgentic(input.effectiveTask, input.config)) {
+        return false;
+    }
+    input.setEffectiveTask(buildAgenticFallbackTask(input.effectiveTask, input.config));
+    input.markUsed();
+    input.resetAttempts();
+    await input.doRetry(input.retryReasonMessage, input.diagnosticInput);
+    return true;
+}
+//# sourceMappingURL=task-executor-fallback.js.map

package/dist/task-executor-fallback.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-executor-fallback.js","sourceRoot":"","sources":["../src/task-executor-fallback.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAG1F,MAAM,CAAC,KAAK,UAAU,4BAA4B,CAAC,KAUlD;IACC,IAAI,KAAK,CAAC,mBAAmB,IAAI,CAAC,uBAAuB,CAAC,KAAK,CAAC,aAAa,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC;QAC7F,OAAO,KAAK,CAAC;IACf,CAAC;IAED,KAAK,CAAC,gBAAgB,CAAC,wBAAwB,CAAC,KAAK,CAAC,aAAa,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;IACpF,KAAK,CAAC,QAAQ,EAAE,CAAC;IACjB,KAAK,CAAC,aAAa,EAAE,CAAC;IACtB,MAAM,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,kBAAkB,EAAE,KAAK,CAAC,eAAe,CAAC,CAAC;IACrE,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/task-executor.d.ts

@@ -0,0 +1,34 @@
+import { type ActionableFailureClass, type ExecutionObservabilityMode, type Task, type StwConfig, type PricingConfig, type BudgetConfig, type PhaseChangeState } from './types.js';
+import type { Logger } from './logger.js';
+export interface ExecuteTaskOptions {
+    taskDir: string;
+    repoRoot: string;
+    runBranch: string;
+    resume?: boolean;
+    stwRoot?: string;
+    runId?: string;
+    logger?: Logger;
+    pricing?: PricingConfig;
+    budget?: BudgetConfig;
+    onPhaseChange?: (taskId: string, phase: string, state: PhaseChangeState) => void;
+    stopCheck?: () => boolean;
+    verbose?: boolean;
+    deferMerge?: boolean;
+    greenfield?: boolean;
+    seedDir?: string;
+}
+export interface ExecuteTaskResult {
+    finalState: 'complete' | 'escalated' | 'rejected' | 'stopped';
+    attempts: number;
+    totalTokens: {
+        input_tokens: number;
+        output_tokens: number;
+    };
+    preservedWorktreePath?: string;
+    worktreePath?: string;
+    taskBranch?: string;
+    executionMode?: ExecutionObservabilityMode;
+    failureClass?: ActionableFailureClass;
+    events?: string[];
+}
+export declare function executeTask(task: Task, config: StwConfig, options: ExecuteTaskOptions): Promise<ExecuteTaskResult>;