@e2edev/e2e 0.2.0

package/dist/run/runner.js

@@ -0,0 +1,375 @@
+/** Run orchestration: config, collection, selection, execution, reporting. */
+import path from 'node:path';
+import { discoverConfig, loadConfigModule } from '../config/load.js';
+import { isCiMode, resolveConfig, } from '../config/resolve.js';
+import { collect } from '../collect/collect.js';
+import { select } from '../collect/select.js';
+import { classifyError, combineExitCodes, ConfigurationError, E2EError, errorMessage, exitCodeForCategory, serializeError, } from '../internal/errors.js';
+import { loadAiSdk } from '../agent/ai-sdk.js';
+import { AiTraceCollector, AiTraceRecorder, registerAiTraceRecorder } from '../internal/ai-trace.js';
+import { DebugTrace } from '../internal/debug.js';
+import { timestamp, uuidv7 } from '../internal/ids.js';
+import { buildReport, describeTarget } from '../report/build.js';
+import { agentStepTable } from '../report/debug-steps.js';
+import { ListReporter } from '../report/list.js';
+import { writeJsonReport } from '../report/write.js';
+import { AppProcess } from './app-process.js';
+import { createRunEventEmitter, toEventResult } from './events.js';
+import { inProcessSpawner } from './in-process.js';
+import { runUnits } from './scheduler.js';
+import { SessionStore } from './sessions.js';
+import { childProcessSpawner } from './worker/handle.js';
+import { setCredentialRegistry } from '../credentials.js';
+/** Executes one complete run and returns the outcome without exiting. */
+export async function run(options = {}) {
+    const cwd = options.cwd ?? process.cwd();
+    const env = options.env ?? process.env;
+    const runId = uuidv7();
+    const startedAt = timestamp();
+    const debug = new DebugTrace(options.debug === true);
+    const aiTrace = options.aiTrace === true ? new AiTraceCollector() : undefined;
+    /** The in-process recorder; child-process workers own their own. */
+    let aiTraceRecorder;
+    const interruptController = new AbortController();
+    const runErrors = [];
+    const results = [];
+    const serialGroups = [];
+    const targetProvenance = new Map();
+    let appProcess;
+    let sessionStore;
+    // Hoisted: workers re-resolve the same config file and need these overrides,
+    // or a flag would apply in the runner and be dropped in every worker.
+    const cli = {};
+    if (options.retries !== undefined)
+        cli.retries = options.retries;
+    if (options.workers !== undefined)
+        cli.workers = options.workers;
+    if (options.reporters !== undefined)
+        cli.reporters = options.reporters;
+    if (options.noCache === true)
+        cli.cache = 'off';
+    // Config resolves before anything is emitted, and its failure is kept rather
+    // than thrown: the reporter set is config truth (CLI overrides merge during
+    // resolution), so the emitter below is built exactly once from the set
+    // actually in force. When config itself failed, the CLI's own value is the
+    // best available, and the failure still renders through it.
+    const loaded = await debug.time('config.load', () => loadRunConfig(options, cwd, env, cli)).then((config) => ({ config, error: undefined }), (cause) => ({ config: undefined, error: classifyError(cause) }));
+    // The event stream is the run's single spine: the list reporter is just one
+    // sink on it, beside the host's, so the CLI and a host can never see
+    // different stories.
+    const reporters = loaded.config?.reporters ?? options.reporters ?? ['list'];
+    const emit = createRunEventEmitter([
+        options.quiet === true || reporters.includes('json') ? undefined : new ListReporter().handle,
+        options.onEvent,
+    ]);
+    const jsonReport = reporters.includes('json');
+    /** Records one run-level error once: into the report and onto the stream. */
+    const recordRunError = (runError) => {
+        runErrors.push(runError);
+        emit({ type: 'run-error', error: runError.error });
+    };
+    /** Records a failure of the run itself, outside any test. */
+    const recordFailure = (cause, phase) => {
+        recordRunError({ error: serializeError(classifyError(cause), phase === undefined ? {} : { phase }) });
+    };
+    /**
+     * The exit code is a fold over run state — every result, every run error,
+     * the interrupt — never threaded through by hand. A run error recorded
+     * anywhere, including during teardown or the report write, reaches the exit
+     * code the same way.
+     */
+    const currentExitCode = () => combineExitCodes([
+        ...resultExitCodes(results),
+        ...runErrors.map((runError) => exitCodeForCategory(runError.error.category)),
+        ...(interruptController.signal.aborted ? [130] : []),
+    ]);
+    const buildRunReport = (exitCode) => buildReport({
+        runId,
+        config: loaded.config,
+        startedAt,
+        status: statusOf(exitCode),
+        exitCode,
+        results,
+        serialGroups,
+        runErrors,
+        targetProvenance,
+    });
+    /**
+     * Writes the canonical report and returns its path only once the file
+     * exists: a host must never be handed a path to a report that was not
+     * written. A lost canonical report is an infrastructure run error, not a
+     * footnote: recorded like any other, it reaches the exit code, and the
+     * returned in-memory document becomes the only complete record. The file
+     * is not retried — the destination just failed.
+     */
+    const writeCanonicalReport = async (config) => {
+        const target = path.join(path.dirname(resolveArtifactsRoot(config, options.artifactsDir)), 'report.json');
+        try {
+            await writeJsonReport(target, buildRunReport(currentExitCode()));
+            return target;
+        }
+        catch (cause) {
+            recordFailure(new E2EError('infrastructure', 'REPORT_WRITE_FAILED', `the canonical report could not be written: ${errorMessage(cause)}`, { cause }), 'report');
+            return undefined;
+        }
+    };
+    /**
+     * Writes the AI trace next to the report, on the same terms: the path is
+     * returned only once the file exists, and a lost trace is a recorded run
+     * error. The in-process recorder is drained here; child-process workers
+     * already shipped theirs over the worker channel.
+     */
+    const writeAiTrace = async (config) => {
+        if (aiTrace === undefined)
+            return undefined;
+        if (aiTraceRecorder !== undefined) {
+            aiTrace.merge(aiTraceRecorder.drain({ all: true }));
+            aiTraceRecorder.dispose();
+            aiTraceRecorder = undefined;
+        }
+        const target = path.join(path.dirname(resolveArtifactsRoot(config, options.artifactsDir)), 'ai-trace.json');
+        try {
+            await writeJsonReport(target, aiTrace.document());
+            return target;
+        }
+        catch (cause) {
+            recordFailure(new E2EError('infrastructure', 'REPORT_WRITE_FAILED', `the AI trace could not be written: ${errorMessage(cause)}`, { cause }), 'report');
+            return undefined;
+        }
+    };
+    const finish = async () => {
+        const aiTracePath = loaded.config === undefined ? undefined : await writeAiTrace(loaded.config);
+        const reportPath = loaded.config === undefined ? undefined : await writeCanonicalReport(loaded.config);
+        const exitCode = currentExitCode();
+        const status = statusOf(exitCode);
+        const report = buildRunReport(exitCode);
+        setCredentialRegistry(undefined);
+        emit({
+            type: 'run-finished',
+            status,
+            exitCode,
+            ...(reportPath === undefined ? {} : { reportPath }),
+            ...(aiTracePath === undefined ? {} : { aiTracePath }),
+        });
+        if (jsonReport) {
+            process.stdout.write(`${JSON.stringify(report, null, 2)}\n`);
+        }
+        if (debug.enabled) {
+            process.stderr.write(debug.summary());
+            process.stderr.write(agentStepTable(results, serialGroups));
+        }
+        return { exitCode, status, report, reportPath, aiTracePath, results };
+    };
+    if (loaded.config === undefined) {
+        recordFailure(loaded.error, 'config');
+        return finish();
+    }
+    const config = loaded.config;
+    setCredentialRegistry(config.credentials);
+    emit({
+        type: 'run-started',
+        runId,
+        projectId: config.projectId,
+        projectRoot: config.projectRoot,
+        ci: isCiMode(env),
+        targets: config.targets.map((target) => target.name),
+    });
+    const executeRun = async () => {
+        const interrupted = interruptController.signal;
+        if (config.app.command !== undefined) {
+            const app = new AppProcess(config.app.command, config.projectRoot, config.app.readyUrl);
+            appProcess = app;
+            await debug.time('app.start', () => app.start(interrupted));
+        }
+        // A run cancelled before any test could start collects nothing: the
+        // interrupt alone decides the outcome.
+        if (interrupted.aborted)
+            return;
+        let planned;
+        try {
+            planned = await debug.time('collect', async () => {
+                const collection = await collect(config, options.files);
+                const filters = {
+                    ...(options.tags !== undefined ? { tags: options.tags } : {}),
+                    ...(options.tagMode !== undefined ? { tagMode: options.tagMode } : {}),
+                    ...(options.targetIds !== undefined ? { targetIds: options.targetIds } : {}),
+                };
+                const selection = select(collection, config, filters, options.passWithNoTests !== undefined ? { passWithNoTests: options.passWithNoTests } : {});
+                return { collection, selection };
+            });
+        }
+        catch (cause) {
+            recordFailure(cause, 'collection');
+            return;
+        }
+        const { collection, selection } = planned;
+        emit({ type: 'plan', total: selection.pairs.length });
+        const artifactsRoot = resolveArtifactsRoot(config, options.artifactsDir);
+        const sessionsRoot = path.join(config.projectRoot, '.e2e', 'sessions');
+        const store = SessionStore.create(runId, sessionsRoot);
+        sessionStore = store;
+        // Pre-flight: grade every selected target from its backend declaration
+        // before any worker starts, so a config that asks for more than the
+        // backend offers fails here, once, instead of inside a launch budget.
+        for (const { target } of selection.perTarget) {
+            targetProvenance.set(target.name, validateBackend(target, config));
+        }
+        // Workers re-load the config module themselves, so a file-backed config
+        // runs across processes. A programmatic `rawConfig` cannot cross a process
+        // boundary (it may hold live backend handles), so it runs in-process
+        // against one worker. Either way the scheduler is the only engine.
+        if (aiTrace !== undefined && config.configPath === undefined) {
+            // In-process execution shares this process with the runner, so the
+            // recorder lives here and is drained straight into the collector.
+            aiTraceRecorder = new AiTraceRecorder();
+            await registerAiTraceRecorder(aiTraceRecorder, loadAiSdk);
+        }
+        const transport = config.configPath === undefined
+            ? {
+                workers: 1,
+                spawn: inProcessSpawner({
+                    config,
+                    selection,
+                    runId,
+                    artifactsRoot,
+                    sessionStore: store,
+                    headed: options.headed ?? false,
+                    debug,
+                }),
+            }
+            : {
+                workers: config.workers,
+                spawn: childProcessSpawner({
+                    configPath: config.configPath,
+                    projectRoot: config.projectRoot,
+                    configDigest: config.configDigest,
+                    cli,
+                    runId,
+                    artifactsRoot,
+                    headed: options.headed ?? false,
+                    sessionsRoot,
+                    sessionKeyBase64: store.exportKeyForWorker(),
+                    debug: debug.enabled,
+                    aiTrace: aiTrace !== undefined,
+                    env,
+                }),
+            };
+        await debug.time('scheduler', () => runUnits({
+            selection,
+            collection,
+            projectRoot: config.projectRoot,
+            workers: transport.workers,
+            spawn: transport.spawn,
+            interruptGraceMs: config.timeout + config.cleanupTimeout,
+            interruptSignal: interrupted,
+            events: {
+                onResult: (result) => {
+                    results.push(result);
+                    emit({ type: 'test-finished', result: toEventResult(result) });
+                },
+                onSerialGroup: (group) => {
+                    serialGroups.push(group);
+                    emit({ type: 'serial-group', group });
+                },
+                onRunError: recordRunError,
+                onTestStart: (testId, title, targetName) => emit({ type: 'test-started', testId, title, target: targetName }),
+                onProgress: (testId, targetName, progress) => emit({ type: 'step', testId, target: targetName, progress }),
+                onDebug: (snapshot) => debug.merge(snapshot),
+                onAiTrace: (snapshot) => aiTrace?.merge(snapshot),
+            },
+        }));
+    };
+    // The interrupt bridge is armed for the whole body — app startup, collection,
+    // scheduling — so a host's cancellation lands wherever the run is, not only
+    // once the scheduler happens to be running. From here the run owns external
+    // resources. Failures anywhere are recorded, never thrown — the outcome must
+    // survive its own execution and its own cleanup — and teardown always runs
+    // before the terminal `run-finished`, so that event means the app process
+    // and session store are gone.
+    const externalSignal = options.interruptSignal;
+    const onInterrupt = () => interruptController.abort();
+    if (externalSignal?.aborted === true)
+        interruptController.abort();
+    externalSignal?.addEventListener('abort', onInterrupt, { once: true });
+    process.once('SIGINT', onInterrupt);
+    process.once('SIGTERM', onInterrupt);
+    try {
+        await executeRun();
+    }
+    catch (cause) {
+        recordFailure(cause);
+    }
+    finally {
+        process.removeListener('SIGINT', onInterrupt);
+        process.removeListener('SIGTERM', onInterrupt);
+        externalSignal?.removeEventListener('abort', onInterrupt);
+    }
+    for (const teardown of [() => sessionStore?.cleanup(), () => appProcess?.stop()]) {
+        try {
+            await teardown();
+        }
+        catch (cause) {
+            recordFailure(cause);
+        }
+    }
+    return finish();
+}
+/** Resolves the run's config: a supplied value, or the discovered file. */
+async function loadRunConfig(options, cwd, env, cli) {
+    if (options.rawConfig !== undefined) {
+        return resolveConfig(options.rawConfig, { projectRoot: cwd, env, cli });
+    }
+    const discovered = discoverConfig(cwd, options.configPath);
+    const raw = discovered.configPath === undefined ? {} : await loadConfigModule(discovered.configPath);
+    return resolveConfig(raw, {
+        projectRoot: discovered.projectRoot,
+        ...(discovered.configPath !== undefined ? { configPath: discovered.configPath } : {}),
+        env,
+        cli,
+    });
+}
+function statusOf(exitCode) {
+    return exitCode === 0 ? 'passed' : exitCode === 1 ? 'failed' : exitCode === 130 ? 'interrupted' : 'error';
+}
+/**
+ * Grades one target from its backend declaration and validates the configured
+ * artifacts against it; returns the report provenance.
+ */
+function validateBackend(target, config) {
+    const provenance = describeTarget(target);
+    // The default artifact set is best-effort: a backend without evidence
+    // capture simply records none. Asking for one explicitly is a contract.
+    for (const artifact of config.artifactsExplicit ? config.artifacts : []) {
+        if (!provenance.artifactCapabilities.includes(artifact)) {
+            throw new ConfigurationError('UNSUPPORTED_ARTIFACT', `target "${target.name}" (backend ${provenance.backend.name}) does not support the configured "${artifact}" artifact`);
+        }
+    }
+    return provenance;
+}
+function resultExitCodes(results) {
+    const codes = [0];
+    for (const result of results) {
+        switch (result.status) {
+            case 'failed':
+            case 'timed-out':
+                codes.push(1);
+                for (const attempt of result.attempts) {
+                    if (attempt.error !== undefined)
+                        codes.push(exitCodeForCategory(attempt.error.category));
+                }
+                break;
+            case 'interrupted':
+                codes.push(130);
+                break;
+            default:
+                break;
+        }
+    }
+    return codes;
+}
+function resolveArtifactsRoot(config, override) {
+    if (override !== undefined)
+        return path.resolve(config.projectRoot, override);
+    return path.join(config.projectRoot, '.e2e', 'artifacts');
+}
+//# sourceMappingURL=runner.js.map

package/dist/run/runner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.js","sourceRoot":"","sources":["../../src/run/runner.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAE9E,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACrE,OAAO,EACL,QAAQ,EACR,aAAa,GAId,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,OAAO,EAAmB,MAAM,uBAAuB,CAAC;AACjE,OAAO,EAAE,MAAM,EAAyC,MAAM,sBAAsB,CAAC;AACrF,OAAO,EACL,aAAa,EACb,gBAAgB,EAChB,kBAAkB,EAClB,QAAQ,EACR,YAAY,EACZ,mBAAmB,EACnB,cAAc,GAEf,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AACrG,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,cAAc,EAA+C,MAAM,oBAAoB,CAAC;AAC9G,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,qBAAqB,EAAE,aAAa,EAAuC,MAAM,aAAa,CAAC;AACxG,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAEnD,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AA8C1D,yEAAyE;AACzE,MAAM,CAAC,KAAK,UAAU,GAAG,CAAC,OAAO,GAAe,EAAE;IAChD,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IACzC,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC;IACvC,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC;IACvB,MAAM,SAAS,GAAG,SAAS,EAAE,CAAC;IAC9B,MAAM,KAAK,GAAG,IAAI,UAAU,CAAC,OAAO,CAAC,KAAK,KAAK,IAAI,CAAC,CAAC;IACrD,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,gBAAgB,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;IAC9E,oEAAoE;IACpE,IAAI,eAA4C,CAAC;IACjD,MAAM,mBAAmB,GAAG,IAAI,eAAe,EAAE,CAAC;IAClD,MAAM,SAAS,GAAe,EAAE,CAAC;IACjC,MAAM,OAAO,GAAmB,EAAE,CAAC;IACnC,MAAM,YAAY,GAAwB,EAAE,CAAC;IAC7C,MAAM,gBAAgB,GAAG,IAAI,GAAG,EAA4B,CAAC;IAC7D,IAAI,UAAkC,CAAC;IACvC,IAAI,YAAsC,CAAC;IAE3C,6EAA6E;IAC7E,sEAAsE;IACtE,MAAM,GAAG,GAAiB,EAAE,CAAC;IAC7B,IAAI,OAAO,CAAC,OAAO,KAAK,SAAS;QAAE,GAAG,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IACjE,IAAI,OAAO,CAAC,OAAO,KAAK,SAAS;QAAE,GAAG,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IACjE,IAAI,OAAO,CAAC,SAAS,KAAK,SAAS;QAAE,GAAG,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;IACvE,IAAI,OAAO,CAAC,OAAO,KAAK,IAAI;QAAE,GAAG,CAAC,KAAK,GAAG,KAAK,CAAC;IAEhD,6EAA6E;IAC7E,4EAA4E;IAC5E,uEAAuE;IACvE,2EAA2E;IAC3E,4DAA4D;IAC5D,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,aAAa,EAAE,GAAG,EAAE,CAAC,aAAa,CAAC,OAAO,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,IAAI,CAC9F,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,EAC1C,CAAC,KAAc,EAAE,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC,CACzE,CAAC;IAEF,4EAA4E;IAC5E,qEAAqE;IACrE,qBAAqB;IACrB,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,SAAS,IAAI,OAAO,CAAC,SAAS,IAAI,CAAC,MAAM,CAAC,CAAC;IAC5E,MAAM,IAAI,GAAG,qBAAqB,CAAC;QACjC,OAAO,CAAC,KAAK,KAAK,IAAI,IAAI,SAAS,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,YAAY,EAAE,CAAC,MAAM;QAC5F,OAAO,CAAC,OAAO;KAChB,CAAC,CAAC;IACH,MAAM,UAAU,GAAG,SAAS,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IAE9C,6EAA6E;IAC7E,MAAM,cAAc,GAAG,CAAC,QAAkB,EAAQ,EAAE;QAClD,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACzB,IAAI,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC;IACrD,CAAC,CAAC;IAEF,6DAA6D;IAC7D,MAAM,aAAa,GAAG,CAAC,KAAc,EAAE,KAAkB,EAAQ,EAAE;QACjE,cAAc,CAAC,EAAE,KAAK,EAAE,cAAc,CAAC,aAAa,CAAC,KAAK,CAAC,EAAE,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC;IACxG,CAAC,CAAC;IAEF;;;;;OAKG;IACH,MAAM,eAAe,GAAG,GAAgB,EAAE,CACxC,gBAAgB,CAAC;QACf,GAAG,eAAe,CAAC,OAAO,CAAC;QAC3B,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,mBAAmB,CAAC,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QAC5E,GAAG,CAAC,mBAAmB,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;KACrD,CAAC,CAAC;IAEL,MAAM,cAAc,GAAG,CAAC,QAAqB,EAAmB,EAAE,CAChE,WAAW,CAAC;QACV,KAAK;QACL,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,SAAS;QACT,MAAM,EAAE,QAAQ,CAAC,QAAQ,CAAC;QAC1B,QAAQ;QACR,OAAO;QACP,YAAY;QACZ,SAAS;QACT,gBAAgB;KACjB,CAAC,CAAC;IAEL;;;;;;;OAOG;IACH,MAAM,oBAAoB,GAAG,KAAK,EAAE,MAAsB,EAA+B,EAAE;QACzF,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,oBAAoB,CAAC,MAAM,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC,EAAE,aAAa,CAAC,CAAC;QAC1G,IAAI,CAAC;YACH,MAAM,eAAe,CAAC,MAAM,EAAE,cAAc,CAAC,eAAe,EAAE,CAAC,CAAC,CAAC;YACjE,OAAO,MAAM,CAAC;QAChB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,aAAa,CACX,IAAI,QAAQ,CACV,gBAAgB,EAChB,qBAAqB,EACrB,8CAA8C,YAAY,CAAC,KAAK,CAAC,EAAE,EACnE,EAAE,KAAK,EAAE,CACV,EACD,QAAQ,CACT,CAAC;YACF,OAAO,SAAS,CAAC;QACnB,CAAC;IACH,CAAC,CAAC;IAEF;;;;;OAKG;IACH,MAAM,YAAY,GAAG,KAAK,EAAE,MAAsB,EAA+B,EAAE;QACjF,IAAI,OAAO,KAAK,SAAS;YAAE,OAAO,SAAS,CAAC;QAC5C,IAAI,eAAe,KAAK,SAAS,EAAE,CAAC;YAClC,OAAO,CAAC,KAAK,CAAC,eAAe,CAAC,KAAK,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;YACpD,eAAe,CAAC,OAAO,EAAE,CAAC;YAC1B,eAAe,GAAG,SAAS,CAAC;QAC9B,CAAC;QACD,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,oBAAoB,CAAC,MAAM,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC,EAAE,eAAe,CAAC,CAAC;QAC5G,IAAI,CAAC;YACH,MAAM,eAAe,CAAC,MAAM,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;YAClD,OAAO,MAAM,CAAC;QAChB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,aAAa,CACX,IAAI,QAAQ,CACV,gBAAgB,EAChB,qBAAqB,EACrB,sCAAsC,YAAY,CAAC,KAAK,CAAC,EAAE,EAC3D,EAAE,KAAK,EAAE,CACV,EACD,QAAQ,CACT,CAAC;YACF,OAAO,SAAS,CAAC;QACnB,CAAC;IACH,CAAC,CAAC;IAEF,MAAM,MAAM,GAAG,KAAK,IAAyB,EAAE;QAC7C,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,YAAY,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAChG,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,oBAAoB,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QACvG,MAAM,QAAQ,GAAG,eAAe,EAAE,CAAC;QACnC,MAAM,MAAM,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC;QAClC,MAAM,MAAM,GAAG,cAAc,CAAC,QAAQ,CAAC,CAAC;QACxC,qBAAqB,CAAC,SAAS,CAAC,CAAC;QACjC,IAAI,CAAC;YACH,IAAI,EAAE,cAAc;YACpB,MAAM;YACN,QAAQ;YACR,GAAG,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC;YACnD,GAAG,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC;SACtD,CAAC,CAAC;QACH,IAAI,UAAU,EAAE,CAAC;YACf,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;QAC/D,CAAC;QACD,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;YAClB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;YACtC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,cAAc,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC;QAC9D,CAAC;QACD,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,WAAW,EAAE,OAAO,EAAE,CAAC;IACxE,CAAC,CAAC;IAEF,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QAChC,aAAa,CAAC,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;QACtC,OAAO,MAAM,EAAE,CAAC;IAClB,CAAC;IACD,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;IAE7B,qBAAqB,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;IAC1C,IAAI,CAAC;QACH,IAAI,EAAE,aAAa;QACnB,KAAK;QACL,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,EAAE,EAAE,QAAQ,CAAC,GAAG,CAAC;QACjB,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC;KACrD,CAAC,CAAC;IAEH,MAAM,UAAU,GAAG,KAAK,IAAmB,EAAE;QAC3C,MAAM,WAAW,GAAG,mBAAmB,CAAC,MAAM,CAAC;QAC/C,IAAI,MAAM,CAAC,GAAG,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;YACrC,MAAM,GAAG,GAAG,IAAI,UAAU,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;YACxF,UAAU,GAAG,GAAG,CAAC;YACjB,MAAM,KAAK,CAAC,IAAI,CAAC,WAAW,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC;QAC9D,CAAC;QACD,oEAAoE;QACpE,uCAAuC;QACvC,IAAI,WAAW,CAAC,OAAO;YAAE,OAAO;QAEhC,IAAI,OAAyD,CAAC;QAC9D,IAAI,CAAC;YACH,OAAO,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,IAAI,EAAE;gBAC/C,MAAM,UAAU,GAAG,MAAM,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;gBACxD,MAAM,OAAO,GAAqB;oBAChC,GAAG,CAAC,OAAO,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;oBAC7D,GAAG,CAAC,OAAO,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;oBACtE,GAAG,CAAC,OAAO,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;iBAC7E,CAAC;gBACF,MAAM,SAAS,GAAG,MAAM,CACtB,UAAU,EACV,MAAM,EACN,OAAO,EACP,OAAO,CAAC,eAAe,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,eAAe,EAAE,OAAO,CAAC,eAAe,EAAE,CAAC,CAAC,CAAC,EAAE,CAC1F,CAAC;gBACF,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,CAAC;YACnC,CAAC,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,aAAa,CAAC,KAAK,EAAE,YAAY,CAAC,CAAC;YACnC,OAAO;QACT,CAAC;QACD,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC;QAE1C,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;QAEtD,MAAM,aAAa,GAAG,oBAAoB,CAAC,MAAM,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC;QACzE,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,CAAC,CAAC;QACvE,MAAM,KAAK,GAAG,YAAY,CAAC,MAAM,CAAC,KAAK,EAAE,YAAY,CAAC,CAAC;QACvD,YAAY,GAAG,KAAK,CAAC;QAErB,uEAAuE;QACvE,oEAAoE;QACpE,sEAAsE;QACtE,KAAK,MAAM,EAAE,MAAM,EAAE,IAAI,SAAS,CAAC,SAAS,EAAE,CAAC;YAC7C,gBAAgB,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,eAAe,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;QACrE,CAAC;QAED,wEAAwE;QACxE,2EAA2E;QAC3E,qEAAqE;QACrE,mEAAmE;QACnE,IAAI,OAAO,KAAK,SAAS,IAAI,MAAM,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;YAC7D,mEAAmE;YACnE,kEAAkE;YAClE,eAAe,GAAG,IAAI,eAAe,EAAE,CAAC;YACxC,MAAM,uBAAuB,CAAC,eAAe,EAAE,SAAS,CAAC,CAAC;QAC5D,CAAC;QACD,MAAM,SAAS,GACb,MAAM,CAAC,UAAU,KAAK,SAAS;YAC7B,CAAC,CAAC;gBACE,OAAO,EAAE,CAAC;gBACV,KAAK,EAAE,gBAAgB,CAAC;oBACtB,MAAM;oBACN,SAAS;oBACT,KAAK;oBACL,aAAa;oBACb,YAAY,EAAE,KAAK;oBACnB,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,KAAK;oBAC/B,KAAK;iBACN,CAAC;aACH;YACH,CAAC,CAAC;gBACE,OAAO,EAAE,MAAM,CAAC,OAAO;gBACvB,KAAK,EAAE,mBAAmB,CAAC;oBACzB,UAAU,EAAE,MAAM,CAAC,UAAU;oBAC7B,WAAW,EAAE,MAAM,CAAC,WAAW;oBAC/B,YAAY,EAAE,MAAM,CAAC,YAAY;oBACjC,GAAG;oBACH,KAAK;oBACL,aAAa;oBACb,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,KAAK;oBAC/B,YAAY;oBACZ,gBAAgB,EAAE,KAAK,CAAC,kBAAkB,EAAE;oBAC5C,KAAK,EAAE,KAAK,CAAC,OAAO;oBACpB,OAAO,EAAE,OAAO,KAAK,SAAS;oBAC9B,GAAG;iBACJ,CAAC;aACH,CAAC;QAER,MAAM,KAAK,CAAC,IAAI,CAAC,WAAW,EAAE,GAAG,EAAE,CACjC,QAAQ,CAAC;YACP,SAAS;YACT,UAAU;YACV,WAAW,EAAE,MAAM,CAAC,WAAW;YAC/B,OAAO,EAAE,SAAS,CAAC,OAAO;YAC1B,KAAK,EAAE,SAAS,CAAC,KAAK;YACtB,gBAAgB,EAAE,MAAM,CAAC,OAAO,GAAG,MAAM,CAAC,cAAc;YACxD,eAAe,EAAE,WAAW;YAC5B,MAAM,EAAE;gBACN,QAAQ,EAAE,CAAC,MAAM,EAAE,EAAE;oBACnB,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;oBACrB,IAAI,CAAC,EAAE,IAAI,EAAE,eAAe,EAAE,MAAM,EAAE,aAAa,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;gBACjE,CAAC;gBACD,aAAa,EAAE,CAAC,KAAK,EAAE,EAAE;oBACvB,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;oBACzB,IAAI,CAAC,EAAE,IAAI,EAAE,cAAc,EAAE,KAAK,EAAE,CAAC,CAAC;gBACxC,CAAC;gBACD,UAAU,EAAE,cAAc;gBAC1B,WAAW,EAAE,CAAC,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,EAAE,CACzC,IAAI,CAAC,EAAE,IAAI,EAAE,cAAc,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC;gBACnE,UAAU,EAAE,CAAC,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,EAAE,CAC3C,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAC;gBAC9D,OAAO,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC;gBAC5C,SAAS,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,OAAO,EAAE,KAAK,CAAC,QAAQ,CAAC;aAClD;SACF,CAAC,CACH,CAAC;IACJ,CAAC,CAAC;IAEF,8EAA8E;IAC9E,4EAA4E;IAC5E,4EAA4E;IAC5E,6EAA6E;IAC7E,2EAA2E;IAC3E,0EAA0E;IAC1E,8BAA8B;IAC9B,MAAM,cAAc,GAAG,OAAO,CAAC,eAAe,CAAC;IAC/C,MAAM,WAAW,GAAG,GAAG,EAAE,CAAC,mBAAmB,CAAC,KAAK,EAAE,CAAC;IACtD,IAAI,cAAc,EAAE,OAAO,KAAK,IAAI;QAAE,mBAAmB,CAAC,KAAK,EAAE,CAAC;IAClE,cAAc,EAAE,gBAAgB,CAAC,OAAO,EAAE,WAAW,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IACvE,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;IACpC,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;IACrC,IAAI,CAAC;QACH,MAAM,UAAU,EAAE,CAAC;IACrB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,aAAa,CAAC,KAAK,CAAC,CAAC;IACvB,CAAC;YAAS,CAAC;QACT,OAAO,CAAC,cAAc,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;QAC9C,OAAO,CAAC,cAAc,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;QAC/C,cAAc,EAAE,mBAAmB,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;IAC5D,CAAC;IACD,KAAK,MAAM,QAAQ,IAAI,CAAC,GAAG,EAAE,CAAC,YAAY,EAAE,OAAO,EAAE,EAAE,GAAG,EAAE,CAAC,UAAU,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;QACjF,IAAI,CAAC;YACH,MAAM,QAAQ,EAAE,CAAC;QACnB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,aAAa,CAAC,KAAK,CAAC,CAAC;QACvB,CAAC;IACH,CAAC;IACD,OAAO,MAAM,EAAE,CAAC;AAClB,CAAC;AAED,2EAA2E;AAC3E,KAAK,UAAU,aAAa,CAC1B,OAAmB,EACnB,GAAW,EACX,GAAsB,EACtB,GAAiB;IAEjB,IAAI,OAAO,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;QACpC,OAAO,aAAa,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,WAAW,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC;IAC1E,CAAC;IACD,MAAM,UAAU,GAAG,cAAc,CAAC,GAAG,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC;IAC3D,MAAM,GAAG,GAAG,UAAU,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,gBAAgB,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;IACrG,OAAO,aAAa,CAAC,GAAG,EAAE;QACxB,WAAW,EAAE,UAAU,CAAC,WAAW;QACnC,GAAG,CAAC,UAAU,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,UAAU,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACrF,GAAG;QACH,GAAG;KACJ,CAAC,CAAC;AACL,CAAC;AAED,SAAS,QAAQ,CAAC,QAAqB;IACrC,OAAO,QAAQ,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,KAAK,GAAG,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,OAAO,CAAC;AAC5G,CAAC;AAED;;;GAGG;AACH,SAAS,eAAe,CAAC,MAAsB,EAAE,MAAsB;IACrE,MAAM,UAAU,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC;IAC1C,sEAAsE;IACtE,wEAAwE;IACxE,KAAK,MAAM,QAAQ,IAAI,MAAM,CAAC,iBAAiB,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;QACxE,IAAI,CAAC,UAAU,CAAC,oBAAoB,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;YACxD,MAAM,IAAI,kBAAkB,CAC1B,sBAAsB,EACtB,WAAW,MAAM,CAAC,IAAI,cAAc,UAAU,CAAC,OAAO,CAAC,IAAI,sCAAsC,QAAQ,YAAY,CACtH,CAAC;QACJ,CAAC;IACH,CAAC;IACD,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,SAAS,eAAe,CAAC,OAAgC;IACvD,MAAM,KAAK,GAAa,CAAC,CAAC,CAAC,CAAC;IAC5B,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,QAAQ,MAAM,CAAC,MAAM,EAAE,CAAC;YACtB,KAAK,QAAQ,CAAC;YACd,KAAK,WAAW;gBACd,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;gBACd,KAAK,MAAM,OAAO,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;oBACtC,IAAI,OAAO,CAAC,KAAK,KAAK,SAAS;wBAAE,KAAK,CAAC,IAAI,CAAC,mBAAmB,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC;gBAC3F,CAAC;gBACD,MAAM;YACR,KAAK,aAAa;gBAChB,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;gBAChB,MAAM;YACR;gBACE,MAAM;QACV,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,oBAAoB,CAAC,MAAsB,EAAE,QAA4B;IAChF,IAAI,QAAQ,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;IAC9E,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC;AAC5D,CAAC"}

package/dist/run/scheduler.d.ts

@@ -0,0 +1,45 @@
+/**
+ * The run engine: dispatches file-target work units across workers (spec
+ * 11-lifecycle.md). Per target, setup units complete before ordinary units
+ * dispatch; a worker is bound to one target, runs one unit at a time, and is
+ * discarded after any failing unit or infrastructure fault.
+ *
+ * Workers are reached only through `SpawnUnitRunner`, so the same scheduling,
+ * gating, and reporting logic covers both child-process and in-process
+ * execution.
+ */
+import type { Collection } from '../collect/collect.ts';
+import type { Selection } from '../collect/select.ts';
+import type { AiTraceSnapshot } from '../internal/ai-trace.ts';
+import type { DebugSnapshot } from '../internal/debug.ts';
+import type { ResultRecord, RunError, SerialGroupRecord } from './records.ts';
+import type { StepProgress } from './steps.ts';
+import type { SpawnUnitRunner } from './unit-runner.ts';
+export interface SchedulerEvents {
+    onResult(result: ResultRecord): void;
+    onSerialGroup(group: SerialGroupRecord): void;
+    onRunError(error: RunError): void;
+    /** A worker began executing one test-target pair. */
+    onTestStart?(testId: string, title: string, targetName: string): void;
+    /** Live step progress of one running attempt. */
+    onProgress?(testId: string, targetName: string, progress: StepProgress): void;
+    /** Phase timings a child-process worker drained after one unit. */
+    onDebug?(snapshot: DebugSnapshot): void;
+    /** Model calls a child-process worker drained after one unit. */
+    onAiTrace?(snapshot: AiTraceSnapshot): void;
+}
+export interface RunUnitsOptions {
+    readonly selection: Selection;
+    readonly collection: Collection;
+    readonly projectRoot: string;
+    /** Maximum workers alive at once across all targets. */
+    readonly workers: number;
+    /** Budget for a worker to finish an in-flight unit after an interrupt. */
+    readonly interruptGraceMs: number;
+    readonly interruptSignal: AbortSignal;
+    readonly spawn: SpawnUnitRunner;
+    readonly events: SchedulerEvents;
+}
+/** Runs every selected unit and streams records. */
+export declare function runUnits(options: RunUnitsOptions): Promise<void>;
+//# sourceMappingURL=scheduler.d.ts.map

package/dist/run/scheduler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scheduler.d.ts","sourceRoot":"","sources":["../../src/run/scheduler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,KAAK,EAAE,SAAS,EAAkB,MAAM,sBAAsB,CAAC;AAEtE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAG1D,OAAO,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAC9E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,KAAK,EAAE,eAAe,EAAc,MAAM,kBAAkB,CAAC;AAYpE,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI,CAAC;IACrC,aAAa,CAAC,KAAK,EAAE,iBAAiB,GAAG,IAAI,CAAC;IAC9C,UAAU,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI,CAAC;IAClC,qDAAqD;IACrD,WAAW,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IACtE,iDAAiD;IACjD,UAAU,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,YAAY,GAAG,IAAI,CAAC;IAC9E,mEAAmE;IACnE,OAAO,CAAC,CAAC,QAAQ,EAAE,aAAa,GAAG,IAAI,CAAC;IACxC,iEAAiE;IACjE,SAAS,CAAC,CAAC,QAAQ,EAAE,eAAe,GAAG,IAAI,CAAC;CAC7C;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAC9B,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;IAChC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,wDAAwD;IACxD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,0EAA0E;IAC1E,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,eAAe,EAAE,WAAW,CAAC;IACtC,QAAQ,CAAC,KAAK,EAAE,eAAe,CAAC;IAChC,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAC;CAClC;AAQD,oDAAoD;AACpD,wBAAsB,QAAQ,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAEtE"}