@mknightzzz/stw 0.1.0

package/dist/commands/run.js

@@ -0,0 +1,356 @@
+import { execFileSync } from 'node:child_process';
+import { existsSync, writeFileSync } from 'node:fs';
+import { join, resolve } from 'node:path';
+import { loadConfig } from '../config.js';
+import { getSkippableDescendantTaskIds } from '../task-graph.js';
+import { writeTaskStatus, readTaskStatus, writeRunState } from '../status.js';
+import { readJson, writeJson, fileExists, runDir, taskDir } from '../storage.js';
+import { executeTask } from '../task-executor.js';
+import { acquireLock, releaseLock } from '../lock.js';
+import { createLogger } from '../logger.js';
+import { loadCosts } from '../cost.js';
+import { createCommitStatus } from '../gitlab.js';
+import { claimTask, releaseClaim } from '../claim.js';
+import { pollAndDispatch } from '../poller.js';
+import { checkDrift } from '../drift.js';
+import { syncRunToGitlab } from '../run-sync.js';
+import { buildProgressState, renderProgress } from '../progress.js';
+import { recoverOrphanedTasks } from '../crash-recovery.js';
+import { cleanupRun } from './clean.js';
+import { getStwRoot } from './helpers.js';
+import { generateScorecard, formatScorecard, writeScorecard } from '../scorecard.js';
+import { findReadyTasks, executeBatch } from '../parallel.js';
+function processBatchResults(batchResults, graph, stwRoot, runId) {
+    let count = 0;
+    for (const { task, result } of batchResults) {
+        const taskCosts = loadCosts(stwRoot, runId);
+        const taskCostUsd = taskCosts?.task_costs[task.id] ?? 0;
+        console.log(`Task ${task.id} result: ${result.finalState} | attempts: ${result.attempts} | cost: $${taskCostUsd.toFixed(4)}`);
+        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,
+        });
+        releaseClaim(stwRoot, runId, task.id);
+        if (result.finalState !== 'complete') {
+            const currentStates = new Map();
+            for (const t of graph.tasks) {
+                const st = readTaskStatus(stwRoot, runId, t.id);
+                currentStates.set(t.id, st?.status ?? t.state);
+            }
+            const toSkip = getSkippableDescendantTaskIds(graph, task.id, currentStates);
+            for (const skipId of toSkip) {
+                writeTaskStatus(stwRoot, runId, skipId, {
+                    agent_id: 'stw-executor',
+                    status: 'skipped',
+                    notes: `Skipped: upstream ${task.id} ${result.finalState}`,
+                });
+            }
+            if (toSkip.length > 0) {
+                console.log(`Skipped ${toSkip.length} downstream task(s): ${toSkip.join(', ')}`);
+            }
+        }
+        count++;
+    }
+    return count;
+}
+function mapExecutionResultToStatus(finalState) {
+    switch (finalState) {
+        case 'complete':
+            return 'complete';
+        case 'escalated':
+            return 'escalated';
+        case 'rejected':
+            return 'failed';
+        case 'stopped':
+            return 'escalated';
+    }
+}
+export function registerRunCommand(program) {
+    program
+        .command('run <run-id>')
+        .description('Execute tasks from the task graph (loops all ready tasks unless --once)')
+        .option('--once', 'Execute only the next ready task, then exit')
+        .option('--skip-budget-check', 'Skip budget check and allow over-budget execution')
+        .option('--timeout <seconds>', 'Override task timeout in seconds', parseInt)
+        .option('--no-progress', 'Disable progress bar display')
+        .option('--verbose', 'Stream worker output to console')
+        .action(async (runId, opts) => {
+        const stwRoot = getStwRoot();
+        const graphPath = join(stwRoot, 'runs', runId, 'task_graph.json');
+        const assignmentsPath = join(stwRoot, 'runs', runId, 'assignments.json');
+        const runStartTime = Date.now();
+        if (!fileExists(graphPath)) {
+            console.error(`No task graph found for run ${runId}`);
+            process.exit(1);
+        }
+        if (!fileExists(assignmentsPath)) {
+            console.error(`No assignments found for run ${runId}`);
+            process.exit(1);
+        }
+        const graph = readJson(graphPath);
+        const config = loadConfig(join(stwRoot, 'config.yml'));
+        const manifestPath = join(runDir(stwRoot, runId), 'manifest.json');
+        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);
+        }
+        let shuttingDown = false;
+        const stopSentinelPath = join(runDir(stwRoot, runId), 'STOP');
+        const handleShutdownSignal = (signal) => {
+            if (shuttingDown)
+                return;
+            shuttingDown = true;
+            console.log(`\n[run] Received ${signal}, shutting down gracefully...`);
+            try {
+                writeFileSync(stopSentinelPath, `${signal} at ${new Date().toISOString()}\n`);
+            }
+            catch { }
+            try {
+                writeRunState(stwRoot, runId, 'paused', { pause_reason: 'signal_received' });
+            }
+            catch { }
+        };
+        process.on('SIGINT', () => handleShutdownSignal('SIGINT'));
+        process.on('SIGTERM', () => handleShutdownSignal('SIGTERM'));
+        try {
+            writeRunState(stwRoot, runId, 'running');
+        }
+        catch (err) {
+            console.warn(`[run] Failed to set run state to running: ${err instanceof Error ? err.message : String(err)}`);
+        }
+        const recoveryResult = recoverOrphanedTasks(stwRoot, runId, graph);
+        if (recoveryResult.recoveredTasks.length > 0) {
+            console.log(`Recovered ${recoveryResult.recoveredTasks.length} orphaned task(s): ${recoveryResult.recoveredTasks.map((t) => t.taskId).join(', ')}`);
+        }
+        // Display initial progress
+        if (!opts.noProgress) {
+            const progressState = buildProgressState({ stwRoot, runId, startTime: runStartTime });
+            if (progressState) {
+                console.log('\n' + renderProgress(progressState) + '\n');
+            }
+        }
+        const logger = createLogger(join(runDir(stwRoot, runId), 'logs.ndjson'), runId);
+        const head = execFileSync('git', ['rev-parse', 'HEAD'], {
+            cwd: resolve('.'),
+            encoding: 'utf-8',
+            stdio: 'pipe',
+        }).trim();
+        const onPhaseChange = (() => {
+            const manifest = readJson(manifestPath);
+            return manifest.pr_number
+                ? (taskId, phase, state) => {
+                    try {
+                        createCommitStatus({
+                            repoRoot: resolve('.'),
+                            sha: head,
+                            state,
+                            name: phase,
+                            description: `Task ${taskId} ${state}`,
+                        });
+                    }
+                    catch {
+                        // Commit status is best-effort — don't crash the executor
+                    }
+                }
+                : undefined;
+        })();
+        try {
+            let executed = 0;
+            let progress = true;
+            while (progress && !shuttingDown) {
+                progress = false;
+                const manifest = readJson(manifestPath);
+                if (manifest.pr_number) {
+                    const taskStates = {};
+                    for (const task of graph.tasks) {
+                        const status = readTaskStatus(stwRoot, runId, task.id);
+                        taskStates[task.id] = status?.status ?? task.state;
+                    }
+                    const pollResult = await pollAndDispatch({
+                        repoRoot: resolve('.'),
+                        mrIid: manifest.pr_number,
+                        since: manifest.created_at,
+                        allowedUsers: config.gitlab?.allowed_command_users ?? [],
+                        afterCommentId: manifest.last_polled_comment_id,
+                        dispatchContext: {
+                            commandsFilePath: join(runDir(stwRoot, runId), 'commands.ndjson'),
+                            allowedUsers: config.gitlab?.allowed_command_users ?? [],
+                            runId,
+                            stwRoot,
+                            runState: manifest.status,
+                            taskStates,
+                        },
+                    });
+                    if (pollResult.commands.length > 0 || pollResult.unauthorized.length > 0) {
+                        progress = true;
+                    }
+                    if (pollResult.lastAppliedCommentId != null) {
+                        const updatedManifest = readJson(manifestPath);
+                        updatedManifest.last_polled_comment_id = pollResult.lastAppliedCommentId;
+                        writeJson(manifestPath, updatedManifest);
+                    }
+                }
+                const maxConcurrent = config.defaults.max_concurrent_workers ?? 1;
+                const readyTasks = findReadyTasks(graph, stwRoot, runId);
+                if (readyTasks.length === 0 || shuttingDown)
+                    break;
+                const batch = readyTasks.slice(0, opts.once ? 1 : maxConcurrent);
+                const useParallel = batch.length > 1;
+                // Claim all tasks in the batch
+                const claimedTasks = [];
+                for (const { task } of batch) {
+                    if (shuttingDown)
+                        break;
+                    const claim = await claimTask(stwRoot, runId, task.id, 'stw-executor');
+                    if (!claim.claimed) {
+                        console.log(`Task ${task.id} already claimed by ${claim.holder}, skipping`);
+                        continue;
+                    }
+                    claimedTasks.push(task);
+                }
+                if (claimedTasks.length === 0)
+                    break;
+                const manifestForTask = readJson(manifestPath);
+                const baseOpts = {
+                    repoRoot: resolve('.'),
+                    runBranch: manifestForTask.branch,
+                    resume: false,
+                    stwRoot,
+                    runId,
+                    logger,
+                    pricing: config.pricing,
+                    budget: opts.skipBudgetCheck ? undefined : config.budget,
+                    onPhaseChange,
+                    stopCheck: () => existsSync(stopSentinelPath),
+                    verbose: opts.verbose,
+                    greenfield: manifestForTask.greenfield,
+                    seedDir: manifestForTask.seedDir,
+                };
+                let batchResults;
+                if (useParallel) {
+                    console.log(`Executing ${claimedTasks.length} tasks in parallel: ${claimedTasks.map((t) => t.id).join(', ')}`);
+                    batchResults = await executeBatch({
+                        tasks: claimedTasks,
+                        config,
+                        baseOptions: baseOpts,
+                        taskDirFn: (id) => taskDir(stwRoot, runId, id),
+                        logger,
+                    });
+                }
+                else {
+                    const task = claimedTasks[0];
+                    console.log(`Executing task: ${task.id}`);
+                    const result = await executeTask(task, config, {
+                        ...baseOpts,
+                        taskDir: taskDir(stwRoot, runId, task.id),
+                    });
+                    batchResults = [{ task, result, taskDir: taskDir(stwRoot, runId, task.id) }];
+                }
+                executed += processBatchResults(batchResults, graph, stwRoot, runId);
+                progress = batchResults.length > 0;
+                // Display progress after batch
+                if (!opts.noProgress) {
+                    const progressState = buildProgressState({ stwRoot, runId, startTime: runStartTime });
+                    if (progressState) {
+                        console.log('\n' + renderProgress(progressState) + '\n');
+                    }
+                }
+                try {
+                    const costs = loadCosts(stwRoot, runId);
+                    const manifestForSync = readJson(manifestPath);
+                    syncRunToGitlab({
+                        stwRoot,
+                        runId,
+                        config,
+                        manifest: manifestForSync,
+                        manifestPath: join(runDir(stwRoot, runId), 'manifest.json'),
+                        graph,
+                        costs,
+                    });
+                }
+                catch {
+                    // GitLab sync is best-effort — don't crash the executor
+                }
+                if (opts.once) {
+                    console.log('--once flag set, stopping after first task');
+                    return;
+                }
+            }
+            if (executed === 0) {
+                console.log('No ready tasks found');
+            }
+            else {
+                const finalCosts = loadCosts(stwRoot, runId);
+                const totalUsd = finalCosts?.total_cost_usd ?? 0;
+                console.log(`Run complete: ${executed} task(s) executed | total cost: $${totalUsd.toFixed(4)}`);
+            }
+            const taskStates = graph.tasks.map((t) => {
+                const st = readTaskStatus(stwRoot, runId, t.id);
+                return st?.status ?? t.state;
+            });
+            const hasEscalated = taskStates.some((s) => s === 'escalated' || s === 'failed' || s === 'rejected');
+            const allComplete = taskStates.every((s) => s === 'complete');
+            let driftDetected = false;
+            try {
+                const currentManifest = readJson(manifestPath);
+                const driftResult = checkDrift({
+                    repoRoot: resolve('.'),
+                    baseBranch: currentManifest.base_branch,
+                    runBranch: currentManifest.branch,
+                });
+                driftDetected = driftResult.hasConflicts;
+                if (driftDetected) {
+                    console.log(`Drift detected: ${driftResult.conflictFiles.join(', ')}`);
+                }
+            }
+            catch {
+                // Drift check is best-effort
+            }
+            try {
+                if (allComplete) {
+                    writeRunState(stwRoot, runId, 'complete');
+                }
+                else if (hasEscalated) {
+                    writeRunState(stwRoot, runId, 'human_review_required');
+                }
+            }
+            catch (err) {
+                console.warn(`[run] Failed to set final run state: ${err instanceof Error ? err.message : String(err)}`);
+            }
+            try {
+                const cleanResult = cleanupRun(stwRoot, resolve('.'), runId);
+                if (cleanResult.worktreesRemoved > 0 || cleanResult.branchesDeleted > 0) {
+                    console.log(`[run] Cleaned run ${runId}: ${cleanResult.branchesDeleted} branch(es), ${cleanResult.worktreesRemoved} worktree(s)`);
+                }
+            }
+            catch (err) {
+                console.warn(`[run] Failed to clean run ${runId}: ${err instanceof Error ? err.message : String(err)}`);
+            }
+            if (driftDetected) {
+                try {
+                    const m = readJson(manifestPath);
+                    m.drift_detected = true;
+                    writeJson(manifestPath, m);
+                }
+                catch { }
+            }
+            try {
+                const scorecard = generateScorecard(stwRoot, runId);
+                const formatted = formatScorecard(scorecard);
+                console.log('\n' + formatted);
+                writeScorecard(stwRoot, runId, scorecard);
+            }
+            catch (err) {
+                console.warn(`[run] Failed to generate scorecard: ${err instanceof Error ? err.message : String(err)}`);
+            }
+        }
+        finally {
+            releaseLock(stwRoot);
+        }
+    });
+}
+//# sourceMappingURL=run.js.map

package/dist/commands/run.js.map

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

package/dist/commands/setup.d.ts

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

package/dist/commands/setup.js

@@ -0,0 +1,198 @@
+import { readFileSync } from 'node:fs';
+import { join, resolve } from 'node:path';
+import { replanRun } from '../run.js';
+import { loadConfig } from '../config.js';
+import { validateTaskGraph } from '../task-graph.js';
+import { generateAssignments } from '../assignments.js';
+import { renderInboxes } from '../inbox-renderer.js';
+import { readJson, writeJson, writeAtomic, ensureDir, runDir } from '../storage.js';
+import { estimateCost, recordCost } from '../cost.js';
+import { generatePlan, validatePlanScope } from '../planner.js';
+import { getStwRoot, ingestRunFromContext } from './helpers.js';
+export function registerSetupCommands(program) {
+    program
+        .command('ingest <spec-path>')
+        .description('Validate a spec and create a run')
+        .action((specPath) => {
+        const stwRoot = getStwRoot();
+        const result = ingestRunFromContext({
+            repoRoot: resolve('.'),
+            stwRoot,
+            fallbackSpecPath: specPath,
+        });
+        if (!result.ok || !result.manifest) {
+            console.error(result.message);
+            for (const detail of result.details ?? []) {
+                console.error(`  - ${detail}`);
+            }
+            process.exit(1);
+        }
+        console.log(`Run created: ${result.manifest.run_id}`);
+        console.log(`Status: ${result.manifest.status}`);
+        console.log(`Branch: ${result.manifest.branch}`);
+        for (const detail of result.details ?? []) {
+            if (detail.startsWith('Spec warning:') || detail.startsWith('Setup warning:')) {
+                console.warn(`  - ${detail}`);
+            }
+        }
+    });
+    program
+        .command('plan <run-id> <task-graph-path>')
+        .description('Load and validate a task graph for a run')
+        .action((runId, graphPath) => {
+        const graph = readJson(resolve(graphPath));
+        const result = validateTaskGraph(graph);
+        if (!result.valid) {
+            console.error('Task graph validation failed:');
+            for (const e of result.errors)
+                console.error(`  - ${e}`);
+            process.exit(1);
+        }
+        if (result.warnings.length > 0) {
+            console.warn('Task graph warnings:');
+            for (const warning of result.warnings)
+                console.warn(`  - ${warning}`);
+        }
+        const stwRoot = getStwRoot();
+        const dest = join(stwRoot, 'runs', runId, 'task_graph.json');
+        writeJson(dest, { ...graph, run_id: runId });
+        console.log(`Task graph loaded: ${result.executionOrder.length} tasks`);
+        console.log(`Execution order: ${result.executionOrder.join(' → ')}`);
+    });
+    program
+        .command('plan-auto <run-id>')
+        .description('Generate a task graph for a run with the planner model')
+        .action(async (runId) => {
+        const stwRoot = getStwRoot();
+        const manifest = readJson(join(runDir(stwRoot, runId), 'manifest.json'));
+        const config = loadConfig(join(stwRoot, 'config.yml'));
+        const specPath = resolve(manifest.repo_root, manifest.spec_path);
+        const spec = readFileSync(specPath, 'utf-8');
+        const result = await generatePlan({
+            spec,
+            repoRoot: manifest.repo_root,
+            config,
+            runId,
+        });
+        if (result.warnings.length > 0) {
+            console.warn('Planner warnings:');
+            for (const warning of result.warnings) {
+                console.warn(`  - ${warning}`);
+            }
+        }
+        const scopeValidation = validatePlanScope(result.task_graph, manifest.repo_root, {
+            max_scope_files_per_task: config.defaults.max_scope_files_per_task,
+            max_tasks_per_spec: config.defaults.max_tasks_per_spec,
+        });
+        if (scopeValidation.warnings.length > 0) {
+            console.warn('Plan scope warnings:');
+            for (const warning of scopeValidation.warnings) {
+                console.warn(`  - ${warning}`);
+            }
+        }
+        if (!scopeValidation.valid) {
+            console.error('Plan scope validation failed:');
+            for (const error of scopeValidation.errors) {
+                console.error(`  - ${error}`);
+            }
+            process.exit(1);
+            return;
+        }
+        writeJson(join(stwRoot, 'runs', runId, 'task_graph.json'), result.task_graph);
+        if (result.usage && config.pricing) {
+            const plannerModel = result.model ?? 'unknown';
+            const plannerCostUsd = estimateCost(config.pricing, plannerModel, result.usage.input_tokens, result.usage.output_tokens);
+            try {
+                recordCost(stwRoot, runId, '_planner', {
+                    task_id: '_planner',
+                    model: plannerModel,
+                    provider: 'unknown',
+                    input_tokens: result.usage.input_tokens,
+                    output_tokens: result.usage.output_tokens,
+                    cost_usd: plannerCostUsd,
+                    tier: 'strong',
+                    latency_ms: result.latency_ms ?? 0,
+                });
+                console.log(`Planner cost: $${plannerCostUsd.toFixed(4)}`);
+            }
+            catch (error) {
+                console.warn(`Failed to record planner cost: ${error instanceof Error ? error.message : String(error)}`);
+            }
+        }
+        console.log(`Task graph generated: ${result.task_graph.tasks.length} tasks`);
+        console.log(`Tasks: ${result.task_graph.tasks.map((task) => task.id).join(', ')}`);
+    });
+    program
+        .command('replan <run-id>')
+        .description('Regenerate the task graph for a run while preserving completed tasks')
+        .option('--agents <path>', 'Path to agents JSON file')
+        .action(async (runId, opts) => {
+        const agents = opts.agents ? readJson(resolve(opts.agents)) : undefined;
+        try {
+            const result = await replanRun({
+                stwRoot: getStwRoot(),
+                runId,
+                agents,
+            });
+            console.log(`Replanned run: ${runId}`);
+            console.log(`Completed tasks preserved: ${result.completedTaskIds.length}`);
+            if (result.completedTaskIds.length > 0) {
+                console.log(`Preserved IDs: ${result.completedTaskIds.join(', ')}`);
+            }
+            console.log(`New task graph written: ${result.taskGraph.tasks.length} tasks`);
+            console.log('Assignments regenerated');
+            console.log(`Status: ${result.manifest.status}`);
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            console.error(`replan failed: ${message}`);
+            process.exit(1);
+        }
+    });
+    program
+        .command('assign <run-id>')
+        .description('Generate assignments from task graph and agent config')
+        .option('--agents <path>', 'Path to agents JSON file')
+        .action((runId, opts) => {
+        const stwRoot = getStwRoot();
+        const graphPath = join(stwRoot, 'runs', runId, 'task_graph.json');
+        const graph = readJson(graphPath);
+        const config = loadConfig(join(stwRoot, 'config.yml'));
+        let agents;
+        if (opts.agents) {
+            agents = readJson(resolve(opts.agents));
+        }
+        else {
+            agents = [
+                { agent_id: 'agent-strong-1', tool: 'claude-code', model: 'opus-4.6', tier: 'strong' },
+                { agent_id: 'agent-medium-1', tool: 'opencode', model: 'gpt-5.4', tier: 'medium' },
+                { agent_id: 'agent-cheap-1', tool: 'opencode', model: 'minimax-2.5', tier: 'cheap' },
+            ];
+        }
+        const result = generateAssignments(graph, agents, config);
+        if (result.warnings.length > 0) {
+            console.warn('Warnings:');
+            for (const w of result.warnings)
+                console.warn(`  - ${w}`);
+        }
+        const dest = join(stwRoot, 'runs', runId, 'assignments.json');
+        writeJson(dest, result.assignments);
+        console.log(`Assignments written: ${result.assignments.assignments.length} tasks assigned`);
+    });
+    program
+        .command('inbox <run-id>')
+        .description('Render per-agent inbox markdown from assignments')
+        .action((runId) => {
+        const stwRoot = getStwRoot();
+        const assignments = readJson(join(stwRoot, 'runs', runId, 'assignments.json'));
+        const graph = readJson(join(stwRoot, 'runs', runId, 'task_graph.json'));
+        const inboxes = renderInboxes(assignments, graph);
+        const inboxDir = join(stwRoot, 'runs', runId, 'inboxes');
+        ensureDir(inboxDir);
+        for (const [agentId, content] of Object.entries(inboxes)) {
+            writeAtomic(join(inboxDir, `${agentId}.md`), content);
+            console.log(`Wrote inbox: ${agentId}.md`);
+        }
+    });
+}
+//# sourceMappingURL=setup.js.map

package/dist/commands/setup.js.map

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

package/dist/commands/spec.d.ts

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

package/dist/commands/spec.js

@@ -0,0 +1,35 @@
+import { resolve, dirname } from 'node:path';
+import { mkdirSync } from 'node:fs';
+import { getTemplate, listTemplates } from '../spec-templates.js';
+import { writeAtomic } from '../storage.js';
+export function registerSpecCommand(program) {
+    const spec = program.command('spec').description('Spec template utilities');
+    spec
+        .command('list')
+        .description('List available spec templates')
+        .action(() => {
+        const templates = listTemplates();
+        console.log('Available templates:');
+        for (const name of templates) {
+            console.log(`  ${name}`);
+        }
+    });
+    spec
+        .command('new')
+        .description('Create a new spec from a template')
+        .requiredOption('--template <name>', 'Template name (bugfix, feature, refactor, cleanup)')
+        .option('--output <path>', 'Output file path', 'specs/untitled.md')
+        .action((opts) => {
+        const template = getTemplate(opts.template);
+        if (!template) {
+            console.error(`Unknown template: ${opts.template}`);
+            console.error(`Available: ${listTemplates().join(', ')}`);
+            process.exit(1);
+        }
+        const outputPath = resolve(opts.output);
+        mkdirSync(dirname(outputPath), { recursive: true });
+        writeAtomic(outputPath, template);
+        console.log(`Spec created: ${outputPath}`);
+    });
+}
+//# sourceMappingURL=spec.js.map

package/dist/commands/spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec.js","sourceRoot":"","sources":["../../src/commands/spec.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACpC,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAClE,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE5C,MAAM,UAAU,mBAAmB,CAAC,OAAgB;IAClD,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,WAAW,CAAC,yBAAyB,CAAC,CAAC;IAE5E,IAAI;SACD,OAAO,CAAC,MAAM,CAAC;SACf,WAAW,CAAC,+BAA+B,CAAC;SAC5C,MAAM,CAAC,GAAG,EAAE;QACX,MAAM,SAAS,GAAG,aAAa,EAAE,CAAC;QAClC,OAAO,CAAC,GAAG,CAAC,sBAAsB,CAAC,CAAC;QACpC,KAAK,MAAM,IAAI,IAAI,SAAS,EAAE,CAAC;YAC7B,OAAO,CAAC,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;QAC3B,CAAC;IACH,CAAC,CAAC,CAAC;IAEL,IAAI;SACD,OAAO,CAAC,KAAK,CAAC;SACd,WAAW,CAAC,mCAAmC,CAAC;SAChD,cAAc,CAAC,mBAAmB,EAAE,oDAAoD,CAAC;SACzF,MAAM,CAAC,iBAAiB,EAAE,kBAAkB,EAAE,mBAAmB,CAAC;SAClE,MAAM,CAAC,CAAC,IAA0C,EAAE,EAAE;QACrD,MAAM,QAAQ,GAAG,WAAW,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC5C,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,OAAO,CAAC,KAAK,CAAC,qBAAqB,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;YACpD,OAAO,CAAC,KAAK,CAAC,cAAc,aAAa,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAC1D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QAED,MAAM,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACxC,SAAS,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACpD,WAAW,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;QAClC,OAAO,CAAC,GAAG,CAAC,iBAAiB,UAAU,EAAE,CAAC,CAAC;IAC7C,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/commands/stats.d.ts

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