@promptwheel/cli 0.6.0

package/dist/lib/solo-git.js

@@ -0,0 +1,365 @@
+/**
+ * Solo mode git utilities
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+/**
+ * Mutex for serializing git operations on the main repo.
+ * Git doesn't support concurrent index operations on the same repo,
+ * so worktree setup (fetch, branch, worktree add) must be serialized.
+ * Once worktrees are created, per-worktree git ops are safe in parallel.
+ */
+let gitMutexPromise = Promise.resolve();
+export function withGitMutex(fn) {
+    const prev = gitMutexPromise;
+    let resolve;
+    gitMutexPromise = new Promise((r) => { resolve = r; });
+    return prev.then(fn).finally(() => resolve());
+}
+/**
+ * Async git command execution — does not block the event loop.
+ * Used instead of execSync to allow parallel ticket execution.
+ */
+export async function gitExec(cmd, opts) {
+    const { exec } = await import('child_process');
+    const { promisify } = await import('util');
+    const execPromise = promisify(exec);
+    const result = await execPromise(cmd, {
+        cwd: opts.cwd,
+        encoding: opts.encoding || 'utf-8',
+        maxBuffer: opts.maxBuffer || 10 * 1024 * 1024,
+    });
+    return result.stdout;
+}
+/**
+ * Async git command execution using execFile — avoids shell interpolation.
+ * Use this instead of gitExec when arguments contain user-controlled data
+ * (e.g., ticket titles) to prevent shell injection.
+ */
+export async function gitExecFile(cmd, args, opts) {
+    const { execFile } = await import('child_process');
+    const { promisify } = await import('util');
+    const execFilePromise = promisify(execFile);
+    const result = await execFilePromise(cmd, args, {
+        cwd: opts.cwd,
+        encoding: 'utf-8',
+        maxBuffer: 10 * 1024 * 1024,
+    });
+    return result.stdout;
+}
+/**
+ * Clean up worktree directory. Branch is left for merge or later pruning.
+ */
+export async function cleanupWorktree(repoRoot, worktreePath) {
+    try {
+        if (fs.existsSync(worktreePath)) {
+            await gitExec(`git worktree remove --force "${worktreePath}"`, { cwd: repoRoot });
+        }
+    }
+    catch {
+        // Ignore worktree removal errors
+    }
+}
+/**
+ * Delete a ticket branch after it has been merged.
+ */
+export async function deleteTicketBranch(repoRoot, branchName) {
+    try {
+        await gitExec(`git branch -D "${branchName}"`, { cwd: repoRoot });
+    }
+    catch {
+        // Branch may already be deleted
+    }
+}
+/**
+ * Delete a remote branch (non-fatal).
+ */
+export async function deleteRemoteBranch(repoRoot, branchName) {
+    try {
+        await gitExecFile('git', ['push', 'origin', '--delete', branchName], { cwd: repoRoot });
+    }
+    catch {
+        // Branch may not exist on remote, or no push access — non-fatal
+    }
+}
+/**
+ * Check if the direct branch's PR was merged; if so, delete local+remote branch.
+ * Returns true if cleanup was performed.
+ */
+export async function cleanupMergedDirectBranch(repoRoot, branchName) {
+    try {
+        // Check if branch exists locally
+        await gitExecFile('git', ['rev-parse', '--verify', branchName], { cwd: repoRoot });
+    }
+    catch {
+        return false; // branch doesn't exist
+    }
+    try {
+        // Check if there's a merged PR for this branch
+        const raw = await gitExecFile('gh', ['pr', 'list', '--head', branchName, '--state', 'merged', '--json', 'url', '--limit', '1'], { cwd: repoRoot });
+        const prs = JSON.parse(raw.trim());
+        if (!Array.isArray(prs) || prs.length === 0)
+            return false;
+        // PR was merged — clean up local branch
+        await gitExecFile('git', ['branch', '-D', branchName], { cwd: repoRoot }).catch(() => { });
+        // Clean up remote branch (non-fatal)
+        await deleteRemoteBranch(repoRoot, branchName).catch(() => { });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Create a milestone branch and persistent worktree for batch merging.
+ * Returns the branch name and worktree path.
+ */
+export async function createMilestoneBranch(repoRoot, baseBranch) {
+    const ts = Date.now().toString(36);
+    const milestoneBranch = `promptwheel/milestone-${ts}`;
+    const milestoneWorktreePath = path.join(repoRoot, '.promptwheel', 'worktrees', '_milestone');
+    await withGitMutex(async () => {
+        // Ensure worktrees dir exists
+        const worktreesDir = path.join(repoRoot, '.promptwheel', 'worktrees');
+        if (!fs.existsSync(worktreesDir)) {
+            fs.mkdirSync(worktreesDir, { recursive: true });
+        }
+        // Clean up any existing milestone worktree
+        if (fs.existsSync(milestoneWorktreePath)) {
+            await gitExec(`git worktree remove --force "${milestoneWorktreePath}"`, { cwd: repoRoot });
+        }
+        // Fetch latest
+        try {
+            await gitExec(`git fetch origin ${baseBranch}`, { cwd: repoRoot });
+        }
+        catch {
+            // Continue with what we have
+        }
+        // Create milestone branch from origin/baseBranch
+        try {
+            await gitExec(`git branch "${milestoneBranch}" "origin/${baseBranch}"`, { cwd: repoRoot });
+        }
+        catch {
+            // Branch may already exist
+        }
+        await gitExec(`git worktree add "${milestoneWorktreePath}" "${milestoneBranch}"`, { cwd: repoRoot });
+    });
+    return { milestoneBranch, milestoneWorktreePath };
+}
+/**
+ * Merge a ticket branch into the milestone branch under git mutex.
+ * Returns success/conflict status.
+ */
+export async function mergeTicketToMilestone(repoRoot, ticketBranch, milestoneWorktreePath) {
+    return withGitMutex(async () => {
+        try {
+            await gitExecFile('git', ['merge', '--no-ff', ticketBranch, '-m', `Merge ${ticketBranch}`], {
+                cwd: milestoneWorktreePath,
+            });
+            return { success: true, conflicted: false };
+        }
+        catch {
+            // Abort the failed merge
+            try {
+                await gitExec('git merge --abort', { cwd: milestoneWorktreePath });
+            }
+            catch {
+                // Ignore abort errors
+            }
+            // Retry: rebase ticket branch onto milestone, then merge
+            const milestoneBranchName = (await gitExec('git rev-parse --abbrev-ref HEAD', {
+                cwd: milestoneWorktreePath,
+            })).trim();
+            try {
+                // Rebase the ticket branch onto the current milestone tip.
+                // Note: `git rebase <upstream> <branch>` switches HEAD to <branch>,
+                // so we must switch back to the milestone branch before merging.
+                await gitExecFile('git', ['rebase', milestoneBranchName, ticketBranch], {
+                    cwd: repoRoot,
+                });
+                // Switch back to milestone branch (rebase left HEAD on ticketBranch)
+                await gitExecFile('git', ['checkout', milestoneBranchName], {
+                    cwd: milestoneWorktreePath,
+                });
+                // Try merge again
+                await gitExecFile('git', ['merge', '--no-ff', ticketBranch, '-m', `Merge ${ticketBranch}`], {
+                    cwd: milestoneWorktreePath,
+                });
+                return { success: true, conflicted: false };
+            }
+            catch {
+                // Abort any in-progress rebase or merge
+                try {
+                    await gitExec('git rebase --abort', { cwd: repoRoot });
+                }
+                catch { /* ignore */ }
+                try {
+                    await gitExec('git merge --abort', { cwd: milestoneWorktreePath });
+                }
+                catch { /* ignore */ }
+                // Restore HEAD to milestone branch if rebase left it on ticket branch
+                try {
+                    await gitExecFile('git', ['checkout', milestoneBranchName], { cwd: milestoneWorktreePath });
+                }
+                catch { /* ignore */ }
+                return { success: false, conflicted: true };
+            }
+        }
+    });
+}
+/**
+ * Push milestone branch and create a squash-merge draft PR to the base branch.
+ * Returns the PR URL.
+ */
+export async function pushAndPrMilestone(repoRoot, milestoneBranch, milestoneWorktreePath, milestoneNumber, ticketCount, summaries) {
+    // Push safety: validate origin matches allowed remote
+    const { assertPushSafe } = await import('./solo-remote.js');
+    const { loadConfig } = await import('./solo-config.js');
+    const config = loadConfig(repoRoot);
+    await assertPushSafe(milestoneWorktreePath, config?.allowedRemote);
+    // Push the milestone branch
+    await gitExec(`git push -u origin "${milestoneBranch}"`, { cwd: milestoneWorktreePath });
+    // Build PR body
+    const bulletList = summaries.map(s => `- ${s}`).join('\n');
+    const title = `Milestone #${milestoneNumber}: ${ticketCount} improvements`;
+    const body = `## Milestone #${milestoneNumber}\n\n${ticketCount} tickets merged:\n\n${bulletList}\n\n---\n_Created by PromptWheel (milestone mode)_`;
+    try {
+        const prOutput = (await gitExecFile('gh', ['pr', 'create', '--title', title, '--body', body, '--head', milestoneBranch, '--draft'], { cwd: milestoneWorktreePath })).trim();
+        const urlMatch = prOutput.match(/https:\/\/github\.com\/[^\s]+/);
+        return urlMatch ? urlMatch[0] : undefined;
+    }
+    catch {
+        // PR might already exist for this branch — try to find it
+        try {
+            const existing = (await gitExec(`gh pr view "${milestoneBranch}" --json url --jq .url`, { cwd: milestoneWorktreePath })).trim();
+            if (existing.startsWith('https://'))
+                return existing;
+        }
+        catch {
+            // ignore
+        }
+        return undefined;
+    }
+}
+/**
+ * Clean up the milestone worktree (but not the branch, which may have a PR).
+ */
+export async function cleanupMilestone(repoRoot) {
+    const milestoneWorktreePath = path.join(repoRoot, '.promptwheel', 'worktrees', '_milestone');
+    await cleanupWorktree(repoRoot, milestoneWorktreePath);
+}
+/**
+ * Fetch review comments from a PR for feedback ingestion.
+ * Non-fatal — returns [] on failure.
+ */
+export async function fetchPrReviewComments(repoRoot, prUrl) {
+    try {
+        const raw = await gitExecFile('gh', ['pr', 'view', prUrl, '--json', 'comments,reviews'], { cwd: repoRoot });
+        const parsed = JSON.parse(raw.trim());
+        const results = [];
+        // Extract from comments
+        if (Array.isArray(parsed.comments)) {
+            for (const c of parsed.comments) {
+                if (c.body && c.body.length > 20) {
+                    results.push({ body: c.body, author: c.author?.login || 'unknown' });
+                }
+            }
+        }
+        // Extract from reviews
+        if (Array.isArray(parsed.reviews)) {
+            for (const r of parsed.reviews) {
+                if (r.body && r.body.length > 20) {
+                    results.push({ body: r.body, author: r.author?.login || 'unknown' });
+                }
+            }
+        }
+        return results;
+    }
+    catch {
+        return [];
+    }
+}
+/** Create/checkout the direct branch, branching from base if needed */
+export async function ensureDirectBranch(repoRoot, branchName, baseBranch) {
+    await withGitMutex(async () => {
+        // Check if branch exists
+        try {
+            await gitExecFile('git', ['rev-parse', '--verify', branchName], { cwd: repoRoot });
+            // Branch exists — check it out
+            await gitExecFile('git', ['checkout', branchName], { cwd: repoRoot });
+        }
+        catch {
+            // Branch doesn't exist — create from base
+            try {
+                await gitExecFile('git', ['fetch', 'origin', baseBranch], { cwd: repoRoot });
+            }
+            catch {
+                // Continue with what we have
+            }
+            // Try origin/baseBranch first, fall back to local baseBranch
+            let base;
+            try {
+                base = (await gitExecFile('git', ['rev-parse', '--verify', `origin/${baseBranch}`], { cwd: repoRoot })).trim();
+            }
+            catch {
+                base = (await gitExecFile('git', ['rev-parse', '--verify', baseBranch], { cwd: repoRoot })).trim();
+            }
+            try {
+                await gitExecFile('git', ['checkout', '-b', branchName, base], { cwd: repoRoot });
+            }
+            catch (err) {
+                if (err?.message?.includes('cannot lock ref') || err?.stderr?.includes('cannot lock ref')) {
+                    throw new Error(`Cannot create branch "${branchName}" — a conflicting ref exists (e.g. "${branchName}/*" branches).\n` +
+                        `This happens when milestone or ticket branches like "${branchName}/milestone-*" exist.\n` +
+                        `Fix: delete the conflicting branches with \`git branch -D <branch>\` or set a different \`directBranch\` in .promptwheel/config.json.`);
+                }
+                throw err;
+            }
+        }
+    });
+}
+/** Push the direct branch to remote */
+export async function pushDirectBranch(repoRoot, branchName) {
+    const { assertPushSafe } = await import('./solo-remote.js');
+    const { loadConfig } = await import('./solo-config.js');
+    const config = loadConfig(repoRoot);
+    await assertPushSafe(repoRoot, config?.allowedRemote);
+    await gitExecFile('git', ['push', '-u', 'origin', branchName], { cwd: repoRoot });
+}
+/** Create a summary PR from the direct branch → base */
+export async function createDirectSummaryPr(repoRoot, branchName, baseBranch, title, body, draft) {
+    const args = ['pr', 'create', '--title', title, '--body', body, '--head', branchName, '--base', baseBranch];
+    if (draft)
+        args.push('--draft');
+    const prOutput = (await gitExecFile('gh', args, { cwd: repoRoot })).trim();
+    const urlMatch = prOutput.match(/https:\/\/github\.com\/[^\s]+/);
+    return urlMatch ? urlMatch[0] : prOutput;
+}
+/** Auto-merge a PR after CI passes (gh pr merge --auto --squash) */
+export async function autoMergePr(repoRoot, prUrl) {
+    try {
+        await gitExecFile('gh', ['pr', 'merge', prUrl, '--auto', '--squash'], { cwd: repoRoot });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export async function checkPrStatuses(repoRoot, prUrls) {
+    const results = [];
+    for (const url of prUrls) {
+        try {
+            const raw = await gitExecFile('gh', ['pr', 'view', url, '--json', 'state,mergedAt,headRefName'], { cwd: repoRoot });
+            const parsed = JSON.parse(raw.trim());
+            const state = parsed.state === 'MERGED' ? 'merged'
+                : parsed.state === 'CLOSED' ? 'closed'
+                    : 'open';
+            results.push({ url, state, mergedAt: parsed.mergedAt || undefined, branch: parsed.headRefName || undefined });
+        }
+        catch {
+            // Non-fatal — skip this PR
+        }
+    }
+    return results;
+}
+//# sourceMappingURL=solo-git.js.map

package/dist/lib/solo-git.js.map

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

package/dist/lib/solo-hints.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Hints system for live steering of auto mode.
+ *
+ * Multiple frontends (stdin listener, `solo nudge` CLI) write to
+ * `.promptwheel/hints.json`. The scout loop consumes pending hints
+ * and injects them into the scout prompt via `customPrompt`.
+ */
+export interface Hint {
+    id: string;
+    text: string;
+    createdAt: number;
+    consumed: boolean;
+}
+/**
+ * Read all hints from disk, pruning stale consumed ones.
+ */
+export declare function readHints(repoRoot: string): Hint[];
+/**
+ * Add a new hint. Returns the created hint.
+ */
+export declare function addHint(repoRoot: string, text: string): Hint;
+/**
+ * Consume all pending (unconsumed) hints.
+ * Marks them as consumed and returns a formatted prompt block,
+ * or null if there are no pending hints.
+ */
+export declare function consumePendingHints(repoRoot: string): string | null;
+/**
+ * Clear all hints.
+ */
+export declare function clearHints(repoRoot: string): void;
+//# sourceMappingURL=solo-hints.d.ts.map

package/dist/lib/solo-hints.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"solo-hints.d.ts","sourceRoot":"","sources":["../../src/lib/solo-hints.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH,MAAM,WAAW,IAAI;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAmBD;;GAEG;AACH,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,EAAE,CAsBlD;AAgBD;;GAEG;AACH,wBAAgB,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAY5D;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAanE;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAEjD"}

package/dist/lib/solo-hints.js

@@ -0,0 +1,98 @@
+/**
+ * Hints system for live steering of auto mode.
+ *
+ * Multiple frontends (stdin listener, `solo nudge` CLI) write to
+ * `.promptwheel/hints.json`. The scout loop consumes pending hints
+ * and injects them into the scout prompt via `customPrompt`.
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import * as crypto from 'node:crypto';
+const HINTS_FILE = 'hints.json';
+const HINTS_TMP = 'hints.json.tmp';
+const MAX_HINT_LENGTH = 500;
+const PRUNE_AGE_MS = 60 * 60 * 1000; // 1 hour
+function hintsPath(repoRoot) {
+    return path.join(repoRoot, '.promptwheel', HINTS_FILE);
+}
+function hintsTmpPath(repoRoot) {
+    return path.join(repoRoot, '.promptwheel', HINTS_TMP);
+}
+function generateId() {
+    return crypto.randomBytes(8).toString('hex');
+}
+/**
+ * Read all hints from disk, pruning stale consumed ones.
+ */
+export function readHints(repoRoot) {
+    const fp = hintsPath(repoRoot);
+    if (!fs.existsSync(fp))
+        return [];
+    try {
+        const raw = fs.readFileSync(fp, 'utf-8');
+        const hints = JSON.parse(raw);
+        const now = Date.now();
+        // Prune consumed hints older than 1 hour
+        const kept = hints.filter((h) => !(h.consumed && now - h.createdAt > PRUNE_AGE_MS));
+        if (kept.length !== hints.length) {
+            atomicWrite(repoRoot, kept);
+        }
+        return kept;
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Atomically write hints array to disk.
+ */
+function atomicWrite(repoRoot, hints) {
+    const dir = path.join(repoRoot, '.promptwheel');
+    if (!fs.existsSync(dir)) {
+        fs.mkdirSync(dir, { recursive: true });
+    }
+    const tmp = hintsTmpPath(repoRoot);
+    const target = hintsPath(repoRoot);
+    fs.writeFileSync(tmp, JSON.stringify(hints, null, 2), 'utf-8');
+    fs.renameSync(tmp, target);
+}
+/**
+ * Add a new hint. Returns the created hint.
+ */
+export function addHint(repoRoot, text) {
+    const truncated = text.slice(0, MAX_HINT_LENGTH);
+    const hints = readHints(repoRoot);
+    const hint = {
+        id: generateId(),
+        text: truncated,
+        createdAt: Date.now(),
+        consumed: false,
+    };
+    hints.push(hint);
+    atomicWrite(repoRoot, hints);
+    return hint;
+}
+/**
+ * Consume all pending (unconsumed) hints.
+ * Marks them as consumed and returns a formatted prompt block,
+ * or null if there are no pending hints.
+ */
+export function consumePendingHints(repoRoot) {
+    const hints = readHints(repoRoot);
+    const pending = hints.filter((h) => !h.consumed);
+    if (pending.length === 0)
+        return null;
+    for (const h of pending) {
+        h.consumed = true;
+    }
+    atomicWrite(repoRoot, hints);
+    const lines = pending.map((h) => `- "${h.text}"`).join('\n');
+    return `\n## User Steering Hints\n${lines}`;
+}
+/**
+ * Clear all hints.
+ */
+export function clearHints(repoRoot) {
+    atomicWrite(repoRoot, []);
+}
+//# sourceMappingURL=solo-hints.js.map

package/dist/lib/solo-hints.js.map

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

package/dist/lib/solo-prompt-builder.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Build execution prompts for solo ticket runs
+ */
+import type { tickets } from '@promptwheel/core/repos';
+/**
+ * Build the prompt for Claude from a ticket
+ */
+export declare function buildTicketPrompt(ticket: NonNullable<Awaited<ReturnType<typeof tickets.getById>>>, guidelinesContext?: string, learningsContext?: string, metadataContext?: string, opts?: {
+    confidence?: number;
+    complexity?: string;
+}): string;
+//# sourceMappingURL=solo-prompt-builder.d.ts.map

package/dist/lib/solo-prompt-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"solo-prompt-builder.d.ts","sourceRoot":"","sources":["../../src/lib/solo-prompt-builder.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAEvD;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,UAAU,CAAC,OAAO,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,iBAAiB,CAAC,EAAE,MAAM,EAAE,gBAAgB,CAAC,EAAE,MAAM,EAAE,eAAe,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;IAAE,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAqEhP"}

package/dist/lib/solo-prompt-builder.js

@@ -0,0 +1,53 @@
+/**
+ * Build execution prompts for solo ticket runs
+ */
+/**
+ * Build the prompt for Claude from a ticket
+ */
+export function buildTicketPrompt(ticket, guidelinesContext, learningsContext, metadataContext, opts) {
+    const parts = [];
+    // Planning preamble for uncertain or complex changes
+    const confidence = opts?.confidence;
+    const complexity = opts?.complexity;
+    if ((confidence !== undefined && confidence < 50) || complexity === 'moderate' || complexity === 'complex') {
+        parts.push('## Approach — This is a complex change', '', `The automated analysis flagged this as uncertain (confidence: ${confidence ?? '?'}%). Before writing code:`, '1. Read all relevant files to understand the full context', '2. Identify all touch points and potential side effects', '3. Write out your implementation plan before making changes', '4. Implement incrementally, verifying at each step', '');
+    }
+    if (guidelinesContext) {
+        parts.push(guidelinesContext, '');
+    }
+    if (metadataContext) {
+        parts.push(metadataContext, '');
+    }
+    if (learningsContext) {
+        parts.push(learningsContext, '');
+    }
+    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('');
+    }
+    parts.push('## Verification');
+    parts.push('QA verification is handled automatically AFTER your changes — do NOT run test suites yourself.');
+    parts.push('Running tests wastes your time budget and they may have pre-existing failures unrelated to your work.');
+    parts.push('Focus only on making the code changes correctly.');
+    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. Keep changes minimal and focused');
+    parts.push('4. Do NOT run test/build/lint commands — QA is automated after you finish');
+    return parts.join('\n');
+}
+//# sourceMappingURL=solo-prompt-builder.js.map

package/dist/lib/solo-prompt-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"solo-prompt-builder.js","sourceRoot":"","sources":["../../src/lib/solo-prompt-builder.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,MAAgE,EAAE,iBAA0B,EAAE,gBAAyB,EAAE,eAAwB,EAAE,IAAmD;IACtO,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,qDAAqD;IACrD,MAAM,UAAU,GAAG,IAAI,EAAE,UAAU,CAAC;IACpC,MAAM,UAAU,GAAG,IAAI,EAAE,UAAU,CAAC;IACpC,IAAI,CAAC,UAAU,KAAK,SAAS,IAAI,UAAU,GAAG,EAAE,CAAC,IAAI,UAAU,KAAK,UAAU,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;QAC3G,KAAK,CAAC,IAAI,CACR,wCAAwC,EACxC,EAAE,EACF,iEAAiE,UAAU,IAAI,GAAG,0BAA0B,EAC5G,2DAA2D,EAC3D,yDAAyD,EACzD,6DAA6D,EAC7D,oDAAoD,EACpD,EAAE,CACH,CAAC;IACJ,CAAC;IAED,IAAI,iBAAiB,EAAE,CAAC;QACtB,KAAK,CAAC,IAAI,CAAC,iBAAiB,EAAE,EAAE,CAAC,CAAC;IACpC,CAAC;IAED,IAAI,eAAe,EAAE,CAAC;QACpB,KAAK,CAAC,IAAI,CAAC,eAAe,EAAE,EAAE,CAAC,CAAC;IAClC,CAAC;IAED,IAAI,gBAAgB,EAAE,CAAC;QACrB,KAAK,CAAC,IAAI,CAAC,gBAAgB,EAAE,EAAE,CAAC,CAAC;IACnC,CAAC;IAED,KAAK,CAAC,IAAI,CACR,WAAW,MAAM,CAAC,KAAK,EAAE,EACzB,EAAE,EACF,MAAM,CAAC,WAAW,IAAI,EAAE,EACxB,EAAE,CACH,CAAC;IAEF,IAAI,MAAM,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACnC,KAAK,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;QAC/B,KAAK,CAAC,IAAI,CAAC,mCAAmC,CAAC,CAAC;QAChD,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,YAAY,EAAE,CAAC;YACpC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACvB,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IAED,IAAI,MAAM,CAAC,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACrC,KAAK,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;QACjC,KAAK,CAAC,IAAI,CAAC,qCAAqC,CAAC,CAAC;QAClD,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,cAAc,EAAE,CAAC;YACtC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACvB,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;IAC9B,KAAK,CAAC,IAAI,CAAC,gGAAgG,CAAC,CAAC;IAC7G,KAAK,CAAC,IAAI,CAAC,uGAAuG,CAAC,CAAC;IACpH,KAAK,CAAC,IAAI,CAAC,kDAAkD,CAAC,CAAC;IAC/D,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,KAAK,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;IAC9B,KAAK,CAAC,IAAI,CAAC,mDAAmD,CAAC,CAAC;IAChE,KAAK,CAAC,IAAI,CAAC,mCAAmC,CAAC,CAAC;IAChD,KAAK,CAAC,IAAI,CAAC,qCAAqC,CAAC,CAAC;IAClD,KAAK,CAAC,IAAI,CAAC,2EAA2E,CAAC,CAAC;IAExF,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

package/dist/lib/solo-qa-retry.d.ts

@@ -0,0 +1,43 @@
+/**
+ * QA failure detection and retry-with-test-fix logic
+ */
+import type { DatabaseAdapter } from '@promptwheel/core/db';
+import { getQaRunDetails } from '@promptwheel/core/services';
+import type { tickets } from '@promptwheel/core/repos';
+import type { ExecutionBackend } from './execution-backends/index.js';
+/**
+ * Check if a QA failure is a test failure (vitest/jest/pytest etc.)
+ */
+export declare function isTestFailure(failedStepName: string | undefined): boolean;
+/**
+ * Extract test file paths from QA error output
+ */
+export declare function extractTestFilesFromQaOutput(output: string): string[];
+export interface QaRetryContext {
+    ticket: NonNullable<Awaited<ReturnType<typeof tickets.getById>>>;
+    worktreePath: string;
+    execBackend: ExecutionBackend;
+    timeoutMs: number;
+    verbose: boolean;
+    onProgress: (msg: string) => void;
+    adapter: DatabaseAdapter;
+    projectId: string;
+    qaConfig: any;
+    guidelinesContext?: string;
+    learningsContext?: string;
+    metadataContext?: string;
+    qaDetails: Awaited<ReturnType<typeof getQaRunDetails>>;
+    failedStepName: string | undefined;
+}
+export interface QaRetryResult {
+    retried: boolean;
+    success: boolean;
+    qaRunId?: string;
+    errorParts?: string[];
+}
+/**
+ * Attempt to retry a QA failure by expanding scope to include test files
+ * and asking the agent to fix them.
+ */
+export declare function runQaRetryWithTestFix(ctx: QaRetryContext): Promise<QaRetryResult>;
+//# sourceMappingURL=solo-qa-retry.d.ts.map

package/dist/lib/solo-qa-retry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"solo-qa-retry.d.ts","sourceRoot":"","sources":["../../src/lib/solo-qa-retry.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,EAAS,eAAe,EAAE,MAAM,4BAA4B,CAAC;AACpE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAEvD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAGtE;;GAEG;AACH,wBAAgB,aAAa,CAAC,cAAc,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAIzE;AAED;;GAEG;AACH,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAsBrE;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,UAAU,CAAC,OAAO,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IACjE,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,gBAAgB,CAAC;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,OAAO,EAAE,eAAe,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,GAAG,CAAC;IACd,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,SAAS,EAAE,OAAO,CAAC,UAAU,CAAC,OAAO,eAAe,CAAC,CAAC,CAAC;IACvD,cAAc,EAAE,MAAM,GAAG,SAAS,CAAC;CACpC;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB;AAED;;;GAGG;AACH,wBAAsB,qBAAqB,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC,CAiGvF"}