@mknightzzz/stw 0.1.0

package/dist/cli.js

@@ -0,0 +1,38 @@
+#!/usr/bin/env node
+import { readFileSync } from 'node:fs';
+import { join, dirname } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { Command } from 'commander';
+import { registerSetupCommands } from './commands/setup.js';
+import { registerRunCommand } from './commands/run.js';
+import { registerExecutionCommands } from './commands/execution.js';
+import { registerTaskOpsCommands } from './commands/task-ops.js';
+import { registerIntegrationCommands } from './commands/integration.js';
+import { registerMaintenanceCommands } from './commands/maintenance.js';
+import { registerInitCommand } from './commands/init.js';
+import { registerCleanCommand } from './commands/clean.js';
+import { registerSpecCommand } from './commands/spec.js';
+import { registerStatsCommand } from './commands/stats.js';
+import { registerIdeaCommand } from './commands/idea.js';
+import { registerGoCommand } from './commands/go.js';
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const pkg = JSON.parse(readFileSync(join(__dirname, '..', 'package.json'), 'utf-8'));
+const program = new Command();
+program
+    .name('stw')
+    .description('Spec-to-Workers — turn markdown specs into reviewed, merge-ready code')
+    .version(pkg.version);
+registerSetupCommands(program);
+registerRunCommand(program);
+registerExecutionCommands(program);
+registerTaskOpsCommands(program);
+registerIntegrationCommands(program);
+registerMaintenanceCommands(program);
+registerInitCommand(program);
+registerCleanCommand(program);
+registerSpecCommand(program);
+registerStatsCommand(program);
+registerIdeaCommand(program);
+registerGoCommand(program);
+await program.parseAsync(process.argv);
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,yBAAyB,EAAE,MAAM,yBAAyB,CAAC;AACpE,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AACjE,OAAO,EAAE,2BAA2B,EAAE,MAAM,2BAA2B,CAAC;AACxE,OAAO,EAAE,2BAA2B,EAAE,MAAM,2BAA2B,CAAC;AACxE,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAErD,MAAM,SAAS,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAC1D,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,cAAc,CAAC,EAAE,OAAO,CAAC,CAAwB,CAAC;AAE5G,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAC9B,OAAO;KACJ,IAAI,CAAC,KAAK,CAAC;KACX,WAAW,CAAC,uEAAuE,CAAC;KACpF,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;AAExB,qBAAqB,CAAC,OAAO,CAAC,CAAC;AAC/B,kBAAkB,CAAC,OAAO,CAAC,CAAC;AAC5B,yBAAyB,CAAC,OAAO,CAAC,CAAC;AACnC,uBAAuB,CAAC,OAAO,CAAC,CAAC;AACjC,2BAA2B,CAAC,OAAO,CAAC,CAAC;AACrC,2BAA2B,CAAC,OAAO,CAAC,CAAC;AACrC,mBAAmB,CAAC,OAAO,CAAC,CAAC;AAC7B,oBAAoB,CAAC,OAAO,CAAC,CAAC;AAC9B,mBAAmB,CAAC,OAAO,CAAC,CAAC;AAC7B,oBAAoB,CAAC,OAAO,CAAC,CAAC;AAC9B,mBAAmB,CAAC,OAAO,CAAC,CAAC;AAC7B,iBAAiB,CAAC,OAAO,CAAC,CAAC;AAE3B,MAAM,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC"}

package/dist/command-dispatch.d.ts

@@ -0,0 +1,45 @@
+import type { SlashCommand } from './command-parser.js';
+export type CommandLifecycleStatus = 'received' | 'dispatching' | 'completed' | 'rejected' | 'failed' | 'recovered';
+export interface CommandDispatchRecord {
+    comment_id: string;
+    merge_request_id?: string | number;
+    username: string;
+    created_at: string;
+    command: SlashCommand;
+    status: CommandLifecycleStatus;
+    reason?: string;
+    result?: unknown;
+    audit_message?: string;
+    feedback_comment?: string;
+}
+export interface DispatchContext {
+    commandsFilePath: string;
+    allowedUsers: string[];
+    latestSeenCommentTimestamp?: string;
+    runId?: string;
+    stwRoot?: string;
+    runState?: string;
+    taskStates?: Record<string, string>;
+    actions?: Partial<Record<'approve-plan' | 'run-next' | 'retry' | 'escalate' | 'stop-run' | 'replan' | 'answer' | 'idea', (command: SlashCommand, entry: CommandDispatchRecord) => Promise<unknown> | unknown>>;
+    onAuditLog?: (record: CommandDispatchRecord) => Promise<void> | void;
+    onCommentFeedback?: (commentId: string, body: string, record: CommandDispatchRecord) => Promise<void> | void;
+}
+export interface DispatchInput {
+    comment_id: string;
+    merge_request_id?: string | number;
+    username: string;
+    created_at: string;
+    command: SlashCommand;
+}
+export interface DispatchResult {
+    accepted: boolean;
+    status: CommandLifecycleStatus;
+    reason?: string;
+    deduped?: boolean;
+    recovered?: number;
+    result?: unknown;
+    feedbackComment?: string;
+}
+export declare function recoverStuckDispatches(commandsFilePath: string): Promise<number>;
+export declare function dispatchCommand(context: DispatchContext, input: DispatchInput): Promise<DispatchResult>;
+export declare function rewriteCommandLog(commandsFilePath: string, records: CommandDispatchRecord[]): Promise<void>;

package/dist/command-dispatch.js

@@ -0,0 +1,206 @@
+import { appendFile, mkdir, readFile, writeFile } from 'node:fs/promises';
+import { dirname } from 'node:path';
+import { isAuthorized } from './command-parser.js';
+const RUN_STATE_CONFLICTS = {
+    'approve-plan': ['stopped'],
+    'run-next': ['stopped'],
+    'stop-run': ['stopped', 'completed'],
+    replan: ['stopped'],
+};
+const TASK_STATE_CONFLICTS = {
+    retry: ['running', 'completed'],
+    escalate: ['completed'],
+    answer: ['completed'],
+};
+function compareIsoTimestamps(a, b) {
+    const aMs = Date.parse(a);
+    const bMs = Date.parse(b);
+    if (Number.isNaN(aMs) || Number.isNaN(bMs))
+        return a.localeCompare(b);
+    return aMs - bMs;
+}
+async function ensureParentDir(filePath) {
+    await mkdir(dirname(filePath), { recursive: true });
+}
+async function appendRecord(filePath, record) {
+    await ensureParentDir(filePath);
+    await appendFile(filePath, `${JSON.stringify(record)}\n`, 'utf8');
+}
+async function readRecords(filePath) {
+    try {
+        const raw = await readFile(filePath, 'utf8');
+        return raw
+            .split('\n')
+            .map((line) => line.trim())
+            .filter(Boolean)
+            .map((line) => JSON.parse(line));
+    }
+    catch (error) {
+        if (error.code === 'ENOENT') {
+            return [];
+        }
+        throw error;
+    }
+}
+function buildFeedbackComment(status, command, reason) {
+    const label = `/${command.type}`;
+    if (status === 'rejected')
+        return `Command ${label} rejected: ${reason ?? 'rejected'}`;
+    if (status === 'failed')
+        return `Command ${label} failed: ${reason ?? 'failed'}`;
+    if (status === 'completed')
+        return `Command ${label} accepted and completed.`;
+    return undefined;
+}
+async function appendAuditedRecord(context, record) {
+    await appendRecord(context.commandsFilePath, record);
+    await context.onAuditLog?.(record);
+}
+async function emitFeedback(context, commentId, body, record) {
+    if (!body)
+        return;
+    await context.onCommentFeedback?.(commentId, body, record);
+}
+export async function recoverStuckDispatches(commandsFilePath) {
+    const records = await readRecords(commandsFilePath);
+    const finalized = new Set();
+    const stuck = [];
+    for (const record of records) {
+        if (record.status === 'completed' ||
+            record.status === 'rejected' ||
+            record.status === 'failed' ||
+            record.status === 'recovered') {
+            finalized.add(record.comment_id);
+        }
+    }
+    for (const record of records) {
+        if (record.status === 'dispatching' && !finalized.has(record.comment_id)) {
+            stuck.push(record);
+        }
+    }
+    for (const record of stuck) {
+        await appendRecord(commandsFilePath, {
+            ...record,
+            status: 'recovered',
+            reason: 'Recovered stuck dispatching command after crash',
+            audit_message: `Recovered stuck command dispatch for comment ${record.comment_id}`,
+        });
+    }
+    return stuck.length;
+}
+export async function dispatchCommand(context, input) {
+    const recovered = await recoverStuckDispatches(context.commandsFilePath);
+    const records = await readRecords(context.commandsFilePath);
+    const existingForComment = records.filter((record) => record.comment_id === input.comment_id);
+    const finalizedExisting = existingForComment.find((record) => record.status === 'completed' || record.status === 'rejected' || record.status === 'failed');
+    if (finalizedExisting) {
+        return {
+            accepted: finalizedExisting.status === 'completed',
+            status: finalizedExisting.status,
+            reason: finalizedExisting.reason,
+            deduped: true,
+            recovered,
+            result: finalizedExisting.result,
+            feedbackComment: finalizedExisting.feedback_comment,
+        };
+    }
+    const receivedEntry = {
+        comment_id: input.comment_id,
+        merge_request_id: input.merge_request_id,
+        username: input.username,
+        created_at: input.created_at,
+        command: input.command,
+        status: 'received',
+        audit_message: `Received command /${input.command.type} from ${input.username} on comment ${input.comment_id}`,
+    };
+    await appendAuditedRecord(context, receivedEntry);
+    if (!isAuthorized(input.username, context.allowedUsers)) {
+        const reason = `User ${input.username} is not authorized to run commands`;
+        const feedbackComment = buildFeedbackComment('rejected', input.command, reason);
+        const record = { ...receivedEntry, status: 'rejected', reason, feedback_comment: feedbackComment };
+        await appendAuditedRecord(context, record);
+        await emitFeedback(context, input.comment_id, feedbackComment, record);
+        return { accepted: false, status: 'rejected', reason, recovered, feedbackComment };
+    }
+    if (context.latestSeenCommentTimestamp &&
+        compareIsoTimestamps(input.created_at, context.latestSeenCommentTimestamp) < 0) {
+        const reason = 'Command is older than the latest processed comment timestamp';
+        const feedbackComment = buildFeedbackComment('rejected', input.command, reason);
+        const record = { ...receivedEntry, status: 'rejected', reason, feedback_comment: feedbackComment };
+        await appendAuditedRecord(context, record);
+        await emitFeedback(context, input.comment_id, feedbackComment, record);
+        return { accepted: false, status: 'rejected', reason, recovered, feedbackComment };
+    }
+    if (input.command.type === 'error') {
+        const reason = input.command.message ?? 'Invalid command';
+        const feedbackComment = buildFeedbackComment('rejected', input.command, reason);
+        const record = { ...receivedEntry, status: 'rejected', reason, feedback_comment: feedbackComment };
+        await appendAuditedRecord(context, record);
+        await emitFeedback(context, input.comment_id, feedbackComment, record);
+        return { accepted: false, status: 'rejected', reason, recovered, feedbackComment };
+    }
+    const runState = context.runState === 'complete' ? 'completed' : context.runState;
+    const runConflicts = runState ? RUN_STATE_CONFLICTS[input.command.type] : undefined;
+    if (runConflicts?.includes(runState)) {
+        const reason = `Command ${input.command.type} is invalid while run is ${runState}`;
+        const feedbackComment = buildFeedbackComment('rejected', input.command, reason);
+        const record = { ...receivedEntry, status: 'rejected', reason, feedback_comment: feedbackComment };
+        await appendAuditedRecord(context, record);
+        await emitFeedback(context, input.comment_id, feedbackComment, record);
+        return { accepted: false, status: 'rejected', reason, recovered, feedbackComment };
+    }
+    if (input.command.taskId && context.taskStates) {
+        const taskState = context.taskStates[input.command.taskId];
+        const normalizedTaskState = taskState === 'working' ? 'running' : taskState === 'complete' ? 'completed' : taskState;
+        const taskConflicts = TASK_STATE_CONFLICTS[input.command.type];
+        if (normalizedTaskState && taskConflicts?.includes(normalizedTaskState)) {
+            const reason = `Command ${input.command.type} is invalid for task ${input.command.taskId} in state ${normalizedTaskState}`;
+            const feedbackComment = buildFeedbackComment('rejected', input.command, reason);
+            const record = { ...receivedEntry, status: 'rejected', reason, feedback_comment: feedbackComment };
+            await appendAuditedRecord(context, record);
+            await emitFeedback(context, input.comment_id, feedbackComment, record);
+            return { accepted: false, status: 'rejected', reason, recovered, feedbackComment };
+        }
+    }
+    const dispatchingEntry = {
+        ...receivedEntry,
+        status: 'dispatching',
+        audit_message: `Dispatching command /${input.command.type} for comment ${input.comment_id}`,
+    };
+    await appendAuditedRecord(context, dispatchingEntry);
+    try {
+        const action = context.actions?.[input.command.type];
+        const result = action ? await action(input.command, dispatchingEntry) : undefined;
+        const feedbackComment = buildFeedbackComment('completed', input.command);
+        const completedRecord = {
+            ...receivedEntry,
+            status: 'completed',
+            result,
+            feedback_comment: feedbackComment,
+            audit_message: `Completed command /${input.command.type} for comment ${input.comment_id}`,
+        };
+        await appendAuditedRecord(context, completedRecord);
+        await emitFeedback(context, input.comment_id, feedbackComment, completedRecord);
+        return { accepted: true, status: 'completed', result, recovered, feedbackComment };
+    }
+    catch (error) {
+        const reason = error instanceof Error ? error.message : String(error);
+        const feedbackComment = buildFeedbackComment('failed', input.command, reason);
+        const failedRecord = {
+            ...receivedEntry,
+            status: 'failed',
+            reason,
+            feedback_comment: feedbackComment,
+            audit_message: `Failed command /${input.command.type} for comment ${input.comment_id}: ${reason}`,
+        };
+        await appendAuditedRecord(context, failedRecord);
+        await emitFeedback(context, input.comment_id, feedbackComment, failedRecord);
+        return { accepted: false, status: 'failed', reason, recovered, feedbackComment };
+    }
+}
+export async function rewriteCommandLog(commandsFilePath, records) {
+    await ensureParentDir(commandsFilePath);
+    const content = records.map((record) => JSON.stringify(record)).join('\n');
+    await writeFile(commandsFilePath, content ? `${content}\n` : '', 'utf8');
+}
+//# sourceMappingURL=command-dispatch.js.map

package/dist/command-dispatch.js.map

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

package/dist/command-parser.d.ts

@@ -0,0 +1,11 @@
+export type SlashCommandType = 'approve-plan' | 'run-next' | 'retry' | 'escalate' | 'stop-run' | 'replan' | 'answer' | 'idea' | 'error';
+export interface SlashCommand {
+    type: SlashCommandType;
+    taskId?: string;
+    provider?: string;
+    message?: string;
+    isGreenfield?: boolean;
+    stack?: string;
+}
+export declare function parseCommand(text: string): SlashCommand | null;
+export declare function isAuthorized(username: string, allowedUsers: string[]): boolean;

package/dist/command-parser.js

@@ -0,0 +1,101 @@
+const VALID_COMMANDS = [
+    'approve-plan',
+    'run-next',
+    'retry',
+    'escalate',
+    'stop-run',
+    'replan',
+    'answer',
+    'idea',
+];
+const VALID_SYNTAX = `Valid commands:
+- /approve-plan
+- /run-next
+- /retry task:<id> [provider:<name>]
+- /escalate task:<id>
+- /stop-run
+- /replan
+- /answer task:<id> <message>
+- /idea [--greenfield] [--stack <preset>] <idea>`;
+export function parseCommand(text) {
+    const firstLine = text.split('\n')[0].trim();
+    if (!firstLine.startsWith('/'))
+        return null;
+    const parts = firstLine.split(/\s+/);
+    const cmdName = parts[0].slice(1);
+    if (!VALID_COMMANDS.includes(cmdName)) {
+        return { type: 'error', message: `Unknown command "/${cmdName}". ${VALID_SYNTAX}` };
+    }
+    if (cmdName === 'approve-plan' || cmdName === 'run-next' || cmdName === 'stop-run' || cmdName === 'replan') {
+        return { type: cmdName };
+    }
+    if (cmdName === 'retry') {
+        const taskMatch = parts.find((p) => p.startsWith('task:'));
+        if (!taskMatch || !taskMatch.slice(5)) {
+            return { type: 'error', message: `/retry requires task:<id>. ${VALID_SYNTAX}` };
+        }
+        const providerMatch = parts.find((p) => p.startsWith('provider:'));
+        return {
+            type: 'retry',
+            taskId: taskMatch.slice(5),
+            provider: providerMatch?.slice(9) || undefined,
+        };
+    }
+    if (cmdName === 'escalate') {
+        const taskMatch = parts.find((p) => p.startsWith('task:'));
+        if (!taskMatch || !taskMatch.slice(5)) {
+            return { type: 'error', message: `/escalate requires task:<id>. ${VALID_SYNTAX}` };
+        }
+        return { type: 'escalate', taskId: taskMatch.slice(5) };
+    }
+    if (cmdName === 'answer') {
+        const taskMatch = parts.find((p) => p.startsWith('task:'));
+        if (!taskMatch || !taskMatch.slice(5)) {
+            return { type: 'error', message: `/answer requires task:<id> <message>. ${VALID_SYNTAX}` };
+        }
+        const taskIndex = parts.findIndex((p) => p === taskMatch);
+        const message = parts
+            .slice(taskIndex + 1)
+            .join(' ')
+            .trim();
+        if (!message) {
+            return { type: 'error', message: `/answer requires task:<id> <message>. ${VALID_SYNTAX}` };
+        }
+        return {
+            type: 'answer',
+            taskId: taskMatch.slice(5),
+            message,
+        };
+    }
+    if (cmdName === 'idea') {
+        const isGreenfield = parts.includes('--greenfield');
+        let stack;
+        const stackIndex = parts.findIndex((p) => p === '--stack');
+        if (stackIndex !== -1 && parts[stackIndex + 1]) {
+            stack = parts[stackIndex + 1];
+        }
+        const filteredFlags = new Set(['--greenfield', '--stack']);
+        const ideaParts = parts.slice(1).filter((p, i) => {
+            if (filteredFlags.has(p))
+                return false;
+            if (i > 0 && parts[i] === '--stack')
+                return false;
+            return true;
+        });
+        const idea = ideaParts.join(' ').trim();
+        if (!idea) {
+            return { type: 'error', message: `/idea requires an idea text. ${VALID_SYNTAX}` };
+        }
+        return {
+            type: 'idea',
+            message: idea,
+            isGreenfield,
+            stack,
+        };
+    }
+    return null;
+}
+export function isAuthorized(username, allowedUsers) {
+    return allowedUsers.includes(username);
+}
+//# sourceMappingURL=command-parser.js.map

package/dist/command-parser.js.map

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

package/dist/commands/clean.d.ts

@@ -0,0 +1,10 @@
+import type { Command } from 'commander';
+export interface CleanResult {
+    branchesDeleted: number;
+    worktreesRemoved: number;
+    remoteBranchesDeleted: number;
+}
+export declare function cleanupRun(stwRoot: string, repoRoot: string, runId: string, opts?: {
+    remote?: string;
+}): CleanResult;
+export declare function registerCleanCommand(program: Command): void;

package/dist/commands/clean.js

@@ -0,0 +1,133 @@
+import { execFileSync } from 'node:child_process';
+import { existsSync, readdirSync, rmSync } from 'node:fs';
+import { join, resolve } from 'node:path';
+import { readJson, fileExists, runDir } from '../storage.js';
+import { getStwRoot } from './helpers.js';
+const BLOCKED_STATES = ['running', 'paused'];
+function getManifest(stwRoot, runId) {
+    const manifestPath = join(runDir(stwRoot, runId), 'manifest.json');
+    if (!fileExists(manifestPath)) {
+        return null;
+    }
+    return readJson(manifestPath);
+}
+function listBranchesForRun(repoRoot, runId) {
+    const execOpts = { cwd: repoRoot, encoding: 'utf-8', stdio: 'pipe' };
+    let output;
+    try {
+        output = execFileSync('git', ['branch', '--list'], execOpts);
+    }
+    catch {
+        return [];
+    }
+    const escapedRunId = runId.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+    const pattern = new RegExp(`^ai/${escapedRunId}`);
+    return output
+        .trim()
+        .split('\n')
+        .map((line) => line.trim().replace(/^[*+]\s*/, ''))
+        .filter((branch) => branch !== '' && pattern.test(branch));
+}
+function deleteLocalBranch(repoRoot, branch) {
+    const execOpts = { cwd: repoRoot, encoding: 'utf-8', stdio: 'pipe' };
+    try {
+        execFileSync('git', ['branch', '-D', branch], execOpts);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function deleteRemoteBranch(repoRoot, remote, branch) {
+    const execOpts = { cwd: repoRoot, encoding: 'utf-8', stdio: 'pipe' };
+    try {
+        execFileSync('git', ['push', remote, '--delete', branch], execOpts);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function listWorktreesForRun(runId) {
+    const tmpDir = '/tmp';
+    if (!existsSync(tmpDir)) {
+        return [];
+    }
+    const escapedRunId = runId.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+    const pattern = new RegExp(`stw-worktree-.*${escapedRunId}`);
+    const entries = [];
+    try {
+        for (const entry of readdirSync(tmpDir, { withFileTypes: true })) {
+            if (entry.isDirectory() && pattern.test(entry.name)) {
+                entries.push(join(tmpDir, entry.name));
+            }
+        }
+    }
+    catch {
+        return [];
+    }
+    return entries;
+}
+function removeWorktree(worktreePath) {
+    try {
+        rmSync(worktreePath, { recursive: true, force: true });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export function cleanupRun(stwRoot, repoRoot, runId, opts) {
+    const result = {
+        branchesDeleted: 0,
+        worktreesRemoved: 0,
+        remoteBranchesDeleted: 0,
+    };
+    const branches = listBranchesForRun(repoRoot, runId);
+    for (const branch of branches) {
+        if (deleteLocalBranch(repoRoot, branch)) {
+            result.branchesDeleted++;
+        }
+    }
+    const worktrees = listWorktreesForRun(runId);
+    for (const wt of worktrees) {
+        if (removeWorktree(wt)) {
+            result.worktreesRemoved++;
+        }
+    }
+    if (opts?.remote) {
+        for (const branch of branches) {
+            if (deleteRemoteBranch(repoRoot, opts.remote, branch)) {
+                result.remoteBranchesDeleted++;
+            }
+        }
+    }
+    return result;
+}
+export function registerCleanCommand(program) {
+    program
+        .command('clean <run-id>')
+        .description('Clean up local branches and worktrees for a run')
+        .option('--remote <remote>', 'Also delete remote branches from the specified remote')
+        .action((runId, opts) => {
+        const stwRoot = getStwRoot();
+        const repoRoot = resolve('.');
+        const manifest = getManifest(stwRoot, runId);
+        if (!manifest) {
+            console.error(`Run not found: ${runId}`);
+            process.exit(1);
+        }
+        if (BLOCKED_STATES.includes(manifest.status)) {
+            console.error(`Cannot clean run in state '${manifest.status}'`);
+            process.exit(1);
+        }
+        const result = cleanupRun(stwRoot, repoRoot, runId, opts);
+        console.log(`Cleaned run ${runId}:`);
+        console.log(`  Deleted ${result.branchesDeleted} local branch(es)`);
+        console.log(`  Removed ${result.worktreesRemoved} worktree(s)`);
+        if (opts.remote) {
+            console.log(`  Deleted ${result.remoteBranchesDeleted} remote branch(es)`);
+        }
+    });
+}
+//# sourceMappingURL=clean.js.map

package/dist/commands/clean.js.map

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

package/dist/commands/execution.d.ts

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