open-multi-agent-kit 0.79.1 → 0.79.3

package/dist/orchestration/ensemble.js

@@ -0,0 +1,558 @@
+import { getOmkResourceSettings } from "../util/resource-profile.js";
+import { getOmkPath, readTextFile, ensureDir } from "../util/fs.js";
+import { join, dirname, relative } from "path";
+import { getWorktreesRoot, removeWorktreeDirectory, resolveSafeWorktreePath, validateWorktreeId } from "../util/worktree.js";
+import { readdir, copyFile, readFile } from "fs/promises";
+const DEFAULT_CANDIDATES = {
+    architect: [
+        { id: "systems", perspective: "system boundaries, interfaces, and long-horizon tradeoffs", weight: 1 },
+        { id: "risk", perspective: "failure modes, hidden constraints, and rollback risks", weight: 1 },
+        { id: "lean", perspective: "simplest plan that preserves correctness", weight: 0.8 },
+    ],
+    planner: [
+        { id: "sequence", perspective: "critical path sequencing and dependencies", weight: 1 },
+        { id: "tests", perspective: "acceptance criteria and verification shape", weight: 1 },
+        { id: "risk", perspective: "scope control and implementation risk", weight: 0.8 },
+    ],
+    coder: [
+        { id: "implement", perspective: "minimal correct implementation", weight: 1 },
+        { id: "edge-cases", perspective: "edge cases, error handling, and backward compatibility", weight: 1 },
+        { id: "simplicity", perspective: "delete/reuse-first simplification", weight: 0.8 },
+    ],
+    reviewer: [
+        { id: "correctness", perspective: "logic defects, regressions, and contract drift", weight: 1 },
+        { id: "security", perspective: "trust boundaries, command execution, and data exposure", weight: 1 },
+        { id: "maintainability", perspective: "unnecessary complexity and future maintenance", weight: 0.8 },
+    ],
+    router: [
+        { id: "skill-fit", perspective: "match task intent to the smallest sufficient skill and MCP set", role: "planner", weight: 1 },
+        { id: "safety-budget", perspective: "preserve read-only safety, context budget, and low-memory fallbacks", role: "reviewer", weight: 1 },
+        { id: "evidence", perspective: "require evidence gates and verification routes before completion", role: "qa", weight: 0.8 },
+    ],
+    orchestrator: [
+        { id: "critical-path", perspective: "DAG critical path, dependency fanout, and unblock order", role: "planner", weight: 1 },
+        { id: "orchestrator-context", perspective: "OMK small-context routing, concise evidence, and tool-call fit", role: "router", weight: 1 },
+        { id: "fallback", perspective: "agent failure recovery, retries, and blocked dependents", role: "reviewer", weight: 0.8 },
+    ],
+    qa: [
+        { id: "regression", perspective: "regression and smoke coverage", weight: 1 },
+        { id: "edge", perspective: "edge cases and failure paths", weight: 1 },
+    ],
+    explorer: [
+        { id: "symbols", perspective: "file, symbol, and call-site mapping", weight: 1 },
+        { id: "dataflow", perspective: "data flow and dependency relationships", weight: 1 },
+    ],
+    default: [
+        { id: "primary", perspective: "primary task objective", weight: 1 },
+        { id: "critic", perspective: "critical counter-review before accepting the result", weight: 1 },
+    ],
+};
+let ensembleConfigPromise;
+export function createEnsembleTaskRunner(baseRunner, policy = {}) {
+    return {
+        get onThinking() {
+            return baseRunner.onThinking;
+        },
+        set onThinking(fn) {
+            baseRunner.onThinking = fn;
+        },
+        fork(newOnThinking) {
+            const forkedBase = baseRunner.fork ? baseRunner.fork(newOnThinking) : baseRunner;
+            return createEnsembleTaskRunner(forkedBase, policy);
+        },
+        async run(node, env, signal) {
+            const resources = await getOmkResourceSettings();
+            const config = await getEnsembleConfig();
+            const effectivePolicy = normalizePolicy(policy, resources, config);
+            const candidates = selectCandidates(node.role, effectivePolicy);
+            if (!effectivePolicy.enabled || candidates.length <= 1) {
+                return baseRunner.run(node, {
+                    ...env,
+                    OMK_ENSEMBLE: "off",
+                    OMK_ENSEMBLE_CANDIDATE_ID: candidates[0]?.id ?? "solo",
+                }, signal);
+            }
+            const progressMap = new Map();
+            const total = candidates.length;
+            function updateThinking() {
+                const parts = Array.from(progressMap.entries())
+                    .map(([id, status]) => `${id}:${status}`);
+                node.thinking = `🧠 ensemble [${parts.length}/${total}] ${parts.slice(-3).join(" · ")}`;
+            }
+            node.thinking = `🧠 ensemble preparing ${total} candidate${total > 1 ? "s" : ""}…`;
+            const createdWorktrees = new Set();
+            const nodeTimeoutMs = Number.parseInt(env.OMK_NODE_TIMEOUT_MS ?? "", 10);
+            const mapperTimeoutMs = (Number.isFinite(nodeTimeoutMs) && nodeTimeoutMs > 0 ? nodeTimeoutMs : 600_000) + 30_000;
+            const candidateControllers = [];
+            try {
+                const candidateResults = await mapWithConcurrency(candidates, effectivePolicy.maxParallel, async (candidate, candidateSignal) => {
+                    progressMap.set(candidate.id, "starting");
+                    updateThinking();
+                    const r = await runCandidate(baseRunner, node, env, candidate, createdWorktrees, candidateSignal);
+                    progressMap.set(candidate.id, r.result.success ? "ok" : "fail");
+                    updateThinking();
+                    return r;
+                }, mapperTimeoutMs, signal, candidateControllers);
+                node.thinking = `🧠 ensemble aggregating ${total} result${total > 1 ? "s" : ""}…`;
+                return await aggregateCandidateResults(node, candidateResults, effectivePolicy);
+            }
+            finally {
+                for (const controller of candidateControllers) {
+                    controller.abort(new Error("Ensemble runner cleaning up"));
+                }
+                await Promise.all(Array.from(createdWorktrees)
+                    .filter((worktree) => worktree !== (node.worktree ?? process.cwd()))
+                    .map((worktree) => cleanupWorktree(worktree)));
+            }
+        },
+    };
+}
+export function selectCandidates(role, policy) {
+    const configured = policy.candidatesByRole[role] ?? policy.candidatesByRole.default;
+    const candidates = configured.length > 0 ? configured : DEFAULT_CANDIDATES.default;
+    return candidates.slice(0, policy.maxCandidatesPerNode).map((candidate, index) => ({
+        ...candidate,
+        id: candidate.id || `${role}-${index + 1}`,
+        weight: normalizeWeight(candidate.weight),
+    }));
+}
+function normalizePolicy(policy, resources, config) {
+    const enabled = policy.enabled ?? config.enabled ?? parseOptionalBoolean(process.env.OMK_ENSEMBLE) ?? resources.ensembleDefaultEnabled;
+    const envMaxCandidates = parsePositiveInt(process.env.OMK_ENSEMBLE_MAX_CANDIDATES);
+    const envMaxParallel = parsePositiveInt(process.env.OMK_ENSEMBLE_MAX_PARALLEL);
+    const envQuorumRatio = parsePositiveNumber(process.env.OMK_ENSEMBLE_QUORUM_RATIO);
+    const maxCandidatesPerNode = Math.max(1, Math.min(6, policy.maxCandidatesPerNode ?? config.maxCandidatesPerNode ?? envMaxCandidates ?? 2));
+    const maxParallel = Math.max(1, Math.min(maxCandidatesPerNode, policy.maxParallel ?? config.maxParallel ?? envMaxParallel ?? resources.maxWorkers));
+    const quorumRatio = Math.max(0.01, Math.min(1, policy.quorumRatio ?? config.quorumRatio ?? envQuorumRatio ?? 0.5));
+    return {
+        enabled,
+        maxCandidatesPerNode,
+        maxParallel,
+        quorumRatio,
+        candidatesByRole: {
+            ...DEFAULT_CANDIDATES,
+            ...(policy.candidatesByRole ?? {}),
+        },
+    };
+}
+async function getEnsembleConfig() {
+    ensembleConfigPromise ??= (async () => {
+        const content = await readTextFile(getOmkPath("config.toml"), "");
+        const section = readSection(content, "ensemble");
+        return {
+            enabled: parseOptionalBoolean(section.enabled),
+            maxCandidatesPerNode: parsePositiveInt(section.max_candidates_per_node),
+            maxParallel: parsePositiveInt(section.max_parallel),
+            quorumRatio: parsePositiveNumber(section.quorum_ratio),
+        };
+    })();
+    return ensembleConfigPromise;
+}
+function readSection(content, sectionName) {
+    const result = {};
+    let active = false;
+    for (const rawLine of content.split(/\r?\n/)) {
+        const line = stripComment(rawLine).trim();
+        if (!line)
+            continue;
+        const section = line.match(/^\[([^\]]+)]$/);
+        if (section) {
+            active = section[1].trim() === sectionName;
+            continue;
+        }
+        if (!active)
+            continue;
+        const kv = line.match(/^([A-Za-z0-9_.-]+)\s*=\s*(.+)$/);
+        if (kv)
+            result[kv[1].trim()] = normalizeTomlValue(kv[2].trim());
+    }
+    return result;
+}
+function stripComment(line) {
+    let inString = false;
+    let quote = "";
+    for (let i = 0; i < line.length; i += 1) {
+        const char = line[i];
+        if ((char === "\"" || char === "'") && line[i - 1] !== "\\") {
+            if (!inString) {
+                inString = true;
+                quote = char;
+            }
+            else if (quote === char) {
+                inString = false;
+            }
+        }
+        if (char === "#" && !inString)
+            return line.slice(0, i);
+    }
+    return line;
+}
+function normalizeTomlValue(value) {
+    const trimmed = value.trim();
+    if ((trimmed.startsWith("\"") && trimmed.endsWith("\"")) || (trimmed.startsWith("'") && trimmed.endsWith("'"))) {
+        return trimmed.slice(1, -1);
+    }
+    return trimmed;
+}
+const SKIP_DIRS = new Set(["node_modules", ".git", ".omk"]);
+const SKIP_FILES = /(\.env(?:\..*)?|\.key$|\.pem$|\.secret$|credentials\.json$)/i;
+async function withTimeout(promise, ms, signal, onTimeout) {
+    if (signal?.aborted)
+        throw signal.reason ?? new Error("Aborted");
+    let timer;
+    let abortListener;
+    const cleanup = () => {
+        if (timer !== undefined) {
+            clearTimeout(timer);
+            timer = undefined;
+        }
+        if (abortListener !== undefined) {
+            signal?.removeEventListener("abort", abortListener);
+            abortListener = undefined;
+        }
+    };
+    const timeoutPromise = new Promise((_, reject) => {
+        timer = setTimeout(() => {
+            onTimeout?.();
+            reject(new Error(`Timed out after ${ms}ms`));
+        }, ms);
+        abortListener = () => {
+            clearTimeout(timer);
+            reject(signal?.reason ?? new Error("Aborted"));
+        };
+        signal?.addEventListener("abort", abortListener, { once: true });
+    });
+    try {
+        return await Promise.race([promise, timeoutPromise]);
+    }
+    finally {
+        cleanup();
+    }
+}
+async function copyWorktreeBase(baseCwd, targetWorktree, signal) {
+    const COPY_TIMEOUT_MS = 60_000;
+    const COPY_CONCURRENCY = 8;
+    let running = 0;
+    const queue = [];
+    async function acquire() {
+        if (running < COPY_CONCURRENCY) {
+            running++;
+            return;
+        }
+        return new Promise((resolve) => queue.push(resolve));
+    }
+    function release() {
+        running--;
+        const next = queue.shift();
+        if (next) {
+            running++;
+            next();
+        }
+    }
+    async function walk(srcDir, destDir) {
+        if (signal?.aborted)
+            throw signal.reason ?? new Error("Aborted");
+        await ensureDir(destDir);
+        const entries = await readdir(srcDir, { withFileTypes: true });
+        await Promise.all(entries.map(async (entry) => {
+            if (SKIP_DIRS.has(entry.name))
+                return;
+            if (entry.isFile() && SKIP_FILES.test(entry.name))
+                return;
+            const srcPath = join(srcDir, entry.name);
+            const destPath = join(destDir, entry.name);
+            if (entry.isDirectory()) {
+                await walk(srcPath, destPath);
+            }
+            else {
+                await acquire();
+                try {
+                    await copyFile(srcPath, destPath);
+                }
+                finally {
+                    release();
+                }
+            }
+        }));
+    }
+    return withTimeout(walk(baseCwd, targetWorktree), COPY_TIMEOUT_MS, signal);
+}
+async function runCandidate(baseRunner, node, env, candidate, worktreeTracker, signal) {
+    const baseCwd = node.worktree ?? process.cwd();
+    let candidateWorktree;
+    let threw = false;
+    try {
+        if (!node.worktree) {
+            const safeNodeId = validateWorktreeId(node.id, "nodeId");
+            const safeCandidateId = validateWorktreeId(candidate.id, "candidateId");
+            candidateWorktree = await resolveSafeWorktreePath(join(getWorktreesRoot(), "ensemble", safeNodeId, safeCandidateId));
+            worktreeTracker?.add(candidateWorktree);
+            try {
+                await copyWorktreeBase(baseCwd, candidateWorktree, signal);
+            }
+            catch {
+                await ensureDir(candidateWorktree);
+            }
+        }
+        const candidateNode = {
+            ...node,
+            id: `${node.id}#${candidate.id}`,
+            role: candidate.role ?? node.role,
+            worktree: candidateWorktree,
+            name: [
+                node.name,
+                "",
+                `Ensemble candidate: ${candidate.id}`,
+                `Perspective: ${candidate.perspective}`,
+                "Return concrete evidence and blockers. Do not hide uncertainty.",
+            ].join("\n"),
+        };
+        const result = await baseRunner.run(candidateNode, {
+            ...env,
+            OMK_ENSEMBLE: "on",
+            OMK_ENSEMBLE_ORIGINAL_NODE_ID: node.id,
+            OMK_ENSEMBLE_CANDIDATE_ID: candidate.id,
+            OMK_ENSEMBLE_PERSPECTIVE: candidate.perspective,
+        }, signal).catch((error) => ({
+            success: false,
+            exitCode: 1,
+            stdout: "",
+            stderr: error instanceof Error ? error.message : String(error),
+        }));
+        return {
+            candidate,
+            result,
+            score: scoreResult(result, normalizeWeight(candidate.weight)),
+            worktree: candidateWorktree,
+        };
+    }
+    catch (e) {
+        threw = true;
+        throw e;
+    }
+    finally {
+        // On success, aggregateCandidateResults handles cleanup after merge.
+        // On exception, clean up immediately to prevent worktree leak.
+        if (threw && candidateWorktree) {
+            await cleanupWorktree(candidateWorktree);
+        }
+    }
+}
+async function mergeWinnerWorktree(winnerWorktree, baseCwd) {
+    const mergedFiles = [];
+    const errors = [];
+    async function walk(dir) {
+        const entries = await readdir(dir, { withFileTypes: true });
+        await Promise.all(entries.map(async (entry) => {
+            if (SKIP_DIRS.has(entry.name))
+                return;
+            const winnerPath = join(dir, entry.name);
+            const relPath = relative(winnerWorktree, winnerPath);
+            const basePath = join(baseCwd, relPath);
+            if (entry.isDirectory()) {
+                await walk(winnerPath);
+                return;
+            }
+            try {
+                const winnerContent = await readFile(winnerPath);
+                let shouldCopy = false;
+                try {
+                    const baseContent = await readFile(basePath);
+                    if (Buffer.compare(winnerContent, baseContent) !== 0) {
+                        shouldCopy = true;
+                    }
+                }
+                catch {
+                    shouldCopy = true;
+                }
+                if (shouldCopy) {
+                    await ensureDir(dirname(basePath));
+                    await copyFile(winnerPath, basePath);
+                    mergedFiles.push(relPath);
+                }
+            }
+            catch (err) {
+                errors.push(`${relPath}: ${err instanceof Error ? err.message : String(err)}`);
+            }
+        }));
+    }
+    await walk(winnerWorktree);
+    return { mergedFiles, errors };
+}
+async function cleanupWorktree(worktree) {
+    try {
+        await removeWorktreeDirectory(worktree);
+    }
+    catch {
+        // ignore cleanup errors for debugging
+    }
+}
+async function aggregateCandidateResults(node, results, policy) {
+    const totalWeight = results.reduce((sum, item) => sum + normalizeWeight(item.candidate.weight), 0);
+    const successWeight = results.reduce((sum, item) => sum + (item.result.success ? normalizeWeight(item.candidate.weight) : 0), 0);
+    const quorumWeight = Math.max(1, totalWeight * policy.quorumRatio);
+    const success = successWeight >= quorumWeight;
+    const winner = [...results].sort((a, b) => b.score - a.score)[0];
+    const summary = renderSummary(node, results, successWeight, totalWeight, quorumWeight);
+    const baseCwd = node.worktree ?? process.cwd();
+    let mergedFiles = [];
+    let mergeErrors = [];
+    if (winner?.worktree && winner.worktree !== baseCwd) {
+        try {
+            const mergeResult = await mergeWinnerWorktree(winner.worktree, baseCwd);
+            mergedFiles = mergeResult.mergedFiles;
+            mergeErrors = mergeResult.errors;
+        }
+        catch (err) {
+            mergeErrors.push(String(err));
+        }
+        await Promise.all(results
+            .filter((item) => item.worktree && item.worktree !== baseCwd)
+            .map((item) => cleanupWorktree(item.worktree)));
+    }
+    return {
+        success,
+        exitCode: success ? winner?.result.exitCode ?? 0 : 1,
+        stdout: [summary, winner?.result.stdout ?? ""].filter(Boolean).join("\n\n"),
+        stderr: results
+            .filter((item) => !item.result.success || item.result.stderr.trim())
+            .map((item) => `[${item.candidate.id}] ${item.result.stderr}`.trim())
+            .filter(Boolean)
+            .join("\n"),
+        metadata: {
+            ...(winner?.result.metadata ?? {}),
+            ensemble: {
+                successWeight,
+                totalWeight,
+                quorumWeight,
+                winner: winner?.candidate.id,
+                mergedFiles,
+                mergeErrors: mergeErrors.length > 0 ? mergeErrors : undefined,
+                candidates: results.map((item) => ({
+                    id: item.candidate.id,
+                    success: item.result.success,
+                    score: item.score,
+                })),
+            },
+        },
+    };
+}
+function renderSummary(node, results, successWeight, totalWeight, quorumWeight) {
+    const lines = [
+        `# OMK Ensemble Result`,
+        ``,
+        `Node: ${node.id} (${node.role})`,
+        `Quorum: ${successWeight.toFixed(2)} / ${totalWeight.toFixed(2)} success weight (required ${quorumWeight.toFixed(2)})`,
+        ``,
+        `| Candidate | Perspective | Success | Score |`,
+        `|---|---|---:|---:|`,
+    ];
+    for (const item of results) {
+        lines.push(`| ${item.candidate.id} | ${escapePipe(item.candidate.perspective)} | ${item.result.success ? "yes" : "no"} | ${item.score.toFixed(2)} |`);
+    }
+    return lines.join("\n");
+}
+function scoreResult(result, weight) {
+    if (!result.success)
+        return 0;
+    const stdout = result.stdout.toLowerCase();
+    const stderr = result.stderr.toLowerCase();
+    const confidence = stdout.match(/confidence\s*[:=]\s*(0(?:\.\d+)?|1(?:\.0+)?)/)?.[1];
+    let confidenceScore;
+    if (confidence) {
+        confidenceScore = Number(confidence);
+    }
+    else {
+        const exitCode = result.exitCode ?? 0;
+        const exitCodeScore = exitCode === 0 ? 1.0 : Math.max(0, 0.7 - exitCode * 0.1);
+        const stderrPenalty = Math.min(0.5, result.stderr.length / 2000);
+        const stdoutBonus = result.stdout.trim().length > 0 ? 0.1 : 0;
+        const combinedText = stdout + " " + stderr;
+        const keywordPenalty = /\b(error|fail|exception)\b/.test(combinedText) ? 0.3 : 0;
+        confidenceScore = Math.max(0, Math.min(1, exitCodeScore - stderrPenalty + stdoutBonus - keywordPenalty));
+    }
+    return weight * Math.max(0, Math.min(1, confidenceScore));
+}
+async function mapWithConcurrency(items, concurrency, mapper, timeoutMs = 600_000, signal, outControllers) {
+    const results = new Array(items.length);
+    const errors = new Array(items.length);
+    let next = 0;
+    const activeControllers = new Set();
+    let stopped = false;
+    function abortAll(reason) {
+        for (const controller of activeControllers) {
+            controller.abort(reason);
+        }
+    }
+    async function worker() {
+        while (next < items.length) {
+            const index = next;
+            next += 1;
+            if (signal?.aborted || stopped) {
+                errors[index] = signal?.reason ?? new Error("Aborted");
+                continue;
+            }
+            const controller = new AbortController();
+            activeControllers.add(controller);
+            outControllers?.push(controller);
+            const candidateSignal = signal ? AbortSignal.any([signal, controller.signal]) : controller.signal;
+            try {
+                results[index] = await withTimeout(mapper(items[index], candidateSignal), timeoutMs, candidateSignal, () => controller.abort(new Error(`Candidate timed out after ${timeoutMs}ms`)));
+            }
+            catch (err) {
+                errors[index] = err;
+                stopped = true;
+                abortAll(signal?.reason ?? new Error("Candidate failed, aborting remaining"));
+            }
+            finally {
+                activeControllers.delete(controller);
+                controller.abort(new Error("Candidate finished"));
+            }
+        }
+    }
+    const abortHandler = () => {
+        stopped = true;
+        abortAll(signal?.reason ?? new Error("Aborted"));
+    };
+    signal?.addEventListener("abort", abortHandler, { once: true });
+    try {
+        await Promise.all(Array.from({ length: Math.min(concurrency, items.length) }, () => worker()));
+    }
+    finally {
+        signal?.removeEventListener("abort", abortHandler);
+        stopped = true;
+        abortAll(new Error("mapWithConcurrency finished"));
+    }
+    const firstError = errors.find((e) => e !== undefined);
+    if (firstError)
+        throw firstError;
+    return results;
+}
+function normalizeWeight(weight) {
+    return Number.isFinite(weight) && weight !== undefined && weight > 0 ? weight : 1;
+}
+function parsePositiveInt(value) {
+    if (!value)
+        return undefined;
+    const parsed = Number.parseInt(value, 10);
+    return Number.isFinite(parsed) && parsed > 0 ? parsed : undefined;
+}
+function parseOptionalBoolean(value) {
+    if (value === undefined)
+        return undefined;
+    const normalized = value.trim().toLowerCase();
+    if (["1", "true", "yes", "on"].includes(normalized))
+        return true;
+    if (["0", "false", "no", "off"].includes(normalized))
+        return false;
+    return undefined;
+}
+function parsePositiveNumber(value) {
+    if (!value)
+        return undefined;
+    const parsed = Number.parseFloat(value);
+    return Number.isFinite(parsed) && parsed > 0 ? parsed : undefined;
+}
+function escapePipe(value) {
+    return value.replace(/\|/g, "\\|");
+}

package/dist/orchestration/eta.d.ts

@@ -0,0 +1,10 @@
+import type { RunProgressEstimate } from "../contracts/orchestration.js";
+import type { DagNode } from "./dag.js";
+export interface EstimateRunProgressInput {
+    nodes: DagNode[];
+    startedAt: string;
+    workerCount: number;
+    now?: Date;
+    fallbackDurationMs?: number;
+}
+export declare function estimateRunProgress(input: EstimateRunProgressInput): RunProgressEstimate;

package/dist/orchestration/eta.js

@@ -0,0 +1,75 @@
+const DEFAULT_NODE_DURATION_MS = 180_000;
+const MIN_RUNNING_REMAINING_RATIO = 0.1;
+export function estimateRunProgress(input) {
+    const now = input.now ?? new Date();
+    const nowMs = now.getTime();
+    const startedMs = parseTimestamp(input.startedAt) ?? nowMs;
+    const workerCount = Math.max(1, Math.floor(input.workerCount));
+    const fallbackDurationMs = normalizeDuration(input.fallbackDurationMs) ?? DEFAULT_NODE_DURATION_MS;
+    const completedNodes = input.nodes.filter((node) => node.status === "done").length;
+    const runningNodes = input.nodes.filter((node) => node.status === "running").length;
+    const pendingNodes = input.nodes.filter((node) => node.status === "pending").length;
+    const failedNodes = input.nodes.filter((node) => node.status === "failed").length;
+    const blockedNodes = input.nodes.filter((node) => node.status === "blocked").length;
+    const totalNodes = input.nodes.length;
+    const completedDurations = input.nodes
+        .filter((node) => node.status === "done")
+        .map((node) => normalizeDuration(node.durationMs))
+        .filter((duration) => duration !== undefined);
+    const averageCompletedDurationMs = completedDurations.length > 0
+        ? Math.round(completedDurations.reduce((sum, duration) => sum + duration, 0) / completedDurations.length)
+        : undefined;
+    const averageDurationMs = averageCompletedDurationMs ?? fallbackDurationMs;
+    const runningRemainingMs = input.nodes
+        .filter((node) => node.status === "running")
+        .map((node) => estimateRunningRemaining(node, nowMs, averageDurationMs));
+    const maxRunningRemainingMs = runningRemainingMs.length === 0 ? 0 : Math.max(...runningRemainingMs);
+    const pendingWaves = pendingNodes === 0 ? 0 : Math.ceil(pendingNodes / workerCount);
+    const estimatedRemainingMs = Math.round(maxRunningRemainingMs + pendingWaves * averageDurationMs);
+    const estimatedCompletedAt = estimatedRemainingMs > 0
+        ? new Date(nowMs + estimatedRemainingMs).toISOString()
+        : now.toISOString();
+    return {
+        elapsedMs: Math.max(0, nowMs - startedMs),
+        completedNodes,
+        runningNodes,
+        pendingNodes,
+        failedNodes,
+        blockedNodes,
+        totalNodes,
+        workerCount,
+        percentComplete: totalNodes === 0 ? 100 : Math.round((completedNodes / totalNodes) * 100),
+        fallbackDurationMs,
+        averageCompletedDurationMs,
+        estimatedRemainingMs,
+        estimatedCompletedAt,
+        confidence: estimateConfidence(completedDurations.length, totalNodes),
+        updatedAt: now.toISOString(),
+    };
+}
+function estimateRunningRemaining(node, nowMs, averageDurationMs) {
+    const startedAtMs = parseTimestamp(node.startedAt);
+    if (startedAtMs === undefined)
+        return averageDurationMs;
+    const elapsedMs = Math.max(0, nowMs - startedAtMs);
+    const minimumRemainingMs = Math.round(averageDurationMs * MIN_RUNNING_REMAINING_RATIO);
+    return Math.max(averageDurationMs - elapsedMs, minimumRemainingMs);
+}
+function estimateConfidence(completedSampleSize, totalNodes) {
+    if (completedSampleSize === 0)
+        return "low";
+    if (completedSampleSize >= 2 || completedSampleSize >= Math.ceil(totalNodes / 2))
+        return "high";
+    return "medium";
+}
+function parseTimestamp(value) {
+    if (!value)
+        return undefined;
+    const parsed = Date.parse(value);
+    return Number.isFinite(parsed) ? parsed : undefined;
+}
+function normalizeDuration(value) {
+    if (value === undefined || !Number.isFinite(value) || value <= 0)
+        return undefined;
+    return Math.round(value);
+}

package/dist/orchestration/evidence-check.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Evidence gate checking implementation.
+ *
+ * Evaluates a list of evidence gates (file-exists, command-pass,
+ * diff-nonempty, summary-present) and returns structured results.
+ */
+import type { DagNodeEvidence } from "./dag.js";
+import type { EvidenceFailureKind } from "./diagnostics.js";
+export declare const SUMMARY_ALIASES: string[];
+export interface EvidenceGate {
+    type: "file-exists" | "command-pass" | "diff-nonempty" | "summary-present";
+    path?: string;
+    command?: string;
+    summaryMarker?: string;
+    severity?: "required" | "warn";
+}
+export interface EvidenceCheckContext {
+    cwd: string;
+    stdout: string;
+    nodeId: string;
+    runId?: string;
+    attemptId?: string;
+}
+export interface EvidenceResult extends DagNodeEvidence {
+    failureKind?: EvidenceFailureKind;
+    command?: string;
+    exitCode?: number;
+    stdoutTail?: string;
+    stderrTail?: string;
+    evidenceText?: string;
+}
+export declare function checkEvidenceGates(gates: EvidenceGate[], context: EvidenceCheckContext): Promise<{
+    passed: boolean;
+    evidence: EvidenceResult[];
+    warnings: EvidenceResult[];
+}>;