@mknightzzz/stw 0.1.0

package/dist/commands/execution.js

@@ -0,0 +1,327 @@
+import { readdirSync, cpSync, mkdirSync } from 'node:fs';
+import { join } from 'node:path';
+import { unlinkSync } from 'node:fs';
+import { loadConfig } from '../config.js';
+import { getResettableSkippedTaskIds } from '../task-graph.js';
+import { buildRunRecoveryReport, readTaskStatus, recordRunEvent, writeRunState, writeTaskStatus } from '../status.js';
+import { readJson, writeJson, writeAtomic, fileExists, runDir, taskDir, ensureDir } from '../storage.js';
+import { executeTask } from '../task-executor.js';
+import { clearCheckpointsFrom } from '../checkpoint.js';
+import { acquireLock, releaseLock } from '../lock.js';
+import { createLogger } from '../logger.js';
+import { claimTask } from '../claim.js';
+import { getStwRoot } from './helpers.js';
+const STOPPABLE_RUN_STATES = new Set(['running', 'pending', 'planning', 'routing']);
+const RETRYABLE_RUN_STATES = new Set(['paused', 'human_review_required', 'running']);
+const RETRYABLE_TASK_STATUSES = new Set(['escalated', 'failed', 'skipped']);
+function findCheckpointTask(stwRoot, runId, tasks) {
+    for (const task of tasks) {
+        const status = readTaskStatus(stwRoot, runId, task.id);
+        const hasStatus = status && !['complete', 'blocked', 'failed', 'escalated'].includes(status.status);
+        if (!status || hasStatus) {
+            const td = taskDir(stwRoot, runId, task.id);
+            if (fileExists(join(td, 'checkpoints'))) {
+                return task.id;
+            }
+        }
+    }
+    return null;
+}
+function archiveCurrentAttempt(td) {
+    if (!fileExists(td)) {
+        return;
+    }
+    const candidateNames = [
+        'status.json',
+        'state.json',
+        'question.json',
+        'response_raw.txt',
+        'checkpoints',
+        'diagnostic.json',
+        'validation.json',
+        'review.json',
+    ];
+    const existing = candidateNames.filter((name) => fileExists(join(td, name)));
+    const answerFiles = safeListAnswerFiles(td);
+    const filesToArchive = [...existing, ...answerFiles];
+    if (filesToArchive.length === 0) {
+        return;
+    }
+    const attemptsDir = join(td, 'attempts');
+    ensureDir(attemptsDir);
+    const attemptNumber = getNextAttemptNumber(attemptsDir);
+    const archiveDir = join(attemptsDir, String(attemptNumber));
+    mkdirSync(archiveDir, { recursive: true });
+    for (const name of filesToArchive) {
+        cpSync(join(td, name), join(archiveDir, name), { recursive: true });
+    }
+}
+function safeListAnswerFiles(td) {
+    try {
+        return readdirSync(td, { withFileTypes: true })
+            .filter((entry) => entry.isFile() && /^answer-\d+\.json$/.test(entry.name))
+            .map((entry) => entry.name)
+            .sort();
+    }
+    catch {
+        return [];
+    }
+}
+function getNextAttemptNumber(attemptsDir) {
+    let max = 0;
+    try {
+        for (const entry of readdirSync(attemptsDir, { withFileTypes: true })) {
+            if (!entry.isDirectory())
+                continue;
+            const value = Number.parseInt(entry.name, 10);
+            if (Number.isFinite(value) && value > max) {
+                max = value;
+            }
+        }
+    }
+    catch { }
+    return max + 1;
+}
+function deleteStaleTaskFiles(td) {
+    const filesToDelete = ['status.json', 'state.json', 'claim.lock'];
+    for (const name of filesToDelete) {
+        const filePath = join(td, name);
+        try {
+            unlinkSync(filePath);
+        }
+        catch { }
+    }
+}
+function reportInterruptedRunIfDetected(stwRoot, runId, graph) {
+    const report = buildRunRecoveryReport(stwRoot, runId, graph.tasks.map((task) => task.id));
+    if (!report.stale) {
+        return;
+    }
+    console.error(`Interrupted run detected for ${runId}.`);
+    if (report.reason === 'stale_lock') {
+        console.error('Primary signal: stale lock file for this run.');
+    }
+    if (report.reason === 'persisted_in_progress_without_live_lock') {
+        console.error('Primary signal: persisted in_progress task status without a live lock for this run.');
+    }
+    if (report.staleTasks.length > 0) {
+        console.error(`Affected tasks: ${report.staleTasks.map((task) => `${task.taskId}${task.taskState ? ` (${task.taskState.state})` : ''}`).join(', ')}`);
+    }
+    for (const line of report.guidance) {
+        console.error(`Guidance: ${line}`);
+    }
+}
+function mapExecutionResultToStatus(finalState) {
+    switch (finalState) {
+        case 'complete':
+            return 'complete';
+        case 'escalated':
+            return 'escalated';
+        case 'rejected':
+            return 'failed';
+        case 'stopped':
+            return 'escalated';
+    }
+}
+export function registerExecutionCommands(program) {
+    program
+        .command('stop <run-id>')
+        .description('Stop a running run and transition to paused')
+        .action((runId) => {
+        const stwRoot = getStwRoot();
+        const manifestPath = join(runDir(stwRoot, runId), 'manifest.json');
+        if (!fileExists(manifestPath)) {
+            console.error(`Run not found: ${runId}`);
+            process.exit(1);
+        }
+        const manifest = readJson(manifestPath);
+        if (!STOPPABLE_RUN_STATES.has(manifest.status)) {
+            console.error(`Cannot stop run in state: ${manifest.status}`);
+            process.exit(1);
+        }
+        const sentinelPath = join(runDir(stwRoot, runId), 'STOP');
+        writeAtomic(sentinelPath, `stopped_at=${new Date().toISOString()}\n`);
+        writeRunState(stwRoot, runId, 'paused', { pause_reason: 'manual' });
+        recordRunEvent(stwRoot, runId, {
+            event_type: 'stop',
+            actor: 'human',
+            summary: 'Run manually stopped',
+            details: 'STOP sentinel written and run paused',
+        });
+        releaseLock(stwRoot);
+        const graphPath = join(runDir(stwRoot, runId), 'task_graph.json');
+        if (fileExists(graphPath)) {
+            const graph = readJson(graphPath);
+            const inProgress = graph.tasks.filter((t) => {
+                const st = readTaskStatus(stwRoot, runId, t.id);
+                return st && !['complete', 'failed', 'escalated', 'skipped'].includes(st.status);
+            });
+            if (inProgress.length > 0) {
+                console.log(`In-progress tasks: ${inProgress.map((t) => t.id).join(', ')}`);
+            }
+        }
+        console.log(`Run ${runId} stopped (paused)`);
+    });
+    program
+        .command('retry <run-id> <task-id>')
+        .description('Reset a failed/escalated task for re-execution')
+        .option('--tier <tier>', 'Override model tier for retry')
+        .action((runId, taskIdArg, opts) => {
+        const stwRoot = getStwRoot();
+        const manifestPath = join(runDir(stwRoot, runId), 'manifest.json');
+        if (!fileExists(manifestPath)) {
+            console.error(`Run not found: ${runId}`);
+            process.exit(1);
+        }
+        const manifest = readJson(manifestPath);
+        if (!RETRYABLE_RUN_STATES.has(manifest.status)) {
+            console.error(`Cannot retry in run state: ${manifest.status}. Must be paused or human_review_required.`);
+            process.exit(1);
+        }
+        const taskStatus = readTaskStatus(stwRoot, runId, taskIdArg);
+        if (!taskStatus) {
+            console.error(`No status found for task ${taskIdArg}`);
+            process.exit(1);
+        }
+        if (!RETRYABLE_TASK_STATUSES.has(taskStatus.status)) {
+            console.error(`Task ${taskIdArg} is ${taskStatus.status}, not retryable`);
+            process.exit(1);
+        }
+        const td = taskDir(stwRoot, runId, taskIdArg);
+        archiveCurrentAttempt(td);
+        deleteStaleTaskFiles(td);
+        clearCheckpointsFrom(td, 'pre_worker');
+        const graphPath = join(runDir(stwRoot, runId), 'task_graph.json');
+        if (fileExists(graphPath)) {
+            const graph = readJson(graphPath);
+            if (opts.tier) {
+                const task = graph.tasks.find((t) => t.id === taskIdArg);
+                if (task) {
+                    task.model_tier = opts.tier;
+                    writeJson(graphPath, graph);
+                }
+            }
+            const currentStates = new Map();
+            for (const t of graph.tasks) {
+                const st = readTaskStatus(stwRoot, runId, t.id);
+                currentStates.set(t.id, st?.status ?? 'pending');
+            }
+            currentStates.set(taskIdArg, 'pending');
+            const toReset = getResettableSkippedTaskIds(graph, taskIdArg, currentStates);
+            for (const resetId of toReset) {
+                const resetTd = taskDir(stwRoot, runId, resetId);
+                archiveCurrentAttempt(resetTd);
+                deleteStaleTaskFiles(resetTd);
+            }
+            if (toReset.length > 0) {
+                console.log(`Un-skipped ${toReset.length} downstream task(s): ${toReset.join(', ')}`);
+            }
+        }
+        const sentinelPath = join(runDir(stwRoot, runId), 'STOP');
+        try {
+            unlinkSync(sentinelPath);
+        }
+        catch { }
+        writeRunState(stwRoot, runId, 'running');
+        recordRunEvent(stwRoot, runId, {
+            event_type: 'retry',
+            actor: 'human',
+            task_id: taskIdArg,
+            summary: 'Task reset for retry',
+            details: opts.tier ? `Tier override: ${opts.tier}` : undefined,
+        });
+        console.log(`Task ${taskIdArg} reset for retry. Run 'stw run ${runId}' to re-execute.`);
+    });
+    program
+        .command('resume <run-id> [task-id]')
+        .description('Resume a task from its last checkpoint')
+        .action(async (runId, taskId) => {
+        const stwRoot = getStwRoot();
+        const runRoot = join(stwRoot, 'runs', runId);
+        const manifestPath = join(runRoot, 'manifest.json');
+        const graphPath = join(runRoot, 'task_graph.json');
+        if (!fileExists(graphPath)) {
+            console.error(`No task graph found for run ${runId}`);
+            process.exit(1);
+        }
+        if (!fileExists(manifestPath)) {
+            console.error(`Run not found: ${runId}`);
+            process.exit(1);
+        }
+        const manifest = readJson(manifestPath);
+        const graph = readJson(graphPath);
+        const config = loadConfig(join(stwRoot, 'config.yml'));
+        reportInterruptedRunIfDetected(stwRoot, runId, graph);
+        const targetId = taskId ?? findCheckpointTask(stwRoot, runId, graph.tasks);
+        if (!targetId) {
+            console.error('No task with checkpoint found');
+            process.exit(1);
+        }
+        const task = graph.tasks.find((t) => t.id === targetId);
+        if (!task) {
+            console.error(`Task ${targetId} not found`);
+            process.exit(1);
+        }
+        const lockResult = acquireLock(stwRoot, runId);
+        if (!lockResult.acquired) {
+            console.error(`Run is locked by PID ${lockResult.existingLock?.data.pid}. Use 'stw unlock' to remove.`);
+            process.exit(1);
+        }
+        const logger = createLogger(join(runDir(stwRoot, runId), 'logs.ndjson'), runId);
+        try {
+            const claim = await claimTask(stwRoot, runId, task.id, 'stw-executor');
+            if (!claim.claimed) {
+                console.error(`Task ${task.id} already claimed by ${claim.holder}. Use 'stw unlock' if the holder is dead.`);
+                process.exit(1);
+            }
+            console.log(`Resuming task: ${task.id}`);
+            const result = await executeTask(task, config, {
+                taskDir: taskDir(stwRoot, runId, task.id),
+                repoRoot: manifest.repo_root,
+                runBranch: manifest.branch,
+                resume: true,
+                stwRoot,
+                runId,
+                logger,
+                pricing: config.pricing,
+                budget: config.budget,
+            });
+            const previousStatus = readTaskStatus(stwRoot, runId, task.id);
+            const preservedNote = result.preservedWorktreePath ? ` | worktree: ${result.preservedWorktreePath}` : '';
+            writeTaskStatus(stwRoot, runId, task.id, {
+                agent_id: 'stw-executor',
+                status: mapExecutionResultToStatus(result.finalState),
+                notes: `attempts: ${result.attempts}${preservedNote}`,
+                preserved_worktree_path: result.preservedWorktreePath ?? previousStatus?.preserved_worktree_path,
+            });
+            recordRunEvent(stwRoot, runId, {
+                event_type: 'resume',
+                actor: 'stw-executor',
+                task_id: task.id,
+                summary: 'Task resumed from checkpoint',
+                details: `Final state: ${result.finalState}; attempts: ${result.attempts}`,
+                metadata: task.planner_metadata?.execution_mode === 'agentic'
+                    ? {
+                        execution_mode: 'agentic',
+                        agentic_backend: task.planner_metadata.agentic_backend ?? config.defaults.agentic?.default_backend ?? null,
+                    }
+                    : undefined,
+            });
+            if (result.finalState !== 'complete') {
+                recordRunEvent(stwRoot, runId, {
+                    event_type: 'escalation',
+                    actor: 'stw-executor',
+                    task_id: task.id,
+                    summary: `Task ended in ${result.finalState} after resume`,
+                    escalation_category: 'human_review',
+                });
+            }
+            console.log(`Task ${task.id} result: ${result.finalState}`);
+            console.log(`Attempts: ${result.attempts}`);
+        }
+        finally {
+            releaseLock(stwRoot);
+        }
+    });
+}
+//# sourceMappingURL=execution.js.map

package/dist/commands/execution.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution.js","sourceRoot":"","sources":["../../src/commands/execution.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACzD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,2BAA2B,EAAE,MAAM,kBAAkB,CAAC;AAC/D,OAAO,EAAE,sBAAsB,EAAE,cAAc,EAAE,cAAc,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACtH,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AACzG,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACtD,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C,MAAM,oBAAoB,GAAG,IAAI,GAAG,CAAwB,CAAC,SAAS,EAAE,SAAS,EAAE,UAAU,EAAE,SAAS,CAAC,CAAC,CAAC;AAC3G,MAAM,oBAAoB,GAAG,IAAI,GAAG,CAAwB,CAAC,QAAQ,EAAE,uBAAuB,EAAE,SAAS,CAAC,CAAC,CAAC;AAC5G,MAAM,uBAAuB,GAAG,IAAI,GAAG,CAAc,CAAC,WAAW,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC,CAAC;AAEzF,SAAS,kBAAkB,CAAC,OAAe,EAAE,KAAa,EAAE,KAAa;IACvE,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,MAAM,GAAG,cAAc,CAAC,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC;QACvD,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,CAAC,UAAU,EAAE,SAAS,EAAE,QAAQ,EAAE,WAAW,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QACpG,IAAI,CAAC,MAAM,IAAI,SAAS,EAAE,CAAC;YACzB,MAAM,EAAE,GAAG,OAAO,CAAC,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC;YAC5C,IAAI,UAAU,CAAC,IAAI,CAAC,EAAE,EAAE,aAAa,CAAC,CAAC,EAAE,CAAC;gBACxC,OAAO,IAAI,CAAC,EAAE,CAAC;YACjB,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,qBAAqB,CAAC,EAAU;IACvC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC,EAAE,CAAC;QACpB,OAAO;IACT,CAAC;IAED,MAAM,cAAc,GAAG;QACrB,aAAa;QACb,YAAY;QACZ,eAAe;QACf,kBAAkB;QAClB,aAAa;QACb,iBAAiB;QACjB,iBAAiB;QACjB,aAAa;KACd,CAAC;IAEF,MAAM,QAAQ,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;IAC7E,MAAM,WAAW,GAAG,mBAAmB,CAAC,EAAE,CAAC,CAAC;IAC5C,MAAM,cAAc,GAAG,CAAC,GAAG,QAAQ,EAAE,GAAG,WAAW,CAAC,CAAC;IAErD,IAAI,cAAc,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAChC,OAAO;IACT,CAAC;IAED,MAAM,WAAW,GAAG,IAAI,CAAC,EAAE,EAAE,UAAU,CAAC,CAAC;IACzC,SAAS,CAAC,WAAW,CAAC,CAAC;IACvB,MAAM,aAAa,GAAG,oBAAoB,CAAC,WAAW,CAAC,CAAC;IACxD,MAAM,UAAU,GAAG,IAAI,CAAC,WAAW,EAAE,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC;IAC5D,SAAS,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAE3C,KAAK,MAAM,IAAI,IAAI,cAAc,EAAE,CAAC;QAClC,MAAM,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,EAAE,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACtE,CAAC;AACH,CAAC;AAED,SAAS,mBAAmB,CAAC,EAAU;IACrC,IAAI,CAAC;QACH,OAAO,WAAW,CAAC,EAAE,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC;aAC5C,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,EAAE,IAAI,oBAAoB,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;aAC1E,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC;aAC1B,IAAI,EAAE,CAAC;IACZ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,SAAS,oBAAoB,CAAC,WAAmB;IAC/C,IAAI,GAAG,GAAG,CAAC,CAAC;IACZ,IAAI,CAAC;QACH,KAAK,MAAM,KAAK,IAAI,WAAW,CAAC,WAAW,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;YACtE,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE;gBAAE,SAAS;YACnC,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YAC9C,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,GAAG,EAAE,CAAC;gBAC1C,GAAG,GAAG,KAAK,CAAC;YACd,CAAC;QACH,CAAC;IACH,CAAC;IAAC,MAAM,CAAC,CAAA,CAAC;IACV,OAAO,GAAG,GAAG,CAAC,CAAC;AACjB,CAAC;AAED,SAAS,oBAAoB,CAAC,EAAU;IACtC,MAAM,aAAa,GAAG,CAAC,aAAa,EAAE,YAAY,EAAE,YAAY,CAAC,CAAC;IAClE,KAAK,MAAM,IAAI,IAAI,aAAa,EAAE,CAAC;QACjC,MAAM,QAAQ,GAAG,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;QAChC,IAAI,CAAC;YACH,UAAU,CAAC,QAAQ,CAAC,CAAC;QACvB,CAAC;QAAC,MAAM,CAAC,CAAA,CAAC;IACZ,CAAC;AACH,CAAC;AAED,SAAS,8BAA8B,CAAC,OAAe,EAAE,KAAa,EAAE,KAAgB;IACtF,MAAM,MAAM,GAAG,sBAAsB,CACnC,OAAO,EACP,KAAK,EACL,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,CACnC,CAAC;IAEF,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QAClB,OAAO;IACT,CAAC;IAED,OAAO,CAAC,KAAK,CAAC,gCAAgC,KAAK,GAAG,CAAC,CAAC;IACxD,IAAI,MAAM,CAAC,MAAM,KAAK,YAAY,EAAE,CAAC;QACnC,OAAO,CAAC,KAAK,CAAC,+CAA+C,CAAC,CAAC;IACjE,CAAC;IACD,IAAI,MAAM,CAAC,MAAM,KAAK,yCAAyC,EAAE,CAAC;QAChE,OAAO,CAAC,KAAK,CAAC,qFAAqF,CAAC,CAAC;IACvG,CAAC;IAED,IAAI,MAAM,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACjC,OAAO,CAAC,KAAK,CACX,mBAAmB,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CACvI,CAAC;IACJ,CAAC;IAED,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;QACnC,OAAO,CAAC,KAAK,CAAC,aAAa,IAAI,EAAE,CAAC,CAAC;IACrC,CAAC;AACH,CAAC;AAED,SAAS,0BAA0B,CAAC,UAA6D;IAC/F,QAAQ,UAAU,EAAE,CAAC;QACnB,KAAK,UAAU;YACb,OAAO,UAAU,CAAC;QACpB,KAAK,WAAW;YACd,OAAO,WAAW,CAAC;QACrB,KAAK,UAAU;YACb,OAAO,QAAQ,CAAC;QAClB,KAAK,SAAS;YACZ,OAAO,WAAW,CAAC;IACvB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,yBAAyB,CAAC,OAAgB;IACxD,OAAO;SACJ,OAAO,CAAC,eAAe,CAAC;SACxB,WAAW,CAAC,6CAA6C,CAAC;SAC1D,MAAM,CAAC,CAAC,KAAa,EAAE,EAAE;QACxB,MAAM,OAAO,GAAG,UAAU,EAAE,CAAC;QAC7B,MAAM,YAAY,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,EAAE,eAAe,CAAC,CAAC;QACnE,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;YAC9B,OAAO,CAAC,KAAK,CAAC,kBAAkB,KAAK,EAAE,CAAC,CAAC;YACzC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QAED,MAAM,QAAQ,GAAG,QAAQ,CAAc,YAAY,CAAC,CAAC;QACrD,IAAI,CAAC,oBAAoB,CAAC,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;YAC/C,OAAO,CAAC,KAAK,CAAC,6BAA6B,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;YAC9D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QAED,MAAM,YAAY,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,EAAE,MAAM,CAAC,CAAC;QAC1D,WAAW,CAAC,YAAY,EAAE,cAAc,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;QAEtE,aAAa,CAAC,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,YAAY,EAAE,QAAQ,EAAE,CAAC,CAAC;QACpE,cAAc,CAAC,OAAO,EAAE,KAAK,EAAE;YAC7B,UAAU,EAAE,MAAM;YAClB,KAAK,EAAE,OAAO;YACd,OAAO,EAAE,sBAAsB;YAC/B,OAAO,EAAE,sCAAsC;SAChD,CAAC,CAAC;QAEH,WAAW,CAAC,OAAO,CAAC,CAAC;QAErB,MAAM,SAAS,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,EAAE,iBAAiB,CAAC,CAAC;QAClE,IAAI,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;YAC1B,MAAM,KAAK,GAAG,QAAQ,CAAY,SAAS,CAAC,CAAC;YAC7C,MAAM,UAAU,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE;gBAC1C,MAAM,EAAE,GAAG,cAAc,CAAC,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;gBAChD,OAAO,EAAE,IAAI,CAAC,CAAC,UAAU,EAAE,QAAQ,EAAE,WAAW,EAAE,SAAS,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC;YACnF,CAAC,CAAC,CAAC;YACH,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC1B,OAAO,CAAC,GAAG,CAAC,sBAAsB,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAC9E,CAAC;QACH,CAAC;QAED,OAAO,CAAC,GAAG,CAAC,OAAO,KAAK,mBAAmB,CAAC,CAAC;IAC/C,CAAC,CAAC,CAAC;IAEL,OAAO;SACJ,OAAO,CAAC,0BAA0B,CAAC;SACnC,WAAW,CAAC,gDAAgD,CAAC;SAC7D,MAAM,CAAC,eAAe,EAAE,+BAA+B,CAAC;SACxD,MAAM,CAAC,CAAC,KAAa,EAAE,SAAiB,EAAE,IAAuB,EAAE,EAAE;QACpE,MAAM,OAAO,GAAG,UAAU,EAAE,CAAC;QAC7B,MAAM,YAAY,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,EAAE,eAAe,CAAC,CAAC;QACnE,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;YAC9B,OAAO,CAAC,KAAK,CAAC,kBAAkB,KAAK,EAAE,CAAC,CAAC;YACzC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QAED,MAAM,QAAQ,GAAG,QAAQ,CAAc,YAAY,CAAC,CAAC;QACrD,IAAI,CAAC,oBAAoB,CAAC,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;YAC/C,OAAO,CAAC,KAAK,CAAC,8BAA8B,QAAQ,CAAC,MAAM,4CAA4C,CAAC,CAAC;YACzG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QAED,MAAM,UAAU,GAAG,cAAc,CAAC,OAAO,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC;QAC7D,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,OAAO,CAAC,KAAK,CAAC,4BAA4B,SAAS,EAAE,CAAC,CAAC;YACvD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QACD,IAAI,CAAC,uBAAuB,CAAC,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;YACpD,OAAO,CAAC,KAAK,CAAC,QAAQ,SAAS,OAAO,UAAU,CAAC,MAAM,iBAAiB,CAAC,CAAC;YAC1E,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QAED,MAAM,EAAE,GAAG,OAAO,CAAC,OAAO,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC;QAC9C,qBAAqB,CAAC,EAAE,CAAC,CAAC;QAC1B,oBAAoB,CAAC,EAAE,CAAC,CAAC;QAEzB,oBAAoB,CAAC,EAAE,EAAE,YAAY,CAAC,CAAC;QAEvC,MAAM,SAAS,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,EAAE,iBAAiB,CAAC,CAAC;QAClE,IAAI,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;YAC1B,MAAM,KAAK,GAAG,QAAQ,CAAY,SAAS,CAAC,CAAC;YAE7C,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;gBACd,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,SAAS,CAAC,CAAC;gBACzD,IAAI,IAAI,EAAE,CAAC;oBACT,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,IAAiB,CAAC;oBACzC,SAAS,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;gBAC9B,CAAC;YACH,CAAC;YAED,MAAM,aAAa,GAAG,IAAI,GAAG,EAAqB,CAAC;YACnD,KAAK,MAAM,CAAC,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;gBAC5B,MAAM,EAAE,GAAG,cAAc,CAAC,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;gBAChD,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAG,EAAE,EAAE,MAAoB,IAAI,SAAS,CAAC,CAAC;YAClE,CAAC;YACD,aAAa,CAAC,GAAG,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;YACxC,MAAM,OAAO,GAAa,2BAA2B,CAAC,KAAK,EAAE,SAAS,EAAE,aAAa,CAAC,CAAC;YACvF,KAAK,MAAM,OAAO,IAAI,OAAO,EAAE,CAAC;gBAC9B,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;gBACjD,qBAAqB,CAAC,OAAO,CAAC,CAAC;gBAC/B,oBAAoB,CAAC,OAAO,CAAC,CAAC;YAChC,CAAC;YACD,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACvB,OAAO,CAAC,GAAG,CAAC,cAAc,OAAO,CAAC,MAAM,wBAAwB,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACxF,CAAC;QACH,CAAC;QAED,MAAM,YAAY,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,EAAE,MAAM,CAAC,CAAC;QAC1D,IAAI,CAAC;YACH,UAAU,CAAC,YAAY,CAAC,CAAC;QAC3B,CAAC;QAAC,MAAM,CAAC,CAAA,CAAC;QAEV,aAAa,CAAC,OAAO,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC;QACzC,cAAc,CAAC,OAAO,EAAE,KAAK,EAAE;YAC7B,UAAU,EAAE,OAAO;YACnB,KAAK,EAAE,OAAO;YACd,OAAO,EAAE,SAAS;YAClB,OAAO,EAAE,sBAAsB;YAC/B,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,kBAAkB,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS;SAC/D,CAAC,CAAC;QAEH,OAAO,CAAC,GAAG,CAAC,QAAQ,SAAS,kCAAkC,KAAK,kBAAkB,CAAC,CAAC;IAC1F,CAAC,CAAC,CAAC;IAEL,OAAO;SACJ,OAAO,CAAC,2BAA2B,CAAC;SACpC,WAAW,CAAC,wCAAwC,CAAC;SACrD,MAAM,CAAC,KAAK,EAAE,KAAa,EAAE,MAAe,EAAE,EAAE;QAC/C,MAAM,OAAO,GAAG,UAAU,EAAE,CAAC;QAC7B,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;QAC7C,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,EAAE,eAAe,CAAC,CAAC;QACpD,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,EAAE,iBAAiB,CAAC,CAAC;QAEnD,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;YAC3B,OAAO,CAAC,KAAK,CAAC,+BAA+B,KAAK,EAAE,CAAC,CAAC;YACtD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QACD,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;YAC9B,OAAO,CAAC,KAAK,CAAC,kBAAkB,KAAK,EAAE,CAAC,CAAC;YACzC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QAED,MAAM,QAAQ,GAAG,QAAQ,CAAc,YAAY,CAAC,CAAC;QACrD,MAAM,KAAK,GAAG,QAAQ,CAAY,SAAS,CAAC,CAAC;QAC7C,MAAM,MAAM,GAAG,UAAU,CAAC,IAAI,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC;QAEvD,8BAA8B,CAAC,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;QAEtD,MAAM,QAAQ,GAAG,MAAM,IAAI,kBAAkB,CAAC,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;QAC3E,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,OAAO,CAAC,KAAK,CAAC,+BAA+B,CAAC,CAAC;YAC/C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QAED,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,QAAQ,CAAC,CAAC;QACxD,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,OAAO,CAAC,KAAK,CAAC,QAAQ,QAAQ,YAAY,CAAC,CAAC;YAC5C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QAED,MAAM,UAAU,GAAG,WAAW,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QAC/C,IAAI,CAAC,UAAU,CAAC,QAAQ,EAAE,CAAC;YACzB,OAAO,CAAC,KAAK,CAAC,wBAAwB,UAAU,CAAC,YAAY,EAAE,IAAI,CAAC,GAAG,+BAA+B,CAAC,CAAC;YACxG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QAED,MAAM,MAAM,GAAG,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,EAAE,aAAa,CAAC,EAAE,KAAK,CAAC,CAAC;QAEhF,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,MAAM,SAAS,CAAC,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,EAAE,EAAE,cAAc,CAAC,CAAC;YACvE,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;gBACnB,OAAO,CAAC,KAAK,CAAC,QAAQ,IAAI,CAAC,EAAE,uBAAuB,KAAK,CAAC,MAAM,2CAA2C,CAAC,CAAC;gBAC7G,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAClB,CAAC;YAED,OAAO,CAAC,GAAG,CAAC,kBAAkB,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;YACzC,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE;gBAC7C,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,EAAE,CAAC;gBACzC,QAAQ,EAAE,QAAQ,CAAC,SAAS;gBAC5B,SAAS,EAAE,QAAQ,CAAC,MAAM;gBAC1B,MAAM,EAAE,IAAI;gBACZ,OAAO;gBACP,KAAK;gBACL,MAAM;gBACN,OAAO,EAAE,MAAM,CAAC,OAAO;gBACvB,MAAM,EAAE,MAAM,CAAC,MAAM;aACtB,CAAC,CAAC;YACH,MAAM,cAAc,GAAG,cAAc,CAAC,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC;YAC/D,MAAM,aAAa,GAAG,MAAM,CAAC,qBAAqB,CAAC,CAAC,CAAC,gBAAgB,MAAM,CAAC,qBAAqB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACzG,eAAe,CAAC,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,EAAE,EAAE;gBACvC,QAAQ,EAAE,cAAc;gBACxB,MAAM,EAAE,0BAA0B,CAAC,MAAM,CAAC,UAAU,CAAC;gBACrD,KAAK,EAAE,aAAa,MAAM,CAAC,QAAQ,GAAG,aAAa,EAAE;gBACrD,uBAAuB,EAAE,MAAM,CAAC,qBAAqB,IAAI,cAAc,EAAE,uBAAuB;aACjG,CAAC,CAAC;YACH,cAAc,CAAC,OAAO,EAAE,KAAK,EAAE;gBAC7B,UAAU,EAAE,QAAQ;gBACpB,KAAK,EAAE,cAAc;gBACrB,OAAO,EAAE,IAAI,CAAC,EAAE;gBAChB,OAAO,EAAE,8BAA8B;gBACvC,OAAO,EAAE,gBAAgB,MAAM,CAAC,UAAU,eAAe,MAAM,CAAC,QAAQ,EAAE;gBAC1E,QAAQ,EACN,IAAI,CAAC,gBAAgB,EAAE,cAAc,KAAK,SAAS;oBACjD,CAAC,CAAC;wBACE,cAAc,EAAE,SAAS;wBACzB,eAAe,EACb,IAAI,CAAC,gBAAgB,CAAC,eAAe,IAAI,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,eAAe,IAAI,IAAI;qBAC5F;oBACH,CAAC,CAAC,SAAS;aAChB,CAAC,CAAC;YACH,IAAI,MAAM,CAAC,UAAU,KAAK,UAAU,EAAE,CAAC;gBACrC,cAAc,CAAC,OAAO,EAAE,KAAK,EAAE;oBAC7B,UAAU,EAAE,YAAY;oBACxB,KAAK,EAAE,cAAc;oBACrB,OAAO,EAAE,IAAI,CAAC,EAAE;oBAChB,OAAO,EAAE,iBAAiB,MAAM,CAAC,UAAU,eAAe;oBAC1D,mBAAmB,EAAE,cAAc;iBACpC,CAAC,CAAC;YACL,CAAC;YACD,OAAO,CAAC,GAAG,CAAC,QAAQ,IAAI,CAAC,EAAE,YAAY,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC;YAC5D,OAAO,CAAC,GAAG,CAAC,aAAa,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC;QAC9C,CAAC;gBAAS,CAAC;YACT,WAAW,CAAC,OAAO,CAAC,CAAC;QACvB,CAAC;IACH,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/commands/go.d.ts

@@ -0,0 +1,2 @@
+import type { Command } from 'commander';
+export declare function registerGoCommand(program: Command): void;

package/dist/commands/go.js

@@ -0,0 +1,197 @@
+import { readFileSync } from 'node:fs';
+import { join, resolve } from 'node:path';
+import { generateSpec, slugify, KNOWN_STACK_PRESETS, ClarityGateError } from '../idea.js';
+import { loadConfig } from '../config.js';
+import { validateSeedDir } from '../worktree.js';
+import { generatePlan, validatePlanScope } from '../planner.js';
+import { estimateCost, recordCost } from '../cost.js';
+import { writeAtomic, writeJson, readJson, fileExists, runDir } from '../storage.js';
+import { getStwRoot, ingestRunFromContext, setupRunArtifacts } from './helpers.js';
+export function registerGoCommand(program) {
+    program
+        .command('go')
+        .description('Run the full pipeline: idea → ingest → plan → assign → run')
+        .argument('<description>', 'The rough idea in natural language')
+        .option('--template <name>', 'Template override (bugfix, feature, refactor, cleanup, greenfield)')
+        .option('--greenfield', 'Generate a spec for a brand-new project (no existing codebase)')
+        .option('--stack <preset>', `Stack preset (${KNOWN_STACK_PRESETS.join(', ')}). Implies --greenfield.`)
+        .option('--from <dir>', 'Seed greenfield worktree from a local directory. Implies --greenfield.')
+        .option('--spec <path>', 'Use an existing spec instead of generating one')
+        .option('--dry-run', 'Stop after plan (do not assign or run)')
+        .option('--skip-budget-check', 'Skip budget check during run')
+        .option('--verbose', 'Stream worker output to console during run')
+        .option('--no-clarity-check', 'Skip the idea clarity check (for power users)')
+        .action(async (description, opts) => {
+        if (opts.stack && !KNOWN_STACK_PRESETS.includes(opts.stack)) {
+            console.error(`Unknown stack preset "${opts.stack}". Available: ${KNOWN_STACK_PRESETS.join(', ')}`);
+            process.exit(1);
+        }
+        const seedDir = opts.from ? resolve(opts.from) : undefined;
+        if (seedDir) {
+            try {
+                validateSeedDir(seedDir);
+            }
+            catch (err) {
+                console.error(err instanceof Error ? err.message : String(err));
+                process.exit(1);
+            }
+        }
+        const isGreenfield = opts.greenfield || !!opts.stack || !!seedDir;
+        const stwRoot = getStwRoot();
+        const config = loadConfig(join(stwRoot, 'config.yml'));
+        const repoRoot = resolve('.');
+        // --- Step 1: Idea → Spec ---
+        let specPath;
+        if (opts.spec) {
+            specPath = opts.spec;
+            console.log(`[go] Using existing spec: ${specPath}`);
+        }
+        else {
+            console.log(`[go] Generating spec from idea: "${description}"`);
+            if (opts.stack) {
+                console.log(`[go] Stack: ${opts.stack}`);
+            }
+            let ideaResult;
+            try {
+                ideaResult = await generateSpec({
+                    idea: description,
+                    repoRoot,
+                    config,
+                    templateOverride: opts.template,
+                    isGreenfield,
+                    stack: opts.stack,
+                    seedDir,
+                    skipClarityCheck: opts.clarityCheck === false,
+                });
+            }
+            catch (err) {
+                if (err instanceof ClarityGateError) {
+                    console.error(`\n[go] Idea rejected — not specific enough to generate a spec.\n`);
+                    console.error(`Feedback: ${err.feedback}`);
+                    if (err.suggestedIdea) {
+                        console.error(`\nYou can use this as a starting point:\n  "${err.suggestedIdea}"`);
+                    }
+                    process.exit(1);
+                }
+                throw err;
+            }
+            specPath = join('specs', `${slugify(description)}.md`);
+            writeAtomic(specPath, ideaResult.spec);
+            console.log(`[go] Spec generated → ${specPath}`);
+            if (ideaResult.model) {
+                console.log(`[go]   Model: ${ideaResult.model}`);
+            }
+            if (ideaResult.usage) {
+                console.log(`[go]   Tokens: ${ideaResult.usage.input_tokens} in / ${ideaResult.usage.output_tokens} out`);
+            }
+            if (ideaResult.latency_ms) {
+                console.log(`[go]   Latency: ${(ideaResult.latency_ms / 1000).toFixed(1)}s`);
+            }
+        }
+        // --- Step 2: Ingest → Run ---
+        console.log(`[go] Ingesting spec...`);
+        const ingestResult = ingestRunFromContext({
+            repoRoot,
+            stwRoot,
+            fallbackSpecPath: specPath,
+            greenfield: isGreenfield,
+            seedDir,
+        });
+        if (!ingestResult.ok || !ingestResult.manifest) {
+            console.error(`[go] Ingest failed: ${ingestResult.message}`);
+            for (const detail of ingestResult.details ?? []) {
+                console.error(`  - ${detail}`);
+            }
+            process.exit(1);
+        }
+        const runId = ingestResult.manifest.run_id;
+        console.log(`[go] Run created: ${runId}`);
+        // --- Step 3: Plan ---
+        console.log(`[go] Planning...`);
+        const spec = readFileSync(resolve(repoRoot, specPath), 'utf-8');
+        const planResult = await generatePlan({
+            spec,
+            repoRoot,
+            config,
+            runId,
+        });
+        if (planResult.warnings.length > 0) {
+            for (const warning of planResult.warnings) {
+                console.warn(`[go]   Plan warning: ${warning}`);
+            }
+        }
+        const scopeValidation = validatePlanScope(planResult.task_graph, repoRoot, {
+            max_scope_files_per_task: config.defaults.max_scope_files_per_task,
+            max_tasks_per_spec: config.defaults.max_tasks_per_spec,
+        });
+        if (!scopeValidation.valid) {
+            // The planner already retried scope errors — demote remaining errors to warnings
+            // so the pipeline can proceed. Workers will still enforce scope at execution time.
+            for (const error of scopeValidation.errors) {
+                console.warn(`[go]   Scope warning (post-retry): ${error}`);
+            }
+        }
+        writeJson(join(stwRoot, 'runs', runId, 'task_graph.json'), planResult.task_graph);
+        if (planResult.usage && config.pricing) {
+            const plannerModel = planResult.model ?? 'unknown';
+            const plannerCostUsd = estimateCost(config.pricing, plannerModel, planResult.usage.input_tokens, planResult.usage.output_tokens);
+            try {
+                recordCost(stwRoot, runId, '_planner', {
+                    task_id: '_planner',
+                    model: plannerModel,
+                    provider: 'unknown',
+                    input_tokens: planResult.usage.input_tokens,
+                    output_tokens: planResult.usage.output_tokens,
+                    cost_usd: plannerCostUsd,
+                    tier: 'strong',
+                    latency_ms: planResult.latency_ms ?? 0,
+                });
+            }
+            catch { }
+        }
+        const taskCount = planResult.task_graph.tasks.length;
+        const taskIds = planResult.task_graph.tasks.map((t) => t.id).join(', ');
+        console.log(`[go] Plan: ${taskCount} tasks (${taskIds})`);
+        if (opts.dryRun) {
+            console.log(`[go] Dry run — stopping before assign/run.`);
+            console.log(`[go] To continue: stw assign ${runId} && stw run ${runId}`);
+            return;
+        }
+        // --- Step 4: Assign ---
+        console.log(`[go] Assigning...`);
+        const setupResult = setupRunArtifacts({ stwRoot, runId, repoRoot });
+        if (!setupResult.assignmentsWritten) {
+            console.error(`[go] Assignment failed — no task graph found after planning.`);
+            process.exit(1);
+        }
+        console.log(`[go] Assigned ${taskCount} tasks`);
+        // --- Step 5: Run ---
+        console.log(`[go] Running...`);
+        // Shell out to `stw run` reusing the current entry point (works both in dev via tsx and after npm install)
+        const { execFileSync } = await import('node:child_process');
+        const entryScript = process.argv[1] ?? 'stw';
+        const args = [entryScript, 'run', runId];
+        if (opts.skipBudgetCheck)
+            args.push('--skip-budget-check');
+        if (opts.verbose)
+            args.push('--verbose');
+        try {
+            execFileSync(process.execPath, args, {
+                cwd: repoRoot,
+                encoding: 'utf-8',
+                stdio: 'inherit',
+                timeout: 30 * 60 * 1000, // 30 min max
+            });
+        }
+        catch {
+            // run command exits non-zero on escalation — check final status
+            const manifestPath = join(runDir(stwRoot, runId), 'manifest.json');
+            if (fileExists(manifestPath)) {
+                const manifest = readJson(manifestPath);
+                console.log(`[go] Run finished with status: ${manifest.status}`);
+            }
+        }
+        console.log(`[go] Pipeline complete for run ${runId}`);
+    });
+}
+//# sourceMappingURL=go.js.map

package/dist/commands/go.js.map

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

package/dist/commands/helpers.d.ts

@@ -0,0 +1,44 @@
+import type { RunManifest, TaskGraph } from '../types.js';
+import type { AgentDefinition } from '../agents.js';
+export declare function getStwRoot(): string;
+export declare function delay(ms: number): Promise<void>;
+export declare const LOG_LEVELS: readonly ["debug", "info", "warn", "error"];
+export type LogLevel = (typeof LOG_LEVELS)[number];
+export interface LogEntry {
+    ts?: string;
+    level?: string;
+    task_id?: string | null;
+    message?: string;
+}
+export interface IngestContext {
+    repoRoot: string;
+    stwRoot: string;
+    noteBody?: string;
+    notePath?: string;
+    fallbackSpecPath?: string;
+    baseBranch?: string;
+    greenfield?: boolean;
+    seedDir?: string;
+}
+export interface IngestResult {
+    ok: boolean;
+    manifest?: RunManifest;
+    message: string;
+    details?: string[];
+}
+export declare function getDefaultAgents(): AgentDefinition[];
+export declare function setupRunArtifacts(options: {
+    stwRoot: string;
+    runId: string;
+    repoRoot: string;
+    agents?: AgentDefinition[];
+}): {
+    graph: TaskGraph | null;
+    assignmentsWritten: boolean;
+    inboxesWritten: number;
+    warnings: string[];
+};
+export declare function ingestRunFromContext(options: IngestContext): IngestResult;
+export declare function findCurrentGitBranch(repoRoot: string): string | null;
+export declare function getRepoRootFromCwd(): string;
+export declare function getFixturesConfigPath(): string;