@humanbased/crosscheck 0.14.0 → 0.15.0-beta.103

package/dist/commands/detect-step.d.ts

@@ -0,0 +1,5 @@
+export declare function runDetectStep(prUrl: string, opts?: {
+    config?: string;
+    json?: boolean;
+}): Promise<void>;
+//# sourceMappingURL=detect-step.d.ts.map

package/dist/commands/detect-step.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect-step.d.ts","sourceRoot":"","sources":["../../src/commands/detect-step.ts"],"names":[],"mappings":"AAgDA,wBAAsB,aAAa,CACjC,KAAK,EAAE,MAAM,EACb,IAAI,GAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,OAAO,CAAA;CAAO,GAC7C,OAAO,CAAC,IAAI,CAAC,CAmFf"}

package/dist/commands/detect-step.js

@@ -0,0 +1,124 @@
+import chalk from 'chalk';
+import ora from 'ora';
+import { createGithubClient } from '../github/client.js';
+import { getGithubToken } from '../config/loader.js';
+import { loadWorkflow } from '../lib/workflow.js';
+import { fetchStepHistory, identifyNextWorkflowStep } from '../lib/pr-workflow-state.js';
+function parsePRUrl(url) {
+    const m = url.match(/github\.com\/([^/]+)\/([^/]+)\/pull\/(\d+)/);
+    if (!m)
+        return null;
+    return { owner: m[1], repo: m[2], number: parseInt(m[3], 10) };
+}
+function fmtDate(iso) {
+    const d = new Date(iso);
+    const pad = (n) => String(n).padStart(2, '0');
+    return `${d.getUTCFullYear()}-${pad(d.getUTCMonth() + 1)}-${pad(d.getUTCDate())} ${pad(d.getUTCHours())}:${pad(d.getUTCMinutes())}`;
+}
+function verdictColor(verdict) {
+    if (!verdict)
+        return chalk.dim('?');
+    if (verdict === 'APPROVE')
+        return chalk.green(verdict);
+    if (verdict === 'BLOCK')
+        return chalk.red(verdict);
+    return chalk.yellow(verdict.replace('_', ' '));
+}
+function printHistory(records) {
+    if (records.length === 0) {
+        console.log(chalk.dim('  (no crosscheck steps found)'));
+        return;
+    }
+    const typeWidth = Math.max(...records.map(r => r.type.length));
+    for (let i = 0; i < records.length; i++) {
+        const r = records[i];
+        const idx = chalk.dim(String(i + 1).padStart(2));
+        const date = chalk.dim(fmtDate(r.createdAt));
+        const type = r.type.padEnd(typeWidth);
+        const reviewer = r.reviewer ? chalk.cyan(r.reviewer) + (r.model ? chalk.dim(`·${r.model}`) : '') : chalk.dim('—');
+        const recordSha = r.sha ?? r.pushedSha;
+        const sha = recordSha ? chalk.dim(`sha=${recordSha.slice(0, 7)}`) : '';
+        const round = r.round > 1 ? chalk.dim(`round=${r.round}`) : '';
+        const source = r.source === 'commit' ? chalk.dim('source=commit') : '';
+        const verdict = r.type === 'review' || r.type === 'recheck' ? verdictColor(r.verdict) : '';
+        const parts = [reviewer, sha, source, round, verdict].filter(Boolean).join('  ');
+        console.log(`  ${idx}  ${date}  ${type}  ${parts}`);
+    }
+}
+export async function runDetectStep(prUrl, opts = {}) {
+    const parsed = parsePRUrl(prUrl);
+    if (!parsed) {
+        console.error(chalk.red('Invalid PR URL. Expected: https://github.com/owner/repo/pull/123'));
+        process.exit(1);
+    }
+    const { owner, repo, number } = parsed;
+    let token;
+    try {
+        token = getGithubToken();
+    }
+    catch (err) {
+        console.error(chalk.red(`✗ ${err instanceof Error ? err.message : String(err)}`));
+        process.exit(1);
+    }
+    const spinner = ora(`Fetching PR #${number}...`).start();
+    const octokit = createGithubClient(token);
+    const { data: prData } = await octokit.rest.pulls.get({ owner, repo, pull_number: number });
+    spinner.succeed(`PR #${number}  ·  ${prData.title}`);
+    const steps = loadWorkflow(process.cwd());
+    const historySpinner = ora('Reading workflow history...').start();
+    const history = await fetchStepHistory(owner, repo, number, token);
+    historySpinner.stop();
+    const currentSha = prData.head.sha;
+    const nextResult = identifyNextWorkflowStep(history, steps, currentSha);
+    if (opts.json) {
+        console.log(JSON.stringify({
+            pr: { number, title: prData.title, headSha: currentSha, base: prData.base.ref },
+            history: history.map(r => ({
+                type: r.type,
+                verdict: r.verdict,
+                sha: r.sha,
+                pushedSha: r.pushedSha,
+                source: r.source,
+                round: r.round,
+                commentId: r.commentId,
+                createdAt: r.createdAt,
+                reviewer: r.reviewer,
+                model: r.model,
+                next_step: r.next_step,
+            })),
+            next: nextResult.step
+                ? {
+                    step: nextResult.step.type,
+                    stepName: nextResult.step.name,
+                    round: nextResult.round,
+                    reviewCommentId: nextResult.reviewComment?.id,
+                }
+                : null,
+        }, null, 2));
+        return;
+    }
+    console.log();
+    console.log(chalk.dim(`  HEAD   ${currentSha.slice(0, 7)}  ·  base: ${prData.base.ref}`));
+    console.log(chalk.dim(`  workflow steps: ${steps.map(s => s.name).join(' → ')}`));
+    console.log();
+    const divider = chalk.dim('─'.repeat(70));
+    console.log(`  ${chalk.bold('Step history')}  ${chalk.dim(`(${history.length} entr${history.length === 1 ? 'y' : 'ies'})`)}\n  ${divider}`);
+    printHistory(history);
+    console.log(`  ${divider}`);
+    console.log();
+    if (nextResult.step === null) {
+        const lastVerdict = [...history].reverse().find(r => r.verdict)?.verdict;
+        console.log(`  ${chalk.green('✓')} Workflow complete${lastVerdict ? ` — last verdict: ${verdictColor(lastVerdict)}` : ''}`);
+    }
+    else {
+        const nextLabel = chalk.bold(nextResult.step.type);
+        const roundLabel = nextResult.round > 1 ? chalk.dim(` (round ${nextResult.round})`) : '';
+        console.log(`  Next step:  ${nextLabel}${roundLabel}`);
+        if (nextResult.reviewComment) {
+            const commentUrl = `https://github.com/${owner}/${repo}/pull/${number}#issuecomment-${nextResult.reviewComment.id}`;
+            console.log(`  Context:    review comment #${nextResult.reviewComment.id}  ·  ${chalk.dim(commentUrl)}`);
+        }
+    }
+    console.log();
+}
+//# sourceMappingURL=detect-step.js.map

package/dist/commands/detect-step.js.map

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

package/dist/commands/kickass.d.ts

@@ -1,12 +1,19 @@
+import type { Config } from '../config/schema.js';
+import type { ErrorCategory } from '../lib/logger.js';
 import type { ScanPRStatus as PRStatus, ScanResult } from '../lib/pr-status.js';
 export interface KickassOpts {
     force?: boolean;
     staleAfter?: string;
     dryRun?: boolean;
+    roundMode?: 'crazy' | 'halfcrazy';
+    timeout?: string;
+    concurrent?: number;
+    staggerMs?: number;
 }
-export type KickassAction = 'review' | 'fix' | 'recheck' | 'merge' | 'skip';
+export type KickassAction = 'review' | 'fix' | 'recheck' | 'skip';
 export type KickassSkipReason = 'fork_pr' | 'stale_signature';
-export type KickassFailureReason = 'error';
+export type KickassFailureReason = ErrorCategory;
+export type FixDeliveryMode = Config['post_review']['auto_fix']['delivery']['mode'];
 export interface PreflightItem {
     pr: PRStatus;
     action: KickassAction;
@@ -14,6 +21,7 @@ export interface PreflightItem {
     details: string[];
     explanation?: string;
     skipReason?: KickassSkipReason;
+    chainRecheck?: boolean;
 }
 export interface KickassExecutionResult {
     pr: PRStatus;
@@ -22,8 +30,7 @@ export interface KickassExecutionResult {
 }
 export interface ExecuteKickassDeps {
     getCurrentHeadSha: (item: PreflightItem) => Promise<string>;
-    dispatchRun: (item: PreflightItem) => Promise<void>;
-    dispatchMerge: (item: PreflightItem) => Promise<void>;
+    dispatchRun: (item: PreflightItem) => Promise<string | void>;
 }
 export interface KickassDeps {
     loadScanResult: (options: {
@@ -32,18 +39,19 @@ export interface KickassDeps {
     }) => Promise<ScanResult>;
     pickPRs: (prs: PRStatus[]) => Promise<PRStatus[]>;
     confirm: (message: string) => Promise<boolean>;
+    getFixDeliveryMode?: () => FixDeliveryMode | Promise<FixDeliveryMode>;
     getCurrentHeadSha: (item: PreflightItem) => Promise<string>;
-    dispatchRun: (item: PreflightItem) => Promise<void>;
-    dispatchMerge: (item: PreflightItem) => Promise<void>;
+    dispatchRun: (item: PreflightItem) => Promise<string | void>;
 }
 export declare function runKickass(opts?: KickassOpts): Promise<void>;
 export declare function runKickassWithDeps(opts: KickassOpts | undefined, deps: KickassDeps): Promise<void>;
-export declare function buildPreflightPlan(prs: PRStatus[]): PreflightItem[];
-export declare function executeKickassPlan(plan: PreflightItem[], deps: ExecuteKickassDeps): Promise<KickassExecutionResult[]>;
-export declare function printPreflight(plan: PreflightItem[]): void;
+export declare function buildPreflightPlan(prs: PRStatus[], roundMode?: 'crazy' | 'halfcrazy', fixDeliveryMode?: FixDeliveryMode): PreflightItem[];
+export declare function executeKickassPlan(plan: PreflightItem[], deps: ExecuteKickassDeps, concurrency?: number, staggerMs?: number): Promise<KickassExecutionResult[]>;
+export declare function printPreflight(plan: PreflightItem[], mergeReady?: PRStatus[]): void;
+export declare function printMergeReady(prs: PRStatus[]): void;
 export declare function summarizeExecutionResults(results: KickassExecutionResult[]): string;
 export declare function printExecutionSummary(results: KickassExecutionResult[]): void;
-export declare function buildKickassRunArgs(itemOrPR: PreflightItem | PRStatus): string[];
+export declare function buildKickassRunArgs(itemOrPR: PreflightItem | PRStatus, roundMode?: 'crazy' | 'halfcrazy', timeout?: string): string[];
 export interface CliInvocation {
     command: string;
     args: string[];

package/dist/commands/kickass.d.ts.map

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

package/dist/commands/kickass.js

@@ -5,14 +5,13 @@ import { createInterface } from 'readline/promises';
 import { fileURLToPath } from 'url';
 import { execa } from 'execa';
 import { createGithubClient } from '../github/client.js';
-import { mergePullRequest } from '../github/merge.js';
-import { getGithubToken } from '../config/loader.js';
+import { getGithubToken, loadConfig } from '../config/loader.js';
 import { parseDuration } from '../lib/durations.js';
-import { logError } from '../lib/logger.js';
+import { classifyError, logError } from '../lib/logger.js';
 import { pickPRs } from '../lib/pr-picker.js';
 import { handleScanError, loadScanResult } from './scan.js';
 export async function runKickass(opts = {}) {
-    await runKickassWithDeps(opts, defaultKickassDeps());
+    await runKickassWithDeps(opts, defaultKickassDeps(opts));
 }
 export async function runKickassWithDeps(opts = {}, deps) {
     let staleAfterMs;
@@ -23,11 +22,38 @@ export async function runKickassWithDeps(opts = {}, deps) {
         console.error(chalk.red(`✗ ${err instanceof Error ? err.message : String(err)}`));
         process.exit(1);
     }
+    if (opts.timeout) {
+        try {
+            parseDuration(opts.timeout);
+        }
+        catch {
+            console.error(chalk.red(`✗ Invalid --timeout value "${opts.timeout}". Use a duration like 300s or 10m.`));
+            process.exit(1);
+        }
+    }
+    if (opts.concurrent !== undefined && (opts.concurrent < 0 || !Number.isInteger(opts.concurrent))) {
+        console.error(chalk.red('✗ --concurrent must be a non-negative integer (0 = one agent per selected PR)'));
+        process.exit(1);
+    }
     try {
         const scan = await deps.loadScanResult({ force: opts.force, staleAfterMs });
-        const queue = scan.prs.filter(pr => pr.freshness === 'stale' && pr.nextAction !== null);
+        // Actionable = nextAction is set and is not merge (merge not dispatched in v1).
+        // Stale PRs shown first; not-stale actionable PRs follow.
+        const queue = scan.prs
+            .filter(pr => pr.nextAction !== null && pr.nextAction !== 'merge')
+            .sort((a, b) => {
+            if (a.freshness !== b.freshness)
+                return a.freshness === 'stale' ? -1 : 1;
+            return 0;
+        });
+        const mergeReady = scan.prs.filter(pr => pr.nextAction === 'merge');
+        if (queue.length === 0 && mergeReady.length === 0) {
+            printNoActionablePRsWarning(scan.cached);
+            return;
+        }
         if (queue.length === 0) {
-            console.log(chalk.dim('No stale PRs need attention.'));
+            printMergeReady(mergeReady);
+            console.log(chalk.dim('\nNo PRs need review, fix, or recheck — all actionable work is merge-ready (manual).'));
             return;
         }
         const selected = await deps.pickPRs(queue);
@@ -35,8 +61,9 @@ export async function runKickassWithDeps(opts = {}, deps) {
             console.log(chalk.dim('No PRs selected.'));
             return;
         }
-        const plan = buildPreflightPlan(selected);
-        printPreflight(plan);
+        const fixDeliveryMode = deps.getFixDeliveryMode ? await deps.getFixDeliveryMode() : 'pull_request';
+        const plan = buildPreflightPlan(selected, opts.roundMode, fixDeliveryMode);
+        printPreflight(plan, mergeReady);
         if (opts.dryRun) {
             console.log(chalk.dim('\ndry-run: no mutations executed'));
             return;
@@ -46,7 +73,15 @@ export async function runKickassWithDeps(opts = {}, deps) {
             console.log(chalk.dim('Canceled.'));
             return;
         }
-        const results = await executeKickassPlan(plan, deps);
+        // 0 = one agent per selected PR; undefined/1 = sequential
+        const resolvedConcurrency = opts.concurrent === 0
+            ? selected.length
+            : Math.max(1, opts.concurrent ?? 1);
+        const resolvedStagger = resolvedConcurrency > 1 ? (opts.staggerMs ?? 2_000) : 0;
+        if (resolvedConcurrency > 1) {
+            console.log(chalk.dim(`\n  running ${resolvedConcurrency} agents in parallel (${resolvedStagger}ms stagger)`));
+        }
+        const results = await executeKickassPlan(plan, deps, resolvedConcurrency, resolvedStagger);
         printExecutionSummary(results);
         if (results.some(result => result.status === 'failed')) {
             process.exitCode = 2;
@@ -56,7 +91,9 @@ export async function runKickassWithDeps(opts = {}, deps) {
         handleScanError('kickass', err);
     }
 }
-export function buildPreflightPlan(prs) {
+export function buildPreflightPlan(prs, roundMode, fixDeliveryMode = 'pull_request') {
+    const modeTag = roundMode ? ` [${roundMode}]` : '';
+    const chainRecheck = fixDeliveryMode === 'commit';
     return prs.map((pr) => {
         const fork = isForkPR(pr);
         if (pr.nextAction === 'fix' && fork) {
@@ -89,59 +126,166 @@ export function buildPreflightPlan(prs) {
             return {
                 pr,
                 action: 'fix',
-                transition: `${pr.reviewState} -> Fix`,
-                details: [`fixer ${fixerLabel(pr)}`, 'delivery commit'],
-            };
-        }
-        if (pr.nextAction === 'recheck') {
-            return {
-                pr,
-                action: 'recheck',
-                transition: `${pr.reviewState} -> Recheck`,
-                details: ['links latest review'],
+                transition: chainRecheck
+                    ? `${pr.reviewState} -> fix→recheck${modeTag}`
+                    : `${pr.reviewState} -> fix`,
+                details: [
+                    `fixer ${fixerLabel(pr)}`,
+                    `delivery ${fixDeliveryMode}`,
+                    ...(chainRecheck ? [] : ['recheck deferred']),
+                ],
+                chainRecheck,
             };
         }
+        // nextAction === 'recheck' — fix was applied externally; close the loop with one recheck
         return {
             pr,
-            action: 'merge',
-            transition: 'APPROVE -> Merge',
-            details: ['method squash', `checks ${checksLabel(pr)}`],
+            action: 'recheck',
+            transition: `${pr.reviewState} -> Recheck`,
+            details: ['links latest review'],
         };
     });
 }
-export async function executeKickassPlan(plan, deps) {
-    const results = [];
-    for (const item of plan) {
+function printCapturedOutput(label, output) {
+    const lines = output.trimEnd().split('\n');
+    console.log(chalk.dim(`\n── ${label} ${'─'.repeat(Math.max(0, 48 - label.length))}`));
+    for (const line of lines)
+        console.log(`  ${line}`);
+}
+function printNoActionablePRsWarning(fromCache) {
+    console.log(chalk.dim('No actionable PRs found.'));
+    if (fromCache) {
+        console.log(chalk.yellow(`⚠ This result came from the scan cache. Rerun with --force to refresh the queue.`));
+    }
+}
+export async function executeKickassPlan(plan, deps, concurrency = 1, staggerMs = 0) {
+    const results = new Array(plan.length);
+    const executeItem = async (item, index, attempt = 1) => {
         if (item.action === 'skip') {
             console.log(chalk.yellow(`↷ skip ${formatPRSignature(item.pr)}  ${item.skipReason ?? 'skipped'}`));
-            results.push({ pr: item.pr, status: 'skipped', reason: item.skipReason });
-            continue;
+            results[index] = { pr: item.pr, status: 'skipped', reason: item.skipReason };
+            return;
         }
         try {
             const currentHeadSha = await deps.getCurrentHeadSha(item);
             if (currentHeadSha !== item.pr.headSha) {
                 console.log(chalk.yellow(`↷ skip ${formatPRSignature(item.pr)}  stale_signature`));
-                results.push({ pr: item.pr, status: 'skipped', reason: 'stale_signature' });
-                continue;
+                results[index] = { pr: item.pr, status: 'skipped', reason: 'stale_signature' };
+                return;
             }
-            console.log(chalk.cyan(`\n→ ${item.transition}  ${formatPRSignature(item.pr)}`));
-            if (item.action === 'merge') {
-                await deps.dispatchMerge(item);
+            const attemptLabel = attempt > 1 ? ` (retry ${attempt - 1})` : '';
+            console.log(chalk.cyan(`\n→ ${item.transition}  ${formatPRSignature(item.pr)}${attemptLabel}`));
+            const output = await deps.dispatchRun(item);
+            if (typeof output === 'string' && output)
+                printCapturedOutput(formatPRSignature(item.pr), output);
+            if (item.action === 'fix' && item.chainRecheck === true) {
+                const fixedHeadSha = await deps.getCurrentHeadSha(item);
+                if (fixedHeadSha !== item.pr.headSha) {
+                    const recheckItem = buildPostFixRecheckItem(item, fixedHeadSha);
+                    console.log(chalk.cyan(`\n→ ${recheckItem.transition}  ${formatPRSignature(recheckItem.pr)}`));
+                    const recheckOutput = await deps.dispatchRun(recheckItem);
+                    if (typeof recheckOutput === 'string' && recheckOutput)
+                        printCapturedOutput(formatPRSignature(recheckItem.pr), recheckOutput);
+                }
+                else {
+                    console.log(chalk.dim(`  head SHA unchanged after fix — recheck deferred`));
+                }
             }
-            else {
-                await deps.dispatchRun(item);
-            }
-            results.push({ pr: item.pr, status: 'executed' });
+            results[index] = { pr: item.pr, status: 'executed' };
         }
         catch (err) {
-            logError({ event: 'kickass_pr_failed', owner: item.pr.owner, repo: item.pr.repo, pr: item.pr.number }, err);
+            logError({ event: 'kickass_pr_failed', owner: item.pr.owner, repo: item.pr.repo, pr: item.pr.number, ...(attempt > 1 && { attempt }) }, err);
             console.error(chalk.red(`✗ failed ${formatPRSignature(item.pr)}`));
-            results.push({ pr: item.pr, status: 'failed', reason: 'error' });
+            // Classify execa errors using structured fields, not the raw message.
+            // The raw message includes the full CLI invocation (e.g. "Command failed with exit
+            // code 1: node crosscheck run --timeout 300s --no-timeout"), so a text match against
+            // `message` would misclassify ordinary subprocess failures as 'timeout' whenever the
+            // command contains a --timeout flag.
+            const maybeExeca = err;
+            let msgForClassify;
+            if (maybeExeca.timedOut === true) {
+                // execa's structured timeout flag — reliable; bypass message matching entirely.
+                msgForClassify = 'timed out';
+            }
+            else if (typeof maybeExeca.exitCode === 'number') {
+                // Subprocess failure: prefer stderr (actual error output) over the message which
+                // includes the full command string.  Strip the command suffix when stderr is absent.
+                const stderr = typeof maybeExeca.stderr === 'string' ? maybeExeca.stderr.trim() : '';
+                msgForClassify = stderr || (err instanceof Error ? err.message.replace(/:\s*\S.*$/, '') : String(err));
+            }
+            else {
+                msgForClassify = err instanceof Error ? err.message : String(err);
+            }
+            const category = classifyError(msgForClassify);
+            results[index] = { pr: item.pr, status: 'failed', reason: category };
+        }
+    };
+    if (concurrency <= 1) {
+        for (let i = 0; i < plan.length; i++)
+            await executeItem(plan[i], i);
+    }
+    else {
+        // Worker-pool: up to `concurrency` PRs run in parallel.
+        // staggerMs > 0 delays each worker's start by (workerIdx * staggerMs) to spread
+        // concurrent subprocess startup API calls over time rather than hitting GitHub simultaneously.
+        let ptr = 0;
+        const makeWorker = (workerIdx) => async () => {
+            if (staggerMs > 0 && workerIdx > 0) {
+                await new Promise(resolve => setTimeout(resolve, workerIdx * staggerMs));
+            }
+            while (ptr < plan.length) {
+                const i = ptr++;
+                await executeItem(plan[i], i);
+            }
+        };
+        await Promise.all(Array.from({ length: Math.min(concurrency, plan.length) }, (_, idx) => makeWorker(idx)()));
+    }
+    // Retry transient failures up to 4 times with escalating delays.
+    // Auth and permission failures are operator issues that won't self-heal.
+    const RETRYABLE = new Set(['network', 'timeout']);
+    const RETRY_DELAYS_MS = [60_000, 120_000, 300_000, 600_000];
+    for (let attempt = 2; attempt <= RETRY_DELAYS_MS.length + 1; attempt++) {
+        const delayMs = RETRY_DELAYS_MS[attempt - 2];
+        const retryItems = results
+            .map((r, i) => ({ r, i }))
+            .filter(({ r }) => r.status === 'failed' && RETRYABLE.has(r.reason));
+        if (retryItems.length === 0)
+            break;
+        const delaySec = delayMs / 1000;
+        const delayLabel = delaySec >= 60 ? `${delaySec / 60}m` : `${delaySec}s`;
+        console.log(chalk.dim(`\n  ${retryItems.length} transient failure(s) — retry ${attempt - 1}/${RETRY_DELAYS_MS.length} in ${delayLabel}...`));
+        await new Promise(resolve => setTimeout(resolve, delayMs));
+        for (const { i } of retryItems) {
+            const priorResult = results[i];
+            await executeItem(plan[i], i, attempt);
+            // Stale-signature means the fix already committed in a prior attempt but the
+            // chained recheck failed transiently.  Instead of reporting that failure as
+            // final, fetch the current head and run a bare recheck to actually retry it.
+            if (results[i].status === 'skipped' && results[i].reason === 'stale_signature'
+                && plan[i].action === 'fix' && plan[i].chainRecheck === true) {
+                try {
+                    const currentHead = await deps.getCurrentHeadSha(plan[i]);
+                    const recheckItem = buildPostFixRecheckItem(plan[i], currentHead);
+                    await executeItem(recheckItem, i, attempt);
+                }
+                catch {
+                    // If we cannot fetch the head (network failure), preserve the original failure.
+                    results[i] = priorResult;
+                }
+            }
         }
     }
     return results;
 }
-export function printPreflight(plan) {
+function buildPostFixRecheckItem(item, headSha) {
+    return {
+        pr: { ...item.pr, headSha, nextAction: 'recheck', reviewState: 'NEEDS_RECHECK' },
+        action: 'recheck',
+        transition: 'fix -> Recheck',
+        details: ['links latest review', `head ${headSha.slice(0, 7)}`],
+    };
+}
+export function printPreflight(plan, mergeReady = []) {
     console.log('\nPreflight');
     const grouped = groupPreflight(plan);
     for (const [transition, items] of grouped) {
@@ -151,6 +295,14 @@ export function printPreflight(plan) {
             console.log(`  ${formatPRSignature(item.pr)}  ${item.details.join('  ')}${explanation}`);
         }
     }
+    if (mergeReady.length > 0)
+        printMergeReady(mergeReady);
+}
+export function printMergeReady(prs) {
+    console.log(chalk.dim('\nneeds merge (manual — not selected)'));
+    for (const pr of prs) {
+        console.log(chalk.dim(`  ${formatPRSignature(pr)}  APPROVE`));
+    }
 }
 export function summarizeExecutionResults(results) {
     const executed = results.filter(result => result.status === 'executed').length;
@@ -161,18 +313,36 @@ export function summarizeExecutionResults(results) {
 export function printExecutionSummary(results) {
     console.log(chalk.dim(`\n${summarizeExecutionResults(results)}`));
 }
-export function buildKickassRunArgs(itemOrPR) {
+export function buildKickassRunArgs(itemOrPR, roundMode, timeout) {
     const item = 'action' in itemOrPR ? itemOrPR : buildPreflightPlan([itemOrPR])[0];
-    if (item.action === 'merge' || item.action === 'skip')
+    if (item.action === 'skip')
         return [];
-    return [
-        'run',
-        item.pr.url,
-        '--steps',
-        stepForAction(item.action),
-        '--expected-head-sha',
-        item.pr.headSha,
-    ];
+    const args = ['run', item.pr.url];
+    // No --steps for normal review/recheck/fix actions: run.ts calls
+    // identifyNextWorkflowStep against live PR history to determine the correct
+    // next step. Exception: when kickass demoted a fix action to review because the
+    // latest annotation covers an older SHA (no_usable_review_comment), we must
+    // force --steps review so run.ts doesn't re-detect from live history and choose
+    // the stale review's fix step, applying fixes to the unreviewed new diff.
+    if (item.action === 'review' && item.explanation === 'no_usable_review_comment') {
+        args.push('--steps', 'review');
+    }
+    args.push('--expected-head-sha', item.pr.headSha);
+    if (item.action !== 'fix') {
+        if (roundMode === 'crazy')
+            args.push('--crazy');
+        else if (roundMode === 'halfcrazy')
+            args.push('--half-crazy');
+    }
+    else if (roundMode) {
+        // fix legs don't loop, but still need the no-timeout constraint lifted
+        args.push('--no-timeout');
+    }
+    // forward user-specified --timeout for runs that aren't already in a round mode
+    if (timeout && !roundMode)
+        args.push('--timeout', timeout);
+    args.push('--trigger', 'kickass');
+    return args;
 }
 export function resolveCliInvocation(options = {}) {
     const exists = options.exists ?? existsSync;
@@ -191,16 +361,20 @@ export function resolveCliInvocation(options = {}) {
         return invocationForEntry(sourceCli, execPath, localTsx, exists);
     throw new Error('Cannot resolve crosscheck CLI entrypoint. Run npm run build before kickass, or run from a source checkout with dev dependencies installed.');
 }
-function defaultKickassDeps() {
+function defaultKickassDeps(opts = {}) {
     let cli;
     const getCli = () => {
         cli ??= resolveCliInvocation();
         return cli;
     };
+    // opts.concurrent = 0 means "one per PR" (fully parallel); undefined means sequential.
+    // Any explicit --concurrent value uses buffered stdio; sequential streams inline.
+    const isParallel = opts.concurrent !== undefined;
     return {
         loadScanResult,
         pickPRs,
         confirm: confirmMutation,
+        getFixDeliveryMode: () => loadConfig().post_review.auto_fix.delivery.mode,
         getCurrentHeadSha: async (item) => {
             const token = getGithubToken();
             const octokit = createGithubClient(token);
@@ -213,15 +387,12 @@ function defaultKickassDeps() {
         },
         dispatchRun: async (item) => {
             const invocation = getCli();
-            await execa(invocation.command, [...invocation.args, ...buildKickassRunArgs(item)], { stdio: 'inherit' });
-        },
-        dispatchMerge: async (item) => {
-            const token = getGithubToken();
-            const octokit = createGithubClient(token);
-            await mergePullRequest(octokit, item.pr.owner, item.pr.repo, item.pr.number, {
-                method: 'squash',
-                expectedHeadSha: item.pr.headSha,
-            });
+            const args = [...invocation.args, ...buildKickassRunArgs(item, opts.roundMode, opts.timeout)];
+            if (isParallel) {
+                const result = await execa(invocation.command, args, { stdio: 'pipe', all: true });
+                return result.all ?? '';
+            }
+            await execa(invocation.command, args, { stdio: 'inherit' });
         },
     };
 }
@@ -268,10 +439,10 @@ function checksLabel(pr) {
         return 'green';
     return pr.merge.mergeStateStatus ?? 'unknown';
 }
-function stepForAction(action) {
-    if (action === 'review')
+function stepsForItem(item) {
+    if (item.action === 'review')
         return 'review';
-    if (action === 'fix')
+    if (item.action === 'fix')
         return 'fix';
     return 'recheck';
 }