@blockspool/cli 0.4.1 → 0.4.3

package/dist/lib/solo-ticket.js

@@ -0,0 +1,850 @@
+/**
+ * Solo mode ticket execution
+ */
+import * as path from 'node:path';
+import * as fs from 'node:fs';
+import { spawn } from 'node:child_process';
+import { runQa, getQaRunDetails, } from '@blockspool/core/services';
+import { projects, runSteps } from '@blockspool/core/repos';
+import { writeJsonArtifact, } from '../lib/artifacts.js';
+import { checkScopeViolations, parseChangedFiles, analyzeViolationsForExpansion, } from '../lib/scope.js';
+import { checkSpindleLoop, createSpindleState, DEFAULT_SPINDLE_CONFIG, formatSpindleResult, } from '../lib/spindle.js';
+import { createExecRunner } from '../lib/exec.js';
+import { createLogger } from '../lib/logger.js';
+import { getBlockspoolDir } from './solo-config.js';
+import { normalizeQaConfig } from './solo-utils.js';
+import { withGitMutex, gitExec, cleanupWorktree } from './solo-git.js';
+import { generateSpindleRecommendations } from './solo-ci.js';
+/**
+ * Exit codes for solo run
+ */
+export const EXIT_CODES = {
+    SUCCESS: 0,
+    FAILURE: 1,
+    SPINDLE_ABORT: 2,
+    SIGINT: 130,
+};
+/**
+ * Execution step definitions
+ */
+const EXECUTE_STEPS = [
+    { name: 'worktree', kind: 'git' },
+    { name: 'agent', kind: 'internal' },
+    { name: 'scope', kind: 'internal' },
+    { name: 'commit', kind: 'git' },
+    { name: 'push', kind: 'git' },
+    { name: 'qa', kind: 'command' },
+    { name: 'pr', kind: 'git' },
+    { name: 'cleanup', kind: 'internal' },
+];
+/**
+ * Build the prompt for Claude from a ticket
+ */
+export function buildTicketPrompt(ticket, guidelinesContext) {
+    const parts = [];
+    if (guidelinesContext) {
+        parts.push(guidelinesContext, '');
+    }
+    parts.push(`# Task: ${ticket.title}`, '', ticket.description ?? '', '');
+    if (ticket.allowedPaths.length > 0) {
+        parts.push('## Allowed Paths');
+        parts.push('Only modify files in these paths:');
+        for (const p of ticket.allowedPaths) {
+            parts.push(`- ${p}`);
+        }
+        parts.push('');
+    }
+    if (ticket.forbiddenPaths.length > 0) {
+        parts.push('## Forbidden Paths');
+        parts.push('Do NOT modify files in these paths:');
+        for (const p of ticket.forbiddenPaths) {
+            parts.push(`- ${p}`);
+        }
+        parts.push('');
+    }
+    if (ticket.verificationCommands.length > 0) {
+        parts.push('## Verification');
+        parts.push('After making changes, verify with:');
+        for (const cmd of ticket.verificationCommands) {
+            parts.push(`- \`${cmd}\``);
+        }
+        parts.push('');
+    }
+    parts.push('## Instructions');
+    parts.push('1. Analyze the codebase to understand the context');
+    parts.push('2. Implement the required changes');
+    parts.push('3. Ensure all verification commands pass');
+    parts.push('4. Keep changes minimal and focused');
+    return parts.join('\n');
+}
+/**
+ * Claude Code CLI execution backend (default)
+ */
+export class ClaudeExecutionBackend {
+    name = 'claude';
+    run(opts) {
+        return runClaude(opts);
+    }
+}
+/**
+ * Codex CLI execution backend
+ *
+ * Default: `--sandbox workspace-write --ask-for-approval never` (safe unattended mode).
+ * Optional: `unsafeBypassSandbox` enables `--dangerously-bypass-approvals-and-sandbox`
+ * for use inside externally hardened/isolated runners only.
+ */
+export class CodexExecutionBackend {
+    name = 'codex';
+    apiKey;
+    model;
+    unsafeBypassSandbox;
+    constructor(opts) {
+        this.apiKey = opts?.apiKey;
+        this.model = opts?.model ?? 'gpt-5.2-codex';
+        this.unsafeBypassSandbox = opts?.unsafeBypassSandbox ?? false;
+    }
+    async run(opts) {
+        const { worktreePath, prompt, timeoutMs, verbose, onProgress } = opts;
+        const startTime = Date.now();
+        const { mkdtempSync, readFileSync, rmSync } = await import('node:fs');
+        const { tmpdir } = await import('node:os');
+        const { join } = await import('node:path');
+        const tmpDir = mkdtempSync(join(tmpdir(), 'blockspool-codex-exec-'));
+        const outPath = join(tmpDir, 'output.md');
+        try {
+            return await new Promise((resolve) => {
+                const args = ['exec', '--json', '--output-last-message', outPath];
+                if (this.unsafeBypassSandbox) {
+                    args.push('--dangerously-bypass-approvals-and-sandbox');
+                }
+                else {
+                    args.push('--sandbox', 'workspace-write');
+                    args.push('--ask-for-approval', 'never');
+                }
+                args.push('--model', this.model);
+                args.push('--cd', worktreePath);
+                args.push('-');
+                const env = { ...process.env };
+                if (this.apiKey) {
+                    env.CODEX_API_KEY = this.apiKey;
+                }
+                const proc = spawn('codex', args, {
+                    cwd: worktreePath,
+                    env,
+                    stdio: ['pipe', 'pipe', 'pipe'],
+                });
+                let stdout = '';
+                let stderr = '';
+                let timedOut = false;
+                const timer = setTimeout(() => {
+                    timedOut = true;
+                    proc.kill('SIGTERM');
+                    setTimeout(() => proc.kill('SIGKILL'), 5000);
+                }, timeoutMs);
+                proc.stdin.write(prompt);
+                proc.stdin.end();
+                proc.stdout.on('data', (data) => {
+                    const text = data.toString();
+                    stdout += text;
+                    if (verbose) {
+                        onProgress(text.trim().slice(0, 100));
+                    }
+                });
+                proc.stderr.on('data', (data) => {
+                    stderr += data.toString();
+                });
+                proc.on('close', (code) => {
+                    clearTimeout(timer);
+                    const durationMs = Date.now() - startTime;
+                    if (timedOut) {
+                        resolve({ success: false, error: `Timed out after ${timeoutMs}ms`, stdout, stderr, exitCode: code, timedOut: true, durationMs });
+                        return;
+                    }
+                    // Prefer --output-last-message file over stdout (stdout is JSONL telemetry)
+                    let output = stdout;
+                    try {
+                        output = readFileSync(outPath, 'utf-8');
+                    }
+                    catch {
+                        // Fall back to stdout if file wasn't written
+                    }
+                    if (code !== 0) {
+                        resolve({ success: false, error: `codex exited with code ${code}: ${stderr.slice(0, 200)}`, stdout: output, stderr, exitCode: code, timedOut: false, durationMs });
+                        return;
+                    }
+                    resolve({ success: true, stdout: output, stderr, exitCode: code, timedOut: false, durationMs });
+                });
+                proc.on('error', (err) => {
+                    clearTimeout(timer);
+                    resolve({ success: false, error: err.message, stdout, stderr, exitCode: null, timedOut: false, durationMs: Date.now() - startTime });
+                });
+            });
+        }
+        finally {
+            try {
+                rmSync(tmpDir, { recursive: true, force: true });
+            }
+            catch { /* best-effort */ }
+        }
+    }
+}
+/**
+ * Run Claude Code CLI
+ */
+export async function runClaude(opts) {
+    const { worktreePath, prompt, timeoutMs, verbose, onProgress } = opts;
+    // Gate: require ANTHROPIC_API_KEY for automated Claude Code usage
+    if (!process.env.ANTHROPIC_API_KEY) {
+        throw new Error('Running Claude Code in automation requires ANTHROPIC_API_KEY.\n' +
+            'Set the env var for API access, or use the BlockSpool plugin (/blockspool:run) inside Claude Code.');
+    }
+    const startTime = Date.now();
+    return new Promise((resolve) => {
+        const claude = spawn('claude', ['-p', '--dangerously-skip-permissions'], {
+            cwd: worktreePath,
+            env: { ...process.env, CLAUDE_CODE_NON_INTERACTIVE: '1' },
+            stdio: ['pipe', 'pipe', 'pipe'],
+        });
+        let stdout = '';
+        let stderr = '';
+        let timedOut = false;
+        const timer = setTimeout(() => {
+            timedOut = true;
+            claude.kill('SIGTERM');
+        }, timeoutMs);
+        claude.stdin.write(prompt);
+        claude.stdin.end();
+        claude.stdout.on('data', (data) => {
+            const text = data.toString();
+            stdout += text;
+            if (verbose) {
+                onProgress(text.trim().slice(0, 100));
+            }
+        });
+        claude.stderr.on('data', (data) => {
+            stderr += data.toString();
+        });
+        claude.on('close', (code) => {
+            clearTimeout(timer);
+            const durationMs = Date.now() - startTime;
+            if (timedOut) {
+                resolve({
+                    success: false,
+                    error: `Timed out after ${timeoutMs}ms`,
+                    stdout,
+                    stderr,
+                    exitCode: code,
+                    timedOut: true,
+                    durationMs,
+                });
+                return;
+            }
+            if (code !== 0) {
+                resolve({
+                    success: false,
+                    error: `Claude exited with code ${code}: ${stderr.slice(0, 200)}`,
+                    stdout,
+                    stderr,
+                    exitCode: code,
+                    timedOut: false,
+                    durationMs,
+                });
+                return;
+            }
+            resolve({
+                success: true,
+                stdout,
+                stderr,
+                exitCode: code,
+                timedOut: false,
+                durationMs,
+            });
+        });
+        claude.on('error', (err) => {
+            clearTimeout(timer);
+            resolve({
+                success: false,
+                error: err.message,
+                stdout,
+                stderr,
+                exitCode: null,
+                timedOut: false,
+                durationMs: Date.now() - startTime,
+            });
+        });
+    });
+}
+/**
+ * Execute a ticket in isolation with step tracking
+ *
+ * Steps tracked: worktree → agent → commit → push → qa → pr → cleanup
+ */
+export async function soloRunTicket(opts) {
+    const { ticket, repoRoot, config, adapter, runId, skipQa, createPr, draftPr = false, timeoutMs, verbose, onProgress, } = opts;
+    const startTime = Date.now();
+    const branchName = `blockspool/${ticket.id}`;
+    const worktreePath = path.join(repoRoot, '.blockspool', 'worktrees', ticket.id);
+    const baseDir = getBlockspoolDir(repoRoot);
+    // Create all steps upfront
+    const stepRecords = new Map();
+    for (let i = 0; i < EXECUTE_STEPS.length; i++) {
+        const stepDef = EXECUTE_STEPS[i];
+        const step = await runSteps.create(adapter, {
+            runId,
+            ordinal: i,
+            name: stepDef.name,
+            kind: stepDef.kind,
+        });
+        stepRecords.set(stepDef.name, step);
+    }
+    // Track artifact paths for run summary
+    const artifactPaths = {};
+    // Initialize Spindle state for loop detection
+    const spindleConfig = {
+        ...DEFAULT_SPINDLE_CONFIG,
+        ...config?.spindle,
+    };
+    const spindleState = createSpindleState();
+    // Track step results for run summary
+    const stepResults = [];
+    // Helper to save run summary artifact
+    async function saveRunSummary(result) {
+        const summary = {
+            runId,
+            ticketId: ticket.id,
+            ticketTitle: ticket.title,
+            projectId: ticket.projectId,
+            success: result.success,
+            startedAt: new Date(startTime).toISOString(),
+            completedAt: new Date().toISOString(),
+            durationMs: result.durationMs,
+            branchName: result.branchName,
+            prUrl: result.prUrl,
+            error: result.error,
+            steps: stepResults.map(s => ({
+                name: s.name,
+                status: s.status,
+                durationMs: s.startedAt && s.completedAt ? s.completedAt - s.startedAt : undefined,
+                errorMessage: s.errorMessage,
+            })),
+            artifacts: artifactPaths,
+        };
+        return writeJsonArtifact({
+            baseDir,
+            type: 'runs',
+            id: runId,
+            data: summary,
+        });
+    }
+    // Helper to mark step progress
+    async function markStep(name, status, markOpts) {
+        const step = stepRecords.get(name);
+        if (!step)
+            return;
+        onProgress(`${name}...`);
+        let stepResult = stepResults.find(s => s.name === name);
+        if (!stepResult) {
+            stepResult = { name, status: 'skipped' };
+            stepResults.push(stepResult);
+        }
+        switch (status) {
+            case 'started':
+                stepResult.startedAt = Date.now();
+                await runSteps.markStarted(adapter, step.id);
+                break;
+            case 'success':
+                stepResult.status = 'success';
+                stepResult.completedAt = Date.now();
+                await runSteps.markSuccess(adapter, step.id, markOpts);
+                break;
+            case 'failed':
+                stepResult.status = 'failed';
+                stepResult.completedAt = Date.now();
+                stepResult.errorMessage = markOpts?.errorMessage;
+                await runSteps.markFailed(adapter, step.id, {
+                    errorMessage: markOpts?.errorMessage,
+                    metadata: markOpts?.metadata,
+                });
+                break;
+            case 'skipped':
+                stepResult.status = 'skipped';
+                stepResult.errorMessage = markOpts?.errorMessage;
+                await runSteps.markSkipped(adapter, step.id, markOpts?.errorMessage);
+                break;
+        }
+    }
+    // Helper to mark remaining steps as skipped
+    async function skipRemaining(fromIndex, reason) {
+        for (let i = fromIndex; i < EXECUTE_STEPS.length; i++) {
+            await markStep(EXECUTE_STEPS[i].name, 'skipped', { errorMessage: reason });
+        }
+    }
+    try {
+        // Step 1: Create worktree
+        await markStep('worktree', 'started');
+        const worktreesDir = path.join(repoRoot, '.blockspool', 'worktrees');
+        if (!fs.existsSync(worktreesDir)) {
+            fs.mkdirSync(worktreesDir, { recursive: true });
+        }
+        let baseBranch = 'master';
+        await withGitMutex(async () => {
+            if (fs.existsSync(worktreePath)) {
+                await gitExec(`git worktree remove --force "${worktreePath}"`, { cwd: repoRoot });
+            }
+            if (opts.baseBranch) {
+                // Use provided base branch (e.g. milestone branch)
+                baseBranch = opts.baseBranch;
+            }
+            else {
+                let detectedBranch = 'master';
+                try {
+                    const remoteHead = (await gitExec('git symbolic-ref refs/remotes/origin/HEAD 2>/dev/null || echo "refs/remotes/origin/master"', { cwd: repoRoot })).trim();
+                    detectedBranch = remoteHead.replace('refs/remotes/origin/', '');
+                }
+                catch {
+                    // Fall back to master
+                }
+                baseBranch = detectedBranch;
+                try {
+                    await gitExec(`git fetch origin ${baseBranch}`, { cwd: repoRoot });
+                }
+                catch {
+                    // Fetch failed, continue with what we have
+                }
+            }
+            const branchBase = opts.baseBranch ? opts.baseBranch : `origin/${baseBranch}`;
+            try {
+                await gitExec(`git branch "${branchName}" "${branchBase}"`, { cwd: repoRoot });
+            }
+            catch {
+                // Branch already exists
+            }
+            await gitExec(`git worktree add "${worktreePath}" "${branchName}"`, { cwd: repoRoot });
+        });
+        await markStep('worktree', 'success', { metadata: { branchName, worktreePath } });
+        // Step 2: Run agent
+        await markStep('agent', 'started');
+        const prompt = buildTicketPrompt(ticket, opts.guidelinesContext);
+        const execBackend = opts.executionBackend ?? new ClaudeExecutionBackend();
+        const claudeResult = await execBackend.run({
+            worktreePath,
+            prompt,
+            timeoutMs,
+            verbose,
+            onProgress: verbose ? onProgress : () => { },
+        });
+        // Save agent artifact
+        const agentArtifactPath = writeJsonArtifact({
+            baseDir,
+            type: 'executions',
+            id: runId,
+            data: {
+                runId,
+                ticketId: ticket.id,
+                prompt,
+                stdout: claudeResult.stdout,
+                stderr: claudeResult.stderr,
+                exitCode: claudeResult.exitCode,
+                timedOut: claudeResult.timedOut,
+                durationMs: claudeResult.durationMs,
+            },
+        });
+        artifactPaths.execution = agentArtifactPath;
+        if (!claudeResult.success) {
+            await markStep('agent', 'failed', {
+                errorMessage: claudeResult.error ?? 'Agent execution failed',
+                metadata: { artifactPath: agentArtifactPath },
+            });
+            await skipRemaining(2, 'Agent failed');
+            await cleanupWorktree(repoRoot, worktreePath);
+            const baseError = claudeResult.error ?? 'Claude execution failed';
+            const errorParts = [
+                claudeResult.timedOut ? 'Agent timed out' : 'Agent execution failed',
+                `  ${baseError}`,
+                '',
+            ];
+            if (claudeResult.timedOut) {
+                errorParts.push('The agent exceeded its time limit.');
+                errorParts.push('Consider breaking down the ticket into smaller tasks.');
+            }
+            errorParts.push(`To retry: blockspool solo run ${ticket.id}`);
+            errorParts.push(`Execution logs: ${agentArtifactPath}`);
+            const result = {
+                success: false,
+                durationMs: Date.now() - startTime,
+                error: errorParts.join('\n'),
+                failureReason: claudeResult.timedOut ? 'timeout' : 'agent_error',
+                artifacts: { ...artifactPaths },
+            };
+            await saveRunSummary(result);
+            return result;
+        }
+        await markStep('agent', 'success', {
+            metadata: { artifactPath: agentArtifactPath, durationMs: claudeResult.durationMs },
+        });
+        // Spindle check
+        if (spindleConfig.enabled) {
+            let prelimDiff = null;
+            try {
+                prelimDiff = (await gitExec('git diff', {
+                    cwd: worktreePath,
+                    maxBuffer: 10 * 1024 * 1024,
+                })).trim();
+            }
+            catch {
+                // Ignore diff errors for Spindle check
+            }
+            const spindleCheck = checkSpindleLoop(spindleState, claudeResult.stdout, prelimDiff, spindleConfig);
+            for (const warning of spindleState.warnings) {
+                onProgress(`⚠ ${warning}`);
+            }
+            spindleState.warnings = [];
+            if (spindleCheck.shouldAbort) {
+                const trigger = spindleCheck.reason;
+                const recommendations = generateSpindleRecommendations(trigger, ticket, spindleConfig);
+                const spindleArtifactData = {
+                    runId,
+                    ticketId: ticket.id,
+                    triggeredAtMs: Date.now(),
+                    iteration: spindleState.outputs.length,
+                    reason: trigger,
+                    metrics: {
+                        similarity: spindleCheck.diagnostics.similarityScore,
+                        similarOutputs: spindleState.outputs.length,
+                        stallIterations: spindleCheck.diagnostics.iterationsWithoutChange,
+                        estimatedTokens: spindleState.estimatedTokens,
+                        repeatedPatterns: spindleCheck.diagnostics.repeatedPatterns,
+                        oscillationPattern: spindleCheck.diagnostics.oscillationPattern,
+                    },
+                    thresholds: {
+                        similarityThreshold: spindleConfig.similarityThreshold,
+                        maxSimilarOutputs: spindleConfig.maxSimilarOutputs,
+                        maxStallIterations: spindleConfig.maxStallIterations,
+                        tokenBudgetWarning: spindleConfig.tokenBudgetWarning,
+                        tokenBudgetAbort: spindleConfig.tokenBudgetAbort,
+                    },
+                    pointers: {
+                        agentExecution: artifactPaths.execution,
+                    },
+                    recommendations,
+                    recentOutputs: spindleState.outputs.slice(-3),
+                    recentDiffs: spindleState.diffs.slice(-3),
+                    formatted: formatSpindleResult(spindleCheck),
+                };
+                const spindleArtifactPath = writeJsonArtifact({
+                    baseDir,
+                    type: 'spindle',
+                    id: runId,
+                    data: spindleArtifactData,
+                });
+                artifactPaths.spindle = spindleArtifactPath;
+                const spindleDetails = {
+                    trigger,
+                    confidence: spindleCheck.confidence,
+                    estimatedTokens: spindleState.estimatedTokens,
+                    iteration: spindleState.outputs.length,
+                    thresholds: {
+                        similarityThreshold: spindleConfig.similarityThreshold,
+                        maxSimilarOutputs: spindleConfig.maxSimilarOutputs,
+                        maxStallIterations: spindleConfig.maxStallIterations,
+                        tokenBudgetWarning: spindleConfig.tokenBudgetWarning,
+                        tokenBudgetAbort: spindleConfig.tokenBudgetAbort,
+                    },
+                    metrics: {
+                        similarityScore: spindleCheck.diagnostics.similarityScore,
+                        iterationsWithoutChange: spindleCheck.diagnostics.iterationsWithoutChange,
+                        repeatedPatterns: spindleCheck.diagnostics.repeatedPatterns,
+                        oscillationPattern: spindleCheck.diagnostics.oscillationPattern,
+                    },
+                    recommendations,
+                    artifactPath: spindleArtifactPath,
+                };
+                onProgress(`Spindle loop detected: ${trigger}`);
+                onProgress(`  Confidence: ${(spindleCheck.confidence * 100).toFixed(0)}%`);
+                onProgress(`  Tokens: ~${spindleState.estimatedTokens.toLocaleString()}`);
+                await skipRemaining(2, `Spindle loop: ${trigger}`);
+                await cleanupWorktree(repoRoot, worktreePath);
+                const result = {
+                    success: false,
+                    durationMs: Date.now() - startTime,
+                    error: `Spindle loop detected: ${trigger} (confidence: ${(spindleCheck.confidence * 100).toFixed(0)}%)`,
+                    failureReason: 'spindle_abort',
+                    spindle: spindleDetails,
+                    artifacts: { ...artifactPaths },
+                };
+                await saveRunSummary(result);
+                return result;
+            }
+        }
+        // Step 3: Scope check
+        await markStep('scope', 'started');
+        const statusOutput = (await gitExec('git status --porcelain', {
+            cwd: worktreePath,
+        })).trim();
+        if (!statusOutput) {
+            await markStep('scope', 'success', { errorMessage: 'No changes needed' });
+            await skipRemaining(3, 'No changes needed');
+            await cleanupWorktree(repoRoot, worktreePath);
+            const result = {
+                success: true,
+                durationMs: Date.now() - startTime,
+                completionOutcome: 'no_changes_needed',
+                artifacts: { ...artifactPaths },
+            };
+            await saveRunSummary(result);
+            return result;
+        }
+        const changedFiles = parseChangedFiles(statusOutput);
+        const violations = checkScopeViolations(changedFiles, ticket.allowedPaths, ticket.forbiddenPaths);
+        if (violations.length > 0) {
+            const violationsData = {
+                runId,
+                ticketId: ticket.id,
+                changedFiles,
+                allowedPaths: ticket.allowedPaths,
+                forbiddenPaths: ticket.forbiddenPaths,
+                violations,
+            };
+            const violationsArtifactPath = writeJsonArtifact({
+                baseDir,
+                type: 'violations',
+                id: runId,
+                data: violationsData,
+            });
+            artifactPaths.violations = violationsArtifactPath;
+            const canAutoRetry = ticket.retryCount < ticket.maxRetries;
+            const expansionResult = canAutoRetry
+                ? analyzeViolationsForExpansion(violations, ticket.allowedPaths)
+                : { canExpand: false, expandedPaths: ticket.allowedPaths, addedPaths: [], reason: 'Max retries exceeded' };
+            if (expansionResult.canExpand && expansionResult.addedPaths.length > 0) {
+                const newRetryCount = ticket.retryCount + 1;
+                await adapter.query(`UPDATE tickets SET
+            allowed_paths = $1,
+            retry_count = $2,
+            status = 'ready',
+            updated_at = datetime('now')
+          WHERE id = $3`, [JSON.stringify(expansionResult.expandedPaths), newRetryCount, ticket.id]);
+                await markStep('scope', 'failed', {
+                    errorMessage: `Scope expanded: +${expansionResult.addedPaths.length} paths, retry ${newRetryCount}/${ticket.maxRetries}`,
+                    metadata: { violations, expansionResult, artifactPath: violationsArtifactPath },
+                });
+                await skipRemaining(4, 'Scope expansion - retry scheduled');
+                await cleanupWorktree(repoRoot, worktreePath);
+                const result = {
+                    success: false,
+                    durationMs: Date.now() - startTime,
+                    error: `Scope auto-expanded: ${expansionResult.addedPaths.join(', ')}`,
+                    failureReason: 'scope_violation',
+                    artifacts: { ...artifactPaths },
+                    scopeExpanded: {
+                        addedPaths: expansionResult.addedPaths,
+                        newRetryCount,
+                    },
+                };
+                await saveRunSummary(result);
+                return result;
+            }
+            const violationSummary = violations
+                .map(v => v.violation === 'in_forbidden'
+                ? `${v.file} (forbidden by ${v.pattern})`
+                : `${v.file} (not in allowed paths)`)
+                .join(', ');
+            await markStep('scope', 'failed', {
+                errorMessage: `Scope violations: ${violationSummary}`,
+                metadata: { violations, expansionResult, artifactPath: violationsArtifactPath },
+            });
+            await skipRemaining(4, 'Scope violations');
+            await cleanupWorktree(repoRoot, worktreePath);
+            const violationDetails = violations
+                .map(v => v.violation === 'in_forbidden'
+                ? `  ${v.file} (forbidden by ${v.pattern})`
+                : `  ${v.file} (not in allowed_paths)`)
+                .join('\n');
+            const blockReason = expansionResult.reason
+                ? `\nNote: ${expansionResult.reason}`
+                : '';
+            const errorMessage = [
+                `Scope violation: Changes outside allowed paths`,
+                violationDetails,
+                blockReason,
+                ``,
+                `To fix: blockspool solo retry ${ticket.id}`,
+                `  This regenerates allowed_paths and resets the ticket to 'ready'`,
+            ].join('\n');
+            const result = {
+                success: false,
+                durationMs: Date.now() - startTime,
+                error: errorMessage,
+                failureReason: 'scope_violation',
+                artifacts: { ...artifactPaths },
+            };
+            await saveRunSummary(result);
+            return result;
+        }
+        await markStep('scope', 'success', {
+            metadata: { filesChecked: changedFiles.length },
+        });
+        // Step 4: Commit changes
+        await markStep('commit', 'started');
+        const diffOutput = await gitExec('git diff HEAD', {
+            cwd: worktreePath,
+            maxBuffer: 10 * 1024 * 1024,
+        });
+        const diffArtifactPath = writeJsonArtifact({
+            baseDir,
+            type: 'diffs',
+            id: runId,
+            data: {
+                runId,
+                ticketId: ticket.id,
+                diff: diffOutput,
+                filesChanged: statusOutput.split('\n').length,
+                changedFiles,
+            },
+        });
+        artifactPaths.diff = diffArtifactPath;
+        await gitExec('git add -A', { cwd: worktreePath });
+        await gitExec(`git commit -m "${ticket.title.replace(/"/g, '\\"')}"`, { cwd: worktreePath });
+        await markStep('commit', 'success', { metadata: { diffArtifactPath } });
+        // Step 5: Push branch
+        if (opts.skipPush) {
+            await markStep('push', 'skipped', { errorMessage: 'Skipped (milestone mode)' });
+        }
+        else {
+            await markStep('push', 'started');
+            try {
+                const { assertPushSafe } = await import('./solo-remote.js');
+                await assertPushSafe(worktreePath, config?.allowedRemote);
+                await gitExec(`git push -u origin "${branchName}"`, { cwd: worktreePath });
+                await markStep('push', 'success');
+            }
+            catch (pushError) {
+                await markStep('push', 'failed', {
+                    errorMessage: pushError instanceof Error ? pushError.message : String(pushError),
+                });
+                await skipRemaining(5, 'Push failed');
+                await cleanupWorktree(repoRoot, worktreePath);
+                const result = {
+                    success: false,
+                    branchName,
+                    durationMs: Date.now() - startTime,
+                    error: `Push failed: ${pushError instanceof Error ? pushError.message : pushError}`,
+                };
+                await saveRunSummary(result);
+                return result;
+            }
+        }
+        // Step 6: Run QA
+        if (!skipQa && config?.qa?.commands?.length) {
+            await markStep('qa', 'started');
+            const qaConfig = normalizeQaConfig(config);
+            const exec = createExecRunner({
+                defaultMaxLogBytes: qaConfig.artifacts.maxLogBytes,
+                defaultTailBytes: qaConfig.artifacts.tailBytes,
+            });
+            const logger = createLogger({ quiet: true });
+            const project = await projects.ensureForRepo(adapter, {
+                name: path.basename(repoRoot),
+                rootPath: repoRoot,
+            });
+            const qaResult = await runQa({ db: adapter, exec, logger }, {
+                projectId: project.id,
+                repoRoot: worktreePath,
+                config: qaConfig,
+            });
+            if (qaResult.status !== 'success') {
+                await markStep('qa', 'failed', {
+                    errorMessage: `QA failed at ${qaResult.failedAt?.stepName ?? 'unknown step'}`,
+                    metadata: { qaRunId: qaResult.runId },
+                });
+                await skipRemaining(6, 'QA failed');
+                const failedStep = qaResult.failedAt?.stepName ?? 'unknown step';
+                const errorParts = [`QA failed at: ${failedStep}`];
+                const qaDetails = await getQaRunDetails(adapter, qaResult.runId);
+                if (qaDetails) {
+                    const failedStepInfo = qaDetails.steps.find(s => s.name === failedStep && s.status === 'failed');
+                    if (failedStepInfo) {
+                        const errorOutput = failedStepInfo.stderrTail || failedStepInfo.stdoutTail;
+                        if (errorOutput) {
+                            const truncated = errorOutput.length > 500
+                                ? '...' + errorOutput.slice(-497)
+                                : errorOutput;
+                            errorParts.push('');
+                            errorParts.push('Error output:');
+                            errorParts.push(truncated.split('\n').map(l => `  ${l}`).join('\n'));
+                        }
+                        if (failedStepInfo.errorMessage) {
+                            errorParts.push('');
+                            errorParts.push(`Error: ${failedStepInfo.errorMessage}`);
+                        }
+                    }
+                }
+                errorParts.push('');
+                errorParts.push(`To retry: blockspool solo run ${ticket.id}`);
+                errorParts.push(`Worktree preserved for inspection: ${worktreePath}`);
+                const result = {
+                    success: false,
+                    branchName,
+                    durationMs: Date.now() - startTime,
+                    error: errorParts.join('\n'),
+                };
+                await saveRunSummary(result);
+                return result;
+            }
+            await markStep('qa', 'success', { metadata: { qaRunId: qaResult.runId } });
+        }
+        else {
+            await markStep('qa', 'skipped', { errorMessage: skipQa ? 'Skipped by flag' : 'No QA configured' });
+        }
+        // Step 7: Create PR
+        let prUrl;
+        if (opts.skipPr) {
+            await markStep('pr', 'skipped', { errorMessage: 'Skipped (milestone mode)' });
+        }
+        else if (createPr) {
+            await markStep('pr', 'started');
+            try {
+                const { assertPushSafe: assertPrSafe } = await import('./solo-remote.js');
+                await assertPrSafe(worktreePath, config?.allowedRemote);
+                const prBody = `## Summary\n\n${ticket.description ?? ticket.title}\n\n---\n_Created by BlockSpool_`;
+                const draftFlag = draftPr ? ' --draft' : '';
+                const prOutput = (await gitExec(`gh pr create --title "${ticket.title.replace(/"/g, '\\"')}" --body "${prBody.replace(/"/g, '\\"')}" --head "${branchName}"${draftFlag}`, { cwd: worktreePath })).trim();
+                const urlMatch = prOutput.match(/https:\/\/github\.com\/[^\s]+/);
+                prUrl = urlMatch ? urlMatch[0] : undefined;
+                await markStep('pr', 'success', { metadata: { prUrl } });
+            }
+            catch (prError) {
+                await markStep('pr', 'failed', {
+                    errorMessage: prError instanceof Error ? prError.message : String(prError),
+                });
+                onProgress(`PR creation failed: ${prError instanceof Error ? prError.message : prError}`);
+            }
+        }
+        else {
+            await markStep('pr', 'skipped', { errorMessage: 'Not requested' });
+        }
+        // Step 8: Clean up worktree
+        await markStep('cleanup', 'started');
+        await cleanupWorktree(repoRoot, worktreePath);
+        await markStep('cleanup', 'success');
+        const result = {
+            success: true,
+            branchName,
+            prUrl,
+            durationMs: Date.now() - startTime,
+        };
+        await saveRunSummary(result);
+        return result;
+    }
+    catch (error) {
+        await cleanupWorktree(repoRoot, worktreePath);
+        const result = {
+            success: false,
+            durationMs: Date.now() - startTime,
+            error: error instanceof Error ? error.message : String(error),
+        };
+        await saveRunSummary(result);
+        return result;
+    }
+}
+//# sourceMappingURL=solo-ticket.js.map