@intrect/openswarm 0.17.1 → 0.17.3

package/dist/agents/pairPipeline.d.ts

@@ -1,149 +1,19 @@
 import { EventEmitter } from 'node:events';
 import type { TaskItem } from '../orchestration/decisionEngine.js';
-import type { WorkerResult, ReviewResult, PairSession } from './agentPair.js';
-import type { TesterResult } from './tester.js';
-import type { DocumenterResult } from './documenter.js';
-import type { AuditorResult } from './auditor.js';
-import type { SkillDocumenterResult } from './skillDocumenter.js';
-import type { PipelineStage, RoleConfig, PipelineGuardsConfig, JobProfile } from '../core/types.js';
-import { type CostInfo } from '../support/costTracker.js';
-import { type GuardsRunResult } from './pipelineGuards.js';
-import { type ReflectionState } from './reflection.js';
-export interface PipelineConfig {
-    /** List of active stages (executed in order) */
-    stages: PipelineStage[];
-    /** Whether to continue on test failure */
-    continueOnTestFail?: boolean;
-    /** Skip Documenter if no changes */
-    skipDocumenterIfNoChange?: boolean;
-    /** Max total iterations (one cycle = Worker → Reviewer → Tester) */
-    maxIterations?: number;
-    /**
-     * Max objective self-repair attempts (lint/bs/test failures) before the loop
-     * gives up on bad edits. Independent of maxIterations so an operator can cap
-     * token burn on reflection without shrinking the reviewer-revise budget.
-     * Default: DEFAULT_MAX_REFLECTIONS (3).
-     */
-    maxReflections?: number;
-    /** Per-role configuration */
-    roles?: {
-        worker?: RoleConfig;
-        reviewer?: RoleConfig;
-        tester?: RoleConfig;
-        documenter?: RoleConfig;
-        auditor?: RoleConfig;
-        'skill-documenter'?: RoleConfig;
-    };
-    /** Pipeline guards configuration */
-    guards?: Partial<PipelineGuardsConfig>;
-    /** Optional job profiles for model selection */
-    jobProfiles?: JobProfile[];
-    /** Skip tester if no code files (.ts/.js/.py etc.) changed (default: true) */
-    skipTesterIfNoCodeChange?: boolean;
-    /** Skip auditor if fewer than N files changed (default: 3) */
-    skipAuditorUnderFileCount?: number;
-    /** Enable verbose logging (detailed stage info, agent decisions, timing) */
-    verbose?: boolean;
-    /** Draft Analyzer 사전 분석 결과 (Haiku) — Worker/Planner에 주입 */
-    draftAnalysis?: {
-        taskType: string;
-        intentSummary: string;
-        relevantFiles: string[];
-        suggestedApproach: string;
-        projectStats?: string;
-        completionCriteria?: string[];
-        sufficient?: boolean;
-        impactAnalysis?: import('../knowledge/types.js').ImpactAnalysis;
-        registrySnapshot?: Array<{
-            filePath: string;
-            summary: string;
-            highlights: string[];
-        }>;
-    };
-}
-export interface StageResult {
-    stage: PipelineStage;
-    success: boolean;
-    result: WorkerResult | ReviewResult | TesterResult | DocumenterResult | AuditorResult | SkillDocumenterResult | {
-        success: false;
-        error: string;
-    };
-    duration: number;
-    /** Stage start time (epoch ms) */
-    startedAt: number;
-    /** Stage completion time (epoch ms) */
-    completedAt: number;
-}
-export interface PipelineResult {
-    success: boolean;
-    sessionId: string;
-    stages: StageResult[];
-    finalStatus: 'approved' | 'rejected' | 'failed' | 'cancelled' | 'decomposed' | 'rate_limited' | 'infra_error';
-    /** Unix timestamp (ms) when the rate-limit quota resets — set when finalStatus is 'rate_limited'. */
-    rateLimitResetsAt?: number;
-    totalDuration: number;
-    /** Total number of completed iterations */
-    iterations: number;
-    workerResult?: WorkerResult;
-    reviewResult?: ReviewResult;
-    testerResult?: TesterResult;
-    documenterResult?: DocumenterResult;
-    auditorResult?: AuditorResult;
-    skillDocumenterResult?: SkillDocumenterResult;
-    /** Task context (for reporting) */
-    taskContext?: {
-        issueIdentifier?: string;
-        projectName?: string;
-        projectPath?: string;
-        taskTitle?: string;
-    };
-    /** PR URL (auto-created PR in worktree mode) */
-    prUrl?: string;
-    /** Total cost across all stages */
-    totalCost?: CostInfo;
-}
-export interface PipelineContext {
-    task: TaskItem;
-    projectPath: string;
-    session: PairSession;
-    config: PipelineConfig;
-    /** Current iteration number (1-based) */
-    currentIteration: number;
-    /** Formatted task prefix for consistent logging (e.g., "OpenSwarm | INT-1171 | worktree/abc123") */
-    taskPrefix: string;
-    workerResult?: WorkerResult;
-    reviewResult?: ReviewResult;
-    testerResult?: TesterResult;
-    documenterResult?: DocumenterResult;
-    auditorResult?: AuditorResult;
-    skillDocumenterResult?: SkillDocumenterResult;
-    guardsResult?: GuardsRunResult;
-    /** Accumulated objective (lint/bs/test) errors for self-repair reflection */
-    reflection: ReflectionState;
-    /**
-     * Source of the latest revise feedback. 'objective' failures (lint/bs/test)
-     * flow through the reflection trail and are preserved across fresh-context
-     * resets; 'review' feedback (reviewer/halt) is subjective and dropped on a
-     * fresh-context retry.
-     */
-    feedbackSource?: 'objective' | 'review';
-}
-/**
- * Build a consistent task prefix for logging across all pipeline stages.
- * Format: "ProjectName | INT-XXX | worktree/abc123" or "ProjectName | INT-XXX"
- */
-export declare function buildTaskPrefix(task: TaskItem, projectPath: string): string;
-export type PipelineEventType = 'stage:start' | 'stage:complete' | 'stage:fail' | 'iteration:start' | 'iteration:complete' | 'iteration:fail' | 'pipeline:complete' | 'pipeline:fail' | 'halt';
-/** Thrown when the pipeline is cancelled mid-run (project disable / manual stop). */
-export declare class PipelineCancelledError extends Error {
-    constructor();
-}
+import type { PipelineGuardsConfig, JobProfile } from '../core/types.js';
+import type { PipelineConfig, PipelineResult, PipelineRunMetadata } from './pairPipelineTypes.js';
+import { PipelineCancelledError } from './stageErrorClassification.js';
+export { PipelineCancelledError };
+export type { PipelineConfig, PipelineContext, PipelineEventType, PipelineResult, PipelineRunMetadata, StageResult, } from './pairPipelineTypes.js';
+export { buildTaskPrefix } from './pipelineTaskPrefix.js';
 export declare class PairPipeline extends EventEmitter {
     private config;
     private stuckDetector;
     private jobProfiles;
     /** Set per run() — aborts the pipeline + in-flight adapter call on cancel/disable. */
     private abortSignal?;
+    /** Cache of adapter default models (heavy: OAuth + live catalog) keyed by adapter name. (INT-2393) */
+    private defaultModelCache;
     /** Throw if this run has been cancelled. Called at iteration/stage boundaries. */
     private throwIfAborted;
     constructor(config: PipelineConfig);
@@ -174,6 +44,7 @@ export declare class PairPipeline extends EventEmitter {
      * Run a single stage
      */
     private runStage;
+    private stageMetadata;
     /**
      * Determine stage success
      */
@@ -210,6 +81,6 @@ export declare function createFullPipeline(config?: Partial<PipelineConfig>): Pa
 /**
  * Create pipeline from configuration
  */
-export declare function createPipelineFromConfig(roles: PipelineConfig['roles'], maxIterations?: number, guards?: Partial<PipelineGuardsConfig>, jobProfiles?: JobProfile[], draftAnalysis?: PipelineConfig['draftAnalysis'], maxReflections?: number): PairPipeline;
+export declare function createPipelineFromConfig(roles: PipelineConfig['roles'], maxIterations?: number, guards?: Partial<PipelineGuardsConfig>, jobProfiles?: JobProfile[], draftAnalysis?: PipelineConfig['draftAnalysis'], maxReflections?: number, runMetadata?: PipelineRunMetadata): PairPipeline;
 export { formatPipelineResult, formatPipelineResultEmbed } from './pipelineFormat.js';
 //# sourceMappingURL=pairPipeline.d.ts.map

package/dist/agents/pairPipeline.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pairPipeline.d.ts","sourceRoot":"","sources":["../../src/agents/pairPipeline.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"pairPipeline.d.ts","sourceRoot":"","sources":["../../src/agents/pairPipeline.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oCAAoC,CAAC;AAMnE,OAAO,KAAK,EAAiB,oBAAoB,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAuBxF,OAAO,KAAK,EACV,cAAc,EAEd,cAAc,EACd,mBAAmB,EAEpB,MAAM,wBAAwB,CAAC;AAUhC,OAAO,EAA2E,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AAOhJ,OAAO,EAAE,sBAAsB,EAAE,CAAC;AAClC,YAAY,EACV,cAAc,EACd,eAAe,EACf,iBAAiB,EACjB,cAAc,EACd,mBAAmB,EACnB,WAAW,GACZ,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAI1D,qBAAa,YAAa,SAAQ,YAAY;IAC5C,OAAO,CAAC,MAAM,CAAiB;IAC/B,OAAO,CAAC,aAAa,CAAgB;IACrC,OAAO,CAAC,WAAW,CAAe;IAClC,sFAAsF;IACtF,OAAO,CAAC,WAAW,CAAC,CAAc;IAClC,sGAAsG;IACtG,OAAO,CAAC,iBAAiB,CAAkD;IAE3E,kFAAkF;IAClF,OAAO,CAAC,cAAc;gBAIV,MAAM,EAAE,cAAc;IAiBlC,OAAO,CAAC,cAAc;IAQtB,OAAO,CAAC,iBAAiB;IAKzB,OAAO,CAAC,eAAe;IAMvB,gFAAgF;IAChF,OAAO,CAAC,gBAAgB;IAQxB;;;;;OAKG;IACG,GAAG,CAAC,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GAAG,OAAO,CAAC,cAAc,CAAC;IA8IxG;;;OAGG;YACW,oBAAoB;IAuGlC;;OAEG;IACH,OAAO,CAAC,QAAQ;IAIhB;;OAEG;YACW,QAAQ;IAuUtB,OAAO,CAAC,aAAa;IAarB;;OAEG;IACH,OAAO,CAAC,cAAc;IA4BtB;;;;;;OAMG;IACH,OAAO,CAAC,qBAAqB;IA4B7B;;;;;;OAMG;YACW,oBAAoB;IA8XlC;;OAEG;IACH,OAAO,CAAC,WAAW;CAyDpB;AAID;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,aAAa,SAAI,GAAG,YAAY,CAKrE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,GAC/B,YAAY,CAQd;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,cAAc,CAAC,OAAO,CAAC,EAC9B,aAAa,SAAI,EACjB,MAAM,CAAC,EAAE,OAAO,CAAC,oBAAoB,CAAC,EACtC,WAAW,CAAC,EAAE,UAAU,EAAE,EAC1B,aAAa,CAAC,EAAE,cAAc,CAAC,eAAe,CAAC,EAC/C,cAAc,CAAC,EAAE,MAAM,EACvB,WAAW,CAAC,EAAE,mBAAmB,GAChC,YAAY,CAgCd;AAgHD,OAAO,EAAE,oBAAoB,EAAE,yBAAyB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/agents/pairPipeline.js

@@ -13,6 +13,8 @@ import { hasRepoSnapshot, scanAndCache, analyzeIssue } from '../knowledge/index.
 import { getRegistryStore } from '../registry/sqliteStore.js';
 import { recallRepoKnowledge } from '../memory/repoKnowledge.js';
 import * as workerAgent from './worker.js';
+import { buildTaskPrefix } from './pipelineTaskPrefix.js';
+import { emitWorkerFanoutGateDecision, evaluateWorkerFanoutGate, runWorkerWithOptionalFanout } from './workerFanoutGate.js';
 import * as reviewerAgent from './reviewer.js';
 import * as testerAgent from './tester.js';
 import * as documenterAgent from './documenter.js';
@@ -21,41 +23,20 @@ import * as skillDocumenterAgent from './skillDocumenter.js';
 import { createStuckDetector } from '../support/stuckDetector.js';
 import { RateLimitError } from '../adapters/rateLimitError.js';
 import { isInfraError } from '../adapters/errorClassification.js';
-/**
- * Build a consistent task prefix for logging across all pipeline stages.
- * Format: "ProjectName | INT-XXX | worktree/abc123" or "ProjectName | INT-XXX"
- */
-export function buildTaskPrefix(task, projectPath) {
-    const parts = [];
-    const projectName = task.linearProject?.name || projectPath.split('/').pop() || 'unknown';
-    parts.push(projectName);
-    if (task.issueIdentifier) {
-        parts.push(task.issueIdentifier);
-    }
-    else if (task.issueId) {
-        parts.push(task.issueId.slice(0, 8));
-    }
-    // Detect worktree path
-    const worktreeMatch = projectPath.match(/worktree\/([a-f0-9-]+)/);
-    if (worktreeMatch) {
-        parts.push(`worktree/${worktreeMatch[1].slice(0, 8)}`);
-    }
-    return parts.join(' | ');
-}
+import { resolveAdapterDefaultModel } from './stageModelResolver.js';
+import { isClassifiedStageError, rethrowClassified, extractClassifiedStageResult, PipelineCancelledError } from './stageErrorClassification.js';
+import { isTesterCodeFile, missingWorkerValidationIssues, testerWouldRunForWorkerResult, } from './workerValidationEvidence.js';
+export { PipelineCancelledError };
+export { buildTaskPrefix } from './pipelineTaskPrefix.js';
 // Pair Pipeline
-/** Thrown when the pipeline is cancelled mid-run (project disable / manual stop). */
-export class PipelineCancelledError extends Error {
-    constructor() {
-        super('Pipeline cancelled');
-        this.name = 'PipelineCancelledError';
-    }
-}
 export class PairPipeline extends EventEmitter {
     config;
     stuckDetector;
     jobProfiles;
     /** Set per run() — aborts the pipeline + in-flight adapter call on cancel/disable. */
     abortSignal;
+    /** Cache of adapter default models (heavy: OAuth + live catalog) keyed by adapter name. (INT-2393) */
+    defaultModelCache = new Map();
     /** Throw if this run has been cancelled. Called at iteration/stage boundaries. */
     throwIfAborted() {
         if (this.abortSignal?.aborted)
@@ -201,6 +182,9 @@ export class PairPipeline extends EventEmitter {
             // spawn, timeout) is not a task failure — surface it distinctly so the
             // runner does a backoff retry instead of counting it toward STUCK. (INT-2010)
             const infra = !cancelled && !rateLimited && isInfraError(error);
+            const classifiedStage = extractClassifiedStageResult(error); // INT-2424
+            if (classifiedStage)
+                stages.push(classifiedStage);
             if (cancelled) {
                 console.log(`[${context.taskPrefix}] Pipeline cancelled`);
             }
@@ -346,11 +330,16 @@ export class PairPipeline extends EventEmitter {
      */
     async runStage(stage, context, overrides) {
         const startTime = Date.now();
-        const stageModel = overrides?.model ?? this.getModelForRole(stage, context.task);
+        // Display model: explicit override → configured (jobProfile/role) → adapter
+        // default (so the TUI/dashboard aren't blank when config omits it). (INT-2393)
+        const stageModel = overrides?.model
+            ?? this.getModelForRole(stage, context.task)
+            ?? await resolveAdapterDefaultModel(this.config.roles?.[stage]?.adapter, this.defaultModelCache);
         const prefix = context.taskPrefix;
+        const metadata = this.stageMetadata(context);
         console.log(`[${prefix}] Stage starting: ${stage}`);
         this.emit('stage:start', { stage, context, model: stageModel });
-        broadcastEvent({ type: 'pipeline:stage', data: { taskId: context.task.id, stage, status: 'start', model: stageModel } });
+        broadcastEvent({ type: 'pipeline:stage', data: { taskId: context.task.id, stage, status: 'start', model: stageModel, ...metadata } });
         if (this.config.verbose) {
             this.emit('log', { line: `[verbose] Stage: ${stage} | model: ${stageModel ?? 'default'} | iteration: ${context.currentIteration}` });
         }
@@ -390,7 +379,7 @@ export class PairPipeline extends EventEmitter {
                         ? reviewerAgent.buildRevisionPrompt(context.reviewResult)
                         : undefined;
                     const combinedFeedback = [reflectionPart, reviewPart].filter(Boolean).join('\n\n') || undefined;
-                    result = await workerAgent.runWorker({
+                    const workerOptions = {
                         taskTitle: context.task.title,
                         taskDescription: context.task.description || '',
                         projectPath: context.projectPath,
@@ -404,6 +393,7 @@ export class PairPipeline extends EventEmitter {
                         maxTurns: this.config.roles?.worker?.maxTurns,
                         adapterName: this.config.roles?.worker?.adapter,
                         reasoningEffort: this.getEffortForTask(context.task),
+                        bashTimeoutMs: await workerAgent.resolveWorkerBashTimeout(context.projectPath, this.getEffortForTask(context.task)), // INT-2415
                         // No-edit guard (re-applied from stranded feat/v0.7.0 commit 2eea3bc):
                         // reasoning workers frequently end with analysis only and never call
                         // edit_file. Without this the guard defaults to 0 (disabled) — measured:
@@ -416,6 +406,15 @@ export class PairPipeline extends EventEmitter {
                         processContext: { taskId: context.task.id, stage: 'worker' },
                         workerContext,
                         signal: this.abortSignal,
+                    };
+                    result = await runWorkerWithOptionalFanout({
+                        projectPath: context.projectPath,
+                        workerOptions,
+                        fanoutDecision: context.workerFanoutDecision,
+                        fanoutConfig: this.config.roles?.worker?.fanout,
+                        guards: this.config.guards,
+                        onLog,
+                        runWorker: workerAgent.runWorker,
                     });
                     agentPair.saveWorkerResult(context.session.id, result);
                     context.workerResult = result;
@@ -471,6 +470,11 @@ export class PairPipeline extends EventEmitter {
                         adapterName: this.config.roles?.reviewer?.adapter,
                         reasoningEffort: this.getEffortForTask(context.task),
                         completionCriteria: this.config.draftAnalysis?.completionCriteria,
+                        // Surface non-blocking guard warnings (dead-module, reformat/scope)
+                        // so the reviewer verifies them instead of them dying in a log. (INT-2388)
+                        guardWarnings: context.guardsResult?.results
+                            .filter(r => !r.passed && !r.blocking)
+                            .flatMap(r => r.issues),
                         processContext: { taskId: context.task.id, stage: 'reviewer' },
                         signal: this.abortSignal,
                     };
@@ -579,7 +583,8 @@ export class PairPipeline extends EventEmitter {
             }
             broadcastEvent({ type: 'pipeline:stage', data: {
                     taskId: context.task.id, stage, status: 'complete',
-                    model: costInfo?.model,
+                    ...metadata,
+                    model: costInfo?.model ?? stageModel,
                     inputTokens: costInfo?.inputTokens,
                     outputTokens: costInfo?.outputTokens,
                     costUsd: costInfo?.costUsd,
@@ -605,12 +610,29 @@ export class PairPipeline extends EventEmitter {
             this.emit('stage:fail', { stage, result: stageResult, context, error });
             broadcastEvent({ type: 'pipeline:stage', data: {
                     taskId: context.task.id, stage, status: 'fail',
+                    ...metadata,
+                    model: stageModel,
                     durationMs: stageResult.duration,
+                    rateLimitResetsAt: error instanceof RateLimitError && error.resetsAt ? error.resetsAt * 1000 : undefined,
                     error: error instanceof Error ? error.message : String(error),
                 } });
+            if (isClassifiedStageError(error))
+                rethrowClassified(error, stageResult); // INT-2424
             return stageResult;
         }
     }
+    stageMetadata(context) {
+        const configured = this.config.runMetadata ?? {};
+        const projectPath = configured.projectPath ?? context.projectPath;
+        return {
+            repository: configured.repository ?? context.task.linearProject?.name ?? repoNameFromPath(projectPath),
+            projectPath,
+            worktree: configured.worktree ?? worktreeNameFromPath(projectPath),
+            branch: configured.branch,
+            issueIdentifier: configured.issueIdentifier ?? context.task.issueIdentifier ?? context.task.issueId,
+            title: configured.title ?? context.task.title,
+        };
+    }
     /**
      * Determine stage success
      */
@@ -719,6 +741,21 @@ export class PairPipeline extends EventEmitter {
                         toModel: escalateModel,
                     } });
             }
+            const fanoutDecision = evaluateWorkerFanoutGate({
+                task: context.task,
+                draftAnalysis: this.config.draftAnalysis,
+                iteration: context.currentIteration,
+                feedbackSource: context.feedbackSource,
+                effort: this.getEffortForTask(context.task),
+                config: this.config.roles?.worker?.fanout,
+            });
+            context.workerFanoutDecision = fanoutDecision;
+            emitWorkerFanoutGateDecision({
+                context,
+                decision: fanoutDecision,
+                verbose: this.config.verbose,
+                emit: (event, payload) => this.emit(event, payload),
+            });
             agentPair.updateSessionStatus(context.session.id, 'working');
             const workerResult = await this.runStage('worker', context, workerOverrides);
             stages.push(workerResult);
@@ -786,6 +823,52 @@ export class PairPipeline extends EventEmitter {
                     });
                 }
             }
+            // A code-changing worker that reports no commands is usually a low-accuracy
+            // partial implementation: the reviewer then spends a full pass rediscovering
+            // that nothing was built, tested, or smoke-checked. When there is no tester
+            // stage to provide objective evidence, bounce it back immediately with a
+            // ground-truth validation reflection.
+            if (hasReviewer && context.workerResult && !testerWouldRunForWorkerResult(context.workerResult, hasTester, this.config.skipTesterIfNoCodeChange ?? true)) {
+                const validationIssues = missingWorkerValidationIssues(context.workerResult);
+                if (validationIssues.length > 0) {
+                    const { progressed } = recordReflection(context.reflection, {
+                        iteration: context.currentIteration,
+                        source: 'validation',
+                        errors: validationIssues,
+                    });
+                    // Missing validation evidence is a nudge, not a verdict: the worker may
+                    // simply be unable to self-report its commands (e.g. git-detected
+                    // changes with no JSON block — worker.ts promotes those to success with
+                    // commands=[]). Bounce it back to re-run with validation while that can
+                    // still make progress; once it stagnates or the reflection budget is
+                    // spent, DEFER to the reviewer (pre-gate behavior) rather than
+                    // hard-failing the whole task. This is a pure predicate — do NOT reuse
+                    // shouldAbortSelfRepair here: it marks the session 'failed' as a side
+                    // effect (see ~L795), which would sink an otherwise-approvable task.
+                    const reflectionBudget = this.config.maxReflections ?? DEFAULT_MAX_REFLECTIONS;
+                    const canRetryForValidation = progressed && !shouldStopReflecting(context.reflection, reflectionBudget);
+                    if (canRetryForValidation) {
+                        console.log(`[${context.taskPrefix}] Missing worker validation evidence: ${validationIssues.join('; ')}`);
+                        context.reviewResult = {
+                            decision: 'revise',
+                            feedback: `Worker validation evidence missing: ${validationIssues.join('; ')}`,
+                            issues: validationIssues,
+                            suggestions: ['Run a relevant validation command before asking for review'],
+                        };
+                        context.feedbackSource = 'objective';
+                        agentPair.trackFailure(context.session.id);
+                        this.emit('iteration:fail', {
+                            iteration: context.currentIteration,
+                            stage: 'worker',
+                            context,
+                        });
+                        agentPair.updateSessionStatus(context.session.id, 'revising');
+                        continue;
+                    }
+                    console.log(`[${context.taskPrefix}] Validation evidence still missing after retries — deferring to reviewer`);
+                    this.emit('log', { line: '⚠️ Validation evidence missing; deferring to reviewer' });
+                }
+            }
             // ========== HALT CHECK (confidence too low) ==========
             if (context.workerResult) {
                 const confidence = agentPair.calculateConfidence(context.workerResult);
@@ -826,9 +909,8 @@ export class PairPipeline extends EventEmitter {
             if (hasTester) {
                 // Skip tester if no code files changed (configurable, default true)
                 const skipIfNoCode = this.config.skipTesterIfNoCodeChange ?? true;
-                const codeExtensions = /\.(ts|tsx|js|jsx|py|rs|go|java|rb|c|cpp|h|hpp)$/;
                 const changedFiles = context.workerResult?.filesChanged || [];
-                const hasCodeChange = changedFiles.some(f => codeExtensions.test(f));
+                const hasCodeChange = changedFiles.some(isTesterCodeFile);
                 if (skipIfNoCode && !hasCodeChange) {
                     console.log(`[${context.taskPrefix}] Skipping tester: no code files changed (${changedFiles.length} files: ${changedFiles.join(', ') || 'none'})`);
                 }
@@ -1022,7 +1104,7 @@ export function createFullPipeline(config) {
 /**
  * Create pipeline from configuration
  */
-export function createPipelineFromConfig(roles, maxIterations = 3, guards, jobProfiles, draftAnalysis, maxReflections) {
+export function createPipelineFromConfig(roles, maxIterations = 3, guards, jobProfiles, draftAnalysis, maxReflections, runMetadata) {
     const stages = [];
     if (roles?.worker?.enabled !== false) {
         stages.push('worker');
@@ -1050,8 +1132,18 @@ export function createPipelineFromConfig(roles, maxIterations = 3, guards, jobPr
         guards,
         jobProfiles,
         draftAnalysis,
+        runMetadata,
     });
 }
+function repoNameFromPath(projectPath) {
+    if (!projectPath)
+        return undefined;
+    const normalized = projectPath.replace(/\/+$/, '').replace(/\/worktree\/[^/]+$/, '');
+    return normalized.split('/').pop();
+}
+function worktreeNameFromPath(projectPath) {
+    return projectPath?.match(/\/worktree\/([^/]+)\/?$/)?.[1];
+}
 // Helpers
 /**
  * Extract a worker-readable summary of what the agent did during a stage so