sequant 2.0.0 → 2.1.0

package/dist/src/lib/settings.js

@@ -30,6 +30,7 @@ export const DEFAULT_ROTATION_SETTINGS = {
 export const DEFAULT_AGENT_SETTINGS = {
     parallel: false,
     model: "haiku",
+    isolateParallel: false,
 };
 /**
  * Default trivial thresholds for scope assessment

package/dist/src/lib/shutdown.js

@@ -138,7 +138,7 @@ export class ShutdownManager {
             return;
         }
         this._isShuttingDown = true;
-        this.output(chalk.yellow(`\n⚠️  Received ${signal}, shutting down gracefully...`));
+        this.output(chalk.yellow(`\n!  Received ${signal}, shutting down gracefully...`));
         // Abort all in-flight phases immediately
         if (this.abortControllers.size > 0) {
             const count = this.abortControllers.size;

package/dist/src/lib/templates.js

@@ -205,6 +205,8 @@ export async function copyTemplates(stack, tokens, options = {}) {
     }
     // Copy skills
     await copyDir(join(templatesDir, "skills"), ".claude/skills");
+    // Copy agent definitions
+    await copyDir(join(templatesDir, "agents"), ".claude/agents");
     // Copy hooks
     await copyDir(join(templatesDir, "hooks"), ".claude/hooks");
     // Copy memory (constitution, etc.)

package/dist/src/lib/wizard.js

@@ -66,11 +66,13 @@ export function displayDependencyStatus(result) {
                 console.log(chalk.yellow(`  ${chalk.yellow("!")} ${dep.displayName} - installed but not authenticated`));
             }
             else {
-                console.log(chalk.green(`  ${chalk.green("✓")} ${dep.displayName} - installed`));
+                console.log(chalk.green(`  ${chalk.green("\u2714")} ${dep.displayName} - installed`));
             }
         }
         else {
-            const marker = dep.required ? chalk.red("✗") : chalk.yellow("○");
+            const marker = dep.required
+                ? chalk.red("\u2716")
+                : chalk.yellow("\u00B7");
             const status = dep.required
                 ? "not installed (required)"
                 : "not installed (optional)";
@@ -135,7 +137,7 @@ export async function runSetupWizard(result, options = {}) {
         };
     }
     // Ask if user wants to set up missing dependencies
-    let setupDeps = false;
+    let setupDeps;
     try {
         const response = await inquirer.prompt([
             {
@@ -181,7 +183,7 @@ export async function runSetupWizard(result, options = {}) {
             console.log(`  ${instruction}`);
         }
         console.log();
-        let action = "skip";
+        let action;
         try {
             const response = await inquirer.prompt([
                 {

package/dist/src/lib/workflow/batch-executor.d.ts

@@ -7,7 +7,7 @@
  * (including quality-loop retries, checkpoint commits, rebasing, and PR
  * creation).
  */
-import { IssueResult, type RunOptions, type IssueExecutionContext, type BatchExecutionContext } from "./types.js";
+import { PhaseResult, IssueResult, type RunOptions, type IssueExecutionContext, type BatchExecutionContext } from "./types.js";
 export type { RunOptions, ProgressCallback, IssueExecutionContext, BatchExecutionContext, } from "./types.js";
 /**
  * Emit a structured progress line to stderr for MCP progress notifications.
@@ -19,6 +19,14 @@ export type { RunOptions, ProgressCallback, IssueExecutionContext, BatchExecutio
  * @param event - Phase lifecycle event: "start", "complete", or "failed"
  * @param extra - Optional fields: durationSeconds (on complete), error (on failed)
  */
+/**
+ * Build enriched prompt context for the /loop phase from a failed phase result (#488).
+ * Passes QA verdict, failed ACs, and error directly so the /loop skill doesn't need
+ * to reconstruct context from GitHub comments (which fails in subprocess).
+ *
+ * @internal Exported for testing only
+ */
+export declare function buildLoopContext(failedResult: PhaseResult): string;
 export declare function emitProgressLine(issue: number, phase: string, event?: "start" | "complete" | "failed", extra?: {
     durationSeconds?: number;
     error?: string;

package/dist/src/lib/workflow/batch-executor.js

@@ -26,6 +26,34 @@ import { detectPhasesFromLabels, parseRecommendedWorkflow, determinePhasesForIss
  * @param event - Phase lifecycle event: "start", "complete", or "failed"
  * @param extra - Optional fields: durationSeconds (on complete), error (on failed)
  */
+/**
+ * Build enriched prompt context for the /loop phase from a failed phase result (#488).
+ * Passes QA verdict, failed ACs, and error directly so the /loop skill doesn't need
+ * to reconstruct context from GitHub comments (which fails in subprocess).
+ *
+ * @internal Exported for testing only
+ */
+export function buildLoopContext(failedResult) {
+    const parts = [`Previous phase "${failedResult.phase}" failed.`];
+    if (failedResult.verdict) {
+        parts.push(`QA Verdict: ${failedResult.verdict}`);
+    }
+    if (failedResult.summary?.gaps?.length) {
+        parts.push(`QA Gaps:\n${failedResult.summary.gaps.map((gap) => `- ${gap}`).join("\n")}`);
+    }
+    if (failedResult.summary?.suggestions?.length) {
+        parts.push(`Suggestions:\n${failedResult.summary.suggestions.map((s) => `- ${s}`).join("\n")}`);
+    }
+    if (failedResult.error) {
+        parts.push(`Error: ${failedResult.error}`);
+    }
+    // Include tail of output for additional context (truncated to avoid prompt bloat)
+    if (failedResult.output) {
+        const tail = failedResult.output.slice(-2000);
+        parts.push(`Last output:\n${tail}`);
+    }
+    return parts.join("\n\n");
+}
 export function emitProgressLine(issue, phase, event = "start", extra) {
     if (!process.env.SEQUANT_ORCHESTRATOR)
         return;
@@ -271,7 +299,7 @@ export async function runIssueWithLogging(ctx) {
         catch (error) {
             // State tracking errors shouldn't stop execution
             if (config.verbose) {
-                log(chalk.yellow(`    ⚠️  State tracking error: ${error}`));
+                log(chalk.yellow(`    !  State tracking error: ${error}`));
             }
         }
     }
@@ -634,8 +662,17 @@ export async function runIssueWithLogging(ctx) {
                     catch {
                         /* progress errors must not halt */
                     }
+                    // Build enriched config for loop phase with QA context (#488).
+                    // Pass verdict, failed ACs, and error directly so the /loop skill
+                    // doesn't need to reconstruct context from GitHub comments.
+                    const loopConfig = {
+                        ...issueConfig,
+                        lastVerdict: result.verdict ?? undefined,
+                        failedAcs: result.summary?.gaps?.join("; ") ?? undefined,
+                        promptContext: buildLoopContext(result),
+                    };
                     const loopStartTime = new Date();
-                    const loopResult = await executePhaseWithRetry(issueNumber, "loop", issueConfig, sessionId, worktreePath, shutdownManager, loopSpinner);
+                    const loopResult = await executePhaseWithRetry(issueNumber, "loop", loopConfig, sessionId, worktreePath, shutdownManager, loopSpinner);
                     const loopEndTime = new Date();
                     phaseResults.push(loopResult);
                     // Emit loop completion/failure progress event (AC-8)

package/dist/src/lib/workflow/log-writer.js

@@ -53,7 +53,7 @@ export class LogWriter {
             await this.ensureLogDirectory(userPath);
         }
         if (this.verbose && this.runLog) {
-            console.log(`📝 Log initialized: ${this.runLog.runId}`);
+            console.log(`Log initialized: ${this.runLog.runId}`);
         }
     }
     /**
@@ -79,7 +79,7 @@ export class LogWriter {
         // Keep currentIssue in sync for callers that don't pass issueNumber
         this.currentIssue = issueData;
         if (this.verbose) {
-            console.log(`📝 Started logging issue #${issueNumber}`);
+            console.log(`Log started: issue #${issueNumber}`);
         }
     }
     /**
@@ -102,7 +102,7 @@ export class LogWriter {
             issue.status = "partial";
         }
         if (this.verbose) {
-            console.log(`📝 Logged phase: ${phaseLog.phase} (${phaseLog.status}) - ${phaseLog.durationSeconds.toFixed(1)}s`);
+            console.log(`Log phase: ${phaseLog.phase} (${phaseLog.status}) - ${phaseLog.durationSeconds.toFixed(1)}s`);
         }
     }
     /**
@@ -160,7 +160,7 @@ export class LogWriter {
             this.currentIssue = null;
         }
         if (this.verbose) {
-            console.log(`📝 Completed issue #${issueLog.issueNumber} (${issueLog.status})`);
+            console.log(`Log complete: issue #${issueLog.issueNumber} (${issueLog.status})`);
         }
     }
     /**
@@ -197,13 +197,13 @@ export class LogWriter {
             await this.writeLogFile(userPath, finalLog);
         }
         if (this.verbose) {
-            console.log(`📝 Log written: ${projectPath}`);
+            console.log(`Log written: ${projectPath}`);
         }
         // Auto-rotate if needed
         if (this.rotation.enabled) {
             const result = rotateIfNeeded(this.logPath, this.rotation);
             if (result.rotated && this.verbose) {
-                console.log(`📝 Rotated ${result.deletedCount} old log(s), reclaimed ${(result.bytesReclaimed / 1024).toFixed(1)} KB`);
+                console.log(`Log rotated: ${result.deletedCount} old log(s), reclaimed ${(result.bytesReclaimed / 1024).toFixed(1)} KB`);
             }
         }
         return projectPath;

package/dist/src/lib/workflow/metrics-writer.js

@@ -66,7 +66,9 @@ export class MetricsWriter {
         }
         catch (error) {
             if (error instanceof SyntaxError) {
-                throw new Error(`Invalid JSON in metrics file: ${error.message}`);
+                throw new Error(`Invalid JSON in metrics file: ${error.message}`, {
+                    cause: error,
+                });
             }
             throw error;
         }
@@ -119,7 +121,7 @@ export class MetricsWriter {
         metrics.runs.push(run);
         await this.saveMetrics(metrics);
         if (this.verbose) {
-            console.log(`📊 Recorded run: ${run.id.slice(0, 8)}... (${run.outcome})`);
+            console.log(`Metrics recorded: ${run.id.slice(0, 8)}... (${run.outcome})`);
         }
         return run;
     }
@@ -162,7 +164,7 @@ export class MetricsWriter {
             fs.unlinkSync(this.metricsPath);
             this.cachedMetrics = null;
             if (this.verbose) {
-                console.log(`📊 Metrics deleted: ${this.metricsPath}`);
+                console.log(`Metrics deleted: ${this.metricsPath}`);
             }
         }
     }

package/dist/src/lib/workflow/phase-executor.d.ts

@@ -48,7 +48,7 @@ export declare function formatDuration(seconds: number): string;
  *
  * @internal Exported for testing only
  */
-export declare function getPhasePrompt(phase: Phase, issueNumber: number, agent?: string): Promise<string>;
+export declare function getPhasePrompt(phase: Phase, issueNumber: number, agent?: string, promptContext?: string): Promise<string>;
 /**
  * Execute a single phase for an issue using the configured AgentDriver.
  */

package/dist/src/lib/workflow/phase-executor.js

@@ -224,9 +224,13 @@ export function formatDuration(seconds) {
  *
  * @internal Exported for testing only
  */
-export async function getPhasePrompt(phase, issueNumber, agent) {
+export async function getPhasePrompt(phase, issueNumber, agent, promptContext) {
     const prompts = agent && agent !== "claude-code" ? AIDER_PHASE_PROMPTS : PHASE_PROMPTS;
-    const basePrompt = prompts[phase].replace(/\{issue\}/g, String(issueNumber));
+    let basePrompt = prompts[phase].replace(/\{issue\}/g, String(issueNumber));
+    // Append phase-specific context (e.g., QA findings for loop phase)
+    if (promptContext) {
+        basePrompt += `\n\n---\n\n${promptContext}`;
+    }
     // Include AGENTS.md content in the prompt context for non-Claude agent compatibility.
     // Claude reads CLAUDE.md natively, but other agents (Aider, Codex, Gemini CLI)
     // rely on AGENTS.md for project context.
@@ -241,7 +245,7 @@ export async function getPhasePrompt(phase, issueNumber, agent) {
  */
 async function executePhase(issueNumber, phase, config, sessionId, worktreePath, shutdownManager, spinner) {
     const startTime = Date.now();
-    const prompt = await getPhasePrompt(phase, issueNumber, config.agent);
+    const prompt = await getPhasePrompt(phase, issueNumber, config.agent, config.promptContext);
     if (config.dryRun) {
         // Dry run - show the prompt that would be sent, then return
         if (config.verbose) {
@@ -318,6 +322,17 @@ async function executePhase(issueNumber, phase, config, sessionId, worktreePath,
     if (config.issueType) {
         env.SEQUANT_ISSUE_TYPE = config.issueType;
     }
+    // Pass QA context to loop phase so it doesn't need to reconstruct from GitHub (#488)
+    if (config.lastVerdict) {
+        env.SEQUANT_LAST_VERDICT = config.lastVerdict;
+    }
+    if (config.failedAcs) {
+        env.SEQUANT_FAILED_ACS = config.failedAcs;
+    }
+    // Propagate parallel isolation mode to exec skill (#485)
+    if (config.isolateParallel) {
+        env.SEQUANT_ISOLATE_PARALLEL = "true";
+    }
     // Track whether we're actively streaming verbose output
     // Pausing spinner once per streaming session prevents truncation from rapid pause/resume cycles
     // (Issue #283: ora's stop() clears the current line, which can truncate output when
@@ -452,37 +467,52 @@ delayFn = (ms) => new Promise((resolve) => setTimeout(resolve, ms))) {
     if (config.retry === false) {
         return executePhaseFn(issueNumber, phase, config, sessionId, worktreePath, shutdownManager, spinner);
     }
+    // Skip cold-start retries for `loop` phase (#488).
+    // Loop is always a re-run after a failed QA — never a first boot.
+    // Failures at 47-51s are genuine skill failures, not cold-start issues.
+    // Without this guard, 2 cold-start retries + 1 MCP fallback = 3 wasted spawns per loop.
+    const skipColdStartRetry = phase === "loop";
     let lastResult;
-    // Phase 1: Cold-start retry attempts (with MCP enabled if configured)
-    for (let attempt = 0; attempt <= COLD_START_MAX_RETRIES; attempt++) {
+    if (skipColdStartRetry) {
+        // Single attempt — no cold-start retry loop
         lastResult = await executePhaseFn(issueNumber, phase, config, sessionId, worktreePath, shutdownManager, spinner);
-        const duration = lastResult.durationSeconds ?? 0;
-        // Success → return immediately
         if (lastResult.success) {
             return lastResult;
         }
-        // Genuine failure (took long enough to be real work) → skip cold-start retries.
-        // For spec phase, break to allow Phase 3 (spec-specific retry) to run.
-        // For other phases, return immediately — no further retries.
-        if (duration >= COLD_START_THRESHOLD_SECONDS) {
-            if (phase === "spec") {
-                break;
+    }
+    else {
+        // Phase 1: Cold-start retry attempts (with MCP enabled if configured)
+        for (let attempt = 0; attempt <= COLD_START_MAX_RETRIES; attempt++) {
+            lastResult = await executePhaseFn(issueNumber, phase, config, sessionId, worktreePath, shutdownManager, spinner);
+            const duration = lastResult.durationSeconds ?? 0;
+            // Success → return immediately
+            if (lastResult.success) {
+                return lastResult;
             }
-            return lastResult;
-        }
-        // Cold-start failure detected — retry
-        if (attempt < COLD_START_MAX_RETRIES) {
-            if (config.verbose) {
-                console.log(chalk.yellow(`\n    ⟳ Cold-start failure detected (${duration.toFixed(1)}s), retrying... (attempt ${attempt + 2}/${COLD_START_MAX_RETRIES + 1})`));
+            // Genuine failure (took long enough to be real work) → skip cold-start retries.
+            // For spec phase, break to allow Phase 3 (spec-specific retry) to run.
+            // For other phases, return immediately — no further retries.
+            if (duration >= COLD_START_THRESHOLD_SECONDS) {
+                if (phase === "spec") {
+                    break;
+                }
+                return lastResult;
+            }
+            // Cold-start failure detected — retry
+            if (attempt < COLD_START_MAX_RETRIES) {
+                if (config.verbose) {
+                    console.log(chalk.yellow(`\n    ⟳ Cold-start failure detected (${duration.toFixed(1)}s), retrying... (attempt ${attempt + 2}/${COLD_START_MAX_RETRIES + 1})`));
+                }
             }
         }
     }
     // Capture the original error for better diagnostics
     const originalError = lastResult.error;
     // Phase 2: MCP fallback - if MCP is enabled and we're still failing, try without MCP
-    // This handles npx-based MCP servers that fail on first run due to cold-cache issues
-    if (config.mcp && !lastResult.success) {
-        console.log(chalk.yellow(`\n    ⚠️ Phase failed with MCP enabled, retrying without MCP...`));
+    // This handles npx-based MCP servers that fail on first run due to cold-cache issues.
+    // Skip for `loop` phase — MCP is never the cause of loop failures (#488).
+    if (config.mcp && !lastResult.success && !skipColdStartRetry) {
+        console.log(chalk.yellow(`\n    ! Phase failed with MCP enabled, retrying without MCP...`));
         // Create config copy with MCP disabled
         const configWithoutMcp = {
             ...config,

package/dist/src/lib/workflow/platforms/github.js

@@ -344,8 +344,12 @@ export class GitHubProvider {
                 stdio: ["pipe", "pipe", "pipe"],
                 timeout: 30000,
             });
-            if (result.status !== 0 || !result.stdout)
+            if (result.status !== 0 || !result.stdout) {
+                if (result.stderr) {
+                    console.error(`gh issue create failed: ${result.stderr.trim()}`);
+                }
                 return null;
+            }
             const url = result.stdout.trim();
             const numberMatch = url.match(/\/issues\/(\d+)$/);
             const number = numberMatch ? parseInt(numberMatch[1], 10) : 0;

package/dist/src/lib/workflow/state-cleanup.js

@@ -73,7 +73,7 @@ export async function cleanupStaleEntries(options = {}) {
             if (issueState.worktree &&
                 !activeWorktrees.includes(issueState.worktree)) {
                 if (options.verbose) {
-                    console.log(`🔍 Orphaned: #${issueNum} (worktree not found: ${issueState.worktree})`);
+                    console.log(`Orphaned: #${issueNum} (worktree not found: ${issueState.worktree})`);
                 }
                 // Check if this issue has a PR and if it's merged
                 let prMerged = false;

package/dist/src/lib/workflow/state-manager.js

@@ -100,7 +100,7 @@ export class StateManager {
                     continue;
                 }
                 if (Date.now() - start > this.lockTimeout) {
-                    throw new Error(`Timeout acquiring state lock after ${this.lockTimeout}ms`);
+                    throw new Error(`Timeout acquiring state lock after ${this.lockTimeout}ms`, { cause: err });
                 }
                 // Wait and retry
                 await new Promise((resolve) => setTimeout(resolve, retryDelay));
@@ -150,7 +150,9 @@ export class StateManager {
         }
         catch (error) {
             if (error instanceof SyntaxError) {
-                throw new Error(`Invalid JSON in state file: ${error.message}`);
+                throw new Error(`Invalid JSON in state file: ${error.message}`, {
+                    cause: error,
+                });
             }
             throw error;
         }
@@ -182,7 +184,7 @@ export class StateManager {
                 }
             }
             if (pruned.length > 0 && this.verbose) {
-                console.log(`📊 Pruned ${pruned.length} expired issue(s): ${pruned.map((k) => `#${k}`).join(", ")}`);
+                console.log(`State: Pruned ${pruned.length} expired issue(s): ${pruned.map((k) => `#${k}`).join(", ")}`);
             }
         }
         catch {
@@ -272,7 +274,7 @@ export class StateManager {
             await this.saveState(state);
         });
         if (this.verbose) {
-            console.log(`📊 Initialized issue #${issueNumber}: ${title}`);
+            console.log(`State: Initialized issue #${issueNumber}: ${title}`);
         }
     }
     /**
@@ -313,7 +315,7 @@ export class StateManager {
             await this.saveState(state);
         });
         if (this.verbose) {
-            console.log(`📊 Phase ${phase} → ${status} for issue #${issueNumber}`);
+            console.log(`State: Phase ${phase} → ${status} for issue #${issueNumber}`);
         }
     }
     /**
@@ -335,7 +337,7 @@ export class StateManager {
             await this.saveState(state);
         });
         if (this.verbose) {
-            console.log(`📊 Issue #${issueNumber} status → ${status}`);
+            console.log(`State: Issue #${issueNumber} status → ${status}`);
         }
     }
     /**
@@ -353,7 +355,7 @@ export class StateManager {
             await this.saveState(state);
         });
         if (this.verbose) {
-            console.log(`📊 PR #${pr.number} linked to issue #${issueNumber}`);
+            console.log(`State: PR #${pr.number} linked to issue #${issueNumber}`);
         }
     }
     /**
@@ -372,7 +374,7 @@ export class StateManager {
             await this.saveState(state);
         });
         if (this.verbose) {
-            console.log(`📊 Worktree updated for issue #${issueNumber}: ${worktree}`);
+            console.log(`State: Worktree updated for issue #${issueNumber}: ${worktree}`);
         }
     }
     /**
@@ -407,7 +409,7 @@ export class StateManager {
             await this.saveState(state);
         });
         if (this.verbose) {
-            console.log(`📊 Loop iteration ${iteration} for issue #${issueNumber}`);
+            console.log(`State: Loop iteration ${iteration} for issue #${issueNumber}`);
         }
     }
     /**
@@ -423,7 +425,7 @@ export class StateManager {
             await this.saveState(state);
         });
         if (this.verbose) {
-            console.log(`📊 Removed issue #${issueNumber} from state`);
+            console.log(`State: Removed issue #${issueNumber} from state`);
         }
     }
     // === Acceptance Criteria Operations ===
@@ -444,7 +446,7 @@ export class StateManager {
             await this.saveState(state);
         });
         if (this.verbose) {
-            console.log(`📊 AC updated for issue #${issueNumber}: ${acceptanceCriteria.items.length} items`);
+            console.log(`State: AC updated for issue #${issueNumber}: ${acceptanceCriteria.items.length} items`);
         }
     }
     /**
@@ -487,7 +489,7 @@ export class StateManager {
             await this.saveState(state);
         });
         if (this.verbose) {
-            console.log(`📊 AC ${acId} → ${status} for issue #${issueNumber}`);
+            console.log(`State: AC ${acId} → ${status} for issue #${issueNumber}`);
         }
     }
     // === Scope Assessment Operations ===
@@ -508,7 +510,7 @@ export class StateManager {
             await this.saveState(state);
         });
         if (this.verbose) {
-            console.log(`📊 Scope assessment updated for issue #${issueNumber}: ${scopeAssessment.verdict}`);
+            console.log(`State: Scope assessment updated for issue #${issueNumber}: ${scopeAssessment.verdict}`);
         }
     }
     /**

package/dist/src/lib/workflow/state-rebuild.js

@@ -55,7 +55,7 @@ export async function rebuildStateFromLogs(options = {}) {
                 const log = RunLogSchema.safeParse(logData);
                 if (!log.success) {
                     if (options.verbose) {
-                        console.log(`⚠️  Invalid log format: ${file}`);
+                        console.log(`!  Invalid log format: ${file}`);
                     }
                     continue;
                 }
@@ -109,7 +109,7 @@ export async function rebuildStateFromLogs(options = {}) {
             }
             catch (err) {
                 if (options.verbose) {
-                    console.log(`⚠️  Error reading ${file}: ${err}`);
+                    console.log(`!  Error reading ${file}: ${err}`);
                 }
             }
         }

package/dist/src/lib/workflow/types.d.ts

@@ -71,6 +71,11 @@ export interface ExecutionConfig {
      * Default: "claude-code"
      */
     agent?: string;
+    /**
+     * Isolate parallel agent groups in separate worktrees.
+     * Propagated as SEQUANT_ISOLATE_PARALLEL env var to exec skill.
+     */
+    isolateParallel?: boolean;
     /**
      * Aider-specific configuration. Passed to AiderDriver when agent is "aider".
      */
@@ -80,6 +85,22 @@ export interface ExecutionConfig {
      * Propagated as SEQUANT_ISSUE_TYPE env var to skills.
      */
     issueType?: string;
+    /**
+     * Additional context appended to the phase prompt.
+     * Used by the quality loop to pass QA findings directly to the /loop skill
+     * so it doesn't need to reconstruct context from GitHub comments.
+     */
+    promptContext?: string;
+    /**
+     * Last QA verdict from a preceding phase.
+     * Propagated as SEQUANT_LAST_VERDICT env var to skills.
+     */
+    lastVerdict?: string;
+    /**
+     * Failed AC descriptions from a preceding QA phase.
+     * Propagated as SEQUANT_FAILED_ACS env var to skills.
+     */
+    failedAcs?: string;
 }
 /**
  * Default execution configuration
@@ -212,6 +233,12 @@ export interface RunOptions {
      * Default: "claude-code"
      */
     agent?: string;
+    /**
+     * Isolate parallel agent groups in separate worktrees.
+     * When true, each agent in a parallel group gets its own sub-worktree.
+     * Resolution priority: CLI flag → settings.agents.isolateParallel → false
+     */
+    isolateParallel?: boolean;
 }
 /**
  * CLI arguments for run command