sequant 2.0.1 → 2.1.1

package/dist/src/lib/settings.d.ts

@@ -44,6 +44,14 @@ export interface AgentSettings {
      * Default: "haiku"
      */
     model: "haiku" | "sonnet" | "opus";
+    /**
+     * Isolate parallel agent groups in separate worktrees.
+     * When true, each agent in a parallel group gets its own sub-worktree,
+     * eliminating file conflicts structurally. Changes are merged back
+     * into the issue worktree after all agents complete.
+     * Default: false (opt-in for v1)
+     */
+    isolateParallel: boolean;
 }
 /**
  * Aider-specific settings for the aider agent driver.

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.js

@@ -299,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}`));
             }
         }
     }

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.js

@@ -329,6 +329,10 @@ async function executePhase(issueNumber, phase, config, sessionId, worktreePath,
     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
@@ -508,7 +512,7 @@ delayFn = (ms) => new Promise((resolve) => setTimeout(resolve, ms))) {
     // 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...`));
+        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".
      */
@@ -228,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