@mknightzzz/stw 0.1.0

package/dist/commands/stats.js

@@ -0,0 +1,80 @@
+import { readdirSync } from 'node:fs';
+import { join } from 'node:path';
+import { fileExists, readJson } from '../storage.js';
+import { getStwRoot } from './helpers.js';
+function loadAllScorecards(stwRoot) {
+    const runsDir = join(stwRoot, 'runs');
+    const entries = [];
+    let runDirs;
+    try {
+        runDirs = readdirSync(runsDir, { withFileTypes: true })
+            .filter((e) => e.isDirectory())
+            .map((e) => e.name)
+            .sort();
+    }
+    catch {
+        return [];
+    }
+    for (const runId of runDirs) {
+        const scorecardPath = join(runsDir, runId, 'scorecard.json');
+        if (!fileExists(scorecardPath))
+            continue;
+        try {
+            const scorecard = readJson(scorecardPath);
+            entries.push({ runId, scorecard });
+        }
+        catch {
+            // Skip corrupt scorecard files
+        }
+    }
+    return entries;
+}
+function formatDuration(seconds) {
+    if (seconds < 60)
+        return `${seconds}s`;
+    const mins = Math.floor(seconds / 60);
+    const secs = seconds % 60;
+    return secs > 0 ? `${mins}m ${secs}s` : `${mins}m`;
+}
+function pad(str, len) {
+    return str.padEnd(len);
+}
+function padRight(str, len) {
+    return str.padStart(len);
+}
+export function registerStatsCommand(program) {
+    program
+        .command('stats')
+        .description('Show trend across all runs with scorecards')
+        .action(() => {
+        const stwRoot = getStwRoot();
+        const entries = loadAllScorecards(stwRoot);
+        if (entries.length === 0) {
+            console.log('No runs with scorecards found. Run `stw run` to generate scorecards.');
+            return;
+        }
+        // Header
+        console.log(`${pad('Run', 30)} ${padRight('Tasks', 5)} ${padRight('Auto%', 6)} ${padRight('Esc', 4)} ${padRight('Retries', 7)} ${padRight('Cost', 8)} ${padRight('Wall', 8)}`);
+        console.log('-'.repeat(72));
+        let totalTasks = 0;
+        let totalAutoCompleted = 0;
+        let totalEscalated = 0;
+        let totalRetries = 0;
+        let totalCost = 0;
+        for (const { runId, scorecard } of entries) {
+            const autoRate = scorecard.total_tasks > 0 ? `${scorecard.auto_completion_rate.toFixed(0)}%` : '-';
+            const cost = `$${(scorecard.worker_cost_usd + scorecard.planner_cost_usd).toFixed(4)}`;
+            const wall = formatDuration(scorecard.wall_clock_seconds);
+            console.log(`${pad(runId, 30)} ${padRight(String(scorecard.total_tasks), 5)} ${padRight(autoRate, 6)} ${padRight(String(scorecard.escalated), 4)} ${padRight(String(scorecard.total_retries), 7)} ${padRight(cost, 8)} ${padRight(wall, 8)}`);
+            totalTasks += scorecard.total_tasks;
+            totalAutoCompleted += scorecard.auto_completed;
+            totalEscalated += scorecard.escalated;
+            totalRetries += scorecard.total_retries;
+            totalCost += scorecard.worker_cost_usd + scorecard.planner_cost_usd;
+        }
+        console.log('-'.repeat(72));
+        const avgAutoRate = totalTasks > 0 ? `${((totalAutoCompleted / totalTasks) * 100).toFixed(0)}%` : '-';
+        console.log(`${pad('TOTAL', 30)} ${padRight(String(totalTasks), 5)} ${padRight(avgAutoRate, 6)} ${padRight(String(totalEscalated), 4)} ${padRight(String(totalRetries), 7)} ${padRight(`$${totalCost.toFixed(4)}`, 8)}`);
+    });
+}
+//# sourceMappingURL=stats.js.map

package/dist/commands/stats.js.map

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

package/dist/commands/task-ops.d.ts

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

package/dist/commands/task-ops.js

@@ -0,0 +1,406 @@
+import { readdirSync } from 'node:fs';
+import { join, resolve } from 'node:path';
+import { loadConfig } from '../config.js';
+import { writeTaskStatus, readRunStatus, readTaskStatus, writeRunState, writeTaskState, recordRunEvent, markTaskSkipped, } from '../status.js';
+import { readJson, writeJson, fileExists, runDir, taskDir } from '../storage.js';
+import { loadCosts } from '../cost.js';
+import { claimTask } from '../claim.js';
+import { runMechanicalReview } from '../mechanical-review.js';
+import { createWorktree, cleanupWorktree } from '../worktree.js';
+import { STATUS_VALUES } from '../types.js';
+import { getStwRoot } from './helpers.js';
+import { buildProgressState, renderProgress } from '../progress.js';
+function getNextAnswerNumber(td) {
+    let max = 0;
+    try {
+        for (const entry of readdirSync(td, { withFileTypes: true })) {
+            if (!entry.isFile())
+                continue;
+            const match = entry.name.match(/^answer-(\d+)\.json$/);
+            if (!match)
+                continue;
+            const value = Number.parseInt(match[1], 10);
+            if (Number.isFinite(value) && value > max) {
+                max = value;
+            }
+        }
+    }
+    catch { }
+    return max + 1;
+}
+export function registerTaskOpsCommands(program) {
+    program
+        .command('status <run-id> [task-id]')
+        .description('Show run/task status or update a task status')
+        .option('--set <status>', 'Set task status (complete, blocked, failed, escalated)')
+        .option('--agent <agent-id>', 'Agent ID for status update')
+        .option('--notes <notes>', 'Notes for status update', '')
+        .action((runId, taskId, opts) => {
+        const stwRoot = getStwRoot();
+        if (taskId && opts.set) {
+            if (!opts.agent) {
+                console.error('--agent is required when setting status');
+                process.exit(1);
+            }
+            if (!STATUS_VALUES.includes(opts.set)) {
+                console.error(`Invalid status "${opts.set}". Valid values: ${STATUS_VALUES.join(', ')}`);
+                process.exit(1);
+            }
+            const previous = readTaskStatus(stwRoot, runId, taskId);
+            writeTaskStatus(stwRoot, runId, taskId, {
+                agent_id: opts.agent,
+                status: opts.set,
+                notes: opts.notes ?? '',
+            });
+            recordRunEvent(stwRoot, runId, {
+                event_type: previous ? 'status_correction' : 'manual_completion',
+                actor: opts.agent,
+                task_id: taskId,
+                summary: `Task status set to ${opts.set}`,
+                details: opts.notes ?? '',
+                escalation_category: opts.set === 'escalated' || opts.set === 'failed' ? 'operator_override' : undefined,
+                metadata: {
+                    previous_status: previous?.status ?? null,
+                    next_status: opts.set,
+                },
+            });
+            console.log(`${taskId}: ${opts.set}`);
+            return;
+        }
+        const graphPath = join(stwRoot, 'runs', runId, 'task_graph.json');
+        if (!fileExists(graphPath)) {
+            console.log(`No task graph found for run ${runId}`);
+            return;
+        }
+        const graph = readJson(graphPath);
+        const taskIds = graph.tasks.map((t) => t.id);
+        const statuses = readRunStatus(stwRoot, runId, taskIds);
+        const manifestPath = join(runDir(stwRoot, runId), 'manifest.json');
+        const runManifest = fileExists(manifestPath) ? readJson(manifestPath) : null;
+        const costs = loadCosts(stwRoot, runId);
+        console.log(`Run: ${runId}${runManifest ? ` (${runManifest.status})` : ''}`);
+        if (runManifest && runManifest.pause_reason) {
+            console.log(`Pause reason: ${runManifest.pause_reason}`);
+        }
+        if (runManifest) {
+            const configPath = join(stwRoot, 'config.yml');
+            if (fileExists(configPath)) {
+                try {
+                    const config = loadConfig(configPath);
+                    if (config.budget) {
+                        const spent = costs?.total_cost_usd ?? 0;
+                        const limit = config.budget.max_run_usd;
+                        const pct = limit > 0 ? (spent / limit) * 100 : 0;
+                        console.log(`Budget: $${spent.toFixed(2)} / $${limit.toFixed(2)} (${pct.toFixed(0)}%)`);
+                    }
+                }
+                catch { }
+            }
+        }
+        console.log('---');
+        for (const [id, status] of Object.entries(statuses)) {
+            const taskCost = costs?.task_costs[id];
+            const costStr = taskCost != null ? ` | $${taskCost.toFixed(4)}` : '';
+            const fullStatus = readTaskStatus(stwRoot, runId, id);
+            const worktreeStr = fullStatus?.preserved_worktree_path
+                ? ` | worktree: ${fullStatus.preserved_worktree_path}`
+                : '';
+            const notesStr = fullStatus?.notes ? ` (${fullStatus.notes})` : '';
+            console.log(`  ${id}: ${status}${costStr}${worktreeStr}${notesStr}`);
+        }
+        if (costs) {
+            console.log('---');
+            console.log(`  Total: $${costs.total_cost_usd.toFixed(4)}`);
+        }
+    });
+    program
+        .command('answer <run-id> <task-id> <text>')
+        .description('Answer a worker question and resume the task from waiting_for_human to working')
+        .action((runId, taskId, text) => {
+        const stwRoot = getStwRoot();
+        const td = taskDir(stwRoot, runId, taskId);
+        if (!fileExists(td)) {
+            console.error(`Task not found: ${taskId}`);
+            process.exit(1);
+        }
+        const statePath = join(td, 'state.json');
+        const taskState = fileExists(statePath) ? readJson(statePath).state : undefined;
+        if (taskState !== 'waiting_for_human') {
+            console.error(`Task ${taskId} is not waiting_for_human`);
+            process.exit(1);
+        }
+        const questionPath = join(td, 'question.json');
+        const questionArtifact = fileExists(questionPath) ? readJson(questionPath) : null;
+        const answerNumber = getNextAnswerNumber(td);
+        const questionNumber = questionArtifact?.question_number ?? answerNumber;
+        const answerArtifact = {
+            schema_version: 1,
+            task_id: taskId,
+            question_number: questionNumber,
+            answer: text,
+            answered_at: new Date().toISOString(),
+            answered_by: 'human',
+        };
+        writeJson(join(td, `answer-${answerNumber}.json`), answerArtifact);
+        try {
+            writeTaskState(stwRoot, runId, taskId, 'working', 'human');
+        }
+        catch { }
+        const manifestPath = join(runDir(stwRoot, runId), 'manifest.json');
+        if (fileExists(manifestPath)) {
+            try {
+                const manifest = readJson(manifestPath);
+                if (manifest.status === 'paused') {
+                    try {
+                        writeRunState(stwRoot, runId, 'running');
+                    }
+                    catch { }
+                }
+            }
+            catch { }
+        }
+        recordRunEvent(stwRoot, runId, {
+            event_type: 'answer',
+            actor: 'human',
+            task_id: taskId,
+            summary: `Answered question #${questionNumber}`,
+            details: text,
+        });
+        recordRunEvent(stwRoot, runId, {
+            event_type: 'resume',
+            actor: 'human',
+            task_id: taskId,
+            summary: 'Resumed task after operator answer',
+        });
+        console.log(`Recorded answer for ${taskId} as answer-${answerNumber}.json`);
+    });
+    program
+        .command('claim <run-id> <task-id>')
+        .description('Atomically claim a task for an agent')
+        .requiredOption('--agent <agent-id>', 'Agent ID that is claiming the task')
+        .action(async (runId, taskId, opts) => {
+        const result = await claimTask(getStwRoot(), runId, taskId, opts.agent);
+        if (result.claimed) {
+            console.log(`Claimed ${taskId} for ${opts.agent}`);
+            return;
+        }
+        console.error(`Task ${taskId} is already claimed by ${result.holder ?? 'unknown'}`);
+        process.exit(1);
+    });
+    program
+        .command('continue <run-id>')
+        .description('Resume a paused run, skipping over-budget tasks')
+        .action((runId) => {
+        const stwRoot = getStwRoot();
+        const manifestPath = join(runDir(stwRoot, runId), 'manifest.json');
+        const graphPath = join(stwRoot, 'runs', runId, 'task_graph.json');
+        if (!fileExists(manifestPath)) {
+            console.error(`Run not found: ${runId}`);
+            process.exit(1);
+        }
+        if (!fileExists(graphPath)) {
+            console.error(`No task graph found for run ${runId}`);
+            process.exit(1);
+        }
+        const manifest = readJson(manifestPath);
+        const graph = readJson(graphPath);
+        if (manifest.status !== 'paused') {
+            console.error(`Run is not paused (status: ${manifest.status})`);
+            process.exit(1);
+        }
+        if (manifest.pause_reason !== 'budget_exceeded') {
+            console.error(`Run is not paused for budget (pause_reason: ${manifest.pause_reason ?? 'none'})`);
+            process.exit(1);
+        }
+        const taskIds = graph.tasks.map((t) => t.id);
+        const statuses = readRunStatus(stwRoot, runId, taskIds);
+        const config = loadConfig(join(stwRoot, 'config.yml'));
+        const costs = loadCosts(stwRoot, runId);
+        const totalCost = costs?.total_cost_usd ?? 0;
+        const runBudget = config.budget?.max_run_usd ?? Infinity;
+        let skippedCount = 0;
+        for (const task of graph.tasks) {
+            const status = statuses[task.id];
+            if (status === 'pending') {
+                markTaskSkipped(stwRoot, runId, task.id, `Skipped: run budget exceeded ($${totalCost.toFixed(2)}/$${runBudget.toFixed(2)})`);
+                skippedCount++;
+            }
+        }
+        writeRunState(stwRoot, runId, 'running');
+        recordRunEvent(stwRoot, runId, {
+            event_type: 'resume',
+            actor: 'human',
+            summary: 'Continued run after budget pause',
+            details: `Skipped ${skippedCount} pending tasks`,
+        });
+        console.log(`Continued run ${runId}`);
+        console.log(`Skipped ${skippedCount} pending tasks`);
+        console.log(`Run status: running`);
+    });
+    program
+        .command('task-reset <run-id> <task-id>')
+        .description('Reset a task to pending state, clearing its status')
+        .action(async (runId, taskId) => {
+        const stwRoot = getStwRoot();
+        const graphPath = join(stwRoot, 'runs', runId, 'task_graph.json');
+        if (!fileExists(graphPath)) {
+            console.error(`No task graph found for run ${runId}`);
+            process.exit(1);
+        }
+        const graph = readJson(graphPath);
+        const task = graph.tasks.find((t) => t.id === taskId);
+        if (!task) {
+            console.error(`Task ${taskId} not found in run ${runId}`);
+            process.exit(1);
+        }
+        const td = taskDir(stwRoot, runId, taskId);
+        const statusPath = join(td, 'status.json');
+        const statePath = join(td, 'state.json');
+        const previous = readTaskStatus(stwRoot, runId, taskId);
+        const { unlinkSync } = await import('node:fs');
+        try {
+            if (fileExists(statePath))
+                unlinkSync(statePath);
+            if (fileExists(statusPath))
+                unlinkSync(statusPath);
+        }
+        catch { }
+        writeTaskState(stwRoot, runId, taskId, 'pending', 'human');
+        recordRunEvent(stwRoot, runId, {
+            event_type: 'status_correction',
+            actor: 'human',
+            task_id: taskId,
+            summary: `Task ${taskId} reset to pending`,
+            details: previous ? `Previous status: ${previous.status}` : '',
+        });
+        console.log(`Task ${taskId} reset to pending`);
+    });
+    program
+        .command('task-skip <run-id> <task-id> <reason>')
+        .description('Mark a task as skipped')
+        .action((runId, taskId, reason) => {
+        const stwRoot = getStwRoot();
+        const graphPath = join(stwRoot, 'runs', runId, 'task_graph.json');
+        if (!fileExists(graphPath)) {
+            console.error(`No task graph found for run ${runId}`);
+            process.exit(1);
+        }
+        const graph = readJson(graphPath);
+        const task = graph.tasks.find((t) => t.id === taskId);
+        if (!task) {
+            console.error(`Task ${taskId} not found in run ${runId}`);
+            process.exit(1);
+        }
+        markTaskSkipped(stwRoot, runId, taskId, reason);
+        recordRunEvent(stwRoot, runId, {
+            event_type: 'status_correction',
+            actor: 'human',
+            task_id: taskId,
+            summary: `Task ${taskId} skipped`,
+            details: reason,
+        });
+        console.log(`Task ${taskId} marked as skipped: ${reason}`);
+    });
+    program
+        .command('task-complete <run-id> <task-id>')
+        .description('Manually mark a task as complete')
+        .action((runId, taskId) => {
+        const stwRoot = getStwRoot();
+        const graphPath = join(stwRoot, 'runs', runId, 'task_graph.json');
+        if (!fileExists(graphPath)) {
+            console.error(`No task graph found for run ${runId}`);
+            process.exit(1);
+        }
+        const graph = readJson(graphPath);
+        const task = graph.tasks.find((t) => t.id === taskId);
+        if (!task) {
+            console.error(`Task ${taskId} not found in run ${runId}`);
+            process.exit(1);
+        }
+        const previous = readTaskStatus(stwRoot, runId, taskId);
+        try {
+            writeTaskState(stwRoot, runId, taskId, 'complete', 'human');
+        }
+        catch { }
+        writeTaskStatus(stwRoot, runId, taskId, {
+            agent_id: 'human',
+            status: 'complete',
+            notes: 'Manually marked complete',
+        });
+        recordRunEvent(stwRoot, runId, {
+            event_type: 'manual_completion',
+            actor: 'human',
+            task_id: taskId,
+            summary: `Task ${taskId} manually marked complete`,
+            details: previous ? `Previous status: ${previous.status}` : '',
+        });
+        console.log(`Task ${taskId} marked as complete`);
+    });
+    program
+        .command('progress <run-id>')
+        .description('Show run progress status')
+        .option('--watch', 'Poll for updates every second')
+        .action((runId, opts) => {
+        const stwRoot = getStwRoot();
+        const showProgress = () => {
+            const progressState = buildProgressState({ stwRoot, runId, startTime: Date.now() });
+            if (progressState) {
+                console.clear();
+                console.log(renderProgress(progressState));
+            }
+            else {
+                console.error(`Run not found: ${runId}`);
+                process.exit(1);
+            }
+        };
+        if (opts.watch) {
+            showProgress();
+            setInterval(showProgress, 1000);
+        }
+        else {
+            showProgress();
+        }
+    });
+    program
+        .command('review <run-id> <task-id>')
+        .description('Run mechanical review on a task output')
+        .action(async (runId, taskId) => {
+        const stwRoot = getStwRoot();
+        const graphPath = join(stwRoot, 'runs', runId, 'task_graph.json');
+        if (!fileExists(graphPath)) {
+            console.error(`No task graph found for run ${runId}`);
+            process.exit(1);
+        }
+        const graph = readJson(graphPath);
+        const task = graph.tasks.find((t) => t.id === taskId);
+        if (!task) {
+            console.error(`Task ${taskId} not found`);
+            process.exit(1);
+        }
+        const runBranch = `stw/run-${runId.replaceAll('_', '-')}`;
+        console.log(`Running mechanical review for task: ${task.id}`);
+        const { worktreePath } = createWorktree({
+            repoRoot: resolve('.'),
+            runBranch,
+            taskId: `review-${taskId}`,
+        });
+        try {
+            const result = await runMechanicalReview({
+                cwd: worktreePath,
+                declaredScope: task.scope.files,
+                baseBranch: runBranch,
+            });
+            console.log(`Mechanical review: ${result.passed ? 'PASSED' : 'FAILED'}`);
+            console.log(`Tests: ${result.checks.tests.passed ? 'PASSED' : 'FAILED'}`);
+            console.log(`Typecheck: ${result.checks.typecheck.passed ? 'PASSED' : 'FAILED'}`);
+            console.log(`Scope: ${result.checks.scope.passed ? 'PASSED' : 'FAILED'}`);
+            if (result.checks.scope.undeclared.length > 0) {
+                console.log(`Undeclared files: ${result.checks.scope.undeclared.join(', ')}`);
+            }
+        }
+        finally {
+            cleanupWorktree(worktreePath, resolve('.'));
+        }
+    });
+}
+//# sourceMappingURL=task-ops.js.map

package/dist/commands/task-ops.js.map

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

package/dist/config.d.ts

@@ -0,0 +1,18 @@
+import { type ModelEntry, type StwConfig } from './types.js';
+import { type AgenticBackend, type AgenticBackendResolution, type AgenticRuntimeRequirement } from './agentic-types.js';
+export declare function loadConfig(configPath: string): StwConfig;
+export declare function validateConfig(raw: unknown): StwConfig;
+export declare function resolveModel(config: StwConfig, tierOrId: string): ModelEntry | null;
+export declare function getDefaultAgenticBackend(config?: StwConfig | null): AgenticBackend;
+export declare function resolveAgenticBackend(backend: AgenticBackend, config?: StwConfig | null, options?: {
+    cwd?: string;
+    pathEnv?: string;
+}): AgenticBackendResolution;
+export declare function resolveAllAgenticBackends(config?: StwConfig | null, options?: {
+    cwd?: string;
+    pathEnv?: string;
+}): AgenticBackendResolution[];
+export declare function ensureAgenticBackendAvailable(requirement: AgenticRuntimeRequirement, config?: StwConfig | null, options?: {
+    cwd?: string;
+    pathEnv?: string;
+}): AgenticBackendResolution;