fix: show task title instead of agent name in loop header (#230)

- Always display "Task N/M" instead of inconsistent "Loop N/M"
- Show task title (from issue/spec) as header, agent name as subtitle
- Add taskTitle option to LoopOptions, passed from run command
- Fall back to agent name only when no title is available

Closes #230

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: rubenmarcus

src/commands/run.ts

@@ -277,6 +277,7 @@ export async function runCommand(
 
   // Handle --from source
   let sourceSpec: string | null = null;
+  let sourceTitle: string | undefined;
   let sourceIssueRef: IssueRef | undefined;
   if (options.from) {
     spinner.start('Fetching spec from source...');
@@ -298,6 +299,7 @@ export async function runCommand(
 
       spinner.succeed(`Fetched spec from ${result.source}`);
       sourceSpec = result.content;
+      sourceTitle = result.title;
 
       // Extract issue reference from metadata for PR linking
       if (
@@ -641,6 +643,7 @@ Focus on one task at a time. After completing a task, update IMPLEMENTATION_PLAN
     validate: options.validate ?? preset?.validate,
     validationWarmup,
     sourceType: options.from?.toLowerCase(),
+    taskTitle: sourceTitle || (task ? task.slice(0, 80) : undefined),
     // New options
     completionPromise: options.completionPromise ?? preset?.completionPromise,
     requireExitSignal: options.requireExitSignal,

src/loop/executor.ts

@@ -241,6 +241,7 @@ export interface LoopOptions {
   maxSkills?: number; // Cap skills included in prompt (default: 5)
   skipPlanInstructions?: boolean; // Skip IMPLEMENTATION_PLAN.md rules in preamble (fix --design)
   fixMode?: 'design' | 'scan' | 'custom'; // Display mode for fix command headers
+  taskTitle?: string; // Human-readable task title (from issue/spec) for display
 }
 
 export interface LoopResult {
@@ -739,13 +740,26 @@ export async function runLoop(options: LoopOptions): Promise<LoopResult> {
       );
     } else {
       const modeLabel =
-        options.fixMode === 'design'
-          ? 'Design Fix'
-          : options.fixMode
-            ? 'Fix'
-            : `Running ${options.agent.name}`;
-      const fallbackLine = `  ${sourceIcon} Loop ${i}/${maxIterations} │ ${modeLabel}`;
-      headerLines.push(chalk.white.bold(truncateToFit(fallbackLine, innerWidth)));
+        options.fixMode === 'design' ? 'Design Fix' : options.fixMode ? 'Fix' : undefined;
+      const displayTitle = modeLabel || options.taskTitle || undefined;
+      if (displayTitle) {
+        const prefix = `  ${sourceIcon} Task ${i}/${maxIterations} │ `;
+        const available = innerWidth - prefix.length;
+        if (available > 0) {
+          const title = truncateToFit(displayTitle, Math.max(8, available));
+          headerLines.push(`${prefix}${chalk.white.bold(title)}`);
+        } else {
+          headerLines.push(chalk.white.bold(truncateToFit(`${prefix}${displayTitle}`, innerWidth)));
+        }
+        headerLines.push(
+          chalk.dim(
+            truncateToFit(`  ${options.agent.name} │ Iter ${i}/${maxIterations}`, innerWidth)
+          )
+        );
+      } else {
+        const fallbackLine = `  ${sourceIcon} Task ${i}/${maxIterations} │ ${options.agent.name}`;
+        headerLines.push(chalk.white.bold(truncateToFit(fallbackLine, innerWidth)));
+      }
     }
     console.log();
     console.log(drawBox(headerLines, { color: chalk.cyan, width: boxWidth }));