@intrect/openswarm 0.17.2 → 0.17.4

package/dist/agents/workerFanout.js

@@ -0,0 +1,292 @@
+// ============================================
+// OpenSwarm - Adaptive worker fan-out
+// ============================================
+//
+// Runs candidate workers in isolated temporary git clones and promotes only the
+// selected winner's diff back into the real project path.
+import { execFile } from 'node:child_process';
+import { existsSync } from 'node:fs';
+import { cp, mkdir, mkdtemp, rm, symlink, writeFile } from 'node:fs/promises';
+import { tmpdir } from 'node:os';
+import { dirname, join, resolve } from 'node:path';
+import { promisify } from 'node:util';
+import { runPool } from '../support/concurrencyPool.js';
+import { loadRepoMetadata } from '../support/repoMetadata.js';
+import { resolveSharedPaths } from '../support/worktreeManager.js';
+import { runWorker } from './worker.js';
+import { runGuards } from './pipelineGuards.js';
+const exec = promisify(execFile);
+function safeCandidateId(id, index) {
+    const safe = id.toLowerCase().replace(/[^a-z0-9._-]+/g, '-').replace(/^-|-$/g, '').slice(0, 48);
+    return safe || `candidate-${index + 1}`;
+}
+async function git(cwd, args, opts) {
+    const { stdout } = await exec('git', args, {
+        cwd,
+        encoding: 'utf8',
+        env: opts?.env,
+        maxBuffer: 20 * 1024 * 1024,
+    });
+    return String(stdout);
+}
+// Capture ALL uncommitted work in the project (tracked edits, deletions, and
+// untracked new files) as a binary patch vs HEAD, WITHOUT mutating the project's
+// real index or worktree — everything is staged into a throwaway temporary index
+// selected via GIT_INDEX_FILE. Returns '' when the worktree is clean. This lets
+// fan-out run on a dirty tree (e.g. a self-repair retry that still holds the
+// previous iteration's edits) by seeding that state into each sandbox.
+async function captureBaselinePatch(projectPath) {
+    const idxDir = await mkdtemp(join(tmpdir(), 'openswarm-fanout-idx-'));
+    const env = { ...process.env, GIT_INDEX_FILE: join(idxDir, 'index') };
+    try {
+        await git(projectPath, ['add', '-A'], { env });
+        return await git(projectPath, ['diff', '--cached', '--binary', 'HEAD'], { env });
+    }
+    finally {
+        await rm(idxDir, { recursive: true, force: true });
+    }
+}
+async function cloneSandbox(projectPath, root, id, sharedPathMode) {
+    const sandbox = join(root, id);
+    await git(projectPath, ['clone', '--quiet', '--no-hardlinks', '--', projectPath, sandbox]);
+    if (sharedPathMode === 'link')
+        await linkSharedPaths(projectPath, sandbox);
+    if (sharedPathMode === 'copy')
+        await copySharedPaths(projectPath, sandbox);
+    return sandbox;
+}
+async function linkSharedPaths(projectPath, sandboxPath) {
+    let metadata = null;
+    try {
+        metadata = await loadRepoMetadata(projectPath);
+    }
+    catch {
+        metadata = null;
+    }
+    for (const rel of resolveSharedPaths(projectPath, metadata)) {
+        const target = resolve(projectPath, rel);
+        const linkPath = resolve(sandboxPath, rel);
+        if (existsSync(linkPath))
+            continue;
+        await mkdir(dirname(linkPath), { recursive: true });
+        await symlink(target, linkPath);
+    }
+}
+async function copySharedPaths(projectPath, sandboxPath) {
+    let metadata = null;
+    try {
+        metadata = await loadRepoMetadata(projectPath);
+    }
+    catch {
+        metadata = null;
+    }
+    for (const rel of resolveSharedPaths(projectPath, metadata)) {
+        const source = resolve(projectPath, rel);
+        const target = resolve(sandboxPath, rel);
+        if (existsSync(target))
+            continue;
+        await mkdir(dirname(target), { recursive: true });
+        await cp(source, target, {
+            recursive: true,
+            force: false,
+            errorOnExist: false,
+            verbatimSymlinks: true,
+        });
+    }
+}
+function sharedPathModeFor(linkSharedPaths) {
+    if (linkSharedPaths === true)
+        return 'link';
+    if (linkSharedPaths === false)
+        return 'off';
+    return 'copy';
+}
+async function changedFiles(projectPath) {
+    const out = await git(projectPath, ['status', '--porcelain']).catch(() => '');
+    return out
+        .split('\n')
+        .map((line) => line.trimEnd())
+        .filter(Boolean)
+        .map((line) => {
+        const file = line.slice(3);
+        return file.includes(' -> ') ? file.split(' -> ').pop() ?? file : file;
+    })
+        .filter(Boolean);
+}
+async function diffBinary(projectPath) {
+    await git(projectPath, ['add', '-A']);
+    return git(projectPath, ['diff', '--cached', '--binary', 'HEAD']);
+}
+async function applyDiff(projectPath, patchRoot, diff) {
+    const patchPath = join(patchRoot, 'winner.patch');
+    await writeFile(patchPath, diff, 'utf8');
+    // Plain worktree apply — NOT --3way. --3way validates the preimage against
+    // the INDEX, but on a dirty project (self-repair retry) the index still holds
+    // HEAD while the patch preimage is the seeded dirty state → "does not match
+    // index" even though the WORKTREE matches the preimage exactly (the sandbox
+    // base was cloned+seeded from it). A 3-way fallback couldn't work anyway: the
+    // sandbox's baseline blobs don't exist in the project's object database.
+    await git(projectPath, ['apply', '--whitespace=nowarn', patchPath]);
+}
+function scoreCandidate(input) {
+    const blockingIssues = input.guards?.results.filter((r) => !r.passed && r.blocking).flatMap((r) => r.issues) ?? [];
+    const hasDiff = input.filesChanged.length > 0;
+    const guardsPass = blockingIssues.length === 0;
+    const eligible = input.result.success && hasDiff && guardsPass && !input.error;
+    let score = 0;
+    if (input.result.success)
+        score += 100;
+    if (hasDiff)
+        score += 25;
+    if (guardsPass)
+        score += 25;
+    if (typeof input.result.confidencePercent === 'number')
+        score += Math.max(0, Math.min(100, input.result.confidencePercent)) / 10;
+    score -= Math.min(input.filesChanged.length, 20);
+    score -= Math.min(Math.round(input.durationMs / 30_000), 20);
+    if (input.error)
+        score -= 100;
+    if (blockingIssues.length > 0)
+        score -= 50 + blockingIssues.length * 5;
+    return { score, eligible };
+}
+// Seed the project's pre-existing uncommitted state into a freshly-cloned
+// sandbox and commit it, so the candidate continues from the dirty base and the
+// winner's promoted diff is the incremental delta (not base+delta, which would
+// double-apply onto the already-dirty project).
+async function seedBaseline(sandbox, root, id, baseline) {
+    if (!baseline.trim())
+        return;
+    const patchPath = join(root, `${id}-base.patch`);
+    await writeFile(patchPath, baseline, 'utf8');
+    await git(sandbox, ['apply', '--whitespace=nowarn', patchPath]);
+    await rm(patchPath, { force: true });
+    await git(sandbox, ['add', '-A']);
+    await git(sandbox, [
+        '-c', 'user.email=fanout@openswarm.local',
+        '-c', 'user.name=OpenSwarm Fanout',
+        'commit', '--quiet', '--no-verify', '-m', 'fanout: seed pre-existing worktree state',
+    ]);
+}
+async function runCandidate(options, candidate, index, root, baseline) {
+    const id = safeCandidateId(candidate.id, index);
+    const started = Date.now();
+    let sandbox = '';
+    try {
+        sandbox = await cloneSandbox(options.projectPath, root, id, sharedPathModeFor(options.linkSharedPaths));
+        await seedBaseline(sandbox, root, id, baseline);
+        const result = await runWorker({
+            ...options.baseWorkerOptions,
+            projectPath: sandbox,
+            model: candidate.model ?? options.baseWorkerOptions.model,
+            adapterName: candidate.adapter ?? options.baseWorkerOptions.adapterName,
+            reasoningEffort: candidate.reasoningEffort ?? options.baseWorkerOptions.reasoningEffort,
+            maxTurns: candidate.maxTurns ?? options.baseWorkerOptions.maxTurns,
+            nudgeMaxOnNoEdit: candidate.nudgeMaxOnNoEdit ?? options.baseWorkerOptions.nudgeMaxOnNoEdit,
+            webTools: candidate.webTools ?? options.baseWorkerOptions.webTools,
+            memoryTools: candidate.memoryTools ?? options.baseWorkerOptions.memoryTools,
+            processContext: options.baseWorkerOptions.processContext
+                ? { ...options.baseWorkerOptions.processContext, stage: `worker:${id}` }
+                : undefined,
+            onLog: (line) => options.onLog?.(`[${id}] ${line}`),
+        });
+        const files = await changedFiles(sandbox);
+        const guards = options.guards && files.length > 0
+            ? await runGuards({ ...result, filesChanged: files }, sandbox, options.guards)
+            : undefined;
+        const scored = scoreCandidate({ result, filesChanged: files, guards, durationMs: Date.now() - started });
+        return {
+            id,
+            projectPath: sandbox,
+            result,
+            filesChanged: files,
+            guards,
+            durationMs: Date.now() - started,
+            score: scored.score,
+            eligible: scored.eligible,
+        };
+    }
+    catch (err) {
+        const result = {
+            success: false,
+            summary: `Fan-out candidate ${id} failed`,
+            filesChanged: [],
+            commands: [],
+            output: '',
+            error: err instanceof Error ? err.message : String(err),
+        };
+        const scored = scoreCandidate({ result, filesChanged: [], durationMs: Date.now() - started, error: result.error });
+        return {
+            id,
+            projectPath: sandbox,
+            result,
+            filesChanged: [],
+            durationMs: Date.now() - started,
+            score: scored.score,
+            eligible: false,
+            error: result.error,
+        };
+    }
+}
+export async function runWorkerFanout(options) {
+    if (options.candidates.length < 2) {
+        return { candidates: [], fallbackReason: 'fan-out needs at least two candidates' };
+    }
+    // A dirty worktree is expected on self-repair retries (the gate scores fan-out
+    // mainly on retry signals). Rather than bail, snapshot the uncommitted state
+    // and seed it into each sandbox so candidates continue from it and only the
+    // incremental winner diff is promoted back. Falls back to '' (clean) on error.
+    const baseline = await captureBaselinePatch(options.projectPath).catch(() => '');
+    const root = await mkdtemp(join(tmpdir(), 'openswarm-worker-fanout-'));
+    try {
+        options.onLog?.(`[fanout] launching ${options.candidates.length} candidate worker(s)${baseline.trim() ? ' (seeded from dirty worktree)' : ''}`);
+        const settled = await runPool(options.candidates, options.concurrency, (candidate, index) => runCandidate(options, candidate, index, root, baseline), (item) => {
+            if (item.value) {
+                options.onLog?.(`[fanout] ${item.value.id}: score=${item.value.score.toFixed(1)} eligible=${item.value.eligible} files=${item.value.filesChanged.length}`);
+            }
+            else if (item.error) {
+                options.onLog?.(`[fanout] candidate ${item.index + 1} failed: ${item.error instanceof Error ? item.error.message : String(item.error)}`);
+            }
+        });
+        const candidates = settled
+            .map((item) => item.value)
+            .filter((item) => Boolean(item));
+        const winner = candidates
+            .filter((candidate) => candidate.eligible)
+            .sort((a, b) => b.score - a.score)[0];
+        if (!winner) {
+            return { candidates, fallbackReason: 'no eligible fan-out candidate produced a guarded diff' };
+        }
+        const diff = await diffBinary(winner.projectPath);
+        if (!diff.trim()) {
+            return { candidates, fallbackReason: 'selected fan-out candidate had no diff to promote' };
+        }
+        // A promotion failure (e.g. the project drifted while candidates ran) must
+        // not sink the whole worker stage — fall back to a single in-place worker,
+        // which is what would have run without fan-out.
+        try {
+            await applyDiff(options.projectPath, root, diff);
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            return { candidates, fallbackReason: `winner diff did not apply cleanly: ${msg}` };
+        }
+        const promotedFiles = await changedFiles(options.projectPath);
+        winner.result = {
+            ...winner.result,
+            summary: `[fanout:${winner.id}] ${winner.result.summary}`,
+            filesChanged: promotedFiles,
+        };
+        options.onLog?.(`[fanout] promoted ${winner.id}: ${promotedFiles.length} file(s)`);
+        return { winner, candidates };
+    }
+    finally {
+        if (!options.keepSandboxes) {
+            await rm(root, { recursive: true, force: true });
+        }
+        else {
+            options.onLog?.(`[fanout] kept sandboxes at ${root}`);
+        }
+    }
+}
+//# sourceMappingURL=workerFanout.js.map

package/dist/agents/workerFanout.js.map

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

package/dist/agents/workerFanoutGate.d.ts

@@ -0,0 +1,48 @@
+import type { TaskItem } from '../orchestration/decisionEngine.js';
+import type { PipelineGuardsConfig, RoleConfig } from '../core/types.js';
+import type { WorkerResult } from './agentPair.js';
+import type { WorkerOptions } from './worker.js';
+export interface WorkerFanoutGateSignal {
+    code: string;
+    weight: number;
+    reason: string;
+}
+export interface WorkerFanoutGateDecision {
+    enabled: boolean;
+    shouldFanOut: boolean;
+    score: number;
+    threshold: number;
+    signals: WorkerFanoutGateSignal[];
+}
+export interface FanoutDraftAnalysis {
+    relevantFiles: string[];
+    sufficient?: boolean;
+}
+export declare function evaluateWorkerFanoutGate(input: {
+    task: TaskItem;
+    draftAnalysis?: FanoutDraftAnalysis;
+    iteration: number;
+    feedbackSource?: 'objective' | 'review';
+    effort?: 'low' | 'medium' | 'high';
+    config?: RoleConfig['fanout'];
+}): WorkerFanoutGateDecision;
+export declare function emitWorkerFanoutGateDecision(input: {
+    context: {
+        task: TaskItem;
+        currentIteration: number;
+        taskPrefix: string;
+    };
+    decision: WorkerFanoutGateDecision;
+    verbose?: boolean;
+    emit: (event: 'fanout:gate' | 'log', payload: unknown) => void;
+}): void;
+export declare function runWorkerWithOptionalFanout(input: {
+    projectPath: string;
+    workerOptions: WorkerOptions;
+    fanoutDecision?: WorkerFanoutGateDecision;
+    fanoutConfig?: RoleConfig['fanout'];
+    guards?: Partial<PipelineGuardsConfig>;
+    onLog: (line: string) => void;
+    runWorker: (options: WorkerOptions) => Promise<WorkerResult>;
+}): Promise<WorkerResult>;
+//# sourceMappingURL=workerFanoutGate.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"workerFanoutGate.d.ts","sourceRoot":"","sources":["../../src/agents/workerFanoutGate.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oCAAoC,CAAC;AACnE,OAAO,KAAK,EAAE,oBAAoB,EAAE,UAAU,EAA+B,MAAM,kBAAkB,CAAC;AAEtG,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAGjD,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,wBAAwB;IACvC,OAAO,EAAE,OAAO,CAAC;IACjB,YAAY,EAAE,OAAO,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,sBAAsB,EAAE,CAAC;CACnC;AAED,MAAM,WAAW,mBAAmB;IAClC,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAUD,wBAAgB,wBAAwB,CAAC,KAAK,EAAE;IAC9C,IAAI,EAAE,QAAQ,CAAC;IACf,aAAa,CAAC,EAAE,mBAAmB,CAAC;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,WAAW,GAAG,QAAQ,CAAC;IACxC,MAAM,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;IACnC,MAAM,CAAC,EAAE,UAAU,CAAC,QAAQ,CAAC,CAAC;CAC/B,GAAG,wBAAwB,CAsD3B;AAsCD,wBAAgB,4BAA4B,CAAC,KAAK,EAAE;IAClD,OAAO,EAAE;QAAE,IAAI,EAAE,QAAQ,CAAC;QAAC,gBAAgB,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC;IAC1E,QAAQ,EAAE,wBAAwB,CAAC;IACnC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,IAAI,EAAE,CAAC,KAAK,EAAE,aAAa,GAAG,KAAK,EAAE,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;CAChE,GAAG,IAAI,CA0BP;AAED,wBAAsB,2BAA2B,CAAC,KAAK,EAAE;IACvD,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,aAAa,CAAC;IAC7B,cAAc,CAAC,EAAE,wBAAwB,CAAC;IAC1C,YAAY,CAAC,EAAE,UAAU,CAAC,QAAQ,CAAC,CAAC;IACpC,MAAM,CAAC,EAAE,OAAO,CAAC,oBAAoB,CAAC,CAAC;IACvC,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC9B,SAAS,EAAE,CAAC,OAAO,EAAE,aAAa,KAAK,OAAO,CAAC,YAAY,CAAC,CAAC;CAC9D,GAAG,OAAO,CAAC,YAAY,CAAC,CA4BxB"}

package/dist/agents/workerFanoutGate.js

@@ -0,0 +1,146 @@
+// ============================================
+// OpenSwarm - Adaptive worker fan-out gate
+// ============================================
+import { broadcastEvent } from '../core/eventHub.js';
+import { runWorkerFanout } from './workerFanout.js';
+const DEFAULT_FANOUT_GATE_MIN_SCORE = 2;
+const CORE_ORCHESTRATION_PATTERN = /\b(pairpipeline|pipeline|autonomousrunner|runnerexecution|worktree|scheduler|adapter|agenticloop|worker|reviewer|tester|auth|mcp|codexresponses|eventhub)\b/i;
+function textMatchesCoreOrchestration(text) {
+    return CORE_ORCHESTRATION_PATTERN.test(text.replace(/[^A-Za-z0-9_/.-]+/g, ' '));
+}
+export function evaluateWorkerFanoutGate(input) {
+    const enabled = input.config?.enabled ?? true;
+    const threshold = input.config?.minScore ?? DEFAULT_FANOUT_GATE_MIN_SCORE;
+    if (!enabled) {
+        return { enabled: false, shouldFanOut: false, score: 0, threshold, signals: [] };
+    }
+    const signals = [];
+    const add = (code, weight, reason) => {
+        signals.push({ code, weight, reason });
+    };
+    if (input.iteration > 1 && input.feedbackSource === 'objective') {
+        add('objective-retry', 2, 'objective guard/test feedback from a previous iteration');
+    }
+    if (input.iteration > 1 && input.feedbackSource === 'review') {
+        add('review-retry', 2, 'reviewer or confidence feedback requested a revision');
+    }
+    if (input.draftAnalysis?.sufficient === false) {
+        add('insufficient-draft', 1, 'draft analysis was insufficient');
+    }
+    const relevantFiles = input.draftAnalysis?.relevantFiles ?? input.task.fileScope ?? [];
+    if (relevantFiles.length >= 4) {
+        add('broad-file-scope', 1, `broad file scope (${relevantFiles.length} files)`);
+    }
+    const scopeText = [
+        input.task.title,
+        input.task.description ?? '',
+        relevantFiles.join(' '),
+    ].join(' ');
+    if (textMatchesCoreOrchestration(scopeText)) {
+        add('core-orchestration-scope', 1, 'core orchestration or agent pipeline surface');
+    }
+    if ((input.task.estimatedMinutes ?? 0) >= 30) {
+        add('large-estimate', 1, `estimated ${input.task.estimatedMinutes} minutes`);
+    }
+    if (input.task.priority === 1 && (input.task.estimatedMinutes ?? 0) >= 15) {
+        add('urgent-nontrivial', 1, 'urgent non-trivial task');
+    }
+    if (input.effort === 'high') {
+        add('high-effort-profile', 1, 'matched high-effort job profile');
+    }
+    const score = signals.reduce((sum, signal) => sum + signal.weight, 0);
+    return {
+        enabled,
+        shouldFanOut: score >= threshold,
+        score,
+        threshold,
+        signals,
+    };
+}
+function buildWorkerFanoutCandidates(base, configured) {
+    if (configured && configured.length > 0)
+        return configured;
+    const primary = {
+        id: 'primary',
+        adapter: base.adapterName,
+        model: base.model,
+        reasoningEffort: base.reasoningEffort,
+        maxTurns: base.maxTurns,
+        nudgeMaxOnNoEdit: base.nudgeMaxOnNoEdit,
+        webTools: base.webTools,
+        memoryTools: base.memoryTools,
+    };
+    const spark = {
+        id: 'spark-diversity',
+        adapter: 'codex-responses',
+        model: 'gpt-5.3-codex-spark',
+        reasoningEffort: 'low',
+        maxTurns: Math.min(base.maxTurns ?? 12, 12),
+        nudgeMaxOnNoEdit: base.nudgeMaxOnNoEdit,
+        webTools: false,
+        memoryTools: false,
+    };
+    const seen = new Set();
+    return [primary, spark].filter((candidate) => {
+        const key = `${candidate.adapter ?? ''}:${candidate.model ?? ''}`;
+        if (seen.has(key))
+            return false;
+        seen.add(key);
+        return true;
+    });
+}
+export function emitWorkerFanoutGateDecision(input) {
+    const { context, decision } = input;
+    const reasons = decision.signals.map((signal) => signal.reason);
+    input.emit('fanout:gate', { context, decision });
+    broadcastEvent({
+        type: 'pipeline:fanout',
+        data: {
+            taskId: context.task.id,
+            iteration: context.currentIteration,
+            enabled: decision.enabled,
+            shouldFanOut: decision.shouldFanOut,
+            score: decision.score,
+            threshold: decision.threshold,
+            reasons,
+        },
+    });
+    if (!decision.enabled)
+        return;
+    if (!decision.shouldFanOut && !input.verbose)
+        return;
+    const verdict = decision.shouldFanOut ? 'recommend fan-out' : 'single worker';
+    const detail = reasons.length > 0 ? `: ${reasons.join('; ')}` : '';
+    const line = `[FanoutGate] ${verdict} (${decision.score}/${decision.threshold})${detail}`;
+    console.log(`[${context.taskPrefix}] ${line}`);
+    input.emit('log', { line });
+    broadcastEvent({ type: 'log', data: { taskId: context.task.id, stage: 'worker', line: `[${context.taskPrefix}] ${line}` } });
+}
+export async function runWorkerWithOptionalFanout(input) {
+    const { fanoutDecision, fanoutConfig, workerOptions } = input;
+    if (fanoutDecision?.shouldFanOut && fanoutConfig?.mode === 'execute') {
+        const candidates = buildWorkerFanoutCandidates(workerOptions, fanoutConfig.candidates);
+        // Surface execution to stdout too: onLog only reaches broadcastEvent, so
+        // without this the daemon log shows the gate's "recommend fan-out" line but
+        // no evidence fan-out actually ran (the exact symptom that hid this path).
+        console.log(`[fanout] executing ${candidates.length} candidate(s) — gate score ${fanoutDecision.score}/${fanoutDecision.threshold}`);
+        const fanoutResult = await runWorkerFanout({
+            projectPath: input.projectPath,
+            baseWorkerOptions: workerOptions,
+            candidates,
+            concurrency: fanoutConfig.concurrency ?? Math.min(candidates.length, 3),
+            keepSandboxes: fanoutConfig.keepSandboxes,
+            linkSharedPaths: fanoutConfig.linkSharedPaths,
+            guards: input.guards,
+            onLog: input.onLog,
+        });
+        if (fanoutResult.winner) {
+            console.log(`[fanout] promoted winner ${fanoutResult.winner.id} (${fanoutResult.winner.filesChanged.length} file(s))`);
+            return fanoutResult.winner.result;
+        }
+        console.log(`[fanout] fallback to single worker: ${fanoutResult.fallbackReason ?? 'no winner'}`);
+        input.onLog(`[fanout] fallback to single worker: ${fanoutResult.fallbackReason ?? 'no winner'}`);
+    }
+    return input.runWorker(workerOptions);
+}
+//# sourceMappingURL=workerFanoutGate.js.map

package/dist/agents/workerFanoutGate.js.map

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

package/dist/agents/workerValidationEvidence.d.ts

@@ -0,0 +1,5 @@
+import type { WorkerResult } from './agentPair.js';
+export declare function missingWorkerValidationIssues(result: WorkerResult): string[];
+export declare function testerWouldRunForWorkerResult(result: WorkerResult, hasTester: boolean, skipIfNoCode: boolean): boolean;
+export declare function isTesterCodeFile(file: string): boolean;
+//# sourceMappingURL=workerValidationEvidence.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"workerValidationEvidence.d.ts","sourceRoot":"","sources":["../../src/agents/workerValidationEvidence.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAgDnD,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,EAAE,CAe5E;AAED,wBAAgB,6BAA6B,CAC3C,MAAM,EAAE,YAAY,EACpB,SAAS,EAAE,OAAO,EAClB,YAAY,EAAE,OAAO,GACpB,OAAO,CAIT;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEtD"}

package/dist/agents/workerValidationEvidence.js

@@ -0,0 +1,75 @@
+const VALIDATION_RELEVANT_FILE_RE = /\.(ts|tsx|mts|cts|js|jsx|mjs|cjs|py|rs|go|java|rb|c|cc|cpp|h|hpp|swift|kt|kts|scala|cs|php|sh|bash|zsh|sql|toml|ya?ml|json)$/i;
+const VALIDATION_RELEVANT_BASENAME_RE = /(^|\/)(Dockerfile(?:\.[^/]+)?|Containerfile(?:\.[^/]+)?|Makefile|GNUmakefile|go\.mod|go\.sum|Cargo\.toml|Cargo\.lock|package(?:-lock)?\.json|pnpm-lock\.ya?ml|yarn\.lock|bun\.lockb?|requirements(?:-[^/]+)?\.txt|pyproject\.toml|poetry\.lock|Pipfile(?:\.lock)?|Gemfile(?:\.lock)?|pom\.xml|build\.gradle(?:\.kts)?|settings\.gradle(?:\.kts)?|flake\.nix|shell\.nix|docker-compose\.ya?ml|compose\.ya?ml)$/i;
+// Only treat README/CHANGELOG/LICENSE/NOTICE as doc-only when they carry a doc
+// extension (or none). A real source module named e.g. `readme.ts` must NOT be
+// misclassified as docs — that would let it skip the validation gate while the
+// tester's isTesterCodeFile() still treats it as code (inconsistent).
+const DOC_ONLY_FILE_RE = /(^|\/)(README|CHANGELOG|LICENSE|NOTICE)(\.(md|mdx|txt|rst|adoc))?$|(^|\/)docs?\/|\.((md|mdx|txt|rst|adoc))$/i;
+// Pure data/asset trees (locale strings, fixtures, snapshots, mocks) have
+// nothing to build or test on their own; exempt them so a data-only edit does
+// not get bounced for "no validation command".
+const DATA_ONLY_DIR_RE = /(^|\/)(locales?|i18n|fixtures?|__fixtures__|__snapshots__|snapshots?|__mocks__|mocks?|testdata|test-data)\//i;
+const VALIDATION_COMMAND_RE = /\b(npm\s+(?:test|run\s+(?:test|build|lint|typecheck|check|ci|verify|validate|smoke))|pnpm\s+(?:test|run\s+(?:test|build|lint|typecheck|check|ci|verify|validate|smoke))|yarn\s+(?:test|run\s+(?:test|build|lint|typecheck|check|ci|verify|validate|smoke))|bun\s+(?:test|run\s+(?:test|build|lint|typecheck|check|ci|verify|validate|smoke))|vitest|jest|mocha|pytest|ruff|mypy|pyright|tsc|eslint|oxlint|cargo\s+(?:check|test|clippy|build)|go\s+(?:test|vet|build)|swift\s+test|gradle\s+(?:test|build|check)|mvn\s+(?:test|verify)|make\b|cmake\b|py_compile|compileall|clippy|fmt\s+--check)\b/i;
+// Anchored at each segment start: a leading inspection verb means that segment
+// ran no validation (e.g. `rg "npm test"` searches for the string, it does not
+// run it), so the segment is skipped rather than the whole command rejected.
+const INSPECTION_ONLY_COMMAND_RE = /^\s*(?:rg|grep|sed|cat|ls|find|pwd|git\s+(?:status|diff|show|log|grep)|jq|head|tail|wc|tree|du|file|which)\b/i;
+const SCRIPT_SMOKE_COMMAND_RE = /^\s*(?:python3?|node|tsx|ts-node|uv\s+run|npx|bunx|bash|sh)\b.*\b(?:scripts?\/|tests?\/|\.py|\.js|\.ts|\.sh|--help|--dry-run|smoke|verify|validate|check|test|build|compile)\b/i;
+const TESTER_CODE_FILE_RE = /\.(ts|tsx|mts|cts|js|jsx|mjs|cjs|py|rs|go|java|rb|c|cpp|h|hpp)$/;
+function validationRelevantFiles(files) {
+    return files.filter(file => {
+        if (/(^|\/)docs?\//i.test(file))
+            return false;
+        if (VALIDATION_RELEVANT_BASENAME_RE.test(file))
+            return true;
+        // Data/asset trees (locale, fixtures, snapshots, mocks) are exempt ONLY for
+        // non-code assets. A real source module under such a dir (e.g.
+        // src/__mocks__/api.ts, test/fixtures/helper.ts) still needs a check —
+        // exempting the whole directory would be a gate bypass.
+        if (DATA_ONLY_DIR_RE.test(file) && !TESTER_CODE_FILE_RE.test(file))
+            return false;
+        return VALIDATION_RELEVANT_FILE_RE.test(file) && !DOC_ONLY_FILE_RE.test(file);
+    });
+}
+function commandLooksLikeValidation(command) {
+    // Workers routinely chain inspection then validation in one string
+    // (e.g. "git diff && npm test"). Evaluate each shell segment independently so
+    // a leading inspection verb does not mask a real validation command in a later
+    // segment, while an inspection-only segment (which may merely *mention* a test
+    // command as a search string) still counts as no validation.
+    const segments = command.split(/&&|\|\||;|\|/).map(s => s.trim()).filter(Boolean);
+    const candidates = segments.length > 0 ? segments : [command];
+    return candidates.some(seg => {
+        if (INSPECTION_ONLY_COMMAND_RE.test(seg))
+            return false;
+        return VALIDATION_COMMAND_RE.test(seg) || SCRIPT_SMOKE_COMMAND_RE.test(seg);
+    });
+}
+export function missingWorkerValidationIssues(result) {
+    const changed = validationRelevantFiles(result.filesChanged ?? []);
+    if (changed.length === 0)
+        return [];
+    const commands = result.commands ?? [];
+    if (commands.some(commandLooksLikeValidation))
+        return [];
+    const sample = changed.slice(0, 6).join(', ');
+    const suffix = changed.length > 6 ? `, +${changed.length - 6} more` : '';
+    const commandIssue = commands.length === 0
+        ? 'Worker changed code/config files but reported zero validation commands.'
+        : `Worker changed code/config files but only reported non-validation commands: ${commands.slice(0, 3).join('; ')}`;
+    return [
+        commandIssue,
+        `Run at least one relevant smoke/build/test/static check before review, or run the closest available check and report its failure. Files needing validation: ${sample}${suffix}`,
+    ];
+}
+export function testerWouldRunForWorkerResult(result, hasTester, skipIfNoCode) {
+    if (!hasTester)
+        return false;
+    if (!skipIfNoCode)
+        return true;
+    return (result.filesChanged ?? []).some(file => TESTER_CODE_FILE_RE.test(file));
+}
+export function isTesterCodeFile(file) {
+    return TESTER_CODE_FILE_RE.test(file);
+}
+//# sourceMappingURL=workerValidationEvidence.js.map

package/dist/agents/workerValidationEvidence.js.map

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